AI Assistant

ai_assistant · @open-mercato/ai-assistant Platform in 0.7.0

MCP server for AI assistant integration with multi-tenant support.

Found by static analysis of the 0.7.0 source. Links that only appear at runtime are not visible here.

2 of the 2 modules outside the starter set that ai_assistant needs in code are missing from its requires.

A newer release exists: ai_assistant in 0.9.0.

Before you enable `ai_assistant` in 0.7.0

5 modules its code requires

✓ 0 declared⚠ 2 not declared, outside the starter set3 not declared, in every app

Enable these yourself, they are not in every starter app

api_keys⚠ Gap attachments⚠ Gap

Already enabled in every starter app: 3 modules.

2 more are optional: the module loses a feature without them.

Before you disable `ai_assistant` in 0.7.0

2 modules require it in code

None of them declares it in requires.

Not declared by

inbox_ops⚠ Gap warranty_claims⚠ Gap

2 more use it optionally or for collaboration.

Required, declared ⚠ Gap: required in code, not in requires ⚠ Gap into a module every starter app has (lower risk) Optional Collaboration In requires only, not seen in code In every starter appA dot takes its module's area colour. Each side lists the areas in the order of the map.Reads left to right: what uses it → ai_assistant → what it needs. Select a module to go to its row.

Needs

Modules ai_assistant needs in 0.7.0
Module	In code	requires	package.json
Module: `api_keys`	In code: Required · api, lib	requires: ⚠ Gap	package.json: ⚠ Not in package.json
9 places Import → Required · api · `packages/ai-assistant/src/modules/ai_assistant/api/chat/route.ts:13` · `@open-mercato/core/modules/api_keys/services/apiKeyService` Import → Required · api · `packages/ai-assistant/src/modules/ai_assistant/api/mcp-key/route.ts:7` · `@open-mercato/core/modules/api_keys/services/apiKeyService` Import → Required · api · `packages/ai-assistant/src/modules/ai_assistant/api/session-key/route.ts:7` · `@open-mercato/core/modules/api_keys/services/apiKeyService` Import → Required · api · `packages/ai-assistant/src/modules/ai_assistant/api/settings/route.ts:10` · `@open-mercato/core/modules/api_keys/services/apiKeyService` Dynamic import in try/catch → Optional · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/auth.ts:66` · `@open-mercato/core/modules/api_keys/services/apiKeyService` Import → Required · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/http-server.ts:18` · `@open-mercato/core/modules/api_keys/services/apiKeyService` Entity import → Required · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/mcp-ensure-api-key.ts:5` · `@open-mercato/core/modules/api_keys/data/entities` Import → Required · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/mcp-ensure-api-key.ts:6` · `@open-mercato/core/modules/api_keys/services/apiKeyService` Import → Required · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/opencode-handlers.ts:10` · `@open-mercato/core/modules/api_keys/services/apiKeyService`
Module: `attachments`	In code: Required · lib	requires: ⚠ Gap	package.json: ⚠ Not in package.json
5 places Contribution file → Collaboration · ai-tools · `packages/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts:31` · `@open-mercato/core/modules/attachments/data/entities` Contribution file → Collaboration · ai-tools · `packages/ai-assistant/src/modules/ai_assistant/ai-tools/attachments-pack.ts:38` · `@open-mercato/core/modules/attachments/lib/metadata` Entity import → Required · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/attachment-parts.ts:133` · `@open-mercato/core/modules/attachments/data/entities` Dynamic import → Required · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/attachment-parts.ts:192` · `@open-mercato/core/modules/attachments/lib/storage` Entity import → Required · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/pending-action-recheck.ts:20` · `@open-mercato/core/modules/attachments/data/entities`
Module: `scheduler`	In code: Optional · setup	requires: Not declared	package.json: ⚠ Not in package.json
2 places Service lookup (DI) in try/catch → Optional · setup · `packages/ai-assistant/src/modules/ai_assistant/setup.ts:35` · `schedulerService` Service lookup (DI) in try/catch → Optional · setup · `packages/ai-assistant/src/modules/ai_assistant/setup.ts:79` · `schedulerService`

In every app (4)

