@tanstack/ai 0.42.0 → 0.43.1

package/dist/esm/delivery-disconnect.js

@@ -0,0 +1,81 @@
+//#region src/delivery-disconnect.ts
+/**
+* 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.
+*/
+/**
+* Per-stream disconnect handlers. Keyed weakly by the stream object, so a stream
+* dropped without ever being consumed takes its entry with it.
+*/
+var disconnectHandlers = /* @__PURE__ */ new WeakMap();
+/**
+* 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
+*/
+function publishRunDisconnectHandler(stream, onDisconnect) {
+	disconnectHandlers.set(stream, onDisconnect);
+}
+/**
+* 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
+*/
+function notifyRunDisconnected(stream) {
+	if (typeof stream !== "object" || stream === null) return;
+	const handler = disconnectHandlers.get(stream);
+	if (handler === void 0) return;
+	try {
+		handler();
+	} catch {}
+}
+//#endregion
+export { notifyRunDisconnected, publishRunDisconnectHandler };
+
+//# sourceMappingURL=delivery-disconnect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-disconnect.js","names":[],"sources":["../../src/delivery-disconnect.ts"],"sourcesContent":["/**\n * The one-way channel from the durable DELIVERY sink back to the chat run: \"your\n * viewer is gone, but you are not.\"\n *\n * This is the MIRROR of `./delivery-detach.ts`. That module answers a question the\n * sink asks the run (was this abort a detach?); this one delivers a fact the sink\n * learns first and the run cannot observe at all — the response body was\n * cancelled. Both are keyed weakly by the exact stream object `chat()` returned,\n * for the same reason: passing that object to\n * `toServerSentEventsResponse(stream, { durability })` is already mandatory, so it\n * is the one seam an application cannot forget to wire.\n *\n * WHY THE RUN CANNOT JUST WATCH AN ABORT SIGNAL. Before this channel existed, the\n * only way a disconnect reached a run's middleware was for the application to\n * mirror `request.signal` into `chat()`'s `abortController` — which ABORTS THE RUN.\n * For a durable run that is precisely wrong, and wrong in the most expensive\n * direction: `chat()` returns at its `isCancelled()` check immediately after\n * middleware setup, so the harness adapter's `chatStream` is never called and the\n * agent in the freshly-created sandbox is NEVER LAUNCHED. The user re-attaches to\n * an empty log belonging to a run that did nothing, and no takeover can recover it\n * because there is no journal to replay. The application was forced to choose\n * between \"the middleware learns about the disconnect\" and \"the run survives it\".\n *\n * So the disconnect travels as a NOTIFICATION rather than a cancellation. The run\n * hands it to whatever subscribed through `RunDisconnectCapability` — bookkeeping\n * only, no teardown — and keeps producing into its still-open durable log, which\n * is exactly what a re-attaching client tails to catch up.\n *\n * DISPATCHED FROM THE TRANSPORT, NOT FROM THE RUN'S UNWINDING. That is what makes\n * it prompt. A run suspended inside a minutes-wide `setup` (cloning a repo into a\n * sandbox) cannot dispatch anything from its own `finally`, because the `finally`\n * is reached only once the generator unwinds — which is what made `detachedSince`\n * land three minutes late instead of immediately.\n */\n\n/**\n * Per-stream disconnect handlers. Keyed weakly by the stream object, so a stream\n * dropped without ever being consumed takes its entry with it.\n */\nconst disconnectHandlers = new WeakMap<object, () => void>()\n\n/**\n * Publish `stream`'s disconnect handler. 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, matching `publishRunDetachedSignal`.\n *\n * @internal\n */\nexport function publishRunDisconnectHandler(\n  stream: object,\n  onDisconnect: () => void,\n): void {\n  disconnectHandlers.set(stream, onDisconnect)\n}\n\n/**\n * Tell the run behind `stream` that its delivery socket closed.\n *\n * A NO-OP for anything that never published a handler — a hand-rolled iterable, a\n * `chat()` from an older build, a non-object source — so an unknown stream simply\n * keeps today's behavior.\n *\n * NEVER THROWS and never returns a promise to await. This is called from\n * `ReadableStream.cancel()`, whose rejection would surface as an unhandled error\n * on a path where the consumer has already gone away; and the handler's own work\n * is tracked by the run (which awaits it before finishing), not by this call. A\n * throwing handler is swallowed for the same reason `wasRunDetached` swallows: the\n * disconnect path has no second channel to report on.\n *\n * @internal\n */\nexport function notifyRunDisconnected(stream: unknown): void {\n  if (typeof stream !== 'object' || stream === null) return\n  const handler = disconnectHandlers.get(stream)\n  if (handler === undefined) return\n  try {\n    handler()\n  } catch {\n    // Intentionally empty: see above.\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,IAAM,qCAAqB,IAAI,QAA4B;;;;;;;;;;;AAY3D,SAAgB,4BACd,QACA,cACM;CACN,mBAAmB,IAAI,QAAQ,YAAY;AAC7C;;;;;;;;;;;;;;;;;AAkBA,SAAgB,sBAAsB,QAAuB;CAC3D,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM;CACnD,MAAM,UAAU,mBAAmB,IAAI,MAAM;CAC7C,IAAI,YAAY,KAAA,GAAW;CAC3B,IAAI;EACF,QAAQ;CACV,QAAQ,CAER;AACF"}

package/dist/esm/extend-adapter.js

