@tagma/sdk 0.4.2 → 0.4.3

package/dist/pipeline-runner.js

@@ -0,0 +1,139 @@
+// ═══ PipelineRunner ═══
+//
+// Wraps runPipeline in a lifecycle object suited for multi-pipeline management
+// in sidecar / Tauri IPC scenarios. Each instance controls one pipeline run.
+//
+// Typical sidecar usage:
+//
+//   const runners = new Map<string, PipelineRunner>();
+//
+//   const runner = new PipelineRunner(config, workDir);
+//   runner.subscribe(event => ipcEmit('pipeline_event', event));
+//   runner.start();
+//   runners.set(runner.instanceId, runner);
+//
+//   // Later, from IPC:
+//   runners.get(id)?.abort();
+import { runPipeline } from './engine';
+import { generateRunId } from './utils';
+export class PipelineRunner {
+    config;
+    workDir;
+    opts;
+    /**
+     * Stable ID assigned before start() — safe to use as a Map key in the sidecar
+     * before the engine-assigned runId becomes available.
+     */
+    instanceId;
+    /**
+     * The runId generated by the engine. Available after the first 'pipeline_start'
+     * event fires (i.e. effectively immediately after start() is called).
+     * null until then.
+     */
+    _runId = null;
+    _status = 'idle';
+    _result = null;
+    _abortController = new AbortController();
+    _handlers = new Set();
+    _states = null;
+    _statesMirror = new Map();
+    constructor(config, workDir, opts = {}) {
+        this.config = config;
+        this.workDir = workDir;
+        this.opts = opts;
+        this.instanceId = generateRunId();
+    }
+    get runId() { return this._runId; }
+    get status() { return this._status; }
+    /**
+     * Start the pipeline. Calling start() more than once returns the same Promise.
+     */
+    start() {
+        if (this._result)
+            return this._result;
+        // Guard: if abort() was called before start(), the signal is already
+        // aborted. Create a fresh controller so the pipeline doesn't terminate
+        // immediately. If users truly want pre-abort semantics, they call
+        // abort() after start().
+        if (this._abortController.signal.aborted) {
+            this._abortController = new AbortController();
+            this._status = 'idle';
+        }
+        this._status = 'running';
+        this._result = runPipeline(this.config, this.workDir, {
+            ...this.opts,
+            signal: this._abortController.signal,
+            onEvent: (event) => {
+                if (event.type === 'pipeline_start') {
+                    this._runId = event.runId;
+                    // Initialize the live mirror with the full initial state snapshot
+                    for (const [id, state] of event.states) {
+                        this._statesMirror.set(id, { ...state });
+                    }
+                }
+                if (event.type === 'task_status_change') {
+                    // Keep the mirror up to date so getStates() works during the run
+                    this._statesMirror.set(event.taskId, event.state);
+                }
+                if (event.type === 'pipeline_end') {
+                    this._status = this._abortController.signal.aborted ? 'aborted' : 'done';
+                }
+                for (const h of this._handlers)
+                    h(event);
+            },
+        }).then(result => {
+            this._states = result.states;
+            if (this._status === 'running')
+                this._status = 'done';
+            return result;
+        }).catch(err => {
+            this._status = 'aborted';
+            throw err;
+        });
+        return this._result;
+    }
+    /**
+     * Cancel the running pipeline. Safe to call multiple times or before start().
+     */
+    abort(reason) {
+        this._status = 'aborted';
+        this._abortController.abort(reason);
+    }
+    /**
+     * Live snapshot of task states. Available from the first pipeline_start event onward
+     * (i.e. as soon as start() is called) and remains accessible after the run completes.
+     * Returns null only if the pipeline has never started.
+     */
+    getStates() {
+        if (this._states)
+            return snapshotStates(this._states);
+        if (this._statesMirror.size > 0)
+            return snapshotStates(this._statesMirror);
+        return null;
+    }
+    /**
+     * Subscribe to pipeline/task events. Returns an unsubscribe function.
+     * Events are emitted synchronously in the engine's event loop, so keep
+     * handlers non-blocking (e.g. queue to IPC, do not await inside).
+     */
+    subscribe(handler) {
+        this._handlers.add(handler);
+        return () => this._handlers.delete(handler);
+    }
+}
+/** Deep-copy a states map so callers cannot mutate SDK internals. */
+function snapshotStates(src) {
+    const copy = new Map();
+    for (const [id, s] of src) {
+        copy.set(id, {
+            config: { ...s.config },
+            trackConfig: { ...s.trackConfig },
+            status: s.status,
+            result: s.result ? { ...s.result } : null,
+            startedAt: s.startedAt,
+            finishedAt: s.finishedAt,
+        });
+    }
+    return copy;
+}
+//# sourceMappingURL=pipeline-runner.js.map

