@sema-agent/core 1.279.0

package/dist/orchestration/workflow-meta.d.ts

@@ -0,0 +1,13 @@
+import type { WorkflowMeta } from "./workflow-script-runner.js";
+export declare class WorkflowScriptError extends Error {
+    readonly code = "workflow.script_error";
+    constructor(message: string);
+}
+export declare function parseWorkflowMeta(source: string): WorkflowMeta;
+export declare function stripStringsAndComments(src: string): string;
+export declare function workflowScriptReadsClockOrRandom(body: string): boolean;
+export declare function splitWorkflowMeta(source: string): {
+    meta: WorkflowMeta;
+    body: string;
+};
+//# sourceMappingURL=workflow-meta.d.ts.map

package/dist/orchestration/workflow-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-meta.d.ts","sourceRoot":"","sources":["../../src/orchestration/workflow-meta.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAIhE,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,2BAA2B;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAkRD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CA4C9D;AASD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAyD3D;AAID,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtE;AAOD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAMtF"}

package/dist/orchestration/workflow-meta.js

@@ -0,0 +1,367 @@
+export class WorkflowScriptError extends Error {
+    code = "workflow.script_error";
+    constructor(message) {
+        super(message);
+        this.name = "WorkflowScriptError";
+    }
+}
+const FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+function sliceMetaObject(source) {
+    const decl = /export\s+const\s+meta\s*=\s*/.exec(source);
+    if (!decl) {
+        throw new WorkflowScriptError("workflow script must declare `export const meta = { name, description }`");
+    }
+    let i = decl.index + decl[0].length;
+    if (source[i] !== "{") {
+        throw new WorkflowScriptError("`export const meta` must be assigned a literal object `{ ... }`");
+    }
+    const start = i;
+    let depth = 0;
+    for (; i < source.length; i++) {
+        const c = source[i];
+        if (c === '"' || c === "'" || c === "`") {
+            i = skipString(source, i, c);
+            continue;
+        }
+        if (c === "/" && source[i + 1] === "/") {
+            i = source.indexOf("\n", i);
+            if (i === -1)
+                i = source.length;
+            continue;
+        }
+        if (c === "/" && source[i + 1] === "*") {
+            const end = source.indexOf("*/", i + 2);
+            i = end === -1 ? source.length : end + 1;
+            continue;
+        }
+        if (c === "{")
+            depth++;
+        else if (c === "}") {
+            depth--;
+            if (depth === 0)
+                return { objText: source.slice(start, i + 1), declStart: decl.index, objEnd: i + 1 };
+        }
+    }
+    throw new WorkflowScriptError("`export const meta` object literal is not closed (unbalanced braces)");
+}
+function skipString(source, start, quote) {
+    for (let i = start + 1; i < source.length; i++) {
+        const c = source[i];
+        if (c === "\\") {
+            i++;
+            continue;
+        }
+        if (c === quote)
+            return i;
+    }
+    throw new WorkflowScriptError("unterminated string literal in `meta`");
+}
+function tokenize(src) {
+    const toks = [];
+    let i = 0;
+    while (i < src.length) {
+        const c = src[i];
+        if (c === " " || c === "\t" || c === "\n" || c === "\r") {
+            i++;
+            continue;
+        }
+        if (c === "/" && src[i + 1] === "/") {
+            i = src.indexOf("\n", i);
+            if (i === -1)
+                i = src.length;
+            continue;
+        }
+        if (c === "/" && src[i + 1] === "*") {
+            const end = src.indexOf("*/", i + 2);
+            i = end === -1 ? src.length : end + 2;
+            continue;
+        }
+        if (c === "{" || c === "}" || c === "[" || c === "]" || c === ":" || c === ",") {
+            toks.push({ t: c });
+            i++;
+            continue;
+        }
+        if (c === "`") {
+            throw new WorkflowScriptError("`meta` may not contain template literals — use a plain string");
+        }
+        if (c === '"' || c === "'") {
+            const end = skipString(src, i, c);
+            toks.push({ t: "str", v: decodeStringLiteral(src.slice(i, end + 1)) });
+            i = end + 1;
+            continue;
+        }
+        if (c === "-" || (c >= "0" && c <= "9")) {
+            const m = /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?/.exec(src.slice(i));
+            if (!m)
+                throw new WorkflowScriptError("invalid number literal in `meta`");
+            toks.push({ t: "num", v: Number(m[0]) });
+            i += m[0].length;
+            continue;
+        }
+        const im = /^[A-Za-z_$][A-Za-z0-9_$]*/.exec(src.slice(i));
+        if (!im) {
+            throw new WorkflowScriptError(`unexpected character in \`meta\`: ${JSON.stringify(c)} (only literal values are allowed)`);
+        }
+        toks.push({ t: "ident", v: im[0] });
+        i += im[0].length;
+    }
+    return toks;
+}
+function decodeStringLiteral(raw) {
+    const body = raw.slice(1, -1);
+    return body.replace(/\\(u\{[0-9a-fA-F]+\}|u[0-9a-fA-F]{4}|x[0-9a-fA-F]{2}|[\s\S])/g, (_m, esc) => {
+        switch (esc[0]) {
+            case "n": return "\n";
+            case "t": return "\t";
+            case "r": return "\r";
+            case "b": return "\b";
+            case "f": return "\f";
+            case "v": return "\v";
+            case "0": return "\0";
+            case "x": return String.fromCodePoint(parseInt(esc.slice(1), 16));
+            case "u":
+                return esc[1] === "{"
+                    ? String.fromCodePoint(parseInt(esc.slice(2, -1), 16))
+                    : String.fromCodePoint(parseInt(esc.slice(1), 16));
+            default: return esc;
+        }
+    });
+}
+const MAX_META_DEPTH = 64;
+function parseTokens(toks) {
+    let p = 0;
+    let depth = 0;
+    const peek = () => toks[p];
+    const next = () => {
+        const t = toks[p++];
+        if (!t)
+            throw new WorkflowScriptError("unexpected end of `meta` object");
+        return t;
+    };
+    const parseValue = () => {
+        const t = next();
+        switch (t.t) {
+            case "{": return parseObject();
+            case "[": return parseArray();
+            case "str": return t.v;
+            case "num": return t.v;
+            case "ident":
+                if (t.v === "true")
+                    return true;
+                if (t.v === "false")
+                    return false;
+                if (t.v === "null")
+                    return null;
+                throw new WorkflowScriptError(`\`meta\` may only contain literal values — \`${t.v}\` is an identifier reference (not allowed)`);
+            default:
+                throw new WorkflowScriptError(`unexpected token "${t.t}" while reading a \`meta\` value`);
+        }
+    };
+    const parseObject = () => {
+        depth++;
+        try {
+            if (depth > MAX_META_DEPTH)
+                throw new WorkflowScriptError(`\`meta\` nests too deeply (max ${MAX_META_DEPTH})`);
+            return parseObjectBody();
+        }
+        finally {
+            depth--;
+        }
+    };
+    const parseObjectBody = () => {
+        const obj = {};
+        if (peek()?.t === "}") {
+            p++;
+            return obj;
+        }
+        for (;;) {
+            const keyTok = next();
+            let key;
+            if (keyTok.t === "ident")
+                key = keyTok.v;
+            else if (keyTok.t === "str")
+                key = keyTok.v;
+            else if (keyTok.t === "[") {
+                throw new WorkflowScriptError("`meta` may not use computed keys `[ ... ]`");
+            }
+            else {
+                throw new WorkflowScriptError(`invalid \`meta\` object key (token "${keyTok.t}")`);
+            }
+            if (FORBIDDEN_KEYS.has(key)) {
+                throw new WorkflowScriptError(`forbidden key in \`meta\`: ${JSON.stringify(key)}`);
+            }
+            const sep = next();
+            if (sep.t !== ":") {
+                throw new WorkflowScriptError(`\`meta\` keys must be \`key: value\` literals (no shorthand / methods / getters) — near "${key}"`);
+            }
+            const value = parseValue();
+            Object.defineProperty(obj, key, { value, enumerable: true, writable: true, configurable: true });
+            const after = next();
+            if (after.t === "}")
+                return obj;
+            if (after.t !== ",")
+                throw new WorkflowScriptError('expected "," or "}" in `meta` object');
+            if (peek()?.t === "}") {
+                p++;
+                return obj;
+            }
+        }
+    };
+    const parseArray = () => {
+        depth++;
+        try {
+            if (depth > MAX_META_DEPTH)
+                throw new WorkflowScriptError(`\`meta\` nests too deeply (max ${MAX_META_DEPTH})`);
+            return parseArrayBody();
+        }
+        finally {
+            depth--;
+        }
+    };
+    const parseArrayBody = () => {
+        const arr = [];
+        if (peek()?.t === "]") {
+            p++;
+            return arr;
+        }
+        for (;;) {
+            arr.push(parseValue());
+            const after = next();
+            if (after.t === "]")
+                return arr;
+            if (after.t !== ",")
+                throw new WorkflowScriptError('expected "," or "]" in `meta` array');
+            if (peek()?.t === "]") {
+                p++;
+                return arr;
+            }
+        }
+    };
+    const root = parseValue();
+    if (p !== toks.length) {
+        throw new WorkflowScriptError("trailing tokens after the `meta` object literal");
+    }
+    return root;
+}
+export function parseWorkflowMeta(source) {
+    const { objText } = sliceMetaObject(source);
+    const data = parseTokens(tokenize(objText));
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+        throw new WorkflowScriptError("`meta` must be an object literal");
+    }
+    const m = data;
+    if (typeof m.name !== "string" || m.name.length === 0) {
+        throw new WorkflowScriptError("`meta.name` is required and must be a non-empty string");
+    }
+    if (typeof m.description !== "string" || m.description.length === 0) {
+        throw new WorkflowScriptError("`meta.description` is required and must be a non-empty string");
+    }
+    const meta = { name: m.name, description: m.description };
+    if (m.whenToUse !== undefined) {
+        if (typeof m.whenToUse !== "string")
+            throw new WorkflowScriptError("`meta.whenToUse` must be a string");
+        meta.whenToUse = m.whenToUse;
+    }
+    if (m.phases !== undefined) {
+        if (!Array.isArray(m.phases))
+            throw new WorkflowScriptError("`meta.phases` must be an array");
+        meta.phases = m.phases.map((ph, idx) => {
+            if (typeof ph !== "object" || ph === null || Array.isArray(ph)) {
+                throw new WorkflowScriptError(`\`meta.phases[${idx}]\` must be an object`);
+            }
+            const phase = ph;
+            if (typeof phase.title !== "string") {
+                throw new WorkflowScriptError(`\`meta.phases[${idx}].title\` must be a string`);
+            }
+            if (phase.detail !== undefined && typeof phase.detail !== "string") {
+                throw new WorkflowScriptError(`\`meta.phases[${idx}].detail\` must be a string`);
+            }
+            if (phase.model !== undefined && typeof phase.model !== "string") {
+                throw new WorkflowScriptError(`\`meta.phases[${idx}].model\` must be a string`);
+            }
+            return {
+                title: phase.title,
+                ...(phase.detail !== undefined ? { detail: phase.detail } : {}),
+                ...(phase.model !== undefined ? { model: phase.model } : {}),
+            };
+        });
+    }
+    return meta;
+}
+export function stripStringsAndComments(src) {
+    let out = "";
+    let i = 0;
+    const n = src.length;
+    while (i < n) {
+        const c = src[i];
+        const d = i + 1 < n ? src[i + 1] : "";
+        if (c === "/" && d === "/") {
+            while (i < n && src[i] !== "\n")
+                i++;
+            continue;
+        }
+        if (c === "/" && d === "*") {
+            i += 2;
+            while (i < n && !(src[i] === "*" && src[i + 1] === "/"))
+                i++;
+            i += 2;
+            continue;
+        }
+        if (c === '"' || c === "'") {
+            i++;
+            while (i < n && src[i] !== c) {
+                if (src[i] === "\\")
+                    i++;
+                i++;
+            }
+            i++;
+            out += " ";
+            continue;
+        }
+        if (c === "`") {
+            i++;
+            while (i < n && src[i] !== "`") {
+                if (src[i] === "\\") {
+                    i += 2;
+                    continue;
+                }
+                if (src[i] === "$" && src[i + 1] === "{") {
+                    i += 2;
+                    let depth = 1;
+                    const start = i;
+                    while (i < n && depth > 0) {
+                        if (src[i] === "{")
+                            depth++;
+                        else if (src[i] === "}")
+                            depth--;
+                        if (depth > 0)
+                            i++;
+                    }
+                    out += ` ${stripStringsAndComments(src.slice(start, i))} `;
+                    i++;
+                    continue;
+                }
+                i++;
+            }
+            i++;
+            out += " ";
+            continue;
+        }
+        out += c;
+        i++;
+    }
+    return out;
+}
+export function workflowScriptReadsClockOrRandom(body) {
+    const code = stripStringsAndComments(body);
+    return /\bDate\s*\.\s*now\b/.test(code) || /\bMath\s*\.\s*random\b/.test(code) || /\bnew\s+Date\s*\(\s*\)/.test(code);
+}
+export function splitWorkflowMeta(source) {
+    const meta = parseWorkflowMeta(source);
+    const { declStart, objEnd } = sliceMetaObject(source);
+    let end = objEnd;
+    while (end < source.length && (source[end] === ";" || source[end] === " " || source[end] === "\t"))
+        end++;
+    return { meta, body: source.slice(0, declStart) + source.slice(end) };
+}
+//# sourceMappingURL=workflow-meta.js.map

