@tanstack/ai 0.41.0 → 0.43.0

package/dist/esm/client.js

@@ -1,67 +1,134 @@
-import { toolDefinition } from "./activities/chat/tools/tool-definition.js";
-import { convertSchemaToJsonSchema, isStandardSchema, parseWithStandardSchema } from "./activities/chat/tools/schema-converter.js";
+import { canonicalInterruptJson, cloneAndDeepFreezeJson, digestInterruptJson } from "./interrupt-serialization.js";
+import { INTERRUPT_BINDING_VERSION, canonicalizeInterruptResolutions } from "./interrupts.js";
+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 { convertMessagesToModelMessages, generateMessageId, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeToUIMessage, uiMessageToModelMessages } from "./activities/chat/messages.js";
-import { uiMessagesToWire } from "./utilities/ag-ui-wire.js";
-import { BatchStrategy, CompositeStrategy, ImmediateStrategy, PunctuationStrategy, WordBoundaryStrategy } from "./activities/chat/stream/strategies.js";
+import { toolDefinition } from "./activities/chat/tools/tool-definition.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 } from "./activities/chat/stream/processor.js";
-var EventType = /* @__PURE__ */ ((EventType2) => {
-  EventType2["TEXT_MESSAGE_START"] = "TEXT_MESSAGE_START";
-  EventType2["TEXT_MESSAGE_CONTENT"] = "TEXT_MESSAGE_CONTENT";
-  EventType2["TEXT_MESSAGE_END"] = "TEXT_MESSAGE_END";
-  EventType2["TEXT_MESSAGE_CHUNK"] = "TEXT_MESSAGE_CHUNK";
-  EventType2["TOOL_CALL_START"] = "TOOL_CALL_START";
-  EventType2["TOOL_CALL_ARGS"] = "TOOL_CALL_ARGS";
-  EventType2["TOOL_CALL_END"] = "TOOL_CALL_END";
-  EventType2["TOOL_CALL_CHUNK"] = "TOOL_CALL_CHUNK";
-  EventType2["TOOL_CALL_RESULT"] = "TOOL_CALL_RESULT";
-  EventType2["THINKING_START"] = "THINKING_START";
-  EventType2["THINKING_END"] = "THINKING_END";
-  EventType2["THINKING_TEXT_MESSAGE_START"] = "THINKING_TEXT_MESSAGE_START";
-  EventType2["THINKING_TEXT_MESSAGE_CONTENT"] = "THINKING_TEXT_MESSAGE_CONTENT";
-  EventType2["THINKING_TEXT_MESSAGE_END"] = "THINKING_TEXT_MESSAGE_END";
-  EventType2["STATE_SNAPSHOT"] = "STATE_SNAPSHOT";
-  EventType2["STATE_DELTA"] = "STATE_DELTA";
-  EventType2["MESSAGES_SNAPSHOT"] = "MESSAGES_SNAPSHOT";
-  EventType2["ACTIVITY_SNAPSHOT"] = "ACTIVITY_SNAPSHOT";
-  EventType2["ACTIVITY_DELTA"] = "ACTIVITY_DELTA";
-  EventType2["RAW"] = "RAW";
-  EventType2["CUSTOM"] = "CUSTOM";
-  EventType2["RUN_STARTED"] = "RUN_STARTED";
-  EventType2["RUN_FINISHED"] = "RUN_FINISHED";
-  EventType2["RUN_ERROR"] = "RUN_ERROR";
-  EventType2["STEP_STARTED"] = "STEP_STARTED";
-  EventType2["STEP_FINISHED"] = "STEP_FINISHED";
-  EventType2["REASONING_START"] = "REASONING_START";
-  EventType2["REASONING_MESSAGE_START"] = "REASONING_MESSAGE_START";
-  EventType2["REASONING_MESSAGE_CONTENT"] = "REASONING_MESSAGE_CONTENT";
-  EventType2["REASONING_MESSAGE_END"] = "REASONING_MESSAGE_END";
-  EventType2["REASONING_MESSAGE_CHUNK"] = "REASONING_MESSAGE_CHUNK";
-  EventType2["REASONING_END"] = "REASONING_END";
-  EventType2["REASONING_ENCRYPTED_VALUE"] = "REASONING_ENCRYPTED_VALUE";
-  return EventType2;
-})(EventType || {});
-export {
-  BatchStrategy,
-  CompositeStrategy,
-  EventType,
-  ImmediateStrategy,
-  PartialJSONParser,
-  PunctuationStrategy,
-  StreamProcessor,
-  WordBoundaryStrategy,
-  convertMessagesToModelMessages,
-  convertSchemaToJsonSchema,
-  defaultJSONParser,
-  generateMessageId,
-  isStandardSchema,
-  modelMessageToUIMessage,
-  modelMessagesToUIMessages,
-  normalizeToUIMessage,
-  parsePartialJSON,
-  parseWithStandardSchema,
-  toolDefinition,
-  uiMessageToModelMessages,
-  uiMessagesToWire
-};
-//# sourceMappingURL=client.js.map
+import { uiMessagesToWire } from "./utilities/ag-ui-wire.js";
+//#region src/client.ts
+var generationKinds = [
+	"image",
+	"audio",
+	"tts",
+	"video",
+	"transcription"
+];
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasOwnKey(value, key) {
+	return Object.prototype.hasOwnProperty.call(value, key);
+}
+function isGenerationEnvelope(body) {
+	return isRecord(body) && (hasOwnKey(body, "data") || hasOwnKey(body, "forwardedProps"));
+}
+function assertGenerationKind(kind) {
+	if (!generationKinds.includes(kind)) throw new Error(`Unsupported generation kind: ${String(kind)}. Expected one of ${generationKinds.join(", ")}.`);
+}
+function assertInputForKind(kind, input) {
+	if (!isRecord(input)) throw new Error(`Generation ${kind} input must be an object.`);
+	const requiredKey = kind === "tts" ? "text" : kind === "transcription" ? "audio" : "prompt";
+	if (!hasOwnKey(input, requiredKey)) throw new Error(`Generation ${kind} input must include ${requiredKey}.`);
+}
+function isInputForKind(kind, input) {
+	if (!isRecord(input)) return false;
+	return hasOwnKey(input, kind === "tts" ? "text" : kind === "transcription" ? "audio" : "prompt");
+}
+function forwardedPropsFromEnvelope(envelope) {
+	if (!hasOwnKey(envelope, "forwardedProps")) return {};
+	if (!isRecord(envelope.forwardedProps)) throw new Error("Generation envelope forwardedProps must be an object.");
+	return envelope.forwardedProps;
+}
+function optionalStringField(envelope, key) {
+	if (!hasOwnKey(envelope, key)) return;
+	const value = envelope[key];
+	if (typeof value !== "string") throw new Error(`Generation envelope ${key} must be a string.`);
+	return value;
+}
+function generationIdentityFields(envelope) {
+	const identity = {};
+	const threadId = optionalStringField(envelope, "threadId");
+	const runId = optionalStringField(envelope, "runId");
+	if (threadId !== void 0) identity.threadId = threadId;
+	if (runId !== void 0) identity.runId = runId;
+	return identity;
+}
+function generationParamsFromBody(kind, body) {
+	assertGenerationKind(kind);
+	if (isInputForKind(kind, body)) {
+		assertInputForKind(kind, body);
+		return {
+			input: body,
+			forwardedProps: {}
+		};
+	}
+	if (!isGenerationEnvelope(body)) {
+		assertInputForKind(kind, body);
+		return {
+			input: body,
+			forwardedProps: {}
+		};
+	}
+	if (!hasOwnKey(body, "data")) throw new Error(`Generation ${kind} envelope must include data.`);
+	const input = body.data;
+	assertInputForKind(kind, input);
+	return {
+		input,
+		forwardedProps: forwardedPropsFromEnvelope(body),
+		...generationIdentityFields(body)
+	};
+}
+async function generationParamsFromRequest(kind, request) {
+	let body;
+	try {
+		body = await request.json();
+	} catch (error) {
+		throw new Error("Invalid JSON request body.", { cause: error });
+	}
+	if (!isRecord(body)) throw new Error("Generation request body must be a JSON object.");
+	return generationParamsFromBody(kind, body);
+}
+var EventType = /* @__PURE__ */ function(EventType) {
+	EventType["TEXT_MESSAGE_START"] = "TEXT_MESSAGE_START";
+	EventType["TEXT_MESSAGE_CONTENT"] = "TEXT_MESSAGE_CONTENT";
+	EventType["TEXT_MESSAGE_END"] = "TEXT_MESSAGE_END";
+	EventType["TEXT_MESSAGE_CHUNK"] = "TEXT_MESSAGE_CHUNK";
+	EventType["TOOL_CALL_START"] = "TOOL_CALL_START";
+	EventType["TOOL_CALL_ARGS"] = "TOOL_CALL_ARGS";
+	EventType["TOOL_CALL_END"] = "TOOL_CALL_END";
+	EventType["TOOL_CALL_CHUNK"] = "TOOL_CALL_CHUNK";
+	EventType["TOOL_CALL_RESULT"] = "TOOL_CALL_RESULT";
+	EventType["THINKING_START"] = "THINKING_START";
+	EventType["THINKING_END"] = "THINKING_END";
+	EventType["THINKING_TEXT_MESSAGE_START"] = "THINKING_TEXT_MESSAGE_START";
+	EventType["THINKING_TEXT_MESSAGE_CONTENT"] = "THINKING_TEXT_MESSAGE_CONTENT";
+	EventType["THINKING_TEXT_MESSAGE_END"] = "THINKING_TEXT_MESSAGE_END";
+	EventType["STATE_SNAPSHOT"] = "STATE_SNAPSHOT";
+	EventType["STATE_DELTA"] = "STATE_DELTA";
+	EventType["MESSAGES_SNAPSHOT"] = "MESSAGES_SNAPSHOT";
+	EventType["ACTIVITY_SNAPSHOT"] = "ACTIVITY_SNAPSHOT";
+	EventType["ACTIVITY_DELTA"] = "ACTIVITY_DELTA";
+	EventType["RAW"] = "RAW";
+	EventType["CUSTOM"] = "CUSTOM";
+	EventType["RUN_STARTED"] = "RUN_STARTED";
+	EventType["RUN_FINISHED"] = "RUN_FINISHED";
+	EventType["RUN_ERROR"] = "RUN_ERROR";
+	EventType["STEP_STARTED"] = "STEP_STARTED";
+	EventType["STEP_FINISHED"] = "STEP_FINISHED";
+	EventType["REASONING_START"] = "REASONING_START";
+	EventType["REASONING_MESSAGE_START"] = "REASONING_MESSAGE_START";
+	EventType["REASONING_MESSAGE_CONTENT"] = "REASONING_MESSAGE_CONTENT";
+	EventType["REASONING_MESSAGE_END"] = "REASONING_MESSAGE_END";
+	EventType["REASONING_MESSAGE_CHUNK"] = "REASONING_MESSAGE_CHUNK";
+	EventType["REASONING_END"] = "REASONING_END";
+	EventType["REASONING_ENCRYPTED_VALUE"] = "REASONING_ENCRYPTED_VALUE";
+	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 };
+
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../src/client.ts"],"sourcesContent":["export 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 ToolDefinition,\n  type ToolDefinitionConfig,\n  type ToolDefinitionInstance,\n} from './activities/chat/tools/tool-definition'\n\nexport {\n  convertSchemaToJsonSchema,\n  isStandardSchema,\n  parseWithStandardSchema,\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  RunErrorEvent,\n  RunFinishedEvent,\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\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"],"names":["EventType"],"mappings":";;;;;;;AAAO,IAAK,8BAAAA,eAAL;AACLA,aAAA,oBAAA,IAAqB;AACrBA,aAAA,sBAAA,IAAuB;AACvBA,aAAA,kBAAA,IAAmB;AACnBA,aAAA,oBAAA,IAAqB;AACrBA,aAAA,iBAAA,IAAkB;AAClBA,aAAA,gBAAA,IAAiB;AACjBA,aAAA,eAAA,IAAgB;AAChBA,aAAA,iBAAA,IAAkB;AAClBA,aAAA,kBAAA,IAAmB;AACnBA,aAAA,gBAAA,IAAiB;AACjBA,aAAA,cAAA,IAAe;AACfA,aAAA,6BAAA,IAA8B;AAC9BA,aAAA,+BAAA,IAAgC;AAChCA,aAAA,2BAAA,IAA4B;AAC5BA,aAAA,gBAAA,IAAiB;AACjBA,aAAA,aAAA,IAAc;AACdA,aAAA,mBAAA,IAAoB;AACpBA,aAAA,mBAAA,IAAoB;AACpBA,aAAA,gBAAA,IAAiB;AACjBA,aAAA,KAAA,IAAM;AACNA,aAAA,QAAA,IAAS;AACTA,aAAA,aAAA,IAAc;AACdA,aAAA,cAAA,IAAe;AACfA,aAAA,WAAA,IAAY;AACZA,aAAA,cAAA,IAAe;AACfA,aAAA,eAAA,IAAgB;AAChBA,aAAA,iBAAA,IAAkB;AAClBA,aAAA,yBAAA,IAA0B;AAC1BA,aAAA,2BAAA,IAA4B;AAC5BA,aAAA,uBAAA,IAAwB;AACxBA,aAAA,yBAAA,IAA0B;AAC1BA,aAAA,eAAA,IAAgB;AAChBA,aAAA,2BAAA,IAA4B;AAjClB,SAAAA;AAAA,GAAA,aAAA,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 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/custom-events.d.ts

@@ -0,0 +1,76 @@
+import { CustomEvent, StreamChunk } from './types.js';
+/** Well-known CUSTOM event names. */
+export declare const CUSTOM_EVENT: {
+    readonly FILE_CHANGED: "file.changed";
+    readonly PROCESS_STDOUT: "process.stdout";
+    readonly PROCESS_STDERR: "process.stderr";
+    readonly PORT_OPENED: "port.opened";
+    readonly APPROVAL_REQUESTED: "approval.requested";
+    readonly APPROVAL_RESOLVED: "approval.resolved";
+    readonly ARTIFACT_CREATED: "artifact.created";
+    readonly SANDBOX_CREATED: "sandbox.created";
+    readonly SANDBOX_RESUMED: "sandbox.resumed";
+};
+/** Union of the well-known CUSTOM event name literals. */
+export type WellKnownCustomEventName = (typeof CUSTOM_EVENT)[keyof typeof CUSTOM_EVENT];
+export interface FileChangedPayload {
+    type: 'create' | 'change' | 'delete';
+    /** Absolute path inside the sandbox (under the workspace root). */
+    path: string;
+    /** Unified diff, when the harness can produce one. */
+    diff?: string;
+    timestamp: number;
+}
+export interface ProcessOutputPayload {
+    /** Stable id for the spawned process whose output this is. */
+    processId: string;
+    /** A chunk of stdout/stderr text. */
+    chunk: string;
+}
+export interface PortOpenedPayload {
+    port: number;
+    /** Externally reachable URL, when the provider exposes one. */
+    url?: string;
+}
+export interface ApprovalRequestedPayload {
+    approvalId: string;
+    title: string;
+    /** Free-form detail describing the action awaiting approval. */
+    [key: string]: unknown;
+}
+export interface ApprovalResolvedPayload {
+    approvalId: string;
+    granted: boolean;
+}
+export interface ArtifactCreatedPayload {
+    artifactId: string;
+    name: string;
+    mimeType: string;
+    size: number;
+}
+export interface SandboxLifecyclePayload {
+    sandboxId: string;
+    provider: string;
+}
+/** Maps each well-known name to its payload type. */
+export interface CustomEventPayloads {
+    [CUSTOM_EVENT.FILE_CHANGED]: FileChangedPayload;
+    [CUSTOM_EVENT.PROCESS_STDOUT]: ProcessOutputPayload;
+    [CUSTOM_EVENT.PROCESS_STDERR]: ProcessOutputPayload;
+    [CUSTOM_EVENT.PORT_OPENED]: PortOpenedPayload;
+    [CUSTOM_EVENT.APPROVAL_REQUESTED]: ApprovalRequestedPayload;
+    [CUSTOM_EVENT.APPROVAL_RESOLVED]: ApprovalResolvedPayload;
+    [CUSTOM_EVENT.ARTIFACT_CREATED]: ArtifactCreatedPayload;
+    [CUSTOM_EVENT.SANDBOX_CREATED]: SandboxLifecyclePayload;
+    [CUSTOM_EVENT.SANDBOX_RESUMED]: SandboxLifecyclePayload;
+}
+/** A CUSTOM event narrowed to a specific well-known name and its payload. */
+export type WellKnownCustomEvent<TName extends WellKnownCustomEventName> = CustomEvent & {
+    name: TName;
+    value: CustomEventPayloads[TName];
+};
+/**
+ * Type guard: is `chunk` a CUSTOM event with the given well-known `name`?
+ * Narrows the payload type when true, so consumers read `chunk.value` typed.
+ */
+export declare function isCustomEvent<TName extends WellKnownCustomEventName>(chunk: StreamChunk, name: TName): chunk is WellKnownCustomEvent<TName>;

package/dist/esm/custom-events.js

@@ -0,0 +1,37 @@
+import { EventType } from "./types.js";
+//#region src/custom-events.ts
+/**
+* Catalog of well-known AG-UI `CUSTOM` event names used by the sandbox/agent
+* layers, plus their payload shapes.
+*
+* The persisted run log is the AG-UI `StreamChunk` stream itself — there is no
+* separate `RunEvent` type. Agent activity that has no first-class AG-UI event
+* (process output, file diffs, ports, approvals, artifacts, sandbox lifecycle)
+* rides on `CUSTOM` events carrying one of these names. Centralizing the names +
+* payloads here keeps emitters (harness adapters, sandbox) and consumers
+* (persistence projections, devtools, diff/terminal panels) in agreement without
+* inventing a parallel event union.
+*/
+/** Well-known CUSTOM event names. */
+var CUSTOM_EVENT = {
+	FILE_CHANGED: "file.changed",
+	PROCESS_STDOUT: "process.stdout",
+	PROCESS_STDERR: "process.stderr",
+	PORT_OPENED: "port.opened",
+	APPROVAL_REQUESTED: "approval.requested",
+	APPROVAL_RESOLVED: "approval.resolved",
+	ARTIFACT_CREATED: "artifact.created",
+	SANDBOX_CREATED: "sandbox.created",
+	SANDBOX_RESUMED: "sandbox.resumed"
+};
+/**
+* Type guard: is `chunk` a CUSTOM event with the given well-known `name`?
+* Narrows the payload type when true, so consumers read `chunk.value` typed.
+*/
+function isCustomEvent(chunk, name) {
+	return chunk.type === EventType.CUSTOM && chunk.name === name;
+}
+//#endregion
+export { CUSTOM_EVENT, isCustomEvent };
+
+//# sourceMappingURL=custom-events.js.map

package/dist/esm/custom-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-events.js","names":[],"sources":["../../src/custom-events.ts"],"sourcesContent":["/**\n * Catalog of well-known AG-UI `CUSTOM` event names used by the sandbox/agent\n * layers, plus their payload shapes.\n *\n * The persisted run log is the AG-UI `StreamChunk` stream itself — there is no\n * separate `RunEvent` type. Agent activity that has no first-class AG-UI event\n * (process output, file diffs, ports, approvals, artifacts, sandbox lifecycle)\n * rides on `CUSTOM` events carrying one of these names. Centralizing the names +\n * payloads here keeps emitters (harness adapters, sandbox) and consumers\n * (persistence projections, devtools, diff/terminal panels) in agreement without\n * inventing a parallel event union.\n */\nimport { EventType } from './types'\nimport type { CustomEvent, StreamChunk } from './types'\n\n/** Well-known CUSTOM event names. */\nexport const CUSTOM_EVENT = {\n  FILE_CHANGED: 'file.changed',\n  PROCESS_STDOUT: 'process.stdout',\n  PROCESS_STDERR: 'process.stderr',\n  PORT_OPENED: 'port.opened',\n  APPROVAL_REQUESTED: 'approval.requested',\n  APPROVAL_RESOLVED: 'approval.resolved',\n  ARTIFACT_CREATED: 'artifact.created',\n  SANDBOX_CREATED: 'sandbox.created',\n  SANDBOX_RESUMED: 'sandbox.resumed',\n} as const\n\n/** Union of the well-known CUSTOM event name literals. */\nexport type WellKnownCustomEventName =\n  (typeof CUSTOM_EVENT)[keyof typeof CUSTOM_EVENT]\n\n// ---- Payload shapes ----\n\nexport interface FileChangedPayload {\n  type: 'create' | 'change' | 'delete'\n  /** Absolute path inside the sandbox (under the workspace root). */\n  path: string\n  /** Unified diff, when the harness can produce one. */\n  diff?: string\n  timestamp: number\n}\n\nexport interface ProcessOutputPayload {\n  /** Stable id for the spawned process whose output this is. */\n  processId: string\n  /** A chunk of stdout/stderr text. */\n  chunk: string\n}\n\nexport interface PortOpenedPayload {\n  port: number\n  /** Externally reachable URL, when the provider exposes one. */\n  url?: string\n}\n\nexport interface ApprovalRequestedPayload {\n  approvalId: string\n  title: string\n  /** Free-form detail describing the action awaiting approval. */\n  [key: string]: unknown\n}\n\nexport interface ApprovalResolvedPayload {\n  approvalId: string\n  granted: boolean\n}\n\nexport interface ArtifactCreatedPayload {\n  artifactId: string\n  name: string\n  mimeType: string\n  size: number\n}\n\nexport interface SandboxLifecyclePayload {\n  sandboxId: string\n  provider: string\n}\n\n/** Maps each well-known name to its payload type. */\nexport interface CustomEventPayloads {\n  [CUSTOM_EVENT.FILE_CHANGED]: FileChangedPayload\n  [CUSTOM_EVENT.PROCESS_STDOUT]: ProcessOutputPayload\n  [CUSTOM_EVENT.PROCESS_STDERR]: ProcessOutputPayload\n  [CUSTOM_EVENT.PORT_OPENED]: PortOpenedPayload\n  [CUSTOM_EVENT.APPROVAL_REQUESTED]: ApprovalRequestedPayload\n  [CUSTOM_EVENT.APPROVAL_RESOLVED]: ApprovalResolvedPayload\n  [CUSTOM_EVENT.ARTIFACT_CREATED]: ArtifactCreatedPayload\n  [CUSTOM_EVENT.SANDBOX_CREATED]: SandboxLifecyclePayload\n  [CUSTOM_EVENT.SANDBOX_RESUMED]: SandboxLifecyclePayload\n}\n\n/** A CUSTOM event narrowed to a specific well-known name and its payload. */\nexport type WellKnownCustomEvent<TName extends WellKnownCustomEventName> =\n  CustomEvent & { name: TName; value: CustomEventPayloads[TName] }\n\n/**\n * Type guard: is `chunk` a CUSTOM event with the given well-known `name`?\n * Narrows the payload type when true, so consumers read `chunk.value` typed.\n */\nexport function isCustomEvent<TName extends WellKnownCustomEventName>(\n  chunk: StreamChunk,\n  name: TName,\n): chunk is WellKnownCustomEvent<TName> {\n  return chunk.type === EventType.CUSTOM && chunk.name === name\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,IAAa,eAAe;CAC1B,cAAc;CACd,gBAAgB;CAChB,gBAAgB;CAChB,aAAa;CACb,oBAAoB;CACpB,mBAAmB;CACnB,kBAAkB;CAClB,iBAAiB;CACjB,iBAAiB;AACnB;;;;;AA2EA,SAAgB,cACd,OACA,MACsC;CACtC,OAAO,MAAM,SAAS,UAAU,UAAU,MAAM,SAAS;AAC3D"}

package/dist/esm/delivery-detach.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The one-way channel from a chat run to the durable DELIVERY sink that is
+ * persisting it.
+ *
+ * The sink (`durableStreamSource` in `./stream-to-response.ts`) has to answer one
+ * question on the abort path: was this disconnect a DETACH — the agent keeps
+ * running and a later attach will continue the log — or the end of the run? Only
+ * the run's own middleware can answer it (`withSandbox`'s `onAbort` resolves both
+ * out-of-band cancel bands and `detachOnDisconnect`), and the sink cannot reach
+ * the middleware capability bus: it lives one layer up, in the transport, and is
+ * handed nothing but the stream and a durability adapter.
+ *
+ * So the fact travels on the STREAM ITSELF, keyed by the exact object `chat()`
+ * returned. That is the seam an application cannot forget to wire: passing the
+ * stream to `toServerSentEventsResponse(stream, { durability })` is already
+ * mandatory, and it is the same object both sides hold. The alternative — a
+ * `detachable` flag on the response options — has to be re-wired correctly at
+ * every durable call site, and a forgotten one silently terminalizes a healthy
+ * detached run's log, which is the exact defect this channel exists to fix.
+ *
+ * The value is a THUNK, not a boolean: the verdict is only known during the run's
+ * teardown, long after the response object was built.
+ */
+/**
+ * Publish `stream`'s detach predicate. Called by `chat()` on the object it hands
+ * back, once per stream.
+ *
+ * Wired on BOTH streaming paths — `runStreamingText` and
+ * `runStreamingStructuredOutput` — since either can be handed to a durable
+ * transport helper. The non-streaming paths (`stream: false`, and the
+ * `Promise<T>` structured-output variant) resolve a value rather than yielding a
+ * stream, so there is no delivery sink to inform and nothing to publish.
+ *
+ * @internal
+ */
+export declare function publishRunDetachedSignal(stream: object, wasDetached: () => boolean): void;
+/**
+ * Whether the run behind `stream` declared its abort a detach.
+ *
+ * `false` for anything that never published a predicate — a hand-rolled
+ * iterable, a `chat()` from an older build, a non-object source — so an unknown
+ * stream keeps the terminalize-and-close behavior rather than being spared it.
+ *
+ * A throwing predicate is also `false`, for the same reason: this is consulted on
+ * a teardown path where the only safe default is to terminalize. Leaving a log
+ * open because a probe threw would park every tailer forever.
+ *
+ * @internal
+ */
+export declare function wasRunDetached(stream: unknown): boolean;