@@ -1,21 +1,23 @@
+//#region src/extend-adapter.ts
 function createModel(name, second) {
-  if (Array.isArray(second)) {
-    return { name, input: second, modelOptions: {} };
-  }
-  const caps = second;
-  return {
-    name,
-    input: caps.input ?? ["text"],
-    modelOptions: caps.modelOptions ?? {},
-    features: caps.features,
-    tools: caps.tools
-  };
+	if (Array.isArray(second)) return {
+		name,
+		input: second,
+		modelOptions: {}
+	};
+	const caps = second;
+	return {
+		name,
+		input: caps.input ?? ["text"],
+		modelOptions: caps.modelOptions ?? {},
+		features: caps.features,
+		tools: caps.tools
+	};
 }
 function extendAdapter(factory, _customModels) {
-  return factory;
+	return factory;
 }
-export {
-  createModel,
-  extendAdapter
-};
-//# sourceMappingURL=extend-adapter.js.map
+//#endregion
+export { createModel, extendAdapter };
+
+//# sourceMappingURL=extend-adapter.js.map

package/dist/esm/extend-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"extend-adapter.js","sources":["../../src/extend-adapter.ts"],"sourcesContent":["import type { Modality } from './types'\n\n// ===========================\n// Extended Model Definition\n// ===========================\n\n/**\n * Definition for a custom model to add to an adapter.\n *\n * @template TName - The model name as a literal string type\n * @template TInput - Array of supported input modalities\n * @template TOptions - Provider options type for this model\n *\n * @example\n * ```typescript\n * const customModels = [\n *   createModel('my-custom-model', ['text', 'image']),\n * ] as const\n * ```\n */\nexport interface ExtendedModelDef<\n  TName extends string = string,\n  TInput extends ReadonlyArray<Modality> = ReadonlyArray<Modality>,\n  TOptions = unknown,\n  TFeatures extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TTools extends ReadonlyArray<string> = ReadonlyArray<string>,\n> {\n  /** The model name identifier */\n  name: TName\n  /** Supported input modalities for this model */\n  input: TInput\n  /** Type brand for provider options - use `{} as YourOptionsType` */\n  modelOptions: TOptions\n  /** Optional declared features (e.g. 'reasoning', 'structured_outputs') */\n  features?: TFeatures\n  /** Optional declared provider tools (e.g. 'web_search') */\n  tools?: TTools\n}\n\n/** Capability bag accepted by the object form of `createModel`. */\nexport interface ModelCapabilities<\n  TInput extends ReadonlyArray<Modality> = ReadonlyArray<Modality>,\n  TFeatures extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TTools extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TOptions = unknown,\n> {\n  input?: TInput\n  features?: TFeatures\n  tools?: TTools\n  modelOptions?: TOptions\n}\n\n/**\n * Creates a custom model definition for use with `extendAdapter`.\n *\n * This is a helper function that provides proper type inference without\n * requiring manual `as const` casts on individual properties.\n *\n * @template TName - The model name (inferred from argument)\n * @template TInput - The input modalities array (inferred from argument)\n *\n * @param name - The model name identifier (literal string)\n * @param input - Array of supported input modalities\n * @returns A properly typed model definition for use with `extendAdapter`\n *\n * @example\n * ```typescript\n * import { extendAdapter, createModel } from '@tanstack/ai'\n * import { openaiText } from '@tanstack/ai-openai'\n *\n * // Define custom models with full type inference\n * const customModels = [\n *   createModel('my-fine-tuned-gpt4', ['text', 'image']),\n *   createModel('local-llama', ['text']),\n * ] as const\n *\n * const myOpenai = extendAdapter(openaiText, customModels)\n * ```\n *\n * @example\n * ```typescript\n * // Capabilities object form - declare features and provider tools\n * const reasoner = createModel('reasoner', {\n *   input: ['text'],\n *   features: ['reasoning', 'structured_outputs'],\n *   tools: ['web_search'],\n * })\n * ```\n */\n// Overload 1 — legacy positional input array (unchanged behavior)\nexport function createModel<\n  const TName extends string,\n  const TInput extends ReadonlyArray<Modality>,\n>(name: TName, input: TInput): ExtendedModelDef<TName, TInput>\n// Overload 2 — capabilities object\nexport function createModel<\n  const TName extends string,\n  const TCaps extends ModelCapabilities,\n>(\n  name: TName,\n  capabilities: TCaps,\n): ExtendedModelDef<\n  TName,\n  TCaps['input'] extends ReadonlyArray<Modality>\n    ? TCaps['input']\n    : ReadonlyArray<Modality>,\n  TCaps['modelOptions'],\n  TCaps['features'] extends ReadonlyArray<string>\n    ? TCaps['features']\n    : ReadonlyArray<string>,\n  TCaps['tools'] extends ReadonlyArray<string>\n    ? TCaps['tools']\n    : ReadonlyArray<string>\n>\n// Implementation\nexport function createModel(\n  name: string,\n  second: ReadonlyArray<Modality> | ModelCapabilities,\n): ExtendedModelDef {\n  if (Array.isArray(second)) {\n    return { name, input: second, modelOptions: {} }\n  }\n  const caps = second as ModelCapabilities\n  return {\n    name,\n    input: caps.input ?? (['text'] as ReadonlyArray<Modality>),\n    modelOptions: caps.modelOptions ?? {},\n    features: caps.features,\n    tools: caps.tools,\n  }\n}\n\n// ===========================\n// Type Extraction Utilities\n// ===========================\n\n/**\n * Extract the model name union from an array of model definitions.\n */\ntype ExtractCustomModelNames<TDefs extends ReadonlyArray<ExtendedModelDef>> =\n  TDefs[number]['name']\n\n// ===========================\n// Factory Type Inference\n// ===========================\n\n/**\n * The widest factory shape `extendAdapter` accepts: any function taking a\n * model as its first parameter. Parameters are contravariant, so `never`\n * params and an `unknown` return accept every factory without resorting\n * to `any`.\n */\ntype AnyAdapterFactory = (model: never, ...args: Array<never>) => unknown\n\n/**\n * Infer the model parameter type from an adapter factory function.\n * For generic functions like `<T extends Union>(model: T)`, this gets `T` which\n * TypeScript treats as the constraint union when used in parameter position.\n */\ntype InferFactoryModels<TFactory> = TFactory extends (\n  model: infer TModel,\n  ...args: Array<never>\n) => unknown\n  ? TModel extends string\n    ? TModel\n    : string\n  : string\n\n/**\n * Infer the adapter return type from a factory function.\n */\ntype InferAdapterReturn<TFactory> = TFactory extends (\n  ...args: Array<never>\n) => infer TReturn\n  ? TReturn\n  : never\n\n/**\n * Extracts all parameter types after the model parameter from a factory,\n * preserving labels and optionality (e.g. `[apiKey: string, config?: C]`).\n * Note: overloaded factories resolve against their last overload (a\n * `Parameters` limitation).\n */\ntype InferRestArgs<TFactory extends AnyAdapterFactory> =\n  Parameters<TFactory> extends [unknown?, ...infer TRest] ? TRest : []\n\n/**\n * The factory signature produced by `extendAdapter`: accepts both original\n * and custom model names while preserving all remaining parameters and the\n * return type of the original factory.\n */\ntype ExtendedFactory<\n  TFactory extends AnyAdapterFactory,\n  TDefs extends ReadonlyArray<ExtendedModelDef>,\n> = (\n  model: InferFactoryModels<TFactory> | ExtractCustomModelNames<TDefs>,\n  ...args: InferRestArgs<TFactory>\n) => InferAdapterReturn<TFactory>\n\n// ===========================\n// extendAdapter Function\n// ===========================\n\n/**\n * Extends an existing adapter factory with additional custom models.\n *\n * The extended adapter accepts both original models (with full original type inference)\n * and custom models (with types from your definitions).\n *\n * At runtime, this simply passes through to the original factory - no validation is performed.\n * The original factory's signature is fully preserved, including any config parameters.\n *\n * @param factory - The original adapter factory function (e.g., `openaiText`, `anthropicText`)\n * @param models - Array of custom model definitions with `name` and `input`\n * @returns A new factory function that accepts both original and custom models\n *\n * @example\n * ```typescript\n * import { extendAdapter, createModel } from '@tanstack/ai'\n * import { openaiText } from '@tanstack/ai-openai'\n *\n * // Define custom models\n * const customModels = [\n *   createModel('my-fine-tuned-gpt4', ['text', 'image']),\n *   createModel('local-llama', ['text']),\n * ] as const\n *\n * // Create extended adapter\n * const myOpenai = extendAdapter(openaiText, customModels)\n *\n * // Use with original models - full type inference preserved\n * const gpt4 = myOpenai('gpt-4o')\n *\n * // Use with custom models\n * const custom = myOpenai('my-fine-tuned-gpt4')\n *\n * // Type error: 'invalid-model' is not a valid model\n * // myOpenai('invalid-model')\n *\n * // Works with chat()\n * chat({\n *   adapter: myOpenai('my-fine-tuned-gpt4'),\n *   messages: [...]\n * })\n * ```\n */\nexport function extendAdapter<\n  TFactory extends AnyAdapterFactory,\n  const TDefs extends ReadonlyArray<ExtendedModelDef>,\n>(factory: TFactory, _customModels: TDefs): ExtendedFactory<TFactory, TDefs>\n// The implementation signature stays at the honest `AnyAdapterFactory` width;\n// the overload above performs the deliberate model-union widening.\nexport function extendAdapter(\n  factory: AnyAdapterFactory,\n  _customModels: ReadonlyArray<ExtendedModelDef>,\n): AnyAdapterFactory {\n  // At runtime, we simply pass through to the original factory.\n  // The _customModels parameter is only used for type inference.\n  // No runtime validation - users are trusted to pass valid model names.\n  return factory\n}\n"],"names":[],"mappings":"AAmHO,SAAS,YACd,MACA,QACkB;AAClB,MAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,WAAO,EAAE,MAAM,OAAO,QAAQ,cAAc,CAAA,EAAC;AAAA,EAC/C;AACA,QAAM,OAAO;AACb,SAAO;AAAA,IACL;AAAA,IACA,OAAO,KAAK,SAAU,CAAC,MAAM;AAAA,IAC7B,cAAc,KAAK,gBAAgB,CAAA;AAAA,IACnC,UAAU,KAAK;AAAA,IACf,OAAO,KAAK;AAAA,EAAA;AAEhB;AA0HO,SAAS,cACd,SACA,eACmB;AAInB,SAAO;AACT;"}
+{"version":3,"file":"extend-adapter.js","names":[],"sources":["../../src/extend-adapter.ts"],"sourcesContent":["import type { Modality } from './types'\n\n// ===========================\n// Extended Model Definition\n// ===========================\n\n/**\n * Definition for a custom model to add to an adapter.\n *\n * @template TName - The model name as a literal string type\n * @template TInput - Array of supported input modalities\n * @template TOptions - Provider options type for this model\n *\n * @example\n * ```typescript\n * const customModels = [\n *   createModel('my-custom-model', ['text', 'image']),\n * ] as const\n * ```\n */\nexport interface ExtendedModelDef<\n  TName extends string = string,\n  TInput extends ReadonlyArray<Modality> = ReadonlyArray<Modality>,\n  TOptions = unknown,\n  TFeatures extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TTools extends ReadonlyArray<string> = ReadonlyArray<string>,\n> {\n  /** The model name identifier */\n  name: TName\n  /** Supported input modalities for this model */\n  input: TInput\n  /** Type brand for provider options - use `{} as YourOptionsType` */\n  modelOptions: TOptions\n  /** Optional declared features (e.g. 'reasoning', 'structured_outputs') */\n  features?: TFeatures\n  /** Optional declared provider tools (e.g. 'web_search') */\n  tools?: TTools\n}\n\n/** Capability bag accepted by the object form of `createModel`. */\nexport interface ModelCapabilities<\n  TInput extends ReadonlyArray<Modality> = ReadonlyArray<Modality>,\n  TFeatures extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TTools extends ReadonlyArray<string> = ReadonlyArray<string>,\n  TOptions = unknown,\n> {\n  input?: TInput\n  features?: TFeatures\n  tools?: TTools\n  modelOptions?: TOptions\n}\n\n/**\n * Creates a custom model definition for use with `extendAdapter`.\n *\n * This is a helper function that provides proper type inference without\n * requiring manual `as const` casts on individual properties.\n *\n * @template TName - The model name (inferred from argument)\n * @template TInput - The input modalities array (inferred from argument)\n *\n * @param name - The model name identifier (literal string)\n * @param input - Array of supported input modalities\n * @returns A properly typed model definition for use with `extendAdapter`\n *\n * @example\n * ```typescript\n * import { extendAdapter, createModel } from '@tanstack/ai'\n * import { openaiText } from '@tanstack/ai-openai'\n *\n * // Define custom models with full type inference\n * const customModels = [\n *   createModel('my-fine-tuned-gpt4', ['text', 'image']),\n *   createModel('local-llama', ['text']),\n * ] as const\n *\n * const myOpenai = extendAdapter(openaiText, customModels)\n * ```\n *\n * @example\n * ```typescript\n * // Capabilities object form - declare features and provider tools\n * const reasoner = createModel('reasoner', {\n *   input: ['text'],\n *   features: ['reasoning', 'structured_outputs'],\n *   tools: ['web_search'],\n * })\n * ```\n */\n// Overload 1 — legacy positional input array (unchanged behavior)\nexport function createModel<\n  const TName extends string,\n  const TInput extends ReadonlyArray<Modality>,\n>(name: TName, input: TInput): ExtendedModelDef<TName, TInput>\n// Overload 2 — capabilities object\nexport function createModel<\n  const TName extends string,\n  const TCaps extends ModelCapabilities,\n>(\n  name: TName,\n  capabilities: TCaps,\n): ExtendedModelDef<\n  TName,\n  TCaps['input'] extends ReadonlyArray<Modality>\n    ? TCaps['input']\n    : ReadonlyArray<Modality>,\n  TCaps['modelOptions'],\n  TCaps['features'] extends ReadonlyArray<string>\n    ? TCaps['features']\n    : ReadonlyArray<string>,\n  TCaps['tools'] extends ReadonlyArray<string>\n    ? TCaps['tools']\n    : ReadonlyArray<string>\n>\n// Implementation\nexport function createModel(\n  name: string,\n  second: ReadonlyArray<Modality> | ModelCapabilities,\n): ExtendedModelDef {\n  if (Array.isArray(second)) {\n    return { name, input: second, modelOptions: {} }\n  }\n  const caps = second as ModelCapabilities\n  return {\n    name,\n    input: caps.input ?? (['text'] as ReadonlyArray<Modality>),\n    modelOptions: caps.modelOptions ?? {},\n    features: caps.features,\n    tools: caps.tools,\n  }\n}\n\n// ===========================\n// Type Extraction Utilities\n// ===========================\n\n/**\n * Extract the model name union from an array of model definitions.\n */\ntype ExtractCustomModelNames<TDefs extends ReadonlyArray<ExtendedModelDef>> =\n  TDefs[number]['name']\n\n// ===========================\n// Factory Type Inference\n// ===========================\n\n/**\n * The widest factory shape `extendAdapter` accepts: any function taking a\n * model as its first parameter. Parameters are contravariant, so `never`\n * params and an `unknown` return accept every factory without resorting\n * to `any`.\n */\ntype AnyAdapterFactory = (model: never, ...args: Array<never>) => unknown\n\n/**\n * Infer the model parameter type from an adapter factory function.\n * For generic functions like `<T extends Union>(model: T)`, this gets `T` which\n * TypeScript treats as the constraint union when used in parameter position.\n */\ntype InferFactoryModels<TFactory> = TFactory extends (\n  model: infer TModel,\n  ...args: Array<never>\n) => unknown\n  ? TModel extends string\n    ? TModel\n    : string\n  : string\n\n/**\n * Infer the adapter return type from a factory function.\n */\ntype InferAdapterReturn<TFactory> = TFactory extends (\n  ...args: Array<never>\n) => infer TReturn\n  ? TReturn\n  : never\n\n/**\n * Extracts all parameter types after the model parameter from a factory,\n * preserving labels and optionality (e.g. `[apiKey: string, config?: C]`).\n * Note: overloaded factories resolve against their last overload (a\n * `Parameters` limitation).\n */\ntype InferRestArgs<TFactory extends AnyAdapterFactory> =\n  Parameters<TFactory> extends [unknown?, ...infer TRest] ? TRest : []\n\n/**\n * The factory signature produced by `extendAdapter`: accepts both original\n * and custom model names while preserving all remaining parameters and the\n * return type of the original factory.\n */\ntype ExtendedFactory<\n  TFactory extends AnyAdapterFactory,\n  TDefs extends ReadonlyArray<ExtendedModelDef>,\n> = (\n  model: InferFactoryModels<TFactory> | ExtractCustomModelNames<TDefs>,\n  ...args: InferRestArgs<TFactory>\n) => InferAdapterReturn<TFactory>\n\n// ===========================\n// extendAdapter Function\n// ===========================\n\n/**\n * Extends an existing adapter factory with additional custom models.\n *\n * The extended adapter accepts both original models (with full original type inference)\n * and custom models (with types from your definitions).\n *\n * At runtime, this simply passes through to the original factory - no validation is performed.\n * The original factory's signature is fully preserved, including any config parameters.\n *\n * @param factory - The original adapter factory function (e.g., `openaiText`, `anthropicText`)\n * @param models - Array of custom model definitions with `name` and `input`\n * @returns A new factory function that accepts both original and custom models\n *\n * @example\n * ```typescript\n * import { extendAdapter, createModel } from '@tanstack/ai'\n * import { openaiText } from '@tanstack/ai-openai'\n *\n * // Define custom models\n * const customModels = [\n *   createModel('my-fine-tuned-gpt4', ['text', 'image']),\n *   createModel('local-llama', ['text']),\n * ] as const\n *\n * // Create extended adapter\n * const myOpenai = extendAdapter(openaiText, customModels)\n *\n * // Use with original models - full type inference preserved\n * const gpt4 = myOpenai('gpt-4o')\n *\n * // Use with custom models\n * const custom = myOpenai('my-fine-tuned-gpt4')\n *\n * // Type error: 'invalid-model' is not a valid model\n * // myOpenai('invalid-model')\n *\n * // Works with chat()\n * chat({\n *   adapter: myOpenai('my-fine-tuned-gpt4'),\n *   messages: [...]\n * })\n * ```\n */\nexport function extendAdapter<\n  TFactory extends AnyAdapterFactory,\n  const TDefs extends ReadonlyArray<ExtendedModelDef>,\n>(factory: TFactory, _customModels: TDefs): ExtendedFactory<TFactory, TDefs>\n// The implementation signature stays at the honest `AnyAdapterFactory` width;\n// the overload above performs the deliberate model-union widening.\nexport function extendAdapter(\n  factory: AnyAdapterFactory,\n  _customModels: ReadonlyArray<ExtendedModelDef>,\n): AnyAdapterFactory {\n  // At runtime, we simply pass through to the original factory.\n  // The _customModels parameter is only used for type inference.\n  // No runtime validation - users are trusted to pass valid model names.\n  return factory\n}\n"],"mappings":";AAmHA,SAAgB,YACd,MACA,QACkB;CAClB,IAAI,MAAM,QAAQ,MAAM,GACtB,OAAO;EAAE;EAAM,OAAO;EAAQ,cAAc,CAAC;CAAE;CAEjD,MAAM,OAAO;CACb,OAAO;EACL;EACA,OAAO,KAAK,SAAU,CAAC,MAAM;EAC7B,cAAc,KAAK,gBAAgB,CAAC;EACpC,UAAU,KAAK;EACf,OAAO,KAAK;CACd;AACF;AA0HA,SAAgB,cACd,SACA,eACmB;CAInB,OAAO;AACT"}

