@elie-laloum/outpost 1.1.0 → 1.1.3

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 1.1.3
+
+- Replace the flat documentation with an Astro Starlight site in English and French, with English as the default language.
+- Organize usage into focused guides and generate checked reference pages for every public API export and supporting contract.
+- Validate translations, TypeScript examples, rendered links, navigation and search assets in CI.
+- Deploy one GitHub Pages site after successful stable releases, protecting it from older release deployments.
+- Move the French getting-started content and roadmap into the documentation, retain the root changelog and remove obsolete migration and contribution files.
+- Keep documentation tooling out of the published library archive.
+
+## 1.1.2
+
+- Match npm package repository metadata to the GitHub build origin for provenance verification. GitLab remains the canonical source repository.
+
+## 1.1.1
+
+- Separate Claude and Codex adapters, request builders and protocol decoders; preserve unknown events as raw observations.
+- Split sandbox provisioning, operation ownership, dispatch, attachment, conversation storage and recovery into dedicated services.
+- Separate campaign planning, issue execution and integration; isolate workflow state, retries and scheduling.
+- Isolate container planning, mounts, commands and transfers, cloud command/file adapters, Git worktree management and remote synchronization stages.
+- Extract contracts into `.types.ts` modules and configuration defaults into `.constants.ts` modules, without changing public entry points.
+- Enforce dependency boundaries and type placement in CI, reject unused implementation declarations, and document the structure in English and French.
+
 ## 1.1.0
 
 - Add typed issue campaigns with dynamic planning, bounded concurrency, per-issue branches, warm review, verified integration and tracker closure.

package/README.md

@@ -1,226 +1,54 @@
 # Outpost
 
