@tanstack/ai 0.45.1 → 0.47.1

package/dist/esm/activities/chat/tools/unique-tool-names.js

@@ -0,0 +1,57 @@
+//#region src/activities/chat/tools/unique-tool-names.ts
+/**
+* Thrown when `chat({ tools })` (or a provider converter) receives two tools
+* with the same public `name`.
+*
+* The common case is a provider-native factory (`webSearchTool()`) next to an
+* ordinary function that reused the reserved name (`web_search`). Providers
+* reject that pair, so we fail before the request is built.
+*/
+var DuplicateToolNameError = class extends Error {
+	toolName;
+	constructor(toolName, message) {
+		super(message);
+		this.name = "DuplicateToolNameError";
+		this.toolName = toolName;
+	}
+};
+function isProviderNativeTool(tool) {
+	const kind = tool.metadata?.["__kind"];
+	return typeof kind === "string" && kind.length > 0;
+}
+function nativeAndCustomMessage(toolName) {
+	return [
+		`Cannot pass two tools named "${toolName}" in the same chat() call.`,
+		`One is the provider-native tool from a factory (for example webSearchTool()).`,
+		`The other is your own function with the same public name.`,
+		`Tool names in one tools array must be unique.`,
+		`Keep the factory for hosted search, or keep your function and give it a different name.`
+	].join(" ");
+}
+function duplicateNameMessage(toolName) {
+	return [`Cannot pass two tools named "${toolName}" in the same chat() call.`, `Tool names in one tools array must be unique.`].join(" ");
+}
+/**
+* Throws {@link DuplicateToolNameError} when two tools share a public name.
+*
+* The native-vs-custom message fires when one of the colliding tools carries
+* adapter `metadata.__kind` (set by a provider factory) and another does not.
+*/
+function assertUniqueToolNames(tools) {
+	const byName = /* @__PURE__ */ new Map();
+	for (const tool of tools) {
+		const group = byName.get(tool.name);
+		if (group) group.push(tool);
+		else byName.set(tool.name, [tool]);
+	}
+	for (const [name, group] of byName) {
+		if (group.length < 2) continue;
+		const hasNative = group.some(isProviderNativeTool);
+		const hasCustom = group.some((tool) => !isProviderNativeTool(tool));
+		throw new DuplicateToolNameError(name, hasNative && hasCustom ? nativeAndCustomMessage(name) : duplicateNameMessage(name));
+	}
+}
+//#endregion
+export { DuplicateToolNameError, assertUniqueToolNames };
+
+//# sourceMappingURL=unique-tool-names.js.map

package/dist/esm/activities/chat/tools/unique-tool-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique-tool-names.js","names":[],"sources":["../../../../../src/activities/chat/tools/unique-tool-names.ts"],"sourcesContent":["import type { Tool } from '../../../types'\n\n/**\n * Thrown when `chat({ tools })` (or a provider converter) receives two tools\n * with the same public `name`.\n *\n * The common case is a provider-native factory (`webSearchTool()`) next to an\n * ordinary function that reused the reserved name (`web_search`). Providers\n * reject that pair, so we fail before the request is built.\n */\nexport class DuplicateToolNameError extends Error {\n  readonly toolName: string\n\n  constructor(toolName: string, message: string) {\n    super(message)\n    this.name = 'DuplicateToolNameError'\n    this.toolName = toolName\n  }\n}\n\nfunction isProviderNativeTool(tool: Tool): boolean {\n  const kind = tool.metadata?.['__kind']\n  return typeof kind === 'string' && kind.length > 0\n}\n\nfunction nativeAndCustomMessage(toolName: string) {\n  return [\n    `Cannot pass two tools named \"${toolName}\" in the same chat() call.`,\n    `One is the provider-native tool from a factory (for example webSearchTool()).`,\n    `The other is your own function with the same public name.`,\n    `Tool names in one tools array must be unique.`,\n    `Keep the factory for hosted search, or keep your function and give it a different name.`,\n  ].join(' ')\n}\n\nfunction duplicateNameMessage(toolName: string) {\n  return [\n    `Cannot pass two tools named \"${toolName}\" in the same chat() call.`,\n    `Tool names in one tools array must be unique.`,\n  ].join(' ')\n}\n\n/**\n * Throws {@link DuplicateToolNameError} when two tools share a public name.\n *\n * The native-vs-custom message fires when one of the colliding tools carries\n * adapter `metadata.__kind` (set by a provider factory) and another does not.\n */\nexport function assertUniqueToolNames(tools: ReadonlyArray<Tool>): void {\n  const byName = new Map<string, Array<Tool>>()\n  for (const tool of tools) {\n    const group = byName.get(tool.name)\n    if (group) {\n      group.push(tool)\n    } else {\n      byName.set(tool.name, [tool])\n    }\n  }\n\n  for (const [name, group] of byName) {\n    if (group.length < 2) {\n      continue\n    }\n    const hasNative = group.some(isProviderNativeTool)\n    const hasCustom = group.some((tool) => !isProviderNativeTool(tool))\n    throw new DuplicateToolNameError(\n      name,\n      hasNative && hasCustom\n        ? nativeAndCustomMessage(name)\n        : duplicateNameMessage(name),\n    )\n  }\n}\n"],"mappings":";;;;;;;;;AAUA,IAAa,yBAAb,cAA4C,MAAM;CAChD;CAEA,YAAY,UAAkB,SAAiB;EAC7C,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,WAAW;CAClB;AACF;AAEA,SAAS,qBAAqB,MAAqB;CACjD,MAAM,OAAO,KAAK,WAAW;CAC7B,OAAO,OAAO,SAAS,YAAY,KAAK,SAAS;AACnD;AAEA,SAAS,uBAAuB,UAAkB;CAChD,OAAO;EACL,gCAAgC,SAAS;EACzC;EACA;EACA;EACA;CACF,CAAC,CAAC,KAAK,GAAG;AACZ;AAEA,SAAS,qBAAqB,UAAkB;CAC9C,OAAO,CACL,gCAAgC,SAAS,6BACzC,+CACF,CAAC,CAAC,KAAK,GAAG;AACZ;;;;;;;AAQA,SAAgB,sBAAsB,OAAkC;CACtE,MAAM,yBAAS,IAAI,IAAyB;CAC5C,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,QAAQ,OAAO,IAAI,KAAK,IAAI;EAClC,IAAI,OACF,MAAM,KAAK,IAAI;OAEf,OAAO,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC;CAEhC;CAEA,KAAK,MAAM,CAAC,MAAM,UAAU,QAAQ;EAClC,IAAI,MAAM,SAAS,GACjB;EAEF,MAAM,YAAY,MAAM,KAAK,oBAAoB;EACjD,MAAM,YAAY,MAAM,MAAM,SAAS,CAAC,qBAAqB,IAAI,CAAC;EAClE,MAAM,IAAI,uBACR,MACA,aAAa,YACT,uBAAuB,IAAI,IAC3B,qBAAqB,IAAI,CAC/B;CACF;AACF"}

package/dist/esm/adapter-internals.d.ts

@@ -6,5 +6,12 @@ export { toRunErrorPayload, toRunErrorRawEvent, } from './activities/error-paylo
 export { getSandboxRuntime, provideSandboxRuntime, SandboxRuntimeCapability, } from './activities/chat/middleware/sandbox-runtime.js';
 export { getRunDisconnect, provideRunDisconnect, RunDisconnectCapability, } from './activities/chat/middleware/run-disconnect.js';
 export { getPendingTurn, PendingTurnCapability, providePendingTurn, } from './activities/chat/middleware/pending-turn.js';
+export { getGenericInterruptDefinitionRegistry, GenericInterruptDefinitionRegistryCapability, provideGenericInterruptDefinitionRegistry, } from './activities/chat/middleware/generic-interrupts.js';
+export type { GenericInterruptDefinitionRegistry } from './activities/chat/middleware/generic-interrupts.js';
+export { createInterruptBinding, getInterruptRequestInput, rehydrateInterruptRequest, } from './interrupt-definition.js';
+export type { GenericInterruptRequest, InterruptDefinition, } from './interrupt-definition.js';
+export { readInterruptBinding, validateInterruptResumeBatch, } from './interrupt-resume.js';
+export type { PendingInterruptResumeRecord } from './interrupt-resume.js';
+export { assertUniqueToolNames, DuplicateToolNameError, } from './activities/chat/tools/unique-tool-names.js';
 export { appendOutputSchemaInstruction, parseJsonFromAssistantText, } from './utilities/structured-output-text.js';
 export { structuredOutputCompleteChunk, structuredOutputStartChunk, } from './utilities/structured-output-events.js';

package/dist/esm/adapter-internals.js

@@ -1,9 +1,13 @@
 import { toRunErrorPayload, toRunErrorRawEvent } from "./activities/error-payload.js";
 import { InternalLogger } from "./logger/internal-logger.js";
 import { resolveDebugOption } from "./logger/resolve.js";
+import { readInterruptBinding, validateInterruptResumeBatch } from "./interrupt-resume.js";
+import { createInterruptBinding, getInterruptRequestInput, rehydrateInterruptRequest } from "./interrupt-definition.js";
+import { DuplicateToolNameError, assertUniqueToolNames } from "./activities/chat/tools/unique-tool-names.js";
 import { SandboxRuntimeCapability, getSandboxRuntime, provideSandboxRuntime } from "./activities/chat/middleware/sandbox-runtime.js";
 import { RunDisconnectCapability, getRunDisconnect, provideRunDisconnect } from "./activities/chat/middleware/run-disconnect.js";
+import { GenericInterruptDefinitionRegistryCapability, getGenericInterruptDefinitionRegistry, provideGenericInterruptDefinitionRegistry } from "./activities/chat/middleware/generic-interrupts.js";
 import { PendingTurnCapability, getPendingTurn, providePendingTurn } from "./activities/chat/middleware/pending-turn.js";
 import { appendOutputSchemaInstruction, parseJsonFromAssistantText } from "./utilities/structured-output-text.js";
 import { structuredOutputCompleteChunk, structuredOutputStartChunk } from "./utilities/structured-output-events.js";
-export { InternalLogger, PendingTurnCapability, RunDisconnectCapability, SandboxRuntimeCapability, appendOutputSchemaInstruction, getPendingTurn, getRunDisconnect, getSandboxRuntime, parseJsonFromAssistantText, providePendingTurn, provideRunDisconnect, provideSandboxRuntime, resolveDebugOption, structuredOutputCompleteChunk, structuredOutputStartChunk, toRunErrorPayload, toRunErrorRawEvent };
+export { DuplicateToolNameError, GenericInterruptDefinitionRegistryCapability, InternalLogger, PendingTurnCapability, RunDisconnectCapability, SandboxRuntimeCapability, appendOutputSchemaInstruction, assertUniqueToolNames, createInterruptBinding, getGenericInterruptDefinitionRegistry, getInterruptRequestInput, getPendingTurn, getRunDisconnect, getSandboxRuntime, parseJsonFromAssistantText, provideGenericInterruptDefinitionRegistry, providePendingTurn, provideRunDisconnect, provideSandboxRuntime, readInterruptBinding, rehydrateInterruptRequest, resolveDebugOption, structuredOutputCompleteChunk, structuredOutputStartChunk, toRunErrorPayload, toRunErrorRawEvent, validateInterruptResumeBatch };

package/dist/esm/client.d.ts

