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

package/dist/modules/ai_assistant/frontend/components/AiAssistantSettingsPageClient.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/ai_assistant/frontend/components/AiAssistantSettingsPageClient.tsx"],
+  "sourcesContent": ["'use client'\n\nimport * as React from 'react'\nimport { useState } from 'react'\nimport { useQuery } from '@tanstack/react-query'\nimport { Bot, Loader2, CheckCircle2, XCircle, ChevronDown, ChevronRight, Server, Wrench, AlertTriangle } from 'lucide-react'\nimport { Button } from '@open-mercato/ui/primitives/button'\nimport {\n  CommandPaletteProvider,\n  CommandPalette,\n  useCommandPaletteContext,\n} from '../../../../frontend'\n\n// OpenCode health response type\ntype OpenCodeHealthResponse = {\n  status: 'ok' | 'error'\n  opencode?: {\n    healthy: boolean\n    version: string\n  }\n  mcp?: Record<string, { status: string; error?: string }>\n  search?: {\n    available: boolean\n    driver: string | null\n  }\n  url: string\n  message?: string\n}\n\n// Provider config type from settings API\ntype ProviderConfig = {\n  id: string\n  name: string\n  model: string\n  defaultModel: string\n  envKey: string\n  configured: boolean\n}\n\ntype SettingsResponse = {\n  provider: ProviderConfig\n  availableProviders: ProviderConfig[]\n}\n\n// Tool info type\ntype ToolInfo = {\n  name: string\n  description: string\n  module: string\n  inputSchema: Record<string, unknown>\n}\n\n// API fetch functions\nasync function fetchHealth(): Promise<OpenCodeHealthResponse> {\n  const res = await fetch('/api/ai_assistant/health')\n  if (!res.ok) throw new Error('Failed to fetch health')\n  return res.json()\n}\n\nasync function fetchSettings(): Promise<SettingsResponse> {\n  const res = await fetch('/api/ai_assistant/settings')\n  if (!res.ok) throw new Error('Failed to fetch settings')\n  return res.json()\n}\n\nasync function fetchTools(): Promise<{ tools: ToolInfo[] }> {\n  const res = await fetch('/api/ai_assistant/tools')\n  if (!res.ok) throw new Error('Failed to fetch tools')\n  return res.json()\n}\n\nfunction AiAssistantSettingsContent() {\n  const [toolsExpanded, setToolsExpanded] = useState(false)\n  const { setIsOpen } = useCommandPaletteContext()\n\n  // Health query - polls every 10 seconds\n  const healthQuery = useQuery({\n    queryKey: ['ai-assistant', 'health'],\n    queryFn: fetchHealth,\n    refetchInterval: 10000,\n    staleTime: 5000,\n  })\n\n  // Settings query - no polling needed (static config)\n  const settingsQuery = useQuery({\n    queryKey: ['ai-assistant', 'settings'],\n    queryFn: fetchSettings,\n    staleTime: 60000,\n  })\n\n  // Tools query - no polling needed\n  const toolsQuery = useQuery({\n    queryKey: ['ai-assistant', 'tools'],\n    queryFn: fetchTools,\n    staleTime: 60000,\n  })\n\n  // Open AI Assistant palette\n  const openAiAssistant = () => {\n    setIsOpen(true)\n  }\n\n  const isLoading = healthQuery.isLoading || settingsQuery.isLoading || toolsQuery.isLoading\n\n  if (isLoading) {\n    return (\n      <div className=\"flex items-center gap-2 text-muted-foreground py-8\">\n        <Loader2 className=\"h-4 w-4 animate-spin\" />\n        Loading settings...\n      </div>\n    )\n  }\n\n  const health = healthQuery.data\n  const settings = settingsQuery.data\n  const tools = toolsQuery.data?.tools || []\n\n  // Group tools by module\n  const toolsByModule = tools.reduce<Record<string, ToolInfo[]>>((acc, tool) => {\n    const module = tool.module || 'other'\n    if (!acc[module]) acc[module] = []\n    acc[module].push(tool)\n    return acc\n  }, {})\n\n  const provider = settings?.provider\n\n  return (\n    <div className=\"flex flex-col gap-6\">\n      {/* Header */}\n      <div className=\"space-y-1\">\n        <h1 className=\"text-2xl font-bold flex items-center gap-2\">\n          <Bot className=\"h-6 w-6\" />\n          AI Assistant Settings\n        </h1>\n        <p className=\"text-muted-foreground\">\n          Configure and monitor the AI assistant\n        </p>\n      </div>\n\n      {/* Test AI Assistant Section */}\n      <div className=\"rounded-lg border bg-card p-6\">\n        <div className=\"flex items-start justify-between\">\n          <div className=\"space-y-1\">\n            <h2 className=\"text-lg font-semibold flex items-center gap-2\">\n              <Bot className=\"h-5 w-5\" />\n              Test AI Assistant\n            </h2>\n            <p className=\"text-sm text-muted-foreground\">\n              Click the button to open the AI Assistant command palette.\n            </p>\n          </div>\n          <Button onClick={openAiAssistant} size=\"lg\" className=\"gap-2\">\n            <Bot className=\"h-4 w-4\" />\n            Open AI Assistant\n          </Button>\n        </div>\n      </div>\n\n      {/* Configuration Section */}\n      <div className=\"rounded-lg border bg-card p-6\">\n        <h2 className=\"text-sm font-semibold mb-4 flex items-center gap-2\">\n          <Server className=\"h-4 w-4\" />\n          Configuration\n        </h2>\n        <div className=\"bg-muted/50 rounded-md p-4 space-y-2\">\n          <div className=\"flex items-center gap-2 text-sm\">\n            <span className=\"text-muted-foreground\">Provider:</span>\n            <span className=\"font-medium\">{provider?.name || 'Anthropic'}</span>\n            {provider?.configured ? (\n              <span className=\"flex items-center gap-1 text-emerald-600 dark:text-emerald-400 text-xs\">\n                <CheckCircle2 className=\"h-3 w-3\" />\n                Configured\n              </span>\n            ) : (\n              <span className=\"flex items-center gap-1 text-amber-600 dark:text-amber-400 text-xs\">\n                <XCircle className=\"h-3 w-3\" />\n                Not configured\n              </span>\n            )}\n          </div>\n          <div className=\"flex items-center gap-2 text-sm\">\n            <span className=\"text-muted-foreground\">Model:</span>\n            <code className=\"font-mono text-xs bg-background px-1.5 py-0.5 rounded\">{provider?.model || 'claude-haiku-4-5-20251001'}</code>\n          </div>\n          <div className=\"flex items-center gap-2 text-sm\">\n            <span className=\"text-muted-foreground\">Required:</span>\n            <span>Set <code className=\"font-mono text-xs bg-background px-1.5 py-0.5 rounded\">{provider?.envKey || 'OPENCODE_ANTHROPIC_API_KEY'}</code> in .env</span>\n          </div>\n        </div>\n\n        {/* Available Providers */}\n        {settings?.availableProviders && settings.availableProviders.length > 1 && (\n          <div className=\"mt-4\">\n            <p className=\"text-xs text-muted-foreground mb-2\">Available Providers:</p>\n            <div className=\"flex flex-wrap gap-2\">\n              {settings.availableProviders.map((p) => (\n                <div\n                  key={p.id}\n                  className={`px-2 py-1 rounded text-xs ${\n                    p.id === provider?.id\n                      ? 'bg-primary text-primary-foreground'\n                      : p.configured\n                        ? 'bg-emerald-100 text-emerald-800 dark:bg-emerald-900/30 dark:text-emerald-400'\n                        : 'bg-muted text-muted-foreground'\n                  }`}\n                >\n                  {p.name}\n                  {p.id === provider?.id && ' (active)'}\n                  {p.id !== provider?.id && p.configured && ' (ready)'}\n                </div>\n              ))}\n            </div>\n          </div>\n        )}\n\n        <p className=\"text-xs text-muted-foreground mt-3\">\n          Set <code className=\"font-mono text-[10px] bg-muted px-1 rounded\">OPENCODE_PROVIDER</code> in .env to change provider (anthropic, openai, google).\n        </p>\n      </div>\n\n      {/* Requirements Section */}\n      <div className=\"rounded-lg border bg-card p-6\">\n        <h2 className=\"text-sm font-semibold mb-4 flex items-center gap-2\">\n          <AlertTriangle className=\"h-4 w-4\" />\n          Requirements\n        </h2>\n        <div className=\"bg-muted/50 rounded-md p-4 space-y-3\">\n          <div className=\"flex items-center gap-2 text-sm\">\n            <span className=\"text-muted-foreground\">Full-Text Search:</span>\n            {health?.search?.available ? (\n              <span className=\"flex items-center gap-1 text-emerald-600 dark:text-emerald-400\">\n                <CheckCircle2 className=\"h-3 w-3\" />\n                Meilisearch connected\n              </span>\n            ) : (\n              <span className=\"flex items-center gap-1 text-amber-600 dark:text-amber-400\">\n                <XCircle className=\"h-3 w-3\" />\n                Not available\n              </span>\n            )}\n          </div>\n          <p className=\"text-xs text-muted-foreground\">\n            A full-text search driver (Meilisearch) is required for API endpoint discovery.\n            Endpoints are indexed automatically when the MCP server starts.\n          </p>\n        </div>\n      </div>\n\n      {/* OpenCode Connection Section */}\n      <div className=\"rounded-lg border bg-card p-6\">\n        <div className=\"flex items-center justify-between mb-4\">\n          <h2 className=\"text-sm font-semibold flex items-center gap-2\">\n            <Server className=\"h-4 w-4\" />\n            OpenCode Connection\n          </h2>\n          {healthQuery.isFetching && !healthQuery.isLoading && (\n            <Loader2 className=\"h-3 w-3 animate-spin text-muted-foreground\" />\n          )}\n        </div>\n        <div className=\"grid gap-4 sm:grid-cols-2\">\n          {/* OpenCode Server Status */}\n          <div className={`p-4 rounded-lg border-2 ${\n            health?.status === 'ok' && health.opencode?.healthy\n              ? 'border-emerald-500/50 bg-emerald-50/50 dark:bg-emerald-900/10'\n              : 'border-destructive/50 bg-destructive/5'\n          }`}>\n            <div className=\"flex items-start justify-between\">\n              <div>\n                <p className=\"text-sm font-medium\">OpenCode Server</p>\n                <p className=\"text-xs text-muted-foreground mt-1\">\n                  {health?.status === 'ok' && health.opencode?.healthy ? (\n                    <span className=\"flex items-center gap-1 text-emerald-600 dark:text-emerald-400\">\n                      <CheckCircle2 className=\"h-3 w-3\" />\n                      Connected\n                    </span>\n                  ) : (\n                    <span className=\"flex items-center gap-1 text-destructive\">\n                      <XCircle className=\"h-3 w-3\" />\n                      {health?.message || 'Disconnected'}\n                    </span>\n                  )}\n                </p>\n                {health?.opencode?.version && (\n                  <p className=\"text-xs text-muted-foreground mt-1\">\n                    Version: {health.opencode.version}\n                  </p>\n                )}\n                <p className=\"text-xs text-muted-foreground mt-1\">\n                  {health?.url || 'http://localhost:4096'}\n                </p>\n              </div>\n              {health?.status === 'ok' && health.opencode?.healthy && (\n                <div className=\"flex h-5 w-5 items-center justify-center rounded-full bg-emerald-100 text-emerald-600 dark:bg-emerald-900/40 dark:text-emerald-400\">\n                  <svg className=\"h-3 w-3\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" strokeWidth={3}>\n                    <path strokeLinecap=\"round\" strokeLinejoin=\"round\" d=\"M5 13l4 4L19 7\" />\n                  </svg>\n                </div>\n              )}\n            </div>\n          </div>\n\n          {/* MCP Server Status */}\n          {health?.mcp && Object.entries(health.mcp).map(([name, mcpStatus]) => (\n            <div\n              key={name}\n              className={`p-4 rounded-lg border-2 ${\n                mcpStatus.status === 'connected'\n                  ? 'border-emerald-500/50 bg-emerald-50/50 dark:bg-emerald-900/10'\n                  : mcpStatus.status === 'connecting'\n                    ? 'border-amber-500/50 bg-amber-50/50 dark:bg-amber-900/10'\n                    : 'border-destructive/50 bg-destructive/5'\n              }`}\n            >\n              <div className=\"flex items-start justify-between\">\n                <div>\n                  <p className=\"text-sm font-medium\">MCP Server</p>\n                  <p className=\"text-xs text-muted-foreground mt-1\">\n                    {mcpStatus.status === 'connected' ? (\n                      <span className=\"flex items-center gap-1 text-emerald-600 dark:text-emerald-400\">\n                        <CheckCircle2 className=\"h-3 w-3\" />\n                        Connected\n                      </span>\n                    ) : mcpStatus.status === 'connecting' ? (\n                      <span className=\"flex items-center gap-1 text-amber-600 dark:text-amber-400\">\n                        <Loader2 className=\"h-3 w-3 animate-spin\" />\n                        Connecting...\n                      </span>\n                    ) : (\n                      <span className=\"flex items-center gap-1 text-destructive\">\n                        <XCircle className=\"h-3 w-3\" />\n                        {mcpStatus.error || 'Failed'}\n                      </span>\n                    )}\n                  </p>\n                  <p className=\"text-xs text-muted-foreground mt-1\">{name}</p>\n                  <p className=\"text-xs text-muted-foreground mt-1\">localhost:3001</p>\n                </div>\n                {mcpStatus.status === 'connected' && (\n                  <div className=\"flex h-5 w-5 items-center justify-center rounded-full bg-emerald-100 text-emerald-600 dark:bg-emerald-900/40 dark:text-emerald-400\">\n                    <svg className=\"h-3 w-3\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" strokeWidth={3}>\n                      <path strokeLinecap=\"round\" strokeLinejoin=\"round\" d=\"M5 13l4 4L19 7\" />\n                    </svg>\n                  </div>\n                )}\n              </div>\n            </div>\n          ))}\n\n          {/* Show placeholder if no MCP info */}\n          {(!health?.mcp || Object.keys(health.mcp).length === 0) && (\n            <div className=\"p-4 rounded-lg border-2 border-border bg-muted/20\">\n              <div>\n                <p className=\"text-sm font-medium\">MCP Server</p>\n                <p className=\"text-xs text-muted-foreground mt-1\">\n                  <span className=\"flex items-center gap-1\">\n                    <XCircle className=\"h-3 w-3\" />\n                    Not connected\n                  </span>\n                </p>\n                <p className=\"text-xs text-muted-foreground mt-1\">localhost:3001</p>\n              </div>\n            </div>\n          )}\n        </div>\n      </div>\n\n      {/* MCP Tools Section */}\n      <div className=\"rounded-lg border bg-card p-6\">\n        <button\n          onClick={() => setToolsExpanded(!toolsExpanded)}\n          className=\"w-full flex items-center justify-between text-left\"\n        >\n          <h2 className=\"text-sm font-semibold flex items-center gap-2\">\n            <Wrench className=\"h-4 w-4\" />\n            MCP Tools ({tools.length} tools)\n          </h2>\n          {toolsExpanded ? (\n            <ChevronDown className=\"h-4 w-4 text-muted-foreground\" />\n          ) : (\n            <ChevronRight className=\"h-4 w-4 text-muted-foreground\" />\n          )}\n        </button>\n\n        {toolsExpanded && (\n          <div className=\"mt-4 space-y-4\">\n            {Object.entries(toolsByModule).map(([module, moduleTools]) => (\n              <div key={module} className=\"space-y-2\">\n                <h3 className=\"text-xs font-medium text-muted-foreground uppercase tracking-wider\">\n                  {module}\n                </h3>\n                <div className=\"space-y-1\">\n                  {moduleTools.map((tool) => (\n                    <div key={tool.name} className=\"pl-2 border-l-2 border-muted py-1\">\n                      <p className=\"text-sm font-medium\">{tool.name}</p>\n                      <p className=\"text-xs text-muted-foreground\">{tool.description}</p>\n                    </div>\n                  ))}\n                </div>\n              </div>\n            ))}\n          </div>\n        )}\n      </div>\n    </div>\n  )\n}\n\nexport function AiAssistantSettingsPageClient() {\n  return (\n    <CommandPaletteProvider tenantId=\"\" organizationId={null}>\n      <AiAssistantSettingsContent />\n      <CommandPalette />\n    </CommandPaletteProvider>\n  )\n}\n\nexport default AiAssistantSettingsPageClient\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/ai_assistant/index.js

@@ -0,0 +1,13 @@
+const metadata = {
+  name: "ai_assistant",
+  title: "AI Assistant",
+  version: "0.1.0",
+  description: "MCP server for AI assistant integration with multi-tenant support.",
+  author: "FreightTech Team"
+};
+import { features } from "./acl.js";
+export {
+  features,
+  metadata
+};
+//# sourceMappingURL=index.js.map

package/dist/modules/ai_assistant/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/ai_assistant/index.ts"],
+  "sourcesContent": ["import type { ModuleInfo } from '@open-mercato/shared/modules/registry'\n\nexport const metadata: ModuleInfo = {\n  name: 'ai_assistant',\n  title: 'AI Assistant',\n  version: '0.1.0',\n  description: 'MCP server for AI assistant integration with multi-tenant support.',\n  author: 'FreightTech Team',\n}\n\nexport { features } from './acl'\n"],
+  "mappings": "AAEO,MAAM,WAAuB;AAAA,EAClC,MAAM;AAAA,EACN,OAAO;AAAA,EACP,SAAS;AAAA,EACT,aAAa;AAAA,EACb,QAAQ;AACV;AAEA,SAAS,gBAAgB;",
+  "names": []
+}

