@calliopelabs/cli 3.1.0 → 3.2.0

package/dist/spawning/actions.js

@@ -0,0 +1,120 @@
+import { join, resolve, relative, dirname } from 'node:path';
+import { createHash } from 'node:crypto';
+import { canonicalPath, canonicalJson } from '../approvals/index.js';
+import { authorizeSessionAction } from '../session-management/index.js';
+import { throwIfCancelled } from '../cancellation.js';
+import { withScope, validatePath } from '../scope.js';
+import { isPolicyEnabled } from '../policy.js';
+import { getHooksForEvent } from '../hooks.js';
+import { ReservationLedger, assertExecutionStoreOutsideProject, manifestHash, ExecutionLimitError } from '../execution/index.js';
+import { inspectExecution } from '../orchestration/coordinator-actions.js';
+import { RunStore } from '../orchestration/store.js';
+import { readArtifactBytes } from '../orchestration/execution-store.js';
+import { agentStopped, MAX_EXECUTION_BYTES, MAX_EXECUTION_EVENTS, MAX_EXECUTION_EVENT_BYTES } from '../orchestration/execution-journal.js';
+import { bindPlan, analyzePlan, pathName } from '../orchestration/validation.js';
+import { OrchestrationError } from '../orchestration/types.js';
+import { inspectSpawnAuthority } from './authority.js';
+import { SpawnProposalStore } from './store.js';
+import { makeSpawnProposal, validateSpawnInput, validateSpawnProposal, proposalGrant, MAX_SPAWN_BYTES } from './validation.js';
+import { assertSupervisionProposal } from '../supervision/journal.js';
+const bytesHash = (bytes) => createHash('sha256').update(bytes).digest('hex');
+function boundedOptions(options, signal) {
+    const approve = options.approve;
+    return { ...options, signal, approve: approve ? decision => approve(decision, signal) : undefined };
+}
+async function context(cwd, runId, options) {
+    const runs = options.store ?? new RunStore(), initial = await inspectExecution(cwd, runId, { ...options, store: runs });
+    assertExecutionStoreOutsideProject(initial.view.manifest.project.root, runs.root);
+    if (!initial.execution)
+        throw new OrchestrationError('unavailable', 'Start the reviewed run before proposing children; its original budget and deadline must already exist.');
+    const ledger = new ReservationLedger(join(runs.root, runId, 'budget'));
+    const goalAuthority = (await import('../goals/index.js')).goalRunAuthority(initial.view.manifest, runs.root);
+    const signal = AbortSignal.any([...(options.signal ? [options.signal] : []), AbortSignal.timeout(Math.max(1, initial.execution.header.deadline - Date.now()))]);
+    options = { ...options, signal };
+    const assertActive = (view) => { throwIfCancelled(options.signal); initial.store.assertApproval(view.header); goalAuthority?.assertActive(); if (Date.now() >= view.header.deadline)
+        throw new ExecutionLimitError('deadline', 'Original run deadline expired.'); };
+    assertActive(initial.execution);
+    return { ...initial, ledger, assertActive, signal, proposals: new SpawnProposalStore(initial.store) };
+}
+/** Preview binds exact source bytes and the current graph without reserving capacity. */
+export async function inspectSpawn(cwd, runId, path, options = {}) {
+    const current = await context(cwd, runId, options), root = current.view.manifest.project.root, file = resolve(root, path), sourcePath = relative(root, file);
+    pathName(sourcePath);
+    options = { ...boundedOptions(options, current.signal), dryRun: options.dryRun };
+    if (canonicalPath(file) !== file || canonicalPath(dirname(file)) !== dirname(file))
+        throw new OrchestrationError('invalid', 'Child proposal must be a canonical project file.');
+    withScope(root, () => validatePath(file, root));
+    if (options.dryRun) {
+        if (isPolicyEnabled() || getHooksForEvent('pre-tool').length)
+            throw new OrchestrationError('policy-denied', 'Dry-run cannot evaluate executable policy or hooks.');
+    }
+    else
+        await authorizeSessionAction(root, 'read_file', { path: file, operation: 'orchestration-child-proposal' }, options);
+    throwIfCancelled(options.signal);
+    const bytes = readArtifactBytes(file, MAX_SPAWN_BYTES);
+    let input;
+    try {
+        input = JSON.parse(bytes.toString());
+    }
+    catch {
+        throw new OrchestrationError('invalid', 'Child proposal is not valid JSON.');
+    }
+    const authority = inspectSpawnAuthority(current.store, current.ledger);
+    current.assertActive(authority.view);
+    const proposal = makeSpawnProposal(current.store.manifest, authority.view.header, authority.context.plan, validateSpawnInput(input), { path: sourcePath, sha256: bytesHash(bytes) });
+    bindPlan(analyzePlan({ ...authority.context.plan, agents: [...authority.context.plan.agents, ...proposal.agents], tasks: [...authority.context.plan.tasks, ...proposal.tasks] }), root);
+    return { proposal, deadline: authority.view.header.deadline, budget: authority.budget.projection, pending: authority.pending.map(record => record.grant.proposalHash) };
+}
+/** Review precedes all writes; replaying an approved proposal reuses its original allocation. */
+export async function admitSpawn(cwd, runId, input, approvedHash, options = {}) {
+    const current = await context(cwd, runId, options), proposal = typeof input === 'string' ? current.proposals.read(input) : structuredClone(input), recovery = typeof input === 'string';
+    options = boundedOptions(options, current.signal);
+    if (proposal.hash !== approvedHash)
+        throw new OrchestrationError('policy-denied', 'Child admission requires the exact reviewed proposal hash.');
+    const before = current.store.read(), existing = before.state.graph?.admissions.find(a => a.proposal.hash === proposal.hash);
+    if (existing) {
+        if (canonicalJson(existing.proposal) !== canonicalJson(proposal))
+            throw new OrchestrationError('conflict', 'Child proposal differs from its admitted graph.');
+        return { admission: existing, execution: before, alreadyAdmitted: true };
+    }
+    validateSpawnProposal(proposal, current.store.manifest, before.header, current.store.context(before).plan);
+    await authorizeSessionAction(cwd, 'orchestration_spawn', { path: cwd, operation: `Admit ${proposal.agents.length} children and ${proposal.tasks.length} tasks under ${proposal.parentId}, proposal ${proposal.hash}, original deadline ${new Date(before.header.deadline).toISOString()}.`, runId, parentId: proposal.parentId, proposalHash: proposal.hash, graphHash: proposal.graphHash, source: proposal.source, agents: proposal.agents, tasks: proposal.tasks, recovery }, { ...options, confirmation: options.source === 'repl' ? 'mutating' : options.confirmation });
+    const checkSource = () => { if (proposal.source.kind === 'supervision')
+        assertSupervisionProposal(proposal, current.store.read().state);
+    else if (!recovery) {
+        const file = resolve(current.store.manifest.project.root, proposal.source.path);
+        if (bytesHash(readArtifactBytes(file, MAX_SPAWN_BYTES)) !== proposal.source.sha256)
+            throw new OrchestrationError('conflict', 'Child proposal source changed after review.');
+    } };
+    let admission, alreadyAdmitted = false;
+    await current.store.transaction(async (prior) => {
+        current.assertActive(prior);
+        const authority = inspectSpawnAuthority(current.store, current.ledger, prior);
+        const existing = prior.state.graph?.admissions.find(a => a.proposal.hash === proposal.hash);
+        if (existing) {
+            if (canonicalJson(existing.proposal) !== canonicalJson(proposal))
+                throw new OrchestrationError('conflict', 'Child proposal changed.');
+            admission = existing;
+            alreadyAdmitted = true;
+            return [];
+        }
+        validateSpawnProposal(proposal, current.store.manifest, prior.header, authority.context.plan);
+        checkSource();
+        bindPlan(analyzePlan({ ...authority.context.plan, agents: [...authority.context.plan.agents, ...proposal.agents], tasks: [...authority.context.plan.tasks, ...proposal.tasks] }), current.store.manifest.project.root);
+        if (prior.state.status === 'completed' || agentStopped(prior.state, authority.context, proposal.parentId) || Object.values(prior.state.tasks).some(task => task.agentId === proposal.parentId && task.escalation))
+            throw new OrchestrationError('conflict', 'Parent is completed, stopped or escalated; no child admission is available.');
+        const grant = proposalGrant(proposal, prior.header);
+        if (grant.accounts.some(a => Date.now() >= a.deadline))
+            throw new ExecutionLimitError('deadline', 'Original child deadline expired.');
+        const reserve = 4 * authority.context.plan.limits.maxConcurrent + (authority.context.plan.supervision ? 4 : 2);
+        if (prior.events.length + reserve > MAX_EXECUTION_EVENTS || Buffer.byteLength(JSON.stringify({ header: prior.header, events: prior.events })) + reserve * MAX_EXECUTION_EVENT_BYTES > MAX_EXECUTION_BYTES)
+            throw new OrchestrationError('limit', 'Execution retention cannot admit more children.');
+        current.proposals.save(proposal);
+        const state = await current.ledger.grantChildren(cwd, manifestHash(authority.budget.manifest), grant, options.signal, () => { current.assertActive(prior); checkSource(); });
+        const recorded = state.childGrants.find(r => r.grant.id === grant.id);
+        admission = { version: 1, proposal, grant: recorded };
+        return [{ change: { type: 'graph_admitted', admission } }];
+    }, options.signal, () => { current.assertActive(current.store.read()); checkSource(); });
+    return { admission: admission, execution: current.store.read(), alreadyAdmitted };
+}
+//# sourceMappingURL=actions.js.map

