@tagma/sdk 0.6.0 → 0.6.2

package/dist/sdk.js.map

@@ -1 +1 @@
-{"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,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,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,GACd,MAAM,cAAc,CAAC;AAEtB,wDAAwD;AACxD,cAAc,SAAS,CAAC"}
+{"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,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,GACd,MAAM,cAAc,CAAC;AAEtB,wDAAwD;AACxD,cAAc,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tagma/sdk",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Local AI task orchestration engine — core SDK for tagma pipelines",
   "license": "MIT",
   "repository": {
@@ -42,7 +42,7 @@
     "release:publish": "bun scripts/release.ts --publish"
   },
   "dependencies": {
-    "@tagma/types": "0.4.0",
+    "@tagma/types": "0.4.1",
     "js-yaml": "^4.1.0",
     "chokidar": "^4.0.0"
   },

package/src/bootstrap.ts

@@ -1,37 +1,46 @@
-import { registerPlugin } from './registry';
-
-// Built-in Drivers
-// 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-claude-code"]
-import { OpenCodeDriver } from './drivers/opencode';
-
-// Built-in Triggers
-import { FileTrigger } from './triggers/file';
-import { ManualTrigger } from './triggers/manual';
-
-// Built-in Completions
-import { ExitCodeCompletion } from './completions/exit-code';
-import { FileExistsCompletion } from './completions/file-exists';
-import { OutputCheckCompletion } from './completions/output-check';
-
-// Built-in Middleware
-import { StaticContextMiddleware } from './middlewares/static-context';
-
-export function bootstrapBuiltins(): void {
-  // Drivers
-  registerPlugin('drivers', 'opencode', OpenCodeDriver);
-
-  // Triggers
-  registerPlugin('triggers', 'file', FileTrigger);
-  registerPlugin('triggers', 'manual', ManualTrigger);
-
-  // Completions
-  registerPlugin('completions', 'exit_code', ExitCodeCompletion);
-  registerPlugin('completions', 'file_exists', FileExistsCompletion);
-  registerPlugin('completions', 'output_check', OutputCheckCompletion);
-
-  // Middlewares
-  registerPlugin('middlewares', 'static_context', StaticContextMiddleware);
-}
+import { defaultRegistry, type PluginRegistry } from './registry';
+
+// Built-in Drivers
+// 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-claude-code"]
+import { OpenCodeDriver } from './drivers/opencode';
+
+// Built-in Triggers
+import { FileTrigger } from './triggers/file';
+import { ManualTrigger } from './triggers/manual';
+
+// Built-in Completions
+import { ExitCodeCompletion } from './completions/exit-code';
+import { FileExistsCompletion } from './completions/file-exists';
+import { OutputCheckCompletion } from './completions/output-check';
+
+// Built-in Middleware
+import { StaticContextMiddleware } from './middlewares/static-context';
+
+/**
+ * Register every built-in plugin into `target` (defaults to the process-wide
+ * default registry). Multi-tenant hosts instantiate one PluginRegistry per
+ * workspace and call this once per instance so each workspace sees the same
+ * built-ins without sharing registration state.
+ *
+ * Built-in handlers are stateless module singletons — registering the same
+ * handler object into N registries is cheap and safe; no cloning is needed.
+ */
+export function bootstrapBuiltins(target: PluginRegistry = defaultRegistry): void {
+  // Drivers
+  target.registerPlugin('drivers', 'opencode', OpenCodeDriver);
+
+  // Triggers
+  target.registerPlugin('triggers', 'file', FileTrigger);
+  target.registerPlugin('triggers', 'manual', ManualTrigger);
+
+  // Completions
+  target.registerPlugin('completions', 'exit_code', ExitCodeCompletion);
+  target.registerPlugin('completions', 'file_exists', FileExistsCompletion);
+  target.registerPlugin('completions', 'output_check', OutputCheckCompletion);
+
+  // Middlewares
+  target.registerPlugin('middlewares', 'static_context', StaticContextMiddleware);
+}

package/src/completions/output-check.ts

@@ -1,92 +1,92 @@
-import type { CompletionPlugin, CompletionContext, TaskResult } from '../types';
-import { shellArgs, parseDuration } from '../utils';
-
-const DEFAULT_TIMEOUT_MS = 30_000;
-
-export const OutputCheckCompletion: CompletionPlugin = {
-  name: 'output_check',
-  schema: {
-    description:
-      'Pipe the task output into a shell command; mark success when that command exits 0. For AI driver tasks the driver-normalized text is piped (not the raw NDJSON); command tasks see their raw stdout.',
-    fields: {
-      check: {
-        type: 'string',
-        required: true,
-        description:
-          'Shell command to run. The task output is piped to its stdin — normalizedOutput when the driver provides one, otherwise raw stdout.',
-        placeholder: "grep -q 'PASS'",
-      },
-      timeout: {
-        type: 'duration',
-        default: '30s',
-        description: 'Maximum time to wait for the check command.',
-        placeholder: '30s',
-      },
-    },
-  },
-
-  async check(
-    config: Record<string, unknown>,
-    result: TaskResult,
-    ctx: CompletionContext,
-  ): Promise<boolean> {
-    const checkCmd = config.check as string;
-    if (!checkCmd) throw new Error('output_check completion: "check" is required');
-
-    const timeoutMs =
-      config.timeout != null ? parseDuration(String(config.timeout)) : DEFAULT_TIMEOUT_MS;
-
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-
-    // Wire pipeline abort signal into the check process so external abort
-    // terminates the child instead of leaving it running undetected.
-    const onAbort = () => controller.abort();
-    if (ctx.signal) {
-      if (ctx.signal.aborted) {
-        controller.abort();
-      } else {
-        ctx.signal.addEventListener('abort', onAbort, { once: true });
-      }
-    }
-
-    const proc = Bun.spawn(shellArgs(checkCmd) as string[], {
-      cwd: ctx.workDir,
-      stdin: 'pipe',
-      stdout: 'pipe',
-      stderr: 'pipe',
-      signal: controller.signal,
-    });
-
-    try {
-      if (proc.stdin) {
-        try {
-          // Prefer driver-normalized text (e.g. concatenated message text for
-          // AI drivers that emit NDJSON). Falling back to raw stdout keeps
-          // command tasks and drivers without parseResult working.
-          const payload = result.normalizedOutput ?? result.stdout;
-          proc.stdin.write(payload);
-          proc.stdin.end(); // no await — consistent with runner.ts; proc.exited handles sync
-        } catch (err: unknown) {
-          // EPIPE is expected when the check process exits before reading all of stdin
-          // (e.g. `grep -q` exits on first match). Anything else is a real failure.
-          const code = (err as NodeJS.ErrnoException)?.code;
-          if (code !== 'EPIPE') throw err;
-        }
-      }
-
-      // Consume stderr concurrently with waiting for exit to prevent pipe-buffer
-      // deadlock when check script emits more than ~64 KB of stderr output.
-      const [exitCode, stderr] = await Promise.all([proc.exited, new Response(proc.stderr).text()]);
-
-      if (exitCode !== 0 && stderr.trim()) {
-        console.warn(`[output_check] "${checkCmd}" exit=${exitCode}: ${stderr.trim()}`);
-      }
-
-      return exitCode === 0;
-    } finally {
-      clearTimeout(timer);
-      if (ctx.signal) ctx.signal.removeEventListener('abort', onAbort);
-    }
-  },
-};
+import type { CompletionPlugin, CompletionContext, TaskResult } from '../types';
+import { shellArgs, parseDuration } from '../utils';
+
+const DEFAULT_TIMEOUT_MS = 30_000;
+
+export const OutputCheckCompletion: CompletionPlugin = {
+  name: 'output_check',
+  schema: {
+    description:
+      'Pipe the task output into a shell command; mark success when that command exits 0. For AI driver tasks the driver-normalized text is piped (not the raw NDJSON); command tasks see their raw stdout.',
+    fields: {
+      check: {
+        type: 'string',
+        required: true,
+        description:
+          'Shell command to run. The task output is piped to its stdin — normalizedOutput when the driver provides one, otherwise raw stdout.',
+        placeholder: "grep -q 'PASS'",
+      },
+      timeout: {
+        type: 'duration',
+        default: '30s',
+        description: 'Maximum time to wait for the check command.',
+        placeholder: '30s',
+      },
+    },
+  },
+
+  async check(
+    config: Record<string, unknown>,
+    result: TaskResult,
+    ctx: CompletionContext,
+  ): Promise<boolean> {
+    const checkCmd = config.check as string;
+    if (!checkCmd) throw new Error('output_check completion: "check" is required');
+
+    const timeoutMs =
+      config.timeout != null ? parseDuration(String(config.timeout)) : DEFAULT_TIMEOUT_MS;
+
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+
+    // Wire pipeline abort signal into the check process so external abort
+    // terminates the child instead of leaving it running undetected.
+    const onAbort = () => controller.abort();
+    if (ctx.signal) {
+      if (ctx.signal.aborted) {
+        controller.abort();
+      } else {
+        ctx.signal.addEventListener('abort', onAbort, { once: true });
+      }
+    }
+
+    const proc = Bun.spawn(shellArgs(checkCmd) as string[], {
+      cwd: ctx.workDir,
+      stdin: 'pipe',
+      stdout: 'pipe',
+      stderr: 'pipe',
+      signal: controller.signal,
+    });
+
+    try {
+      if (proc.stdin) {
+        try {
+          // Prefer driver-normalized text (e.g. concatenated message text for
+          // AI drivers that emit NDJSON). Falling back to raw stdout keeps
+          // command tasks and drivers without parseResult working.
+          const payload = result.normalizedOutput ?? result.stdout;
+          proc.stdin.write(payload);
+          proc.stdin.end(); // no await — consistent with runner.ts; proc.exited handles sync
+        } catch (err: unknown) {
+          // EPIPE is expected when the check process exits before reading all of stdin
+          // (e.g. `grep -q` exits on first match). Anything else is a real failure.
+          const code = (err as NodeJS.ErrnoException)?.code;
+          if (code !== 'EPIPE') throw err;
+        }
+      }
+
+      // Consume stderr concurrently with waiting for exit to prevent pipe-buffer
+      // deadlock when check script emits more than ~64 KB of stderr output.
+      const [exitCode, stderr] = await Promise.all([proc.exited, new Response(proc.stderr).text()]);
+
+      if (exitCode !== 0 && stderr.trim()) {
+        console.warn(`[output_check] "${checkCmd}" exit=${exitCode}: ${stderr.trim()}`);
+      }
+
+      return exitCode === 0;
+    } finally {
+      clearTimeout(timer);
+      if (ctx.signal) ctx.signal.removeEventListener('abort', onAbort);
+    }
+  },
+};