package/dist/esm/index.d.ts

@@ -7,22 +7,38 @@ export { createVideoOptions } from './activities/generateVideo/index.js';
 export { createSpeechOptions } from './activities/generateSpeech/index.js';
 export { createTranscriptionOptions } from './activities/generateTranscription/index.js';
 export type { AIAdapter, ImageAdapter, AnyImageAdapter, TextAdapter, AnyTextAdapter, AnySummarizeAdapter, SummarizeAdapter, AnyAudioAdapter, AudioAdapter, AnyTTSAdapter, TTSAdapter, AnyTranscriptionAdapter, TranscriptionAdapter, AnyVideoAdapter, VideoAdapter, } from './activities/index.js';
-export { toolDefinition, type ToolDefinition, type ToolDefinitionInstance, type ToolDefinitionConfig, type ServerTool, type ClientTool, type AnyClientTool, type InferToolName, type InferToolInput, type InferToolOutput, } from './activities/chat/tools/tool-definition.js';
+export { toolDefinition, type ToolDefinition, type ToolDefinitionInstance, type ToolDefinitionConfig, type ServerTool, type AnyServerTool, type ClientTool, type AnyClientTool, type InferToolName, type InferToolInput, type InferToolOutput, type ApprovalCapabilityOf, type ApprovalSchemaConfig, type ApprovalSchemaOf, type InputSchemaOf, type OutputSchemaOf, type NoSchema, } from './activities/chat/tools/tool-definition.js';
+export { hashSchemaInput, normalizeApprovalSchema, type NormalizedApprovalSchema, type NormalizedSchemaInput, } from './activities/chat/tools/approval-schema.js';
+export { canonicalInterruptJson, cloneAndDeepFreezeJson, digestInterruptJson, } from './interrupt-serialization.js';
+export { INTERRUPT_BINDING_METADATA_KEY, InterruptResumeValidationError, interruptItemError, readInterruptBinding, readUnopenedInterruptBinding, validateInterruptResumeBatch, withInterruptBinding, withoutInterruptBinding, type PendingInterruptResumeRecord, type ValidateInterruptResumeBatchInput, type ValidatedInterruptResumeBatch, } from './interrupt-resume.js';
 export type { MCPToolSource, ChatMCPOptions, MCPConnectionPolicy, } from './activities/chat/mcp/types.js';
 export { MCPDuplicateToolNameError } from './activities/chat/mcp/manager.js';
