@revealui/ai 0.10.1 → 1.0.1

package/dist/tools/mcp-adapter.d.ts

@@ -1,65 +1,22 @@
 /**
  * MCP Tool Adapter
  *
- * Bridges MCP (Model Context Protocol) servers to the tool system.
+ * Bridges MCP (Model Context Protocol) servers to the agent tool system.
  *
- * Two paths:
+ * Consumers construct an `McpClient` from `@revealui/mcp/client` against stdio
+ * or Streamable HTTP, and pass it to `createToolsFromMcpClient()` (or to
+ * `AgentRuntime` via `mcpClients`). That is the only agent-side mount: tools,
+ * resources, prompts, sampling, elicitation.
  *
- *   1. **Standard MCP client** (Stage 5.1a, preferred) — consumers construct an
- *      `McpClient` from `@revealui/mcp/client` against stdio or Streamable HTTP,
- *      and pass it to `createToolsFromMcpClient()` (or to `AgentRuntime` via
- *      `mcpClients`). This is the full-protocol path: future stages will extend
- *      this to resources, prompts, sampling, elicitation, etc.
+ * Structurally typed — `@revealui/ai` has no runtime dependency on
+ * `@revealui/mcp`. Consumers satisfy `McpClientLike`.
  *
- *   2. **Hypervisor** (legacy, pre-5.1a) — consumers pass an `MCPHypervisor` (or
- *      any `MCPToolSource`) to `discoverMCPTools()`. Kept for backwards compat;
- *      deprecated in favor of path (1). The hypervisor still owns server-side
- *      subprocess + tenant-scoping concerns and isn't going away.
- *
- * Both paths are deliberately **structurally typed** — `@revealui/ai` has no
- * runtime dependency on `@revealui/mcp`. Consumers satisfy the shapes
- * `McpClientLike` / `MCPToolSource` with whichever client they construct.
+ * Process-local MCP server spawn and tenant scoping live on `MCPHypervisor`
+ * in `@revealui/mcp`. That is not an agent tool adapter: connect those
+ * processes with a real `McpClient` and call `createToolsFromMcpClient`.
  */
 import type { Tool } from './base.js';
 import { type McpEventSink, type McpToolCallEvent } from './mcp-events.js';
-export declare function warnHypervisorMcpPathDeprecated(site: string): void;
-/** Test-only: reset the one-time deprecation warn latch. */
-export declare function resetHypervisorMcpPathWarningForTests(): void;
-export interface MCPTool {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: 'object';
-        properties: Record<string, unknown>;
-        required?: string[];
-    };
-}
-export interface MCPClient {
-    listTools(): Promise<MCPTool[]>;
-    callTool(name: string, args: unknown): Promise<unknown>;
-}
-/**
- * Interface for an MCP tool source (e.g. MCPHypervisor from @revealui/mcp).
- * Using an interface here keeps @revealui/ai decoupled from @revealui/mcp.
- *
- * @deprecated Prefer `McpClientLike` + `createToolsFromMcpClient()` (Stage 5.1a).
- *   The hypervisor path doesn't expose the full MCP protocol surface (resources,
- *   prompts, sampling, elicitation). The typed-client path does.
- *
- * **Removal owner:** product AI runtime (agent-stream already uses `mcpClients`).
- * **REMOVE-BY:** `@revealui/ai` 1.0.0 — delete `MCPToolSource`, `discoverMCPTools`,
- * and `AgentRuntime` `mcpToolSource` once no external kit still calls them
- * (grep product + published examples in the same PR). Until then this path is
- * retained for external SDK compatibility only.
- */
-export interface MCPToolSource {
-    getAllTools(): Array<{
-        namespacedName: string;
-        serverName: string;
-        tool: MCPTool;
-    }>;
-    callTool(serverName: string, toolName: string, args: unknown): Promise<unknown>;
-}
 /**
  * Structural shape of an `McpClient` from `@revealui/mcp/client`. Declared
  * here (rather than imported) to keep `@revealui/ai` decoupled from
@@ -237,51 +194,10 @@ export interface McpProgressEvent {
  * ```
  */
 export declare function createToolsFromMcpClient(client: McpClientLike, options: CreateToolsFromMcpClientOptions): Promise<Tool[]>;
