@calliopelabs/cli 3.0.0 → 3.2.0

package/dist/improvement/projection.js

@@ -0,0 +1,135 @@
+import { cycleMetrics } from './metrics.js';
+const ref = (e) => ({ id: e.id, hash: e.hash, at: e.at, sequence: e.sequence });
+/** Pure projection of an already validated ExecutionStore inspection; never performs work. */
+export function projectImprovementHistory(manifest, execution, context, accounting) {
+    const history = { version: 1, kind: 'improvement.history', runId: manifest.id, revision: execution.state.revision, cycles: [] };
+    const policy = context.plan.supervision;
+    if (!policy)
+        return history;
+    if (accounting?.status === 'available' && accounting.executionRevision !== execution.state.revision)
+        accounting = undefined;
+    const attributed = execution.events.some(e => 'requestAttribution' in e.change && e.change.requestAttribution === 1);
+    if (attributed) {
+        history.version = 2;
+        history.accounting = { version: 1, status: accounting?.status ?? 'unavailable', revision: accounting?.status === 'available' ? accounting.revision : null, scope: 'worker-attempts', basis: 'reservations-and-settlements' };
+    }
+    const events = new Map(), outcomes = new Map(), starts = new Map();
+    const taskCycles = new Map(), agentCycles = new Map(), previous = new Map();
+    const pending = new Map();
+    const health = new Map();
+    const tools = new Map();
+    let reviewRequest = null;
+    for (const event of execution.events) {
+        const c = event.change;
+        events.set(event.id, event);
+        if (c.type === 'started' && c.proposalOnly)
+            reviewRequest = ref(event);
+        if (c.type === 'supervision_started' && c.health)
+            health.set(`${c.round}:${c.role}`, structuredClone(c.health));
+        if (c.type === 'task_started') {
+            starts.set(c.taskId, event);
+            tools.set(c.taskId, { calls: 0, failures: 0 });
+        }
+        else if (c.type === 'tool' && c.stage === 'finished') {
+            const counts = tools.get(c.taskId);
+            if (counts) {
+                counts.calls++;
+                if (!c.success)
+                    counts.failures++;
+            }
+        }
+        else if (c.type === 'task_finished') {
+            const start = starts.get(c.taskId), count = tools.get(c.taskId), attempt = start?.change.type === 'task_started' ? start.change.attempt : 0;
+            const outcome = { taskId: c.taskId, attempt, status: c.status, event: ref(event), checks: structuredClone(c.output.checks), artifacts: structuredClone(c.output.artifacts), risks: [...c.output.unresolvedRisks],
+                durationMs: start ? Date.parse(event.at) - Date.parse(start.at) : null, toolCalls: count?.calls ?? 0, toolFailures: count?.failures ?? 0,
+                ...(attributed ? { accounting: accounting?.status === 'available' && start ? structuredClone(accounting.groups[start.id] ?? null) : null } : {}) };
+            outcomes.set(event.id, outcome);
+            for (const { cycle, attempts } of pending.values())
+                if (cycle.application && !cycle.withdrawal && attempts.get(c.taskId) === attempt && !cycle.results.some(r => r.taskId === c.taskId))
+                    cycle.results.push(outcome);
+        }
+        else if (c.type === 'task_accepted') {
+            const outcome = [...outcomes.values()].reverse().find(o => o.taskId === c.taskId);
+            if (outcome) {
+                const accepted = { ...outcome, status: 'completed', event: ref(event) };
+                outcomes.set(event.id, accepted);
+                for (const { cycle } of pending.values()) {
+                    const index = cycle.results.findIndex(r => r.event.id === outcome.event.id);
+                    if (index >= 0 && !cycle.withdrawal)
+                        cycle.results[index] = accepted;
+                }
+            }
+        }
+        else if (c.type === 'supervision_decided' && !(c.role === 'controller' && policy.reviewerId)) {
+            const decision = c.decision;
+            if (!('hypothesis' in decision)) {
+                reviewRequest = null;
+                continue;
+            }
+            const targets = decision.action === 'decompose' ? decision.children.tasks.map(t => t.id) : [decision.taskId];
+            const baseline = decision.evidence.map(id => outcomes.get(id)).filter((v) => !!v && (decision.action === 'decompose' || v.taskId === decision.taskId));
+            const parent = decision.action === 'decompose' ? agentCycles.get(decision.children.parentId) : taskCycles.get(decision.taskId);
+            const controllerHealth = health.get(`${c.round}:controller`), reviewerHealth = health.get(`${c.round}:reviewer`), providerHealth = controllerHealth ? { controller: controllerHealth, ...(reviewerHealth ? { reviewer: reviewerHealth } : {}) } : undefined;
+            const cycle = { version: providerHealth ? 3 : attributed ? 2 : 1, id: event.id, runId: manifest.id, round: c.round, principle: policy.principle, parentCycleId: parent ?? null, previousCycleId: decision.action === 'decompose' ? null : previous.get(decision.taskId) ?? null, status: 'proposed',
+                trigger: { reason: decision.reason, events: decision.evidence.map(id => ref(events.get(id))) }, hypothesis: { text: decision.hypothesis, state: 'proposed' }, proposedChange: structuredClone(decision), expectedMetric: { ...decision.expectedMetric, state: 'proposed' },
+                budget: { deadline: execution.header.deadline, limits: structuredClone(context.plan.limits), accounts: cycleAccounts(decision.action === 'decompose' ? { ...context, plan: { ...context.plan, agents: [...context.plan.agents, ...decision.children.agents.filter(a => !context.plan.agents.some(existing => existing.id === a.id))], tasks: [...context.plan.tasks, ...decision.children.tasks.filter(t => !context.plan.tasks.some(existing => existing.id === t.id))] } } : context, targets, policy.controllerId, policy.reviewerId) },
+                approval: { proposal: reviewRequest, approval: null, execution: 'pending', planHash: manifest.planHash, approvalRevision: execution.header.approvalRevision, production: 'not-approved' }, withdrawal: null, application: null, targetTaskIds: targets, baseline, results: [], metrics: [], risks: [],
+                isolation: { mode: context.plan.workspace.isolation ? 'git-worktree' : 'unavailable', image: context.plan.workspace.isolation?.image ?? null },
+                rollback: { kind: 'retained-source-and-artifacts', manifestHash: manifest.hash, baselineEvents: baseline.map(o => o.event), patches: baseline.flatMap(o => o.artifacts.filter(a => a.kind === 'patch')), productionChanged: false, baseCommit: null },
+                source: { manifestHash: manifest.hash, executionRevision: execution.state.revision, decision: ref(event) }, ...(providerHealth ? { providerHealth } : {}) };
+            history.cycles.push(cycle);
+            pending.set(cycle.id, { cycle, attempts: new Map(targets.map(id => [id, (baseline.find(o => o.taskId === id)?.attempt ?? 0) + 1])) });
+        }
+        else if (c.type === 'supervision_proposed' || c.type === 'supervision_approved') {
+            const item = pending.get(c.decisionId);
+            if (item)
+                item.cycle.approval[c.type === 'supervision_proposed' ? 'proposal' : 'approval'] = ref(event);
+        }
+        else if (c.type === 'supervision_withdrawn') {
+            reviewRequest = null;
+            const item = pending.get(c.decisionId);
+            if (item)
+                item.cycle.withdrawal = ref(event);
+        }
+        else if (c.type === 'supervision_applied') {
+            reviewRequest = null;
+            const item = pending.get(c.decisionId);
+            if (!item)
+                continue;
+            const cycle = item.cycle;
+            cycle.application = ref(event);
+            cycle.approval.execution = 'reviewed-policy';
+            if (cycle.proposedChange.action === 'decompose') {
+                for (const task of cycle.proposedChange.children.tasks)
+                    taskCycles.set(task.id, cycle.id);
+                for (const agent of cycle.proposedChange.children.agents)
+                    agentCycles.set(agent.id, cycle.id);
+            }
+            else
+                previous.set(cycle.proposedChange.taskId, cycle.id);
+        }
+    }
+    for (const cycle of history.cycles) {
+        if (cycle.application) {
+            const complete = cycle.results.length === cycle.targetTaskIds.length;
+            cycle.status = complete ? (cycle.results.every(r => r.status === 'completed') ? 'verified' : cycle.results.some(r => r.status === 'cancelled') ? 'cancelled' : cycle.results.some(r => ['failed', 'denied', 'unknown'].includes(r.status)) ? 'failed' : 'partial')
+                : execution.state.status === 'cancelled' ? 'cancelled' : execution.state.status === 'running' ? 'running' : 'partial';
+        }
+        if (cycle.withdrawal)
+            cycle.status = 'withdrawn';
+        cycle.metrics = cycleMetrics(cycle.baseline, cycle.results, cycle.targetTaskIds);
+        cycle.risks = [...new Set([...cycle.baseline, ...cycle.results].flatMap(o => o.risks))];
+    }
+    if (history.cycles.some(cycle => cycle.version === 3))
+        history.version = 3;
+    return history;
+}
+function cycleAccounts(context, targets, controller, reviewer) {
+    const ids = new Set([controller, ...(reviewer ? [reviewer] : []), ...context.plan.tasks.filter(t => targets.includes(t.id)).map(t => t.agentId)]);
+    for (let i = 0; i < context.plan.agents.length; i++)
+        for (const agent of context.plan.agents)
+            if (ids.has(agent.id) && agent.parentId)
+                ids.add(agent.parentId);
+    return context.plan.agents.filter(a => ids.has(a.id)).map(({ id, parentId, tokenBudget, costBudgetUsd, timeBudgetMs, maxChildDepth, maxChildCount, allowedTools, allowedPaths }) => ({ id, parentId, tokenBudget, costBudgetUsd, timeBudgetMs, maxChildDepth, maxChildCount, allowedTools: [...allowedTools], allowedPaths: structuredClone(allowedPaths) }));
+}
+//# sourceMappingURL=projection.js.map

