Skip to content

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-Match as 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 (ModelContextProtocol 2.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.
  • --once harness 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-bridge skill (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/queued are client-local states), and daily usage aggregates live at telemetry/usage/{yyyy-MM-dd}.json.
  • MIT license: standard-layout LICENSE at the plugin root plus the matching SPDX license field in plugin.json.