@@ -61,6 +61,10 @@ export { uiMessagesToWire } from './utilities/ag-ui-wire.js';
 export type { WireMessage } from './utilities/ag-ui-wire.js';
 export type { AudioPart, ContentPart, ContentPartDataSource, ContentPartSource, ContentPartUrlSource, CustomEvent, DocumentPart, ImagePart, MediaInputMetadata, MediaInputRole, MediaPrompt, MediaPromptPart, MessagePart, ModelMessage, PersistedArtifactActivity, PersistedArtifactRef, PersistedArtifactRole, Interrupt, RunAgentResumeItem, RunErrorEvent, RunFinishedEvent, RunFinishedOutcome, SchemaInput, StreamChunk, StructuredOutputPart, TextPart, ThinkingPart, ToolCall, ToolCallPart, ToolResultPart, UIMessage, UIResourcePart, VideoPart, InferSchemaType, } from './types.js';
 export { INTERRUPT_BINDING_VERSION, canonicalizeInterruptResolutions, } from './interrupts.js';
+export { defineInterrupt, hashInterruptDefinitionSchema, INTERRUPT_PAYLOAD_METADATA_KEY, } from './interrupt-definition.js';
+export { INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, genericInterruptContinuationFromDescriptor, readGenericInterruptContinuation, wrapGenericInterruptContinuation, } from './generic-interrupt-continuation.js';
+export type { GenericInterruptContinuation, GenericInterruptContinuationReadResult, } from './generic-interrupt-continuation.js';
+export type { GenericInterruptRequest, InterruptDefinition, } from './interrupt-definition.js';
 export type { BatchInterruptError, BatchInterruptErrorCode, InterruptBinding, InterruptCorrelation, InterruptSubmissionError, ItemInterruptError, ItemInterruptErrorCode, ToolApprovalResolution, UnopenedInterruptBinding, } from './interrupts.js';
 export { INTERRUPT_BINDING_METADATA_KEY, readInterruptBinding, readUnopenedInterruptBinding, withInterruptBinding, withoutInterruptBinding, } from './interrupt-resume.js';
 export type { AudioVisualization, RealtimeAdapter, RealtimeConnection, RealtimeError, RealtimeErrorCode, RealtimeEvent, RealtimeEventHandler, RealtimeEventPayloads, RealtimeMessage, RealtimeMessagePart, RealtimeMode, RealtimeSessionConfig, RealtimeStatus, RealtimeToken, RealtimeAudioPart, RealtimeImagePart, RealtimeTextPart, RealtimeToolCallPart, RealtimeToolResultPart, VADConfig, } from './realtime/types.js';

package/dist/esm/client.js

@@ -3,6 +3,8 @@ import { INTERRUPT_BINDING_VERSION, canonicalizeInterruptResolutions } from "./i
 import { convertSchemaToJsonSchema, isStandardSchema, parseWithStandardSchema, validateWithStandardSchema } from "./activities/chat/tools/schema-converter.js";
 import { hashSchemaInput, normalizeApprovalSchema } from "./activities/chat/tools/approval-schema.js";
 import { INTERRUPT_BINDING_METADATA_KEY, readInterruptBinding, readUnopenedInterruptBinding, withInterruptBinding, withoutInterruptBinding } from "./interrupt-resume.js";
+import { INTERRUPT_PAYLOAD_METADATA_KEY, defineInterrupt, hashInterruptDefinitionSchema } from "./interrupt-definition.js";
+import { INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, genericInterruptContinuationFromDescriptor, readGenericInterruptContinuation, wrapGenericInterruptContinuation } from "./generic-interrupt-continuation.js";
 import { convertMessagesToModelMessages, generateMessageId, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeToUIMessage, uiMessageToModelMessages } from "./activities/chat/messages.js";
 import { toolDefinition } from "./activities/chat/tools/tool-definition.js";
 import { PartialJSONParser, defaultJSONParser, parsePartialJSON } from "./activities/chat/stream/json-parser.js";
@@ -129,6 +131,6 @@ var EventType = /* @__PURE__ */ function(EventType) {
 	return EventType;
 }({});
 //#endregion
