@pellux/goodvibes-sdk 0.30.3 → 0.33.0

package/dist/platform/state/telemetry.d.ts

@@ -9,11 +9,11 @@ export interface ToolCallRecord {
     timestamp: number;
 }
 export interface TelemetryFilter {
-    tool?: string;
-    status?: 'ok' | 'error';
-    since?: number;
-    until?: number;
-    limit?: number;
+    tool?: string | undefined;
+    status?: 'ok' | 'error' | undefined;
+    since?: number | undefined;
+    until?: number | undefined;
+    limit?: number | undefined;
 }
 export interface TelemetrySummary {
     total_calls: number;

package/dist/platform/state/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/platform/state/telemetry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrG;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,MAAM,CAAC,EAAE,MAAM;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,IAAI;IAiBP,KAAK,CAAC,MAAM,GAAE,eAAoB,GAAG,cAAc,EAAE;IAwCrD,UAAU,IAAI,gBAAgB;IAwC9B,MAAM,CAAC,MAAM,GAAE,MAAM,GAAG,KAAc,GAAG,MAAM;IAczC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAI9B,KAAK,IAAI,IAAI;IAIb,IAAI,OAAO,IAAI,OAAO,CAErB;CACF"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/platform/state/telemetry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrG;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,MAAM,CAAC,EAAE,MAAM;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,IAAI;IAiBP,KAAK,CAAC,MAAM,GAAE,eAAoB,GAAG,cAAc,EAAE;IAwCrD,UAAU,IAAI,gBAAgB;IAwC9B,MAAM,CAAC,MAAM,GAAE,MAAM,GAAG,KAAc,GAAG,MAAM;IAczC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAI9B,KAAK,IAAI,IAAI;IAIb,IAAI,OAAO,IAAI,OAAO,CAErB;CACF"}

package/dist/platform/state/telemetry.js

