@rudderjs/ai 1.5.0 → 1.6.0

package/dist/index.js

@@ -15,6 +15,8 @@ export { MistralProvider } from './providers/mistral.js';
 export { AzureOpenAIProvider } from './providers/azure.js';
 export { CohereProvider } from './providers/cohere.js';
 export { JinaProvider } from './providers/jina.js';
+export { ElevenLabsProvider, DEFAULT_TTS_MODEL_ID, DEFAULT_VOICE_ID } from './providers/elevenlabs.js';
+export { VoyageProvider } from './providers/voyage.js';
 export { OpenRouterProvider } from './providers/openrouter.js';
 export { BedrockProvider } from './providers/bedrock.js';
 // Tools
@@ -23,7 +25,7 @@ export { zodToJsonSchema } from './zod-to-json-schema.js';
 // Handoffs
 export { handoff, isHandoffTool } from './handoff.js';
 // Agent
-export { Agent, ConversableAgent, agent, stepCountIs, hasToolCall, setConversationStore } from './agent.js';
+export { Agent, ConversableAgent, agent, stepCountIs, hasToolCall, setConversationStore, setUserMemory, resolveUserMemory } from './agent.js';
 export { QueuedPromptBuilder } from './queue-job.js';
 // Middleware
 export { runOnConfig, runOnChunk, runOnBeforeToolCall, runOnAfterToolCall, runSequential, runOnUsage, runOnAbort, runOnError } from './middleware.js';
