@tambo-ai/client 0.0.1

package/dist/utils/unstrictify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unstrictify.js","sourceRoot":"","sources":["../../src/utils/unstrictify.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Unstrictify tool call parameters using the original JSON Schema.\n *\n * When OpenAI's structured outputs mode is enabled, all optional parameters\n * become required-and-nullable. The LLM then sends `null` for parameters the\n * user didn't specify. This module reverses that transformation by comparing\n * the LLM's output against the original schema and stripping nulls for\n * parameters that were originally optional and non-nullable.\n *\n * Copied from packages/core/src/strictness/tool-call-strict.ts (minus the\n * OpenAI-specific `unstrictifyToolCallRequest` wrapper).\n */\n\nimport type { JSONSchema7, JSONSchema7Definition } from \"json-schema\";\n\n/**\n * Unstrictify the parameters of a tool call request.\n *\n * This effectively reverses the process of strictifyToolCallParams, for a\n * tool call request that was built from a strict JSON Schema, by returning a\n * updated tool call request with the parameter values unstrictified.\n * @returns The params with strictification-induced nulls stripped.\n */\nfunction unstrictifyToolCallParams(\n  originalToolParamSchema: JSONSchema7,\n  toolCallRequestParams: Record<string, unknown>,\n): Record<string, unknown> {\n  if (originalToolParamSchema.type !== \"object\") {\n    throw new Error(\n      `tool call parameter schema must be an object, instead got ${originalToolParamSchema.type} / ${typeof originalToolParamSchema}`,\n    );\n  }\n  const newParams = Object.entries(toolCallRequestParams)\n    .map(([parameterName, parameterValue]) => {\n      const isRequired =\n        originalToolParamSchema.required?.includes(parameterName);\n      // find the param in the original tool schema\n      const originalParamSchema =\n        parameterName in (originalToolParamSchema.properties ?? {})\n          ? originalToolParamSchema.properties?.[parameterName]\n          : undefined;\n\n      // This should never happen, because the strict schema was derived from\n      // the original schema, so the parameter should always be present.\n      if (!originalParamSchema) {\n        throw new Error(\n          `Tool call request parameter ${parameterName} not found in original tool`,\n        );\n      }\n\n      if (\n        parameterValue === null &&\n        !canBeNull(originalParamSchema) &&\n        !isRequired\n      ) {\n        // This is the meat of this function. In the strict schema, this is\n        // \"required and can be null\", but in the original schema, the param was\n        // not required.\n        if (\n          typeof originalParamSchema === \"object\" &&\n          \"default\" in originalParamSchema\n        ) {\n          return [parameterName, originalParamSchema.default] as const;\n        }\n        return undefined;\n      }\n\n      // recurse into arrays\n      if (\n        typeof originalParamSchema === \"object\" &&\n        originalParamSchema.type === \"array\"\n      ) {\n        const arrayValue = parameterValue as unknown[];\n        const itemSchema = originalParamSchema.items;\n        if (\n          Array.isArray(arrayValue) &&\n          itemSchema &&\n          typeof itemSchema === \"object\" &&\n          !Array.isArray(itemSchema)\n        ) {\n          const newArrayValue = arrayValue.map((item) => {\n            if (\n              itemSchema.type === \"object\" &&\n              typeof item === \"object\" &&\n              item !== null\n            ) {\n              // recurse into each object in the array\n              return unstrictifyToolCallParams(\n                itemSchema,\n                item as Record<string, unknown>,\n              );\n            }\n            return item;\n          });\n          return [parameterName, newArrayValue] as const;\n        }\n        return [parameterName, parameterValue] as const;\n      }\n\n      // recurse into the parameter value, passing along the matching original schema\n      if (\n        typeof originalParamSchema === \"object\" &&\n        originalParamSchema.type === \"object\"\n      ) {\n        // If the LLM sent a JSON string instead of an object (common with z.any() schemas),\n        // try to parse it\n        let objectValue = parameterValue;\n        if (typeof parameterValue === \"string\") {\n          try {\n            const parsed = JSON.parse(parameterValue);\n            if (typeof parsed === \"object\" && parsed !== null) {\n              objectValue = parsed;\n            }\n          } catch {\n            // Not valid JSON, keep original value\n          }\n        }\n\n        // Only recurse if we have an actual object AND the schema has properties defined.\n        // If the schema has no properties (e.g., z.any() which produces {type: 'object', anyOf: [...]}),\n        // just return the value as-is without recursing.\n        const hasProperties =\n          originalParamSchema.properties &&\n          Object.keys(originalParamSchema.properties).length > 0;\n\n        if (\n          hasProperties &&\n          typeof objectValue === \"object\" &&\n          objectValue !== null &&\n          !Array.isArray(objectValue)\n        ) {\n          const newParamValue = unstrictifyToolCallParams(\n            originalParamSchema,\n            objectValue as Record<string, unknown>,\n          );\n          return [parameterName, newParamValue] as const;\n        }\n\n        // Return the (possibly parsed) object value without recursing\n        return [parameterName, objectValue] as const;\n      }\n\n      return [parameterName, parameterValue] as const;\n    })\n    .filter((param) => param !== undefined);\n  return Object.fromEntries(newParams);\n}\n\n/**\n * Unstrictify tool call params using the original JSON Schema.\n *\n * Unlike the private `unstrictifyToolCallParams` which throws on unknown params,\n * this function separates params into schema-defined vs `_tambo_*` pass-through\n * (server-injected params not in the original schema), unstrictifies only the\n * schema-defined ones, and merges pass-through params back. Unknown keys that\n * aren't in the schema and don't have the `_tambo_` prefix are dropped.\n * @returns The params with strictification-induced nulls stripped for optional\n * non-nullable properties, and pass-through params preserved as-is.\n */\nexport function unstrictifyToolCallParamsFromSchema(\n  originalSchema: JSONSchema7,\n  params: Record<string, unknown>,\n): Record<string, unknown> {\n  if (originalSchema.type !== \"object\") {\n    return params;\n  }\n\n  const schemaProperties = originalSchema.properties ?? {};\n  const schemaDefinedParams: Record<string, unknown> = {};\n  const passThroughParams: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(params)) {\n    if (key in schemaProperties) {\n      schemaDefinedParams[key] = value;\n    } else if (key.startsWith(\"_tambo_\")) {\n      passThroughParams[key] = value;\n    }\n    // Unknown keys not in schema and not _tambo_* are dropped —\n    // they're likely hallucinated by the model.\n  }\n\n  const unstrictified = unstrictifyToolCallParams(\n    originalSchema,\n    schemaDefinedParams,\n  );\n\n  return { ...unstrictified, ...passThroughParams };\n}\n\n/**\n * Check if a JSON Schema definition allows null values.\n * @param originalSchema - The schema definition to check\n * @returns True if the schema allows null values\n */\nexport function canBeNull(originalSchema: JSONSchema7Definition): boolean {\n  if (typeof originalSchema !== \"object\") {\n    return false;\n  }\n\n  if (originalSchema.type === \"null\") {\n    return true;\n  }\n\n  if (originalSchema.anyOf?.some((anyOf) => canBeNull(anyOf))) {\n    return true;\n  }\n  return false;\n}\n"]}

