@tagma/sdk 0.6.12 → 0.7.0

package/src/index.ts

@@ -0,0 +1,28 @@
+export { createTagma } from './tagma';
+export type { CreateTagmaOptions, Tagma, TagmaRunOptions } from './tagma';
+export { definePipeline } from './pipeline-definition';
+export { PluginRegistry } from './registry';
+export { TriggerBlockedError, TriggerTimeoutError } from './engine';
+export type { EngineResult, RunEventPayload } from './engine';
+export { RUN_PROTOCOL_VERSION, TASK_LOG_CAP } from './types';
+export type {
+  PipelineConfig,
+  RawPipelineConfig,
+  RawTrackConfig,
+  RawTaskConfig,
+  TrackConfig,
+  TaskConfig,
+  RunSnapshotPayload,
+  WireRunEvent,
+  RunTaskState,
+  TaskLogLine,
+  ApprovalRequestInfo,
+  TaskStatus,
+  ApprovalRequest,
+  PluginCategory,
+  DriverPlugin,
+  TriggerPlugin,
+  CompletionPlugin,
+  MiddlewarePlugin,
+  RunEventPayload as PipelineRunEventPayload,
+} from '@tagma/types';

package/src/pipeline-definition.ts

@@ -0,0 +1,5 @@
+import type { RawPipelineConfig } from './types';
+
+export function definePipeline<T extends RawPipelineConfig>(pipeline: T): T {
+  return pipeline;
+}

package/src/pipeline-runner.ts

@@ -13,7 +13,7 @@
 //
 //   const runners = new Map<string, PipelineRunner>();
 //
-//   const runner = new PipelineRunner(config, workDir);
+//   const runner = new PipelineRunner(config, workDir, { registry });
 //   runner.subscribe(event => ipcEmit('run_event', event));
 //   runner.start();
 //   runners.set(runner.instanceId, runner);
@@ -29,6 +29,7 @@ import { generateRunId } from './utils';
 export type { EngineResult };
 
 export type PipelineRunnerStatus = 'idle' | 'running' | 'done' | 'aborted';
