@tanstack/ai 0.42.0 → 0.43.0

package/dist/esm/activities/summarize/index.js

@@ -1,113 +1,279 @@
-import { aiEventClient } from "@tanstack/ai-event-client";
-import { streamGenerationResult } from "../stream-generation-result.js";
 import { resolveDebugOption } from "../../logger/resolve.js";
-const kind = "summarize";
+import { streamGenerationResult } from "../stream-generation-result.js";
+import { applyGenerationResultTransforms, createGenerationContext, runGenerationAbort, runGenerationError, runGenerationFinish, runGenerationStart, runGenerationUsage } from "../middleware/run.js";
+import "./adapter.js";
+import "./chat-stream-summarize.js";
+import { aiEventClient } from "@tanstack/ai-event-client";
+//#region src/activities/summarize/index.ts
+/**
+* Summarize Activity
+*
+* Generates summaries from text input.
+* This is a self-contained module with implementation, types, and JSDoc.
+*/
+/** The adapter kind this activity handles */
+var kind = "summarize";
 function createId(prefix) {
-  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+	return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
 }
+/**
+* Summarize activity - generates summaries from text.
+*
+* Supports both streaming and non-streaming modes.
+*
+* @example Basic summarization
+* ```ts
+* import { summarize } from '@tanstack/ai'
+* import { openaiSummarize } from '@tanstack/ai-openai'
+*
+* const result = await summarize({
+*   adapter: openaiSummarize('gpt-4o-mini'),
+*   text: 'Long article text here...'
+* })
+*
+* console.log(result.summary)
+* ```
+*
+* @example Summarization with style
+* ```ts
+* const result = await summarize({
+*   adapter: openaiSummarize('gpt-4o-mini'),
+*   text: 'Long article text here...',
+*   style: 'bullet-points',
+*   maxLength: 100
+* })
+* ```
+*
+* @example Focused summarization
+* ```ts
+* const result = await summarize({
+*   adapter: openaiSummarize('gpt-4o-mini'),
+*   text: 'Long technical document...',
+*   focus: ['key findings', 'methodology']
+* })
+* ```
+*
+* @example Streaming summarization
+* ```ts
+* for await (const chunk of summarize({
+*   adapter: openaiSummarize('gpt-4o-mini'),
+*   text: 'Long article text here...',
+*   stream: true
+* })) {
+*   if (chunk.type === 'content') {
+*     process.stdout.write(chunk.delta)
+*   }
+* }
+* ```
+*/
 function summarize(options) {
-  const { stream } = options;
-  if (stream) {
-    return runStreamingSummarize(
-      options
-    );
-  }
-  return runSummarize(
-    options
-  );
+	const { stream } = options;
+	if (stream) return runStreamingSummarize(options);
+	return runSummarize(options);
 }
+/**
+* Run non-streaming summarization
+*/
 async function runSummarize(options) {
-  const { adapter, text, maxLength, style, focus, modelOptions } = options;
-  const model = adapter.model;
-  const requestId = createId("summarize");
-  const inputLength = text.length;
-  const startTime = Date.now();
-  const logger = resolveDebugOption(options.debug);
-  aiEventClient.emit("summarize:request:started", {
-    requestId,
-    provider: adapter.name,
-    model,
-    inputLength,
-    timestamp: startTime
-  });
-  logger.request(`activity=summarize provider=${adapter.name}`, {
-    provider: adapter.name,
-    model,
-    inputLength
-  });
-  const summarizeOptions = {
-    model,
-    text,
-    maxLength,
-    style,
-    focus,
-    modelOptions,
-    logger
-  };
-  try {
-    const result = await adapter.summarize(summarizeOptions);
-    const duration = Date.now() - startTime;
-    const outputLength = result.summary.length;
-    aiEventClient.emit("summarize:request:completed", {
-      requestId,
-      provider: adapter.name,
-      model,
-      inputLength,
-      outputLength,
-      duration,
-      timestamp: Date.now()
-    });
-    logger.output(`activity=summarize length=${outputLength}`, {
-      hasSummary: !!result.summary,
-      outputLength
-    });
-    return result;
-  } catch (error) {
-    logger.errors("summarize activity failed", {
-      error,
-      source: "summarize"
-    });
-    throw error;
-  }
+	const { adapter, text, maxLength, style, focus, modelOptions, middleware } = options;
+	const model = adapter.model;
+	const requestId = createId("summarize");
+	const inputLength = text.length;
+	const startTime = Date.now();
+	const logger = resolveDebugOption(options.debug);
+	const mwCtx = createGenerationContext({
+		requestId,
+		activity: "summarize",
+		provider: adapter.name,
+		model,
+		modelOptions,
+		threadId: options.threadId,
+		runId: options.runId,
+		createId
+	});
+	await runGenerationStart(middleware, mwCtx);
+	aiEventClient.emit("summarize:request:started", {
+		requestId,
+		provider: adapter.name,
+		model,
+		inputLength,
+		timestamp: startTime
+	});
+	logger.request(`activity=summarize provider=${adapter.name}`, {
+		provider: adapter.name,
+		model,
+		inputLength
+	});
+	const summarizeOptions = {
+		model,
+		text,
+		maxLength,
+		style,
+		focus,
+		modelOptions,
+		logger
+	};
+	try {
+		const result = await applyGenerationResultTransforms(mwCtx, await adapter.summarize(summarizeOptions));
+		const duration = Date.now() - startTime;
+		const outputLength = result.summary.length;
+		aiEventClient.emit("summarize:request:completed", {
+			requestId,
+			provider: adapter.name,
+			model,
+			inputLength,
+			outputLength,
+			duration,
+			timestamp: Date.now()
+		});
+		logger.output(`activity=summarize length=${outputLength}`, {
+			hasSummary: !!result.summary,
+			outputLength
+		});
+		if (result.usage) await runGenerationUsage(middleware, mwCtx, result.usage);
+		await runGenerationFinish(middleware, mwCtx, {
+			duration,
+			usage: result.usage
+		});
+		return result;
+	} catch (error) {
+		await runGenerationError(middleware, mwCtx, {
+			error,
+			duration: Date.now() - startTime
+		});
+		logger.errors("summarize activity failed", {
+			error,
+			source: "summarize"
+		});
+		throw error;
+	}
+}
+/** Read a `usage` off a transformed result without asserting its shape. */
+function usageOf(result) {
+	if (typeof result !== "object" || result === null) return void 0;
+	const usage = result.usage;
+	return typeof usage === "object" && usage !== null ? usage : void 0;
 }
