@open-mercato/ai-assistant 0.4.2-canary-c02407ff85

package/src/modules/ai_assistant/backend/config/ai-assistant/page.meta.ts

@@ -0,0 +1,26 @@
+import React from 'react'
+
+const aiIcon = React.createElement(
+  'svg',
+  { width: 16, height: 16, viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: 2, strokeLinecap: 'round', strokeLinejoin: 'round' },
+  React.createElement('path', { d: 'M12 8V4H8' }),
+  React.createElement('rect', { width: 16, height: 12, x: 4, y: 8, rx: 2 }),
+  React.createElement('path', { d: 'M2 14h2' }),
+  React.createElement('path', { d: 'M20 14h2' }),
+  React.createElement('path', { d: 'M15 13v2' }),
+  React.createElement('path', { d: 'M9 13v2' }),
+)
+
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['ai_assistant.view'],
+  pageTitle: 'AI Assistant',
+  pageTitleKey: 'ai_assistant.config.nav.settings',
+  pageGroup: 'Configuration',
+  pageGroupKey: 'backend.nav.configuration',
+  pageOrder: 430,
+  icon: aiIcon,
+  breadcrumb: [
+    { label: 'AI Assistant', labelKey: 'ai_assistant.config.nav.settings' },
+  ],
+} as const

package/src/modules/ai_assistant/backend/config/ai-assistant/page.tsx

@@ -0,0 +1,12 @@
+import { Page, PageBody } from '@open-mercato/ui/backend/Page'
+import { AiAssistantSettingsPageClient } from '../../../frontend/components/AiAssistantSettingsPageClient'
+
+export default async function AiAssistantSettingsPage() {
+  return (
+    <Page>
+      <PageBody>
+        <AiAssistantSettingsPageClient />
+      </PageBody>
+    </Page>
+  )
+}

package/src/modules/ai_assistant/cli.ts