-export { convertSchemaToJsonSchema, isStandardSchema, parseWithStandardSchema, StandardSchemaValidationError, } from './activities/chat/tools/schema-converter.js';
-export { streamToText, toServerSentEventsStream, toServerSentEventsResponse, toHttpStream, toHttpResponse, } from './stream-to-response.js';
+export { convertSchemaToJsonSchema, isStandardSchema, parseWithStandardSchema, validateWithStandardSchema, StandardSchemaValidationError, } from './activities/chat/tools/schema-converter.js';
+export { streamToText, toServerSentEventsStream, toServerSentEventsResponse, resumeServerSentEventsResponse, toHttpStream, toHttpResponse, resumeHttpResponse, resolveResumeRunId, RUN_ACCEPTED_EVENT, } from './stream-to-response.js';
+export type { RunDriverOptions } from './stream-to-response.js';
+export { memoryStream, replayRunStream } from './stream-durability.js';
+export type { MemoryStreamInit, MemoryStreamOptions, StreamDurability, UpsertableStreamDurability, } from './stream-durability.js';
 export { ToolCallManager } from './activities/chat/tools/tool-calls.js';
 export { DISCOVERY_TOOL_NAME } from './activities/chat/tools/lazy-tool-manager.js';
 export type { ProviderTool } from './tools/provider-tool.js';
 export { brandProviderTool } from './tools/provider-tool.js';