package/dist/modules/ai_assistant/lib/ai-sdk.js

@@ -0,0 +1,13 @@
+import { streamText, generateObject, stepCountIs } from "ai";
+import { createOpenAI } from "@ai-sdk/openai";
+import { createAnthropic } from "@ai-sdk/anthropic";
+import { createGoogleGenerativeAI } from "@ai-sdk/google";
+export {
+  createAnthropic,
+  createGoogleGenerativeAI,
+  createOpenAI,
+  generateObject,
+  stepCountIs,
+  streamText
+};
+//# sourceMappingURL=ai-sdk.js.map

package/dist/modules/ai_assistant/lib/ai-sdk.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ai_assistant/lib/ai-sdk.ts"],
+  "sourcesContent": ["// Re-export AI SDK functions from the ai-assistant package\nexport { streamText, generateObject, stepCountIs } from 'ai'\nexport { createOpenAI } from '@ai-sdk/openai'\nexport { createAnthropic } from '@ai-sdk/anthropic'\nexport { createGoogleGenerativeAI } from '@ai-sdk/google'\n"],
+  "mappings": "AACA,SAAS,YAAY,gBAAgB,mBAAmB;AACxD,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAChC,SAAS,gCAAgC;",
+  "names": []
+}

package/dist/modules/ai_assistant/lib/api-discovery-tools.js