package/dist/pipeline-runner.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,43 @@
+import type { PluginCategory, DriverPlugin, TriggerPlugin, CompletionPlugin, MiddlewarePlugin, PluginManifest } from './types';
+type PluginType = DriverPlugin | TriggerPlugin | CompletionPlugin | MiddlewarePlugin;
+export type RegisterResult = 'registered' | 'replaced' | 'unchanged';
+/**
+ * Register a plugin under (category, type). Returns:
+ *   - 'registered' on first registration
+ *   - 'replaced'   when an existing entry was overwritten with a different handler
+ *   - 'unchanged'  when the same handler instance was already present
+ *
+ * Throws if `category` is unknown, `type` is empty, or `handler` violates the
+ * minimum interface contract for the category.
+ */
+export declare function registerPlugin<T extends PluginType>(category: PluginCategory, type: string, handler: T): RegisterResult;
+/**
+ * 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.
+ */
+export declare function unregisterPlugin(category: PluginCategory, type: string): boolean;
+export declare function getHandler<T extends PluginType>(category: PluginCategory, type: string): T;
+export declare function hasHandler(category: PluginCategory, type: string): boolean;
+export declare const PLUGIN_NAME_RE: RegExp;
+export declare function isValidPluginName(name: unknown): name is string;
+/**
+ * Parse and validate the `tagmaPlugin` field of a `package.json` blob.
+ *
+ * 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 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
+ * the plugin author should hear about loudly, not a silent skip.
+ *
+ * Hosts use this during auto-discovery to decide whether to load a
+ * package as a plugin without having to dynamically `import()` it.
+ */
+export declare function readPluginManifest(pkgJson: unknown): PluginManifest | null;
+export declare function loadPlugins(pluginNames: readonly string[]): Promise<void>;
+export declare function listRegistered(category: PluginCategory): string[];
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAAE,YAAY,EAAE,aAAa,EAC3C,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EACnD,MAAM,SAAS,CAAC;AAEjB,KAAK,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAsFrF,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC;AAErE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,UAAU,EACjD,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GACjD,cAAc,CAchB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhF;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,UAAU,EAC7C,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GACrC,CAAC,CASH;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1E;AAKD,eAAO,MAAM,cAAc,QAA4D,CAAC;AAExF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAE/D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAmB1E;AAED,wBAAsB,WAAW,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/E;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE,CAEjE"}

package/dist/registry.js