-[Français](README.fr.md) · [API](docs/api.md) · [Providers](docs/providers.md) · [Workflows](docs/workflows.md) · [Operations](docs/operations.md) · [Roadmap](ROADMAP.md)
+[Documentation](https://elie-laloum.github.io/outpost/) · [Français](https://elie-laloum.github.io/outpost/fr/) · [API](https://elie-laloum.github.io/outpost/reference/) · [Changelog](CHANGELOG.md)
 
-Outpost is a TypeScript library for running coding agents in reusable sandboxes, managing their Git workspaces and composing typed workflows. V1 supports **Codex** and **Claude Code**, with Docker, Podman, Vercel, Daytona and explicit host execution. Agent adapters and sandbox providers are separate extension points.
+Outpost is a TypeScript library for running coding agents in reusable sandboxes, managing their Git workspaces and composing typed workflows. Claude Code and Codex adapters work with Docker, Podman, Vercel, Daytona or explicit host execution.
 
-The source repository is [GitLab](https://gitlab.elielaloum.com/elielaloum/outpost). [GitHub](https://github.com/elie-laloum/outpost) is its push mirror and runs all CI and package releases.
+## Get started
 
-## Requirements
-
-- Node.js **24 or later**, Git, and an existing repository with at least one commit.
-- Docker or Podman for local isolation; the appropriate account and optional SDK for a cloud sandbox.
-- An authenticated coding agent or its API key. Git hosting credentials are not model credentials.
-- ESM imports. TypeScript declarations ship with the package; Node can execute the generated `.ts`/`.mts` scripts directly.
-
-## Install and run
-
-Build from the source checkout:
-
-```sh
-npm ci
-npm run build
-npm pack
-```
-
-Install the resulting tarball in your target repository, or use the package from [GitHub Packages](https://github.com/elie-laloum/outpost/packages). Registry configuration is documented in [Operations](docs/operations.md).
+Requires Node.js **24+**, Git, an existing repository with a commit, and the credentials of your chosen agent. This example uses Docker.
 
 ```sh
-npm install --save-dev /path/to/elie-laloum-outpost-1.1.0.tgz
+npm install --save-dev @elie-laloum/outpost
 npx outpost init --yes --agent codex --provider docker --template blank --build
 ```
 
-Copy `.outpost/.env.example` to `.outpost/.env`. Set `OPENAI_API_KEY` there, or leave its declaration empty to inherit the process value. For Claude, select `--agent claude` and declare `ANTHROPIC_API_KEY` or `CLAUDE_CODE_OAUTH_TOKEN`. Only declared process variables are imported into isolated sandboxes. Run the generated script:
+Copy `.outpost/.env.example` to `.outpost/.env` and declare `OPENAI_API_KEY`. An empty declaration inherits the matching process variable. Then run the generated script:
 
 ```sh
-node .outpost/run.mts "Add validation and tests for the configuration loader"
+node .outpost/run.mts "Add validation, run tests and commit the change"
 ```
 
-Initialization uses `run.ts` when the host package declares `"type": "module"`, and `run.mts` otherwise. It never overwrites an existing scaffold. `--install` installs the library and optional provider SDK with the detected package manager. Omit `--build` to build the image later with `npx outpost image build`.
+Use `run.ts` for a project with `"type": "module"`; initialization prints the exact command.
 
-## One dispatch
+## Use the library
 
 ```ts
 import { dispatch, codex } from "@elie-laloum/outpost";
-import { docker } from "@elie-laloum/outpost/providers/docker";
 
 const result = await dispatch({
   agent: codex(),
-  provider: docker(),
   branch: { mode: "integrate" },
-  brief: { text: "Fix the failing tests, verify the result and commit it." },
-});
-
-console.log(result.branch, result.commits, result.conversation);
-```
-
-`dispatch` provisions a sandbox, executes the agent, collects changes and native conversation files, integrates commits when requested, and closes owned resources. Uncommitted work is retained. Failure paths preserve separate workspaces for inspection.
-
-| Branch policy                                                 | Behavior                                                                         |
-| ------------------------------------------------------------- | -------------------------------------------------------------------------------- |
-| `{ mode: "current" }`                                         | Uses the current checkout. This is the mounted/host default.                     |
-| `{ mode: "named", name: "feature/validation", from: "main" }` | Creates or reuses a managed worktree for that branch.                            |
-| `{ mode: "integrate", from: "main" }`                         | Creates a temporary branch and merges its commits into the original host branch. |
-
-Remote providers require `named` or `integrate`. `from` is optional. Integration refuses a changed host branch and retains the workspace on conflict. A branch checked out elsewhere produces an actionable error.
-
-## Keep a sandbox warm
-
-```ts
-import { createSandbox, claude } from "@elie-laloum/outpost";
-
-await using sandbox = await createSandbox({
-  agent: claude({ model: "sonnet", reasoning: "high" }),
-  branch: { mode: "named", name: "feature/settings" },
-});
-
-const first = await sandbox.dispatch({
-  brief: { text: "Implement settings validation." },
-});
-const tests = await sandbox.command({ executable: "npm", arguments: ["test"] });
-if (tests.status !== 0)
-  await first.resume({ brief: { text: "Fix the failing tests." } });
-await sandbox.attach();
-```
-
-Commands return nonzero statuses; agent dispatches throw on agent failure. `AbortSignal`, command deadlines and idle watchdogs stop the current operation while leaving a warm sandbox usable. A sandbox accepts one active operation at a time. Use separate sandboxes for parallel work.
-
-The default agent is optional for a warm sandbox. Pass `agent` to individual `sandbox.dispatch` or `sandbox.attach` calls to switch between Codex and Claude, or change models, without recreating the environment. Each job receives only its selected adapter's variables.
-
-## Own the workspace separately
-
-```ts
-import { openWorkspace, codex, claude } from "@elie-laloum/outpost";
-
-await using workspace = await openWorkspace({
-  branch: { mode: "named", name: "feature/shared-work" },
-  copies: [".env.test"],
-});
-
-await workspace.dispatch({
-  agent: codex(),
-  brief: { text: "Implement the feature and commit." },
-});
-await workspace.dispatch({
-  agent: claude(),
-  brief: { text: "Review the implementation, test and commit fixes." },
-});
-```
-
-A supplied workspace outlives each sandbox. Its owner closes it. Closing a dirty workspace returns `retainedDirectory`; closing a clean managed workspace removes the worktree. Named branches remain. `workspace.sandbox()` and `workspace.attach()` provide the other lifecycles. Warm integration workspaces can call `sandbox.workspace.integrate()` explicitly.
-
-## Prompts and iteration
-
-Provide exactly one `brief`: literal `text`, or a `file` with optional primitive `values`. Files are reread each pass; inline text is never expanded.
-
-```ts
-const result = await dispatch({
-  agent: codex(),
-  brief: { file: ".outpost/brief.md", values: { OBJECTIVE: "Fix validation" } },
-  passes: 5,
-  until: ["<outpost>done</outpost>"],
-  idleMs: 600_000,
-  settleMs: 60_000,
+  brief: { text: "Fix the failing tests, verify and commit." },
 });
+console.log(result.branch, result.commits);
 ```
 
-Files support `{{OBJECTIVE}}`, reserved `{{WORK_BRANCH}}` and `{{BASE_BRANCH}}`, and shell expansion such as `` !`git status --short` ``. Original file commands run concurrently inside the sandbox after setup hooks. Substituted text cannot introduce additional commands. Values inserted into an existing command are shell input: only interpolate trusted values there. Missing variables fail; unused variables warn through `warn`.
-
-Completion markers stop the loop. If the process hangs after a marker, the completion grace period resets on subsequent output and then stops that command. Every turn includes its duration, native transcript path when available and raw token counts (input, cache read, cache creation, output); the result includes aggregate usage and the matched completion marker.
+Learn about [sandboxes](https://elie-laloum.github.io/outpost/sandboxes/lifecycle/), [workflows](https://elie-laloum.github.io/outpost/workflows/graph/), [providers](https://elie-laloum.github.io/outpost/providers/overview/) and [recovery](https://elie-laloum.github.io/outpost/operations/recovery/) in the English/French documentation. The [roadmap](https://elie-laloum.github.io/outpost/project/roadmap/) describes future work.
 
-## Structured responses and conversations
-
-```ts
-import { response } from "@elie-laloum/outpost";
-
-const result = await dispatch({
-  agent: codex(),
-  brief: {
-    text: "Analyze the repository. Return <report>JSON with an ok boolean</report>.",
-  },
-  response: response.json({
-    tag: "report",
-    repairs: 2,
-    schema(input) {
-      if (
-        !input ||
-        typeof input !== "object" ||
-        !("ok" in input) ||
-        typeof input.ok !== "boolean"
-      ) {
-        throw new Error("Expected an ok boolean");
-      }
-      return { ok: input.ok };
-    },
-  }),
-});
-
-console.log(result.value.ok);
-await result.resume({ brief: { text: "Explain the result." } });
-await result.fork({ brief: { text: "Explore a different solution." } });
-```
-
-`response.text` extracts tagged text. `response.json` accepts a function or a Standard Schema validator, including asynchronous validation. Structured responses and conversation continuations require one pass. Repairs resume the same conversation. `ResponseError.recovery` exposes the conversation, commits and recovery paths. `recoveryDetails(error)` also retrieves recovery metadata for other failures without replacing cancellation reasons.
-
-Native conversation capture is enabled by default. Transcripts are saved to the host agent's own storage and working-directory fields are rewritten for host resumption. Claude child transcripts are copied on a best-effort basis. Set `saveConversations: false` on an adapter to opt out. Forks create a new conversation; use a separate workspace when filesystem isolation is also required.
-
-Each cold `dispatch({ passes })` provisions a fresh sandbox per pass. `sandbox.dispatch({ passes })` deliberately reuses its environment. Relative brief filenames resolve from the caller’s working directory. Cold result `resume`/`fork` accepts new branch/provider/hook settings; warm result methods retain the sandbox’s settings. See [1.1 migration notes](docs/migration-1.1.md).
-
-## Typed workflows
-
-```ts
-import { task, workflow } from "@elie-laloum/outpost";
-
-const inspect = task({
-  key: "inspect",
-  perform: async () => ({ ready: true }),
-});
-const implement = task({
-  key: "implement",
-  after: [inspect],
-  retry: { attempts: 2, delayMs: 500 },
-  perform: async (context) => context.value(inspect).ready,
-});
-const result = await workflow("delivery", [inspect, implement]).start({
-  concurrency: 2,
-});
-result.unwrap();
-console.log(result.value(implement));
-```
-
-The graph validates dependencies and cycles before running. Results are typed and scoped to one execution. Conditions, cooperative cancellation, retries, concurrency limits, observer events and Mermaid diagrams are built in. `agentTask`, `commandTask` and `isolatedTask` connect workflows to sandbox operations. [Workflow guide](docs/workflows.md).
-
-## Issue campaigns
-
-`campaign({ agent, provider, backlog })` loads a backlog, validates a typed plan, allocates a branch per issue and bounds parallel implementation. Review shares each issue sandbox. A merge phase validates the combined work; issue closure occurs only after integration into the host branch. The backlog is refreshed for the next cycle. GitHub and Beads connectors expose list, detail and close operations; custom trackers implement `Backlog`.
-
-[Campaign configuration and starter examples](docs/workflows.md#issue-campaigns).
-
-## Configuration and extension
-
-Provider settings cover environment variables, file/directory mounts, networks, resource limits, devices, extra groups and SELinux labels. Hooks run at workspace readiness and after sandbox creation. The two post-creation hook groups run concurrently. Host commands run in order; sandbox commands run concurrently and cancel their siblings on failure. [Complete API](docs/api.md) and [provider reference](docs/providers.md).
-
-Outpost reads only `.outpost/.env`. Nonempty file values win; empty declarations inherit matching process values. The repository-root `.env` is not imported. Explicit provider and adapter variables override those values. The same variable cannot be declared by both provider and adapter. Logs default to `.outpost/logs`, with `false`, `"stdout"`, custom files and verbose modes available.
-
-Implement `AgentAdapter` to add an agent. Implement `SandboxProvider` directly or use `mountedProvider`/`remoteProvider` to add an execution backend. Domain contracts do not depend on a specific cloud SDK. [Architecture](docs/architecture.md).
-
-## Verification and releases
+## Development
 
 ```sh
 npm ci
 npm run check
 npm run coverage
 npm run test:package
+npm ci --prefix docs
+npm run docs:sync
+npm run docs:build
+npm run docs:test
 ```
 
-GitHub Actions runs unit and functional tests on Linux, Windows and macOS, enforces 80% line/function/branch coverage, installs the packed package, and runs real Docker and Podman tests. Cloud contract tests use controlled SDK doubles; live cloud/model checks require the corresponding credentials. No GitLab CI pipeline is required.
-
-Version tags are created on GitLab and mirrored. The release workflow validates the tag, runs CI, publishes GitHub Packages and attaches the installable tarball to a GitHub release. Optional npm publication uses trusted publishing when enabled. [Release procedure and registry setup](docs/operations.md).
-
-## Execution boundary
-
-Docker and Podman mount the selected worktree and Git metadata. Agents can edit that repository and its Git state. This protects unrelated host paths but is not a boundary against a hostile agent attacking the shared repository. Mount only what the task needs. `local()` runs directly on your machine without isolation. Cloud providers synchronize via Git bundles and file transfers; concurrent host changes cause a recovery error instead of being overwritten.
-
-Logs, conversation files and recovery files can contain private prompts or source. Runtime folders and `.env` are excluded from version control. See [Security](SECURITY.md) for the precise boundaries.
+[GitLab](https://gitlab.elielaloum.com/elielaloum/outpost) is the canonical repository. [GitHub](https://github.com/elie-laloum/outpost) is the mirror running tests, package releases and GitHub Pages. Documentation is validated on main and deployed only after a successful stable release.
 
-MIT licensed. See [LICENSE](LICENSE).
+See [SECURITY.md](SECURITY.md) for execution boundaries and [LICENSE](LICENSE) for the MIT license.

package/dist/adapters/agents/claude-adapter.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAdapter } from "../../domain/agent.types.ts";
+import type { ClaudeSettings } from "./settings.types.ts";
+export declare function claude(settings?: ClaudeSettings): AgentAdapter;

package/dist/adapters/agents/claude-adapter.js

@@ -0,0 +1,15 @@
+import { claudeEvents, claudeTranscriptUsage } from "./claude-events.js";
+import { claudeRequest } from "./claude-request.js";
+export function claude(settings = {}) {
+    return Object.freeze({
+        name: "claude",
+        conversations: "claude",
+        resumable: true,
+        capture: settings.saveConversations ?? true,
+        variables: Object.freeze({ ...settings.variables }),
+        request: (input) => claudeRequest(settings, input),
+        events: claudeEvents,
+        transcriptUsage: claudeTranscriptUsage,
+    });
+}
+//# sourceMappingURL=claude-adapter.js.map

package/dist/adapters/agents/claude-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-adapter.js","sourceRoot":"","sources":["../../../src/adapters/agents/claude-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,UAAU,MAAM,CAAC,WAA2B,EAAE;IAClD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ;QACd,aAAa,EAAE,QAAQ;QACvB,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,QAAQ,CAAC,iBAAiB,IAAI,IAAI;QAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;QACnD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC;QAClD,MAAM,EAAE,YAAY;QACpB,eAAe,EAAE,qBAAqB;KAChB,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["import type { AgentAdapter } from \"../../domain/agent.types.ts\";\nimport { claudeEvents, claudeTranscriptUsage } from \"./claude-events.ts\";\nimport { claudeRequest } from \"./claude-request.ts\";\nimport type { ClaudeSettings } from \"./settings.types.ts\";\n\nexport function claude(settings: ClaudeSettings = {}): AgentAdapter {\n  return Object.freeze({\n    name: \"claude\",\n    conversations: \"claude\",\n    resumable: true,\n    capture: settings.saveConversations ?? true,\n    variables: Object.freeze({ ...settings.variables }),\n    request: (input) => claudeRequest(settings, input),\n    events: claudeEvents,\n    transcriptUsage: claudeTranscriptUsage,\n  } satisfies AgentAdapter);\n}\n"]}

package/dist/adapters/agents/claude-events.d.ts

@@ -0,0 +1,3 @@
+import type { AgentEvent, Usage } from "../../domain/agent.types.ts";
+export declare function claudeEvents(line: string): AgentEvent[];
+export declare function claudeTranscriptUsage(text: string): Usage | undefined;

package/dist/adapters/agents/claude-events.js

@@ -0,0 +1,63 @@
+import { decodeEvent, decodeLine } from "./event-decoder.js";
+import { asRecord, decodeRecord, numberOrZero } from "./protocol.js";
+function tokens(value) {
+    const usage = asRecord(value);
+    return {
+        input: numberOrZero(usage.input_tokens),
+        cacheCreated: numberOrZero(usage.cache_creation_input_tokens),
+        cached: numberOrZero(usage.cache_read_input_tokens),
+        output: numberOrZero(usage.output_tokens),
+    };
+}
+function system(event) {
+    return typeof event.session_id === "string"
+        ? [{ kind: "conversation", id: event.session_id }]
+        : [];
+}
+function assistant(event) {
+    const content = asRecord(event.message).content;
+    if (!Array.isArray(content))
+        return [];
+    return content.flatMap((part) => decodeEvent(asRecord(part), {
+        text: (block) => typeof block.text === "string"
+            ? [{ kind: "text", text: block.text }]
+            : [],
+        tool_use: (block) => [
+            { kind: "tool", name: String(block.name), input: block.input },
+        ],
+    }));
+}
+function result(event) {
+    const events = [];
+    if (!event.is_error && typeof event.result === "string")
+        events.push({ kind: "result", text: event.result });
+    if (event.usage)
+        events.push({ kind: "usage", tokens: tokens(event.usage) });
+    events.push(event.is_error
+        ? {
+            kind: "failure",
+            message: String(event.result ?? JSON.stringify(event.errors) ?? "Agent failed"),
+        }
+        : { kind: "finished" });
+    return events;
+}
+export function claudeEvents(line) {
+    return decodeLine(line, {
+        system,
+        assistant,
+        result,
+    });
+}
+export function claudeTranscriptUsage(text) {
+    let usage;
+    for (const line of text.split(/\r?\n/)) {
+        const event = decodeRecord(line);
+        if (event?.type !== "assistant")
+            continue;
+        const message = asRecord(event.message);
+        if (message.usage)
+            usage = tokens(message.usage);
+    }
+    return usage;
+}
+//# sourceMappingURL=claude-events.js.map

package/dist/adapters/agents/claude-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-events.js","sourceRoot":"","sources":["../../../src/adapters/agents/claude-events.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentEvent, Usage } from \"../../domain/agent.types.ts\";\nimport { decodeEvent, decodeLine } from \"./event-decoder.ts\";\nimport { asRecord, decodeRecord, numberOrZero } from \"./protocol.ts\";\nimport type { EventDecoders, ProtocolRecord } from \"./protocol.types.ts\";\n\nfunction tokens(value: unknown): Usage {\n  const usage = asRecord(value);\n  return {\n    input: numberOrZero(usage.input_tokens),\n    cacheCreated: numberOrZero(usage.cache_creation_input_tokens),\n    cached: numberOrZero(usage.cache_read_input_tokens),\n    output: numberOrZero(usage.output_tokens),\n  };\n}\n\nfunction system(event: ProtocolRecord): AgentEvent[] {\n  return typeof event.session_id === \"string\"\n    ? [{ kind: \"conversation\", id: event.session_id }]\n    : [];\n}\n\nfunction assistant(event: ProtocolRecord): AgentEvent[] {\n  const content = asRecord(event.message).content;\n  if (!Array.isArray(content)) return [];\n  return content.flatMap((part) =>\n    decodeEvent(asRecord(part), {\n      text: (block) =>\n        typeof block.text === \"string\"\n          ? [{ kind: \"text\", text: block.text }]\n          : [],\n      tool_use: (block) => [\n        { kind: \"tool\", name: String(block.name), input: block.input },\n      ],\n    }),\n  );\n}\n\nfunction result(event: ProtocolRecord): AgentEvent[] {\n  const events: AgentEvent[] = [];\n  if (!event.is_error && typeof event.result === \"string\")\n    events.push({ kind: \"result\", text: event.result });\n  if (event.usage) events.push({ kind: \"usage\", tokens: tokens(event.usage) });\n  events.push(\n    event.is_error\n      ? {\n          kind: \"failure\",\n          message: String(\n            event.result ?? JSON.stringify(event.errors) ?? \"Agent failed\",\n          ),\n        }\n      : { kind: \"finished\" },\n  );\n  return events;\n}\n\nexport function claudeEvents(line: string): AgentEvent[] {\n  return decodeLine(line, {\n    system,\n    assistant,\n    result,\n  } satisfies EventDecoders);\n}\n\nexport function claudeTranscriptUsage(text: string): Usage | undefined {\n  let usage: Usage | undefined;\n  for (const line of text.split(/\\r?\\n/)) {\n    const event = decodeRecord(line);\n    if (event?.type !== \"assistant\") continue;\n    const message = asRecord(event.message);\n    if (message.usage) usage = tokens(message.usage);\n  }\n  return usage;\n}\n"]}

package/dist/adapters/agents/claude-request.d.ts

@@ -0,0 +1,4 @@
+import type { AgentInput } from "../../domain/agent.types.ts";
+import type { Command } from "../../domain/command.types.ts";
+import type { ClaudeSettings } from "./settings.types.ts";
+export declare function claudeRequest(settings: ClaudeSettings, input: AgentInput): Command;

package/dist/adapters/agents/claude-request.js

@@ -0,0 +1,30 @@
+import { validateContinuation } from "./continuation.js";
+export function claudeRequest(settings, input) {
+    validateContinuation(input);
+    const args = [];
+    if (!input.interactive)
+        args.push("--print", "--verbose", "--output-format", "stream-json");
+    if (settings.model)
+        args.push("--model", settings.model);
+    if (settings.reasoning)
+        args.push("--effort", settings.reasoning);
+    if (settings.permissions)
+        args.push("--permission-mode", settings.permissions);
+    if (!settings.permissions && !input.interactive)
+        args.push("--dangerously-skip-permissions");
+    if (input.continuation) {
+        args.push("--resume", input.continuation.id);
+        if (input.continuation.fork)
+            args.push("--fork-session");
+    }
+    if (input.interactive && input.text !== undefined)
+        args.push("--", input.text);
+    return {
+        executable: "claude",
+        arguments: args,
+        ...(input.interactive
+            ? { interactive: true }
+            : { stdin: input.text ?? "" }),
+    };
+}
+//# sourceMappingURL=claude-request.js.map

package/dist/adapters/agents/claude-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-request.js","sourceRoot":"","sources":["../../../src/adapters/agents/claude-request.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,MAAM,UAAU,aAAa,CAC3B,QAAwB,EACxB,KAAiB;IAEjB,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC,WAAW;QACpB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC;IACtE,IAAI,QAAQ,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,QAAQ,CAAC,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClE,IAAI,QAAQ,CAAC,WAAW;QACtB,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACvD,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,WAAW;QAC7C,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO;QACL,UAAU,EAAE,QAAQ;QACpB,SAAS,EAAE,IAAI;QACf,GAAG,CAAC,KAAK,CAAC,WAAW;YACnB,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;YACvB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentInput } from \"../../domain/agent.types.ts\";\nimport type { Command } from \"../../domain/command.types.ts\";\nimport { validateContinuation } from \"./continuation.ts\";\nimport type { ClaudeSettings } from \"./settings.types.ts\";\n\nexport function claudeRequest(\n  settings: ClaudeSettings,\n  input: AgentInput,\n): Command {\n  validateContinuation(input);\n  const args: string[] = [];\n  if (!input.interactive)\n    args.push(\"--print\", \"--verbose\", \"--output-format\", \"stream-json\");\n  if (settings.model) args.push(\"--model\", settings.model);\n  if (settings.reasoning) args.push(\"--effort\", settings.reasoning);\n  if (settings.permissions)\n    args.push(\"--permission-mode\", settings.permissions);\n  if (!settings.permissions && !input.interactive)\n    args.push(\"--dangerously-skip-permissions\");\n  if (input.continuation) {\n    args.push(\"--resume\", input.continuation.id);\n    if (input.continuation.fork) args.push(\"--fork-session\");\n  }\n  if (input.interactive && input.text !== undefined)\n    args.push(\"--\", input.text);\n  return {\n    executable: \"claude\",\n    arguments: args,\n    ...(input.interactive\n      ? { interactive: true }\n      : { stdin: input.text ?? \"\" }),\n  };\n}\n"]}