@@ -0,0 +1,249 @@
+import { z } from "zod";
+import { registerMcpTool } from "./tool-registry.js";
+import {
+  getApiEndpoints,
+  getEndpointByOperationId,
+  searchEndpoints
+} from "./api-endpoint-index.js";
+async function loadApiDiscoveryTools() {
+  const endpoints = await getApiEndpoints();
+  console.error(`[API Discovery] ${endpoints.length} endpoints available for discovery`);
+  registerApiDiscoverTool();
+  registerApiExecuteTool();
+  registerApiSchemaTool();
+  return 3;
+}
+function registerApiDiscoverTool() {
+  registerMcpTool(
+    {
+      name: "api_discover",
+      description: `Find API endpoints in Open Mercato by keyword or action.
+
+CAPABILITIES: This tool searches 400+ endpoints that can CREATE, READ, UPDATE, and DELETE
+data across all modules (customers, products, orders, shipments, invoices, etc.).
+
+SEARCH: Uses hybrid search (fulltext + vector) for best results. You can filter by HTTP method.
+
+EXAMPLES:
+- "customer endpoints" - Find all customer-related APIs
+- "create order" - Find endpoint to create new orders
+- "delete product" - Find endpoint to delete products (confirm with user before executing!)
+- "update company name" - Find endpoint to modify companies
+- "search customers" - Find search/list endpoints
+
+Returns: method, path, description, and operationId for each match.
+Use operationId with api_schema to get detailed parameter info before calling api_execute.`,
+      inputSchema: z.object({
+        query: z.string().describe('Natural language query to find relevant endpoints (e.g., "customer list")'),
+        method: z.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).optional().describe("Filter by HTTP method"),
+        limit: z.number().optional().default(10).describe("Max results to return (default: 10)")
+      }),
+      requiredFeatures: [],
+      // Available to all authenticated users
+      handler: async (input, ctx) => {
+        const { query, method, limit = 10 } = input;
+        const searchService = ctx.container?.resolve("searchService");
+        const matches = await searchEndpoints(searchService, query, { limit, method });
+        if (matches.length === 0) {
+          return {
+            success: true,
+            message: "No matching endpoints found. Try different search terms.",
+            endpoints: []
+          };
+        }
+        const results = matches.map((endpoint) => ({
+          operationId: endpoint.operationId,
+          method: endpoint.method,
+          path: endpoint.path,
+          description: endpoint.description || endpoint.summary,
+          tags: endpoint.tags,
+          parameters: endpoint.parameters.map((p) => ({
+            name: p.name,
+            in: p.in,
+            required: p.required,
+            type: p.type
+          })),
+          hasRequestBody: endpoint.requestBodySchema !== null
+        }));
+        return {
+          success: true,
+          message: `Found ${results.length} matching endpoint(s)`,
+          endpoints: results,
+          hint: "Use api_schema to get detailed parameter info, or api_execute to call an endpoint"
+        };
+      }
+    },
+    { moduleId: "api" }
+  );
+}
+function registerApiExecuteTool() {
+  registerMcpTool(
+    {
+      name: "api_execute",
+      description: `Execute an API call to CREATE, READ, UPDATE, or DELETE data in Open Mercato.
+
+WARNING: This tool can MODIFY and DELETE data. Be careful with mutations!
+
+METHODS:
+- GET: Read/search data (safe, no confirmation needed)
+- POST: Create new records (confirm data with user first)
+- PUT/PATCH: Update existing records (confirm changes with user)
+- DELETE: Remove records permanently (ALWAYS confirm with user before executing!)
+
+WORKFLOW:
+1. First use api_discover to find the right endpoint
+2. Use api_schema to understand required parameters
+3. For POST/PUT/PATCH/DELETE: Confirm with user what will be changed
+4. Execute the call with proper parameters
+
+PARAMETERS:
+- method: HTTP method (GET, POST, PUT, PATCH, DELETE)
+- path: API path with parameters replaced (e.g., /customers/companies/123)
+- query: Query parameters as key-value object (for GET requests and filtering)
+- body: Request body for POST/PUT/PATCH (object with required fields)`,
+      inputSchema: z.object({
+        method: z.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).describe("HTTP method"),
+        path: z.string().describe("API path with parameters replaced (e.g., /customers/123, /orders)"),
+        query: z.record(z.string(), z.string()).optional().describe("Query parameters as key-value pairs"),
+        body: z.record(z.string(), z.unknown()).optional().describe("Request body for POST/PUT/PATCH requests")
+      }),
+      requiredFeatures: [],
+      // ACL checked at API level
+      handler: async (input, ctx) => {
+        const { method, path, query, body } = input;
+        const baseUrl = process.env.NEXT_PUBLIC_API_BASE_URL || process.env.NEXT_PUBLIC_APP_URL || process.env.APP_URL || "http://localhost:3000";
+        const apiPath = path.startsWith("/api") ? path : `/api${path}`;
+        let url = `${baseUrl}${apiPath}`;
+        const queryParams = { ...query };
+        if (method === "GET") {
+          if (ctx.tenantId) queryParams.tenantId = ctx.tenantId;
+          if (ctx.organizationId) queryParams.organizationId = ctx.organizationId;
+        }
+        if (Object.keys(queryParams).length > 0) {
+          const separator = url.includes("?") ? "&" : "?";
+          url += separator + new URLSearchParams(queryParams).toString();
+        }
+        let requestBody;
+        if (["POST", "PUT", "PATCH"].includes(method)) {
+          requestBody = { ...body };
+          if (ctx.tenantId) requestBody.tenantId = ctx.tenantId;
+          if (ctx.organizationId) requestBody.organizationId = ctx.organizationId;
+        }
+        const headers = {
+          "Content-Type": "application/json"
+        };
+        if (ctx.apiKeySecret) headers["X-API-Key"] = ctx.apiKeySecret;
+        if (ctx.tenantId) headers["X-Tenant-Id"] = ctx.tenantId;
+        if (ctx.organizationId) headers["X-Organization-Id"] = ctx.organizationId;
+        try {
+          const response = await fetch(url, {
+            method,
+            headers,
+            body: requestBody ? JSON.stringify(requestBody) : void 0
+          });
+          const responseText = await response.text();
+          if (!response.ok) {
+            return {
+              success: false,
+              statusCode: response.status,
+              error: `API error ${response.status}`,
+              details: tryParseJson(responseText)
+            };
+          }
+          return {
+            success: true,
+            statusCode: response.status,
+            data: tryParseJson(responseText)
+          };
+        } catch (error) {
+          return {
+            success: false,
+            error: error instanceof Error ? error.message : "Request failed"
+          };
+        }
+      }
+    },
+    { moduleId: "api" }
+  );
+}
+function registerApiSchemaTool() {
+  registerMcpTool(
+    {
+      name: "api_schema",
+      description: `Get detailed schema for an API endpoint before executing it.
+
+IMPORTANT: Always check the schema before calling POST, PUT, PATCH, or DELETE endpoints
+to understand what parameters are required.
+
+USAGE:
+- Use the operationId from api_discover results
+- Returns: path parameters, query parameters, and request body schema
+- Shows which fields are required vs optional
+- Includes field types and descriptions
+
+This helps you construct the correct api_execute call with all required data.`,
+      inputSchema: z.object({
+        operationId: z.string().describe("Operation ID from api_discover results")
+      }),
+      requiredFeatures: [],
+      handler: async (input) => {
+        const endpoint = await getEndpointByOperationId(input.operationId);
+        if (!endpoint) {
+          return {
+            success: false,
+            error: `Endpoint not found: ${input.operationId}`,
+            hint: "Use api_discover to find available endpoints"
+          };
+        }
+        return {
+          success: true,
+          endpoint: {
+            operationId: endpoint.operationId,
+            method: endpoint.method,
+            path: endpoint.path,
+            description: endpoint.description,
+            tags: endpoint.tags,
+            deprecated: endpoint.deprecated,
+            requiredFeatures: endpoint.requiredFeatures,
+            parameters: endpoint.parameters,
+            requestBodySchema: endpoint.requestBodySchema
+          },
+          usage: buildUsageExample(endpoint)
+        };
+      }
+    },
+    { moduleId: "api" }
+  );
+}
+function buildUsageExample(endpoint) {
+  const pathParams = endpoint.parameters.filter((p) => p.in === "path");
+  const queryParams = endpoint.parameters.filter((p) => p.in === "query");
+  let example = `api_execute with:
+  method: "${endpoint.method}"
+  path: "${endpoint.path}"`;
+  if (pathParams.length > 0) {
+    example += `
+  (replace ${pathParams.map((p) => `{${p.name}}`).join(", ")} in path)`;
+  }
+  if (queryParams.length > 0) {
+    const queryExample = queryParams.slice(0, 3).map((p) => `"${p.name}": "..."`).join(", ");
+    example += `
+  query: { ${queryExample} }`;
+  }
+  if (endpoint.requestBodySchema) {
+    example += `
+  body: { ... } (see requestBodySchema above)`;
+  }
+  return example;
+}
+function tryParseJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+export {
+  loadApiDiscoveryTools
+};
+//# sourceMappingURL=api-discovery-tools.js.map

