@tagma/sdk 0.4.1 → 0.4.3

package/dist/triggers/file.js

@@ -0,0 +1,123 @@
+import { watch } from 'chokidar';
+import { resolve, dirname } from 'path';
+import { mkdir } from 'fs/promises';
+import { parseDuration, validatePath } from '../utils';
+import { TriggerTimeoutError } from '../engine';
+const IS_WINDOWS = process.platform === 'win32';
+function pathsEqual(a, b) {
+    return IS_WINDOWS ? a.toLowerCase() === b.toLowerCase() : a === b;
+}
+export const FileTrigger = {
+    name: 'file',
+    schema: {
+        description: 'Wait for a file to appear or be modified before the task runs.',
+        fields: {
+            path: {
+                type: 'path',
+                required: true,
+                description: 'Path to the file to watch (relative to workDir or absolute).',
+                placeholder: 'e.g. build/output.json',
+            },
+            timeout: {
+                type: 'duration',
+                description: 'Maximum wait time (e.g. 30s, 5m). Omit or 0 to wait indefinitely.',
+                placeholder: '30s',
+            },
+        },
+    },
+    watch(config, ctx) {
+        const filePath = config.path;
+        if (!filePath)
+            throw new Error(`file trigger: "path" is required`);
+        const safePath = validatePath(filePath, ctx.workDir);
+        const timeoutMs = config.timeout != null ? parseDuration(String(config.timeout)) : 0;
+        return new Promise(async (resolve_p, reject) => {
+            if (ctx.signal.aborted) {
+                reject(new Error('Pipeline aborted'));
+                return;
+            }
+            let settled = false;
+            let timer = null;
+            // Ensure the parent directory exists so the watcher doesn't fail
+            // with ENOENT for nested paths like `build/output/result.json`.
+            const dir = dirname(safePath);
+            try {
+                await mkdir(dir, { recursive: true });
+            }
+            catch { /* best effort — dir may already exist */ }
+            const watcher = watch(dir, {
+                ignoreInitial: true,
+                depth: 0,
+                awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 },
+            });
+            const cleanup = () => {
+                if (settled)
+                    return;
+                settled = true;
+                watcher.close().catch(() => { });
+                if (timer)
+                    clearTimeout(timer);
+                ctx.signal.removeEventListener('abort', onAbort);
+            };
+            const onAbort = () => {
+                cleanup();
+                reject(new Error('Pipeline aborted'));
+            };
+            watcher.on('add', (addedPath) => {
+                if (settled)
+                    return;
+                if (pathsEqual(resolve(addedPath), safePath)) {
+                    cleanup();
+                    resolve_p({ path: safePath });
+                }
+            });
+            // Also fire on 'change' so that overwriting an existing file is detected.
+            // Without this, upstream tasks that truncate-and-rewrite a file emit only
+            // a 'change' event and the downstream trigger would never resolve.
+            watcher.on('change', (changedPath) => {
+                if (settled)
+                    return;
+                if (pathsEqual(resolve(changedPath), safePath)) {
+                    cleanup();
+                    resolve_p({ path: safePath });
+                }
+            });
+            watcher.on('error', (err) => {
+                if (settled)
+                    return;
+                cleanup();
+                reject(new Error(`file trigger watch error: ${err instanceof Error ? err.message : String(err)}`));
+            });
+            // After the watcher finishes its initial scan, check if the file already exists.
+            // Doing this inside 'ready' eliminates the race window between existence check
+            // and watcher startup, so we neither miss events nor double-resolve.
+            watcher.on('ready', () => {
+                if (settled)
+                    return;
+                Bun.file(safePath).exists().then((exists) => {
+                    if (settled)
+                        return;
+                    if (exists) {
+                        cleanup();
+                        resolve_p({ path: safePath });
+                    }
+                }).catch((err) => {
+                    if (settled)
+                        return;
+                    cleanup();
+                    reject(new Error(`file trigger existence check failed: ${err instanceof Error ? err.message : String(err)}`));
+                });
+            });
+            if (timeoutMs > 0) {
+                timer = setTimeout(() => {
+                    if (settled)
+                        return;
+                    cleanup();
+                    reject(new TriggerTimeoutError(`file trigger timeout: ${filePath} did not appear within ${config.timeout}`));
+                }, timeoutMs);
+            }
+            ctx.signal.addEventListener('abort', onAbort);
+        });
+    },
+};
+//# sourceMappingURL=file.js.map

