@rudderjs/ai 1.4.0 → 1.6.0

package/dist/handoff.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from './zod-to-json-schema.js';
+/**
+ * Symbol-tagged marker identifying a handoff tool. Looked up via
+ * `Symbol.for(...)` so cross-bundle / cross-realm checks succeed even when
+ * `@rudderjs/ai` is loaded twice (rare, but possible in monorepo + linked
+ * setups).
+ */
+export const HANDOFF_MARKER = Symbol.for('rudderjs.ai.handoff');
+const DEFAULT_INPUT_SCHEMA = z.object({
+    message: z
+        .string()
+        .describe('A short user-style prompt for the next agent describing what to do next.'),
+});
+/**
+ * Define a handoff tool — a control-transfer tool the parent agent's model
+ * can call to pivot the conversation to another agent. After the model
+ * calls it, the parent's loop ends and the child agent runs from the same
+ * message history with its own instructions, tools, and model.
+ *
+ * Distinct from {@link Agent.asTool} (which is call-and-return: the parent
+ * resumes after the child finishes and incorporates the child's text as a
+ * tool result). Handoffs do not return — the child owns the rest of the
+ * conversation.
+ *
+ * @example
+ * ```ts
+ * class TriageAgent extends Agent {
+ *   tools() {
+ *     return [
+ *       handoff(SalesAgent,    { when: 'pricing or sales questions' }),
+ *       handoff(SupportAgent,  { when: 'bug reports or technical issues' }),
+ *     ]
+ *   }
+ * }
+ * ```
+ */
+export function handoff(AgentClass, opts) {
+    const name = opts?.name ?? `handoffTo${AgentClass.name}`;
+    const description = opts?.description ?? buildDefaultDescription(AgentClass.name, opts?.when);
+    const inputSchema = (opts?.inputSchema ?? DEFAULT_INPUT_SCHEMA);
+    const spec = {
+        AgentClass: AgentClass,
+        name,
+        description,
+        inputSchema,
+    };
+    const definition = { name, description, inputSchema };
+    const tool = {
+        [HANDOFF_MARKER]: true,
+        __handoffSpec: spec,
+        definition,
+        toSchema() {
+            return {
+                name,
+                description,
+                parameters: zodToJsonSchema(inputSchema),
+            };
+        },
+    };
+    return tool;
+}
+function buildDefaultDescription(agentName, when) {
+    const base = `Hand off the conversation to ${agentName}`;
+    return when ? `${base} for ${when}.` : `${base}.`;
+}
+/**
+ * Structural typeguard. Used by the agent loop to detect handoff tools
+ * without coupling to a class hierarchy — handoff tools are plain objects
+ * tagged with the {@link HANDOFF_MARKER} symbol.
+ */
+export function isHandoffTool(t) {
+    if (t === null || typeof t !== 'object')
+        return false;
+    const marker = t[HANDOFF_MARKER];
+    return marker === true;
+}
+//# sourceMappingURL=handoff.js.map