-/**
- * Create a Tool from an MCP tool definition
- */
-export declare function createToolFromMCP(mcpTool: MCPTool, mcpClient: MCPClient): Tool;
-/**
- * Register all MCP tools in the registry
- */
-export declare function registerMCPTools(mcpClient: MCPClient, registry: {
-    register(tool: Tool): void;
-}): Promise<void>;
 /**
  * Serialize an MCP tool result safely:
  * - bigint values → string (JSON.stringify fails on bigint)
  * - Circular references → replaced with "[Circular]"
  */
 export declare function serializeMCPResult(value: unknown): unknown;
-/** Options for the legacy hypervisor discovery path (GAP-355 integrity). */
-export interface DiscoverMCPToolsOptions {
-    /**
-     * Integrity audit hook (awaited, fail-closed on success). Same contract as
-     * `createToolsFromMcpClient({ onToolAudit })`. `namespace` on the event is
-     * the MCP server name from the hypervisor source.
-     */
-    onToolAudit?: (event: McpToolCallEvent) => void | Promise<void>;
-}
-/**
- * Discover all tools from a running MCPHypervisor (or any MCPToolSource)
- * and return them as RevealUI Tool instances.
- *
- * Tool names use the hypervisor's namespacing (@@mcp_{server}_{tool}) so
- * collisions across servers are impossible.
- *
- * @deprecated Prefer `createToolsFromMcpClient` (Stage 5.1a). Kept for
- *   AgentRuntime `mcpToolSource` compatibility.
- *   **REMOVE-BY:** `@revealui/ai` 1.0.0 (same train as `MCPToolSource`).
- *
- * @example
- * ```typescript
- * import { MCPHypervisor } from '@revealui/mcp'
- * import { discoverMCPTools } from '@revealui/ai'
- *
- * const hypervisor = MCPHypervisor.getInstance()
- * const tools = discoverMCPTools(hypervisor, { onToolAudit })
- * agent.tools.push(...tools)
- * ```
- */
-export declare function discoverMCPTools(source: MCPToolSource, options?: DiscoverMCPToolsOptions): Tool[];
 //# sourceMappingURL=mcp-adapter.d.ts.map

package/dist/tools/mcp-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-adapter.ts"],"names":[],"mappings":"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"}

package/dist/tools/mcp-adapter.js

@@ -1,40 +1,22 @@
 /**
  * MCP Tool Adapter
  *
- * Bridges MCP (Model Context Protocol) servers to the tool system.
+ * Bridges MCP (Model Context Protocol) servers to the agent tool system.
  *
- * Two paths:
+ * Consumers construct an `McpClient` from `@revealui/mcp/client` against stdio
+ * or Streamable HTTP, and pass it to `createToolsFromMcpClient()` (or to
+ * `AgentRuntime` via `mcpClients`). That is the only agent-side mount: tools,
+ * resources, prompts, sampling, elicitation.
  *
- *   1. **Standard MCP client** (Stage 5.1a, preferred) — consumers construct an
- *      `McpClient` from `@revealui/mcp/client` against stdio or Streamable HTTP,
- *      and pass it to `createToolsFromMcpClient()` (or to `AgentRuntime` via
- *      `mcpClients`). This is the full-protocol path: future stages will extend
- *      this to resources, prompts, sampling, elicitation, etc.
+ * Structurally typed — `@revealui/ai` has no runtime dependency on
+ * `@revealui/mcp`. Consumers satisfy `McpClientLike`.
  *
- *   2. **Hypervisor** (legacy, pre-5.1a) — consumers pass an `MCPHypervisor` (or
- *      any `MCPToolSource`) to `discoverMCPTools()`. Kept for backwards compat;
- *      deprecated in favor of path (1). The hypervisor still owns server-side
- *      subprocess + tenant-scoping concerns and isn't going away.
- *
- * Both paths are deliberately **structurally typed** — `@revealui/ai` has no
- * runtime dependency on `@revealui/mcp`. Consumers satisfy the shapes
- * `McpClientLike` / `MCPToolSource` with whichever client they construct.
+ * Process-local MCP server spawn and tenant scoping live on `MCPHypervisor`
+ * in `@revealui/mcp`. That is not an agent tool adapter: connect those
+ * processes with a real `McpClient` and call `createToolsFromMcpClient`.
  */
 import { z } from 'zod/v4';
 import { emitMcpEvent } from './mcp-events.js';