package/dist/improvement/projection.js.map

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

package/dist/improvement/types.d.ts

@@ -0,0 +1,115 @@
+import type { CollectedArtifact, CheckEvidence, TaskStatus } from '../orchestration/coordinator-types.js';
+import type { ProjectPlan } from '../orchestration/types.js';
+import type { OptimizationPrinciple, SupervisionDecision } from '../supervision/types.js';
+export interface CycleEventRef {
+    id: string;
+    hash: string;
+    at: string;
+    sequence: number;
+}
+export interface CycleOutcome {
+    taskId: string;
+    attempt: number;
+    status: Exclude<TaskStatus, 'pending' | 'running'>;
+    event: CycleEventRef;
+    checks: CheckEvidence[];
+    artifacts: CollectedArtifact[];
+    risks: string[];
+    durationMs: number | null;
+    toolCalls: number;
+    toolFailures: number;
+    accounting?: import('../orchestration/request-accounting.js').AttributedCharge | null;
+}
+export interface CycleMetric {
+    name: 'acceptance-check-pass-rate' | 'attempt-duration' | 'tool-failure-rate' | 'provider-accounted-cost';
+    unit: 'ratio' | 'ms' | 'nano-usd';
+    before: number | null;
+    after: number | null;
+    delta: number | null;
+    comparable: boolean;
+    reason: string;
+    direction: 'increase' | 'decrease';
+}
+/** Derived from validated append-only execution and request histories at named revisions. */
+export interface ImprovementCycle {
+    version: 1 | 2 | 3;
+    id: string;
+    runId: string;
+    round: number;
+    principle: OptimizationPrinciple;
+    parentCycleId: string | null;
+    previousCycleId: string | null;
+    status: 'proposed' | 'running' | 'verified' | 'failed' | 'partial' | 'cancelled' | 'withdrawn';
+    trigger: {
+        reason: string;
+        events: CycleEventRef[];
+    };
+    hypothesis: {
+        text: string;
+        state: 'proposed';
+    };
+    proposedChange: Extract<SupervisionDecision, {
+        action: 'retry' | 'replan' | 'decompose';
+    }>;
+    expectedMetric: {
+        name: string;
+        direction: 'increase' | 'decrease';
+        state: 'proposed';
+    };
+    budget: {
+        deadline: number;
+        limits: ProjectPlan['limits'];
+        accounts: Pick<ProjectPlan['agents'][number], 'id' | 'parentId' | 'tokenBudget' | 'costBudgetUsd' | 'timeBudgetMs' | 'maxChildDepth' | 'maxChildCount' | 'allowedTools' | 'allowedPaths'>[];
+    };
+    approval: {
+        proposal: CycleEventRef | null;
+        approval: CycleEventRef | null;
+        execution: 'reviewed-policy' | 'pending';
+        planHash: string;
+        approvalRevision: string;
+        production: 'not-approved';
+    };
+    withdrawal: CycleEventRef | null;
+    application: CycleEventRef | null;
+    targetTaskIds: string[];
+    baseline: CycleOutcome[];
+    results: CycleOutcome[];
+    metrics: CycleMetric[];
+    risks: string[];
+    isolation: {
+        mode: 'git-worktree' | 'unavailable';
+        image: string | null;
+    };
+    rollback: {
+        kind: 'retained-source-and-artifacts';
+        manifestHash: string;
+        baselineEvents: CycleEventRef[];
+        patches: CollectedArtifact[];
+        productionChanged: false;
+        baseCommit: string | null;
+    };
+    source: {
+        manifestHash: string;
+        executionRevision: string;
+        decision: CycleEventRef;
+    };
+    providerHealth?: {
+        controller: import('../supervision/types.js').SupervisionHealthEvidence;
+        reviewer?: import('../supervision/types.js').SupervisionHealthEvidence;
+    };
+}
+export interface ImprovementHistory {
+    version: 1 | 2 | 3;
+    kind: 'improvement.history';
+    runId: string;
+    revision: string;
+    cycles: ImprovementCycle[];
+    accounting?: {
+        version: 1;
+        status: 'available' | 'unavailable';
+        revision: string | null;
+        scope: 'worker-attempts';
+        basis: 'reservations-and-settlements';
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/improvement/types.js

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

package/dist/improvement/types.js.map

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

package/dist/index.d.ts

@@ -13,8 +13,11 @@ export { runSetup, reconfigure } from './setup.js';
 export { getVersion, checkForUpdates, getLatestVersion, performUpgrade } from './version-check.js';
 export { selectModelInteractively, getAvailableModels, clearModelCache, getModelInfo, getModelContextLimit, preWarmModelCache } from './model-detection.js';
 export type { ModelInfo } from './model-detection.js';
+export { selectRoute, formatRoutingDecision, RoutingUnavailableError } from './routing/index.js';
+export type { RoutingDecision, RoutingRequest, RoutingPreferences, RoutingRequirements, RouteCandidate } from './routing/index.js';
 export { getCurrentSkin, getPalette, applyPalette, getCurrentPalette, getBoxChars, getSpinnerFrames, getPaletteColor, paletteColorize, getInkColor, getInkBorderStyle, clearHUDCache, } from './hud/api.js';
 export type { Skin, Palette, PaletteColors, SemanticColorKey, BoxChars, HUDConfig } from './hud/types.js';
 export { runHeadless } from './headless.js';
 export type { HeadlessEvent, HeadlessOptions, HeadlessOutputMode } from './headless.js';
+export * from './runtime/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,SAAS,EACT,GAAG,EACH,GAAG,EACH,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,SAAS,EACT,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5J,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EACL,cAAc,EACd,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAC3C,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAC/D,WAAW,EAAE,iBAAiB,EAC9B,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG1G,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,SAAS,EACT,GAAG,EACH,GAAG,EACH,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,SAAS,EACT,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5J,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACjG,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGnI,OAAO,EACL,cAAc,EACd,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAC3C,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAC/D,WAAW,EAAE,iBAAiB,EAC9B,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG1G,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxF,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -13,8 +13,11 @@ export * from './types.js';
 export { runSetup, reconfigure } from './setup.js';
 export { getVersion, checkForUpdates, getLatestVersion, performUpgrade } from './version-check.js';
 export { selectModelInteractively, getAvailableModels, clearModelCache, getModelInfo, getModelContextLimit, preWarmModelCache } from './model-detection.js';
+export { selectRoute, formatRoutingDecision, RoutingUnavailableError } from './routing/index.js';
 // HUD system
 export { getCurrentSkin, getPalette, applyPalette, getCurrentPalette, getBoxChars, getSpinnerFrames, getPaletteColor, paletteColorize, getInkColor, getInkBorderStyle, clearHUDCache, } from './hud/api.js';
 // Headless renderer
 export { runHeadless } from './headless.js';
+// Shared runtime for terminal, editor and programmatic clients.
+export * from './runtime/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+DAA+D;AAC/D,OAAO,EACL,SAAS,EACT,GAAG,EACH,GAAG,EACH,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,SAAS,EACT,UAAU,GAEX,MAAM,aAAa,CAAC;AACrB,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG5J,aAAa;AACb,OAAO,EACL,cAAc,EACd,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAC3C,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAC/D,WAAW,EAAE,iBAAiB,EAC9B,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+DAA+D;AAC/D,OAAO,EACL,SAAS,EACT,GAAG,EACH,GAAG,EACH,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,SAAS,EACT,UAAU,GAEX,MAAM,aAAa,CAAC;AACrB,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE5J,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGjG,aAAa;AACb,OAAO,EACL,cAAc,EACd,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAC3C,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAC/D,WAAW,EAAE,iBAAiB,EAC9B,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,gEAAgE;AAChE,cAAc,oBAAoB,CAAC"}

package/dist/instructions.d.ts

@@ -0,0 +1,10 @@
+export interface RepositoryInstruction {
+    path: string;
+    scope: string;
+    content: string;
+}
+/** Bound prompt growth without silently discarding controlling instructions. */
+export declare const MAX_INSTRUCTION_BYTES: number;
+export declare function loadRepositoryInstructions(directory: string): RepositoryInstruction[];
+export declare function formatRepositoryInstructions(instructions: RepositoryInstruction[]): string;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAE/C,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,EAAE,CA6DrF;AAED,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAW1F"}

package/dist/instructions.js

@@ -0,0 +1,93 @@
+/** Repository instructions, scoped to trusted directories inside one checkout. */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { checkTrust } from './trust.js';
+/** Bound prompt growth without silently discarding controlling instructions. */
+export const MAX_INSTRUCTION_BYTES = 64 * 1024;
+export function loadRepositoryInstructions(directory) {
+    let cwd;
+    try {
+        cwd = fs.realpathSync(directory);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    const ancestry = [];
+    let current = cwd;
+    while (true) {
+        ancestry.unshift(current);
+        if (fs.existsSync(path.join(current, '.git')))
+            break;
+        const parent = path.dirname(current);
+        if (parent === current) {
+            // Outside a checkout, only the explicitly selected directory is in scope.
+            ancestry.splice(0, ancestry.length, cwd);
+            break;
+        }
+        current = parent;
+    }
+    let trustedRoot;
+    const instructions = [];
+    let bytes = 0;
+    for (const scope of ancestry) {
+        const trust = checkTrust(scope);
+        // An explicit refusal blocks inheritance into that subtree.
+        if (!trust.trusted && trust.reason === 'Project explicitly untrusted.')
+            return [];
+        if (trust.trusted && !trustedRoot)
+            trustedRoot = scope;
+        if (!trustedRoot)
+            continue;
+        const source = path.join(scope, 'AGENTS.md');
+        let resolved;
+        try {
+            resolved = fs.realpathSync(source);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                continue;
+            throw new Error(`Cannot load repository instructions at ${source}`, { cause: error });
+        }
+        const relative = path.relative(trustedRoot, resolved);
+        if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+            throw new Error(`Repository instructions at ${source} point outside the trusted scope ${trustedRoot}`);
+        }
+        // Symlinks cannot import rules from an explicitly refused subtree.
+        for (let target = path.dirname(resolved);; target = path.dirname(target)) {
+            const targetTrust = checkTrust(target);
+            if (!targetTrust.trusted && targetTrust.reason === 'Project explicitly untrusted.') {
+                throw new Error(`Repository instructions at ${source} point into an explicitly untrusted directory: ${target}`);
+            }
+            if (target === trustedRoot)
+                break;
+        }
+        const stat = fs.statSync(resolved);
+        if (!stat.isFile())
+            throw new Error(`Repository instructions must be a regular file: ${source}`);
+        if (bytes + stat.size > MAX_INSTRUCTION_BYTES) {
+            throw new Error(`Repository instructions exceed ${MAX_INSTRUCTION_BYTES} bytes at ${source}. Shorten the applicable AGENTS.md files; instructions were not truncated.`);
+        }
+        const content = fs.readFileSync(resolved, 'utf8');
+        bytes += Buffer.byteLength(content);
+        if (bytes > MAX_INSTRUCTION_BYTES)
+            throw new Error(`Repository instructions grew beyond ${MAX_INSTRUCTION_BYTES} bytes while reading ${source}; retry after shortening them.`);
+        instructions.push({ path: source, scope, content });
+    }
+    return instructions;
+}
+export function formatRepositoryInstructions(instructions) {
+    if (instructions.length === 0)
+        return '';
+    return [
+        'Repository instructions (AGENTS.md):',
+        'These instructions take precedence over conflicting project reference context. More specific directory instructions take precedence within their own subtree. User instructions and runtime policy retain priority.',
+        'Only the checkout-to-working-directory chain is loaded here. Before working in a deeper directory, read its applicable AGENTS.md files. Do not apply sibling directory instructions.',
+        ...instructions.flatMap(instruction => [
+            `--- Instructions: ${instruction.path} (scope: ${instruction.scope}) ---`,
+            instruction.content,
+        ]),
+    ].join('\n\n');
+}
+//# sourceMappingURL=instructions.js.map

package/dist/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQxC,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE/C,MAAM,UAAU,0BAA0B,CAAC,SAAiB;IAC1D,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QAAC,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAAC,CAAC;IACzC,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAClE,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,OAAO,IAAI,EAAE,CAAC;QACZ,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAAE,MAAM;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,0EAA0E;YAC1E,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACzC,MAAM;QACR,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,IAAI,WAA+B,CAAC;IACpC,MAAM,YAAY,GAA4B,EAAE,CAAC;IACjD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,4DAA4D;QAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,+BAA+B;YAAE,OAAO,EAAE,CAAC;QAClF,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,WAAW;YAAE,WAAW,GAAG,KAAK,CAAC;QACvD,IAAI,CAAC,WAAW;YAAE,SAAS;QAE3B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC7C,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YAAC,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAAC,CAAC;QAC3C,OAAO,KAAK,EAAE,CAAC;YACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YACjE,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3F,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,oCAAoC,WAAW,EAAE,CAAC,CAAC;QACzG,CAAC;QACD,mEAAmE;QACnE,KAAK,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1E,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,MAAM,KAAK,+BAA+B,EAAE,CAAC;gBACnF,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,kDAAkD,MAAM,EAAE,CAAC,CAAC;YAClH,CAAC;YACD,IAAI,MAAM,KAAK,WAAW;gBAAE,MAAM;QACpC,CAAC;QACD,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,MAAM,EAAE,CAAC,CAAC;QACjG,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,qBAAqB,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,kCAAkC,qBAAqB,aAAa,MAAM,4EAA4E,CAAC,CAAC;QAC1K,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClD,KAAK,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,KAAK,GAAG,qBAAqB;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,qBAAqB,wBAAwB,MAAM,gCAAgC,CAAC,CAAC;QAC/K,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,YAAqC;IAChF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACzC,OAAO;QACL,sCAAsC;QACtC,qNAAqN;QACrN,sLAAsL;QACtL,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,qBAAqB,WAAW,CAAC,IAAI,YAAY,WAAW,CAAC,KAAK,OAAO;YACzE,WAAW,CAAC,OAAO;SACpB,CAAC;KACH,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC"}

package/dist/isolation/contracts.d.ts

@@ -0,0 +1,42 @@
+import type { ProjectPlan, ProjectTask } from '../orchestration/types.js';
+export interface WorktreeIsolation {
+    version: 1;
+    image: string;
+}
+export interface VerificationCommand {
+    artifactId: string;
+    argv: string[];
+    timeoutMs: number;
+}
+export interface TaskIsolation {
+    patchArtifactId: string;
+    commands: VerificationCommand[];
+}
+export interface CommandEvidence {
+    version: 1;
+    kind: 'isolated-command';
+    argv: string[];
+    image: string;
+    exitCode: number;
+    outcome: 'passed' | 'failed' | 'cancelled' | 'timeout' | 'unavailable';
+    stdout: string;
+    stderr: string;
+    truncated: boolean;
+    durationMs: number;
+    container: string;
+    cleanupConfirmed: boolean;
+    cleanup?: {
+        version: 1;
+        removal: {
+            outcome: 'removed' | 'absent' | 'timeout' | 'error';
+            exitCode: number | null;
+        };
+        verification?: {
+            outcome: 'absent' | 'present' | 'timeout' | 'error';
+            exitCode: number | null;
+        };
+    };
+}
+export declare function validateIsolation(value: unknown): asserts value is WorktreeIsolation;
+export declare function validateTaskIsolation(value: unknown, task: ProjectTask, plan: ProjectPlan): asserts value is TaskIsolation;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/isolation/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/isolation/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG1E,MAAM,WAAW,iBAAiB;IAAG,OAAO,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAChE,MAAM,WAAW,mBAAmB;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC9F,MAAM,WAAW,aAAa;IAAG,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAA;CAAE;AAC3F,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;IACzF,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IACvE,SAAS,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAC;IAC7C,OAAO,CAAC,EAAE;QAAC,OAAO,EAAC,CAAC,CAAC;QAAA,OAAO,EAAC;YAAC,OAAO,EAAC,SAAS,GAAC,QAAQ,GAAC,SAAS,GAAC,OAAO,CAAC;YAAA,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAA;SAAC,CAAC;QAC/F,YAAY,CAAC,EAAC;YAAC,OAAO,EAAC,QAAQ,GAAC,SAAS,GAAC,SAAS,GAAC,OAAO,CAAC;YAAA,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAA;SAAC,CAAA;KAAC,CAAC;CACtF;AACD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,iBAAiB,CAIpF;AACD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAe1H"}

package/dist/isolation/contracts.js

@@ -0,0 +1,33 @@
+import { array, fail, integer, shape, text, id } from '../orchestration/validation.js';
+export function validateIsolation(value) {
+    shape(value, ['version', 'image']);
+    if (value.version !== 1 || typeof value.image !== 'string' || !/^sha256:[a-f0-9]{64}$/.test(value.image))
+        fail('Isolated workers require version 1 and a pinned local Docker image ID (sha256:...).');
+}
+export function validateTaskIsolation(value, task, plan) {
+    shape(value, ['patchArtifactId', 'commands']);
+    id(value.patchArtifactId);
+    array(value.commands, 8);
+    const agent = plan.agents.find(a => a.id === task.agentId);
+    const output = (name, kind) => task.outputs.some(o => o.id === name && o.kind === kind && o.path === undefined);
+    if (!output(value.patchArtifactId, 'patch'))
+        fail('An isolated task requires a declared patch artifact without a project path.');
+    const seen = new Set();
+    for (const command of value.commands) {
+        shape(command, ['artifactId', 'argv', 'timeoutMs']);
+        id(command.artifactId);
+        array(command.argv, 64, 1);
+        command.argv.forEach(arg => text(arg, 8192));
+        if (command.argv.some(arg => String(arg).includes('\n')) || String(command.argv[0]).startsWith('-') ||
+            !output(command.artifactId, 'test_result') || seen.has(command.artifactId))
+            fail('Invalid verification command or result artifact.');
+        seen.add(command.artifactId);
+        integer(command.timeoutMs, 1, Math.min(60000, agent.timeBudgetMs));
+    }
+    if (value.commands.length && !agent.allowedTools.includes('shell'))
+        fail('Verification commands require inherited shell authority.');
+    for (const grant of agent.allowedPaths)
+        if (grant.path.split('/').some(p => p.toLowerCase() === '.git'))
+            fail('Git metadata cannot be granted to isolated workers.');
+}
+//# sourceMappingURL=contracts.js.map

package/dist/isolation/contracts.js.map

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

package/dist/isolation/coordinator.d.ts

@@ -0,0 +1,10 @@
+import { type ProjectTask } from '../orchestration/types.js';
+import type { RunActionOptions } from '../orchestration/actions.js';
+import type { ExecutionStore } from '../orchestration/execution-store.js';
+import type { ExecutionGuard } from '../execution/guard.js';
+import { type WorkerWorktree } from './worktree.js';
+export declare function taskWorktree(store: ExecutionStore, task: ProjectTask, options: RunActionOptions): Promise<WorkerWorktree | undefined>;
+export declare function verifyInWorktree(store: ExecutionStore, task: ProjectTask, workspace: WorkerWorktree, guard: ExecutionGuard, options: RunActionOptions & {
+    expectedWorkspaceHash?: string;
+}): Promise<Map<string, string>>;
+//# sourceMappingURL=coordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/isolation/coordinator.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAyC,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAG3F,wBAAsB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAoB3I;AACD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,GAAC;IAAC,qBAAqB,CAAC,EAAC,MAAM,CAAA;CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwB1N"}