+/**
+* Run streaming summarization
+* Uses the adapter's native streaming if available, otherwise falls back
+* to non-streaming and yields the result as a single chunk.
+*/
 async function* runStreamingSummarize(options) {
-  const { adapter, text, maxLength, style, focus, modelOptions } = options;
-  const model = adapter.model;
-  const logger = resolveDebugOption(options.debug);
-  logger.request(`activity=summarize provider=${adapter.name}`, {
-    provider: adapter.name,
-    model,
-    stream: true
-  });
-  const summarizeOptions = {
-    model,
-    text,
-    maxLength,
-    style,
-    focus,
-    modelOptions,
-    logger
-  };
-  try {
-    if (adapter.summarizeStream) {
-      yield* adapter.summarizeStream(summarizeOptions);
-      return;
-    }
-    yield* streamGenerationResult(() => adapter.summarize(summarizeOptions));
-  } catch (error) {
-    logger.errors("summarize activity failed", {
-      error,
-      source: "summarize"
-    });
-    throw error;
-  }
+	const { adapter, text, maxLength, style, focus, modelOptions, runId, threadId } = options;
+	const model = adapter.model;
+	const logger = resolveDebugOption(options.debug);
+	logger.request(`activity=summarize provider=${adapter.name}`, {
+		provider: adapter.name,
+		model,
+		stream: true
+	});
+	const summarizeOptions = {
+		model,
+		text,
+		maxLength,
+		style,
+		focus,
+		modelOptions,
+		logger,
+		...runId !== void 0 ? { runId } : {},
+		...threadId !== void 0 ? { threadId } : {}
+	};
+	if (adapter.summarizeStream) {
+		yield* runNativeSummarizeStream(options, adapter.summarizeStream(summarizeOptions), logger);
+		return;
+	}
+	try {
+		yield* streamGenerationResult((resolved) => runSummarize({
+			...options,
+			stream: false,
+			runId: resolved.runId
+		}), {
+			...runId !== void 0 ? { runId } : {},
+			...threadId !== void 0 ? { threadId } : {}
+		});
+	} catch (error) {
+		logger.errors("summarize activity failed", {
+			error,
+			source: "summarize"
+		});
+		throw error;
+	}
+}
+/**
+* Drive an adapter's native `summarizeStream`, wiring the generation middleware
+* around it.
+*
+* The adapter emits a terminal `generation:result` CUSTOM chunk carrying the
+* assembled {@link SummarizationResult}; that is the one point where a result
+* exists, so the transforms run there and the REWRITTEN result is what gets
+* yielded — the client and the persisted run record then hold the same object.
+* An adapter whose stream never emits one still finishes the run, just with no
+* result recorded.
+*/
+async function* runNativeSummarizeStream(options, stream, logger) {
+	const { adapter, middleware, modelOptions } = options;
+	const mwCtx = createGenerationContext({
+		requestId: createId("summarize"),
+		activity: "summarize",
+		provider: adapter.name,
+		model: adapter.model,
+		modelOptions,
+		threadId: options.threadId,
+		runId: options.runId,
+		createId
+	});
+	await runGenerationStart(middleware, mwCtx);
+	const startTime = Date.now();
+	let settled = false;
+	try {
+		for await (const chunk of stream) {
+			if (chunk.type === "CUSTOM" && chunk.name === "generation:result") {
+				const result = await applyGenerationResultTransforms(mwCtx, chunk.value);
+				const usage = usageOf(result);
+				if (usage) await runGenerationUsage(middleware, mwCtx, usage);
+				await runGenerationFinish(middleware, mwCtx, {
+					duration: Date.now() - startTime,
+					usage
+				});
+				settled = true;
+				yield {
+					...chunk,
+					value: result
+				};
+				continue;
+			}
+			yield chunk;
+		}
+		if (!settled) {
+			await runGenerationFinish(middleware, mwCtx, { duration: Date.now() - startTime });
+			settled = true;
+		}
+	} catch (error) {
+		settled = true;
+		await runGenerationError(middleware, mwCtx, {
+			error,
+			duration: Date.now() - startTime
+		});
+		logger.errors("summarize activity failed", {
+			error,
+			source: "summarize"
+		});
+		throw error;
+	} finally {
+		if (!settled) await runGenerationAbort(middleware, mwCtx, {
+			reason: "Summarize stream abandoned before completion",
+			duration: Date.now() - startTime
+		});
+	}
 }
+/**
+* Create typed options for the summarize() function without executing.
+*/
 function createSummarizeOptions(options) {
-  return options;
+	return options;
 }
-export {
-  createSummarizeOptions,
-  kind,
-  summarize
-};
-//# sourceMappingURL=index.js.map
+//#endregion
+export { createSummarizeOptions, kind, summarize };
+
+//# sourceMappingURL=index.js.map