package/dist/adapters/agents/codex-adapter.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAdapter } from "../../domain/agent.types.ts";
+import type { CodexSettings } from "./settings.types.ts";
+export declare function codex(settings?: CodexSettings): AgentAdapter;

package/dist/adapters/agents/codex-adapter.js

@@ -0,0 +1,14 @@
+import { codexEvents } from "./codex-events.js";
+import { codexRequest } from "./codex-request.js";
+export function codex(settings = {}) {
+    return Object.freeze({
+        name: "codex",
+        conversations: "codex",
+        resumable: true,
+        capture: settings.saveConversations ?? true,
+        variables: Object.freeze({ ...settings.variables }),
+        request: (input) => codexRequest(settings, input),
+        events: codexEvents,
+    });
+}
+//# sourceMappingURL=codex-adapter.js.map

package/dist/adapters/agents/codex-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-adapter.js","sourceRoot":"","sources":["../../../src/adapters/agents/codex-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,UAAU,KAAK,CAAC,WAA0B,EAAE;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,OAAO;QACb,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,QAAQ,CAAC,iBAAiB,IAAI,IAAI;QAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;QACnD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC;QACjD,MAAM,EAAE,WAAW;KACG,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["import type { AgentAdapter } from \"../../domain/agent.types.ts\";\nimport { codexEvents } from \"./codex-events.ts\";\nimport { codexRequest } from \"./codex-request.ts\";\nimport type { CodexSettings } from \"./settings.types.ts\";\n\nexport function codex(settings: CodexSettings = {}): AgentAdapter {\n  return Object.freeze({\n    name: \"codex\",\n    conversations: \"codex\",\n    resumable: true,\n    capture: settings.saveConversations ?? true,\n    variables: Object.freeze({ ...settings.variables }),\n    request: (input) => codexRequest(settings, input),\n    events: codexEvents,\n  } satisfies AgentAdapter);\n}\n"]}