-export { maxIterations, maxToolCalls, untilFinishReason, combineStrategies, } from './activities/chat/agent-loop-strategies.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, StructuredOutputMiddlewareConfig, ToolCallHookContext, BeforeToolCallDecision, AfterToolCallInfo, IterationInfo, ToolPhaseCompleteInfo, UsageInfo, FinishInfo, AbortInfo, ErrorInfo, SandboxFileEvent, SandboxFileHookEvent, ChatSandboxHooks, } from './activities/chat/middleware/index.js';
-export type { GenerationMiddleware, GenerationMiddlewareContext, GenerationActivity, GenerationUsageInfo, GenerationFinishInfo, GenerationAbortInfo, GenerationErrorInfo, AnyGenerationMiddleware, } from './activities/middleware/index.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 { 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';
 export { createCapability, defineChatMiddleware, createChatMiddleware, } from './activities/chat/middleware/index.js';
 export type { Capability, CapabilityHandle, CapabilityContext, CapabilityGetter, CapabilityProvider, DefinedChatMiddleware, AnyChatMiddleware, } from './activities/chat/middleware/index.js';
+export { isRunStatus, isTerminalRunStatus, defineRunStore, InMemoryRunStore, } from './activities/chat/middleware/index.js';
+export type { RunStatus, TerminalRunStatus, RunRecord, RunError, RunStore, } from './activities/chat/middleware/index.js';
+export { DetachableRunCapability, getDetachableRun, provideDetachableRun, } from './activities/chat/middleware/run-store.js';
+export { RunDetachedCapability, getRunDetached, provideRunDetached, } from './activities/chat/middleware/run-store.js';
+export { RUN_CANCEL_REASON, isCancelRequestedReason, requestRunCancel, wasCancelRequested, } from './activities/chat/cancel.js';
+export { CUSTOM_EVENT, isCustomEvent } from './custom-events.js';
+export type { WellKnownCustomEventName, FileChangedPayload, ProcessOutputPayload, PortOpenedPayload, ApprovalRequestedPayload, ApprovalResolvedPayload, ArtifactCreatedPayload, SandboxLifecyclePayload, } from './custom-events.js';
 export * from './types.js';