package/dist/spawning/actions.js.map

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

package/dist/spawning/authority.d.ts

@@ -0,0 +1,15 @@
+import { ReservationLedger } from '../execution/ledger.js';
+import type { ExecutionStore } from '../orchestration/execution-store.js';
+import type { ExecutionInspection } from '../orchestration/coordinator-types.js';
+/** Graph events may consume only grants recorded in this run's original ledger. */
+export declare function inspectSpawnAuthority(store: ExecutionStore, ledger: ReservationLedger, view?: ExecutionInspection): {
+    view: ExecutionInspection;
+    context: import("../orchestration/coordinator-types.js").RunPlanContext;
+    budget: {
+        manifest: import("../execution/types.js").ExecutionManifest;
+        events: import("../execution/types.js").ReservationEvent[];
+        projection: import("../execution/types.js").ReservationProjection;
+    };
+    pending: import("../execution/types.js").RecordedChildGrant[];
+};
+//# sourceMappingURL=authority.d.ts.map

package/dist/spawning/authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority.d.ts","sourceRoot":"","sources":["../../src/spawning/authority.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,uCAAuC,CAAC;AAE/E,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,KAAK,EAAC,cAAc,EAAC,MAAM,EAAC,iBAAiB,EAAC,IAAI,GAAC,mBAAgC;;;;;;;;;EAMxH"}