Modules ai_assistant needs in 0.7.0 that every starter app enables
Module	In code	requires	package.json
Module: `auth`	In code: Required · api, cli, lib	requires: ⚠ Gap in every app	package.json: ⚠ Not in package.json
41 places Service lookup (DI) in try/catch → Optional · api · `packages/ai-assistant/src/modules/ai_assistant/api/ai/actions/[id]/cancel/route.ts:142` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/ai-assistant/src/modules/ai_assistant/api/ai/actions/[id]/confirm/route.ts:125` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/ai-assistant/src/modules/ai_assistant/api/ai/actions/[id]/route.ts:102` · `rbacService` Service lookup (DI) → Required · api · `packages/ai-assistant/src/modules/ai_assistant/api/ai/agents/[agentId]/loop-override/route.ts:160` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/ai-assistant/src/modules/ai_assistant/api/ai/agents/[agentId]/models/route.ts:112` · `rbacService` Service lookup (DI) → Required · api · `packages/ai-assistant/src/modules/ai_assistant/api/ai/agents/[agentId]/mutation-policy/route.ts:161` · `rbacService` Service lookup (DI) → Required · api · `packages/ai-assistant/src/modules/ai_assistant/api/ai/agents/[agentId]/prompt-override/route.ts:138` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/ai-assistant/src/modules/ai_assistant/api/ai/agents/route.ts:54` · `rbacService` Service lookup (DI) in try/catch → Optional · api · `packages/ai-assistant/src/modules/ai_assistant/api/ai/chat/route.ts:463` · `rbacService` Service lookup (DI) → Required · api · `packages/ai-assistant/src/modules/ai_assistant/api/ai/conversations/[conversationId]/participants/[userId]/route.ts:85` · `rbacService` and 31 more in `packages/ai-assistant/src/modules/ai_assistant`
Module: `directory`	In code: Required · data	requires: ⚠ Gap in every app	package.json: ⚠ Not in package.json
1 place Entity import → Required · data · `packages/ai-assistant/src/modules/ai_assistant/data/repositories/AiChatConversationRepository.ts:6` · `@open-mercato/core/modules/directory/data/entities`
Module: `notifications`	In code: Required · subscriber	requires: ⚠ Gap in every app	package.json: ⚠ Not in package.json
2 places Import → Required · subscriber · `packages/ai-assistant/src/modules/ai_assistant/subscribers/conversation-shared-notify.ts:2` · `@open-mercato/core/modules/notifications/lib/notificationService` Import → Required · subscriber · `packages/ai-assistant/src/modules/ai_assistant/subscribers/conversation-shared-notify.ts:3` · `@open-mercato/core/modules/notifications/lib/notificationBuilder`
Module: `configs`	In code: Optional · lib	requires: Not declared	package.json: ⚠ Not in package.json
6 places Service lookup (DI) in try/catch → Optional · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/chat-config.ts:122` · `moduleConfigService` Service lookup (DI) in try/catch → Optional · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/chat-config.ts:140` · `moduleConfigService` Service lookup (DI) in try/catch → Optional · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/mcp-server-config.ts:67` · `moduleConfigService` Service lookup (DI) in try/catch → Optional · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/mcp-server-config.ts:114` · `moduleConfigService` Service lookup (DI) in try/catch → Optional · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/mcp-server-config.ts:175` · `moduleConfigService` Service lookup (DI) in try/catch → Optional · lib · `packages/ai-assistant/src/modules/ai_assistant/lib/mcp-server-config.ts:218` · `moduleConfigService`

Used by

Modules that use ai_assistant in 0.7.0
Module	In code	requires	package.json
Module: `inbox_ops`	In code: Required · lib	requires: ⚠ Gap	package.json: ✓ Declared
1 place Import → Required · lib · `packages/core/src/modules/inbox_ops/lib/llmProvider.ts:13` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/model-factory`
Module: `warranty_claims`	In code: Required · lib	requires: ⚠ Gap	package.json: ✓ Declared
2 places Import → Required · lib · `packages/core/src/modules/warranty_claims/lib/aiAssist.ts:5` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/model-factory` Import → Required · lib · `packages/core/src/modules/warranty_claims/lib/aiAssist.ts:10` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/attachment-parts`
Module: `catalog`	In code: Collaboration · ai-tools	requires: Not declared	package.json: ✓ Declared
5 places Contribution file → Collaboration · ai-tools · `packages/core/src/modules/catalog/ai-tools/configuration-pack.ts:15` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool` Contribution file → Collaboration · ai-tools · `packages/core/src/modules/catalog/ai-tools/mutation-pack.ts:61` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner` Contribution file → Collaboration · ai-tools · `packages/core/src/modules/catalog/ai-tools/prices-offers-pack.ts:25` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool` Contribution file → Collaboration · ai-tools · `packages/core/src/modules/catalog/ai-tools/products-pack.ts:14` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool` Contribution file → Collaboration · ai-tools · `packages/core/src/modules/catalog/ai-tools/variants-pack.ts:12` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool`
Module: `customers`	In code: Collaboration · ai-tools	requires: Not declared	package.json: ✓ Declared
7 places Contribution file → Collaboration · ai-tools · `packages/core/src/modules/customers/ai-tools/activities-tasks-pack.ts:11` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner` Contribution file → Collaboration · ai-tools · `packages/core/src/modules/customers/ai-tools/companies-pack.ts:15` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool` Contribution file → Collaboration · ai-tools · `packages/core/src/modules/customers/ai-tools/companies-pack.ts:16` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner` Contribution file → Collaboration · ai-tools · `packages/core/src/modules/customers/ai-tools/deals-pack.ts:19` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool` Contribution file → Collaboration · ai-tools · `packages/core/src/modules/customers/ai-tools/deals-pack.ts:20` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner` Contribution file → Collaboration · ai-tools · `packages/core/src/modules/customers/ai-tools/people-pack.ts:21` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool` Contribution file → Collaboration · ai-tools · `packages/core/src/modules/customers/ai-tools/people-pack.ts:22` · `@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner`

Facts

Registers in DI (2)

mcpToolRegistry · packages/ai-assistant/src/modules/ai_assistant/di.ts:8
moderationService · packages/ai-assistant/src/modules/ai_assistant/di.ts:11

Emits events (4)

ai_assistant.conversation.unshared · packages/ai-assistant/src/modules/ai_assistant/api/ai/conversations/[conversationId]/participants/[userId]/route.ts:125
ai_assistant.conversation.shared · packages/ai-assistant/src/modules/ai_assistant/api/ai/conversations/[conversationId]/participants/route.ts:276
ai_assistant.moderation_flag.created · packages/ai-assistant/src/modules/ai_assistant/lib/moderation-flag-recorder.ts:64
ai.token_usage.recorded · packages/ai-assistant/src/modules/ai_assistant/lib/token-usage-recorder.ts:102

Subscribes to events (1)

ai_assistant.conversation.shared · packages/ai-assistant/src/modules/ai_assistant/subscribers/conversation-shared-notify.ts:13

Entities (11)

AiAgentPromptOverride · packages/ai-assistant/src/modules/ai_assistant/data/entities.ts:50
AiPendingAction · packages/ai-assistant/src/modules/ai_assistant/data/entities.ts:122
AiAgentRuntimeOverride · packages/ai-assistant/src/modules/ai_assistant/data/entities.ts:254
AiTokenUsageEvent · packages/ai-assistant/src/modules/ai_assistant/data/entities.ts:406
AiTokenUsageDaily · packages/ai-assistant/src/modules/ai_assistant/data/entities.ts:504
AiTenantModelAllowlist · packages/ai-assistant/src/modules/ai_assistant/data/entities.ts:600
AiAgentMutationPolicyOverride · packages/ai-assistant/src/modules/ai_assistant/data/entities.ts:653
AiChatConversation · packages/ai-assistant/src/modules/ai_assistant/data/entities.ts:722
AiChatConversationParticipant · packages/ai-assistant/src/modules/ai_assistant/data/entities.ts:812
AiChatMessage · packages/ai-assistant/src/modules/ai_assistant/data/entities.ts:885
AiModerationFlag · packages/ai-assistant/src/modules/ai_assistant/data/entities.ts:962