package/dist/orchestration/workflow-meta.js.map

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

package/dist/orchestration/workflow-observe.d.ts

@@ -0,0 +1,18 @@
+import type { WorkflowRunStore, WorkflowRunSummary } from "../core/workflow-run-store.js";
+import type { WorkflowEvent, WorkflowItemStatus, WorkflowRun, WorkflowRunStatus } from "./workflow.js";
+export declare function markWorkflowActive(runId: string): void;
+export declare function isWorkflowRunActive(runId: string): boolean;
+export declare function publishWorkflowEvent(runId: string, event: WorkflowEvent): void;
+export declare function closeWorkflowChannel(runId: string): void;
+export declare function subscribeWorkflow(runId: string): AsyncIterable<WorkflowEvent>;
+export declare function listWorkflowRuns(store: WorkflowRunStore, scope: string, opts?: {
+    status?: WorkflowRunStatus;
+    limit?: number;
+}): Promise<WorkflowRunSummary[]>;
+export declare function getWorkflowRun(store: WorkflowRunStore, id: string, scope: string): Promise<WorkflowRun | null>;
+export type AgentDisplayStatus = "queued" | "running" | "done" | "failed" | "interrupted";
+export declare function deriveAgentDisplayStatus(agent: {
+    status: WorkflowItemStatus;
+    startedAt?: number;
+}, runStatus: WorkflowRunStatus): AgentDisplayStatus;
+//# sourceMappingURL=workflow-observe.d.ts.map