package/dist/triggers/file.js.map

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

package/dist/triggers/manual.d.ts

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

package/dist/triggers/manual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.d.ts","sourceRoot":"","sources":["../../src/triggers/manual.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,UAAU,CAAC;AAI9D,eAAO,MAAM,aAAa,EAAE,aA4E3B,CAAC"}

package/dist/triggers/manual.js

@@ -0,0 +1,73 @@
+import { parseDuration } from '../utils';
+import { TriggerBlockedError, TriggerTimeoutError } from '../engine';
+export const ManualTrigger = {
+    name: 'manual',
+    schema: {
+        description: 'Pause the task until a user approves via the approval gateway.',
+        fields: {
+            message: {
+                type: 'string',
+                description: 'Prompt shown to the approver. Defaults to a generic message if empty.',
+                placeholder: 'Confirm deployment to production?',
+            },
+            timeout: {
+                type: 'duration',
+                description: 'Maximum wait time (e.g. 10m). Omit or 0 to wait indefinitely.',
+                placeholder: '10m',
+            },
+        },
+    },
+    async watch(config, ctx) {
+        const message = config.message ?? `Manual confirmation required for task "${ctx.taskId}"`;
+        const timeoutMs = config.timeout ? parseDuration(config.timeout) : 0;
+        const metadata = config.metadata && typeof config.metadata === 'object'
+            ? config.metadata
+            : undefined;
+        const decisionPromise = ctx.approvalGateway.request({
+            taskId: ctx.taskId,
+            trackId: ctx.trackId,
+            message,
+            timeoutMs,
+            metadata,
+        });
+        // Wire AbortSignal → try to resolve this specific request as aborted.
+        // We can't directly cancel via the gateway (no id yet at .request() call site),
+        // so instead we race against an abort promise and let engine status logic
+        // fall back to pipelineAborted → skipped. abortAll() on gateway still runs
+        // from engine shutdown path to clean up any truly-pending entries.
+        const onAbort = () => { };
+        const abortPromise = new Promise((_, reject) => {
+            if (ctx.signal.aborted) {
+                reject(new Error('Pipeline aborted'));
+                return;
+            }
+            const handler = () => reject(new Error('Pipeline aborted'));
+            // Store reference so we can remove it after the race settles.
+            onAbort.handler = handler;
+            ctx.signal.addEventListener('abort', handler, { once: true });
+        });
+        let decision;
+        try {
+            decision = await Promise.race([decisionPromise, abortPromise]);
+        }
+        finally {
+            // Clean up the abort listener to prevent leaking on normal completion.
+            const handler = onAbort.handler;
+            if (handler)
+                ctx.signal.removeEventListener('abort', handler);
+        }
+        switch (decision.outcome) {
+            case 'approved':
+                return { confirmed: true, approvalId: decision.approvalId, actor: decision.actor };
+            case 'rejected':
+                // A7: Use typed error for proper classification in the engine.
+                throw new TriggerBlockedError(`Manual trigger rejected by ${decision.actor ?? 'user'}` +
+                    (decision.reason ? `: ${decision.reason}` : ''));
+            case 'timeout':
+                throw new TriggerTimeoutError(`Manual trigger timeout: ${decision.reason ?? 'no decision made'}`);
+            case 'aborted':
+                throw new TriggerBlockedError(`Manual trigger aborted: ${decision.reason ?? 'pipeline aborted'}`);
+        }
+    },
+};
+//# sourceMappingURL=manual.js.map

package/dist/triggers/manual.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,4 @@
+export * from '@tagma/types';
+import type { Permissions } from '@tagma/types';
+export declare const DEFAULT_PERMISSIONS: Permissions;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAOA,cAAc,cAAc,CAAC;AAE7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,eAAO,MAAM,mBAAmB,EAAE,WAIjC,CAAC"}

package/dist/types.js