package/dist/adapters/agents/codex-events.d.ts

@@ -0,0 +1,2 @@
+import type { AgentEvent } from "../../domain/agent.types.ts";
+export declare function codexEvents(line: string): AgentEvent[];

package/dist/adapters/agents/codex-events.js

@@ -0,0 +1,58 @@
+import { decodeEvent, decodeLine } from "./event-decoder.js";
+import { asRecord, numberOrZero } from "./protocol.js";
+function conversation(event) {
+    return typeof event.thread_id === "string"
+        ? [{ kind: "conversation", id: event.thread_id }]
+        : [];
+}
+function completedItem(event) {
+    return decodeEvent(asRecord(event.item), {
+        agent_message: (item) => typeof item.text === "string" ? [{ kind: "text", text: item.text }] : [],
+    });
+}
+function startedItem(event) {
+    return decodeEvent(asRecord(event.item), {
+        command_execution: (item) => [
+            { kind: "tool", name: "command", input: item.command },
+        ],
+        mcp_tool_call: (item) => [
+            { kind: "tool", name: String(item.tool), input: item.arguments },
+        ],
+    });
+}
+function completedTurn(event) {
+    const usage = asRecord(event.usage);
+    return [
+        {
+            kind: "usage",
+            tokens: {
+                input: numberOrZero(usage.input_tokens),
+                cached: numberOrZero(usage.cached_input_tokens),
+                output: numberOrZero(usage.output_tokens),
+            },
+        },
+        { kind: "finished" },
+    ];
+}
+function failure(event) {
+    const error = typeof event.error === "string"
+        ? event.error
+        : asRecord(event.error).message;
+    return [
+        {
+            kind: "failure",
+            message: String(event.message ?? error ?? "Agent failed"),
+        },
+    ];
+}
+export function codexEvents(line) {
+    return decodeLine(line, {
+        "thread.started": conversation,
+        "item.completed": completedItem,
+        "item.started": startedItem,
+        "turn.completed": completedTurn,
+        error: failure,
+        "turn.failed": failure,
+    });
+}
+//# sourceMappingURL=codex-events.js.map

