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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (199) hide show
  1. package/dist/frontend/hooks/useCommandPalette.js +16 -14
  2. package/dist/frontend/hooks/useCommandPalette.js.map +2 -2
  3. package/dist/modules/ai_assistant/api/ai/actions/[id]/cancel/route.js +3 -1
  4. package/dist/modules/ai_assistant/api/ai/actions/[id]/cancel/route.js.map +2 -2
  5. package/dist/modules/ai_assistant/api/ai/actions/[id]/confirm/route.js +3 -1
  6. package/dist/modules/ai_assistant/api/ai/actions/[id]/confirm/route.js.map +2 -2
  7. package/dist/modules/ai_assistant/api/ai/actions/[id]/route.js +3 -1
  8. package/dist/modules/ai_assistant/api/ai/actions/[id]/route.js.map +2 -2
  9. package/dist/modules/ai_assistant/api/ai/agents/[agentId]/loop-override/route.js +5 -3
  10. package/dist/modules/ai_assistant/api/ai/agents/[agentId]/loop-override/route.js.map +2 -2
  11. package/dist/modules/ai_assistant/api/ai/agents/[agentId]/models/route.js +4 -2
  12. package/dist/modules/ai_assistant/api/ai/agents/[agentId]/models/route.js.map +2 -2
  13. package/dist/modules/ai_assistant/api/ai/agents/[agentId]/mutation-policy/route.js +5 -3
  14. package/dist/modules/ai_assistant/api/ai/agents/[agentId]/mutation-policy/route.js.map +2 -2
  15. package/dist/modules/ai_assistant/api/ai/agents/[agentId]/prompt-override/route.js +4 -2
  16. package/dist/modules/ai_assistant/api/ai/agents/[agentId]/prompt-override/route.js.map +2 -2
  17. package/dist/modules/ai_assistant/api/ai/agents/route.js +3 -1
  18. package/dist/modules/ai_assistant/api/ai/agents/route.js.map +2 -2
  19. package/dist/modules/ai_assistant/api/ai/chat/route.js +6 -7
  20. package/dist/modules/ai_assistant/api/ai/chat/route.js.map +2 -2
  21. package/dist/modules/ai_assistant/api/ai/conversations/[conversationId]/route.js +5 -3
  22. package/dist/modules/ai_assistant/api/ai/conversations/[conversationId]/route.js.map +2 -2
  23. package/dist/modules/ai_assistant/api/ai/conversations/import/route.js +3 -1
  24. package/dist/modules/ai_assistant/api/ai/conversations/import/route.js.map +2 -2
  25. package/dist/modules/ai_assistant/api/ai/conversations/route.js +4 -2
  26. package/dist/modules/ai_assistant/api/ai/conversations/route.js.map +2 -2
  27. package/dist/modules/ai_assistant/api/ai/run-object/route.js +3 -1
  28. package/dist/modules/ai_assistant/api/ai/run-object/route.js.map +2 -2
  29. package/dist/modules/ai_assistant/api/chat/route.js +23 -14
  30. package/dist/modules/ai_assistant/api/chat/route.js.map +2 -2
  31. package/dist/modules/ai_assistant/api/health/route.js +3 -1
  32. package/dist/modules/ai_assistant/api/health/route.js.map +2 -2
  33. package/dist/modules/ai_assistant/api/mcp-key/route.js +3 -1
  34. package/dist/modules/ai_assistant/api/mcp-key/route.js.map +2 -2
  35. package/dist/modules/ai_assistant/api/route/route.js +11 -9
  36. package/dist/modules/ai_assistant/api/route/route.js.map +2 -2
  37. package/dist/modules/ai_assistant/api/session-key/route.js +3 -1
  38. package/dist/modules/ai_assistant/api/session-key/route.js.map +2 -2
  39. package/dist/modules/ai_assistant/api/settings/allowlist/route.js +4 -2
  40. package/dist/modules/ai_assistant/api/settings/allowlist/route.js.map +2 -2
  41. package/dist/modules/ai_assistant/api/settings/route.js +6 -4
  42. package/dist/modules/ai_assistant/api/settings/route.js.map +2 -2
  43. package/dist/modules/ai_assistant/api/tools/execute/route.js +3 -1
  44. package/dist/modules/ai_assistant/api/tools/execute/route.js.map +2 -2
  45. package/dist/modules/ai_assistant/api/tools/route.js +3 -1
  46. package/dist/modules/ai_assistant/api/tools/route.js.map +2 -2
  47. package/dist/modules/ai_assistant/api/usage/daily/route.js +3 -1
  48. package/dist/modules/ai_assistant/api/usage/daily/route.js.map +2 -2
  49. package/dist/modules/ai_assistant/api/usage/sessions/[sessionId]/route.js +3 -1
  50. package/dist/modules/ai_assistant/api/usage/sessions/[sessionId]/route.js.map +2 -2
  51. package/dist/modules/ai_assistant/api/usage/sessions/route.js +3 -1
  52. package/dist/modules/ai_assistant/api/usage/sessions/route.js.map +2 -2
  53. package/dist/modules/ai_assistant/cli.js +3 -0
  54. package/dist/modules/ai_assistant/cli.js.map +2 -2
  55. package/dist/modules/ai_assistant/lib/agent-policy.js +7 -5
  56. package/dist/modules/ai_assistant/lib/agent-policy.js.map +2 -2
  57. package/dist/modules/ai_assistant/lib/agent-registry.js +11 -13
  58. package/dist/modules/ai_assistant/lib/agent-registry.js.map +2 -2
  59. package/dist/modules/ai_assistant/lib/agent-runtime.js +21 -44
  60. package/dist/modules/ai_assistant/lib/agent-runtime.js.map +2 -2
  61. package/dist/modules/ai_assistant/lib/agent-tools.js +5 -10
  62. package/dist/modules/ai_assistant/lib/agent-tools.js.map +2 -2
  63. package/dist/modules/ai_assistant/lib/ai-overrides.js +5 -9
  64. package/dist/modules/ai_assistant/lib/ai-overrides.js.map +2 -2
  65. package/dist/modules/ai_assistant/lib/api-endpoint-index.js +22 -22
  66. package/dist/modules/ai_assistant/lib/api-endpoint-index.js.map +2 -2
  67. package/dist/modules/ai_assistant/lib/attachment-parts.js +10 -26
  68. package/dist/modules/ai_assistant/lib/attachment-parts.js.map +2 -2
  69. package/dist/modules/ai_assistant/lib/auth.js +3 -1
  70. package/dist/modules/ai_assistant/lib/auth.js.map +2 -2
  71. package/dist/modules/ai_assistant/lib/codemode-tools.js +15 -17
  72. package/dist/modules/ai_assistant/lib/codemode-tools.js.map +2 -2
  73. package/dist/modules/ai_assistant/lib/entity-index.js +7 -5
  74. package/dist/modules/ai_assistant/lib/entity-index.js.map +2 -2
  75. package/dist/modules/ai_assistant/lib/generated-registry-loader.js +3 -4
  76. package/dist/modules/ai_assistant/lib/generated-registry-loader.js.map +2 -2
  77. package/dist/modules/ai_assistant/lib/http-server.js +45 -48
  78. package/dist/modules/ai_assistant/lib/http-server.js.map +2 -2
  79. package/dist/modules/ai_assistant/lib/llm-bootstrap.js +5 -12
  80. package/dist/modules/ai_assistant/lib/llm-bootstrap.js.map +2 -2
  81. package/dist/modules/ai_assistant/lib/mcp-client.js +3 -1
  82. package/dist/modules/ai_assistant/lib/mcp-client.js.map +2 -2
  83. package/dist/modules/ai_assistant/lib/mcp-dev-key-resolution.js +3 -1
  84. package/dist/modules/ai_assistant/lib/mcp-dev-key-resolution.js.map +2 -2
  85. package/dist/modules/ai_assistant/lib/mcp-dev-server.js +3 -1
  86. package/dist/modules/ai_assistant/lib/mcp-dev-server.js.map +2 -2
  87. package/dist/modules/ai_assistant/lib/mcp-server.js +24 -19
  88. package/dist/modules/ai_assistant/lib/mcp-server.js.map +2 -2
  89. package/dist/modules/ai_assistant/lib/mcp-tool-adapter.js +3 -1
  90. package/dist/modules/ai_assistant/lib/mcp-tool-adapter.js.map +2 -2
  91. package/dist/modules/ai_assistant/lib/model-factory.js +4 -2
  92. package/dist/modules/ai_assistant/lib/model-factory.js.map +2 -2
  93. package/dist/modules/ai_assistant/lib/opencode-client.js +5 -3
  94. package/dist/modules/ai_assistant/lib/opencode-client.js.map +2 -2
  95. package/dist/modules/ai_assistant/lib/opencode-handlers.js +30 -12
  96. package/dist/modules/ai_assistant/lib/opencode-handlers.js.map +2 -2
  97. package/dist/modules/ai_assistant/lib/pending-action-cancel.js +3 -1
  98. package/dist/modules/ai_assistant/lib/pending-action-cancel.js.map +2 -2
  99. package/dist/modules/ai_assistant/lib/pending-action-executor.js +3 -1
  100. package/dist/modules/ai_assistant/lib/pending-action-executor.js.map +2 -2
  101. package/dist/modules/ai_assistant/lib/prepare-mutation.js +4 -6
  102. package/dist/modules/ai_assistant/lib/prepare-mutation.js.map +2 -2
  103. package/dist/modules/ai_assistant/lib/schema-utils.js +3 -1
  104. package/dist/modules/ai_assistant/lib/schema-utils.js.map +2 -2
  105. package/dist/modules/ai_assistant/lib/token-usage-recorder.js +4 -8
  106. package/dist/modules/ai_assistant/lib/token-usage-recorder.js.map +2 -2
  107. package/dist/modules/ai_assistant/lib/tool-executor.js +3 -1
  108. package/dist/modules/ai_assistant/lib/tool-executor.js.map +2 -2
  109. package/dist/modules/ai_assistant/lib/tool-loader.js +18 -25
  110. package/dist/modules/ai_assistant/lib/tool-loader.js.map +2 -2
  111. package/dist/modules/ai_assistant/lib/tool-registry.js +3 -1
  112. package/dist/modules/ai_assistant/lib/tool-registry.js.map +2 -2
  113. package/dist/modules/ai_assistant/lib/tool-test-runner.js +3 -1
  114. package/dist/modules/ai_assistant/lib/tool-test-runner.js.map +2 -2
  115. package/dist/modules/ai_assistant/setup.js +4 -8
  116. package/dist/modules/ai_assistant/setup.js.map +2 -2
  117. package/dist/modules/ai_assistant/subscribers/conversation-shared-notify.js +3 -1
  118. package/dist/modules/ai_assistant/subscribers/conversation-shared-notify.js.map +2 -2
  119. package/dist/modules/ai_assistant/workers/ai-pending-action-cleanup.js +7 -19
  120. package/dist/modules/ai_assistant/workers/ai-pending-action-cleanup.js.map +2 -2
  121. package/dist/modules/ai_assistant/workers/ai-token-usage-prune.js +5 -11
  122. package/dist/modules/ai_assistant/workers/ai-token-usage-prune.js.map +2 -2
  123. package/package.json +6 -6
  124. package/src/frontend/hooks/useCommandPalette.ts +17 -16
  125. package/src/modules/ai_assistant/__tests__/events.test.ts +23 -5
  126. package/src/modules/ai_assistant/__tests__/integration/ws-c-attachment-bridge.test.ts +21 -3
  127. package/src/modules/ai_assistant/__tests__/integration/ws-c-policy-and-tools.test.ts +22 -3
  128. package/src/modules/ai_assistant/__tests__/token-usage-recorder.test.ts +26 -5
  129. package/src/modules/ai_assistant/api/ai/actions/[id]/cancel/route.ts +4 -1
  130. package/src/modules/ai_assistant/api/ai/actions/[id]/confirm/route.ts +4 -1
  131. package/src/modules/ai_assistant/api/ai/actions/[id]/route.ts +4 -1
  132. package/src/modules/ai_assistant/api/ai/agents/[agentId]/loop-override/route.ts +6 -3
  133. package/src/modules/ai_assistant/api/ai/agents/[agentId]/models/route.ts +5 -2
  134. package/src/modules/ai_assistant/api/ai/agents/[agentId]/mutation-policy/route.ts +6 -3
  135. package/src/modules/ai_assistant/api/ai/agents/[agentId]/prompt-override/route.ts +5 -2
  136. package/src/modules/ai_assistant/api/ai/agents/route.ts +4 -1
  137. package/src/modules/ai_assistant/api/ai/chat/route.ts +7 -7
  138. package/src/modules/ai_assistant/api/ai/conversations/[conversationId]/route.ts +6 -3
  139. package/src/modules/ai_assistant/api/ai/conversations/import/route.ts +4 -1
  140. package/src/modules/ai_assistant/api/ai/conversations/route.ts +5 -2
  141. package/src/modules/ai_assistant/api/ai/run-object/route.ts +4 -1
  142. package/src/modules/ai_assistant/api/chat/route.ts +24 -15
  143. package/src/modules/ai_assistant/api/health/route.ts +4 -1
  144. package/src/modules/ai_assistant/api/mcp-key/route.ts +4 -1
  145. package/src/modules/ai_assistant/api/route/route.ts +12 -9
  146. package/src/modules/ai_assistant/api/session-key/route.ts +4 -1
  147. package/src/modules/ai_assistant/api/settings/allowlist/route.ts +5 -2
  148. package/src/modules/ai_assistant/api/settings/route.ts +7 -4
  149. package/src/modules/ai_assistant/api/tools/execute/route.ts +4 -1
  150. package/src/modules/ai_assistant/api/tools/route.ts +4 -1
  151. package/src/modules/ai_assistant/api/usage/daily/route.ts +4 -1
  152. package/src/modules/ai_assistant/api/usage/sessions/[sessionId]/route.ts +4 -1
  153. package/src/modules/ai_assistant/api/usage/sessions/route.ts +4 -1
  154. package/src/modules/ai_assistant/cli.ts +5 -0
  155. package/src/modules/ai_assistant/lib/__tests__/agent-policy.mutation-override.test.ts +20 -2
  156. package/src/modules/ai_assistant/lib/__tests__/agent-registry.test.ts +25 -5
  157. package/src/modules/ai_assistant/lib/__tests__/agent-runtime-loop-phase0.test.ts +21 -2
  158. package/src/modules/ai_assistant/lib/__tests__/agent-runtime-parity.test.ts +23 -3
  159. package/src/modules/ai_assistant/lib/__tests__/agent-runtime-phase4a.test.ts +20 -2
  160. package/src/modules/ai_assistant/lib/__tests__/agent-tools.test.ts +22 -3
  161. package/src/modules/ai_assistant/lib/__tests__/ai-overrides.test.ts +23 -3
  162. package/src/modules/ai_assistant/lib/__tests__/attachment-parts.test.ts +25 -7
  163. package/src/modules/ai_assistant/lib/__tests__/model-factory.test.ts +25 -5
  164. package/src/modules/ai_assistant/lib/__tests__/pending-action-cancel.test.ts +19 -1
  165. package/src/modules/ai_assistant/lib/__tests__/prepare-mutation.test.ts +22 -3
  166. package/src/modules/ai_assistant/lib/agent-policy.ts +8 -5
  167. package/src/modules/ai_assistant/lib/agent-registry.ts +12 -15
  168. package/src/modules/ai_assistant/lib/agent-runtime.ts +23 -46
  169. package/src/modules/ai_assistant/lib/agent-tools.ts +7 -11
  170. package/src/modules/ai_assistant/lib/ai-overrides.ts +6 -9
  171. package/src/modules/ai_assistant/lib/api-endpoint-index.ts +23 -22
  172. package/src/modules/ai_assistant/lib/attachment-parts.ts +14 -29
  173. package/src/modules/ai_assistant/lib/auth.ts +4 -1
  174. package/src/modules/ai_assistant/lib/codemode-tools.ts +17 -17
  175. package/src/modules/ai_assistant/lib/entity-index.ts +8 -5
  176. package/src/modules/ai_assistant/lib/generated-registry-loader.ts +4 -4
  177. package/src/modules/ai_assistant/lib/http-server.ts +46 -48
  178. package/src/modules/ai_assistant/lib/llm-bootstrap.ts +7 -13
  179. package/src/modules/ai_assistant/lib/mcp-client.ts +4 -1
  180. package/src/modules/ai_assistant/lib/mcp-dev-key-resolution.ts +4 -1
  181. package/src/modules/ai_assistant/lib/mcp-dev-server.ts +4 -1
  182. package/src/modules/ai_assistant/lib/mcp-server.ts +27 -19
  183. package/src/modules/ai_assistant/lib/mcp-tool-adapter.ts +4 -1
  184. package/src/modules/ai_assistant/lib/model-factory.ts +6 -3
  185. package/src/modules/ai_assistant/lib/opencode-client.ts +6 -3
  186. package/src/modules/ai_assistant/lib/opencode-handlers.ts +32 -12
  187. package/src/modules/ai_assistant/lib/pending-action-cancel.ts +4 -1
  188. package/src/modules/ai_assistant/lib/pending-action-executor.ts +4 -1
  189. package/src/modules/ai_assistant/lib/prepare-mutation.ts +5 -6
  190. package/src/modules/ai_assistant/lib/schema-utils.ts +4 -1
  191. package/src/modules/ai_assistant/lib/token-usage-recorder.ts +5 -8
  192. package/src/modules/ai_assistant/lib/tool-executor.ts +4 -1
  193. package/src/modules/ai_assistant/lib/tool-loader.ts +19 -25
  194. package/src/modules/ai_assistant/lib/tool-registry.ts +4 -1
  195. package/src/modules/ai_assistant/lib/tool-test-runner.ts +4 -1
  196. package/src/modules/ai_assistant/setup.ts +5 -8
  197. package/src/modules/ai_assistant/subscribers/conversation-shared-notify.ts +4 -1
  198. package/src/modules/ai_assistant/workers/ai-pending-action-cleanup.ts +8 -19
  199. package/src/modules/ai_assistant/workers/ai-token-usage-prune.ts +6 -11
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/modules/ai_assistant/lib/mcp-server.ts"],
4
- "sourcesContent": ["import { Server } from '@modelcontextprotocol/sdk/server/index.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport {\n ListToolsRequestSchema,\n CallToolRequestSchema,\n} from '@modelcontextprotocol/sdk/types.js'\nimport { zodToJsonSchema } from 'zod-to-json-schema'\nimport { getToolRegistry } from './tool-registry'\nimport { executeTool } from './tool-executor'\nimport { loadAllModuleTools, indexToolsForSearch } from './tool-loader'\nimport { authenticateMcpRequest, hasRequiredFeatures } from './auth'\nimport type { McpServerOptions, McpToolContext } from './types'\nimport type { SearchService } from '@open-mercato/search/service'\nimport type { RbacService } from '@open-mercato/core/modules/auth/services/rbacService'\n\n/**\n * Create and configure an MCP server instance.\n */\nexport async function createMcpServer(options: McpServerOptions): Promise<Server> {\n const { config, container, context, allowUnauthenticatedSuperadmin } = options\n\n // Treat empty / whitespace-only secrets as missing so a blank api key cannot\n // fall through into an unauthenticated branch.\n const apiKeySecret =\n typeof options.apiKeySecret === 'string' && options.apiKeySecret.trim().length > 0\n ? options.apiKeySecret\n : undefined\n\n let tenantId: string | null = null\n let organizationId: string | null = null\n let userId: string | null = null\n let userFeatures: string[] = []\n let isSuperAdmin = false\n\n // API key authentication takes precedence\n if (apiKeySecret) {\n const authResult = await authenticateMcpRequest(apiKeySecret, container)\n if (!authResult.success) {\n throw new Error(`API key authentication failed: ${authResult.error}`)\n }\n tenantId = authResult.tenantId\n organizationId = authResult.organizationId\n userId = authResult.userId\n userFeatures = authResult.features\n isSuperAdmin = authResult.isSuperAdmin\n console.error(`[MCP Server] Authenticated via API key: ${authResult.keyName}`)\n } else if (context && context.userId) {\n // Manual context with a real user \u2014 load that user's ACL.\n tenantId = context.tenantId\n organizationId = context.organizationId\n userId = context.userId\n\n try {\n const rbacService = container.resolve('rbacService') as {\n loadAcl: (\n userId: string,\n scope: { tenantId: string | null; organizationId: string | null }\n ) => Promise<{\n isSuperAdmin: boolean\n features: string[]\n }>\n }\n const acl = await rbacService.loadAcl(userId, {\n tenantId,\n organizationId,\n })\n userFeatures = acl.features\n isSuperAdmin = acl.isSuperAdmin\n } catch (error) {\n console.error('[MCP Server] Failed to load user ACL:', error)\n }\n } else if (allowUnauthenticatedSuperadmin) {\n // Explicit, loud dev/testing opt-in. Without a user there is no ACL to load,\n // so the server runs as superadmin with no tenant scoping beyond whatever the\n // caller pinned via `context`. NEVER enable this in production.\n if (context) {\n tenantId = context.tenantId\n organizationId = context.organizationId\n }\n isSuperAdmin = true\n console.error(\n '[MCP Server] WARNING: allowUnauthenticatedSuperadmin is enabled \u2014 running with UNAUTHENTICATED SUPERADMIN access and no per-user ACL. Do not use this outside local development/testing.'\n )\n } else {\n // Fail closed: refuse to start rather than silently escalating to superadmin.\n throw new Error(\n '[internal] MCP server refused to start: no authentication provided. Supply a valid apiKeySecret, a context with a non-empty userId, or explicitly set allowUnauthenticatedSuperadmin: true for local development.'\n )\n }\n\n const toolContext: McpToolContext = {\n tenantId,\n organizationId,\n userId,\n container,\n userFeatures,\n isSuperAdmin,\n apiKeySecret,\n }\n\n const server = new Server(\n { name: config.name, version: config.version },\n { capabilities: { tools: {} } }\n )\n\n // List tools handler\n server.setRequestHandler(ListToolsRequestSchema, async () => {\n const registry = getToolRegistry()\n const tools = Array.from(registry.getTools().values())\n\n // Filter tools based on user permissions\n const rbacService = container.resolve<RbacService>('rbacService')\n const accessibleTools = tools.filter((tool) =>\n hasRequiredFeatures(tool.requiredFeatures, userFeatures, isSuperAdmin, rbacService)\n )\n\n if (config.debug) {\n console.error(\n `[MCP Server] Listing ${accessibleTools.length}/${tools.length} tools (filtered by ACL)`\n )\n }\n\n return {\n tools: accessibleTools.map((tool) => ({\n name: tool.name,\n description: tool.description,\n // Cast to any for Zod v4 compatibility with zod-to-json-schema\n inputSchema: zodToJsonSchema(tool.inputSchema as any) as Record<string, unknown>,\n })),\n }\n })\n\n // Call tool handler\n server.setRequestHandler(CallToolRequestSchema, async (request) => {\n const { name, arguments: args } = request.params\n\n if (config.debug) {\n console.error(`[MCP Server] Calling tool: ${name}`, JSON.stringify(args))\n }\n\n const result = await executeTool(name, args ?? {}, toolContext)\n\n if (!result.success) {\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify({ error: result.error, code: result.errorCode }),\n },\n ],\n isError: true,\n }\n }\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result.result, null, 2),\n },\n ],\n }\n })\n\n return server\n}\n\n/**\n * Run MCP server with stdio transport.\n * This keeps the process running until terminated.\n *\n * Supports two authentication modes:\n * 1. API key: Provide `apiKeySecret` option\n * 2. Manual context: Provide `context` with tenant/org/user\n */\nexport async function runMcpServer(options: McpServerOptions): Promise<void> {\n // Generate entity graph for Code Mode search tool\n try {\n const { extractEntityGraph, cacheEntityGraph } = await import('./entity-graph')\n const { getOrm } = await import('@open-mercato/shared/lib/db/mikro')\n const orm = await getOrm()\n const graph = await extractEntityGraph(orm)\n cacheEntityGraph(graph)\n console.error(`[MCP Server] Entity graph: ${graph.nodes.length} entities`)\n } catch (error) {\n console.error('[MCP Server] Entity graph skipped:', error instanceof Error ? error.message : error)\n }\n\n // Pre-cache raw OpenAPI spec for Code Mode search tool\n try {\n const { getRawOpenApiSpec } = await import('./api-endpoint-index')\n await getRawOpenApiSpec()\n console.error('[MCP Server] Raw OpenAPI spec cached for Code Mode')\n } catch (error) {\n console.error('[MCP Server] Raw OpenAPI spec caching skipped:', error instanceof Error ? error.message : error)\n }\n\n // Load tools from all modules before starting\n await loadAllModuleTools()\n\n // Index tools for hybrid search discovery (if search service available)\n try {\n const searchService = options.container.resolve('searchService') as SearchService\n await indexToolsForSearch(searchService)\n } catch (error) {\n // Search service might not be configured - discovery will use fallback\n console.error('[MCP Server] Search indexing skipped (search service not available)')\n }\n\n const server = await createMcpServer(options)\n const transport = new StdioServerTransport()\n\n const toolCount = getToolRegistry().listToolNames().length\n\n console.error(`[MCP Server] Starting ${options.config.name} v${options.config.version}`)\n\n if (options.apiKeySecret && options.apiKeySecret.trim().length > 0) {\n console.error(`[MCP Server] Authentication: API key`)\n } else if (options.context && options.context.userId) {\n console.error(`[MCP Server] Tenant: ${options.context.tenantId ?? '(none)'}`)\n console.error(`[MCP Server] Organization: ${options.context.organizationId ?? '(none)'}`)\n console.error(`[MCP Server] User: ${options.context.userId}`)\n } else {\n console.error(`[MCP Server] Authentication: none (unauthenticated superadmin opt-in)`)\n }\n\n console.error(`[MCP Server] Tools registered: ${toolCount}`)\n\n await server.connect(transport)\n\n console.error('[MCP Server] Connected and ready for requests')\n\n // Handle shutdown gracefully\n const shutdown = async () => {\n console.error('[MCP Server] Shutting down...')\n await server.close()\n process.exit(0)\n }\n\n process.on('SIGINT', shutdown)\n process.on('SIGTERM', shutdown)\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import { Server } from '@modelcontextprotocol/sdk/server/index.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport {\n ListToolsRequestSchema,\n CallToolRequestSchema,\n} from '@modelcontextprotocol/sdk/types.js'\nimport { zodToJsonSchema } from 'zod-to-json-schema'\nimport { getToolRegistry } from './tool-registry'\nimport { executeTool } from './tool-executor'\nimport { loadAllModuleTools, indexToolsForSearch } from './tool-loader'\nimport { authenticateMcpRequest, hasRequiredFeatures } from './auth'\nimport type { McpServerOptions, McpToolContext } from './types'\nimport type { SearchService } from '@open-mercato/search/service'\nimport type { RbacService } from '@open-mercato/core/modules/auth/services/rbacService'\n\n\nconst formatStderrError = (error: unknown): string =>\n error instanceof Error ? error.stack ?? error.message : String(error)\n\nconst writeStderrLine = (line: string): void => {\n process.stderr.write(`${line}\\n`)\n}\n\n/**\n * Create and configure an MCP server instance.\n */\nexport async function createMcpServer(options: McpServerOptions): Promise<Server> {\n const { config, container, context, allowUnauthenticatedSuperadmin } = options\n\n // Treat empty / whitespace-only secrets as missing so a blank api key cannot\n // fall through into an unauthenticated branch.\n const apiKeySecret =\n typeof options.apiKeySecret === 'string' && options.apiKeySecret.trim().length > 0\n ? options.apiKeySecret\n : undefined\n\n let tenantId: string | null = null\n let organizationId: string | null = null\n let userId: string | null = null\n let userFeatures: string[] = []\n let isSuperAdmin = false\n\n // API key authentication takes precedence\n if (apiKeySecret) {\n const authResult = await authenticateMcpRequest(apiKeySecret, container)\n if (!authResult.success) {\n throw new Error(`API key authentication failed: ${authResult.error}`)\n }\n tenantId = authResult.tenantId\n organizationId = authResult.organizationId\n userId = authResult.userId\n userFeatures = authResult.features\n isSuperAdmin = authResult.isSuperAdmin\n writeStderrLine(`[MCP Server] Authenticated via API key: ${authResult.keyName}`)\n } else if (context && context.userId) {\n // Manual context with a real user \u2014 load that user's ACL.\n tenantId = context.tenantId\n organizationId = context.organizationId\n userId = context.userId\n\n try {\n const rbacService = container.resolve('rbacService') as {\n loadAcl: (\n userId: string,\n scope: { tenantId: string | null; organizationId: string | null }\n ) => Promise<{\n isSuperAdmin: boolean\n features: string[]\n }>\n }\n const acl = await rbacService.loadAcl(userId, {\n tenantId,\n organizationId,\n })\n userFeatures = acl.features\n isSuperAdmin = acl.isSuperAdmin\n } catch (error) {\n writeStderrLine(`[MCP Server] Failed to load user ACL: ${formatStderrError(error)}`)\n }\n } else if (allowUnauthenticatedSuperadmin) {\n // Explicit, loud dev/testing opt-in. Without a user there is no ACL to load,\n // so the server runs as superadmin with no tenant scoping beyond whatever the\n // caller pinned via `context`. NEVER enable this in production.\n if (context) {\n tenantId = context.tenantId\n organizationId = context.organizationId\n }\n isSuperAdmin = true\n writeStderrLine(\n '[MCP Server] WARNING: allowUnauthenticatedSuperadmin is enabled \u2014 running with UNAUTHENTICATED SUPERADMIN access and no per-user ACL. Do not use this outside local development/testing.'\n )\n } else {\n // Fail closed: refuse to start rather than silently escalating to superadmin.\n throw new Error(\n '[internal] MCP server refused to start: no authentication provided. Supply a valid apiKeySecret, a context with a non-empty userId, or explicitly set allowUnauthenticatedSuperadmin: true for local development.'\n )\n }\n\n const toolContext: McpToolContext = {\n tenantId,\n organizationId,\n userId,\n container,\n userFeatures,\n isSuperAdmin,\n apiKeySecret,\n }\n\n const server = new Server(\n { name: config.name, version: config.version },\n { capabilities: { tools: {} } }\n )\n\n // List tools handler\n server.setRequestHandler(ListToolsRequestSchema, async () => {\n const registry = getToolRegistry()\n const tools = Array.from(registry.getTools().values())\n\n // Filter tools based on user permissions\n const rbacService = container.resolve<RbacService>('rbacService')\n const accessibleTools = tools.filter((tool) =>\n hasRequiredFeatures(tool.requiredFeatures, userFeatures, isSuperAdmin, rbacService)\n )\n\n if (config.debug) {\n writeStderrLine(\n `[MCP Server] Listing ${accessibleTools.length}/${tools.length} tools (filtered by ACL)`\n )\n }\n\n return {\n tools: accessibleTools.map((tool) => ({\n name: tool.name,\n description: tool.description,\n // Cast to any for Zod v4 compatibility with zod-to-json-schema\n inputSchema: zodToJsonSchema(tool.inputSchema as any) as Record<string, unknown>,\n })),\n }\n })\n\n // Call tool handler\n server.setRequestHandler(CallToolRequestSchema, async (request) => {\n const { name, arguments: args } = request.params\n\n if (config.debug) {\n writeStderrLine(`[MCP Server] Calling tool: ${name} argKeys=${Object.keys(args ?? {}).join(',')}`)\n }\n\n const result = await executeTool(name, args ?? {}, toolContext)\n\n if (!result.success) {\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify({ error: result.error, code: result.errorCode }),\n },\n ],\n isError: true,\n }\n }\n\n return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(result.result, null, 2),\n },\n ],\n }\n })\n\n return server\n}\n\n/**\n * Run MCP server with stdio transport.\n * This keeps the process running until terminated.\n *\n * Supports two authentication modes:\n * 1. API key: Provide `apiKeySecret` option\n * 2. Manual context: Provide `context` with tenant/org/user\n */\nexport async function runMcpServer(options: McpServerOptions): Promise<void> {\n // Generate entity graph for Code Mode search tool\n try {\n const { extractEntityGraph, cacheEntityGraph } = await import('./entity-graph')\n const { getOrm } = await import('@open-mercato/shared/lib/db/mikro')\n const orm = await getOrm()\n const graph = await extractEntityGraph(orm)\n cacheEntityGraph(graph)\n writeStderrLine(`[MCP Server] Entity graph: ${graph.nodes.length} entities`)\n } catch (error) {\n writeStderrLine(`[MCP Server] Entity graph skipped: ${error instanceof Error ? error.message : String(error)}`)\n }\n\n // Pre-cache raw OpenAPI spec for Code Mode search tool\n try {\n const { getRawOpenApiSpec } = await import('./api-endpoint-index')\n await getRawOpenApiSpec()\n writeStderrLine('[MCP Server] Raw OpenAPI spec cached for Code Mode')\n } catch (error) {\n writeStderrLine(`[MCP Server] Raw OpenAPI spec caching skipped: ${error instanceof Error ? error.message : String(error)}`)\n }\n\n // Load tools from all modules before starting\n await loadAllModuleTools()\n\n // Index tools for hybrid search discovery (if search service available)\n try {\n const searchService = options.container.resolve('searchService') as SearchService\n await indexToolsForSearch(searchService)\n } catch (error) {\n // Search service might not be configured - discovery will use fallback\n writeStderrLine('[MCP Server] Search indexing skipped (search service not available)')\n }\n\n const server = await createMcpServer(options)\n const transport = new StdioServerTransport()\n\n const toolCount = getToolRegistry().listToolNames().length\n\n writeStderrLine(`[MCP Server] Starting ${options.config.name} v${options.config.version}`)\n\n if (options.apiKeySecret && options.apiKeySecret.trim().length > 0) {\n writeStderrLine(`[MCP Server] Authentication: API key`)\n } else if (options.context && options.context.userId) {\n writeStderrLine(`[MCP Server] Tenant: ${options.context.tenantId ?? '(none)'}`)\n writeStderrLine(`[MCP Server] Organization: ${options.context.organizationId ?? '(none)'}`)\n writeStderrLine(`[MCP Server] User: ${options.context.userId}`)\n } else {\n writeStderrLine(`[MCP Server] Authentication: none (unauthenticated superadmin opt-in)`)\n }\n\n writeStderrLine(`[MCP Server] Tools registered: ${toolCount}`)\n\n await server.connect(transport)\n\n writeStderrLine('[MCP Server] Connected and ready for requests')\n\n // Handle shutdown gracefully\n const shutdown = async () => {\n writeStderrLine('[MCP Server] Shutting down...')\n await server.close()\n process.exit(0)\n }\n\n process.on('SIGINT', shutdown)\n process.on('SIGTERM', shutdown)\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -1,5 +1,7 @@
1
+ import { createLogger } from "@open-mercato/shared/lib/logger";
1
2
  import { dynamicTool } from "ai";
2
3
  import { toSafeZodSchema } from "./schema-utils.js";
4
+ const logger = createLogger("ai_assistant");
3
5
  function convertMcpToolsToAiSdk(mcpClient, mcpTools) {
4
6
  const aiTools = {};
5
7
  for (const mcpTool of mcpTools) {
@@ -17,7 +19,7 @@ function convertMcpToolsToAiSdk(mcpClient, mcpTools) {
17
19
  }
18
20
  });
19
21
  } catch (error) {
20
- console.error(`[MCP Adapter] Error converting tool "${mcpTool.name}":`, error);
22
+ logger.error("Error converting tool", { toolName: mcpTool.name, err: error });
21
23
  }