package/esm/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.js";
+export type { TamboClientOptions, RunOptions, ClientState, BeforeRunContext, ContextHelperFn, } from "./tambo-client.js";
+export { TamboStream } from "./tambo-stream.js";
+export type { StreamEvent, TamboStreamOptions } from "./tambo-stream.js";
+export { createRunStream, dispatchUserMessage, dispatchToolResults, executeToolsAndContinue, } from "./utils/send-message.js";
+export type { SendMessageOptions, CreateRunStreamParams, CreateRunStreamResult, ExecuteToolsParams, ExecuteToolsResult, RunStream, CreateStream, } from "./utils/send-message.js";
+export type { TamboThread, StreamingState, RunStatus } from "./types/thread.js";
+export type { TamboThreadMessage, TamboComponentContent, TamboToolUseContent, TamboToolDisplayProps, Content, MessageRole, ComponentStreamingState, InitialInputMessage, } from "./types/message.js";
+export type { ComponentStartEvent, ComponentPropsDeltaEvent, ComponentStateDeltaEvent, ComponentEndEvent, RunAwaitingInputEvent, MessageParentEvent, TamboCustomEvent, PendingToolCall as PendingToolCallEvent, } from "./types/event.js";
+export { isTamboCustomEvent, asTamboCustomEvent } from "./types/event.js";
+export type { TamboAuthState } from "./types/auth.js";
+export type { ToolChoice } from "./types/tool-choice.js";
+export type { TextContent, ToolResultContent, ResourceContent, InputMessage, MessageListResponse, MessageGetResponse, } from "./types/message.js";
+export type { ThreadCreateResponse, ThreadRetrieveResponse, ThreadListResponse, } from "./types/thread.js";
+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.js";
+export type { McpServerInfo, NormalizedMcpServerInfo, } from "./model/mcp-server-info.js";
+export { MCPTransport, getMcpServerUniqueKey } from "./model/mcp-server-info.js";
+export { looksLikeJSONSchema, makeJsonSchemaPartial, getParametersFromToolSchema, safeSchemaToJsonSchema, schemaToJsonSchema, isStandardSchema, assertNoRecordSchema, } from "./schema/index.js";
+export { MCPClient, ServerType, REGISTRY_SERVER_KEY, toElicitationRequestedSchema, hasRequestedSchema, } from "./mcp/index.js";
+export type { MCPToolCallResult, MCPToolSpec, MCPElicitationHandler, MCPSamplingHandler, MCPHandlers, ElicitationRequestedSchema, TamboElicitationRequest, TamboElicitationResponse, ElicitationContextState, PrimitiveSchemaDefinition, } from "./mcp/index.js";
+export { streamReducer, createInitialState, createInitialStateWithMessages, createInitialThreadState, isPlaceholderThreadId, PLACEHOLDER_THREAD_ID, UnreachableCaseError, } from "./utils/event-accumulator.js";
+export type { ThreadState, StreamState, StreamAction, EventAction, InitThreadAction, SetCurrentThreadAction, StartNewThreadAction, LoadThreadMessagesAction, SetLastCompletedRunIdAction, UpdateThreadNameAction, } from "./utils/event-accumulator.js";
+export { executeStreamableToolCall, createThrottledStreamableExecutor, executeClientTool, executeAllPendingTools, } from "./utils/tool-executor.js";
+export type { PendingToolCall } from "./utils/tool-executor.js";
+export { ToolCallTracker } from "./utils/tool-call-tracker.js";
+export { handleEventStream } from "./utils/stream-handler.js";
+export type { StreamHandlerOptions } from "./utils/stream-handler.js";
+export { findComponentContent } from "./utils/thread-utils.js";
+export { createKeyedThrottle } from "./utils/keyed-throttle.js";
+export type { KeyedThrottle } from "./utils/keyed-throttle.js";
+export { applyJsonPatch } from "./utils/json-patch.js";
+export { unstrictifyToolCallParamsFromSchema, canBeNull, } from "./utils/unstrictify.js";
+export { toAvailableComponent, toAvailableComponents, toAvailableTool, toAvailableTools, } from "./utils/registry-conversion.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

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