-export { BatchStrategy, CompositeStrategy, EventType, INTERRUPT_BINDING_METADATA_KEY, INTERRUPT_BINDING_VERSION, ImmediateStrategy, PartialJSONParser, PunctuationStrategy, StreamProcessor, WordBoundaryStrategy, canonicalInterruptJson, canonicalizeInterruptResolutions, cloneAndDeepFreezeJson, convertMessagesToModelMessages, convertSchemaToJsonSchema, defaultJSONParser, digestInterruptJson, generateMessageId, generationParamsFromBody, generationParamsFromRequest, hashSchemaInput, isStandardSchema, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeApprovalSchema, normalizeToUIMessage, parsePartialJSON, parseWithStandardSchema, readInterruptBinding, readUnopenedInterruptBinding, toolDefinition, uiMessageToModelMessages, uiMessagesToWire, validateWithStandardSchema, withInterruptBinding, withoutInterruptBinding };
+export { BatchStrategy, CompositeStrategy, EventType, INTERRUPT_BINDING_METADATA_KEY, INTERRUPT_BINDING_VERSION, INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, INTERRUPT_PAYLOAD_METADATA_KEY, ImmediateStrategy, PartialJSONParser, PunctuationStrategy, StreamProcessor, WordBoundaryStrategy, canonicalInterruptJson, canonicalizeInterruptResolutions, cloneAndDeepFreezeJson, convertMessagesToModelMessages, convertSchemaToJsonSchema, defaultJSONParser, defineInterrupt, digestInterruptJson, generateMessageId, generationParamsFromBody, generationParamsFromRequest, genericInterruptContinuationFromDescriptor, hashInterruptDefinitionSchema, hashSchemaInput, isStandardSchema, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeApprovalSchema, normalizeToUIMessage, parsePartialJSON, parseWithStandardSchema, readGenericInterruptContinuation, readInterruptBinding, readUnopenedInterruptBinding, toolDefinition, uiMessageToModelMessages, uiMessagesToWire, validateWithStandardSchema, withInterruptBinding, withoutInterruptBinding, wrapGenericInterruptContinuation };
 
 //# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../../src/client.ts"],"sourcesContent":["import type {\n  AudioGenerationOptions,\n  ImageGenerationOptions,\n  TTSOptions,\n  TranscriptionOptions,\n  VideoGenerationOptions,\n} from './types'\n\nexport type GenerationKind =\n  | 'image'\n  | 'audio'\n  | 'tts'\n  | 'video'\n  | 'transcription'\n\ntype GenerationInputByKind = {\n  image: Omit<ImageGenerationOptions, 'logger' | 'model'>\n  audio: Omit<AudioGenerationOptions, 'logger' | 'model'>\n  tts: Omit<TTSOptions, 'logger' | 'model'>\n  video: Omit<VideoGenerationOptions, 'logger' | 'model'>\n  transcription: Omit<TranscriptionOptions, 'logger' | 'model'>\n}\n\nexport interface GenerationParams<TKind extends GenerationKind> {\n  input: GenerationInputByKind[TKind]\n  forwardedProps: Record<string, unknown>\n  threadId?: string\n  runId?: string\n}\n\nconst generationKinds = [\n  'image',\n  'audio',\n  'tts',\n  'video',\n  'transcription',\n] as const satisfies ReadonlyArray<GenerationKind>\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction hasOwnKey(value: Record<string, unknown>, key: string): boolean {\n  return Object.prototype.hasOwnProperty.call(value, key)\n}\n\nfunction isGenerationEnvelope(body: unknown): body is Record<string, unknown> {\n  return (\n    isRecord(body) &&\n    (hasOwnKey(body, 'data') || hasOwnKey(body, 'forwardedProps'))\n  )\n}\n\nfunction assertGenerationKind(kind: unknown): asserts kind is GenerationKind {\n  if (!generationKinds.includes(kind as GenerationKind)) {\n    throw new Error(\n      `Unsupported generation kind: ${String(\n        kind,\n      )}. Expected one of ${generationKinds.join(', ')}.`,\n    )\n  }\n}\n\nfunction assertInputForKind(\n  kind: GenerationKind,\n  input: unknown,\n): asserts input is GenerationInputByKind[GenerationKind] {\n  if (!isRecord(input)) {\n    throw new Error(`Generation ${kind} input must be an object.`)\n  }\n\n  const requiredKey =\n    kind === 'tts' ? 'text' : kind === 'transcription' ? 'audio' : 'prompt'\n\n  if (!hasOwnKey(input, requiredKey)) {\n    throw new Error(`Generation ${kind} input must include ${requiredKey}.`)\n  }\n}\n\nfunction isInputForKind(kind: GenerationKind, input: unknown): boolean {\n  if (!isRecord(input)) return false\n\n  const requiredKey =\n    kind === 'tts' ? 'text' : kind === 'transcription' ? 'audio' : 'prompt'\n\n  return hasOwnKey(input, requiredKey)\n}\n\nfunction forwardedPropsFromEnvelope(\n  envelope: Record<string, unknown>,\n): Record<string, unknown> {\n  if (!hasOwnKey(envelope, 'forwardedProps')) {\n    return {}\n  }\n\n  if (!isRecord(envelope.forwardedProps)) {\n    throw new Error('Generation envelope forwardedProps must be an object.')\n  }\n\n  return envelope.forwardedProps\n}\n\nfunction optionalStringField(\n  envelope: Record<string, unknown>,\n  key: 'threadId' | 'runId',\n): string | undefined {\n  if (!hasOwnKey(envelope, key)) {\n    return undefined\n  }\n\n  const value = envelope[key]\n  if (typeof value !== 'string') {\n    throw new Error(`Generation envelope ${key} must be a string.`)\n  }\n\n  return value\n}\n\nfunction generationIdentityFields(envelope: Record<string, unknown>): {\n  threadId?: string\n  runId?: string\n} {\n  const identity: {\n    threadId?: string\n    runId?: string\n  } = {}\n  const threadId = optionalStringField(envelope, 'threadId')\n  const runId = optionalStringField(envelope, 'runId')\n\n  if (threadId !== undefined) identity.threadId = threadId\n  if (runId !== undefined) identity.runId = runId\n\n  return identity\n}\n\nexport function generationParamsFromBody<TKind extends GenerationKind>(\n  kind: TKind,\n  body: unknown,\n): GenerationParams<TKind> {\n  assertGenerationKind(kind)\n\n  if (isInputForKind(kind, body)) {\n    assertInputForKind(kind, body)\n    return {\n      input: body as GenerationInputByKind[TKind],\n      forwardedProps: {},\n    }\n  }\n\n  if (!isGenerationEnvelope(body)) {\n    assertInputForKind(kind, body)\n    return {\n      input: body as GenerationInputByKind[TKind],\n      forwardedProps: {},\n    }\n  }\n\n  if (!hasOwnKey(body, 'data')) {\n    throw new Error(`Generation ${kind} envelope must include data.`)\n  }\n\n  const input = body.data\n  assertInputForKind(kind, input)\n\n  const forwardedProps = forwardedPropsFromEnvelope(body)\n\n  return {\n    input: input as GenerationInputByKind[TKind],\n    forwardedProps,\n    ...generationIdentityFields(body),\n  }\n}\n\nexport async function generationParamsFromRequest<TKind extends GenerationKind>(\n  kind: TKind,\n  request: Request,\n): Promise<GenerationParams<TKind>> {\n  let body: unknown\n  try {\n    body = await request.json()\n  } catch (error) {\n    throw new Error('Invalid JSON request body.', { cause: error })\n  }\n\n  if (!isRecord(body)) {\n    throw new Error('Generation request body must be a JSON object.')\n  }\n\n  return generationParamsFromBody(kind, body)\n}\n\nexport enum EventType {\n  TEXT_MESSAGE_START = 'TEXT_MESSAGE_START',\n  TEXT_MESSAGE_CONTENT = 'TEXT_MESSAGE_CONTENT',\n  TEXT_MESSAGE_END = 'TEXT_MESSAGE_END',\n  TEXT_MESSAGE_CHUNK = 'TEXT_MESSAGE_CHUNK',\n  TOOL_CALL_START = 'TOOL_CALL_START',\n  TOOL_CALL_ARGS = 'TOOL_CALL_ARGS',\n  TOOL_CALL_END = 'TOOL_CALL_END',\n  TOOL_CALL_CHUNK = 'TOOL_CALL_CHUNK',\n  TOOL_CALL_RESULT = 'TOOL_CALL_RESULT',\n  THINKING_START = 'THINKING_START',\n  THINKING_END = 'THINKING_END',\n  THINKING_TEXT_MESSAGE_START = 'THINKING_TEXT_MESSAGE_START',\n  THINKING_TEXT_MESSAGE_CONTENT = 'THINKING_TEXT_MESSAGE_CONTENT',\n  THINKING_TEXT_MESSAGE_END = 'THINKING_TEXT_MESSAGE_END',\n  STATE_SNAPSHOT = 'STATE_SNAPSHOT',\n  STATE_DELTA = 'STATE_DELTA',\n  MESSAGES_SNAPSHOT = 'MESSAGES_SNAPSHOT',\n  ACTIVITY_SNAPSHOT = 'ACTIVITY_SNAPSHOT',\n  ACTIVITY_DELTA = 'ACTIVITY_DELTA',\n  RAW = 'RAW',\n  CUSTOM = 'CUSTOM',\n  RUN_STARTED = 'RUN_STARTED',\n  RUN_FINISHED = 'RUN_FINISHED',\n  RUN_ERROR = 'RUN_ERROR',\n  STEP_STARTED = 'STEP_STARTED',\n  STEP_FINISHED = 'STEP_FINISHED',\n  REASONING_START = 'REASONING_START',\n  REASONING_MESSAGE_START = 'REASONING_MESSAGE_START',\n  REASONING_MESSAGE_CONTENT = 'REASONING_MESSAGE_CONTENT',\n  REASONING_MESSAGE_END = 'REASONING_MESSAGE_END',\n  REASONING_MESSAGE_CHUNK = 'REASONING_MESSAGE_CHUNK',\n  REASONING_END = 'REASONING_END',\n  REASONING_ENCRYPTED_VALUE = 'REASONING_ENCRYPTED_VALUE',\n}\n\nexport {\n  toolDefinition,\n  type AnyClientTool,\n  type ClientTool,\n  type InferToolInput,\n  type InferToolName,\n  type InferToolOutput,\n  type ApprovalCapabilityOf,\n  type ApprovalSchemaConfig,\n  type ApprovalSchemaOf,\n  type InputSchemaOf,\n  type OutputSchemaOf,\n  type NoSchema,\n  type ToolDefinition,\n  type ToolDefinitionConfig,\n  type ToolDefinitionInstance,\n} from './activities/chat/tools/tool-definition'\n\nexport {\n  hashSchemaInput,\n  normalizeApprovalSchema,\n  type NormalizedApprovalSchema,\n  type NormalizedSchemaInput,\n} from './activities/chat/tools/approval-schema'\n\nexport {\n  canonicalInterruptJson,\n  cloneAndDeepFreezeJson,\n  digestInterruptJson,\n} from './interrupt-serialization'\n\nexport {\n  convertSchemaToJsonSchema,\n  isStandardSchema,\n  parseWithStandardSchema,\n  validateWithStandardSchema,\n} from './activities/chat/tools/schema-converter'\n\nexport {\n  convertMessagesToModelMessages,\n  generateMessageId,\n  modelMessageToUIMessage,\n  modelMessagesToUIMessages,\n  normalizeToUIMessage,\n  uiMessageToModelMessages,\n} from './activities/chat/messages'\n\nexport {\n  BatchStrategy,\n  CompositeStrategy,\n  defaultJSONParser,\n  ImmediateStrategy,\n  parsePartialJSON,\n  PartialJSONParser,\n  PunctuationStrategy,\n  StreamProcessor,\n  WordBoundaryStrategy,\n} from './activities/chat/stream/index'\nexport type {\n  ChunkRecording,\n  ChunkStrategy,\n  InternalToolCallState,\n  JSONParser,\n  ProcessorResult,\n  ProcessorState,\n  StreamProcessorEvents,\n  StreamProcessorOptions,\n  ToolCallState,\n  ToolResultState,\n} from './activities/chat/stream/index'\n\nexport { uiMessagesToWire } from './utilities/ag-ui-wire'\nexport type { WireMessage } from './utilities/ag-ui-wire'\n\nexport type {\n  AudioPart,\n  ContentPart,\n  ContentPartDataSource,\n  ContentPartSource,\n  ContentPartUrlSource,\n  CustomEvent,\n  DocumentPart,\n  ImagePart,\n  MediaInputMetadata,\n  MediaInputRole,\n  MediaPrompt,\n  MediaPromptPart,\n  MessagePart,\n  ModelMessage,\n  PersistedArtifactActivity,\n  PersistedArtifactRef,\n  PersistedArtifactRole,\n  Interrupt,\n  RunAgentResumeItem,\n  RunErrorEvent,\n  RunFinishedEvent,\n  RunFinishedOutcome,\n  SchemaInput,\n  StreamChunk,\n  StructuredOutputPart,\n  TextPart,\n  ThinkingPart,\n  ToolCall,\n  ToolCallPart,\n  ToolResultPart,\n  UIMessage,\n  UIResourcePart,\n  VideoPart,\n  InferSchemaType,\n} from './types'\n\n// Enumerated, not `export *` — see the matching note in `index.ts`. The\n// interrupt protocol surface is a commitment, so it is published field by\n// field.\nexport {\n  INTERRUPT_BINDING_VERSION,\n  canonicalizeInterruptResolutions,\n} from './interrupts'\nexport type {\n  BatchInterruptError,\n  BatchInterruptErrorCode,\n  InterruptBinding,\n  InterruptCorrelation,\n  InterruptSubmissionError,\n  ItemInterruptError,\n  ItemInterruptErrorCode,\n  ToolApprovalResolution,\n  UnopenedInterruptBinding,\n} from './interrupts'\n\nexport {\n  INTERRUPT_BINDING_METADATA_KEY,\n  readInterruptBinding,\n  readUnopenedInterruptBinding,\n  withInterruptBinding,\n  withoutInterruptBinding,\n} from './interrupt-resume'\n\nexport type {\n  AudioVisualization,\n  RealtimeAdapter,\n  RealtimeConnection,\n  RealtimeError,\n  RealtimeErrorCode,\n  RealtimeEvent,\n  RealtimeEventHandler,\n  RealtimeEventPayloads,\n  RealtimeMessage,\n  RealtimeMessagePart,\n  RealtimeMode,\n  RealtimeSessionConfig,\n  RealtimeStatus,\n  RealtimeToken,\n  RealtimeAudioPart,\n  RealtimeImagePart,\n  RealtimeTextPart,\n  RealtimeToolCallPart,\n  RealtimeToolResultPart,\n  VADConfig,\n} from './realtime/types'\n"],"mappings":";;;;;;;;;;;;AA8BA,IAAM,kBAAkB;CACtB;CACA;CACA;CACA;CACA;AACF;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,UAAU,OAAgC,KAAsB;CACvE,OAAO,OAAO,UAAU,eAAe,KAAK,OAAO,GAAG;AACxD;AAEA,SAAS,qBAAqB,MAAgD;CAC5E,OACE,SAAS,IAAI,MACZ,UAAU,MAAM,MAAM,KAAK,UAAU,MAAM,gBAAgB;AAEhE;AAEA,SAAS,qBAAqB,MAA+C;CAC3E,IAAI,CAAC,gBAAgB,SAAS,IAAsB,GAClD,MAAM,IAAI,MACR,gCAAgC,OAC9B,IACF,EAAE,oBAAoB,gBAAgB,KAAK,IAAI,EAAE,EACnD;AAEJ;AAEA,SAAS,mBACP,MACA,OACwD;CACxD,IAAI,CAAC,SAAS,KAAK,GACjB,MAAM,IAAI,MAAM,cAAc,KAAK,0BAA0B;CAG/D,MAAM,cACJ,SAAS,QAAQ,SAAS,SAAS,kBAAkB,UAAU;CAEjE,IAAI,CAAC,UAAU,OAAO,WAAW,GAC/B,MAAM,IAAI,MAAM,cAAc,KAAK,sBAAsB,YAAY,EAAE;AAE3E;AAEA,SAAS,eAAe,MAAsB,OAAyB;CACrE,IAAI,CAAC,SAAS,KAAK,GAAG,OAAO;CAK7B,OAAO,UAAU,OAFf,SAAS,QAAQ,SAAS,SAAS,kBAAkB,UAAU,QAE9B;AACrC;AAEA,SAAS,2BACP,UACyB;CACzB,IAAI,CAAC,UAAU,UAAU,gBAAgB,GACvC,OAAO,CAAC;CAGV,IAAI,CAAC,SAAS,SAAS,cAAc,GACnC,MAAM,IAAI,MAAM,uDAAuD;CAGzE,OAAO,SAAS;AAClB;AAEA,SAAS,oBACP,UACA,KACoB;CACpB,IAAI,CAAC,UAAU,UAAU,GAAG,GAC1B;CAGF,MAAM,QAAQ,SAAS;CACvB,IAAI,OAAO,UAAU,UACnB,MAAM,IAAI,MAAM,uBAAuB,IAAI,mBAAmB;CAGhE,OAAO;AACT;AAEA,SAAS,yBAAyB,UAGhC;CACA,MAAM,WAGF,CAAC;CACL,MAAM,WAAW,oBAAoB,UAAU,UAAU;CACzD,MAAM,QAAQ,oBAAoB,UAAU,OAAO;CAEnD,IAAI,aAAa,KAAA,GAAW,SAAS,WAAW;CAChD,IAAI,UAAU,KAAA,GAAW,SAAS,QAAQ;CAE1C,OAAO;AACT;AAEA,SAAgB,yBACd,MACA,MACyB;CACzB,qBAAqB,IAAI;CAEzB,IAAI,eAAe,MAAM,IAAI,GAAG;EAC9B,mBAAmB,MAAM,IAAI;EAC7B,OAAO;GACL,OAAO;GACP,gBAAgB,CAAC;EACnB;CACF;CAEA,IAAI,CAAC,qBAAqB,IAAI,GAAG;EAC/B,mBAAmB,MAAM,IAAI;EAC7B,OAAO;GACL,OAAO;GACP,gBAAgB,CAAC;EACnB;CACF;CAEA,IAAI,CAAC,UAAU,MAAM,MAAM,GACzB,MAAM,IAAI,MAAM,cAAc,KAAK,6BAA6B;CAGlE,MAAM,QAAQ,KAAK;CACnB,mBAAmB,MAAM,KAAK;CAI9B,OAAO;EACE;EACP,gBAJqB,2BAA2B,IAIhD;EACA,GAAG,yBAAyB,IAAI;CAClC;AACF;AAEA,eAAsB,4BACpB,MACA,SACkC;CAClC,IAAI;CACJ,IAAI;EACF,OAAO,MAAM,QAAQ,KAAK;CAC5B,SAAS,OAAO;EACd,MAAM,IAAI,MAAM,8BAA8B,EAAE,OAAO,MAAM,CAAC;CAChE;CAEA,IAAI,CAAC,SAAS,IAAI,GAChB,MAAM,IAAI,MAAM,gDAAgD;CAGlE,OAAO,yBAAyB,MAAM,IAAI;AAC5C;AAEA,IAAY,YAAL,yBAAA,WAAA;CACL,UAAA,wBAAA;CACA,UAAA,0BAAA;CACA,UAAA,sBAAA;CACA,UAAA,wBAAA;CACA,UAAA,qBAAA;CACA,UAAA,oBAAA;CACA,UAAA,mBAAA;CACA,UAAA,qBAAA;CACA,UAAA,sBAAA;CACA,UAAA,oBAAA;CACA,UAAA,kBAAA;CACA,UAAA,iCAAA;CACA,UAAA,mCAAA;CACA,UAAA,+BAAA;CACA,UAAA,oBAAA;CACA,UAAA,iBAAA;CACA,UAAA,uBAAA;CACA,UAAA,uBAAA;CACA,UAAA,oBAAA;CACA,UAAA,SAAA;CACA,UAAA,YAAA;CACA,UAAA,iBAAA;CACA,UAAA,kBAAA;CACA,UAAA,eAAA;CACA,UAAA,kBAAA;CACA,UAAA,mBAAA;CACA,UAAA,qBAAA;CACA,UAAA,6BAAA;CACA,UAAA,+BAAA;CACA,UAAA,2BAAA;CACA,UAAA,6BAAA;CACA,UAAA,mBAAA;CACA,UAAA,+BAAA;;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"client.js","names":[],"sources":["../../src/client.ts"],"sourcesContent":["import type {\n  AudioGenerationOptions,\n  ImageGenerationOptions,\n  TTSOptions,\n  TranscriptionOptions,\n  VideoGenerationOptions,\n} from './types'\n\nexport type GenerationKind =\n  | 'image'\n  | 'audio'\n  | 'tts'\n  | 'video'\n  | 'transcription'\n\ntype GenerationInputByKind = {\n  image: Omit<ImageGenerationOptions, 'logger' | 'model'>\n  audio: Omit<AudioGenerationOptions, 'logger' | 'model'>\n  tts: Omit<TTSOptions, 'logger' | 'model'>\n  video: Omit<VideoGenerationOptions, 'logger' | 'model'>\n  transcription: Omit<TranscriptionOptions, 'logger' | 'model'>\n}\n\nexport interface GenerationParams<TKind extends GenerationKind> {\n  input: GenerationInputByKind[TKind]\n  forwardedProps: Record<string, unknown>\n  threadId?: string\n  runId?: string\n}\n\nconst generationKinds = [\n  'image',\n  'audio',\n  'tts',\n  'video',\n  'transcription',\n] as const satisfies ReadonlyArray<GenerationKind>\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction hasOwnKey(value: Record<string, unknown>, key: string): boolean {\n  return Object.prototype.hasOwnProperty.call(value, key)\n}\n\nfunction isGenerationEnvelope(body: unknown): body is Record<string, unknown> {\n  return (\n    isRecord(body) &&\n    (hasOwnKey(body, 'data') || hasOwnKey(body, 'forwardedProps'))\n  )\n}\n\nfunction assertGenerationKind(kind: unknown): asserts kind is GenerationKind {\n  if (!generationKinds.includes(kind as GenerationKind)) {\n    throw new Error(\n      `Unsupported generation kind: ${String(\n        kind,\n      )}. Expected one of ${generationKinds.join(', ')}.`,\n    )\n  }\n}\n\nfunction assertInputForKind(\n  kind: GenerationKind,\n  input: unknown,\n): asserts input is GenerationInputByKind[GenerationKind] {\n  if (!isRecord(input)) {\n    throw new Error(`Generation ${kind} input must be an object.`)\n  }\n\n  const requiredKey =\n    kind === 'tts' ? 'text' : kind === 'transcription' ? 'audio' : 'prompt'\n\n  if (!hasOwnKey(input, requiredKey)) {\n    throw new Error(`Generation ${kind} input must include ${requiredKey}.`)\n  }\n}\n\nfunction isInputForKind(kind: GenerationKind, input: unknown): boolean {\n  if (!isRecord(input)) return false\n\n  const requiredKey =\n    kind === 'tts' ? 'text' : kind === 'transcription' ? 'audio' : 'prompt'\n\n  return hasOwnKey(input, requiredKey)\n}\n\nfunction forwardedPropsFromEnvelope(\n  envelope: Record<string, unknown>,\n): Record<string, unknown> {\n  if (!hasOwnKey(envelope, 'forwardedProps')) {\n    return {}\n  }\n\n  if (!isRecord(envelope.forwardedProps)) {\n    throw new Error('Generation envelope forwardedProps must be an object.')\n  }\n\n  return envelope.forwardedProps\n}\n\nfunction optionalStringField(\n  envelope: Record<string, unknown>,\n  key: 'threadId' | 'runId',\n): string | undefined {\n  if (!hasOwnKey(envelope, key)) {\n    return undefined\n  }\n\n  const value = envelope[key]\n  if (typeof value !== 'string') {\n    throw new Error(`Generation envelope ${key} must be a string.`)\n  }\n\n  return value\n}\n\nfunction generationIdentityFields(envelope: Record<string, unknown>): {\n  threadId?: string\n  runId?: string\n} {\n  const identity: {\n    threadId?: string\n    runId?: string\n  } = {}\n  const threadId = optionalStringField(envelope, 'threadId')\n  const runId = optionalStringField(envelope, 'runId')\n\n  if (threadId !== undefined) identity.threadId = threadId\n  if (runId !== undefined) identity.runId = runId\n\n  return identity\n}\n\nexport function generationParamsFromBody<TKind extends GenerationKind>(\n  kind: TKind,\n  body: unknown,\n): GenerationParams<TKind> {\n  assertGenerationKind(kind)\n\n  if (isInputForKind(kind, body)) {\n    assertInputForKind(kind, body)\n    return {\n      input: body as GenerationInputByKind[TKind],\n      forwardedProps: {},\n    }\n  }\n\n  if (!isGenerationEnvelope(body)) {\n    assertInputForKind(kind, body)\n    return {\n      input: body as GenerationInputByKind[TKind],\n      forwardedProps: {},\n    }\n  }\n\n  if (!hasOwnKey(body, 'data')) {\n    throw new Error(`Generation ${kind} envelope must include data.`)\n  }\n\n  const input = body.data\n  assertInputForKind(kind, input)\n\n  const forwardedProps = forwardedPropsFromEnvelope(body)\n\n  return {\n    input: input as GenerationInputByKind[TKind],\n    forwardedProps,\n    ...generationIdentityFields(body),\n  }\n}\n\nexport async function generationParamsFromRequest<TKind extends GenerationKind>(\n  kind: TKind,\n  request: Request,\n): Promise<GenerationParams<TKind>> {\n  let body: unknown\n  try {\n    body = await request.json()\n  } catch (error) {\n    throw new Error('Invalid JSON request body.', { cause: error })\n  }\n\n  if (!isRecord(body)) {\n    throw new Error('Generation request body must be a JSON object.')\n  }\n\n  return generationParamsFromBody(kind, body)\n}\n\nexport enum EventType {\n  TEXT_MESSAGE_START = 'TEXT_MESSAGE_START',\n  TEXT_MESSAGE_CONTENT = 'TEXT_MESSAGE_CONTENT',\n  TEXT_MESSAGE_END = 'TEXT_MESSAGE_END',\n  TEXT_MESSAGE_CHUNK = 'TEXT_MESSAGE_CHUNK',\n  TOOL_CALL_START = 'TOOL_CALL_START',\n  TOOL_CALL_ARGS = 'TOOL_CALL_ARGS',\n  TOOL_CALL_END = 'TOOL_CALL_END',\n  TOOL_CALL_CHUNK = 'TOOL_CALL_CHUNK',\n  TOOL_CALL_RESULT = 'TOOL_CALL_RESULT',\n  THINKING_START = 'THINKING_START',\n  THINKING_END = 'THINKING_END',\n  THINKING_TEXT_MESSAGE_START = 'THINKING_TEXT_MESSAGE_START',\n  THINKING_TEXT_MESSAGE_CONTENT = 'THINKING_TEXT_MESSAGE_CONTENT',\n  THINKING_TEXT_MESSAGE_END = 'THINKING_TEXT_MESSAGE_END',\n  STATE_SNAPSHOT = 'STATE_SNAPSHOT',\n  STATE_DELTA = 'STATE_DELTA',\n  MESSAGES_SNAPSHOT = 'MESSAGES_SNAPSHOT',\n  ACTIVITY_SNAPSHOT = 'ACTIVITY_SNAPSHOT',\n  ACTIVITY_DELTA = 'ACTIVITY_DELTA',\n  RAW = 'RAW',\n  CUSTOM = 'CUSTOM',\n  RUN_STARTED = 'RUN_STARTED',\n  RUN_FINISHED = 'RUN_FINISHED',\n  RUN_ERROR = 'RUN_ERROR',\n  STEP_STARTED = 'STEP_STARTED',\n  STEP_FINISHED = 'STEP_FINISHED',\n  REASONING_START = 'REASONING_START',\n  REASONING_MESSAGE_START = 'REASONING_MESSAGE_START',\n  REASONING_MESSAGE_CONTENT = 'REASONING_MESSAGE_CONTENT',\n  REASONING_MESSAGE_END = 'REASONING_MESSAGE_END',\n  REASONING_MESSAGE_CHUNK = 'REASONING_MESSAGE_CHUNK',\n  REASONING_END = 'REASONING_END',\n  REASONING_ENCRYPTED_VALUE = 'REASONING_ENCRYPTED_VALUE',\n}\n\nexport {\n  toolDefinition,\n  type AnyClientTool,\n  type ClientTool,\n  type InferToolInput,\n  type InferToolName,\n  type InferToolOutput,\n  type ApprovalCapabilityOf,\n  type ApprovalSchemaConfig,\n  type ApprovalSchemaOf,\n  type InputSchemaOf,\n  type OutputSchemaOf,\n  type NoSchema,\n  type ToolDefinition,\n  type ToolDefinitionConfig,\n  type ToolDefinitionInstance,\n} from './activities/chat/tools/tool-definition'\n\nexport {\n  hashSchemaInput,\n  normalizeApprovalSchema,\n  type NormalizedApprovalSchema,\n  type NormalizedSchemaInput,\n} from './activities/chat/tools/approval-schema'\n\nexport {\n  canonicalInterruptJson,\n  cloneAndDeepFreezeJson,\n  digestInterruptJson,\n} from './interrupt-serialization'\n\nexport {\n  convertSchemaToJsonSchema,\n  isStandardSchema,\n  parseWithStandardSchema,\n  validateWithStandardSchema,\n} from './activities/chat/tools/schema-converter'\n\nexport {\n  convertMessagesToModelMessages,\n  generateMessageId,\n  modelMessageToUIMessage,\n  modelMessagesToUIMessages,\n  normalizeToUIMessage,\n  uiMessageToModelMessages,\n} from './activities/chat/messages'\n\nexport {\n  BatchStrategy,\n  CompositeStrategy,\n  defaultJSONParser,\n  ImmediateStrategy,\n  parsePartialJSON,\n  PartialJSONParser,\n  PunctuationStrategy,\n  StreamProcessor,\n  WordBoundaryStrategy,\n} from './activities/chat/stream/index'\nexport type {\n  ChunkRecording,\n  ChunkStrategy,\n  InternalToolCallState,\n  JSONParser,\n  ProcessorResult,\n  ProcessorState,\n  StreamProcessorEvents,\n  StreamProcessorOptions,\n  ToolCallState,\n  ToolResultState,\n} from './activities/chat/stream/index'\n\nexport { uiMessagesToWire } from './utilities/ag-ui-wire'\nexport type { WireMessage } from './utilities/ag-ui-wire'\n\nexport type {\n  AudioPart,\n  ContentPart,\n  ContentPartDataSource,\n  ContentPartSource,\n  ContentPartUrlSource,\n  CustomEvent,\n  DocumentPart,\n  ImagePart,\n  MediaInputMetadata,\n  MediaInputRole,\n  MediaPrompt,\n  MediaPromptPart,\n  MessagePart,\n  ModelMessage,\n  PersistedArtifactActivity,\n  PersistedArtifactRef,\n  PersistedArtifactRole,\n  Interrupt,\n  RunAgentResumeItem,\n  RunErrorEvent,\n  RunFinishedEvent,\n  RunFinishedOutcome,\n  SchemaInput,\n  StreamChunk,\n  StructuredOutputPart,\n  TextPart,\n  ThinkingPart,\n  ToolCall,\n  ToolCallPart,\n  ToolResultPart,\n  UIMessage,\n  UIResourcePart,\n  VideoPart,\n  InferSchemaType,\n} from './types'\n\n// Enumerated, not `export *` — see the matching note in `index.ts`. The\n// interrupt protocol surface is a commitment, so it is published field by\n// field.\nexport {\n  INTERRUPT_BINDING_VERSION,\n  canonicalizeInterruptResolutions,\n} from './interrupts'\nexport {\n  defineInterrupt,\n  hashInterruptDefinitionSchema,\n  INTERRUPT_PAYLOAD_METADATA_KEY,\n} from './interrupt-definition'\nexport {\n  INTERRUPT_CONTINUATION_METADATA_KEY,\n  INTERRUPT_CONTINUATION_VERSION,\n  genericInterruptContinuationFromDescriptor,\n  readGenericInterruptContinuation,\n  wrapGenericInterruptContinuation,\n} from './generic-interrupt-continuation'\nexport type {\n  GenericInterruptContinuation,\n  GenericInterruptContinuationReadResult,\n} from './generic-interrupt-continuation'\nexport type {\n  GenericInterruptRequest,\n  InterruptDefinition,\n} from './interrupt-definition'\nexport type {\n  BatchInterruptError,\n  BatchInterruptErrorCode,\n  InterruptBinding,\n  InterruptCorrelation,\n  InterruptSubmissionError,\n  ItemInterruptError,\n  ItemInterruptErrorCode,\n  ToolApprovalResolution,\n  UnopenedInterruptBinding,\n} from './interrupts'\n\nexport {\n  INTERRUPT_BINDING_METADATA_KEY,\n  readInterruptBinding,\n  readUnopenedInterruptBinding,\n  withInterruptBinding,\n  withoutInterruptBinding,\n} from './interrupt-resume'\n\nexport type {\n  AudioVisualization,\n  RealtimeAdapter,\n  RealtimeConnection,\n  RealtimeError,\n  RealtimeErrorCode,\n  RealtimeEvent,\n  RealtimeEventHandler,\n  RealtimeEventPayloads,\n  RealtimeMessage,\n  RealtimeMessagePart,\n  RealtimeMode,\n  RealtimeSessionConfig,\n  RealtimeStatus,\n  RealtimeToken,\n  RealtimeAudioPart,\n  RealtimeImagePart,\n  RealtimeTextPart,\n  RealtimeToolCallPart,\n  RealtimeToolResultPart,\n  VADConfig,\n} from './realtime/types'\n"],"mappings":"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"}

