@tanstack/ai 0.42.0 → 0.43.0

package/dist/esm/interrupt-resume.js

@@ -0,0 +1,438 @@
+import { canonicalInterruptJson, digestInterruptJson } from "./interrupt-serialization.js";
+import { canonicalizeInterruptResolutions } from "./interrupts.js";
+import { isStandardSchema, validateWithStandardSchema } from "./activities/chat/tools/schema-converter.js";
+import { hashSchemaInput, normalizeApprovalSchema } from "./activities/chat/tools/approval-schema.js";
+//#region src/interrupt-resume.ts
+/**
+* The `Interrupt.metadata` key under which this package's resume binding
+* travels.
+*
+* Exported so anything that produces an interrupt this package must later
+* resume — an application middleware raising a generic pause, a future
+* workflow-to-AG-UI projection — attaches the binding through
+* {@link withInterruptBinding} rather than copying the string. Everything
+* outside this key is the plain AG-UI envelope and is left untouched.
+*/
+var INTERRUPT_BINDING_METADATA_KEY = "tanstack:interruptBinding";
+var interruptBindingMetadataKey = INTERRUPT_BINDING_METADATA_KEY;
+var InterruptResumeValidationError = class extends Error {
+	errors;
+	name = "InterruptResumeValidationError";
+	constructor(errors) {
+		super(errors.map((error) => error.message).join(" "));
+		this.errors = errors;
+	}
+};
+function objectValue(value) {
+	return value && typeof value === "object" ? value : null;
+}
+function stringField(value, key) {
+	return typeof value[key] === "string" ? value[key] : void 0;
+}
+function normalizeIssuePath(path) {
+	if (!path) return void 0;
+	return path.map((segment) => {
+		if (typeof segment === "string" || typeof segment === "number") return segment;
+		const key = objectValue(segment)?.key;
+		return typeof key === "number" ? key : String(key ?? segment);
+	});
+}
+function interruptItemError(input, interruptId, code, message, options) {
+	return {
+		scope: "item",
+		threadId: input.threadId,
+		interruptedRunId: input.interruptedRunId,
+		generation: input.generation,
+		interruptId,
+		code,
+		message,
+		source: options?.source ?? "client",
+		retryable: options?.retryable ?? false,
+		...options?.path ? { path: options.path } : {}
+	};
+}
+async function validateSchemaValue(input) {
+	if (isStandardSchema(input.schema)) {
+		const result = await validateWithStandardSchema(input.schema, input.value);
+		if (!result.success) for (const issue of result.issues) input.onIssue(issue.message, normalizeIssuePath(issue.path));
+		return;
+	}
+}
+function runtimeTool(tools, name) {
+	return tools.find((tool) => tool.name === name);
+}
+function descriptorResponseSchema(record) {
+	return objectValue(record.payload)?.responseSchema;
+}
+function schemaHash(schema) {
+	return digestInterruptJson(canonicalInterruptJson(schema));
+}
+async function pushSchemaIssues(input) {
+	try {
+		await validateSchemaValue({
+			schema: input.schema,
+			value: input.value,
+			onIssue: (message, path) => {
+				input.errors.push(interruptItemError(input.request, input.interruptId, input.code, `${input.label}: ${message}`, { path }));
+			}
+		});
+	} catch (error) {
+		input.errors.push(interruptItemError(input.request, input.interruptId, "invalid-response-schema", `${input.label} could not be validated: ${error instanceof Error ? error.message : String(error)}`, { source: "server" }));
+	}
+}
+function validateDescriptorSchema(input, record, binding, errors) {
+	const schema = descriptorResponseSchema(record);
+	if (schema === void 0 || schemaHash(schema) !== binding.responseSchemaHash) errors.push(interruptItemError(input, record.interruptId, "invalid-response-schema", `Interrupt ${record.interruptId} response schema no longer matches its binding.`, { source: "server" }));
+	return schema;
+}
+/**
+* Validate and translate a complete interrupt batch before any tool executes.
+* Used by ephemeral chat resume; a durable layer may share the same validator.
+*/
+async function validateInterruptResumeBatch(input) {
+	const grouped = /* @__PURE__ */ new Map();
+	const batchErrors = [];
+	const group = (interruptId) => {
+		const existing = grouped.get(interruptId);
+		if (existing) return existing;
+		const created = [];
+		grouped.set(interruptId, created);
+		return created;
+	};
+	const pendingById = new Map(input.pending.map((record) => [record.interruptId, record]));
+	const resumeById = /* @__PURE__ */ new Map();
+	const counts = /* @__PURE__ */ new Map();
+	for (const entry of input.resume ?? []) {
+		counts.set(entry.interruptId, (counts.get(entry.interruptId) ?? 0) + 1);
+		if (!resumeById.has(entry.interruptId)) resumeById.set(entry.interruptId, entry);
+	}
+	for (const [interruptId, count] of counts) if (count > 1) group(interruptId).push(interruptItemError(input, interruptId, "conflict", `Interrupt ${interruptId} has duplicate resume entries.`));
+	let incomplete = false;
+	for (const record of input.pending) {
+		const errors = group(record.interruptId);
+		const entry = resumeById.get(record.interruptId);
+		const binding = record.binding;
+		if (!entry) {
+			incomplete = true;
+			errors.push(interruptItemError(input, record.interruptId, "unknown-interrupt", `Missing resume entry for interrupt ${record.interruptId}.`));
+		}
+		if (binding.interruptedRunId !== input.interruptedRunId || binding.generation !== input.generation || binding.interruptId !== record.interruptId) errors.push(interruptItemError(input, record.interruptId, "stale", `Interrupt ${record.interruptId} has stale correlation metadata.`, { source: "server" }));
+		if (binding.expiresAt !== void 0 && Date.parse(binding.expiresAt) <= (input.now ?? Date.now())) errors.push(interruptItemError(input, record.interruptId, "expired", `Interrupt ${record.interruptId} has expired.`, { source: "server" }));
+		const responseSchema = validateDescriptorSchema(input, record, binding, errors);
+		if (!entry) continue;
+		const entryStatus = entry.status;
+		if (entryStatus !== "resolved" && entryStatus !== "cancelled") {
+			errors.push(interruptItemError(input, record.interruptId, "invalid-payload", `Interrupt ${record.interruptId} has invalid status ${String(entryStatus)}.`));
+			continue;
+		}
+		if (binding.kind === "generic") {
+			if (entry.status === "cancelled") {
+				if (entry.payload !== void 0) errors.push(interruptItemError(input, record.interruptId, "invalid-payload", `Cancelled interrupt ${record.interruptId} must not include a payload.`));
+			} else if (responseSchema !== void 0) await pushSchemaIssues({
+				request: input,
+				errors,
+				interruptId: record.interruptId,
+				schema: responseSchema,
+				value: entry.payload,
+				code: "invalid-payload",
+				label: `Interrupt ${record.interruptId} payload is invalid`
+			});
+			continue;
+		}
+		const tool = runtimeTool(input.tools, binding.toolName);
+		if (!tool) {
+			errors.push(interruptItemError(input, record.interruptId, "stale", `Tool ${binding.toolName} is unavailable for interrupt ${record.interruptId}.`, { source: "server" }));
+			continue;
+		}
+		let approval;
+		let schemaDrifted = false;
+		if (binding.kind === "client-tool-execution") {
+			if (hashSchemaInput(tool.outputSchema) !== binding.outputSchemaHash) {
+				errors.push(interruptItemError(input, record.interruptId, "stale", `Tool ${binding.toolName} output schema has changed.`, { source: "server" }));
+				schemaDrifted = true;
+			}
+		} else {
+			try {
+				approval = normalizeApprovalSchema(tool.approvalSchema, tool.inputSchema);
+			} catch {
+				errors.push(interruptItemError(input, record.interruptId, "stale", `Tool ${binding.toolName} approval schema is unavailable.`, { source: "server" }));
+				schemaDrifted = true;
+			}
+			if (approval !== void 0 && (hashSchemaInput(tool.inputSchema) !== binding.inputSchemaHash || approval.approvalSchemaHash !== binding.approvalSchemaHash || approval.responseSchemaHash !== binding.responseSchemaHash)) {
+				errors.push(interruptItemError(input, record.interruptId, "stale", `Tool ${binding.toolName} approval schema has changed.`, { source: "server" }));
+				schemaDrifted = true;
+			}
+		}
+		if (entry.status === "cancelled") {
+			if (entry.payload !== void 0) errors.push(interruptItemError(input, record.interruptId, "invalid-payload", `Cancelled interrupt ${record.interruptId} must not include a payload.`));
+			continue;
+		}
+		if (schemaDrifted) continue;
+		if (binding.kind === "client-tool-execution") {
+			if (responseSchema !== void 0) await pushSchemaIssues({
+				request: input,
+				errors,
+				interruptId: record.interruptId,
+				schema: responseSchema,
+				value: entry.payload,
+				code: "invalid-tool-output",
+				label: `Tool ${binding.toolName} output is invalid`
+			});
+			if (tool.outputSchema !== void 0) await pushSchemaIssues({
+				request: input,
+				errors,
+				interruptId: record.interruptId,
+				schema: tool.outputSchema,
+				value: entry.payload,
+				code: "invalid-tool-output",
+				label: `Tool ${binding.toolName} output is invalid`
+			});
+			continue;
+		}
+		if (approval === void 0) continue;
+		const envelope = objectValue(entry.payload);
+		const approved = typeof entry.payload === "boolean" ? entry.payload : typeof envelope?.approved === "boolean" ? envelope.approved : void 0;
+		if (approved === void 0) {
+			errors.push(interruptItemError(input, record.interruptId, "invalid-payload", `Approval ${record.interruptId} must be a boolean or decision envelope.`));
+			continue;
+		}
+		if (envelope) await pushSchemaIssues({
+			request: input,
+			errors,
+			interruptId: record.interruptId,
+			schema: approval.responseSchema,
+			value: entry.payload,
+			code: "invalid-payload",
+			label: `Approval ${record.interruptId} envelope is invalid`
+		});
+		if (approved && envelope?.editedArgs !== void 0) if (tool.inputSchema === void 0) errors.push(interruptItemError(input, record.interruptId, "invalid-edited-args", `Approval ${record.interruptId} cannot edit arguments without an input schema.`));
+		else await pushSchemaIssues({
+			request: input,
+			errors,
+			interruptId: record.interruptId,
+			schema: tool.inputSchema,
+			value: envelope.editedArgs,
+			code: "invalid-edited-args",
+			label: `Approval ${record.interruptId} edited arguments are invalid`
+		});
+		const branch = approved ? approval.branches.approve : approval.branches.reject;
+		if (branch) if (!envelope) errors.push(interruptItemError(input, record.interruptId, "invalid-payload", `Approval ${record.interruptId} requires a payload for the ${approved ? "approve" : "reject"} decision.`));
+		else await pushSchemaIssues({
+			request: input,
+			errors,
+			interruptId: record.interruptId,
+			schema: branch.source,
+			value: envelope.payload,
+			code: "invalid-payload",
+			label: `Approval ${record.interruptId} payload is invalid`
+		});
+	}
+	for (const entry of input.resume ?? []) if (!pendingById.has(entry.interruptId)) {
+		incomplete = true;
+		group(entry.interruptId).push(interruptItemError(input, entry.interruptId, "unknown-interrupt", `Resume entry references unknown interrupt ${entry.interruptId}.`));
+	}
+	if (incomplete) batchErrors.push({
+		scope: "batch",
+		threadId: input.threadId,
+		interruptedRunId: input.interruptedRunId,
+		generation: input.generation,
+		code: "incomplete-batch",
+		message: "Resume entries must resolve or cancel the complete interrupt batch.",
+		source: "client",
+		retryable: false,
+		interruptIds: input.pending.map((record) => record.interruptId)
+	});
+	const itemErrors = [...grouped.entries()].sort(([left], [right]) => left.localeCompare(right)).flatMap(([, errors]) => errors);
+	if (itemErrors.length > 0) {
+		batchErrors.push({
+			scope: "batch",
+			threadId: input.threadId,
+			interruptedRunId: input.interruptedRunId,
+			generation: input.generation,
+			code: "item-validation-failed",
+			message: "One or more interrupt resolutions are invalid.",
+			source: "client",
+			retryable: false,
+			interruptIds: input.pending.map((record) => record.interruptId)
+		});
+		return { errors: [...itemErrors, ...batchErrors] };
+	}
+	const canonical = canonicalizeInterruptResolutions(input.resume ?? []);
+	const approvals = /* @__PURE__ */ new Map();
+	const clientToolResults = /* @__PURE__ */ new Map();
+	const genericInterrupts = /* @__PURE__ */ new Map();
+	const deniedToolResults = /* @__PURE__ */ new Map();
+	const cancelledToolCallIds = /* @__PURE__ */ new Set();
+	for (const record of input.pending) {
+		const entry = resumeById.get(record.interruptId);
+		if (!entry) continue;
+		const binding = record.binding;
+		if (binding.kind === "generic") {
+			genericInterrupts.set(record.interruptId, entry.status === "resolved" ? {
+				interruptId: record.interruptId,
+				status: "resolved",
+				payload: entry.payload
+			} : {
+				interruptId: record.interruptId,
+				status: "cancelled"
+			});
+			continue;
+		}
+		if (entry.status === "cancelled") {
+			cancelledToolCallIds.add(binding.toolCallId);
+			continue;
+		}
+		if (binding.kind === "client-tool-execution") {
+			clientToolResults.set(binding.toolCallId, entry.payload);
+			continue;
+		}
+		const envelope = objectValue(entry.payload);
+		const resolution = typeof entry.payload === "boolean" ? entry.payload : envelope?.approved === true ? {
+			approved: true,
+			...envelope.editedArgs !== void 0 ? { editedArgs: envelope.editedArgs } : {},
+			...envelope.payload !== void 0 ? { payload: envelope.payload } : {}
+		} : {
+			approved: false,
+			...envelope?.payload !== void 0 ? { payload: envelope.payload } : {}
+		};
+		approvals.set(binding.toolCallId, resolution);
+		if (resolution === false || typeof resolution === "object" && !resolution.approved) deniedToolResults.set(binding.toolCallId, typeof resolution === "object" ? resolution.payload : void 0);
+	}
+	return {
+		errors: [],
+		resolutions: canonical.resolutions,
+		canonicalResolutions: canonical.canonicalResolutions,
+		fingerprint: canonical.fingerprint,
+		resumeToolState: {
+			approvals,
+			clientToolResults,
+			genericInterrupts,
+			deniedToolResults,
+			cancelledToolCallIds
+		}
+	};
+}
+/**
+* Is this a binding written by a version of the protocol we understand?
+*
+* A missing `v` is read as {@link INTERRUPT_BINDING_VERSION} so bindings
+* written before the field existed still resume. A `v` we don't recognise is
+* rejected outright — a newer or foreign producer's binding must not be
+* duck-typed into ours.
+*/
+function isSupportedBindingVersion(raw) {
+	const version = raw["v"];
+	if (version === void 0) return true;
+	return version === 1;
+}
+function readUnopenedInterruptBinding(descriptor) {
+	const metadata = objectValue(descriptor.metadata);
+	const raw = metadata ? objectValue(metadata[interruptBindingMetadataKey]) : null;
+	if (!raw || stringField(raw, "interruptId") !== descriptor.id) return void 0;
+	if (!isSupportedBindingVersion(raw)) return void 0;
+	const kind = stringField(raw, "kind");
+	const interruptId = stringField(raw, "interruptId");
+	const responseSchemaHash = stringField(raw, "responseSchemaHash");
+	const expiresAt = stringField(raw, "expiresAt");
+	if (!interruptId || !responseSchemaHash) return void 0;
+	const v = 1;
+	if (kind === "generic") return {
+		v,
+		kind,
+		interruptId,
+		responseSchemaHash,
+		...expiresAt ? { expiresAt } : {}
+	};
+	const toolName = stringField(raw, "toolName");
+	const toolCallId = stringField(raw, "toolCallId");
+	if (!toolName || !toolCallId) return void 0;
+	if (kind === "client-tool-execution") {
+		const outputSchemaHash = stringField(raw, "outputSchemaHash");
+		if (!outputSchemaHash) return void 0;
+		return {
+			v,
+			kind,
+			interruptId,
+			toolName,
+			toolCallId,
+			outputSchemaHash,
+			responseSchemaHash,
+			...expiresAt ? { expiresAt } : {}
+		};
+	}
+	if (kind === "tool-approval") {
+		const inputSchemaHash = stringField(raw, "inputSchemaHash");
+		const approvalSchemaHash = stringField(raw, "approvalSchemaHash");
+		if (!inputSchemaHash || !approvalSchemaHash) return void 0;
+		return {
+			v,
+			kind,
+			interruptId,
+			toolName,
+			toolCallId,
+			originalArgs: raw.originalArgs,
+			inputSchemaHash,
+			approvalSchemaHash,
+			responseSchemaHash,
+			...expiresAt ? { expiresAt } : {}
+		};
+	}
+}
+/**
+* Attach a resume binding to an interrupt descriptor, under
+* {@link INTERRUPT_BINDING_METADATA_KEY}.
+*
+* This is the supported way to make an interrupt resumable by this package.
+* The descriptor keeps its AG-UI shape; only `metadata` gains the namespaced
+* key. Pass the unopened form (no `interruptedRunId` / `generation`) when
+* emitting from inside a run — those fields are stamped as the run finishes.
+*/
+function withInterruptBinding(descriptor, binding) {
+	return {
+		...descriptor,
+		metadata: {
+			...descriptor.metadata,
+			[interruptBindingMetadataKey]: {
+				...binding,
+				v: 1,
+				interruptId: descriptor.id
+			}
+		}
+	};
+}
+/**
+* Read the opened resume binding off a descriptor, or `undefined` when the
+* descriptor carries no binding of a version we understand.
+*
+* `undefined` means "this interrupt is not ours to resume" — it is not a
+* failure to recover from by inventing a binding.
+*/
+function readInterruptBinding(descriptor) {
+	const unopened = readUnopenedInterruptBinding(descriptor);
+	if (!unopened) return void 0;
+	const metadata = objectValue(descriptor.metadata);
+	const raw = metadata ? objectValue(metadata[interruptBindingMetadataKey]) : null;
+	if (!raw) return void 0;
+	const interruptedRunId = stringField(raw, "interruptedRunId");
+	const generation = raw["generation"];
+	if (!interruptedRunId || typeof generation !== "number" || !Number.isInteger(generation) || generation < 0) return;
+	return {
+		...unopened,
+		interruptedRunId,
+		generation
+	};
+}
+function withoutInterruptBinding(descriptor) {
+	const metadata = objectValue(descriptor.metadata);
+	if (!metadata || !(interruptBindingMetadataKey in metadata)) return descriptor;
+	const publicMetadata = { ...metadata };
+	delete publicMetadata[interruptBindingMetadataKey];
+	return {
+		...descriptor,
+		metadata: publicMetadata
+	};
+}
+//#endregion
+export { INTERRUPT_BINDING_METADATA_KEY, InterruptResumeValidationError, interruptItemError, readInterruptBinding, readUnopenedInterruptBinding, validateInterruptResumeBatch, withInterruptBinding, withoutInterruptBinding };
+
+//# sourceMappingURL=interrupt-resume.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt-resume.js","names":[],"sources":["../../src/interrupt-resume.ts"],"sourcesContent":["import {\n  INTERRUPT_BINDING_VERSION,\n  canonicalizeInterruptResolutions,\n} from './interrupts'\nimport {\n  canonicalInterruptJson,\n  digestInterruptJson,\n} from './interrupt-serialization'\nimport {\n  hashSchemaInput,\n  normalizeApprovalSchema,\n} from './activities/chat/tools/approval-schema'\nimport {\n  isStandardSchema,\n  validateWithStandardSchema,\n} from './activities/chat/tools/schema-converter'\nimport type {\n  InterruptBinding,\n  InterruptSubmissionError,\n  ItemInterruptErrorCode,\n  ToolApprovalResolution,\n  UnopenedInterruptBinding,\n} from './interrupts'\nimport type {\n  ChatMiddlewareConfig,\n  ChatResumeToolState,\n} from './activities/chat/middleware/types'\nimport type { Interrupt, RunAgentResumeItem } from './types'\n\n/**\n * The `Interrupt.metadata` key under which this package's resume binding\n * travels.\n *\n * Exported so anything that produces an interrupt this package must later\n * resume — an application middleware raising a generic pause, a future\n * workflow-to-AG-UI projection — attaches the binding through\n * {@link withInterruptBinding} rather than copying the string. Everything\n * outside this key is the plain AG-UI envelope and is left untouched.\n */\nexport const INTERRUPT_BINDING_METADATA_KEY = 'tanstack:interruptBinding'\n\nconst interruptBindingMetadataKey = INTERRUPT_BINDING_METADATA_KEY\n\n/** The persistence-neutral shape required to validate an interrupt resume. */\nexport interface PendingInterruptResumeRecord {\n  interruptId: string\n  payload: unknown\n  binding: InterruptBinding\n}\n\nexport interface ValidateInterruptResumeBatchInput {\n  threadId: string\n  interruptedRunId: string\n  generation: number\n  pending: ReadonlyArray<PendingInterruptResumeRecord>\n  resume?: ReadonlyArray<RunAgentResumeItem>\n  tools: ChatMiddlewareConfig['tools']\n  now?: number\n}\n\nexport interface ValidatedInterruptResumeBatch {\n  errors: ReadonlyArray<InterruptSubmissionError>\n  resolutions?: ReadonlyArray<RunAgentResumeItem>\n  canonicalResolutions?: string\n  fingerprint?: string\n  resumeToolState?: ChatResumeToolState\n}\n\nexport class InterruptResumeValidationError extends Error {\n  override readonly name = 'InterruptResumeValidationError'\n\n  constructor(readonly errors: ReadonlyArray<InterruptSubmissionError>) {\n    super(errors.map((error) => error.message).join(' '))\n  }\n}\n\nfunction objectValue(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === 'object'\n    ? (value as Record<string, unknown>)\n    : null\n}\n\nfunction stringField(\n  value: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  return typeof value[key] === 'string' ? value[key] : undefined\n}\n\nfunction normalizeIssuePath(\n  path: ReadonlyArray<unknown> | undefined,\n): ReadonlyArray<string | number> | undefined {\n  if (!path) return undefined\n  return path.map((segment) => {\n    if (typeof segment === 'string' || typeof segment === 'number') {\n      return segment\n    }\n    const record = objectValue(segment)\n    const key = record?.key\n    return typeof key === 'number' ? key : String(key ?? segment)\n  })\n}\n\nexport function interruptItemError(\n  input: Pick<\n    ValidateInterruptResumeBatchInput,\n    'threadId' | 'interruptedRunId' | 'generation'\n  >,\n  interruptId: string,\n  code: ItemInterruptErrorCode,\n  message: string,\n  options?: {\n    path?: ReadonlyArray<string | number>\n    source?: 'client' | 'server'\n    retryable?: boolean\n  },\n): InterruptSubmissionError {\n  return {\n    scope: 'item',\n    threadId: input.threadId,\n    interruptedRunId: input.interruptedRunId,\n    generation: input.generation,\n    interruptId,\n    code,\n    message,\n    source: options?.source ?? 'client',\n    retryable: options?.retryable ?? false,\n    ...(options?.path ? { path: options.path } : {}),\n  }\n}\n\nasync function validateSchemaValue(input: {\n  schema: unknown\n  value: unknown\n  onIssue: (message: string, path?: ReadonlyArray<string | number>) => void\n}): Promise<void> {\n  if (isStandardSchema(input.schema)) {\n    const result = await validateWithStandardSchema<unknown>(\n      input.schema,\n      input.value,\n    )\n    if (!result.success) {\n      for (const issue of result.issues) {\n        input.onIssue(issue.message, normalizeIssuePath(issue.path))\n      }\n    }\n    return\n  }\n\n  // A non-Standard-Schema value (a raw JSON Schema, e.g. a generic interrupt's\n  // wire responseSchema) is not validated by the library. The application\n  // validates the resume value itself if it needs to; otherwise it flows\n  // through as-is.\n}\n\ntype RuntimeTool = ChatMiddlewareConfig['tools'][number] & {\n  approvalSchema?: Parameters<typeof normalizeApprovalSchema>[0]\n}\n\nfunction runtimeTool(\n  tools: ChatMiddlewareConfig['tools'],\n  name: string,\n): RuntimeTool | undefined {\n  return tools.find((tool) => tool.name === name) as RuntimeTool | undefined\n}\n\nfunction descriptorResponseSchema(\n  record: PendingInterruptResumeRecord,\n): unknown {\n  return objectValue(record.payload)?.responseSchema\n}\n\nfunction schemaHash(schema: unknown): string {\n  return digestInterruptJson(canonicalInterruptJson(schema))\n}\n\nasync function pushSchemaIssues(input: {\n  request: ValidateInterruptResumeBatchInput\n  errors: Array<InterruptSubmissionError>\n  interruptId: string\n  schema: unknown\n  value: unknown\n  code: ItemInterruptErrorCode\n  label: string\n}): Promise<void> {\n  try {\n    await validateSchemaValue({\n      schema: input.schema,\n      value: input.value,\n      onIssue: (message, path) => {\n        input.errors.push(\n          interruptItemError(\n            input.request,\n            input.interruptId,\n            input.code,\n            `${input.label}: ${message}`,\n            { path },\n          ),\n        )\n      },\n    })\n  } catch (error) {\n    input.errors.push(\n      interruptItemError(\n        input.request,\n        input.interruptId,\n        'invalid-response-schema',\n        `${input.label} could not be validated: ${error instanceof Error ? error.message : String(error)}`,\n        { source: 'server' },\n      ),\n    )\n  }\n}\n\nfunction validateDescriptorSchema(\n  input: ValidateInterruptResumeBatchInput,\n  record: PendingInterruptResumeRecord,\n  binding: InterruptBinding,\n  errors: Array<InterruptSubmissionError>,\n): unknown {\n  const schema = descriptorResponseSchema(record)\n  if (\n    schema === undefined ||\n    schemaHash(schema) !== binding.responseSchemaHash\n  ) {\n    errors.push(\n      interruptItemError(\n        input,\n        record.interruptId,\n        'invalid-response-schema',\n        `Interrupt ${record.interruptId} response schema no longer matches its binding.`,\n        { source: 'server' },\n      ),\n    )\n  }\n  return schema\n}\n\n/**\n * Validate and translate a complete interrupt batch before any tool executes.\n * Used by ephemeral chat resume; a durable layer may share the same validator.\n */\nexport async function validateInterruptResumeBatch(\n  input: ValidateInterruptResumeBatchInput,\n): Promise<ValidatedInterruptResumeBatch> {\n  const grouped = new Map<string, Array<InterruptSubmissionError>>()\n  const batchErrors: Array<InterruptSubmissionError> = []\n  const group = (interruptId: string): Array<InterruptSubmissionError> => {\n    const existing = grouped.get(interruptId)\n    if (existing) return existing\n    const created: Array<InterruptSubmissionError> = []\n    grouped.set(interruptId, created)\n    return created\n  }\n  const pendingById = new Map(\n    input.pending.map((record) => [record.interruptId, record]),\n  )\n  const resumeById = new Map<string, RunAgentResumeItem>()\n  const counts = new Map<string, number>()\n  for (const entry of input.resume ?? []) {\n    counts.set(entry.interruptId, (counts.get(entry.interruptId) ?? 0) + 1)\n    if (!resumeById.has(entry.interruptId))\n      resumeById.set(entry.interruptId, entry)\n  }\n\n  for (const [interruptId, count] of counts) {\n    if (count > 1) {\n      group(interruptId).push(\n        interruptItemError(\n          input,\n          interruptId,\n          'conflict',\n          `Interrupt ${interruptId} has duplicate resume entries.`,\n        ),\n      )\n    }\n  }\n\n  let incomplete = false\n  for (const record of input.pending) {\n    const errors = group(record.interruptId)\n    const entry = resumeById.get(record.interruptId)\n    const binding = record.binding\n    if (!entry) {\n      incomplete = true\n      errors.push(\n        interruptItemError(\n          input,\n          record.interruptId,\n          'unknown-interrupt',\n          `Missing resume entry for interrupt ${record.interruptId}.`,\n        ),\n      )\n    }\n    if (\n      binding.interruptedRunId !== input.interruptedRunId ||\n      binding.generation !== input.generation ||\n      binding.interruptId !== record.interruptId\n    ) {\n      errors.push(\n        interruptItemError(\n          input,\n          record.interruptId,\n          'stale',\n          `Interrupt ${record.interruptId} has stale correlation metadata.`,\n          { source: 'server' },\n        ),\n      )\n    }\n    if (\n      binding.expiresAt !== undefined &&\n      Date.parse(binding.expiresAt) <= (input.now ?? Date.now())\n    ) {\n      errors.push(\n        interruptItemError(\n          input,\n          record.interruptId,\n          'expired',\n          `Interrupt ${record.interruptId} has expired.`,\n          { source: 'server' },\n        ),\n      )\n    }\n\n    const responseSchema = validateDescriptorSchema(\n      input,\n      record,\n      binding,\n      errors,\n    )\n    if (!entry) continue\n    const entryStatus: unknown = entry.status\n    if (entryStatus !== 'resolved' && entryStatus !== 'cancelled') {\n      errors.push(\n        interruptItemError(\n          input,\n          record.interruptId,\n          'invalid-payload',\n          `Interrupt ${record.interruptId} has invalid status ${String(entryStatus)}.`,\n        ),\n      )\n      continue\n    }\n    if (binding.kind === 'generic') {\n      if (entry.status === 'cancelled') {\n        if (entry.payload !== undefined) {\n          errors.push(\n            interruptItemError(\n              input,\n              record.interruptId,\n              'invalid-payload',\n              `Cancelled interrupt ${record.interruptId} must not include a payload.`,\n            ),\n          )\n        }\n      } else if (responseSchema !== undefined) {\n        await pushSchemaIssues({\n          request: input,\n          errors,\n          interruptId: record.interruptId,\n          schema: responseSchema,\n          value: entry.payload,\n          code: 'invalid-payload',\n          label: `Interrupt ${record.interruptId} payload is invalid`,\n        })\n      }\n      continue\n    }\n\n    const tool = runtimeTool(input.tools, binding.toolName)\n    if (!tool) {\n      errors.push(\n        interruptItemError(\n          input,\n          record.interruptId,\n          'stale',\n          `Tool ${binding.toolName} is unavailable for interrupt ${record.interruptId}.`,\n          { source: 'server' },\n        ),\n      )\n      continue\n    }\n\n    let approval: ReturnType<typeof normalizeApprovalSchema> | undefined\n    let schemaDrifted = false\n    if (binding.kind === 'client-tool-execution') {\n      if (hashSchemaInput(tool.outputSchema) !== binding.outputSchemaHash) {\n        errors.push(\n          interruptItemError(\n            input,\n            record.interruptId,\n            'stale',\n            `Tool ${binding.toolName} output schema has changed.`,\n            { source: 'server' },\n          ),\n        )\n        schemaDrifted = true\n      }\n    } else {\n      try {\n        approval = normalizeApprovalSchema(\n          tool.approvalSchema,\n          tool.inputSchema,\n        )\n      } catch {\n        errors.push(\n          interruptItemError(\n            input,\n            record.interruptId,\n            'stale',\n            `Tool ${binding.toolName} approval schema is unavailable.`,\n            { source: 'server' },\n          ),\n        )\n        schemaDrifted = true\n      }\n      if (\n        approval !== undefined &&\n        (hashSchemaInput(tool.inputSchema) !== binding.inputSchemaHash ||\n          approval.approvalSchemaHash !== binding.approvalSchemaHash ||\n          approval.responseSchemaHash !== binding.responseSchemaHash)\n      ) {\n        errors.push(\n          interruptItemError(\n            input,\n            record.interruptId,\n            'stale',\n            `Tool ${binding.toolName} approval schema has changed.`,\n            { source: 'server' },\n          ),\n        )\n        schemaDrifted = true\n      }\n    }\n\n    if (entry.status === 'cancelled') {\n      if (entry.payload !== undefined) {\n        errors.push(\n          interruptItemError(\n            input,\n            record.interruptId,\n            'invalid-payload',\n            `Cancelled interrupt ${record.interruptId} must not include a payload.`,\n          ),\n        )\n      }\n      continue\n    }\n    if (schemaDrifted) continue\n\n    if (binding.kind === 'client-tool-execution') {\n      if (responseSchema !== undefined) {\n        await pushSchemaIssues({\n          request: input,\n          errors,\n          interruptId: record.interruptId,\n          schema: responseSchema,\n          value: entry.payload,\n          code: 'invalid-tool-output',\n          label: `Tool ${binding.toolName} output is invalid`,\n        })\n      }\n      if (tool.outputSchema !== undefined) {\n        await pushSchemaIssues({\n          request: input,\n          errors,\n          interruptId: record.interruptId,\n          schema: tool.outputSchema,\n          value: entry.payload,\n          code: 'invalid-tool-output',\n          label: `Tool ${binding.toolName} output is invalid`,\n        })\n      }\n      continue\n    }\n\n    if (approval === undefined) continue\n    const envelope = objectValue(entry.payload)\n    const approved =\n      typeof entry.payload === 'boolean'\n        ? entry.payload\n        : typeof envelope?.approved === 'boolean'\n          ? envelope.approved\n          : undefined\n    if (approved === undefined) {\n      errors.push(\n        interruptItemError(\n          input,\n          record.interruptId,\n          'invalid-payload',\n          `Approval ${record.interruptId} must be a boolean or decision envelope.`,\n        ),\n      )\n      continue\n    }\n    if (envelope) {\n      await pushSchemaIssues({\n        request: input,\n        errors,\n        interruptId: record.interruptId,\n        schema: approval.responseSchema,\n        value: entry.payload,\n        code: 'invalid-payload',\n        label: `Approval ${record.interruptId} envelope is invalid`,\n      })\n    }\n    if (approved && envelope?.editedArgs !== undefined) {\n      if (tool.inputSchema === undefined) {\n        errors.push(\n          interruptItemError(\n            input,\n            record.interruptId,\n            'invalid-edited-args',\n            `Approval ${record.interruptId} cannot edit arguments without an input schema.`,\n          ),\n        )\n      } else {\n        await pushSchemaIssues({\n          request: input,\n          errors,\n          interruptId: record.interruptId,\n          schema: tool.inputSchema,\n          value: envelope.editedArgs,\n          code: 'invalid-edited-args',\n          label: `Approval ${record.interruptId} edited arguments are invalid`,\n        })\n      }\n    }\n    const branch = approved\n      ? approval.branches.approve\n      : approval.branches.reject\n    if (branch) {\n      if (!envelope) {\n        errors.push(\n          interruptItemError(\n            input,\n            record.interruptId,\n            'invalid-payload',\n            `Approval ${record.interruptId} requires a payload for the ${approved ? 'approve' : 'reject'} decision.`,\n          ),\n        )\n      } else {\n        await pushSchemaIssues({\n          request: input,\n          errors,\n          interruptId: record.interruptId,\n          schema: branch.source,\n          value: envelope.payload,\n          code: 'invalid-payload',\n          label: `Approval ${record.interruptId} payload is invalid`,\n        })\n      }\n    }\n  }\n\n  for (const entry of input.resume ?? []) {\n    if (!pendingById.has(entry.interruptId)) {\n      incomplete = true\n      group(entry.interruptId).push(\n        interruptItemError(\n          input,\n          entry.interruptId,\n          'unknown-interrupt',\n          `Resume entry references unknown interrupt ${entry.interruptId}.`,\n        ),\n      )\n    }\n  }\n\n  if (incomplete) {\n    batchErrors.push({\n      scope: 'batch',\n      threadId: input.threadId,\n      interruptedRunId: input.interruptedRunId,\n      generation: input.generation,\n      code: 'incomplete-batch',\n      message:\n        'Resume entries must resolve or cancel the complete interrupt batch.',\n      source: 'client',\n      retryable: false,\n      interruptIds: input.pending.map((record) => record.interruptId),\n    })\n  }\n\n  const itemErrors = [...grouped.entries()]\n    .sort(([left], [right]) => left.localeCompare(right))\n    .flatMap(([, errors]) => errors)\n  if (itemErrors.length > 0) {\n    batchErrors.push({\n      scope: 'batch',\n      threadId: input.threadId,\n      interruptedRunId: input.interruptedRunId,\n      generation: input.generation,\n      code: 'item-validation-failed',\n      message: 'One or more interrupt resolutions are invalid.',\n      source: 'client',\n      retryable: false,\n      interruptIds: input.pending.map((record) => record.interruptId),\n    })\n    return { errors: [...itemErrors, ...batchErrors] }\n  }\n\n  const canonical = canonicalizeInterruptResolutions(input.resume ?? [])\n  const approvals = new Map<string, ToolApprovalResolution>()\n  const clientToolResults = new Map<string, unknown>()\n  const genericInterrupts = new Map<\n    string,\n    | { interruptId: string; status: 'resolved'; payload: unknown }\n    | { interruptId: string; status: 'cancelled' }\n  >()\n  const deniedToolResults = new Map<string, unknown>()\n  const cancelledToolCallIds = new Set<string>()\n\n  for (const record of input.pending) {\n    const entry = resumeById.get(record.interruptId)\n    if (!entry) continue\n    const binding = record.binding\n    if (binding.kind === 'generic') {\n      genericInterrupts.set(\n        record.interruptId,\n        entry.status === 'resolved'\n          ? {\n              interruptId: record.interruptId,\n              status: 'resolved',\n              payload: entry.payload,\n            }\n          : { interruptId: record.interruptId, status: 'cancelled' },\n      )\n      continue\n    }\n    if (entry.status === 'cancelled') {\n      cancelledToolCallIds.add(binding.toolCallId)\n      continue\n    }\n    if (binding.kind === 'client-tool-execution') {\n      clientToolResults.set(binding.toolCallId, entry.payload)\n      continue\n    }\n    const envelope = objectValue(entry.payload)\n    const resolution: ToolApprovalResolution =\n      typeof entry.payload === 'boolean'\n        ? entry.payload\n        : envelope?.approved === true\n          ? {\n              approved: true,\n              ...(envelope.editedArgs !== undefined\n                ? { editedArgs: envelope.editedArgs }\n                : {}),\n              ...(envelope.payload !== undefined\n                ? { payload: envelope.payload }\n                : {}),\n            }\n          : {\n              approved: false,\n              ...(envelope?.payload !== undefined\n                ? { payload: envelope.payload }\n                : {}),\n            }\n    approvals.set(binding.toolCallId, resolution)\n    if (\n      resolution === false ||\n      (typeof resolution === 'object' && !resolution.approved)\n    ) {\n      deniedToolResults.set(\n        binding.toolCallId,\n        typeof resolution === 'object' ? resolution.payload : undefined,\n      )\n    }\n  }\n\n  return {\n    errors: [],\n    resolutions: canonical.resolutions,\n    canonicalResolutions: canonical.canonicalResolutions,\n    fingerprint: canonical.fingerprint,\n    resumeToolState: {\n      approvals,\n      clientToolResults,\n      genericInterrupts,\n      deniedToolResults,\n      cancelledToolCallIds,\n    },\n  }\n}\n\n/**\n * Is this a binding written by a version of the protocol we understand?\n *\n * A missing `v` is read as {@link INTERRUPT_BINDING_VERSION} so bindings\n * written before the field existed still resume. A `v` we don't recognise is\n * rejected outright — a newer or foreign producer's binding must not be\n * duck-typed into ours.\n */\nfunction isSupportedBindingVersion(raw: Record<string, unknown>): boolean {\n  const version = raw['v']\n  if (version === undefined) return true\n  return version === INTERRUPT_BINDING_VERSION\n}\n\nexport function readUnopenedInterruptBinding(\n  descriptor: Interrupt,\n): UnopenedInterruptBinding | undefined {\n  const metadata = objectValue(descriptor.metadata)\n  const raw = metadata\n    ? objectValue(metadata[interruptBindingMetadataKey])\n    : null\n  if (!raw || stringField(raw, 'interruptId') !== descriptor.id)\n    return undefined\n  if (!isSupportedBindingVersion(raw)) return undefined\n  const kind = stringField(raw, 'kind')\n  const interruptId = stringField(raw, 'interruptId')\n  const responseSchemaHash = stringField(raw, 'responseSchemaHash')\n  const expiresAt = stringField(raw, 'expiresAt')\n  if (!interruptId || !responseSchemaHash) return undefined\n  const v = INTERRUPT_BINDING_VERSION\n  if (kind === 'generic') {\n    return {\n      v,\n      kind,\n      interruptId,\n      responseSchemaHash,\n      ...(expiresAt ? { expiresAt } : {}),\n    }\n  }\n  const toolName = stringField(raw, 'toolName')\n  const toolCallId = stringField(raw, 'toolCallId')\n  if (!toolName || !toolCallId) return undefined\n  if (kind === 'client-tool-execution') {\n    const outputSchemaHash = stringField(raw, 'outputSchemaHash')\n    if (!outputSchemaHash) return undefined\n    return {\n      v,\n      kind,\n      interruptId,\n      toolName,\n      toolCallId,\n      outputSchemaHash,\n      responseSchemaHash,\n      ...(expiresAt ? { expiresAt } : {}),\n    }\n  }\n  if (kind === 'tool-approval') {\n    const inputSchemaHash = stringField(raw, 'inputSchemaHash')\n    const approvalSchemaHash = stringField(raw, 'approvalSchemaHash')\n    if (!inputSchemaHash || !approvalSchemaHash) return undefined\n    return {\n      v,\n      kind,\n      interruptId,\n      toolName,\n      toolCallId,\n      originalArgs: raw.originalArgs,\n      inputSchemaHash,\n      approvalSchemaHash,\n      responseSchemaHash,\n      ...(expiresAt ? { expiresAt } : {}),\n    }\n  }\n  return undefined\n}\n\n/**\n * Attach a resume binding to an interrupt descriptor, under\n * {@link INTERRUPT_BINDING_METADATA_KEY}.\n *\n * This is the supported way to make an interrupt resumable by this package.\n * The descriptor keeps its AG-UI shape; only `metadata` gains the namespaced\n * key. Pass the unopened form (no `interruptedRunId` / `generation`) when\n * emitting from inside a run — those fields are stamped as the run finishes.\n */\nexport function withInterruptBinding(\n  descriptor: Interrupt,\n  binding: UnopenedInterruptBinding | InterruptBinding,\n): Interrupt {\n  return {\n    ...descriptor,\n    metadata: {\n      ...descriptor.metadata,\n      [interruptBindingMetadataKey]: {\n        ...binding,\n        v: INTERRUPT_BINDING_VERSION,\n        interruptId: descriptor.id,\n      },\n    },\n  }\n}\n\n/**\n * Read the opened resume binding off a descriptor, or `undefined` when the\n * descriptor carries no binding of a version we understand.\n *\n * `undefined` means \"this interrupt is not ours to resume\" — it is not a\n * failure to recover from by inventing a binding.\n */\nexport function readInterruptBinding(\n  descriptor: Interrupt,\n): InterruptBinding | undefined {\n  const unopened = readUnopenedInterruptBinding(descriptor)\n  if (!unopened) return undefined\n  const metadata = objectValue(descriptor.metadata)\n  const raw = metadata\n    ? objectValue(metadata[interruptBindingMetadataKey])\n    : null\n  if (!raw) return undefined\n  const interruptedRunId = stringField(raw, 'interruptedRunId')\n  const generation = raw['generation']\n  if (\n    !interruptedRunId ||\n    typeof generation !== 'number' ||\n    !Number.isInteger(generation) ||\n    generation < 0\n  ) {\n    return undefined\n  }\n  return { ...unopened, interruptedRunId, generation }\n}\n\nexport function withoutInterruptBinding(descriptor: Interrupt): Interrupt {\n  const metadata = objectValue(descriptor.metadata)\n  if (!metadata || !(interruptBindingMetadataKey in metadata)) return descriptor\n  const publicMetadata = { ...metadata }\n  delete publicMetadata[interruptBindingMetadataKey]\n  return { ...descriptor, metadata: publicMetadata }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,12 @@
+/**
+ * A hash function for interrupt bindings and resolution fingerprints. Receives
+ * canonical JSON text and returns an opaque string. Must be deterministic; the
+ * server compares hashes it computed against the ones in a binding, so the same
+ * function has to run wherever a given binding is produced and checked.
+ */
+export type InterruptHash = (canonicalJson: string) => string;
+/** The built-in default: SHA-256, prefixed so the algorithm is self-describing. */
+export declare function defaultInterruptHash(canonicalJson: string): string;
+export declare function canonicalInterruptJson(value: unknown): string;
+export declare function digestInterruptJson(canonicalJson: string, hash?: InterruptHash): string;
+export declare function cloneAndDeepFreezeJson<T>(value: T): T;