Skip to content

VENDORED.md

Latest commit

 

History

History
16 lines (11 loc) · 2.66 KB

VENDORED.md

File metadata and controls

16 lines (11 loc) · 2.66 KB
Raw

Port provenance and v2 gaps

This fork retains the history of Dmitry Zelenkovsky's original plugin, based on maintained fork commit 1936f495e396c9bcb93a201adee3cd3bd271d650. The v2 port was developed as a locally vendored plugin; its runtime files and focused tests are copied here. The older v1 suite and historical planning documents do not describe this port and have been removed from the current tree, not from Git history.

API mapping

  • V2 exports { id, setup(ctx) }; setup registers JSON-schema tools through ctx.tool.transform and returns cleanup. Plugin options replace the v1 config hook.
  • Session events track status and deletion. The v2 plugin context does not expose a status query. A prompt uses delivery: "queue", including when no status has been observed.
  • V2 has no per-prompt agent argument. The plugin never switches the session agent; a mismatch pauses the reminder. Verification and admission are not atomic, so another actor can change the session agent between them. Completion uses session.wait and checks the entire context suffix after the admitted user message; an intervening user, incomplete or failed assistant, or missing or unsuccessful terminal idle marker makes it fail closed. This differs from v1 and depends on the host API's behaviour.
  • V2 has no server-side toast API. Notification options from v1 are ignored.
  • Local same-host leases, mutation locks and generation fencing remain. A durable paused in-flight guard is written before admission; reload, process crash or uncertain completion leaves it paused even if admission never occurred. This avoids an automatic replay after reload but does not provide exactly-once delivery or distributed-filesystem coordination; writes are not fsynced, so OS or power failure may lose the guard. Cancellation cannot retract an admitted prompt; stale recovery guards may require manual cleanup.
  • Monitor execution keeps the creating agent and ordinary session/model/permission resolution. It is not a cheaper-model mechanism. Failed or unverified action and monitor executions pause immediately; the old max_consecutive_failures option is ignored, including for usage-limit errors.

Verification and deployment

Focused Bun tests cover the port with fake hosts. Historical v2 smoke testing of the vendored copy reported successful plugin and four-tool registration on a stock v2.0.3 server without provider calls; it does not establish compatibility with other builds, live providers or this particular release tree. Run the tests and validate registration on the target v2 build before deployment. This repository does not itself deploy or publish a package.