realactivity/lantern-bridge
v0.3.0MIT
Lantern desktop bridge: a Scout skill plus a local stdio MCP bridge that connects Scout to the Lantern mobile companion through the OneDrive App Folder protocol.
Changelog
Notable changes to the lantern-bridge plugin. Versioning follows SemVer,
as recommended by Agent Plugins 1.0.0 §10.2.
[0.3.0] (2026-08-15)
Added
- Graph delta pagination with approot-relative paths, deletion tombstones, and stale-cursor reset behavior.
Changed
- Create-if-absent Graph writes rely on their conditional PUT and no longer issue a redundant metadata preflight.
- Graph store tests enforce the two-request cold-start budget (approot plus conditional PUT).
[0.2.1] (2026-08-15)
Security
- Use platform-protected, cross-process MSAL caches (DPAPI, macOS Keychain, or Linux Keyring). The Graph backend fails closed when protected storage is unavailable.
- Validate the protocol major before processing and bind inbox filenames to their command IDs.
- Fail closed when a command already has a response, and repair a missing receipt from an immutable terminal response instead of re-executing work.
Fixed
- Recreate Graph HTTP request bodies on every 429/503 retry and send
If-None-Matchas a request header. - Bound retry delays and activity lookback, make local state writes atomic, and add Graph retry regression tests.
[0.2.0] (2026-08-15)
Added
- Stdio MCP server (
ModelContextProtocol2.2.0) with deterministic tools:publish_status,read_inbox,write_acknowledgement,write_response,record_processed_receipt,read_activity,resolve_artifact. - App Folder storage port: filesystem harness (CI) and Graph REST backend
(
/me/drive/special/approot, If-Match, Retry-After). - Strict inbox gate: schema-invalid, unknown-field, expired, and already receipted commands are never executed. Prompt-injection text is refused and audited.
--onceharness mode for the cross-language smoke test.- State under
LANTERN_STATE_DIR(receipts mirror, journal, delta cursor). MSAL caches stay in a separate user-only directory.
[0.1.0] (2026-08-15)
Added
- Initial Agent Plugins 1.0.0 package. The
lantern-bridgeskill (with bundled protocol quick reference) and the stdio MCP bridge declaration. - Manifest and MCP configuration validated against the official 1.0.0 schemas (specification published 2026-08-06).
- Bridge state directory contract.
LANTERN_STATE_DIR(backed by${PLUGIN_DATA}under a conformant client) holds delta cursors, receipt mirrors, and diagnostics. - Alignment with design spec v2.0: the command state machine in the protocol
quick reference starts at
acknowledged(draft/queuedare client-local states), and daily usage aggregates live attelemetry/usage/{yyyy-MM-dd}.json. - MIT license: standard-layout
LICENSEat the plugin root plus the matching SPDXlicensefield inplugin.json.