package/dist/esm/generic-interrupt-continuation.d.ts

@@ -0,0 +1,45 @@
+import { Interrupt } from './types.js';
+/**
+ * `ResumeEntry.metadata` key for a first-party generic request.
+ *
+ * AG-UI `resume` only carries the answer (`interruptId`, `status`, `payload`).
+ * The original request rides here so an ephemeral server can rebuild it.
+ */
+export declare const INTERRUPT_CONTINUATION_METADATA_KEY: "tanstack:interruptContinuation";
+export declare const INTERRUPT_CONTINUATION_VERSION: 1;
+export interface GenericInterruptContinuation {
+    v: typeof INTERRUPT_CONTINUATION_VERSION;
+    definitionId: string;
+    key: string;
+    batchIndex: number;
+    reason: string;
+    message: string;
+    expiresAt?: string;
+    responseSchemaHash?: string;
+    payloadSchemaHash?: string;
+    payload?: unknown;
+}
+export type GenericInterruptContinuationReadResult = {
+    status: 'absent';
+} | {
+    status: 'invalid';
+    message: string;
+} | {
+    status: 'ok';
+    value: GenericInterruptContinuation;
+};
+/**
+ * Read one generic request from `resume[].metadata`.
+ *
+ * Missing key means this resume item is not a first-party generic continuation.
+ * A present key that fails the shape is a protocol error.
+ */
+export declare function readGenericInterruptContinuation(metadata: unknown): GenericInterruptContinuationReadResult;
+/** Put a parsed continuation on `ResumeEntry.metadata`. */
+export declare function wrapGenericInterruptContinuation(continuation: GenericInterruptContinuation): Record<string, unknown>;
+/**
+ * Build the resume-metadata continuation from an outbound AG-UI interrupt.
+ *
+ * Returns `undefined` when the descriptor is not a first-party generic item.
+ */
+export declare function genericInterruptContinuationFromDescriptor(interrupt: Interrupt): GenericInterruptContinuation | undefined;