package/dist/esm/activities/summarize/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/activities/summarize/index.ts"],"sourcesContent":["/**\n * Summarize Activity\n *\n * Generates summaries from text input.\n * This is a self-contained module with implementation, types, and JSDoc.\n */\n\nimport { aiEventClient } from '@tanstack/ai-event-client'\nimport { streamGenerationResult } from '../stream-generation-result.js'\nimport { resolveDebugOption } from '../../logger/resolve'\nimport type { InternalLogger } from '../../logger/internal-logger'\nimport type { DebugOption } from '../../logger/types'\nimport type { SummarizeAdapter } from './adapter'\nimport type { StreamChunk, SummarizationResult } from '../../types'\n\n// ===========================\n// Activity Kind\n// ===========================\n\n/** The adapter kind this activity handles */\nexport const kind = 'summarize' as const\n\n// ===========================\n// Type Extraction Helpers\n// ===========================\n\n/** Extract provider options from a SummarizeAdapter via ~types */\nexport type SummarizeProviderOptions<TAdapter> =\n  TAdapter extends SummarizeAdapter<any, any>\n    ? TAdapter['~types']['providerOptions']\n    : object\n\n// ===========================\n// Activity Options Type\n// ===========================\n\n/**\n * Options for the summarize activity.\n * The model is extracted from the adapter's model property.\n *\n * @template TAdapter - The summarize adapter type\n * @template TStream - Whether to stream the output\n */\nexport interface SummarizeActivityOptions<\n  TAdapter extends SummarizeAdapter<string, object>,\n  TStream extends boolean = false,\n> {\n  /** The summarize adapter to use (must be created with a model) */\n  adapter: TAdapter & { kind: typeof kind }\n  /** The text to summarize */\n  text: string\n  /** Maximum length of the summary (in words or characters, provider-dependent) */\n  maxLength?: number\n  /** Style of summary to generate */\n  style?: 'bullet-points' | 'paragraph' | 'concise'\n  /** Topics or aspects to focus on in the summary */\n  focus?: Array<string>\n  /** Provider-specific options */\n  modelOptions?: SummarizeProviderOptions<TAdapter>\n  /**\n   * Whether to stream the summarization result.\n   * When true, returns an AsyncIterable<StreamChunk> for streaming output.\n   * When false or not provided, returns a Promise<SummarizationResult>.\n   *\n   * @default false\n   */\n  stream?: TStream\n  /**\n   * Enable debug logging. Pass `true` to enable all categories, `false` to\n   * silence everything including errors, or a `DebugConfig` object for granular\n   * control and/or a custom `Logger`.\n   */\n  debug?: DebugOption\n}\n\n// ===========================\n// Activity Result Type\n// ===========================\n\n/**\n * Result type for the summarize activity.\n * - If stream is true: AsyncIterable<StreamChunk>\n * - Otherwise: Promise<SummarizationResult>\n */\nexport type SummarizeActivityResult<TStream extends boolean> =\n  TStream extends true\n    ? AsyncIterable<StreamChunk>\n    : Promise<SummarizationResult>\n\n// ===========================\n// Helper Functions\n// ===========================\n\nfunction createId(prefix: string): string {\n  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`\n}\n\n// ===========================\n// Activity Implementation\n// ===========================\n\n/**\n * Summarize activity - generates summaries from text.\n *\n * Supports both streaming and non-streaming modes.\n *\n * @example Basic summarization\n * ```ts\n * import { summarize } from '@tanstack/ai'\n * import { openaiSummarize } from '@tanstack/ai-openai'\n *\n * const result = await summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long article text here...'\n * })\n *\n * console.log(result.summary)\n * ```\n *\n * @example Summarization with style\n * ```ts\n * const result = await summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long article text here...',\n *   style: 'bullet-points',\n *   maxLength: 100\n * })\n * ```\n *\n * @example Focused summarization\n * ```ts\n * const result = await summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long technical document...',\n *   focus: ['key findings', 'methodology']\n * })\n * ```\n *\n * @example Streaming summarization\n * ```ts\n * for await (const chunk of summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long article text here...',\n *   stream: true\n * })) {\n *   if (chunk.type === 'content') {\n *     process.stdout.write(chunk.delta)\n *   }\n * }\n * ```\n */\nexport function summarize<\n  TAdapter extends SummarizeAdapter<string, object>,\n  TStream extends boolean = false,\n>(\n  options: SummarizeActivityOptions<TAdapter, TStream>,\n): SummarizeActivityResult<TStream> {\n  const { stream } = options\n\n  if (stream) {\n    return runStreamingSummarize(\n      options as SummarizeActivityOptions<\n        SummarizeAdapter<string, object>,\n        true\n      >,\n    ) as SummarizeActivityResult<TStream>\n  }\n\n  return runSummarize(\n    options as SummarizeActivityOptions<\n      SummarizeAdapter<string, object>,\n      false\n    >,\n  ) as SummarizeActivityResult<TStream>\n}\n\n/**\n * Run non-streaming summarization\n */\nasync function runSummarize(\n  options: SummarizeActivityOptions<SummarizeAdapter<string, object>, false>,\n): Promise<SummarizationResult> {\n  const { adapter, text, maxLength, style, focus, modelOptions } = options\n  const model = adapter.model\n  const requestId = createId('summarize')\n  const inputLength = text.length\n  const startTime = Date.now()\n  const logger: InternalLogger = resolveDebugOption(options.debug)\n\n  aiEventClient.emit('summarize:request:started', {\n    requestId,\n    provider: adapter.name,\n    model,\n    inputLength,\n    timestamp: startTime,\n  })\n\n  logger.request(`activity=summarize provider=${adapter.name}`, {\n    provider: adapter.name,\n    model,\n    inputLength,\n  })\n\n  const summarizeOptions = {\n    model,\n    text,\n    maxLength,\n    style,\n    focus,\n    modelOptions,\n    logger,\n  }\n\n  try {\n    const result = await adapter.summarize(summarizeOptions)\n\n    const duration = Date.now() - startTime\n    const outputLength = result.summary.length\n\n    aiEventClient.emit('summarize:request:completed', {\n      requestId,\n      provider: adapter.name,\n      model,\n      inputLength,\n      outputLength,\n      duration,\n      timestamp: Date.now(),\n    })\n\n    logger.output(`activity=summarize length=${outputLength}`, {\n      hasSummary: !!result.summary,\n      outputLength,\n    })\n\n    return result\n  } catch (error) {\n    logger.errors('summarize activity failed', {\n      error,\n      source: 'summarize',\n    })\n    throw error\n  }\n}\n\n/**\n * Run streaming summarization\n * Uses the adapter's native streaming if available, otherwise falls back\n * to non-streaming and yields the result as a single chunk.\n */\nasync function* runStreamingSummarize(\n  options: SummarizeActivityOptions<SummarizeAdapter<string, object>, true>,\n): AsyncIterable<StreamChunk> {\n  const { adapter, text, maxLength, style, focus, modelOptions } = options\n  const model = adapter.model\n  const logger: InternalLogger = resolveDebugOption(options.debug)\n\n  logger.request(`activity=summarize provider=${adapter.name}`, {\n    provider: adapter.name,\n    model,\n    stream: true,\n  })\n\n  const summarizeOptions = {\n    model,\n    text,\n    maxLength,\n    style,\n    focus,\n    modelOptions,\n    logger,\n  }\n\n  try {\n    // Use real streaming if the adapter supports it\n    if (adapter.summarizeStream) {\n      yield* adapter.summarizeStream(summarizeOptions)\n      return\n    }\n\n    // Fall back to non-streaming — wrap result with streamGenerationResult\n    yield* streamGenerationResult(() => adapter.summarize(summarizeOptions))\n  } catch (error) {\n    logger.errors('summarize activity failed', {\n      error,\n      source: 'summarize',\n    })\n    throw error\n  }\n}\n\n// ===========================\n// Options Factory\n// ===========================\n\n/**\n * Create typed options for the summarize() function without executing.\n */\nexport function createSummarizeOptions<\n  TAdapter extends SummarizeAdapter<string, object>,\n  TStream extends boolean = false,\n>(\n  options: SummarizeActivityOptions<TAdapter, TStream>,\n): SummarizeActivityOptions<TAdapter, TStream> {\n  return options\n}\n\n// Re-export adapter types\nexport type {\n  SummarizeAdapter,\n  SummarizeAdapterConfig,\n  AnySummarizeAdapter,\n} from './adapter'\nexport { BaseSummarizeAdapter } from './adapter'\nexport {\n  ChatStreamSummarizeAdapter,\n  type ChatStreamCapable,\n  type InferTextProviderOptions,\n} from './chat-stream-summarize'\n"],"names":[],"mappings":";;;AAoBO,MAAM,OAAO;AAyEpB,SAAS,SAAS,QAAwB;AACxC,SAAO,GAAG,MAAM,IAAI,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;AAC1E;AAwDO,SAAS,UAId,SACkC;AAClC,QAAM,EAAE,WAAW;AAEnB,MAAI,QAAQ;AACV,WAAO;AAAA,MACL;AAAA,IAAA;AAAA,EAKJ;AAEA,SAAO;AAAA,IACL;AAAA,EAAA;AAKJ;AAKA,eAAe,aACb,SAC8B;AAC9B,QAAM,EAAE,SAAS,MAAM,WAAW,OAAO,OAAO,iBAAiB;AACjE,QAAM,QAAQ,QAAQ;AACtB,QAAM,YAAY,SAAS,WAAW;AACtC,QAAM,cAAc,KAAK;AACzB,QAAM,YAAY,KAAK,IAAA;AACvB,QAAM,SAAyB,mBAAmB,QAAQ,KAAK;AAE/D,gBAAc,KAAK,6BAA6B;AAAA,IAC9C;AAAA,IACA,UAAU,QAAQ;AAAA,IAClB;AAAA,IACA;AAAA,IACA,WAAW;AAAA,EAAA,CACZ;AAED,SAAO,QAAQ,+BAA+B,QAAQ,IAAI,IAAI;AAAA,IAC5D,UAAU,QAAQ;AAAA,IAClB;AAAA,IACA;AAAA,EAAA,CACD;AAED,QAAM,mBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAGF,MAAI;AACF,UAAM,SAAS,MAAM,QAAQ,UAAU,gBAAgB;AAEvD,UAAM,WAAW,KAAK,IAAA,IAAQ;AAC9B,UAAM,eAAe,OAAO,QAAQ;AAEpC,kBAAc,KAAK,+BAA+B;AAAA,MAChD;AAAA,MACA,UAAU,QAAQ;AAAA,MAClB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW,KAAK,IAAA;AAAA,IAAI,CACrB;AAED,WAAO,OAAO,6BAA6B,YAAY,IAAI;AAAA,MACzD,YAAY,CAAC,CAAC,OAAO;AAAA,MACrB;AAAA,IAAA,CACD;AAED,WAAO;AAAA,EACT,SAAS,OAAO;AACd,WAAO,OAAO,6BAA6B;AAAA,MACzC;AAAA,MACA,QAAQ;AAAA,IAAA,CACT;AACD,UAAM;AAAA,EACR;AACF;AAOA,gBAAgB,sBACd,SAC4B;AAC5B,QAAM,EAAE,SAAS,MAAM,WAAW,OAAO,OAAO,iBAAiB;AACjE,QAAM,QAAQ,QAAQ;AACtB,QAAM,SAAyB,mBAAmB,QAAQ,KAAK;AAE/D,SAAO,QAAQ,+BAA+B,QAAQ,IAAI,IAAI;AAAA,IAC5D,UAAU,QAAQ;AAAA,IAClB;AAAA,IACA,QAAQ;AAAA,EAAA,CACT;AAED,QAAM,mBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAGF,MAAI;AAEF,QAAI,QAAQ,iBAAiB;AAC3B,aAAO,QAAQ,gBAAgB,gBAAgB;AAC/C;AAAA,IACF;AAGA,WAAO,uBAAuB,MAAM,QAAQ,UAAU,gBAAgB,CAAC;AAAA,EACzE,SAAS,OAAO;AACd,WAAO,OAAO,6BAA6B;AAAA,MACzC;AAAA,MACA,QAAQ;AAAA,IAAA,CACT;AACD,UAAM;AAAA,EACR;AACF;AASO,SAAS,uBAId,SAC6C;AAC7C,SAAO;AACT;"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/activities/summarize/index.ts"],"sourcesContent":["/**\n * Summarize Activity\n *\n * Generates summaries from text input.\n * This is a self-contained module with implementation, types, and JSDoc.\n */\n\nimport { aiEventClient } from '@tanstack/ai-event-client'\nimport { streamGenerationResult } from '../stream-generation-result.js'\nimport { resolveDebugOption } from '../../logger/resolve'\nimport {\n  applyGenerationResultTransforms,\n  createGenerationContext,\n  runGenerationAbort,\n  runGenerationError,\n  runGenerationFinish,\n  runGenerationStart,\n  runGenerationUsage,\n} from '../middleware/run'\nimport type { InternalLogger } from '../../logger/internal-logger'\nimport type { DebugOption } from '../../logger/types'\nimport type { GenerationMiddleware } from '../middleware/types'\nimport type { SummarizeAdapter } from './adapter'\nimport type { StreamChunk, SummarizationResult } from '../../types'\n\n// ===========================\n// Activity Kind\n// ===========================\n\n/** The adapter kind this activity handles */\nexport const kind = 'summarize' as const\n\n// ===========================\n// Type Extraction Helpers\n// ===========================\n\n/** Extract provider options from a SummarizeAdapter via ~types */\nexport type SummarizeProviderOptions<TAdapter> =\n  TAdapter extends SummarizeAdapter<any, any>\n    ? TAdapter['~types']['providerOptions']\n    : object\n\n// ===========================\n// Activity Options Type\n// ===========================\n\n/**\n * Options for the summarize activity.\n * The model is extracted from the adapter's model property.\n *\n * @template TAdapter - The summarize adapter type\n * @template TStream - Whether to stream the output\n */\nexport interface SummarizeActivityOptions<\n  TAdapter extends SummarizeAdapter<string, object>,\n  TStream extends boolean = false,\n> {\n  /** The summarize adapter to use (must be created with a model) */\n  adapter: TAdapter & { kind: typeof kind }\n  /** The text to summarize */\n  text: string\n  /** Maximum length of the summary (in words or characters, provider-dependent) */\n  maxLength?: number\n  /** Style of summary to generate */\n  style?: 'bullet-points' | 'paragraph' | 'concise'\n  /** Topics or aspects to focus on in the summary */\n  focus?: Array<string>\n  /** Provider-specific options */\n  modelOptions?: SummarizeProviderOptions<TAdapter>\n  /**\n   * Optional run identity. When set on a streaming summarize, it is stamped\n   * onto the emitted `RUN_STARTED` so a delivery-durable route keys the run's\n   * log by the same id the client rejoins with — making a mid-run reload\n   * resumable. Filed under `threadId` when persistence is wired.\n   */\n  runId?: string\n  /**\n   * Stable conversation/thread id for correlating this run when persisted — the\n   * slot a reloading client hydrates the last summary by. Pass it whenever\n   * persistence is on; `withGenerationPersistence` refuses a run without one.\n   */\n  threadId?: string\n  /**\n   * Observe-only middleware notified on start, usage, success, and error. Pass\n   * `otelMiddleware()` for OpenTelemetry, `withGenerationPersistence()` to\n   * record the run (summaries are text, so the run record holds the result and\n   * there are no artifacts to store), or implement the `GenerationMiddleware`\n   * contract for a custom backend.\n   *\n   * Streaming and non-streaming behave the same way: one `onStart`, then a\n   * terminal `onFinish` / `onError`, with the result transforms applied to the\n   * `SummarizationResult` in between. A streaming consumer that disconnects\n   * mid-summary fires `onAbort`.\n   */\n  middleware?: Array<GenerationMiddleware>\n  /**\n   * Whether to stream the summarization result.\n   * When true, returns an AsyncIterable<StreamChunk> for streaming output.\n   * When false or not provided, returns a Promise<SummarizationResult>.\n   *\n   * @default false\n   */\n  stream?: TStream\n  /**\n   * Enable debug logging. Pass `true` to enable all categories, `false` to\n   * silence everything including errors, or a `DebugConfig` object for granular\n   * control and/or a custom `Logger`.\n   */\n  debug?: DebugOption\n}\n\n// ===========================\n// Activity Result Type\n// ===========================\n\n/**\n * Result type for the summarize activity.\n * - If stream is true: AsyncIterable<StreamChunk>\n * - Otherwise: Promise<SummarizationResult>\n */\nexport type SummarizeActivityResult<TStream extends boolean> =\n  TStream extends true\n    ? AsyncIterable<StreamChunk>\n    : Promise<SummarizationResult>\n\n// ===========================\n// Helper Functions\n// ===========================\n\nfunction createId(prefix: string): string {\n  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`\n}\n\n// ===========================\n// Activity Implementation\n// ===========================\n\n/**\n * Summarize activity - generates summaries from text.\n *\n * Supports both streaming and non-streaming modes.\n *\n * @example Basic summarization\n * ```ts\n * import { summarize } from '@tanstack/ai'\n * import { openaiSummarize } from '@tanstack/ai-openai'\n *\n * const result = await summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long article text here...'\n * })\n *\n * console.log(result.summary)\n * ```\n *\n * @example Summarization with style\n * ```ts\n * const result = await summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long article text here...',\n *   style: 'bullet-points',\n *   maxLength: 100\n * })\n * ```\n *\n * @example Focused summarization\n * ```ts\n * const result = await summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long technical document...',\n *   focus: ['key findings', 'methodology']\n * })\n * ```\n *\n * @example Streaming summarization\n * ```ts\n * for await (const chunk of summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long article text here...',\n *   stream: true\n * })) {\n *   if (chunk.type === 'content') {\n *     process.stdout.write(chunk.delta)\n *   }\n * }\n * ```\n */\nexport function summarize<\n  TAdapter extends SummarizeAdapter<string, object>,\n  TStream extends boolean = false,\n>(\n  options: SummarizeActivityOptions<TAdapter, TStream>,\n): SummarizeActivityResult<TStream> {\n  const { stream } = options\n\n  if (stream) {\n    return runStreamingSummarize(\n      options as SummarizeActivityOptions<\n        SummarizeAdapter<string, object>,\n        true\n      >,\n    ) as SummarizeActivityResult<TStream>\n  }\n\n  return runSummarize(\n    options as SummarizeActivityOptions<\n      SummarizeAdapter<string, object>,\n      false\n    >,\n  ) as SummarizeActivityResult<TStream>\n}\n\n/**\n * Run non-streaming summarization\n */\nasync function runSummarize(\n  options: SummarizeActivityOptions<SummarizeAdapter<string, object>, false>,\n): Promise<SummarizationResult> {\n  const { adapter, text, maxLength, style, focus, modelOptions, middleware } =\n    options\n  const model = adapter.model\n  const requestId = createId('summarize')\n  const inputLength = text.length\n  const startTime = Date.now()\n  const logger: InternalLogger = resolveDebugOption(options.debug)\n\n  const mwCtx = createGenerationContext({\n    requestId,\n    activity: 'summarize',\n    provider: adapter.name,\n    model,\n    modelOptions,\n    threadId: options.threadId,\n    runId: options.runId,\n    createId,\n  })\n\n  await runGenerationStart(middleware, mwCtx)\n\n  aiEventClient.emit('summarize:request:started', {\n    requestId,\n    provider: adapter.name,\n    model,\n    inputLength,\n    timestamp: startTime,\n  })\n\n  logger.request(`activity=summarize provider=${adapter.name}`, {\n    provider: adapter.name,\n    model,\n    inputLength,\n  })\n\n  const summarizeOptions = {\n    model,\n    text,\n    maxLength,\n    style,\n    focus,\n    modelOptions,\n    logger,\n  }\n\n  try {\n    const rawResult = await adapter.summarize(summarizeOptions)\n    // Transforms run before anything observes the result — the same order every\n    // media activity uses — so the run record and the returned value are the\n    // same object.\n    const result = await applyGenerationResultTransforms(mwCtx, rawResult)\n\n    const duration = Date.now() - startTime\n    const outputLength = result.summary.length\n\n    aiEventClient.emit('summarize:request:completed', {\n      requestId,\n      provider: adapter.name,\n      model,\n      inputLength,\n      outputLength,\n      duration,\n      timestamp: Date.now(),\n    })\n\n    logger.output(`activity=summarize length=${outputLength}`, {\n      hasSummary: !!result.summary,\n      outputLength,\n    })\n\n    if (result.usage) await runGenerationUsage(middleware, mwCtx, result.usage)\n    await runGenerationFinish(middleware, mwCtx, {\n      duration,\n      usage: result.usage,\n    })\n\n    return result\n  } catch (error) {\n    await runGenerationError(middleware, mwCtx, {\n      error,\n      duration: Date.now() - startTime,\n    })\n    logger.errors('summarize activity failed', {\n      error,\n      source: 'summarize',\n    })\n    throw error\n  }\n}\n\n/** Read a `usage` off a transformed result without asserting its shape. */\nfunction usageOf(result: unknown): SummarizationResult['usage'] | undefined {\n  if (typeof result !== 'object' || result === null) return undefined\n  const usage = (result as { usage?: unknown }).usage\n  return typeof usage === 'object' && usage !== null\n    ? (usage as SummarizationResult['usage'])\n    : undefined\n}\n\n/**\n * Run streaming summarization\n * Uses the adapter's native streaming if available, otherwise falls back\n * to non-streaming and yields the result as a single chunk.\n */\nasync function* runStreamingSummarize(\n  options: SummarizeActivityOptions<SummarizeAdapter<string, object>, true>,\n): AsyncIterable<StreamChunk> {\n  const {\n    adapter,\n    text,\n    maxLength,\n    style,\n    focus,\n    modelOptions,\n    runId,\n    threadId,\n  } = options\n  const model = adapter.model\n  const logger: InternalLogger = resolveDebugOption(options.debug)\n\n  logger.request(`activity=summarize provider=${adapter.name}`, {\n    provider: adapter.name,\n    model,\n    stream: true,\n  })\n\n  // Thread the caller's run identity through so the emitted `RUN_STARTED`\n  // carries it — keeps a delivery-durable route's log keyed by the id the\n  // client rejoins with (mid-run reload resumability). Conditional spreads keep\n  // the fields off the object entirely under `exactOptionalPropertyTypes`.\n  const summarizeOptions = {\n    model,\n    text,\n    maxLength,\n    style,\n    focus,\n    modelOptions,\n    logger,\n    ...(runId !== undefined ? { runId } : {}),\n    ...(threadId !== undefined ? { threadId } : {}),\n  }\n\n  // Use real streaming if the adapter supports it\n  if (adapter.summarizeStream) {\n    yield* runNativeSummarizeStream(\n      options,\n      adapter.summarizeStream(summarizeOptions),\n      logger,\n    )\n    return\n  }\n\n  try {\n    // Fall back to non-streaming — wrap the result with streamGenerationResult,\n    // forwarding the run identity so its RUN_STARTED matches too. The generation\n    // itself goes through `runSummarize`, so middleware (and its result\n    // transforms) run exactly as they do for a non-streaming call. Only `runId`\n    // is taken from the resolved wire identity — `threadId` stays the CALLER's,\n    // since a minted one would file the run in a slot no client can hydrate.\n    yield* streamGenerationResult(\n      (resolved) =>\n        runSummarize({ ...options, stream: false, runId: resolved.runId }),\n      {\n        ...(runId !== undefined ? { runId } : {}),\n        ...(threadId !== undefined ? { threadId } : {}),\n      },\n    )\n  } catch (error) {\n    logger.errors('summarize activity failed', {\n      error,\n      source: 'summarize',\n    })\n    throw error\n  }\n}\n\n/**\n * Drive an adapter's native `summarizeStream`, wiring the generation middleware\n * around it.\n *\n * The adapter emits a terminal `generation:result` CUSTOM chunk carrying the\n * assembled {@link SummarizationResult}; that is the one point where a result\n * exists, so the transforms run there and the REWRITTEN result is what gets\n * yielded — the client and the persisted run record then hold the same object.\n * An adapter whose stream never emits one still finishes the run, just with no\n * result recorded.\n */\nasync function* runNativeSummarizeStream(\n  options: SummarizeActivityOptions<SummarizeAdapter<string, object>, true>,\n  stream: AsyncIterable<StreamChunk>,\n  logger: InternalLogger,\n): AsyncIterable<StreamChunk> {\n  const { adapter, middleware, modelOptions } = options\n  const mwCtx = createGenerationContext({\n    requestId: createId('summarize'),\n    activity: 'summarize',\n    provider: adapter.name,\n    model: adapter.model,\n    modelOptions,\n    threadId: options.threadId,\n    runId: options.runId,\n    createId,\n  })\n\n  await runGenerationStart(middleware, mwCtx)\n\n  const startTime = Date.now()\n  // Tracks whether a terminal hook already fired, so the `finally` can report an\n  // abandoned stream without double-firing. Mirrors the streaming video path.\n  let settled = false\n  try {\n    for await (const chunk of stream) {\n      if (chunk.type === 'CUSTOM' && chunk.name === 'generation:result') {\n        const result = await applyGenerationResultTransforms<unknown>(\n          mwCtx,\n          chunk.value,\n        )\n        const usage = usageOf(result)\n        // Finish before yielding the terminal chunks: a consumer that stops\n        // reading once it has the result must not trip the abandonment path.\n        if (usage) await runGenerationUsage(middleware, mwCtx, usage)\n        await runGenerationFinish(middleware, mwCtx, {\n          duration: Date.now() - startTime,\n          usage,\n        })\n        settled = true\n        yield { ...chunk, value: result }\n        continue\n      }\n      yield chunk\n    }\n    if (!settled) {\n      await runGenerationFinish(middleware, mwCtx, {\n        duration: Date.now() - startTime,\n      })\n      settled = true\n    }\n  } catch (error) {\n    settled = true\n    await runGenerationError(middleware, mwCtx, {\n      error,\n      duration: Date.now() - startTime,\n    })\n    logger.errors('summarize activity failed', {\n      error,\n      source: 'summarize',\n    })\n    throw error\n  } finally {\n    if (!settled) {\n      // The consumer abandoned the stream mid-summary, so the generator is being\n      // unwound at a `yield`. Report a cancel, not an error, so an observer ends\n      // its span (and persistence marks the run interrupted) instead of leaving\n      // the run open forever.\n      await runGenerationAbort(middleware, mwCtx, {\n        reason: 'Summarize stream abandoned before completion',\n        duration: Date.now() - startTime,\n      })\n    }\n  }\n}\n\n// ===========================\n// Options Factory\n// ===========================\n\n/**\n * Create typed options for the summarize() function without executing.\n */\nexport function createSummarizeOptions<\n  TAdapter extends SummarizeAdapter<string, object>,\n  TStream extends boolean = false,\n>(\n  options: SummarizeActivityOptions<TAdapter, TStream>,\n): SummarizeActivityOptions<TAdapter, TStream> {\n  return options\n}\n\n// Re-export adapter types\nexport type {\n  SummarizeAdapter,\n  SummarizeAdapterConfig,\n  AnySummarizeAdapter,\n} from './adapter'\nexport { BaseSummarizeAdapter } from './adapter'\nexport {\n  ChatStreamSummarizeAdapter,\n  type ChatStreamCapable,\n  type InferTextProviderOptions,\n} from './chat-stream-summarize'\n"],"mappings":";;;;;;;;;;;;;;AA8BA,IAAa,OAAO;AAmGpB,SAAS,SAAS,QAAwB;CACxC,OAAO,GAAG,OAAO,GAAG,KAAK,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC;AACzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,UAId,SACkC;CAClC,MAAM,EAAE,WAAW;CAEnB,IAAI,QACF,OAAO,sBACL,OAIF;CAGF,OAAO,aACL,OAIF;AACF;;;;AAKA,eAAe,aACb,SAC8B;CAC9B,MAAM,EAAE,SAAS,MAAM,WAAW,OAAO,OAAO,cAAc,eAC5D;CACF,MAAM,QAAQ,QAAQ;CACtB,MAAM,YAAY,SAAS,WAAW;CACtC,MAAM,cAAc,KAAK;CACzB,MAAM,YAAY,KAAK,IAAI;CAC3B,MAAM,SAAyB,mBAAmB,QAAQ,KAAK;CAE/D,MAAM,QAAQ,wBAAwB;EACpC;EACA,UAAU;EACV,UAAU,QAAQ;EAClB;EACA;EACA,UAAU,QAAQ;EAClB,OAAO,QAAQ;EACf;CACF,CAAC;CAED,MAAM,mBAAmB,YAAY,KAAK;CAE1C,cAAc,KAAK,6BAA6B;EAC9C;EACA,UAAU,QAAQ;EAClB;EACA;EACA,WAAW;CACb,CAAC;CAED,OAAO,QAAQ,+BAA+B,QAAQ,QAAQ;EAC5D,UAAU,QAAQ;EAClB;EACA;CACF,CAAC;CAED,MAAM,mBAAmB;EACvB;EACA;EACA;EACA;EACA;EACA;EACA;CACF;CAEA,IAAI;EAKF,MAAM,SAAS,MAAM,gCAAgC,OAAO,MAJpC,QAAQ,UAAU,gBAAgB,CAIW;EAErE,MAAM,WAAW,KAAK,IAAI,IAAI;EAC9B,MAAM,eAAe,OAAO,QAAQ;EAEpC,cAAc,KAAK,+BAA+B;GAChD;GACA,UAAU,QAAQ;GAClB;GACA;GACA;GACA;GACA,WAAW,KAAK,IAAI;EACtB,CAAC;EAED,OAAO,OAAO,6BAA6B,gBAAgB;GACzD,YAAY,CAAC,CAAC,OAAO;GACrB;EACF,CAAC;EAED,IAAI,OAAO,OAAO,MAAM,mBAAmB,YAAY,OAAO,OAAO,KAAK;EAC1E,MAAM,oBAAoB,YAAY,OAAO;GAC3C;GACA,OAAO,OAAO;EAChB,CAAC;EAED,OAAO;CACT,SAAS,OAAO;EACd,MAAM,mBAAmB,YAAY,OAAO;GAC1C;GACA,UAAU,KAAK,IAAI,IAAI;EACzB,CAAC;EACD,OAAO,OAAO,6BAA6B;GACzC;GACA,QAAQ;EACV,CAAC;EACD,MAAM;CACR;AACF;;AAGA,SAAS,QAAQ,QAA2D;CAC1E,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO,KAAA;CAC1D,MAAM,QAAS,OAA+B;CAC9C,OAAO,OAAO,UAAU,YAAY,UAAU,OACzC,QACD,KAAA;AACN;;;;;;AAOA,gBAAgB,sBACd,SAC4B;CAC5B,MAAM,EACJ,SACA,MACA,WACA,OACA,OACA,cACA,OACA,aACE;CACJ,MAAM,QAAQ,QAAQ;CACtB,MAAM,SAAyB,mBAAmB,QAAQ,KAAK;CAE/D,OAAO,QAAQ,+BAA+B,QAAQ,QAAQ;EAC5D,UAAU,QAAQ;EAClB;EACA,QAAQ;CACV,CAAC;CAMD,MAAM,mBAAmB;EACvB;EACA;EACA;EACA;EACA;EACA;EACA;EACA,GAAI,UAAU,KAAA,IAAY,EAAE,MAAM,IAAI,CAAC;EACvC,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;CAC/C;CAGA,IAAI,QAAQ,iBAAiB;EAC3B,OAAO,yBACL,SACA,QAAQ,gBAAgB,gBAAgB,GACxC,MACF;EACA;CACF;CAEA,IAAI;EAOF,OAAO,wBACJ,aACC,aAAa;GAAE,GAAG;GAAS,QAAQ;GAAO,OAAO,SAAS;EAAM,CAAC,GACnE;GACE,GAAI,UAAU,KAAA,IAAY,EAAE,MAAM,IAAI,CAAC;GACvC,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;EAC/C,CACF;CACF,SAAS,OAAO;EACd,OAAO,OAAO,6BAA6B;GACzC;GACA,QAAQ;EACV,CAAC;EACD,MAAM;CACR;AACF;;;;;;;;;;;;AAaA,gBAAgB,yBACd,SACA,QACA,QAC4B;CAC5B,MAAM,EAAE,SAAS,YAAY,iBAAiB;CAC9C,MAAM,QAAQ,wBAAwB;EACpC,WAAW,SAAS,WAAW;EAC/B,UAAU;EACV,UAAU,QAAQ;EAClB,OAAO,QAAQ;EACf;EACA,UAAU,QAAQ;EAClB,OAAO,QAAQ;EACf;CACF,CAAC;CAED,MAAM,mBAAmB,YAAY,KAAK;CAE1C,MAAM,YAAY,KAAK,IAAI;CAG3B,IAAI,UAAU;CACd,IAAI;EACF,WAAW,MAAM,SAAS,QAAQ;GAChC,IAAI,MAAM,SAAS,YAAY,MAAM,SAAS,qBAAqB;IACjE,MAAM,SAAS,MAAM,gCACnB,OACA,MAAM,KACR;IACA,MAAM,QAAQ,QAAQ,MAAM;IAG5B,IAAI,OAAO,MAAM,mBAAmB,YAAY,OAAO,KAAK;IAC5D,MAAM,oBAAoB,YAAY,OAAO;KAC3C,UAAU,KAAK,IAAI,IAAI;KACvB;IACF,CAAC;IACD,UAAU;IACV,MAAM;KAAE,GAAG;KAAO,OAAO;IAAO;IAChC;GACF;GACA,MAAM;EACR;EACA,IAAI,CAAC,SAAS;GACZ,MAAM,oBAAoB,YAAY,OAAO,EAC3C,UAAU,KAAK,IAAI,IAAI,UACzB,CAAC;GACD,UAAU;EACZ;CACF,SAAS,OAAO;EACd,UAAU;EACV,MAAM,mBAAmB,YAAY,OAAO;GAC1C;GACA,UAAU,KAAK,IAAI,IAAI;EACzB,CAAC;EACD,OAAO,OAAO,6BAA6B;GACzC;GACA,QAAQ;EACV,CAAC;EACD,MAAM;CACR,UAAU;EACR,IAAI,CAAC,SAKH,MAAM,mBAAmB,YAAY,OAAO;GAC1C,QAAQ;GACR,UAAU,KAAK,IAAI,IAAI;EACzB,CAAC;CAEL;AACF;;;;AASA,SAAgB,uBAId,SAC6C;CAC7C,OAAO;AACT"}

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

