@namzu/sdk 50.1.0 → 51.1.0

package/dist/execution/workflow/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../../src/execution/workflow/journal.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAExE,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAM,GAAG,MAAM,CAMvD;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IAG9C,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,KAAK,CAA2B;gBAEX,GAAG,EAAE,MAAM;IAExC,OAAO,CAAC,MAAM;IAKR,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CAM1D"}

package/dist/execution/workflow/journal.js

@@ -0,0 +1,43 @@
+import { createHash } from 'node:crypto';
+import { appendFile, mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export function sha256(text) {
+    return createHash('sha256').update(text).digest('hex');
+}
+/** The first `max` UTF-16 units of `text`, never ending inside a surrogate pair. */
+export function preview(text, max = 500) {
+    if (text.length <= max)
+        return text;
+    let end = max;
+    const last = text.charCodeAt(end - 1);
+    if (last >= 0xd800 && last <= 0xdbff)
+        end--;
+    return `${text.slice(0, end)}…`;
+}
+/**
+ * A journal in a directory: `script.js` (the exact script text, mode 0600)
+ * and `journal.jsonl` (one JSON record per line, append-only). The caller
+ * chooses the directory, normally `<session>/runs/<runId>/workflow/`.
+ */
+export class FileWorkflowJournal {
+    dir;
+    ready;
+    constructor(dir) {
+        this.dir = dir;
+    }
+    ensure() {
+        this.ready ??= mkdir(this.dir, { recursive: true, mode: 0o700 }).then(() => undefined);
+        return this.ready;
+    }
+    async writeScript(source) {
+        await this.ensure();
+        await writeFile(join(this.dir, 'script.js'), source, { mode: 0o600 });
+    }
+    async append(record) {
+        await this.ensure();
+        await appendFile(join(this.dir, 'journal.jsonl'), `${JSON.stringify(record)}\n`, {
+            mode: 0o600,
+        });
+    }
+}
+//# sourceMappingURL=journal.js.map

package/dist/execution/workflow/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../../src/execution/workflow/journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIhC,MAAM,UAAU,MAAM,CAAC,IAAY;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACvD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,GAAG,GAAG,GAAG;IAC9C,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAA;IACnC,IAAI,GAAG,GAAG,GAAG,CAAA;IACb,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;IACrC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM;QAAE,GAAG,EAAE,CAAA;IAC3C,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAA;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAGF;IAFrB,KAAK,CAA2B;IAExC,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAEpC,MAAM;QACb,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACtF,OAAO,IAAI,CAAC,KAAK,CAAA;IAClB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc;QAC/B,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACnB,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACtE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAA6B;QACzC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACnB,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE;YAChF,IAAI,EAAE,KAAK;SACX,CAAC,CAAA;IACH,CAAC;CACD"}

package/dist/execution/workflow/meta.d.ts

@@ -0,0 +1,14 @@
+import type { WorkflowMeta } from './types.js';
+export declare function normalizePhaseTitle(value: string): string;
+/**
+ * Split a script into its `meta` and its body. The body keeps the script's
+ * line breaks (the meta statement is blanked, not removed) so an error line
+ * still points at the author's text.
+ */
+export declare function splitWorkflowScript(source: string): {
+    meta: WorkflowMeta;
+    body: string;
+};
+/** Parse `meta` from a script without executing it. Throws {@link WorkflowScriptError}. */
+export declare function parseWorkflowMeta(source: string): WorkflowMeta;
+//# sourceMappingURL=meta.d.ts.map

package/dist/execution/workflow/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/execution/workflow/meta.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAA;AA0OjE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AA6CD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAuBxF;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAE9D"}

package/dist/execution/workflow/meta.js

@@ -0,0 +1,314 @@
+import { WorkflowScriptError } from './errors.js';
+const MAX_META_BYTES = 16 * 1024;
+const MAX_DEPTH = 8;
+const MAX_PHASES = 50;
+const KEYWORD = /export\s+const\s+meta\s*=/y;
+/**
+ * Reads the `export const meta = {...}` literal WITHOUT running the script.
+ *
+ * The statement must be the first one in the file (comments and blank lines
+ * before it are fine) and its value must be a pure literal: strings, numbers,
+ * booleans, null, arrays and objects. Variables, calls, spreads, template
+ * substitutions and computed keys are refused with a plain message, because
+ * the operator reviews this literal BEFORE the script is allowed to run.
+ */
+class LiteralParser {
+    source;
+    pos = 0;
+    constructor(source) {
+        this.source = source;
+    }
+    fail(what) {
+        const before = this.source.slice(0, this.pos);
+        const line = before.split('\n').length;
+        const column = this.pos - before.lastIndexOf('\n');
+        throw new WorkflowScriptError(`${what} (line ${line}, column ${column}).`);
+    }
+    skipTrivia() {
+        const s = this.source;
+        for (;;) {
+            const c = s[this.pos];
+            if (c === ' ' || c === '\t' || c === '\n' || c === '\r' || c === '')
+                this.pos++;
+            else if (c === '/' && s[this.pos + 1] === '/') {
+                while (this.pos < s.length && s[this.pos] !== '\n')
+                    this.pos++;
+            }
+            else if (c === '/' && s[this.pos + 1] === '*') {
+                const end = s.indexOf('*/', this.pos + 2);
+                if (end === -1)
+                    this.fail('Unterminated comment');
+                this.pos = end + 2;
+            }
+            else
+                return;
+        }
+    }
+    describe() {
+        const snippet = this.source.slice(this.pos, this.pos + 24).split('\n')[0];
+        return snippet ? `"${snippet}"` : 'the end of the script';
+    }
+    notLiteral() {
+        return this.fail(`\`meta\` must be a pure literal (no variables, calls, spreads or expressions); found ${this.describe()}`);
+    }
+    value(depth) {
+        if (depth > MAX_DEPTH)
+            this.fail('`meta` is nested too deeply');
+        this.skipTrivia();
+        const c = this.source[this.pos];
+        if (c === '{')
+            return this.object(depth);
+        if (c === '[')
+            return this.array(depth);
+        if (c === '"' || c === "'")
+            return this.string(c);
+        if (c === '`')
+            return this.string('`');
+        if (c === '-' || c === '.' || (c !== undefined && c >= '0' && c <= '9'))
+            return this.number();
+        for (const [word, value] of [
+            ['true', true],
+            ['false', false],
+            ['null', null],
+        ]) {
+            if (this.source.startsWith(word, this.pos) &&
+                !/[\w$]/.test(this.source[this.pos + word.length] ?? '')) {
+                this.pos += word.length;
+                return value;
+            }
+        }
+        return this.notLiteral();
+    }
+    number() {
+        const match = /-?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?/y;
+        match.lastIndex = this.pos;
+        const found = match.exec(this.source);
+        if (!found)
+            return this.notLiteral();
+        this.pos += found[0].length;
+        if (/[\w$]/.test(this.source[this.pos] ?? ''))
+            return this.notLiteral();
+        return Number(found[0]);
+    }
+    string(quote) {
+        const s = this.source;
+        this.pos++;
+        let out = '';
+        for (;;) {
+            const c = s[this.pos];
+            if (c === undefined)
+                return this.fail('Unterminated string in `meta`');
+            if (c === quote) {
+                this.pos++;
+                return out;
+            }
+            if (c === '\n' && quote !== '`')
+                return this.fail('Unterminated string in `meta`');
+            if (quote === '`' && c === '$' && s[this.pos + 1] === '{') {
+                return this.fail('`meta` strings cannot use `${...}` substitutions');
+            }
+            if (c !== '\\') {
+                out += c;
+                this.pos++;
+                continue;
+            }
+            const e = s[this.pos + 1];
+            this.pos += 2;
+            const simple = {
+                n: '\n',
+                t: '\t',
+                r: '\r',
+                b: '\b',
+                f: '\f',
+                v: '\v',
+                '0': '\0',
+                '\\': '\\',
+                "'": "'",
+                '"': '"',
+                '`': '`',
+                $: '$',
+            };
+            if (e !== undefined && e in simple)
+                out += simple[e];
+            else if (e === '\n')
+                continue;
+            else if (e === 'u' && s[this.pos] === '{') {
+                const end = s.indexOf('}', this.pos);
+                const hex = s.slice(this.pos + 1, end);
+                if (end === -1 || !/^[0-9a-fA-F]{1,6}$/.test(hex) || Number.parseInt(hex, 16) > 0x10ffff) {
+                    return this.fail('Bad escape in a `meta` string');
+                }
+                out += String.fromCodePoint(Number.parseInt(hex, 16));
+                this.pos = end + 1;
+            }
+            else if (e === 'u' || e === 'x') {
+                const len = e === 'u' ? 4 : 2;
+                const hex = s.slice(this.pos, this.pos + len);
+                if (!new RegExp(`^[0-9a-fA-F]{${len}}$`).test(hex))
+                    return this.fail('Bad escape in a `meta` string');
+                out += String.fromCharCode(Number.parseInt(hex, 16));
+                this.pos += len;
+            }
+            else
+                return this.fail('Bad escape in a `meta` string');
+        }
+    }
+    array(depth) {
+        this.pos++;
+        const out = [];
+        for (;;) {
+            this.skipTrivia();
+            if (this.source[this.pos] === ']') {
+                this.pos++;
+                return out;
+            }
+            out.push(this.value(depth + 1));
+            this.skipTrivia();
+            if (this.source[this.pos] === ',')
+                this.pos++;
+            else if (this.source[this.pos] !== ']')
+                return this.notLiteral();
+        }
+    }
+    object(depth) {
+        this.pos++;
+        const out = Object.create(null);
+        for (;;) {
+            this.skipTrivia();
+            const c = this.source[this.pos];
+            if (c === '}') {
+                this.pos++;
+                return out;
+            }
+            let key;
+            if (c === '"' || c === "'")
+                key = this.string(c);
+            else {
+                const ident = /[A-Za-z_$][\w$]*/y;
+                ident.lastIndex = this.pos;
+                const found = ident.exec(this.source);
+                if (!found)
+                    return this.notLiteral();
+                key = found[0];
+                this.pos += key.length;
+            }
+            if (key === '__proto__')
+                this.fail('`meta` cannot define `__proto__`');
+            if (key in out)
+                this.fail(`\`meta\` repeats the key "${key}"`);
+            this.skipTrivia();
+            if (this.source[this.pos] !== ':')
+                return this.notLiteral();
+            this.pos++;
+            out[key] = this.value(depth + 1);
+            this.skipTrivia();
+            if (this.source[this.pos] === ',')
+                this.pos++;
+            else if (this.source[this.pos] !== '}')
+                return this.notLiteral();
+        }
+    }
+}
+function text(value, field, max, required) {
+    if (value === undefined) {
+        if (required)
+            throw new WorkflowScriptError(`\`meta.${field}\` is required.`);
+        return undefined;
+    }
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new WorkflowScriptError(`\`meta.${field}\` must be a non-empty string.`);
+    }
+    if (value.length > max) {
+        throw new WorkflowScriptError(`\`meta.${field}\` is longer than ${max} characters.`);
+    }
+    return value;
+}
+function onlyKeys(object, allowed, where) {
+    for (const key of Object.keys(object)) {
+        if (!allowed.includes(key)) {
+            throw new WorkflowScriptError(`\`${where}\` has an unknown key "${key}". Allowed: ${allowed.join(', ')}.`);
+        }
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function normalizePhaseTitle(value) {
+    return value.replace(/\s+/g, ' ').trim().slice(0, 120);
+}
+function toMeta(literal) {
+    if (!isRecord(literal))
+        throw new WorkflowScriptError('`meta` must be an object literal.');
+    onlyKeys(literal, ['name', 'description', 'whenToUse', 'phases'], 'meta');
+    const name = text(literal.name, 'name', 80, true);
+    const description = text(literal.description, 'description', 500, true);
+    const whenToUse = text(literal.whenToUse, 'whenToUse', 500, false);
+    const phases = [];
+    if (literal.phases !== undefined) {
+        if (!Array.isArray(literal.phases)) {
+            throw new WorkflowScriptError('`meta.phases` must be an array of { title, detail?, model? }.');
+        }
+        if (literal.phases.length > MAX_PHASES) {
+            throw new WorkflowScriptError(`\`meta.phases\` lists more than ${MAX_PHASES} phases.`);
+        }
+        const seen = new Set();
+        for (const [i, entry] of literal.phases.entries()) {
+            if (!isRecord(entry)) {
+                throw new WorkflowScriptError(`\`meta.phases[${i}]\` must be an object with a title.`);
+            }
+            onlyKeys(entry, ['title', 'detail', 'model'], `meta.phases[${i}]`);
+            const raw = text(entry.title, `phases[${i}].title`, 120, true);
+            const title = normalizePhaseTitle(raw);
+            if (seen.has(title)) {
+                throw new WorkflowScriptError(`\`meta.phases\` repeats the title "${title}".`);
+            }
+            seen.add(title);
+            const detail = text(entry.detail, `phases[${i}].detail`, 300, false);
+            const model = text(entry.model, `phases[${i}].model`, 120, false);
+            phases.push({
+                title,
+                ...(detail !== undefined ? { detail } : {}),
+                ...(model !== undefined ? { model } : {}),
+            });
+        }
+    }
+    return {
+        name,
+        description,
+        ...(whenToUse !== undefined ? { whenToUse } : {}),
+        phases,
+    };
+}
+/**
+ * Split a script into its `meta` and its body. The body keeps the script's
+ * line breaks (the meta statement is blanked, not removed) so an error line
+ * still points at the author's text.
+ */
+export function splitWorkflowScript(source) {
+    const parser = new LiteralParser(source);
+    parser.skipTrivia();
+    KEYWORD.lastIndex = parser.pos;
+    const found = KEYWORD.exec(source);
+    if (!found) {
+        throw new WorkflowScriptError('A workflow script must start with `export const meta = { name, description, phases? }`.');
+    }
+    const start = parser.pos;
+    parser.pos = start + found[0].length;
+    const literal = parser.value(0);
+    parser.skipTrivia();
+    if (source[parser.pos] === ';')
+        parser.pos++;
+    if (Buffer.byteLength(source.slice(start, parser.pos)) > MAX_META_BYTES) {
+        throw new WorkflowScriptError(`\`meta\` is larger than ${MAX_META_BYTES} bytes.`);
+    }
+    const meta = toMeta(literal);
+    return {
+        meta,
+        body: source.slice(0, parser.pos).replace(/[^\n]/g, ' ') + source.slice(parser.pos),
+    };
+}
+/** Parse `meta` from a script without executing it. Throws {@link WorkflowScriptError}. */
+export function parseWorkflowMeta(source) {
+    return splitWorkflowScript(source).meta;
+}
+//# sourceMappingURL=meta.js.map

package/dist/execution/workflow/meta.js.map

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

package/dist/execution/workflow/phases.d.ts

@@ -0,0 +1,32 @@
+import type { WorkflowAgentState, WorkflowPhaseMeta, WorkflowPhaseSummary } from './types.js';
+export interface PhaseRecord {
+    readonly index: number;
+    readonly title: string;
+    readonly declared: boolean;
+}
+/**
+ * Phase titles of one run. A title is the only grouping key: the same title
+ * is the same group. Indexes are 1-based first-seen order, declared titles
+ * first. `register` reports whether the title was announced just now.
+ */
+export declare class PhaseRegistry {
+    private readonly byTitle;
+    register(rawTitle: string, declared?: boolean): {
+        phase: PhaseRecord;
+        isNew: boolean;
+    };
+    all(): PhaseRecord[];
+}
+export interface PhaseAgentView {
+    readonly phaseIndex?: number;
+    readonly state: WorkflowAgentState;
+    readonly tokens: number;
+}
+/**
+ * Per-phase status from the agents seen so far, in phase order. A phase with
+ * no agent yet is `not-started`. When no agent belongs to any phase (and
+ * nothing is declared) the run shows one derived group, "Agents"; agents
+ * without a phase next to phased ones also land in "Agents", listed last.
+ */
+export declare function summarizeWorkflowPhases(declared: readonly WorkflowPhaseMeta[], phases: readonly PhaseRecord[], agents: readonly PhaseAgentView[]): WorkflowPhaseSummary[];
+//# sourceMappingURL=phases.d.ts.map

package/dist/execution/workflow/phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.d.ts","sourceRoot":"","sources":["../../../src/execution/workflow/phases.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,kBAAkB,EAClB,iBAAiB,EAEjB,oBAAoB,EACpB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC1B;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IAEzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE;IASpF,GAAG,IAAI,WAAW,EAAE;CAGpB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAQD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,EACtC,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,MAAM,EAAE,SAAS,cAAc,EAAE,GAC/B,oBAAoB,EAAE,CAgCxB"}

package/dist/execution/workflow/phases.js

@@ -0,0 +1,57 @@
+import { normalizePhaseTitle } from './meta.js';
+/**
+ * Phase titles of one run. A title is the only grouping key: the same title
+ * is the same group. Indexes are 1-based first-seen order, declared titles
+ * first. `register` reports whether the title was announced just now.
+ */
+export class PhaseRegistry {
+    byTitle = new Map();
+    register(rawTitle, declared = false) {
+        const title = normalizePhaseTitle(rawTitle);
+        const existing = this.byTitle.get(title);
+        if (existing)
+            return { phase: existing, isNew: false };
+        const phase = { index: this.byTitle.size + 1, title, declared };
+        this.byTitle.set(title, phase);
+        return { phase, isNew: true };
+    }
+    all() {
+        return [...this.byTitle.values()];
+    }
+}
+function statusOf(total, done, failed) {
+    if (total === 0)
+        return 'not-started';
+    if (done + failed === total)
+        return failed > 0 ? 'failed' : 'done';
+    return 'running';
+}
+/**
+ * Per-phase status from the agents seen so far, in phase order. A phase with
+ * no agent yet is `not-started`. When no agent belongs to any phase (and
+ * nothing is declared) the run shows one derived group, "Agents"; agents
+ * without a phase next to phased ones also land in "Agents", listed last.
+ */
+export function summarizeWorkflowPhases(declared, phases, agents) {
+    const detail = new Map(declared.map((p) => [normalizePhaseTitle(p.title), p.detail]));
+    const summarize = (index, title, members, extra) => {
+        const done = members.filter((a) => a.state === 'done').length;
+        const failed = members.filter((a) => a.state === 'error').length;
+        return {
+            index,
+            title,
+            ...(extra !== undefined ? { detail: extra } : {}),
+            status: statusOf(members.length, done, failed),
+            agents: members.length,
+            done,
+            failed,
+            tokens: members.reduce((sum, a) => sum + a.tokens, 0),
+        };
+    };
+    const out = phases.map((p) => summarize(p.index, p.title, agents.filter((a) => a.phaseIndex === p.index), detail.get(p.title)));
+    const ungrouped = agents.filter((a) => a.phaseIndex === undefined);
+    if (ungrouped.length > 0)
+        out.push(summarize(0, 'Agents', ungrouped));
+    return out;
+}
+//# sourceMappingURL=phases.js.map

package/dist/execution/workflow/phases.js.map

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

package/dist/execution/workflow/prelude.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Lines the prelude occupies in the interpreter source, plus the newline that
+ * joins it to the script body: subtract this from an interpreter line number
+ * to get the line in the script the author wrote.
+ */
+export declare function preludeLineCount(config: {
+    args: unknown;
+    tokenLimit: number | null;
+}): number;
+/** Source that installs the workflow globals, ready to prepend to a script body. */
+export declare function buildPrelude(config: {
+    args: unknown;
+    tokenLimit: number | null;
+}): string;
+//# sourceMappingURL=prelude.d.ts.map

package/dist/execution/workflow/prelude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prelude.d.ts","sourceRoot":"","sources":["../../../src/execution/workflow/prelude.ts"],"names":[],"mappings":"AA+GA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACxC,IAAI,EAAE,OAAO,CAAA;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,GAAG,MAAM,CAET;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACpC,IAAI,EAAE,OAAO,CAAA;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,GAAG,MAAM,CAOT"}

package/dist/execution/workflow/prelude.js

@@ -0,0 +1,128 @@
+/**
+ * The interpreter-side half of the workflow language: `agent`, `parallel`,
+ * `pipeline`, `phase`, `log`, `args` and `budget`.
+ *
+ * This text runs INSIDE the QuickJS interpreter, ahead of the script body,
+ * and is the only place those names are defined. It captures the two bridge
+ * natives (`call`, `print`) in its own closure and deletes them from the
+ * global object, so the script reaches the host only through `agent()`, and
+ * `phase()`/`log()` can only emit well-formed records. None of this is a
+ * security boundary: the host re-validates every request and treats every
+ * printed line as untrusted text. The boundary is the interpreter itself.
+ *
+ * Written with String.raw and no backticks or substitutions so no escaping
+ * layer can change what the interpreter parses.
+ */
+const PRELUDE_SOURCE = String.raw `(function (config) {
+	'use strict';
+	var rawCall = globalThis.call;
+	var rawPrint = globalThis.print;
+	delete globalThis.call;
+	delete globalThis.print;
+	var stringify = JSON.stringify;
+	var spent = { tokensUsed: 0 };
+	var cursor = null;
+	function emit(record) { rawPrint(stringify(record)); }
+	function clean(value, limit) {
+		return String(value).replace(/\s+/g, ' ').trim().slice(0, limit);
+	}
+	function phase(title) {
+		var t = clean(title, 120);
+		if (!t) throw new TypeError('phase() needs a non-empty title.');
+		cursor = t;
+		emit({ k: 'phase', title: t });
+	}
+	function log(message) {
+		emit({ k: 'log', message: String(message).slice(0, 2000) });
+	}
+	function kind(value) {
+		if (value === null) return 'null';
+		if (value === '') return 'an empty string';
+		if (Array.isArray(value)) return 'an array';
+		var t = typeof value;
+		if (t === 'undefined') return 'undefined';
+		if (t === 'object') return typeof value.then === 'function' ? 'a promise' : 'an object';
+		return 'a ' + t;
+	}
+	async function agent(prompt, opts) {
+		if (typeof prompt !== 'string' || prompt.length === 0) {
+			throw new TypeError('agent(prompt, options?): the prompt must be a non-empty string, got ' + kind(prompt));
+		}
+		var o = opts == null ? {} : opts;
+		if (typeof o !== 'object' || Array.isArray(o)) {
+			throw new TypeError('agent(prompt, options?): options must be an object, got ' + kind(o));
+		}
+		var request = { prompt: prompt, cursor: cursor };
+		if (o.label != null) request.label = clean(o.label, 120);
+		if (o.phase != null) request.phase = clean(o.phase, 120);
+		if (o.schema != null) request.schema = o.schema;
+		if (o.agentType != null) request.agentType = clean(o.agentType, 120);
+		if (o.model != null) request.model = clean(o.model, 120);
+		if (o.effort != null) request.effort = clean(o.effort, 32);
+		var reply = await rawCall('agent', request);
+		spent.tokensUsed = reply.t;
+		return reply.v;
+	}
+	async function parallel(thunks) {
+		if (!Array.isArray(thunks)) {
+			throw new TypeError('parallel(thunks): the argument must be an array of functions, got ' + kind(thunks));
+		}
+		for (var p = 0; p < thunks.length; p++) {
+			if (typeof thunks[p] !== 'function') {
+				throw new TypeError('parallel(thunks): item ' + (p + 1) + ' must be a function (wrap the work as () => agent(...)), got ' + kind(thunks[p]));
+			}
+		}
+		return Promise.all(thunks.map(function (t) { return t(); }));
+	}
+	async function pipeline(items) {
+		if (!Array.isArray(items)) {
+			throw new TypeError('pipeline(items, ...stages): the first argument must be an array, got ' + kind(items));
+		}
+		var stages = Array.prototype.slice.call(arguments, 1);
+		for (var s = 0; s < stages.length; s++) {
+			if (typeof stages[s] !== 'function') {
+				throw new TypeError('pipeline(items, ...stages): stage ' + (s + 1) + ' must be a function, got ' + kind(stages[s]));
+			}
+		}
+		return Promise.all(items.map(async function (item, index) {
+			var value = item;
+			for (var i = 0; i < stages.length; i++) {
+				value = await stages[i](value, index, item);
+				if (value === null || value === undefined) return null;
+			}
+			return value;
+		}));
+	}
+	var budget = Object.freeze({
+		get tokensUsed() { return spent.tokensUsed; },
+		get tokenLimit() { return config.tokenLimit === null ? undefined : config.tokenLimit; },
+	});
+	function install(name, value) {
+		Object.defineProperty(globalThis, name, { value: value, writable: false, configurable: false, enumerable: true });
+	}
+	install('agent', agent);
+	install('parallel', parallel);
+	install('pipeline', pipeline);
+	install('phase', phase);
+	install('log', log);
+	install('budget', budget);
+	install('args', config.args);
+})`;
+/**
+ * Lines the prelude occupies in the interpreter source, plus the newline that
+ * joins it to the script body: subtract this from an interpreter line number
+ * to get the line in the script the author wrote.
+ */
+export function preludeLineCount(config) {
+    return buildPrelude(config).split('\n').length;
+}
+/** Source that installs the workflow globals, ready to prepend to a script body. */
+export function buildPrelude(config) {
+    const literal = JSON.stringify(config)
+        .split(String.fromCharCode(0x2028))
+        .join('\\u2028')
+        .split(String.fromCharCode(0x2029))
+        .join('\\u2029');
+    return `${PRELUDE_SOURCE}(${literal});`;
+}
+//# sourceMappingURL=prelude.js.map