Distillation

Date: Sep 17, 2026

• 🟡 (09:25) packages/server/src/routes.ts adds SessionRecovery to applicationServices alongside SessionV2; AppNodeBuilder.build(applicationServices, [[SessionExecution.node, SessionExecutionLocal.node]]) substitutes local session execution. createRoutes(password?) uses username "opencode" with the supplied password or ServerAuth.Config.layer; createEmbeddedRoutes() uses username "opencode" with Option.none(). The API exposes OpenAPI at /openapi.json, and webHandler() disables logging.
• 🔴 (09:25) User stated the /doc route is loaded lazily so processes that “never serve it (CLI, scripts) don't pay at module load.”
• 🟡 (09:25) Main server route composition was changed to import SessionRecovery and build LayerNode.group([SessionV2.node, SessionRecovery.node]), integrating recovery into the server’s session service layer.
• 🟡 (09:25) Session execution interruption logic was changed from interrupt(key) to interrupt(key, cleanup = Effect.void). If no active owner exists it runs cleanup; concurrent interruption callers share entry.interruption; interruption marks stopping = true and clears pendingWake, interrupts the owner, captures the cleanup exit, requires the execution to have settled, then either deletes the active entry or creates and starts a successor when a wake became pending. It completes entry.done with the settled exit, propagates cleanup failure, runs uninterruptibly, and resolves the interruption deferred on exit.
• 🟡 (09:26) packages/core/src/database/schema.gen.ts reflects the recovery migration in the generated full-schema initializer, including session_execution, session_recovery, session_input.wake_pending, session.wake_attempts, their foreign keys/check constraints, and all associated recovery and wake-scanning indexes.