package/dist/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAIzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkB,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;AA2D9E,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,0EAA0E,CAAC;CACxF,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,OAAO,CACrB,UAA2C,EAC3C,IAAqB;IAErB,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,YAAY,UAAU,CAAC,IAAI,EAAE,CAAA;IACxD,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,uBAAuB,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAC7F,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,oBAAoB,CAAc,CAAA;IAE5E,MAAM,IAAI,GAAgB;QACxB,UAAU,EAAE,UAA0D;QACtE,IAAI;QACJ,WAAW;QACX,WAAW;KACZ,CAAA;IACD,MAAM,UAAU,GAA0B,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,CAAA;IAE5E,MAAM,IAAI,GAAgB;QACxB,CAAC,cAAc,CAAC,EAAE,IAAI;QACtB,aAAa,EAAE,IAAI;QACnB,UAAU;QACV,QAAQ;YACN,OAAO;gBACL,IAAI;gBACJ,WAAW;gBACX,UAAU,EAAE,eAAe,CAAC,WAAW,CAAC;aACzC,CAAA;QACH,CAAC;KACF,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,uBAAuB,CAAC,SAAiB,EAAE,IAAa;IAC/D,MAAM,IAAI,GAAG,gCAAgC,SAAS,EAAE,CAAA;IACxD,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAA;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACrD,MAAM,MAAM,GAAI,CAAsC,CAAC,cAAc,CAAC,CAAA;IACtE,OAAO,MAAM,KAAK,IAAI,CAAA;AACxB,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { DocumentAttachment as Document, ImageAttachment as Image, getMessageText, attachmentsToContentParts } from './attachment.js';
-export type { AgentPromptOptions, Attachment, AiMessage, ContentPart, AiConfig, AiModelConfig, AiProviderConfig, AiMiddleware, AgentResponse, AgentStep, AgentStreamResponse, AnyTool, BeforeToolCallResult, CacheableConfig, CacheableMarkers, ClientTool, ConversationStore, ConversationStoreMeta, FinishReason, HasMiddleware, HasMemory, HasStructuredOutput, HasTools, MiddlewareConfigResult, MiddlewareContext, PrepareStepResult, ProviderAdapter, ProviderFactory, ProviderRequestOptions, ProviderResponse, ServerTool, StopCondition, Tool, StreamChunk, TokenUsage, ToolCall, ToolCallContext, ToolChoice, ToolDefinitionOptions, ToolDefinitionSchema, ToolExecuteFn, ToolNeedsApproval, ToolResult, EmbeddingAdapter, EmbeddingResult, ImageGenerationAdapter, ImageGenerationOptions, ImageGenerationResult, TextToSpeechAdapter, TextToSpeechOptions, TextToSpeechResult, SpeechToTextAdapter, SpeechToTextOptions, SpeechToTextResult, RerankingAdapter, RerankingOptions, RerankingResult, FileAdapter, FileUploadOptions, FileUploadResult, FileListResult, FileContent, } from './types.js';
+export type { AgentPromptOptions, Attachment, AiMessage, ContentPart, AiConfig, AiModelConfig, AiProviderConfig, AiMiddleware, AgentResponse, AgentStep, AgentStreamResponse, AnyTool, BeforeToolCallResult, CacheableConfig, CacheableMarkers, ClientTool, ConversationStore, ConversationStoreMeta, MemoryEntry, RemembersOverride, RemembersSpec, UserMemory, FinishReason, HasMiddleware, HasMemory, HasStructuredOutput, HasTools, MiddlewareConfigResult, MiddlewareContext, PrepareStepResult, ProviderAdapter, ProviderFactory, ProviderRequestOptions, ProviderResponse, ServerTool, StopCondition, Tool, StreamChunk, TokenUsage, ToolCall, ToolCallContext, ToolChoice, ToolDefinitionOptions, ToolDefinitionSchema, ToolExecuteFn, ToolNeedsApproval, ToolResult, EmbeddingAdapter, EmbeddingResult, ImageGenerationAdapter, ImageGenerationOptions, ImageGenerationResult, TextToSpeechAdapter, TextToSpeechOptions, TextToSpeechResult, SpeechToTextAdapter, SpeechToTextOptions, SpeechToTextResult, RerankingAdapter, RerankingOptions, RerankingResult, FileAdapter, FileUploadOptions, FileUploadResult, FileListResult, FileContent, SubAgentUpdate, } from './types.js';
 export { AiRegistry } from './registry.js';
 export { AnthropicProvider, type AnthropicConfig } from './providers/anthropic.js';
 export { OpenAIProvider, OpenAIAdapter, type OpenAIConfig } from './providers/openai.js';
