@mcoda/codali 0.1.133 → 0.1.135-codali.2

package/config/terminal-long-scenarios.v1.json

@@ -0,0 +1,70 @@
+{
+  "schemaVersion": 1,
+  "corpusId": "codali-terminal-long-v1",
+  "kind": "deterministic-fault-coverage",
+  "liveModelQualification": "separate; not established by these fixtures",
+  "scenarios": [
+    {
+      "id": "L01-goal-continuity",
+      "invariant": "Original intent and mandatory criteria survive five compactions and two real process restarts.",
+      "test": "eval/__tests__/TerminalRecoveryJourney.test.ts"
+    },
+    {
+      "id": "L02-requirement-coverage",
+      "invariant": "Missing criteria, orphan tasks and cyclic dependencies cannot replace an accepted plan.",
+      "test": "session/__tests__/WorkState.test.ts"
+    },
+    {
+      "id": "L03-architecture-supersession",
+      "invariant": "A superseded decision fences affected and transitive dependent work while retaining its history.",
+      "test": "session/__tests__/WorkState.test.ts"
+    },
+    {
+      "id": "L04-dependency-ordering",
+      "invariant": "Tasks and phases cannot start before prerequisites are verified, including after restart.",
+      "test": "eval/__tests__/TerminalRecoveryJourney.test.ts"
+    },
+    {
+      "id": "L05-scope-and-user-edits",
+      "invariant": "Pre-existing and concurrent user edits survive bounded writes, cancellation and recovery.",
+      "tests": ["runtime/__tests__/WorkspaceLedger.test.ts", "runtime/__tests__/SessionController.test.ts", "eval/__tests__/TerminalRecoveryJourney.test.ts"]
+    },
+    {
+      "id": "L06-bad-helper-handoff",
+      "invariant": "Invented helper sources are rejected; a poisoned transcript cannot cancel canonical criteria.",
+      "test": "eval/__tests__/TerminalRecoveryJourney.test.ts"
+    },
+    {
+      "id": "L07-stale-evidence",
+      "invariant": "Changed source invalidates acceptance and reopens affected downstream work, including completed goals.",
+      "tests": ["session/__tests__/WorkState.test.ts", "runtime/__tests__/StructuralEvidence.test.ts"]
+    },
+    {
+      "id": "L08-premature-completion",
+      "invariant": "Missing receipts, skipped verification and an unsupported completion claim cannot finish the goal.",
+      "tests": ["runtime/__tests__/SessionController.test.ts", "eval/__tests__/TerminalRecoveryJourney.test.ts"]
+    },
+    {
+      "id": "L09-steering-and-ownership",
+      "invariant": "User steering adds required work and fences previous attempts without erasing the original objective.",
+      "test": "eval/__tests__/TerminalRecoveryJourney.test.ts"
+    },
+    {
+      "id": "L10-duplicate-delivery",
+      "invariant": "Duplicate project handoff or media admission recovery cannot create duplicate accepted work.",
+      "tests": ["runtime/__tests__/SessionController.test.ts", "connectors/media/__tests__/RemoteMediaJob.test.ts"],
+      "serverTests": ["/srv/mswarm/tests/durable-media.test.ts", "/srv/mswarm/tests/openai-proxy.test.ts"]
+    },
+    {
+      "id": "L11-stalls-and-cancellation",
+      "invariant": "Expired leases, unavailable services, interrupted status reads and process descendants have bounded outcomes.",
+      "tests": ["session/__tests__/WorkState.test.ts", "tools/shell/__tests__/AsyncProcess.test.ts", "connectors/media/__tests__/RemoteMediaJob.test.ts"]
+    },
+    {
+      "id": "L12-media-crash-boundaries",
+      "invariant": "Lost admission or acknowledgement, corrupt payloads and incomplete local receipts never silently resubmit or claim success.",
+      "tests": ["connectors/media/__tests__/RemoteMediaJob.test.ts", "connectors/media/__tests__/MediaJobStore.test.ts"],
+      "remainingLiveCase": "Mixed code/media journey against the deployed durable API, including server expiry and tenant isolation."
+    }
+  ]
+}