package/dist/orchestration/workflow-observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-observe.d.ts","sourceRoot":"","sources":["../../src/orchestration/workflow-observe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AA0CvG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEtD;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D;AAQD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAI9E;AAQD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMxD;AAgBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,aAAa,CAAC,CAiC7E;AAYD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE/B;AASD,wBAAsB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAGpH;AAGD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;AAgB1F,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS,EAAE,iBAAiB,GAAG,kBAAkB,CASpJ"}

package/dist/orchestration/workflow-observe.js

@@ -0,0 +1,73 @@
+import { PushQueue } from "../core/push-queue.js";
+const channels = new Map();
+const activeRuns = new Set();
+export function markWorkflowActive(runId) {
+    activeRuns.add(runId);
+}
+export function isWorkflowRunActive(runId) {
+    return activeRuns.has(runId);
+}
+export function publishWorkflowEvent(runId, event) {
+    const subs = channels.get(runId);
+    if (!subs)
+        return;
+    for (const q of subs)
+        q.push(event);
+}
+export function closeWorkflowChannel(runId) {
+    activeRuns.delete(runId);
+    const subs = channels.get(runId);
+    if (!subs)
+        return;
+    for (const q of subs)
+        q.close();
+    channels.delete(runId);
+}
+export function subscribeWorkflow(runId) {
+    if (!activeRuns.has(runId)) {
+        return {
+            async *[Symbol.asyncIterator]() {
+            },
+        };
+    }
+    const queue = new PushQueue();
+    let subs = channels.get(runId);
+    if (!subs) {
+        subs = new Set();
+        channels.set(runId, subs);
+    }
+    subs.add(queue);
+    return {
+        async *[Symbol.asyncIterator]() {
+            try {
+                for await (const ev of queue)
+                    yield ev;
+            }
+            finally {
+                const live = channels.get(runId);
+                if (live) {
+                    live.delete(queue);
+                    if (live.size === 0)
+                        channels.delete(runId);
+                }
+            }
+        },
+    };
+}
+export function listWorkflowRuns(store, scope, opts) {
+    return store.listByScope(scope, opts);
+}
+export async function getWorkflowRun(store, id, scope) {
+    const run = await store.get(id);
+    return run && run.scope === scope ? run : null;
+}
+export function deriveAgentDisplayStatus(agent, runStatus) {
+    if (agent.status === "completed")
+        return "done";
+    if (agent.status === "failed")
+        return "failed";
+    if (runStatus !== "running")
+        return "interrupted";
+    return agent.startedAt === undefined ? "queued" : "running";
+}
+//# sourceMappingURL=workflow-observe.js.map