22
24
  }
23
25
  return aiTools;
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/modules/ai_assistant/lib/mcp-tool-adapter.ts"],
4
- "sourcesContent": ["import { dynamicTool, type Tool } from 'ai'\nimport type { InProcessMcpClient, ToolInfoWithSchema } from './in-process-client'\nimport { toSafeZodSchema } from './schema-utils'\n\n/**\n * Convert MCP tools to Vercel AI SDK format.\n *\n * This adapter takes tools from an MCP client and converts them\n * to the format expected by the AI SDK's streamText function.\n *\n * Uses dynamicTool for dynamic schema support, which allows\n * tools with runtime-determined schemas (from MCP servers).\n *\n * @param mcpClient - MCP client to execute tools\n * @param mcpTools - List of tools with Zod schemas\n * @returns Record of AI SDK tools\n */\nexport function convertMcpToolsToAiSdk(\n mcpClient: InProcessMcpClient,\n mcpTools: ToolInfoWithSchema[]\n): Record<string, Tool<unknown, unknown>> {\n const aiTools: Record<string, Tool<unknown, unknown>> = {}\n\n for (const mcpTool of mcpTools) {\n try {\n // Convert schema using Zod4's toJSONSchema with unrepresentable: 'any'\n // This handles Date types by converting them to 'any' in JSON Schema,\n // then we convert back to a clean Zod schema\n const safeSchema = toSafeZodSchema(mcpTool.inputSchema)\n\n aiTools[mcpTool.name] = dynamicTool({\n description: mcpTool.description,\n inputSchema: safeSchema,\n execute: async (args: unknown) => {\n const result = await mcpClient.callTool(mcpTool.name, args)\n\n if (!result.success) {\n throw new Error(result.error || 'Tool execution failed')\n }\n\n // Return the result in a format suitable for LLM consumption\n return formatToolResult(result.result)\n },\n })\n } catch (error) {\n console.error(`[MCP Adapter] Error converting tool \"${mcpTool.name}\":`, error)\n }\n }\n\n return aiTools\n}\n\n/**\n * Format tool result for LLM consumption.\n * Converts various result types to a string representation.\n */\nfunction formatToolResult(result: unknown): string {\n if (result === null || result === undefined) {\n return 'No result returned'\n }\n\n if (typeof result === 'string') {\n return result\n }\n\n if (typeof result === 'number' || typeof result === 'boolean') {\n return String(result)\n }\n\n // For objects and arrays, return JSON representation\n try {\n return JSON.stringify(result, null, 2)\n } catch {\n return String(result)\n }\n}\n"],
5
- "mappings": "AAAA,SAAS,mBAA8B;AAEvC,SAAS,uBAAuB;AAezB,SAAS,uBACd,WACA,UACwC;AACxC,QAAM,UAAkD,CAAC;AAEzD,aAAW,WAAW,UAAU;AAC9B,QAAI;AAIF,YAAM,aAAa,gBAAgB,QAAQ,WAAW;AAEtD,cAAQ,QAAQ,IAAI,IAAI,YAAY;AAAA,QAClC,aAAa,QAAQ;AAAA,QACrB,aAAa;AAAA,QACb,SAAS,OAAO,SAAkB;AAChC,gBAAM,SAAS,MAAM,UAAU,SAAS,QAAQ,MAAM,IAAI;AAE1D,cAAI,CAAC,OAAO,SAAS;AACnB,kBAAM,IAAI,MAAM,OAAO,SAAS,uBAAuB;AAAA,UACzD;AAGA,iBAAO,iBAAiB,OAAO,MAAM;AAAA,QACvC;AAAA,MACF,CAAC;AAAA,IACH,SAAS,OAAO;AACd,cAAQ,MAAM,wCAAwC,QAAQ,IAAI,MAAM,KAAK;AAAA,IAC/E;AAAA,EACF;AAEA,SAAO;AACT;AAMA,SAAS,iBAAiB,QAAyB;AACjD,MAAI,WAAW,QAAQ,WAAW,QAAW;AAC3C,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,WAAW,UAAU;AAC9B,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,WAAW,YAAY,OAAO,WAAW,WAAW;AAC7D,WAAO,OAAO,MAAM;AAAA,EACtB;AAGA,MAAI;AACF,WAAO,KAAK,UAAU,QAAQ,MAAM,CAAC;AAAA,EACvC,QAAQ;AACN,WAAO,OAAO,MAAM;AAAA,EACtB;AACF;",
4
+ "sourcesContent": ["import { createLogger } from '@open-mercato/shared/lib/logger'\nimport { dynamicTool, type Tool } from 'ai'\nimport type { InProcessMcpClient, ToolInfoWithSchema } from './in-process-client'\nimport { toSafeZodSchema } from './schema-utils'\n\nconst logger = createLogger('ai_assistant')\n\n/**\n * Convert MCP tools to Vercel AI SDK format.\n *\n * This adapter takes tools from an MCP client and converts them\n * to the format expected by the AI SDK's streamText function.\n *\n * Uses dynamicTool for dynamic schema support, which allows\n * tools with runtime-determined schemas (from MCP servers).\n *\n * @param mcpClient - MCP client to execute tools\n * @param mcpTools - List of tools with Zod schemas\n * @returns Record of AI SDK tools\n */\nexport function convertMcpToolsToAiSdk(\n mcpClient: InProcessMcpClient,\n mcpTools: ToolInfoWithSchema[]\n): Record<string, Tool<unknown, unknown>> {\n const aiTools: Record<string, Tool<unknown, unknown>> = {}\n\n for (const mcpTool of mcpTools) {\n try {\n // Convert schema using Zod4's toJSONSchema with unrepresentable: 'any'\n // This handles Date types by converting them to 'any' in JSON Schema,\n // then we convert back to a clean Zod schema\n const safeSchema = toSafeZodSchema(mcpTool.inputSchema)\n\n aiTools[mcpTool.name] = dynamicTool({\n description: mcpTool.description,\n inputSchema: safeSchema,\n execute: async (args: unknown) => {\n const result = await mcpClient.callTool(mcpTool.name, args)\n\n if (!result.success) {\n throw new Error(result.error || 'Tool execution failed')\n }\n\n // Return the result in a format suitable for LLM consumption\n return formatToolResult(result.result)\n },\n })\n } catch (error) {\n logger.error('Error converting tool', { toolName: mcpTool.name, err: error })\n }\n }\n\n return aiTools\n}\n\n/**\n * Format tool result for LLM consumption.\n * Converts various result types to a string representation.\n */\nfunction formatToolResult(result: unknown): string {\n if (result === null || result === undefined) {\n return 'No result returned'\n }\n\n if (typeof result === 'string') {\n return result\n }\n\n if (typeof result === 'number' || typeof result === 'boolean') {\n return String(result)\n }\n\n // For objects and arrays, return JSON representation\n try {\n return JSON.stringify(result, null, 2)\n } catch {\n return String(result)\n }\n}\n"],
5
+ "mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,mBAA8B;AAEvC,SAAS,uBAAuB;AAEhC,MAAM,SAAS,aAAa,cAAc;AAenC,SAAS,uBACd,WACA,UACwC;AACxC,QAAM,UAAkD,CAAC;AAEzD,aAAW,WAAW,UAAU;AAC9B,QAAI;AAIF,YAAM,aAAa,gBAAgB,QAAQ,WAAW;AAEtD,cAAQ,QAAQ,IAAI,IAAI,YAAY;AAAA,QAClC,aAAa,QAAQ;AAAA,QACrB,aAAa;AAAA,QACb,SAAS,OAAO,SAAkB;AAChC,gBAAM,SAAS,MAAM,UAAU,SAAS,QAAQ,MAAM,IAAI;AAE1D,cAAI,CAAC,OAAO,SAAS;AACnB,kBAAM,IAAI,MAAM,OAAO,SAAS,uBAAuB;AAAA,UACzD;AAGA,iBAAO,iBAAiB,OAAO,MAAM;AAAA,QACvC;AAAA,MACF,CAAC;AAAA,IACH,SAAS,OAAO;AACd,aAAO,MAAM,yBAAyB,EAAE,UAAU,QAAQ,MAAM,KAAK,MAAM,CAAC;AAAA,IAC9E;AAAA,EACF;AAEA,SAAO;AACT;AAMA,SAAS,iBAAiB,QAAyB;AACjD,MAAI,WAAW,QAAQ,WAAW,QAAW;AAC3C,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,WAAW,UAAU;AAC9B,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,WAAW,YAAY,OAAO,WAAW,WAAW;AAC7D,WAAO,OAAO,MAAM;AAAA,EACtB;AAGA,MAAI;AACF,WAAO,KAAK,UAAU,QAAQ,MAAM,CAAC;AAAA,EACvC,QAAQ;AACN,WAAO,OAAO,MAAM;AAAA,EACtB;AACF;",
6
6
  "names": []