package/dist/agents/RoleResolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RoleResolution.d.ts","sourceRoot":"","sources":["../../src/agents/RoleResolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EAClC,MAAM,iCAAiC,CAAC;AAKzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,sBAAsB,GAC9B,cAAc,GACd,QAAQ,GACR,aAAa,GACb,OAAO,CAAC;AAuBZ,wEAAwE;AACxE,eAAO,MAAM,eAAe,EAAE,sBAAsB,EAInD,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,mBAAmB,CAAC;IAChC,8DAA8D;IAC9D,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,4BAA4B,CAAC,CAAC,CAAC;IACnF,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,4BAA4B,CAAC;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAmFD,eAAO,MAAM,wBAAwB,GACnC,OAAO,mBAAmB,KACzB,oBA8FF,CAAC"}
+{"version":3,"file":"RoleResolution.d.ts","sourceRoot":"","sources":["../../src/agents/RoleResolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EAClC,MAAM,iCAAiC,CAAC;AAKzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,sBAAsB,GAC9B,cAAc,GACd,QAAQ,GACR,aAAa,GACb,OAAO,CAAC;AAuBZ,wEAAwE;AACxE,eAAO,MAAM,eAAe,EAAE,sBAAsB,EAInD,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,mBAAmB,CAAC;IAChC,8DAA8D;IAC9D,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,4BAA4B,CAAC,CAAC,CAAC;IACnF,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,4BAA4B,CAAC;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAmFD,eAAO,MAAM,wBAAwB,GACnC,OAAO,mBAAmB,KACzB,oBA4FF,CAAC"}

package/dist/agents/RoleResolution.js

@@ -153,13 +153,13 @@ export const resolveConfigurableRoles = (input) => {
             continue;
         warnings.push(`agent_resolution_error:${error.code}${error.role ? `:${error.role}` : ""}`);
     }
-    const toolCapable = findToolCapableAssignment(resolution, 
-    // An explicitly bound worker wins; otherwise fall back to the orchestrator.
-    assignments.worker ?? assignments.orchestrator);
+    // An explicitly bound worker wins; otherwise prefer the orchestrator.
+    const preferredToolWorker = assignments.worker ?? assignments.orchestrator;
+    const toolCapable = findToolCapableAssignment(resolution, preferredToolWorker);
     if (!toolCapable) {
         warnings.push("no_tool_capable_agent");
     }
-    else if (toolCapable !== assignments.orchestrator) {
+    else if (toolCapable !== preferredToolWorker) {
         warnings.push(`tool_worker_substituted:${toolCapable.candidate.slug}`);
     }
     return { resolution, assignments, bindings: bindingsOut, toolCapable, warnings };

package/dist/api/CodaliApi.d.ts

@@ -1,3 +1,6 @@
+import type { EffortLevel, ResolvedOrchestrationConfig } from "../config/OrchestrationConfig.js";
+import { type ScopedModelUsage } from "../providers/ConfiguredModelScope.js";
+import type { ModelCallerContext, ModelInvocation } from "../providers/ConfiguredProvider.js";
 import { attachMcpTools } from "../connectors/mcp/McpToolSource.js";
 import { type ImageGenerationConfig } from "../connectors/media/ImageGenerationTool.js";
 import { createProviderForAssignment } from "../gateway/LocalGatewayProvider.js";
@@ -80,6 +83,12 @@ export interface CodaliToolCallRecord {
     errorCode?: string;
 }
 export interface CodaliResult {
+    orchestration?: {
+        configHash: string;
+        usage: ScopedModelUsage;
+        toolCalls: number;
+        routes: ModelInvocation[];
+    };
     status: CodaliGatewayStatus;
     /** Text answer, or the clarifying question when status is needs_clarification. */
     answer: string;
@@ -104,6 +113,13 @@ export interface CodaliResult {
 /** Flattens a message list into the single query the gateway plans against. */
 export declare const messagesToQuery: (messages: readonly CodaliMessage[]) => string;
 export interface CodaliRunDependencies {
+    /** Trusted host policy, never copied from a tenant's request payload. */
+    orchestration?: {
+        resolved: ResolvedOrchestrationConfig;
+        effort?: EffortLevel;
+        caller?: ModelCallerContext;
+    };
+    signal?: AbortSignal;
     loadInventory?: typeof getAgentInventory;
     resolveRunContext?: (workspaceRoot: string) => Promise<RunContext>;
     buildRegistry?: (workspaceRoot: string, context: RunContext) => ToolRegistry;

package/dist/api/CodaliApi.d.ts.map

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

package/dist/api/CodaliApi.js

@@ -1,4 +1,5 @@
 import { randomUUID } from "node:crypto";
+import { ConfiguredModelScope } from "../providers/ConfiguredModelScope.js";
 import { attachHttpTools } from "../connectors/http/HttpToolSource.js";
 import { attachMcpTools } from "../connectors/mcp/McpToolSource.js";
 import { createImageGenerationTool, } from "../connectors/media/ImageGenerationTool.js";
@@ -62,6 +63,27 @@ const toolCallRecords = (tracer) => tracer.snapshot().toolCalls.map((call) => ({
  * The same code path the CLI uses, so a product and the terminal cannot drift.
  */
 export const runCodali = async (request, deps = {}) => {
+    if (!deps.orchestration)
+        return runCodaliWithinScope(request, deps);
+    if (deps.createProvider)
+        throw new Error("Configured Codali API cannot accept a legacy provider override");
+    if (request.media)
+        throw new Error("Configured Codali API media must be registered by the host using approved bindings; request media overrides are not allowed");
+    const routes = [];
+    const scope = new ConfiguredModelScope(deps.orchestration.resolved, { effort: deps.orchestration.effort, signal: deps.signal, caller: deps.orchestration.caller,
+        onEvent: event => { if (event.type === "intent" && event.route)
+            routes.push(event.route); } });
+    try {
+        for (const binding of ["planner", "synthesizer", "worker"])
+            scope.models(binding);
+        const result = await runCodaliWithinScope(request, deps, scope);
+        return { ...result, orchestration: { configHash: scope.configHash, usage: scope.snapshot(), toolCalls: scope.toolsUsed, routes } };
+    }
+    finally {
+        scope.close();
+    }
+};
+const runCodaliWithinScope = async (request, deps, scope) => {
     const workspaceRoot = request.workspaceRoot ?? process.cwd();
     const query = messagesToQuery(request.messages);
     const tracer = new GatewayTracer(query);
@@ -106,7 +128,7 @@ export const runCodali = async (request, deps = {}) => {
     const context = resolvedContext;
     for (const warning of context.warnings ?? [])
         tracer.addWarning(warning);
-    const inventory = await (deps.loadInventory ?? getAgentInventory)();
+    const inventory = scope ? { agents: [], warnings: [] } : await (deps.loadInventory ?? getAgentInventory)();
     const drivable = filterLocallyDrivable(inventory.agents);
     const roles = resolveConfigurableRoles({
         inventory: drivable,
@@ -117,7 +139,7 @@ export const runCodali = async (request, deps = {}) => {
         tracer.addWarning(warning);
     const orchestrator = roles.assignments.orchestrator;
     const synthesizer = roles.assignments.synthesizer;
-    if (!orchestrator && !synthesizer) {
+    if (!scope && !orchestrator && !synthesizer) {
         return {
             status: "failed",
             answer: "No usable model agent could be resolved for this run.",
@@ -139,10 +161,10 @@ export const runCodali = async (request, deps = {}) => {
     const clientProduct = resolveMswarmClientProduct(context.tenant?.product);
     const baseProvider = deps.createProvider ?? createProviderForAssignment;
     const makeProvider = (assignment, options) => baseProvider(assignment, { clientIdentity, clientProduct, ...options });
-    const primary = makeProvider((synthesizer ?? orchestrator));
-    const orchestratorProvider = orchestrator ? makeProvider(orchestrator) : undefined;
+    const primary = scope ? scope.provider("synthesizer") : makeProvider((synthesizer ?? orchestrator));
+    const orchestratorProvider = scope ? scope.provider("planner") : orchestrator ? makeProvider(orchestrator) : undefined;
     const workerCandidates = [roles.toolCapable, orchestrator, synthesizer].filter(Boolean);
-    let worker = primary;
+    let worker = scope ? scope.provider("worker") : primary;
     for (const candidate of workerCandidates) {
         const provider = makeProvider(candidate);
         if (providerSupportsToolCalls(provider)) {
@@ -153,7 +175,7 @@ export const runCodali = async (request, deps = {}) => {
     const toolsExecutable = providerSupportsToolCalls(worker);
     const min = (a, b) => (b === undefined ? a : Math.min(a, b));
     // ---- Tools ------------------------------------------------------------
-    const registry = deps.buildRegistry?.(workspaceRoot, context) ?? buildDefaultRegistry(workspaceRoot, context);
+    const registry = deps.buildRegistry?.(workspaceRoot, context) ?? buildDefaultRegistry(workspaceRoot, context, scope);
     const mcp = await (deps.attachMcp ?? attachMcpTools)({ context, toolRegistry: registry });
     for (const warning of mcp.warnings)
         tracer.addWarning(warning);
@@ -184,7 +206,7 @@ export const runCodali = async (request, deps = {}) => {
     // A run with no tool budget is a run without tools. Offering them anyway
     // produced tasks that could not execute, and a failed job where the honest
     // outcome was an answer given without them.
-    const toolBudget = min(request.budgets?.maxToolCalls ?? DEFAULTS.maxToolCalls, context.limits?.maxToolCalls);
+    const toolBudget = Math.min(scope?.budget().maxToolCalls ?? Infinity, min(request.budgets?.maxToolCalls ?? DEFAULTS.maxToolCalls, context.limits?.maxToolCalls));
     const allowedTools = toolsExecutable && toolBudget > 0
         ? (context.allowedTools ?? defaultAllowed).filter((tool) => registered.includes(tool))
         : [];
@@ -205,8 +227,9 @@ export const runCodali = async (request, deps = {}) => {
     // ---- Budgets ----------------------------------------------------------
     const maxRounds = min(request.budgets?.maxRounds ?? DEFAULTS.maxRounds, context.limits?.maxRounds);
     const maxToolCalls = toolBudget;
-    const deadlineMs = min(request.budgets?.deadlineMs ?? DEFAULTS.deadlineMs, context.limits?.deadlineMs);
+    const deadlineMs = Math.min(scope?.budget().timeoutMs ?? Infinity, min(request.budgets?.deadlineMs ?? DEFAULTS.deadlineMs, context.limits?.deadlineMs));
     const gatewayRequest = {
+        metadata: scope ? { orchestration: { configHash: scope.configHash, effort: scope.effort, scopeId: scope.id } } : undefined,
         id: runId,
         query,
         mode: request.mode ?? "balanced",
@@ -227,7 +250,7 @@ export const runCodali = async (request, deps = {}) => {
             maxIterations: maxRounds,
             maxRuntimeMs: deadlineMs,
             maxToolCalls,
-            maxModelCalls: request.budgets?.maxModelCalls ?? DEFAULTS.maxModelCalls,
+            maxModelCalls: Math.min(request.budgets?.maxModelCalls ?? DEFAULTS.maxModelCalls, scope?.budget().maxModelCalls ?? Infinity),
             maxEvidenceItems: 40,
             maxImageArtifacts: request.media ? 4 : 0,
             maxContextPackTokens: 16000,
@@ -257,6 +280,8 @@ export const runCodali = async (request, deps = {}) => {
             provider: worker,
             registry,
             toolContext: {
+                signal: scope?.signal ?? deps.signal,
+                beforeTool: scope ? async () => scope.reserveTool() : undefined,
                 workspaceRoot,
                 allowShell: false,
                 allowDestructiveOperations: false,
@@ -286,6 +311,7 @@ export const runCodali = async (request, deps = {}) => {
     });
     try {
         const result = await gateway.run(gatewayRequest);
+        scope?.signal.throwIfAborted();
         return {
             status: result.status,
             answer: result.answer,
@@ -322,9 +348,12 @@ export const runCodali = async (request, deps = {}) => {
         await mcp.registry?.close();
     }
 };
-const buildDefaultRegistry = (workspaceRoot, context) => {
+const buildDefaultRegistry = (workspaceRoot, context, scope) => {
     const registry = new ToolRegistry();
     const client = new DocdexClient({
+        signal: () => scope?.signal,
+        beforeRequest: scope ? () => scope.reserveTool() : undefined,
+        localSearchOnly: Boolean(scope),
         baseUrl: context.docdex?.baseUrl ?? "http://127.0.0.1:28491",
         repoRoot: docdexRepoRootFor(context.repo?.root, context.docdex?.repoId, workspaceRoot),
         repoId: context.docdex?.repoId,

package/dist/cli/AskCommand.d.ts

@@ -1,3 +1,4 @@
+import { type EffortLevel } from "../config/OrchestrationConfig.js";
 import { getAgentInventory } from "../agents/AgentInventory.js";
 import { attachMcpTools } from "../connectors/mcp/McpToolSource.js";
 import { createProviderForAssignment } from "../gateway/LocalGatewayProvider.js";
@@ -32,6 +33,8 @@ export declare const DEFAULT_DEADLINE_MS = 600000;
  */
 export declare const DEFAULT_MAX_PARALLEL_WORKERS = 3;
 export interface AskOptions {
+    orchestrationConfig?: string;
+    effort?: EffortLevel;
     query: string;
     workspaceRoot: string;
     mode: CodaliGatewayMode;

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

@@ -1 +1 @@
-{"version":3,"file":"AskCommand.d.ts","sourceRoot":"","sources":["../../src/cli/AskCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGvF,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIpE,OAAO,EACL,2BAA2B,EAE5B,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,KAAK,EACV,iBAAiB,EAEjB,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAG9D;;;;;;GAMG;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAe9C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;CAClB;AA+BD,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,KAAG,UAuE7C,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACzC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACnE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,KAAK,YAAY,CAAC;IAC3E,cAAc,CAAC,EAAE,CACf,UAAU,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC,CAAC,CAAC,KAC1D,QAAQ,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,cAAc,CAAC;IAClC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AA8BD,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,MAAM,GACjB,MAAM,MAAM,EAAE,EACd,OAAM,eAAoB,KACzB,OAAO,CAAC,UAAU,CAsZpB,CAAC;AAEF,eAAO,MAAM,UAAU;cACL,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAMzC,CAAC"}
+{"version":3,"file":"AskCommand.d.ts","sourceRoot":"","sources":["../../src/cli/AskCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAE7F,OAAO,EAAyB,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGvF,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIpE,OAAO,EACL,2BAA2B,EAE5B,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,KAAK,EACV,iBAAiB,EAEjB,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAG9D;;;;;;GAMG;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAe9C,MAAM,WAAW,UAAU;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;CAClB;AAkCD,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,KAAG,UAiF7C,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACzC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACnE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,KAAK,YAAY,CAAC;IAC3E,cAAc,CAAC,EAAE,CACf,UAAU,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC,CAAC,CAAC,KAC1D,QAAQ,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,cAAc,CAAC;IAClC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAkCD,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,MAAM,GACjB,MAAM,MAAM,EAAE,EACd,OAAM,eAAoB,KACzB,OAAO,CAAC,UAAU,CAyBpB,CAAC;AA6ZF,eAAO,MAAM,UAAU;cACL,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAMzC,CAAC"}

package/dist/cli/AskCommand.js

@@ -1,4 +1,6 @@
 import path from "node:path";
+import { loadOrchestrationConfig } from "../config/OrchestrationConfig.js";
+import { ConfiguredModelScope } from "../providers/ConfiguredModelScope.js";
 import { filterLocallyDrivable, getAgentInventory } from "../agents/AgentInventory.js";
 import { resolveConfigurableRoles } from "../agents/RoleResolution.js";
 import { attachHttpTools } from "../connectors/http/HttpToolSource.js";
@@ -55,6 +57,9 @@ const DEFAULT_ALLOWED_TOOLS = [
 ];
 const HELP = `Usage: codali ask "<question>" [options]
 
+Configured routing: --orchestration-config PATH --effort low|medium|high|max
+Deployment default: CODALI_ORCHESTRATION_CONFIG
+
 Ask Codali a question. The orchestrator routes the request, gathers evidence
 with the tools available to it, and returns a cited answer.
 
@@ -94,10 +99,24 @@ export const parseAskArgs = (argv) => {
     let responseSchemaPath;
     let responseFormat;
     let noTools = false;
+    let orchestrationConfig;
+    let effort;
     for (let index = 0; index < argv.length; index += 1) {
         const arg = argv[index];
         const next = argv[index + 1];
-        if (arg === "--workspace-root" && next) {
+        if (arg === "--orchestration-config") {
+            if (!next || next.startsWith("--"))
+                throw new Error("--orchestration-config requires a file path");
+            orchestrationConfig = next;
+            index += 1;
+        }
+        else if (arg === "--effort") {
+            if (!["low", "medium", "high", "max"].includes(next ?? ""))
+                throw new Error("--effort requires low|medium|high|max");
+            effort = next;
+            index += 1;
+        }
+        else if (arg === "--workspace-root" && next) {
             workspaceRoot = path.resolve(next);
             index += 1;
         }
@@ -147,6 +166,8 @@ export const parseAskArgs = (argv) => {
         throw new Error("codali ask requires a question.\n\n" + HELP);
     }
     return {
+        orchestrationConfig,
+        effort,
         query,
         workspaceRoot,
         mode,
@@ -161,11 +182,14 @@ export const parseAskArgs = (argv) => {
         noTools,
     };
 };
-const buildDefaultRegistry = (options, context, judgeProvider) => {
+const buildDefaultRegistry = (options, context, judgeProvider, scope) => {
     const registry = new ToolRegistry();
     if (options.noTools)
         return registry;
     const client = new DocdexClient({
+        signal: () => scope?.signal,
+        beforeRequest: scope ? () => scope.reserveTool() : undefined,
+        localSearchOnly: Boolean(scope),
         baseUrl: options.docdexBaseUrl ?? context.docdex?.baseUrl ?? "http://127.0.0.1:28491",
         repoRoot: docdexRepoRootFor(context.repo?.root, context.docdex?.repoId, options.workspaceRoot),
         repoId: context.docdex?.repoId,
@@ -189,6 +213,35 @@ export const runAsk = async (argv, deps = {}) => {
         return { tracer: new GatewayTracer(""), exitCode: 0 };
     }
     const options = parseAskArgs(argv);
+    const file = options.orchestrationConfig ?? process.env.CODALI_ORCHESTRATION_CONFIG;
+    if (!file) {
+        if (options.effort)
+            throw new Error("Legacy ask requires --orchestration-config to select an effort budget");
+        return runAskWithOptions(options, deps);
+    }
+    if (deps.createProvider)
+        throw new Error("Configured ask cannot accept a legacy provider override");
+    const resolved = await loadOrchestrationConfig(file);
+    const context = deps.resolveRunContext ? await deps.resolveRunContext(options.workspaceRoot)
+        : await new LocalConfigRunContextResolver().resolve({ workspaceRoot: options.workspaceRoot });
+    const abort = new AbortController();
+    const stop = () => abort.abort(new Error("Configured ask cancelled"));
+    const scope = new ConfiguredModelScope(resolved, { effort: options.effort, signal: abort.signal,
+        caller: { clientIdentity: context.tenant?.slug ?? context.tenant?.id, clientProduct: resolveMswarmClientProduct(context.tenant?.product) ?? "codali" } });
+    process.once("SIGINT", stop);
+    process.once("SIGTERM", stop);
+    try {
+        for (const binding of options.noTools ? ["planner", "synthesizer"] : ["planner", "synthesizer", "worker"])
+            scope.models(binding);
+        return await runAskWithOptions(options, { ...deps, resolveRunContext: async () => context }, scope);
+    }
+    finally {
+        scope.close();
+        process.removeListener("SIGINT", stop);
+        process.removeListener("SIGTERM", stop);
+    }
+};
+const runAskWithOptions = async (options, deps, scope) => {
     const write = deps.write ?? ((line) => process.stdout.write(`${line}\n`));
     const tracer = new GatewayTracer(options.query, { verbose: options.trace });
     // ---- Resolve what this run may touch --------------------------------
@@ -200,7 +253,7 @@ export const runAsk = async (argv, deps = {}) => {
     for (const warning of context.warnings ?? [])
         tracer.addWarning(warning);
     // ---- Resolve models (inventory is loaded once per process) -----------
-    const inventory = await (deps.loadInventory ?? getAgentInventory)();
+    const inventory = scope ? { agents: [], warnings: [] } : await (deps.loadInventory ?? getAgentInventory)();
     for (const warning of inventory.warnings)
         tracer.addWarning(warning);
     // Only consider agents this process can actually call. Selecting one it
@@ -216,9 +269,11 @@ export const runAsk = async (argv, deps = {}) => {
     for (const warning of roles.warnings)
         tracer.addWarning(warning);
     tracer.setRoleBindings(roles.bindings);
+    if (scope)
+        tracer.setRoleBindings({ orchestrator: "configured:planner", synthesizer: "configured:synthesizer", worker: "configured:worker" });
     const orchestrator = roles.assignments.orchestrator;
     const synthesizer = roles.assignments.synthesizer;
-    if (!orchestrator && !synthesizer) {
+    if (!scope && !orchestrator && !synthesizer) {
         write("No usable mcoda agent was found for the orchestrator or synthesizer role.\n" +
             "Check `mcoda agent list --json` and bind roles in ~/.codali/config.json.");
         tracer.finish({ status: "failed", completionReason: "no_agents_resolved" });
@@ -232,12 +287,12 @@ export const runAsk = async (argv, deps = {}) => {
     const clientProduct = resolveMswarmClientProduct(context.tenant?.product);
     const baseProvider = deps.createProvider ?? createProviderForAssignment;
     const makeProvider = (assignment, options) => baseProvider(assignment, { clientIdentity, clientProduct, ...options });
-    const orchestratorProvider = orchestrator ? makeProvider(orchestrator) : undefined;
-    const synthesizerProvider = synthesizer ? makeProvider(synthesizer) : undefined;
+    const orchestratorProvider = scope ? scope.provider("planner") : orchestrator ? makeProvider(orchestrator) : undefined;
+    const synthesizerProvider = scope ? scope.provider("synthesizer") : synthesizer ? makeProvider(synthesizer) : undefined;
     // Either role can stand in for the other if only one resolved; the trace
     // records which, so a degraded run is visible rather than silent.
     const primary = (synthesizerProvider ?? orchestratorProvider);
-    if (!orchestrator || !synthesizer) {
+    if (!scope && (!orchestrator || !synthesizer)) {
         tracer.addWarning("agent_role_substituted");
     }
     // Worker tasks need a provider that can emit structured tool calls. The
@@ -246,7 +301,7 @@ export const runAsk = async (argv, deps = {}) => {
     // through text and can never surface a call. So probe the built provider.
     const workerCandidates = [roles.toolCapable, roles.assignments.worker, orchestrator, synthesizer].filter((assignment) => Boolean(assignment));
     let workerAssignment = workerCandidates[0];
-    let worker = workerAssignment ? makeProvider(workerAssignment) : primary;
+    let worker = scope && !options.noTools ? scope.provider("worker") : workerAssignment ? makeProvider(workerAssignment) : primary;
     for (const candidate of workerCandidates) {
         const provider = makeProvider(candidate);
         if (providerSupportsToolCalls(provider)) {
@@ -269,7 +324,7 @@ export const runAsk = async (argv, deps = {}) => {
     // ---- Tools -----------------------------------------------------------
     const registry = deps.buildRegistry
         ? deps.buildRegistry(options, context)
-        : buildDefaultRegistry(options, context, orchestratorProvider ?? worker);
+        : buildDefaultRegistry(options, context, orchestratorProvider ?? worker, scope);
     // Connect the run's MCP servers and register what they expose into the same
     // registry the built-in and docdex tools live in. A failing server degrades
     // its own tools to unavailable and is reported; it never fails the run.
@@ -311,9 +366,9 @@ export const runAsk = async (argv, deps = {}) => {
     const toolDescriptors = gatewayToolDescriptorsFromRegistry(registry, allowedTools);
     // ---- Build the request ------------------------------------------------
     const limits = context.limits ?? {};
-    const maxToolCalls = Math.min(options.maxToolCalls, limits.maxToolCalls ?? Infinity);
+    const maxToolCalls = Math.min(options.maxToolCalls, limits.maxToolCalls ?? Infinity, scope?.budget().maxToolCalls ?? Infinity);
     const maxRounds = Math.min(options.maxRounds, limits.maxRounds ?? Infinity);
-    const deadlineMs = Math.min(options.deadlineMs, limits.deadlineMs ?? Infinity);
+    const deadlineMs = Math.min(options.deadlineMs, limits.deadlineMs ?? Infinity, scope?.budget().timeoutMs ?? Infinity);
     // Every tool must be declared to the capability compiler, which otherwise
     // discards it as `not_declared`. That includes docdex tools outside the
     // compiler's hardcoded backing-tool set — `docdex_web_research` among them,
@@ -326,6 +381,7 @@ export const runAsk = async (argv, deps = {}) => {
         responseSchema = JSON.parse(await readFile(path.resolve(options.responseSchemaPath), "utf8"));
     }
     const request = {
+        metadata: scope ? { orchestration: { configHash: scope.configHash, effort: scope.effort, scopeId: scope.id } } : undefined,
         query: options.query,
         mode: options.mode,
         product: { name: "codali-cli" },
@@ -350,7 +406,7 @@ export const runAsk = async (argv, deps = {}) => {
             maxIterations: maxRounds,
             maxRuntimeMs: deadlineMs,
             maxToolCalls,
-            maxModelCalls: DEFAULT_MAX_MODEL_CALLS,
+            maxModelCalls: Math.min(DEFAULT_MAX_MODEL_CALLS, scope?.budget().maxModelCalls ?? Infinity),
             maxEvidenceItems: 40,
             maxContextPackTokens: 16000,
             allowWrites: false,
@@ -381,6 +437,8 @@ export const runAsk = async (argv, deps = {}) => {
             provider: worker,
             registry,
             toolContext: {
+                signal: scope?.signal,
+                beforeTool: scope ? async () => scope.reserveTool() : undefined,
                 workspaceRoot: options.workspaceRoot,
                 allowShell: false,
                 allowDestructiveOperations: false,
@@ -417,6 +475,7 @@ export const runAsk = async (argv, deps = {}) => {
     });
     try {
         const planning = await gateway.plan(request);
+        scope?.signal.throwIfAborted();
         tracer.setRunId(planning.runId);
         tracer.recordPlan({
             capabilities: planning.classifier.capabilities,
@@ -448,6 +507,7 @@ export const runAsk = async (argv, deps = {}) => {
             return { result: clarified, tracer, exitCode: 0 };
         }
         const workers = await gateway.executePlannedWorkerTasks(request, planning);
+        scope?.signal.throwIfAborted();
         tracer.recordRound(1);
         // Surface worker failures. Without this a run whose every task failed still
         // reaches the synthesizer, which correctly reports it cannot answer — and
@@ -459,12 +519,15 @@ export const runAsk = async (argv, deps = {}) => {
         }
         for (const error of workers.workers.errors)
             tracer.addWarning(`worker_error:${error}`);
-        const result = await gateway.synthesizeFinalAnswer({
+        const synthesized = await gateway.synthesizeFinalAnswer({
             runId: planning.runId,
             request,
             planning,
             workers: workers.workers,
         });
+        scope?.signal.throwIfAborted();
+        const result = { ...synthesized, telemetry: { ...synthesized.telemetry,
+                ...(scope ? { orchestration: { configHash: scope.configHash, usage: scope.snapshot(), toolCalls: scope.toolsUsed } } : {}) } };
         tracer.finish({
             status: result.status,
             finalizerMode: String(result.telemetry.finalizerMode ?? "synthesizer"),

package/dist/cli/RunCommand.d.ts

@@ -1,8 +1,11 @@
+import { type EffortLevel } from "../config/OrchestrationConfig.js";
 import type { ToolConfig } from "../config/Config.js";
 import type { ProviderConfig } from "../providers/ProviderTypes.js";
 import { type PipelinePhase } from "../cognitive/ProviderRouting.js";
 import { type PhaseAgentSelection } from "../agents/PhaseAgentSelector.js";
 interface ParsedArgs {
+    orchestrationConfig?: string;
+    effort?: EffortLevel;
     workspaceRoot?: string;
     project?: string;
     command?: string;
@@ -88,6 +91,7 @@ export declare const assessPhaseFallbackSuitability: (phase: PipelinePhase, buil
 };
 export declare class RunCommand {
     static run(argv: string[]): Promise<void>;
+    private static runParsed;
 }
 export {};
 //# sourceMappingURL=RunCommand.d.ts.map

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

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