@calliopelabs/cli 3.1.0 → 3.2.0

package/dist/orchestration/cli.d.ts

@@ -0,0 +1,28 @@
+import { type RunActionOptions } from './actions.js';
+import { type ExecutionCommandOptions } from './execution-cli.js';
+export declare const ORCHESTRATION_USAGE = "calliope run <plan> --dry-run | run prepare <plan> | run [list|status|replay] [run-id] | run approve|cancel <run-id> | agents [--tree] [--run <id>] | tasks [--graph] [--run <id>] [--json]";
+/** Quotes group arguments only; substitutions and commands are never evaluated. */
+export declare function parseOrchestrationArgs(input: string): string[];
+export interface OrchestrationReport {
+    version: 1;
+    type: 'orchestration';
+    action: string;
+    localOnly: true;
+    execution: 'not-started';
+    data?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export type OrchestrationNamespace = 'run' | 'agents' | 'tasks';
+export declare function isSpawnArgs(args: string[]): boolean;
+export declare function orchestrationCommand(namespace: OrchestrationNamespace, args: string[], options?: RunActionOptions & {
+    cwd?: string;
+}): Promise<{
+    report: OrchestrationReport;
+    exitCode: number;
+}>;
+export declare function formatOrchestration(report: OrchestrationReport): string;
+export declare function runOrchestrationCommand(namespace: OrchestrationNamespace, args: string[], options?: ExecutionCommandOptions): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/orchestration/cli.ts"],"names":[],"mappings":"AAMA,OAAO,EAA0D,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC7G,OAAO,EAAkB,KAAK,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AACjF,eAAO,MAAM,mBAAmB,gMAAgM,CAAC;AACjO,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAa9D;AACD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,aAAa,CAAC;IAC7F,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AACD,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAChE,wBAAgB,WAAW,CAAC,IAAI,EAAC,MAAM,EAAE,GAAE,OAAO,CAEjD;AACD,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,sBAAsB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,gBAAgB,GAAG;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,OAAO,CAAC;IAAC,MAAM,EAAC,mBAAmB,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAA;CAAC,CAAC,CAwCpM;AACD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAoBvE;AACD,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,sBAAsB,EAAC,IAAI,EAAC,MAAM,EAAE,EAAC,OAAO,GAAC,uBAA4B,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnJ"}

package/dist/orchestration/cli.js

@@ -0,0 +1,178 @@
+import { parseArgs } from 'node:util';
+import { SessionPolicyError } from '../session-management/index.js';
+import { isCancellation, throwIfCancelled } from '../cancellation.js';
+import { approvalDisplayText } from '../approvals/index.js';
+import { OrchestrationError } from './types.js';
+import { RunStore } from './store.js';
+import { loadRunPlan, prepareRun, changePreparedRun, inspectRun } from './actions.js';
+import { executionCommand } from './execution-cli.js';
+export const ORCHESTRATION_USAGE = 'calliope run <plan> --dry-run | run prepare <plan> | run [list|status|replay] [run-id] | run approve|cancel <run-id> | agents [--tree] [--run <id>] | tasks [--graph] [--run <id>] [--json]';
+/** Quotes group arguments only; substitutions and commands are never evaluated. */
+export function parseOrchestrationArgs(input) {
+    if (input.length > 32768)
+        throw new OrchestrationError('invalid', 'Orchestration command exceeds 32,768 characters.');
+    const args = [];
+    let value = '', quote = '', present = false;
+    const push = () => { if (present) {
+        args.push(value);
+        value = '';
+        present = false;
+        if (args.length > 128)
+            throw new OrchestrationError('invalid', 'Too many orchestration arguments.');
+    } };
+    for (let i = 0; i < input.length; i++) {
+        const char = input[i];
+        if (char === '\\' && quote !== "'") {
+            if (++i >= input.length)
+                throw new OrchestrationError('invalid', 'Incomplete argument escape.');
+            value += input[i];
+            present = true;
+        }
+        else if (quote) {
+            if (char === quote)
+                quote = '';
+            else
+                value += char;
+        }
+        else if (char === '"' || char === "'") {
+            quote = char;
+            present = true;
+        }
+        else if (/\s/.test(char))
+            push();
+        else {
+            value += char;
+            present = true;
+        }
+    }
+    if (quote)
+        throw new OrchestrationError('invalid', 'Unclosed argument quote.');
+    push();
+    return args;
+}
+export function isSpawnArgs(args) {
+    try {
+        return parseArgs({ args, strict: false, allowPositionals: true, options: { run: { type: 'string' }, approve: { type: 'string' }, resume: { type: 'string' }, 'max-output-tokens': { type: 'string' } } }).positionals[0] === 'spawn';
+    }
+    catch {
+        return false;
+    }
+}
+export async function orchestrationCommand(namespace, args, options = {}) {
+    let action = namespace;
+    const response = (data) => ({ exitCode: 0, report: { version: 1, type: 'orchestration', action, localOnly: true, execution: 'not-started', data } });
+    const failure = (code, message, exitCode) => ({ exitCode, report: { version: 1, type: 'orchestration', action, localOnly: true, execution: 'not-started', error: { code, message } } });
+    let parsed;
+    try {
+        parsed = parseArgs({ args, allowPositionals: true, options: { json: { type: 'boolean' }, 'dry-run': { type: 'boolean' }, tree: { type: 'boolean' }, graph: { type: 'boolean' }, run: { type: 'string' } } });
+    }
+    catch {
+        return failure('invalid-arguments', ORCHESTRATION_USAGE, 2);
+    }
+    const { positionals, values } = parsed;
+    if (args.some(arg => arg.length > 4096 || /[\x00-\x1f\x7f]/.test(arg)))
+        return failure('invalid-arguments', ORCHESTRATION_USAGE, 2);
+    const cwd = options.cwd ?? process.cwd(), store = options.store ?? new RunStore(), opts = { ...options, store };
+    try {
+        throwIfCancelled(options.signal);
+        if (namespace !== 'run') {
+            const expected = namespace === 'agents' ? 'tree' : 'graph';
+            if (values['dry-run'] || values[expected === 'tree' ? 'graph' : 'tree'] || positionals.length > 2 || positionals[0] && positionals[0] !== expected || positionals[1] && values.run)
+                return failure('invalid-arguments', ORCHESTRATION_USAGE, 2);
+            const view = await inspectRun(cwd, positionals[1] ?? values.run, opts);
+            return response(namespace === 'agents' ? { run: view.run, coordinatorId: view.analysis.coordinatorId, depths: view.analysis.depths, agents: view.manifest.plan.agents }
+                : { run: view.run, tasks: view.manifest.plan.tasks, stages: view.analysis.stages, conflicts: view.analysis.conflicts });
+        }
+        if (values.tree || values.graph || values.run)
+            return failure('invalid-arguments', ORCHESTRATION_USAGE, 2);
+        action = positionals[0] ?? 'list';
+        if (values['dry-run']) {
+            if (positionals.length !== 1)
+                return failure('invalid-arguments', ORCHESTRATION_USAGE, 2);
+            action = 'dry-run';
+            const { analysis, project, source } = await loadRunPlan(cwd, positionals[0], true, opts);
+            return response({ project, source, planHash: analysis.hash, plan: analysis.plan, coordinatorId: analysis.coordinatorId, stages: analysis.stages, conflicts: analysis.conflicts, approval: 'not-requested', modelDiscovery: 'not-checked', executedTasks: 0 });
+        }
+        const arities = { list: [0], status: [0, 1], replay: [1], prepare: [1], approve: [1], cancel: [1] };
+        const count = positionals.length ? positionals.length - 1 : 0;
+        if (!Object.hasOwn(arities, action) || !arities[action].includes(count))
+            return failure('invalid-arguments', ORCHESTRATION_USAGE + '. Child execution is not available in this preparation command.', 2);
+        if (action === 'list')
+            return response(await store.list(cwd, options.signal));
+        if (action === 'prepare') {
+            const view = await prepareRun(cwd, positionals[1], opts);
+            return response({ run: view.run, coordinatorId: view.analysis.coordinatorId, agents: view.manifest.plan.agents.length, tasks: view.manifest.plan.tasks.length, stages: view.analysis.stages, conflicts: view.analysis.conflicts });
+        }
+        if (action === 'approve' || action === 'cancel')
+            return response({ run: (await changePreparedRun(cwd, positionals[1], action === 'approve' ? 'approved' : 'cancelled', opts)).run });
+        const view = await inspectRun(cwd, positionals[1], opts);
+        return response(action === 'replay' ? { run: view.run, events: view.events } : { run: view.run, coordinatorId: view.analysis.coordinatorId, agents: view.manifest.plan.agents.length, tasks: view.manifest.plan.tasks.length, stages: view.analysis.stages, conflicts: view.analysis.conflicts });
+    }
+    catch (error) {
+        if (options.signal?.aborted || isCancellation(error))
+            return failure('cancelled', 'Operation cancelled. Inspect recorded state before retrying; no child agents were started.', 130);
+        if (error instanceof SessionPolicyError)
+            return failure('policy-denied', error.message, 3);
+        if (error instanceof OrchestrationError)
+            return failure(error.code, approvalDisplayText(error.message), error.code === 'policy-denied' ? 3 : 1);
+        return failure('unavailable', 'Run operation failed. Check the project, plan, local store permissions and available space; preserve existing records.', 1);
+    }
+}
+export function formatOrchestration(report) {
+    if (report.error)
+        return report.error.message;
+    const data = report.data;
+    const lines = [`Orchestration ${report.action} · no child execution`];
+    if (data.run)
+        lines.push(`Run ${data.run.id} · ${data.run.status} · approval ${data.run.approval}`, `Plan SHA-256 ${data.run.planHash} · revision ${data.run.revision}`);
+    if (data.plan)
+        lines.push(`Plan ${data.plan.id}: ${data.plan.goal}`, `SHA-256 ${data.planHash}`, `${data.plan.agents.length} declared agents · ${data.plan.tasks.length} tasks · concurrency limit ${data.plan.limits.maxConcurrent}`, `Budgets: ${data.plan.limits.tokenBudget} tokens · $${data.plan.limits.costBudgetUsd} · ${data.plan.limits.timeBudgetMs} ms`, 'Model compatibility has not been checked.');
+    if (data.runs) {
+        for (const run of data.runs)
+            lines.push(`${run.id} · ${run.status} · ${run.eventCount} events · ${run.updatedAt}`);
+        if (!data.runs.length)
+            lines.push('No prepared runs in this project.');
+        if (data.unavailable)
+            lines.push(`${data.unavailable} run directories are unavailable; preserve them for inspection.`);
+    }
+    if (Array.isArray(data.agents)) {
+        const agents = data.agents;
+        const tree = (parentId, indent) => {
+            for (const agent of agents.filter(agent => agent.parentId === parentId).sort((a, b) => a.id.localeCompare(b.id))) {
+                lines.push(`${indent}${parentId ? '└─ ' : ''}${agent.id} · ${agent.role} · planned`);
+                tree(agent.id, indent + '   ');
+            }
+        };
+        tree(null, '');
+    }
+    if (Array.isArray(data.tasks))
+        for (const task of data.tasks)
+            lines.push(`${task.id} → ${task.agentId} · depends on ${task.dependencies.join(', ') || 'none'} · pending`);
+    if (data.stages)
+        data.stages.forEach((stage, index) => lines.push(`Dependency stage ${index + 1}: ${stage.join(', ')}`));
+    if (data.conflicts?.length) {
+        lines.push(`${data.conflicts.length} write/read scope overlaps require scheduling or isolation:`);
+        for (const conflict of data.conflicts.slice(0, 40))
+            lines.push(`${conflict.tasks.join(' ↔ ')}: ${conflict.paths.join(', ')}`);
+        if (data.conflicts.length > 40)
+            lines.push('Further overlaps are available with --json.');
+    }
+    if (data.events)
+        for (const event of data.events)
+            lines.push(`${event.sequence}. ${event.at} ${event.change.type} · ${event.id}`);
+    lines.push('Plan approval records intent; runtime permission and budget gates still apply.');
+    const display = approvalDisplayText(lines.join('\n'));
+    return display.length > 32000 ? display.slice(0, 32000) + '\n[Display limited to 32,000 characters; use --json for the complete report.]' : display;
+}
+export async function runOrchestrationCommand(namespace, args, options = {}) {
+    if (namespace === 'agents' && isSpawnArgs(args))
+        return (await import('../spawning/index.js')).spawnCommand(args, options);
+    const executed = await executionCommand(namespace, args, options);
+    if (executed !== null)
+        return executed;
+    const result = await orchestrationCommand(namespace, args, options);
+    const delimiter = args.indexOf('--'), json = args.slice(0, delimiter < 0 ? args.length : delimiter).includes('--json');
+    (options.write ?? (text => { process.stdout.write(text); }))(json ? JSON.stringify(result.report) + '\n' : formatOrchestration(result.report) + '\n');
+    return result.exitCode;
+}
+//# sourceMappingURL=cli.js.map

package/dist/orchestration/cli.js.map

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

package/dist/orchestration/coordinator-actions.d.ts

@@ -0,0 +1,15 @@
+import { ExecutionStore } from './execution-store.js';
+import type { RunActionOptions } from './actions.js';
+import type { CoordinatorOptions } from './coordinator.js';
+export declare function inspectExecution(cwd: string, runId: string, options?: RunActionOptions): Promise<{
+    view: import("./types.js").RunInspection;
+    store: ExecutionStore;
+    execution: import("./coordinator-types.js").ExecutionInspection | null;
+    owner: {
+        id: string;
+        pid: number;
+        alive: boolean;
+    } | null;
+}>;
+export declare function controlExecution(cwd: string, runId: string, action: 'retry' | 'accept' | 'agent-stop' | 'agent-retry' | 'controller-retry', target: string, options?: RunActionOptions & Pick<CoordinatorOptions, 'onProgress'>): Promise<import("./coordinator-types.js").ExecutionInspection>;
+//# sourceMappingURL=coordinator-actions.d.ts.map

package/dist/orchestration/coordinator-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-actions.d.ts","sourceRoot":"","sources":["../../src/orchestration/coordinator-actions.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAIpD,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AAKzD,wBAAsB,gBAAgB,CAAC,GAAG,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,EAAC,OAAO,GAAC,gBAAmB;;;;;;;;;GAGzF;AACD,wBAAsB,gBAAgB,CAAC,GAAG,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,EAAC,MAAM,EAAC,OAAO,GAAC,QAAQ,GAAC,YAAY,GAAC,aAAa,GAAC,kBAAkB,EAAC,MAAM,EAAC,MAAM,EAAC,OAAO,GAAC,gBAAgB,GAAC,IAAI,CAAC,kBAAkB,EAAC,YAAY,CAAI,iEAkCnN"}

package/dist/orchestration/coordinator-actions.js

@@ -0,0 +1,79 @@
+import { coordinatorProgress } from './progress.js';
+import { join } from 'node:path';
+import { authorizeSessionAction } from '../session-management/index.js';
+import { throwIfCancelled } from '../cancellation.js';
+import { RunStore } from './store.js';
+import { ExecutionStore } from './execution-store.js';
+import { artifactSetHash } from './execution-journal.js';
+import { readCollectedArtifact, checkArtifactSnapshot } from './verification.js';
+import { OrchestrationError } from './types.js';
+import { ReservationLedger } from '../execution/index.js';
+import { inspectSpawnAuthority } from '../spawning/authority.js';
+export async function inspectExecution(cwd, runId, options = {}) {
+    const runs = options.store ?? new RunStore(), view = await runs.read(runId, cwd, options.signal), store = new ExecutionStore(join(runs.root, runId), view.manifest);
+    return { view, store, execution: store.exists() ? store.read() : null, owner: store.exists() ? store.owner() : null };
+}
+export async function controlExecution(cwd, runId, action, target, options = {}) {
+    const initial = await inspectExecution(cwd, runId, options);
+    if (!initial.execution)
+        throw new OrchestrationError('unavailable', 'Run has no execution history.');
+    const { view, store } = initial, agentAction = action.startsWith('agent-'), context = store.context(initial.execution);
+    const finish = () => { const execution = store.read(); options.onProgress?.(coordinatorProgress(store, execution)); return execution; };
+    const goalAuthority = view.manifest.version === 2 && action !== 'agent-stop' ? (await import('../goals/index.js')).goalRunAuthority(view.manifest, (options.store ?? new RunStore()).root) : undefined;
+    const assertAuthority = () => { store.assertApproval(initial.execution.header); goalAuthority?.assertActive(); const authority = inspectSpawnAuthority(store, new ReservationLedger(join(store.root, '..', 'budget'))); if (action === 'accept' && authority.pending.length)
+        throw new OrchestrationError('conflict', 'Recover pending child admission before accepting the run.'); };
+    if (action === 'controller-retry' ? context.plan.supervision?.controllerId !== target : agentAction ? !context.plan.agents.some(a => a.id === target) : !context.plan.tasks.some(t => t.id === target))
+        throw new OrchestrationError('invalid', 'Unknown execution task or agent.');
+    if (action === 'accept') {
+        const task = initial.execution.state.tasks[target];
+        if (task.status !== 'review_required' || !task.output)
+            throw new OrchestrationError('conflict', 'Task is not awaiting acceptance.');
+        for (const artifact of task.output.artifacts)
+            await readCollectedArtifact(store, artifact, options);
+    }
+    await authorizeSessionAction(cwd, action === 'accept' ? 'orchestration_accept' : action === 'agent-stop' ? 'orchestration_agent_stop' : 'orchestration_retry', { path: cwd, runId, target, action, planHash: initial.execution.state.graph?.hash ?? view.manifest.planHash, revision: initial.execution.state.revision, ...(action === 'accept' ? { artifactsHash: artifactSetHash(initial.execution.state.tasks[target].output.artifacts), acceptanceCriteria: context.plan.tasks.find(t => t.id === target).acceptanceCriteria, agentCriteria: context.plan.agents.find(a => a.id === initial.execution.state.tasks[target].agentId).acceptanceCriteria, evidence: initial.execution.state.tasks[target].output } : {}) }, options);
+    throwIfCancelled(options.signal);
+    if (action === 'agent-stop') {
+        await store.append({ type: 'agent_stop', agentId: target }, options.signal);
+        return finish();
+    }
+    const lease = store.acquire();
+    try {
+        const current = store.read();
+        assertAuthority();
+        if (current.state.revision !== initial.execution.state.revision || current.state.ownerId)
+            throw new OrchestrationError('conflict', 'Execution changed or needs orphan recovery; inspect and resume before applying this decision.');
+        if (action === 'controller-retry') {
+            await store.append({ type: 'supervision_reset', source: options.source === 'repl' ? 'repl' : 'cli' }, options.signal, undefined, () => { lease.check(); assertAuthority(); });
+        }
+        else if (action === 'accept') {
+            const output = current.state.tasks[target].output;
+            for (const artifact of output.artifacts)
+                await readCollectedArtifact(store, artifact, options);
+            await store.appendBatch([{ change: { type: 'task_accepted', taskId: target, artifactsHash: artifactSetHash(output.artifacts) } }], options.signal, () => { lease.check(); assertAuthority(); if (store.read().state.revision !== current.state.revision)
+                throw new OrchestrationError('conflict', 'Execution changed during acceptance.'); for (const artifact of output.artifacts)
+                checkArtifactSnapshot(store, artifact); });
+        }
+        else if (action === 'retry') {
+            await store.append({ type: 'task_reset', taskId: target, source: 'manual' }, options.signal, undefined, () => { lease.check(); store.assertApproval(current.header); goalAuthority?.assertActive(); });
+        }
+        else {
+            const descendants = new Set([target]);
+            for (let n = 0; n < context.plan.agents.length; n++)
+                for (const agent of context.plan.agents)
+                    if (agent.parentId && descendants.has(agent.parentId))
+                        descendants.add(agent.id);
+            const candidates = context.plan.tasks.filter(t => descendants.has(t.agentId) && ['failed', 'denied', 'cancelled', 'unknown'].includes(current.state.tasks[t.id].status));
+            if (!candidates.length && !current.state.stoppedAgents.some(id => descendants.has(id)))
+                throw new OrchestrationError('conflict', 'Agent has no stopped or retryable task.');
+            const changes = [...candidates.map(task => ({ type: 'task_reset', taskId: task.id, source: 'manual' })), ...current.state.stoppedAgents.filter(id => descendants.has(id)).map(agentId => ({ type: 'agent_reset', agentId }))];
+            await store.appendBatch(changes.map(change => ({ change })), options.signal, () => { lease.check(); store.assertApproval(current.header); goalAuthority?.assertActive(); if (store.read().state.revision !== current.state.revision)
+                throw new OrchestrationError('conflict', 'Execution changed during agent retry.'); });
+        }
+        return finish();
+    }
+    finally {
+        lease.release();
+    }
+}
+//# sourceMappingURL=coordinator-actions.js.map

package/dist/orchestration/coordinator-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-actions.js","sourceRoot":"","sources":["../../src/orchestration/coordinator-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,sBAAsB,EAAC,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AACpC,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAC,eAAe,EAAC,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAC,qBAAqB,EAAC,qBAAqB,EAAC,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAC,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAI9C,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAC,qBAAqB,EAAC,MAAM,0BAA0B,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAU,EAAC,KAAY,EAAC,OAAO,GAAkB,EAAE;IACxF,MAAM,IAAI,GAAC,OAAO,CAAC,KAAK,IAAE,IAAI,QAAQ,EAAE,EAAC,IAAI,GAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAC,GAAG,EAAC,OAAO,CAAC,MAAM,CAAC,EAAC,KAAK,GAAC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAC,KAAK,CAAC,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtJ,OAAM,EAAC,IAAI,EAAC,KAAK,EAAC,SAAS,EAAC,KAAK,CAAC,MAAM,EAAE,CAAA,CAAC,CAAA,KAAK,CAAC,IAAI,EAAE,CAAA,CAAC,CAAA,IAAI,EAAC,KAAK,EAAC,KAAK,CAAC,MAAM,EAAE,CAAA,CAAC,CAAA,KAAK,CAAC,KAAK,EAAE,CAAA,CAAC,CAAA,IAAI,EAAC,CAAC;AACxG,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAU,EAAC,KAAY,EAAC,MAAqE,EAAC,MAAa,EAAC,OAAO,GAAwD,EAAE;IAClN,MAAM,OAAO,GAAC,MAAM,gBAAgB,CAAC,GAAG,EAAC,KAAK,EAAC,OAAO,CAAC,CAAC;IAAA,IAAG,CAAC,OAAO,CAAC,SAAS;QAAC,MAAM,IAAI,kBAAkB,CAAC,aAAa,EAAC,+BAA+B,CAAC,CAAC;IAC1J,MAAM,EAAC,IAAI,EAAC,KAAK,EAAC,GAAC,OAAO,EAAC,WAAW,GAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAC,OAAO,GAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5G,MAAM,MAAM,GAAC,GAAE,EAAE,GAAC,MAAM,SAAS,GAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA,OAAO,CAAC,UAAU,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAC,SAAS,CAAC,CAAC,CAAC,CAAA,OAAO,SAAS,CAAC,CAAA,CAAC,CAAC;IAC7H,MAAM,aAAa,GAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,KAAG,CAAC,IAAE,MAAM,KAAG,YAAY,CAAA,CAAC,CAAA,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAC,CAAC,OAAO,CAAC,KAAK,IAAE,IAAI,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA,CAAC,CAAA,SAAS,CAAC;IACxL,MAAM,eAAe,GAAC,GAAE,EAAE,GAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,SAAU,CAAC,MAAM,CAAC,CAAC,CAAA,aAAa,EAAE,YAAY,EAAE,CAAC,CAAA,MAAM,SAAS,GAAC,qBAAqB,CAAC,KAAK,EAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAC,IAAI,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA,IAAG,MAAM,KAAG,QAAQ,IAAE,SAAS,CAAC,OAAO,CAAC,MAAM;QAAC,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAC,2DAA2D,CAAC,CAAC,CAAA,CAAC,CAAC;IAClW,IAAG,MAAM,KAAG,kBAAkB,CAAA,CAAC,CAAA,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,KAAG,MAAM,CAAA,CAAC,CAAA,WAAW,CAAA,CAAC,CAAA,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,EAAE,KAAG,MAAM,CAAC,CAAA,CAAC,CAAA,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,EAAE,KAAG,MAAM,CAAC;QAAC,MAAM,IAAI,kBAAkB,CAAC,SAAS,EAAC,kCAAkC,CAAC,CAAC;IAC7P,IAAG,MAAM,KAAG,QAAQ,EAAC,CAAC;QACpB,MAAM,IAAI,GAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC;QAAA,IAAG,IAAI,CAAC,MAAM,KAAG,iBAAiB,IAAE,CAAC,IAAI,CAAC,MAAM;YAAC,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAC,kCAAkC,CAAC,CAAC;QAC/K,KAAI,MAAM,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS;YAAC,MAAM,qBAAqB,CAAC,KAAK,EAAC,QAAQ,EAAC,OAAO,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,sBAAsB,CAAC,GAAG,EAAC,MAAM,KAAG,QAAQ,CAAA,CAAC,CAAA,sBAAsB,CAAA,CAAC,CAAA,MAAM,KAAG,YAAY,CAAA,CAAC,CAAA,0BAA0B,CAAA,CAAC,CAAA,qBAAqB,EAC9I,EAAC,IAAI,EAAC,GAAG,EAAC,KAAK,EAAC,MAAM,EAAC,MAAM,EAAC,QAAQ,EAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,IAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAC,QAAQ,EAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAC,GAAG,CAAC,MAAM,KAAG,QAAQ,CAAA,CAAC,CAAA,EAAC,aAAa,EAAC,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC,MAAO,CAAC,SAAS,CAAC,EAAC,kBAAkB,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,EAAE,KAAG,MAAM,CAAE,CAAC,kBAAkB,EAAC,aAAa,EAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,EAAE,KAAG,OAAO,CAAC,SAAU,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC,OAAO,CAAE,CAAC,kBAAkB,EAAC,QAAQ,EAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC,MAAM,EAAC,CAAA,CAAC,CAAA,EAAE,CAAC,EAAC,EAAC,OAAO,CAAC,CAAC;IAC3gB,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,IAAG,MAAM,KAAG,YAAY,EAAC,CAAC;QAAA,MAAM,KAAK,CAAC,MAAM,CAAC,EAAC,IAAI,EAAC,YAAY,EAAC,OAAO,EAAC,MAAM,EAAC,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAAA,OAAO,MAAM,EAAE,CAAC;IAAA,CAAC;IACjH,MAAM,KAAK,GAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,OAAO,GAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAAA,eAAe,EAAE,CAAC;QAC7C,IAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,IAAE,OAAO,CAAC,KAAK,CAAC,OAAO;YAAC,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAC,+FAA+F,CAAC,CAAC;QAC7N,IAAG,MAAM,KAAG,kBAAkB,EAAC,CAAC;YAC9B,MAAM,KAAK,CAAC,MAAM,CAAC,EAAC,IAAI,EAAC,mBAAmB,EAAC,MAAM,EAAC,OAAO,CAAC,MAAM,KAAG,MAAM,CAAA,CAAC,CAAA,MAAM,CAAA,CAAC,CAAA,KAAK,EAAC,EAAC,OAAO,CAAC,MAAM,EAAC,SAAS,EAAC,GAAE,EAAE,GAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA,eAAe,EAAE,CAAC,CAAA,CAAC,CAAC,CAAC;QAC7J,CAAC;aAAK,IAAG,MAAM,KAAG,QAAQ,EAAC,CAAC;YAC1B,MAAM,MAAM,GAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC,MAAO,CAAC;YAAA,KAAI,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS;gBAAC,MAAM,qBAAqB,CAAC,KAAK,EAAC,QAAQ,EAAC,OAAO,CAAC,CAAC;YAC7I,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC,EAAC,MAAM,EAAC,EAAC,IAAI,EAAC,eAAe,EAAC,MAAM,EAAC,MAAM,EAAC,aAAa,EAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,EAAC,EAAC,CAAC,EAAC,OAAO,CAAC,MAAM,EAAC,GAAE,EAAE,GAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA,eAAe,EAAE,CAAC,CAAA,IAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAG,OAAO,CAAC,KAAK,CAAC,QAAQ;gBAAC,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAC,sCAAsC,CAAC,CAAC,CAAA,KAAI,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS;gBAAC,qBAAqB,CAAC,KAAK,EAAC,QAAQ,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC;QACtY,CAAC;aAAK,IAAG,MAAM,KAAG,OAAO,EAAC,CAAC;YAAA,MAAM,KAAK,CAAC,MAAM,CAAC,EAAC,IAAI,EAAC,YAAY,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,QAAQ,EAAC,EAAC,OAAO,CAAC,MAAM,EAAC,SAAS,EAAC,GAAE,EAAE,GAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA,aAAa,EAAE,YAAY,EAAE,CAAC,CAAA,CAAC,CAAC,CAAC;QAAA,CAAC;aAC9M,CAAC;YACJ,MAAM,WAAW,GAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAAA,KAAI,IAAI,CAAC,GAAC,CAAC,EAAC,CAAC,GAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAC,CAAC,EAAE;gBAAC,KAAI,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM;oBAAC,IAAG,KAAK,CAAC,QAAQ,IAAE,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;wBAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrM,MAAM,UAAU,GAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA,EAAE,CAAA,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAE,CAAC,QAAQ,EAAC,QAAQ,EAAC,WAAW,EAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC,MAAM,CAAC,CAAC,CAAC;YACjK,IAAG,CAAC,UAAU,CAAC,MAAM,IAAE,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAA,EAAE,CAAA,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAC,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAC,yCAAyC,CAAC,CAAC;YACrK,MAAM,OAAO,GAAmB,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAA,EAAE,CAAA,CAAC,EAAC,IAAI,EAAC,YAAqB,EAAC,MAAM,EAAC,IAAI,CAAC,EAAE,EAAC,MAAM,EAAC,QAAiB,EAAC,CAAC,CAAC,EAAC,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAA,EAAE,CAAA,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAA,EAAE,CAAA,CAAC,EAAC,IAAI,EAAC,aAAsB,EAAC,OAAO,EAAC,CAAC,CAAC,CAAC,CAAC;YACvP,MAAM,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAA,EAAE,CAAA,CAAC,EAAC,MAAM,EAAC,CAAC,CAAC,EAAC,OAAO,CAAC,MAAM,EAAC,GAAE,EAAE,GAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA,aAAa,EAAE,YAAY,EAAE,CAAC,CAAA,IAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAG,OAAO,CAAC,KAAK,CAAC,QAAQ;gBAAC,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAC,uCAAuC,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC;QAC3S,CAAC;QACD,OAAO,MAAM,EAAE,CAAC;IAClB,CAAC;YAAO,CAAC;QAAA,KAAK,CAAC,OAAO,EAAE,CAAC;IAAA,CAAC;AAC5B,CAAC"}

package/dist/orchestration/coordinator-types.d.ts

@@ -0,0 +1,193 @@
+import type { ArtifactSpec, RunManifest } from './types.js';
+import type { SpawnAdmission, SpawnGraph } from '../spawning/types.js';
+export type TaskStatus = 'pending' | 'running' | 'completed' | 'review_required' | 'failed' | 'denied' | 'cancelled' | 'unknown';
+export type ExecutionStatus = 'ready' | 'running' | 'completed' | 'partial' | 'failed' | 'denied' | 'cancelled';
+export interface CollectedArtifact {
+    id: string;
+    taskId: string;
+    agentId: string;
+    kind: ArtifactSpec['kind'];
+    location: 'project' | 'run';
+    path: string;
+    sha256: string;
+    bytes: number;
+    createdAt: string;
+    source: {
+        runId: string;
+        eventId: string;
+    };
+    confidence: number;
+}
+export interface CheckEvidence {
+    id: string;
+    artifactId: string;
+    kind: string;
+    criteria: string[];
+    passed: boolean;
+    observedHash: string | null;
+}
+export interface TaskOutput {
+    version: 1;
+    taskId: string;
+    agentId: string;
+    status: 'success' | 'partial' | 'failed' | 'denied' | 'cancelled';
+    summary: string;
+    changedFiles: string[];
+    artifacts: CollectedArtifact[];
+    testEvidence: string[];
+    unresolvedRisks: string[];
+    recommendedNextAction: string;
+    checks: CheckEvidence[];
+}
+export type ExecutionChange = {
+    type: 'agent_routed';
+    agentId: string;
+    sessionId: string;
+    taskId?: string;
+    route: import('./routing.js').RecordedAgentRoute;
+} | {
+    type: 'proposal_validated';
+    taskId: string;
+    artifactId: string;
+    artifactHash: string;
+    goalManifestHash: string;
+    valid: boolean;
+    diagnostics: import('./types.js').PlanDiagnostic[];
+} | import('../supervision/types.js').SupervisionChange | {
+    type: 'graph_admitted';
+    admission: SpawnAdmission;
+} | {
+    type: 'started';
+    ownerId: string;
+    proposalOnly?: true;
+} | {
+    type: 'task_started';
+    taskId: string;
+    attempt: number;
+    sessionId: string;
+    requestAttribution?: 1;
+} | {
+    type: 'task_recovery_started';
+    taskId: string;
+    outcomeId: string;
+} | {
+    type: 'agent_started';
+    agentId: string;
+    taskId: string;
+} | {
+    type: 'agent_finished';
+    agentId: string;
+    taskId: string;
+    status: Exclude<TaskStatus, 'pending' | 'running'>;
+} | {
+    type: 'escalated';
+    agentId: string;
+    taskId: string;
+    target: 'stop' | 'parent' | 'human';
+} | {
+    type: 'tool';
+    taskId: string;
+    callId: string;
+    name: string;
+    path: string | null;
+    stage: 'started' | 'finished';
+    mutating: boolean;
+    success: boolean;
+} | {
+    type: 'artifact';
+    artifact: CollectedArtifact;
+} | {
+    type: 'task_finished';
+    taskId: string;
+    status: Exclude<TaskStatus, 'pending' | 'running'>;
+    output: TaskOutput;
+} | {
+    type: 'task_reset';
+    taskId: string;
+    source: 'automatic' | 'manual';
+} | {
+    type: 'task_accepted';
+    taskId: string;
+    artifactsHash: string;
+} | {
+    type: 'agent_stop';
+    agentId: string;
+} | {
+    type: 'agent_reset';
+    agentId: string;
+} | {
+    type: 'finished';
+    ownerId: string;
+    status: Exclude<ExecutionStatus, 'ready' | 'running'>;
+};
+export interface ExecutionEvent {
+    version: 1 | 2 | 3 | 4 | 5 | 6 | 7;
+    id: string;
+    runId: string;
+    sequence: number;
+    at: string;
+    previous: string;
+    change: ExecutionChange;
+    hash: string;
+}
+export interface TaskState {
+    id: string;
+    agentId: string;
+    status: TaskStatus;
+    attempts: number;
+    sessionId: string | null;
+    output: TaskOutput | null;
+    escalation: 'stop' | 'parent' | 'human' | null;
+    artifactIds: string[];
+    changedFiles: string[];
+    mutations: boolean;
+    route?: import('./routing.js').RecordedAgentRoute;
+}
+export interface ExecutionProjection {
+    version: 1 | 2 | 3 | 4 | 5 | 6;
+    runId: string;
+    revision: string;
+    status: ExecutionStatus;
+    ownerId: string | null;
+    deadline: number;
+    graph?: SpawnGraph;
+    routes?: Record<string, {
+        sessionId: string;
+        taskId?: string;
+        route: import('./routing.js').RecordedAgentRoute;
+    }>;
+    supervision?: import('../supervision/types.js').SupervisionProjection;
+    tasks: Record<string, TaskState>;
+    artifacts: Record<string, CollectedArtifact>;
+    stoppedAgents: string[];
+}
+export interface ExecutionHeader {
+    version: 1;
+    runId: string;
+    manifestHash: string;
+    approvalRevision: string;
+    createdAt: string;
+    deadline: number;
+}
+export interface ExecutionInspection {
+    header: ExecutionHeader;
+    events: ExecutionEvent[];
+    state: ExecutionProjection;
+}
+export interface ExecutionLease {
+    id: string;
+    check: () => void;
+    release: () => void;
+}
+export interface ExecutionJournal {
+    version: 1;
+    header: ExecutionHeader;
+    events: ExecutionEvent[];
+    hash: string;
+}
+export interface BoundExecution {
+    manifest: RunManifest;
+    header: ExecutionHeader;
+}
+export type RunPlanContext = Pick<RunManifest, 'id' | 'project' | 'plan'>;
+//# sourceMappingURL=coordinator-types.d.ts.map

package/dist/orchestration/coordinator-types.d.ts.map

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

package/dist/orchestration/coordinator-types.js

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

package/dist/orchestration/coordinator-types.js.map

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

package/dist/orchestration/coordinator.d.ts

@@ -0,0 +1,32 @@
+import { type RunAccounting } from './accounting.js';
+import type { ApprovalStore, ApprovalChoice } from '../approvals/index.js';
+import type { PermissionDecision } from '../runtime/types.js';
+import { type CoordinatorProgress } from './progress.js';
+export { agentPreference } from './progress.js';
+import type { RunActionOptions } from './actions.js';
+import type { ExecutionEvent, ExecutionInspection, ExecutionStatus } from './coordinator-types.js';
+export interface CoordinatorOptions extends RunActionOptions {
+    measuredInputReservation?: boolean;
+    /** Restrict this invocation to a bounded review; never start workers or apply its decision. */
+    proposalOnly?: boolean;
+    expectedDecisionId?: string;
+    expectedProposalHash?: string;
+    resume?: boolean;
+    maxOutputTokens?: number;
+    approvals?: ApprovalStore;
+    approve?: (decision: PermissionDecision, signal?: AbortSignal) => Promise<ApprovalChoice>;
+    onEvent?: (event: ExecutionEvent) => void;
+    onProgress?: (progress: CoordinatorProgress) => void;
+}
+export interface CoordinatorResult {
+    version: 2;
+    type: 'orchestration.execution';
+    runId: string;
+    status: ExecutionStatus;
+    execution: ExecutionInspection;
+    exitCode: number;
+    accounting: RunAccounting;
+}
+/** Execute the reviewed hierarchy and explicitly admitted child graphs. */
+export declare function executeReviewedRun(cwd: string, runId: string, options?: CoordinatorOptions): Promise<CoordinatorResult>;
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/orchestration/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/orchestration/coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAiBrE,OAAO,KAAK,EAAC,aAAa,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAQ5D,OAAO,EAAqC,KAAK,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAC,eAAe,EAAC,MAAM,eAAe,CAAC;AAE9C,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAC,cAAc,EAAC,mBAAmB,EAAgB,eAAe,EAAuB,MAAM,wBAAwB,CAAC;AAKpI,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,+FAA+F;IAC/F,YAAY,CAAC,EAAC,OAAO,CAAC;IAAA,kBAAkB,CAAC,EAAC,MAAM,CAAC;IAAA,oBAAoB,CAAC,EAAC,MAAM,CAAC;IAC9E,MAAM,CAAC,EAAC,OAAO,CAAC;IAAA,eAAe,CAAC,EAAC,MAAM,CAAC;IAAA,SAAS,CAAC,EAAC,aAAa,CAAC;IACjE,OAAO,CAAC,EAAC,CAAC,QAAQ,EAAC,kBAAkB,EAAC,MAAM,CAAC,EAAC,WAAW,KAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACpF,OAAO,CAAC,EAAC,CAAC,KAAK,EAAC,cAAc,KAAG,IAAI,CAAC;IACtC,UAAU,CAAC,EAAC,CAAC,QAAQ,EAAC,mBAAmB,KAAG,IAAI,CAAC;CAClD;AACD,MAAM,WAAW,iBAAiB;IAAE,OAAO,EAAC,CAAC,CAAC;IAAA,IAAI,EAAC,yBAAyB,CAAC;IAAA,KAAK,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC,eAAe,CAAC;IAAA,SAAS,EAAC,mBAAmB,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,UAAU,EAAC,aAAa,CAAA;CAAC;AAgCxL,2EAA2E;AAC3E,wBAAsB,kBAAkB,CAAC,GAAG,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,EAAC,OAAO,GAAC,kBAAqB,GAAE,OAAO,CAAC,iBAAiB,CAAC,CA8MzH"}