package/dist/esm/delivery-detach.js

@@ -0,0 +1,71 @@
+//#region src/delivery-detach.ts
+/**
+* The one-way channel from a chat run to the durable DELIVERY sink that is
+* persisting it.
+*
+* The sink (`durableStreamSource` in `./stream-to-response.ts`) has to answer one
+* question on the abort path: was this disconnect a DETACH — the agent keeps
+* running and a later attach will continue the log — or the end of the run? Only
+* the run's own middleware can answer it (`withSandbox`'s `onAbort` resolves both
+* out-of-band cancel bands and `detachOnDisconnect`), and the sink cannot reach
+* the middleware capability bus: it lives one layer up, in the transport, and is
+* handed nothing but the stream and a durability adapter.
+*
+* So the fact travels on the STREAM ITSELF, keyed by the exact object `chat()`
+* returned. That is the seam an application cannot forget to wire: passing the
+* stream to `toServerSentEventsResponse(stream, { durability })` is already
+* mandatory, and it is the same object both sides hold. The alternative — a
+* `detachable` flag on the response options — has to be re-wired correctly at
+* every durable call site, and a forgotten one silently terminalizes a healthy
+* detached run's log, which is the exact defect this channel exists to fix.
+*
+* The value is a THUNK, not a boolean: the verdict is only known during the run's
+* teardown, long after the response object was built.
+*/
+/**
+* Per-stream detach predicates. Keyed weakly by the stream object, so a stream
+* that is dropped without ever being consumed takes its entry with it.
+*/
+var detachSignals = /* @__PURE__ */ new WeakMap();
+/**
+* Publish `stream`'s detach predicate. Called by `chat()` on the object it hands
+* back, once per stream.
+*
+* Wired on BOTH streaming paths — `runStreamingText` and
+* `runStreamingStructuredOutput` — since either can be handed to a durable
+* transport helper. The non-streaming paths (`stream: false`, and the
+* `Promise<T>` structured-output variant) resolve a value rather than yielding a
+* stream, so there is no delivery sink to inform and nothing to publish.
+*
+* @internal
+*/
+function publishRunDetachedSignal(stream, wasDetached) {
+	detachSignals.set(stream, wasDetached);
+}
+/**
+* Whether the run behind `stream` declared its abort a detach.
+*
+* `false` for anything that never published a predicate — a hand-rolled
+* iterable, a `chat()` from an older build, a non-object source — so an unknown
+* stream keeps the terminalize-and-close behavior rather than being spared it.
+*
+* A throwing predicate is also `false`, for the same reason: this is consulted on
+* a teardown path where the only safe default is to terminalize. Leaving a log
+* open because a probe threw would park every tailer forever.
+*
+* @internal
+*/
+function wasRunDetached(stream) {
+	if (typeof stream !== "object" || stream === null) return false;
+	const signal = detachSignals.get(stream);
+	if (signal === void 0) return false;
+	try {
+		return signal();
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { publishRunDetachedSignal, wasRunDetached };
+
+//# sourceMappingURL=delivery-detach.js.map

package/dist/esm/delivery-detach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-detach.js","names":[],"sources":["../../src/delivery-detach.ts"],"sourcesContent":["/**\n * The one-way channel from a chat run to the durable DELIVERY sink that is\n * persisting it.\n *\n * The sink (`durableStreamSource` in `./stream-to-response.ts`) has to answer one\n * question on the abort path: was this disconnect a DETACH — the agent keeps\n * running and a later attach will continue the log — or the end of the run? Only\n * the run's own middleware can answer it (`withSandbox`'s `onAbort` resolves both\n * out-of-band cancel bands and `detachOnDisconnect`), and the sink cannot reach\n * the middleware capability bus: it lives one layer up, in the transport, and is\n * handed nothing but the stream and a durability adapter.\n *\n * So the fact travels on the STREAM ITSELF, keyed by the exact object `chat()`\n * returned. That is the seam an application cannot forget to wire: passing the\n * stream to `toServerSentEventsResponse(stream, { durability })` is already\n * mandatory, and it is the same object both sides hold. The alternative — a\n * `detachable` flag on the response options — has to be re-wired correctly at\n * every durable call site, and a forgotten one silently terminalizes a healthy\n * detached run's log, which is the exact defect this channel exists to fix.\n *\n * The value is a THUNK, not a boolean: the verdict is only known during the run's\n * teardown, long after the response object was built.\n */\n\n/**\n * Per-stream detach predicates. Keyed weakly by the stream object, so a stream\n * that is dropped without ever being consumed takes its entry with it.\n */\nconst detachSignals = new WeakMap<object, () => boolean>()\n\n/**\n * Publish `stream`'s detach predicate. Called by `chat()` on the object it hands\n * back, once per stream.\n *\n * Wired on BOTH streaming paths — `runStreamingText` and\n * `runStreamingStructuredOutput` — since either can be handed to a durable\n * transport helper. The non-streaming paths (`stream: false`, and the\n * `Promise<T>` structured-output variant) resolve a value rather than yielding a\n * stream, so there is no delivery sink to inform and nothing to publish.\n *\n * @internal\n */\nexport function publishRunDetachedSignal(\n  stream: object,\n  wasDetached: () => boolean,\n): void {\n  detachSignals.set(stream, wasDetached)\n}\n\n/**\n * Whether the run behind `stream` declared its abort a detach.\n *\n * `false` for anything that never published a predicate — a hand-rolled\n * iterable, a `chat()` from an older build, a non-object source — so an unknown\n * stream keeps the terminalize-and-close behavior rather than being spared it.\n *\n * A throwing predicate is also `false`, for the same reason: this is consulted on\n * a teardown path where the only safe default is to terminalize. Leaving a log\n * open because a probe threw would park every tailer forever.\n *\n * @internal\n */\nexport function wasRunDetached(stream: unknown): boolean {\n  if (typeof stream !== 'object' || stream === null) return false\n  const signal = detachSignals.get(stream)\n  if (signal === undefined) return false\n  try {\n    return signal()\n  } catch {\n    return false\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,IAAM,gCAAgB,IAAI,QAA+B;;;;;;;;;;;;;AAczD,SAAgB,yBACd,QACA,aACM;CACN,cAAc,IAAI,QAAQ,WAAW;AACvC;;;;;;;;;;;;;;AAeA,SAAgB,eAAe,QAA0B;CACvD,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO;CAC1D,MAAM,SAAS,cAAc,IAAI,MAAM;CACvC,IAAI,WAAW,KAAA,GAAW,OAAO;CACjC,IAAI;EACF,OAAO,OAAO;CAChB,QAAQ;EACN,OAAO;CACT;AACF"}

package/dist/esm/delivery-disconnect.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The one-way channel from the durable DELIVERY sink back to the chat run: "your
+ * viewer is gone, but you are not."
+ *
+ * This is the MIRROR of `./delivery-detach.ts`. That module answers a question the
+ * sink asks the run (was this abort a detach?); this one delivers a fact the sink
+ * learns first and the run cannot observe at all — the response body was
+ * cancelled. Both are keyed weakly by the exact stream object `chat()` returned,
+ * for the same reason: passing that object to
+ * `toServerSentEventsResponse(stream, { durability })` is already mandatory, so it
+ * is the one seam an application cannot forget to wire.
+ *
+ * WHY THE RUN CANNOT JUST WATCH AN ABORT SIGNAL. Before this channel existed, the
+ * only way a disconnect reached a run's middleware was for the application to
+ * mirror `request.signal` into `chat()`'s `abortController` — which ABORTS THE RUN.
+ * For a durable run that is precisely wrong, and wrong in the most expensive
+ * direction: `chat()` returns at its `isCancelled()` check immediately after
+ * middleware setup, so the harness adapter's `chatStream` is never called and the
+ * agent in the freshly-created sandbox is NEVER LAUNCHED. The user re-attaches to
+ * an empty log belonging to a run that did nothing, and no takeover can recover it
+ * because there is no journal to replay. The application was forced to choose
+ * between "the middleware learns about the disconnect" and "the run survives it".
+ *
+ * So the disconnect travels as a NOTIFICATION rather than a cancellation. The run
+ * hands it to whatever subscribed through `RunDisconnectCapability` — bookkeeping
+ * only, no teardown — and keeps producing into its still-open durable log, which
+ * is exactly what a re-attaching client tails to catch up.
+ *
+ * DISPATCHED FROM THE TRANSPORT, NOT FROM THE RUN'S UNWINDING. That is what makes
+ * it prompt. A run suspended inside a minutes-wide `setup` (cloning a repo into a
+ * sandbox) cannot dispatch anything from its own `finally`, because the `finally`
+ * is reached only once the generator unwinds — which is what made `detachedSince`
+ * land three minutes late instead of immediately.
+ */
+/**
+ * Publish `stream`'s disconnect handler. Called by `chat()` on the object it hands
+ * back, once per stream.
+ *
+ * Wired on BOTH streaming paths — `runStreamingText` and
+ * `runStreamingStructuredOutput` — since either can be handed to a durable
+ * transport helper, matching `publishRunDetachedSignal`.
+ *
+ * @internal
+ */
+export declare function publishRunDisconnectHandler(stream: object, onDisconnect: () => void): void;
+/**
+ * Tell the run behind `stream` that its delivery socket closed.
+ *
+ * A NO-OP for anything that never published a handler — a hand-rolled iterable, a
+ * `chat()` from an older build, a non-object source — so an unknown stream simply
+ * keeps today's behavior.
+ *
+ * NEVER THROWS and never returns a promise to await. This is called from
+ * `ReadableStream.cancel()`, whose rejection would surface as an unhandled error
+ * on a path where the consumer has already gone away; and the handler's own work
+ * is tracked by the run (which awaits it before finishing), not by this call. A
+ * throwing handler is swallowed for the same reason `wasRunDetached` swallows: the
+ * disconnect path has no second channel to report on.
+ *
+ * @internal
+ */
+export declare function notifyRunDisconnected(stream: unknown): void;