package/dist/spawning/authority.js

@@ -0,0 +1,16 @@
+import { canonicalJson } from '../approvals/index.js';
+import { ExecutionLimitError } from '../execution/types.js';
+/** Graph events may consume only grants recorded in this run's original ledger. */
+export function inspectSpawnAuthority(store, ledger, view = store.read()) {
+    const saved = ledger.read(store.manifest.project.root), grants = saved.projection.childGrants ?? [], admissions = view.state.graph?.admissions ?? [];
+    if (saved.manifest.runId !== store.manifest.id || saved.manifest.planHash !== store.manifest.planHash || admissions.length > grants.length)
+        throw new ExecutionLimitError('authority', 'Child graph has no matching original run budget.');
+    for (const record of grants)
+        if (record.grant.runManifestHash !== store.manifest.hash || record.grant.approvalRevision !== view.header.approvalRevision)
+            throw new ExecutionLimitError('authority', 'Child grant belongs to another run or approval.');
+    for (let n = 0; n < admissions.length; n++)
+        if (canonicalJson(admissions[n].grant) !== canonicalJson(grants[n]))
+            throw new ExecutionLimitError('authority', 'Child graph and budget grant histories disagree.');
+    return { view, context: store.context(view), budget: saved, pending: grants.slice(admissions.length) };
+}
+//# sourceMappingURL=authority.js.map

package/dist/spawning/authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority.js","sourceRoot":"","sources":["../../src/spawning/authority.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AAI1D,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CAAC,KAAoB,EAAC,MAAwB,EAAC,IAAI,GAAqB,KAAK,CAAC,IAAI,EAAE;IACvH,MAAM,KAAK,GAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAC,MAAM,GAAC,KAAK,CAAC,UAAU,CAAC,WAAW,IAAE,EAAE,EAAC,UAAU,GAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,IAAE,EAAE,CAAC;IACzI,IAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,KAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,IAAE,UAAU,CAAC,MAAM,GAAC,MAAM,CAAC,MAAM;QAAC,MAAM,IAAI,mBAAmB,CAAC,WAAW,EAAC,kDAAkD,CAAC,CAAC;IAC9N,KAAI,MAAM,MAAM,IAAI,MAAM;QAAC,IAAG,MAAM,CAAC,KAAK,CAAC,eAAe,KAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAE,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB;YAAC,MAAM,IAAI,mBAAmB,CAAC,WAAW,EAAC,iDAAiD,CAAC,CAAC;IAC5O,KAAI,IAAI,CAAC,GAAC,CAAC,EAAC,CAAC,GAAC,UAAU,CAAC,MAAM,EAAC,CAAC,EAAE;QAAC,IAAG,aAAa,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,KAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAAC,MAAM,IAAI,mBAAmB,CAAC,WAAW,EAAC,kDAAkD,CAAC,CAAC;IACpM,OAAM,EAAC,IAAI,EAAC,OAAO,EAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAC,MAAM,EAAC,KAAK,EAAC,OAAO,EAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAC,CAAC;AAChG,CAAC"}