7
7
  }
@@ -1,3 +1,4 @@
1
+ import { createLogger } from "@open-mercato/shared/lib/logger";
1
2
  import { llmProviderRegistry } from "@open-mercato/shared/lib/ai/llm-provider-registry";
2
3
  import {
3
4
  intersectAllowlists,
@@ -6,6 +7,7 @@ import {
6
7
  isProviderAllowedInEffective,
7
8
  providerIdAliases
8
9
  } from "./model-allowlist.js";
10
+ const logger = createLogger("ai_assistant");
9
11
  class AiModelFactoryError extends Error {
10
12
  constructor(code, message) {
11
13
  super(message);
@@ -258,7 +260,7 @@ function enforceAllowlist(input) {
258
260
  if (replacement) {
259
261
  const source = effective.tenantOverridesActive ? "the effective allowlist (env \u2229 tenant)" : "OM_AI_AVAILABLE_PROVIDERS";
260
262
  fallback = `Provider "${provider.id}" is not in ${source}; using "${replacement.id}" instead.`;
261
- console.warn(`[AI Model Factory] ${fallback}`);
263
+ logger.warn("Allowlist provider fallback", { reason: fallback });
262
264
  provider = replacement;
263
265
  modelId = pickAllowedModel({
264
266
  provider,
@@ -276,7 +278,7 @@ function enforceAllowlist(input) {
276
278
  if (replacementModel !== modelId) {
277
279
  const source = effective.tenantOverridesActive ? `the effective allowlist (env \u2229 tenant) for "${provider.id}"` : `OM_AI_AVAILABLE_MODELS_${provider.id.toUpperCase()}`;
278
280
  const reason = `Model "${modelId}" is not in ${source}; using "${replacementModel}" instead.`;
279
- console.warn(`[AI Model Factory] ${reason}`);
281
+ logger.warn("Allowlist model fallback", { reason });
280
282
  fallback = fallback ? `${fallback} ${reason}` : reason;
281
283
  modelId = replacementModel;
282
284
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/modules/ai_assistant/lib/model-factory.ts"],
4
- "sourcesContent": ["/**\n * Shared AI model factory.\n *\n * Consolidates the previously-per-module model-creation plumbing (inbox_ops's\n * `llmProvider.ts`, the agent-runtime's inline `resolveAgentModel`) behind a\n * single DI-friendly port. Every AI-runtime caller (chat, object, inbox-ops\n * extraction, future agents) resolves the `LanguageModelV1` it hands to the\n * Vercel AI SDK through `createModelFactory(container).resolveModel(...)` so\n * all of them share one resolution order:\n *\n * 1. `callerOverride` (non-empty string) \u2014 highest precedence, e.g. the\n * `modelOverride` field on `runAiAgentText`/`runAiAgentObject`.\n * Accepts a slash-qualified `<provider>/<model>` shorthand (Phase 1).\n * 2. Env variable `OM_AI_<MODULE>_MODEL` (uppercased `moduleId`) when\n * `moduleId` is provided. Example:\n * `OM_AI_INBOX_OPS_MODEL=claude-haiku-4-5`,\n * `OM_AI_CATALOG_MODEL=gpt-4o-mini`. The legacy\n * `<MODULE>_AI_MODEL` form (e.g. `INBOX_OPS_AI_MODEL`) is read as a\n * backward-compatibility fallback when the canonical name is unset.\n * Accepts a slash-qualified shorthand (Phase 1).\n * 3. `agentDefaultModel` \u2014 typically `AiAgentDefinition.defaultModel`.\n * Accepts a slash-qualified `<provider>/<model>` shorthand (Phase 1).\n * 4. Global env `OM_AI_MODEL` (canonical) with `OPENCODE_MODEL` kept as\n * a backward-compatibility fallback. Accepts either a plain model id\n * (`gpt-5-mini`) or a slash-qualified id (`openai/gpt-5-mini`).\n * Slash qualifiers consume the provider axis at the same step. When the\n * selected model source carries a provider hint, the provider/model pair\n * is atomic: an unconfigured hinted provider fails instead of sending\n * the model id to a different configured provider.\n * 5. The configured provider's own default model id\n * (`provider.defaultModel`).\n *\n * Every model-axis source is parsed through {@link parseSlashShorthand}.\n * Resolution walks the chain top-down and takes the first non-null hint as\n * the registry-walk seed. If the winning model source also supplies the\n * winning provider hint \u2014 either through `<provider>/<model>` or through the\n * same-source provider field/env var \u2014 that pair is resolved exactly and\n * never mixed with a fallback provider.\n *\n * Provider-axis seed order (highest priority first):\n * 1. Slash-prefix from `callerOverride` (Phase 1).\n * 2. `providerOverride` \u2014 request-time provider override (Phase 1).\n * 3. Slash-prefix from `OM_AI_<MODULE>_MODEL` (legacy `<MODULE>_AI_MODEL`) (Phase 1).\n * 4. `OM_AI_<MODULE>_PROVIDER` env (legacy `<MODULE>_AI_PROVIDER`) (Phase 1).\n * 5. Slash-prefix from `agentDefaultModel` (Phase 1).\n * 6. `agentDefaultProvider` \u2014 `AiAgentDefinition.defaultProvider` (Phase 1).\n * 7. Slash-prefix from `OM_AI_MODEL` (legacy `OPENCODE_MODEL`) (Phase 0).\n * 8. `OM_AI_PROVIDER` (legacy `OPENCODE_PROVIDER`) (Phase 0).\n *\n * The `OM_AI_*` env knobs are canonical; the legacy `OPENCODE_PROVIDER` /\n * `OPENCODE_MODEL` envs stay bound to the OpenCode Code Mode stack and are\n * also honored as backward-compatibility fallbacks here.\n *\n * The factory throws {@link AiModelFactoryError} when no provider is\n * configured \u2014 every current call site already expects the throw (see the\n * bare `throw new Error('No LLM provider is configured...')` in\n * `agent-runtime.ts` prior to the consolidation).\n *\n * @see packages/shared/src/lib/ai/llm-provider-registry.ts\n * @see packages/ai-assistant/src/modules/ai_assistant/lib/agent-runtime.ts\n * @see packages/core/src/modules/inbox_ops/lib/llmProvider.ts\n */\n\nimport type { AwilixContainer } from 'awilix'\nimport type { EnvLookup, LlmProvider } from '@open-mercato/shared/lib/ai/llm-provider'\nimport { llmProviderRegistry } from '@open-mercato/shared/lib/ai/llm-provider-registry'\nimport {\n intersectAllowlists,\n canonicalProviderId,\n isModelAllowedForProviderInEffective,\n isProviderAllowedInEffective,\n providerIdAliases,\n type EffectiveAllowlist,\n type TenantAllowlistSnapshot,\n} from './model-allowlist'\n\n/**\n * Minimal AI SDK LanguageModel shape \u2014 the factory exposes the protocol-\n * agnostic `unknown`-typed return from {@link LlmProvider.createModel} under a\n * dedicated alias so callers can document intent without importing the AI SDK\n * here. Call sites that hand the result to `generateText` / `streamText` /\n * `generateObject` / `streamObject` continue to cast to the SDK's\n * `LanguageModelV1` / `LanguageModel` union exactly as they already do.\n */\nexport type AiModelInstance = unknown\n\n/**\n * Input accepted by {@link AiModelFactory.resolveModel}. All fields are\n * optional \u2014 passing an empty input resolves the provider default.\n */\nexport interface AiModelFactoryInput {\n /**\n * Owning module id (matches `Module.id`). When set, the factory checks\n * `OM_AI_<MODULE>_MODEL` (uppercased) as the env-override source, with\n * the legacy `<MODULE>_AI_MODEL` form honored as a backward-compatibility\n * fallback. Example: `moduleId: 'inbox_ops'` \u2192 canonical env var\n * `OM_AI_INBOX_OPS_MODEL` (legacy `INBOX_OPS_AI_MODEL`).\n *\n * Also enables the `OM_AI_<MODULE>_PROVIDER` env axis (legacy\n * `<MODULE>_AI_PROVIDER` honored as a backward-compatibility fallback).\n */\n moduleId?: string\n /**\n * Agent-level default, typically `AiAgentDefinition.defaultModel`. Used\n * when neither `callerOverride` nor the module env override is present.\n * Accepts a slash-qualified `<provider>/<model>` shorthand (Phase 1).\n */\n agentDefaultModel?: string\n /**\n * Agent-level default provider, typically `AiAgentDefinition.defaultProvider`.\n * Named provider id. When paired with an agent default model, the pair is\n * resolved exactly and fails if the provider is unconfigured. When used as\n * a provider preference without an agent default model, it can fall through\n * to the next configured provider. Sits between `OM_AI_<MODULE>_PROVIDER`\n * and the global `OM_AI_PROVIDER` in the provider-axis seed list above.\n *\n * Phase 1 of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n agentDefaultProvider?: string\n /**\n * Per-call override (e.g. `runAiAgentText({ modelOverride })`). Wins over\n * every other source when it is a non-empty trimmed string. Empty strings\n * are treated as \"no override\" so the next source in the chain wins \u2014\n * callers MUST NOT need a separate \"clear override\" API.\n */\n callerOverride?: string\n /**\n * Request-time provider override \u2014 wins for the provider axis at the same\n * priority as `callerOverride` for the model axis. A non-empty string\n * that does not match any registered provider id is silently ignored and\n * the factory falls through to the next provider source.\n *\n * Phase 1 of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n providerOverride?: string\n /**\n * Agent-level default base URL, typically `AiAgentDefinition.defaultBaseUrl`.\n * Sits between the `<MODULE>_AI_BASE_URL` env var and the preset's own\n * `baseURLEnvKeys` in the resolution chain.\n *\n * Phase 2 of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n agentDefaultBaseUrl?: string\n /**\n * Per-call base URL override that wins over every other source. Intended\n * for programmatic callers only \u2014 the HTTP query-param baseUrl and the\n * AI_RUNTIME_BASEURL_ALLOWLIST arrive in Phase 4a.\n *\n * Phase 2 of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n baseUrlOverride?: string\n /**\n * Per-tenant default loaded from `ai_agent_runtime_overrides` by the agent\n * runtime (best-effort, fail-open). Sits at step 3 of the resolution chain\n * between the caller/request override (step 1\u20132) and the module-env axis\n * (step 4).\n *\n * Honored ONLY when `allowRuntimeOverride !== false` on the agent definition\n * (checked via `resolveAllowRuntimeOverride`). The agent runtime is\n * responsible for hydration \u2014 the factory does NOT load the row itself.\n *\n * Phase 4a of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n tenantOverride?: {\n providerId?: string | null\n modelId?: string | null\n baseURL?: string | null\n }\n /**\n * Per-request override forwarded from the HTTP dispatcher query params\n * (`?provider=`, `?model=`, `?baseUrl=`). Sits at step 1 of the resolution\n * chain \u2014 wins over everything else for that turn.\n *\n * Honored ONLY when `allowRuntimeOverride !== false` on the agent (checked\n * via `resolveAllowRuntimeOverride`). The dispatcher validates all three\n * values before setting this input.\n *\n * Phase 4a of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n requestOverride?: {\n providerId?: string | null\n modelId?: string | null\n baseURL?: string | null\n }\n /**\n * When false, steps 1 (requestOverride) and 3 (tenantOverride) of the\n * resolution chain are skipped. Agents that pin a specific model for\n * correctness reasons set `AiAgentDefinition.allowRuntimeOverride = false`.\n * Default behavior (omitted) is permissive (= true).\n *\n * Canonical field (renamed from `allowRuntimeModelOverride` in Phase 4 of\n * spec `2026-04-28-ai-agents-agentic-loop-controls`). The deprecated alias\n * `allowRuntimeModelOverride` is still accepted via the resolution helper\n * {@link resolveAllowRuntimeOverride}.\n *\n * Phase 4a of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n allowRuntimeOverride?: boolean\n /**\n * @deprecated Use `allowRuntimeOverride` instead.\n *\n * Phase 4a of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n allowRuntimeModelOverride?: boolean\n /**\n * Optional tenant allowlist snapshot (Phase 1780-6). When supplied, the\n * factory clips the resolved (provider, model) to the intersection of the\n * env allowlist (`OM_AI_AVAILABLE_*`) and this tenant allowlist. Pass `null`\n * or omit to fall back to env-only enforcement.\n *\n * The settings PUT route validates writes against the env allowlist before\n * persisting, so the snapshot here is trusted to be a subset of env. The\n * factory still defends against drift (env tightened after write) by\n * intersecting at resolution time.\n */\n tenantAllowlist?: TenantAllowlistSnapshot | null\n}\n\n/**\n * Materialized output returned by {@link AiModelFactory.resolveModel}.\n */\nexport interface AiModelResolution {\n /**\n * Concrete AI SDK model instance ready to pass to\n * `generateText`/`streamText`/`generateObject`/`streamObject`. Typed as\n * {@link AiModelInstance} to avoid coupling this port to a specific SDK\n * major version.\n */\n model: AiModelInstance\n /** Resolved upstream model id (e.g. `claude-haiku-4-5-20251001`). */\n modelId: string\n /** Stable provider id from {@link LlmProvider.id}. */\n providerId: string\n /**\n * Which source won resolution. Useful for logs and tests; never exposed\n * as a public contract beyond these enum values.\n *\n * - `env_default` indicates `OM_AI_MODEL` (preferred) or the legacy\n * `OPENCODE_MODEL` fallback supplied the model id.\n */\n source:\n | 'request_override'\n | 'caller_override'\n | 'tenant_override'\n | 'module_env'\n | 'agent_default'\n | 'env_default'\n | 'provider_default'\n | 'allowlist_fallback'\n /**\n * Resolved base URL passed to the adapter (if any). Undefined when the\n * adapter will use its built-in default. Included for observability and\n * test assertions; never exposed over HTTP (Phase 4a adds the allowlist).\n */\n baseURL?: string\n /**\n * Populated when the env-driven OM_AI_AVAILABLE_PROVIDERS /\n * OM_AI_AVAILABLE_MODELS_<PROVIDER> allowlist rejected the originally\n * resolved (provider, model) and the factory fell back to a safe pair.\n * Includes the rejected ids and a human-readable reason so the UI / logs\n * can surface why the runtime did not honor the requested combination.\n */\n allowlistFallback?: {\n originalProviderId: string\n originalModelId: string\n reason: string\n }\n}\n\n/**\n * Port exposed by {@link createModelFactory}. Stateless \u2014 the factory\n * re-reads the registry + env on every `resolveModel` call so hot-reload\n * and test overrides work without needing factory re-creation.\n */\nexport interface AiModelFactory {\n resolveModel(input: AiModelFactoryInput): AiModelResolution\n}\n\n/**\n * Typed error thrown by the factory when it cannot materialize a model.\n *\n * `code` is a stable string union so downstream callers can branch without\n * parsing error messages. `AiModelFactoryError`s bubble through\n * `runAiAgentText`/`runAiAgentObject` unchanged \u2014 the agent runtime does\n * NOT catch them, matching the pre-consolidation behavior of the inline\n * resolver.\n */\nexport type AiModelFactoryErrorCode =\n | 'no_provider_configured'\n | 'api_key_missing'\n\nexport class AiModelFactoryError extends Error {\n readonly code: AiModelFactoryErrorCode\n\n constructor(code: AiModelFactoryErrorCode, message: string) {\n super(message)\n this.name = 'AiModelFactoryError'\n this.code = code\n }\n}\n\n/**\n * Subset of {@link import('@open-mercato/shared/lib/ai/llm-provider-registry').LlmProviderRegistry}\n * the factory consumes. Defined locally so test doubles only need to mock\n * the methods the factory actually calls.\n */\nexport interface AiModelFactoryRegistry {\n resolveFirstConfigured(options?: {\n env?: EnvLookup\n order?: readonly string[]\n }): LlmProvider | null\n /**\n * Optional registry lookup used by the slash-shorthand parser to validate\n * a provider hint. When absent, slash parsing is disabled and the entire\n * model token is treated as a model id (mirrors the pre-Phase-0\n * behavior).\n */\n get?(id: string): LlmProvider | null\n /**\n * Optional registry enumeration used by the Phase 1780-6 allowlist\n * intersection so the env model lists are pre-loaded for every provider\n * (and not just the resolved one). Test doubles MAY omit this \u2014 the\n * factory still defends correctly by also seeding the resolved provider's\n * id directly into `intersectAllowlists(...)`.\n */\n list?(): readonly LlmProvider[]\n}\n\n/**\n * Internal dependencies of the factory. Exposed for tests only; production\n * callers rely on the defaults wired by {@link createModelFactory}.\n */\nexport interface CreateModelFactoryDependencies {\n /**\n * Registry used to resolve the first configured provider. Defaults to the\n * singleton `llmProviderRegistry`. Implementations MAY honor the optional\n * `order` argument to prefer the operator-selected provider.\n */\n registry?: AiModelFactoryRegistry\n /** Env lookup for `OM_AI_<MODULE>_MODEL` + provider credentials. */\n env?: EnvLookup\n}\n\nfunction normalizeOverride(value: string | undefined): string | null {\n if (typeof value !== 'string') return null\n const trimmed = value.trim()\n return trimmed.length > 0 ? trimmed : null\n}\n\n/**\n * Reads the operator-selected provider id from the unified env vars.\n * Returns `null` when neither `OM_AI_PROVIDER` nor the legacy\n * `OPENCODE_PROVIDER` resolves to a known provider \u2014 in that case the\n * registry falls back to its default registration walk.\n */\nfunction readGlobalProviderFromEnv(\n env: EnvLookup,\n registry: Pick<AiModelFactoryRegistry, 'get'>,\n): string | null {\n const candidates = [normalizeOverride(env.OM_AI_PROVIDER), normalizeOverride(env.OPENCODE_PROVIDER)]\n for (const candidate of candidates) {\n if (!candidate) continue\n if (!registry.get) return providerIdAliases(candidate)[0] ?? candidate\n for (const alias of providerIdAliases(candidate)) {\n if (registry.get(alias)) return alias\n }\n }\n return null\n}\n\n/**\n * Reads the global model hint from the unified env vars. `OM_AI_MODEL`\n * wins over the legacy `OPENCODE_MODEL`.\n */\nfunction readGlobalModelFromEnv(env: EnvLookup): string | null {\n return normalizeOverride(env.OM_AI_MODEL) ?? normalizeOverride(env.OPENCODE_MODEL)\n}\n\n/** Canonical per-module model env. Example: `OM_AI_INBOX_OPS_MODEL`. */\nfunction moduleModelEnvVarName(moduleId: string): string {\n return `OM_AI_${moduleId.toUpperCase()}_MODEL`\n}\n\n/**\n * Legacy per-module model env (pre-OM_AI_* rename). Example:\n * `INBOX_OPS_AI_MODEL`. Read as a backward-compatibility fallback only.\n */\nfunction legacyModuleModelEnvVarName(moduleId: string): string {\n return `${moduleId.toUpperCase()}_AI_MODEL`\n}\n\nfunction readModuleModelEnvOverride(env: EnvLookup, moduleId: string): string | null {\n return (\n normalizeOverride(env[moduleModelEnvVarName(moduleId)]) ??\n normalizeOverride(env[legacyModuleModelEnvVarName(moduleId)])\n )\n}\n\n/** Canonical per-module provider env. Example: `OM_AI_INBOX_OPS_PROVIDER`. */\nfunction moduleProviderEnvVarName(moduleId: string): string {\n return `OM_AI_${moduleId.toUpperCase()}_PROVIDER`\n}\n\n/**\n * Legacy per-module provider env (pre-OM_AI_* rename). Example:\n * `INBOX_OPS_AI_PROVIDER`. Read as a backward-compatibility fallback only.\n */\nfunction legacyModuleProviderEnvVarName(moduleId: string): string {\n return `${moduleId.toUpperCase()}_AI_PROVIDER`\n}\n\nfunction readModuleProviderEnvOverride(env: EnvLookup, moduleId: string): string | null {\n return (\n normalizeOverride(env[moduleProviderEnvVarName(moduleId)]) ??\n normalizeOverride(env[legacyModuleProviderEnvVarName(moduleId)])\n )\n}\n\nfunction normalizeProviderHint(\n providerId: string | null,\n registry: AiModelFactoryRegistry,\n): string | null {\n if (!providerId) return null\n const knownProviderIds = registry.list?.().map((provider) => provider.id) ?? []\n if (knownProviderIds.length > 0) {\n return canonicalProviderId(providerId, knownProviderIds)\n }\n return providerIdAliases(providerId)[0] ?? providerId\n}\n\nfunction resolveRequiredProvider(\n providerId: string,\n registry: AiModelFactoryRegistry,\n env: EnvLookup,\n): LlmProvider | null {\n const resolved = registry.resolveFirstConfigured({ env, order: [providerId] })\n if (resolved?.id === providerId) return resolved\n\n const direct = registry.get?.(providerId) ?? null\n if (direct) return direct.isConfigured(env) ? direct : null\n return null\n}\n\nfunction requiredProviderMessage(providerId: string, registry: AiModelFactoryRegistry, env: EnvLookup): string {\n const provider = registry.get?.(providerId) ?? null\n const envKey = provider?.getConfiguredEnvKey?.(env)\n const credentialHint = envKey\n ? ` Set ${envKey} to use this provider.`\n : ' Configure the matching provider API key to use this provider.'\n return `The resolved model is pinned to provider \"${providerId}\", but that provider is not configured.${credentialHint} The runtime refuses to send provider-specific model ids to a different provider.`\n}\n\nfunction moduleBaseUrlEnvVarName(moduleId: string): string {\n return `${moduleId.toUpperCase()}_AI_BASE_URL`\n}\n\n/**\n * Splits a slash-qualified model token (e.g. `openai/gpt-5-mini`) into\n * `{ providerHint, modelId }` when the prefix matches a registered provider\n * id, otherwise returns the entire token as the model id and a null hint.\n *\n * The registry-membership guard avoids mis-splitting model ids that already\n * contain slashes (DeepInfra: `meta-llama/Llama-3.3-70B-Instruct-Turbo`,\n * `zai-org/GLM-5.1`). When the registry does not expose `get`, slash\n * parsing is disabled \u2014 callers without a configured registry behave as if\n * the entire token were a plain model id.\n *\n * Exported for test coverage; production callers go through\n * {@link createModelFactory}.\n */\nexport function parseSlashShorthand(\n token: string,\n registry: Pick<AiModelFactoryRegistry, 'get'>,\n): { providerHint: string | null; modelId: string } {\n const slashIndex = token.indexOf('/')\n if (slashIndex < 0) return { providerHint: null, modelId: token }\n const before = token.slice(0, slashIndex)\n const after = token.slice(slashIndex + 1)\n if (!before || !after) return { providerHint: null, modelId: token }\n if (!registry.get) return { providerHint: null, modelId: token }\n const provider = registry.get(before)\n if (!provider) return { providerHint: null, modelId: token }\n return { providerHint: before, modelId: after }\n}\n\n/**\n * Resolves the effective `allowRuntimeOverride` flag from an input that may\n * carry either the new canonical name (`allowRuntimeOverride`) or the\n * deprecated alias (`allowRuntimeModelOverride`). The canonical name wins\n * when both are present. Returns `true` (permissive) when neither is set.\n *\n * Exported for test coverage.\n */\nexport function resolveAllowRuntimeOverride(input: {\n allowRuntimeOverride?: boolean\n allowRuntimeModelOverride?: boolean\n}): boolean {\n if (input.allowRuntimeOverride !== undefined) return input.allowRuntimeOverride !== false\n if (input.allowRuntimeModelOverride !== undefined) return input.allowRuntimeModelOverride !== false\n return true\n}\n\n/**\n * Creates an {@link AiModelFactory} bound to the DI container. The container\n * reference is accepted for API symmetry with other runtime helpers (and so\n * future work can read provider overrides registered on the container); the\n * current implementation only needs the registry + env. No breaking change\n * when later implementations DO consult the container.\n */\nexport function createModelFactory(\n _container: AwilixContainer,\n deps: CreateModelFactoryDependencies = {},\n): AiModelFactory {\n const registry: AiModelFactoryRegistry = deps.registry ?? llmProviderRegistry\n const env = deps.env ?? process.env\n\n return {\n resolveModel(input: AiModelFactoryInput): AiModelResolution {\n const hasModule = typeof input.moduleId === 'string' && input.moduleId.length > 0\n // When allowRuntimeOverride (or its deprecated alias allowRuntimeModelOverride)\n // is explicitly false, skip steps 1 (requestOverride) and 3 (tenantOverride).\n const runtimeOverridesAllowed = resolveAllowRuntimeOverride(input)\n\n // --- Step 1: requestOverride (HTTP query params) \u2014 gated by flag ---\n const requestModelRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.requestOverride?.modelId ?? undefined)\n : null\n const requestProviderRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.requestOverride?.providerId ?? undefined)\n : null\n const requestBaseUrlRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.requestOverride?.baseURL ?? undefined)\n : null\n\n // --- Step 2: callerOverride (programmatic) ---\n const callerRaw = normalizeOverride(input.callerOverride)\n\n // --- Step 3: tenantOverride (DB row) \u2014 gated by flag ---\n const tenantModelRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.tenantOverride?.modelId ?? undefined)\n : null\n const tenantProviderRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.tenantOverride?.providerId ?? undefined)\n : null\n const tenantBaseUrlRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.tenantOverride?.baseURL ?? undefined)\n : null\n\n // --- Steps 4+: env / agent / global ---\n const moduleModelRaw = hasModule\n ? readModuleModelEnvOverride(env, input.moduleId!)\n : null\n const agentModelRaw = normalizeOverride(input.agentDefaultModel)\n // OM_AI_MODEL is canonical; the legacy OPENCODE_MODEL is read as a\n // backward-compatibility fallback through readGlobalModelFromEnv.\n const globalModelRaw = readGlobalModelFromEnv(env)\n\n // Parse slash shorthand on every model-axis source.\n const requestModelParsed = requestModelRaw ? parseSlashShorthand(requestModelRaw, registry) : null\n const callerParsed = callerRaw ? parseSlashShorthand(callerRaw, registry) : null\n const tenantModelParsed = tenantModelRaw ? parseSlashShorthand(tenantModelRaw, registry) : null\n const moduleModelParsed = moduleModelRaw ? parseSlashShorthand(moduleModelRaw, registry) : null\n const agentModelParsed = agentModelRaw ? parseSlashShorthand(agentModelRaw, registry) : null\n const globalModelParsed = globalModelRaw ? parseSlashShorthand(globalModelRaw, registry) : null\n\n const providerOverrideRaw = normalizeOverride(input.providerOverride)\n const moduleProviderRaw = hasModule\n ? readModuleProviderEnvOverride(env, input.moduleId!)\n : null\n const agentDefaultProviderRaw = normalizeOverride(input.agentDefaultProvider)\n // OM_AI_PROVIDER is canonical; the legacy OPENCODE_PROVIDER is read as\n // a backward-compatibility fallback through readGlobalProviderFromEnv.\n const globalProviderRaw = readGlobalProviderFromEnv(env, registry)\n\n const requestProviderHint = normalizeProviderHint(requestProviderRaw, registry)\n const providerOverrideHint = normalizeProviderHint(providerOverrideRaw, registry)\n const tenantProviderHint = normalizeProviderHint(tenantProviderRaw, registry)\n const moduleProviderHint = normalizeProviderHint(moduleProviderRaw, registry)\n const agentDefaultProviderHint = normalizeProviderHint(agentDefaultProviderRaw, registry)\n\n // Walk the provider-axis seed list: slash hint beats plain provider at\n // the same step. We keep only the first (highest-priority) non-null hint.\n const providerHintCandidates: Array<string | null> = [\n requestModelParsed?.providerHint ?? null,\n requestProviderHint,\n callerParsed?.providerHint ?? null,\n providerOverrideHint,\n tenantModelParsed?.providerHint ?? null,\n tenantProviderHint,\n moduleModelParsed?.providerHint ?? null,\n moduleProviderHint,\n agentModelParsed?.providerHint ?? null,\n agentDefaultProviderHint,\n globalModelParsed?.providerHint ?? null,\n globalProviderRaw,\n ]\n const orderHint = providerHintCandidates.find((hint) => hint !== null) ?? null\n const order = orderHint ? [orderHint] : undefined\n\n const pairPlainProviderIfWinning = (providerHint: string | null): string | null =>\n providerHint && providerHint === orderHint ? providerHint : null\n\n let modelId: string\n let source: AiModelResolution['source']\n let pairedProviderHint: string | null = null\n if (requestModelParsed) {\n modelId = requestModelParsed.modelId\n source = 'request_override'\n pairedProviderHint = requestModelParsed.providerHint ?? pairPlainProviderIfWinning(requestProviderHint)\n } else if (callerParsed) {\n modelId = callerParsed.modelId\n source = 'caller_override'\n pairedProviderHint = callerParsed.providerHint ?? pairPlainProviderIfWinning(providerOverrideHint)\n } else if (tenantModelParsed) {\n modelId = tenantModelParsed.modelId\n source = 'tenant_override'\n pairedProviderHint = tenantModelParsed.providerHint ?? pairPlainProviderIfWinning(tenantProviderHint)\n } else if (moduleModelParsed) {\n modelId = moduleModelParsed.modelId\n source = 'module_env'\n pairedProviderHint = moduleModelParsed.providerHint ?? pairPlainProviderIfWinning(moduleProviderHint)\n } else if (agentModelParsed) {\n modelId = agentModelParsed.modelId\n source = 'agent_default'\n pairedProviderHint = agentModelParsed.providerHint ?? pairPlainProviderIfWinning(agentDefaultProviderHint)\n } else if (globalModelParsed) {\n modelId = globalModelParsed.modelId\n source = 'env_default'\n pairedProviderHint = globalModelParsed.providerHint ?? pairPlainProviderIfWinning(globalProviderRaw)\n } else {\n modelId = ''\n source = 'provider_default'\n }\n\n // --- Provider-axis: walk from highest to lowest priority for the seed.\n // A slash-qualified hint from a model source wins over a plain provider\n // source at the same priority step. We walk top-down and take the first\n // non-null hint.\n const provider = pairedProviderHint\n ? resolveRequiredProvider(pairedProviderHint, registry, env)\n : registry.resolveFirstConfigured({ env, order })\n if (!provider) {\n if (pairedProviderHint) {\n throw new AiModelFactoryError(\n 'no_provider_configured',\n requiredProviderMessage(pairedProviderHint, registry, env),\n )\n }\n throw new AiModelFactoryError(\n 'no_provider_configured',\n 'No LLM provider is configured. Set OM_AI_PROVIDER (or the legacy OPENCODE_PROVIDER) plus a matching API key such as OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_GENERATIVE_AI_API_KEY, then restart the app. See https://docs.openmercato.com/framework/ai-assistant/overview.',\n )\n }\n const apiKey = provider.resolveApiKey(env)\n if (!apiKey) {\n throw new AiModelFactoryError(\n 'api_key_missing',\n `LLM provider \"${provider.id}\" is advertised as configured but resolveApiKey() returned empty.`,\n )\n }\n\n // --- Model-axis: use the post-parse model id from the winning source.\n if (source === 'provider_default') {\n modelId = provider.defaultModel\n }\n\n // --- BaseURL-axis resolution (highest to lowest priority) ---\n // 1. requestOverride.baseURL (HTTP dispatcher) \u2014 gated by allowRuntimeOverride\n // 2. baseUrlOverride (programmatic caller)\n // 3. tenantOverride.baseURL (DB row) \u2014 gated by allowRuntimeOverride\n // 4. <MODULE>_AI_BASE_URL env\n // 5. agentDefaultBaseUrl\n // Steps 6-7 (preset env + preset default) are handled inside the adapter's\n // createModel when no explicit baseURL is passed.\n const resolvedBaseURL = requestBaseUrlRaw\n ?? normalizeOverride(input.baseUrlOverride)\n ?? tenantBaseUrlRaw\n ?? (hasModule ? normalizeOverride(env[moduleBaseUrlEnvVarName(input.moduleId!)]) : null)\n ?? normalizeOverride(input.agentDefaultBaseUrl)\n ?? undefined\n\n // --- Allowlist enforcement (Phase 1780-5 + 1780-6) -------------------\n // OM_AI_AVAILABLE_PROVIDERS / OM_AI_AVAILABLE_MODELS_<PROVIDER> clip\n // the resolution to an operator-approved set. The optional tenant\n // allowlist snapshot narrows the env outer constraint further. If the\n // resolved pair isn't allowed, fall back to a safe (provider, model)\n // \u2014 never throw, so a stale tenant override or chat picker can't take\n // the runtime down. The fallback is logged so the operator can see\n // what happened.\n const registryProviderIds = registry.list?.()?.map((p) => p.id) ?? []\n const tenantProviderIds = input.tenantAllowlist\n ? Object.keys(input.tenantAllowlist.allowedModelsByProvider ?? {})\n : []\n const knownProviderIds = Array.from(\n new Set([provider.id, ...registryProviderIds, ...tenantProviderIds]),\n )\n const effectiveAllowlist = intersectAllowlists(\n env,\n knownProviderIds,\n input.tenantAllowlist ?? null,\n )\n const allowlistResult = enforceAllowlist({\n env,\n registry,\n resolved: { provider, modelId },\n agentDefaultProvider: agentDefaultProviderRaw,\n agentDefaultModel: agentModelParsed?.modelId ?? agentModelRaw,\n effective: effectiveAllowlist,\n })\n\n const finalProvider = allowlistResult.provider\n const finalModelId = allowlistResult.modelId\n const finalSource = allowlistResult.fallback ? 'allowlist_fallback' : source\n const finalApiKey = allowlistResult.fallback\n ? finalProvider.resolveApiKey(env)\n : apiKey\n if (!finalApiKey) {\n throw new AiModelFactoryError(\n 'api_key_missing',\n `LLM provider \"${finalProvider.id}\" is advertised as configured but resolveApiKey() returned empty.`,\n )\n }\n\n const model = finalProvider.createModel({\n modelId: finalModelId,\n apiKey: finalApiKey,\n baseURL: resolvedBaseURL,\n })\n return {\n model,\n modelId: finalModelId,\n providerId: finalProvider.id,\n source: finalSource,\n ...(resolvedBaseURL !== undefined ? { baseURL: resolvedBaseURL } : {}),\n ...(allowlistResult.fallback\n ? {\n allowlistFallback: {\n originalProviderId: provider.id,\n originalModelId: modelId,\n reason: allowlistResult.fallback,\n },\n }\n : {}),\n }\n },\n }\n}\n\ninterface EnforceAllowlistInput {\n env: EnvLookup\n registry: AiModelFactoryRegistry\n resolved: { provider: LlmProvider; modelId: string }\n agentDefaultProvider: string | null\n agentDefaultModel: string | null\n effective: EffectiveAllowlist\n}\n\ninterface EnforceAllowlistResult {\n provider: LlmProvider\n modelId: string\n /** Populated only when the resolved pair was rejected. */\n fallback: string | null\n}\n\n/**\n * Clips a resolved `(provider, model)` to what the effective allowlist\n * permits (env intersected with optional tenant allowlist).\n *\n * Order of fallback when the resolved provider is not allowed:\n * 1. The agent's `defaultProvider` (if allowed and configured).\n * 2. The first allowed provider that is also configured in the registry.\n *\n * Order of fallback when the model is not allowed for the resolved provider:\n * 1. The agent's `defaultModel` (if allowed for that provider).\n * 2. The provider's `defaultModel` (if allowed).\n * 3. The first model from the effective allowlist for that provider.\n *\n * Both fall-back paths emit a `console.warn` so the operator can see why the\n * runtime did not honor the requested combination. The function never throws.\n */\nfunction enforceAllowlist(input: EnforceAllowlistInput): EnforceAllowlistResult {\n const { registry, resolved, agentDefaultProvider, agentDefaultModel, effective } = input\n let provider = resolved.provider\n let modelId = resolved.modelId\n let fallback: string | null = null\n\n if (effective.providers !== null && !isProviderAllowedInEffective(effective, provider.id)) {\n const replacement = pickAllowedProvider({\n registry,\n agentDefaultProvider,\n effective,\n })\n if (replacement) {\n const source = effective.tenantOverridesActive\n ? 'the effective allowlist (env \u2229 tenant)'\n : 'OM_AI_AVAILABLE_PROVIDERS'\n fallback = `Provider \"${provider.id}\" is not in ${source}; using \"${replacement.id}\" instead.`\n console.warn(`[AI Model Factory] ${fallback}`)\n provider = replacement\n modelId = pickAllowedModel({\n provider,\n preferred: agentDefaultModel,\n effective,\n })\n }\n // If no replacement is configured we keep the resolved provider \u2014 the\n // throw at the api-key gate will surface the misconfiguration to the\n // operator instead of silently masking it.\n }\n\n if (!isModelAllowedForProviderInEffective(effective, provider.id, modelId)) {\n const replacementModel = pickAllowedModel({\n provider,\n preferred: agentDefaultModel,\n effective,\n })\n if (replacementModel !== modelId) {\n const source = effective.tenantOverridesActive\n ? `the effective allowlist (env \u2229 tenant) for \"${provider.id}\"`\n : `OM_AI_AVAILABLE_MODELS_${provider.id.toUpperCase()}`\n const reason = `Model \"${modelId}\" is not in ${source}; using \"${replacementModel}\" instead.`\n console.warn(`[AI Model Factory] ${reason}`)\n fallback = fallback ? `${fallback} ${reason}` : reason\n modelId = replacementModel\n }\n }\n\n return { provider, modelId, fallback }\n}\n\nfunction pickAllowedProvider(input: {\n registry: AiModelFactoryRegistry\n agentDefaultProvider: string | null\n effective: EffectiveAllowlist\n}): LlmProvider | null {\n const { registry, agentDefaultProvider, effective } = input\n if (agentDefaultProvider) {\n if (isProviderAllowedInEffective(effective, agentDefaultProvider)) {\n const provider = registry.get?.(agentDefaultProvider)\n if (provider && provider.isConfigured(process.env as EnvLookup)) return provider\n }\n }\n const allowed = effective.providers\n if (!allowed) return null\n for (const id of allowed) {\n const provider = registry.get?.(id)\n if (provider && provider.isConfigured(process.env as EnvLookup)) return provider\n }\n return null\n}\n\nfunction pickAllowedModel(input: {\n provider: LlmProvider\n preferred: string | null\n effective: EffectiveAllowlist\n}): string {\n const { provider, preferred, effective } = input\n const allowed = effective.modelsByProvider[provider.id]\n if (allowed === undefined) {\n return preferred && preferred.length > 0 ? preferred : provider.defaultModel\n }\n if (preferred && allowed.includes(preferred)) return preferred\n if (allowed.includes(provider.defaultModel)) return provider.defaultModel\n return allowed[0] ?? provider.defaultModel\n}\n"],
5
- "mappings": "AAiEA,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAyNA,MAAM,4BAA4B,MAAM;AAAA,EAG7C,YAAY,MAA+B,SAAiB;AAC1D,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;AA4CA,SAAS,kBAAkB,OAA0C;AACnE,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;AAQA,SAAS,0BACP,KACA,UACe;AACf,QAAM,aAAa,CAAC,kBAAkB,IAAI,cAAc,GAAG,kBAAkB,IAAI,iBAAiB,CAAC;AACnG,aAAW,aAAa,YAAY;AAClC,QAAI,CAAC,UAAW;AAChB,QAAI,CAAC,SAAS,IAAK,QAAO,kBAAkB,SAAS,EAAE,CAAC,KAAK;AAC7D,eAAW,SAAS,kBAAkB,SAAS,GAAG;AAChD,UAAI,SAAS,IAAI,KAAK,EAAG,QAAO;AAAA,IAClC;AAAA,EACF;AACA,SAAO;AACT;AAMA,SAAS,uBAAuB,KAA+B;AAC7D,SAAO,kBAAkB,IAAI,WAAW,KAAK,kBAAkB,IAAI,cAAc;AACnF;AAGA,SAAS,sBAAsB,UAA0B;AACvD,SAAO,SAAS,SAAS,YAAY,CAAC;AACxC;AAMA,SAAS,4BAA4B,UAA0B;AAC7D,SAAO,GAAG,SAAS,YAAY,CAAC;AAClC;AAEA,SAAS,2BAA2B,KAAgB,UAAiC;AACnF,SACE,kBAAkB,IAAI,sBAAsB,QAAQ,CAAC,CAAC,KACtD,kBAAkB,IAAI,4BAA4B,QAAQ,CAAC,CAAC;AAEhE;AAGA,SAAS,yBAAyB,UAA0B;AAC1D,SAAO,SAAS,SAAS,YAAY,CAAC;AACxC;AAMA,SAAS,+BAA+B,UAA0B;AAChE,SAAO,GAAG,SAAS,YAAY,CAAC;AAClC;AAEA,SAAS,8BAA8B,KAAgB,UAAiC;AACtF,SACE,kBAAkB,IAAI,yBAAyB,QAAQ,CAAC,CAAC,KACzD,kBAAkB,IAAI,+BAA+B,QAAQ,CAAC,CAAC;AAEnE;AAEA,SAAS,sBACP,YACA,UACe;AACf,MAAI,CAAC,WAAY,QAAO;AACxB,QAAM,mBAAmB,SAAS,OAAO,EAAE,IAAI,CAAC,aAAa,SAAS,EAAE,KAAK,CAAC;AAC9E,MAAI,iBAAiB,SAAS,GAAG;AAC/B,WAAO,oBAAoB,YAAY,gBAAgB;AAAA,EACzD;AACA,SAAO,kBAAkB,UAAU,EAAE,CAAC,KAAK;AAC7C;AAEA,SAAS,wBACP,YACA,UACA,KACoB;AACpB,QAAM,WAAW,SAAS,uBAAuB,EAAE,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;AAC7E,MAAI,UAAU,OAAO,WAAY,QAAO;AAExC,QAAM,SAAS,SAAS,MAAM,UAAU,KAAK;AAC7C,MAAI,OAAQ,QAAO,OAAO,aAAa,GAAG,IAAI,SAAS;AACvD,SAAO;AACT;AAEA,SAAS,wBAAwB,YAAoB,UAAkC,KAAwB;AAC7G,QAAM,WAAW,SAAS,MAAM,UAAU,KAAK;AAC/C,QAAM,SAAS,UAAU,sBAAsB,GAAG;AAClD,QAAM,iBAAiB,SACnB,QAAQ,MAAM,2BACd;AACJ,SAAO,6CAA6C,UAAU,0CAA0C,cAAc;AACxH;AAEA,SAAS,wBAAwB,UAA0B;AACzD,SAAO,GAAG,SAAS,YAAY,CAAC;AAClC;AAgBO,SAAS,oBACd,OACA,UACkD;AAClD,QAAM,aAAa,MAAM,QAAQ,GAAG;AACpC,MAAI,aAAa,EAAG,QAAO,EAAE,cAAc,MAAM,SAAS,MAAM;AAChE,QAAM,SAAS,MAAM,MAAM,GAAG,UAAU;AACxC,QAAM,QAAQ,MAAM,MAAM,aAAa,CAAC;AACxC,MAAI,CAAC,UAAU,CAAC,MAAO,QAAO,EAAE,cAAc,MAAM,SAAS,MAAM;AACnE,MAAI,CAAC,SAAS,IAAK,QAAO,EAAE,cAAc,MAAM,SAAS,MAAM;AAC/D,QAAM,WAAW,SAAS,IAAI,MAAM;AACpC,MAAI,CAAC,SAAU,QAAO,EAAE,cAAc,MAAM,SAAS,MAAM;AAC3D,SAAO,EAAE,cAAc,QAAQ,SAAS,MAAM;AAChD;AAUO,SAAS,4BAA4B,OAGhC;AACV,MAAI,MAAM,yBAAyB,OAAW,QAAO,MAAM,yBAAyB;AACpF,MAAI,MAAM,8BAA8B,OAAW,QAAO,MAAM,8BAA8B;AAC9F,SAAO;AACT;AASO,SAAS,mBACd,YACA,OAAuC,CAAC,GACxB;AAChB,QAAM,WAAmC,KAAK,YAAY;AAC1D,QAAM,MAAM,KAAK,OAAO,QAAQ;AAEhC,SAAO;AAAA,IACL,aAAa,OAA+C;AAC1D,YAAM,YAAY,OAAO,MAAM,aAAa,YAAY,MAAM,SAAS,SAAS;AAGhF,YAAM,0BAA0B,4BAA4B,KAAK;AAGjE,YAAM,kBAAkB,0BACpB,kBAAkB,MAAM,iBAAiB,WAAW,MAAS,IAC7D;AACJ,YAAM,qBAAqB,0BACvB,kBAAkB,MAAM,iBAAiB,cAAc,MAAS,IAChE;AACJ,YAAM,oBAAoB,0BACtB,kBAAkB,MAAM,iBAAiB,WAAW,MAAS,IAC7D;AAGJ,YAAM,YAAY,kBAAkB,MAAM,cAAc;AAGxD,YAAM,iBAAiB,0BACnB,kBAAkB,MAAM,gBAAgB,WAAW,MAAS,IAC5D;AACJ,YAAM,oBAAoB,0BACtB,kBAAkB,MAAM,gBAAgB,cAAc,MAAS,IAC/D;AACJ,YAAM,mBAAmB,0BACrB,kBAAkB,MAAM,gBAAgB,WAAW,MAAS,IAC5D;AAGJ,YAAM,iBAAiB,YACnB,2BAA2B,KAAK,MAAM,QAAS,IAC/C;AACJ,YAAM,gBAAgB,kBAAkB,MAAM,iBAAiB;AAG/D,YAAM,iBAAiB,uBAAuB,GAAG;AAGjD,YAAM,qBAAqB,kBAAkB,oBAAoB,iBAAiB,QAAQ,IAAI;AAC9F,YAAM,eAAe,YAAY,oBAAoB,WAAW,QAAQ,IAAI;AAC5E,YAAM,oBAAoB,iBAAiB,oBAAoB,gBAAgB,QAAQ,IAAI;AAC3F,YAAM,oBAAoB,iBAAiB,oBAAoB,gBAAgB,QAAQ,IAAI;AAC3F,YAAM,mBAAmB,gBAAgB,oBAAoB,eAAe,QAAQ,IAAI;AACxF,YAAM,oBAAoB,iBAAiB,oBAAoB,gBAAgB,QAAQ,IAAI;AAE3F,YAAM,sBAAsB,kBAAkB,MAAM,gBAAgB;AACpE,YAAM,oBAAoB,YACtB,8BAA8B,KAAK,MAAM,QAAS,IAClD;AACJ,YAAM,0BAA0B,kBAAkB,MAAM,oBAAoB;AAG5E,YAAM,oBAAoB,0BAA0B,KAAK,QAAQ;AAEjE,YAAM,sBAAsB,sBAAsB,oBAAoB,QAAQ;AAC9E,YAAM,uBAAuB,sBAAsB,qBAAqB,QAAQ;AAChF,YAAM,qBAAqB,sBAAsB,mBAAmB,QAAQ;AAC5E,YAAM,qBAAqB,sBAAsB,mBAAmB,QAAQ;AAC5E,YAAM,2BAA2B,sBAAsB,yBAAyB,QAAQ;AAIxF,YAAM,yBAA+C;AAAA,QACnD,oBAAoB,gBAAgB;AAAA,QACpC;AAAA,QACA,cAAc,gBAAgB;AAAA,QAC9B;AAAA,QACA,mBAAmB,gBAAgB;AAAA,QACnC;AAAA,QACA,mBAAmB,gBAAgB;AAAA,QACnC;AAAA,QACA,kBAAkB,gBAAgB;AAAA,QAClC;AAAA,QACA,mBAAmB,gBAAgB;AAAA,QACnC;AAAA,MACF;AACA,YAAM,YAAY,uBAAuB,KAAK,CAAC,SAAS,SAAS,IAAI,KAAK;AAC1E,YAAM,QAAQ,YAAY,CAAC,SAAS,IAAI;AAExC,YAAM,6BAA6B,CAAC,iBAClC,gBAAgB,iBAAiB,YAAY,eAAe;AAE9D,UAAI;AACJ,UAAI;AACJ,UAAI,qBAAoC;AACxC,UAAI,oBAAoB;AACtB,kBAAU,mBAAmB;AAC7B,iBAAS;AACT,6BAAqB,mBAAmB,gBAAgB,2BAA2B,mBAAmB;AAAA,MACxG,WAAW,cAAc;AACvB,kBAAU,aAAa;AACvB,iBAAS;AACT,6BAAqB,aAAa,gBAAgB,2BAA2B,oBAAoB;AAAA,MACnG,WAAW,mBAAmB;AAC5B,kBAAU,kBAAkB;AAC5B,iBAAS;AACT,6BAAqB,kBAAkB,gBAAgB,2BAA2B,kBAAkB;AAAA,MACtG,WAAW,mBAAmB;AAC5B,kBAAU,kBAAkB;AAC5B,iBAAS;AACT,6BAAqB,kBAAkB,gBAAgB,2BAA2B,kBAAkB;AAAA,MACtG,WAAW,kBAAkB;AAC3B,kBAAU,iBAAiB;AAC3B,iBAAS;AACT,6BAAqB,iBAAiB,gBAAgB,2BAA2B,wBAAwB;AAAA,MAC3G,WAAW,mBAAmB;AAC5B,kBAAU,kBAAkB;AAC5B,iBAAS;AACT,6BAAqB,kBAAkB,gBAAgB,2BAA2B,iBAAiB;AAAA,MACrG,OAAO;AACL,kBAAU;AACV,iBAAS;AAAA,MACX;AAMA,YAAM,WAAW,qBACb,wBAAwB,oBAAoB,UAAU,GAAG,IACzD,SAAS,uBAAuB,EAAE,KAAK,MAAM,CAAC;AAClD,UAAI,CAAC,UAAU;AACb,YAAI,oBAAoB;AACtB,gBAAM,IAAI;AAAA,YACR;AAAA,YACA,wBAAwB,oBAAoB,UAAU,GAAG;AAAA,UAC3D;AAAA,QACF;AACA,cAAM,IAAI;AAAA,UACR;AAAA,UACA;AAAA,QACF;AAAA,MACF;AACA,YAAM,SAAS,SAAS,cAAc,GAAG;AACzC,UAAI,CAAC,QAAQ;AACX,cAAM,IAAI;AAAA,UACR;AAAA,UACA,iBAAiB,SAAS,EAAE;AAAA,QAC9B;AAAA,MACF;AAGA,UAAI,WAAW,oBAAoB;AACjC,kBAAU,SAAS;AAAA,MACrB;AAUA,YAAM,kBAAkB,qBACnB,kBAAkB,MAAM,eAAe,KACvC,qBACC,YAAY,kBAAkB,IAAI,wBAAwB,MAAM,QAAS,CAAC,CAAC,IAAI,SAChF,kBAAkB,MAAM,mBAAmB,KAC3C;AAUL,YAAM,sBAAsB,SAAS,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC;AACpE,YAAM,oBAAoB,MAAM,kBAC5B,OAAO,KAAK,MAAM,gBAAgB,2BAA2B,CAAC,CAAC,IAC/D,CAAC;AACL,YAAM,mBAAmB,MAAM;AAAA,QAC7B,oBAAI,IAAI,CAAC,SAAS,IAAI,GAAG,qBAAqB,GAAG,iBAAiB,CAAC;AAAA,MACrE;AACA,YAAM,qBAAqB;AAAA,QACzB;AAAA,QACA;AAAA,QACA,MAAM,mBAAmB;AAAA,MAC3B;AACA,YAAM,kBAAkB,iBAAiB;AAAA,QACvC;AAAA,QACA;AAAA,QACA,UAAU,EAAE,UAAU,QAAQ;AAAA,QAC9B,sBAAsB;AAAA,QACtB,mBAAmB,kBAAkB,WAAW;AAAA,QAChD,WAAW;AAAA,MACb,CAAC;AAED,YAAM,gBAAgB,gBAAgB;AACtC,YAAM,eAAe,gBAAgB;AACrC,YAAM,cAAc,gBAAgB,WAAW,uBAAuB;AACtE,YAAM,cAAc,gBAAgB,WAChC,cAAc,cAAc,GAAG,IAC/B;AACJ,UAAI,CAAC,aAAa;AAChB,cAAM,IAAI;AAAA,UACR;AAAA,UACA,iBAAiB,cAAc,EAAE;AAAA,QACnC;AAAA,MACF;AAEA,YAAM,QAAQ,cAAc,YAAY;AAAA,QACtC,SAAS;AAAA,QACT,QAAQ;AAAA,QACR,SAAS;AAAA,MACX,CAAC;AACD,aAAO;AAAA,QACL;AAAA,QACA,SAAS;AAAA,QACT,YAAY,cAAc;AAAA,QAC1B,QAAQ;AAAA,QACR,GAAI,oBAAoB,SAAY,EAAE,SAAS,gBAAgB,IAAI,CAAC;AAAA,QACpE,GAAI,gBAAgB,WAChB;AAAA,UACE,mBAAmB;AAAA,YACjB,oBAAoB,SAAS;AAAA,YAC7B,iBAAiB;AAAA,YACjB,QAAQ,gBAAgB;AAAA,UAC1B;AAAA,QACF,IACA,CAAC;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACF;AAkCA,SAAS,iBAAiB,OAAsD;AAC9E,QAAM,EAAE,UAAU,UAAU,sBAAsB,mBAAmB,UAAU,IAAI;AACnF,MAAI,WAAW,SAAS;AACxB,MAAI,UAAU,SAAS;AACvB,MAAI,WAA0B;AAE9B,MAAI,UAAU,cAAc,QAAQ,CAAC,6BAA6B,WAAW,SAAS,EAAE,GAAG;AACzF,UAAM,cAAc,oBAAoB;AAAA,MACtC;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AACD,QAAI,aAAa;AACf,YAAM,SAAS,UAAU,wBACrB,gDACA;AACJ,iBAAW,aAAa,SAAS,EAAE,eAAe,MAAM,YAAY,YAAY,EAAE;AAClF,cAAQ,KAAK,sBAAsB,QAAQ,EAAE;AAC7C,iBAAW;AACX,gBAAU,iBAAiB;AAAA,QACzB;AAAA,QACA,WAAW;AAAA,QACX;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EAIF;AAEA,MAAI,CAAC,qCAAqC,WAAW,SAAS,IAAI,OAAO,GAAG;AAC1E,UAAM,mBAAmB,iBAAiB;AAAA,MACxC;AAAA,MACA,WAAW;AAAA,MACX;AAAA,IACF,CAAC;AACD,QAAI,qBAAqB,SAAS;AAChC,YAAM,SAAS,UAAU,wBACrB,oDAA+C,SAAS,EAAE,MAC1D,0BAA0B,SAAS,GAAG,YAAY,CAAC;AACvD,YAAM,SAAS,UAAU,OAAO,eAAe,MAAM,YAAY,gBAAgB;AACjF,cAAQ,KAAK,sBAAsB,MAAM,EAAE;AAC3C,iBAAW,WAAW,GAAG,QAAQ,IAAI,MAAM,KAAK;AAChD,gBAAU;AAAA,IACZ;AAAA,EACF;AAEA,SAAO,EAAE,UAAU,SAAS,SAAS;AACvC;AAEA,SAAS,oBAAoB,OAIN;AACrB,QAAM,EAAE,UAAU,sBAAsB,UAAU,IAAI;AACtD,MAAI,sBAAsB;AACxB,QAAI,6BAA6B,WAAW,oBAAoB,GAAG;AACjE,YAAM,WAAW,SAAS,MAAM,oBAAoB;AACpD,UAAI,YAAY,SAAS,aAAa,QAAQ,GAAgB,EAAG,QAAO;AAAA,IAC1E;AAAA,EACF;AACA,QAAM,UAAU,UAAU;AAC1B,MAAI,CAAC,QAAS,QAAO;AACrB,aAAW,MAAM,SAAS;AACxB,UAAM,WAAW,SAAS,MAAM,EAAE;AAClC,QAAI,YAAY,SAAS,aAAa,QAAQ,GAAgB,EAAG,QAAO;AAAA,EAC1E;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,OAIf;AACT,QAAM,EAAE,UAAU,WAAW,UAAU,IAAI;AAC3C,QAAM,UAAU,UAAU,iBAAiB,SAAS,EAAE;AACtD,MAAI,YAAY,QAAW;AACzB,WAAO,aAAa,UAAU,SAAS,IAAI,YAAY,SAAS;AAAA,EAClE;AACA,MAAI,aAAa,QAAQ,SAAS,SAAS,EAAG,QAAO;AACrD,MAAI,QAAQ,SAAS,SAAS,YAAY,EAAG,QAAO,SAAS;AAC7D,SAAO,QAAQ,CAAC,KAAK,SAAS;AAChC;",
4
+ "sourcesContent": ["/**\n * Shared AI model factory.\n *\n * Consolidates the previously-per-module model-creation plumbing (inbox_ops's\n * `llmProvider.ts`, the agent-runtime's inline `resolveAgentModel`) behind a\n * single DI-friendly port. Every AI-runtime caller (chat, object, inbox-ops\n * extraction, future agents) resolves the `LanguageModelV1` it hands to the\n * Vercel AI SDK through `createModelFactory(container).resolveModel(...)` so\n * all of them share one resolution order:\n *\n * 1. `callerOverride` (non-empty string) \u2014 highest precedence, e.g. the\n * `modelOverride` field on `runAiAgentText`/`runAiAgentObject`.\n * Accepts a slash-qualified `<provider>/<model>` shorthand (Phase 1).\n * 2. Env variable `OM_AI_<MODULE>_MODEL` (uppercased `moduleId`) when\n * `moduleId` is provided. Example:\n * `OM_AI_INBOX_OPS_MODEL=claude-haiku-4-5`,\n * `OM_AI_CATALOG_MODEL=gpt-4o-mini`. The legacy\n * `<MODULE>_AI_MODEL` form (e.g. `INBOX_OPS_AI_MODEL`) is read as a\n * backward-compatibility fallback when the canonical name is unset.\n * Accepts a slash-qualified shorthand (Phase 1).\n * 3. `agentDefaultModel` \u2014 typically `AiAgentDefinition.defaultModel`.\n * Accepts a slash-qualified `<provider>/<model>` shorthand (Phase 1).\n * 4. Global env `OM_AI_MODEL` (canonical) with `OPENCODE_MODEL` kept as\n * a backward-compatibility fallback. Accepts either a plain model id\n * (`gpt-5-mini`) or a slash-qualified id (`openai/gpt-5-mini`).\n * Slash qualifiers consume the provider axis at the same step. When the\n * selected model source carries a provider hint, the provider/model pair\n * is atomic: an unconfigured hinted provider fails instead of sending\n * the model id to a different configured provider.\n * 5. The configured provider's own default model id\n * (`provider.defaultModel`).\n *\n * Every model-axis source is parsed through {@link parseSlashShorthand}.\n * Resolution walks the chain top-down and takes the first non-null hint as\n * the registry-walk seed. If the winning model source also supplies the\n * winning provider hint \u2014 either through `<provider>/<model>` or through the\n * same-source provider field/env var \u2014 that pair is resolved exactly and\n * never mixed with a fallback provider.\n *\n * Provider-axis seed order (highest priority first):\n * 1. Slash-prefix from `callerOverride` (Phase 1).\n * 2. `providerOverride` \u2014 request-time provider override (Phase 1).\n * 3. Slash-prefix from `OM_AI_<MODULE>_MODEL` (legacy `<MODULE>_AI_MODEL`) (Phase 1).\n * 4. `OM_AI_<MODULE>_PROVIDER` env (legacy `<MODULE>_AI_PROVIDER`) (Phase 1).\n * 5. Slash-prefix from `agentDefaultModel` (Phase 1).\n * 6. `agentDefaultProvider` \u2014 `AiAgentDefinition.defaultProvider` (Phase 1).\n * 7. Slash-prefix from `OM_AI_MODEL` (legacy `OPENCODE_MODEL`) (Phase 0).\n * 8. `OM_AI_PROVIDER` (legacy `OPENCODE_PROVIDER`) (Phase 0).\n *\n * The `OM_AI_*` env knobs are canonical; the legacy `OPENCODE_PROVIDER` /\n * `OPENCODE_MODEL` envs stay bound to the OpenCode Code Mode stack and are\n * also honored as backward-compatibility fallbacks here.\n *\n * The factory throws {@link AiModelFactoryError} when no provider is\n * configured \u2014 every current call site already expects the throw (see the\n * bare `throw new Error('No LLM provider is configured...')` in\n * `agent-runtime.ts` prior to the consolidation).\n *\n * @see packages/shared/src/lib/ai/llm-provider-registry.ts\n * @see packages/ai-assistant/src/modules/ai_assistant/lib/agent-runtime.ts\n * @see packages/core/src/modules/inbox_ops/lib/llmProvider.ts\n */\n\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport type { AwilixContainer } from 'awilix'\nimport type { EnvLookup, LlmProvider } from '@open-mercato/shared/lib/ai/llm-provider'\nimport { llmProviderRegistry } from '@open-mercato/shared/lib/ai/llm-provider-registry'\nimport {\n intersectAllowlists,\n canonicalProviderId,\n isModelAllowedForProviderInEffective,\n isProviderAllowedInEffective,\n providerIdAliases,\n type EffectiveAllowlist,\n type TenantAllowlistSnapshot,\n} from './model-allowlist'\n\nconst logger = createLogger('ai_assistant')\n\n/**\n * Minimal AI SDK LanguageModel shape \u2014 the factory exposes the protocol-\n * agnostic `unknown`-typed return from {@link LlmProvider.createModel} under a\n * dedicated alias so callers can document intent without importing the AI SDK\n * here. Call sites that hand the result to `generateText` / `streamText` /\n * `generateObject` / `streamObject` continue to cast to the SDK's\n * `LanguageModelV1` / `LanguageModel` union exactly as they already do.\n */\nexport type AiModelInstance = unknown\n\n/**\n * Input accepted by {@link AiModelFactory.resolveModel}. All fields are\n * optional \u2014 passing an empty input resolves the provider default.\n */\nexport interface AiModelFactoryInput {\n /**\n * Owning module id (matches `Module.id`). When set, the factory checks\n * `OM_AI_<MODULE>_MODEL` (uppercased) as the env-override source, with\n * the legacy `<MODULE>_AI_MODEL` form honored as a backward-compatibility\n * fallback. Example: `moduleId: 'inbox_ops'` \u2192 canonical env var\n * `OM_AI_INBOX_OPS_MODEL` (legacy `INBOX_OPS_AI_MODEL`).\n *\n * Also enables the `OM_AI_<MODULE>_PROVIDER` env axis (legacy\n * `<MODULE>_AI_PROVIDER` honored as a backward-compatibility fallback).\n */\n moduleId?: string\n /**\n * Agent-level default, typically `AiAgentDefinition.defaultModel`. Used\n * when neither `callerOverride` nor the module env override is present.\n * Accepts a slash-qualified `<provider>/<model>` shorthand (Phase 1).\n */\n agentDefaultModel?: string\n /**\n * Agent-level default provider, typically `AiAgentDefinition.defaultProvider`.\n * Named provider id. When paired with an agent default model, the pair is\n * resolved exactly and fails if the provider is unconfigured. When used as\n * a provider preference without an agent default model, it can fall through\n * to the next configured provider. Sits between `OM_AI_<MODULE>_PROVIDER`\n * and the global `OM_AI_PROVIDER` in the provider-axis seed list above.\n *\n * Phase 1 of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n agentDefaultProvider?: string\n /**\n * Per-call override (e.g. `runAiAgentText({ modelOverride })`). Wins over\n * every other source when it is a non-empty trimmed string. Empty strings\n * are treated as \"no override\" so the next source in the chain wins \u2014\n * callers MUST NOT need a separate \"clear override\" API.\n */\n callerOverride?: string\n /**\n * Request-time provider override \u2014 wins for the provider axis at the same\n * priority as `callerOverride` for the model axis. A non-empty string\n * that does not match any registered provider id is silently ignored and\n * the factory falls through to the next provider source.\n *\n * Phase 1 of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n providerOverride?: string\n /**\n * Agent-level default base URL, typically `AiAgentDefinition.defaultBaseUrl`.\n * Sits between the `<MODULE>_AI_BASE_URL` env var and the preset's own\n * `baseURLEnvKeys` in the resolution chain.\n *\n * Phase 2 of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n agentDefaultBaseUrl?: string\n /**\n * Per-call base URL override that wins over every other source. Intended\n * for programmatic callers only \u2014 the HTTP query-param baseUrl and the\n * AI_RUNTIME_BASEURL_ALLOWLIST arrive in Phase 4a.\n *\n * Phase 2 of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n baseUrlOverride?: string\n /**\n * Per-tenant default loaded from `ai_agent_runtime_overrides` by the agent\n * runtime (best-effort, fail-open). Sits at step 3 of the resolution chain\n * between the caller/request override (step 1\u20132) and the module-env axis\n * (step 4).\n *\n * Honored ONLY when `allowRuntimeOverride !== false` on the agent definition\n * (checked via `resolveAllowRuntimeOverride`). The agent runtime is\n * responsible for hydration \u2014 the factory does NOT load the row itself.\n *\n * Phase 4a of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n tenantOverride?: {\n providerId?: string | null\n modelId?: string | null\n baseURL?: string | null\n }\n /**\n * Per-request override forwarded from the HTTP dispatcher query params\n * (`?provider=`, `?model=`, `?baseUrl=`). Sits at step 1 of the resolution\n * chain \u2014 wins over everything else for that turn.\n *\n * Honored ONLY when `allowRuntimeOverride !== false` on the agent (checked\n * via `resolveAllowRuntimeOverride`). The dispatcher validates all three\n * values before setting this input.\n *\n * Phase 4a of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n requestOverride?: {\n providerId?: string | null\n modelId?: string | null\n baseURL?: string | null\n }\n /**\n * When false, steps 1 (requestOverride) and 3 (tenantOverride) of the\n * resolution chain are skipped. Agents that pin a specific model for\n * correctness reasons set `AiAgentDefinition.allowRuntimeOverride = false`.\n * Default behavior (omitted) is permissive (= true).\n *\n * Canonical field (renamed from `allowRuntimeModelOverride` in Phase 4 of\n * spec `2026-04-28-ai-agents-agentic-loop-controls`). The deprecated alias\n * `allowRuntimeModelOverride` is still accepted via the resolution helper\n * {@link resolveAllowRuntimeOverride}.\n *\n * Phase 4a of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n allowRuntimeOverride?: boolean\n /**\n * @deprecated Use `allowRuntimeOverride` instead.\n *\n * Phase 4a of spec `2026-04-27-ai-agents-provider-model-baseurl-overrides`.\n */\n allowRuntimeModelOverride?: boolean\n /**\n * Optional tenant allowlist snapshot (Phase 1780-6). When supplied, the\n * factory clips the resolved (provider, model) to the intersection of the\n * env allowlist (`OM_AI_AVAILABLE_*`) and this tenant allowlist. Pass `null`\n * or omit to fall back to env-only enforcement.\n *\n * The settings PUT route validates writes against the env allowlist before\n * persisting, so the snapshot here is trusted to be a subset of env. The\n * factory still defends against drift (env tightened after write) by\n * intersecting at resolution time.\n */\n tenantAllowlist?: TenantAllowlistSnapshot | null\n}\n\n/**\n * Materialized output returned by {@link AiModelFactory.resolveModel}.\n */\nexport interface AiModelResolution {\n /**\n * Concrete AI SDK model instance ready to pass to\n * `generateText`/`streamText`/`generateObject`/`streamObject`. Typed as\n * {@link AiModelInstance} to avoid coupling this port to a specific SDK\n * major version.\n */\n model: AiModelInstance\n /** Resolved upstream model id (e.g. `claude-haiku-4-5-20251001`). */\n modelId: string\n /** Stable provider id from {@link LlmProvider.id}. */\n providerId: string\n /**\n * Which source won resolution. Useful for logs and tests; never exposed\n * as a public contract beyond these enum values.\n *\n * - `env_default` indicates `OM_AI_MODEL` (preferred) or the legacy\n * `OPENCODE_MODEL` fallback supplied the model id.\n */\n source:\n | 'request_override'\n | 'caller_override'\n | 'tenant_override'\n | 'module_env'\n | 'agent_default'\n | 'env_default'\n | 'provider_default'\n | 'allowlist_fallback'\n /**\n * Resolved base URL passed to the adapter (if any). Undefined when the\n * adapter will use its built-in default. Included for observability and\n * test assertions; never exposed over HTTP (Phase 4a adds the allowlist).\n */\n baseURL?: string\n /**\n * Populated when the env-driven OM_AI_AVAILABLE_PROVIDERS /\n * OM_AI_AVAILABLE_MODELS_<PROVIDER> allowlist rejected the originally\n * resolved (provider, model) and the factory fell back to a safe pair.\n * Includes the rejected ids and a human-readable reason so the UI / logs\n * can surface why the runtime did not honor the requested combination.\n */\n allowlistFallback?: {\n originalProviderId: string\n originalModelId: string\n reason: string\n }\n}\n\n/**\n * Port exposed by {@link createModelFactory}. Stateless \u2014 the factory\n * re-reads the registry + env on every `resolveModel` call so hot-reload\n * and test overrides work without needing factory re-creation.\n */\nexport interface AiModelFactory {\n resolveModel(input: AiModelFactoryInput): AiModelResolution\n}\n\n/**\n * Typed error thrown by the factory when it cannot materialize a model.\n *\n * `code` is a stable string union so downstream callers can branch without\n * parsing error messages. `AiModelFactoryError`s bubble through\n * `runAiAgentText`/`runAiAgentObject` unchanged \u2014 the agent runtime does\n * NOT catch them, matching the pre-consolidation behavior of the inline\n * resolver.\n */\nexport type AiModelFactoryErrorCode =\n | 'no_provider_configured'\n | 'api_key_missing'\n\nexport class AiModelFactoryError extends Error {\n readonly code: AiModelFactoryErrorCode\n\n constructor(code: AiModelFactoryErrorCode, message: string) {\n super(message)\n this.name = 'AiModelFactoryError'\n this.code = code\n }\n}\n\n/**\n * Subset of {@link import('@open-mercato/shared/lib/ai/llm-provider-registry').LlmProviderRegistry}\n * the factory consumes. Defined locally so test doubles only need to mock\n * the methods the factory actually calls.\n */\nexport interface AiModelFactoryRegistry {\n resolveFirstConfigured(options?: {\n env?: EnvLookup\n order?: readonly string[]\n }): LlmProvider | null\n /**\n * Optional registry lookup used by the slash-shorthand parser to validate\n * a provider hint. When absent, slash parsing is disabled and the entire\n * model token is treated as a model id (mirrors the pre-Phase-0\n * behavior).\n */\n get?(id: string): LlmProvider | null\n /**\n * Optional registry enumeration used by the Phase 1780-6 allowlist\n * intersection so the env model lists are pre-loaded for every provider\n * (and not just the resolved one). Test doubles MAY omit this \u2014 the\n * factory still defends correctly by also seeding the resolved provider's\n * id directly into `intersectAllowlists(...)`.\n */\n list?(): readonly LlmProvider[]\n}\n\n/**\n * Internal dependencies of the factory. Exposed for tests only; production\n * callers rely on the defaults wired by {@link createModelFactory}.\n */\nexport interface CreateModelFactoryDependencies {\n /**\n * Registry used to resolve the first configured provider. Defaults to the\n * singleton `llmProviderRegistry`. Implementations MAY honor the optional\n * `order` argument to prefer the operator-selected provider.\n */\n registry?: AiModelFactoryRegistry\n /** Env lookup for `OM_AI_<MODULE>_MODEL` + provider credentials. */\n env?: EnvLookup\n}\n\nfunction normalizeOverride(value: string | undefined): string | null {\n if (typeof value !== 'string') return null\n const trimmed = value.trim()\n return trimmed.length > 0 ? trimmed : null\n}\n\n/**\n * Reads the operator-selected provider id from the unified env vars.\n * Returns `null` when neither `OM_AI_PROVIDER` nor the legacy\n * `OPENCODE_PROVIDER` resolves to a known provider \u2014 in that case the\n * registry falls back to its default registration walk.\n */\nfunction readGlobalProviderFromEnv(\n env: EnvLookup,\n registry: Pick<AiModelFactoryRegistry, 'get'>,\n): string | null {\n const candidates = [normalizeOverride(env.OM_AI_PROVIDER), normalizeOverride(env.OPENCODE_PROVIDER)]\n for (const candidate of candidates) {\n if (!candidate) continue\n if (!registry.get) return providerIdAliases(candidate)[0] ?? candidate\n for (const alias of providerIdAliases(candidate)) {\n if (registry.get(alias)) return alias\n }\n }\n return null\n}\n\n/**\n * Reads the global model hint from the unified env vars. `OM_AI_MODEL`\n * wins over the legacy `OPENCODE_MODEL`.\n */\nfunction readGlobalModelFromEnv(env: EnvLookup): string | null {\n return normalizeOverride(env.OM_AI_MODEL) ?? normalizeOverride(env.OPENCODE_MODEL)\n}\n\n/** Canonical per-module model env. Example: `OM_AI_INBOX_OPS_MODEL`. */\nfunction moduleModelEnvVarName(moduleId: string): string {\n return `OM_AI_${moduleId.toUpperCase()}_MODEL`\n}\n\n/**\n * Legacy per-module model env (pre-OM_AI_* rename). Example:\n * `INBOX_OPS_AI_MODEL`. Read as a backward-compatibility fallback only.\n */\nfunction legacyModuleModelEnvVarName(moduleId: string): string {\n return `${moduleId.toUpperCase()}_AI_MODEL`\n}\n\nfunction readModuleModelEnvOverride(env: EnvLookup, moduleId: string): string | null {\n return (\n normalizeOverride(env[moduleModelEnvVarName(moduleId)]) ??\n normalizeOverride(env[legacyModuleModelEnvVarName(moduleId)])\n )\n}\n\n/** Canonical per-module provider env. Example: `OM_AI_INBOX_OPS_PROVIDER`. */\nfunction moduleProviderEnvVarName(moduleId: string): string {\n return `OM_AI_${moduleId.toUpperCase()}_PROVIDER`\n}\n\n/**\n * Legacy per-module provider env (pre-OM_AI_* rename). Example:\n * `INBOX_OPS_AI_PROVIDER`. Read as a backward-compatibility fallback only.\n */\nfunction legacyModuleProviderEnvVarName(moduleId: string): string {\n return `${moduleId.toUpperCase()}_AI_PROVIDER`\n}\n\nfunction readModuleProviderEnvOverride(env: EnvLookup, moduleId: string): string | null {\n return (\n normalizeOverride(env[moduleProviderEnvVarName(moduleId)]) ??\n normalizeOverride(env[legacyModuleProviderEnvVarName(moduleId)])\n )\n}\n\nfunction normalizeProviderHint(\n providerId: string | null,\n registry: AiModelFactoryRegistry,\n): string | null {\n if (!providerId) return null\n const knownProviderIds = registry.list?.().map((provider) => provider.id) ?? []\n if (knownProviderIds.length > 0) {\n return canonicalProviderId(providerId, knownProviderIds)\n }\n return providerIdAliases(providerId)[0] ?? providerId\n}\n\nfunction resolveRequiredProvider(\n providerId: string,\n registry: AiModelFactoryRegistry,\n env: EnvLookup,\n): LlmProvider | null {\n const resolved = registry.resolveFirstConfigured({ env, order: [providerId] })\n if (resolved?.id === providerId) return resolved\n\n const direct = registry.get?.(providerId) ?? null\n if (direct) return direct.isConfigured(env) ? direct : null\n return null\n}\n\nfunction requiredProviderMessage(providerId: string, registry: AiModelFactoryRegistry, env: EnvLookup): string {\n const provider = registry.get?.(providerId) ?? null\n const envKey = provider?.getConfiguredEnvKey?.(env)\n const credentialHint = envKey\n ? ` Set ${envKey} to use this provider.`\n : ' Configure the matching provider API key to use this provider.'\n return `The resolved model is pinned to provider \"${providerId}\", but that provider is not configured.${credentialHint} The runtime refuses to send provider-specific model ids to a different provider.`\n}\n\nfunction moduleBaseUrlEnvVarName(moduleId: string): string {\n return `${moduleId.toUpperCase()}_AI_BASE_URL`\n}\n\n/**\n * Splits a slash-qualified model token (e.g. `openai/gpt-5-mini`) into\n * `{ providerHint, modelId }` when the prefix matches a registered provider\n * id, otherwise returns the entire token as the model id and a null hint.\n *\n * The registry-membership guard avoids mis-splitting model ids that already\n * contain slashes (DeepInfra: `meta-llama/Llama-3.3-70B-Instruct-Turbo`,\n * `zai-org/GLM-5.1`). When the registry does not expose `get`, slash\n * parsing is disabled \u2014 callers without a configured registry behave as if\n * the entire token were a plain model id.\n *\n * Exported for test coverage; production callers go through\n * {@link createModelFactory}.\n */\nexport function parseSlashShorthand(\n token: string,\n registry: Pick<AiModelFactoryRegistry, 'get'>,\n): { providerHint: string | null; modelId: string } {\n const slashIndex = token.indexOf('/')\n if (slashIndex < 0) return { providerHint: null, modelId: token }\n const before = token.slice(0, slashIndex)\n const after = token.slice(slashIndex + 1)\n if (!before || !after) return { providerHint: null, modelId: token }\n if (!registry.get) return { providerHint: null, modelId: token }\n const provider = registry.get(before)\n if (!provider) return { providerHint: null, modelId: token }\n return { providerHint: before, modelId: after }\n}\n\n/**\n * Resolves the effective `allowRuntimeOverride` flag from an input that may\n * carry either the new canonical name (`allowRuntimeOverride`) or the\n * deprecated alias (`allowRuntimeModelOverride`). The canonical name wins\n * when both are present. Returns `true` (permissive) when neither is set.\n *\n * Exported for test coverage.\n */\nexport function resolveAllowRuntimeOverride(input: {\n allowRuntimeOverride?: boolean\n allowRuntimeModelOverride?: boolean\n}): boolean {\n if (input.allowRuntimeOverride !== undefined) return input.allowRuntimeOverride !== false\n if (input.allowRuntimeModelOverride !== undefined) return input.allowRuntimeModelOverride !== false\n return true\n}\n\n/**\n * Creates an {@link AiModelFactory} bound to the DI container. The container\n * reference is accepted for API symmetry with other runtime helpers (and so\n * future work can read provider overrides registered on the container); the\n * current implementation only needs the registry + env. No breaking change\n * when later implementations DO consult the container.\n */\nexport function createModelFactory(\n _container: AwilixContainer,\n deps: CreateModelFactoryDependencies = {},\n): AiModelFactory {\n const registry: AiModelFactoryRegistry = deps.registry ?? llmProviderRegistry\n const env = deps.env ?? process.env\n\n return {\n resolveModel(input: AiModelFactoryInput): AiModelResolution {\n const hasModule = typeof input.moduleId === 'string' && input.moduleId.length > 0\n // When allowRuntimeOverride (or its deprecated alias allowRuntimeModelOverride)\n // is explicitly false, skip steps 1 (requestOverride) and 3 (tenantOverride).\n const runtimeOverridesAllowed = resolveAllowRuntimeOverride(input)\n\n // --- Step 1: requestOverride (HTTP query params) \u2014 gated by flag ---\n const requestModelRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.requestOverride?.modelId ?? undefined)\n : null\n const requestProviderRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.requestOverride?.providerId ?? undefined)\n : null\n const requestBaseUrlRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.requestOverride?.baseURL ?? undefined)\n : null\n\n // --- Step 2: callerOverride (programmatic) ---\n const callerRaw = normalizeOverride(input.callerOverride)\n\n // --- Step 3: tenantOverride (DB row) \u2014 gated by flag ---\n const tenantModelRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.tenantOverride?.modelId ?? undefined)\n : null\n const tenantProviderRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.tenantOverride?.providerId ?? undefined)\n : null\n const tenantBaseUrlRaw = runtimeOverridesAllowed\n ? normalizeOverride(input.tenantOverride?.baseURL ?? undefined)\n : null\n\n // --- Steps 4+: env / agent / global ---\n const moduleModelRaw = hasModule\n ? readModuleModelEnvOverride(env, input.moduleId!)\n : null\n const agentModelRaw = normalizeOverride(input.agentDefaultModel)\n // OM_AI_MODEL is canonical; the legacy OPENCODE_MODEL is read as a\n // backward-compatibility fallback through readGlobalModelFromEnv.\n const globalModelRaw = readGlobalModelFromEnv(env)\n\n // Parse slash shorthand on every model-axis source.\n const requestModelParsed = requestModelRaw ? parseSlashShorthand(requestModelRaw, registry) : null\n const callerParsed = callerRaw ? parseSlashShorthand(callerRaw, registry) : null\n const tenantModelParsed = tenantModelRaw ? parseSlashShorthand(tenantModelRaw, registry) : null\n const moduleModelParsed = moduleModelRaw ? parseSlashShorthand(moduleModelRaw, registry) : null\n const agentModelParsed = agentModelRaw ? parseSlashShorthand(agentModelRaw, registry) : null\n const globalModelParsed = globalModelRaw ? parseSlashShorthand(globalModelRaw, registry) : null\n\n const providerOverrideRaw = normalizeOverride(input.providerOverride)\n const moduleProviderRaw = hasModule\n ? readModuleProviderEnvOverride(env, input.moduleId!)\n : null\n const agentDefaultProviderRaw = normalizeOverride(input.agentDefaultProvider)\n // OM_AI_PROVIDER is canonical; the legacy OPENCODE_PROVIDER is read as\n // a backward-compatibility fallback through readGlobalProviderFromEnv.\n const globalProviderRaw = readGlobalProviderFromEnv(env, registry)\n\n const requestProviderHint = normalizeProviderHint(requestProviderRaw, registry)\n const providerOverrideHint = normalizeProviderHint(providerOverrideRaw, registry)\n const tenantProviderHint = normalizeProviderHint(tenantProviderRaw, registry)\n const moduleProviderHint = normalizeProviderHint(moduleProviderRaw, registry)\n const agentDefaultProviderHint = normalizeProviderHint(agentDefaultProviderRaw, registry)\n\n // Walk the provider-axis seed list: slash hint beats plain provider at\n // the same step. We keep only the first (highest-priority) non-null hint.\n const providerHintCandidates: Array<string | null> = [\n requestModelParsed?.providerHint ?? null,\n requestProviderHint,\n callerParsed?.providerHint ?? null,\n providerOverrideHint,\n tenantModelParsed?.providerHint ?? null,\n tenantProviderHint,\n moduleModelParsed?.providerHint ?? null,\n moduleProviderHint,\n agentModelParsed?.providerHint ?? null,\n agentDefaultProviderHint,\n globalModelParsed?.providerHint ?? null,\n globalProviderRaw,\n ]\n const orderHint = providerHintCandidates.find((hint) => hint !== null) ?? null\n const order = orderHint ? [orderHint] : undefined\n\n const pairPlainProviderIfWinning = (providerHint: string | null): string | null =>\n providerHint && providerHint === orderHint ? providerHint : null\n\n let modelId: string\n let source: AiModelResolution['source']\n let pairedProviderHint: string | null = null\n if (requestModelParsed) {\n modelId = requestModelParsed.modelId\n source = 'request_override'\n pairedProviderHint = requestModelParsed.providerHint ?? pairPlainProviderIfWinning(requestProviderHint)\n } else if (callerParsed) {\n modelId = callerParsed.modelId\n source = 'caller_override'\n pairedProviderHint = callerParsed.providerHint ?? pairPlainProviderIfWinning(providerOverrideHint)\n } else if (tenantModelParsed) {\n modelId = tenantModelParsed.modelId\n source = 'tenant_override'\n pairedProviderHint = tenantModelParsed.providerHint ?? pairPlainProviderIfWinning(tenantProviderHint)\n } else if (moduleModelParsed) {\n modelId = moduleModelParsed.modelId\n source = 'module_env'\n pairedProviderHint = moduleModelParsed.providerHint ?? pairPlainProviderIfWinning(moduleProviderHint)\n } else if (agentModelParsed) {\n modelId = agentModelParsed.modelId\n source = 'agent_default'\n pairedProviderHint = agentModelParsed.providerHint ?? pairPlainProviderIfWinning(agentDefaultProviderHint)\n } else if (globalModelParsed) {\n modelId = globalModelParsed.modelId\n source = 'env_default'\n pairedProviderHint = globalModelParsed.providerHint ?? pairPlainProviderIfWinning(globalProviderRaw)\n } else {\n modelId = ''\n source = 'provider_default'\n }\n\n // --- Provider-axis: walk from highest to lowest priority for the seed.\n // A slash-qualified hint from a model source wins over a plain provider\n // source at the same priority step. We walk top-down and take the first\n // non-null hint.\n const provider = pairedProviderHint\n ? resolveRequiredProvider(pairedProviderHint, registry, env)\n : registry.resolveFirstConfigured({ env, order })\n if (!provider) {\n if (pairedProviderHint) {\n throw new AiModelFactoryError(\n 'no_provider_configured',\n requiredProviderMessage(pairedProviderHint, registry, env),\n )\n }\n throw new AiModelFactoryError(\n 'no_provider_configured',\n 'No LLM provider is configured. Set OM_AI_PROVIDER (or the legacy OPENCODE_PROVIDER) plus a matching API key such as OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_GENERATIVE_AI_API_KEY, then restart the app. See https://docs.openmercato.com/framework/ai-assistant/overview.',\n )\n }\n const apiKey = provider.resolveApiKey(env)\n if (!apiKey) {\n throw new AiModelFactoryError(\n 'api_key_missing',\n `LLM provider \"${provider.id}\" is advertised as configured but resolveApiKey() returned empty.`,\n )\n }\n\n // --- Model-axis: use the post-parse model id from the winning source.\n if (source === 'provider_default') {\n modelId = provider.defaultModel\n }\n\n // --- BaseURL-axis resolution (highest to lowest priority) ---\n // 1. requestOverride.baseURL (HTTP dispatcher) \u2014 gated by allowRuntimeOverride\n // 2. baseUrlOverride (programmatic caller)\n // 3. tenantOverride.baseURL (DB row) \u2014 gated by allowRuntimeOverride\n // 4. <MODULE>_AI_BASE_URL env\n // 5. agentDefaultBaseUrl\n // Steps 6-7 (preset env + preset default) are handled inside the adapter's\n // createModel when no explicit baseURL is passed.\n const resolvedBaseURL = requestBaseUrlRaw\n ?? normalizeOverride(input.baseUrlOverride)\n ?? tenantBaseUrlRaw\n ?? (hasModule ? normalizeOverride(env[moduleBaseUrlEnvVarName(input.moduleId!)]) : null)\n ?? normalizeOverride(input.agentDefaultBaseUrl)\n ?? undefined\n\n // --- Allowlist enforcement (Phase 1780-5 + 1780-6) -------------------\n // OM_AI_AVAILABLE_PROVIDERS / OM_AI_AVAILABLE_MODELS_<PROVIDER> clip\n // the resolution to an operator-approved set. The optional tenant\n // allowlist snapshot narrows the env outer constraint further. If the\n // resolved pair isn't allowed, fall back to a safe (provider, model)\n // \u2014 never throw, so a stale tenant override or chat picker can't take\n // the runtime down. The fallback is logged so the operator can see\n // what happened.\n const registryProviderIds = registry.list?.()?.map((p) => p.id) ?? []\n const tenantProviderIds = input.tenantAllowlist\n ? Object.keys(input.tenantAllowlist.allowedModelsByProvider ?? {})\n : []\n const knownProviderIds = Array.from(\n new Set([provider.id, ...registryProviderIds, ...tenantProviderIds]),\n )\n const effectiveAllowlist = intersectAllowlists(\n env,\n knownProviderIds,\n input.tenantAllowlist ?? null,\n )\n const allowlistResult = enforceAllowlist({\n env,\n registry,\n resolved: { provider, modelId },\n agentDefaultProvider: agentDefaultProviderRaw,\n agentDefaultModel: agentModelParsed?.modelId ?? agentModelRaw,\n effective: effectiveAllowlist,\n })\n\n const finalProvider = allowlistResult.provider\n const finalModelId = allowlistResult.modelId\n const finalSource = allowlistResult.fallback ? 'allowlist_fallback' : source\n const finalApiKey = allowlistResult.fallback\n ? finalProvider.resolveApiKey(env)\n : apiKey\n if (!finalApiKey) {\n throw new AiModelFactoryError(\n 'api_key_missing',\n `LLM provider \"${finalProvider.id}\" is advertised as configured but resolveApiKey() returned empty.`,\n )\n }\n\n const model = finalProvider.createModel({\n modelId: finalModelId,\n apiKey: finalApiKey,\n baseURL: resolvedBaseURL,\n })\n return {\n model,\n modelId: finalModelId,\n providerId: finalProvider.id,\n source: finalSource,\n ...(resolvedBaseURL !== undefined ? { baseURL: resolvedBaseURL } : {}),\n ...(allowlistResult.fallback\n ? {\n allowlistFallback: {\n originalProviderId: provider.id,\n originalModelId: modelId,\n reason: allowlistResult.fallback,\n },\n }\n : {}),\n }\n },\n }\n}\n\ninterface EnforceAllowlistInput {\n env: EnvLookup\n registry: AiModelFactoryRegistry\n resolved: { provider: LlmProvider; modelId: string }\n agentDefaultProvider: string | null\n agentDefaultModel: string | null\n effective: EffectiveAllowlist\n}\n\ninterface EnforceAllowlistResult {\n provider: LlmProvider\n modelId: string\n /** Populated only when the resolved pair was rejected. */\n fallback: string | null\n}\n\n/**\n * Clips a resolved `(provider, model)` to what the effective allowlist\n * permits (env intersected with optional tenant allowlist).\n *\n * Order of fallback when the resolved provider is not allowed:\n * 1. The agent's `defaultProvider` (if allowed and configured).\n * 2. The first allowed provider that is also configured in the registry.\n *\n * Order of fallback when the model is not allowed for the resolved provider:\n * 1. The agent's `defaultModel` (if allowed for that provider).\n * 2. The provider's `defaultModel` (if allowed).\n * 3. The first model from the effective allowlist for that provider.\n *\n * Both fall-back paths emit a logger warning so the operator can see why the\n * runtime did not honor the requested combination. The function never throws.\n */\nfunction enforceAllowlist(input: EnforceAllowlistInput): EnforceAllowlistResult {\n const { registry, resolved, agentDefaultProvider, agentDefaultModel, effective } = input\n let provider = resolved.provider\n let modelId = resolved.modelId\n let fallback: string | null = null\n\n if (effective.providers !== null && !isProviderAllowedInEffective(effective, provider.id)) {\n const replacement = pickAllowedProvider({\n registry,\n agentDefaultProvider,\n effective,\n })\n if (replacement) {\n const source = effective.tenantOverridesActive\n ? 'the effective allowlist (env \u2229 tenant)'\n : 'OM_AI_AVAILABLE_PROVIDERS'\n fallback = `Provider \"${provider.id}\" is not in ${source}; using \"${replacement.id}\" instead.`\n logger.warn('Allowlist provider fallback', { reason: fallback })\n provider = replacement\n modelId = pickAllowedModel({\n provider,\n preferred: agentDefaultModel,\n effective,\n })\n }\n // If no replacement is configured we keep the resolved provider \u2014 the\n // throw at the api-key gate will surface the misconfiguration to the\n // operator instead of silently masking it.\n }\n\n if (!isModelAllowedForProviderInEffective(effective, provider.id, modelId)) {\n const replacementModel = pickAllowedModel({\n provider,\n preferred: agentDefaultModel,\n effective,\n })\n if (replacementModel !== modelId) {\n const source = effective.tenantOverridesActive\n ? `the effective allowlist (env \u2229 tenant) for \"${provider.id}\"`\n : `OM_AI_AVAILABLE_MODELS_${provider.id.toUpperCase()}`\n const reason = `Model \"${modelId}\" is not in ${source}; using \"${replacementModel}\" instead.`\n logger.warn('Allowlist model fallback', { reason })\n fallback = fallback ? `${fallback} ${reason}` : reason\n modelId = replacementModel\n }\n }\n\n return { provider, modelId, fallback }\n}\n\nfunction pickAllowedProvider(input: {\n registry: AiModelFactoryRegistry\n agentDefaultProvider: string | null\n effective: EffectiveAllowlist\n}): LlmProvider | null {\n const { registry, agentDefaultProvider, effective } = input\n if (agentDefaultProvider) {\n if (isProviderAllowedInEffective(effective, agentDefaultProvider)) {\n const provider = registry.get?.(agentDefaultProvider)\n if (provider && provider.isConfigured(process.env as EnvLookup)) return provider\n }\n }\n const allowed = effective.providers\n if (!allowed) return null\n for (const id of allowed) {\n const provider = registry.get?.(id)\n if (provider && provider.isConfigured(process.env as EnvLookup)) return provider\n }\n return null\n}\n\nfunction pickAllowedModel(input: {\n provider: LlmProvider\n preferred: string | null\n effective: EffectiveAllowlist\n}): string {\n const { provider, preferred, effective } = input\n const allowed = effective.modelsByProvider[provider.id]\n if (allowed === undefined) {\n return preferred && preferred.length > 0 ? preferred : provider.defaultModel\n }\n if (preferred && allowed.includes(preferred)) return preferred\n if (allowed.includes(provider.defaultModel)) return provider.defaultModel\n return allowed[0] ?? provider.defaultModel\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -1,5 +1,7 @@
1
+ import { createLogger } from "@open-mercato/shared/lib/logger";
1
2
  import { readJsonSafe } from "@open-mercato/shared/lib/http/readJsonSafe";
2
3
  import { fetchWithTimeout, resolveTimeoutMs } from "@open-mercato/shared/lib/http/fetchWithTimeout";
4
+ const logger = createLogger("ai_assistant");
3
5
  const DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS = 3e4;
4
6
  const DEFAULT_OPENCODE_SSE_CONNECT_TIMEOUT_MS = 15e3;
5
7
  function resolveOpencodeTimeoutMs(envVar, fallback) {
@@ -243,7 +245,7 @@ class OpenCodeClient {
243
245
  }
244
246
  }
245
247
  const body = { answers };
246
- console.log("[OpenCode Client] Answering question", questionId, "with body:", JSON.stringify(body));
248
+ logger.debug("Answering question", { questionId, answersCount: answers.length });
247
249
  const res = await fetchWithTimeout(`${this.baseUrl}/question/${questionId}/reply`, {
248
250
  method: "POST",
249
251
  headers: this.headers,
@@ -251,7 +253,7 @@ class OpenCodeClient {
251
253
  timeoutMs: resolveOpencodeTimeoutMs("OPENCODE_REQUEST_TIMEOUT_MS", DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS)
252
254
  });
253
255
  const responseText = await res.text();
254
- console.log("[OpenCode Client] Answer response:", res.status, responseText.substring(0, 200));
256
+ logger.debug("Answer response received", { status: res.status, bytes: responseText.length });
255
257
  if (!res.ok) {
256
258
  throw new Error(`Failed to answer question: ${res.status} - ${responseText}`);
257
259
  }
@@ -260,7 +262,7 @@ class OpenCodeClient {
260
262
  * Reject a pending question.
261
263
  */
262
264
  async rejectQuestion(questionId) {
263
- console.log("[OpenCode Client] Rejecting question", questionId);
265
+ logger.info("OpenCode Client \u2014 Rejecting question", { questionId });
264
266
  const res = await fetchWithTimeout(`${this.baseUrl}/question/${questionId}/reject`, {
265
267
  method: "POST",
266
268
  headers: this.headers,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/modules/ai_assistant/lib/opencode-client.ts"],
4
- "sourcesContent": ["/**\n * OpenCode Agent Client\n *\n * Client for communicating with OpenCode server running in headless mode.\n * OpenCode is used as an AI agent that can execute MCP tools.\n */\nimport { readJsonSafe } from '@open-mercato/shared/lib/http/readJsonSafe'\nimport { fetchWithTimeout, resolveTimeoutMs } from '@open-mercato/shared/lib/http/fetchWithTimeout'\n\nconst DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS = 30_000\nconst DEFAULT_OPENCODE_SSE_CONNECT_TIMEOUT_MS = 15_000\n\nfunction resolveOpencodeTimeoutMs(envVar: string, fallback: number): number {\n const raw = process.env[envVar]\n const parsed = raw ? Number.parseInt(raw, 10) : undefined\n return resolveTimeoutMs(parsed, fallback)\n}\n\nexport type OpenCodeClientConfig = {\n baseUrl: string\n password?: string\n}\n\nexport type OpenCodeSession = {\n id: string\n slug: string\n version: string\n projectID: string\n directory: string\n title: string\n time: {\n created: number\n updated: number\n }\n}\n\nexport type OpenCodeMessagePart = {\n type: 'text'\n text: string\n}\n\nexport type OpenCodeMessageInfo = {\n id: string\n sessionID: string\n role: 'user' | 'assistant'\n time: {\n created: number\n completed?: number\n }\n modelID?: string\n providerID?: string\n tokens?: {\n input: number\n output: number\n }\n error?: {\n name: string\n data: Record<string, unknown>\n }\n}\n\nexport type OpenCodeMessage = {\n info: OpenCodeMessageInfo\n parts: Array<{\n id: string\n type: string\n text?: string\n [key: string]: unknown\n }>\n}\n\nexport type OpenCodeHealth = {\n healthy: boolean\n version: string\n}\n\nexport type OpenCodeMcpStatus = Record<\n string,\n {\n status: 'connected' | 'failed' | 'connecting'\n error?: string\n }\n>\n\nexport type OpenCodeQuestionOption = {\n label: string\n description: string\n}\n\nexport type OpenCodeQuestion = {\n id: string\n sessionID: string\n questions: Array<{\n question: string\n header: string\n options: OpenCodeQuestionOption[]\n }>\n tool: {\n messageID: string\n callID: string\n }\n}\n\n/**\n * SSE Event from OpenCode event stream.\n */\nexport type OpenCodeSSEEvent = {\n type: string\n properties: Record<string, unknown>\n}\n\n/**\n * Callback for SSE events.\n */\nexport type OpenCodeSSECallback = (event: OpenCodeSSEEvent) => void\n\n/**\n * Client for OpenCode server API.\n */\nexport class OpenCodeClient {\n private baseUrl: string\n private headers: Record<string, string>\n\n constructor(config: OpenCodeClientConfig) {\n this.baseUrl = config.baseUrl.replace(/\\/$/, '')\n this.headers = {\n 'Content-Type': 'application/json',\n }\n\n if (config.password) {\n const credentials = Buffer.from(`opencode:${config.password}`).toString('base64')\n this.headers['Authorization'] = `Basic ${credentials}`\n }\n }\n\n /**\n * Subscribe to SSE event stream for real-time updates.\n * Returns an abort function to stop the stream.\n */\n subscribeToEvents(\n onEvent: OpenCodeSSECallback,\n onError?: (error: Error) => void\n ): () => void {\n const controller = new AbortController()\n const connectTimeoutMs = resolveOpencodeTimeoutMs(\n 'OPENCODE_SSE_CONNECT_TIMEOUT_MS',\n DEFAULT_OPENCODE_SSE_CONNECT_TIMEOUT_MS,\n )\n const connectTimeoutReason = new Error(\n `OpenCode SSE connection timed out after ${connectTimeoutMs}ms`,\n )\n let connectTimer: ReturnType<typeof setTimeout> | null = setTimeout(() => {\n controller.abort(connectTimeoutReason)\n }, connectTimeoutMs)\n const clearConnectTimer = () => {\n if (connectTimer !== null) {\n clearTimeout(connectTimer)\n connectTimer = null\n }\n }\n\n const connect = async () => {\n try {\n const res = await fetch(`${this.baseUrl}/event`, {\n headers: {\n ...this.headers,\n Accept: 'text/event-stream',\n },\n signal: controller.signal,\n })\n clearConnectTimer()\n\n if (!res.ok || !res.body) {\n throw new Error(`SSE connection failed: ${res.status}`)\n }\n\n const reader = res.body.getReader()\n const decoder = new TextDecoder()\n let buffer = ''\n\n while (true) {\n const { done, value } = await reader.read()\n if (done) break\n\n buffer += decoder.decode(value, { stream: true })\n\n // Process complete SSE messages\n const lines = buffer.split('\\n')\n buffer = lines.pop() || '' // Keep incomplete line in buffer\n\n for (const line of lines) {\n if (line.startsWith('data: ')) {\n try {\n const data = JSON.parse(line.slice(6))\n onEvent(data)\n } catch {\n // Ignore parse errors\n }\n }\n }\n }\n } catch (error) {\n clearConnectTimer()\n if ((error as Error).name === 'AbortError') {\n const reason = (controller.signal as AbortSignal & { reason?: unknown }).reason\n if (reason === connectTimeoutReason) {\n onError?.(connectTimeoutReason)\n }\n return\n }\n onError?.(error as Error)\n }\n }\n\n connect()\n\n return () => {\n clearConnectTimer()\n controller.abort()\n }\n }\n\n /**\n * Check OpenCode server health.\n */\n async health(): Promise<OpenCodeHealth> {\n const res = await fetchWithTimeout(`${this.baseUrl}/global/health`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`Health check failed: ${res.status}`)\n }\n\n const data = await readJsonSafe<OpenCodeHealth>(res, null)\n if (!data) throw new Error('Health check returned invalid JSON response')\n return data\n }\n\n /**\n * Get MCP server connection status.\n */\n async mcpStatus(): Promise<OpenCodeMcpStatus> {\n const res = await fetchWithTimeout(`${this.baseUrl}/mcp`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`MCP status check failed: ${res.status}`)\n }\n\n const data = await readJsonSafe<OpenCodeMcpStatus>(res, null)\n if (!data) throw new Error('MCP status check returned invalid JSON response')\n return data\n }\n\n /**\n * Create a new conversation session.\n */\n async createSession(): Promise<OpenCodeSession> {\n const res = await fetchWithTimeout(`${this.baseUrl}/session`, {\n method: 'POST',\n headers: this.headers,\n body: JSON.stringify({}),\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n const error = await res.text()\n throw new Error(`Failed to create session: ${error}`)\n }\n\n const data = await readJsonSafe<OpenCodeSession>(res, null)\n if (!data) throw new Error('Create session returned invalid JSON response')\n return data\n }\n\n /**\n * Get an existing session by ID.\n */\n async getSession(sessionId: string): Promise<OpenCodeSession> {\n const res = await fetchWithTimeout(`${this.baseUrl}/session/${sessionId}`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`Failed to get session: ${res.status}`)\n }\n\n const data = await readJsonSafe<OpenCodeSession>(res, null)\n if (!data) throw new Error('Get session returned invalid JSON response')\n return data\n }\n\n /**\n * Send a message to a session and wait for response.\n */\n async sendMessage(\n sessionId: string,\n message: string,\n options?: {\n model?: { providerID: string; modelID: string }\n }\n ): Promise<OpenCodeMessage> {\n const body: Record<string, unknown> = {\n parts: [{ type: 'text', text: message }],\n }\n\n if (options?.model) {\n body.model = options.model\n }\n\n const res = await fetchWithTimeout(`${this.baseUrl}/session/${sessionId}/message`, {\n method: 'POST',\n headers: this.headers,\n body: JSON.stringify(body),\n timeoutMs: resolveOpencodeTimeoutMs(\n 'OPENCODE_SEND_MESSAGE_TIMEOUT_MS',\n resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n ),\n })\n\n if (!res.ok) {\n const error = await res.text()\n throw new Error(`Failed to send message: ${error}`)\n }\n\n const data = await readJsonSafe<OpenCodeMessage>(res, null)\n if (!data) throw new Error('Send message returned invalid JSON response')\n return data\n }\n\n /**\n * Set authentication credentials for a provider.\n */\n async setAuth(providerId: string, apiKey: string): Promise<void> {\n const res = await fetchWithTimeout(`${this.baseUrl}/auth/${providerId}`, {\n method: 'PUT',\n headers: this.headers,\n body: JSON.stringify({ type: 'api', key: apiKey }),\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`Failed to set auth: ${res.status}`)\n }\n }\n\n /**\n * Get current configuration.\n */\n async getConfig(): Promise<Record<string, unknown>> {\n const res = await fetchWithTimeout(`${this.baseUrl}/config`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`Failed to get config: ${res.status}`)\n }\n\n const data = await readJsonSafe<Record<string, unknown>>(res, null)\n if (!data) throw new Error('Get config returned invalid JSON response')\n return data\n }\n\n /**\n * Get pending questions that need user response.\n */\n async getPendingQuestions(): Promise<OpenCodeQuestion[]> {\n const res = await fetchWithTimeout(`${this.baseUrl}/question`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`Failed to get questions: ${res.status}`)\n }\n\n const data = await readJsonSafe<OpenCodeQuestion[]>(res, null)\n if (!data) throw new Error('Get questions returned invalid JSON response')\n return data\n }\n\n /**\n * Answer a pending question.\n * OpenCode expects: POST /question/{requestID}/reply with { answers: [[\"label\"]] }\n * Each answer is an array of selected option labels (for multi-select support).\n */\n async answerQuestion(questionId: string, answerIndex: number): Promise<void> {\n // First get the question to find the selected option label\n const questions = await this.getPendingQuestions()\n const question = questions.find((q) => q.id === questionId)\n\n if (!question) {\n throw new Error(`Question ${questionId} not found`)\n }\n\n // Build answers array - each question's answer is an array of selected labels\n const answers: string[][] = []\n for (const q of question.questions) {\n const selectedOption = q.options[answerIndex]\n if (selectedOption) {\n // Each answer is an array of selected labels (supports multi-select)\n answers.push([selectedOption.label])\n }\n }\n\n const body = { answers }\n\n console.log('[OpenCode Client] Answering question', questionId, 'with body:', JSON.stringify(body))\n\n const res = await fetchWithTimeout(`${this.baseUrl}/question/${questionId}/reply`, {\n method: 'POST',\n headers: this.headers,\n body: JSON.stringify(body),\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n const responseText = await res.text()\n console.log('[OpenCode Client] Answer response:', res.status, responseText.substring(0, 200))\n\n if (!res.ok) {\n throw new Error(`Failed to answer question: ${res.status} - ${responseText}`)\n }\n }\n\n /**\n * Reject a pending question.\n */\n async rejectQuestion(questionId: string): Promise<void> {\n console.log('[OpenCode Client] Rejecting question', questionId)\n\n const res = await fetchWithTimeout(`${this.baseUrl}/question/${questionId}/reject`, {\n method: 'POST',\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n const responseText = await res.text()\n throw new Error(`Failed to reject question: ${res.status} - ${responseText}`)\n }\n }\n\n /**\n * Get session status (idle, busy, waiting for question).\n * Falls back to inferring status from pending questions if endpoint doesn't exist.\n */\n async getSessionStatus(sessionId: string): Promise<{ status: string; questionId?: string }> {\n try {\n const res = await fetchWithTimeout(`${this.baseUrl}/session/${sessionId}/status`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (res.ok) {\n const contentType = res.headers.get('content-type')\n if (contentType && contentType.includes('application/json')) {\n const data = await readJsonSafe<{ status: string; questionId?: string }>(res, null)\n if (data) return data\n }\n }\n } catch {\n // Endpoint doesn't exist or network error - fall through to inference\n }\n\n // Fall back to inferring status from pending questions\n // Note: We can't tell if OpenCode is busy without the status endpoint\n // Return 'unknown' to let SSE events determine actual state\n const questions = await this.getPendingQuestions()\n const sessionQuestion = questions.find((q) => q.sessionID === sessionId)\n if (sessionQuestion) {\n return { status: 'waiting', questionId: sessionQuestion.id }\n }\n // Don't assume idle - we can't know without SSE events\n return { status: 'unknown' }\n }\n}\n\n/**\n * Create an OpenCode client with default configuration from environment.\n */\nexport function createOpenCodeClient(config?: Partial<OpenCodeClientConfig>): OpenCodeClient {\n return new OpenCodeClient({\n baseUrl: config?.baseUrl ?? process.env.OPENCODE_URL ?? 'http://localhost:4096',\n password: config?.password ?? process.env.OPENCODE_PASSWORD,\n })\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["/**\n * OpenCode Agent Client\n *\n * Client for communicating with OpenCode server running in headless mode.\n * OpenCode is used as an AI agent that can execute MCP tools.\n */\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport { readJsonSafe } from '@open-mercato/shared/lib/http/readJsonSafe'\nimport { fetchWithTimeout, resolveTimeoutMs } from '@open-mercato/shared/lib/http/fetchWithTimeout'\n\nconst logger = createLogger('ai_assistant')\n\nconst DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS = 30_000\nconst DEFAULT_OPENCODE_SSE_CONNECT_TIMEOUT_MS = 15_000\n\nfunction resolveOpencodeTimeoutMs(envVar: string, fallback: number): number {\n const raw = process.env[envVar]\n const parsed = raw ? Number.parseInt(raw, 10) : undefined\n return resolveTimeoutMs(parsed, fallback)\n}\n\nexport type OpenCodeClientConfig = {\n baseUrl: string\n password?: string\n}\n\nexport type OpenCodeSession = {\n id: string\n slug: string\n version: string\n projectID: string\n directory: string\n title: string\n time: {\n created: number\n updated: number\n }\n}\n\nexport type OpenCodeMessagePart = {\n type: 'text'\n text: string\n}\n\nexport type OpenCodeMessageInfo = {\n id: string\n sessionID: string\n role: 'user' | 'assistant'\n time: {\n created: number\n completed?: number\n }\n modelID?: string\n providerID?: string\n tokens?: {\n input: number\n output: number\n }\n error?: {\n name: string\n data: Record<string, unknown>\n }\n}\n\nexport type OpenCodeMessage = {\n info: OpenCodeMessageInfo\n parts: Array<{\n id: string\n type: string\n text?: string\n [key: string]: unknown\n }>\n}\n\nexport type OpenCodeHealth = {\n healthy: boolean\n version: string\n}\n\nexport type OpenCodeMcpStatus = Record<\n string,\n {\n status: 'connected' | 'failed' | 'connecting'\n error?: string\n }\n>\n\nexport type OpenCodeQuestionOption = {\n label: string\n description: string\n}\n\nexport type OpenCodeQuestion = {\n id: string\n sessionID: string\n questions: Array<{\n question: string\n header: string\n options: OpenCodeQuestionOption[]\n }>\n tool: {\n messageID: string\n callID: string\n }\n}\n\n/**\n * SSE Event from OpenCode event stream.\n */\nexport type OpenCodeSSEEvent = {\n type: string\n properties: Record<string, unknown>\n}\n\n/**\n * Callback for SSE events.\n */\nexport type OpenCodeSSECallback = (event: OpenCodeSSEEvent) => void\n\n/**\n * Client for OpenCode server API.\n */\nexport class OpenCodeClient {\n private baseUrl: string\n private headers: Record<string, string>\n\n constructor(config: OpenCodeClientConfig) {\n this.baseUrl = config.baseUrl.replace(/\\/$/, '')\n this.headers = {\n 'Content-Type': 'application/json',\n }\n\n if (config.password) {\n const credentials = Buffer.from(`opencode:${config.password}`).toString('base64')\n this.headers['Authorization'] = `Basic ${credentials}`\n }\n }\n\n /**\n * Subscribe to SSE event stream for real-time updates.\n * Returns an abort function to stop the stream.\n */\n subscribeToEvents(\n onEvent: OpenCodeSSECallback,\n onError?: (error: Error) => void\n ): () => void {\n const controller = new AbortController()\n const connectTimeoutMs = resolveOpencodeTimeoutMs(\n 'OPENCODE_SSE_CONNECT_TIMEOUT_MS',\n DEFAULT_OPENCODE_SSE_CONNECT_TIMEOUT_MS,\n )\n const connectTimeoutReason = new Error(\n `OpenCode SSE connection timed out after ${connectTimeoutMs}ms`,\n )\n let connectTimer: ReturnType<typeof setTimeout> | null = setTimeout(() => {\n controller.abort(connectTimeoutReason)\n }, connectTimeoutMs)\n const clearConnectTimer = () => {\n if (connectTimer !== null) {\n clearTimeout(connectTimer)\n connectTimer = null\n }\n }\n\n const connect = async () => {\n try {\n const res = await fetch(`${this.baseUrl}/event`, {\n headers: {\n ...this.headers,\n Accept: 'text/event-stream',\n },\n signal: controller.signal,\n })\n clearConnectTimer()\n\n if (!res.ok || !res.body) {\n throw new Error(`SSE connection failed: ${res.status}`)\n }\n\n const reader = res.body.getReader()\n const decoder = new TextDecoder()\n let buffer = ''\n\n while (true) {\n const { done, value } = await reader.read()\n if (done) break\n\n buffer += decoder.decode(value, { stream: true })\n\n // Process complete SSE messages\n const lines = buffer.split('\\n')\n buffer = lines.pop() || '' // Keep incomplete line in buffer\n\n for (const line of lines) {\n if (line.startsWith('data: ')) {\n try {\n const data = JSON.parse(line.slice(6))\n onEvent(data)\n } catch {\n // Ignore parse errors\n }\n }\n }\n }\n } catch (error) {\n clearConnectTimer()\n if ((error as Error).name === 'AbortError') {\n const reason = (controller.signal as AbortSignal & { reason?: unknown }).reason\n if (reason === connectTimeoutReason) {\n onError?.(connectTimeoutReason)\n }\n return\n }\n onError?.(error as Error)\n }\n }\n\n connect()\n\n return () => {\n clearConnectTimer()\n controller.abort()\n }\n }\n\n /**\n * Check OpenCode server health.\n */\n async health(): Promise<OpenCodeHealth> {\n const res = await fetchWithTimeout(`${this.baseUrl}/global/health`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`Health check failed: ${res.status}`)\n }\n\n const data = await readJsonSafe<OpenCodeHealth>(res, null)\n if (!data) throw new Error('Health check returned invalid JSON response')\n return data\n }\n\n /**\n * Get MCP server connection status.\n */\n async mcpStatus(): Promise<OpenCodeMcpStatus> {\n const res = await fetchWithTimeout(`${this.baseUrl}/mcp`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`MCP status check failed: ${res.status}`)\n }\n\n const data = await readJsonSafe<OpenCodeMcpStatus>(res, null)\n if (!data) throw new Error('MCP status check returned invalid JSON response')\n return data\n }\n\n /**\n * Create a new conversation session.\n */\n async createSession(): Promise<OpenCodeSession> {\n const res = await fetchWithTimeout(`${this.baseUrl}/session`, {\n method: 'POST',\n headers: this.headers,\n body: JSON.stringify({}),\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n const error = await res.text()\n throw new Error(`Failed to create session: ${error}`)\n }\n\n const data = await readJsonSafe<OpenCodeSession>(res, null)\n if (!data) throw new Error('Create session returned invalid JSON response')\n return data\n }\n\n /**\n * Get an existing session by ID.\n */\n async getSession(sessionId: string): Promise<OpenCodeSession> {\n const res = await fetchWithTimeout(`${this.baseUrl}/session/${sessionId}`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`Failed to get session: ${res.status}`)\n }\n\n const data = await readJsonSafe<OpenCodeSession>(res, null)\n if (!data) throw new Error('Get session returned invalid JSON response')\n return data\n }\n\n /**\n * Send a message to a session and wait for response.\n */\n async sendMessage(\n sessionId: string,\n message: string,\n options?: {\n model?: { providerID: string; modelID: string }\n }\n ): Promise<OpenCodeMessage> {\n const body: Record<string, unknown> = {\n parts: [{ type: 'text', text: message }],\n }\n\n if (options?.model) {\n body.model = options.model\n }\n\n const res = await fetchWithTimeout(`${this.baseUrl}/session/${sessionId}/message`, {\n method: 'POST',\n headers: this.headers,\n body: JSON.stringify(body),\n timeoutMs: resolveOpencodeTimeoutMs(\n 'OPENCODE_SEND_MESSAGE_TIMEOUT_MS',\n resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n ),\n })\n\n if (!res.ok) {\n const error = await res.text()\n throw new Error(`Failed to send message: ${error}`)\n }\n\n const data = await readJsonSafe<OpenCodeMessage>(res, null)\n if (!data) throw new Error('Send message returned invalid JSON response')\n return data\n }\n\n /**\n * Set authentication credentials for a provider.\n */\n async setAuth(providerId: string, apiKey: string): Promise<void> {\n const res = await fetchWithTimeout(`${this.baseUrl}/auth/${providerId}`, {\n method: 'PUT',\n headers: this.headers,\n body: JSON.stringify({ type: 'api', key: apiKey }),\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`Failed to set auth: ${res.status}`)\n }\n }\n\n /**\n * Get current configuration.\n */\n async getConfig(): Promise<Record<string, unknown>> {\n const res = await fetchWithTimeout(`${this.baseUrl}/config`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`Failed to get config: ${res.status}`)\n }\n\n const data = await readJsonSafe<Record<string, unknown>>(res, null)\n if (!data) throw new Error('Get config returned invalid JSON response')\n return data\n }\n\n /**\n * Get pending questions that need user response.\n */\n async getPendingQuestions(): Promise<OpenCodeQuestion[]> {\n const res = await fetchWithTimeout(`${this.baseUrl}/question`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n throw new Error(`Failed to get questions: ${res.status}`)\n }\n\n const data = await readJsonSafe<OpenCodeQuestion[]>(res, null)\n if (!data) throw new Error('Get questions returned invalid JSON response')\n return data\n }\n\n /**\n * Answer a pending question.\n * OpenCode expects: POST /question/{requestID}/reply with { answers: [[\"label\"]] }\n * Each answer is an array of selected option labels (for multi-select support).\n */\n async answerQuestion(questionId: string, answerIndex: number): Promise<void> {\n // First get the question to find the selected option label\n const questions = await this.getPendingQuestions()\n const question = questions.find((q) => q.id === questionId)\n\n if (!question) {\n throw new Error(`Question ${questionId} not found`)\n }\n\n // Build answers array - each question's answer is an array of selected labels\n const answers: string[][] = []\n for (const q of question.questions) {\n const selectedOption = q.options[answerIndex]\n if (selectedOption) {\n // Each answer is an array of selected labels (supports multi-select)\n answers.push([selectedOption.label])\n }\n }\n\n const body = { answers }\n\n logger.debug('Answering question', { questionId, answersCount: answers.length })\n\n const res = await fetchWithTimeout(`${this.baseUrl}/question/${questionId}/reply`, {\n method: 'POST',\n headers: this.headers,\n body: JSON.stringify(body),\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n const responseText = await res.text()\n logger.debug('Answer response received', { status: res.status, bytes: responseText.length })\n\n if (!res.ok) {\n throw new Error(`Failed to answer question: ${res.status} - ${responseText}`)\n }\n }\n\n /**\n * Reject a pending question.\n */\n async rejectQuestion(questionId: string): Promise<void> {\n logger.info('OpenCode Client \u2014 Rejecting question', { questionId: questionId })\n\n const res = await fetchWithTimeout(`${this.baseUrl}/question/${questionId}/reject`, {\n method: 'POST',\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (!res.ok) {\n const responseText = await res.text()\n throw new Error(`Failed to reject question: ${res.status} - ${responseText}`)\n }\n }\n\n /**\n * Get session status (idle, busy, waiting for question).\n * Falls back to inferring status from pending questions if endpoint doesn't exist.\n */\n async getSessionStatus(sessionId: string): Promise<{ status: string; questionId?: string }> {\n try {\n const res = await fetchWithTimeout(`${this.baseUrl}/session/${sessionId}/status`, {\n headers: this.headers,\n timeoutMs: resolveOpencodeTimeoutMs('OPENCODE_REQUEST_TIMEOUT_MS', DEFAULT_OPENCODE_REQUEST_TIMEOUT_MS),\n })\n\n if (res.ok) {\n const contentType = res.headers.get('content-type')\n if (contentType && contentType.includes('application/json')) {\n const data = await readJsonSafe<{ status: string; questionId?: string }>(res, null)\n if (data) return data\n }\n }\n } catch {\n // Endpoint doesn't exist or network error - fall through to inference\n }\n\n // Fall back to inferring status from pending questions\n // Note: We can't tell if OpenCode is busy without the status endpoint\n // Return 'unknown' to let SSE events determine actual state\n const questions = await this.getPendingQuestions()\n const sessionQuestion = questions.find((q) => q.sessionID === sessionId)\n if (sessionQuestion) {\n return { status: 'waiting', questionId: sessionQuestion.id }\n }\n // Don't assume idle - we can't know without SSE events\n return { status: 'unknown' }\n }\n}\n\n/**\n * Create an OpenCode client with default configuration from environment.\n */\nexport function createOpenCodeClient(config?: Partial<OpenCodeClientConfig>): OpenCodeClient {\n return new OpenCodeClient({\n baseUrl: config?.baseUrl ?? process.env.OPENCODE_URL ?? 'http://localhost:4096',\n password: config?.password ?? process.env.OPENCODE_PASSWORD,\n })\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }