@xopcai/xopc 0.0.116 → 0.0.118

package/dist/src/agent/embedded/run-for-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-for-session.js","names":[],"sources":["../../../../src/agent/embedded/run-for-session.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport type { AgentMessage, ThinkingLevel } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { resolveAgentTurnTimeoutMs } from '../orchestration/run-agent-turn-with-timeout.js';\nimport { runXopcEmbeddedTurn } from './run-turn.js';\nimport type { EmbeddedStreamEvent, RunXopcEmbeddedTurnParams, RunXopcEmbeddedTurnResult } from './types.js';\nimport { applyStartupContextToUserMessage } from '../reply/apply-turn-user-enrichment.js';\nimport {\n  mergeTurnTools,\n  resolveEmbeddedMcpToolsForTurn,\n} from '../mcp/resolve-embedded-mcp-tools.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('EmbeddedTurnForSession');\n\nexport type RunEmbeddedForSessionParams = {\n  sessionKey: string;\n  runId?: string;\n  userMessage: AgentMessage;\n  llmImages?: import('@earendil-works/pi-ai').ImageContent[];\n  sessionStore: SessionStore;\n  agentManager: AgentInstanceGateway;\n  modelManager: ModelManager;\n  thinkingOverride?: string | null;\n  abortSignal?: AbortSignal;\n  onEvent?: (event: EmbeddedStreamEvent) => void;\n  getConfig?: () => Config | undefined;\n  beforeTurn?: () => void | Promise<void>;\n  afterTurn?: (userPlain: string) => void | Promise<void>;\n  startupAction?: 'new' | 'reset';\n  forceStartupContext?: boolean;\n  applyStartupContext?: boolean;\n  /** When true, dispose session MCP runtime after this turn completes. */\n  cleanupBundleMcpOnRunEnd?: boolean;\n};\n\nexport async function runEmbeddedTurnForSession(\n  params: RunEmbeddedForSessionParams,\n): Promise<RunXopcEmbeddedTurnResult> {\n  const { sessionKey, agentManager, modelManager, sessionStore, userMessage } = params;\n  const runId = params.runId ?? crypto.randomUUID();\n\n  await params.beforeTurn?.();\n\n  const agent = (agentManager as any).getOrCreateAgent(sessionKey) as {\n    state: {\n      tools: RunXopcEmbeddedTurnParams['tools'];\n      systemPrompt?: string;\n      thinkingLevel?: ThinkingLevel;\n    };\n  };\n  const mm = modelManager as any;\n  await mm.applyModelForSession(agent, sessionKey);\n\n  const modelRef = String(mm.getModelForSession(sessionKey));\n  agentManager.setModelForSession(sessionKey, modelRef);\n  const model = mm.getResolvedModelForSession(sessionKey) as RunXopcEmbeddedTurnParams['model'];\n  const tools = agent.state.tools;\n  const systemPrompt = agent.state.systemPrompt ?? '';\n  const thinkingLevel = (params.thinkingOverride as ThinkingLevel | undefined) ?? agent.state.thinkingLevel;\n  const workspaceDir = agentManager.getResolvedWorkspaceForSession(sessionKey);\n  const config = params.getConfig?.();\n\n  // --- Pre-turn automatic compaction ---\n  await maybeAutoCompactBeforeTurn({\n    sessionKey,\n    sessionStore,\n    agentManager,\n    model,\n    config,\n    onEvent: params.onEvent,\n  });\n\n  let userMessageForTurn = userMessage;\n  if (params.applyStartupContext !== false) {\n    userMessageForTurn = await applyStartupContextToUserMessage({\n      userMessage,\n      sessionKey,\n      workspaceDir,\n      cfg: config,\n      sessionStore,\n      startupAction: params.startupAction,\n      force: params.forceStartupContext,\n    });\n  }\n\n  const result = await (async () => {\n    const mcpResolved = await resolveEmbeddedMcpToolsForTurn({\n      sessionKey,\n      workspaceDir,\n      cfg: config,\n      baseTools: tools,\n      cleanupOnTurnEnd: params.cleanupBundleMcpOnRunEnd === true,\n    });\n    const turnTools = mergeTurnTools(tools, mcpResolved.tools);\n    try {\n      return await runXopcEmbeddedTurn({\n        sessionKey,\n        runId,\n        userMessage: userMessageForTurn,\n        images: params.llmImages,\n        model,\n        modelRef,\n        tools: turnTools,\n        systemPrompt,\n        thinkingLevel,\n        workspaceDir,\n        sessionStore,\n        timeoutMs: resolveAgentTurnTimeoutMs(config),\n        abortSignal: params.abortSignal,\n        onEvent: params.onEvent,\n      });\n    } finally {\n      await mcpResolved.dispose().catch(() => {});\n    }\n  })();\n\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Pre-turn automatic compaction\n// ---------------------------------------------------------------------------\n\nasync function maybeAutoCompactBeforeTurn(opts: {\n  sessionKey: string;\n  sessionStore: SessionStore;\n  agentManager: AgentInstanceGateway;\n  model: RunXopcEmbeddedTurnParams['model'];\n  config: Config | undefined;\n  onEvent?: (event: EmbeddedStreamEvent) => void;\n}): Promise<void> {\n  const { sessionKey, sessionStore, agentManager, model, config, onEvent } = opts;\n\n  // Respect the compaction.enabled flag\n  const compactionConfig = config?.agents?.defaults?.compaction;\n  if (compactionConfig?.enabled === false) {\n    return;\n  }\n\n  const contextWindow = (model as { contextWindow?: number }).contextWindow ?? 128_000;\n  const messages = await sessionStore.load(sessionKey);\n  const prep = sessionStore.prepareCompaction(sessionKey, messages, contextWindow);\n\n  if (!prep.needsCompaction) {\n    return;\n  }\n\n  log.info(\n    { sessionKey, reason: prep.stats?.reason, usagePercent: prep.stats?.usagePercent, contextWindow },\n    'Pre-turn auto-compaction triggered',\n  );\n\n  onEvent?.({\n    type: 'compaction',\n    status: 'started',\n    tokensBefore: prep.stats?.usagePercent != null\n      ? Math.round((prep.stats.usagePercent as number) * contextWindow)\n      : undefined,\n  });\n\n  try {\n    const result = await sessionStore.compact(sessionKey, messages, contextWindow);\n\n    if (result.compacted) {\n      // Evict the cached agent so the next turn reloads from the compacted transcript\n      agentManager.removeAgent(sessionKey);\n\n      log.info(\n        { sessionKey, tokensBefore: result.tokensBefore, tokensAfter: result.tokensAfter },\n        'Pre-turn auto-compaction completed',\n      );\n\n      onEvent?.({\n        type: 'compaction',\n        status: 'completed',\n        tokensBefore: result.tokensBefore,\n        tokensAfter: result.tokensAfter,\n        summary: result.summary.length > 200 ? `${result.summary.slice(0, 200)}…` : result.summary,\n      });\n    } else {\n      onEvent?.({ type: 'compaction', status: 'skipped' });\n    }\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    log.warn({ err, sessionKey }, `Pre-turn auto-compaction failed: ${errorMessage}`);\n    // Non-fatal: let the turn proceed even if compaction fails\n    onEvent?.({ type: 'compaction', status: 'skipped' });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"run-for-session.js","names":[],"sources":["../../../../src/agent/embedded/run-for-session.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport type { AgentMessage, ThinkingLevel } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { resolveAgentTurnTimeoutMs } from '../orchestration/run-agent-turn-with-timeout.js';\nimport { runXopcEmbeddedTurn } from './run-turn.js';\nimport type { EmbeddedStreamEvent, RunXopcEmbeddedTurnParams, RunXopcEmbeddedTurnResult } from './types.js';\nimport { applyStartupContextToUserMessage } from '../reply/apply-turn-user-enrichment.js';\nimport { resolveEffectiveAgentManifestForSession } from '../../config/agent-profile.js';\nimport {\n  mergeTurnTools,\n  resolveEmbeddedMcpToolsForTurn,\n} from '../mcp/resolve-embedded-mcp-tools.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('EmbeddedTurnForSession');\n\nexport type RunEmbeddedForSessionParams = {\n  sessionKey: string;\n  runId?: string;\n  userMessage: AgentMessage;\n  llmImages?: import('@earendil-works/pi-ai').ImageContent[];\n  sessionStore: SessionStore;\n  agentManager: AgentInstanceGateway;\n  modelManager: ModelManager;\n  thinkingOverride?: string | null;\n  abortSignal?: AbortSignal;\n  onEvent?: (event: EmbeddedStreamEvent) => void;\n  getConfig?: () => Config | undefined;\n  beforeTurn?: () => void | Promise<void>;\n  afterTurn?: (userPlain: string) => void | Promise<void>;\n  startupAction?: 'new' | 'reset';\n  forceStartupContext?: boolean;\n  applyStartupContext?: boolean;\n  /** When true, dispose session MCP runtime after this turn completes. */\n  cleanupBundleMcpOnRunEnd?: boolean;\n};\n\nexport async function runEmbeddedTurnForSession(\n  params: RunEmbeddedForSessionParams,\n): Promise<RunXopcEmbeddedTurnResult> {\n  const { sessionKey, agentManager, modelManager, sessionStore, userMessage } = params;\n  const runId = params.runId ?? crypto.randomUUID();\n\n  await params.beforeTurn?.();\n\n  const agent = (agentManager as any).getOrCreateAgent(sessionKey) as {\n    state: {\n      tools: RunXopcEmbeddedTurnParams['tools'];\n      systemPrompt?: string;\n      thinkingLevel?: ThinkingLevel;\n    };\n  };\n  const mm = modelManager as any;\n  await mm.applyModelForSession(agent, sessionKey);\n\n  const modelRef = String(mm.getModelForSession(sessionKey));\n  agentManager.setModelForSession(sessionKey, modelRef);\n  const model = mm.getResolvedModelForSession(sessionKey) as RunXopcEmbeddedTurnParams['model'];\n  const tools = agent.state.tools;\n  const systemPrompt = agent.state.systemPrompt ?? '';\n  const thinkingLevel = (params.thinkingOverride as ThinkingLevel | undefined) ?? agent.state.thinkingLevel;\n  const workspaceDir = agentManager.getResolvedWorkspaceForSession(sessionKey);\n  const config = params.getConfig?.();\n\n  // --- Pre-turn automatic compaction ---\n  await maybeAutoCompactBeforeTurn({\n    sessionKey,\n    sessionStore,\n    agentManager,\n    model,\n    config,\n    onEvent: params.onEvent,\n  });\n\n  let userMessageForTurn = userMessage;\n  if (params.applyStartupContext !== false) {\n    userMessageForTurn = await applyStartupContextToUserMessage({\n      userMessage,\n      sessionKey,\n      workspaceDir,\n      cfg: config,\n      sessionStore,\n      startupAction: params.startupAction,\n      force: params.forceStartupContext,\n    });\n  }\n\n  const result = await (async () => {\n    const mcpResolved = await resolveEmbeddedMcpToolsForTurn({\n      sessionKey,\n      workspaceDir,\n      cfg: config,\n      baseTools: tools,\n      cleanupOnTurnEnd: params.cleanupBundleMcpOnRunEnd === true,\n    });\n    const turnTools = mergeTurnTools(tools, mcpResolved.tools);\n    try {\n      return await runXopcEmbeddedTurn({\n        sessionKey,\n        runId,\n        userMessage: userMessageForTurn,\n        images: params.llmImages,\n        model,\n        modelRef,\n        tools: turnTools,\n        systemPrompt,\n        thinkingLevel,\n        workspaceDir,\n        sessionStore,\n        timeoutMs: resolveAgentTurnTimeoutMs(config),\n        abortSignal: params.abortSignal,\n        onEvent: params.onEvent,\n      });\n    } finally {\n      await mcpResolved.dispose().catch(() => {});\n    }\n  })();\n\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Pre-turn automatic compaction\n// ---------------------------------------------------------------------------\n\nasync function maybeAutoCompactBeforeTurn(opts: {\n  sessionKey: string;\n  sessionStore: SessionStore;\n  agentManager: AgentInstanceGateway;\n  model: RunXopcEmbeddedTurnParams['model'];\n  config: Config | undefined;\n  onEvent?: (event: EmbeddedStreamEvent) => void;\n}): Promise<void> {\n  const { sessionKey, sessionStore, agentManager, model, config, onEvent } = opts;\n  if (config) {\n    try {\n      const manifest = resolveEffectiveAgentManifestForSession(config, sessionKey);\n      if (manifest.memory.retention?.compaction === false) {\n        return;\n      }\n    } catch {\n      // Keep compaction enabled when manifest resolution is unavailable.\n    }\n  }\n\n  const contextWindow = (model as { contextWindow?: number }).contextWindow ?? 128_000;\n  const messages = await sessionStore.load(sessionKey);\n  const prep = sessionStore.prepareCompaction(sessionKey, messages, contextWindow);\n\n  if (!prep.needsCompaction) {\n    return;\n  }\n\n  log.info(\n    { sessionKey, reason: prep.stats?.reason, usagePercent: prep.stats?.usagePercent, contextWindow },\n    'Pre-turn auto-compaction triggered',\n  );\n\n  onEvent?.({\n    type: 'compaction',\n    status: 'started',\n    tokensBefore: prep.stats?.usagePercent != null\n      ? Math.round((prep.stats.usagePercent as number) * contextWindow)\n      : undefined,\n  });\n\n  try {\n    const result = await sessionStore.compact(sessionKey, messages, contextWindow);\n\n    if (result.compacted) {\n      // Evict the cached agent so the next turn reloads from the compacted transcript\n      agentManager.removeAgent(sessionKey);\n\n      log.info(\n        { sessionKey, tokensBefore: result.tokensBefore, tokensAfter: result.tokensAfter },\n        'Pre-turn auto-compaction completed',\n      );\n\n      onEvent?.({\n        type: 'compaction',\n        status: 'completed',\n        tokensBefore: result.tokensBefore,\n        tokensAfter: result.tokensAfter,\n        summary: result.summary.length > 200 ? `${result.summary.slice(0, 200)}…` : result.summary,\n      });\n    } else {\n      onEvent?.({ type: 'compaction', status: 'skipped' });\n    }\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    log.warn({ err, sessionKey }, `Pre-turn auto-compaction failed: ${errorMessage}`);\n    // Non-fatal: let the turn proceed even if compaction fails\n    onEvent?.({ type: 'compaction', status: 'skipped' });\n  }\n}\n"],"mappings":";;;;;;;;;aAgBqD;AAErD,MAAM,MAAM,aAAa,yBAAyB;AAuBlD,eAAsB,0BACpB,QACoC;CACpC,MAAM,EAAE,YAAY,cAAc,cAAc,cAAc,gBAAgB;CAC9E,MAAM,QAAQ,OAAO,SAAS,OAAO,YAAY;AAEjD,OAAM,OAAO,cAAc;CAE3B,MAAM,QAAS,aAAqB,iBAAiB,WAAW;CAOhE,MAAM,KAAK;AACX,OAAM,GAAG,qBAAqB,OAAO,WAAW;CAEhD,MAAM,WAAW,OAAO,GAAG,mBAAmB,WAAW,CAAC;AAC1D,cAAa,mBAAmB,YAAY,SAAS;CACrD,MAAM,QAAQ,GAAG,2BAA2B,WAAW;CACvD,MAAM,QAAQ,MAAM,MAAM;CAC1B,MAAM,eAAe,MAAM,MAAM,gBAAgB;CACjD,MAAM,gBAAiB,OAAO,oBAAkD,MAAM,MAAM;CAC5F,MAAM,eAAe,aAAa,+BAA+B,WAAW;CAC5E,MAAM,SAAS,OAAO,aAAa;AAGnC,OAAM,2BAA2B;EAC/B;EACA;EACA;EACA;EACA;EACA,SAAS,OAAO;EACjB,CAAC;CAEF,IAAI,qBAAqB;AACzB,KAAI,OAAO,wBAAwB,MACjC,sBAAqB,MAAM,iCAAiC;EAC1D;EACA;EACA;EACA,KAAK;EACL;EACA,eAAe,OAAO;EACtB,OAAO,OAAO;EACf,CAAC;AAkCJ,QAAO,OA/Be,YAAY;EAChC,MAAM,cAAc,MAAM,+BAA+B;GACvD;GACA;GACA,KAAK;GACL,WAAW;GACX,kBAAkB,OAAO,6BAA6B;GACvD,CAAC;EACF,MAAM,YAAY,eAAe,OAAO,YAAY,MAAM;AAC1D,MAAI;AACF,UAAO,MAAM,oBAAoB;IAC/B;IACA;IACA,aAAa;IACb,QAAQ,OAAO;IACf;IACA;IACA,OAAO;IACP;IACA;IACA;IACA;IACA,WAAW,0BAA0B,OAAO;IAC5C,aAAa,OAAO;IACpB,SAAS,OAAO;IACjB,CAAC;YACM;AACR,SAAM,YAAY,SAAS,CAAC,YAAY,GAAG;;KAE3C;;AASN,eAAe,2BAA2B,MAOxB;CAChB,MAAM,EAAE,YAAY,cAAc,cAAc,OAAO,QAAQ,YAAY;AAC3E,KAAI,OACF,KAAI;AAEF,MADiB,wCAAwC,QAAQ,WACrD,CAAC,OAAO,WAAW,eAAe,MAC5C;SAEI;CAKV,MAAM,gBAAiB,MAAqC,iBAAiB;CAC7E,MAAM,WAAW,MAAM,aAAa,KAAK,WAAW;CACpD,MAAM,OAAO,aAAa,kBAAkB,YAAY,UAAU,cAAc;AAEhF,KAAI,CAAC,KAAK,gBACR;AAGF,KAAI,KACF;EAAE;EAAY,QAAQ,KAAK,OAAO;EAAQ,cAAc,KAAK,OAAO;EAAc;EAAe,EACjG,qCACD;AAED,WAAU;EACR,MAAM;EACN,QAAQ;EACR,cAAc,KAAK,OAAO,gBAAgB,OACtC,KAAK,MAAO,KAAK,MAAM,eAA0B,cAAc,GAC/D,KAAA;EACL,CAAC;AAEF,KAAI;EACF,MAAM,SAAS,MAAM,aAAa,QAAQ,YAAY,UAAU,cAAc;AAE9E,MAAI,OAAO,WAAW;AAEpB,gBAAa,YAAY,WAAW;AAEpC,OAAI,KACF;IAAE;IAAY,cAAc,OAAO;IAAc,aAAa,OAAO;IAAa,EAClF,qCACD;AAED,aAAU;IACR,MAAM;IACN,QAAQ;IACR,cAAc,OAAO;IACrB,aAAa,OAAO;IACpB,SAAS,OAAO,QAAQ,SAAS,MAAM,GAAG,OAAO,QAAQ,MAAM,GAAG,IAAI,CAAC,KAAK,OAAO;IACpF,CAAC;QAEF,WAAU;GAAE,MAAM;GAAc,QAAQ;GAAW,CAAC;UAE/C,KAAK;EACZ,MAAM,eAAe,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AACrE,MAAI,KAAK;GAAE;GAAK;GAAY,EAAE,oCAAoC,eAAe;AAEjF,YAAU;GAAE,MAAM;GAAc,QAAQ;GAAW,CAAC"}

package/dist/src/agent/fallback/candidates.js

@@ -3,10 +3,13 @@ import { normalizeProviderId, parseModelRef as parseModelRef$1 } from "../models
 //#region src/agent/fallback/candidates.ts
 init_providers();
 function getDefaultModelParts(config) {
-	const parts = getDefaultModelSync(config).split("/");
+	const defaultModel = getDefaultModelSync(config);
+	if (!defaultModel) return null;
+	const parts = defaultModel.split("/");
+	if (!parts[0] || !parts[1]) return null;
 	return {
-		provider: parts[0] || "anthropic",
-		model: parts[1] || "claude-sonnet-4-5"
+		provider: parts[0],
+		model: parts[1]
 	};
 }
 /**
@@ -23,13 +26,12 @@ function parseModelRef(raw, defaultProvider) {
 }
 function resolveFallbackCandidates(params) {
 	const { cfg, provider: inputProvider, model: inputModel, fallbacksOverride } = params;
-	const modelConfig = cfg?.agents?.defaults?.models?.chat;
-	const primaryRef = modelConfig?.primary;
-	const fallbacks = fallbacksOverride ?? modelConfig?.fallbacks;
+	const primaryRef = getDefaultModelSync(cfg);
+	const fallbacks = fallbacksOverride;
 	const defaultParts = getDefaultModelParts(cfg);
 	const primaryResolved = parseModelRef(primaryRef || getDefaultModelSync(cfg));
-	const provider = inputProvider.trim() || primaryResolved?.provider || defaultParts.provider;
-	const model = inputModel.trim() || primaryResolved?.model || defaultParts.model;
+	const provider = inputProvider.trim() || primaryResolved?.provider || defaultParts?.provider || "";
+	const model = inputModel.trim() || primaryResolved?.model || defaultParts?.model || "";
 	const candidates = [];
 	const seen = /* @__PURE__ */ new Set();
 	const addCandidate = (c) => {
@@ -39,7 +41,7 @@ function resolveFallbackCandidates(params) {
 		seen.add(key);
 		candidates.push(c);
 	};
-	addCandidate({
+	if (provider && model) addCandidate({
 		provider,
 		model
 	});

package/dist/src/agent/fallback/candidates.js.map

@@ -1 +1 @@
-{"version":3,"file":"candidates.js","names":["parseModelRefUtil"],"sources":["../../../../src/agent/fallback/candidates.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport { getDefaultModelSync } from '../../providers/index.js';\nimport { parseModelRef as parseModelRefUtil, normalizeProviderId } from '../models/selection.js';\n\nexport interface ModelCandidate {\n  provider: string;\n  model: string;\n}\n\nexport interface FallbackAttempt {\n  provider: string;\n  model: string;\n  error: string;\n  reason?: string;\n  status?: number;\n  code?: string;\n}\n\n// Get default model dynamically\nfunction getDefaultModelParts(config?: Config): { provider: string; model: string } {\n  const defaultModel = getDefaultModelSync(config);\n  const parts = defaultModel.split('/');\n  return {\n    provider: parts[0] || 'anthropic',\n    model: parts[1] || 'claude-sonnet-4-5',\n  };\n}\n\n/**\n * Parse model reference string into provider/model parts.\n * Uses the unified implementation from selection.ts.\n */\nfunction parseModelRef(raw: string, defaultProvider?: string): ModelCandidate | null {\n  const result = parseModelRefUtil(raw, defaultProvider);\n  if (!result) return null;\n  return {\n    provider: normalizeProviderId(result.provider),\n    model: result.model,\n  };\n}\n\nexport function resolveFallbackCandidates(params: {\n  cfg: Config | undefined;\n  provider: string;\n  model: string;\n  fallbacksOverride?: string[];\n}): ModelCandidate[] {\n  const { cfg, provider: inputProvider, model: inputModel, fallbacksOverride } = params;\n\n  const modelConfig = cfg?.agents?.defaults?.models?.chat;\n  const primaryRef = modelConfig?.primary;\n  const fallbacks = fallbacksOverride ?? modelConfig?.fallbacks;\n\n  const defaultParts = getDefaultModelParts(cfg);\n  const primaryResolved = parseModelRef(primaryRef || getDefaultModelSync(cfg));\n  const provider = inputProvider.trim() || primaryResolved?.provider || defaultParts.provider;\n  const model = inputModel.trim() || primaryResolved?.model || defaultParts.model;\n\n  const candidates: ModelCandidate[] = [];\n  const seen = new Set<string>();\n\n  const addCandidate = (c: ModelCandidate) => {\n    const key = `${c.provider}/${c.model}`.toLowerCase();\n    if (seen.has(key)) return;\n    // Skip providers that are not configured (no API key)\n    if (!isProviderConfiguredSync(c.provider)) return;\n    seen.add(key);\n    candidates.push(c);\n  };\n\n  addCandidate({ provider, model });\n\n  if (fallbacks) {\n    for (const fb of fallbacks) {\n      const resolved = parseModelRef(fb, provider);\n      if (resolved) addCandidate(resolved);\n    }\n  }\n\n  if (!fallbacksOverride && primaryResolved) {\n    addCandidate(primaryResolved);\n  }\n\n  return candidates;\n}\n"],"mappings":";;;gBACoE;AAmBpE,SAAS,qBAAqB,QAAsD;CAElF,MAAM,QADe,oBAAoB,OACf,CAAC,MAAM,IAAI;AACrC,QAAO;EACL,UAAU,MAAM,MAAM;EACtB,OAAO,MAAM,MAAM;EACpB;;;;;;AAOH,SAAS,cAAc,KAAa,iBAAiD;CACnF,MAAM,SAASA,gBAAkB,KAAK,gBAAgB;AACtD,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO;EACL,UAAU,oBAAoB,OAAO,SAAS;EAC9C,OAAO,OAAO;EACf;;AAGH,SAAgB,0BAA0B,QAKrB;CACnB,MAAM,EAAE,KAAK,UAAU,eAAe,OAAO,YAAY,sBAAsB;CAE/E,MAAM,cAAc,KAAK,QAAQ,UAAU,QAAQ;CACnD,MAAM,aAAa,aAAa;CAChC,MAAM,YAAY,qBAAqB,aAAa;CAEpD,MAAM,eAAe,qBAAqB,IAAI;CAC9C,MAAM,kBAAkB,cAAc,cAAc,oBAAoB,IAAI,CAAC;CAC7E,MAAM,WAAW,cAAc,MAAM,IAAI,iBAAiB,YAAY,aAAa;CACnF,MAAM,QAAQ,WAAW,MAAM,IAAI,iBAAiB,SAAS,aAAa;CAE1E,MAAM,aAA+B,EAAE;CACvC,MAAM,uBAAO,IAAI,KAAa;CAE9B,MAAM,gBAAgB,MAAsB;EAC1C,MAAM,MAAM,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ,aAAa;AACpD,MAAI,KAAK,IAAI,IAAI,CAAE;AAEnB,MAAI,CAAC,yBAAyB,EAAE,SAAS,CAAE;AAC3C,OAAK,IAAI,IAAI;AACb,aAAW,KAAK,EAAE;;AAGpB,cAAa;EAAE;EAAU;EAAO,CAAC;AAEjC,KAAI,UACF,MAAK,MAAM,MAAM,WAAW;EAC1B,MAAM,WAAW,cAAc,IAAI,SAAS;AAC5C,MAAI,SAAU,cAAa,SAAS;;AAIxC,KAAI,CAAC,qBAAqB,gBACxB,cAAa,gBAAgB;AAG/B,QAAO"}
+{"version":3,"file":"candidates.js","names":["parseModelRefUtil"],"sources":["../../../../src/agent/fallback/candidates.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport { getDefaultModelSync } from '../../providers/index.js';\nimport { parseModelRef as parseModelRefUtil, normalizeProviderId } from '../models/selection.js';\n\nexport interface ModelCandidate {\n  provider: string;\n  model: string;\n}\n\nexport interface FallbackAttempt {\n  provider: string;\n  model: string;\n  error: string;\n  reason?: string;\n  status?: number;\n  code?: string;\n}\n\nfunction getDefaultModelParts(config?: Config): ModelCandidate | null {\n  const defaultModel = getDefaultModelSync(config);\n  if (!defaultModel) return null;\n  const parts = defaultModel.split('/');\n  if (!parts[0] || !parts[1]) return null;\n  return { provider: parts[0], model: parts[1] };\n}\n\n/**\n * Parse model reference string into provider/model parts.\n * Uses the unified implementation from selection.ts.\n */\nfunction parseModelRef(raw: string, defaultProvider?: string): ModelCandidate | null {\n  const result = parseModelRefUtil(raw, defaultProvider);\n  if (!result) return null;\n  return {\n    provider: normalizeProviderId(result.provider),\n    model: result.model,\n  };\n}\n\nexport function resolveFallbackCandidates(params: {\n  cfg: Config | undefined;\n  provider: string;\n  model: string;\n  fallbacksOverride?: string[];\n}): ModelCandidate[] {\n  const { cfg, provider: inputProvider, model: inputModel, fallbacksOverride } = params;\n\n  const primaryRef = getDefaultModelSync(cfg);\n  const fallbacks = fallbacksOverride;\n\n  const defaultParts = getDefaultModelParts(cfg);\n  const primaryResolved = parseModelRef(primaryRef || getDefaultModelSync(cfg));\n  const provider = inputProvider.trim() || primaryResolved?.provider || defaultParts?.provider || '';\n  const model = inputModel.trim() || primaryResolved?.model || defaultParts?.model || '';\n\n  const candidates: ModelCandidate[] = [];\n  const seen = new Set<string>();\n\n  const addCandidate = (c: ModelCandidate) => {\n    const key = `${c.provider}/${c.model}`.toLowerCase();\n    if (seen.has(key)) return;\n    // Skip providers that are not configured (no API key)\n    if (!isProviderConfiguredSync(c.provider)) return;\n    seen.add(key);\n    candidates.push(c);\n  };\n\n  if (provider && model) {\n    addCandidate({ provider, model });\n  }\n\n  if (fallbacks) {\n    for (const fb of fallbacks) {\n      const resolved = parseModelRef(fb, provider);\n      if (resolved) addCandidate(resolved);\n    }\n  }\n\n  if (!fallbacksOverride && primaryResolved) {\n    addCandidate(primaryResolved);\n  }\n\n  return candidates;\n}\n"],"mappings":";;;gBACoE;AAkBpE,SAAS,qBAAqB,QAAwC;CACpE,MAAM,eAAe,oBAAoB,OAAO;AAChD,KAAI,CAAC,aAAc,QAAO;CAC1B,MAAM,QAAQ,aAAa,MAAM,IAAI;AACrC,KAAI,CAAC,MAAM,MAAM,CAAC,MAAM,GAAI,QAAO;AACnC,QAAO;EAAE,UAAU,MAAM;EAAI,OAAO,MAAM;EAAI;;;;;;AAOhD,SAAS,cAAc,KAAa,iBAAiD;CACnF,MAAM,SAASA,gBAAkB,KAAK,gBAAgB;AACtD,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO;EACL,UAAU,oBAAoB,OAAO,SAAS;EAC9C,OAAO,OAAO;EACf;;AAGH,SAAgB,0BAA0B,QAKrB;CACnB,MAAM,EAAE,KAAK,UAAU,eAAe,OAAO,YAAY,sBAAsB;CAE/E,MAAM,aAAa,oBAAoB,IAAI;CAC3C,MAAM,YAAY;CAElB,MAAM,eAAe,qBAAqB,IAAI;CAC9C,MAAM,kBAAkB,cAAc,cAAc,oBAAoB,IAAI,CAAC;CAC7E,MAAM,WAAW,cAAc,MAAM,IAAI,iBAAiB,YAAY,cAAc,YAAY;CAChG,MAAM,QAAQ,WAAW,MAAM,IAAI,iBAAiB,SAAS,cAAc,SAAS;CAEpF,MAAM,aAA+B,EAAE;CACvC,MAAM,uBAAO,IAAI,KAAa;CAE9B,MAAM,gBAAgB,MAAsB;EAC1C,MAAM,MAAM,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ,aAAa;AACpD,MAAI,KAAK,IAAI,IAAI,CAAE;AAEnB,MAAI,CAAC,yBAAyB,EAAE,SAAS,CAAE;AAC3C,OAAK,IAAI,IAAI;AACb,aAAW,KAAK,EAAE;;AAGpB,KAAI,YAAY,MACd,cAAa;EAAE;EAAU;EAAO,CAAC;AAGnC,KAAI,UACF,MAAK,MAAM,MAAM,WAAW;EAC1B,MAAM,WAAW,cAAc,IAAI,SAAS;AAC5C,MAAI,SAAU,cAAa,SAAS;;AAIxC,KAAI,CAAC,qBAAqB,gBACxB,cAAa,gBAAgB;AAG/B,QAAO"}

package/dist/src/agent/goals/goal-locale.js

@@ -1,7 +1,7 @@
-import { checklistCounts } from "./checklist-types.js";
-import { renderChecklistPlain } from "./state.js";
 import { formatI18n } from "../../i18n/format.js";
 import { SERVER_LOCALES, isServerLocale, normalizeServerLocale, serverLocaleOrFallback } from "../../i18n/locale.js";
+import { checklistCounts } from "./checklist-types.js";
+import { renderChecklistPlain } from "./state.js";
 import { JUDGE_REASON_EN, goalsChecklistProgressSuffix, goalsContinuationChecklistTemplate, goalsContinuationPlainTemplate, goalsEvaluateCopy, goalsJudgeReason, goalsJudgeResponseLanguageNote } from "../../i18n/goals-bundle.js";
 //#region src/agent/goals/goal-locale.ts
 const GOAL_UI_LOCALES = SERVER_LOCALES;

package/dist/src/agent/goals/post-turn.js

@@ -1,9 +1,9 @@
-import { createLogger } from "../../utils/logger/index.js";
-import { init_logger } from "../../utils/logger.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
-import { resolveGoalUiLocale } from "./goal-locale.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
 import { GoalService } from "../../goals/goal-service.js";
+import { resolveGoalUiLocale } from "./goal-locale.js";
 import { evaluateAfterTurnHermesLike } from "./evaluate-turn.js";
 import "../../goals/index.js";
 //#region src/agent/goals/post-turn.ts

package/dist/src/agent/image/generation/runtime-types.d.ts

@@ -7,6 +7,7 @@
  * want a single import surface.
  */
 import type { Config } from '../../../config/schema.js';
+import type { ToolModelConfig } from '../tool-model-config.js';
 import type { AuthProfileStore } from '../../../providers/auth-runtime/index.js';
 import type { FallbackAttempt } from '../../failover-error.js';
 import type { GeneratedImageAsset, ImageGenerationBackground, ImageGenerationIgnoredOverride, ImageGenerationNormalization, ImageGenerationOutputFormat, ImageGenerationProvider, ImageGenerationProviderOptions, ImageGenerationQuality, ImageGenerationResolution, ImageGenerationSourceImage } from './types.js';
@@ -16,6 +17,7 @@ export interface GenerateImageParams {
     prompt: string;
     agentDir?: string;
     authStore?: AuthProfileStore;
+    modelConfig?: ToolModelConfig;
     modelOverride?: string;
     count?: number;
     size?: string;

package/dist/src/agent/image/generation/runtime.js

@@ -21,7 +21,7 @@ async function generateImage(params, deps = {}) {
 	const getProvider = (id, cfg) => (deps.getProvider ?? getImageGenerationProvider)(id, cfg);
 	const candidates = resolveCapabilityModelCandidates({
 		cfg: params.cfg,
-		modelConfig: params.cfg?.agents?.defaults?.imageGenerationModel,
+		modelConfig: params.modelConfig,
 		modelOverride: params.modelOverride,
 		parseModelRef: parseImageGenerationModelRef,
 		agentDir: params.agentDir,

package/dist/src/agent/image/generation/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","names":["listProvidersSummaryFromRegistry"],"sources":["../../../../../src/agent/image/generation/runtime.ts"],"sourcesContent":["import type { Config } from '../../../config/schema.js';\nimport { PROVIDER_ENV_MAP } from '../../../providers/env-keys.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport {\n  buildMediaGenerationNormalizationMetadata,\n  buildNoCapabilityModelConfiguredMessage,\n  recordCapabilityCandidateFailure,\n  resolveCapabilityModelCandidates,\n  throwCapabilityGenerationFailure,\n  type CapabilityProviderCandidate,\n} from '../../media-generation/index.js';\nimport { describeFailoverError, isFailoverError, type FallbackAttempt } from '../../failover-error.js';\nimport { parseImageGenerationModelRef } from './model-ref.js';\nimport { resolveImageGenerationOverrides } from './normalization.js';\nimport {\n  getImageGenerationProvider,\n  listImageGenerationProviders,\n  listImageGenerationProvidersSummary as listProvidersSummaryFromRegistry,\n  type ImageGenerationProvider,\n  type ImageGenerationProviderSummary,\n} from './provider-registry.js';\nimport type {\n  ImageGenerationProviderCapabilities,\n  ImageGenerationRequest,\n  ImageGenerationSourceImage,\n} from './types.js';\n\n// Side-effect: registers every bundled image-generation provider listed in\n// src/generated/bundled-image-generation-providers.ts (regenerated via\n// `pnpm run generate:bundled-image-providers`). Vendor implementations live\n// under extensions/<vendor>/src/image-generation-provider.ts.\nimport './bundled.js';\n\nexport type {\n  GenerateImageParams,\n  GenerateImageRuntimeResult,\n  ImageGenerationRuntimeDeps,\n} from './runtime-types.js';\n\nimport type {\n  GenerateImageParams,\n  GenerateImageRuntimeResult,\n  ImageGenerationRuntimeDeps,\n} from './runtime-types.js';\n\nconst log = createLogger('ImageGen');\n\n/**\n * Generate one or more images, walking the candidate model list with\n * structured failover. See {@link GenerateImageParams} / {@link GenerateImageRuntimeResult}.\n */\nexport async function generateImage(\n  params: GenerateImageParams,\n  deps: ImageGenerationRuntimeDeps = {},\n): Promise<GenerateImageRuntimeResult> {\n  const listProviders = (cfg?: Config) =>\n    (deps.listProviders ?? listImageGenerationProviders)(cfg);\n  const getProvider = (id: string, cfg?: Config) =>\n    (deps.getProvider ?? getImageGenerationProvider)(id, cfg);\n\n  const candidates = resolveCapabilityModelCandidates({\n    cfg: params.cfg,\n    modelConfig: params.cfg?.agents?.defaults?.imageGenerationModel,\n    modelOverride: params.modelOverride,\n    parseModelRef: parseImageGenerationModelRef,\n    agentDir: params.agentDir,\n    listProviders: (cfg) => listProviders(cfg).map(toCapabilityCandidate),\n    autoProviderFallback: params.autoProviderFallback,\n  });\n\n  if (candidates.length === 0) {\n    throw new Error(buildNoImageGenerationModelConfiguredMessage(params.cfg, deps));\n  }\n\n  const attempts: FallbackAttempt[] = [];\n  let lastError: unknown;\n\n  for (const candidate of candidates) {\n    const startedAt = Date.now();\n    const provider = getProvider(candidate.provider, params.cfg);\n    if (!provider) {\n      const errorMessage = `Image generation provider not registered: ${candidate.provider}`;\n      attempts.push({\n        provider: candidate.provider,\n        model: candidate.model,\n        error: errorMessage,\n        reason: 'config',\n      });\n      lastError = new Error(errorMessage);\n      log.warn(\n        { provider: candidate.provider, model: candidate.model, phase: 'candidate_skipped' },\n        `image-generation candidate skipped: ${errorMessage}`,\n      );\n      continue;\n    }\n\n    try {\n      const sanitized = resolveImageGenerationOverrides({\n        provider,\n        size: params.size,\n        aspectRatio: params.aspectRatio,\n        resolution: params.resolution,\n        quality: params.quality,\n        outputFormat: params.outputFormat,\n        background: params.background,\n        inputImages: params.inputImages,\n      });\n\n      const request = buildProviderRequest({\n        provider,\n        candidate,\n        params,\n        sanitized,\n      });\n\n      log.debug(\n        {\n          provider: candidate.provider,\n          model: candidate.model,\n          phase: 'provider_invoked',\n          normalizationCount: sanitized.normalization\n            ? Object.keys(sanitized.normalization).length\n            : 0,\n          ignoredCount: sanitized.ignoredOverrides.length,\n        },\n        `image-generation provider invoked: ${candidate.provider}/${candidate.model}`,\n      );\n\n      const result = await provider.generateImage(request);\n      if (!result.images?.length) {\n        throw new Error('Image generation provider returned no images.');\n      }\n\n      const normalizationMetadata = buildMediaGenerationNormalizationMetadata({\n        normalization: sanitized.normalization as Record<string, unknown> | undefined,\n      });\n\n      return {\n        images: result.images,\n        provider: candidate.provider,\n        model: result.model ?? candidate.model,\n        attempts,\n        ...(sanitized.normalization ? { normalization: sanitized.normalization } : {}),\n        ignoredOverrides: sanitized.ignoredOverrides,\n        metadata: { ...(result.metadata ?? {}), ...normalizationMetadata },\n      };\n    } catch (err) {\n      lastError = err;\n      const durationMs = Date.now() - startedAt;\n      recordCapabilityCandidateFailure({\n        attempts,\n        provider: candidate.provider,\n        model: candidate.model,\n        error: err,\n        durationMs,\n      });\n      const last = attempts[attempts.length - 1];\n      const description = isFailoverError(err) ? describeFailoverError(err) : undefined;\n      log.warn(\n        {\n          err,\n          provider: candidate.provider,\n          model: candidate.model,\n          status: last?.status,\n          reason: last?.reason,\n          durationMs,\n          phase: 'candidate_failed',\n          attemptCount: attempts.length,\n        },\n        `image-generation candidate failed: ${candidate.provider}/${candidate.model}: ${\n          description ?? last?.error ?? (err instanceof Error ? err.message : String(err))\n        }`,\n      );\n    }\n  }\n\n  return throwCapabilityGenerationFailure({\n    capabilityLabel: 'image generation',\n    attempts,\n    lastError,\n  });\n}\n\nexport function listImageGenerationProvidersSummary(\n  cfg?: Config,\n): ImageGenerationProviderSummary[] {\n  return listProvidersSummaryFromRegistry(cfg);\n}\n\n// ============================================\n// Helpers\n// ============================================\n\nfunction buildProviderRequest(input: {\n  provider: ImageGenerationProvider;\n  candidate: { provider: string; model: string };\n  params: GenerateImageParams;\n  sanitized: ReturnType<typeof resolveImageGenerationOverrides>;\n}): ImageGenerationRequest {\n  const { provider, candidate, params, sanitized } = input;\n  const inputImages = params.inputImages\n    ? cloneInputImages(params.inputImages)\n    : undefined;\n  return {\n    provider: provider.id,\n    model: candidate.model,\n    prompt: params.prompt,\n    ...(params.cfg ? { cfg: params.cfg } : {}),\n    ...(params.agentDir ? { agentDir: params.agentDir } : {}),\n    ...(params.authStore ? { authStore: params.authStore } : {}),\n    ...(typeof params.timeoutMs === 'number' ? { timeoutMs: params.timeoutMs } : {}),\n    ...(params.signal ? { signal: params.signal } : {}),\n    ...(typeof params.count === 'number' ? { count: params.count } : {}),\n    ...(sanitized.size !== undefined ? { size: sanitized.size } : {}),\n    ...(sanitized.aspectRatio !== undefined ? { aspectRatio: sanitized.aspectRatio } : {}),\n    ...(sanitized.resolution !== undefined ? { resolution: sanitized.resolution } : {}),\n    ...(sanitized.quality !== undefined ? { quality: sanitized.quality } : {}),\n    ...(sanitized.outputFormat !== undefined ? { outputFormat: sanitized.outputFormat } : {}),\n    ...(sanitized.background !== undefined ? { background: sanitized.background } : {}),\n    ...(inputImages ? { inputImages } : {}),\n    ...(params.providerOptions ? { providerOptions: params.providerOptions } : {}),\n  };\n}\n\nfunction cloneInputImages(images: ImageGenerationSourceImage[]): ImageGenerationSourceImage[] {\n  return images.map((img) => ({\n    buffer: img.buffer,\n    mimeType: img.mimeType,\n    ...(img.fileName ? { fileName: img.fileName } : {}),\n    ...(img.metadata ? { metadata: img.metadata } : {}),\n  }));\n}\n\nfunction toCapabilityCandidate(provider: ImageGenerationProvider): CapabilityProviderCandidate {\n  return {\n    id: provider.id,\n    ...(provider.aliases ? { aliases: provider.aliases } : {}),\n    defaultModel: provider.defaultModel ?? null,\n    models: provider.models ?? [],\n    isConfigured: provider.isConfigured,\n  };\n}\n\nfunction buildNoImageGenerationModelConfiguredMessage(\n  cfg: Config | undefined,\n  deps: ImageGenerationRuntimeDeps,\n): string {\n  const list = (deps.listProviders ?? listImageGenerationProviders)(cfg);\n  return buildNoCapabilityModelConfiguredMessage({\n    capabilityLabel: 'image-generation',\n    modelConfigKey: 'imageGenerationModel',\n    providers: list.map(toCapabilityCandidate),\n    getProviderEnvVars: deps.getProviderEnvVars ?? ((id) => PROVIDER_ENV_MAP[id]),\n  });\n}\n\n// Re-export the canonical capability type for callers consuming this barrel.\nexport type { ImageGenerationProviderCapabilities };\n// Re-export the provider-registry surface that gateway routes / CLI consume\n// through this single barrel module. NOTE: `listImageGenerationProvidersSummary`\n// is implemented locally above (it overlays cfg-aware `configured` flags), so\n// it must not be re-exported from the registry to avoid a name clash.\nexport {\n  getImageGenerationProvider,\n  listImageGenerationProviders,\n} from './provider-registry.js';\n"],"mappings":"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"}
+{"version":3,"file":"runtime.js","names":["listProvidersSummaryFromRegistry"],"sources":["../../../../../src/agent/image/generation/runtime.ts"],"sourcesContent":["import type { Config } from '../../../config/schema.js';\nimport { PROVIDER_ENV_MAP } from '../../../providers/env-keys.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport {\n  buildMediaGenerationNormalizationMetadata,\n  buildNoCapabilityModelConfiguredMessage,\n  recordCapabilityCandidateFailure,\n  resolveCapabilityModelCandidates,\n  throwCapabilityGenerationFailure,\n  type CapabilityProviderCandidate,\n} from '../../media-generation/index.js';\nimport { describeFailoverError, isFailoverError, type FallbackAttempt } from '../../failover-error.js';\nimport { parseImageGenerationModelRef } from './model-ref.js';\nimport { resolveImageGenerationOverrides } from './normalization.js';\nimport {\n  getImageGenerationProvider,\n  listImageGenerationProviders,\n  listImageGenerationProvidersSummary as listProvidersSummaryFromRegistry,\n  type ImageGenerationProvider,\n  type ImageGenerationProviderSummary,\n} from './provider-registry.js';\nimport type {\n  ImageGenerationProviderCapabilities,\n  ImageGenerationRequest,\n  ImageGenerationSourceImage,\n} from './types.js';\n\n// Side-effect: registers every bundled image-generation provider listed in\n// src/generated/bundled-image-generation-providers.ts (regenerated via\n// `pnpm run generate:bundled-image-providers`). Vendor implementations live\n// under extensions/<vendor>/src/image-generation-provider.ts.\nimport './bundled.js';\n\nexport type {\n  GenerateImageParams,\n  GenerateImageRuntimeResult,\n  ImageGenerationRuntimeDeps,\n} from './runtime-types.js';\n\nimport type {\n  GenerateImageParams,\n  GenerateImageRuntimeResult,\n  ImageGenerationRuntimeDeps,\n} from './runtime-types.js';\n\nconst log = createLogger('ImageGen');\n\n/**\n * Generate one or more images, walking the candidate model list with\n * structured failover. See {@link GenerateImageParams} / {@link GenerateImageRuntimeResult}.\n */\nexport async function generateImage(\n  params: GenerateImageParams,\n  deps: ImageGenerationRuntimeDeps = {},\n): Promise<GenerateImageRuntimeResult> {\n  const listProviders = (cfg?: Config) =>\n    (deps.listProviders ?? listImageGenerationProviders)(cfg);\n  const getProvider = (id: string, cfg?: Config) =>\n    (deps.getProvider ?? getImageGenerationProvider)(id, cfg);\n\n  const candidates = resolveCapabilityModelCandidates({\n    cfg: params.cfg,\n    modelConfig: params.modelConfig,\n    modelOverride: params.modelOverride,\n    parseModelRef: parseImageGenerationModelRef,\n    agentDir: params.agentDir,\n    listProviders: (cfg) => listProviders(cfg).map(toCapabilityCandidate),\n    autoProviderFallback: params.autoProviderFallback,\n  });\n\n  if (candidates.length === 0) {\n    throw new Error(buildNoImageGenerationModelConfiguredMessage(params.cfg, deps));\n  }\n\n  const attempts: FallbackAttempt[] = [];\n  let lastError: unknown;\n\n  for (const candidate of candidates) {\n    const startedAt = Date.now();\n    const provider = getProvider(candidate.provider, params.cfg);\n    if (!provider) {\n      const errorMessage = `Image generation provider not registered: ${candidate.provider}`;\n      attempts.push({\n        provider: candidate.provider,\n        model: candidate.model,\n        error: errorMessage,\n        reason: 'config',\n      });\n      lastError = new Error(errorMessage);\n      log.warn(\n        { provider: candidate.provider, model: candidate.model, phase: 'candidate_skipped' },\n        `image-generation candidate skipped: ${errorMessage}`,\n      );\n      continue;\n    }\n\n    try {\n      const sanitized = resolveImageGenerationOverrides({\n        provider,\n        size: params.size,\n        aspectRatio: params.aspectRatio,\n        resolution: params.resolution,\n        quality: params.quality,\n        outputFormat: params.outputFormat,\n        background: params.background,\n        inputImages: params.inputImages,\n      });\n\n      const request = buildProviderRequest({\n        provider,\n        candidate,\n        params,\n        sanitized,\n      });\n\n      log.debug(\n        {\n          provider: candidate.provider,\n          model: candidate.model,\n          phase: 'provider_invoked',\n          normalizationCount: sanitized.normalization\n            ? Object.keys(sanitized.normalization).length\n            : 0,\n          ignoredCount: sanitized.ignoredOverrides.length,\n        },\n        `image-generation provider invoked: ${candidate.provider}/${candidate.model}`,\n      );\n\n      const result = await provider.generateImage(request);\n      if (!result.images?.length) {\n        throw new Error('Image generation provider returned no images.');\n      }\n\n      const normalizationMetadata = buildMediaGenerationNormalizationMetadata({\n        normalization: sanitized.normalization as Record<string, unknown> | undefined,\n      });\n\n      return {\n        images: result.images,\n        provider: candidate.provider,\n        model: result.model ?? candidate.model,\n        attempts,\n        ...(sanitized.normalization ? { normalization: sanitized.normalization } : {}),\n        ignoredOverrides: sanitized.ignoredOverrides,\n        metadata: { ...(result.metadata ?? {}), ...normalizationMetadata },\n      };\n    } catch (err) {\n      lastError = err;\n      const durationMs = Date.now() - startedAt;\n      recordCapabilityCandidateFailure({\n        attempts,\n        provider: candidate.provider,\n        model: candidate.model,\n        error: err,\n        durationMs,\n      });\n      const last = attempts[attempts.length - 1];\n      const description = isFailoverError(err) ? describeFailoverError(err) : undefined;\n      log.warn(\n        {\n          err,\n          provider: candidate.provider,\n          model: candidate.model,\n          status: last?.status,\n          reason: last?.reason,\n          durationMs,\n          phase: 'candidate_failed',\n          attemptCount: attempts.length,\n        },\n        `image-generation candidate failed: ${candidate.provider}/${candidate.model}: ${\n          description ?? last?.error ?? (err instanceof Error ? err.message : String(err))\n        }`,\n      );\n    }\n  }\n\n  return throwCapabilityGenerationFailure({\n    capabilityLabel: 'image generation',\n    attempts,\n    lastError,\n  });\n}\n\nexport function listImageGenerationProvidersSummary(\n  cfg?: Config,\n): ImageGenerationProviderSummary[] {\n  return listProvidersSummaryFromRegistry(cfg);\n}\n\n// ============================================\n// Helpers\n// ============================================\n\nfunction buildProviderRequest(input: {\n  provider: ImageGenerationProvider;\n  candidate: { provider: string; model: string };\n  params: GenerateImageParams;\n  sanitized: ReturnType<typeof resolveImageGenerationOverrides>;\n}): ImageGenerationRequest {\n  const { provider, candidate, params, sanitized } = input;\n  const inputImages = params.inputImages\n    ? cloneInputImages(params.inputImages)\n    : undefined;\n  return {\n    provider: provider.id,\n    model: candidate.model,\n    prompt: params.prompt,\n    ...(params.cfg ? { cfg: params.cfg } : {}),\n    ...(params.agentDir ? { agentDir: params.agentDir } : {}),\n    ...(params.authStore ? { authStore: params.authStore } : {}),\n    ...(typeof params.timeoutMs === 'number' ? { timeoutMs: params.timeoutMs } : {}),\n    ...(params.signal ? { signal: params.signal } : {}),\n    ...(typeof params.count === 'number' ? { count: params.count } : {}),\n    ...(sanitized.size !== undefined ? { size: sanitized.size } : {}),\n    ...(sanitized.aspectRatio !== undefined ? { aspectRatio: sanitized.aspectRatio } : {}),\n    ...(sanitized.resolution !== undefined ? { resolution: sanitized.resolution } : {}),\n    ...(sanitized.quality !== undefined ? { quality: sanitized.quality } : {}),\n    ...(sanitized.outputFormat !== undefined ? { outputFormat: sanitized.outputFormat } : {}),\n    ...(sanitized.background !== undefined ? { background: sanitized.background } : {}),\n    ...(inputImages ? { inputImages } : {}),\n    ...(params.providerOptions ? { providerOptions: params.providerOptions } : {}),\n  };\n}\n\nfunction cloneInputImages(images: ImageGenerationSourceImage[]): ImageGenerationSourceImage[] {\n  return images.map((img) => ({\n    buffer: img.buffer,\n    mimeType: img.mimeType,\n    ...(img.fileName ? { fileName: img.fileName } : {}),\n    ...(img.metadata ? { metadata: img.metadata } : {}),\n  }));\n}\n\nfunction toCapabilityCandidate(provider: ImageGenerationProvider): CapabilityProviderCandidate {\n  return {\n    id: provider.id,\n    ...(provider.aliases ? { aliases: provider.aliases } : {}),\n    defaultModel: provider.defaultModel ?? null,\n    models: provider.models ?? [],\n    isConfigured: provider.isConfigured,\n  };\n}\n\nfunction buildNoImageGenerationModelConfiguredMessage(\n  cfg: Config | undefined,\n  deps: ImageGenerationRuntimeDeps,\n): string {\n  const list = (deps.listProviders ?? listImageGenerationProviders)(cfg);\n  return buildNoCapabilityModelConfiguredMessage({\n    capabilityLabel: 'image-generation',\n    modelConfigKey: 'imageGenerationModel',\n    providers: list.map(toCapabilityCandidate),\n    getProviderEnvVars: deps.getProviderEnvVars ?? ((id) => PROVIDER_ENV_MAP[id]),\n  });\n}\n\n// Re-export the canonical capability type for callers consuming this barrel.\nexport type { ImageGenerationProviderCapabilities };\n// Re-export the provider-registry surface that gateway routes / CLI consume\n// through this single barrel module. NOTE: `listImageGenerationProvidersSummary`\n// is implemented locally above (it overlays cfg-aware `configured` flags), so\n// it must not be re-exported from the registry to avoid a name clash.\nexport {\n  getImageGenerationProvider,\n  listImageGenerationProviders,\n} from './provider-registry.js';\n"],"mappings":"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"}

package/dist/src/agent/image/image-helpers.d.ts

@@ -14,7 +14,7 @@ export declare function coerceImageAssistantText(params: {
     provider: string;
     model: string;
 }): string;
-export declare function coerceImageModelConfig(cfg?: Config): ImageModelConfig;
+export declare function coerceImageModelConfig(_cfg?: Config): ImageModelConfig;
 export declare function applyImageGenerationModelConfigDefaults(cfg: Config | undefined, imageGenerationModelConfig: ToolModelConfig): Config | undefined;
 export declare function resolvePromptAndModelOverride(args: Record<string, unknown>, defaultPrompt: string): {
     prompt: string;

package/dist/src/agent/image/image-helpers.js

@@ -25,26 +25,13 @@ function coerceImageAssistantText(params) {
 	if (text.trim()) return text.trim();
 	throw new Error(`Image model returned no text (${params.provider}/${params.model}).`);
 }
-function coerceImageModelConfig(cfg) {
-	return coerceToolModelConfig(cfg?.agents?.defaults?.imageModel);
+function coerceImageModelConfig(_cfg) {
+	return coerceToolModelConfig(void 0);
 }
 function applyImageGenerationModelConfigDefaults(cfg, imageGenerationModelConfig) {
 	if (!cfg) return;
-	const primary = imageGenerationModelConfig.primary?.trim();
-	if (!primary) return cfg;
-	return {
-		...cfg,
-		agents: {
-			...cfg.agents,
-			defaults: {
-				...cfg.agents?.defaults,
-				imageGenerationModel: {
-					primary,
-					...imageGenerationModelConfig.fallbacks?.length ? { fallbacks: imageGenerationModelConfig.fallbacks } : {}
-				}
-			}
-		}
-	};
+	if (!imageGenerationModelConfig.primary?.trim()) return cfg;
+	return cfg;
 }
 function resolvePromptAndModelOverride(args, defaultPrompt) {
 	return {

package/dist/src/agent/image/image-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-helpers.js","names":[],"sources":["../../../../src/agent/image/image-helpers.ts"],"sourcesContent":["import type { AgentToolResult } from '@earendil-works/pi-agent-core';\nimport type { AssistantMessage } from '@earendil-works/pi-ai';\nimport type { Config } from '../../config/schema.js';\nimport { extractTextContent } from '../context/workspace.js';\nimport type { ImageAttempt } from './image-model-fallback.js';\nimport { coerceToolModelConfig, type ToolModelConfig } from './tool-model-config.js';\n\nexport type ImageModelConfig = ToolModelConfig;\n\nexport function decodeDataUrl(dataUrl: string): {\n  buffer: Buffer;\n  mimeType: string;\n  kind: 'image';\n} {\n  const trimmed = dataUrl.trim();\n  const match = /^data:([^;,]+);base64,([a-z0-9+/=\\r\\n]+)$/i.exec(trimmed);\n  if (!match) {\n    throw new Error('Invalid data URL (expected base64 data: URL).');\n  }\n  const mimeType = (match[1] ?? '').trim().toLowerCase();\n  if (!mimeType.startsWith('image/')) {\n    throw new Error(`Unsupported data URL type: ${mimeType || 'unknown'}`);\n  }\n  const b64 = (match[2] ?? '').trim();\n  const buffer = Buffer.from(b64, 'base64');\n  if (buffer.length === 0) {\n    throw new Error('Invalid data URL: empty payload.');\n  }\n  return { buffer, mimeType, kind: 'image' };\n}\n\nexport function coerceImageAssistantText(params: {\n  message: AssistantMessage;\n  provider: string;\n  model: string;\n}): string {\n  const stop = params.message.stopReason;\n  const errorMessage = params.message.errorMessage?.trim();\n  if (stop === 'error' || stop === 'aborted') {\n    throw new Error(\n      errorMessage\n        ? `Image model failed (${params.provider}/${params.model}): ${errorMessage}`\n        : `Image model failed (${params.provider}/${params.model})`,\n    );\n  }\n  if (errorMessage) {\n    throw new Error(`Image model failed (${params.provider}/${params.model}): ${errorMessage}`);\n  }\n  const text = extractTextContent(\n    params.message.content as Array<{ type: string; text?: string }>,\n  );\n  if (text.trim()) {\n    return text.trim();\n  }\n  throw new Error(`Image model returned no text (${params.provider}/${params.model}).`);\n}\n\nexport function coerceImageModelConfig(cfg?: Config): ImageModelConfig {\n  return coerceToolModelConfig(cfg?.agents?.defaults?.imageModel);\n}\n\nexport function applyImageGenerationModelConfigDefaults(\n  cfg: Config | undefined,\n  imageGenerationModelConfig: ToolModelConfig,\n): Config | undefined {\n  if (!cfg) {\n    return undefined;\n  }\n  const primary = imageGenerationModelConfig.primary?.trim();\n  if (!primary) {\n    return cfg;\n  }\n  return {\n    ...cfg,\n    agents: {\n      ...cfg.agents,\n      defaults: {\n        ...cfg.agents?.defaults,\n        imageGenerationModel: {\n          primary,\n          ...(imageGenerationModelConfig.fallbacks?.length ? { fallbacks: imageGenerationModelConfig.fallbacks } : {}),\n        },\n      },\n    },\n  };\n}\n\nexport function resolvePromptAndModelOverride(\n  args: Record<string, unknown>,\n  defaultPrompt: string,\n): {\n  prompt: string;\n  modelOverride?: string;\n} {\n  const prompt =\n    typeof args.prompt === 'string' && args.prompt.trim() ? args.prompt.trim() : defaultPrompt;\n  const modelOverride =\n    typeof args.model === 'string' && args.model.trim() ? args.model.trim() : undefined;\n  return { prompt, modelOverride };\n}\n\nexport function buildImageToolTextResult(\n  result: { text: string; provider: string; model: string; attempts: ImageAttempt[] },\n  extraDetails: Record<string, unknown>,\n): AgentToolResult<Record<string, unknown>> {\n  return {\n    content: [{ type: 'text', text: result.text }],\n    details: {\n      model: `${result.provider}/${result.model}`,\n      ...extraDetails,\n      attempts: result.attempts,\n    },\n  };\n}\n"],"mappings":";;;AASA,SAAgB,cAAc,SAI5B;CACA,MAAM,UAAU,QAAQ,MAAM;CAC9B,MAAM,QAAQ,6CAA6C,KAAK,QAAQ;AACxE,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,gDAAgD;CAElE,MAAM,YAAY,MAAM,MAAM,IAAI,MAAM,CAAC,aAAa;AACtD,KAAI,CAAC,SAAS,WAAW,SAAS,CAChC,OAAM,IAAI,MAAM,8BAA8B,YAAY,YAAY;CAExE,MAAM,OAAO,MAAM,MAAM,IAAI,MAAM;CACnC,MAAM,SAAS,OAAO,KAAK,KAAK,SAAS;AACzC,KAAI,OAAO,WAAW,EACpB,OAAM,IAAI,MAAM,mCAAmC;AAErD,QAAO;EAAE;EAAQ;EAAU,MAAM;EAAS;;AAG5C,SAAgB,yBAAyB,QAI9B;CACT,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,eAAe,OAAO,QAAQ,cAAc,MAAM;AACxD,KAAI,SAAS,WAAW,SAAS,UAC/B,OAAM,IAAI,MACR,eACI,uBAAuB,OAAO,SAAS,GAAG,OAAO,MAAM,KAAK,iBAC5D,uBAAuB,OAAO,SAAS,GAAG,OAAO,MAAM,GAC5D;AAEH,KAAI,aACF,OAAM,IAAI,MAAM,uBAAuB,OAAO,SAAS,GAAG,OAAO,MAAM,KAAK,eAAe;CAE7F,MAAM,OAAO,mBACX,OAAO,QAAQ,QAChB;AACD,KAAI,KAAK,MAAM,CACb,QAAO,KAAK,MAAM;AAEpB,OAAM,IAAI,MAAM,iCAAiC,OAAO,SAAS,GAAG,OAAO,MAAM,IAAI;;AAGvF,SAAgB,uBAAuB,KAAgC;AACrE,QAAO,sBAAsB,KAAK,QAAQ,UAAU,WAAW;;AAGjE,SAAgB,wCACd,KACA,4BACoB;AACpB,KAAI,CAAC,IACH;CAEF,MAAM,UAAU,2BAA2B,SAAS,MAAM;AAC1D,KAAI,CAAC,QACH,QAAO;AAET,QAAO;EACL,GAAG;EACH,QAAQ;GACN,GAAG,IAAI;GACP,UAAU;IACR,GAAG,IAAI,QAAQ;IACf,sBAAsB;KACpB;KACA,GAAI,2BAA2B,WAAW,SAAS,EAAE,WAAW,2BAA2B,WAAW,GAAG,EAAE;KAC5G;IACF;GACF;EACF;;AAGH,SAAgB,8BACd,MACA,eAIA;AAKA,QAAO;EAAE,QAHP,OAAO,KAAK,WAAW,YAAY,KAAK,OAAO,MAAM,GAAG,KAAK,OAAO,MAAM,GAAG;EAG9D,eADf,OAAO,KAAK,UAAU,YAAY,KAAK,MAAM,MAAM,GAAG,KAAK,MAAM,MAAM,GAAG,KAAA;EAC5C;;AAGlC,SAAgB,yBACd,QACA,cAC0C;AAC1C,QAAO;EACL,SAAS,CAAC;GAAE,MAAM;GAAQ,MAAM,OAAO;GAAM,CAAC;EAC9C,SAAS;GACP,OAAO,GAAG,OAAO,SAAS,GAAG,OAAO;GACpC,GAAG;GACH,UAAU,OAAO;GAClB;EACF"}
+{"version":3,"file":"image-helpers.js","names":[],"sources":["../../../../src/agent/image/image-helpers.ts"],"sourcesContent":["import type { AgentToolResult } from '@earendil-works/pi-agent-core';\nimport type { AssistantMessage } from '@earendil-works/pi-ai';\nimport type { Config } from '../../config/schema.js';\nimport { extractTextContent } from '../context/workspace.js';\nimport type { ImageAttempt } from './image-model-fallback.js';\nimport { coerceToolModelConfig, type ToolModelConfig } from './tool-model-config.js';\n\nexport type ImageModelConfig = ToolModelConfig;\n\nexport function decodeDataUrl(dataUrl: string): {\n  buffer: Buffer;\n  mimeType: string;\n  kind: 'image';\n} {\n  const trimmed = dataUrl.trim();\n  const match = /^data:([^;,]+);base64,([a-z0-9+/=\\r\\n]+)$/i.exec(trimmed);\n  if (!match) {\n    throw new Error('Invalid data URL (expected base64 data: URL).');\n  }\n  const mimeType = (match[1] ?? '').trim().toLowerCase();\n  if (!mimeType.startsWith('image/')) {\n    throw new Error(`Unsupported data URL type: ${mimeType || 'unknown'}`);\n  }\n  const b64 = (match[2] ?? '').trim();\n  const buffer = Buffer.from(b64, 'base64');\n  if (buffer.length === 0) {\n    throw new Error('Invalid data URL: empty payload.');\n  }\n  return { buffer, mimeType, kind: 'image' };\n}\n\nexport function coerceImageAssistantText(params: {\n  message: AssistantMessage;\n  provider: string;\n  model: string;\n}): string {\n  const stop = params.message.stopReason;\n  const errorMessage = params.message.errorMessage?.trim();\n  if (stop === 'error' || stop === 'aborted') {\n    throw new Error(\n      errorMessage\n        ? `Image model failed (${params.provider}/${params.model}): ${errorMessage}`\n        : `Image model failed (${params.provider}/${params.model})`,\n    );\n  }\n  if (errorMessage) {\n    throw new Error(`Image model failed (${params.provider}/${params.model}): ${errorMessage}`);\n  }\n  const text = extractTextContent(\n    params.message.content as Array<{ type: string; text?: string }>,\n  );\n  if (text.trim()) {\n    return text.trim();\n  }\n  throw new Error(`Image model returned no text (${params.provider}/${params.model}).`);\n}\n\nexport function coerceImageModelConfig(_cfg?: Config): ImageModelConfig {\n  return coerceToolModelConfig(undefined);\n}\n\nexport function applyImageGenerationModelConfigDefaults(\n  cfg: Config | undefined,\n  imageGenerationModelConfig: ToolModelConfig,\n): Config | undefined {\n  if (!cfg) {\n    return undefined;\n  }\n  const primary = imageGenerationModelConfig.primary?.trim();\n  if (!primary) {\n    return cfg;\n  }\n  return cfg;\n}\n\nexport function resolvePromptAndModelOverride(\n  args: Record<string, unknown>,\n  defaultPrompt: string,\n): {\n  prompt: string;\n  modelOverride?: string;\n} {\n  const prompt =\n    typeof args.prompt === 'string' && args.prompt.trim() ? args.prompt.trim() : defaultPrompt;\n  const modelOverride =\n    typeof args.model === 'string' && args.model.trim() ? args.model.trim() : undefined;\n  return { prompt, modelOverride };\n}\n\nexport function buildImageToolTextResult(\n  result: { text: string; provider: string; model: string; attempts: ImageAttempt[] },\n  extraDetails: Record<string, unknown>,\n): AgentToolResult<Record<string, unknown>> {\n  return {\n    content: [{ type: 'text', text: result.text }],\n    details: {\n      model: `${result.provider}/${result.model}`,\n      ...extraDetails,\n      attempts: result.attempts,\n    },\n  };\n}\n"],"mappings":";;;AASA,SAAgB,cAAc,SAI5B;CACA,MAAM,UAAU,QAAQ,MAAM;CAC9B,MAAM,QAAQ,6CAA6C,KAAK,QAAQ;AACxE,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,gDAAgD;CAElE,MAAM,YAAY,MAAM,MAAM,IAAI,MAAM,CAAC,aAAa;AACtD,KAAI,CAAC,SAAS,WAAW,SAAS,CAChC,OAAM,IAAI,MAAM,8BAA8B,YAAY,YAAY;CAExE,MAAM,OAAO,MAAM,MAAM,IAAI,MAAM;CACnC,MAAM,SAAS,OAAO,KAAK,KAAK,SAAS;AACzC,KAAI,OAAO,WAAW,EACpB,OAAM,IAAI,MAAM,mCAAmC;AAErD,QAAO;EAAE;EAAQ;EAAU,MAAM;EAAS;;AAG5C,SAAgB,yBAAyB,QAI9B;CACT,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,eAAe,OAAO,QAAQ,cAAc,MAAM;AACxD,KAAI,SAAS,WAAW,SAAS,UAC/B,OAAM,IAAI,MACR,eACI,uBAAuB,OAAO,SAAS,GAAG,OAAO,MAAM,KAAK,iBAC5D,uBAAuB,OAAO,SAAS,GAAG,OAAO,MAAM,GAC5D;AAEH,KAAI,aACF,OAAM,IAAI,MAAM,uBAAuB,OAAO,SAAS,GAAG,OAAO,MAAM,KAAK,eAAe;CAE7F,MAAM,OAAO,mBACX,OAAO,QAAQ,QAChB;AACD,KAAI,KAAK,MAAM,CACb,QAAO,KAAK,MAAM;AAEpB,OAAM,IAAI,MAAM,iCAAiC,OAAO,SAAS,GAAG,OAAO,MAAM,IAAI;;AAGvF,SAAgB,uBAAuB,MAAiC;AACtE,QAAO,sBAAsB,KAAA,EAAU;;AAGzC,SAAgB,wCACd,KACA,4BACoB;AACpB,KAAI,CAAC,IACH;AAGF,KAAI,CADY,2BAA2B,SAAS,MAAM,CAExD,QAAO;AAET,QAAO;;AAGT,SAAgB,8BACd,MACA,eAIA;AAKA,QAAO;EAAE,QAHP,OAAO,KAAK,WAAW,YAAY,KAAK,OAAO,MAAM,GAAG,KAAK,OAAO,MAAM,GAAG;EAG9D,eADf,OAAO,KAAK,UAAU,YAAY,KAAK,MAAM,MAAM,GAAG,KAAK,MAAM,MAAM,GAAG,KAAA;EAC5C;;AAGlC,SAAgB,yBACd,QACA,cAC0C;AAC1C,QAAO;EACL,SAAS,CAAC;GAAE,MAAM;GAAQ,MAAM,OAAO;GAAM,CAAC;EAC9C,SAAS;GACP,OAAO,GAAG,OAAO,SAAS,GAAG,OAAO;GACpC,GAAG;GACH,UAAU,OAAO;GAClB;EACF"}

package/dist/src/agent/image/image-model-fallback.js

@@ -21,7 +21,7 @@ async function runWithImageModelFallback(params) {
 		toolConfig: params.toolConfig,
 		modelOverride: params.modelOverride
 	});
-	if (refs.length === 0) throw new Error("No image model configured. Set agents.defaults.imageModel.primary or add fallbacks.");
+	if (refs.length === 0) throw new Error("No image-capable model is available.");
 	const attempts = [];
 	let lastErr;
 	for (const modelRef of refs) try {

package/dist/src/agent/image/image-model-fallback.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-model-fallback.js","names":[],"sources":["../../../../src/agent/image/image-model-fallback.ts"],"sourcesContent":["import type { ToolModelConfig } from './tool-model-config.js';\n\nexport type ImageAttempt = { provider: string; model: string; error: string };\n\nfunction collectModelRefs(params: {\n  toolConfig: ToolModelConfig;\n  modelOverride?: string;\n}): string[] {\n  const refs: string[] = [];\n  const add = (raw: string | undefined) => {\n    const t = raw?.trim();\n    if (t?.includes('/')) {\n      refs.push(t);\n    }\n  };\n  add(params.modelOverride);\n  add(params.toolConfig.primary);\n  for (const f of params.toolConfig.fallbacks ?? []) {\n    add(f);\n  }\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const r of refs) {\n    if (!seen.has(r)) {\n      seen.add(r);\n      out.push(r);\n    }\n  }\n  return out;\n}\n\nexport async function runWithImageModelFallback<T>(params: {\n  toolConfig: ToolModelConfig;\n  modelOverride?: string;\n  run: (modelRef: string) => Promise<T>;\n}): Promise<{ result: T; attempts: ImageAttempt[] }> {\n  const refs = collectModelRefs({\n    toolConfig: params.toolConfig,\n    modelOverride: params.modelOverride,\n  });\n  if (refs.length === 0) {\n    throw new Error(\n      'No image model configured. Set agents.defaults.imageModel.primary or add fallbacks.',\n    );\n  }\n\n  const attempts: ImageAttempt[] = [];\n  let lastErr: unknown;\n\n  for (const modelRef of refs) {\n    try {\n      const result = await params.run(modelRef);\n      return { result, attempts };\n    } catch (err) {\n      lastErr = err;\n      const msg = err instanceof Error ? err.message : String(err);\n      const slash = modelRef.indexOf('/');\n      attempts.push({\n        provider: slash > 0 ? modelRef.slice(0, slash) : modelRef,\n        model: slash > 0 ? modelRef.slice(slash + 1) : '',\n        error: msg,\n      });\n    }\n  }\n\n  const summary = attempts.map((a) => `${a.provider}/${a.model}: ${a.error}`).join(' | ');\n  throw new Error(\n    `All image models failed (${attempts.length}): ${summary || (lastErr instanceof Error ? lastErr.message : String(lastErr))}`,\n  );\n}\n"],"mappings":";AAIA,SAAS,iBAAiB,QAGb;CACX,MAAM,OAAiB,EAAE;CACzB,MAAM,OAAO,QAA4B;EACvC,MAAM,IAAI,KAAK,MAAM;AACrB,MAAI,GAAG,SAAS,IAAI,CAClB,MAAK,KAAK,EAAE;;AAGhB,KAAI,OAAO,cAAc;AACzB,KAAI,OAAO,WAAW,QAAQ;AAC9B,MAAK,MAAM,KAAK,OAAO,WAAW,aAAa,EAAE,CAC/C,KAAI,EAAE;CAER,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,MAAgB,EAAE;AACxB,MAAK,MAAM,KAAK,KACd,KAAI,CAAC,KAAK,IAAI,EAAE,EAAE;AAChB,OAAK,IAAI,EAAE;AACX,MAAI,KAAK,EAAE;;AAGf,QAAO;;AAGT,eAAsB,0BAA6B,QAIE;CACnD,MAAM,OAAO,iBAAiB;EAC5B,YAAY,OAAO;EACnB,eAAe,OAAO;EACvB,CAAC;AACF,KAAI,KAAK,WAAW,EAClB,OAAM,IAAI,MACR,sFACD;CAGH,MAAM,WAA2B,EAAE;CACnC,IAAI;AAEJ,MAAK,MAAM,YAAY,KACrB,KAAI;AAEF,SAAO;GAAE,QAAA,MADY,OAAO,IAAI,SAAS;GACxB;GAAU;UACpB,KAAK;AACZ,YAAU;EACV,MAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;EAC5D,MAAM,QAAQ,SAAS,QAAQ,IAAI;AACnC,WAAS,KAAK;GACZ,UAAU,QAAQ,IAAI,SAAS,MAAM,GAAG,MAAM,GAAG;GACjD,OAAO,QAAQ,IAAI,SAAS,MAAM,QAAQ,EAAE,GAAG;GAC/C,OAAO;GACR,CAAC;;CAIN,MAAM,UAAU,SAAS,KAAK,MAAM,GAAG,EAAE,SAAS,GAAG,EAAE,MAAM,IAAI,EAAE,QAAQ,CAAC,KAAK,MAAM;AACvF,OAAM,IAAI,MACR,4BAA4B,SAAS,OAAO,KAAK,YAAY,mBAAmB,QAAQ,QAAQ,UAAU,OAAO,QAAQ,IAC1H"}
+{"version":3,"file":"image-model-fallback.js","names":[],"sources":["../../../../src/agent/image/image-model-fallback.ts"],"sourcesContent":["import type { ToolModelConfig } from './tool-model-config.js';\n\nexport type ImageAttempt = { provider: string; model: string; error: string };\n\nfunction collectModelRefs(params: {\n  toolConfig: ToolModelConfig;\n  modelOverride?: string;\n}): string[] {\n  const refs: string[] = [];\n  const add = (raw: string | undefined) => {\n    const t = raw?.trim();\n    if (t?.includes('/')) {\n      refs.push(t);\n    }\n  };\n  add(params.modelOverride);\n  add(params.toolConfig.primary);\n  for (const f of params.toolConfig.fallbacks ?? []) {\n    add(f);\n  }\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const r of refs) {\n    if (!seen.has(r)) {\n      seen.add(r);\n      out.push(r);\n    }\n  }\n  return out;\n}\n\nexport async function runWithImageModelFallback<T>(params: {\n  toolConfig: ToolModelConfig;\n  modelOverride?: string;\n  run: (modelRef: string) => Promise<T>;\n}): Promise<{ result: T; attempts: ImageAttempt[] }> {\n  const refs = collectModelRefs({\n    toolConfig: params.toolConfig,\n    modelOverride: params.modelOverride,\n  });\n  if (refs.length === 0) {\n    throw new Error(\n      'No image-capable model is available.',\n    );\n  }\n\n  const attempts: ImageAttempt[] = [];\n  let lastErr: unknown;\n\n  for (const modelRef of refs) {\n    try {\n      const result = await params.run(modelRef);\n      return { result, attempts };\n    } catch (err) {\n      lastErr = err;\n      const msg = err instanceof Error ? err.message : String(err);\n      const slash = modelRef.indexOf('/');\n      attempts.push({\n        provider: slash > 0 ? modelRef.slice(0, slash) : modelRef,\n        model: slash > 0 ? modelRef.slice(slash + 1) : '',\n        error: msg,\n      });\n    }\n  }\n\n  const summary = attempts.map((a) => `${a.provider}/${a.model}: ${a.error}`).join(' | ');\n  throw new Error(\n    `All image models failed (${attempts.length}): ${summary || (lastErr instanceof Error ? lastErr.message : String(lastErr))}`,\n  );\n}\n"],"mappings":";AAIA,SAAS,iBAAiB,QAGb;CACX,MAAM,OAAiB,EAAE;CACzB,MAAM,OAAO,QAA4B;EACvC,MAAM,IAAI,KAAK,MAAM;AACrB,MAAI,GAAG,SAAS,IAAI,CAClB,MAAK,KAAK,EAAE;;AAGhB,KAAI,OAAO,cAAc;AACzB,KAAI,OAAO,WAAW,QAAQ;AAC9B,MAAK,MAAM,KAAK,OAAO,WAAW,aAAa,EAAE,CAC/C,KAAI,EAAE;CAER,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,MAAgB,EAAE;AACxB,MAAK,MAAM,KAAK,KACd,KAAI,CAAC,KAAK,IAAI,EAAE,EAAE;AAChB,OAAK,IAAI,EAAE;AACX,MAAI,KAAK,EAAE;;AAGf,QAAO;;AAGT,eAAsB,0BAA6B,QAIE;CACnD,MAAM,OAAO,iBAAiB;EAC5B,YAAY,OAAO;EACnB,eAAe,OAAO;EACvB,CAAC;AACF,KAAI,KAAK,WAAW,EAClB,OAAM,IAAI,MACR,uCACD;CAGH,MAAM,WAA2B,EAAE;CACnC,IAAI;AAEJ,MAAK,MAAM,YAAY,KACrB,KAAI;AAEF,SAAO;GAAE,QAAA,MADY,OAAO,IAAI,SAAS;GACxB;GAAU;UACpB,KAAK;AACZ,YAAU;EACV,MAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;EAC5D,MAAM,QAAQ,SAAS,QAAQ,IAAI;AACnC,WAAS,KAAK;GACZ,UAAU,QAAQ,IAAI,SAAS,MAAM,GAAG,MAAM,GAAG;GACjD,OAAO,QAAQ,IAAI,SAAS,MAAM,QAAQ,EAAE,GAAG;GAC/C,OAAO;GACR,CAAC;;CAIN,MAAM,UAAU,SAAS,KAAK,MAAM,GAAG,EAAE,SAAS,GAAG,EAAE,MAAM,IAAI,EAAE,QAAQ,CAAC,KAAK,MAAM;AACvF,OAAM,IAAI,MACR,4BAA4B,SAAS,OAAO,KAAK,YAAY,mBAAmB,QAAQ,QAAQ,UAAU,OAAO,QAAQ,IAC1H"}

package/dist/src/agent/image/inbound-image-handling.js

@@ -13,7 +13,7 @@ async function resolveInboundImageContentParts(params) {
 	const fallbacks = toolCfg?.fallbacks ?? [];
 	if (!primary) return [{
 		type: "text",
-		text: `[${params.images.length} image(s) attached; configure agents.defaults.imageModel to describe them.]`
+		text: `[${params.images.length} image(s) attached; no image-capable model is available to describe them.]`
 	}];
 	try {
 		return [{

package/dist/src/agent/image/inbound-image-handling.js.map

@@ -1 +1 @@
-{"version":3,"file":"inbound-image-handling.js","names":[],"sources":["../../../../src/agent/image/inbound-image-handling.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { describeImagesWithFallback } from './understanding/runtime.js';\nimport { resolveImageModelConfigForTool } from './tool-model-config.js';\nimport { resolveImageHandlingStrategy } from './vision-detection.js';\n\nexport async function resolveInboundImageContentParts(params: {\n  modelRef: string;\n  cfg?: Config;\n  userTextForContext: string;\n  images: Array<{ data: string; mimeType: string }>;\n}): Promise<Array<{ type: 'image'; data: string; mimeType: string } | { type: 'text'; text: string }>> {\n  const strategy = resolveImageHandlingStrategy(params.modelRef);\n  if (strategy === 'native') {\n    return params.images.map((att) => ({\n      type: 'image' as const,\n      data: att.data,\n      mimeType: att.mimeType,\n    }));\n  }\n\n  const toolCfg = resolveImageModelConfigForTool({ cfg: params.cfg });\n  const primary = toolCfg?.primary;\n  const fallbacks = toolCfg?.fallbacks ?? [];\n\n  if (!primary) {\n    return [\n      {\n        type: 'text' as const,\n        text: `[${params.images.length} image(s) attached; configure agents.defaults.imageModel to describe them.]`,\n      },\n    ];\n  }\n\n  try {\n    const buffers = params.images.map((att) => ({\n      buffer: Buffer.from(att.data, 'base64'),\n      mimeType: att.mimeType,\n    }));\n    const prompt = params.userTextForContext.trim()\n      ? `Describe these images in the context of the user's message: \"${params.userTextForContext}\"`\n      : 'Describe these images in detail.';\n    const result = await describeImagesWithFallback({\n      modelRef: primary,\n      fallbacks,\n      images: buffers,\n      prompt,\n      maxTokens: 1024,\n      timeoutMs: 30_000,\n    });\n    return [{ type: 'text' as const, text: `[Image description: ${result.text}]` }];\n  } catch (err) {\n    return [\n      {\n        type: 'text' as const,\n        text: `[${params.images.length} image(s) attached but could not be described: ${err instanceof Error ? err.message : String(err)}]`,\n      },\n    ];\n  }\n}\n"],"mappings":";;;;AAKA,eAAsB,gCAAgC,QAKiD;AAErG,KADiB,6BAA6B,OAAO,SACzC,KAAK,SACf,QAAO,OAAO,OAAO,KAAK,SAAS;EACjC,MAAM;EACN,MAAM,IAAI;EACV,UAAU,IAAI;EACf,EAAE;CAGL,MAAM,UAAU,+BAA+B,EAAE,KAAK,OAAO,KAAK,CAAC;CACnE,MAAM,UAAU,SAAS;CACzB,MAAM,YAAY,SAAS,aAAa,EAAE;AAE1C,KAAI,CAAC,QACH,QAAO,CACL;EACE,MAAM;EACN,MAAM,IAAI,OAAO,OAAO,OAAO;EAChC,CACF;AAGH,KAAI;AAgBF,SAAO,CAAC;GAAE,MAAM;GAAiB,MAAM,wBAAuB,MARzC,2BAA2B;IAC9C,UAAU;IACV;IACA,QAVc,OAAO,OAAO,KAAK,SAAS;KAC1C,QAAQ,OAAO,KAAK,IAAI,MAAM,SAAS;KACvC,UAAU,IAAI;KACf,EAOgB;IACf,QAPa,OAAO,mBAAmB,MAAM,GAC3C,gEAAgE,OAAO,mBAAmB,KAC1F;IAMF,WAAW;IACX,WAAW;IACZ,CAAC,EACmE,KAAK;GAAI,CAAC;UACxE,KAAK;AACZ,SAAO,CACL;GACE,MAAM;GACN,MAAM,IAAI,OAAO,OAAO,OAAO,iDAAiD,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC;GAClI,CACF"}
+{"version":3,"file":"inbound-image-handling.js","names":[],"sources":["../../../../src/agent/image/inbound-image-handling.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { describeImagesWithFallback } from './understanding/runtime.js';\nimport { resolveImageModelConfigForTool } from './tool-model-config.js';\nimport { resolveImageHandlingStrategy } from './vision-detection.js';\n\nexport async function resolveInboundImageContentParts(params: {\n  modelRef: string;\n  cfg?: Config;\n  userTextForContext: string;\n  images: Array<{ data: string; mimeType: string }>;\n}): Promise<Array<{ type: 'image'; data: string; mimeType: string } | { type: 'text'; text: string }>> {\n  const strategy = resolveImageHandlingStrategy(params.modelRef);\n  if (strategy === 'native') {\n    return params.images.map((att) => ({\n      type: 'image' as const,\n      data: att.data,\n      mimeType: att.mimeType,\n    }));\n  }\n\n  const toolCfg = resolveImageModelConfigForTool({ cfg: params.cfg });\n  const primary = toolCfg?.primary;\n  const fallbacks = toolCfg?.fallbacks ?? [];\n\n  if (!primary) {\n    return [\n      {\n        type: 'text' as const,\n        text: `[${params.images.length} image(s) attached; no image-capable model is available to describe them.]`,\n      },\n    ];\n  }\n\n  try {\n    const buffers = params.images.map((att) => ({\n      buffer: Buffer.from(att.data, 'base64'),\n      mimeType: att.mimeType,\n    }));\n    const prompt = params.userTextForContext.trim()\n      ? `Describe these images in the context of the user's message: \"${params.userTextForContext}\"`\n      : 'Describe these images in detail.';\n    const result = await describeImagesWithFallback({\n      modelRef: primary,\n      fallbacks,\n      images: buffers,\n      prompt,\n      maxTokens: 1024,\n      timeoutMs: 30_000,\n    });\n    return [{ type: 'text' as const, text: `[Image description: ${result.text}]` }];\n  } catch (err) {\n    return [\n      {\n        type: 'text' as const,\n        text: `[${params.images.length} image(s) attached but could not be described: ${err instanceof Error ? err.message : String(err)}]`,\n      },\n    ];\n  }\n}\n"],"mappings":";;;;AAKA,eAAsB,gCAAgC,QAKiD;AAErG,KADiB,6BAA6B,OAAO,SACzC,KAAK,SACf,QAAO,OAAO,OAAO,KAAK,SAAS;EACjC,MAAM;EACN,MAAM,IAAI;EACV,UAAU,IAAI;EACf,EAAE;CAGL,MAAM,UAAU,+BAA+B,EAAE,KAAK,OAAO,KAAK,CAAC;CACnE,MAAM,UAAU,SAAS;CACzB,MAAM,YAAY,SAAS,aAAa,EAAE;AAE1C,KAAI,CAAC,QACH,QAAO,CACL;EACE,MAAM;EACN,MAAM,IAAI,OAAO,OAAO,OAAO;EAChC,CACF;AAGH,KAAI;AAgBF,SAAO,CAAC;GAAE,MAAM;GAAiB,MAAM,wBAAuB,MARzC,2BAA2B;IAC9C,UAAU;IACV;IACA,QAVc,OAAO,OAAO,KAAK,SAAS;KAC1C,QAAQ,OAAO,KAAK,IAAI,MAAM,SAAS;KACvC,UAAU,IAAI;KACf,EAOgB;IACf,QAPa,OAAO,mBAAmB,MAAM,GAC3C,gEAAgE,OAAO,mBAAmB,KAC1F;IAMF,WAAW;IACX,WAAW;IACZ,CAAC,EACmE,KAAK;GAAI,CAAC;UACxE,KAAK;AACZ,SAAO,CACL;GACE,MAAM;GACN,MAAM,IAAI,OAAO,OAAO,OAAO,iDAAiD,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC;GAClI,CACF"}

package/dist/src/agent/image/load-image-media.js

@@ -1,8 +1,8 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { decodeDataUrl } from "./image-helpers.js";
-import { promises } from "node:fs";
-import path from "node:path";
 import { homedir } from "node:os";
+import path from "node:path";
+import { promises } from "node:fs";
 //#region src/agent/image/load-image-media.ts
 function expandUser(p) {
 	if (p.startsWith("~/") || p === "~") return path.join(homedir(), p.slice(1));

package/dist/src/agent/image/tool-model-config.d.ts

@@ -14,7 +14,7 @@ export declare function buildToolModelConfigFromCandidates(params: {
     candidates: Array<string | null | undefined>;
 }): ToolModelConfig | null;
 /**
- * Effective image understanding model: explicit `agents.defaults.imageModel`, else inferred from configured providers.
+ * Effective image understanding model inferred from configured providers.
  */
 export declare function resolveImageModelConfigForTool(params: {
     cfg?: Config;

package/dist/src/agent/image/tool-model-config.js

@@ -49,10 +49,10 @@ function firstVisionModelRef(provider) {
 	return m ? `${provider}/${m.id}` : void 0;
 }
 /**
-* Effective image understanding model: explicit `agents.defaults.imageModel`, else inferred from configured providers.
+* Effective image understanding model inferred from configured providers.
 */
 function resolveImageModelConfigForTool(params) {
-	const explicit = coerceToolModelConfig(params.cfg?.agents?.defaults?.imageModel);
+	const explicit = coerceToolModelConfig(void 0);
 	if (hasToolModelConfig(explicit)) return explicit;
 	const primary = resolveDefaultModelRef(params.cfg);
 	const primaryCandidates = [];

package/dist/src/agent/image/tool-model-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-model-config.js","names":[],"sources":["../../../../src/agent/image/tool-model-config.ts"],"sourcesContent":["import type { AgentModelConfig, Config } from '../../config/schema.js';\nimport { getAgentDefaultModelRef, parseModelRef } from '../../config/schema.js';\nimport {\n  resolveAgentModelFallbackValues,\n  resolveAgentModelPrimaryValue,\n} from '../../config/model-input.js';\nimport { getDefaultModelSync, getModelsByProvider, isProviderConfiguredSync } from '../../providers/index.js';\n\nexport type ToolModelConfig = { primary?: string; fallbacks?: string[] };\n\nexport function hasToolModelConfig(model: ToolModelConfig | undefined): boolean {\n  return Boolean(\n    model?.primary?.trim() || (model?.fallbacks ?? []).some((entry) => entry.trim().length > 0),\n  );\n}\n\nexport function resolveDefaultModelRef(cfg?: Config): { provider: string; model: string } {\n  const ref = cfg ? getAgentDefaultModelRef(cfg) : undefined;\n  if (ref) {\n    const p = parseModelRef(ref);\n    if (p) {\n      return p;\n    }\n  }\n  const fallback = getDefaultModelSync(cfg);\n  const p2 = parseModelRef(fallback);\n  if (p2) {\n    return p2;\n  }\n  return { provider: 'deepseek', model: 'deepseek-v4-flash' };\n}\n\nexport function coerceToolModelConfig(model?: AgentModelConfig): ToolModelConfig {\n  const primary = resolveAgentModelPrimaryValue(model);\n  const fallbacks = resolveAgentModelFallbackValues(model);\n  return {\n    ...(primary?.trim() ? { primary: primary.trim() } : {}),\n    ...(fallbacks.length > 0 ? { fallbacks } : {}),\n  };\n}\n\nexport function buildToolModelConfigFromCandidates(params: {\n  explicit: ToolModelConfig;\n  candidates: Array<string | null | undefined>;\n}): ToolModelConfig | null {\n  if (hasToolModelConfig(params.explicit)) {\n    return params.explicit;\n  }\n\n  const deduped: string[] = [];\n  for (const candidate of params.candidates) {\n    const trimmed = candidate?.trim();\n    if (!trimmed || !trimmed.includes('/')) {\n      continue;\n    }\n    const provider = trimmed.slice(0, trimmed.indexOf('/')).trim();\n    if (!provider || !isProviderConfiguredSync(provider)) {\n      continue;\n    }\n    if (!deduped.includes(trimmed)) {\n      deduped.push(trimmed);\n    }\n  }\n\n  if (deduped.length === 0) {\n    return null;\n  }\n\n  return {\n    primary: deduped[0],\n    ...(deduped.length > 1 ? { fallbacks: deduped.slice(1) } : {}),\n  };\n}\n\nfunction firstVisionModelRef(provider: string): string | undefined {\n  const m = getModelsByProvider(provider).find((x) => x.input?.includes('image'));\n  return m ? `${provider}/${m.id}` : undefined;\n}\n\n/**\n * Effective image understanding model: explicit `agents.defaults.imageModel`, else inferred from configured providers.\n */\nexport function resolveImageModelConfigForTool(params: { cfg?: Config }): ToolModelConfig | null {\n  const explicit = coerceToolModelConfig(params.cfg?.agents?.defaults?.imageModel);\n  if (hasToolModelConfig(explicit)) {\n    return explicit;\n  }\n\n  const primary = resolveDefaultModelRef(params.cfg);\n  const primaryCandidates: string[] = [];\n  const vision = firstVisionModelRef(primary.provider);\n  if (vision) {\n    primaryCandidates.push(vision);\n  }\n  if (primary.provider === 'openai') {\n    primaryCandidates.push('openai/gpt-4o-mini');\n  }\n  if (primary.provider === 'anthropic') {\n    primaryCandidates.push('anthropic/claude-sonnet-4-5');\n  }\n  if (primary.provider === 'google') {\n    primaryCandidates.push('google/gemini-2.0-flash');\n  }\n\n  return buildToolModelConfigFromCandidates({\n    explicit,\n    candidates: [\n      ...primaryCandidates,\n      firstVisionModelRef('openai') ?? 'openai/gpt-4o-mini',\n      firstVisionModelRef('anthropic') ?? 'anthropic/claude-sonnet-4-5',\n    ],\n  });\n}\n"],"mappings":";;;;aACgF;gBAK8B;AAI9G,SAAgB,mBAAmB,OAA6C;AAC9E,QAAO,QACL,OAAO,SAAS,MAAM,KAAK,OAAO,aAAa,EAAE,EAAE,MAAM,UAAU,MAAM,MAAM,CAAC,SAAS,EAAE,CAC5F;;AAGH,SAAgB,uBAAuB,KAAmD;CACxF,MAAM,MAAM,MAAM,wBAAwB,IAAI,GAAG,KAAA;AACjD,KAAI,KAAK;EACP,MAAM,IAAI,cAAc,IAAI;AAC5B,MAAI,EACF,QAAO;;CAIX,MAAM,KAAK,cADM,oBAAoB,IACJ,CAAC;AAClC,KAAI,GACF,QAAO;AAET,QAAO;EAAE,UAAU;EAAY,OAAO;EAAqB;;AAG7D,SAAgB,sBAAsB,OAA2C;CAC/E,MAAM,UAAU,8BAA8B,MAAM;CACpD,MAAM,YAAY,gCAAgC,MAAM;AACxD,QAAO;EACL,GAAI,SAAS,MAAM,GAAG,EAAE,SAAS,QAAQ,MAAM,EAAE,GAAG,EAAE;EACtD,GAAI,UAAU,SAAS,IAAI,EAAE,WAAW,GAAG,EAAE;EAC9C;;AAGH,SAAgB,mCAAmC,QAGxB;AACzB,KAAI,mBAAmB,OAAO,SAAS,CACrC,QAAO,OAAO;CAGhB,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,aAAa,OAAO,YAAY;EACzC,MAAM,UAAU,WAAW,MAAM;AACjC,MAAI,CAAC,WAAW,CAAC,QAAQ,SAAS,IAAI,CACpC;EAEF,MAAM,WAAW,QAAQ,MAAM,GAAG,QAAQ,QAAQ,IAAI,CAAC,CAAC,MAAM;AAC9D,MAAI,CAAC,YAAY,CAAC,yBAAyB,SAAS,CAClD;AAEF,MAAI,CAAC,QAAQ,SAAS,QAAQ,CAC5B,SAAQ,KAAK,QAAQ;;AAIzB,KAAI,QAAQ,WAAW,EACrB,QAAO;AAGT,QAAO;EACL,SAAS,QAAQ;EACjB,GAAI,QAAQ,SAAS,IAAI,EAAE,WAAW,QAAQ,MAAM,EAAE,EAAE,GAAG,EAAE;EAC9D;;AAGH,SAAS,oBAAoB,UAAsC;CACjE,MAAM,IAAI,oBAAoB,SAAS,CAAC,MAAM,MAAM,EAAE,OAAO,SAAS,QAAQ,CAAC;AAC/E,QAAO,IAAI,GAAG,SAAS,GAAG,EAAE,OAAO,KAAA;;;;;AAMrC,SAAgB,+BAA+B,QAAkD;CAC/F,MAAM,WAAW,sBAAsB,OAAO,KAAK,QAAQ,UAAU,WAAW;AAChF,KAAI,mBAAmB,SAAS,CAC9B,QAAO;CAGT,MAAM,UAAU,uBAAuB,OAAO,IAAI;CAClD,MAAM,oBAA8B,EAAE;CACtC,MAAM,SAAS,oBAAoB,QAAQ,SAAS;AACpD,KAAI,OACF,mBAAkB,KAAK,OAAO;AAEhC,KAAI,QAAQ,aAAa,SACvB,mBAAkB,KAAK,qBAAqB;AAE9C,KAAI,QAAQ,aAAa,YACvB,mBAAkB,KAAK,8BAA8B;AAEvD,KAAI,QAAQ,aAAa,SACvB,mBAAkB,KAAK,0BAA0B;AAGnD,QAAO,mCAAmC;EACxC;EACA,YAAY;GACV,GAAG;GACH,oBAAoB,SAAS,IAAI;GACjC,oBAAoB,YAAY,IAAI;GACrC;EACF,CAAC"}
+{"version":3,"file":"tool-model-config.js","names":[],"sources":["../../../../src/agent/image/tool-model-config.ts"],"sourcesContent":["import type { AgentModelConfig, Config } from '../../config/schema.js';\nimport { getAgentDefaultModelRef, parseModelRef } from '../../config/schema.js';\nimport {\n  resolveAgentModelFallbackValues,\n  resolveAgentModelPrimaryValue,\n} from '../../config/model-input.js';\nimport { getDefaultModelSync, getModelsByProvider, isProviderConfiguredSync } from '../../providers/index.js';\n\nexport type ToolModelConfig = { primary?: string; fallbacks?: string[] };\n\nexport function hasToolModelConfig(model: ToolModelConfig | undefined): boolean {\n  return Boolean(\n    model?.primary?.trim() || (model?.fallbacks ?? []).some((entry) => entry.trim().length > 0),\n  );\n}\n\nexport function resolveDefaultModelRef(cfg?: Config): { provider: string; model: string } {\n  const ref = cfg ? getAgentDefaultModelRef(cfg) : undefined;\n  if (ref) {\n    const p = parseModelRef(ref);\n    if (p) {\n      return p;\n    }\n  }\n  const fallback = getDefaultModelSync(cfg);\n  const p2 = parseModelRef(fallback);\n  if (p2) {\n    return p2;\n  }\n  return { provider: 'deepseek', model: 'deepseek-v4-flash' };\n}\n\nexport function coerceToolModelConfig(model?: AgentModelConfig): ToolModelConfig {\n  const primary = resolveAgentModelPrimaryValue(model);\n  const fallbacks = resolveAgentModelFallbackValues(model);\n  return {\n    ...(primary?.trim() ? { primary: primary.trim() } : {}),\n    ...(fallbacks.length > 0 ? { fallbacks } : {}),\n  };\n}\n\nexport function buildToolModelConfigFromCandidates(params: {\n  explicit: ToolModelConfig;\n  candidates: Array<string | null | undefined>;\n}): ToolModelConfig | null {\n  if (hasToolModelConfig(params.explicit)) {\n    return params.explicit;\n  }\n\n  const deduped: string[] = [];\n  for (const candidate of params.candidates) {\n    const trimmed = candidate?.trim();\n    if (!trimmed || !trimmed.includes('/')) {\n      continue;\n    }\n    const provider = trimmed.slice(0, trimmed.indexOf('/')).trim();\n    if (!provider || !isProviderConfiguredSync(provider)) {\n      continue;\n    }\n    if (!deduped.includes(trimmed)) {\n      deduped.push(trimmed);\n    }\n  }\n\n  if (deduped.length === 0) {\n    return null;\n  }\n\n  return {\n    primary: deduped[0],\n    ...(deduped.length > 1 ? { fallbacks: deduped.slice(1) } : {}),\n  };\n}\n\nfunction firstVisionModelRef(provider: string): string | undefined {\n  const m = getModelsByProvider(provider).find((x) => x.input?.includes('image'));\n  return m ? `${provider}/${m.id}` : undefined;\n}\n\n/**\n * Effective image understanding model inferred from configured providers.\n */\nexport function resolveImageModelConfigForTool(params: { cfg?: Config }): ToolModelConfig | null {\n  const explicit = coerceToolModelConfig(undefined);\n  if (hasToolModelConfig(explicit)) {\n    return explicit;\n  }\n\n  const primary = resolveDefaultModelRef(params.cfg);\n  const primaryCandidates: string[] = [];\n  const vision = firstVisionModelRef(primary.provider);\n  if (vision) {\n    primaryCandidates.push(vision);\n  }\n  if (primary.provider === 'openai') {\n    primaryCandidates.push('openai/gpt-4o-mini');\n  }\n  if (primary.provider === 'anthropic') {\n    primaryCandidates.push('anthropic/claude-sonnet-4-5');\n  }\n  if (primary.provider === 'google') {\n    primaryCandidates.push('google/gemini-2.0-flash');\n  }\n\n  return buildToolModelConfigFromCandidates({\n    explicit,\n    candidates: [\n      ...primaryCandidates,\n      firstVisionModelRef('openai') ?? 'openai/gpt-4o-mini',\n      firstVisionModelRef('anthropic') ?? 'anthropic/claude-sonnet-4-5',\n    ],\n  });\n}\n"],"mappings":";;;;aACgF;gBAK8B;AAI9G,SAAgB,mBAAmB,OAA6C;AAC9E,QAAO,QACL,OAAO,SAAS,MAAM,KAAK,OAAO,aAAa,EAAE,EAAE,MAAM,UAAU,MAAM,MAAM,CAAC,SAAS,EAAE,CAC5F;;AAGH,SAAgB,uBAAuB,KAAmD;CACxF,MAAM,MAAM,MAAM,wBAAwB,IAAI,GAAG,KAAA;AACjD,KAAI,KAAK;EACP,MAAM,IAAI,cAAc,IAAI;AAC5B,MAAI,EACF,QAAO;;CAIX,MAAM,KAAK,cADM,oBAAoB,IACJ,CAAC;AAClC,KAAI,GACF,QAAO;AAET,QAAO;EAAE,UAAU;EAAY,OAAO;EAAqB;;AAG7D,SAAgB,sBAAsB,OAA2C;CAC/E,MAAM,UAAU,8BAA8B,MAAM;CACpD,MAAM,YAAY,gCAAgC,MAAM;AACxD,QAAO;EACL,GAAI,SAAS,MAAM,GAAG,EAAE,SAAS,QAAQ,MAAM,EAAE,GAAG,EAAE;EACtD,GAAI,UAAU,SAAS,IAAI,EAAE,WAAW,GAAG,EAAE;EAC9C;;AAGH,SAAgB,mCAAmC,QAGxB;AACzB,KAAI,mBAAmB,OAAO,SAAS,CACrC,QAAO,OAAO;CAGhB,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,aAAa,OAAO,YAAY;EACzC,MAAM,UAAU,WAAW,MAAM;AACjC,MAAI,CAAC,WAAW,CAAC,QAAQ,SAAS,IAAI,CACpC;EAEF,MAAM,WAAW,QAAQ,MAAM,GAAG,QAAQ,QAAQ,IAAI,CAAC,CAAC,MAAM;AAC9D,MAAI,CAAC,YAAY,CAAC,yBAAyB,SAAS,CAClD;AAEF,MAAI,CAAC,QAAQ,SAAS,QAAQ,CAC5B,SAAQ,KAAK,QAAQ;;AAIzB,KAAI,QAAQ,WAAW,EACrB,QAAO;AAGT,QAAO;EACL,SAAS,QAAQ;EACjB,GAAI,QAAQ,SAAS,IAAI,EAAE,WAAW,QAAQ,MAAM,EAAE,EAAE,GAAG,EAAE;EAC9D;;AAGH,SAAS,oBAAoB,UAAsC;CACjE,MAAM,IAAI,oBAAoB,SAAS,CAAC,MAAM,MAAM,EAAE,OAAO,SAAS,QAAQ,CAAC;AAC/E,QAAO,IAAI,GAAG,SAAS,GAAG,EAAE,OAAO,KAAA;;;;;AAMrC,SAAgB,+BAA+B,QAAkD;CAC/F,MAAM,WAAW,sBAAsB,KAAA,EAAU;AACjD,KAAI,mBAAmB,SAAS,CAC9B,QAAO;CAGT,MAAM,UAAU,uBAAuB,OAAO,IAAI;CAClD,MAAM,oBAA8B,EAAE;CACtC,MAAM,SAAS,oBAAoB,QAAQ,SAAS;AACpD,KAAI,OACF,mBAAkB,KAAK,OAAO;AAEhC,KAAI,QAAQ,aAAa,SACvB,mBAAkB,KAAK,qBAAqB;AAE9C,KAAI,QAAQ,aAAa,YACvB,mBAAkB,KAAK,8BAA8B;AAEvD,KAAI,QAAQ,aAAa,SACvB,mBAAkB,KAAK,0BAA0B;AAGnD,QAAO,mCAAmC;EACxC;EACA,YAAY;GACV,GAAG;GACH,oBAAoB,SAAS,IAAI;GACjC,oBAAoB,YAAY,IAAI;GACrC;EACF,CAAC"}

package/dist/src/agent/ipc/inbox.js

@@ -1,9 +1,9 @@
-import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
-import { init_paths, resolveAgentDir } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { existsSync, watch } from "fs";
+import { init_paths, resolveAgentDir } from "../../config/paths.js";
+import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { join } from "path";
+import { existsSync, watch } from "fs";
 import { mkdir, readFile, readdir, rename } from "fs/promises";
 //#region src/agent/ipc/inbox.ts
 init_write_file_atomic();

package/dist/src/agent/ipc/socket.js

@@ -1,6 +1,6 @@
-import { init_paths, resolveSocketPath } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { init_paths, resolveSocketPath } from "../../config/paths.js";
 import { isValidIPCMessage } from "./types.js";
 import { dirname } from "path";
 import { mkdir } from "fs/promises";

package/dist/src/agent/mcp/bundle-mcp-materialize.js

@@ -1,6 +1,6 @@
+import { init_string_coerce, normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_string_coerce, normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { buildSafeToolName, normalizeReservedToolNames } from "./bundle-mcp-names.js";
 import { setPluginToolMeta } from "./mcp-tool-meta.js";
 import crypto from "node:crypto";

package/dist/src/agent/mcp/bundle-mcp-runtime.js

@@ -1,6 +1,6 @@
+import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { resolveGlobalSingleton } from "../../utils/global-singleton.js";
 import { sanitizeServerName } from "./bundle-mcp-names.js";
 import { redactSensitiveUrlLikeString } from "../../utils/redact-sensitive-url.js";

package/dist/src/agent/mcp/mcp-transport-config.js

@@ -1,6 +1,6 @@
+import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../../utils/string-coerce.js";
 import { resolveXopcMcpTransportAlias } from "../../config/mcp-config-normalize.js";
 import { sanitizeForLog } from "../../utils/sanitize-log.js";
 import { describeHttpMcpServerLaunchConfig, resolveHttpMcpServerLaunchConfig } from "./mcp-http.js";

package/dist/src/agent/mcp/mcp-transport.js

@@ -1,6 +1,6 @@
+import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { XopcStdioClientTransport } from "./mcp-stdio-transport.js";
 import { resolveMcpTransportConfig } from "./mcp-transport-config.js";
 import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

package/dist/src/agent/mcp/resolve-embedded-mcp-tools.js

@@ -5,7 +5,7 @@ import { materializeBundleMcpToolsForRun } from "./bundle-mcp-materialize.js";
 import "./bundle-mcp-tools.js";
 //#region src/agent/mcp/resolve-embedded-mcp-tools.ts
 async function resolveEmbeddedMcpToolsForTurn(params) {
-	const disabledTools = (params.cfg ? resolveEffectiveAgentProfileForSession(params.cfg, params.sessionKey) : void 0)?.tools.disable;
+	const disabledTools = (params.cfg ? resolveEffectiveAgentProfileForSession(params.cfg, params.sessionKey) : void 0)?.tools.denied;
 	if (!shouldCreateBundleMcpRuntimeForAttempt({
 		cfg: params.cfg,
 		disabledTools

package/dist/src/agent/mcp/resolve-embedded-mcp-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-embedded-mcp-tools.js","names":[],"sources":["../../../../src/agent/mcp/resolve-embedded-mcp-tools.ts"],"sourcesContent":["import type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Config } from '../../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../../config/agent-profile.js';\nimport {\n  getOrCreateSessionMcpRuntime,\n  materializeBundleMcpToolsForRun,\n} from './bundle-mcp-tools.js';\nimport { shouldCreateBundleMcpRuntimeForAttempt } from './bundle-mcp-policy.js';\nimport type { BundleMcpToolRuntime } from './bundle-mcp-types.js';\n\nexport type ResolvedEmbeddedMcpTools = {\n  tools: AgentTool[];\n  dispose: () => Promise<void>;\n};\n\nexport async function resolveEmbeddedMcpToolsForTurn(params: {\n  sessionKey: string;\n  workspaceDir: string;\n  cfg?: Config;\n  baseTools: AgentTool[];\n  cleanupOnTurnEnd?: boolean;\n}): Promise<ResolvedEmbeddedMcpTools> {\n  const profile = params.cfg\n    ? resolveEffectiveAgentProfileForSession(params.cfg, params.sessionKey)\n    : undefined;\n  const disabledTools = profile?.tools.disable;\n\n  if (\n    !shouldCreateBundleMcpRuntimeForAttempt({\n      cfg: params.cfg,\n      disabledTools,\n    })\n  ) {\n    return { tools: [], dispose: async () => {} };\n  }\n\n  const reserved = new Set(params.baseTools.map((t) => t.name));\n  const runtime = await getOrCreateSessionMcpRuntime({\n    sessionId: params.sessionKey,\n    sessionKey: params.sessionKey,\n    workspaceDir: params.workspaceDir,\n    cfg: params.cfg,\n  });\n\n  let materialized: BundleMcpToolRuntime;\n  try {\n    materialized = await materializeBundleMcpToolsForRun({\n      runtime,\n      reservedToolNames: reserved,\n      disposeRuntime: params.cleanupOnTurnEnd\n        ? async () => {\n            await runtime.dispose();\n          }\n        : undefined,\n    });\n  } catch (error) {\n    await runtime.dispose().catch(() => {});\n    throw error;\n  }\n\n  const filtered = materialized.tools.filter((tool) => {\n    if (disabledTools?.has(tool.name)) {\n      return false;\n    }\n    return true;\n  });\n\n  return {\n    tools: filtered,\n    dispose: materialized.dispose,\n  };\n}\n\nexport function mergeTurnTools(baseTools: AgentTool[], mcpTools: AgentTool[]): AgentTool[] {\n  if (mcpTools.length === 0) {\n    return baseTools;\n  }\n  return [...baseTools, ...mcpTools];\n}\n"],"mappings":";;;;;;AAeA,eAAsB,+BAA+B,QAMf;CAIpC,MAAM,iBAHU,OAAO,MACnB,uCAAuC,OAAO,KAAK,OAAO,WAAW,GACrE,KAAA,IAC2B,MAAM;AAErC,KACE,CAAC,uCAAuC;EACtC,KAAK,OAAO;EACZ;EACD,CAAC,CAEF,QAAO;EAAE,OAAO,EAAE;EAAE,SAAS,YAAY;EAAI;CAG/C,MAAM,WAAW,IAAI,IAAI,OAAO,UAAU,KAAK,MAAM,EAAE,KAAK,CAAC;CAC7D,MAAM,UAAU,MAAM,6BAA6B;EACjD,WAAW,OAAO;EAClB,YAAY,OAAO;EACnB,cAAc,OAAO;EACrB,KAAK,OAAO;EACb,CAAC;CAEF,IAAI;AACJ,KAAI;AACF,iBAAe,MAAM,gCAAgC;GACnD;GACA,mBAAmB;GACnB,gBAAgB,OAAO,mBACnB,YAAY;AACV,UAAM,QAAQ,SAAS;OAEzB,KAAA;GACL,CAAC;UACK,OAAO;AACd,QAAM,QAAQ,SAAS,CAAC,YAAY,GAAG;AACvC,QAAM;;AAUR,QAAO;EACL,OARe,aAAa,MAAM,QAAQ,SAAS;AACnD,OAAI,eAAe,IAAI,KAAK,KAAK,CAC/B,QAAO;AAET,UAAO;IAIQ;EACf,SAAS,aAAa;EACvB;;AAGH,SAAgB,eAAe,WAAwB,UAAoC;AACzF,KAAI,SAAS,WAAW,EACtB,QAAO;AAET,QAAO,CAAC,GAAG,WAAW,GAAG,SAAS"}
+{"version":3,"file":"resolve-embedded-mcp-tools.js","names":[],"sources":["../../../../src/agent/mcp/resolve-embedded-mcp-tools.ts"],"sourcesContent":["import type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Config } from '../../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../../config/agent-profile.js';\nimport {\n  getOrCreateSessionMcpRuntime,\n  materializeBundleMcpToolsForRun,\n} from './bundle-mcp-tools.js';\nimport { shouldCreateBundleMcpRuntimeForAttempt } from './bundle-mcp-policy.js';\nimport type { BundleMcpToolRuntime } from './bundle-mcp-types.js';\n\nexport type ResolvedEmbeddedMcpTools = {\n  tools: AgentTool[];\n  dispose: () => Promise<void>;\n};\n\nexport async function resolveEmbeddedMcpToolsForTurn(params: {\n  sessionKey: string;\n  workspaceDir: string;\n  cfg?: Config;\n  baseTools: AgentTool[];\n  cleanupOnTurnEnd?: boolean;\n}): Promise<ResolvedEmbeddedMcpTools> {\n  const profile = params.cfg\n    ? resolveEffectiveAgentProfileForSession(params.cfg, params.sessionKey)\n    : undefined;\n  const disabledTools = profile?.tools.denied;\n\n  if (\n    !shouldCreateBundleMcpRuntimeForAttempt({\n      cfg: params.cfg,\n      disabledTools,\n    })\n  ) {\n    return { tools: [], dispose: async () => {} };\n  }\n\n  const reserved = new Set(params.baseTools.map((t) => t.name));\n  const runtime = await getOrCreateSessionMcpRuntime({\n    sessionId: params.sessionKey,\n    sessionKey: params.sessionKey,\n    workspaceDir: params.workspaceDir,\n    cfg: params.cfg,\n  });\n\n  let materialized: BundleMcpToolRuntime;\n  try {\n    materialized = await materializeBundleMcpToolsForRun({\n      runtime,\n      reservedToolNames: reserved,\n      disposeRuntime: params.cleanupOnTurnEnd\n        ? async () => {\n            await runtime.dispose();\n          }\n        : undefined,\n    });\n  } catch (error) {\n    await runtime.dispose().catch(() => {});\n    throw error;\n  }\n\n  const filtered = materialized.tools.filter((tool) => {\n    if (disabledTools?.has(tool.name)) {\n      return false;\n    }\n    return true;\n  });\n\n  return {\n    tools: filtered,\n    dispose: materialized.dispose,\n  };\n}\n\nexport function mergeTurnTools(baseTools: AgentTool[], mcpTools: AgentTool[]): AgentTool[] {\n  if (mcpTools.length === 0) {\n    return baseTools;\n  }\n  return [...baseTools, ...mcpTools];\n}\n"],"mappings":";;;;;;AAeA,eAAsB,+BAA+B,QAMf;CAIpC,MAAM,iBAHU,OAAO,MACnB,uCAAuC,OAAO,KAAK,OAAO,WAAW,GACrE,KAAA,IAC2B,MAAM;AAErC,KACE,CAAC,uCAAuC;EACtC,KAAK,OAAO;EACZ;EACD,CAAC,CAEF,QAAO;EAAE,OAAO,EAAE;EAAE,SAAS,YAAY;EAAI;CAG/C,MAAM,WAAW,IAAI,IAAI,OAAO,UAAU,KAAK,MAAM,EAAE,KAAK,CAAC;CAC7D,MAAM,UAAU,MAAM,6BAA6B;EACjD,WAAW,OAAO;EAClB,YAAY,OAAO;EACnB,cAAc,OAAO;EACrB,KAAK,OAAO;EACb,CAAC;CAEF,IAAI;AACJ,KAAI;AACF,iBAAe,MAAM,gCAAgC;GACnD;GACA,mBAAmB;GACnB,gBAAgB,OAAO,mBACnB,YAAY;AACV,UAAM,QAAQ,SAAS;OAEzB,KAAA;GACL,CAAC;UACK,OAAO;AACd,QAAM,QAAQ,SAAS,CAAC,YAAY,GAAG;AACvC,QAAM;;AAUR,QAAO;EACL,OARe,aAAa,MAAM,QAAQ,SAAS;AACnD,OAAI,eAAe,IAAI,KAAK,KAAK,CAC/B,QAAO;AAET,UAAO;IAIQ;EACf,SAAS,aAAa;EACvB;;AAGH,SAAgB,eAAe,WAAwB,UAAoC;AACzF,KAAI,SAAS,WAAW,EACtB,QAAO;AAET,QAAO,CAAC,GAAG,WAAW,GAAG,SAAS"}

package/dist/src/agent/media-generation/runtime-shared.d.ts

@@ -23,8 +23,11 @@ export interface CapabilityProviderCandidate {
 }
 export interface ResolveCapabilityModelCandidatesParams {
     cfg?: Config;
-    /** Active capability model config, e.g. cfg.agents.defaults.imageGenerationModel. */
-    modelConfig: AgentModelConfig | undefined;
+    /** Active capability model config from a manifest/runtime policy. */
+    modelConfig: {
+        primary?: string;
+        fallbacks?: string[];
+    } | AgentModelConfig | undefined;
     /** Caller-supplied per-call override (highest priority). */
     modelOverride?: string;
     /** Optional ref parser; defaults to {@link parseCapabilityModelRef}. */

package/dist/src/agent/media-generation/runtime-shared.js

@@ -189,7 +189,7 @@ function throwCapabilityGenerationFailure(params) {
 	});
 }
 function buildNoCapabilityModelConfiguredMessage(params) {
-	const lines = [`No ${params.capabilityLabel} model configured. Set agents.defaults.${params.modelConfigKey} to a "<provider>/<model>" value (or pass modelOverride at call site).`];
+	const lines = [`No ${params.capabilityLabel} model configured. Add a manifest/runtime model policy for ${params.modelConfigKey} or pass modelOverride at call site.`];
 	if (params.providers.length > 0) {
 		lines.push("Registered providers:");
 		for (const p of params.providers) {