@tambo-ai/client 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fractal Dynamics Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,100 @@
+# @tambo-ai/client
+
+Framework-agnostic client for [Tambo AI](https://tambo.co). Provides streaming, tool execution, and thread management without React dependencies.
+
+## Installation
+
+```sh
+npm install @tambo-ai/client
+```
+
+## Quick Start
+
+```ts
+import { TamboClient } from "@tambo-ai/client";
+
+const client = new TamboClient({ apiKey: "your-api-key" });
+
+// Send a message and await the final thread state
+const stream = client.run("Hello!");
+const thread = await stream.thread;
+console.log(thread.messages);
+```
+
+## Usage
+
+### Streaming with async iteration
+
+```ts
+const stream = client.run("What is 2 + 2?");
+
+for await (const { event, snapshot } of stream) {
+  console.log(event.type, snapshot.messages.length);
+}
+```
+
+### Thread management
+
+```ts
+// Start a new thread
+const threadId = client.startNewThread();
+
+// Switch to an existing thread
+await client.switchThread("thread_abc123");
+
+// List all threads
+const threads = await client.listThreads();
+```
+
+### Tool registration
+
+```ts
+client.registerTool({
+  name: "get_weather",
+  description: "Get the current weather for a location",
+  tool: async ({ location }) => {
+    return { temp: 72, condition: "sunny" };
+  },
+  inputSchema: {
+    type: "object",
+    properties: {
+      location: { type: "string" },
+    },
+    required: ["location"],
+  },
+});
+```
+
+### React integration
+
+For React applications, use `@tambo-ai/react` which wraps this package with hooks and providers:
+
+```sh
+npm install @tambo-ai/react
+```
+
+See [@tambo-ai/react](https://tambo.co/docs) for React-specific documentation.
+
+## API
+
+### `TamboClient`
+
+The main client class. Implements `getState()` and `subscribe()` for use with `useSyncExternalStore` or similar framework bindings.
+
+### `TamboStream`
+
+Returned by `client.run()`. Two consumption modes:
+
+- **Async iteration**: `for await (const { event, snapshot } of stream) { ... }`
+- **Promise**: `const thread = await stream.thread`
+
+### Key types
+
+- `TamboThread` - Thread state with messages, status, and metadata
+- `StreamEvent` - Event/snapshot pair yielded during streaming
+- `TamboClientOptions` - Configuration for client creation
+- `ClientState` - Full client state (thread map, current thread, streaming state)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `@tambo-ai/client` - Framework-agnostic client for Tambo AI
+ *
+ * Provides streaming, tool execution, and thread management
+ * without React dependencies.
+ * @packageDocumentation
+ */
+/** Client version constant. */
+export declare const CLIENT_VERSION = "1.0.0";
+export { TamboClient } from "./tambo-client";
+export type { TamboClientOptions, RunOptions, ClientState, BeforeRunContext, ContextHelperFn, } from "./tambo-client";
+export { TamboStream } from "./tambo-stream";
+export type { StreamEvent, TamboStreamOptions } from "./tambo-stream";
+export { createRunStream, dispatchUserMessage, dispatchToolResults, executeToolsAndContinue, } from "./utils/send-message";
+export type { SendMessageOptions, CreateRunStreamParams, CreateRunStreamResult, ExecuteToolsParams, ExecuteToolsResult, RunStream, CreateStream, } from "./utils/send-message";
+export type { TamboThread, StreamingState, RunStatus } from "./types/thread";
+export type { TamboThreadMessage, TamboComponentContent, TamboToolUseContent, TamboToolDisplayProps, Content, MessageRole, ComponentStreamingState, InitialInputMessage, } from "./types/message";
+export type { ComponentStartEvent, ComponentPropsDeltaEvent, ComponentStateDeltaEvent, ComponentEndEvent, RunAwaitingInputEvent, MessageParentEvent, TamboCustomEvent, PendingToolCall as PendingToolCallEvent, } from "./types/event";
+export { isTamboCustomEvent, asTamboCustomEvent } from "./types/event";
+export type { TamboAuthState } from "./types/auth";
+export type { ToolChoice } from "./types/tool-choice";
+export type { TextContent, ToolResultContent, ResourceContent, InputMessage, MessageListResponse, MessageGetResponse, } from "./types/message";
+export type { ThreadCreateResponse, ThreadRetrieveResponse, ThreadListResponse, } from "./types/thread";
+export type { SupportedSchema, ToolAnnotations, ParameterSpec, ComponentContextToolMetadata, ComponentContextTool, RegisteredComponent, ComponentRegistry, TamboToolRegistry, JSONSchemaLite, TamboTool, TamboToolJSONSchema, TamboToolUnknown, TamboToolStandardSchema, UnsupportedSchemaTamboTool, TamboToolAssociations, TamboComponent, RegisterToolsFn, RegisterToolFn, DefineToolFn, } from "./model/component-metadata";
+export type { McpServerInfo, NormalizedMcpServerInfo, } from "./model/mcp-server-info";
+export { MCPTransport, getMcpServerUniqueKey } from "./model/mcp-server-info";
+export { looksLikeJSONSchema, makeJsonSchemaPartial, getParametersFromToolSchema, safeSchemaToJsonSchema, schemaToJsonSchema, isStandardSchema, assertNoRecordSchema, } from "./schema/index";
+export { MCPClient, ServerType, REGISTRY_SERVER_KEY, toElicitationRequestedSchema, hasRequestedSchema, } from "./mcp/index";
+export type { MCPToolCallResult, MCPToolSpec, MCPElicitationHandler, MCPSamplingHandler, MCPHandlers, ElicitationRequestedSchema, TamboElicitationRequest, TamboElicitationResponse, ElicitationContextState, PrimitiveSchemaDefinition, } from "./mcp/index";
+export { streamReducer, createInitialState, createInitialStateWithMessages, createInitialThreadState, isPlaceholderThreadId, PLACEHOLDER_THREAD_ID, UnreachableCaseError, } from "./utils/event-accumulator";
+export type { ThreadState, StreamState, StreamAction, EventAction, InitThreadAction, SetCurrentThreadAction, StartNewThreadAction, LoadThreadMessagesAction, SetLastCompletedRunIdAction, UpdateThreadNameAction, } from "./utils/event-accumulator";
+export { executeStreamableToolCall, createThrottledStreamableExecutor, executeClientTool, executeAllPendingTools, } from "./utils/tool-executor";
+export type { PendingToolCall } from "./utils/tool-executor";
+export { ToolCallTracker } from "./utils/tool-call-tracker";
+export { handleEventStream } from "./utils/stream-handler";
+export type { StreamHandlerOptions } from "./utils/stream-handler";
+export { findComponentContent } from "./utils/thread-utils";
+export { createKeyedThrottle } from "./utils/keyed-throttle";
+export type { KeyedThrottle } from "./utils/keyed-throttle";
+export { applyJsonPatch } from "./utils/json-patch";
+export { unstrictifyToolCallParamsFromSchema, canBeNull, } from "./utils/unstrictify";
+export { toAvailableComponent, toAvailableComponents, toAvailableTool, toAvailableTools, } from "./utils/registry-conversion";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+BAA+B;AAC/B,eAAO,MAAM,cAAc,UAAU,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGtE,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,YAAY,GACb,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7E,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,OAAO,EACP,WAAW,EACX,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,IAAI,oBAAoB,GACxC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,4BAA4B,EAC5B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,aAAa,EACb,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAG9E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,EACX,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,8BAA8B,EAC9B,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,yBAAyB,EACzB,iCAAiC,EACjC,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,mCAAmC,EACnC,SAAS,GACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GACjB,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * `@tambo-ai/client` - Framework-agnostic client for Tambo AI
+ *
+ * Provides streaming, tool execution, and thread management
+ * without React dependencies.
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toAvailableTools = exports.toAvailableTool = exports.toAvailableComponents = exports.toAvailableComponent = exports.canBeNull = exports.unstrictifyToolCallParamsFromSchema = exports.applyJsonPatch = exports.createKeyedThrottle = exports.findComponentContent = exports.handleEventStream = exports.ToolCallTracker = exports.executeAllPendingTools = exports.executeClientTool = exports.createThrottledStreamableExecutor = exports.executeStreamableToolCall = exports.UnreachableCaseError = exports.PLACEHOLDER_THREAD_ID = exports.isPlaceholderThreadId = exports.createInitialThreadState = exports.createInitialStateWithMessages = exports.createInitialState = exports.streamReducer = exports.hasRequestedSchema = exports.toElicitationRequestedSchema = exports.REGISTRY_SERVER_KEY = exports.ServerType = exports.MCPClient = exports.assertNoRecordSchema = exports.isStandardSchema = exports.schemaToJsonSchema = exports.safeSchemaToJsonSchema = exports.getParametersFromToolSchema = exports.makeJsonSchemaPartial = exports.looksLikeJSONSchema = exports.getMcpServerUniqueKey = exports.MCPTransport = exports.asTamboCustomEvent = exports.isTamboCustomEvent = exports.executeToolsAndContinue = exports.dispatchToolResults = exports.dispatchUserMessage = exports.createRunStream = exports.TamboStream = exports.TamboClient = exports.CLIENT_VERSION = void 0;
+/** Client version constant. */
+exports.CLIENT_VERSION = "1.0.0";
+// -- Core classes --
+var tambo_client_1 = require("./tambo-client");
+Object.defineProperty(exports, "TamboClient", { enumerable: true, get: function () { return tambo_client_1.TamboClient; } });
+var tambo_stream_1 = require("./tambo-stream");
+Object.defineProperty(exports, "TamboStream", { enumerable: true, get: function () { return tambo_stream_1.TamboStream; } });
+// -- Send message utilities --
+var send_message_1 = require("./utils/send-message");
+Object.defineProperty(exports, "createRunStream", { enumerable: true, get: function () { return send_message_1.createRunStream; } });
+Object.defineProperty(exports, "dispatchUserMessage", { enumerable: true, get: function () { return send_message_1.dispatchUserMessage; } });
+Object.defineProperty(exports, "dispatchToolResults", { enumerable: true, get: function () { return send_message_1.dispatchToolResults; } });
+Object.defineProperty(exports, "executeToolsAndContinue", { enumerable: true, get: function () { return send_message_1.executeToolsAndContinue; } });
+var event_1 = require("./types/event");
+Object.defineProperty(exports, "isTamboCustomEvent", { enumerable: true, get: function () { return event_1.isTamboCustomEvent; } });
+Object.defineProperty(exports, "asTamboCustomEvent", { enumerable: true, get: function () { return event_1.asTamboCustomEvent; } });
+var mcp_server_info_1 = require("./model/mcp-server-info");
+Object.defineProperty(exports, "MCPTransport", { enumerable: true, get: function () { return mcp_server_info_1.MCPTransport; } });
+Object.defineProperty(exports, "getMcpServerUniqueKey", { enumerable: true, get: function () { return mcp_server_info_1.getMcpServerUniqueKey; } });
+// -- Schema --
+var index_1 = require("./schema/index");
+Object.defineProperty(exports, "looksLikeJSONSchema", { enumerable: true, get: function () { return index_1.looksLikeJSONSchema; } });
+Object.defineProperty(exports, "makeJsonSchemaPartial", { enumerable: true, get: function () { return index_1.makeJsonSchemaPartial; } });
+Object.defineProperty(exports, "getParametersFromToolSchema", { enumerable: true, get: function () { return index_1.getParametersFromToolSchema; } });
+Object.defineProperty(exports, "safeSchemaToJsonSchema", { enumerable: true, get: function () { return index_1.safeSchemaToJsonSchema; } });
+Object.defineProperty(exports, "schemaToJsonSchema", { enumerable: true, get: function () { return index_1.schemaToJsonSchema; } });
+Object.defineProperty(exports, "isStandardSchema", { enumerable: true, get: function () { return index_1.isStandardSchema; } });
+Object.defineProperty(exports, "assertNoRecordSchema", { enumerable: true, get: function () { return index_1.assertNoRecordSchema; } });
+// -- MCP --
+var index_2 = require("./mcp/index");
+Object.defineProperty(exports, "MCPClient", { enumerable: true, get: function () { return index_2.MCPClient; } });
+Object.defineProperty(exports, "ServerType", { enumerable: true, get: function () { return index_2.ServerType; } });
+Object.defineProperty(exports, "REGISTRY_SERVER_KEY", { enumerable: true, get: function () { return index_2.REGISTRY_SERVER_KEY; } });
+Object.defineProperty(exports, "toElicitationRequestedSchema", { enumerable: true, get: function () { return index_2.toElicitationRequestedSchema; } });
+Object.defineProperty(exports, "hasRequestedSchema", { enumerable: true, get: function () { return index_2.hasRequestedSchema; } });
+// -- Utils --
+var event_accumulator_1 = require("./utils/event-accumulator");
+Object.defineProperty(exports, "streamReducer", { enumerable: true, get: function () { return event_accumulator_1.streamReducer; } });
+Object.defineProperty(exports, "createInitialState", { enumerable: true, get: function () { return event_accumulator_1.createInitialState; } });
+Object.defineProperty(exports, "createInitialStateWithMessages", { enumerable: true, get: function () { return event_accumulator_1.createInitialStateWithMessages; } });
+Object.defineProperty(exports, "createInitialThreadState", { enumerable: true, get: function () { return event_accumulator_1.createInitialThreadState; } });
+Object.defineProperty(exports, "isPlaceholderThreadId", { enumerable: true, get: function () { return event_accumulator_1.isPlaceholderThreadId; } });
+Object.defineProperty(exports, "PLACEHOLDER_THREAD_ID", { enumerable: true, get: function () { return event_accumulator_1.PLACEHOLDER_THREAD_ID; } });
+Object.defineProperty(exports, "UnreachableCaseError", { enumerable: true, get: function () { return event_accumulator_1.UnreachableCaseError; } });
+var tool_executor_1 = require("./utils/tool-executor");
+Object.defineProperty(exports, "executeStreamableToolCall", { enumerable: true, get: function () { return tool_executor_1.executeStreamableToolCall; } });
+Object.defineProperty(exports, "createThrottledStreamableExecutor", { enumerable: true, get: function () { return tool_executor_1.createThrottledStreamableExecutor; } });
+Object.defineProperty(exports, "executeClientTool", { enumerable: true, get: function () { return tool_executor_1.executeClientTool; } });
+Object.defineProperty(exports, "executeAllPendingTools", { enumerable: true, get: function () { return tool_executor_1.executeAllPendingTools; } });
+var tool_call_tracker_1 = require("./utils/tool-call-tracker");
+Object.defineProperty(exports, "ToolCallTracker", { enumerable: true, get: function () { return tool_call_tracker_1.ToolCallTracker; } });
+var stream_handler_1 = require("./utils/stream-handler");
+Object.defineProperty(exports, "handleEventStream", { enumerable: true, get: function () { return stream_handler_1.handleEventStream; } });
+var thread_utils_1 = require("./utils/thread-utils");
+Object.defineProperty(exports, "findComponentContent", { enumerable: true, get: function () { return thread_utils_1.findComponentContent; } });
+var keyed_throttle_1 = require("./utils/keyed-throttle");
+Object.defineProperty(exports, "createKeyedThrottle", { enumerable: true, get: function () { return keyed_throttle_1.createKeyedThrottle; } });
+var json_patch_1 = require("./utils/json-patch");
+Object.defineProperty(exports, "applyJsonPatch", { enumerable: true, get: function () { return json_patch_1.applyJsonPatch; } });
+var unstrictify_1 = require("./utils/unstrictify");
+Object.defineProperty(exports, "unstrictifyToolCallParamsFromSchema", { enumerable: true, get: function () { return unstrictify_1.unstrictifyToolCallParamsFromSchema; } });
+Object.defineProperty(exports, "canBeNull", { enumerable: true, get: function () { return unstrictify_1.canBeNull; } });
+var registry_conversion_1 = require("./utils/registry-conversion");
+Object.defineProperty(exports, "toAvailableComponent", { enumerable: true, get: function () { return registry_conversion_1.toAvailableComponent; } });
+Object.defineProperty(exports, "toAvailableComponents", { enumerable: true, get: function () { return registry_conversion_1.toAvailableComponents; } });
+Object.defineProperty(exports, "toAvailableTool", { enumerable: true, get: function () { return registry_conversion_1.toAvailableTool; } });
+Object.defineProperty(exports, "toAvailableTools", { enumerable: true, get: function () { return registry_conversion_1.toAvailableTools; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,+BAA+B;AAClB,QAAA,cAAc,GAAG,OAAO,CAAC;AAEtC,qBAAqB;AACrB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAQpB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAGpB,+BAA+B;AAC/B,qDAK8B;AAJ5B,+GAAA,eAAe,OAAA;AACf,mHAAA,mBAAmB,OAAA;AACnB,mHAAA,mBAAmB,OAAA;AACnB,uHAAA,uBAAuB,OAAA;AAkCzB,uCAAuE;AAA9D,2GAAA,kBAAkB,OAAA;AAAE,2GAAA,kBAAkB,OAAA;AA6C/C,2DAA8E;AAArE,+GAAA,YAAY,OAAA;AAAE,wHAAA,qBAAqB,OAAA;AAE5C,eAAe;AACf,wCAQwB;AAPtB,4GAAA,mBAAmB,OAAA;AACnB,8GAAA,qBAAqB,OAAA;AACrB,oHAAA,2BAA2B,OAAA;AAC3B,+GAAA,sBAAsB,OAAA;AACtB,2GAAA,kBAAkB,OAAA;AAClB,yGAAA,gBAAgB,OAAA;AAChB,6GAAA,oBAAoB,OAAA;AAGtB,YAAY;AACZ,qCAMqB;AALnB,kGAAA,SAAS,OAAA;AACT,mGAAA,UAAU,OAAA;AACV,4GAAA,mBAAmB,OAAA;AACnB,qHAAA,4BAA4B,OAAA;AAC5B,2GAAA,kBAAkB,OAAA;AAepB,cAAc;AACd,+DAQmC;AAPjC,kHAAA,aAAa,OAAA;AACb,uHAAA,kBAAkB,OAAA;AAClB,mIAAA,8BAA8B,OAAA;AAC9B,6HAAA,wBAAwB,OAAA;AACxB,0HAAA,qBAAqB,OAAA;AACrB,0HAAA,qBAAqB,OAAA;AACrB,yHAAA,oBAAoB,OAAA;AAetB,uDAK+B;AAJ7B,0HAAA,yBAAyB,OAAA;AACzB,kIAAA,iCAAiC,OAAA;AACjC,kHAAA,iBAAiB,OAAA;AACjB,uHAAA,sBAAsB,OAAA;AAIxB,+DAA4D;AAAnD,oHAAA,eAAe,OAAA;AACxB,yDAA2D;AAAlD,mHAAA,iBAAiB,OAAA;AAE1B,qDAA4D;AAAnD,oHAAA,oBAAoB,OAAA;AAC7B,yDAA6D;AAApD,qHAAA,mBAAmB,OAAA;AAE5B,iDAAoD;AAA3C,4GAAA,cAAc,OAAA;AACvB,mDAG6B;AAF3B,kIAAA,mCAAmC,OAAA;AACnC,wGAAA,SAAS,OAAA;AAEX,mEAKqC;AAJnC,2HAAA,oBAAoB,OAAA;AACpB,4HAAA,qBAAqB,OAAA;AACrB,sHAAA,eAAe,OAAA;AACf,uHAAA,gBAAgB,OAAA","sourcesContent":["/**\n * `@tambo-ai/client` - Framework-agnostic client for Tambo AI\n *\n * Provides streaming, tool execution, and thread management\n * without React dependencies.\n * @packageDocumentation\n */\n\n/** Client version constant. */\nexport const CLIENT_VERSION = \"1.0.0\";\n\n// -- Core classes --\nexport { TamboClient } from \"./tambo-client\";\nexport type {\n  TamboClientOptions,\n  RunOptions,\n  ClientState,\n  BeforeRunContext,\n  ContextHelperFn,\n} from \"./tambo-client\";\nexport { TamboStream } from \"./tambo-stream\";\nexport type { StreamEvent, TamboStreamOptions } from \"./tambo-stream\";\n\n// -- Send message utilities --\nexport {\n  createRunStream,\n  dispatchUserMessage,\n  dispatchToolResults,\n  executeToolsAndContinue,\n} from \"./utils/send-message\";\nexport type {\n  SendMessageOptions,\n  CreateRunStreamParams,\n  CreateRunStreamResult,\n  ExecuteToolsParams,\n  ExecuteToolsResult,\n  RunStream,\n  CreateStream,\n} from \"./utils/send-message\";\n\n// -- Types --\nexport type { TamboThread, StreamingState, RunStatus } from \"./types/thread\";\nexport type {\n  TamboThreadMessage,\n  TamboComponentContent,\n  TamboToolUseContent,\n  TamboToolDisplayProps,\n  Content,\n  MessageRole,\n  ComponentStreamingState,\n  InitialInputMessage,\n} from \"./types/message\";\nexport type {\n  ComponentStartEvent,\n  ComponentPropsDeltaEvent,\n  ComponentStateDeltaEvent,\n  ComponentEndEvent,\n  RunAwaitingInputEvent,\n  MessageParentEvent,\n  TamboCustomEvent,\n  PendingToolCall as PendingToolCallEvent,\n} from \"./types/event\";\nexport { isTamboCustomEvent, asTamboCustomEvent } from \"./types/event\";\nexport type { TamboAuthState } from \"./types/auth\";\nexport type { ToolChoice } from \"./types/tool-choice\";\n\n// Re-export SDK types that are part of the public API\nexport type {\n  TextContent,\n  ToolResultContent,\n  ResourceContent,\n  InputMessage,\n  MessageListResponse,\n  MessageGetResponse,\n} from \"./types/message\";\nexport type {\n  ThreadCreateResponse,\n  ThreadRetrieveResponse,\n  ThreadListResponse,\n} from \"./types/thread\";\n\n// -- Model --\nexport type {\n  SupportedSchema,\n  ToolAnnotations,\n  ParameterSpec,\n  ComponentContextToolMetadata,\n  ComponentContextTool,\n  RegisteredComponent,\n  ComponentRegistry,\n  TamboToolRegistry,\n  JSONSchemaLite,\n  TamboTool,\n  TamboToolJSONSchema,\n  TamboToolUnknown,\n  TamboToolStandardSchema,\n  UnsupportedSchemaTamboTool,\n  TamboToolAssociations,\n  TamboComponent,\n  RegisterToolsFn,\n  RegisterToolFn,\n  DefineToolFn,\n} from \"./model/component-metadata\";\nexport type {\n  McpServerInfo,\n  NormalizedMcpServerInfo,\n} from \"./model/mcp-server-info\";\nexport { MCPTransport, getMcpServerUniqueKey } from \"./model/mcp-server-info\";\n\n// -- Schema --\nexport {\n  looksLikeJSONSchema,\n  makeJsonSchemaPartial,\n  getParametersFromToolSchema,\n  safeSchemaToJsonSchema,\n  schemaToJsonSchema,\n  isStandardSchema,\n  assertNoRecordSchema,\n} from \"./schema/index\";\n\n// -- MCP --\nexport {\n  MCPClient,\n  ServerType,\n  REGISTRY_SERVER_KEY,\n  toElicitationRequestedSchema,\n  hasRequestedSchema,\n} from \"./mcp/index\";\nexport type {\n  MCPToolCallResult,\n  MCPToolSpec,\n  MCPElicitationHandler,\n  MCPSamplingHandler,\n  MCPHandlers,\n  ElicitationRequestedSchema,\n  TamboElicitationRequest,\n  TamboElicitationResponse,\n  ElicitationContextState,\n  PrimitiveSchemaDefinition,\n} from \"./mcp/index\";\n\n// -- Utils --\nexport {\n  streamReducer,\n  createInitialState,\n  createInitialStateWithMessages,\n  createInitialThreadState,\n  isPlaceholderThreadId,\n  PLACEHOLDER_THREAD_ID,\n  UnreachableCaseError,\n} from \"./utils/event-accumulator\";\nexport type {\n  ThreadState,\n  StreamState,\n  StreamAction,\n  EventAction,\n  InitThreadAction,\n  SetCurrentThreadAction,\n  StartNewThreadAction,\n  LoadThreadMessagesAction,\n  SetLastCompletedRunIdAction,\n  UpdateThreadNameAction,\n} from \"./utils/event-accumulator\";\n\nexport {\n  executeStreamableToolCall,\n  createThrottledStreamableExecutor,\n  executeClientTool,\n  executeAllPendingTools,\n} from \"./utils/tool-executor\";\nexport type { PendingToolCall } from \"./utils/tool-executor\";\n\nexport { ToolCallTracker } from \"./utils/tool-call-tracker\";\nexport { handleEventStream } from \"./utils/stream-handler\";\nexport type { StreamHandlerOptions } from \"./utils/stream-handler\";\nexport { findComponentContent } from \"./utils/thread-utils\";\nexport { createKeyedThrottle } from \"./utils/keyed-throttle\";\nexport type { KeyedThrottle } from \"./utils/keyed-throttle\";\nexport { applyJsonPatch } from \"./utils/json-patch\";\nexport {\n  unstrictifyToolCallParamsFromSchema,\n  canBeNull,\n} from \"./utils/unstrictify\";\nexport {\n  toAvailableComponent,\n  toAvailableComponents,\n  toAvailableTool,\n  toAvailableTools,\n} from \"./utils/registry-conversion\";\n"]}

package/dist/mcp/elicitation.d.ts

@@ -0,0 +1,59 @@
+import type { ElicitRequestFormParams, PrimitiveSchemaDefinition } from "@modelcontextprotocol/sdk/spec.types.js";
+import type { ElicitRequest } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Schema type for elicitation request fields
+ */
+export type ElicitationRequestedSchema = ElicitRequestFormParams["requestedSchema"];
+/**
+ * Elicitation request from MCP server
+ */
+export interface TamboElicitationRequest {
+    message: string;
+    requestedSchema: ElicitationRequestedSchema;
+    /** AbortSignal that fires when the server cancels the request (e.g., timeout) */
+    signal?: AbortSignal;
+}
+/**
+ * Re-export PrimitiveSchemaDefinition for consumers that need to work with schema fields
+ */
+export type { PrimitiveSchemaDefinition };
+type ElicitRequestParamsWithRequestedSchema = Extract<ElicitRequest["params"], {
+    requestedSchema: unknown;
+}>;
+/**
+ * Elicitation response to be sent back
+ */
+export interface TamboElicitationResponse {
+    action: "accept" | "decline" | "cancel";
+    content?: Record<string, unknown>;
+    [x: string]: unknown;
+}
+/**
+ * Elicitation context state - read-only interface for consumers.
+ * State management is handled internally by useElicitation hook.
+ */
+export interface ElicitationContextState {
+    /** Current elicitation request, or null if none active */
+    elicitation: TamboElicitationRequest | null;
+    /** Function to call when user responds to elicitation (clears state automatically) */
+    resolveElicitation: ((response: TamboElicitationResponse) => void) | null;
+}
+/**
+ * Narrow the runtime ElicitRequest requestedSchema into the public
+ * ElicitationRequestedSchema type.
+ *
+ * The MCP SDK guarantees that the runtime
+ * `ElicitRequest["params"]["requestedSchema"]` shape stays aligned with the
+ * spec-defined `ElicitRequestFormParams["requestedSchema"]`. This helper
+ * centralizes the cast based on that contract so that if a future SDK version
+ * ever diverges, we have a single place to tighten the implementation (for
+ * example with structural validation or normalization).
+ * @returns requestedSchema as ElicitationRequestedSchema
+ */
+export declare function toElicitationRequestedSchema(value: ElicitRequestParamsWithRequestedSchema["requestedSchema"]): ElicitationRequestedSchema;
+/**
+ * Type guard for the elicitation form params shape.
+ * @returns true when params include requestedSchema
+ */
+export declare function hasRequestedSchema(params: ElicitRequest["params"]): params is ElicitRequestParamsWithRequestedSchema;
+//# sourceMappingURL=elicitation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../../src/mcp/elicitation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,0BAA0B,GACpC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,0BAA0B,CAAC;IAC5C,iFAAiF;IACjF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAE1C,KAAK,sCAAsC,GAAG,OAAO,CACnD,aAAa,CAAC,QAAQ,CAAC,EACvB;IAAE,eAAe,EAAE,OAAO,CAAA;CAAE,CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,WAAW,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC5C,sFAAsF;IACtF,kBAAkB,EAAE,CAAC,CAAC,QAAQ,EAAE,wBAAwB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,sCAAsC,CAAC,iBAAiB,CAAC,GAC/D,0BAA0B,CAE5B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAC9B,MAAM,IAAI,sCAAsC,CAElD"}

package/dist/mcp/elicitation.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toElicitationRequestedSchema = toElicitationRequestedSchema;
+exports.hasRequestedSchema = hasRequestedSchema;
+/**
+ * Narrow the runtime ElicitRequest requestedSchema into the public
+ * ElicitationRequestedSchema type.
+ *
+ * The MCP SDK guarantees that the runtime
+ * `ElicitRequest["params"]["requestedSchema"]` shape stays aligned with the
+ * spec-defined `ElicitRequestFormParams["requestedSchema"]`. This helper
+ * centralizes the cast based on that contract so that if a future SDK version
+ * ever diverges, we have a single place to tighten the implementation (for
+ * example with structural validation or normalization).
+ * @returns requestedSchema as ElicitationRequestedSchema
+ */
+function toElicitationRequestedSchema(value) {
+    return value;
+}
+/**
+ * Type guard for the elicitation form params shape.
+ * @returns true when params include requestedSchema
+ */
+function hasRequestedSchema(params) {
+    return "requestedSchema" in params;
+}
+//# sourceMappingURL=elicitation.js.map

package/dist/mcp/elicitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.js","sourceRoot":"","sources":["../../src/mcp/elicitation.ts"],"names":[],"mappings":";;AAgEA,oEAIC;AAMD,gDAIC;AA1BD;;;;;;;;;;;GAWG;AACH,SAAgB,4BAA4B,CAC1C,KAAgE;IAEhE,OAAO,KAAmC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAChC,MAA+B;IAE/B,OAAO,iBAAiB,IAAI,MAAM,CAAC;AACrC,CAAC","sourcesContent":["import type {\n  ElicitRequestFormParams,\n  PrimitiveSchemaDefinition,\n} from \"@modelcontextprotocol/sdk/spec.types.js\";\nimport type { ElicitRequest } from \"@modelcontextprotocol/sdk/types.js\";\n\n/**\n * Schema type for elicitation request fields\n */\nexport type ElicitationRequestedSchema =\n  ElicitRequestFormParams[\"requestedSchema\"];\n\n/**\n * Elicitation request from MCP server\n */\nexport interface TamboElicitationRequest {\n  message: string;\n  requestedSchema: ElicitationRequestedSchema;\n  /** AbortSignal that fires when the server cancels the request (e.g., timeout) */\n  signal?: AbortSignal;\n}\n\n/**\n * Re-export PrimitiveSchemaDefinition for consumers that need to work with schema fields\n */\nexport type { PrimitiveSchemaDefinition };\n\ntype ElicitRequestParamsWithRequestedSchema = Extract<\n  ElicitRequest[\"params\"],\n  { requestedSchema: unknown }\n>;\n\n/**\n * Elicitation response to be sent back\n */\nexport interface TamboElicitationResponse {\n  action: \"accept\" | \"decline\" | \"cancel\";\n  content?: Record<string, unknown>;\n  [x: string]: unknown;\n}\n\n/**\n * Elicitation context state - read-only interface for consumers.\n * State management is handled internally by useElicitation hook.\n */\nexport interface ElicitationContextState {\n  /** Current elicitation request, or null if none active */\n  elicitation: TamboElicitationRequest | null;\n  /** Function to call when user responds to elicitation (clears state automatically) */\n  resolveElicitation: ((response: TamboElicitationResponse) => void) | null;\n}\n\n/**\n * Narrow the runtime ElicitRequest requestedSchema into the public\n * ElicitationRequestedSchema type.\n *\n * The MCP SDK guarantees that the runtime\n * `ElicitRequest[\"params\"][\"requestedSchema\"]` shape stays aligned with the\n * spec-defined `ElicitRequestFormParams[\"requestedSchema\"]`. This helper\n * centralizes the cast based on that contract so that if a future SDK version\n * ever diverges, we have a single place to tighten the implementation (for\n * example with structural validation or normalization).\n * @returns requestedSchema as ElicitationRequestedSchema\n */\nexport function toElicitationRequestedSchema(\n  value: ElicitRequestParamsWithRequestedSchema[\"requestedSchema\"],\n): ElicitationRequestedSchema {\n  return value as ElicitationRequestedSchema;\n}\n\n/**\n * Type guard for the elicitation form params shape.\n * @returns true when params include requestedSchema\n */\nexport function hasRequestedSchema(\n  params: ElicitRequest[\"params\"],\n): params is ElicitRequestParamsWithRequestedSchema {\n  return \"requestedSchema\" in params;\n}\n"]}

package/dist/mcp/index.d.ts

@@ -0,0 +1,6 @@
+export { MCPClient, type MCPToolCallResult, type MCPToolSpec, type MCPElicitationHandler, type MCPSamplingHandler, type MCPHandlers, } from "./mcp-client";
+export { MCPTransport } from "./mcp-client";
+export { ServerType, REGISTRY_SERVER_KEY } from "./mcp-constants";
+export type { ElicitationRequestedSchema, TamboElicitationRequest, TamboElicitationResponse, ElicitationContextState, PrimitiveSchemaDefinition, } from "./elicitation";
+export { toElicitationRequestedSchema, hasRequestedSchema, } from "./elicitation";
+//# 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,OAAO,EACL,SAAS,EACT,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClE,YAAY,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasRequestedSchema = exports.toElicitationRequestedSchema = exports.REGISTRY_SERVER_KEY = exports.ServerType = exports.MCPTransport = exports.MCPClient = void 0;
+var mcp_client_1 = require("./mcp-client");
+Object.defineProperty(exports, "MCPClient", { enumerable: true, get: function () { return mcp_client_1.MCPClient; } });
+var mcp_client_2 = require("./mcp-client");
+Object.defineProperty(exports, "MCPTransport", { enumerable: true, get: function () { return mcp_client_2.MCPTransport; } });
+var mcp_constants_1 = require("./mcp-constants");
+Object.defineProperty(exports, "ServerType", { enumerable: true, get: function () { return mcp_constants_1.ServerType; } });
+Object.defineProperty(exports, "REGISTRY_SERVER_KEY", { enumerable: true, get: function () { return mcp_constants_1.REGISTRY_SERVER_KEY; } });
+var elicitation_1 = require("./elicitation");
+Object.defineProperty(exports, "toElicitationRequestedSchema", { enumerable: true, get: function () { return elicitation_1.toElicitationRequestedSchema; } });
+Object.defineProperty(exports, "hasRequestedSchema", { enumerable: true, get: function () { return elicitation_1.hasRequestedSchema; } });
+//# 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,2CAOsB;AANpB,uGAAA,SAAS,OAAA;AAOX,2CAA4C;AAAnC,0GAAA,YAAY,OAAA;AACrB,iDAAkE;AAAzD,2GAAA,UAAU,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAQxC,6CAGuB;AAFrB,2HAAA,4BAA4B,OAAA;AAC5B,iHAAA,kBAAkB,OAAA","sourcesContent":["export {\n  MCPClient,\n  type MCPToolCallResult,\n  type MCPToolSpec,\n  type MCPElicitationHandler,\n  type MCPSamplingHandler,\n  type MCPHandlers,\n} from \"./mcp-client\";\nexport { MCPTransport } from \"./mcp-client\";\nexport { ServerType, REGISTRY_SERVER_KEY } from \"./mcp-constants\";\nexport type {\n  ElicitationRequestedSchema,\n  TamboElicitationRequest,\n  TamboElicitationResponse,\n  ElicitationContextState,\n  PrimitiveSchemaDefinition,\n} from \"./elicitation\";\nexport {\n  toElicitationRequestedSchema,\n  hasRequestedSchema,\n} from \"./elicitation\";\n"]}

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

@@ -0,0 +1,185 @@
+import { type OAuthClientProvider } from "@modelcontextprotocol/sdk/client/auth.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { ClientNotification, ClientRequest, CreateMessageRequest, CreateMessageResult, ElicitRequest, ElicitResult } from "@modelcontextprotocol/sdk/types.js";
+import { JSONSchema7 } from "json-schema";
+import { MCPTransport } from "../model/mcp-server-info";
+export { MCPTransport };
+/**
+ * Handler for MCP elicitation requests.
+ * Receives the elicit request and a RequestHandlerExtra containing an AbortSignal that fires when the request is cancelled.
+ * @param request - The elicitation request from the server
+ * @param extra - Additional context including AbortSignal for cancellation
+ * @returns Promise resolving to the elicitation result
+ * @example
+ * ```typescript
+ * const handler: MCPElicitationHandler = async (request, extra) => {
+ *   // Listen for cancellation
+ *   extra.signal.addEventListener('abort', () => {
+ *     console.log('Request cancelled');
+ *   });
+ *
+ *   // Return user's response
+ *   return {
+ *     action: 'accept',
+ *     content: { name: 'John' }
+ *   };
+ * };
+ * ```
+ */
+export type MCPElicitationHandler = (e: ElicitRequest, extra: RequestHandlerExtra<ClientRequest, ClientNotification>) => Promise<ElicitResult>;
+/**
+ * Handler for MCP sampling requests (create_message).
+ * Receives the sampling request and a RequestHandlerExtra containing an AbortSignal that fires when the request is cancelled.
+ * @param request - The sampling/create_message request from the server
+ * @param extra - Additional context including AbortSignal for cancellation
+ * @returns Promise resolving to the sampling result
+ */
+export type MCPSamplingHandler = (e: CreateMessageRequest, extra: RequestHandlerExtra<ClientRequest, ClientNotification>) => Promise<CreateMessageResult>;
+/**
+ * Handlers for MCP requests - these are only used if the server supports the corresponding capabilities
+ * @param elicitation - Handler for elicitation requests (receives request and RequestHandlerExtra with AbortSignal)
+ * @param sampling - Handler for sampling requests (receives request and RequestHandlerExtra with AbortSignal)
+ * @example
+ * ```typescript
+ * const mcp = await MCPClient.create(
+ *     'https://api.example.com/mcp',
+ *     MCPTransport.HTTP,
+ *     {},
+ *     undefined,
+ *     undefined,
+ *     {
+ *       elicitation: (e, extra) => Promise.resolve({...}),
+ *     },
+ * );
+ * ```
+ */
+export interface MCPHandlers {
+    elicitation: MCPElicitationHandler;
+    sampling: MCPSamplingHandler;
+}
+/**
+ * A client for interacting with MCP (Model Context Protocol) servers.
+ * Provides a simple interface for listing and calling tools exposed by the server.
+ * @example
+ * ```typescript
+ * const mcp = await MCPClient.create('https://api.example.com/mcp');
+ * const tools = await mcp.listTools();
+ * const result = await mcp.callTool('toolName', { arg1: 'value1' });
+ * ```
+ */
+export declare class MCPClient {
+    /**
+     * The underlying MCP client
+     *
+     * Be careful not to mutate the client directly, use the methods provided instead.
+     */
+    client: Client;
+    private transport;
+    private transportType;
+    sessionId?: string;
+    private endpoint;
+    private headers;
+    private authProvider?;
+    private handlers;
+    /**
+     * Private constructor to enforce using the static create method.
+     * @param endpoint - The URL of the MCP server to connect to
+     * @param transportType - The transport to use for the MCP client
+     * @param headers - Optional custom headers to include in requests
+     */
+    private constructor();
+    /**
+     * Creates and initializes a new MCPClient instance. This is the recommended
+     * way to create an MCPClient as it handles both instantiation and connection
+     * setup.
+     * @param endpoint - The URL of the MCP server to connect to
+     * @param transportType - The transport type to use for the MCP client. Defaults to HTTP.
+     * @param headers - Optional custom headers to include in requests
+     * @param authProvider - Optional auth provider to use for authentication
+     * @param sessionId - Optional session id to use for the MCP client - if not
+     *   provided, a new session will be created
+     * @returns A connected MCPClient instance ready for use
+     * @throws {Error} Will throw an error if connection fails
+     */
+    static create(endpoint: string, transportType: MCPTransport | undefined, headers: Record<string, string> | undefined, authProvider: OAuthClientProvider | undefined, sessionId: string | undefined, handlers?: Partial<MCPHandlers>): Promise<MCPClient>;
+    private initializeTransport;
+    /**
+     * Initializes the MCP client with the appropriate capabilities and handlers
+     * @returns The initialized MCP client
+     */
+    private initializeClient;
+    /**
+     * Retrieves a complete list of all available tools from the MCP server.
+     * Handles pagination automatically by following cursors until all tools are fetched.
+     * @returns A complete list of all available tools and their descriptions
+     * @throws {Error} Will throw an error if any server request fails during pagination
+     */
+    listTools(): Promise<MCPToolSpec[]>;
+    getServerCapabilities(): {
+        experimental?: {
+            [x: string]: object;
+        } | undefined;
+        logging?: object | undefined;
+        completions?: object | undefined;
+        prompts?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        resources?: {
+            subscribe?: boolean | undefined;
+            listChanged?: boolean | undefined;
+        } | undefined;
+        tools?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        tasks?: {
+            [x: string]: unknown;
+            list?: object | undefined;
+            cancel?: object | undefined;
+            requests?: {
+                [x: string]: unknown;
+                tools?: {
+                    [x: string]: unknown;
+                    call?: object | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    getServerVersion(): {
+        version: string;
+        name: string;
+        websiteUrl?: string | undefined;
+        description?: string | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+            theme?: "light" | "dark" | undefined;
+        }[] | undefined;
+        title?: string | undefined;
+    } | undefined;
+    getInstructions(): string | undefined;
+    /**
+     * Calls a specific tool on the MCP server with the provided arguments.
+     * @param name - The name of the tool to call
+     * @param args - Arguments to pass to the tool, must match the tool's expected schema
+     * @returns The result from the tool execution
+     * @throws {Error} Will throw an error if the tool call fails or if arguments are invalid
+     */
+    callTool(name: string, args: Record<string, unknown>, _meta?: Record<string, unknown>): Promise<MCPToolCallResult>;
+    updateElicitationHandler(handler: MCPElicitationHandler | undefined): void;
+    updateSamplingHandler(handler: MCPSamplingHandler | undefined): void;
+    close(): Promise<void>;
+}
+/**
+ * The result of a tool call.
+ * This is the same as the result of a tool call in the OpenAI SDK, but is reified here
+ */
+export type MCPToolCallResult = Awaited<ReturnType<typeof Client.prototype.callTool>>;
+export interface MCPToolSpec {
+    name: string;
+    description?: string;
+    inputSchema?: JSONSchema7;
+    maxCalls?: number;
+}
+//# sourceMappingURL=mcp-client.d.ts.map

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

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