@tagma/sdk 0.4.2 → 0.4.4

package/dist/validate-raw.js

@@ -0,0 +1,327 @@
+// ═══ Raw Pipeline Config Validation ═══
+//
+// Validates a RawPipelineConfig without resolving inheritance or executing
+// anything — intended for real-time feedback in a visual editor (e.g. drag
+// to add a task, live error highlighting).
+//
+// Returns a flat list of ValidationError objects. An empty array means valid.
+const DURATION_RE = /^(\d*\.?\d+)\s*(s|m|h|d)$/;
+function isValidDuration(input) {
+    return DURATION_RE.test(input.trim());
+}
+const VALID_ON_FAILURE = new Set(['skip_downstream', 'stop_all', 'ignore']);
+const VALID_MODEL_TIERS = new Set(['low', 'medium', 'high']);
+// Built-in plugin types always known to the SDK core, regardless of which
+// external plugin packages are installed. These MUST stay in sync with the
+// types that `bootstrapBuiltins()` registers, otherwise the editor will
+// emit false-positive "unknown type" warnings for stock pipelines.
+const BUILTIN_TRIGGER_TYPES = new Set(['manual', 'file']);
+const BUILTIN_COMPLETION_TYPES = new Set([
+    'exit_code', 'file_exists', 'output_check',
+]);
+const BUILTIN_MIDDLEWARE_TYPES = new Set(['static_context']);
+/**
+ * Validate a raw pipeline config.
+ * Checks structure, required fields, prompt/command exclusivity,
+ * depends_on reference integrity, and circular dependencies.
+ *
+ * Plugin type checks: when `knownTypes` is provided, task/track references to
+ * trigger/completion/middleware types that are neither built-in nor in the
+ * supplied set produce a soft warning (severity: 'warning') — these don't
+ * block save/run but light up the Task panel so users discover the broken
+ * reference in the editor instead of at run time. Omit `knownTypes` to skip
+ * plugin checks entirely (offline/pre-load validation).
+ */
+export function validateRaw(config, knownTypes) {
+    const errors = [];
+    const knownTriggers = knownTypes
+        ? new Set([...BUILTIN_TRIGGER_TYPES, ...(knownTypes.triggers ?? [])])
+        : null;
+    const knownCompletions = knownTypes
+        ? new Set([...BUILTIN_COMPLETION_TYPES, ...(knownTypes.completions ?? [])])
+        : null;
+    const knownMiddlewares = knownTypes
+        ? new Set([...BUILTIN_MIDDLEWARE_TYPES, ...(knownTypes.middlewares ?? [])])
+        : null;
+    // ── Top level ──
+    if (!config.name?.trim()) {
+        errors.push({ path: 'name', message: 'Pipeline name is required' });
+    }
+    if (!config.tracks || config.tracks.length === 0) {
+        errors.push({ path: 'tracks', message: 'At least one track is required' });
+        return errors; // No point going further without tracks
+    }
+    // ── Build qualified ID sets for cross-reference checks ──
+    // Qualified ID format: "trackId.taskId" (mirrors the engine's convention)
+    const allQualified = new Set();
+    // bare taskId → qualified ID, or "__ambiguous__" when multiple tracks share that bare name.
+    // "__ambiguous__" signals that a bare ref is unresolvable without a track prefix.
+    const bareToQualified = new Map();
+    const bareIdCount = new Map();
+    for (const track of config.tracks) {
+        if (!track.id)
+            continue;
+        for (const task of track.tasks ?? []) {
+            if (!task.id)
+                continue;
+            const qid = `${track.id}.${task.id}`;
+            allQualified.add(qid);
+            const count = (bareIdCount.get(task.id) ?? 0) + 1;
+            bareIdCount.set(task.id, count);
+            // Mark as ambiguous when a second track introduces the same bare name.
+            bareToQualified.set(task.id, count === 1 ? qid : '__ambiguous__');
+        }
+    }
+    // ── Per-track validation ──
+    const seenTrackIds = new Set();
+    for (let ti = 0; ti < config.tracks.length; ti++) {
+        const track = config.tracks[ti];
+        const trackPath = `tracks[${ti}]`;
+        if (!track.id?.trim()) {
+            errors.push({ path: `${trackPath}.id`, message: 'Track id is required' });
+        }
+        else if (seenTrackIds.has(track.id)) {
+            errors.push({ path: `${trackPath}.id`, message: `Duplicate track id "${track.id}"` });
+        }
+        else {
+            seenTrackIds.add(track.id);
+        }
+        if (!track.name?.trim()) {
+            errors.push({ path: `${trackPath}.name`, message: 'Track name is required' });
+        }
+        if (track.on_failure && !VALID_ON_FAILURE.has(track.on_failure)) {
+            errors.push({ path: `${trackPath}.on_failure`, message: `Invalid on_failure value "${track.on_failure}". Expected "skip_downstream", "stop_all", or "ignore".` });
+        }
+        if (track.model_tier && !VALID_MODEL_TIERS.has(track.model_tier)) {
+            errors.push({ path: `${trackPath}.model_tier`, message: `Invalid model_tier "${track.model_tier}". Expected "low", "medium", or "high".` });
+        }
+        // Track-level middlewares can reference a plugin that was uninstalled
+        // after the YAML was written — surface a warning so the user notices
+        // before hitting Run.
+        if (knownMiddlewares && track.middlewares) {
+            for (let mi = 0; mi < track.middlewares.length; mi++) {
+                const mw = track.middlewares[mi];
+                if (mw?.type && !knownMiddlewares.has(mw.type)) {
+                    errors.push({
+                        path: `${trackPath}.middlewares[${mi}].type`,
+                        message: `Middleware type "${mw.type}" is not registered. Install the plugin (e.g. @tagma/middleware-${mw.type}) or remove the reference — the pipeline will fail at run time.`,
+                        severity: 'warning',
+                    });
+                }
+            }
+        }
+        if (!track.tasks || track.tasks.length === 0) {
+            errors.push({ path: `${trackPath}.tasks`, message: `Track "${track.id || ti}": must have at least one task` });
+            continue;
+        }
+        // ── Per-task validation ──
+        const seenTaskIds = new Set();
+        for (let ki = 0; ki < track.tasks.length; ki++) {
+            const task = track.tasks[ki];
+            const taskPath = `${trackPath}.tasks[${ki}]`;
+            if (!task.id?.trim()) {
+                errors.push({ path: `${taskPath}.id`, message: 'Task id is required' });
+                continue; // Can't check further without an id
+            }
+            if (seenTaskIds.has(task.id)) {
+                errors.push({ path: taskPath, message: `Duplicate task id "${task.id}" in track "${track.id}"` });
+            }
+            seenTaskIds.add(task.id);
+            // Template-based tasks: skip prompt/command checks (params validated at runtime)
+            if (task.use)
+                continue;
+            const hasPromptKey = typeof task.prompt === 'string';
+            const hasCommandKey = typeof task.command === 'string';
+            const promptEmpty = hasPromptKey && task.prompt.trim().length === 0;
+            const commandEmpty = hasCommandKey && task.command.trim().length === 0;
+            if (hasPromptKey && hasCommandKey) {
+                errors.push({
+                    path: taskPath,
+                    message: `Task "${task.id}": cannot have both "prompt" and "command"`,
+                });
+            }
+            else if (!hasPromptKey && !hasCommandKey) {
+                errors.push({
+                    path: taskPath,
+                    message: `Task "${task.id}": must have "prompt" or "command"`,
+                });
+            }
+            else if (promptEmpty) {
+                errors.push({
+                    path: taskPath,
+                    message: `Task "${task.id}": prompt content cannot be empty`,
+                });
+            }
+            else if (commandEmpty) {
+                errors.push({
+                    path: taskPath,
+                    message: `Task "${task.id}": command content cannot be empty`,
+                });
+            }
+            // ── Field-level validations ──
+            if (task.timeout && !isValidDuration(task.timeout)) {
+                errors.push({ path: `${taskPath}.timeout`, message: `Invalid duration format "${task.timeout}". Expected e.g. "30s", "5m", "1h".` });
+            }
+            if (task.model_tier && !VALID_MODEL_TIERS.has(task.model_tier)) {
+                errors.push({ path: `${taskPath}.model_tier`, message: `Invalid model_tier "${task.model_tier}". Expected "low", "medium", or "high".` });
+            }
+            // ── Plugin type warnings (trigger / completion / middlewares) ──
+            // Only fire when the host supplied a `knownTypes` snapshot, so offline
+            // validation stays quiet. The messages deliberately name the npm
+            // scope so users can copy-paste the install command.
+            if (knownTriggers && task.trigger?.type && !knownTriggers.has(task.trigger.type)) {
+                errors.push({
+                    path: `${taskPath}.trigger.type`,
+                    message: `Trigger type "${task.trigger.type}" is not registered. Install the plugin (e.g. @tagma/trigger-${task.trigger.type}) or the task will fail at run time.`,
+                    severity: 'warning',
+                });
+            }
+            if (knownCompletions && task.completion?.type && !knownCompletions.has(task.completion.type)) {
+                errors.push({
+                    path: `${taskPath}.completion.type`,
+                    message: `Completion type "${task.completion.type}" is not registered. Install the plugin (e.g. @tagma/completion-${task.completion.type}) or the task will fail at run time.`,
+                    severity: 'warning',
+                });
+            }
+            if (knownMiddlewares && task.middlewares) {
+                for (let mi = 0; mi < task.middlewares.length; mi++) {
+                    const mw = task.middlewares[mi];
+                    if (mw?.type && !knownMiddlewares.has(mw.type)) {
+                        errors.push({
+                            path: `${taskPath}.middlewares[${mi}].type`,
+                            message: `Middleware type "${mw.type}" is not registered. Install the plugin (e.g. @tagma/middleware-${mw.type}) or remove the reference — the pipeline will fail at run time.`,
+                            severity: 'warning',
+                        });
+                    }
+                }
+            }
+            // ── depends_on reference checks ──
+            if (task.depends_on && task.depends_on.length > 0) {
+                for (const dep of task.depends_on) {
+                    const resolved = resolveDepRef(dep, track.id, allQualified, bareToQualified);
+                    if (!resolved) {
+                        errors.push({
+                            path: `${taskPath}.depends_on`,
+                            message: `Task "${task.id}": depends_on "${dep}" — no such task found`,
+                        });
+                    }
+                    else if (resolved === '__ambiguous__') {
+                        errors.push({
+                            path: `${taskPath}.depends_on`,
+                            message: `Task "${task.id}": depends_on "${dep}" is ambiguous — multiple tracks have a task with this id. Use the fully-qualified form "trackId.${dep}".`,
+                        });
+                    }
+                }
+            }
+            // ── continue_from reference check ──
+            if (task.continue_from) {
+                const resolved = resolveDepRef(task.continue_from, track.id, allQualified, bareToQualified);
+                if (!resolved) {
+                    errors.push({
+                        path: `${taskPath}.continue_from`,
+                        message: `Task "${task.id}": continue_from "${task.continue_from}" — no such task found`,
+                    });
+                }
+                else if (resolved === '__ambiguous__') {
+                    errors.push({
+                        path: `${taskPath}.continue_from`,
+                        message: `Task "${task.id}": continue_from "${task.continue_from}" is ambiguous — multiple tracks have a task with this id. Use the fully-qualified form "trackId.${task.continue_from}".`,
+                    });
+                }
+                else if (!task.depends_on || !task.depends_on.some(dep => resolveDepRef(dep, track.id, allQualified, bareToQualified) === resolved)) {
+                    // H8: demote to a warning. dag.ts/buildDag inserts continue_from
+                    // as an implicit dependency at runtime, so the pipeline runs fine
+                    // without the explicit listing. Treat as a style hint rather than
+                    // blocking save / run, otherwise we frighten users with a red
+                    // "Configuration error" for code that would have run successfully.
+                    errors.push({
+                        path: `${taskPath}.continue_from`,
+                        message: `Task "${task.id}": continue_from "${task.continue_from}" should also be listed in depends_on for clarity (the runtime will add it implicitly).`,
+                        severity: 'warning',
+                    });
+                }
+            }
+        }
+    }
+    // ── Cycle detection ──
+    errors.push(...detectCycles(config, allQualified, bareToQualified));
+    return errors;
+}
+// ── Helpers ──
+// Returns the resolved qualified ID, null (not found), or '__ambiguous__' (multiple tracks match).
+function resolveDepRef(ref, fromTrackId, allQualified, bareToQualified) {
+    // Fully qualified reference (trackId.taskId) — always unambiguous
+    if (allQualified.has(ref))
+        return ref;
+    // Same-track shorthand — always unambiguous (shadows any global bare match)
+    const sameTrack = `${fromTrackId}.${ref}`;
+    if (allQualified.has(sameTrack))
+        return sameTrack;
+    // Global bare lookup — may be '__ambiguous__' when multiple tracks share the name
+    return bareToQualified.get(ref) ?? null;
+}
+function detectCycles(config, allQualified, bareToQualified) {
+    // Build adjacency: qualifiedId → [resolved dep qualifiedIds]
+    const adj = new Map();
+    for (const track of config.tracks) {
+        if (!track.id)
+            continue;
+        for (const task of track.tasks ?? []) {
+            if (!task.id || task.use)
+                continue;
+            const qid = `${track.id}.${task.id}`;
+            const deps = [];
+            for (const dep of task.depends_on ?? []) {
+                const resolved = resolveDepRef(dep, track.id, allQualified, bareToQualified);
+                if (resolved)
+                    deps.push(resolved);
+            }
+            if (task.continue_from) {
+                const resolved = resolveDepRef(task.continue_from, track.id, allQualified, bareToQualified);
+                if (resolved && !deps.includes(resolved))
+                    deps.push(resolved);
+            }
+            adj.set(qid, deps);
+        }
+    }
+    const errors = [];
+    const visited = new Set();
+    const inStack = new Set();
+    // Deduplicate cycles: the same cycle can be discovered from multiple entry points.
+    // Canonical key = sorted node list joined — order-independent fingerprint.
+    const seenCycles = new Set();
+    // Use a mutable path array instead of copying at each level (O(n) vs O(n^2)).
+    const pathStack = [];
+    function dfs(id) {
+        if (inStack.has(id)) {
+            const cycleStart = pathStack.indexOf(id);
+            // Unique nodes in the cycle (without repeating the start node) for dedup.
+            // Previously the duplicate start node caused different sorted keys when
+            // the same cycle was discovered from different entry points.
+            const uniqueNodes = pathStack.slice(cycleStart);
+            const key = [...uniqueNodes].sort().join(',');
+            if (!seenCycles.has(key)) {
+                seenCycles.add(key);
+                const display = [...uniqueNodes, id]; // include start for readable display
+                errors.push({ path: 'tracks', message: `Circular dependency detected: ${display.join(' → ')}` });
+            }
+            return;
+        }
+        if (visited.has(id))
+            return;
+        visited.add(id);
+        inStack.add(id);
+        pathStack.push(id);
+        for (const dep of adj.get(id) ?? []) {
+            dfs(dep);
+        }
+        pathStack.pop();
+        inStack.delete(id);
+    }
+    for (const id of adj.keys()) {
+        if (!visited.has(id))
+            dfs(id);
+    }
+    return errors;
+}
+//# sourceMappingURL=validate-raw.js.map