@@ -4,4 +4,5 @@ export type { Logger } from './logger/types.js';
 export { resolveDebugOption } from './logger/resolve.js';
 export { toRunErrorPayload, toRunErrorRawEvent, } from './activities/error-payload.js';
 export { getSandboxRuntime, provideSandboxRuntime, SandboxRuntimeCapability, } from './activities/chat/middleware/sandbox-runtime.js';
-export type { SandboxRuntime } from './activities/chat/middleware/sandbox-runtime.js';
+export { getRunDisconnect, provideRunDisconnect, RunDisconnectCapability, } from './activities/chat/middleware/run-disconnect.js';
+export { getPendingTurn, PendingTurnCapability, providePendingTurn, } from './activities/chat/middleware/pending-turn.js';

package/dist/esm/adapter-internals.js

@@ -1,14 +1,7 @@
+import { toRunErrorPayload, toRunErrorRawEvent } from "./activities/error-payload.js";
 import { InternalLogger } from "./logger/internal-logger.js";
 import { resolveDebugOption } from "./logger/resolve.js";
-import { toRunErrorPayload, toRunErrorRawEvent } from "./activities/error-payload.js";
 import { SandboxRuntimeCapability, getSandboxRuntime, provideSandboxRuntime } from "./activities/chat/middleware/sandbox-runtime.js";
