@open-mercato/ai-assistant 0.6.6-develop.6465.1.019f0fb26f → 0.6.6-develop.6471.1.9ab5bdd79a

package/dist/modules/ai_assistant/lib/agent-registry.js

@@ -1,3 +1,4 @@
+import { createLogger } from "@open-mercato/shared/lib/logger";
 import { llmProviderRegistry } from "@open-mercato/shared/lib/ai/llm-provider-registry";
 import {
   applyAgentOverrideMap,
@@ -6,6 +7,7 @@ import {
 } from "./ai-overrides.js";
 import { TASK_PLAN_TOOL_NAME } from "./task-plan-labels.js";
 import { findGeneratedFile, compileAndImportGenerated } from "./generated-registry-loader.js";
+const logger = createLogger("ai_assistant");
 const agentsById = /* @__PURE__ */ new Map();
 let loaded = false;
 async function importGeneratedAiAgentsModule() {
@@ -94,9 +96,10 @@ function validateAndNormalizeAgent(candidate) {
   const providerHint = rawProvider.trim();
   const registered = llmProviderRegistry.get(providerHint);
   if (!registered) {
-    console.warn(
-      `[AI Agents] Agent "${candidate.id}" declares defaultProvider "${providerHint}" which is not registered in llmProviderRegistry. The agent will be registered with defaultProvider: undefined so the resolution chain still works. Built-in provider ids: anthropic, google, openai, deepinfra, groq, together, fireworks, azure, litellm, ollama.`
-    );
+    logger.warn("Agent declares a defaultProvider not registered in llmProviderRegistry; registering with defaultProvider undefined", {
+      agentId: candidate.id,
+      defaultProvider: providerHint
+    });
     return { ...taskPlanNormalized, defaultProvider: void 0 };
   }
   return taskPlanNormalized;
@@ -104,7 +107,7 @@ function validateAndNormalizeAgent(candidate) {
 function populateFromAgents(agents) {
   for (const candidate of agents) {
     if (!isAiAgentDefinition(candidate)) {
-      console.warn("[AI Agents] Skipping malformed agent entry in ai-agents.generated.ts");
+      logger.warn("AI Agents \u2014 Skipping malformed agent entry in ai-agents.generated.ts");
       continue;
     }
     const existing = agentsById.get(candidate.id);
@@ -132,7 +135,7 @@ function applyOverridesToRegistry(entries) {
   for (const agent of overridden) agentsById.set(agent.id, agent);
   for (const [id, value] of Object.entries(overrideMap)) {
     const verb = value === null ? "disabled" : "replaced";
-    console.info(`[AI Overrides] Agent "${id}" ${verb} by override.`);
+    logger.info("Agent changed by override", { agentId: id, change: verb });
   }
 }
 async function loadExtensionEntries() {
@@ -149,9 +152,7 @@ function applyExtensionsToRegistry(extensions) {
   for (const extension of extensions) {
     const agent = agentsById.get(extension.targetAgentId);
     if (!agent) {
-      console.warn(
-        `[AI Agents] Skipping extension for unknown agent "${extension.targetAgentId}".`
-      );
+      logger.warn("Skipping extension for unknown agent", { agentId: extension.targetAgentId });
       continue;
     }
     const replacementSystemPrompt = extension.replaceSystemPrompt?.trim();
@@ -187,10 +188,7 @@ async function loadAgentRegistry() {
     const agents = mod && Array.isArray(mod.allAiAgents) ? mod.allAiAgents : [];
     populateFromAgents(agents);
   } catch (error) {
-    console.error(
-      "[AI Agents] Could not load ai-agents.generated.ts (agent registry empty):",
-      error
-    );
+    logger.error("AI Agents \u2014 Could not load ai-agents.generated.ts (agent registry empty)", { err: error });
   } finally {
     try {
       const overrideEntries = await loadOverrideEntries();
@@ -198,7 +196,7 @@ async function loadAgentRegistry() {
       const extensionEntries = await loadExtensionEntries();
       applyExtensionsToRegistry(extensionEntries);
     } catch (error) {
-      console.error("[AI Agents] Failed to apply agent overrides/extensions:", error);
+      logger.error("AI Agents \u2014 Failed to apply agent overrides/extensions", { err: error });
     }
     loaded = true;
   }

package/dist/modules/ai_assistant/lib/agent-registry.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/ai_assistant/lib/agent-registry.ts"],
-  "sourcesContent": ["import { llmProviderRegistry } from '@open-mercato/shared/lib/ai/llm-provider-registry'\nimport type { AiAgentDefinition, AiAgentExtension, AiAgentSuggestion } from './ai-agent-definition'\nimport {\n  applyAgentOverrideMap,\n  composeAgentExtensionEntries,\n  composeAgentOverrideMap,\n  type AiAgentExtensionConfigEntry,\n  type AiAgentOverrideConfigEntry,\n} from './ai-overrides'\nimport { TASK_PLAN_TOOL_NAME } from './task-plan-labels'\nimport { findGeneratedFile, compileAndImportGenerated } from './generated-registry-loader'\n\nconst agentsById = new Map<string, AiAgentDefinition>()\nlet loaded = false\n\n/**\n * Import the generated `ai-agents.generated.ts` registry.\n *\n * Dual-strategy, mirroring `tool-loader`'s `importGeneratedAiToolsModule`:\n *  1. Prefer the `@/` path-alias import \u2014 the Next.js bundler resolves it at\n *     build time, so the in-app agent runtime is unchanged.\n *  2. Fall back to locating + compiling the file from disk when the alias\n *     import throws. That only happens in a standalone Node process (the\n *     `mcp:dev` / `mcp:serve` MCP servers), where `@/` is not a real package\n *     specifier and Node throws `ERR_MODULE_NOT_FOUND`. Without this the\n *     `meta.list_agents` / `meta.describe_agent` tools return an empty agent\n *     registry over MCP.\n *\n * Returns `null` when no generated file exists (pre-generate builds, tests).\n */\nasync function importGeneratedAiAgentsModule(): Promise<Record<string, unknown> | null> {\n  try {\n    return (await import(\n      '@/.mercato/generated/ai-agents.generated'\n    )) as Record<string, unknown>\n  } catch {\n    const tsPath = findGeneratedFile('ai-agents.generated.ts')\n    if (!tsPath) return null\n    return compileAndImportGenerated(tsPath)\n  }\n}\n\nfunction isStringArray(value: unknown): value is string[] {\n  return Array.isArray(value) && value.every((item) => typeof item === 'string')\n}\n\nfunction isAiAgentSuggestion(value: unknown): value is AiAgentSuggestion {\n  if (!value || typeof value !== 'object') return false\n  const candidate = value as Record<string, unknown>\n  return typeof candidate.label === 'string' && typeof candidate.prompt === 'string'\n}\n\nfunction isAiAgentExtension(value: unknown): value is AiAgentExtension {\n  if (!value || typeof value !== 'object') return false\n  const candidate = value as Record<string, unknown>\n  return (\n    typeof candidate.targetAgentId === 'string' &&\n    (!('replaceAllowedTools' in candidate) || isStringArray(candidate.replaceAllowedTools)) &&\n    (!('deleteAllowedTools' in candidate) || isStringArray(candidate.deleteAllowedTools)) &&\n    (!('appendAllowedTools' in candidate) || isStringArray(candidate.appendAllowedTools)) &&\n    (!('taskPlan' in candidate) ||\n      (candidate.taskPlan != null &&\n        typeof candidate.taskPlan === 'object' &&\n        (!('enabled' in candidate.taskPlan) ||\n          typeof (candidate.taskPlan as { enabled?: unknown }).enabled === 'boolean'))) &&\n    (!('replaceSystemPrompt' in candidate) || typeof candidate.replaceSystemPrompt === 'string') &&\n    (!('appendSystemPrompt' in candidate) || typeof candidate.appendSystemPrompt === 'string') &&\n    (!('replaceSuggestions' in candidate) ||\n      (Array.isArray(candidate.replaceSuggestions) && candidate.replaceSuggestions.every(isAiAgentSuggestion))) &&\n    (!('deleteSuggestions' in candidate) || isStringArray(candidate.deleteSuggestions)) &&\n    (!('appendSuggestions' in candidate) ||\n      (Array.isArray(candidate.appendSuggestions) && candidate.appendSuggestions.every(isAiAgentSuggestion))) &&\n    (!('suggestions' in candidate) ||\n      (Array.isArray(candidate.suggestions) && candidate.suggestions.every(isAiAgentSuggestion)))\n  )\n}\n\nfunction isAiAgentDefinition(value: unknown): value is AiAgentDefinition {\n  if (!value || typeof value !== 'object') return false\n  const candidate = value as Record<string, unknown>\n  return (\n    typeof candidate.id === 'string' &&\n    typeof candidate.moduleId === 'string' &&\n    typeof candidate.label === 'string' &&\n    typeof candidate.description === 'string' &&\n    typeof candidate.systemPrompt === 'string' &&\n    isStringArray(candidate.allowedTools)\n  )\n}\n\nfunction uniqueStrings(values: readonly string[]): string[] {\n  return Array.from(new Set(values.filter((value) => typeof value === 'string' && value.length > 0)))\n}\n\nexport function isAgentTaskPlanEnabled(agent: Pick<AiAgentDefinition, 'taskPlan'>): boolean {\n  return agent.taskPlan?.enabled === true\n}\n\nfunction normalizeTaskPlanTool(agent: AiAgentDefinition): AiAgentDefinition {\n  const enabled = isAgentTaskPlanEnabled(agent)\n  const withoutInternalTool = agent.allowedTools.filter((toolName) => toolName !== TASK_PLAN_TOOL_NAME)\n  const allowedTools = enabled\n    ? uniqueStrings([...withoutInternalTool, TASK_PLAN_TOOL_NAME])\n    : uniqueStrings(withoutInternalTool)\n  if (\n    allowedTools.length === agent.allowedTools.length &&\n    allowedTools.every((toolName, index) => toolName === agent.allowedTools[index])\n  ) {\n    return agent\n  }\n  return {\n    ...agent,\n    allowedTools,\n  }\n}\n\nfunction applyStringListPatch(\n  current: readonly string[],\n  patch: {\n    replace?: readonly string[]\n    delete?: readonly string[]\n    append?: readonly string[]\n  },\n): string[] {\n  const deleted = new Set(patch.delete ?? [])\n  return uniqueStrings([\n    ...(patch.replace ?? current).filter((value) => !deleted.has(value)),\n    ...(patch.append ?? []),\n  ])\n}\n\nfunction suggestionDeleteKey(suggestion: AiAgentSuggestion): string[] {\n  return [suggestion.label, suggestion.prompt].filter((value) => value.length > 0)\n}\n\nfunction applySuggestionPatch(\n  current: readonly AiAgentSuggestion[],\n  patch: {\n    replace?: readonly AiAgentSuggestion[]\n    delete?: readonly string[]\n    append?: readonly AiAgentSuggestion[]\n  },\n): AiAgentSuggestion[] {\n  const deleted = new Set(patch.delete ?? [])\n  const base = patch.replace ?? current\n  const out: AiAgentSuggestion[] = []\n  const seen = new Set<string>()\n  for (const suggestion of base) {\n    if (suggestionDeleteKey(suggestion).some((key) => deleted.has(key))) continue\n    const key = `${suggestion.label}\\n${suggestion.prompt}`\n    if (seen.has(key)) continue\n    seen.add(key)\n    out.push(suggestion)\n  }\n  for (const suggestion of patch.append ?? []) {\n    const key = `${suggestion.label}\\n${suggestion.prompt}`\n    if (seen.has(key)) continue\n    seen.add(key)\n    out.push(suggestion)\n  }\n  return out\n}\n\nfunction validateAndNormalizeAgent(candidate: AiAgentDefinition): AiAgentDefinition {\n  const taskPlanNormalized = normalizeTaskPlanTool(candidate)\n  const rawProvider = candidate.defaultProvider\n  if (typeof rawProvider !== 'string' || rawProvider.trim().length === 0) {\n    return taskPlanNormalized\n  }\n  const providerHint = rawProvider.trim()\n  const registered = llmProviderRegistry.get(providerHint)\n  if (!registered) {\n    console.warn(\n      `[AI Agents] Agent \"${candidate.id}\" declares defaultProvider \"${providerHint}\" which is not registered in llmProviderRegistry. ` +\n        `The agent will be registered with defaultProvider: undefined so the resolution chain still works. ` +\n        `Built-in provider ids: anthropic, google, openai, deepinfra, groq, together, fireworks, azure, litellm, ollama.`,\n    )\n    return { ...taskPlanNormalized, defaultProvider: undefined }\n  }\n  return taskPlanNormalized\n}\n\nfunction populateFromAgents(agents: unknown[]): void {\n  for (const candidate of agents) {\n    if (!isAiAgentDefinition(candidate)) {\n      console.warn('[AI Agents] Skipping malformed agent entry in ai-agents.generated.ts')\n      continue\n    }\n    const existing = agentsById.get(candidate.id)\n    if (existing) {\n      throw new Error(\n        `[AI Agents] Duplicate agent id \"${candidate.id}\" \u2014 already registered by module \"${existing.moduleId}\", conflicts with module \"${candidate.moduleId}\". Export \\`aiAgentOverrides\\` from your module's \\`ai-agents.ts\\` (or set it on the modules.ts entry) to replace an agent across modules.`\n      )\n    }\n    agentsById.set(candidate.id, validateAndNormalizeAgent(candidate))\n  }\n}\n\nasync function loadOverrideEntries(): Promise<AiAgentOverrideConfigEntry[]> {\n  try {\n    const mod = (await importGeneratedAiAgentsModule()) as {\n      aiAgentOverrideEntries?: unknown[]\n    } | null\n    return mod && Array.isArray(mod.aiAgentOverrideEntries)\n      ? (mod.aiAgentOverrideEntries as AiAgentOverrideConfigEntry[])\n      : []\n  } catch {\n    // No generated file yet \u2014 pre-generate builds and tests fall through.\n    return []\n  }\n}\n\nfunction applyOverridesToRegistry(entries: readonly AiAgentOverrideConfigEntry[]): void {\n  const overrideMap = composeAgentOverrideMap(entries)\n  if (Object.keys(overrideMap).length === 0) return\n  const overridden = applyAgentOverrideMap(Array.from(agentsById.values()), overrideMap)\n  agentsById.clear()\n  for (const agent of overridden) agentsById.set(agent.id, agent)\n  for (const [id, value] of Object.entries(overrideMap)) {\n    const verb = value === null ? 'disabled' : 'replaced'\n    console.info(`[AI Overrides] Agent \"${id}\" ${verb} by override.`)\n  }\n}\n\nasync function loadExtensionEntries(): Promise<AiAgentExtension[]> {\n  try {\n    const mod = (await importGeneratedAiAgentsModule()) as {\n      aiAgentExtensionEntries?: unknown[]\n    } | null\n    const entries =\n      mod && Array.isArray(mod.aiAgentExtensionEntries)\n        ? (mod.aiAgentExtensionEntries as AiAgentExtensionConfigEntry[])\n        : []\n    return composeAgentExtensionEntries(entries).filter(isAiAgentExtension)\n  } catch {\n    return []\n  }\n}\n\nfunction applyExtensionsToRegistry(extensions: readonly AiAgentExtension[]): void {\n  if (extensions.length === 0) return\n  for (const extension of extensions) {\n    const agent = agentsById.get(extension.targetAgentId)\n    if (!agent) {\n      console.warn(\n        `[AI Agents] Skipping extension for unknown agent \"${extension.targetAgentId}\".`,\n      )\n      continue\n    }\n\n    const replacementSystemPrompt = extension.replaceSystemPrompt?.trim()\n    const appendSystemPrompt = extension.appendSystemPrompt?.trim()\n    const systemPrompt = replacementSystemPrompt ?? agent.systemPrompt.trim()\n    const patchedAgent: AiAgentDefinition = {\n      ...agent,\n      allowedTools: applyStringListPatch(agent.allowedTools, {\n        replace: extension.replaceAllowedTools,\n        delete: extension.deleteAllowedTools,\n        append: extension.appendAllowedTools,\n      }),\n      taskPlan: extension.taskPlan !== undefined ? extension.taskPlan : agent.taskPlan,\n      systemPrompt: appendSystemPrompt\n        ? `${systemPrompt}\\n\\n${appendSystemPrompt}`\n        : systemPrompt,\n      suggestions: applySuggestionPatch(agent.suggestions ?? [], {\n        replace: extension.replaceSuggestions,\n        delete: extension.deleteSuggestions,\n        append: [\n          ...(extension.appendSuggestions ?? []),\n          ...(extension.suggestions ?? []),\n        ],\n      }),\n    }\n    agentsById.set(agent.id, validateAndNormalizeAgent(patchedAgent))\n  }\n}\n\nexport async function loadAgentRegistry(): Promise<void> {\n  if (loaded) return\n  try {\n    const mod = (await importGeneratedAiAgentsModule()) as {\n      allAiAgents?: unknown[]\n    } | null\n    const agents = mod && Array.isArray(mod.allAiAgents) ? mod.allAiAgents : []\n    populateFromAgents(agents)\n  } catch (error) {\n    console.error(\n      '[AI Agents] Could not load ai-agents.generated.ts (agent registry empty):',\n      error\n    )\n  } finally {\n    try {\n      const overrideEntries = await loadOverrideEntries()\n      applyOverridesToRegistry(overrideEntries)\n      const extensionEntries = await loadExtensionEntries()\n      applyExtensionsToRegistry(extensionEntries)\n    } catch (error) {\n      console.error('[AI Agents] Failed to apply agent overrides/extensions:', error)\n    }\n    loaded = true\n  }\n}\n\nexport function getAgent(id: string): AiAgentDefinition | undefined {\n  return agentsById.get(id)\n}\n\nexport function listAgents(): AiAgentDefinition[] {\n  return Array.from(agentsById.values()).sort((a, b) => a.id.localeCompare(b.id))\n}\n\nexport function listAgentsByModule(moduleId: string): AiAgentDefinition[] {\n  return listAgents().filter((agent) => agent.moduleId === moduleId)\n}\n\n/**\n * @__internal\n * Test-only hook \u2014 clears the cached registry so `loadAgentRegistry` re-evaluates its source.\n */\nexport function resetAgentRegistryForTests(): void {\n  agentsById.clear()\n  loaded = false\n}\n\n/**\n * @__internal\n * Test-only hook \u2014 seeds the registry directly from a fixture array without going through\n * the dynamic generated-file import. Used by the registry's own unit tests.\n */\nexport function seedAgentRegistryForTests(agents: unknown[]): void {\n  agentsById.clear()\n  populateFromAgents(agents)\n  loaded = true\n}\n\n/**\n * @__internal\n * Test-only hook \u2014 apply override entries against the seeded registry to\n * exercise the override pipeline without round-tripping through the\n * generated file.\n */\nexport function applyAgentOverrideEntriesForTests(\n  entries: readonly AiAgentOverrideConfigEntry[],\n): void {\n  applyOverridesToRegistry(entries)\n}\n\n/**\n * @__internal Test-only hook \u2014 apply additive extension entries against the\n * seeded registry without round-tripping through the generated file.\n */\nexport function applyAgentExtensionEntriesForTests(\n  entries: readonly AiAgentExtension[],\n): void {\n  applyExtensionsToRegistry(entries)\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { createLogger } from '@open-mercato/shared/lib/logger'\nimport { llmProviderRegistry } from '@open-mercato/shared/lib/ai/llm-provider-registry'\nimport type { AiAgentDefinition, AiAgentExtension, AiAgentSuggestion } from './ai-agent-definition'\nimport {\n  applyAgentOverrideMap,\n  composeAgentExtensionEntries,\n  composeAgentOverrideMap,\n  type AiAgentExtensionConfigEntry,\n  type AiAgentOverrideConfigEntry,\n} from './ai-overrides'\nimport { TASK_PLAN_TOOL_NAME } from './task-plan-labels'\nimport { findGeneratedFile, compileAndImportGenerated } from './generated-registry-loader'\n\nconst logger = createLogger('ai_assistant')\n\nconst agentsById = new Map<string, AiAgentDefinition>()\nlet loaded = false\n\n/**\n * Import the generated `ai-agents.generated.ts` registry.\n *\n * Dual-strategy, mirroring `tool-loader`'s `importGeneratedAiToolsModule`:\n *  1. Prefer the `@/` path-alias import \u2014 the Next.js bundler resolves it at\n *     build time, so the in-app agent runtime is unchanged.\n *  2. Fall back to locating + compiling the file from disk when the alias\n *     import throws. That only happens in a standalone Node process (the\n *     `mcp:dev` / `mcp:serve` MCP servers), where `@/` is not a real package\n *     specifier and Node throws `ERR_MODULE_NOT_FOUND`. Without this the\n *     `meta.list_agents` / `meta.describe_agent` tools return an empty agent\n *     registry over MCP.\n *\n * Returns `null` when no generated file exists (pre-generate builds, tests).\n */\nasync function importGeneratedAiAgentsModule(): Promise<Record<string, unknown> | null> {\n  try {\n    return (await import(\n      '@/.mercato/generated/ai-agents.generated'\n    )) as Record<string, unknown>\n  } catch {\n    const tsPath = findGeneratedFile('ai-agents.generated.ts')\n    if (!tsPath) return null\n    return compileAndImportGenerated(tsPath)\n  }\n}\n\nfunction isStringArray(value: unknown): value is string[] {\n  return Array.isArray(value) && value.every((item) => typeof item === 'string')\n}\n\nfunction isAiAgentSuggestion(value: unknown): value is AiAgentSuggestion {\n  if (!value || typeof value !== 'object') return false\n  const candidate = value as Record<string, unknown>\n  return typeof candidate.label === 'string' && typeof candidate.prompt === 'string'\n}\n\nfunction isAiAgentExtension(value: unknown): value is AiAgentExtension {\n  if (!value || typeof value !== 'object') return false\n  const candidate = value as Record<string, unknown>\n  return (\n    typeof candidate.targetAgentId === 'string' &&\n    (!('replaceAllowedTools' in candidate) || isStringArray(candidate.replaceAllowedTools)) &&\n    (!('deleteAllowedTools' in candidate) || isStringArray(candidate.deleteAllowedTools)) &&\n    (!('appendAllowedTools' in candidate) || isStringArray(candidate.appendAllowedTools)) &&\n    (!('taskPlan' in candidate) ||\n      (candidate.taskPlan != null &&\n        typeof candidate.taskPlan === 'object' &&\n        (!('enabled' in candidate.taskPlan) ||\n          typeof (candidate.taskPlan as { enabled?: unknown }).enabled === 'boolean'))) &&\n    (!('replaceSystemPrompt' in candidate) || typeof candidate.replaceSystemPrompt === 'string') &&\n    (!('appendSystemPrompt' in candidate) || typeof candidate.appendSystemPrompt === 'string') &&\n    (!('replaceSuggestions' in candidate) ||\n      (Array.isArray(candidate.replaceSuggestions) && candidate.replaceSuggestions.every(isAiAgentSuggestion))) &&\n    (!('deleteSuggestions' in candidate) || isStringArray(candidate.deleteSuggestions)) &&\n    (!('appendSuggestions' in candidate) ||\n      (Array.isArray(candidate.appendSuggestions) && candidate.appendSuggestions.every(isAiAgentSuggestion))) &&\n    (!('suggestions' in candidate) ||\n      (Array.isArray(candidate.suggestions) && candidate.suggestions.every(isAiAgentSuggestion)))\n  )\n}\n\nfunction isAiAgentDefinition(value: unknown): value is AiAgentDefinition {\n  if (!value || typeof value !== 'object') return false\n  const candidate = value as Record<string, unknown>\n  return (\n    typeof candidate.id === 'string' &&\n    typeof candidate.moduleId === 'string' &&\n    typeof candidate.label === 'string' &&\n    typeof candidate.description === 'string' &&\n    typeof candidate.systemPrompt === 'string' &&\n    isStringArray(candidate.allowedTools)\n  )\n}\n\nfunction uniqueStrings(values: readonly string[]): string[] {\n  return Array.from(new Set(values.filter((value) => typeof value === 'string' && value.length > 0)))\n}\n\nexport function isAgentTaskPlanEnabled(agent: Pick<AiAgentDefinition, 'taskPlan'>): boolean {\n  return agent.taskPlan?.enabled === true\n}\n\nfunction normalizeTaskPlanTool(agent: AiAgentDefinition): AiAgentDefinition {\n  const enabled = isAgentTaskPlanEnabled(agent)\n  const withoutInternalTool = agent.allowedTools.filter((toolName) => toolName !== TASK_PLAN_TOOL_NAME)\n  const allowedTools = enabled\n    ? uniqueStrings([...withoutInternalTool, TASK_PLAN_TOOL_NAME])\n    : uniqueStrings(withoutInternalTool)\n  if (\n    allowedTools.length === agent.allowedTools.length &&\n    allowedTools.every((toolName, index) => toolName === agent.allowedTools[index])\n  ) {\n    return agent\n  }\n  return {\n    ...agent,\n    allowedTools,\n  }\n}\n\nfunction applyStringListPatch(\n  current: readonly string[],\n  patch: {\n    replace?: readonly string[]\n    delete?: readonly string[]\n    append?: readonly string[]\n  },\n): string[] {\n  const deleted = new Set(patch.delete ?? [])\n  return uniqueStrings([\n    ...(patch.replace ?? current).filter((value) => !deleted.has(value)),\n    ...(patch.append ?? []),\n  ])\n}\n\nfunction suggestionDeleteKey(suggestion: AiAgentSuggestion): string[] {\n  return [suggestion.label, suggestion.prompt].filter((value) => value.length > 0)\n}\n\nfunction applySuggestionPatch(\n  current: readonly AiAgentSuggestion[],\n  patch: {\n    replace?: readonly AiAgentSuggestion[]\n    delete?: readonly string[]\n    append?: readonly AiAgentSuggestion[]\n  },\n): AiAgentSuggestion[] {\n  const deleted = new Set(patch.delete ?? [])\n  const base = patch.replace ?? current\n  const out: AiAgentSuggestion[] = []\n  const seen = new Set<string>()\n  for (const suggestion of base) {\n    if (suggestionDeleteKey(suggestion).some((key) => deleted.has(key))) continue\n    const key = `${suggestion.label}\\n${suggestion.prompt}`\n    if (seen.has(key)) continue\n    seen.add(key)\n    out.push(suggestion)\n  }\n  for (const suggestion of patch.append ?? []) {\n    const key = `${suggestion.label}\\n${suggestion.prompt}`\n    if (seen.has(key)) continue\n    seen.add(key)\n    out.push(suggestion)\n  }\n  return out\n}\n\nfunction validateAndNormalizeAgent(candidate: AiAgentDefinition): AiAgentDefinition {\n  const taskPlanNormalized = normalizeTaskPlanTool(candidate)\n  const rawProvider = candidate.defaultProvider\n  if (typeof rawProvider !== 'string' || rawProvider.trim().length === 0) {\n    return taskPlanNormalized\n  }\n  const providerHint = rawProvider.trim()\n  const registered = llmProviderRegistry.get(providerHint)\n  if (!registered) {\n    logger.warn('Agent declares a defaultProvider not registered in llmProviderRegistry; registering with defaultProvider undefined', {\n      agentId: candidate.id,\n      defaultProvider: providerHint,\n    })\n    return { ...taskPlanNormalized, defaultProvider: undefined }\n  }\n  return taskPlanNormalized\n}\n\nfunction populateFromAgents(agents: unknown[]): void {\n  for (const candidate of agents) {\n    if (!isAiAgentDefinition(candidate)) {\n      logger.warn('AI Agents \u2014 Skipping malformed agent entry in ai-agents.generated.ts')\n      continue\n    }\n    const existing = agentsById.get(candidate.id)\n    if (existing) {\n      throw new Error(\n        `[AI Agents] Duplicate agent id \"${candidate.id}\" \u2014 already registered by module \"${existing.moduleId}\", conflicts with module \"${candidate.moduleId}\". Export \\`aiAgentOverrides\\` from your module's \\`ai-agents.ts\\` (or set it on the modules.ts entry) to replace an agent across modules.`\n      )\n    }\n    agentsById.set(candidate.id, validateAndNormalizeAgent(candidate))\n  }\n}\n\nasync function loadOverrideEntries(): Promise<AiAgentOverrideConfigEntry[]> {\n  try {\n    const mod = (await importGeneratedAiAgentsModule()) as {\n      aiAgentOverrideEntries?: unknown[]\n    } | null\n    return mod && Array.isArray(mod.aiAgentOverrideEntries)\n      ? (mod.aiAgentOverrideEntries as AiAgentOverrideConfigEntry[])\n      : []\n  } catch {\n    // No generated file yet \u2014 pre-generate builds and tests fall through.\n    return []\n  }\n}\n\nfunction applyOverridesToRegistry(entries: readonly AiAgentOverrideConfigEntry[]): void {\n  const overrideMap = composeAgentOverrideMap(entries)\n  if (Object.keys(overrideMap).length === 0) return\n  const overridden = applyAgentOverrideMap(Array.from(agentsById.values()), overrideMap)\n  agentsById.clear()\n  for (const agent of overridden) agentsById.set(agent.id, agent)\n  for (const [id, value] of Object.entries(overrideMap)) {\n    const verb = value === null ? 'disabled' : 'replaced'\n    logger.info('Agent changed by override', { agentId: id, change: verb })\n  }\n}\n\nasync function loadExtensionEntries(): Promise<AiAgentExtension[]> {\n  try {\n    const mod = (await importGeneratedAiAgentsModule()) as {\n      aiAgentExtensionEntries?: unknown[]\n    } | null\n    const entries =\n      mod && Array.isArray(mod.aiAgentExtensionEntries)\n        ? (mod.aiAgentExtensionEntries as AiAgentExtensionConfigEntry[])\n        : []\n    return composeAgentExtensionEntries(entries).filter(isAiAgentExtension)\n  } catch {\n    return []\n  }\n}\n\nfunction applyExtensionsToRegistry(extensions: readonly AiAgentExtension[]): void {\n  if (extensions.length === 0) return\n  for (const extension of extensions) {\n    const agent = agentsById.get(extension.targetAgentId)\n    if (!agent) {\n      logger.warn('Skipping extension for unknown agent', { agentId: extension.targetAgentId })\n      continue\n    }\n\n    const replacementSystemPrompt = extension.replaceSystemPrompt?.trim()\n    const appendSystemPrompt = extension.appendSystemPrompt?.trim()\n    const systemPrompt = replacementSystemPrompt ?? agent.systemPrompt.trim()\n    const patchedAgent: AiAgentDefinition = {\n      ...agent,\n      allowedTools: applyStringListPatch(agent.allowedTools, {\n        replace: extension.replaceAllowedTools,\n        delete: extension.deleteAllowedTools,\n        append: extension.appendAllowedTools,\n      }),\n      taskPlan: extension.taskPlan !== undefined ? extension.taskPlan : agent.taskPlan,\n      systemPrompt: appendSystemPrompt\n        ? `${systemPrompt}\\n\\n${appendSystemPrompt}`\n        : systemPrompt,\n      suggestions: applySuggestionPatch(agent.suggestions ?? [], {\n        replace: extension.replaceSuggestions,\n        delete: extension.deleteSuggestions,\n        append: [\n          ...(extension.appendSuggestions ?? []),\n          ...(extension.suggestions ?? []),\n        ],\n      }),\n    }\n    agentsById.set(agent.id, validateAndNormalizeAgent(patchedAgent))\n  }\n}\n\nexport async function loadAgentRegistry(): Promise<void> {\n  if (loaded) return\n  try {\n    const mod = (await importGeneratedAiAgentsModule()) as {\n      allAiAgents?: unknown[]\n    } | null\n    const agents = mod && Array.isArray(mod.allAiAgents) ? mod.allAiAgents : []\n    populateFromAgents(agents)\n  } catch (error) {\n    logger.error('AI Agents \u2014 Could not load ai-agents.generated.ts (agent registry empty)', { err: error })\n  } finally {\n    try {\n      const overrideEntries = await loadOverrideEntries()\n      applyOverridesToRegistry(overrideEntries)\n      const extensionEntries = await loadExtensionEntries()\n      applyExtensionsToRegistry(extensionEntries)\n    } catch (error) {\n      logger.error('AI Agents \u2014 Failed to apply agent overrides/extensions', { err: error })\n    }\n    loaded = true\n  }\n}\n\nexport function getAgent(id: string): AiAgentDefinition | undefined {\n  return agentsById.get(id)\n}\n\nexport function listAgents(): AiAgentDefinition[] {\n  return Array.from(agentsById.values()).sort((a, b) => a.id.localeCompare(b.id))\n}\n\nexport function listAgentsByModule(moduleId: string): AiAgentDefinition[] {\n  return listAgents().filter((agent) => agent.moduleId === moduleId)\n}\n\n/**\n * @__internal\n * Test-only hook \u2014 clears the cached registry so `loadAgentRegistry` re-evaluates its source.\n */\nexport function resetAgentRegistryForTests(): void {\n  agentsById.clear()\n  loaded = false\n}\n\n/**\n * @__internal\n * Test-only hook \u2014 seeds the registry directly from a fixture array without going through\n * the dynamic generated-file import. Used by the registry's own unit tests.\n */\nexport function seedAgentRegistryForTests(agents: unknown[]): void {\n  agentsById.clear()\n  populateFromAgents(agents)\n  loaded = true\n}\n\n/**\n * @__internal\n * Test-only hook \u2014 apply override entries against the seeded registry to\n * exercise the override pipeline without round-tripping through the\n * generated file.\n */\nexport function applyAgentOverrideEntriesForTests(\n  entries: readonly AiAgentOverrideConfigEntry[],\n): void {\n  applyOverridesToRegistry(entries)\n}\n\n/**\n * @__internal Test-only hook \u2014 apply additive extension entries against the\n * seeded registry without round-tripping through the generated file.\n */\nexport function applyAgentExtensionEntriesForTests(\n  entries: readonly AiAgentExtension[],\n): void {\n  applyExtensionsToRegistry(entries)\n}\n"],
+  "mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,2BAA2B;AAEpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,2BAA2B;AACpC,SAAS,mBAAmB,iCAAiC;AAE7D,MAAM,SAAS,aAAa,cAAc;AAE1C,MAAM,aAAa,oBAAI,IAA+B;AACtD,IAAI,SAAS;AAiBb,eAAe,gCAAyE;AACtF,MAAI;AACF,WAAQ,MAAM,OACZ,0CACF;AAAA,EACF,QAAQ;AACN,UAAM,SAAS,kBAAkB,wBAAwB;AACzD,QAAI,CAAC,OAAQ,QAAO;AACpB,WAAO,0BAA0B,MAAM;AAAA,EACzC;AACF;AAEA,SAAS,cAAc,OAAmC;AACxD,SAAO,MAAM,QAAQ,KAAK,KAAK,MAAM,MAAM,CAAC,SAAS,OAAO,SAAS,QAAQ;AAC/E;AAEA,SAAS,oBAAoB,OAA4C;AACvE,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,SAAO,OAAO,UAAU,UAAU,YAAY,OAAO,UAAU,WAAW;AAC5E;AAEA,SAAS,mBAAmB,OAA2C;AACrE,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,kBAAkB,aAClC,EAAE,yBAAyB,cAAc,cAAc,UAAU,mBAAmB,OACpF,EAAE,wBAAwB,cAAc,cAAc,UAAU,kBAAkB,OAClF,EAAE,wBAAwB,cAAc,cAAc,UAAU,kBAAkB,OAClF,EAAE,cAAc,cACd,UAAU,YAAY,QACrB,OAAO,UAAU,aAAa,aAC7B,EAAE,aAAa,UAAU,aACxB,OAAQ,UAAU,SAAmC,YAAY,gBACtE,EAAE,yBAAyB,cAAc,OAAO,UAAU,wBAAwB,cAClF,EAAE,wBAAwB,cAAc,OAAO,UAAU,uBAAuB,cAChF,EAAE,wBAAwB,cACxB,MAAM,QAAQ,UAAU,kBAAkB,KAAK,UAAU,mBAAmB,MAAM,mBAAmB,OACvG,EAAE,uBAAuB,cAAc,cAAc,UAAU,iBAAiB,OAChF,EAAE,uBAAuB,cACvB,MAAM,QAAQ,UAAU,iBAAiB,KAAK,UAAU,kBAAkB,MAAM,mBAAmB,OACrG,EAAE,iBAAiB,cACjB,MAAM,QAAQ,UAAU,WAAW,KAAK,UAAU,YAAY,MAAM,mBAAmB;AAE9F;AAEA,SAAS,oBAAoB,OAA4C;AACvE,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,OAAO,YACxB,OAAO,UAAU,aAAa,YAC9B,OAAO,UAAU,UAAU,YAC3B,OAAO,UAAU,gBAAgB,YACjC,OAAO,UAAU,iBAAiB,YAClC,cAAc,UAAU,YAAY;AAExC;AAEA,SAAS,cAAc,QAAqC;AAC1D,SAAO,MAAM,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,UAAU,OAAO,UAAU,YAAY,MAAM,SAAS,CAAC,CAAC,CAAC;AACpG;AAEO,SAAS,uBAAuB,OAAqD;AAC1F,SAAO,MAAM,UAAU,YAAY;AACrC;AAEA,SAAS,sBAAsB,OAA6C;AAC1E,QAAM,UAAU,uBAAuB,KAAK;AAC5C,QAAM,sBAAsB,MAAM,aAAa,OAAO,CAAC,aAAa,aAAa,mBAAmB;AACpG,QAAM,eAAe,UACjB,cAAc,CAAC,GAAG,qBAAqB,mBAAmB,CAAC,IAC3D,cAAc,mBAAmB;AACrC,MACE,aAAa,WAAW,MAAM,aAAa,UAC3C,aAAa,MAAM,CAAC,UAAU,UAAU,aAAa,MAAM,aAAa,KAAK,CAAC,GAC9E;AACA,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,EACF;AACF;AAEA,SAAS,qBACP,SACA,OAKU;AACV,QAAM,UAAU,IAAI,IAAI,MAAM,UAAU,CAAC,CAAC;AAC1C,SAAO,cAAc;AAAA,IACnB,IAAI,MAAM,WAAW,SAAS,OAAO,CAAC,UAAU,CAAC,QAAQ,IAAI,KAAK,CAAC;AAAA,IACnE,GAAI,MAAM,UAAU,CAAC;AAAA,EACvB,CAAC;AACH;AAEA,SAAS,oBAAoB,YAAyC;AACpE,SAAO,CAAC,WAAW,OAAO,WAAW,MAAM,EAAE,OAAO,CAAC,UAAU,MAAM,SAAS,CAAC;AACjF;AAEA,SAAS,qBACP,SACA,OAKqB;AACrB,QAAM,UAAU,IAAI,IAAI,MAAM,UAAU,CAAC,CAAC;AAC1C,QAAM,OAAO,MAAM,WAAW;AAC9B,QAAM,MAA2B,CAAC;AAClC,QAAM,OAAO,oBAAI,IAAY;AAC7B,aAAW,cAAc,MAAM;AAC7B,QAAI,oBAAoB,UAAU,EAAE,KAAK,CAACA,SAAQ,QAAQ,IAAIA,IAAG,CAAC,EAAG;AACrE,UAAM,MAAM,GAAG,WAAW,KAAK;AAAA,EAAK,WAAW,MAAM;AACrD,QAAI,KAAK,IAAI,GAAG,EAAG;AACnB,SAAK,IAAI,GAAG;AACZ,QAAI,KAAK,UAAU;AAAA,EACrB;AACA,aAAW,cAAc,MAAM,UAAU,CAAC,GAAG;AAC3C,UAAM,MAAM,GAAG,WAAW,KAAK;AAAA,EAAK,WAAW,MAAM;AACrD,QAAI,KAAK,IAAI,GAAG,EAAG;AACnB,SAAK,IAAI,GAAG;AACZ,QAAI,KAAK,UAAU;AAAA,EACrB;AACA,SAAO;AACT;AAEA,SAAS,0BAA0B,WAAiD;AAClF,QAAM,qBAAqB,sBAAsB,SAAS;AAC1D,QAAM,cAAc,UAAU;AAC9B,MAAI,OAAO,gBAAgB,YAAY,YAAY,KAAK,EAAE,WAAW,GAAG;AACtE,WAAO;AAAA,EACT;AACA,QAAM,eAAe,YAAY,KAAK;AACtC,QAAM,aAAa,oBAAoB,IAAI,YAAY;AACvD,MAAI,CAAC,YAAY;AACf,WAAO,KAAK,sHAAsH;AAAA,MAChI,SAAS,UAAU;AAAA,MACnB,iBAAiB;AAAA,IACnB,CAAC;AACD,WAAO,EAAE,GAAG,oBAAoB,iBAAiB,OAAU;AAAA,EAC7D;AACA,SAAO;AACT;AAEA,SAAS,mBAAmB,QAAyB;AACnD,aAAW,aAAa,QAAQ;AAC9B,QAAI,CAAC,oBAAoB,SAAS,GAAG;AACnC,aAAO,KAAK,2EAAsE;AAClF;AAAA,IACF;AACA,UAAM,WAAW,WAAW,IAAI,UAAU,EAAE;AAC5C,QAAI,UAAU;AACZ,YAAM,IAAI;AAAA,QACR,mCAAmC,UAAU,EAAE,0CAAqC,SAAS,QAAQ,6BAA6B,UAAU,QAAQ;AAAA,MACtJ;AAAA,IACF;AACA,eAAW,IAAI,UAAU,IAAI,0BAA0B,SAAS,CAAC;AAAA,EACnE;AACF;AAEA,eAAe,sBAA6D;AAC1E,MAAI;AACF,UAAM,MAAO,MAAM,8BAA8B;AAGjD,WAAO,OAAO,MAAM,QAAQ,IAAI,sBAAsB,IACjD,IAAI,yBACL,CAAC;AAAA,EACP,QAAQ;AAEN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,SAAS,yBAAyB,SAAsD;AACtF,QAAM,cAAc,wBAAwB,OAAO;AACnD,MAAI,OAAO,KAAK,WAAW,EAAE,WAAW,EAAG;AAC3C,QAAM,aAAa,sBAAsB,MAAM,KAAK,WAAW,OAAO,CAAC,GAAG,WAAW;AACrF,aAAW,MAAM;AACjB,aAAW,SAAS,WAAY,YAAW,IAAI,MAAM,IAAI,KAAK;AAC9D,aAAW,CAAC,IAAI,KAAK,KAAK,OAAO,QAAQ,WAAW,GAAG;AACrD,UAAM,OAAO,UAAU,OAAO,aAAa;AAC3C,WAAO,KAAK,6BAA6B,EAAE,SAAS,IAAI,QAAQ,KAAK,CAAC;AAAA,EACxE;AACF;AAEA,eAAe,uBAAoD;AACjE,MAAI;AACF,UAAM,MAAO,MAAM,8BAA8B;AAGjD,UAAM,UACJ,OAAO,MAAM,QAAQ,IAAI,uBAAuB,IAC3C,IAAI,0BACL,CAAC;AACP,WAAO,6BAA6B,OAAO,EAAE,OAAO,kBAAkB;AAAA,EACxE,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,SAAS,0BAA0B,YAA+C;AAChF,MAAI,WAAW,WAAW,EAAG;AAC7B,aAAW,aAAa,YAAY;AAClC,UAAM,QAAQ,WAAW,IAAI,UAAU,aAAa;AACpD,QAAI,CAAC,OAAO;AACV,aAAO,KAAK,wCAAwC,EAAE,SAAS,UAAU,cAAc,CAAC;AACxF;AAAA,IACF;AAEA,UAAM,0BAA0B,UAAU,qBAAqB,KAAK;AACpE,UAAM,qBAAqB,UAAU,oBAAoB,KAAK;AAC9D,UAAM,eAAe,2BAA2B,MAAM,aAAa,KAAK;AACxE,UAAM,eAAkC;AAAA,MACtC,GAAG;AAAA,MACH,cAAc,qBAAqB,MAAM,cAAc;AAAA,QACrD,SAAS,UAAU;AAAA,QACnB,QAAQ,UAAU;AAAA,QAClB,QAAQ,UAAU;AAAA,MACpB,CAAC;AAAA,MACD,UAAU,UAAU,aAAa,SAAY,UAAU,WAAW,MAAM;AAAA,MACxE,cAAc,qBACV,GAAG,YAAY;AAAA;AAAA,EAAO,kBAAkB,KACxC;AAAA,MACJ,aAAa,qBAAqB,MAAM,eAAe,CAAC,GAAG;AAAA,QACzD,SAAS,UAAU;AAAA,QACnB,QAAQ,UAAU;AAAA,QAClB,QAAQ;AAAA,UACN,GAAI,UAAU,qBAAqB,CAAC;AAAA,UACpC,GAAI,UAAU,eAAe,CAAC;AAAA,QAChC;AAAA,MACF,CAAC;AAAA,IACH;AACA,eAAW,IAAI,MAAM,IAAI,0BAA0B,YAAY,CAAC;AAAA,EAClE;AACF;AAEA,eAAsB,oBAAmC;AACvD,MAAI,OAAQ;AACZ,MAAI;AACF,UAAM,MAAO,MAAM,8BAA8B;AAGjD,UAAM,SAAS,OAAO,MAAM,QAAQ,IAAI,WAAW,IAAI,IAAI,cAAc,CAAC;AAC1E,uBAAmB,MAAM;AAAA,EAC3B,SAAS,OAAO;AACd,WAAO,MAAM,iFAA4E,EAAE,KAAK,MAAM,CAAC;AAAA,EACzG,UAAE;AACA,QAAI;AACF,YAAM,kBAAkB,MAAM,oBAAoB;AAClD,+BAAyB,eAAe;AACxC,YAAM,mBAAmB,MAAM,qBAAqB;AACpD,gCAA0B,gBAAgB;AAAA,IAC5C,SAAS,OAAO;AACd,aAAO,MAAM,+DAA0D,EAAE,KAAK,MAAM,CAAC;AAAA,IACvF;AACA,aAAS;AAAA,EACX;AACF;AAEO,SAAS,SAAS,IAA2C;AAClE,SAAO,WAAW,IAAI,EAAE;AAC1B;AAEO,SAAS,aAAkC;AAChD,SAAO,MAAM,KAAK,WAAW,OAAO,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC;AAChF;AAEO,SAAS,mBAAmB,UAAuC;AACxE,SAAO,WAAW,EAAE,OAAO,CAAC,UAAU,MAAM,aAAa,QAAQ;AACnE;AAMO,SAAS,6BAAmC;AACjD,aAAW,MAAM;AACjB,WAAS;AACX;AAOO,SAAS,0BAA0B,QAAyB;AACjE,aAAW,MAAM;AACjB,qBAAmB,MAAM;AACzB,WAAS;AACX;AAQO,SAAS,kCACd,SACM;AACN,2BAAyB,OAAO;AAClC;AAMO,SAAS,mCACd,SACM;AACN,4BAA0B,OAAO;AACnC;",
   "names": ["key"]
 }

package/dist/modules/ai_assistant/lib/agent-runtime.js

@@ -1,3 +1,4 @@
+import { createLogger } from "@open-mercato/shared/lib/logger";
 import { randomUUID } from "node:crypto";
 import { createContainer } from "awilix";
 import {
@@ -34,6 +35,7 @@ import { recordTokenUsage } from "./token-usage-recorder.js";
 import { injectTaskPlanIntoStream } from "./task-plan-stream.js";
 import { TASK_PLAN_RUNTIME_PROMPT_SECTION } from "./task-plan-labels.js";
 import "./llm-bootstrap.js";
+const logger = createLogger("ai_assistant").child({ component: "agent-runtime" });
 const WRAPPER_DEFAULT_LOOP_CHAT = { maxSteps: 10 };
 const WRAPPER_DEFAULT_LOOP_OBJECT = {};
 function resolveLoopBudgetPreset(preset) {
@@ -172,9 +174,12 @@ class BudgetEnforcer {
   abort(reason) {
     if (this.abortReason !== null) return;
     this.abortReason = reason;
-    console.info(
-      `[AI Agents] Budget exceeded \u2014 aborting turn. Reason: ${reason}. toolCalls=${this.toolCallsUsed}, tokens=${this.tokensUsed}, elapsedMs=${Date.now() - this.turnStartMs}.`
-    );
+    logger.info("Budget exceeded \u2014 aborting turn", {
+      reason,
+      toolCalls: this.toolCallsUsed,
+      tokens: this.tokensUsed,
+      elapsedMs: Date.now() - this.turnStartMs
+    });
     this.abortController.abort(reason);
   }
   wire(userOnStepFinish) {
@@ -189,7 +194,7 @@ class BudgetEnforcer {
         try {
           await userOnStepFinish(event);
         } catch (err) {
-          console.error("[AI Agents] User onStepFinish threw; ignoring:", err);
+          logger.error("User onStepFinish threw; ignoring", { err });
         }
       }
     };
@@ -232,7 +237,7 @@ function buildLoopTraceCollector(agentId, sessionId, turnId, userOnStepFinish) {
       try {
         await userOnStepFinish(event);
       } catch (err) {
-        console.error("[AI Agents] User onStepFinish in LoopTrace collector threw; ignoring:", err);
+        logger.error("User onStepFinish in LoopTrace collector threw; ignoring", { err });
       }
     }
   };
@@ -299,9 +304,7 @@ function mergeStepOverrides(wrapperOverride, userOverride, agent, wrappedToolReg
       const normalized = normalizeAllowedToolNameForAgent(name, agent);
       const allowed = normalized !== null;
       if (!allowed) {
-        console.warn(
-          `[AI Agents] loop:active_tools_filtered \u2014 tool "${name}" is not in agent "${agent.id}" allowedTools; dropping from activeTools.`
-        );
+        logger.warn("loop:active_tools_filtered \u2014 tool not in agent allowedTools; dropping from activeTools", { toolName: name, agentId: agent.id });
       }
       return normalized ? [normalized] : [];
     });
@@ -313,9 +316,7 @@ function mergeStepOverrides(wrapperOverride, userOverride, agent, wrappedToolReg
     for (const [toolKey, userHandler] of Object.entries(userTools)) {
       const wrappedHandler = wrappedToolRegistry[toolKey];
       if (!wrappedHandler) {
-        console.warn(
-          `[AI Agents] mergeStepOverrides \u2014 tool "${toolKey}" from user prepareStep is not in the wrapper tool registry; dropping.`
-        );
+        logger.warn("mergeStepOverrides \u2014 tool from user prepareStep is not in the wrapper tool registry; dropping", { toolName: toolKey });
         continue;
       }
       if (userHandler !== wrappedHandler) {
@@ -361,9 +362,7 @@ function buildWrapperPrepareStep(agent, effectiveLoop, wrappedTools) {
         const normalized = normalizeAllowedToolNameForAgent(name, agent);
         const allowed = normalized !== null;
         if (!allowed) {
-          console.warn(
-            `[AI Agents] loop:active_tools_filtered \u2014 tool "${name}" is not in agent "${agent.id}" allowedTools; dropping from activeTools.`
-          );
+          logger.warn("loop:active_tools_filtered \u2014 tool not in agent allowedTools; dropping from activeTools", { toolName: name, agentId: agent.id });
         }
         return normalized ? [normalized] : [];
       });
@@ -373,10 +372,7 @@ function buildWrapperPrepareStep(agent, effectiveLoop, wrappedTools) {
       try {
         userOverride = await effectiveLoop.prepareStep(state);
       } catch (error) {
-        console.error(
-          `[AI Agents] User prepareStep threw for agent "${agent.id}"; ignoring user override:`,
-          error
-        );
+        logger.error("User prepareStep threw; ignoring user override", { agentId: agent.id, err: error });
         return mapPrepareStepResultForModel(wrapperOverride, wrappedTools);
       }
       return mapPrepareStepResultForModel(
@@ -438,10 +434,7 @@ async function resolveTenantAllowlistSnapshot(container, tenantId, organizationI
       organizationId: organizationId ?? null
     });
   } catch (error) {
-    console.warn(
-      "[AI Agents] Tenant allowlist lookup failed; falling back to env-only enforcement.",
-      error
-    );
+    logger.warn("Tenant allowlist lookup failed; falling back to env-only enforcement", { err: error });
     return null;
   }
 }
@@ -459,9 +452,7 @@ async function composeSystemPrompt(agent, pageContext, container, tenantId, orga
   if (typeof entityType !== "string" || entityType.length === 0) return baseFromOverride;
   if (typeof recordId !== "string" || recordId.length === 0) return baseFromOverride;
   if (!container) {
-    console.warn(
-      `[AI Agents] Agent "${agent.id}" declares resolvePageContext but no container was passed to runAiAgentText; skipping hydration.`
-    );
+    logger.warn("Agent declares resolvePageContext but no container was passed to runAiAgentText; skipping hydration", { agentId: agent.id });
     return baseFromOverride;
   }
   const hydrationInput = {
@@ -479,10 +470,7 @@ async function composeSystemPrompt(agent, pageContext, container, tenantId, orga
 ${hydrated}`;
     }
   } catch (error) {
-    console.error(
-      `[AI Agents] resolvePageContext for agent "${agent.id}" failed; continuing without hydration:`,
-      error
-    );
+    logger.error("resolvePageContext failed; continuing without hydration", { agentId: agent.id, err: error });
   }
   return baseFromOverride;
 }
@@ -507,10 +495,7 @@ async function resolveBaseSystemPromptWithOverride(agent, container, tenantId, o
     }
     return composeSystemPromptWithOverride(base, { sections: latest.sections });
   } catch (error) {
-    console.warn(
-      `[AI Agents] Prompt-override lookup failed for agent "${agent.id}"; falling back to built-in prompt.`,
-      error
-    );
+    logger.warn("Prompt-override lookup failed; falling back to built-in prompt", { agentId: agent.id, err: error });
     return base;
   }
 }
@@ -529,17 +514,12 @@ async function resolveMutationPolicyOverride(agentId, container, tenantId, organ
     if (!row) return null;
     const raw = row.mutationPolicy;
     if (!isKnownMutationPolicy(raw)) {
-      console.warn(
-        `[AI Agents] Ignoring corrupt mutationPolicy override row for agent "${agentId}": "${raw}". Falling back to code-declared policy.`
-      );
+      logger.warn("Ignoring corrupt mutationPolicy override row; falling back to code-declared policy", { agentId, policy: raw });
       return null;
     }
     return raw;
   } catch (error) {
-    console.warn(
-      `[AI Agents] mutationPolicy override lookup failed for agent "${agentId}"; falling back to code-declared policy.`,
-      error
-    );
+    logger.warn("mutationPolicy override lookup failed; falling back to code-declared policy", { agentId, err: error });
     return null;
   }
 }
@@ -566,10 +546,7 @@ async function resolveRuntimeModelOverride(agentId, container, tenantId, organiz
       baseURL: row.baseUrl ?? null
     };
   } catch (error) {
-    console.warn(
-      `[AI Agents] Runtime model override lookup failed for agent "${agentId}"; falling back to lower-priority sources.`,
-      error
-    );
+    logger.warn("Runtime model override lookup failed; falling back to lower-priority sources", { agentId, err: error });
     return null;
   }
 }