agent-tempo 1.0.1

package/dist/adapters/copilot/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * copilot adapter — barrel export.
+ *
+ * Re-exports the descriptor and class from `./adapter`. `src/adapters/index.ts`
+ * imports the descriptor here at module load and registers it with the
+ * singleton {@link AdapterRegistry}. Direct consumers should fetch from the
+ * registry, not import the descriptor directly.
+ *
+ * The descriptor constant itself lives colocated with the class in `./adapter`
+ * so this file has no inward-pointing imports — breaks the module-graph cycle
+ * flagged in PR-B QA review.
+ *
+ * Design reference: docs/design/session-lifecycle-rebuild-v2.md §4.2.
+ */
+export { CopilotSdkAttachment, copilotDescriptor } from './adapter';

package/dist/adapters/copilot/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copilotDescriptor = exports.CopilotSdkAttachment = void 0;
+/**
+ * copilot adapter — barrel export.
+ *
+ * Re-exports the descriptor and class from `./adapter`. `src/adapters/index.ts`
+ * imports the descriptor here at module load and registers it with the
+ * singleton {@link AdapterRegistry}. Direct consumers should fetch from the
+ * registry, not import the descriptor directly.
+ *
+ * The descriptor constant itself lives colocated with the class in `./adapter`
+ * so this file has no inward-pointing imports — breaks the module-graph cycle
+ * flagged in PR-B QA review.
+ *
+ * Design reference: docs/design/session-lifecycle-rebuild-v2.md §4.2.
+ */
+var adapter_1 = require("./adapter");
+Object.defineProperty(exports, "CopilotSdkAttachment", { enumerable: true, get: function () { return adapter_1.CopilotSdkAttachment; } });
+Object.defineProperty(exports, "copilotDescriptor", { enumerable: true, get: function () { return adapter_1.copilotDescriptor; } });

package/dist/adapters/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Adapter registry bootstrap + barrel exports.
+ *
+ * Import side effect: registers every shipped adapter descriptor with the
+ * singleton {@link registry}. Callers should:
+ *
+ * ```ts
+ * import { registry } from './adapters';
+ * const descriptor = registry.get(metadata.adapterId ?? registry.resolveFromAgentType(metadata.agentType));
+ * ```
+ *
+ * Adding a new adapter is one line — import its descriptor here and call
+ * `registry.register(...)`. See `src/adapters/README.md`.
+ *
+ * Design reference: docs/design/session-lifecycle-rebuild-v2.md §§4.1–4.2.
+ * Sequencing memo: §3 PR-B.
+ */
+import { AdapterRegistry } from './base';
+export declare const registry: AdapterRegistry;
+/**
+ * Canonical list of production adapters registered at module-import time.
+ *
+ * SSOT for the conformance test asserting every shipped adapter is present
+ * in the registry (#486). Adding a new adapter is two adjacent touches in
+ * this file: a `registry.register(...)` call above AND a new entry below.
+ * The test (`test/conformance/registry.test.ts`) imports this constant and
+ * compares it against `registry.all()`, so it catches BOTH "registered but
+ * not declared canonical" AND "declared canonical but not registered"
+ * drift. Mirrors the `AGENT_TYPES` tripwire in `src/types.ts`.
+ *
+ * Mock adapter is intentionally excluded — it's dev-mode-only and stripped
+ * from the npm tarball at prepack time (ADR 0014 §7 gate 1).
+ */
+export declare const CANONICAL_ADAPTER_IDS: readonly ["claude-code", "copilot", "claude-api", "opencode", "claude-code-headless"];
+export { BaseAttachment, AdapterRegistry } from './base';
+export { SdkAttachment } from './sdk/base';
+export { InteractiveAttachment } from './claude-code';
+export { CopilotSdkAttachment } from './copilot';
+export { DirectApiAttachment } from './claude-api';
+export { OpenCodeAttachment } from './opencode';
+export { ClaudeCodeHeadlessAttachment } from './claude-code-headless';
+export type { AdapterClass, AdapterDescriptor } from '../types';