package/dist/esm/generic-interrupt-continuation.js

@@ -0,0 +1,80 @@
+import { readUnopenedInterruptBinding } from "./interrupt-resume.js";
+import { INTERRUPT_PAYLOAD_METADATA_KEY } from "./interrupt-definition.js";
+//#region src/generic-interrupt-continuation.ts
+/**
+* `ResumeEntry.metadata` key for a first-party generic request.
+*
+* AG-UI `resume` only carries the answer (`interruptId`, `status`, `payload`).
+* The original request rides here so an ephemeral server can rebuild it.
+*/
+var INTERRUPT_CONTINUATION_METADATA_KEY = "tanstack:interruptContinuation";
+var INTERRUPT_CONTINUATION_VERSION = 1;
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function invalid(message) {
+	return {
+		status: "invalid",
+		message
+	};
+}
+/**
+* Read one generic request from `resume[].metadata`.
+*
+* Missing key means this resume item is not a first-party generic continuation.
+* A present key that fails the shape is a protocol error.
+*/
+function readGenericInterruptContinuation(metadata) {
+	if (metadata === void 0) return { status: "absent" };
+	if (!isRecord(metadata)) return invalid("Generic interrupt resume metadata must be an object.");
+	if (!Object.prototype.hasOwnProperty.call(metadata, "tanstack:interruptContinuation")) return { status: "absent" };
+	const raw = metadata[INTERRUPT_CONTINUATION_METADATA_KEY];
+	if (!isRecord(raw)) return invalid("Generic interrupt continuation is invalid.");
+	if (raw.v !== 1 || typeof raw.definitionId !== "string" || typeof raw.key !== "string" || typeof raw.reason !== "string" || typeof raw.message !== "string" || typeof raw.batchIndex !== "number" || !Number.isInteger(raw.batchIndex) || raw.batchIndex < 0 || raw.responseSchemaHash !== void 0 && typeof raw.responseSchemaHash !== "string" || raw.expiresAt !== void 0 && typeof raw.expiresAt !== "string" || raw.payloadSchemaHash !== void 0 && typeof raw.payloadSchemaHash !== "string") return invalid("Generic interrupt continuation contains invalid fields.");
+	return {
+		status: "ok",
+		value: {
+			v: 1,
+			definitionId: raw.definitionId,
+			key: raw.key,
+			batchIndex: raw.batchIndex,
+			reason: raw.reason,
+			message: raw.message,
+			...typeof raw.expiresAt === "string" ? { expiresAt: raw.expiresAt } : {},
+			...typeof raw.responseSchemaHash === "string" ? { responseSchemaHash: raw.responseSchemaHash } : {},
+			...typeof raw.payloadSchemaHash === "string" ? { payloadSchemaHash: raw.payloadSchemaHash } : {},
+			...Object.prototype.hasOwnProperty.call(raw, "payload") ? { payload: raw.payload } : {}
+		}
+	};
+}
+/** Put a parsed continuation on `ResumeEntry.metadata`. */
+function wrapGenericInterruptContinuation(continuation) {
+	return { [INTERRUPT_CONTINUATION_METADATA_KEY]: continuation };
+}
+/**
+* Build the resume-metadata continuation from an outbound AG-UI interrupt.
+*
+* Returns `undefined` when the descriptor is not a first-party generic item.
+*/
+function genericInterruptContinuationFromDescriptor(interrupt) {
+	const binding = readUnopenedInterruptBinding(interrupt);
+	if (binding?.kind !== "generic" || binding.definitionId === void 0 || binding.key === void 0 || binding.batchIndex === void 0) return;
+	const metadata = isRecord(interrupt.metadata) ? interrupt.metadata : void 0;
+	const hasPayload = metadata !== void 0 && Object.prototype.hasOwnProperty.call(metadata, "tanstack:interruptPayload");
+	return {
+		v: 1,
+		definitionId: binding.definitionId,
+		key: binding.key,
+		batchIndex: binding.batchIndex,
+		reason: interrupt.reason,
+		message: interrupt.message ?? "",
+		...interrupt.expiresAt !== void 0 ? { expiresAt: interrupt.expiresAt } : {},
+		...binding.responseSchemaHash !== void 0 ? { responseSchemaHash: binding.responseSchemaHash } : {},
+		...binding.payloadSchemaHash !== void 0 ? { payloadSchemaHash: binding.payloadSchemaHash } : {},
+		...hasPayload ? { payload: metadata[INTERRUPT_PAYLOAD_METADATA_KEY] } : {}
+	};
+}
+//#endregion
+export { INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, genericInterruptContinuationFromDescriptor, readGenericInterruptContinuation, wrapGenericInterruptContinuation };
+
+//# sourceMappingURL=generic-interrupt-continuation.js.map