package/dist/spawning/cli.d.ts

@@ -0,0 +1,4 @@
+import type { ExecutionCommandOptions } from '../orchestration/execution-cli.js';
+export declare const SPAWN_USAGE = "calliope agents spawn <children.json> --run <id> [--dry-run] [--approve <proposal-hash>] [--allow-mutations] [--json] | agents spawn --resume <proposal-hash> --run <id> [--json]";
+export declare function spawnCommand(args: string[], options?: ExecutionCommandOptions): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/spawning/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/spawning/cli.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,mCAAmC,CAAC;AAK/E,eAAO,MAAM,WAAW,sLAAoL,CAAC;AAC7M,wBAAsB,YAAY,CAAC,IAAI,EAAC,MAAM,EAAE,EAAC,OAAO,GAAC,uBAA0B,GAAE,OAAO,CAAC,MAAM,CAAC,CAuBnG"}

package/dist/spawning/cli.js

@@ -0,0 +1,46 @@
+import { parseArgs } from 'node:util';
+import { approvalDisplayText } from '../approvals/index.js';
+import { isCancellation, throwIfCancelled } from '../cancellation.js';
+import { SessionPolicyError } from '../session-management/index.js';
+import { ExecutionLimitError } from '../execution/index.js';
+import { OrchestrationError } from '../orchestration/types.js';
+import { inspectExecution } from '../orchestration/coordinator-actions.js';
+import { inspectSpawn, admitSpawn } from './actions.js';
+import { SpawnProposalStore } from './store.js';
+import { executeSpawn } from './execution.js';
+export const SPAWN_USAGE = 'calliope agents spawn <children.json> --run <id> [--dry-run] [--approve <proposal-hash>] [--allow-mutations] [--json] | agents spawn --resume <proposal-hash> --run <id> [--json]';
+export async function spawnCommand(args, options = {}) {
+    const delimiter = args.indexOf('--'), json = args.slice(0, delimiter < 0 ? args.length : delimiter).includes('--json'), write = options.write ?? (text => { process.stdout.write(text); }), cwd = options.cwd ?? process.cwd();
+    const emit = (type, data, text) => write(json ? JSON.stringify({ version: 1, type, data }) + '\n' : approvalDisplayText(text) + '\n');
+    try {
+        throwIfCancelled(options.signal);
+        const { positionals: p, values: v } = parseArgs({ args, allowPositionals: true, options: { json: { type: 'boolean' }, run: { type: 'string' }, approve: { type: 'string' }, resume: { type: 'string' }, 'dry-run': { type: 'boolean' }, 'allow-mutations': { type: 'boolean' }, 'max-output-tokens': { type: 'string' } } });
+        if (p[0] !== 'spawn' || !v.run || (v.resume ? p.length !== 1 || !!v.approve || !!v['dry-run'] : p.length !== 2))
+            throw new OrchestrationError('invalid', SPAWN_USAGE);
+        if (args.some(arg => arg.length > 4096 || /[\x00-\x1f\x7f]/.test(arg)) || v['dry-run'] && (v.approve || v['allow-mutations'] || v['max-output-tokens']))
+            throw new OrchestrationError('invalid', SPAWN_USAGE);
+        const raw = v['max-output-tokens'];
+        if (raw !== undefined && (!/^\d+$/.test(raw) || !Number.isSafeInteger(Number(raw)) || Number(raw) < 1 || Number(raw) > 100000000))
+            throw new OrchestrationError('invalid', SPAWN_USAGE);
+        const runId = v.run, opts = { ...options, ...(raw ? { maxOutputTokens: Number(raw) } : {}) };
+        const preview = v.resume ? { proposal: new SpawnProposalStore((await inspectExecution(cwd, runId, opts)).store).read(v.resume) } : await inspectSpawn(cwd, runId, p[1], { ...opts, dryRun: !!v['dry-run'] });
+        const sourceArgument = "'" + (p[1] ?? 'children.json').replaceAll("'", "'\\''") + "'";
+        emit('orchestration.spawn.review', preview, `Review child proposal ${preview.proposal.hash}:\n${JSON.stringify(preview, null, 2)}\nApprove: calliope agents spawn ${sourceArgument} --run ${runId} --approve ${preview.proposal.hash}`);
+        if (v['dry-run'])
+            return 0;
+        if (!v.approve && !v.resume && !(options.source === 'repl' && options.approve && !json))
+            return 5;
+        const accepted = await admitSpawn(cwd, runId, v.resume ?? preview.proposal, v.approve ?? preview.proposal.hash, opts);
+        emit('orchestration.spawn.admitted', accepted, `Admitted ${accepted.admission.proposal.agents.length} children. Waiting for verified task outcomes.`);
+        const result = await executeSpawn(cwd, accepted.admission, { ...opts, ...(v['allow-mutations'] ? { approve: async () => 'allow' } : {}), onEvent: event => { options.onEvent?.(event); emit('orchestration.spawn.event', { runId, event }, `${event.sequence}. ${event.change.type}`); } });
+        emit('orchestration.spawn.result', result, `Child execution ${result.status} · run ${runId} · proposal ${result.proposalHash}`);
+        return result.exitCode;
+    }
+    catch (error) {
+        const cancelled = options.signal?.aborted || isCancellation(error), denied = error instanceof SessionPolicyError || error instanceof ExecutionLimitError || error instanceof OrchestrationError && error.code === 'policy-denied', invalid = error instanceof OrchestrationError && error.code === 'invalid' || error instanceof Error && 'code' in error && String(error.code).startsWith('ERR_PARSE_ARGS');
+        const message = cancelled ? 'Child operation cancelled; inspect its run and retained budget before resuming.' : invalid ? SPAWN_USAGE : error instanceof OrchestrationError || error instanceof ExecutionLimitError || error instanceof SessionPolicyError ? error.message : 'Child operation failed; preserve its proposal and run records for recovery.';
+        emit('orchestration.spawn.error', { code: cancelled ? 'cancelled' : denied ? 'policy-denied' : invalid ? 'invalid' : 'failed', message }, message);
+        return cancelled ? 130 : denied ? 3 : invalid ? 2 : 1;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/spawning/cli.js.map

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

package/dist/spawning/execution.d.ts

@@ -0,0 +1,13 @@
+import { type CoordinatorOptions } from '../orchestration/coordinator.js';
+import type { SpawnAdmission } from './types.js';
+/** A successful admission is not successful child work; wait for verified outcomes. */
+export declare function executeSpawn(cwd: string, admission: SpawnAdmission, options?: CoordinatorOptions): Promise<{
+    version: 1;
+    type: 'orchestration.spawn';
+    runId: string;
+    proposalHash: string;
+    status: string;
+    execution: import("../orchestration/coordinator-types.js").ExecutionInspection;
+    exitCode: number;
+}>;
+//# sourceMappingURL=execution.d.ts.map

package/dist/spawning/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/spawning/execution.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,kBAAkB,EAAC,MAAM,iCAAiC,CAAC;AAG3F,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,YAAY,CAAC;AAE/C,uFAAuF;AACvF,wBAAsB,YAAY,CAAC,GAAG,EAAC,MAAM,EAAC,SAAS,EAAC,cAAc,EAAC,OAAO,GAAC,kBAAqB;aAc7E,CAAC;UAAe,qBAAqB;;;;;;GAS3D"}

package/dist/spawning/execution.js

@@ -0,0 +1,59 @@
+import { coordinatorProgress } from '../orchestration/progress.js';
+import { cancellableDelay, throwIfCancelled, isCancellation, cancellationError } from '../cancellation.js';
+import { canonicalJson } from '../approvals/index.js';
+import { executeReviewedRun } from '../orchestration/coordinator.js';
+import { inspectExecution } from '../orchestration/coordinator-actions.js';
+import { OrchestrationError } from '../orchestration/types.js';
+/** A successful admission is not successful child work; wait for verified outcomes. */
+export async function executeSpawn(cwd, admission, options = {}) {
+    const runId = admission.proposal.runId, initial = await inspectExecution(cwd, runId, options), store = initial.store;
+    const recorded = initial.execution?.state.graph?.admissions.find(a => a.proposal.hash === admission.proposal.hash);
+    if (!initial.execution || !recorded || canonicalJson(recorded) !== canonicalJson(admission))
+        throw new OrchestrationError('conflict', 'Child graph has not been admitted or differs from its recorded authority.');
+    let cursor = initial.execution.events.length, resumed = false, cancelled = false;
+    const roots = admission.proposal.agents.filter(agent => !admission.proposal.agents.some(a => a.id === agent.parentId));
+    const stopChildren = async () => { if (cancelled)
+        return; cancelled = true; await store.appendBatch(roots.map(agent => ({ change: { type: 'agent_stop', agentId: agent.id } }))); };
+    try {
+        while (true) {
+            const view = store.read();
+            options.onProgress?.(coordinatorProgress(store, view));
+            for (const event of view.events.slice(cursor))
+                options.onEvent?.(event);
+            cursor = view.events.length;
+            const tasks = admission.proposal.tasks.map(task => view.state.tasks[task.id]), owner = store.owner();
+            if (options.signal?.aborted) {
+                await stopChildren();
+                if (!tasks.some(task => task.status === 'running') || !owner?.alive || Date.now() >= view.header.deadline)
+                    throw cancellationError();
+            }
+            else if (tasks.every(task => !['pending', 'running'].includes(task.status)) || (!owner?.alive && resumed) || Date.now() >= view.header.deadline) {
+                const status = tasks.every(task => task.status === 'completed') ? 'completed' : tasks.some(task => task.status === 'denied') ? 'denied' : tasks.some(task => task.status === 'cancelled') ? 'cancelled' : tasks.some(task => ['completed', 'review_required', 'pending'].includes(task.status)) ? 'partial' : 'failed';
+                return { version: 1, type: 'orchestration.spawn', runId, proposalHash: admission.proposal.hash, status, execution: view, exitCode: status === 'completed' ? 0 : status === 'partial' ? 4 : status === 'denied' ? 3 : status === 'cancelled' ? 130 : 1 };
+            }
+            else if (!owner?.alive) {
+                try {
+                    await executeReviewedRun(cwd, runId, { ...options, resume: true, onEvent: event => { if (event.sequence > cursor) {
+                            options.onEvent?.(event);
+                            cursor = event.sequence;
+                        } } });
+                    resumed = true;
+                    continue;
+                }
+                catch (error) {
+                    if (!(error instanceof OrchestrationError && error.code === 'locked'))
+                        throw error;
+                }
+            }
+            await cancellableDelay(100);
+        }
+    }
+    catch (error) {
+        if (options.signal?.aborted || isCancellation(error)) {
+            await stopChildren();
+            throwIfCancelled(options.signal);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=execution.js.map

package/dist/spawning/execution.js.map

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

package/dist/spawning/index.d.ts

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './validation.js';
+export * from './authority.js';
+export * from './store.js';
+export * from './actions.js';
+export * from './execution.js';
+export * from './cli.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/spawning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spawning/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}

package/dist/spawning/index.js

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './validation.js';
+export * from './authority.js';
+export * from './store.js';
+export * from './actions.js';
+export * from './execution.js';
+export * from './cli.js';
+//# sourceMappingURL=index.js.map

package/dist/spawning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/spawning/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}

package/dist/spawning/store.d.ts

@@ -0,0 +1,12 @@
+import { ExecutionStore } from '../orchestration/execution-store.js';
+import type { SpawnProposal } from './types.js';
+/** Immutable human-reviewed proposals live outside the worker's project scope. */
+export declare class SpawnProposalStore {
+    readonly execution: ExecutionStore;
+    readonly root: string;
+    constructor(execution: ExecutionStore);
+    read(hash: string): SpawnProposal;
+    /** Caller holds the execution writer lock, including the retention check. */
+    save(proposal: SpawnProposal): void;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/spawning/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/spawning/store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,cAAc,EAAoC,MAAM,qCAAqC,CAAC;AAItG,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,YAAY,CAAC;AAE9C,kFAAkF;AAClF,qBAAa,kBAAkB;IAEjB,QAAQ,CAAC,SAAS,EAAC,cAAc;IAD7C,QAAQ,CAAC,IAAI,EAAC,MAAM,CAAC;IACrB,YAAqB,SAAS,EAAC,cAAc,EAAoD;IACjG,IAAI,CAAC,IAAI,EAAC,MAAM,GAAE,aAAa,CAQ9B;IACD,6EAA6E;IAC7E,IAAI,CAAC,QAAQ,EAAC,aAAa,GAAE,IAAI,CAahC;CACF"}

package/dist/spawning/store.js

@@ -0,0 +1,93 @@
+import * as fs from 'node:fs';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { canonicalJson, canonicalPath } from '../approvals/index.js';
+import { privateDirectory, readArtifactBytes } from '../orchestration/execution-store.js';
+import { OrchestrationError } from '../orchestration/types.js';
+import { hex } from '../orchestration/validation.js';
+import { MAX_SPAWN_BYTES, MAX_SPAWN_PROPOSALS, validateSpawnProposal } from './validation.js';
+/** Immutable human-reviewed proposals live outside the worker's project scope. */
+export class SpawnProposalStore {
+    execution;
+    root;
+    constructor(execution) {
+        this.execution = execution;
+        this.root = join(execution.root, 'spawn-proposals');
+    }
+    read(hash) {
+        if (!hex(hash))
+            throw new OrchestrationError('invalid', 'Invalid child proposal hash.');
+        privateDirectory(this.root);
+        const value = JSON.parse(readArtifactBytes(join(this.root, hash + '.json'), MAX_SPAWN_BYTES, true).toString());
+        if (!value || typeof value !== 'object' || !('hash' in value) || value.hash !== hash)
+            throw new OrchestrationError('conflict', 'Saved child proposal does not match its requested hash.');
+        const view = this.execution.read(), admission = view.state.graph?.admissions.find(a => a.proposal.hash === hash);
+        if (admission) {
+            if (canonicalJson(value) !== canonicalJson(admission.proposal))
+                throw new OrchestrationError('conflict', 'Saved child proposal differs from its admission.');
+            return admission.proposal;
+        }
+        return validateSpawnProposal(value, this.execution.manifest, view.header, this.execution.context(view).plan);
+    }
+    /** Caller holds the execution writer lock, including the retention check. */
+    save(proposal) {
+        privateDirectory(this.execution.root);
+        if (canonicalPath(this.root) !== this.root)
+            throw new OrchestrationError('invalid', 'Child proposal store cannot use a symlink alias.');
+        try {
+            fs.mkdirSync(this.root, { mode: 0o700 });
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+        }
+        privateDirectory(this.root);
+        const file = join(this.root, proposal.hash + '.json');
+        if (fs.existsSync(file)) {
+            if (canonicalJson(this.read(proposal.hash)) !== canonicalJson(proposal))
+                throw new OrchestrationError('conflict', 'Child proposal identity changed.');
+            return;
+        }
+        let count = 0;
+        const dir = fs.opendirSync(this.root);
+        try {
+            let entry;
+            while ((entry = dir.readSync())) {
+                if (++count >= MAX_SPAWN_PROPOSALS)
+                    throw new OrchestrationError('limit', 'Child proposal retention reached; preserve existing evidence.');
+                if (!entry.isFile() || !/^([a-f0-9]{64}\.json|[a-f0-9-]{36}\.tmp)$/.test(entry.name))
+                    throw new OrchestrationError('unavailable', 'Child proposal store contains unrecognized files.');
+            }
+        }
+        finally {
+            dir.closeSync();
+        }
+        const raw = canonicalJson(proposal);
+        if (Buffer.byteLength(raw) > MAX_SPAWN_BYTES)
+            throw new OrchestrationError('limit', 'Child proposal exceeds its byte limit.');
+        const temp = join(this.root, randomUUID() + '.tmp'), fd = fs.openSync(temp, 'wx', 0o600);
+        try {
+            fs.writeFileSync(fd, raw);
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        try {
+            fs.linkSync(temp, file);
+        }
+        finally {
+            fs.unlinkSync(temp);
+        }
+        for (const path of [this.root, this.execution.root]) {
+            const directory = fs.openSync(path, 'r');
+            try {
+                fs.fsyncSync(directory);
+            }
+            finally {
+                fs.closeSync(directory);
+            }
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/spawning/store.js.map

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

package/dist/spawning/types.d.ts

@@ -0,0 +1,34 @@
+import type { AgentContract, ProjectTask, ProjectPlan } from '../orchestration/types.js';
+import type { RecordedChildGrant } from '../execution/types.js';
+export interface SpawnInput {
+    version: 1;
+    parentId: string;
+    agents: AgentContract[];
+    tasks: ProjectTask[];
+}
+export interface SpawnProposal extends SpawnInput {
+    runId: string;
+    runManifestHash: string;
+    approvalRevision: string;
+    graphHash: string;
+    planHash: string;
+    source: {
+        path: string;
+        sha256: string;
+        kind?: 'supervision';
+        eventId?: string;
+    };
+    hash: string;
+}
+export interface SpawnAdmission {
+    version: 1;
+    proposal: SpawnProposal;
+    grant: RecordedChildGrant;
+}
+export interface SpawnGraph {
+    version: 1;
+    plan: ProjectPlan;
+    hash: string;
+    admissions: SpawnAdmission[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/spawning/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/spawning/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,WAAW,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAC;AACrF,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAC;AAC9D,MAAM,WAAW,UAAU;IAAE,OAAO,EAAC,CAAC,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC,aAAa,EAAE,CAAC;IAAA,KAAK,EAAC,WAAW,EAAE,CAAA;CAAC;AAClG,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,KAAK,EAAC,MAAM,CAAC;IAAA,eAAe,EAAC,MAAM,CAAC;IAAA,gBAAgB,EAAC,MAAM,CAAC;IAAA,SAAS,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAC7F,MAAM,EAAC;QAAC,IAAI,EAAC,MAAM,CAAC;QAAA,MAAM,EAAC,MAAM,CAAC;QAAA,IAAI,CAAC,EAAC,aAAa,CAAC;QAAA,OAAO,CAAC,EAAC,MAAM,CAAA;KAAC,CAAC;IAAA,IAAI,EAAC,MAAM,CAAC;CACpF;AACD,MAAM,WAAW,cAAc;IAAE,OAAO,EAAC,CAAC,CAAC;IAAA,QAAQ,EAAC,aAAa,CAAC;IAAA,KAAK,EAAC,kBAAkB,CAAA;CAAC;AAC3F,MAAM,WAAW,UAAU;IAAE,OAAO,EAAC,CAAC,CAAC;IAAA,IAAI,EAAC,WAAW,CAAC;IAAA,IAAI,EAAC,MAAM,CAAC;IAAA,UAAU,EAAC,cAAc,EAAE,CAAA;CAAC"}

package/dist/spawning/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/spawning/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/spawning/types.ts"],"names":[],"mappings":""}

package/dist/spawning/validation.d.ts

@@ -0,0 +1,14 @@
+import type { ProjectPlan, RunManifest } from '../orchestration/types.js';
+import type { ExecutionHeader } from '../orchestration/coordinator-types.js';
+import type { ChildGrant } from '../execution/types.js';
+import type { SpawnInput, SpawnProposal, SpawnAdmission } from './types.js';
+export declare const MAX_SPAWN_BYTES = 65536, MAX_SPAWN_PROPOSALS = 256;
+export declare function validateSpawnInput(value: unknown): SpawnInput;
+/** Existing agents, tasks, scopes and limits remain byte-for-byte unchanged. */
+export declare function extendPlan(base: ProjectPlan, input: SpawnInput): ProjectPlan;
+export declare function proposalId(hash: string): string;
+export declare function proposalGrant(proposal: SpawnProposal, header: ExecutionHeader): ChildGrant;
+export declare function validateSpawnProposal(value: unknown, manifest: RunManifest, header: ExecutionHeader, base: ProjectPlan): SpawnProposal;
+export declare function makeSpawnProposal(manifest: RunManifest, header: ExecutionHeader, base: ProjectPlan, input: SpawnInput, source: SpawnProposal['source']): SpawnProposal;
+export declare function validateSpawnAdmission(value: unknown, manifest: RunManifest, header: ExecutionHeader, base: ProjectPlan): SpawnAdmission;
+//# sourceMappingURL=validation.d.ts.map

package/dist/spawning/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/spawning/validation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,WAAW,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uCAAuC,CAAC;AAE3E,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAC,UAAU,EAAC,aAAa,EAAC,cAAc,EAAC,MAAM,YAAY,CAAC;AAExE,eAAO,MAAM,eAAe,QAAM,EAAC,mBAAmB,MAAI,CAAC;AAC3D,wBAAgB,kBAAkB,CAAC,KAAK,EAAC,OAAO,GAAE,UAAU,CAG3D;AACD,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,IAAI,EAAC,WAAW,EAAC,KAAK,EAAC,UAAU,GAAE,WAAW,CAWxE;AACD,wBAAgB,UAAU,CAAC,IAAI,EAAC,MAAM,GAAE,MAAM,CAE7C;AACD,wBAAgB,aAAa,CAAC,QAAQ,EAAC,aAAa,EAAC,MAAM,EAAC,eAAe,GAAE,UAAU,CAGtF;AACD,wBAAgB,qBAAqB,CAAC,KAAK,EAAC,OAAO,EAAC,QAAQ,EAAC,WAAW,EAAC,MAAM,EAAC,eAAe,EAAC,IAAI,EAAC,WAAW,GAAE,aAAa,CAS9H;AACD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAC,WAAW,EAAC,MAAM,EAAC,eAAe,EAAC,IAAI,EAAC,WAAW,EAAC,KAAK,EAAC,UAAU,EAAC,MAAM,EAAC,aAAa,CAAC,QAAQ,CAAC,GAAE,aAAa,CAG5J;AACD,wBAAgB,sBAAsB,CAAC,KAAK,EAAC,OAAO,EAAC,QAAQ,EAAC,WAAW,EAAC,MAAM,EAAC,eAAe,EAAC,IAAI,EAAC,WAAW,GAAE,cAAc,CAIhI"}