+export type { Scope } from './scope.js';
 export { firstSentence, renderLazyCatalogEntry, } from './activities/chat/tools/lazy-tools.js';
 export { buildBaseUsage, type BaseUsageInput } from './utilities/usage.js';
 export { resolveMediaPrompt } from './utilities/media-prompt.js';
@@ -36,6 +52,8 @@ export { convertMessagesToModelMessages, generateMessageId, uiMessageToModelMess
 export { StreamProcessor, createReplayStream, ImmediateStrategy, PunctuationStrategy, BatchStrategy, WordBoundaryStrategy, CompositeStrategy, PartialJSONParser, defaultJSONParser, parsePartialJSON, } from './activities/chat/stream/index.js';
 export type { ChunkStrategy, ChunkRecording, InternalToolCallState, ProcessorResult, ProcessorState, StreamProcessorEvents, StreamProcessorOptions, ToolCallState, ToolResultState, JSONParser, } from './activities/chat/stream/index.js';
 export { chatParamsFromRequest, chatParamsFromRequestBody, mergeAgentTools, } from './utilities/chat-params.js';
+export type { ClientToolDeclaration, MergedAgentTools, } from './utilities/chat-params.js';
+export { generationParamsFromBody, generationParamsFromRequest } from './client.js';
 export { uiMessagesToWire } from './utilities/ag-ui-wire.js';
 export type { WireMessage } from './utilities/ag-ui-wire.js';
 export { isContentPart, isContentPartArray, normalizeToolResult, } from './utilities/tool-result.js';

package/dist/esm/index.js

@@ -1,115 +1,47 @@
+import { RUN_CANCEL_REASON, isCancelRequestedReason, requestRunCancel, wasCancelRequested } from "./activities/chat/cancel.js";
+import { createCapability } from "./activities/chat/middleware/capabilities.js";
+import { DetachableRunCapability, InMemoryRunStore, RunDetachedCapability, defineRunStore, getDetachableRun, getRunDetached, isRunStatus, isTerminalRunStatus, provideDetachableRun, provideRunDetached } from "./activities/chat/middleware/run-store.js";
+import { memoryStream, replayRunStream, resolveResumeRunId } from "./stream-durability.js";
+import { EventType } from "./types.js";
+import { ConsoleLogger } from "./logger/console-logger.js";
+import { RUN_ACCEPTED_EVENT, resumeHttpResponse, resumeServerSentEventsResponse, streamToText, toHttpResponse, toHttpStream, toServerSentEventsResponse, toServerSentEventsStream } from "./stream-to-response.js";
+import { canonicalInterruptJson, cloneAndDeepFreezeJson, digestInterruptJson } from "./interrupt-serialization.js";
+import { INTERRUPT_BINDING_VERSION, canonicalizeInterruptResolutions } from "./interrupts.js";
+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 { isContentPart, isContentPartArray, normalizeToolResult } from "./utilities/tool-result.js";
+import { getProviderExecutedMetadata, isProviderExecutedToolCall } from "./utilities/provider-executed.js";
+import { firstSentence, renderLazyCatalogEntry } from "./activities/chat/tools/lazy-tools.js";
+import { DISCOVERY_TOOL_NAME } from "./activities/chat/tools/lazy-tool-manager.js";
+import { ToolCallManager } from "./activities/chat/tools/tool-calls.js";
+import { combineStrategies, maxIterations, untilFinishReason } from "./activities/chat/agent-loop-strategies.js";
+import { convertMessagesToModelMessages, generateMessageId, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeToUIMessage, uiMessageToModelMessages } from "./activities/chat/messages.js";
+import { MCPDuplicateToolNameError } from "./activities/chat/mcp/manager.js";
 import { chat, createChatOptions } from "./activities/chat/index.js";
 import { createSummarizeOptions, summarize } from "./activities/summarize/index.js";
+import { resolveMediaPrompt } from "./utilities/media-prompt.js";
 import { createImageOptions, generateImage } from "./activities/generateImage/index.js";
 import { createAudioOptions, generateAudio } from "./activities/generateAudio/index.js";
 import { createVideoOptions, generateVideo, getVideoJobStatus } from "./activities/generateVideo/index.js";
 import { createSpeechOptions, generateSpeech } from "./activities/generateSpeech/index.js";
 import { createTranscriptionOptions, generateTranscription } from "./activities/generateTranscription/index.js";
 import { toolDefinition } from "./activities/chat/tools/tool-definition.js";
-import { MCPDuplicateToolNameError } from "./activities/chat/mcp/manager.js";
-import { StandardSchemaValidationError, convertSchemaToJsonSchema, isStandardSchema, parseWithStandardSchema } from "./activities/chat/tools/schema-converter.js";
-import { streamToText, toHttpResponse, toHttpStream, toServerSentEventsResponse, toServerSentEventsStream } from "./stream-to-response.js";
-import { ToolCallManager } from "./activities/chat/tools/tool-calls.js";
-import { DISCOVERY_TOOL_NAME } from "./activities/chat/tools/lazy-tool-manager.js";
 import { brandProviderTool } from "./tools/provider-tool.js";
-import { combineStrategies, maxIterations, maxToolCalls, untilFinishReason } from "./activities/chat/agent-loop-strategies.js";
 import { createFrozenRegistry, createToolRegistry } from "./tool-registry.js";
-import { firstSentence, renderLazyCatalogEntry } from "./activities/chat/tools/lazy-tools.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";
 import { buildBaseUsage } from "./utilities/usage.js";
-import { resolveMediaPrompt } from "./utilities/media-prompt.js";
 import { normalizeSystemPrompts } from "./system-prompts.js";
 import { detectImageMimeType } from "./utils.js";
+import { createRealtimeEventEmitter } from "./realtime/event-emitter.js";
 import { realtimeToken } from "./realtime/index.js";
-import { convertMessagesToModelMessages, generateMessageId, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeToUIMessage, uiMessageToModelMessages } from "./activities/chat/messages.js";
+import { PartialJSONParser, defaultJSONParser, parsePartialJSON } from "./activities/chat/stream/json-parser.js";
+import { BatchStrategy, CompositeStrategy, ImmediateStrategy, PunctuationStrategy, WordBoundaryStrategy } from "./activities/chat/stream/strategies.js";
+import { StreamProcessor, createReplayStream } from "./activities/chat/stream/processor.js";
 import { chatParamsFromRequest, chatParamsFromRequestBody, mergeAgentTools } from "./utilities/chat-params.js";
 import { uiMessagesToWire } from "./utilities/ag-ui-wire.js";
-import { isContentPart, isContentPartArray, normalizeToolResult } from "./utilities/tool-result.js";
-import { getProviderExecutedMetadata, isProviderExecutedToolCall } from "./utilities/provider-executed.js";
+import { generationParamsFromBody, generationParamsFromRequest } from "./client.js";
 import { createModel, extendAdapter } from "./extend-adapter.js";
-import { ConsoleLogger } from "./logger/console-logger.js";
-import { BatchStrategy, CompositeStrategy, ImmediateStrategy, PunctuationStrategy, WordBoundaryStrategy } from "./activities/chat/stream/strategies.js";
-import { EventType } from "@ag-ui/core";
-import { PartialJSONParser, defaultJSONParser, parsePartialJSON } from "./activities/chat/stream/json-parser.js";
-import { StreamProcessor, createReplayStream } from "./activities/chat/stream/processor.js";
-import { createCapability } from "./activities/chat/middleware/capabilities.js";
-import { createChatMiddleware } from "./activities/chat/middleware/builder.js";
-import { createRealtimeEventEmitter } from "./realtime/event-emitter.js";
-import { defineChatMiddleware } from "./activities/chat/middleware/define.js";
-export {
-  BatchStrategy,
-  CompositeStrategy,
-  ConsoleLogger,
-  DISCOVERY_TOOL_NAME,
-  EventType,
-  ImmediateStrategy,
-  MCPDuplicateToolNameError,
-  PartialJSONParser,
-  PunctuationStrategy,
-  StandardSchemaValidationError,
-  StreamProcessor,
-  ToolCallManager,
-  WordBoundaryStrategy,
-  brandProviderTool,
-  buildBaseUsage,
-  chat,
-  chatParamsFromRequest,
-  chatParamsFromRequestBody,
-  combineStrategies,
-  convertMessagesToModelMessages,
-  convertSchemaToJsonSchema,
-  createAudioOptions,
-  createCapability,
-  createChatMiddleware,
-  createChatOptions,
-  createFrozenRegistry,
-  createImageOptions,
-  createModel,
-  createRealtimeEventEmitter,
-  createReplayStream,
-  createSpeechOptions,
-  createSummarizeOptions,
-  createToolRegistry,
-  createTranscriptionOptions,
-  createVideoOptions,
-  defaultJSONParser,
-  defineChatMiddleware,
-  detectImageMimeType,
-  extendAdapter,
-  firstSentence,
-  generateAudio,
-  generateImage,
-  generateMessageId,
-  generateSpeech,
-  generateTranscription,
-  generateVideo,
-  getProviderExecutedMetadata,
-  getVideoJobStatus,
-  isContentPart,
-  isContentPartArray,
-  isProviderExecutedToolCall,
-  isStandardSchema,
-  maxIterations,
-  maxToolCalls,
-  mergeAgentTools,
-  modelMessageToUIMessage,
-  modelMessagesToUIMessages,
-  normalizeSystemPrompts,
-  normalizeToUIMessage,
-  normalizeToolResult,
-  parsePartialJSON,
-  parseWithStandardSchema,
-  realtimeToken,
-  renderLazyCatalogEntry,
-  resolveMediaPrompt,
-  streamToText,
-  summarize,
-  toHttpResponse,
-  toHttpStream,
-  toServerSentEventsResponse,
-  toServerSentEventsStream,
-  toolDefinition,
-  uiMessageToModelMessages,
-  uiMessagesToWire,
-  untilFinishReason
-};
-//# sourceMappingURL=index.js.map
+export { BatchStrategy, CUSTOM_EVENT, CompositeStrategy, ConsoleLogger, DISCOVERY_TOOL_NAME, DetachableRunCapability, EventType, INTERRUPT_BINDING_METADATA_KEY, INTERRUPT_BINDING_VERSION, ImmediateStrategy, InMemoryRunStore, InterruptResumeValidationError, MCPDuplicateToolNameError, PartialJSONParser, PunctuationStrategy, RUN_ACCEPTED_EVENT, RUN_CANCEL_REASON, RunDetachedCapability, StandardSchemaValidationError, StreamProcessor, ToolCallManager, WordBoundaryStrategy, brandProviderTool, buildBaseUsage, canonicalInterruptJson, canonicalizeInterruptResolutions, chat, chatParamsFromRequest, chatParamsFromRequestBody, cloneAndDeepFreezeJson, combineStrategies, convertMessagesToModelMessages, convertSchemaToJsonSchema, createAudioOptions, createCapability, createChatMiddleware, createChatOptions, createFrozenRegistry, createImageOptions, createModel, createRealtimeEventEmitter, createReplayStream, createSpeechOptions, createSummarizeOptions, createToolRegistry, createTranscriptionOptions, createVideoOptions, defaultJSONParser, defineChatMiddleware, defineRunStore, detectImageMimeType, digestInterruptJson, 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, resolveMediaPrompt, resolveResumeRunId, resumeHttpResponse, resumeServerSentEventsResponse, streamToText, summarize, toHttpResponse, toHttpStream, toServerSentEventsResponse, toServerSentEventsStream, toolDefinition, uiMessageToModelMessages, uiMessagesToWire, untilFinishReason, validateInterruptResumeBatch, validateWithStandardSchema, wasCancelRequested, withInterruptBinding, withoutInterruptBinding };

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

@@ -0,0 +1,71 @@
+import { InterruptBinding, InterruptSubmissionError, ItemInterruptErrorCode, UnopenedInterruptBinding } from './interrupts.js';
+import { ChatMiddlewareConfig, ChatResumeToolState } from './activities/chat/middleware/types.js';
+import { Interrupt, RunAgentResumeItem } from './types.js';
+/**
+ * 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.
+ */
+export declare const INTERRUPT_BINDING_METADATA_KEY = "tanstack:interruptBinding";
+/** The persistence-neutral shape required to validate an interrupt resume. */
+export interface PendingInterruptResumeRecord {
+    interruptId: string;
+    payload: unknown;
+    binding: InterruptBinding;
+}
+export interface ValidateInterruptResumeBatchInput {
+    threadId: string;
+    interruptedRunId: string;
+    generation: number;
+    pending: ReadonlyArray<PendingInterruptResumeRecord>;
+    resume?: ReadonlyArray<RunAgentResumeItem>;
+    tools: ChatMiddlewareConfig['tools'];
+    now?: number;
+}
+export interface ValidatedInterruptResumeBatch {
+    errors: ReadonlyArray<InterruptSubmissionError>;
+    resolutions?: ReadonlyArray<RunAgentResumeItem>;
+    canonicalResolutions?: string;
+    fingerprint?: string;
+    resumeToolState?: ChatResumeToolState;
+}
+export declare class InterruptResumeValidationError extends Error {
+    readonly errors: ReadonlyArray<InterruptSubmissionError>;
+    readonly name = "InterruptResumeValidationError";
+    constructor(errors: ReadonlyArray<InterruptSubmissionError>);
+}
+export declare function interruptItemError(input: Pick<ValidateInterruptResumeBatchInput, 'threadId' | 'interruptedRunId' | 'generation'>, interruptId: string, code: ItemInterruptErrorCode, message: string, options?: {
+    path?: ReadonlyArray<string | number>;
+    source?: 'client' | 'server';
+    retryable?: boolean;
+}): InterruptSubmissionError;
+/**
+ * Validate and translate a complete interrupt batch before any tool executes.
+ * Used by ephemeral chat resume; a durable layer may share the same validator.
+ */
+export declare function validateInterruptResumeBatch(input: ValidateInterruptResumeBatchInput): Promise<ValidatedInterruptResumeBatch>;
+export declare function readUnopenedInterruptBinding(descriptor: Interrupt): UnopenedInterruptBinding | undefined;
+/**
+ * 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.
+ */
+export declare function withInterruptBinding(descriptor: Interrupt, binding: UnopenedInterruptBinding | InterruptBinding): Interrupt;
+/**
+ * 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.
+ */
+export declare function readInterruptBinding(descriptor: Interrupt): InterruptBinding | undefined;
+export declare function withoutInterruptBinding(descriptor: Interrupt): Interrupt;