package/dist/orchestration/workflow-observe.js.map

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

package/dist/orchestration/workflow-primitives.d.ts

@@ -0,0 +1,12 @@
+import type { Model } from "../internal/llm.js";
+import type { TaskSpec, WorkflowGovernanceBaseline } from "../core/types.js";
+import type { WorkflowAgentHandle, WorkflowRunContext } from "./workflow.js";
+import type { WorkflowPrimitives } from "./workflow-script-runner.js";
+import { type WorkflowChildCaps } from "./workflow-governance.js";
+export interface WorkflowGovernance {
+    baseline: WorkflowGovernanceBaseline;
+    models?: Record<string, Model>;
+    caps?: WorkflowChildCaps;
+}
+export declare function buildWorkflowPrimitives(ctx: WorkflowRunContext, governance?: WorkflowGovernance, onAgentSpawn?: (handle: WorkflowAgentHandle) => void, parentThinking?: () => TaskSpec["thinking"], parentPrincipal?: string): WorkflowPrimitives;
+//# sourceMappingURL=workflow-primitives.d.ts.map

package/dist/orchestration/workflow-primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-primitives.d.ts","sourceRoot":"","sources":["../../src/orchestration/workflow-primitives.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAwB,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG1F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AA0BD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,kBAAkB,EACvB,UAAU,CAAC,EAAE,kBAAkB,EAC/B,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,EACpD,cAAc,CAAC,EAAE,MAAM,QAAQ,CAAC,UAAU,CAAC,EAC3C,eAAe,CAAC,EAAE,MAAM,GACvB,kBAAkB,CAyDpB"}

