@tagma/sdk 0.4.19 → 0.5.1

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;AAyBlB,eAAO,MAAM,cAAc,EAAE,YA0K5B,CAAC"}

package/dist/drivers/opencode.js

@@ -0,0 +1,176 @@
+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',
+};
+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 model = task.model ?? track.model ?? DEFAULT_MODEL;
+        // 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.d.ts

@@ -1,5 +1,4 @@
-import type { PipelineConfig, TaskState, TaskStatus } from './types';
-import { type LogLevel } from './logger';
+import type { PipelineConfig, TaskState, RunEventPayload } from './types';
 import { type ApprovalGateway } from './approval';
 export declare class TriggerBlockedError extends Error {
     readonly code: "TRIGGER_BLOCKED";
@@ -23,37 +22,7 @@ export interface EngineResult {
     };
     readonly states: ReadonlyMap<string, TaskState>;
 }
-export type PipelineEvent = {
-    readonly type: 'task_status_change';
-    readonly taskId: string;
-    readonly status: TaskStatus;
-    readonly prevStatus: TaskStatus;
-    readonly runId: string;
-    readonly state: TaskState;
-} | {
-    readonly type: 'pipeline_start';
-    readonly runId: string;
-    readonly states: ReadonlyMap<string, TaskState>;
-} | {
-    readonly type: 'pipeline_end';
-    readonly runId: string;
-    readonly success: boolean;
-}
-/**
- * Fine-grained log line emitted alongside every write to pipeline.log.
- * Consumers use this to stream the full run process into UIs without
- * tailing the log file. `taskId` is non-null for task-scoped lines and
- * null for pipeline-wide messages (e.g. configuration dumps, DAG
- * topology, pipeline start/end).
- */
- | {
-    readonly type: 'task_log';
-    readonly runId: string;
-    readonly taskId: string | null;
-    readonly level: LogLevel;
-    readonly timestamp: string;
-    readonly text: string;
-};
+export type { RunEventPayload } from './types';
 export interface RunPipelineOptions {
     readonly approvalGateway?: ApprovalGateway;
     /**
@@ -76,7 +45,7 @@ export interface RunPipelineOptions {
      * Called on every pipeline/task status transition.
      * Use for real-time UI updates (e.g. updating a visual workflow graph).
      */
-    readonly onEvent?: (event: PipelineEvent) => void;
+    readonly onEvent?: (event: RunEventPayload) => void;
     /**
      * Skip the engine's built-in `loadPlugins(config.plugins)` call.
      * Use this when the host has already pre-loaded plugins from a custom

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAEd,SAAS,EACT,UAAU,EAUX,MAAM,SAAS,CAAC;AAgBjB,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAM3E,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAG,iBAAiB,CAAU;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAG,iBAAiB,CAAU;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AA6ED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACjD;AAID,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACjD,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AACtF;;;;;;GAMG;GACD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAClD;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAWD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAm1BvB"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAEd,SAAS,EAaT,eAAe,EAEhB,MAAM,SAAS,CAAC;AAiBjB,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAM3E,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAG,iBAAiB,CAAU;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAG,iBAAiB,CAAU;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AA6ED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACjD;AAWD,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAuC/C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACpD;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAWD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAm5BvB"}