+export type PipelineRunnerOptions = Omit<RunPipelineOptions, 'signal' | 'onEvent'>;
 
 export class PipelineRunner {
   /**
@@ -57,7 +58,7 @@ export class PipelineRunner {
   constructor(
     private readonly config: PipelineConfig,
     private readonly workDir: string,
-    private readonly opts: Omit<RunPipelineOptions, 'signal' | 'onEvent'> = {},
+    private readonly opts: PipelineRunnerOptions,
   ) {
     this.instanceId = generateRunId();
   }

package/src/plugin-registry.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from 'bun:test';
-import { PluginRegistry, defaultRegistry } from './registry';
+import { PluginRegistry } from './registry';
 import { bootstrapBuiltins } from './bootstrap';
 import { runPipeline } from './engine';
 import type { DriverPlugin, TriggerPlugin, PipelineConfig } from './types';
@@ -80,7 +80,7 @@ describe('PluginRegistry — instance isolation', () => {
     expect(reg.getHandler<DriverPlugin>('drivers', 'mock').name).toBe('two');
   });
 
-  test('bootstrapBuiltins(target) populates a specific instance without touching the default', () => {
+  test('bootstrapBuiltins(target) populates a specific instance', () => {
     const fresh = new PluginRegistry();
     expect(fresh.hasHandler('drivers', 'opencode')).toBe(false);
 
@@ -222,13 +222,9 @@ describe('runPipeline — options.registry isolation', () => {
     }
   });
 
-  test('omitting options.registry falls back to defaultRegistry', async () => {
-    // bootstrapBuiltins into default happens in most host callers; do it
-    // explicitly here so the test is independent of module-load order.
-    bootstrapBuiltins(defaultRegistry);
-
+  test('runPipeline rejects missing explicit registry', async () => {
     const config: PipelineConfig = {
-      name: 'default-fallback',
+      name: 'missing-registry',
       tracks: [
         {
           id: 't',
@@ -239,8 +235,9 @@ describe('runPipeline — options.registry isolation', () => {
     };
     const tmp = mkdtempSync(join(tmpdir(), 'tagma-default-'));
     try {
-      const res = await runPipeline(config, tmp, { skipPluginLoading: true });
-      expect(res.success).toBe(true);
+      await expect(
+        runPipeline(config, tmp, { skipPluginLoading: true } as never),
+      ).rejects.toThrow(/requires options\.registry/);
     } finally {
       rmSync(tmp, { recursive: true, force: true });
     }

package/src/plugins.ts

@@ -0,0 +1,18 @@
+export { bootstrapBuiltins } from './bootstrap';
+export {
+  PluginRegistry,
+  isValidPluginName,
+  PLUGIN_NAME_RE,
+  readPluginManifest,
+} from './registry';
+export type { RegisterResult } from './registry';
+export type {
+  PluginCategory,
+  PluginModule,
+  PluginManifest,
+  DriverPlugin,
+  TriggerPlugin,
+  CompletionPlugin,
+  MiddlewarePlugin,
+} from './types';
+

package/src/registry.ts

@@ -37,7 +37,7 @@ function singularCategory(category: PluginCategory): string {
  * registration time rather than crashing the engine mid-run.
  *
  * For drivers we materialize `capabilities` and assert each field is a
- * boolean — otherwise a plugin author can write
+ * boolean �?otherwise a plugin author can write
  *     get capabilities() { throw new Error('boom') }
  * and pass the basic typeof check, then crash preflight when the engine
  * touches `driver.capabilities.sessionResume`. (R8)
@@ -55,7 +55,7 @@ function validateContract(category: PluginCategory, handler: unknown): void {
       if (typeof h.buildCommand !== 'function') {
         throw new Error(`drivers plugin "${h.name}" must export buildCommand()`);
       }
-      // Materialize capabilities — this triggers any throwing getter NOW
+      // Materialize capabilities �?this triggers any throwing getter NOW
       // instead of during preflight.
       let caps: unknown;
       try {
@@ -132,7 +132,7 @@ export function isValidPluginName(name: unknown): name is string {
  *
  * Returns the strongly-typed manifest if the field is present and
  * well-formed (`category` is one of the four known categories and `type`
- * is a non-empty string). Returns `null` if the field is absent — that
+ * is a non-empty string). Returns `null` if the field is absent �?that
  * is the host's signal that the package is a library, not a plugin.
  *
  * Throws if the field is present but malformed: that's a packaging bug
@@ -170,9 +170,7 @@ export function readPluginManifest(pkgJson: unknown): PluginManifest | null {
 /**
  * Instance-scoped plugin registry. Each workspace in a multi-tenant sidecar
  * owns its own PluginRegistry, so installing/uninstalling a driver in one
- * workspace cannot clobber another. The process-wide `defaultRegistry`
- * exported at the bottom of this file preserves the historical free-function
- * API (registerPlugin / getHandler / …) for CLI and single-tenant hosts.
+ * workspace cannot clobber another.
  */
 export class PluginRegistry {
   private readonly registries = {
@@ -216,12 +214,12 @@ export class PluginRegistry {
     if (wasReplaced) {
       // D18: surface silent shadowing. Hot-reload flows legitimately replace
       // handlers; installing two different plugin packages that both claim
-      // the same (category, type) does not — the second wins and breaks the
+      // the same (category, type) does not �?the second wins and breaks the
       // first's consumers with no audit trail. A console.warn is cheap,
       // respects existing callers that rely on 'replaced', and gives ops a
       // grep-able signal when registrations collide unexpectedly.
       console.warn(
-        `[tagma-sdk] registerPlugin: replaced existing ${category}/${type} — ` +
+        `[tagma-sdk] registerPlugin: replaced existing ${category}/${type} �?` +
           `check for duplicate plugin packages claiming the same type.`,
       );
     }
@@ -231,8 +229,7 @@ export class PluginRegistry {
   /**
    * Remove a plugin from the in-process registry. Returns true if a plugin
    * was actually removed. Note: ESM module caching is not affected, so
-   * re-importing the same file after unregister will yield the cached module —
-   * callers wanting a fresh load must restart the host process.
+   * re-importing the same file after unregister will yield the cached module �?   * callers wanting a fresh load must restart the host process.
    */
   unregisterPlugin(category: PluginCategory, type: string): boolean {
     if (!VALID_CATEGORIES.has(category)) return false;
@@ -299,42 +296,3 @@ export class PluginRegistry {
     }
   }
 }
-
-/**
- * Process-wide default registry. Preserves the historical free-function API
- * for CLI and single-tenant hosts. Multi-tenant hosts (the editor sidecar
- * after the one-sidecar refactor) build their own `PluginRegistry` per
- * workspace and pass it through `RunPipelineOptions.registry`.
- */
-export const defaultRegistry = new PluginRegistry();
-
-export function registerPlugin<T extends PluginType>(
-  category: PluginCategory,
-  type: string,
-  handler: T,
-): RegisterResult {
-  return defaultRegistry.registerPlugin(category, type, handler);
-}
-
-export function unregisterPlugin(category: PluginCategory, type: string): boolean {
-  return defaultRegistry.unregisterPlugin(category, type);
-}
-
-export function getHandler<T extends PluginType>(category: PluginCategory, type: string): T {
-  return defaultRegistry.getHandler<T>(category, type);
-}
-
-export function hasHandler(category: PluginCategory, type: string): boolean {
-  return defaultRegistry.hasHandler(category, type);
-}
-
-export function listRegistered(category: PluginCategory): string[] {
-  return defaultRegistry.listRegistered(category);
-}
-
-export function loadPlugins(
-  pluginNames: readonly string[],
-  resolveFrom?: string,
-): Promise<void> {
-  return defaultRegistry.loadPlugins(pluginNames, resolveFrom);
-}

package/src/tagma.test.ts

@@ -0,0 +1,84 @@
+import { describe, expect, test } from 'bun:test';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createTagma } from './tagma';
+import type { DriverPlugin, PipelineConfig } from './types';
+
+function makeDir(prefix: string): string {
+  return mkdtempSync(join(tmpdir(), prefix));
+}
+
+function makeDriver(name: string, marker: string[]): DriverPlugin {
+  return {
+    name,
+    capabilities: { sessionResume: false, systemPrompt: false, outputFormat: false },
+    async buildCommand() {
+      marker.push(name);
+      return { args: ['echo', name] };
+    },
+  };
+}
+
+describe('createTagma', () => {
+  test('instances own isolated plugin registries', () => {
+    const seenA: string[] = [];
+    const seenB: string[] = [];
+    const tagmaA = createTagma({ builtins: false });
+    const tagmaB = createTagma({ builtins: false });
+
+    tagmaA.registry.registerPlugin('drivers', 'mock', makeDriver('driver-a', seenA));
+    tagmaB.registry.registerPlugin('drivers', 'mock', makeDriver('driver-b', seenB));
+
+    expect(tagmaA.registry.getHandler<DriverPlugin>('drivers', 'mock').name).toBe('driver-a');
+    expect(tagmaB.registry.getHandler<DriverPlugin>('drivers', 'mock').name).toBe('driver-b');
+    expect(seenA).toEqual([]);
+    expect(seenB).toEqual([]);
+  });
+
+  test('run uses only the instance registry', async () => {
+    const tagma = createTagma({ builtins: false });
+    const dir = makeDir('tagma-instance-run-');
+    try {
+      await expect(
+        tagma.run(
+          {
+            name: 'instance-run',
+            tracks: [
+              {
+                id: 't',
+                name: 'T',
+                tasks: [{ id: 'prompt', name: 'prompt', prompt: 'hello' }],
+              },
+            ],
+          },
+          {
+            cwd: dir,
+            skipPluginLoading: true,
+          },
+        ),
+      ).rejects.toThrow(/driver "opencode" not registered/);
+    } finally {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('validate returns structural pipeline errors without running tasks', () => {
+    const tagma = createTagma({ builtins: false });
+
+    expect(
+      tagma.validate({
+        name: 'invalid',
+        tracks: [
+          {
+            id: 't',
+            name: 'T',
+            tasks: [
+              { id: 'a', name: 'A', command: 'echo a', depends_on: ['missing'] },
+            ],
+          },
+        ],
+      }),
+    ).toEqual(['Task reference "missing" not found']);
+  });
+});

package/src/tagma.ts

@@ -0,0 +1,47 @@
+import { runPipeline, type EngineResult, type RunPipelineOptions } from './engine';
+import { bootstrapBuiltins } from './bootstrap';
+import { PluginRegistry } from './registry';
+import { validateConfig } from './schema';
+import type { PipelineConfig } from './types';
+
+export interface CreateTagmaOptions {
+  /**
+   * Registry used by this SDK instance. Omit to create an isolated registry.
+   */
+  readonly registry?: PluginRegistry;
+  /**
+   * Register built-in drivers/triggers/completions/middlewares into the
+   * instance registry. Defaults to true.
+   */
+  readonly builtins?: boolean;
+}
+
+export interface TagmaRunOptions extends Omit<RunPipelineOptions, 'registry'> {
+  readonly cwd: string;
+}
+
+export interface Tagma {
+  readonly registry: PluginRegistry;
+  run(config: PipelineConfig, options: TagmaRunOptions): Promise<EngineResult>;
+  validate(config: PipelineConfig): readonly string[];
+}
+
+export function createTagma(options: CreateTagmaOptions = {}): Tagma {
+  const registry = options.registry ?? new PluginRegistry();
+  if (options.builtins !== false) {
+    bootstrapBuiltins(registry);
+  }
+
+  return {
+    registry,
+    run(config, { cwd, ...runOptions }) {
+      return runPipeline(config, cwd, {
+        ...runOptions,
+        registry,
+      });
+    },
+    validate(config) {
+      return validateConfig(config);
+    },
+  };
+}

package/src/utils-api.ts

@@ -0,0 +1,8 @@
+export {
+  parseDuration,
+  validatePath,
+  generateRunId,
+  nowISO,
+  truncateForName,
+} from './utils';
+

package/src/yaml.ts

@@ -0,0 +1,11 @@
+export {
+  parseYaml,
+  resolveConfig,
+  loadPipeline,
+  serializePipeline,
+  deresolvePipeline,
+  validateConfig,
+} from './schema';
+export { compileYamlContent } from './yaml-compiler';
+export type { YamlCompileResult, CompileYamlOptions } from './yaml-compiler';
+

package/dist/sdk.d.ts

@@ -1,32 +0,0 @@
-export { runPipeline, TriggerBlockedError, TriggerTimeoutError } from './engine';
-export type { EngineResult, RunPipelineOptions, RunEventPayload } from './engine';
-export { PipelineRunner } from './pipeline-runner';
-export type { PipelineRunnerStatus } from './pipeline-runner';
-export { createEmptyPipeline, setPipelineField, upsertTrack, removeTrack, moveTrack, updateTrack, upsertTask, removeTask, moveTask, transferTask, } from './config-ops';
-export { validateRaw } from './validate-raw';
-export type { ValidationError, KnownPluginTypes } from './validate-raw';
-export { compileYamlContent } from './yaml-compiler';
-export type { YamlCompileResult, CompileYamlOptions } from './yaml-compiler';
-export { parseYaml, resolveConfig, loadPipeline, serializePipeline, deresolvePipeline, validateConfig, } from './schema';
-export { buildDag, buildRawDag } from './dag';
-export type { DagNode, Dag, RawDagNode, RawDag } from './dag';
-export { bootstrapBuiltins } from './bootstrap';
-export { PluginRegistry, defaultRegistry, loadPlugins, registerPlugin, unregisterPlugin, getHandler, hasHandler, listRegistered, isValidPluginName, PLUGIN_NAME_RE, readPluginManifest, } from './registry';
-export type { RegisterResult } from './registry';
-export { InMemoryApprovalGateway } from './approval';
-export type { ApprovalGateway, ApprovalRequest, ApprovalDecision, ApprovalOutcome, ApprovalEvent, ApprovalListener, } from './approval';
-export { attachStdinApprovalAdapter } from './adapters/stdin-approval';
-export type { StdinApprovalAdapter } from './adapters/stdin-approval';
-export { attachWebSocketApprovalAdapter } from './adapters/websocket-approval';
-export type { WebSocketApprovalAdapter, WebSocketApprovalAdapterOptions, } from './adapters/websocket-approval';
-export { Logger, tailLines, clip } from './logger';
-export type { LogRecord, LogLevel, LogListener } from './logger';
-export type { HookResult, PipelineInfo, TrackInfo, TaskInfo } from './hooks';
-export { parseDuration, validatePath, generateRunId, nowISO, truncateForName, _resetShellCache, } from './utils';
-export { TASK_ID_RE, isValidTaskId, qualifyTaskId, isQualifiedRef, buildTaskIndex, resolveTaskRef, AMBIGUOUS, } from './task-ref';
-export type { TaskIndex, RefResolution } from './task-ref';
-export { promptDocumentFromString, serializePromptDocument, appendContext, prependContext, renderInputsBlock, renderOutputSchemaBlock, } from './prompt-doc';
-export { substituteInputs, extractInputReferences, resolveTaskBindingInputs, resolveTaskInputs, extractTaskBindingOutputs, extractTaskOutputs, inferPromptPorts, } from './ports';
-export type { SubstituteResult, BindingInputResolution, UpstreamBindingData, InputResolution, ExtractResult, PromptPortInference, PromptPortConflict, PromptUpstreamNeighbor, PromptDownstreamNeighbor, } from './ports';
-export * from './types';
-//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

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

package/dist/sdk.js

@@ -1,41 +0,0 @@
-// ═══ tagma-sdk public API ═══
-//
-// This is the SDK entry point. Import from here, not from internal modules.
-// The CLI (src/index.ts in the CLI project) also imports from here.
-// ── Core engine ──
-export { runPipeline, TriggerBlockedError, TriggerTimeoutError } from './engine';
-// ── Pipeline runner (multi-pipeline lifecycle management) ──
-export { PipelineRunner } from './pipeline-runner';
-// ── Raw config CRUD (visual editor / YAML sync) ──
-export { createEmptyPipeline, setPipelineField, upsertTrack, removeTrack, moveTrack, updateTrack, upsertTask, removeTask, moveTask, transferTask, } from './config-ops';
-// ── Raw config validation (real-time feedback) ──
-export { validateRaw } from './validate-raw';
-// ── YAML compiler (validation + compile log support) ──
-export { compileYamlContent } from './yaml-compiler';
-// ── Schema: parse / resolve / load / serialize / validate ──
-export { parseYaml, resolveConfig, loadPipeline, serializePipeline, deresolvePipeline, validateConfig, } from './schema';
-// ── DAG ──
-export { buildDag, buildRawDag } from './dag';
-// ── Plugin registry ──
-export { bootstrapBuiltins } from './bootstrap';
-export { PluginRegistry, defaultRegistry, loadPlugins, registerPlugin, unregisterPlugin, getHandler, hasHandler, listRegistered, isValidPluginName, PLUGIN_NAME_RE, readPluginManifest, } from './registry';
-// ── Approval gateway ──
-export { InMemoryApprovalGateway } from './approval';
-// ── Approval adapters ──
-export { attachStdinApprovalAdapter } from './adapters/stdin-approval';
-export { attachWebSocketApprovalAdapter } from './adapters/websocket-approval';
-// ── Logger ──
-export { Logger, tailLines, clip } from './logger';
-// ── Utils (public subset) ──
-export { parseDuration, validatePath, generateRunId, nowISO, truncateForName, _resetShellCache, } from './utils';
-// ── Task reference resolution (shared id normalization) ──
-export { TASK_ID_RE, isValidTaskId, qualifyTaskId, isQualifiedRef, buildTaskIndex, resolveTaskRef, AMBIGUOUS, } from './task-ref';
-// ── Prompt document helpers (middleware authors + drivers) ──
-export { promptDocumentFromString, serializePromptDocument, appendContext, prependContext, renderInputsBlock, renderOutputSchemaBlock, } from './prompt-doc';
-// ── Task ports (editor: substitute placeholders, resolve upstream
-//    values, extract downstream outputs; drivers that wrap the prompt
-//    may want substituteInputs on their own envelope) ──
-export { substituteInputs, extractInputReferences, resolveTaskBindingInputs, resolveTaskInputs, extractTaskBindingOutputs, extractTaskOutputs, inferPromptPorts, } from './ports';
-// ── All types from @tagma/types + runtime constants ──
-export * from './types';
-//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,4EAA4E;AAC5E,oEAAoE;AAEpE,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGjF,8DAA8D;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,oDAAoD;AACpD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,QAAQ,EACR,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,mDAAmD;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,yDAAyD;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,8DAA8D;AAC9D,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,GACf,MAAM,UAAU,CAAC;AAElB,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAG9C,wBAAwB;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,yBAAyB;AACzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAUrD,0BAA0B;AAC1B,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAM/E,eAAe;AACf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAMnD,8BAA8B;AAC9B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,MAAM,EACN,eAAe,EACf,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,4DAA4D;AAC5D,OAAO,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,+DAA+D;AAC/D,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,mEAAmE;AACnE,sEAAsE;AACtE,yDAAyD;AACzD,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAajB,wDAAwD;AACxD,cAAc,SAAS,CAAC"}

package/src/sdk.ts

@@ -1,151 +0,0 @@
-// ═══ tagma-sdk public API ═══
-//
-// This is the SDK entry point. Import from here, not from internal modules.
-// The CLI (src/index.ts in the CLI project) also imports from here.
-
-// ── Core engine ──
-export { runPipeline, TriggerBlockedError, TriggerTimeoutError } from './engine';
-export type { EngineResult, RunPipelineOptions, RunEventPayload } from './engine';
-
-// ── Pipeline runner (multi-pipeline lifecycle management) ──
-export { PipelineRunner } from './pipeline-runner';
-export type { PipelineRunnerStatus } from './pipeline-runner';
-
-// ── Raw config CRUD (visual editor / YAML sync) ──
-export {
-  createEmptyPipeline,
-  setPipelineField,
-  upsertTrack,
-  removeTrack,
-  moveTrack,
-  updateTrack,
-  upsertTask,
-  removeTask,
-  moveTask,
-  transferTask,
-} from './config-ops';
-
-// ── Raw config validation (real-time feedback) ──
-export { validateRaw } from './validate-raw';
-export type { ValidationError, KnownPluginTypes } from './validate-raw';
-
-// ── YAML compiler (validation + compile log support) ──
-export { compileYamlContent } from './yaml-compiler';
-export type { YamlCompileResult, CompileYamlOptions } from './yaml-compiler';
-
-// ── Schema: parse / resolve / load / serialize / validate ──
-export {
-  parseYaml,
-  resolveConfig,
-  loadPipeline,
-  serializePipeline,
-  deresolvePipeline,
-  validateConfig,
-} from './schema';
-
-// ── DAG ──
-export { buildDag, buildRawDag } from './dag';
-export type { DagNode, Dag, RawDagNode, RawDag } from './dag';
-
-// ── Plugin registry ──
-export { bootstrapBuiltins } from './bootstrap';
-export {
-  PluginRegistry,
-  defaultRegistry,
-  loadPlugins,
-  registerPlugin,
-  unregisterPlugin,
-  getHandler,
-  hasHandler,
-  listRegistered,
-  isValidPluginName,
-  PLUGIN_NAME_RE,
-  readPluginManifest,
-} from './registry';
-export type { RegisterResult } from './registry';
-
-// ── Approval gateway ──
-export { InMemoryApprovalGateway } from './approval';
-export type {
-  ApprovalGateway,
-  ApprovalRequest,
-  ApprovalDecision,
-  ApprovalOutcome,
-  ApprovalEvent,
-  ApprovalListener,
-} from './approval';
-
-// ── Approval adapters ──
-export { attachStdinApprovalAdapter } from './adapters/stdin-approval';
-export type { StdinApprovalAdapter } from './adapters/stdin-approval';
-export { attachWebSocketApprovalAdapter } from './adapters/websocket-approval';
-export type {
-  WebSocketApprovalAdapter,
-  WebSocketApprovalAdapterOptions,
-} from './adapters/websocket-approval';
-
-// ── Logger ──
-export { Logger, tailLines, clip } from './logger';
-export type { LogRecord, LogLevel, LogListener } from './logger';
-
-// ── Hook context types (useful for frontend display) ──
-export type { HookResult, PipelineInfo, TrackInfo, TaskInfo } from './hooks';
-
-// ── Utils (public subset) ──
-export {
-  parseDuration,
-  validatePath,
-  generateRunId,
-  nowISO,
-  truncateForName,
-  _resetShellCache,
-} from './utils';
-
-// ── Task reference resolution (shared id normalization) ──
-export {
-  TASK_ID_RE,
-  isValidTaskId,
-  qualifyTaskId,
-  isQualifiedRef,
-  buildTaskIndex,
-  resolveTaskRef,
-  AMBIGUOUS,
-} from './task-ref';
-export type { TaskIndex, RefResolution } from './task-ref';
-
-// ── Prompt document helpers (middleware authors + drivers) ──
-export {
-  promptDocumentFromString,
-  serializePromptDocument,
-  appendContext,
-  prependContext,
-  renderInputsBlock,
-  renderOutputSchemaBlock,
-} from './prompt-doc';
-
-// ── Task ports (editor: substitute placeholders, resolve upstream
-//    values, extract downstream outputs; drivers that wrap the prompt
-//    may want substituteInputs on their own envelope) ──
-export {
-  substituteInputs,
-  extractInputReferences,
-  resolveTaskBindingInputs,
-  resolveTaskInputs,
-  extractTaskBindingOutputs,
-  extractTaskOutputs,
-  inferPromptPorts,
-} from './ports';
-export type {
-  SubstituteResult,
-  BindingInputResolution,
-  UpstreamBindingData,
-  InputResolution,
-  ExtractResult,
-  PromptPortInference,
-  PromptPortConflict,
-  PromptUpstreamNeighbor,
-  PromptDownstreamNeighbor,
-} from './ports';
-
-// ── All types from @tagma/types + runtime constants ──
-export * from './types';