package/esm/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.js");
+Object.defineProperty(exports, "TamboClient", { enumerable: true, get: function () { return tambo_client_1.TamboClient; } });
+var tambo_stream_1 = require("./tambo-stream.js");
+Object.defineProperty(exports, "TamboStream", { enumerable: true, get: function () { return tambo_stream_1.TamboStream; } });
+// -- Send message utilities --
+var send_message_1 = require("./utils/send-message.js");
+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.js");
+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.js");
+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.js");
+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.js");
+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.js");
+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.js");
+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.js");
+Object.defineProperty(exports, "ToolCallTracker", { enumerable: true, get: function () { return tool_call_tracker_1.ToolCallTracker; } });
+var stream_handler_1 = require("./utils/stream-handler.js");
+Object.defineProperty(exports, "handleEventStream", { enumerable: true, get: function () { return stream_handler_1.handleEventStream; } });
+var thread_utils_1 = require("./utils/thread-utils.js");
+Object.defineProperty(exports, "findComponentContent", { enumerable: true, get: function () { return thread_utils_1.findComponentContent; } });
+var keyed_throttle_1 = require("./utils/keyed-throttle.js");
+Object.defineProperty(exports, "createKeyedThrottle", { enumerable: true, get: function () { return keyed_throttle_1.createKeyedThrottle; } });
+var json_patch_1 = require("./utils/json-patch.js");
+Object.defineProperty(exports, "applyJsonPatch", { enumerable: true, get: function () { return json_patch_1.applyJsonPatch; } });
+var unstrictify_1 = require("./utils/unstrictify.js");
+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.js");
+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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/mcp/index.d.ts

@@ -0,0 +1,6 @@
+export { MCPClient, type MCPToolCallResult, type MCPToolSpec, type MCPElicitationHandler, type MCPSamplingHandler, type MCPHandlers, } from "./mcp-client.js";
+export { MCPTransport } from "./mcp-client.js";
+export { ServerType, REGISTRY_SERVER_KEY } from "./mcp-constants.js";
+export type { ElicitationRequestedSchema, TamboElicitationRequest, TamboElicitationResponse, ElicitationContextState, PrimitiveSchemaDefinition, } from "./elicitation.js";
+export { toElicitationRequestedSchema, hasRequestedSchema, } from "./elicitation.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/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/esm/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.js");
+Object.defineProperty(exports, "MCPClient", { enumerable: true, get: function () { return mcp_client_1.MCPClient; } });
+var mcp_client_2 = require("./mcp-client.js");
+Object.defineProperty(exports, "MCPTransport", { enumerable: true, get: function () { return mcp_client_2.MCPTransport; } });
+var mcp_constants_1 = require("./mcp-constants.js");
+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.js");
+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/esm/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/esm/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.js";
+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/esm/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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"}