package/dist/orchestration/workflow-primitives.js

@@ -0,0 +1,56 @@
+import { buildGovernedChildSpec } from "./workflow-governance.js";
+function safeAgentOptions(opts) {
+    if (typeof opts !== "object" || opts === null)
+        return {};
+    const o = opts;
+    const out = {};
+    if (typeof o.label === "string")
+        out.label = o.label;
+    if (typeof o.phase === "string")
+        out.phase = o.phase;
+    if (o.schema !== undefined)
+        out.schema = o.schema;
+    if (typeof o.agentType === "string")
+        out.agentType = o.agentType;
+    if (o.isolation === "worktree")
+        out.isolation = "worktree";
+    return out;
+}
+export function buildWorkflowPrimitives(ctx, governance, onAgentSpawn, parentThinking, parentPrincipal) {
+    const agent = (spec, opts) => {
+        if (typeof spec === "string")
+            spec = { objective: spec };
+        const agentOpts = safeAgentOptions(opts);
+        const childSpec = governance
+            ? buildGovernedChildSpec(spec, governance.baseline, governance.models, governance.caps)
+            : { ...spec };
+        if (childSpec.thinking === undefined && parentThinking) {
+            const inherited = parentThinking();
+            if (inherited !== undefined)
+                childSpec.thinking = inherited;
+        }
+        if (childSpec.principal === undefined && parentPrincipal !== undefined) {
+            childSpec.principal = parentPrincipal;
+        }
+        if (onAgentSpawn) {
+            return ctx.agentStream(childSpec, agentOpts).then((handle) => {
+                onAgentSpawn(handle);
+                return handle.result();
+            });
+        }
+        return ctx.agent(childSpec, agentOpts);
+    };
+    return {
+        agent,
+        parallel: (thunks) => ctx.parallel(thunks),
+        pipeline: (items, ...stages) => ctx.pipeline(items, ...stages),
+        phase: (title, body) => ctx.phase(title, body),
+        log: (message) => ctx.log(message),
+        budget: {
+            total: ctx.budget.total,
+            spent: () => ctx.budget.spent(),
+            remaining: () => ctx.budget.remaining(),
+        },
+    };
+}
+//# sourceMappingURL=workflow-primitives.js.map

package/dist/orchestration/workflow-primitives.js.map

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

package/dist/orchestration/workflow-sandbox-conformance.d.ts

@@ -0,0 +1,5 @@
+import type { WorkflowScriptRunner } from "./workflow-script-runner.js";
+export declare function assertWorkflowPrimitivesWiring(runner: WorkflowScriptRunner): Promise<void>;
+export declare function assertWorkflowSandboxConformance(runner: WorkflowScriptRunner): Promise<void>;
+export declare function assertWorkflowDeterminism(runner: WorkflowScriptRunner): Promise<void>;
+//# sourceMappingURL=workflow-sandbox-conformance.d.ts.map

package/dist/orchestration/workflow-sandbox-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-sandbox-conformance.d.ts","sourceRoot":"","sources":["../../src/orchestration/workflow-sandbox-conformance.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAsB,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AA+I5F,wBAAsB,8BAA8B,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEhG;AAED,wBAAsB,gCAAgC,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgElG;AAiBD,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3F"}