@tagma/sdk 0.5.0 → 0.5.2

package/README.md

@@ -15,7 +15,7 @@
 > the npm registry website and cannot be removed — please ignore it and use
 > the command above.)_
 
-A local AI task orchestration SDK for [Bun](https://bun.sh). Define multi-track pipelines in YAML, run AI coding agents (Claude Code, Codex, OpenCode) and shell commands in parallel with dependency resolution, approval gates, and lifecycle hooks.
+A local AI task orchestration SDK for [Bun](https://bun.sh). Define multi-track pipelines in YAML, run AI coding agents (OpenCode, Codex, Claude Code) and shell commands in parallel with dependency resolution, approval gates, and lifecycle hooks.
 
 ## Install
 
@@ -35,7 +35,7 @@ pipeline:
   tracks:
     - id: backend
       name: Backend
-      driver: claude-code
+      driver: opencode
       permissions: { read: true, write: true, execute: false }
       tasks:
         - id: implement
@@ -65,7 +65,7 @@ console.log(result.success ? 'Done' : 'Failed');
 ## Features
 
 - **Multi-track DAG execution** -- tasks run in parallel across tracks, respecting `depends_on` ordering
-- **Driver plugins** -- built-in `claude-code` driver; install `@tagma/driver-codex` or `@tagma/driver-opencode` for other agents
+- **Driver plugins** -- built-in `opencode` driver; install `@tagma/driver-codex` or `@tagma/driver-claude-code` for other agents
 - **Session handoff** -- `continue_from` passes context between tasks (session resume or text injection)
 - **Approval gates** -- trigger-based approval with stdin and WebSocket adapters
 - **Lifecycle hooks** -- `pipeline_start`, `task_start`, `task_success`, `task_failure`, `pipeline_complete`, `pipeline_error`
@@ -80,10 +80,11 @@ console.log(result.success ? 'Done' : 'Failed');
 ```yaml
 pipeline:
   name: my-pipeline
-  driver: claude-code
+  driver: opencode
   timeout: 30m
   plugins:
     - '@tagma/driver-codex'
+    - '@tagma/driver-claude-code'
   hooks:
     pipeline_start: 'echo starting'
     task_start: 'echo task begin'
@@ -95,8 +96,8 @@ pipeline:
     - id: track-1
       name: Track One
       color: '#3b82f6'
-      driver: claude-code
-      model: claude-sonnet-4-6
+      driver: opencode
+      model: opencode/big-pickle
       agent_profile: senior
       cwd: ./services/backend
       permissions:
@@ -113,8 +114,8 @@ pipeline:
           name: Do something
           prompt: 'Your prompt here'
           timeout: 10m
-          driver: claude-code
-          model: claude-sonnet-4-6
+          driver: opencode
+          model: opencode/big-pickle
           agent_profile: senior
           cwd: ./src
           permissions:
@@ -143,7 +144,7 @@ pipeline:
 | Field     | Type            | Required | Description                                                                                |
 | --------- | --------------- | -------- | ------------------------------------------------------------------------------------------ |
 | `name`    | `string`        | Yes      | Pipeline name, used in logs and run IDs                                                    |
-| `driver`  | `string`        | No       | Default driver for all tracks/tasks (inherited). Built-in: `claude-code`                   |
+| `driver`  | `string`        | No       | Default driver for all tracks/tasks (inherited). Built-in: `opencode`                      |
 | `model`   | `string`        | No       | Default model for all tracks/tasks (inherited). Exact model name, e.g. `claude-sonnet-4-6` |
 | `timeout` | `string`        | No       | Pipeline-level timeout. Format: `"30s"`, `"5m"`, `"2h"`                                    |
 | `plugins` | `string[]`      | No       | External plugin packages to load, e.g. `["@tagma/driver-codex"]`                           |
@@ -280,7 +281,7 @@ Track-level `middlewares` apply to all tasks in the track. Setting task-level `m
 
 ### `bootstrapBuiltins()`
 
-Registers all built-in plugins (claude-code driver, file/manual triggers, completion checks, static-context middleware).
+Registers all built-in plugins (opencode driver, file/manual triggers, completion checks, static-context middleware).
 
 ### `loadPipeline(yaml: string, workDir: string): Promise<PipelineConfig>`
 
@@ -294,24 +295,27 @@ Options:
 
 - `approvalGateway` -- custom `ApprovalGateway` instance (defaults to `InMemoryApprovalGateway`)
 - `signal` -- `AbortSignal` to cancel the run externally
-- `onEvent` -- callback for real-time `PipelineEvent` updates:
-  - `pipeline_start` — pipeline began; includes `states: ReadonlyMap<taskId, TaskState>` (initial snapshot of all tasks at `waiting`)
-  - `task_status_change` — a task changed status; includes `state: TaskState` (complete snapshot at the time of change: `startedAt` is populated before the `running` event; `result` and `finishedAt` are populated before any terminal-status event)
+- `onEvent` -- callback for real-time `RunEventPayload` updates. Every payload carries `runId`. The editor server stamps a per-run `seq` on top of this payload before broadcasting over SSE (producing a `WireRunEvent`); the SDK itself does not stamp `seq`. Event variants:
+  - `run_start` — pipeline approved and all tasks transitioned to `waiting`; includes `tasks: RunTaskState[]` (wire-shape snapshot of every task). Fires only when the `pipeline_start` hook allows the run — blocked pipelines emit no wire events at all.
+  - `task_update` — a task's status or result changed; flat fields (`status`, `startedAt?`, `finishedAt?`, `durationMs?`, `exitCode?`, `stdout?`, `stderr?`, `stderrPath?`, `sessionId?`, `normalizedOutput?`, `resolvedDriver?`, `resolvedModel?`, `resolvedPermissions?`) so clients can fold partial updates with `??` semantics. `startedAt` is populated before the `running` transition; `finishedAt` and result fields are populated before any terminal-status transition. Terminal-state locking in the engine guarantees at most one terminal event per task.
   - `task_log` — a structured log line was written to `pipeline.log`. Mirrors every `Logger` call (info/warn/error/debug/section/quiet) and carries `{ taskId: string | null, level, timestamp, text }`. `taskId` is non-null for lines tagged with a `[task:<id>]` prefix (or passed explicitly to `section`/`quiet`) and `null` for pipeline-wide messages such as the configuration dump and DAG topology. Use this to stream the full run process into UIs without tailing the log file.
-  - `pipeline_end` — pipeline finished; includes `success: boolean`
+  - `run_end` — pipeline finished; includes `success: boolean` and `abortReason: 'timeout' | 'stop_all' | 'external' | null`. `null` means the run completed on its own steam (success may still be `false` if tasks failed).
+  - `run_error` — reserved for fatal engine errors surfaced over the wire.
+  - `approval_request` / `approval_resolved` — bridged from the approval gateway so hosts see approvals on the same channel as task updates, without separately subscribing to the gateway.
 - `runId` -- caller-supplied run ID. When provided the engine uses this instead of generating its own, keeping the caller and the SDK log directories aligned on the same ID
 - `maxLogRuns` -- number of per-run log directories to keep under `<workDir>/.tagma/logs/` (default: 20)
+- `skipPluginLoading` -- skip the engine's built-in `loadPlugins(config.plugins)` call. Set this when the host has already pre-loaded plugins from a custom resolution path (e.g. the editor loading from the user's workspace `node_modules`) so the engine doesn't re-resolve them via Node's default cwd-based import.
 
 ### `PipelineRunner`
 
 Higher-level wrapper for managing multiple concurrent pipeline runs — designed for sidecar / Tauri IPC scenarios where the frontend controls pipeline lifecycle by ID.
 
 ```ts
-const runner = new PipelineRunner(config, workDir);
+const runner = new PipelineRunner(config, workDir, options?); // options: Omit<RunPipelineOptions, 'signal' | 'onEvent'>
 
-// Subscribe before start — handler is called for every PipelineEvent
+// Subscribe before start — handler is called for every RunEventPayload
 const unsubscribe = runner.subscribe((event) => {
-  tauriEmit('pipeline_event', { id: runner.instanceId, event });
+  tauriEmit('run_event', { id: runner.instanceId, event });
 });
 
 runner.start(); // returns Promise<EngineResult>, idempotent
@@ -319,16 +323,16 @@ runner.start(); // returns Promise<EngineResult>, idempotent
 // Cancel from IPC
 runner.abort();
 
-// Available from the first pipeline_start event onward (not just after completion)
-// Returns null only if the pipeline has never started
-const states = runner.getStates(); // ReadonlyMap<taskId, TaskState> | null
+// Live wire-shape task mirror, maintained from run_start + task_update events.
+// Empty map before the first run_start; safe to read at any time.
+const tasks = runner.getTasks(); // ReadonlyMap<taskId, RunTaskState>
 ```
 
 Properties:
 
 - `instanceId` — stable ID assigned at construction, safe to use as a Map key before `start()`
-- `runId` — engine-assigned run ID, available after the first `pipeline_start` event (`null` until then)
-- `status` — `'idle' | 'running' | 'done' | 'aborted'`
+- `runId` — engine-assigned run ID, available after the first `run_start` event (`null` until then)
+- `status` — `'idle' | 'running' | 'done' | 'aborted'` (see `PipelineRunnerStatus`)
 
 ### `TriggerBlockedError` / `TriggerTimeoutError`
 
@@ -561,8 +565,8 @@ Truncates `text` to at most `maxBytes` UTF-8 bytes (default 16 KB), appending a
 | Package                                                                        | Description                |
 | ------------------------------------------------------------------------------ | -------------------------- |
 | [@tagma/types](https://www.npmjs.com/package/@tagma/types)                     | Shared TypeScript types    |
-| [@tagma/driver-codex](https://www.npmjs.com/package/@tagma/driver-codex)       | Codex CLI driver plugin    |
-| [@tagma/driver-opencode](https://www.npmjs.com/package/@tagma/driver-opencode) | OpenCode CLI driver plugin |
+| [@tagma/driver-codex](https://www.npmjs.com/package/@tagma/driver-codex)             | Codex CLI driver plugin       |
+| [@tagma/driver-claude-code](https://www.npmjs.com/package/@tagma/driver-claude-code) | Claude Code CLI driver plugin |
 
 ## License
 

package/dist/bootstrap.js

@@ -1,10 +1,10 @@
 import { registerPlugin } from './registry';
 // Built-in Drivers
-// Only claude-code is built in. Other drivers (codex, opencode) ship as
-// workspace plugins under plugins/ and must be declared in pipeline.yaml
+// Only opencode is built in. Other drivers (codex, claude-code) ship as
+// workspace plugins under packages/ and must be declared in pipeline.yaml
 // via the `plugins` field, e.g.:
-//   plugins: ["@tagma/driver-codex", "@tagma/driver-opencode"]
-import { ClaudeCodeDriver } from './drivers/claude-code';
+//   plugins: ["@tagma/driver-codex", "@tagma/driver-claude-code"]
+import { OpenCodeDriver } from './drivers/opencode';
 // Built-in Triggers
 import { FileTrigger } from './triggers/file';
 import { ManualTrigger } from './triggers/manual';
@@ -16,7 +16,7 @@ import { OutputCheckCompletion } from './completions/output-check';
 import { StaticContextMiddleware } from './middlewares/static-context';
 export function bootstrapBuiltins() {
     // Drivers
-    registerPlugin('drivers', 'claude-code', ClaudeCodeDriver);
+    registerPlugin('drivers', 'opencode', OpenCodeDriver);
     // Triggers
     registerPlugin('triggers', 'file', FileTrigger);
     registerPlugin('triggers', 'manual', ManualTrigger);

package/dist/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,mBAAmB;AACnB,wEAAwE;AACxE,yEAAyE;AACzE,iCAAiC;AACjC,+DAA+D;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,sBAAsB;AACtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,UAAU,iBAAiB;IAC/B,UAAU;IACV,cAAc,CAAC,SAAS,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC;IAE3D,WAAW;IACX,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAChD,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAEpD,cAAc;IACd,cAAc,CAAC,aAAa,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAC/D,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAC;IACnE,cAAc,CAAC,aAAa,EAAE,cAAc,EAAE,qBAAqB,CAAC,CAAC;IAErE,cAAc;IACd,cAAc,CAAC,aAAa,EAAE,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,mBAAmB;AACnB,wEAAwE;AACxE,0EAA0E;AAC1E,iCAAiC;AACjC,kEAAkE;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,sBAAsB;AACtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,UAAU,iBAAiB;IAC/B,UAAU;IACV,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IAEtD,WAAW;IACX,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAChD,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAEpD,cAAc;IACd,cAAc,CAAC,aAAa,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAC/D,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAC;IACnE,cAAc,CAAC,aAAa,EAAE,cAAc,EAAE,qBAAqB,CAAC,CAAC;IAErE,cAAc;IACd,cAAc,CAAC,aAAa,EAAE,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;AAC3E,CAAC"}

package/dist/drivers/opencode.d.ts

@@ -0,0 +1,3 @@
+import type { DriverPlugin } from '../types';
+export declare const OpenCodeDriver: DriverPlugin;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/drivers/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/drivers/opencode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAOb,MAAM,UAAU,CAAC;AAyLlB,eAAO,MAAM,cAAc,EAAE,YAiL5B,CAAC"}

package/dist/drivers/opencode.js

@@ -0,0 +1,316 @@
+const DEFAULT_MODEL = 'opencode/big-pickle';
+// NOTE on Windows multi-line prompts: `opencode` resolves to `opencode.cmd`,
+// an npm-generated batch wrapper. cmd.exe silently truncates argv elements
+// at the first newline, so a multi-line prompt reaches the model as only
+// its first line. The SDK's runner auto-unwraps npm .cmd shims into direct
+// `node <js-entry>` invocations so newlines survive, and this driver can
+// keep using the bare `opencode` name on every platform.
+// tagma uses a provider-neutral reasoning_effort vocabulary (low|medium|high)
+// but opencode's `--variant` is provider-specific (e.g. high|max|minimal).
+// Map the tagma values to the closest opencode variant:
+//   low    → minimal  (least thinking)
+//   medium → <no flag, provider default>
+//   high   → high     (most thinking)
+// Unknown values pass through unchanged so users who target a specific
+// opencode variant (e.g. "max") still work.
+const EFFORT_TO_VARIANT = {
+    low: 'minimal',
+    medium: null,
+    high: 'high',
+};
+let opencodeReady;
+let cachedDefaultModel;
+async function runCapture(args) {
+    try {
+        const proc = Bun.spawn(args, { stdout: 'pipe', stderr: 'pipe' });
+        const [stdout, stderr, code] = await Promise.all([
+            new Response(proc.stdout).text(),
+            new Response(proc.stderr).text(),
+            proc.exited,
+        ]);
+        return { code, stdout, stderr };
+    }
+    catch {
+        return { code: -1, stdout: '', stderr: '' };
+    }
+}
+async function ensureOpencodeInstalled() {
+    if (opencodeReady !== undefined)
+        return opencodeReady;
+    // Probe existing install first — users who already have it get no delay.
+    const probe = await runCapture(['opencode', '--version']);
+    if (probe.code === 0) {
+        opencodeReady = true;
+        return true;
+    }
+    console.error('[driver:opencode] opencode CLI not found — installing via `bun install -g opencode-ai`... (this may take up to a minute)');
+    // Use inherit here so the user sees bun's own progress during the one-time
+    // install; runCapture would swallow it.
+    const install = Bun.spawn(['bun', 'install', '-g', 'opencode-ai'], {
+        stdout: 'inherit',
+        stderr: 'inherit',
+    });
+    const installCode = await install.exited;
+    if (installCode !== 0) {
+        console.error('[driver:opencode] install failed — opencode run will likely fail below.');
+        opencodeReady = false;
+        return false;
+    }
+    // Bun installs globals under `~/.bun/bin` (or `%USERPROFILE%\.bun\bin`),
+    // which isn't on this process's cached PATH unless the user already has
+    // bun set up. Ask bun for the directory and prepend it so bare `opencode`
+    // resolves in this process without requiring a shell reload.
+    const bin = await runCapture(['bun', 'pm', 'bin', '-g']);
+    if (bin.code === 0) {
+        const dir = bin.stdout.trim();
+        const sep = process.platform === 'win32' ? ';' : ':';
+        const current = process.env.PATH ?? '';
+        if (dir && !current.split(sep).includes(dir)) {
+            process.env.PATH = `${dir}${sep}${current}`;
+        }
+    }
+    const verify = await runCapture(['opencode', '--version']);
+    opencodeReady = verify.code === 0;
+    if (!opencodeReady) {
+        console.error('[driver:opencode] `opencode` still not resolvable after install — check that bun global bin is on PATH.');
+    }
+    return opencodeReady;
+}
+// `opencode models --verbose` emits "<provider>/<id>\n{...json...}\n" pairs.
+// Walk balanced braces rather than split on newlines so we survive any
+// whitespace oddities in the JSON payload.
+function parseVerboseModels(stdout) {
+    const out = [];
+    let depth = 0;
+    let start = -1;
+    for (let i = 0; i < stdout.length; i++) {
+        const c = stdout[i];
+        if (c === '{') {
+            if (depth === 0)
+                start = i;
+            depth++;
+        }
+        else if (c === '}') {
+            depth--;
+            if (depth === 0 && start !== -1) {
+                try {
+                    out.push(JSON.parse(stdout.slice(start, i + 1)));
+                }
+                catch {
+                    /* skip malformed block */
+                }
+                start = -1;
+            }
+        }
+    }
+    return out;
+}
+function pickFreeModel(models) {
+    const fullId = (m) => `${m.providerID ?? 'opencode'}/${m.id ?? ''}`;
+    const eligible = models.filter((m) => {
+        if (!m.id || m.id === 'big-pickle')
+            return false;
+        if (m.status && m.status !== 'active')
+            return false;
+        const cost = m.cost;
+        if (!cost || cost.input !== 0 || cost.output !== 0)
+            return false;
+        const ctx = m.limit?.context;
+        if (typeof ctx !== 'number' || ctx <= 128000)
+            return false;
+        return true;
+    });
+    // Prefer models explicitly labelled "-free" by the provider — those are
+    // a stronger stability signal than "cost happens to be 0 right now".
+    const preferred = eligible.filter((m) => m.id?.endsWith('-free'));
+    const pool = preferred.length > 0 ? preferred : eligible;
+    if (pool.length === 0)
+        return null;
+    // Deterministic pick: sort by full id so upstream model-list reordering
+    // doesn't flip our choice between runs.
+    pool.sort((a, b) => fullId(a).localeCompare(fullId(b)));
+    return fullId(pool[0]);
+}
+async function resolveDefaultModel() {
+    if (cachedDefaultModel !== undefined)
+        return cachedDefaultModel;
+    const ready = await ensureOpencodeInstalled();
+    if (!ready) {
+        cachedDefaultModel = DEFAULT_MODEL;
+        return cachedDefaultModel;
+    }
+    console.error('[driver:opencode] resolving free opencode model...');
+    const { code, stdout } = await runCapture(['opencode', 'models', '--verbose']);
+    if (code !== 0) {
+        cachedDefaultModel = DEFAULT_MODEL;
+        return cachedDefaultModel;
+    }
+    const picked = pickFreeModel(parseVerboseModels(stdout));
+    cachedDefaultModel = picked ?? DEFAULT_MODEL;
+    console.error(`[driver:opencode] default model: ${cachedDefaultModel}`);
+    return cachedDefaultModel;
+}
+export const OpenCodeDriver = {
+    name: 'opencode',
+    capabilities: {
+        sessionResume: true, // supports --session
+        systemPrompt: false, // no --system-prompt flag; prepend to prompt instead
+        outputFormat: true, // supports --format json
+    },
+    resolveModel() {
+        return DEFAULT_MODEL;
+    },
+    async buildCommand(task, track, ctx) {
+        const explicitModel = task.model ?? track.model;
+        // Always make sure the opencode CLI is usable before we spawn it — even
+        // when the user pinned a model. If missing, ensureOpencodeInstalled
+        // auto-installs it via `bun install -g opencode-ai`.
+        if (explicitModel)
+            await ensureOpencodeInstalled();
+        // Otherwise resolveDefaultModel both ensures the CLI and picks a free
+        // model from `opencode models --verbose` (cached per-process).
+        const model = explicitModel ?? (await resolveDefaultModel());
+        // Resolve reasoning_effort → opencode --variant. SDK schema layer already
+        // resolved task → track → pipeline inheritance, so we only need to read
+        // task.reasoning_effort here.
+        const rawEffort = task.reasoning_effort ?? track.reasoning_effort;
+        const variant = rawEffort
+            ? rawEffort in EFFORT_TO_VARIANT
+                ? EFFORT_TO_VARIANT[rawEffort]
+                : rawEffort
+            : null;
+        let prompt = task.prompt;
+        // agent_profile has no dedicated flag; prepend to prompt
+        const profile = task.agent_profile ?? track.agent_profile;
+        if (profile) {
+            prompt = `[Role]\n${profile}\n\n[Task]\n${prompt}`;
+        }
+        // continue_from: prefer session resume, fall back to text injection
+        let sessionId = null;
+        if (task.continue_from) {
+            sessionId = ctx.sessionMap.get(task.continue_from) ?? null;
+            if (!sessionId) {
+                // no session — degrade to text context passthrough
+                let prev = null;
+                if (ctx.normalizedMap.has(task.continue_from)) {
+                    prev = ctx.normalizedMap.get(task.continue_from);
+                }
+                if (prev !== null) {
+                    prompt = `[Previous Output]\n${prev}\n\n[Current Task]\n${prompt}`;
+                }
+            }
+        }
+        // opencode run does not support stdin (no `-` placeholder like codex exec).
+        // Prompt is always a positional argument. Flags must be declared before `--`;
+        // the prompt follows after so that leading `--flag` content cannot be
+        // misread by opencode's argument parser (flag-injection mitigation).
+        // Shell-level injection is already prevented by Bun.spawn's direct argv array.
+        // Windows cmd.exe argv truncation on the `.cmd` wrapper is handled by the
+        // SDK runner's shim unwrapping — see note at the top of this file.
+        const args = [
+            'opencode',
+            'run',
+            '--model',
+            model,
+            '--format',
+            'json', // JSON output for parseResult
+        ];
+        // `--variant` must precede `--` like every other flag. opencode rejects
+        // unknown variant names with a clear error, so we don't pre-validate.
+        if (variant) {
+            args.push('--variant', variant);
+        }
+        // session resume (must appear before --)
+        if (sessionId) {
+            args.push('--session', sessionId);
+        }
+        // `--` (POSIX end-of-options) isolates prompt from flag parsing
+        args.push('--', prompt);
+        return { args, cwd: task.cwd ?? ctx.workDir };
+    },
+    parseResult(stdout) {
+        // opencode --format json emits NDJSON — one JSON object per line
+        // (step_start / text / step_finish / …). The previous single
+        // `JSON.parse(stdout)` always threw on this shape and fell through to
+        // the catch, returning sessionId:null and losing session resume.
+        // Walk line-by-line, pick up the first sessionID we see, concatenate
+        // any text-type parts into normalizedOutput, and bail early on error
+        // payloads.
+        const lines = stdout.split(/\r?\n/);
+        let sessionId;
+        const textParts = [];
+        let sawAnyJson = false;
+        let errorReason = null;
+        for (const raw of lines) {
+            const line = raw.trim();
+            if (!line)
+                continue;
+            let json;
+            try {
+                json = JSON.parse(line);
+            }
+            catch {
+                continue; // tolerate interleaved non-JSON noise
+            }
+            sawAnyJson = true;
+            // M12: opencode sometimes emits {type:"error", error:{...}} with
+            // exit 0 for transient API failures. Force-fail so downstream
+            // skip_downstream / stop_all kicks in.
+            if (json.type === 'error') {
+                const err = json.error;
+                const msg = typeof err === 'object' && err !== null && typeof err.message === 'string'
+                    ? err.message
+                    : typeof err === 'string'
+                        ? err
+                        : null;
+                errorReason = msg
+                    ? `opencode reported error: ${msg}`
+                    : 'opencode emitted an error JSON payload';
+                // D21: stop at the first error. Continuing meant subsequent text
+                // lines got accumulated into `textParts` only to be discarded by
+                // the error-return below, and a later `{type:"error"}` would
+                // silently overwrite the original cause — operators then debugged
+                // a downstream symptom while the root-cause line scrolled past.
+                break;
+            }
+            // Session id — opencode uses `sessionID` (camelCase with capital D).
+            // Keep `session_id` / `sessionId` as fallbacks for forward/backward
+            // compatibility with other shapes.
+            if (!sessionId) {
+                const sid = json.sessionID ??
+                    json.session_id ??
+                    json.sessionId ??
+                    null;
+                if (typeof sid === 'string' && sid.length > 0)
+                    sessionId = sid;
+            }
+            // Extract human-readable text from text-type parts.
+            if (json.type === 'text') {
+                const part = json.part;
+                if (part && typeof part.text === 'string') {
+                    textParts.push(part.text);
+                }
+            }
+            else if (typeof json.result === 'string') {
+                textParts.push(json.result);
+            }
+            else if (typeof json.content === 'string') {
+                textParts.push(json.content);
+            }
+        }
+        if (errorReason) {
+            return { forceFailure: true, forceFailureReason: errorReason };
+        }
+        // If nothing parsed as JSON, treat stdout as plain text.
+        const normalizedOutput = !sawAnyJson
+            ? stdout
+            : textParts.length > 0
+                ? textParts.join('\n')
+                : stdout;
+        return {
+            sessionId,
+            normalizedOutput,
+        };
+    },
+};
+//# sourceMappingURL=opencode.js.map

package/dist/drivers/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/drivers/opencode.ts"],"names":[],"mappings":"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"}

package/dist/engine.js

@@ -31,7 +31,7 @@ function preflight(config, dag) {
     for (const [, node] of dag.nodes) {
         const task = node.task;
         const track = node.track;
-        const driverName = task.driver ?? track.driver ?? config.driver ?? 'claude-code';
+        const driverName = task.driver ?? track.driver ?? config.driver ?? 'opencode';
         // Pure command tasks don't use a driver — skip driver registration check.
         const isCommandOnly = task.command && !task.prompt;
         if (!isCommandOnly && !hasHandler('drivers', driverName)) {
@@ -62,7 +62,7 @@ function preflight(config, dag) {
                         // A handoff is possible via session resume (already ruled out above),
                         // OR in-memory text injection through normalizedMap
                         // (when the upstream driver implements parseResult and returns normalizedOutput).
-                        const upstreamDriverName = upstream.task.driver ?? upstream.track.driver ?? config.driver ?? 'claude-code';
+                        const upstreamDriverName = upstream.task.driver ?? upstream.track.driver ?? config.driver ?? 'opencode';
                         const upstreamDriver = hasHandler('drivers', upstreamDriverName)
                             ? getHandler('drivers', upstreamDriverName)
                             : null;
@@ -153,7 +153,7 @@ export async function runPipeline(config, workDir, options = {}) {
         // File-only: dump the resolved pipeline shape + DAG topology for post-mortem.
         log.section('Pipeline configuration');
         log.quiet(`name:          ${config.name}`);
-        log.quiet(`driver:        ${config.driver ?? '(default: claude-code)'}`);
+        log.quiet(`driver:        ${config.driver ?? '(default: opencode)'}`);
         log.quiet(`timeout:       ${config.timeout ?? '(none)'}`);
         log.quiet(`tracks:        ${config.tracks.length}`);
         log.quiet(`tasks (total): ${dag.nodes.size}`);
@@ -515,7 +515,7 @@ export async function runPipeline(config, workDir, options = {}) {
             setTaskStatus(taskId, 'running');
             log.info(`[task:${taskId}]`, task.command ? `running: ${task.command}` : `running (driver task)`);
             // File-only: resolved config for this task
-            const resolvedDriver = task.driver ?? track.driver ?? config.driver ?? 'claude-code';
+            const resolvedDriver = task.driver ?? track.driver ?? config.driver ?? 'opencode';
             const resolvedModel = task.model ?? track.model ?? config.model ?? '(default)';
             const resolvedPerms = task.permissions ?? track.permissions ?? '(default)';
             const resolvedCwd = task.cwd ?? track.cwd ?? workDir;
@@ -537,7 +537,7 @@ export async function runPipeline(config, workDir, options = {}) {
                 }
                 else {
                     // AI task: apply middleware chain against a structured PromptDocument.
-                    const driverName = task.driver ?? track.driver ?? config.driver ?? 'claude-code';
+                    const driverName = task.driver ?? track.driver ?? config.driver ?? 'opencode';
                     const driver = getHandler('drivers', driverName);
                     const originalLen = task.prompt.length;
                     let doc = promptDocumentFromString(task.prompt);