package/dist/esm/generic-interrupt-continuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-interrupt-continuation.js","names":[],"sources":["../../src/generic-interrupt-continuation.ts"],"sourcesContent":["import { INTERRUPT_PAYLOAD_METADATA_KEY } from './interrupt-definition'\nimport { readUnopenedInterruptBinding } from './interrupt-resume'\nimport type { Interrupt } from './types'\n\n/**\n * `ResumeEntry.metadata` key for a first-party generic request.\n *\n * AG-UI `resume` only carries the answer (`interruptId`, `status`, `payload`).\n * The original request rides here so an ephemeral server can rebuild it.\n */\nexport const INTERRUPT_CONTINUATION_METADATA_KEY =\n  'tanstack:interruptContinuation' as const\n\nexport const INTERRUPT_CONTINUATION_VERSION = 1 as const\n\nexport interface GenericInterruptContinuation {\n  v: typeof INTERRUPT_CONTINUATION_VERSION\n  definitionId: string\n  key: string\n  batchIndex: number\n  reason: string\n  message: string\n  expiresAt?: string\n  responseSchemaHash?: string\n  payloadSchemaHash?: string\n  payload?: unknown\n}\n\nexport type GenericInterruptContinuationReadResult =\n  | { status: 'absent' }\n  | { status: 'invalid'; message: string }\n  | { status: 'ok'; value: GenericInterruptContinuation }\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n}\n\nfunction invalid(\n  message: string,\n): Extract<GenericInterruptContinuationReadResult, { status: 'invalid' }> {\n  return { status: 'invalid', message }\n}\n\n/**\n * Read one generic request from `resume[].metadata`.\n *\n * Missing key means this resume item is not a first-party generic continuation.\n * A present key that fails the shape is a protocol error.\n */\nexport function readGenericInterruptContinuation(\n  metadata: unknown,\n): GenericInterruptContinuationReadResult {\n  if (metadata === undefined) return { status: 'absent' }\n  if (!isRecord(metadata)) {\n    return invalid('Generic interrupt resume metadata must be an object.')\n  }\n  if (\n    !Object.prototype.hasOwnProperty.call(\n      metadata,\n      INTERRUPT_CONTINUATION_METADATA_KEY,\n    )\n  ) {\n    return { status: 'absent' }\n  }\n  const raw = metadata[INTERRUPT_CONTINUATION_METADATA_KEY]\n  if (!isRecord(raw)) {\n    return invalid('Generic interrupt continuation is invalid.')\n  }\n  if (\n    raw.v !== INTERRUPT_CONTINUATION_VERSION ||\n    typeof raw.definitionId !== 'string' ||\n    typeof raw.key !== 'string' ||\n    typeof raw.reason !== 'string' ||\n    typeof raw.message !== 'string' ||\n    typeof raw.batchIndex !== 'number' ||\n    !Number.isInteger(raw.batchIndex) ||\n    raw.batchIndex < 0 ||\n    (raw.responseSchemaHash !== undefined &&\n      typeof raw.responseSchemaHash !== 'string') ||\n    (raw.expiresAt !== undefined && typeof raw.expiresAt !== 'string') ||\n    (raw.payloadSchemaHash !== undefined &&\n      typeof raw.payloadSchemaHash !== 'string')\n  ) {\n    return invalid('Generic interrupt continuation contains invalid fields.')\n  }\n  return {\n    status: 'ok',\n    value: {\n      v: INTERRUPT_CONTINUATION_VERSION,\n      definitionId: raw.definitionId,\n      key: raw.key,\n      batchIndex: raw.batchIndex,\n      reason: raw.reason,\n      message: raw.message,\n      ...(typeof raw.expiresAt === 'string'\n        ? { expiresAt: raw.expiresAt }\n        : {}),\n      ...(typeof raw.responseSchemaHash === 'string'\n        ? { responseSchemaHash: raw.responseSchemaHash }\n        : {}),\n      ...(typeof raw.payloadSchemaHash === 'string'\n        ? { payloadSchemaHash: raw.payloadSchemaHash }\n        : {}),\n      ...(Object.prototype.hasOwnProperty.call(raw, 'payload')\n        ? { payload: raw.payload }\n        : {}),\n    },\n  }\n}\n\n/** Put a parsed continuation on `ResumeEntry.metadata`. */\nexport function wrapGenericInterruptContinuation(\n  continuation: GenericInterruptContinuation,\n): Record<string, unknown> {\n  return { [INTERRUPT_CONTINUATION_METADATA_KEY]: continuation }\n}\n\n/**\n * Build the resume-metadata continuation from an outbound AG-UI interrupt.\n *\n * Returns `undefined` when the descriptor is not a first-party generic item.\n */\nexport function genericInterruptContinuationFromDescriptor(\n  interrupt: Interrupt,\n): GenericInterruptContinuation | undefined {\n  const binding = readUnopenedInterruptBinding(interrupt)\n  if (\n    binding?.kind !== 'generic' ||\n    binding.definitionId === undefined ||\n    binding.key === undefined ||\n    binding.batchIndex === undefined\n  ) {\n    return undefined\n  }\n  const metadata = isRecord(interrupt.metadata) ? interrupt.metadata : undefined\n  const hasPayload =\n    metadata !== undefined &&\n    Object.prototype.hasOwnProperty.call(\n      metadata,\n      INTERRUPT_PAYLOAD_METADATA_KEY,\n    )\n  return {\n    v: INTERRUPT_CONTINUATION_VERSION,\n    definitionId: binding.definitionId,\n    key: binding.key,\n    batchIndex: binding.batchIndex,\n    reason: interrupt.reason,\n    message: interrupt.message ?? '',\n    ...(interrupt.expiresAt !== undefined\n      ? { expiresAt: interrupt.expiresAt }\n      : {}),\n    ...(binding.responseSchemaHash !== undefined\n      ? { responseSchemaHash: binding.responseSchemaHash }\n      : {}),\n    ...(binding.payloadSchemaHash !== undefined\n      ? { payloadSchemaHash: binding.payloadSchemaHash }\n      : {}),\n    ...(hasPayload\n      ? { payload: metadata[INTERRUPT_PAYLOAD_METADATA_KEY] }\n      : {}),\n  }\n}\n"],"mappings":";;;;;;;;;AAUA,IAAa,sCACX;AAEF,IAAa,iCAAiC;AAoB9C,SAAS,SAAS,OAAkD;CAClE,OAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,QACP,SACwE;CACxE,OAAO;EAAE,QAAQ;EAAW;CAAQ;AACtC;;;;;;;AAQA,SAAgB,iCACd,UACwC;CACxC,IAAI,aAAa,KAAA,GAAW,OAAO,EAAE,QAAQ,SAAS;CACtD,IAAI,CAAC,SAAS,QAAQ,GACpB,OAAO,QAAQ,sDAAsD;CAEvE,IACE,CAAC,OAAO,UAAU,eAAe,KAC/B,UAAA,gCAEF,GAEA,OAAO,EAAE,QAAQ,SAAS;CAE5B,MAAM,MAAM,SAAS;CACrB,IAAI,CAAC,SAAS,GAAG,GACf,OAAO,QAAQ,4CAA4C;CAE7D,IACE,IAAI,MAAA,KACJ,OAAO,IAAI,iBAAiB,YAC5B,OAAO,IAAI,QAAQ,YACnB,OAAO,IAAI,WAAW,YACtB,OAAO,IAAI,YAAY,YACvB,OAAO,IAAI,eAAe,YAC1B,CAAC,OAAO,UAAU,IAAI,UAAU,KAChC,IAAI,aAAa,KAChB,IAAI,uBAAuB,KAAA,KAC1B,OAAO,IAAI,uBAAuB,YACnC,IAAI,cAAc,KAAA,KAAa,OAAO,IAAI,cAAc,YACxD,IAAI,sBAAsB,KAAA,KACzB,OAAO,IAAI,sBAAsB,UAEnC,OAAO,QAAQ,yDAAyD;CAE1E,OAAO;EACL,QAAQ;EACR,OAAO;GACL,GAAA;GACA,cAAc,IAAI;GAClB,KAAK,IAAI;GACT,YAAY,IAAI;GAChB,QAAQ,IAAI;GACZ,SAAS,IAAI;GACb,GAAI,OAAO,IAAI,cAAc,WACzB,EAAE,WAAW,IAAI,UAAU,IAC3B,CAAC;GACL,GAAI,OAAO,IAAI,uBAAuB,WAClC,EAAE,oBAAoB,IAAI,mBAAmB,IAC7C,CAAC;GACL,GAAI,OAAO,IAAI,sBAAsB,WACjC,EAAE,mBAAmB,IAAI,kBAAkB,IAC3C,CAAC;GACL,GAAI,OAAO,UAAU,eAAe,KAAK,KAAK,SAAS,IACnD,EAAE,SAAS,IAAI,QAAQ,IACvB,CAAC;EACP;CACF;AACF;;AAGA,SAAgB,iCACd,cACyB;CACzB,OAAO,GAAG,sCAAsC,aAAa;AAC/D;;;;;;AAOA,SAAgB,2CACd,WAC0C;CAC1C,MAAM,UAAU,6BAA6B,SAAS;CACtD,IACE,SAAS,SAAS,aAClB,QAAQ,iBAAiB,KAAA,KACzB,QAAQ,QAAQ,KAAA,KAChB,QAAQ,eAAe,KAAA,GAEvB;CAEF,MAAM,WAAW,SAAS,UAAU,QAAQ,IAAI,UAAU,WAAW,KAAA;CACrE,MAAM,aACJ,aAAa,KAAA,KACb,OAAO,UAAU,eAAe,KAC9B,UAAA,2BAEF;CACF,OAAO;EACL,GAAA;EACA,cAAc,QAAQ;EACtB,KAAK,QAAQ;EACb,YAAY,QAAQ;EACpB,QAAQ,UAAU;EAClB,SAAS,UAAU,WAAW;EAC9B,GAAI,UAAU,cAAc,KAAA,IACxB,EAAE,WAAW,UAAU,UAAU,IACjC,CAAC;EACL,GAAI,QAAQ,uBAAuB,KAAA,IAC/B,EAAE,oBAAoB,QAAQ,mBAAmB,IACjD,CAAC;EACL,GAAI,QAAQ,sBAAsB,KAAA,IAC9B,EAAE,mBAAmB,QAAQ,kBAAkB,IAC/C,CAAC;EACL,GAAI,aACA,EAAE,SAAS,SAAS,gCAAgC,IACpD,CAAC;CACP;AACF"}

package/dist/esm/index.d.ts

@@ -16,18 +16,26 @@ export { canonicalInterruptJson, cloneAndDeepFreezeJson, digestInterruptJson, }
 export { INTERRUPT_BINDING_METADATA_KEY, InterruptResumeValidationError, interruptItemError, readInterruptBinding, readUnopenedInterruptBinding, validateInterruptResumeBatch, withInterruptBinding, withoutInterruptBinding, type PendingInterruptResumeRecord, type ValidateInterruptResumeBatchInput, type ValidatedInterruptResumeBatch, } from './interrupt-resume.js';
 export type { MCPToolSource, ChatMCPOptions, MCPConnectionPolicy, } from './activities/chat/mcp/types.js';
 export { MCPDuplicateToolNameError } from './activities/chat/mcp/manager.js';