package/dist/adapters/agents/codex-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-events.js","sourceRoot":"","sources":["../../../src/adapters/agents/codex-events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGvD,SAAS,YAAY,CAAC,KAAqB;IACzC,OAAO,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACxC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QACjD,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAS,aAAa,CAAC,KAAqB;IAC1C,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QACvC,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CACtB,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;KAC3E,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,KAAqB;IACxC,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QACvC,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE;SACvD;QACD,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YACvB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE;SACjE;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAqB;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO;QACL;YACE,IAAI,EAAE,OAAO;YACb,MAAM,EAAE;gBACN,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC;gBACvC,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,mBAAmB,CAAC;gBAC/C,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC;aAC1C;SACF;QACD,EAAE,IAAI,EAAE,UAAU,EAAE;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,KAAqB;IACpC,MAAM,KAAK,GACT,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC7B,CAAC,CAAC,KAAK,CAAC,KAAK;QACb,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;IACpC,OAAO;QACL;YACE,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,IAAI,cAAc,CAAC;SAC1D;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,CAAC,IAAI,EAAE;QACtB,gBAAgB,EAAE,YAAY;QAC9B,gBAAgB,EAAE,aAAa;QAC/B,cAAc,EAAE,WAAW;QAC3B,gBAAgB,EAAE,aAAa;QAC/B,KAAK,EAAE,OAAO;QACd,aAAa,EAAE,OAAO;KACvB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { AgentEvent } from \"../../domain/agent.types.ts\";\nimport { decodeEvent, decodeLine } from \"./event-decoder.ts\";\nimport { asRecord, numberOrZero } from \"./protocol.ts\";\nimport type { ProtocolRecord } from \"./protocol.types.ts\";\n\nfunction conversation(event: ProtocolRecord): AgentEvent[] {\n  return typeof event.thread_id === \"string\"\n    ? [{ kind: \"conversation\", id: event.thread_id }]\n    : [];\n}\n\nfunction completedItem(event: ProtocolRecord): AgentEvent[] {\n  return decodeEvent(asRecord(event.item), {\n    agent_message: (item) =>\n      typeof item.text === \"string\" ? [{ kind: \"text\", text: item.text }] : [],\n  });\n}\n\nfunction startedItem(event: ProtocolRecord): AgentEvent[] {\n  return decodeEvent(asRecord(event.item), {\n    command_execution: (item) => [\n      { kind: \"tool\", name: \"command\", input: item.command },\n    ],\n    mcp_tool_call: (item) => [\n      { kind: \"tool\", name: String(item.tool), input: item.arguments },\n    ],\n  });\n}\n\nfunction completedTurn(event: ProtocolRecord): AgentEvent[] {\n  const usage = asRecord(event.usage);\n  return [\n    {\n      kind: \"usage\",\n      tokens: {\n        input: numberOrZero(usage.input_tokens),\n        cached: numberOrZero(usage.cached_input_tokens),\n        output: numberOrZero(usage.output_tokens),\n      },\n    },\n    { kind: \"finished\" },\n  ];\n}\n\nfunction failure(event: ProtocolRecord): AgentEvent[] {\n  const error =\n    typeof event.error === \"string\"\n      ? event.error\n      : asRecord(event.error).message;\n  return [\n    {\n      kind: \"failure\",\n      message: String(event.message ?? error ?? \"Agent failed\"),\n    },\n  ];\n}\n\nexport function codexEvents(line: string): AgentEvent[] {\n  return decodeLine(line, {\n    \"thread.started\": conversation,\n    \"item.completed\": completedItem,\n    \"item.started\": startedItem,\n    \"turn.completed\": completedTurn,\n    error: failure,\n    \"turn.failed\": failure,\n  });\n}\n"]}