@@ -0,0 +1,182 @@
+const VALID_CATEGORIES = new Set([
+    'drivers', 'triggers', 'completions', 'middlewares',
+]);
+const registries = {
+    drivers: new Map(),
+    triggers: new Map(),
+    completions: new Map(),
+    middlewares: new Map(),
+};
+/**
+ * Minimal contract enforcement so a malformed plugin fails fast at
+ * 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
+ *     get capabilities() { throw new Error('boom') }
+ * and pass the basic typeof check, then crash preflight when the engine
+ * touches `driver.capabilities.sessionResume`. (R8)
+ */
+function validateContract(category, handler) {
+    if (!handler || typeof handler !== 'object') {
+        throw new Error(`Plugin handler for category "${category}" must be an object`);
+    }
+    const h = handler;
+    if (typeof h.name !== 'string' || h.name.length === 0) {
+        throw new Error(`Plugin handler for category "${category}" must declare a non-empty "name"`);
+    }
+    switch (category) {
+        case 'drivers': {
+            if (typeof h.buildCommand !== 'function') {
+                throw new Error(`drivers plugin "${h.name}" must export buildCommand()`);
+            }
+            // Materialize capabilities — this triggers any throwing getter NOW
+            // instead of during preflight.
+            let caps;
+            try {
+                caps = h.capabilities;
+            }
+            catch (err) {
+                throw new Error(`drivers plugin "${h.name}" capabilities accessor threw: ` +
+                    (err instanceof Error ? err.message : String(err)));
+            }
+            if (!caps || typeof caps !== 'object') {
+                throw new Error(`drivers plugin "${h.name}" must declare capabilities object`);
+            }
+            const c = caps;
+            for (const field of ['sessionResume', 'systemPrompt', 'outputFormat']) {
+                if (typeof c[field] !== 'boolean') {
+                    throw new Error(`drivers plugin "${h.name}".capabilities.${field} must be a boolean (got ${typeof c[field]})`);
+                }
+            }
+            // Optional methods, but if present must be functions.
+            for (const opt of ['parseResult', 'resolveModel', 'resolveTools']) {
+                if (h[opt] !== undefined && typeof h[opt] !== 'function') {
+                    throw new Error(`drivers plugin "${h.name}".${opt} must be a function or undefined`);
+                }
+            }
+            break;
+        }
+        case 'triggers':
+            if (typeof h.watch !== 'function') {
+                throw new Error(`triggers plugin "${h.name}" must export watch()`);
+            }
+            break;
+        case 'completions':
+            if (typeof h.check !== 'function') {
+                throw new Error(`completions plugin "${h.name}" must export check()`);
+            }
+            break;
+        case 'middlewares':
+            if (typeof h.enhance !== 'function') {
+                throw new Error(`middlewares plugin "${h.name}" must export enhance()`);
+            }
+            break;
+    }
+}
+/**
+ * Register a plugin under (category, type). Returns:
+ *   - 'registered' on first registration
+ *   - 'replaced'   when an existing entry was overwritten with a different handler
+ *   - 'unchanged'  when the same handler instance was already present
+ *
+ * Throws if `category` is unknown, `type` is empty, or `handler` violates the
+ * minimum interface contract for the category.
+ */
+export function registerPlugin(category, type, handler) {
+    if (!VALID_CATEGORIES.has(category)) {
+        throw new Error(`Unknown plugin category "${category}"`);
+    }
+    if (typeof type !== 'string' || type.length === 0) {
+        throw new Error(`Plugin type must be a non-empty string (category="${category}")`);
+    }
+    validateContract(category, handler);
+    const registry = registries[category];
+    const existing = registry.get(type);
+    if (existing === handler)
+        return 'unchanged';
+    const wasReplaced = existing !== undefined;
+    registry.set(type, handler);
+    return wasReplaced ? 'replaced' : 'registered';
+}
+/**
+ * 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.
+ */
+export function unregisterPlugin(category, type) {
+    if (!VALID_CATEGORIES.has(category))
+        return false;
+    return registries[category].delete(type);
+}
+export function getHandler(category, type) {
+    const handler = registries[category].get(type);
+    if (!handler) {
+        throw new Error(`${category} type "${type}" not registered.\n` +
+            `Install the plugin: bun add @tagma/${category.replace(/s$/, '')}-${type}`);
+    }
+    return handler;
+}
+export function hasHandler(category, type) {
+    return registries[category].has(type);
+}
+// Plugin name must be a scoped npm package or a tagma-prefixed package.
+// Reject absolute/relative paths and suspicious patterns to prevent
+// arbitrary code execution via crafted YAML configs.
+export const PLUGIN_NAME_RE = /^(@[a-z0-9-]+\/[a-z0-9._-]+|tagma-plugin-[a-z0-9._-]+)$/;
+export function isValidPluginName(name) {
+    return typeof name === 'string' && PLUGIN_NAME_RE.test(name);
+}
+/**
+ * Parse and validate the `tagmaPlugin` field of a `package.json` blob.
+ *
+ * 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 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
+ * the plugin author should hear about loudly, not a silent skip.
+ *
+ * Hosts use this during auto-discovery to decide whether to load a
+ * package as a plugin without having to dynamically `import()` it.
+ */
+export function readPluginManifest(pkgJson) {
+    if (!pkgJson || typeof pkgJson !== 'object')
+        return null;
+    const raw = pkgJson.tagmaPlugin;
+    if (raw === undefined)
+        return null;
+    if (!raw || typeof raw !== 'object') {
+        throw new Error('tagmaPlugin field must be an object with { category, type }');
+    }
+    const m = raw;
+    const category = m.category;
+    const type = m.type;
+    if (typeof category !== 'string' || !VALID_CATEGORIES.has(category)) {
+        throw new Error(`tagmaPlugin.category must be one of ${[...VALID_CATEGORIES].join(', ')}, got ${JSON.stringify(category)}`);
+    }
+    if (typeof type !== 'string' || type.length === 0) {
+        throw new Error(`tagmaPlugin.type must be a non-empty string, got ${JSON.stringify(type)}`);
+    }
+    return { category: category, type };
+}
+export async function loadPlugins(pluginNames) {
+    for (const name of pluginNames) {
+        if (!isValidPluginName(name)) {
+            throw new Error(`Plugin "${name}" rejected: plugin names must be scoped npm packages ` +
+                `(e.g. @tagma/trigger-xyz) or tagma-plugin-* packages. ` +
+                `Relative/absolute paths are not allowed.`);
+        }
+        const mod = await import(name);
+        if (!mod.pluginCategory || !mod.pluginType || !mod.default) {
+            throw new Error(`Plugin "${name}" must export pluginCategory, pluginType, and default`);
+        }
+        registerPlugin(mod.pluginCategory, mod.pluginType, mod.default);
+    }
+}
+export function listRegistered(category) {
+    return [...registries[category].keys()];
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,19 @@
+import type { SpawnSpec, DriverPlugin, TaskResult } from './types';
+export interface RunOptions {
+    readonly timeoutMs?: number;
+    readonly signal?: AbortSignal;
+}
+/**
+ * R2: Validate a SpawnSpec returned by a third-party driver. Returns null on
+ * success or a human-readable error message describing the first violation.
+ *
+ * Catching this here is critical: an undetected bad spec ends up calling
+ * Bun.spawn with garbage and the resulting TypeError leaks into engine
+ * processTask's catch block as "Cannot read properties of undefined". By
+ * validating here we surface a clear "Driver X returned invalid args" message
+ * instead, and short-circuit before holding any process resources.
+ */
+export declare function validateSpawnSpec(spec: unknown, driverName: string): string | null;
+export declare function runSpawn(spec: SpawnSpec, driver: DriverPlugin | null, opts?: RunOptions): Promise<TaskResult>;
+export declare function runCommand(command: string, cwd: string, opts?: RunOptions): Promise<TaskResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAc,MAAM,SAAS,CAAC;AA+B/E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAsFD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoClF;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,YAAY,GAAG,IAAI,EAC3B,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,UAAU,CAAC,CAmNrB;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,UAAU,CAAC,CAMrB"}