-export {
-  InternalLogger,
-  SandboxRuntimeCapability,
-  getSandboxRuntime,
-  provideSandboxRuntime,
-  resolveDebugOption,
-  toRunErrorPayload,
-  toRunErrorRawEvent
-};
-//# sourceMappingURL=adapter-internals.js.map
+import { RunDisconnectCapability, getRunDisconnect, provideRunDisconnect } from "./activities/chat/middleware/run-disconnect.js";
+import { PendingTurnCapability, getPendingTurn, providePendingTurn } from "./activities/chat/middleware/pending-turn.js";
+export { InternalLogger, PendingTurnCapability, RunDisconnectCapability, SandboxRuntimeCapability, getPendingTurn, getRunDisconnect, getSandboxRuntime, providePendingTurn, provideRunDisconnect, provideSandboxRuntime, resolveDebugOption, toRunErrorPayload, toRunErrorRawEvent };

package/dist/esm/client.d.ts

@@ -1,3 +1,20 @@
+import { AudioGenerationOptions, ImageGenerationOptions, TTSOptions, TranscriptionOptions, VideoGenerationOptions } from './types.js';
+export type GenerationKind = 'image' | 'audio' | 'tts' | 'video' | 'transcription';
+type GenerationInputByKind = {
+    image: Omit<ImageGenerationOptions, 'logger' | 'model'>;
+    audio: Omit<AudioGenerationOptions, 'logger' | 'model'>;
+    tts: Omit<TTSOptions, 'logger' | 'model'>;
+    video: Omit<VideoGenerationOptions, 'logger' | 'model'>;
+    transcription: Omit<TranscriptionOptions, 'logger' | 'model'>;
+};
+export interface GenerationParams<TKind extends GenerationKind> {
+    input: GenerationInputByKind[TKind];
+    forwardedProps: Record<string, unknown>;
+    threadId?: string;
+    runId?: string;
+}
+export declare function generationParamsFromBody<TKind extends GenerationKind>(kind: TKind, body: unknown): GenerationParams<TKind>;
+export declare function generationParamsFromRequest<TKind extends GenerationKind>(kind: TKind, request: Request): Promise<GenerationParams<TKind>>;
 export declare enum EventType {
     TEXT_MESSAGE_START = "TEXT_MESSAGE_START",
     TEXT_MESSAGE_CONTENT = "TEXT_MESSAGE_CONTENT",
@@ -33,12 +50,17 @@ export declare enum EventType {
     REASONING_END = "REASONING_END",
     REASONING_ENCRYPTED_VALUE = "REASONING_ENCRYPTED_VALUE"
 }
-export { toolDefinition, type AnyClientTool, type ClientTool, type InferToolInput, type InferToolName, type InferToolOutput, type ToolDefinition, type ToolDefinitionConfig, type ToolDefinitionInstance, } from './activities/chat/tools/tool-definition.js';
-export { convertSchemaToJsonSchema, isStandardSchema, parseWithStandardSchema, } from './activities/chat/tools/schema-converter.js';
+export { toolDefinition, type AnyClientTool, type ClientTool, type InferToolInput, type InferToolName, type InferToolOutput, type ApprovalCapabilityOf, type ApprovalSchemaConfig, type ApprovalSchemaOf, type InputSchemaOf, type OutputSchemaOf, type NoSchema, type ToolDefinition, type ToolDefinitionConfig, type ToolDefinitionInstance, } 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 { convertSchemaToJsonSchema, isStandardSchema, parseWithStandardSchema, validateWithStandardSchema, } from './activities/chat/tools/schema-converter.js';
 export { convertMessagesToModelMessages, generateMessageId, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeToUIMessage, uiMessageToModelMessages, } from './activities/chat/messages.js';
 export { BatchStrategy, CompositeStrategy, defaultJSONParser, ImmediateStrategy, parsePartialJSON, PartialJSONParser, PunctuationStrategy, StreamProcessor, WordBoundaryStrategy, } from './activities/chat/stream/index.js';
 export type { ChunkRecording, ChunkStrategy, InternalToolCallState, JSONParser, ProcessorResult, ProcessorState, StreamProcessorEvents, StreamProcessorOptions, ToolCallState, ToolResultState, } from './activities/chat/stream/index.js';
 export { uiMessagesToWire } from './utilities/ag-ui-wire.js';
 export type { WireMessage } from './utilities/ag-ui-wire.js';
-export type { AudioPart, ContentPart, ContentPartDataSource, ContentPartSource, ContentPartUrlSource, CustomEvent, DocumentPart, ImagePart, MediaInputMetadata, MediaInputRole, MediaPrompt, MediaPromptPart, MessagePart, ModelMessage, RunErrorEvent, RunFinishedEvent, SchemaInput, StreamChunk, StructuredOutputPart, TextPart, ThinkingPart, ToolCall, ToolCallPart, ToolResultPart, UIMessage, UIResourcePart, VideoPart, InferSchemaType, } from './types.js';
+export type { AudioPart, ContentPart, ContentPartDataSource, ContentPartSource, ContentPartUrlSource, CustomEvent, DocumentPart, ImagePart, MediaInputMetadata, MediaInputRole, MediaPrompt, MediaPromptPart, MessagePart, ModelMessage, PersistedArtifactActivity, PersistedArtifactRef, PersistedArtifactRole, Interrupt, RunAgentResumeItem, RunErrorEvent, RunFinishedEvent, RunFinishedOutcome, SchemaInput, StreamChunk, StructuredOutputPart, TextPart, ThinkingPart, ToolCall, ToolCallPart, ToolResultPart, UIMessage, UIResourcePart, VideoPart, InferSchemaType, } from './types.js';
+export { INTERRUPT_BINDING_VERSION, canonicalizeInterruptResolutions, } from './interrupts.js';
+export type { BatchInterruptError, BatchInterruptErrorCode, InterruptBinding, InterruptCorrelation, InterruptSubmissionError, ItemInterruptError, ItemInterruptErrorCode, ToolApprovalResolution, UnopenedInterruptBinding, } from './interrupts.js';
+export { INTERRUPT_BINDING_METADATA_KEY, readInterruptBinding, readUnopenedInterruptBinding, withInterruptBinding, withoutInterruptBinding, } from './interrupt-resume.js';
 export type { AudioVisualization, RealtimeAdapter, RealtimeConnection, RealtimeError, RealtimeErrorCode, RealtimeEvent, RealtimeEventHandler, RealtimeEventPayloads, RealtimeMessage, RealtimeMessagePart, RealtimeMode, RealtimeSessionConfig, RealtimeStatus, RealtimeToken, RealtimeAudioPart, RealtimeImagePart, RealtimeTextPart, RealtimeToolCallPart, RealtimeToolResultPart, VADConfig, } from './realtime/types.js';