package/dist/adapters/index.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeCodeHeadlessAttachment = exports.OpenCodeAttachment = exports.DirectApiAttachment = exports.CopilotSdkAttachment = exports.InteractiveAttachment = exports.SdkAttachment = exports.AdapterRegistry = exports.BaseAttachment = exports.CANONICAL_ADAPTER_IDS = exports.registry = void 0;
+/**
+ * Adapter registry bootstrap + barrel exports.
+ *
+ * Import side effect: registers every shipped adapter descriptor with the
+ * singleton {@link registry}. Callers should:
+ *
+ * ```ts
+ * import { registry } from './adapters';
+ * const descriptor = registry.get(metadata.adapterId ?? registry.resolveFromAgentType(metadata.agentType));
+ * ```
+ *
+ * Adding a new adapter is one line — import its descriptor here and call
+ * `registry.register(...)`. See `src/adapters/README.md`.
+ *
+ * Design reference: docs/design/session-lifecycle-rebuild-v2.md §§4.1–4.2.
+ * Sequencing memo: §3 PR-B.
+ */
+const base_1 = require("./base");
+const claude_code_1 = require("./claude-code");
+const copilot_1 = require("./copilot");
+const claude_api_1 = require("./claude-api");
+const opencode_1 = require("./opencode");
+const claude_code_headless_1 = require("./claude-code-headless");
+const config_1 = require("../config");
+exports.registry = new base_1.AdapterRegistry();
+exports.registry.register(claude_code_1.claudeCodeDescriptor);
+exports.registry.register(copilot_1.copilotDescriptor);
+// #131 Phase C — headless Claude API adapter. Always-registered (the optional
+// `@anthropic-ai/sdk` dependency only matters at adapter spawn time; the
+// descriptor itself has no SDK dependency, so the registry can list and
+// resolve it even on hosts that haven't installed the SDK).
+exports.registry.register(claude_api_1.claudeApiDescriptor);
+// #449 Phase C — headless multi-provider OpenCode adapter. Always-registered
+// for the same reason as claude-api: the optional `@opencode-ai/sdk` and the
+// `opencode` binary only matter at adapter spawn time. The recruit pre-flight
+// gates on both being available (or `force: true` to bypass).
+exports.registry.register(opencode_1.opencodeDescriptor);
+// #520 — headless Claude Code adapter. Spawns the host's installed `claude`
+// CLI as a per-turn subprocess; uses the operator's existing OAuth login so
+// turns bill against subscription extra-usage credits (the only ToS-clean
+// path to that pool for a third-party tool). Always-registered — the
+// `claude` binary is a system binary, not an npm dep; recruit pre-flight
+// probes for installation + login state via `pre-flight.ts`.
+exports.registry.register(claude_code_headless_1.claudeCodeHeadlessDescriptor);
+/**
+ * Canonical list of production adapters registered at module-import time.
+ *
+ * SSOT for the conformance test asserting every shipped adapter is present
+ * in the registry (#486). Adding a new adapter is two adjacent touches in
+ * this file: a `registry.register(...)` call above AND a new entry below.
+ * The test (`test/conformance/registry.test.ts`) imports this constant and
+ * compares it against `registry.all()`, so it catches BOTH "registered but
+ * not declared canonical" AND "declared canonical but not registered"
+ * drift. Mirrors the `AGENT_TYPES` tripwire in `src/types.ts`.
+ *
+ * Mock adapter is intentionally excluded — it's dev-mode-only and stripped
+ * from the npm tarball at prepack time (ADR 0014 §7 gate 1).
+ */
+exports.CANONICAL_ADAPTER_IDS = [
+    'claude-code',
+    'copilot',
+    'claude-api',
+    'opencode',
+    'claude-code-headless',
+];
+// ADR 0014 §7 gate 2 — import-time registration gate. The mock adapter's
+// descriptor only enters the registry when `isDevMode()` is true.
+//
+// Synchronous (require) is intentional: the registry is the resolution
+// surface every recruit / spawn / restart path consults, and they consult
+// it inside the same Node.js tick the MCP server boots in. Doing this with
+// dynamic `import()` would leave a window where `registry.get('mock')`
+// throws "Unknown adapter" until the promise lands. Tests that want to
+// flip dev mode mid-process can re-require this module after mutating
+// `process.env.AGENT_TEMPO_DEV_MODE`.
+//
+// In production tarballs `dist/adapters/mock/` is excluded via the root
+// `.npmignore` (gate 1). If a malicious / hand-edited install somehow has
+// the file present AND `AGENT_TEMPO_DEV_MODE=1`, recruit-time rejection
+// (gate 3) is the next line of defence.
+if ((0, config_1.isDevMode)()) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { mockDescriptor } = require('./mock');
+        exports.registry.register(mockDescriptor);
+        console.error('[agent-tempo] DEV MODE: mock adapter registered');
+    }
+    catch (err) {
+        // ADR 0014 §7 gate 1 strips `dist/adapters/mock/` from the published
+        // tarball. If a user then sets `AGENT_TEMPO_DEV_MODE=1` against an
+        // npm-installed agent-tempo, the require above fails — and that's
+        // exactly the safety property we want. Log + continue so the rest of
+        // the daemon boots normally; gate 3 (recruit-time rejection) catches
+        // any later `agent: 'mock'` request with a clearer message.
+        console.error('[agent-tempo] DEV MODE: mock adapter unavailable in this build —', err instanceof Error ? err.message : err);
+    }
+}
+var base_2 = require("./base");
+Object.defineProperty(exports, "BaseAttachment", { enumerable: true, get: function () { return base_2.BaseAttachment; } });
+Object.defineProperty(exports, "AdapterRegistry", { enumerable: true, get: function () { return base_2.AdapterRegistry; } });
+var base_3 = require("./sdk/base");
+Object.defineProperty(exports, "SdkAttachment", { enumerable: true, get: function () { return base_3.SdkAttachment; } });
+var claude_code_2 = require("./claude-code");
+Object.defineProperty(exports, "InteractiveAttachment", { enumerable: true, get: function () { return claude_code_2.InteractiveAttachment; } });
+var copilot_2 = require("./copilot");
+Object.defineProperty(exports, "CopilotSdkAttachment", { enumerable: true, get: function () { return copilot_2.CopilotSdkAttachment; } });
+var claude_api_2 = require("./claude-api");
+Object.defineProperty(exports, "DirectApiAttachment", { enumerable: true, get: function () { return claude_api_2.DirectApiAttachment; } });
+var opencode_2 = require("./opencode");
+Object.defineProperty(exports, "OpenCodeAttachment", { enumerable: true, get: function () { return opencode_2.OpenCodeAttachment; } });
+var claude_code_headless_2 = require("./claude-code-headless");
+Object.defineProperty(exports, "ClaudeCodeHeadlessAttachment", { enumerable: true, get: function () { return claude_code_headless_2.ClaudeCodeHeadlessAttachment; } });