-/** One-time process warning for the hypervisor MCP tool path (REMOVE-BY ai@1.0.0). */
-let hypervisorPathWarned = false;
-export function warnHypervisorMcpPathDeprecated(site) {
-    if (hypervisorPathWarned)
-        return;
-    hypervisorPathWarned = true;
-    process.emitWarning(`@revealui/ai: ${site} is deprecated. Prefer mcpClients / createToolsFromMcpClient (Stage 5.1a). ` +
-        'REMOVE-BY: @revealui/ai 1.0.0. See packages/ai/src/tools/mcp-adapter.ts.', 'DeprecationWarning', 'REVEALUI_AI_MCP_HYPERVISOR_DEPRECATED');
-}
-/** Test-only: reset the one-time deprecation warn latch. */
-export function resetHypervisorMcpPathWarningForTests() {
-    hypervisorPathWarned = false;
-}
 /**
  * Connect the agent's tool registry to a standard MCP client. Lists tools
  * from the MCP server and returns agent-side `Tool` instances that dispatch
@@ -452,43 +434,6 @@ function extractErrorText(result) {
     }
     return texts.length > 0 ? texts.join('\n') : 'Tool reported error (no detail)';
 }
-/**
- * Create a Tool from an MCP tool definition
- */
-export function createToolFromMCP(mcpTool, mcpClient) {
-    // Convert JSON Schema to Zod schema (simplified)
-    const zodSchema = jsonSchemaToZod(mcpTool.inputSchema);
-    return {
-        name: mcpTool.name,
-        description: mcpTool.description,
-        parameters: zodSchema,
-        execute: async (params) => {
-            try {
-                const result = await mcpClient.callTool(mcpTool.name, params);
-                return {
-                    success: true,
-                    data: result,
-                };
-            }
-            catch (error) {
-                return {
-                    success: false,
-                    error: error instanceof Error ? error.message : String(error),
-                };
-            }
-        },
-    };
-}
-/**
- * Register all MCP tools in the registry
- */
-export async function registerMCPTools(mcpClient, registry) {
-    const tools = await mcpClient.listTools();
-    for (const mcpTool of tools) {
-        const tool = createToolFromMCP(mcpTool, mcpClient);
-        registry.register(tool);
-    }
-}
 /**
  * Serialize an MCP tool result safely:
  * - bigint values → string (JSON.stringify fails on bigint)
@@ -508,87 +453,6 @@ export function serializeMCPResult(value) {
     }
     return JSON.parse(JSON.stringify(value, replacer));
 }
-/**
- * Discover all tools from a running MCPHypervisor (or any MCPToolSource)
- * and return them as RevealUI Tool instances.
- *
- * Tool names use the hypervisor's namespacing (@@mcp_{server}_{tool}) so
- * collisions across servers are impossible.
- *
- * @deprecated Prefer `createToolsFromMcpClient` (Stage 5.1a). Kept for
- *   AgentRuntime `mcpToolSource` compatibility.
- *   **REMOVE-BY:** `@revealui/ai` 1.0.0 (same train as `MCPToolSource`).
- *
- * @example
- * ```typescript
- * import { MCPHypervisor } from '@revealui/mcp'
- * import { discoverMCPTools } from '@revealui/ai'
- *
- * const hypervisor = MCPHypervisor.getInstance()
- * const tools = discoverMCPTools(hypervisor, { onToolAudit })
- * agent.tools.push(...tools)
- * ```
- */
-export function discoverMCPTools(source, options) {
-    warnHypervisorMcpPathDeprecated('discoverMCPTools() / MCPToolSource');
-    return source.getAllTools().map(({ namespacedName, serverName, tool }) => {
-        const zodSchema = jsonSchemaToZod(tool.inputSchema);
-        const agentTool = {
-            name: namespacedName,
-            description: tool.description,
-            parameters: zodSchema,
-            async execute(params) {
-                // Validate params against the schema
-                const validated = zodSchema.parse(params);
-                const started = Date.now();
-                let toolSucceeded = false;
-                let payload;
-                let errorText;
-                try {
-                    payload = await source.callTool(serverName, tool.name, validated);
-                    toolSucceeded = true;
-                }
-                catch (error) {
-                    errorText = error instanceof Error ? error.message : String(error);
-                }
-                const event = {
-                    kind: 'mcp.tool.call',
-                    namespace: serverName,
-                    toolName: tool.name,
-                    duration_ms: Date.now() - started,
-                    success: toolSucceeded,
-                    ...(errorText !== undefined ? { error: errorText } : {}),
-                };
-                if (toolSucceeded) {
-                    // Integrity outside the RPC try so audit throws fail closed.
-                    if (options?.onToolAudit) {
-                        await options.onToolAudit(event);
-                    }
-                    return {
-                        success: true,
-                        data: serializeMCPResult(payload),
-                    };
-                }
-                if (options?.onToolAudit) {
-                    try {
-                        await options.onToolAudit(event);
-                    }
-                    catch {
-                        // Prefer the tool failure over a secondary audit failure.
-                    }
-                }
-                return {
-                    success: false,
-                    error: errorText ?? 'Tool failed',
-                };
-            },
-            getMetadata() {
-                return { category: 'mcp', version: '1.0.0' };
-            },
-        };
-        return agentTool;
-    });
-}
 /**
  * Narrow an untyped `inputSchema` from a spec `Tool` into the shape
  * `jsonSchemaToZod` understands, then delegate. Falls back to a permissive

package/dist/tools/mcp-sampling.d.ts

@@ -21,7 +21,7 @@
  *
  * const llm = new InferenceSnapsProvider({
  *   baseURL: 'http://localhost:9090/v1',
- *   model: 'nemotron-3-nano',
+ *   model: 'gemma3',
  * });
  *
  * const client = new McpClient({
@@ -29,8 +29,8 @@
  *   transport: { kind: 'streamable-http', url: 'https://example.com/mcp' },
  *   samplingHandler: createSamplingHandler({
  *     llm,
- *     defaultModel: 'nemotron-3-nano',
- *     allowedModels: ['nemotron-3-nano', 'gemma4', 'gemma3'],
+ *     defaultModel: 'gemma3',
+ *     allowedModels: ['gemma3', 'gemma4', 'nemotron-3-nano'],
  *   }),
  * });
  * await client.connect();

package/dist/tools/mcp-sampling.js

@@ -21,7 +21,7 @@
  *
  * const llm = new InferenceSnapsProvider({
  *   baseURL: 'http://localhost:9090/v1',
- *   model: 'nemotron-3-nano',
+ *   model: 'gemma3',
  * });
  *
  * const client = new McpClient({
@@ -29,8 +29,8 @@
  *   transport: { kind: 'streamable-http', url: 'https://example.com/mcp' },
  *   samplingHandler: createSamplingHandler({
  *     llm,
- *     defaultModel: 'nemotron-3-nano',
- *     allowedModels: ['nemotron-3-nano', 'gemma4', 'gemma3'],
+ *     defaultModel: 'gemma3',
+ *     allowedModels: ['gemma3', 'gemma4', 'nemotron-3-nano'],
  *   }),
  * });
  * await client.connect();

package/dist/tools/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAElD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAE7C,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAO1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,MAAM,IAAI,IAAI,EAAE;IAIhB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,kBAAkB,IAAI,cAAc,EAAE;IAWhC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CAgBlE;AAED,eAAO,MAAM,kBAAkB,cAAqB,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAElD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAE7C,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAO1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,MAAM,IAAI,IAAI,EAAE;IAIhB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,kBAAkB,IAAI,cAAc,EAAE;IAWhC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CAgBlE;AAED,eAAO,MAAM,kBAAkB,cAAqB,CAAC"}

package/dist/tools/registry.js

@@ -1,3 +1,4 @@
+import { toolParametersToJsonSchema } from '../llm/tool-json-schema.js';
 export class ToolRegistry {
     tools = new Map();
     register(tool) {
@@ -24,7 +25,7 @@ export class ToolRegistry {
             function: {
                 name: tool.name,
                 description: tool.description,
-                parameters: tool.parameters.toJSONSchema(), // Native Zod v4 method
+                parameters: toolParametersToJsonSchema(tool.parameters),
             },
         }));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revealui/ai",
-  "version": "0.10.1",
+  "version": "1.0.1",
   "description": "AI runtime for agent-driven products — agents, memory, LLM providers (Inference Snaps, Ollama, OpenAI-compatible), tools, and orchestration. Anthropic-SDK-free.",
   "keywords": [
     "agent",
@@ -25,8 +25,8 @@
   "dependencies": {
     "lru-cache": "^11.5.1",
     "zod": "^4.4.3",
-    "@revealui/contracts": "0.8.2",
-    "@revealui/core": "0.13.1",
+    "@revealui/contracts": "0.8.3",
+    "@revealui/core": "0.14.1",
     "@revealui/db": "0.10.0",
     "@revealui/resilience": "0.2.4"
   },
@@ -37,7 +37,7 @@
     "jsdom": "29.1.1",
     "react": "19.2.8",
     "react-dom": "19.2.8",
-    "typescript": "^6.0.3",
+    "typescript": "6.0.3",
     "vitest": "^4.1.10",
     "@revealui/dev": "0.1.0"
   },
@@ -135,6 +135,31 @@
       "import": "./dist/llm/providers/base.js",
       "default": "./dist/llm/providers/base.js"
     },
+    "./llm/providers/groq": {
+      "types": "./dist/llm/providers/groq.d.ts",
+      "import": "./dist/llm/providers/groq.js",
+      "default": "./dist/llm/providers/groq.js"
+    },
+    "./llm/providers/xai": {
+      "types": "./dist/llm/providers/xai.d.ts",
+      "import": "./dist/llm/providers/xai.js",
+      "default": "./dist/llm/providers/xai.js"
+    },
+    "./llm/providers/openai": {
+      "types": "./dist/llm/providers/openai.d.ts",
+      "import": "./dist/llm/providers/openai.js",
+      "default": "./dist/llm/providers/openai.js"
+    },
+    "./llm/providers/anthropic": {
+      "types": "./dist/llm/providers/anthropic.d.ts",
+      "import": "./dist/llm/providers/anthropic.js",
+      "default": "./dist/llm/providers/anthropic.js"
+    },
+    "./llm/providers/openai-compat": {
+      "types": "./dist/llm/providers/openai-compat.d.ts",
+      "import": "./dist/llm/providers/openai-compat.js",
+      "default": "./dist/llm/providers/openai-compat.js"
+    },
     "./llm/response-cache": {
       "types": "./dist/llm/response-cache.d.ts",
       "import": "./dist/llm/response-cache.js",