@@ -31,6 +33,10 @@ export { runOnConfig, runOnChunk, runOnBeforeToolCall, runOnAfterToolCall, runSe
 export { Output } from './output.js';
 // Conversation
 export { MemoryConversationStore } from './conversation.js';
+// User Memory (#A4)
+export { MemoryUserMemory, resolveRemembersSpec } from './memory.js';
+export { withMemoryInject } from './memory-inject.js';
+export { withMemoryExtract } from './memory-extract.js';
 // Sub-agent run store (asTool streaming + suspend)
 export { InMemorySubAgentRunStore, CachedSubAgentRunStore, } from './sub-agent-run-store.js';
 // Facade
@@ -48,8 +54,18 @@ export { toVercelDataStream, toVercelResponse } from './vercel-protocol.js';
 export { Reranker } from './rerank.js';
 // File Management
 export { FileManager } from './files.js';
+// Hosted Vector Stores (#B8 Phase 1)
+export { VectorStores, VectorStore } from './vector-stores/index.js';
+// File Search agent tool (#B8 Phase 2 — provider-native RAG)
+export { fileSearch, isFileSearchTool, FILE_SEARCH_MARKER, FILE_SEARCH_TOOL_NAME, normalizeWhere } from './file-search.js';
 // Cached Embeddings
 export { CachedEmbeddingAdapter } from './cached-embedding.js';
+// Similarity Search (#B7 Phase 2 — agent tool wrapping ORM vector primitives)
+export { similaritySearch } from './similarity-search.js';
+// Budget / pricing (#A6 — full pricing catalog + per-user spend caps)
+export { ModelPricing, estimateCost, assertKnownModelPricing, UnknownModelPricingError, BudgetExceededError, } from './budget/pricing.js';
+export { memoryBudgetStorage, periodKey, } from './budget/storage.js';
+export { withBudget } from './budget/with-budget.js';
 // Testing
 export { AiFake } from './fake.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

@@ -0,0 +1,39 @@
+import type { Tool } from '../types.js';
+import type { McpClientTransport, McpClientToolsOptions } from './types.js';
+/**
+ * The result of `mcpClientTools()` — an array of `Tool`s that also carries a
+ * `close()` method when this call owns the underlying client lifecycle.
+ *
+ * Spreading this into `tools()` works because the extra method is non-enumerable
+ * (and only present when relevant) — the agent loop iterates with for-of which
+ * skips it.
+ */
+export interface McpClientToolsHandle extends ReadonlyArray<Tool> {
+    /** Disconnect the underlying MCP client. No-op when an external client was passed in. */
+    close?: () => Promise<void>;
+}
+/**
+ * Connect to a remote MCP server and surface its tools as RudderJS `Tool`s.
+ *
+ * Three transport shapes are accepted:
+ *
+ * ```ts
+ * // (a) HTTP — string URL or URL instance
+ * const t = await mcpClientTools('https://api.example.com/mcp')
+ *
+ * // (b) Local stdio subprocess
+ * const t = await mcpClientTools({ command: 'npx', args: ['some-mcp-server'] })
+ *
+ * // (c) Already-connected SDK Client (caller owns lifecycle)
+ * const t = await mcpClientTools(myClient)
+ * ```
+ *
+ * The returned array exposes a `close()` method when this call owns the client
+ * (cases a + b). Pass it back so the subprocess / HTTP session can shut down
+ * cleanly when your agent is done.
+ *
+ * The remote server's `inputSchema` (JSON Schema) ships through to providers
+ * via `ToolDefinitionOptions.jsonSchema` — no zod conversion in either direction.
+ */
+export declare function mcpClientTools(transport: McpClientTransport, opts?: McpClientToolsOptions): Promise<McpClientToolsHandle>;
+//# sourceMappingURL=client-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/client-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAmB,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EACV,kBAAkB,EAAE,qBAAqB,EAC1C,MAAM,YAAY,CAAA;AAInB;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAqB,SAAQ,aAAa,CAAC,IAAI,CAAC;IAC/D,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,kBAAkB,EAC7B,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CA4B/B"}

package/dist/mcp/client-tools.js

@@ -0,0 +1,147 @@
+import { z } from 'zod';
+import { dynamicTool } from '../tool.js';
+const CLIENT_INFO = { name: 'rudderjs-ai-mcp-bridge', version: '1.0.0' };
+/**
+ * Connect to a remote MCP server and surface its tools as RudderJS `Tool`s.
+ *
+ * Three transport shapes are accepted:
+ *
+ * ```ts
+ * // (a) HTTP — string URL or URL instance
+ * const t = await mcpClientTools('https://api.example.com/mcp')
+ *
+ * // (b) Local stdio subprocess
+ * const t = await mcpClientTools({ command: 'npx', args: ['some-mcp-server'] })
+ *
+ * // (c) Already-connected SDK Client (caller owns lifecycle)
+ * const t = await mcpClientTools(myClient)
+ * ```
+ *
+ * The returned array exposes a `close()` method when this call owns the client
+ * (cases a + b). Pass it back so the subprocess / HTTP session can shut down
+ * cleanly when your agent is done.
+ *
+ * The remote server's `inputSchema` (JSON Schema) ships through to providers
+ * via `ToolDefinitionOptions.jsonSchema` — no zod conversion in either direction.
+ */
+export async function mcpClientTools(transport, opts = {}) {
+    const streaming = opts.streaming ?? true;
+    const namePrefix = opts.namePrefix ?? '';
+    const { client, ownsClient } = await resolveClient(transport);
+    let toolList;
+    try {
+        const listed = await client.listTools();
+        toolList = listed.tools.filter(t => opts.filter ? opts.filter(t.name) : true);
+    }
+    catch (err) {
+        if (ownsClient)
+            await safeClose(client);
+        throw err;
+    }
+    const tools = toolList.map(t => buildTool(client, t, namePrefix, streaming));
+    const handle = ownsClient
+        ? Object.defineProperty([...tools], 'close', {
+            value: () => safeClose(client),
+            enumerable: false,
+            writable: false,
+        })
+        : tools;
+    return handle;
+}
+async function resolveClient(transport) {
+    // Already a Client instance — duck-type check for `callTool` + `listTools`.
+    if (typeof transport === 'object' && transport !== null && 'callTool' in transport && 'listTools' in transport) {
+        return { client: transport, ownsClient: false };
+    }
+    // Lazy-load the SDK so apps that don't import @rudderjs/ai/mcp don't pay for it.
+    const { Client } = await import('@modelcontextprotocol/sdk/client/index.js');
+    const sdkTransport = await buildTransport(transport);
+    const client = new Client(CLIENT_INFO);
+    await client.connect(sdkTransport);
+    return { client, ownsClient: true };
+}
+async function buildTransport(transport) {
+    if (typeof transport === 'string' || transport instanceof URL) {
+        const url = transport instanceof URL ? transport : new URL(transport);
+        const { StreamableHTTPClientTransport } = await import('@modelcontextprotocol/sdk/client/streamableHttp.js');
+        return new StreamableHTTPClientTransport(url);
+    }
+    if (typeof transport === 'object' && transport !== null && 'command' in transport) {
+        const spawn = transport;
+        const { StdioClientTransport } = await import('@modelcontextprotocol/sdk/client/stdio.js');
+        return new StdioClientTransport({
+            command: spawn.command,
+            ...(spawn.args !== undefined ? { args: [...spawn.args] } : {}),
+            ...(spawn.env !== undefined ? { env: spawn.env } : {}),
+            ...(spawn.cwd !== undefined ? { cwd: spawn.cwd } : {}),
+        });
+    }
+    throw new Error(`mcpClientTools: unsupported transport shape: ${typeof transport}`);
+}
+async function safeClose(client) {
+    try {
+        await client.close();
+    }
+    catch { /* best-effort */ }
+}
+function buildTool(client, remote, namePrefix, streaming) {
+    const localName = namePrefix + remote.name;
+    const builder = dynamicTool({
+        name: localName,
+        description: remote.description ?? '',
+        inputSchema: z.unknown(), // placeholder — real shape lives in jsonSchema
+        jsonSchema: remote.inputSchema,
+    });
+    if (streaming) {
+        const built = builder.server(async function* (input, _ctx) {
+            const collected = [];
+            const result = await client.callTool({ name: remote.name, arguments: (input ?? {}) }, undefined, { onprogress: (p) => collected.push(p) });
+            // SDK delivers progress notifications synchronously into onprogress during
+            // the request lifetime, so by the time we're here all progress events have
+            // arrived. Yielding them before returning preserves the observable order
+            // (tool-update chunks land before tool-result).
+            for (const p of collected)
+                yield p;
+            return mcpContentToString(result);
+        });
+        return built;
+    }
+    const built = builder.server(async (input) => {
+        const result = await client.callTool({ name: remote.name, arguments: (input ?? {}) });
+        return mcpContentToString(result);
+    });
+    return built;
+}
+/**
+ * Flatten an MCP tool result into a string for the agent's `tool_result` slot.
+ * Text blocks concatenate; image / resource blocks become bracketed placeholders
+ * so the model knows something non-text was returned.
+ */
+function mcpContentToString(result) {
+    const parts = [];
+    for (const block of result.content) {
+        if (typeof block !== 'object' || block === null)
+            continue;
+        const b = block;
+        if (b['type'] === 'text' && typeof b['text'] === 'string') {
+            parts.push(b['text']);
+        }
+        else if (b['type'] === 'image') {
+            parts.push(`[image: ${b['mimeType'] ?? 'unknown mime'}]`);
+        }
+        else if (b['type'] === 'resource' || b['type'] === 'resource_link') {
+            const ref = b['resource'] && typeof b['resource'] === 'object'
+                ? b['resource']['uri']
+                : b['uri'];
+            parts.push(`[resource: ${ref ?? 'unknown'}]`);
+        }
+        else if (b['type']) {
+            parts.push(`[${b['type']}]`);
+        }
+    }
+    const text = parts.join('\n').trim();
+    if (result.isError)
+        return `[error] ${text || 'Tool reported an error'}`;
+    return text || '(empty result)';
+}
+//# sourceMappingURL=client-tools.js.map

package/dist/mcp/client-tools.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@rudderjs/ai/mcp` — bridge between `@rudderjs/ai` Agents and Model Context
+ * Protocol servers. Two connectors:
+ *
+ * - {@link mcpClientTools} — consume a remote MCP server's tools as Agent tools
+ * - {@link mcpServerFromAgent} — expose an Agent as an MCP server external
+ *   clients (Claude Desktop, Cursor, etc.) can call
+ *
+ * Requires `@modelcontextprotocol/sdk` at runtime — declared as an optional
+ * peer dependency. Apps that don't import this subpath aren't forced to
+ * install it.
+ */
+export { mcpClientTools } from './client-tools.js';
+export { mcpServerFromAgent } from './server-from-agent.js';
+export type { McpClientTransport, McpClientToolsOptions, McpServerFromAgentOptions, StdioServerSpawn, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,YAAY,CAAA"}

package/dist/mcp/index.js

@@ -0,0 +1,15 @@
+/**
+ * `@rudderjs/ai/mcp` — bridge between `@rudderjs/ai` Agents and Model Context
+ * Protocol servers. Two connectors:
+ *
+ * - {@link mcpClientTools} — consume a remote MCP server's tools as Agent tools
+ * - {@link mcpServerFromAgent} — expose an Agent as an MCP server external
+ *   clients (Claude Desktop, Cursor, etc.) can call
+ *
+ * Requires `@modelcontextprotocol/sdk` at runtime — declared as an optional
+ * peer dependency. Apps that don't import this subpath aren't forced to
+ * install it.
+ */
+export { mcpClientTools } from './client-tools.js';
+export { mcpServerFromAgent } from './server-from-agent.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/mcp/server-from-agent.d.ts

@@ -0,0 +1,24 @@
+import type { Agent } from '../agent.js';
+import type { McpServerFromAgentOptions } from './types.js';
+/**
+ * Wrap an `Agent` class as an MCP server. External MCP clients (Claude Desktop,
+ * Cursor, etc.) can connect to it like any other MCP server.
+ *
+ * Returns an `McpServer` from `@modelcontextprotocol/sdk` — connect it with the
+ * SDK's stdio / HTTP transports:
+ *
+ * ```ts
+ * import { mcpServerFromAgent } from '@rudderjs/ai/mcp'
+ * import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+ *
+ * const server = await mcpServerFromAgent(MyAgent)
+ * await server.connect(new StdioServerTransport())
+ * ```
+ *
+ * Three exposure modes via `opts.expose`:
+ * - `'tools'` (default) — one MCP tool per `agent.tools()` entry
+ * - `'agent'` — one MCP tool that runs the whole agent (`prompt(text) → text`)
+ * - `'both'` — expose individual tools and the agent prompt-tool side by side
+ */
+export declare function mcpServerFromAgent(AgentClass: new () => Agent, opts?: McpServerFromAgentOptions): Promise<unknown>;
+//# sourceMappingURL=server-from-agent.d.ts.map

package/dist/mcp/server-from-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-from-agent.d.ts","sourceRoot":"","sources":["../../src/mcp/server-from-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAE3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,KAAK,EAC3B,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,OAAO,CAAC,CAiClB"}

package/dist/mcp/server-from-agent.js

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+/**
+ * Wrap an `Agent` class as an MCP server. External MCP clients (Claude Desktop,
+ * Cursor, etc.) can connect to it like any other MCP server.
+ *
+ * Returns an `McpServer` from `@modelcontextprotocol/sdk` — connect it with the
+ * SDK's stdio / HTTP transports:
+ *
+ * ```ts
+ * import { mcpServerFromAgent } from '@rudderjs/ai/mcp'
+ * import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+ *
+ * const server = await mcpServerFromAgent(MyAgent)
+ * await server.connect(new StdioServerTransport())
+ * ```
+ *
+ * Three exposure modes via `opts.expose`:
+ * - `'tools'` (default) — one MCP tool per `agent.tools()` entry
+ * - `'agent'` — one MCP tool that runs the whole agent (`prompt(text) → text`)
+ * - `'both'` — expose individual tools and the agent prompt-tool side by side
+ */
+export async function mcpServerFromAgent(AgentClass, opts = {}) {
+    const expose = opts.expose ?? 'tools';
+    const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
+    const agent = new AgentClass();
+    const instructions = opts.instructions ?? safeInstructions(agent);
+    const name = opts.name ?? `${AgentClass.name}Server`;
+    const version = opts.version ?? '1.0.0';
+    const server = new McpServer({ name, version }, instructions !== undefined ? { instructions } : {});
+    if (expose === 'tools' || expose === 'both') {
+        // `tools()` is opt-in via the HasTools interface — abstract `Agent` doesn't
+        // declare it. Cast and tolerate absence gracefully (subclass without tools()
+        // returns no tools but the agent prompt-tool path still works).
+        const hasTools = agent;
+        const toolList = typeof hasTools.tools === 'function' ? hasTools.tools() : [];
+        for (const tool of toolList) {
+            registerAgentToolOnServer(server, tool);
+        }
+    }
+    if (expose === 'agent' || expose === 'both') {
+        registerAgentPromptToolOnServer(server, AgentClass, opts.agentToolName ?? AgentClass.name);
+    }
+    return server;
+}
+function registerAgentToolOnServer(server, tool) {
+    const name = tool.definition.name;
+    const description = tool.definition.description;
+    // Pass the zod schema as a single AnySchema (the SDK's `inputSchema` field
+    // accepts either a ZodRawShape record or a single zod schema). The callback
+    // then receives `input: unknown` which is what the agent tool expects too.
+    server.registerTool(name, { description, inputSchema: tool.definition.inputSchema }, async (input) => {
+        const result = await runAgentTool(tool, input);
+        return { content: [{ type: 'text', text: stringifyResult(result) }] };
+    });
+}
+function registerAgentPromptToolOnServer(server, AgentClass, toolName) {
+    const promptShape = { prompt: z.string().describe('User message for the agent') };
+    server.registerTool(toolName, {
+        description: `Run the ${AgentClass.name} agent with a prompt and return its response`,
+        inputSchema: promptShape,
+    }, async (input) => {
+        const args = (input ?? {});
+        if (typeof args.prompt !== 'string') {
+            return { content: [{ type: 'text', text: '[error] Agent prompt-tool requires { prompt: string }' }] };
+        }
+        const agent = new AgentClass();
+        const response = await agent.prompt(args.prompt);
+        return { content: [{ type: 'text', text: response.text ?? '' }] };
+    });
+}
+async function runAgentTool(tool, input) {
+    if (!tool.execute) {
+        throw new Error(`mcpServerFromAgent: tool "${tool.definition.name}" has no execute fn (client-only tool — cannot be exposed via MCP)`);
+    }
+    const out = tool.execute(input);
+    if (out instanceof Promise)
+        return await out;
+    // Generator path — drain progress yields silently and return the final value.
+    // (MCP forwards progress via `notifications/progress`; the agent loop's
+    //  tool-update chunks don't map cleanly without a progressToken from the
+    //  caller, so we drop them in v1. Future enhancement: forward progress when
+    //  the calling MCP client supplied a progressToken.)
+    const iter = out;
+    let next = await iter.next();
+    while (!next.done)
+        next = await iter.next();
+    return next.value;
+}
+function stringifyResult(result) {
+    if (typeof result === 'string')
+        return result;
+    if (result === undefined || result === null)
+        return '';
+    if (typeof result === 'object') {
+        try {
+            return JSON.stringify(result, null, 2);
+        }
+        catch {
+            return String(result);
+        }
+    }
+    return String(result);
+}
+function safeInstructions(agent) {
+    try {
+        const out = agent.instructions();
+        return typeof out === 'string' && out.length > 0 ? out : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=server-from-agent.js.map

package/dist/mcp/server-from-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-from-agent.js","sourceRoot":"","sources":["../../src/mcp/server-from-agent.ts"],"names":[],"mappings":"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"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Public types for `@rudderjs/ai/mcp`. Kept in a separate module so the
+ * client + server connectors can share them without circular imports.
+ */
+/**
+ * Configuration for spawning a local MCP server as a stdio subprocess.
+ * Mirrors `StdioServerParameters` from `@modelcontextprotocol/sdk` but is
+ * re-exported here so consumers don't need a direct SDK import for the
+ * common case.
+ */
+export interface StdioServerSpawn {
+    command: string;
+    args?: readonly string[];
+    /** Inherited from the parent process when omitted. */
+    env?: Readonly<Record<string, string>>;
+    /** Working directory for the spawned process. */
+    cwd?: string;
+}
+/**
+ * Anything `mcpClientTools()` accepts as the connection target.
+ *
+ * - `string` / `URL` — connects via the Streamable HTTP transport
+ * - `StdioServerSpawn` — spawns a subprocess and connects over stdio
+ * - existing `Client` instance — used as-is, lifecycle remains the caller's
+ *
+ * Implementation note: keeping `Client` as `unknown` here so the type union
+ * doesn't force a hard dep on `@modelcontextprotocol/sdk` at module load.
+ * The runtime code uses an instanceof check via dynamic import.
+ */
+export type McpClientTransport = string | URL | StdioServerSpawn | object;
+export interface McpClientToolsOptions {
+    /** Filter exposed tools — return `false` to drop a remote tool from the result. Defaults to all. */
+    filter?: (toolName: string) => boolean;
+    /** Prefix tool names to avoid collisions when wiring multiple remote servers. */
+    namePrefix?: string;
+    /**
+     * Forward MCP `notifications/progress` from the remote server as `tool-update`
+     * chunks during agent execution. Defaults to `true`.
+     */
+    streaming?: boolean;
+}
+export interface McpServerFromAgentOptions {
+    /** Server name advertised over MCP. Default: `${AgentClass.name}Server`. */
+    name?: string;
+    /** Server version. Default: `'1.0.0'`. */
+    version?: string;
+    /**
+     * Server instructions advertised over MCP — typically the agent's own
+     * system prompt. Default: tries `agent.instructions()`, falls back to undefined.
+     */
+    instructions?: string;
+    /**
+     * What to expose:
+     * - `'tools'` (default): one MCP tool per `agent.tools()` entry — external
+     *   MCP clients call them as if they were the server's own.
+     * - `'agent'`: one MCP tool `prompt(text: string)` that runs the whole agent
+     *   and returns the response text. Ship one agent, callable from any MCP client.
+     * - `'both'`: both of the above.
+     */
+    expose?: 'tools' | 'agent' | 'both';
+    /** Name of the synthetic prompt-tool when `expose: 'agent' | 'both'`. Default: agent class name. */
+    agentToolName?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAI,SAAS,MAAM,EAAE,CAAA;IAC1B,sDAAsD;IACtD,GAAG,CAAC,EAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACzC,iDAAiD;IACjD,GAAG,CAAC,EAAK,MAAM,CAAA;CAChB;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,GAAG,GACH,gBAAgB,GAChB,MAAM,CAAA;AAEV,MAAM,WAAW,qBAAqB;IACpC,oGAAoG;IACpG,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAA;IACtC,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;IACnC,oGAAoG;IACpG,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB"}

package/dist/mcp/types.js

@@ -0,0 +1,6 @@
+/**
+ * Public types for `@rudderjs/ai/mcp`. Kept in a separate module so the
+ * client + server connectors can share them without circular imports.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}