@@ -12,16 +12,28 @@ export { MistralProvider, type MistralConfig } from './providers/mistral.js';
 export { AzureOpenAIProvider, type AzureOpenAIConfig } from './providers/azure.js';
 export { CohereProvider, type CohereConfig } from './providers/cohere.js';
 export { JinaProvider, type JinaConfig } from './providers/jina.js';
-export { toolDefinition, dynamicTool, ToolBuilder, toolToSchema, pauseForClientTools, isPauseForClientToolsChunk, } from './tool.js';
-export type { PauseForClientToolsChunk } from './tool.js';
+export { ElevenLabsProvider, type ElevenLabsConfig, DEFAULT_TTS_MODEL_ID, DEFAULT_VOICE_ID } from './providers/elevenlabs.js';
+export { VoyageProvider, type VoyageConfig, type VoyageEmbedExtras } from './providers/voyage.js';
+export { OpenRouterProvider, type OpenRouterConfig } from './providers/openrouter.js';
+export { BedrockProvider, type BedrockConfig } from './providers/bedrock.js';
+export { toolDefinition, dynamicTool, ToolBuilder, toolToSchema, pauseForClientTools, isPauseForClientToolsChunk, pauseForApproval, isPauseForApprovalChunk, } from './tool.js';
+export type { PauseForClientToolsChunk, PauseForApprovalChunk } from './tool.js';
 export { zodToJsonSchema } from './zod-to-json-schema.js';
-export { Agent, ConversableAgent, agent, stepCountIs, hasToolCall, setConversationStore } from './agent.js';
+export { handoff, isHandoffTool } from './handoff.js';
+export type { HandoffTool, HandoffOptions, HandoffSpec } from './handoff.js';
+export { Agent, ConversableAgent, agent, stepCountIs, hasToolCall, setConversationStore, setUserMemory, resolveUserMemory } from './agent.js';
 export type { InvalidToolArgumentsError } from './agent.js';
 export { QueuedPromptBuilder } from './queue-job.js';
 export { runOnConfig, runOnChunk, runOnBeforeToolCall, runOnAfterToolCall, runSequential, runOnUsage, runOnAbort, runOnError } from './middleware.js';
 export { Output, type OutputWrapper } from './output.js';
 export { MemoryConversationStore } from './conversation.js';
-export { InMemorySubAgentRunStore, CachedSubAgentRunStore, type SubAgentRunStore, type SubAgentRunSnapshot, type CachedSubAgentRunStoreOptions, } from './sub-agent-run-store.js';
+export { MemoryUserMemory, resolveRemembersSpec } from './memory.js';
+export type { UserMemoryLookup } from './memory.js';
+export { withMemoryInject } from './memory-inject.js';
+export type { MemoryInjectOptions } from './memory-inject.js';
+export { withMemoryExtract } from './memory-extract.js';
+export type { MemoryExtractOptions } from './memory-extract.js';
+export { InMemorySubAgentRunStore, CachedSubAgentRunStore, type SubAgentRunStore, type SubAgentRunSnapshot, type SubAgentPauseKind, type CachedSubAgentRunStoreOptions, } from './sub-agent-run-store.js';
 export { AI } from './facade.js';
 export { ImageGenerator } from './image.js';
 export { AudioGenerator } from './audio.js';
@@ -30,6 +42,18 @@ export { WebSearch, WebFetch, CodeExecution } from './provider-tools.js';
 export { toVercelDataStream, toVercelResponse } from './vercel-protocol.js';
 export { Reranker } from './rerank.js';
 export { FileManager } from './files.js';
+export { VectorStores, VectorStore } from './vector-stores/index.js';
+export type { VectorStoreAdapter, VectorStoreCreateOptions, VectorStoreInfo, VectorStoreFileInfo, VectorStoreAddOptions, VectorStoreListOptions, VectorStoreList, VectorStoreFileList, } from './types.js';
+export { fileSearch, isFileSearchTool, FILE_SEARCH_MARKER, FILE_SEARCH_TOOL_NAME, normalizeWhere } from './file-search.js';
+export type { FileSearchOptions, FileSearchTool, FileSearchFilter, FileSearchWhereSugar } from './file-search.js';
 export { CachedEmbeddingAdapter } from './cached-embedding.js';