package/dist/validate-raw.js.map

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

package/package.json

@@ -1,43 +1,52 @@
 {
   "name": "@tagma/sdk",
-  "version": "0.4.2",
+  "version": "0.4.4",
+  "description": "Local AI task orchestration engine — core SDK for tagma pipelines",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/GoTagma/tagma-sdk.git"
+    "url": "https://github.com/GoTagma/tagma-mono.git",
+    "directory": "packages/sdk"
   },
+  "bugs": "https://github.com/GoTagma/tagma-mono/issues",
+  "homepage": "https://github.com/GoTagma/tagma-mono/tree/main/packages/sdk#readme",
   "type": "module",
-  "workspaces": [
-    "plugins/*"
-  ],
-  "main": "./src/sdk.ts",
+  "sideEffects": false,
+  "main": "./dist/sdk.js",
+  "module": "./dist/sdk.js",
+  "types": "./dist/sdk.d.ts",
   "exports": {
-    ".": "./src/sdk.ts"
+    ".": {
+      "types": "./dist/sdk.d.ts",
+      "import": "./dist/sdk.js",
+      "default": "./dist/sdk.js"
+    }
   },
   "files": [
-    "src",
-    "scripts/preinstall.js"
+    "dist",
+    "src"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "engines": {
     "bun": ">=1.3"
   },
-  "packageManager": "bun@1.3.7",
   "scripts": {
-    "preinstall": "node scripts/preinstall.js",
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "bun run build",
     "test": "bun test",
     "release": "bun scripts/release.ts",
     "release:publish": "bun scripts/release.ts --publish"
   },
   "dependencies": {
+    "@tagma/types": "0.2.1",
     "js-yaml": "^4.1.0",
-    "chokidar": "^4.0.0",
-    "@tagma/types": "0.2.0"
+    "chokidar": "^4.0.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
-    "bun-types": "latest",
-    "typescript": "^6.0.2",
-    "@tagma/driver-codex": "0.1.9",
-    "@tagma/driver-opencode": "0.1.8"
+    "bun-types": "^1.3.11",
+    "typescript": "^5.8.3"
   }
 }

package/src/approval.ts

@@ -5,16 +5,18 @@ import { nowISO } from './utils';
 // ApprovalEvent, ApprovalListener, ApprovalGateway) live in the shared
 // @tagma/types package so trigger plugins can import them without
 // depending on the engine's runtime implementation. This module keeps
-// only the in-memory implementation.
+// only the in-memory implementation. Internal SDK imports go through
+// ./types (the engine-side re-export) for consistency with the rest of
+// the SDK source.
 import type {
   ApprovalRequest, ApprovalDecision, ApprovalEvent, ApprovalListener, ApprovalGateway,
-} from '@tagma/types';
+} from './types';
 
 // Re-export for existing engine-side consumers that import from this file.
 export type {
   ApprovalRequest, ApprovalDecision, ApprovalOutcome, ApprovalEvent,
   ApprovalListener, ApprovalGateway,
-} from '@tagma/types';
+} from './types';
 
 // ═══ Default In-Memory Implementation ═══