+export { DuplicateToolNameError } from './activities/chat/tools/unique-tool-names.js';
 export { convertSchemaToJsonSchema, isStandardSchema, parseWithStandardSchema, validateWithStandardSchema, StandardSchemaValidationError, } from './activities/chat/tools/schema-converter.js';
 export { streamToText, toServerSentEventsStream, toServerSentEventsResponse, resumeServerSentEventsResponse, toHttpStream, toHttpResponse, resumeHttpResponse, resolveResumeRunId, RUN_ACCEPTED_EVENT, } from './stream-to-response.js';
 export type { RunDriverOptions } from './stream-to-response.js';
 export { memoryStream, replayRunStream } from './stream-durability.js';
 export type { MemoryStreamInit, MemoryStreamOptions, StreamDurability, UpsertableStreamDurability, } from './stream-durability.js';
+export { toWebSocketStream, toWebSocketResponse, resumeWebSocketStream, resumeWebSocketResponse, encodeWsFrame, decodeWsFrame, } from './stream-to-websocket.js';
+export type { WebSocketLike, WsRunContext, WebSocketStreamInit, InboundFrame, } from './stream-to-websocket.js';
 export { ToolCallManager } from './activities/chat/tools/tool-calls.js';
 export { DISCOVERY_TOOL_NAME } from './activities/chat/tools/lazy-tool-manager.js';
 export type { ProviderTool } from './tools/provider-tool.js';
 export { brandProviderTool } from './tools/provider-tool.js';
 export { maxIterations, untilFinishReason, combineStrategies, } from './activities/chat/agent-loop-strategies.js';
 export { createToolRegistry, createFrozenRegistry, type ToolRegistry, } from './tool-registry.js';
-export type { ChatMiddleware, ChatMiddlewareContext, ChatMiddlewarePhase, ChatMiddlewareConfig, ChatResumeToolState, ChatResumeGenericResolution, StructuredOutputMiddlewareConfig, ToolCallHookContext, BeforeToolCallDecision, AfterToolCallInfo, IterationInfo, ToolPhaseCompleteInfo, UsageInfo, FinishInfo, AbortInfo, ErrorInfo, SandboxFileEvent, SandboxFileHookEvent, ChatSandboxHooks, } from './activities/chat/middleware/index.js';
+export type { ChatMiddleware, ChatMiddlewareContext, ChatMiddlewarePhase, ChatMiddlewareConfig, ChatResumeToolState, ChatResumeGenericResolution, StructuredOutputMiddlewareConfig, ToolCallHookContext, BeforeToolCallDecision, AfterToolCallInfo, IterationInfo, ToolPhaseCompleteInfo, UsageInfo, FinishInfo, AbortInfo, ErrorInfo, SandboxFileEvent, SandboxFileHookEvent, ChatSandboxHooks, InterruptBoundaryPhase, InterruptToolResume, InterruptResolutionCollection, GenericInterruptResolution, InterruptBoundaryResult, InterruptResolutionResult, } from './activities/chat/middleware/index.js';
+export { INTERRUPT_BOUNDARY_PHASES, INTERRUPT_TOOL_RESUMES, } from './activities/chat/middleware/index.js';
+export { defineInterrupt, createInterruptBinding, INTERRUPT_PAYLOAD_METADATA_KEY, } from './interrupt-definition.js';
+export { INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, genericInterruptContinuationFromDescriptor, readGenericInterruptContinuation, wrapGenericInterruptContinuation, } from './generic-interrupt-continuation.js';
+export type { GenericInterruptContinuation, GenericInterruptContinuationReadResult, } from './generic-interrupt-continuation.js';
+export type { InterruptDefinition, GenericInterruptRequest, InterruptDefinitionOptions, InterruptBindingDescriptor, } from './interrupt-definition.js';
 export { INTERRUPT_BINDING_VERSION, canonicalizeInterruptResolutions, } from './interrupts.js';
 export type { BatchInterruptError, BatchInterruptErrorCode, InterruptBinding, InterruptCorrelation, InterruptSubmissionError, ItemInterruptError, ItemInterruptErrorCode, ToolApprovalResolution, UnopenedInterruptBinding, } from './interrupts.js';
 export type { GenerationMiddleware, GenerationMiddlewareContext, GenerationActivity, GenerationUsageInfo, GenerationFinishInfo, GenerationAbortInfo, GenerationErrorInfo, AnyGenerationMiddleware, GenerationResultTransform, GenerationResultTransformContext, } from './activities/middleware/index.js';

package/dist/esm/index.js

@@ -10,10 +10,13 @@ import { INTERRUPT_BINDING_VERSION, canonicalizeInterruptResolutions } from "./i
 import { StandardSchemaValidationError, convertSchemaToJsonSchema, isStandardSchema, parseWithStandardSchema, validateWithStandardSchema } from "./activities/chat/tools/schema-converter.js";
 import { hashSchemaInput, normalizeApprovalSchema } from "./activities/chat/tools/approval-schema.js";
 import { INTERRUPT_BINDING_METADATA_KEY, InterruptResumeValidationError, interruptItemError, readInterruptBinding, readUnopenedInterruptBinding, validateInterruptResumeBatch, withInterruptBinding, withoutInterruptBinding } from "./interrupt-resume.js";
+import { INTERRUPT_PAYLOAD_METADATA_KEY, createInterruptBinding, defineInterrupt } from "./interrupt-definition.js";
+import { INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, genericInterruptContinuationFromDescriptor, readGenericInterruptContinuation, wrapGenericInterruptContinuation } from "./generic-interrupt-continuation.js";
 import { isContentPart, isContentPartArray, normalizeToolResult } from "./utilities/tool-result.js";
 import { getProviderExecutedMetadata, isProviderExecutedToolCall } from "./utilities/provider-executed.js";
 import { firstSentence, renderLazyCatalogEntry } from "./activities/chat/tools/lazy-tools.js";
 import { DISCOVERY_TOOL_NAME } from "./activities/chat/tools/lazy-tool-manager.js";
+import { DuplicateToolNameError } from "./activities/chat/tools/unique-tool-names.js";
 import { ToolCallManager } from "./activities/chat/tools/tool-calls.js";
 import { combineStrategies, maxIterations, untilFinishReason } from "./activities/chat/agent-loop-strategies.js";
 import { convertMessagesToModelMessages, generateMessageId, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeToUIMessage, uiMessageToModelMessages } from "./activities/chat/messages.js";
@@ -31,8 +34,11 @@ import { createTranscriptionOptions, generateTranscription } from "./activities/
 import { countEmbeddingInputModalities, requireTextOnlyEmbeddingInput, resolveEmbeddingInput } from "./utilities/embedding-input.js";
 import { createEmbedOptions, embed } from "./activities/embed/index.js";
 import { toolDefinition } from "./activities/chat/tools/tool-definition.js";
+import { chatParamsFromRequest, chatParamsFromRequestBody, mergeAgentTools } from "./utilities/chat-params.js";
+import { decodeWsFrame, encodeWsFrame, resumeWebSocketResponse, resumeWebSocketStream, toWebSocketResponse, toWebSocketStream } from "./stream-to-websocket.js";
 import { brandProviderTool } from "./tools/provider-tool.js";
 import { createFrozenRegistry, createToolRegistry } from "./tool-registry.js";
+import { INTERRUPT_BOUNDARY_PHASES, INTERRUPT_TOOL_RESUMES } from "./activities/chat/middleware/types.js";
 import { defineChatMiddleware } from "./activities/chat/middleware/define.js";
 import { createChatMiddleware } from "./activities/chat/middleware/builder.js";
 import { CUSTOM_EVENT, isCustomEvent } from "./custom-events.js";
@@ -44,8 +50,7 @@ import { realtimeToken } from "./realtime/index.js";
 import { PartialJSONParser, defaultJSONParser, parsePartialJSON } from "./activities/chat/stream/json-parser.js";
 import { BatchStrategy, CompositeStrategy, ImmediateStrategy, PunctuationStrategy, WordBoundaryStrategy } from "./activities/chat/stream/strategies.js";
 import { StreamProcessor, createReplayStream } from "./activities/chat/stream/processor.js";
-import { chatParamsFromRequest, chatParamsFromRequestBody, mergeAgentTools } from "./utilities/chat-params.js";
 import { uiMessagesToWire } from "./utilities/ag-ui-wire.js";
 import { generationParamsFromBody, generationParamsFromRequest } from "./client.js";
 import { createModel, extendAdapter } from "./extend-adapter.js";
-export { BaseRerankAdapter, BatchStrategy, CUSTOM_EVENT, CompositeStrategy, ConsoleLogger, DISCOVERY_TOOL_NAME, DetachableRunCapability, EventType, INTERRUPT_BINDING_METADATA_KEY, INTERRUPT_BINDING_VERSION, ImmediateStrategy, InMemoryRunStore, InterruptResumeValidationError, MCPDuplicateToolNameError, PartialJSONParser, PunctuationStrategy, RUN_ACCEPTED_EVENT, RUN_CANCEL_REASON, RunDetachedCapability, StandardSchemaValidationError, StreamProcessor, ToolCallManager, WordBoundaryStrategy, brandProviderTool, buildBaseUsage, canonicalInterruptJson, canonicalizeInterruptResolutions, chat, chatParamsFromRequest, chatParamsFromRequestBody, cloneAndDeepFreezeJson, combineStrategies, convertMessagesToModelMessages, convertSchemaToJsonSchema, countEmbeddingInputModalities, createAudioOptions, createCapability, createChatMiddleware, createChatOptions, createEmbedOptions, createFrozenRegistry, createImageOptions, createModel, createRealtimeEventEmitter, createReplayStream, createRerankOptions, createSpeechOptions, createSummarizeOptions, createToolRegistry, createTranscriptionOptions, createVideoOptions, defaultJSONParser, defineChatMiddleware, defineRunStore, detectImageMimeType, digestInterruptJson, embed, extendAdapter, firstSentence, generateAudio, generateImage, generateMessageId, generateSpeech, generateTranscription, generateVideo, generationParamsFromBody, generationParamsFromRequest, getDetachableRun, getProviderExecutedMetadata, getRunDetached, getVideoJobStatus, hashSchemaInput, interruptItemError, isCancelRequestedReason, isContentPart, isContentPartArray, isCustomEvent, isProviderExecutedToolCall, isRunStatus, isStandardSchema, isTerminalRunStatus, maxIterations, memoryStream, mergeAgentTools, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeApprovalSchema, normalizeSystemPrompts, normalizeToUIMessage, normalizeToolResult, parsePartialJSON, parseWithStandardSchema, provideDetachableRun, provideRunDetached, readInterruptBinding, readUnopenedInterruptBinding, realtimeToken, renderLazyCatalogEntry, replayRunStream, requestRunCancel, requireTextOnlyEmbeddingInput, rerank, resolveEmbeddingInput, resolveMediaPrompt, resolveResumeRunId, resumeHttpResponse, resumeServerSentEventsResponse, streamToText, summarize, toHttpResponse, toHttpStream, toServerSentEventsResponse, toServerSentEventsStream, toolDefinition, uiMessageToModelMessages, uiMessagesToWire, untilFinishReason, validateInterruptResumeBatch, validateWithStandardSchema, wasCancelRequested, withInterruptBinding, withoutInterruptBinding };
+export { BaseRerankAdapter, BatchStrategy, CUSTOM_EVENT, CompositeStrategy, ConsoleLogger, DISCOVERY_TOOL_NAME, DetachableRunCapability, DuplicateToolNameError, EventType, INTERRUPT_BINDING_METADATA_KEY, INTERRUPT_BINDING_VERSION, INTERRUPT_BOUNDARY_PHASES, INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, INTERRUPT_PAYLOAD_METADATA_KEY, INTERRUPT_TOOL_RESUMES, ImmediateStrategy, InMemoryRunStore, InterruptResumeValidationError, MCPDuplicateToolNameError, PartialJSONParser, PunctuationStrategy, RUN_ACCEPTED_EVENT, RUN_CANCEL_REASON, RunDetachedCapability, StandardSchemaValidationError, StreamProcessor, ToolCallManager, WordBoundaryStrategy, brandProviderTool, buildBaseUsage, canonicalInterruptJson, canonicalizeInterruptResolutions, chat, chatParamsFromRequest, chatParamsFromRequestBody, cloneAndDeepFreezeJson, combineStrategies, convertMessagesToModelMessages, convertSchemaToJsonSchema, countEmbeddingInputModalities, createAudioOptions, createCapability, createChatMiddleware, createChatOptions, createEmbedOptions, createFrozenRegistry, createImageOptions, createInterruptBinding, createModel, createRealtimeEventEmitter, createReplayStream, createRerankOptions, createSpeechOptions, createSummarizeOptions, createToolRegistry, createTranscriptionOptions, createVideoOptions, decodeWsFrame, defaultJSONParser, defineChatMiddleware, defineInterrupt, defineRunStore, detectImageMimeType, digestInterruptJson, embed, encodeWsFrame, extendAdapter, firstSentence, generateAudio, generateImage, generateMessageId, generateSpeech, generateTranscription, generateVideo, generationParamsFromBody, generationParamsFromRequest, genericInterruptContinuationFromDescriptor, getDetachableRun, getProviderExecutedMetadata, getRunDetached, getVideoJobStatus, hashSchemaInput, interruptItemError, isCancelRequestedReason, isContentPart, isContentPartArray, isCustomEvent, isProviderExecutedToolCall, isRunStatus, isStandardSchema, isTerminalRunStatus, maxIterations, memoryStream, mergeAgentTools, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeApprovalSchema, normalizeSystemPrompts, normalizeToUIMessage, normalizeToolResult, parsePartialJSON, parseWithStandardSchema, provideDetachableRun, provideRunDetached, readGenericInterruptContinuation, readInterruptBinding, readUnopenedInterruptBinding, realtimeToken, renderLazyCatalogEntry, replayRunStream, requestRunCancel, requireTextOnlyEmbeddingInput, rerank, resolveEmbeddingInput, resolveMediaPrompt, resolveResumeRunId, resumeHttpResponse, resumeServerSentEventsResponse, resumeWebSocketResponse, resumeWebSocketStream, streamToText, summarize, toHttpResponse, toHttpStream, toServerSentEventsResponse, toServerSentEventsStream, toWebSocketResponse, toWebSocketStream, toolDefinition, uiMessageToModelMessages, uiMessagesToWire, untilFinishReason, validateInterruptResumeBatch, validateWithStandardSchema, wasCancelRequested, withInterruptBinding, withoutInterruptBinding, wrapGenericInterruptContinuation };