@@ -80,7 +80,7 @@ export class TelemetryDB {
        FROM tool_calls`);
         let total_calls = 0, total_tokens = 0, total_errors = 0, total_duration_ms = 0;
         if (totalResult.length > 0) {
-            const row = totalResult[0].values[0];
+            const row = (totalResult[0]?.values[0] ?? []);
             total_calls = row[0] ?? 0;
             total_tokens = row[1] ?? 0;
             total_errors = row[2] ?? 0;
@@ -96,7 +96,7 @@ export class TelemetryDB {
        ORDER BY calls DESC`);
         const by_tool = {};
         if (byToolResult.length > 0) {
-            for (const row of byToolResult[0].values) {
+            for (const row of (byToolResult[0]?.values ?? [])) {
                 const [tool, calls, tokens, errors, avg_duration_ms] = row;
                 by_tool[tool] = { calls, tokens, errors, avg_duration_ms: Math.round(avg_duration_ms) };
             }

package/dist/platform/templates/manager.d.ts

@@ -7,8 +7,8 @@ export interface TemplateEntry {
 export interface TemplateManagerRoots {
     projectRoot: string;
     homeDirectory: string;
-    projectDirectory?: string;
-    globalDirectory?: string;
+    projectDirectory?: string | undefined;
+    globalDirectory?: string | undefined;
 }
 /**
  * TemplateManager — save, load, list, delete and expand prompt templates.

package/dist/platform/templates/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/platform/templates/manager.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,KAAK,EAAE,oBAAoB;IAKvC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMzC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAajC,IAAI,IAAI,aAAa,EAAE;IAgCvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAe7B,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,KAAK,SAAI,GACR,MAAM;CAoBV;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBxE"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/platform/templates/manager.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,KAAK,EAAE,oBAAoB;IAKvC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMzC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAajC,IAAI,IAAI,aAAa,EAAE;IAgCvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAe7B,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,KAAK,SAAI,GACR,MAAM;CAoBV;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBxE"}

package/dist/platform/tools/agent/index.d.ts

@@ -9,8 +9,8 @@ export { AGENT_TEMPLATES, AgentManager } from './manager.js';
 export declare function createAgentTool(config: {
     manager: AgentManager;
     messageBus: Pick<AgentMessageBus, 'getMessages' | 'send'>;
-    wrfcController?: Pick<WrfcController, 'getWorkmap'>;
-    archetypeLoader?: Pick<ArchetypeLoader, 'loadArchetype'>;
+    wrfcController?: Pick<WrfcController, 'getWorkmap'> | undefined;
+    archetypeLoader?: Pick<ArchetypeLoader, 'loadArchetype'> | undefined;
     configManager: Pick<ConfigManager, 'get'>;
 }): Tool;
 //# sourceMappingURL=index.d.ts.map

package/dist/platform/tools/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAmB,YAAY,EAAE,MAAM,cAAc,CAAC;AAI7D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAiB7D,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,MAAM,CAAC,CAAC;IAC1D,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IACpD,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IACzD,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;CAC3C,GAAG,IAAI,CAkkBP"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAmB,YAAY,EAAE,MAAM,cAAc,CAAC;AAI7D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAiB7D,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,MAAM,CAAC,CAAC;IAC1D,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;IAChE,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,GAAG,SAAS,CAAC;IACrE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;CAC3C,GAAG,IAAI,CAkkBP"}

package/dist/platform/tools/agent/manager.d.ts

@@ -9,11 +9,11 @@ export type AgentExecutor = {
     runAgent(record: AgentRecord): Promise<void>;
 };
 export interface AgentManagerDependencies {
-    readonly archetypeLoader?: Pick<ArchetypeLoader, 'loadArchetype'>;
-    readonly messageBus?: Pick<AgentMessageBus, 'registerAgent'>;
-    readonly wrfcController?: Pick<WrfcController, 'createChain'> | null;
-    readonly executor?: AgentExecutor | null;
-    readonly configManager?: Pick<ConfigManager, 'get'>;
+    readonly archetypeLoader?: Pick<ArchetypeLoader, 'loadArchetype'> | undefined;
+    readonly messageBus?: Pick<AgentMessageBus, 'registerAgent'> | undefined;
+    readonly wrfcController?: Pick<WrfcController, 'createChain'> | null | undefined;
+    readonly executor?: AgentExecutor | null | undefined;
+    readonly configManager?: Pick<ConfigManager, 'get'> | undefined;
 }
 export declare const AGENT_TEMPLATES: Record<string, {
     description: string;
@@ -23,49 +23,49 @@ export interface AgentRecord {
     id: string;
     task: string;
     template: string;
-    model?: string;
-    provider?: string;
-    fallbackModels?: string[];
-    routing?: AgentInput['routing'];
-    executionIntent?: ExecutionIntent;
-    reasoningEffort?: 'instant' | 'low' | 'medium' | 'high';
-    context?: string;
+    model?: string | undefined;
+    provider?: string | undefined;
+    fallbackModels?: string[] | undefined;
+    routing?: AgentInput['routing'] | undefined;
+    executionIntent?: ExecutionIntent | undefined;
+    reasoningEffort?: 'instant' | 'low' | 'medium' | 'high' | undefined;
+    context?: string | undefined;
     tools: string[];
     status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
     startedAt: number;
-    completedAt?: number;
-    progress?: string;
+    completedAt?: number | undefined;
+    progress?: string | undefined;
     toolCallCount: number;
     usage?: {
         inputTokens: number;
         outputTokens: number;
         cacheReadTokens: number;
         cacheWriteTokens: number;
-        reasoningTokens?: number;
+        reasoningTokens?: number | undefined;
         llmCallCount: number;
         turnCount: number;
-        reasoningSummaryCount?: number;
+        reasoningSummaryCount?: number | undefined;
     };
-    error?: string;
-    fullOutput?: string;
-    streamingContent?: string;
-    wrfcId?: string;
-    dangerously_disable_wrfc?: boolean;
-    cohort?: string;
-    orchestrationGraphId?: string;
-    orchestrationNodeId?: string;
+    error?: string | undefined;
+    fullOutput?: string | undefined;
+    streamingContent?: string | undefined;
+    wrfcId?: string | undefined;
+    dangerously_disable_wrfc?: boolean | undefined;
+    cohort?: string | undefined;
+    orchestrationGraphId?: string | undefined;
+    orchestrationNodeId?: string | undefined;
     orchestrationDepth: number;
-    parentAgentId?: string;
-    parentNodeId?: string;
-    capabilityCeilingTools?: string[];
-    successCriteria?: string[];
-    requiredEvidence?: string[];
-    writeScope?: string[];
+    parentAgentId?: string | undefined;
+    parentNodeId?: string | undefined;
+    capabilityCeilingTools?: string[] | undefined;
+    successCriteria?: string[] | undefined;
+    requiredEvidence?: string[] | undefined;
+    writeScope?: string[] | undefined;
     executionProtocol: 'direct' | 'gather-plan-apply';
     reviewMode: 'none' | 'wrfc';
     communicationLane: 'parent-only' | 'parent-and-children' | 'cohort' | 'direct';
     /** Appended verbatim to the system prompt when the agent runs. Used by WRFC to inject constraint addenda. */
-    systemPromptAddendum?: string;
+    systemPromptAddendum?: string | undefined;
     knowledgeInjections?: Array<{
         id: string;
         cls: string;

package/dist/platform/tools/agent/manager.d.ts.map

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

package/dist/platform/tools/agent/manager.js

@@ -6,6 +6,7 @@ import { emitAgentSpawning, emitOrchestrationGraphCreated, emitOrchestrationNode
 import { evaluateOrchestrationSpawn } from '../../runtime/orchestration/spawn-policy.js';
 import { logger } from '../../utils/logger.js';
 import { summarizeError } from '../../utils/error-display.js';
+import { splitModelRegistryKey } from '../../providers/registry-helpers.js';
 export const AGENT_TEMPLATES = {
     engineer: {
         description: 'Full-stack implementation agent',
@@ -28,6 +29,24 @@ export const AGENT_TEMPLATES = {
         defaultTools: ['read', 'write', 'edit', 'find', 'exec', 'analyze', 'inspect', 'fetch', 'registry'],
     },
 };
+function requireProviderQualifiedModel(modelId, label) {
+    const trimmed = typeof modelId === 'string' ? modelId.trim() : '';
+    if (!trimmed)
+        return undefined;
+    try {
+        splitModelRegistryKey(trimmed);
+    }
+    catch {
+        throw new Error(`${label} must be a provider-qualified registry key; received '${modelId}'.`);
+    }
+    return trimmed;
+}
+function normalizeProviderQualifiedModelList(models, label) {
+    const normalized = models
+        ?.filter((model) => typeof model === 'string' && model.trim().length > 0)
+        .map((model) => requireProviderQualifiedModel(model, label));
+    return normalized && normalized.length > 0 ? normalized : undefined;
+}
 export class AgentManager {
     agents = new Map();
     runtimeBus = null;
@@ -48,9 +67,11 @@ export class AgentManager {
         this.runtimeBus = runtimeBus;
     }
     deriveEffectiveTools(input, defaultTools) {
-        const requestedTools = input.tools
-            ? (input.restrictTools ? [...input.tools] : [...new Set([...defaultTools, ...input.tools])])
-            : [...defaultTools];
+        const requestedTools = input.restrictTools
+            ? [...(input.tools ?? [])]
+            : input.tools
+                ? [...new Set([...defaultTools, ...input.tools])]
+                : [...defaultTools];
         if (!input.parentAgentId) {
             return { tools: requestedTools };
         }
@@ -80,9 +101,6 @@ export class AgentManager {
         const archetype = this.archetypeLoader.loadArchetype(template);
         const templateDef = AGENT_TEMPLATES[template] ?? AGENT_TEMPLATES.general;
         const defaultTools = archetype ? archetype.tools : templateDef.defaultTools;
-        if (input.restrictTools && (!input.tools || input.tools.length === 0)) {
-            logger.warn('spawn: restrictTools=true has no effect without a tools array — falling back to template defaults', { template });
-        }
         const toolResolution = this.deriveEffectiveTools(input, defaultTools);
         const tools = toolResolution.tools;
         if (!input.model && archetype?.model) {
@@ -124,24 +142,38 @@ export class AgentManager {
         const reviewMode = input.reviewMode ?? (input.dangerously_disable_wrfc ? 'none' : 'wrfc');
         const communicationLane = input.communicationLane
             ?? (input.parentAgentId ? 'parent-only' : input.cohort ? 'cohort' : 'direct');
+        const model = requireProviderQualifiedModel(input.model, 'Agent model overrides');
+        const provider = input.provider?.trim() || undefined;
+        if (!model && provider) {
+            throw new Error('Agent provider routing requires a provider-qualified model when provider is supplied.');
+        }
+        if (model && provider && splitModelRegistryKey(model).providerId !== provider) {
+            throw new Error(`Agent model override '${model}' conflicts with provider '${provider}'.`);
+        }
+        const fallbackModels = normalizeProviderQualifiedModelList(input.fallbackModels, 'Agent fallback models');
+        const routingFallbackModels = normalizeProviderQualifiedModelList(input.routing?.fallbackModels, 'Agent routing fallback models');
+        const effectiveFallbackModels = input.routing?.providerFailurePolicy === 'fail'
+            ? undefined
+            : routingFallbackModels ?? fallbackModels;
+        if (input.routing?.providerFailurePolicy === 'ordered-fallbacks'
+            && !effectiveFallbackModels?.length) {
+            throw new Error('Agent ordered fallback routing requires at least one provider-qualified fallback model.');
+        }
+        if (input.routing?.providerFailurePolicy === 'fail' && (routingFallbackModels?.length || fallbackModels?.length)) {
+            throw new Error('Agent fail routing cannot include fallback models; use ordered-fallbacks to enable model failover.');
+        }
         const id = `agent-${crypto.randomUUID().slice(0, 8)}`;
         const record = {
             id,
             task,
             template,
-            model: input.model,
-            provider: input.provider,
-            fallbackModels: input.fallbackModels?.filter((model) => typeof model === 'string' && model.trim().length > 0).map((model) => model.trim()),
+            model,
+            provider,
+            fallbackModels: effectiveFallbackModels,
             routing: input.routing
                 ? {
                     ...input.routing,
-                    ...(input.routing.fallbackModels
-                        ? {
-                            fallbackModels: input.routing.fallbackModels
-                                .filter((model) => typeof model === 'string' && model.trim().length > 0)
-                                .map((model) => model.trim()),
-                        }
-                        : {}),
+                    ...(effectiveFallbackModels ? { fallbackModels: effectiveFallbackModels } : {}),
                 }
                 : undefined,
             executionIntent: input.executionIntent,

package/dist/platform/tools/agent/schema.d.ts

@@ -6,66 +6,65 @@ import type { ExecutionIntent } from '../../runtime/execution-intents.js';
  */
 export declare const AGENT_TOOL_SCHEMA: ToolDefinition;
 export interface AgentProviderRoutingPolicy {
-    providerSelection?: 'inherit-current' | 'concrete' | 'synthetic';
-    unresolvedModelPolicy?: 'fallback-to-current' | 'fail';
-    providerFailurePolicy?: 'ordered-fallbacks' | 'fail';
-    fallbackModels?: readonly string[];
+    providerSelection?: 'inherit-current' | 'concrete' | 'synthetic' | undefined;
+    providerFailurePolicy?: 'ordered-fallbacks' | 'fail' | undefined;
+    fallbackModels?: readonly string[] | undefined;
 }
 /** Input shape for the agent tool. */
 export interface AgentInput {
     mode: 'spawn' | 'batch-spawn' | 'status' | 'cancel' | 'list' | 'templates' | 'get' | 'budget' | 'plan' | 'wait' | 'message' | 'wrfc-chains' | 'wrfc-history' | 'cohort-status' | 'cohort-report';
-    task?: string;
-    template?: string;
-    model?: string;
-    provider?: string;
-    fallbackModels?: string[];
-    routing?: AgentProviderRoutingPolicy;
-    executionIntent?: ExecutionIntent;
-    reasoningEffort?: 'instant' | 'low' | 'medium' | 'high';
-    tools?: string[];
-    restrictTools?: boolean;
-    context?: string;
-    successCriteria?: string[];
-    requiredEvidence?: string[];
-    writeScope?: string[];
-    executionProtocol?: 'direct' | 'gather-plan-apply';
-    reviewMode?: 'none' | 'wrfc';
-    communicationLane?: 'parent-only' | 'parent-and-children' | 'cohort' | 'direct';
-    parentAgentId?: string;
-    orchestrationGraphId?: string;
-    orchestrationNodeId?: string;
-    parentNodeId?: string;
-    dangerously_disable_wrfc?: boolean;
-    cohort?: string;
+    task?: string | undefined;
+    template?: string | undefined;
+    model?: string | undefined;
+    provider?: string | undefined;
+    fallbackModels?: string[] | undefined;
+    routing?: AgentProviderRoutingPolicy | undefined;
+    executionIntent?: ExecutionIntent | undefined;
+    reasoningEffort?: 'instant' | 'low' | 'medium' | 'high' | undefined;
+    tools?: string[] | undefined;
+    restrictTools?: boolean | undefined;
+    context?: string | undefined;
+    successCriteria?: string[] | undefined;
+    requiredEvidence?: string[] | undefined;
+    writeScope?: string[] | undefined;
+    executionProtocol?: 'direct' | 'gather-plan-apply' | undefined;
+    reviewMode?: 'none' | 'wrfc' | undefined;
+    communicationLane?: 'parent-only' | 'parent-and-children' | 'cohort' | 'direct' | undefined;
+    parentAgentId?: string | undefined;
+    orchestrationGraphId?: string | undefined;
+    orchestrationNodeId?: string | undefined;
+    parentNodeId?: string | undefined;
+    dangerously_disable_wrfc?: boolean | undefined;
+    cohort?: string | undefined;
     tasks?: Array<{
         task: string;
-        template?: string;
-        model?: string;
-        provider?: string;
-        fallbackModels?: string[];
-        routing?: AgentProviderRoutingPolicy;
-        executionIntent?: ExecutionIntent;
-        reasoningEffort?: 'instant' | 'low' | 'medium' | 'high';
-        tools?: string[];
-        restrictTools?: boolean;
-        context?: string;
-        successCriteria?: string[];
-        requiredEvidence?: string[];
-        writeScope?: string[];
-        executionProtocol?: 'direct' | 'gather-plan-apply';
-        reviewMode?: 'none' | 'wrfc';
-        communicationLane?: 'parent-only' | 'parent-and-children' | 'cohort' | 'direct';
-        parentAgentId?: string;
-        orchestrationGraphId?: string;
-        orchestrationNodeId?: string;
-        parentNodeId?: string;
-        dangerously_disable_wrfc?: boolean;
+        template?: string | undefined;
+        model?: string | undefined;
+        provider?: string | undefined;
+        fallbackModels?: string[] | undefined;
+        routing?: AgentProviderRoutingPolicy | undefined;
+        executionIntent?: ExecutionIntent | undefined;
+        reasoningEffort?: 'instant' | 'low' | 'medium' | 'high' | undefined;
+        tools?: string[] | undefined;
+        restrictTools?: boolean | undefined;
+        context?: string | undefined;
+        successCriteria?: string[] | undefined;
+        requiredEvidence?: string[] | undefined;
+        writeScope?: string[] | undefined;
+        executionProtocol?: 'direct' | 'gather-plan-apply' | undefined;
+        reviewMode?: 'none' | 'wrfc' | undefined;
+        communicationLane?: 'parent-only' | 'parent-and-children' | 'cohort' | 'direct' | undefined;
+        parentAgentId?: string | undefined;
+        orchestrationGraphId?: string | undefined;
+        orchestrationNodeId?: string | undefined;
+        parentNodeId?: string | undefined;
+        dangerously_disable_wrfc?: boolean | undefined;
     }>;
-    agentId?: string;
-    detail?: 'summary' | 'contract' | 'messages' | 'full';
-    timeoutMs?: number;
-    message?: string;
-    kind?: 'directive' | 'status' | 'question' | 'finding' | 'review' | 'handoff' | 'escalation' | 'completion';
-    wrfcId?: string;
+    agentId?: string | undefined;
+    detail?: 'summary' | 'contract' | 'messages' | 'full' | undefined;
+    timeoutMs?: number | undefined;
+    message?: string | undefined;
+    kind?: 'directive' | 'status' | 'question' | 'finding' | 'review' | 'handoff' | 'escalation' | 'completion' | undefined;
+    wrfcId?: string | undefined;
 }
 //# sourceMappingURL=schema.d.ts.map

package/dist/platform/tools/agent/schema.d.ts.map

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

package/dist/platform/tools/agent/schema.js

@@ -44,7 +44,7 @@ export const AGENT_TOOL_SCHEMA = {
             },
             model: {
                 type: 'string',
-                description: 'Model override for the spawned agent (mode: spawn).',
+                description: 'Provider-qualified model registry key for the spawned agent (mode: spawn).',
             },
             provider: {
                 type: 'string',
@@ -53,7 +53,7 @@ export const AGENT_TOOL_SCHEMA = {
             fallbackModels: {
                 type: 'array',
                 items: { type: 'string' },
-                description: 'Ordered fallback model IDs or registry keys to try if the primary model fails (mode: spawn).',
+                description: 'Ordered provider-qualified registry keys to try if the primary model fails (mode: spawn).',
             },
             executionIntent: {
                 type: 'object',
@@ -163,9 +163,9 @@ export const AGENT_TOOL_SCHEMA = {
                     properties: {
                         task: { type: 'string', description: 'Task description for the agent.' },
                         template: { type: 'string', enum: ['engineer', 'reviewer', 'tester', 'researcher', 'general'], description: 'Agent template.' },
-                        model: { type: 'string', description: 'Model override.' },
+                        model: { type: 'string', description: 'Provider-qualified model registry key.' },
                         provider: { type: 'string', description: 'Provider override.' },
-                        fallbackModels: { type: 'array', items: { type: 'string' }, description: 'Ordered fallback model IDs or registry keys.' },
+                        fallbackModels: { type: 'array', items: { type: 'string' }, description: 'Ordered provider-qualified registry keys.' },
                         executionIntent: {
                             type: 'object',
                             properties: {

package/dist/platform/tools/analyze/git-modes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-modes.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/analyze/git-modes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,YAAY,CAAC;AAyGpE,wBAAsB,OAAO,CAC3B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8BlC;AA8CD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2DlC;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6ClC;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6ElC"}
+{"version":3,"file":"git-modes.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/analyze/git-modes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,YAAY,CAAC;AA4GpE,wBAAsB,OAAO,CAC3B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8BlC;AA8CD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2DlC;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA+ClC;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6ElC"}

package/dist/platform/tools/analyze/git-modes.js

@@ -4,6 +4,8 @@ import { GitService } from '../../git/service.js';
 import { summarizeError } from '../../utils/error-display.js';
 import { isBreakingUpgrade, loadDependencyVersions, parseDiffStats, parseSemver, readJsonFile, truncateDiffAtBoundary, validateGitRefs, } from './shared.js';
 import { instrumentedFetch } from '../../utils/fetch-with-timeout.js';
+// 1.2 s — warm `git status` cache response budget; keeps semantic-diff LLM probe non-blocking
+const GIT_PROBE_TIMEOUT_MS = 1200;
 function parseSemanticDiffResponse(llmResponse, changedFiles) {
     let summary = 'LLM unavailable — diff available in raw_diff field.';
     let impact = changedFiles.map((f) => `Changed file: ${f}`);
@@ -72,7 +74,7 @@ async function trySemanticDiffLlm(toolLLM, prompt) {
         return await Promise.race([
             toolLLM.chat(prompt, { maxTokens: 512 }),
             new Promise((resolve) => {
-                const timer = setTimeout(() => resolve(''), 1200);
+                const timer = setTimeout(() => resolve(''), GIT_PROBE_TIMEOUT_MS);
                 timer.unref?.();
             }),
         ]);
@@ -116,15 +118,15 @@ function extractSignaturesFromDiff(diff) {
     const lines = diff.split('\n');
     const exportLinePattern = /^([+-])\s*export\s+(?:(?:async|default|declare)\s+)*(?:function\*?|class|const|let|var|type|interface|enum)\s+(\w+)(.*)/;
     for (let i = 0; i < lines.length; i++) {
-        const m = lines[i].match(exportLinePattern);
+        const m = (lines[i] ?? '').match(exportLinePattern);
         if (!m)
             continue;
-        const marker = m[1];
-        const name = m[2];
+        const marker = (m[1] ?? '+'); // regex group 1 is always present when m matches
+        const name = m[2] ?? '';
         let rest = m[3];
-        if (!rest.includes('{') && !rest.includes(';')) {
+        if (!rest?.includes('{') && !rest?.includes(';')) {
             for (let j = i + 1; j < lines.length; j++) {
-                const contLine = lines[j];
+                const contLine = lines[j] ?? '';
                 if (!contLine.startsWith(marker) && !contLine.startsWith(' '))
                     break;
                 const stripped = contLine.startsWith(marker)
@@ -135,8 +137,8 @@ function extractSignaturesFromDiff(diff) {
                     break;
             }
         }
-        const braceIdx = rest.indexOf('{');
-        const sig = `${name}${braceIdx >= 0 ? rest.slice(0, braceIdx).trimEnd() : rest.replace(/;.*$/, '').trimEnd()}`;
+        const braceIdx = rest?.indexOf('{') ?? -1;
+        const sig = `${name}${braceIdx >= 0 ? (rest ?? '').slice(0, braceIdx).trimEnd() : (rest ?? '').replace(/;.*$/, '').trimEnd()}`;
         if (marker === '-') {
             before.set(name, sig);
         }
@@ -235,12 +237,14 @@ ${truncatedDiff}`;
     const { summary, impact, risk } = llmResponse
         ? parseSemanticDiffResponse(llmResponse, changedFiles)
         : fallback;
+    const source = llmResponse ? 'llm' : 'deterministic_fallback';
     return {
         before,
         after,
         summary,
         impact,
         risk,
+        source,
         changed_files: changedFiles,
     };
 }

package/dist/platform/tools/analyze/scan-modes.js

@@ -16,7 +16,7 @@ function extractExportedSymbols(content) {
         { kind: 'variable', regex: /^export\s+(?:let|var)\s+(\w+)/ },
     ];
     for (let i = 0; i < lines.length; i++) {
-        const trimmed = lines[i].trimStart();
+        const trimmed = (lines[i] ?? '').trimStart();
         for (const { kind, regex } of patterns) {
             const m = trimmed.match(regex);
             if (m?.[1]) {
@@ -265,7 +265,7 @@ export async function runSecurity(input, projectRoot) {
             const lines = content.split('\n');
             for (let i = 0; i < lines.length; i++) {
                 for (const { name, regex } of SECRET_PATTERNS) {
-                    const m = lines[i].match(regex);
+                    const m = (lines[i] ?? '').match(regex);
                     if (m) {
                         findings.push({
                             file: relative(projectRoot, file),
@@ -522,14 +522,14 @@ export async function runPermissions(input, projectRoot) {
         const lines = content.split('\n');
         for (let i = 0; i < lines.length; i++) {
             for (const { name, regex, severity } of DANGEROUS_PATTERNS) {
-                const m = lines[i].match(regex);
+                const m = (lines[i] ?? '').match(regex);
                 if (m) {
                     findings.push({
                         file: relative(projectRoot, file),
                         line: i + 1,
                         pattern: name,
                         severity,
-                        match: lines[i].trim().slice(0, 100),
+                        match: (lines[i] ?? '').trim().slice(0, 100),
                     });
                 }
             }
@@ -570,11 +570,11 @@ export async function runEnvAudit(_input, projectRoot) {
         return { files: [], missing: [], extra: [], message: 'No .env files found' };
     }
     const reference = found.find((f) => f.name === '.env.example') ?? found[0];
-    const referenceKeys = new Set(reference.keys);
+    const referenceKeys = new Set(reference?.keys ?? []);
     const missing = [];
     const extra = [];
     for (const file of found) {
-        if (file.name === reference.name)
+        if (file.name === reference?.name)
             continue;
         const fileKeys = new Set(file.keys);
         for (const key of referenceKeys) {
@@ -584,7 +584,7 @@ export async function runEnvAudit(_input, projectRoot) {
                     existing.missing_from.push(file.name);
                 }
                 else {
-                    missing.push({ key, present_in: reference.name, missing_from: [file.name] });
+                    missing.push({ key, present_in: reference?.name ?? '', missing_from: [file.name] });
                 }
             }
         }
@@ -596,7 +596,7 @@ export async function runEnvAudit(_input, projectRoot) {
     }
     return {
         files: found.map((f) => ({ name: f.name, key_count: f.keys.length })),
-        reference: reference.name,
+        reference: reference?.name ?? '',
         missing,
         extra,
     };

package/dist/platform/tools/analyze/shared.d.ts

@@ -11,9 +11,9 @@ export declare function validatePath(inputPath: string, root: string): string |
 };
 export declare function readTextFile(filePath: string): Promise<string | null>;
 export declare function collectInputFiles(inputFiles: string[] | undefined, projectRoot: string, options?: {
-    expandDirectories?: boolean;
-    limit?: number;
-    deadline?: number;
+    expandDirectories?: boolean | undefined;
+    limit?: number | undefined;
+    deadline?: number | undefined;
 }): Promise<string[]>;
 export declare function sampleArray<T>(value: unknown, limit?: number): T[];
 export declare function summarizeAnalyzeResult(mode: AnalyzeInput['mode'], result: Record<string, unknown>): Record<string, unknown>;