package/dist/adapters/opencode/adapter.d.ts

@@ -0,0 +1,82 @@
+import type { AdapterDescriptor } from '../../types';
+import { SdkAttachment } from '../sdk/base';
+/**
+ * Descriptor for the opencode adapter. Colocated with the class so
+ * `adapter.ts` has no import dependency on `index.ts` (avoids the
+ * circular module-graph cycle QA flagged on copilot's PR-B).
+ */
+export declare const opencodeDescriptor: AdapterDescriptor;
+/**
+ * SDK-class adapter for OpenCode. Pull-based delivery: poll workflow for
+ * pending messages, post each batch to `prompt_async`, observe SSE until
+ * `finish`, ack via `markDelivered`. `processingStart`/`End` paired by
+ * `SdkAttachment.deliver()`.
+ */
+export declare class OpenCodeAttachment extends SdkAttachment {
+    readonly descriptor: AdapterDescriptor;
+    /** Resolved model id (recruit-arg → ENV.OPENCODE_MODEL → DEFAULT_MODEL). */
+    private model;
+    /** Probed-free port the opencode serve subprocess binds. */
+    private port;
+    /** Subprocess handle — `null` before run() spawns, after cleanup kills. */
+    private serveProcess;
+    /** HTTP/SSE bridge — `null` before run() boots the subprocess. */
+    private bridge;
+    /** OpenCode session id — created on first turn, stashed on workflow metadata. */
+    private openCodeSessionId;
+    /** AbortController for the in-flight SSE consumer / prompt_async fetch. */
+    private inFlightAbortController;
+    /** Cached for the per-turn telemetry log. */
+    private playerName;
+    /** Built once at session start; sent every turn (cheap; OpenCode caches server-side). */
+    private systemPrompt;
+    constructor(opts?: {
+        model?: string;
+    });
+    /**
+     * Lease-revocation hook. Two-step graceful → SIGTERM → SIGKILL fallback
+     * per design §6.1: post `/session/:id/abort` first (cleanest, no
+     * subprocess kill), abort in-flight fetch via `inFlightAbortController`,
+     * fall back to subprocess kill if HTTP abort hangs.
+     */
+    protected onSuperseded(): void;
+    /**
+     * Subprocess entry point. Boots `opencode serve`, connects Temporal,
+     * claims the attachment, runs the poll loop. The optional-dep gate at
+     * module load (above) has already exited the process if the SDK isn't
+     * installed, so by the time `run()` executes we know it's available.
+     */
+    run(): Promise<void>;
+    /**
+     * Poll the workflow for pending messages; call `deliver()` per batch.
+     * Mirrors claude-api / copilot — only the `invokeSdk` body differs.
+     */
+    private pollLoop;
+    /** True once `onTerminal` fired and cleanup tore down the V2 token. */
+    private shouldStop;
+    /**
+     * Per-turn LLM dispatch. Closes over the message batch so SdkAttachment's
+     * `invokeSdk` callback can stay (prompt, timeoutMs) shaped while the
+     * actual driving data is the `messages[]` from the poll.
+     *
+     * Steps per design §5.4:
+     *   1. Ensure OpenCode session exists (create on first turn, stash id
+     *      on workflow metadata via the existing updateMetadataSignal
+     *      sessionId field — same field copilot uses).
+     *   2. Subscribe to `/event` SSE.
+     *   3. POST `/session/:id/prompt_async` (returns 204, turn streams).
+     *   4. Consume SSE until `finish` reason — accumulate text, observe
+     *      tool-use breadcrumbs.
+     *   5. Log per-turn `turn-usage` line (design §5.6).
+     */
+    private invokeSdkWithBatch;
+    /**
+     * SIGTERM → SIGKILL escalation on the `opencode serve` subprocess.
+     * Idempotent — racing signals during cleanup are safe.
+     *
+     * On Windows, Bun-runtime SIGTERM may not propagate cleanly (ADR 0015
+     * §84). The fallback to SIGKILL after `SIGTERM_TIMEOUT_MS` covers this
+     * case without per-platform branching.
+     */
+    private killSubprocessChain;
+}