@tanstack/ai 0.46.0 → 0.47.2

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":"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"}
+{"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

@@ -30,7 +30,12 @@ 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,6 +10,8 @@ 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";
@@ -36,6 +38,7 @@ import { chatParamsFromRequest, chatParamsFromRequestBody, mergeAgentTools } fro
 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";
@@ -50,4 +53,4 @@ import { StreamProcessor, createReplayStream } from "./activities/chat/stream/pr
 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, DuplicateToolNameError, 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, decodeWsFrame, defaultJSONParser, defineChatMiddleware, defineRunStore, detectImageMimeType, digestInterruptJson, embed, encodeWsFrame, 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, resumeWebSocketResponse, resumeWebSocketStream, streamToText, summarize, toHttpResponse, toHttpStream, toServerSentEventsResponse, toServerSentEventsStream, toWebSocketResponse, toWebSocketStream, 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 {};

package/dist/esm/interrupt-definition.js

@@ -0,0 +1,169 @@
+import { canonicalInterruptJson, cloneAndDeepFreezeJson, digestInterruptJson } from "./interrupt-serialization.js";
+import "./interrupts.js";
+import { isStandardJSONSchema, isStandardSchema } from "./activities/chat/tools/schema-converter.js";
+//#region src/interrupt-definition.ts
+var INTERRUPT_PAYLOAD_METADATA_KEY = "tanstack:interruptPayload";
+var INTERRUPT_BINDING_KIND = "generic";
+var definitionSchemaState = /* @__PURE__ */ new WeakMap();
+function createInterruptBinding(request, fields = {}) {
+	const schemaState = definitionSchemaState.get(request.definition);
+	if (!schemaState) throw new TypeError("Interrupt definition schema state is unavailable.");
+	const { threadId, interruptedRunId, generation, batchIndex } = fields;
+	return {
+		descriptor: {
+			v: 1,
+			kind: INTERRUPT_BINDING_KIND,
+			definitionId: request.definition.id,
+			key: request.key,
+			...threadId !== void 0 ? { threadId } : {},
+			...interruptedRunId !== void 0 ? { interruptedRunId } : {},
+			...generation !== void 0 ? { generation } : {},
+			...batchIndex !== void 0 ? { batchIndex } : {},
+			...schemaState.responseSchemaCanonicalJson ? { responseSchemaCanonicalJson: schemaState.responseSchemaCanonicalJson } : {},
+			...schemaState.payloadSchemaCanonicalJson ? { payloadSchemaCanonicalJson: schemaState.payloadSchemaCanonicalJson } : {},
+			...schemaState.payloadSchemaHash ? { payloadSchemaHash: schemaState.payloadSchemaHash } : {},
+			...schemaState.responseSchemaHash ? { responseSchemaHash: schemaState.responseSchemaHash } : {}
+		},
+		..."payload" in request && request.payload !== void 0 ? { payload: request.payload } : {}
+	};
+}
+var interruptRequestFactories = /* @__PURE__ */ new WeakMap();
+var interruptRequestInputs = /* @__PURE__ */ new WeakMap();
+/**
+* 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.
+*/
+function getInterruptRequestInput(request) {
+	const input = interruptRequestInputs.get(request);
+	if (!input) throw new TypeError("Interrupt request input is unavailable.");
+	return input;
+}
+/**
+* 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.
+*/
+function rehydrateInterruptRequest(definition, input) {
+	const factory = interruptRequestFactories.get(definition);
+	if (!factory) throw new TypeError("Interrupt definition request factory is unavailable.");
+	return factory(input, true);
+}
+function schemaJson(schema, name) {
+	if (!isStandardJSONSchema(schema)) throw new TypeError(`${name} must be a Standard Schema with a JSON Schema converter.`);
+	try {
+		const exported = schema["~standard"].jsonSchema.input({ target: "draft-07" });
+		if (exported === void 0) throw new TypeError("The exported schema is undefined.");
+		if (typeof exported === "function") throw new TypeError("The exported schema must not be a function.");
+		if (Array.isArray(exported)) throw new TypeError("The exported schema must be a plain JSON object.");
+		if (!exported || typeof exported !== "object" || ![Object.prototype, null].includes(Object.getPrototypeOf(exported))) throw new TypeError("The exported schema must be a plain JSON object.");
+		const converted = {};
+		for (const [key, value] of Object.entries(exported)) if (key !== "$schema") converted[key] = value;
+		return {
+			json: converted,
+			canonicalJson: canonicalInterruptJson(converted)
+		};
+	} catch (error) {
+		throw new TypeError(`${name} could not export compatible JSON Schema: ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+/** Same hash the producer stamps on a first-party generic binding. */
+function hashInterruptDefinitionSchema(schema) {
+	return digestInterruptJson(schemaJson(schema, "Interrupt schema").canonicalJson);
+}
+function validateJson(value, label) {
+	try {
+		canonicalInterruptJson(value);
+	} catch (error) {
+		throw new TypeError(`${label} must be JSON-compatible: ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+function validateNonEmptyString(value, label) {
+	if (typeof value !== "string" || value.trim() === "") throw new TypeError(`${label} must be a non-empty string.`);
+	return value;
+}
+function validateExpiresAt(value) {
+	if (typeof value !== "string" || !Number.isFinite(Date.parse(value))) throw new TypeError("Interrupt expiresAt must be a valid date string.");
+	return value;
+}
+function isPromiseLike(value) {
+	return value !== null && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function";
+}
+function parseInterruptPayload(schema, value) {
+	if (!isStandardSchema(schema)) return value;
+	const result = schema["~standard"].validate(value);
+	if (isPromiseLike(result)) throw new TypeError("Interrupt payloadSchema validation must be synchronous.");
+	if (result.issues !== void 0) throw new TypeError(`Interrupt payload is invalid: ${result.issues.map((issue) => issue.message).join(" ")}`);
+	return result.value;
+}
+function defineInterrupt(options) {
+	validateNonEmptyString(options.id, "Interrupt definition id");
+	const responseJson = options.responseSchema !== void 0 ? schemaJson(options.responseSchema, "responseSchema") : void 0;
+	const hasPayloadSchema = Object.prototype.hasOwnProperty.call(options, "payloadSchema");
+	const payloadJson = hasPayloadSchema ? schemaJson(options.payloadSchema, "payloadSchema") : void 0;
+	const schemaState = {
+		...responseJson ? {
+			responseSchemaCanonicalJson: responseJson.canonicalJson,
+			responseSchemaHash: digestInterruptJson(responseJson.canonicalJson)
+		} : {},
+		...payloadJson ? {
+			payloadSchemaCanonicalJson: payloadJson.canonicalJson,
+			payloadSchemaHash: digestInterruptJson(payloadJson.canonicalJson)
+		} : {}
+	};
+	const definition = {
+		id: options.id,
+		payloadSchema: options.payloadSchema,
+		responseSchema: options.responseSchema,
+		interrupt(input) {
+			return createRequest(input, false);
+		}
+	};
+	const parsePayload = (payload) => {
+		const payloadSchema = options.payloadSchema;
+		if (payloadSchema === void 0) throw new TypeError("This interrupt definition does not accept a payload.");
+		return parseInterruptPayload(payloadSchema, payload);
+	};
+	const createRequest = (input, payloadIsParsed) => {
+		for (const key of Object.keys(input)) if (![
+			"key",
+			"payload",
+			"reason",
+			"message",
+			"expiresAt"
+		].includes(key)) throw new TypeError(`Interrupt input field ${key} is not allowed.`);
+		const key = validateNonEmptyString(input.key, "Interrupt key");
+		const reason = validateNonEmptyString(input.reason, "Interrupt reason");
+		const message = validateNonEmptyString(input.message, "Interrupt message");
+		if ("payload" in input) {
+			if (!hasPayloadSchema) throw new TypeError("This interrupt definition does not accept a payload.");
+			if (input.payload !== void 0) validateJson(input.payload, "Interrupt payload");
+		}
+		const parsedPayload = "payload" in input ? payloadIsParsed ? input.payload : parsePayload(input.payload) : void 0;
+		const payload = parsedPayload === void 0 ? void 0 : cloneAndDeepFreezeJson(parsedPayload);
+		const expiresAt = input.expiresAt === void 0 ? void 0 : validateExpiresAt(input.expiresAt);
+		const request = Object.freeze({
+			definition,
+			key,
+			...hasPayloadSchema && payload !== void 0 ? { payload } : {},
+			reason,
+			message,
+			...expiresAt !== void 0 ? { expiresAt } : {}
+		});
+		if (!payloadIsParsed) interruptRequestInputs.set(request, cloneAndDeepFreezeJson({
+			key,
+			reason,
+			message,
+			...expiresAt !== void 0 ? { expiresAt } : {},
+			...parsedPayload !== void 0 ? { payload: parsedPayload } : {}
+		}));
+		return request;
+	};
+	definitionSchemaState.set(definition, schemaState);
+	interruptRequestFactories.set(definition, createRequest);
+	return Object.freeze(definition);
+}
+//#endregion
+export { INTERRUPT_BINDING_KIND, INTERRUPT_PAYLOAD_METADATA_KEY, createInterruptBinding, defineInterrupt, getInterruptRequestInput, hashInterruptDefinitionSchema, rehydrateInterruptRequest };
+
+//# sourceMappingURL=interrupt-definition.js.map

package/dist/esm/interrupt-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt-definition.js","names":[],"sources":["../../src/interrupt-definition.ts"],"sourcesContent":["import type {\n  StandardJSONSchemaV1,\n  StandardSchemaV1,\n} from '@standard-schema/spec'\nimport {\n  canonicalInterruptJson,\n  cloneAndDeepFreezeJson,\n  digestInterruptJson,\n} from './interrupt-serialization'\nimport {\n  isStandardSchema,\n  isStandardJSONSchema,\n} from './activities/chat/tools/schema-converter'\nimport { INTERRUPT_BINDING_VERSION } from './interrupts'\n\nexport const INTERRUPT_PAYLOAD_METADATA_KEY =\n  'tanstack:interruptPayload' as const\nexport const INTERRUPT_BINDING_KIND = 'generic' as const\n\ntype PortableSchema =\n  | StandardJSONSchemaV1<any, any>\n  | StandardSchemaV1<any, any>\n\ntype InferSchemaOutput<TSchema> =\n  TSchema extends StandardSchemaV1<any, infer TOutput>\n    ? TOutput\n    : TSchema extends StandardJSONSchemaV1<any, infer TOutput>\n      ? TOutput\n      : never\ntype InferSchemaInput<TSchema> =\n  TSchema extends StandardSchemaV1<infer TInput, any>\n    ? TInput\n    : TSchema extends StandardJSONSchemaV1<infer TInput, any>\n      ? TInput\n      : never\ntype DefinitionSchemaState = {\n  responseSchemaCanonicalJson?: string\n  responseSchemaHash?: string\n  payloadSchemaCanonicalJson?: string\n  payloadSchemaHash?: string\n}\nconst definitionSchemaState = new WeakMap<object, DefinitionSchemaState>()\n\nexport interface InterruptDefinitionOptions<\n  TId extends string,\n  TPayloadSchema extends PortableSchema | undefined,\n  TResponseSchema extends PortableSchema | undefined,\n> {\n  id: TId\n  payloadSchema?: TPayloadSchema\n  responseSchema?: TResponseSchema\n}\n\nexport interface InterruptBindingDescriptor {\n  v: typeof INTERRUPT_BINDING_VERSION\n  kind: typeof INTERRUPT_BINDING_KIND\n  definitionId: string\n  key: string\n  threadId?: string\n  interruptedRunId?: string\n  generation?: number\n  batchIndex?: number\n  responseSchemaCanonicalJson?: string\n  payloadSchemaCanonicalJson?: string\n  payloadSchemaHash?: string\n  responseSchemaHash?: string\n}\n\nexport interface InterruptPreEmissionData {\n  descriptor: InterruptBindingDescriptor\n  payload?: unknown\n}\n\ntype InterruptInput<\n  TPayloadSchema extends PortableSchema | undefined,\n  TPayload = unknown,\n> = {\n  key: string\n  reason: string\n  message: string\n  expiresAt?: string\n} & ([TPayloadSchema] extends [undefined] ? {} : { payload?: TPayload })\n\ntype GenericInterruptRequestBase<\n  TDefinition extends InterruptDefinition<any, any, any, any>,\n> = {\n  readonly definition: TDefinition\n  readonly key: string\n  readonly reason: string\n  readonly message: string\n  readonly expiresAt?: string\n}\n\ntype GenericInterruptRequestFor<\n  TDefinition extends InterruptDefinition<any, any, any, any>,\n  TPayloadSchema extends PortableSchema | undefined,\n  TPayload,\n> = GenericInterruptRequestBase<TDefinition> &\n  ([TPayloadSchema] extends [undefined]\n    ? {}\n    : { readonly payload: TPayload | undefined })\n\nexport type GenericInterruptRequest<\n  TDefinition extends InterruptDefinition<any, any, any, any>,\n> = [TDefinition] extends [never]\n  ? never\n  : TDefinition extends InterruptDefinition<\n        any,\n        infer TPayloadSchema,\n        any,\n        infer TPayload\n      >\n    ? GenericInterruptRequestFor<TDefinition, TPayloadSchema, TPayload>\n    : GenericInterruptRequestBase<TDefinition>\n\ntype InterruptInputKey = 'key' | 'reason' | 'message' | 'expiresAt' | 'payload'\ntype RejectUnexpectedInputKeys<TInput> =\n  Exclude<keyof TInput, InterruptInputKey> extends never\n    ? unknown\n    : { [K in Exclude<keyof TInput, InterruptInputKey>]: never }\ntype RejectUnexpectedPayload<TInput> = 'payload' extends keyof TInput\n  ? { payload: never }\n  : unknown\ntype ValidInterruptInput<\n  TInput,\n  TPayloadSchema extends PortableSchema | undefined,\n  TPayload = unknown,\n> =\n  TInput extends InterruptInput<TPayloadSchema, TPayload>\n    ? RejectUnexpectedInputKeys<TInput> &\n        ([TPayloadSchema] extends [undefined]\n          ? RejectUnexpectedPayload<TInput>\n          : unknown)\n    : never\n\n/**\n * Extracting a class method preserves the intentional bivariant assignment\n * behavior of the public `interrupt` callback without exposing a method\n * signature in an interface.\n */\ndeclare abstract class InterruptRequestMethodSignature<\n  TId extends string,\n  TPayloadSchema extends PortableSchema | undefined,\n  TResponseSchema extends PortableSchema | undefined,\n  TPayload,\n  TPayloadInput,\n> {\n  abstract call<TInput>(\n    input: TInput & ValidInterruptInput<TInput, TPayloadSchema, TPayloadInput>,\n  ): GenericInterruptRequestFor<\n    InterruptDefinition<\n      TId,\n      TPayloadSchema,\n      TResponseSchema,\n      TPayload,\n      TPayloadInput\n    >,\n    TPayloadSchema,\n    TPayload\n  >\n}\n\ntype InterruptRequestMethod<\n  TId extends string,\n  TPayloadSchema extends PortableSchema | undefined,\n  TResponseSchema extends PortableSchema | undefined,\n  TPayload,\n  TPayloadInput,\n> = InterruptRequestMethodSignature<\n  TId,\n  TPayloadSchema,\n  TResponseSchema,\n  TPayload,\n  TPayloadInput\n>['call']\n\ntype DefinedInterruptDefinition<\n  TId extends string,\n  TPayloadSchema extends PortableSchema | undefined,\n  TResponseSchema extends PortableSchema | undefined,\n  TPayload = unknown,\n  TPayloadInput = TPayload,\n> = Omit<\n  InterruptDefinition<\n    TId,\n    TPayloadSchema,\n    TResponseSchema,\n    TPayload,\n    TPayloadInput\n  >,\n  'interrupt'\n> & {\n  interrupt: InterruptRequestMethod<\n    TId,\n    TPayloadSchema,\n    TResponseSchema,\n    TPayload,\n    TPayloadInput\n  >\n}\n\nexport interface InterruptDefinition<\n  TId extends string,\n  TPayloadSchema extends PortableSchema | undefined,\n  TResponseSchema extends PortableSchema | undefined,\n  TPayload = unknown,\n  TPayloadInput = TPayload,\n> {\n  readonly id: TId\n  readonly payloadSchema: TPayloadSchema\n  readonly responseSchema: TResponseSchema\n  interrupt: InterruptRequestMethod<\n    TId,\n    TPayloadSchema,\n    TResponseSchema,\n    TPayload,\n    TPayloadInput\n  >\n}\n\nexport function createInterruptBinding(\n  request: GenericInterruptRequest<InterruptDefinition<any, any, any, any>>,\n  fields: Pick<\n    InterruptBindingDescriptor,\n    'threadId' | 'interruptedRunId' | 'generation' | 'batchIndex'\n  > = {},\n): InterruptPreEmissionData {\n  const schemaState = definitionSchemaState.get(request.definition)\n  if (!schemaState) {\n    throw new TypeError('Interrupt definition schema state is unavailable.')\n  }\n  const { threadId, interruptedRunId, generation, batchIndex } = fields\n  return {\n    descriptor: {\n      v: INTERRUPT_BINDING_VERSION,\n      kind: INTERRUPT_BINDING_KIND,\n      definitionId: request.definition.id,\n      key: request.key,\n      ...(threadId !== undefined ? { threadId } : {}),\n      ...(interruptedRunId !== undefined ? { interruptedRunId } : {}),\n      ...(generation !== undefined ? { generation } : {}),\n      ...(batchIndex !== undefined ? { batchIndex } : {}),\n      ...(schemaState.responseSchemaCanonicalJson\n        ? {\n            responseSchemaCanonicalJson:\n              schemaState.responseSchemaCanonicalJson,\n          }\n        : {}),\n      ...(schemaState.payloadSchemaCanonicalJson\n        ? { payloadSchemaCanonicalJson: schemaState.payloadSchemaCanonicalJson }\n        : {}),\n      ...(schemaState.payloadSchemaHash\n        ? { payloadSchemaHash: schemaState.payloadSchemaHash }\n        : {}),\n      ...(schemaState.responseSchemaHash\n        ? { responseSchemaHash: schemaState.responseSchemaHash }\n        : {}),\n    },\n    ...('payload' in request && request.payload !== undefined\n      ? { payload: request.payload }\n      : {}),\n  }\n}\n\ntype ParsedInterruptInput = {\n  key: string\n  reason: string\n  message: string\n  expiresAt?: string\n  payload?: unknown\n}\n\ntype InterruptRequestFactory = (\n  input: ParsedInterruptInput,\n  payloadIsParsed: boolean,\n) => GenericInterruptRequest<InterruptDefinition<any, any, any, any>>\n\nconst interruptRequestFactories = new WeakMap<object, InterruptRequestFactory>()\nconst interruptRequestInputs = new WeakMap<\n  object,\n  Readonly<ParsedInterruptInput>\n>()\n\n/**\n * Returns the schema input captured for a newly emitted request. This is\n * internal because continuation state can cross a client boundary and must be\n * parsed again when it returns to the server.\n */\nexport function getInterruptRequestInput(\n  request: GenericInterruptRequest<InterruptDefinition<any, any, any, any>>,\n): Readonly<ParsedInterruptInput> {\n  const input = interruptRequestInputs.get(request)\n  if (!input) {\n    throw new TypeError('Interrupt request input is unavailable.')\n  }\n  return input\n}\n\n/**\n * Rebuild a request from a persisted display payload that has already passed\n * the definition's payload schema. This is internal because callers must not\n * bypass public input validation for new requests.\n */\nexport function rehydrateInterruptRequest(\n  definition: InterruptDefinition<any, any, any, any>,\n  input: ParsedInterruptInput,\n): GenericInterruptRequest<InterruptDefinition<any, any, any, any>> {\n  const factory = interruptRequestFactories.get(definition)\n  if (!factory) {\n    throw new TypeError('Interrupt definition request factory is unavailable.')\n  }\n  return factory(input, true)\n}\n\ninterface CanonicalSchemaJson {\n  json: Record<string, unknown>\n  canonicalJson: string\n}\n\nfunction schemaJson(schema: unknown, name: string): CanonicalSchemaJson {\n  if (!isStandardJSONSchema(schema)) {\n    throw new TypeError(\n      `${name} must be a Standard Schema with a JSON Schema converter.`,\n    )\n  }\n  try {\n    const exported = schema['~standard'].jsonSchema.input({\n      target: 'draft-07',\n    })\n    if (exported === undefined) {\n      throw new TypeError('The exported schema is undefined.')\n    }\n    if (typeof exported === 'function') {\n      throw new TypeError('The exported schema must not be a function.')\n    }\n    if (Array.isArray(exported)) {\n      throw new TypeError('The exported schema must be a plain JSON object.')\n    }\n    if (\n      !exported ||\n      typeof exported !== 'object' ||\n      ![Object.prototype, null].includes(Object.getPrototypeOf(exported))\n    ) {\n      throw new TypeError('The exported schema must be a plain JSON object.')\n    }\n    const converted: Record<string, unknown> = {}\n    for (const [key, value] of Object.entries(exported)) {\n      if (key !== '$schema') converted[key] = value\n    }\n    const canonicalJson = canonicalInterruptJson(converted)\n    return { json: converted, canonicalJson }\n  } catch (error) {\n    throw new TypeError(\n      `${name} could not export compatible JSON Schema: ${error instanceof Error ? error.message : String(error)}`,\n    )\n  }\n}\n\n/** Same hash the producer stamps on a first-party generic binding. */\nexport function hashInterruptDefinitionSchema(schema: unknown): string {\n  return digestInterruptJson(\n    schemaJson(schema, 'Interrupt schema').canonicalJson,\n  )\n}\n\nfunction validateJson(value: unknown, label: string): void {\n  try {\n    canonicalInterruptJson(value)\n  } catch (error) {\n    throw new TypeError(\n      `${label} must be JSON-compatible: ${error instanceof Error ? error.message : String(error)}`,\n    )\n  }\n}\n\nfunction validateNonEmptyString(value: unknown, label: string): string {\n  if (typeof value !== 'string' || value.trim() === '') {\n    throw new TypeError(`${label} must be a non-empty string.`)\n  }\n  return value\n}\n\nfunction validateExpiresAt(value: unknown): string {\n  if (typeof value !== 'string' || !Number.isFinite(Date.parse(value))) {\n    throw new TypeError('Interrupt expiresAt must be a valid date string.')\n  }\n  return value\n}\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return (\n    value !== null &&\n    (typeof value === 'object' || typeof value === 'function') &&\n    'then' in value &&\n    typeof value.then === 'function'\n  )\n}\n\nfunction parseInterruptPayload(\n  schema: PortableSchema,\n  value: unknown,\n): unknown {\n  if (!isStandardSchema(schema)) return value\n  const result = schema['~standard'].validate(value)\n  if (isPromiseLike(result)) {\n    throw new TypeError(\n      'Interrupt payloadSchema validation must be synchronous.',\n    )\n  }\n  if (result.issues !== undefined) {\n    throw new TypeError(\n      `Interrupt payload is invalid: ${result.issues.map((issue) => issue.message).join(' ')}`,\n    )\n  }\n  return result.value\n}\n\nexport function defineInterrupt<\n  const TId extends string,\n  const TPayloadSchema extends PortableSchema,\n  const TResponseSchema extends PortableSchema,\n>(options: {\n  id: TId\n  payloadSchema: TPayloadSchema\n  responseSchema: TResponseSchema\n}): DefinedInterruptDefinition<\n  TId,\n  TPayloadSchema,\n  TResponseSchema,\n  InferSchemaOutput<TPayloadSchema>,\n  InferSchemaInput<TPayloadSchema>\n>\nexport function defineInterrupt<\n  const TId extends string,\n  const TPayloadSchema extends PortableSchema,\n>(options: {\n  id: TId\n  payloadSchema: TPayloadSchema\n  responseSchema?: never\n}): DefinedInterruptDefinition<\n  TId,\n  TPayloadSchema,\n  undefined,\n  InferSchemaOutput<TPayloadSchema>,\n  InferSchemaInput<TPayloadSchema>\n>\nexport function defineInterrupt<\n  const TId extends string,\n  const TResponseSchema extends PortableSchema,\n>(options: {\n  id: TId\n  responseSchema: TResponseSchema\n  payloadSchema?: never\n}): DefinedInterruptDefinition<\n  TId,\n  undefined,\n  TResponseSchema,\n  undefined,\n  undefined\n>\nexport function defineInterrupt<\n  const TId extends string,\n  const TPayloadSchema extends PortableSchema | undefined,\n  const TResponseSchema extends PortableSchema | undefined,\n>(\n  options: InterruptDefinitionOptions<TId, TPayloadSchema, TResponseSchema>,\n): InterruptDefinition<\n  TId,\n  TPayloadSchema,\n  TResponseSchema,\n  InferSchemaOutput<TPayloadSchema>,\n  InferSchemaInput<TPayloadSchema>\n> {\n  validateNonEmptyString(options.id, 'Interrupt definition id')\n  const hasResponseSchema = options.responseSchema !== undefined\n  const responseJson = hasResponseSchema\n    ? schemaJson(options.responseSchema, 'responseSchema')\n    : undefined\n  const hasPayloadSchema = Object.prototype.hasOwnProperty.call(\n    options,\n    'payloadSchema',\n  )\n  const payloadJson = hasPayloadSchema\n    ? schemaJson(options.payloadSchema, 'payloadSchema')\n    : undefined\n  const schemaState: DefinitionSchemaState = {\n    ...(responseJson\n      ? {\n          responseSchemaCanonicalJson: responseJson.canonicalJson,\n          responseSchemaHash: digestInterruptJson(responseJson.canonicalJson),\n        }\n      : {}),\n    ...(payloadJson\n      ? {\n          payloadSchemaCanonicalJson: payloadJson.canonicalJson,\n          payloadSchemaHash: digestInterruptJson(payloadJson.canonicalJson),\n        }\n      : {}),\n  }\n  const definition = {\n    id: options.id,\n    payloadSchema: options.payloadSchema,\n    responseSchema: options.responseSchema,\n    interrupt(input: InterruptInput<TPayloadSchema>) {\n      return createRequest(input, false)\n    },\n  } as InterruptDefinition<\n    TId,\n    TPayloadSchema,\n    TResponseSchema,\n    InferSchemaOutput<TPayloadSchema>,\n    InferSchemaInput<TPayloadSchema>\n  >\n  const parsePayload = (payload: unknown): unknown => {\n    const payloadSchema = options.payloadSchema\n    if (payloadSchema === undefined) {\n      throw new TypeError(\n        'This interrupt definition does not accept a payload.',\n      )\n    }\n    return parseInterruptPayload(payloadSchema, payload)\n  }\n  const createRequest: InterruptRequestFactory = (input, payloadIsParsed) => {\n    for (const key of Object.keys(input)) {\n      if (!['key', 'payload', 'reason', 'message', 'expiresAt'].includes(key)) {\n        throw new TypeError(`Interrupt input field ${key} is not allowed.`)\n      }\n    }\n    const key = validateNonEmptyString(input.key, 'Interrupt key')\n    const reason = validateNonEmptyString(input.reason, 'Interrupt reason')\n    const message = validateNonEmptyString(input.message, 'Interrupt message')\n    if ('payload' in input) {\n      if (!hasPayloadSchema) {\n        throw new TypeError(\n          'This interrupt definition does not accept a payload.',\n        )\n      }\n      if (input.payload !== undefined) {\n        validateJson(input.payload, 'Interrupt payload')\n      }\n    }\n    const parsedPayload =\n      'payload' in input\n        ? payloadIsParsed\n          ? input.payload\n          : parsePayload(input.payload)\n        : undefined\n    const payload =\n      parsedPayload === undefined\n        ? undefined\n        : cloneAndDeepFreezeJson(parsedPayload)\n    const expiresAt =\n      input.expiresAt === undefined\n        ? undefined\n        : validateExpiresAt(input.expiresAt)\n    const request = Object.freeze({\n      definition,\n      key,\n      ...(hasPayloadSchema && payload !== undefined ? { payload } : {}),\n      reason,\n      message,\n      ...(expiresAt !== undefined ? { expiresAt } : {}),\n    })\n    if (!payloadIsParsed) {\n      interruptRequestInputs.set(\n        request,\n        cloneAndDeepFreezeJson({\n          key,\n          reason,\n          message,\n          ...(expiresAt !== undefined ? { expiresAt } : {}),\n          ...(parsedPayload !== undefined ? { payload: parsedPayload } : {}),\n        }),\n      )\n    }\n    return request\n  }\n  definitionSchemaState.set(definition, schemaState)\n  interruptRequestFactories.set(definition, createRequest)\n  return Object.freeze(definition)\n}\n"],"mappings":"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"}