@@ -0,0 +1,233 @@
+import type { ModuleCli } from '@open-mercato/shared/modules/registry'
+import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
+import { fileURLToPath } from 'node:url'
+import { dirname, resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+/**
+ * Ensure app bootstrap is called before creating DI container.
+ * Uses import.meta.url for runtime path resolution since @/ alias
+ * doesn't work with dynamic imports (TypeScript path aliases are
+ * compile-time only, not available to Node.js at runtime).
+ */
+async function ensureBootstrap(): Promise<void> {
+  // First check if DI is already available
+  try {
+    const { getDiRegistrars } = await import('@open-mercato/shared/lib/di/container')
+    getDiRegistrars()
+    return // DI already available
+  } catch {
+    // DI not available, need to bootstrap
+  }
+
+  // Construct absolute path to bootstrap using import.meta.url
+  try {
+    const __filename = fileURLToPath(import.meta.url)
+    const __dirname = dirname(__filename)
+    // From packages/ai-assistant/src/modules/ai_assistant/cli.ts
+    // to apps/mercato/src/bootstrap.ts:
+    // ai_assistant → modules → src → ai-assistant → packages → root (6 levels)
+    // then into apps/mercato/src/bootstrap.ts
+    const bootstrapPath = resolve(__dirname, '../../../../../../apps/mercato/src/bootstrap.ts')
+
+    // Dynamic import using file URL
+    const bootstrapUrl = pathToFileURL(bootstrapPath).href
+    const { bootstrap, isBootstrapped } = await import(bootstrapUrl)
+
+    if (!isBootstrapped()) {
+      bootstrap()
+    }
+  } catch (error) {
+    console.error('[MCP] Bootstrap failed:', error instanceof Error ? error.message : error)
+    // Continue - some contexts may not have bootstrap available
+  }
+}
+
+function parseArgs(rest: string[]): Record<string, string | boolean> {
+  const args: Record<string, string | boolean> = {}
+  for (let i = 0; i < rest.length; i++) {
+    const arg = rest[i]
+    if (!arg?.startsWith('--')) continue
+
+    const [key, value] = arg.replace(/^--/, '').split('=')
+    if (value !== undefined) {
+      args[key] = value
+    } else if (rest[i + 1] && !rest[i + 1]!.startsWith('--')) {
+      args[key] = rest[i + 1]!
+      i++
+    } else {
+      args[key] = true
+    }
+  }
+  return args
+}
+
+const mcpServe: ModuleCli = {
+  command: 'mcp:serve',
+  async run(rest) {
+    const args = parseArgs(rest)
+    const apiKey = String(args['api-key'] ?? args.apiKey ?? '') || null
+    const tenantId = String(args.tenant ?? args.tenantId ?? '') || null
+    const organizationId = String(args.org ?? args.organizationId ?? '') || null
+    const userId = String(args.user ?? args.userId ?? '') || null
+    const debug = args.debug === true || args.debug === 'true'
+
+    // Either API key or tenant is required
+    if (!apiKey && !tenantId) {
+      console.error('Usage: mercato ai_assistant mcp:serve [options]')
+      console.error('')
+      console.error('Authentication (choose one):')
+      console.error('  --api-key <secret>   API key secret for authentication (recommended)')
+      console.error('  --tenant <id>        Tenant ID (for manual context)')
+      console.error('')
+      console.error('Options (with --tenant):')
+      console.error('  --org <id>           Organization ID (optional)')
+      console.error('  --user <id>          User ID for ACL (optional, uses superadmin if not set)')
+      console.error('')
+      console.error('Common options:')
+      console.error('  --debug              Enable debug logging')
+      console.error('')
+      console.error('Examples:')
+      console.error('  mercato ai_assistant mcp:serve --api-key omk_xxxx.yyyy...')
+      console.error('  mercato ai_assistant mcp:serve --tenant 123e4567-e89b-12d3-a456-426614174000')
+      return
+    }
+
+    await ensureBootstrap()
+    const container = await createRequestContainer()
+
+    const { runMcpServer } = await import('./lib/mcp-server')
+
+    if (apiKey) {
+      await runMcpServer({
+        config: {
+          name: 'open-mercato-mcp',
+          version: '0.1.0',
+          debug,
+        },
+        container,
+        apiKeySecret: apiKey,
+      })
+    } else {
+      await runMcpServer({
+        config: {
+          name: 'open-mercato-mcp',
+          version: '0.1.0',
+          debug,
+        },
+        container,
+        context: {
+          tenantId,
+          organizationId,
+          userId,
+        },
+      })
+    }
+  },
+}
+
+const mcpServeHttp: ModuleCli = {
+  command: 'mcp:serve-http',
+  async run(rest) {
+    const args = parseArgs(rest)
+    const port = parseInt(String(args.port ?? ''), 10)
+    const debug = args.debug === true || args.debug === 'true'
+
+    if (!port || isNaN(port)) {
+      console.error('Usage: mercato ai_assistant mcp:serve-http --port <port> [options]')
+      console.error('')
+      console.error('Options:')
+      console.error('  --port <number>    Port to listen on (required)')
+      console.error('  --debug            Enable debug logging')
+      console.error('')
+      console.error('Authentication:')
+      console.error('  Clients must provide API key via x-api-key header')
+      console.error('')
+      console.error('Example:')
+      console.error('  mercato ai_assistant mcp:serve-http --port 3001')
+      return
+    }
+
+    await ensureBootstrap()
+    const container = await createRequestContainer()
+
+    const { runMcpHttpServer } = await import('./lib/http-server')
+
+    await runMcpHttpServer({
+      config: {
+        name: 'open-mercato-mcp',
+        version: '0.1.0',
+        debug,
+      },
+      container,
+      port,
+    })
+  },
+}
+
+const mcpDev: ModuleCli = {
+  command: 'mcp:dev',
+  async run() {
+    await ensureBootstrap()
+    const { runMcpDevServer } = await import('./lib/mcp-dev-server')
+    await runMcpDevServer()
+  },
+}
+
+const listTools: ModuleCli = {
+  command: 'mcp:list-tools',
+  async run(rest) {
+    const args = parseArgs(rest)
+    const verbose = args.verbose === true || args.verbose === 'true'
+
+    const { loadAllModuleTools } = await import('./lib/tool-loader')
+    await loadAllModuleTools()
+
+    const { getToolRegistry } = await import('./lib/tool-registry')
+    const registry = getToolRegistry()
+    const toolNames = registry.listToolNames()
+
+    if (toolNames.length === 0) {
+      console.log('\nNo MCP tools registered.')
+      console.log('Tools can be registered by modules using registerMcpTool().\n')
+      return
+    }
+
+    console.log(`\nRegistered MCP Tools (${toolNames.length}):\n`)
+
+    // Group tools by module
+    const byModule = new Map<string, string[]>()
+    for (const name of toolNames) {
+      const [module] = name.split('.')
+      const list = byModule.get(module) ?? []
+      list.push(name)
+      byModule.set(module, list)
+    }
+
+    // Sort modules alphabetically
+    const sortedModules = Array.from(byModule.keys()).sort()
+
+    for (const module of sortedModules) {
+      const tools = byModule.get(module)!
+      console.log(`${module} (${tools.length} tools):`)
+
+      for (const name of tools.sort()) {
+        const tool = registry.getTool(name)
+        if (!tool) continue
+
+        if (verbose) {
+          console.log(`  ${name}`)
+          console.log(`    ${tool.description}`)
+          if (tool.requiredFeatures?.length) {
+            console.log(`    Requires: ${tool.requiredFeatures.join(', ')}`)
+          }
+        } else {
+          console.log(`  - ${name}`)
+        }
+      }
+      console.log('')
+    }
+  },
+}
+
+export default [mcpServe, mcpServeHttp, mcpDev, listTools]

package/src/modules/ai_assistant/di.ts

@@ -0,0 +1,9 @@
+import { asValue } from 'awilix'
+import type { AwilixContainer } from 'awilix'
+import { toolRegistry } from './lib/tool-registry'
+
+export function register(container: AwilixContainer): void {
+  container.register({
+    mcpToolRegistry: asValue(toolRegistry),
+  })
+}