package/dist/modules/ai_assistant/lib/api-discovery-tools.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ai_assistant/lib/api-discovery-tools.ts"],
+  "sourcesContent": ["/**\n * API Discovery Tools\n *\n * Meta-tools for discovering and executing API endpoints via search.\n * Replaces 400+ individual endpoint tools with 3 flexible tools.\n */\n\nimport { z } from 'zod'\nimport { registerMcpTool } from './tool-registry'\nimport type { McpToolContext } from './types'\nimport {\n  getApiEndpoints,\n  getEndpointByOperationId,\n  searchEndpoints,\n  type ApiEndpoint,\n} from './api-endpoint-index'\n\n/**\n * Load API discovery tools into the registry\n */\nexport async function loadApiDiscoveryTools(): Promise<number> {\n  // Ensure endpoints are parsed and cached\n  const endpoints = await getApiEndpoints()\n  console.error(`[API Discovery] ${endpoints.length} endpoints available for discovery`)\n\n  // Register the three discovery tools\n  registerApiDiscoverTool()\n  registerApiExecuteTool()\n  registerApiSchemaTool()\n\n  return 3\n}\n\n/**\n * api_discover - Find relevant API endpoints based on a query\n */\nfunction registerApiDiscoverTool(): void {\n  registerMcpTool(\n    {\n      name: 'api_discover',\n      description: `Find API endpoints in Open Mercato by keyword or action.\n\nCAPABILITIES: This tool searches 400+ endpoints that can CREATE, READ, UPDATE, and DELETE\ndata across all modules (customers, products, orders, shipments, invoices, etc.).\n\nSEARCH: Uses hybrid search (fulltext + vector) for best results. You can filter by HTTP method.\n\nEXAMPLES:\n- \"customer endpoints\" - Find all customer-related APIs\n- \"create order\" - Find endpoint to create new orders\n- \"delete product\" - Find endpoint to delete products (confirm with user before executing!)\n- \"update company name\" - Find endpoint to modify companies\n- \"search customers\" - Find search/list endpoints\n\nReturns: method, path, description, and operationId for each match.\nUse operationId with api_schema to get detailed parameter info before calling api_execute.`,\n      inputSchema: z.object({\n        query: z\n          .string()\n          .describe('Natural language query to find relevant endpoints (e.g., \"customer list\")'),\n        method: z\n          .enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE'])\n          .optional()\n          .describe('Filter by HTTP method'),\n        limit: z.number().optional().default(10).describe('Max results to return (default: 10)'),\n      }),\n      requiredFeatures: [], // Available to all authenticated users\n      handler: async (input: { query: string; method?: string; limit?: number }, ctx) => {\n        const { query, method, limit = 10 } = input\n\n        // Search for matching endpoints\n        const searchService = ctx.container?.resolve<any>('searchService')\n        const matches = await searchEndpoints(searchService, query, { limit, method })\n\n        if (matches.length === 0) {\n          return {\n            success: true,\n            message: 'No matching endpoints found. Try different search terms.',\n            endpoints: [],\n          }\n        }\n\n        // Format results for LLM consumption\n        const results = matches.map((endpoint) => ({\n          operationId: endpoint.operationId,\n          method: endpoint.method,\n          path: endpoint.path,\n          description: endpoint.description || endpoint.summary,\n          tags: endpoint.tags,\n          parameters: endpoint.parameters.map((p) => ({\n            name: p.name,\n            in: p.in,\n            required: p.required,\n            type: p.type,\n          })),\n          hasRequestBody: endpoint.requestBodySchema !== null,\n        }))\n\n        return {\n          success: true,\n          message: `Found ${results.length} matching endpoint(s)`,\n          endpoints: results,\n          hint: 'Use api_schema to get detailed parameter info, or api_execute to call an endpoint',\n        }\n      },\n    },\n    { moduleId: 'api' }\n  )\n}\n\n/**\n * api_execute - Execute an API endpoint\n */\nfunction registerApiExecuteTool(): void {\n  registerMcpTool(\n    {\n      name: 'api_execute',\n      description: `Execute an API call to CREATE, READ, UPDATE, or DELETE data in Open Mercato.\n\nWARNING: This tool can MODIFY and DELETE data. Be careful with mutations!\n\nMETHODS:\n- GET: Read/search data (safe, no confirmation needed)\n- POST: Create new records (confirm data with user first)\n- PUT/PATCH: Update existing records (confirm changes with user)\n- DELETE: Remove records permanently (ALWAYS confirm with user before executing!)\n\nWORKFLOW:\n1. First use api_discover to find the right endpoint\n2. Use api_schema to understand required parameters\n3. For POST/PUT/PATCH/DELETE: Confirm with user what will be changed\n4. Execute the call with proper parameters\n\nPARAMETERS:\n- method: HTTP method (GET, POST, PUT, PATCH, DELETE)\n- path: API path with parameters replaced (e.g., /customers/companies/123)\n- query: Query parameters as key-value object (for GET requests and filtering)\n- body: Request body for POST/PUT/PATCH (object with required fields)`,\n      inputSchema: z.object({\n        method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']).describe('HTTP method'),\n        path: z\n          .string()\n          .describe('API path with parameters replaced (e.g., /customers/123, /orders)'),\n        query: z\n          .record(z.string(), z.string())\n          .optional()\n          .describe('Query parameters as key-value pairs'),\n        body: z\n          .record(z.string(), z.unknown())\n          .optional()\n          .describe('Request body for POST/PUT/PATCH requests'),\n      }),\n      requiredFeatures: [], // ACL checked at API level\n      handler: async (\n        input: {\n          method: string\n          path: string\n          query?: Record<string, string>\n          body?: Record<string, unknown>\n        },\n        ctx: McpToolContext\n      ) => {\n        const { method, path, query, body } = input\n\n        // Build URL\n        const baseUrl =\n          process.env.NEXT_PUBLIC_API_BASE_URL ||\n          process.env.NEXT_PUBLIC_APP_URL ||\n          process.env.APP_URL ||\n          'http://localhost:3000'\n\n        // Ensure path starts with /api\n        const apiPath = path.startsWith('/api') ? path : `/api${path}`\n        let url = `${baseUrl}${apiPath}`\n\n        // Add query parameters\n        const queryParams = { ...query }\n\n        // Add context to query for GET, to body for mutations\n        if (method === 'GET') {\n          if (ctx.tenantId) queryParams.tenantId = ctx.tenantId\n          if (ctx.organizationId) queryParams.organizationId = ctx.organizationId\n        }\n\n        if (Object.keys(queryParams).length > 0) {\n          const separator = url.includes('?') ? '&' : '?'\n          url += separator + new URLSearchParams(queryParams).toString()\n        }\n\n        // Build body with context\n        let requestBody: Record<string, unknown> | undefined\n        if (['POST', 'PUT', 'PATCH'].includes(method)) {\n          requestBody = { ...body }\n          if (ctx.tenantId) requestBody.tenantId = ctx.tenantId\n          if (ctx.organizationId) requestBody.organizationId = ctx.organizationId\n        }\n\n        // Build headers\n        const headers: Record<string, string> = {\n          'Content-Type': 'application/json',\n        }\n        if (ctx.apiKeySecret) headers['X-API-Key'] = ctx.apiKeySecret\n        if (ctx.tenantId) headers['X-Tenant-Id'] = ctx.tenantId\n        if (ctx.organizationId) headers['X-Organization-Id'] = ctx.organizationId\n\n        // Execute request\n        try {\n          const response = await fetch(url, {\n            method,\n            headers,\n            body: requestBody ? JSON.stringify(requestBody) : undefined,\n          })\n\n          const responseText = await response.text()\n\n          if (!response.ok) {\n            return {\n              success: false,\n              statusCode: response.status,\n              error: `API error ${response.status}`,\n              details: tryParseJson(responseText),\n            }\n          }\n\n          return {\n            success: true,\n            statusCode: response.status,\n            data: tryParseJson(responseText),\n          }\n        } catch (error) {\n          return {\n            success: false,\n            error: error instanceof Error ? error.message : 'Request failed',\n          }\n        }\n      },\n    },\n    { moduleId: 'api' }\n  )\n}\n\n/**\n * api_schema - Get detailed schema for an endpoint\n */\nfunction registerApiSchemaTool(): void {\n  registerMcpTool(\n    {\n      name: 'api_schema',\n      description: `Get detailed schema for an API endpoint before executing it.\n\nIMPORTANT: Always check the schema before calling POST, PUT, PATCH, or DELETE endpoints\nto understand what parameters are required.\n\nUSAGE:\n- Use the operationId from api_discover results\n- Returns: path parameters, query parameters, and request body schema\n- Shows which fields are required vs optional\n- Includes field types and descriptions\n\nThis helps you construct the correct api_execute call with all required data.`,\n      inputSchema: z.object({\n        operationId: z.string().describe('Operation ID from api_discover results'),\n      }),\n      requiredFeatures: [],\n      handler: async (input: { operationId: string }) => {\n        const endpoint = await getEndpointByOperationId(input.operationId)\n\n        if (!endpoint) {\n          return {\n            success: false,\n            error: `Endpoint not found: ${input.operationId}`,\n            hint: 'Use api_discover to find available endpoints',\n          }\n        }\n\n        return {\n          success: true,\n          endpoint: {\n            operationId: endpoint.operationId,\n            method: endpoint.method,\n            path: endpoint.path,\n            description: endpoint.description,\n            tags: endpoint.tags,\n            deprecated: endpoint.deprecated,\n            requiredFeatures: endpoint.requiredFeatures,\n            parameters: endpoint.parameters,\n            requestBodySchema: endpoint.requestBodySchema,\n          },\n          usage: buildUsageExample(endpoint),\n        }\n      },\n    },\n    { moduleId: 'api' }\n  )\n}\n\n/**\n * Build usage example for an endpoint\n */\nfunction buildUsageExample(endpoint: ApiEndpoint): string {\n  const pathParams = endpoint.parameters.filter((p) => p.in === 'path')\n  const queryParams = endpoint.parameters.filter((p) => p.in === 'query')\n\n  let example = `api_execute with:\\n  method: \"${endpoint.method}\"\\n  path: \"${endpoint.path}\"`\n\n  if (pathParams.length > 0) {\n    example += `\\n  (replace ${pathParams.map((p) => `{${p.name}}`).join(', ')} in path)`\n  }\n\n  if (queryParams.length > 0) {\n    const queryExample = queryParams\n      .slice(0, 3)\n      .map((p) => `\"${p.name}\": \"...\"`)\n      .join(', ')\n    example += `\\n  query: { ${queryExample} }`\n  }\n\n  if (endpoint.requestBodySchema) {\n    example += `\\n  body: { ... } (see requestBodySchema above)`\n  }\n\n  return example\n}\n\n/**\n * Try to parse JSON, return original string if fails\n */\nfunction tryParseJson(text: string): unknown {\n  try {\n    return JSON.parse(text)\n  } catch {\n    return text\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/ai_assistant/lib/api-endpoint-index-config.js

@@ -0,0 +1,177 @@
+const API_ENDPOINT_ENTITY_ID = "ai_assistant:api_endpoint";
+const GLOBAL_TENANT_ID = "00000000-0000-0000-0000-000000000000";
+const API_ENDPOINT_SEARCH_CONFIG = {
+  /** Maximum endpoints to return from search */
+  defaultLimit: 20,
+  /** Minimum relevance score (0-1) */
+  minScore: 0.15,
+  /** Strategies to use (in priority order) */
+  strategies: ["fulltext", "vector"]
+};
+const apiEndpointEntityConfig = {
+  entityId: API_ENDPOINT_ENTITY_ID,
+  enabled: true,
+  priority: 90,
+  // High priority, just below tools
+  /**
+   * Build searchable content from an API endpoint.
+   */
+  buildSource: (ctx) => {
+    const endpoint = ctx.record;
+    const method = endpoint.method || "";
+    const path = endpoint.path || "";
+    const summary = endpoint.summary || "";
+    const description = endpoint.description || "";
+    const tags = endpoint.tags || [];
+    const operationId = endpoint.operationId || "";
+    const normalizedPath = path.replace(/[/{}\[\]]/g, " ").trim();
+    const actionWords = getActionWordsForMethod(method);
+    const textContent = [
+      `${method} ${normalizedPath}`,
+      operationId.replace(/[_.-]/g, " "),
+      summary,
+      description,
+      ...actionWords,
+      ...tags
+    ].filter(Boolean).join(" | ");
+    return {
+      text: textContent,
+      fields: {
+        method,
+        path,
+        operationId,
+        summary,
+        description,
+        tags,
+        module: extractModuleFromPath(path),
+        deprecated: endpoint.deprecated ?? false,
+        requiredFeatures: endpoint.requiredFeatures ?? []
+      },
+      presenter: {
+        title: `${method} ${path}`,
+        subtitle: summary || description.slice(0, 100),
+        icon: getIconForMethod(method)
+      },
+      checksumSource: { operationId, method, path, summary }
+    };
+  },
+  /**
+   * Format result for display in search UI.
+   */
+  formatResult: (ctx) => {
+    const endpoint = ctx.record;
+    return {
+      title: `${endpoint.method} ${endpoint.path}`,
+      subtitle: (endpoint.summary || endpoint.description || "").slice(0, 100),
+      icon: getIconForMethod(endpoint.method)
+    };
+  },
+  /**
+   * Field policy for search strategies.
+   */
+  fieldPolicy: {
+    searchable: ["method", "path", "operationId", "summary", "description", "tags", "module"],
+    hashOnly: [],
+    excluded: ["parameters", "requestBodySchema", "requiredFeatures"]
+  }
+};
+function endpointToIndexableRecord(endpoint) {
+  const method = endpoint.method;
+  const path = endpoint.path;
+  const normalizedPath = path.replace(/[/{}\[\]]/g, " ").trim();
+  const actionWords = getActionWordsForMethod(method);
+  const embeddingText = [
+    `${method} ${normalizedPath}`,
+    endpoint.operationId.replace(/[_.-]/g, " "),
+    endpoint.summary,
+    endpoint.description,
+    ...actionWords,
+    ...endpoint.tags
+  ].filter(Boolean).join(" | ");
+  const presenter = {
+    title: `${method} ${path}`,
+    subtitle: (endpoint.summary || endpoint.description || "").slice(0, 100),
+    icon: getIconForMethod(method)
+  };
+  return {
+    entityId: API_ENDPOINT_ENTITY_ID,
+    recordId: endpoint.operationId,
+    tenantId: GLOBAL_TENANT_ID,
+    organizationId: null,
+    fields: {
+      method,
+      path,
+      operationId: endpoint.operationId,
+      summary: endpoint.summary,
+      description: endpoint.description,
+      tags: endpoint.tags,
+      module: extractModuleFromPath(path),
+      deprecated: endpoint.deprecated,
+      requiredFeatures: endpoint.requiredFeatures
+    },
+    presenter,
+    text: embeddingText,
+    checksumSource: {
+      operationId: endpoint.operationId,
+      method,
+      path,
+      summary: endpoint.summary
+    }
+  };
+}
+function getActionWordsForMethod(method) {
+  switch (method.toUpperCase()) {
+    case "GET":
+      return ["read", "fetch", "get", "list", "retrieve", "find", "search", "query"];
+    case "POST":
+      return ["create", "add", "new", "insert", "submit", "register"];
+    case "PUT":
+      return ["update", "replace", "modify", "set", "change", "edit"];
+    case "PATCH":
+      return ["update", "modify", "partial", "change", "edit", "patch"];
+    case "DELETE":
+      return ["delete", "remove", "destroy", "cancel", "erase"];
+    default:
+      return [];
+  }
+}
+function getIconForMethod(method) {
+  switch (method.toUpperCase()) {
+    case "GET":
+      return "search";
+    case "POST":
+      return "plus";
+    case "PUT":
+    case "PATCH":
+      return "edit";
+    case "DELETE":
+      return "trash";
+    default:
+      return "api";
+  }
+}
+function extractModuleFromPath(path) {
+  const match = path.match(/^\/([\w-]+)/);
+  if (match) {
+    return match[1];
+  }
+  return null;
+}
+function computeEndpointsChecksum(endpoints) {
+  const content = endpoints.map((e) => `${e.operationId}:${e.method}:${e.path}`).sort().join("|");
+  let hash = 0;
+  for (let i = 0; i < content.length; i++) {
+    const char = content.charCodeAt(i);
+    hash = (hash << 5) - hash + char | 0;
+  }
+  return hash.toString(16);
+}
+export {
+  API_ENDPOINT_ENTITY_ID,
+  API_ENDPOINT_SEARCH_CONFIG,
+  GLOBAL_TENANT_ID,
+  apiEndpointEntityConfig,
+  computeEndpointsChecksum,
+  endpointToIndexableRecord
+};
+//# sourceMappingURL=api-endpoint-index-config.js.map

package/dist/modules/ai_assistant/lib/api-endpoint-index-config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ai_assistant/lib/api-endpoint-index-config.ts"],
+  "sourcesContent": ["import type {\n  SearchEntityConfig,\n  SearchResultPresenter,\n  IndexableRecord,\n} from '@open-mercato/search/types'\nimport type { ApiEndpoint } from './api-endpoint-index'\n\n/**\n * Entity ID for API endpoints in the search index.\n * Following the module:entity naming convention.\n */\nexport const API_ENDPOINT_ENTITY_ID = 'ai_assistant:api_endpoint' as const\n\n/**\n * Tenant ID for global endpoints.\n * API endpoints are not tenant-scoped, so we use a special \"system\" UUID.\n * This is the nil UUID (all zeros) reserved for system-wide resources.\n */\nexport const GLOBAL_TENANT_ID = '00000000-0000-0000-0000-000000000000'\n\n/**\n * Default configuration for API endpoint search.\n */\nexport const API_ENDPOINT_SEARCH_CONFIG = {\n  /** Maximum endpoints to return from search */\n  defaultLimit: 20,\n  /** Minimum relevance score (0-1) */\n  minScore: 0.15,\n  /** Strategies to use (in priority order) */\n  strategies: ['fulltext', 'vector'] as const,\n} as const\n\n/**\n * Search entity configuration for API endpoints.\n * This configures how endpoints are indexed and searched.\n */\nexport const apiEndpointEntityConfig: SearchEntityConfig = {\n  entityId: API_ENDPOINT_ENTITY_ID,\n  enabled: true,\n  priority: 90, // High priority, just below tools\n\n  /**\n   * Build searchable content from an API endpoint.\n   */\n  buildSource: (ctx) => {\n    const endpoint = ctx.record as unknown as ApiEndpoint\n    const method = endpoint.method || ''\n    const path = endpoint.path || ''\n    const summary = endpoint.summary || ''\n    const description = endpoint.description || ''\n    const tags = endpoint.tags || []\n    const operationId = endpoint.operationId || ''\n\n    // Normalize path: replace slashes and braces with spaces for better search\n    const normalizedPath = path.replace(/[/{}\\[\\]]/g, ' ').trim()\n\n    // Build action words from method\n    const actionWords = getActionWordsForMethod(method)\n\n    // Build text content for embedding and fulltext search\n    const textContent = [\n      `${method} ${normalizedPath}`,\n      operationId.replace(/[_.-]/g, ' '),\n      summary,\n      description,\n      ...actionWords,\n      ...tags,\n    ]\n      .filter(Boolean)\n      .join(' | ')\n\n    return {\n      text: textContent,\n      fields: {\n        method,\n        path,\n        operationId,\n        summary,\n        description,\n        tags,\n        module: extractModuleFromPath(path),\n        deprecated: endpoint.deprecated ?? false,\n        requiredFeatures: endpoint.requiredFeatures ?? [],\n      },\n      presenter: {\n        title: `${method} ${path}`,\n        subtitle: summary || description.slice(0, 100),\n        icon: getIconForMethod(method),\n      },\n      checksumSource: { operationId, method, path, summary },\n    }\n  },\n\n  /**\n   * Format result for display in search UI.\n   */\n  formatResult: (ctx) => {\n    const endpoint = ctx.record as unknown as ApiEndpoint\n    return {\n      title: `${endpoint.method} ${endpoint.path}`,\n      subtitle: (endpoint.summary || endpoint.description || '').slice(0, 100),\n      icon: getIconForMethod(endpoint.method),\n    }\n  },\n\n  /**\n   * Field policy for search strategies.\n   */\n  fieldPolicy: {\n    searchable: ['method', 'path', 'operationId', 'summary', 'description', 'tags', 'module'],\n    hashOnly: [],\n    excluded: ['parameters', 'requestBodySchema', 'requiredFeatures'],\n  },\n}\n\n/**\n * Convert an API endpoint to an indexable record for search.\n *\n * @param endpoint - The API endpoint to index\n * @returns IndexableRecord ready for search indexing\n */\nexport function endpointToIndexableRecord(endpoint: ApiEndpoint): IndexableRecord {\n  const method = endpoint.method\n  const path = endpoint.path\n  const normalizedPath = path.replace(/[/{}\\[\\]]/g, ' ').trim()\n  const actionWords = getActionWordsForMethod(method)\n\n  // Build text for vector embedding\n  const embeddingText = [\n    `${method} ${normalizedPath}`,\n    endpoint.operationId.replace(/[_.-]/g, ' '),\n    endpoint.summary,\n    endpoint.description,\n    ...actionWords,\n    ...endpoint.tags,\n  ]\n    .filter(Boolean)\n    .join(' | ')\n\n  const presenter: SearchResultPresenter = {\n    title: `${method} ${path}`,\n    subtitle: (endpoint.summary || endpoint.description || '').slice(0, 100),\n    icon: getIconForMethod(method),\n  }\n\n  return {\n    entityId: API_ENDPOINT_ENTITY_ID,\n    recordId: endpoint.operationId,\n    tenantId: GLOBAL_TENANT_ID,\n    organizationId: null,\n    fields: {\n      method,\n      path,\n      operationId: endpoint.operationId,\n      summary: endpoint.summary,\n      description: endpoint.description,\n      tags: endpoint.tags,\n      module: extractModuleFromPath(path),\n      deprecated: endpoint.deprecated,\n      requiredFeatures: endpoint.requiredFeatures,\n    },\n    presenter,\n    text: embeddingText,\n    checksumSource: {\n      operationId: endpoint.operationId,\n      method,\n      path,\n      summary: endpoint.summary,\n    },\n  }\n}\n\n/**\n * Get action words for HTTP method to improve semantic search.\n */\nfunction getActionWordsForMethod(method: string): string[] {\n  switch (method.toUpperCase()) {\n    case 'GET':\n      return ['read', 'fetch', 'get', 'list', 'retrieve', 'find', 'search', 'query']\n    case 'POST':\n      return ['create', 'add', 'new', 'insert', 'submit', 'register']\n    case 'PUT':\n      return ['update', 'replace', 'modify', 'set', 'change', 'edit']\n    case 'PATCH':\n      return ['update', 'modify', 'partial', 'change', 'edit', 'patch']\n    case 'DELETE':\n      return ['delete', 'remove', 'destroy', 'cancel', 'erase']\n    default:\n      return []\n  }\n}\n\n/**\n * Get icon for HTTP method.\n */\nfunction getIconForMethod(method: string): string {\n  switch (method.toUpperCase()) {\n    case 'GET':\n      return 'search'\n    case 'POST':\n      return 'plus'\n    case 'PUT':\n    case 'PATCH':\n      return 'edit'\n    case 'DELETE':\n      return 'trash'\n    default:\n      return 'api'\n  }\n}\n\n/**\n * Extract module name from API path.\n */\nfunction extractModuleFromPath(path: string): string | null {\n  // Common module patterns in paths\n  const match = path.match(/^\\/([\\w-]+)/)\n  if (match) {\n    return match[1]\n  }\n  return null\n}\n\n/**\n * Compute a simple checksum for endpoint definitions.\n * Used to detect changes and avoid unnecessary re-indexing.\n */\nexport function computeEndpointsChecksum(\n  endpoints: Array<{ operationId: string; method: string; path: string }>\n): string {\n  const content = endpoints\n    .map((e) => `${e.operationId}:${e.method}:${e.path}`)\n    .sort()\n    .join('|')\n\n  // Simple hash using string code points\n  let hash = 0\n  for (let i = 0; i < content.length; i++) {\n    const char = content.charCodeAt(i)\n    hash = ((hash << 5) - hash + char) | 0\n  }\n  return hash.toString(16)\n}\n"],
+  "mappings": "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",
+  "names": []
+}