package/dist/adapters/agents/codex-request.d.ts

@@ -0,0 +1,4 @@
+import type { AgentInput } from "../../domain/agent.types.ts";
+import type { Command } from "../../domain/command.types.ts";
+import type { CodexSettings } from "./settings.types.ts";
+export declare function codexRequest(settings: CodexSettings, input: AgentInput): Command;

package/dist/adapters/agents/codex-request.js

@@ -0,0 +1,29 @@
+import { validateContinuation } from "./continuation.js";
+export function codexRequest(settings, input) {
+    validateContinuation(input);
+    const args = [];
+    if (settings.approvalReviewer === "auto_review")
+        args.push("-a", "on-request", "-s", "danger-full-access", "-c", 'approvals_reviewer="auto_review"');
+    if (settings.approvalReviewer !== "auto_review" && !input.interactive)
+        args.push("--dangerously-bypass-approvals-and-sandbox");
+    if (settings.model)
+        args.push("--model", settings.model);
+    if (settings.reasoning)
+        args.push("-c", `model_reasoning_effort="${settings.reasoning}"`);
+    if (!input.interactive)
+        args.push("exec");
+    if (input.continuation)
+        args.push(input.continuation.fork ? "fork" : "resume", input.continuation.id);
+    if (!input.interactive)
+        args.push("--json", "-");
+    if (input.interactive && input.text !== undefined)
+        args.push("--", input.text);
+    return {
+        executable: "codex",
+        arguments: args,
+        ...(input.interactive
+            ? { interactive: true }
+            : { stdin: input.text ?? "" }),
+    };
+}
+//# sourceMappingURL=codex-request.js.map