@@ -0,0 +1,14 @@
+// ═══ Engine-facing type surface ═══
+//
+// All type definitions live in the shared `@tagma/types` workspace package
+// so that plugins under plugins/* can depend on the same types without
+// reaching into the engine's internals. This file re-exports everything
+// and adds runtime-only values (constants) that plugins don't need.
+export * from '@tagma/types';
+// ═══ Runtime Constants ═══
+export const DEFAULT_PERMISSIONS = {
+    read: true,
+    write: false,
+    execute: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,EAAE;AACF,2EAA2E;AAC3E,uEAAuE;AACvE,wEAAwE;AACxE,oEAAoE;AAEpE,cAAc,cAAc,CAAC;AAI7B,4BAA4B;AAE5B,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,KAAK;IACZ,OAAO,EAAE,KAAK;CACf,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,14 @@
+export declare function parseDuration(input: string): number;
+export declare function validatePath(filePath: string, projectRoot: string): string;
+export declare function validatePathParam(filePath: string): void;
+export declare function generateRunId(): string;
+export declare function truncateForName(text: string, maxLen?: number): string;
+export declare function nowISO(): string;
+export declare function shellArgs(command: string): readonly string[];
+/**
+ * Convert an args array to shell-wrapped args suitable for Bun.spawn.
+ * Each arg is quoted as needed, then joined and passed through shellArgs.
+ */
+export declare function shellArgsFromArray(args: readonly string[]): readonly string[];
+export declare function _resetShellCache(): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcnD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAY1E;AAID,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAUxD;AAID,wBAAgB,aAAa,IAAI,MAAM,CAOtC;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,CAMjE;AAED,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAsDD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAU5D;AAcD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAE7E;AAGD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/utils.js

@@ -0,0 +1,138 @@
+import { resolve, relative } from 'path';
+import { randomBytes } from 'crypto';
+const DURATION_RE = /^(\d*\.?\d+)\s*(s|m|h|d)$/;
+export function parseDuration(input) {
+    const match = DURATION_RE.exec(input.trim());
+    if (!match) {
+        throw new Error(`Invalid duration format: "${input}". Expected format: <number>(s|m|h|d)`);
+    }
+    const value = parseFloat(match[1]);
+    const unit = match[2];
+    switch (unit) {
+        case 's': return value * 1000;
+        case 'm': return value * 60_000;
+        case 'h': return value * 3_600_000;
+        case 'd': return value * 86_400_000;
+        default: throw new Error(`Unknown duration unit: "${unit}"`);
+    }
+}
+export function validatePath(filePath, projectRoot) {
+    const resolved = resolve(projectRoot, filePath);
+    const rel = relative(projectRoot, resolved);
+    if (rel.startsWith('..') || rel.startsWith('/') || /^[a-zA-Z]:/.test(rel)) {
+        throw new Error(`Security: path "${filePath}" escapes project root. ` +
+            `All file references must be within "${projectRoot}".`);
+    }
+    return resolved;
+}
+const SHELL_META_CHARS = /[;&|$`\\!><()\[\]{}*?#~]/;
+export function validatePathParam(filePath) {
+    if (filePath.includes('..')) {
+        throw new Error(`Template param type=path: ".." traversal not allowed in "${filePath}"`);
+    }
+    if (resolve(filePath) === filePath) {
+        throw new Error(`Template param type=path: absolute path not allowed: "${filePath}"`);
+    }
+    if (SHELL_META_CHARS.test(filePath)) {
+        throw new Error(`Template param type=path: shell metacharacters not allowed in "${filePath}"`);
+    }
+}
+let runCounter = 0;
+export function generateRunId() {
+    const ts = Date.now().toString(36);
+    const seq = (runCounter++).toString(36).padStart(2, '0');
+    // Random suffix prevents ID collisions when two pipelines start within
+    // the same millisecond or after a process restart resets the counter.
+    const rand = randomBytes(3).toString('hex');
+    return `run_${ts}_${seq}_${rand}`;
+}
+export function truncateForName(text, maxLen = 40) {
+    const first = text.split('\n')[0].trim();
+    // Guard: if the first line is empty (e.g. prompt is all whitespace/newlines),
+    // fall back to the raw text trimmed rather than silently producing an empty name.
+    if (!first)
+        return text.trim().slice(0, maxLen) || '...';
+    return first.length > maxLen ? first.slice(0, maxLen) + '...' : first;
+}
+export function nowISO() {
+    return new Date().toISOString();
+}
+// ═══ Platform-aware shell ═══
+//
+// Resolution order:
+//   1. Env override: PIPELINE_SHELL="bash" or PIPELINE_SHELL="cmd" etc.
+//   2. Windows: prefer sh (Git Bash / MSYS2) if on PATH, fall back to cmd.exe
+//   3. Unix: sh
+//
+// Resolution is cached once on first call to avoid repeated PATH lookups.
+const IS_WINDOWS = process.platform === 'win32';
+let resolvedShell = null;
+function detectShell() {
+    // Env override takes precedence
+    const override = process.env.PIPELINE_SHELL;
+    if (override) {
+        const kind = override;
+        return { kind, path: override };
+    }
+    if (!IS_WINDOWS) {
+        return { kind: 'sh', path: 'sh' };
+    }
+    // Windows: probe PATH for sh (bundled with Git for Windows / MSYS2)
+    const pathEnv = process.env.PATH ?? '';
+    const pathExt = (process.env.PATHEXT ?? '.EXE;.CMD;.BAT').split(';');
+    const dirs = pathEnv.split(';').filter(Boolean);
+    for (const dir of dirs) {
+        for (const ext of ['', ...pathExt]) {
+            const candidate = `${dir}\\sh${ext}`;
+            try {
+                if (Bun.file(candidate).size > 0) {
+                    return { kind: 'sh', path: candidate };
+                }
+            }
+            catch { /* ignore */ }
+        }
+    }
+    // Fallback: cmd.exe (always present on Windows)
+    const systemRoot = process.env.SystemRoot ?? 'C:\\Windows';
+    return { kind: 'cmd', path: `${systemRoot}\\System32\\cmd.exe` };
+}
+function getShell() {
+    if (!resolvedShell)
+        resolvedShell = detectShell();
+    return resolvedShell;
+}
+export function shellArgs(command) {
+    const sh = getShell();
+    if (sh.kind === 'cmd') {
+        return [sh.path, '/c', command];
+    }
+    if (sh.kind === 'powershell') {
+        return [sh.path, '-Command', command];
+    }
+    // sh or bash
+    return [sh.path, '-c', command];
+}
+/** Quote a single argument for inclusion in a shell command string. */
+function quoteArg(arg) {
+    if (!/[\s"'\\<>|&;`$!^%]/.test(arg))
+        return arg;
+    if (IS_WINDOWS) {
+        // On Windows (cmd.exe), double-quote and escape embedded quotes + backslashes
+        return '"' + arg.replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+    }
+    // On Unix, use single quotes to prevent $variable expansion.
+    // Escape embedded single quotes via the '\'' idiom.
+    return "'" + arg.replace(/'/g, "'\\''") + "'";
+}
+/**
+ * Convert an args array to shell-wrapped args suitable for Bun.spawn.
+ * Each arg is quoted as needed, then joined and passed through shellArgs.
+ */
+export function shellArgsFromArray(args) {
+    return shellArgs(args.map(quoteArg).join(' '));
+}
+// For tests: allow resetting the cached shell detection
+export function _resetShellCache() {
+    resolvedShell = null;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/validate-raw.d.ts

@@ -0,0 +1,26 @@
+import type { RawPipelineConfig } from './types';
+export type ValidationSeverity = 'error' | 'warning';
+export interface ValidationError {
+    /** JSONPath-style location, e.g. "tracks[0].tasks[1].prompt" */
+    path: string;
+    message: string;
+    /**
+     * H8: not all "errors" are equally fatal. The DAG runtime is happy to
+     * insert implicit `continue_from → depends_on` ordering, so the matching
+     * validate-raw check is a *style* nit, not a hard failure. Severity lets
+     * the editor render it as a soft warning instead of blocking save / run.
+     * Existing call sites that don't read this field still treat every entry
+     * as fatal — defaulting `severity` to undefined preserves that behaviour.
+     */
+    severity?: ValidationSeverity;
+}
+/**
+ * Validate a raw pipeline config.
+ * Checks structure, required fields, prompt/command exclusivity,
+ * depends_on reference integrity, and circular dependencies.
+ *
+ * Does NOT check plugin registration — plugins may not be loaded yet
+ * when the frontend is editing a config offline.
+ */
+export declare function validateRaw(config: RawPipelineConfig): ValidationError[];
+//# sourceMappingURL=validate-raw.d.ts.map

package/dist/validate-raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-raw.d.ts","sourceRoot":"","sources":["../src/validate-raw.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAUjD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,EAAE,CAyKxE"}