package/dist/esm/interrupt-definition.d.ts

@@ -0,0 +1,113 @@
+import { StandardJSONSchemaV1, StandardSchemaV1 } from '@standard-schema/spec';
+import { INTERRUPT_BINDING_VERSION } from './interrupts.js';
+export declare const INTERRUPT_PAYLOAD_METADATA_KEY: "tanstack:interruptPayload";
+export declare const INTERRUPT_BINDING_KIND: "generic";
+type PortableSchema = StandardJSONSchemaV1<any, any> | StandardSchemaV1<any, any>;
+type InferSchemaOutput<TSchema> = TSchema extends StandardSchemaV1<any, infer TOutput> ? TOutput : TSchema extends StandardJSONSchemaV1<any, infer TOutput> ? TOutput : never;
+type InferSchemaInput<TSchema> = TSchema extends StandardSchemaV1<infer TInput, any> ? TInput : TSchema extends StandardJSONSchemaV1<infer TInput, any> ? TInput : never;
+export interface InterruptDefinitionOptions<TId extends string, TPayloadSchema extends PortableSchema | undefined, TResponseSchema extends PortableSchema | undefined> {
+    id: TId;
+    payloadSchema?: TPayloadSchema;
+    responseSchema?: TResponseSchema;
+}
+export interface InterruptBindingDescriptor {
+    v: typeof INTERRUPT_BINDING_VERSION;
+    kind: typeof INTERRUPT_BINDING_KIND;
+    definitionId: string;
+    key: string;
+    threadId?: string;
+    interruptedRunId?: string;
+    generation?: number;
+    batchIndex?: number;
+    responseSchemaCanonicalJson?: string;
+    payloadSchemaCanonicalJson?: string;
+    payloadSchemaHash?: string;
+    responseSchemaHash?: string;
+}
+export interface InterruptPreEmissionData {
+    descriptor: InterruptBindingDescriptor;
+    payload?: unknown;
+}
+type InterruptInput<TPayloadSchema extends PortableSchema | undefined, TPayload = unknown> = {
+    key: string;
+    reason: string;
+    message: string;
+    expiresAt?: string;
+} & ([TPayloadSchema] extends [undefined] ? {} : {
+    payload?: TPayload;
+});
+type GenericInterruptRequestBase<TDefinition extends InterruptDefinition<any, any, any, any>> = {
+    readonly definition: TDefinition;
+    readonly key: string;
+    readonly reason: string;
+    readonly message: string;
+    readonly expiresAt?: string;
+};
+type GenericInterruptRequestFor<TDefinition extends InterruptDefinition<any, any, any, any>, TPayloadSchema extends PortableSchema | undefined, TPayload> = GenericInterruptRequestBase<TDefinition> & ([TPayloadSchema] extends [undefined] ? {} : {
+    readonly payload: TPayload | undefined;
+});
+export type GenericInterruptRequest<TDefinition extends InterruptDefinition<any, any, any, any>> = [TDefinition] extends [never] ? never : TDefinition extends InterruptDefinition<any, infer TPayloadSchema, any, infer TPayload> ? GenericInterruptRequestFor<TDefinition, TPayloadSchema, TPayload> : GenericInterruptRequestBase<TDefinition>;
+type InterruptInputKey = 'key' | 'reason' | 'message' | 'expiresAt' | 'payload';
+type RejectUnexpectedInputKeys<TInput> = Exclude<keyof TInput, InterruptInputKey> extends never ? unknown : {
+    [K in Exclude<keyof TInput, InterruptInputKey>]: never;
+};
+type RejectUnexpectedPayload<TInput> = 'payload' extends keyof TInput ? {
+    payload: never;
+} : unknown;
+type ValidInterruptInput<TInput, TPayloadSchema extends PortableSchema | undefined, TPayload = unknown> = TInput extends InterruptInput<TPayloadSchema, TPayload> ? RejectUnexpectedInputKeys<TInput> & ([TPayloadSchema] extends [undefined] ? RejectUnexpectedPayload<TInput> : unknown) : never;
+/**
+ * Extracting a class method preserves the intentional bivariant assignment
+ * behavior of the public `interrupt` callback without exposing a method
+ * signature in an interface.
+ */
+declare abstract class InterruptRequestMethodSignature<TId extends string, TPayloadSchema extends PortableSchema | undefined, TResponseSchema extends PortableSchema | undefined, TPayload, TPayloadInput> {
+    abstract call<TInput>(input: TInput & ValidInterruptInput<TInput, TPayloadSchema, TPayloadInput>): GenericInterruptRequestFor<InterruptDefinition<TId, TPayloadSchema, TResponseSchema, TPayload, TPayloadInput>, TPayloadSchema, TPayload>;
+}
+type InterruptRequestMethod<TId extends string, TPayloadSchema extends PortableSchema | undefined, TResponseSchema extends PortableSchema | undefined, TPayload, TPayloadInput> = InterruptRequestMethodSignature<TId, TPayloadSchema, TResponseSchema, TPayload, TPayloadInput>['call'];
+type DefinedInterruptDefinition<TId extends string, TPayloadSchema extends PortableSchema | undefined, TResponseSchema extends PortableSchema | undefined, TPayload = unknown, TPayloadInput = TPayload> = Omit<InterruptDefinition<TId, TPayloadSchema, TResponseSchema, TPayload, TPayloadInput>, 'interrupt'> & {
+    interrupt: InterruptRequestMethod<TId, TPayloadSchema, TResponseSchema, TPayload, TPayloadInput>;
+};
+export interface InterruptDefinition<TId extends string, TPayloadSchema extends PortableSchema | undefined, TResponseSchema extends PortableSchema | undefined, TPayload = unknown, TPayloadInput = TPayload> {
+    readonly id: TId;
+    readonly payloadSchema: TPayloadSchema;
+    readonly responseSchema: TResponseSchema;
+    interrupt: InterruptRequestMethod<TId, TPayloadSchema, TResponseSchema, TPayload, TPayloadInput>;
+}
+export declare function createInterruptBinding(request: GenericInterruptRequest<InterruptDefinition<any, any, any, any>>, fields?: Pick<InterruptBindingDescriptor, 'threadId' | 'interruptedRunId' | 'generation' | 'batchIndex'>): InterruptPreEmissionData;
+type ParsedInterruptInput = {
+    key: string;
+    reason: string;
+    message: string;
+    expiresAt?: string;
+    payload?: unknown;
+};
+/**
+ * Returns the schema input captured for a newly emitted request. This is
+ * internal because continuation state can cross a client boundary and must be
+ * parsed again when it returns to the server.
+ */
+export declare function getInterruptRequestInput(request: GenericInterruptRequest<InterruptDefinition<any, any, any, any>>): Readonly<ParsedInterruptInput>;
+/**
+ * Rebuild a request from a persisted display payload that has already passed
+ * the definition's payload schema. This is internal because callers must not
+ * bypass public input validation for new requests.
+ */
+export declare function rehydrateInterruptRequest(definition: InterruptDefinition<any, any, any, any>, input: ParsedInterruptInput): GenericInterruptRequest<InterruptDefinition<any, any, any, any>>;
+/** Same hash the producer stamps on a first-party generic binding. */
+export declare function hashInterruptDefinitionSchema(schema: unknown): string;
+export declare function defineInterrupt<const TId extends string, const TPayloadSchema extends PortableSchema, const TResponseSchema extends PortableSchema>(options: {
+    id: TId;
+    payloadSchema: TPayloadSchema;
+    responseSchema: TResponseSchema;
+}): DefinedInterruptDefinition<TId, TPayloadSchema, TResponseSchema, InferSchemaOutput<TPayloadSchema>, InferSchemaInput<TPayloadSchema>>;
+export declare function defineInterrupt<const TId extends string, const TPayloadSchema extends PortableSchema>(options: {
+    id: TId;
+    payloadSchema: TPayloadSchema;
+    responseSchema?: never;
+}): DefinedInterruptDefinition<TId, TPayloadSchema, undefined, InferSchemaOutput<TPayloadSchema>, InferSchemaInput<TPayloadSchema>>;
+export declare function defineInterrupt<const TId extends string, const TResponseSchema extends PortableSchema>(options: {
+    id: TId;
+    responseSchema: TResponseSchema;
+    payloadSchema?: never;
+}): DefinedInterruptDefinition<TId, undefined, TResponseSchema, undefined, undefined>;
+export {};