package/dist/adapters/agents/codex-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-request.js","sourceRoot":"","sources":["../../../src/adapters/agents/codex-request.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,MAAM,UAAU,YAAY,CAC1B,QAAuB,EACvB,KAAiB;IAEjB,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,QAAQ,CAAC,gBAAgB,KAAK,aAAa;QAC7C,IAAI,CAAC,IAAI,CACP,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,oBAAoB,EACpB,IAAI,EACJ,kCAAkC,CACnC,CAAC;IACJ,IAAI,QAAQ,CAAC,gBAAgB,KAAK,aAAa,IAAI,CAAC,KAAK,CAAC,WAAW;QACnE,IAAI,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC1D,IAAI,QAAQ,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,QAAQ,CAAC,SAAS;QACpB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,2BAA2B,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK,CAAC,WAAW;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,YAAY;QACpB,IAAI,CAAC,IAAI,CACP,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAC3C,KAAK,CAAC,YAAY,CAAC,EAAE,CACtB,CAAC;IACJ,IAAI,CAAC,KAAK,CAAC,WAAW;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO;QACL,UAAU,EAAE,OAAO;QACnB,SAAS,EAAE,IAAI;QACf,GAAG,CAAC,KAAK,CAAC,WAAW;YACnB,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;YACvB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentInput } from \"../../domain/agent.types.ts\";\nimport type { Command } from \"../../domain/command.types.ts\";\nimport { validateContinuation } from \"./continuation.ts\";\nimport type { CodexSettings } from \"./settings.types.ts\";\n\nexport function codexRequest(\n  settings: CodexSettings,\n  input: AgentInput,\n): Command {\n  validateContinuation(input);\n  const args: string[] = [];\n  if (settings.approvalReviewer === \"auto_review\")\n    args.push(\n      \"-a\",\n      \"on-request\",\n      \"-s\",\n      \"danger-full-access\",\n      \"-c\",\n      'approvals_reviewer=\"auto_review\"',\n    );\n  if (settings.approvalReviewer !== \"auto_review\" && !input.interactive)\n    args.push(\"--dangerously-bypass-approvals-and-sandbox\");\n  if (settings.model) args.push(\"--model\", settings.model);\n  if (settings.reasoning)\n    args.push(\"-c\", `model_reasoning_effort=\"${settings.reasoning}\"`);\n  if (!input.interactive) args.push(\"exec\");\n  if (input.continuation)\n    args.push(\n      input.continuation.fork ? \"fork\" : \"resume\",\n      input.continuation.id,\n    );\n  if (!input.interactive) args.push(\"--json\", \"-\");\n  if (input.interactive && input.text !== undefined)\n    args.push(\"--\", input.text);\n  return {\n    executable: \"codex\",\n    arguments: args,\n    ...(input.interactive\n      ? { interactive: true }\n      : { stdin: input.text ?? \"\" }),\n  };\n}\n"]}