+export { similaritySearch } from './similarity-search.js';
+export type { SimilaritySearchOptions, SimilarityHit, SimilaritySearchModel, SimilaritySearchQueryBuilder, } from './similarity-search.js';
+export { ModelPricing, estimateCost, assertKnownModelPricing, UnknownModelPricingError, BudgetExceededError, } from './budget/pricing.js';
+export type { ModelPriceEntry } from './budget/pricing.js';
+export { memoryBudgetStorage, periodKey, } from './budget/storage.js';
+export type { BudgetStorage, BudgetPeriod, BudgetCheckOptions, BudgetCheckResult, } from './budget/storage.js';
+export { withBudget } from './budget/with-budget.js';
+export type { WithBudgetOptions, BudgetCaps, BudgetExceededArgs, } from './budget/with-budget.js';
 export { AiFake } from './fake.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,IAAI,QAAQ,EAAE,eAAe,IAAI,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA;AAGrI,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,WAAW,EACX,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,OAAO,EACP,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,IAAI,EACJ,WAAW,EACX,UAAU,EACV,QAAQ,EACR,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG1C,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAClF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAClF,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAGnE,OAAO,EACL,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAGzD,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAC3G,YAAY,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAGpD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGrJ,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAGxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAG3D,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,GACnC,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAGhC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGxE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAG3E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAG9D,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,IAAI,QAAQ,EAAE,eAAe,IAAI,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA;AAGrI,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,WAAW,EACX,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,OAAO,EACP,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,IAAI,EACJ,WAAW,EACX,UAAU,EACV,QAAQ,EACR,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG1C,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAClF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAClF,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC7H,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACjG,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACrF,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAG5E,OAAO,EACL,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAGzD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACrD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG5E,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC7I,YAAY,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAGpD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGrJ,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAGxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAG3D,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAG/D,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,6BAA6B,GACnC,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAGhC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGxE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAG3E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACpE,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC1H,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAGjH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,YAAY,EACV,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EACL,mBAAmB,EACnB,SAAS,GACV,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,kBAAkB,GACnB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -15,11 +15,17 @@ 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
-export { toolDefinition, dynamicTool, ToolBuilder, toolToSchema, pauseForClientTools, isPauseForClientToolsChunk, } from './tool.js';
+export { toolDefinition, dynamicTool, ToolBuilder, toolToSchema, pauseForClientTools, isPauseForClientToolsChunk, pauseForApproval, isPauseForApprovalChunk, } from './tool.js';
 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';
@@ -27,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
@@ -44,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":"AAAA,2BAA2B;AAE3B,cAAc;AACd,OAAO,EAAE,kBAAkB,IAAI,QAAQ,EAAE,eAAe,IAAI,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA;AAoErI,WAAW;AACX,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAwB,MAAM,0BAA0B,CAAA;AAClF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAqB,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAE,cAAc,EAAqB,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,cAAc,EAAqB,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,yBAAyB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAkB,MAAM,oBAAoB,CAAA;AAChE,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAsB,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAAE,mBAAmB,EAA0B,MAAM,sBAAsB,CAAA;AAClF,OAAO,EAAE,cAAc,EAAqB,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAA;AAEnE,QAAQ;AACR,OAAO,EACL,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAE3G,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEpD,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAErJ,oBAAoB;AACpB,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAA;AAExD,eAAe;AACf,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,mDAAmD;AACnD,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GAIvB,MAAM,0BAA0B,CAAA;AAEjC,SAAS;AACT,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAEhC,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,iBAAiB;AACjB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExE,qBAAqB;AACrB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE3E,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,UAAU;AACV,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA"}
+{"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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"}