package/dist/adapters/agents/continuation.d.ts

@@ -0,0 +1,2 @@
+import type { AgentInput } from "../../domain/agent.types.ts";
+export declare function validateContinuation(input: AgentInput): void;

package/dist/adapters/agents/continuation.js

@@ -0,0 +1,6 @@
+import { invariant } from "../../domain/errors.js";
+export function validateContinuation(input) {
+    if (input.continuation)
+        invariant(/^[A-Za-z0-9_-]+$/.test(input.continuation.id), "Invalid conversation identifier");
+}
+//# sourceMappingURL=continuation.js.map

package/dist/adapters/agents/continuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation.js","sourceRoot":"","sources":["../../../src/adapters/agents/continuation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,UAAU,oBAAoB,CAAC,KAAiB;IACpD,IAAI,KAAK,CAAC,YAAY;QACpB,SAAS,CACP,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,EAC9C,iCAAiC,CAClC,CAAC;AACN,CAAC","sourcesContent":["import type { AgentInput } from \"../../domain/agent.types.ts\";\nimport { invariant } from \"../../domain/errors.ts\";\n\nexport function validateContinuation(input: AgentInput): void {\n  if (input.continuation)\n    invariant(\n      /^[A-Za-z0-9_-]+$/.test(input.continuation.id),\n      \"Invalid conversation identifier\",\n    );\n}\n"]}

package/dist/adapters/agents/event-decoder.d.ts

@@ -0,0 +1,4 @@
+import type { AgentEvent } from "../../domain/agent.types.ts";
+import type { EventDecoders, ProtocolRecord } from "./protocol.types.ts";
+export declare function decodeEvent(event: ProtocolRecord, handlers: EventDecoders): AgentEvent[];
+export declare function decodeLine(line: string, handlers: EventDecoders): AgentEvent[];

package/dist/adapters/agents/event-decoder.js

@@ -0,0 +1,15 @@
+import { decodeRecord } from "./protocol.js";
+export function decodeEvent(event, handlers) {
+    const handler = typeof event.type === "string" && Object.hasOwn(handlers, event.type)
+        ? handlers[event.type]
+        : undefined;
+    return handler?.(event) ?? [];
+}
+export function decodeLine(line, handlers) {
+    const event = decodeRecord(line);
+    if (!event)
+        return [{ kind: "raw", value: line }];
+    const events = decodeEvent(event, handlers);
+    return events.length ? events : [{ kind: "raw", value: event }];
+}
+//# sourceMappingURL=event-decoder.js.map

package/dist/adapters/agents/event-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-decoder.js","sourceRoot":"","sources":["../../../src/adapters/agents/event-decoder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,UAAU,WAAW,CACzB,KAAqB,EACrB,QAAuB;IAEvB,MAAM,OAAO,GACX,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC;QACnE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QACtB,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,QAAuB;IAEvB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAClE,CAAC","sourcesContent":["import type { AgentEvent } from \"../../domain/agent.types.ts\";\nimport { decodeRecord } from \"./protocol.ts\";\nimport type { EventDecoders, ProtocolRecord } from \"./protocol.types.ts\";\n\nexport function decodeEvent(\n  event: ProtocolRecord,\n  handlers: EventDecoders,\n): AgentEvent[] {\n  const handler =\n    typeof event.type === \"string\" && Object.hasOwn(handlers, event.type)\n      ? handlers[event.type]\n      : undefined;\n  return handler?.(event) ?? [];\n}\n\nexport function decodeLine(\n  line: string,\n  handlers: EventDecoders,\n): AgentEvent[] {\n  const event = decodeRecord(line);\n  if (!event) return [{ kind: \"raw\", value: line }];\n  const events = decodeEvent(event, handlers);\n  return events.length ? events : [{ kind: \"raw\", value: event }];\n}\n"]}

package/dist/adapters/agents/protocol.d.ts

@@ -0,0 +1,3 @@
+export declare function asRecord(value: unknown): Record<string, unknown>;
+export declare function numberOrZero(value: unknown): number;
+export declare function decodeRecord(line: string): Record<string, unknown> | undefined;