@tanstack/ai 0.59.0 → 0.63.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/activities/generateWorld/index.ts"],"sourcesContent":["/**\n * World Activity (Experimental)\n *\n * Mints a session token for a live, prompt-steerable world. Unlike\n * generateVideo (a job that finishes with a URL), the browser then connects\n * with the token, sets the prompt, and streams until pause/reset/close.\n *\n * @experimental World generation is an experimental feature and may change.\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 {\n  abortReasonMessage,\n  createActivityAbortControls,\n  isActivityAbortError,\n  raceWithAbort,\n} from '../../utilities/activity-abort'\nimport type { InternalLogger } from '../../logger/internal-logger'\nimport type { DebugOption } from '../../logger/types'\nimport type { GenerationMiddleware } from '../middleware/types'\nimport type { WorldAdapter } from './adapter'\nimport type { StreamChunk, WorldGenerationResult } from '../../types'\n\n// ===========================\n// Activity Kind\n// ===========================\n\n/** The adapter kind this activity handles */\nexport const kind = 'world' as const\n\n// ===========================\n// Type Extraction Helpers\n// ===========================\n\n/**\n * Extract provider options from a WorldAdapter via ~types.\n */\nexport type WorldProviderOptions<TAdapter> = TAdapter extends {\n  '~types': { providerOptions: infer P extends object }\n}\n  ? P\n  : object\n\n// ===========================\n// Activity Options Type\n// ===========================\n\n/**\n * Options for the world generation activity.\n * The model is extracted from the adapter's model property.\n *\n * @template TAdapter - The world adapter type\n * @template TStream - Whether to stream the output\n *\n * @experimental World generation is an experimental feature and may change.\n */\nexport interface WorldActivityOptions<\n  TAdapter extends WorldAdapter<string, WorldProviderOptions<TAdapter>>,\n  TStream extends boolean = false,\n> {\n  /** The world adapter to use (must be created with a model) */\n  adapter: TAdapter & { kind: typeof kind }\n  /** Natural-language description of the world or scene */\n  prompt: string\n  /** Provider-specific options for world generation */\n  modelOptions?: WorldProviderOptions<TAdapter>\n  /**\n   * Whether to wrap the token result as StreamChunks for SSE transport.\n   * This is not the live video. When false or omitted, returns\n   * Promise<WorldGenerationResult>.\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   * Observe-only middleware notified on start, usage, success, and error. Pass\n   * `otelMiddleware()` to emit OpenTelemetry spans, or implement the\n   * `GenerationMiddleware` contract for a custom backend.\n   */\n  middleware?: Array<GenerationMiddleware>\n  /** Stable conversation/thread id for correlating this run when persisted. */\n  threadId?: string\n  /** Stable run id for correlating this run when persisted. */\n  runId?: string\n  /**\n   * Maximum duration of the token mint in milliseconds.\n   * No SDK-wide default. Composed with {@link abortSignal}; the first abort wins.\n   */\n  timeout?: number\n  /**\n   * Caller cancellation signal (request disconnects, job/runtime cancellation).\n   * Composed with {@link timeout} into an effective signal forwarded to the\n   * adapter. Request-specific — not stored on global provider client config.\n   */\n  abortSignal?: AbortSignal\n}\n\n// ===========================\n// Activity Result Type\n// ===========================\n\n/**\n * Result type for the world generation activity.\n * - If stream is true: AsyncIterable<StreamChunk>\n * - Otherwise: Promise<WorldGenerationResult>\n */\nexport type WorldActivityResult<TStream extends boolean = false> =\n  TStream extends true\n    ? AsyncIterable<StreamChunk>\n    : Promise<WorldGenerationResult>\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 * World generation activity - opens a live, prompt-steerable world session.\n *\n * @example Mint a session token on the server\n * ```ts\n * import { generateWorld } from '@tanstack/ai'\n * import { reactorWorld } from '@tanstack/ai-reactor'\n *\n * const world = await generateWorld({\n *   adapter: reactorWorld('visko-orbis-stable'),\n *   prompt: 'A neon cyberpunk city at night, slow aerial drift',\n * })\n *\n * // Hand world.token, world.model, and world.prompt to the browser.\n * ```\n *\n * @experimental World generation is an experimental feature and may change.\n */\nexport function generateWorld<\n  TAdapter extends WorldAdapter<string, WorldProviderOptions<TAdapter>>,\n  TStream extends boolean = false,\n>(\n  options: WorldActivityOptions<TAdapter, TStream>,\n): WorldActivityResult<TStream> {\n  if (options.stream) {\n    return streamGenerationResult(\n      (resolved) => runGenerateWorld({ ...options, runId: resolved.runId }),\n      options,\n    ) as WorldActivityResult<TStream>\n  }\n  return runGenerateWorld(options) as WorldActivityResult<TStream>\n}\n\n/**\n * Run the core world generation logic (non-streaming).\n */\nasync function runGenerateWorld<\n  TAdapter extends WorldAdapter<string, WorldProviderOptions<TAdapter>>,\n>(\n  options: WorldActivityOptions<TAdapter, boolean>,\n): Promise<WorldGenerationResult> {\n  const {\n    adapter,\n    stream: _stream,\n    debug: _debug,\n    middleware,\n    threadId,\n    runId,\n    timeout,\n    abortSignal: callerAbortSignal,\n    ...rest\n  } = options\n  const model = adapter.model\n  const requestId = createId('world')\n  const startTime = Date.now()\n  const logger: InternalLogger = resolveDebugOption(options.debug)\n  const abortControls = createActivityAbortControls({\n    timeout,\n    abortSignal: callerAbortSignal,\n  })\n  const providerName =\n    (adapter as { name?: string; provider?: string }).provider ??\n    (adapter as { name?: string }).name ??\n    'unknown'\n\n  const mwCtx = createGenerationContext({\n    requestId,\n    activity: 'world',\n    provider: adapter.name,\n    model,\n    modelOptions: rest.modelOptions,\n    threadId,\n    runId,\n    artifactInputs: { prompt: rest.prompt },\n    createId,\n  })\n\n  await runGenerationStart(middleware, mwCtx)\n\n  aiEventClient.emit('world:request:started', {\n    requestId,\n    provider: adapter.name,\n    model,\n    prompt: rest.prompt,\n    timestamp: startTime,\n    ...(rest.modelOptions !== undefined && {\n      modelOptions: rest.modelOptions as Record<string, unknown>,\n    }),\n  })\n\n  logger.request(`activity=generateWorld provider=${providerName}`, {\n    provider: providerName,\n    model,\n  })\n\n  try {\n    const rawResult = await raceWithAbort(\n      adapter.createWorld({\n        ...rest,\n        model,\n        logger,\n        ...(abortControls.signal ? { abortSignal: abortControls.signal } : {}),\n      }),\n      abortControls.signal,\n    )\n    abortControls.clear()\n    const result = await applyGenerationResultTransforms(mwCtx, rawResult)\n    const elapsedMs = Date.now() - startTime\n\n    aiEventClient.emit('world:request:completed', {\n      requestId,\n      provider: adapter.name,\n      model: result.model,\n      prompt: result.prompt,\n      status: result.status,\n      duration: elapsedMs,\n      timestamp: Date.now(),\n      ...(rest.modelOptions !== undefined && {\n        modelOptions: rest.modelOptions as Record<string, unknown>,\n      }),\n    })\n\n    if (result.usage) {\n      aiEventClient.emit('world:usage', {\n        requestId,\n        model: result.model,\n        usage: result.usage,\n        timestamp: Date.now(),\n        ...(rest.modelOptions !== undefined && {\n          modelOptions: rest.modelOptions as Record<string, unknown>,\n        }),\n      })\n    }\n\n    logger.output(`activity=generateWorld provider=${providerName}`, {\n      model: result.model,\n      status: result.status,\n    })\n\n    if (result.usage) await runGenerationUsage(middleware, mwCtx, result.usage)\n    await runGenerationFinish(middleware, mwCtx, {\n      duration: elapsedMs,\n      usage: result.usage,\n    })\n\n    return result\n  } catch (error) {\n    abortControls.clear()\n    const elapsedMs = Date.now() - startTime\n    const err = error as Error\n    aiEventClient.emit('world:request:error', {\n      requestId,\n      provider: adapter.name,\n      model,\n      error: { message: err.message, name: err.name },\n      duration: elapsedMs,\n      timestamp: Date.now(),\n      ...(rest.modelOptions !== undefined && {\n        modelOptions: rest.modelOptions as Record<string, unknown>,\n      }),\n    })\n    if (isActivityAbortError(error, abortControls.signal)) {\n      await runGenerationAbort(middleware, mwCtx, {\n        reason: abortReasonMessage(error, abortControls.signal),\n        duration: elapsedMs,\n      })\n    } else {\n      await runGenerationError(middleware, mwCtx, {\n        error,\n        duration: elapsedMs,\n      })\n    }\n    logger.errors('generateWorld activity failed', {\n      error,\n      source: 'generateWorld',\n    })\n    throw error\n  }\n}\n\n// ===========================\n// Options Factory\n// ===========================\n\n/**\n * Create typed options for the generateWorld() function without executing.\n */\nexport function createWorldOptions<\n  TAdapter extends WorldAdapter<string, WorldProviderOptions<TAdapter>>,\n  TStream extends boolean = false,\n>(\n  options: WorldActivityOptions<TAdapter, TStream>,\n): WorldActivityOptions<TAdapter, TStream> {\n  return options\n}\n\n// Re-export adapter types\nexport type {\n  WorldAdapter,\n  WorldAdapterConfig,\n  AnyWorldAdapter,\n} from './adapter'\nexport { BaseWorldAdapter } from './adapter'\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/activities/generateWorld/index.ts"],"sourcesContent":["/**\n * World Activity (Experimental)\n *\n * Live adapters mint a session token for a prompt-steerable world. Job\n * adapters start generation and return a viewer URL, or an operation id\n * while the job is still running.\n *\n * @experimental World generation is an experimental feature and may change.\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 {\n  abortReasonMessage,\n  createActivityAbortControls,\n  isActivityAbortError,\n  raceWithAbort,\n} from '../../utilities/activity-abort'\nimport type { InternalLogger } from '../../logger/internal-logger'\nimport type { DebugOption } from '../../logger/types'\nimport type { GenerationMiddleware } from '../middleware/types'\nimport type { WorldAdapter } from './adapter'\nimport type { StreamChunk, WorldGenerationResult } from '../../types'\n\n// ===========================\n// Activity Kind\n// ===========================\n\n/** The adapter kind this activity handles */\nexport const kind = 'world' as const\n\n// ===========================\n// Type Extraction Helpers\n// ===========================\n\n/**\n * Extract provider options from a WorldAdapter via ~types.\n */\nexport type WorldProviderOptions<TAdapter> = TAdapter extends {\n  '~types': { providerOptions: infer P extends object }\n}\n  ? P\n  : object\n\n// ===========================\n// Activity Options Type\n// ===========================\n\n/**\n * Options for the world generation activity.\n * The model is extracted from the adapter's model property.\n *\n * @template TAdapter - The world adapter type\n * @template TStream - Whether to stream the output\n *\n * @experimental World generation is an experimental feature and may change.\n */\nexport interface WorldActivityOptions<\n  TAdapter extends WorldAdapter<string, WorldProviderOptions<TAdapter>>,\n  TStream extends boolean = false,\n> {\n  /** The world adapter to use (must be created with a model) */\n  adapter: TAdapter & { kind: typeof kind }\n  /** Natural-language description of the world or scene */\n  prompt: string\n  /** Provider-specific options for world generation */\n  modelOptions?: WorldProviderOptions<TAdapter>\n  /**\n   * Whether to wrap the result as StreamChunks for SSE transport.\n   * This is not the live video. When false or omitted, returns\n   * Promise<WorldGenerationResult>.\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   * Observe-only middleware notified on start, usage, success, and error. Pass\n   * `otelMiddleware()` to emit OpenTelemetry spans, or implement the\n   * `GenerationMiddleware` contract for a custom backend.\n   */\n  middleware?: Array<GenerationMiddleware>\n  /** Stable conversation/thread id for correlating this run when persisted. */\n  threadId?: string\n  /** Stable run id for correlating this run when persisted. */\n  runId?: string\n  /**\n   * Maximum wait for the mint or job poll, in milliseconds.\n   * No SDK-wide default. Composed with {@link abortSignal}; the first abort wins.\n   */\n  timeout?: number\n  /**\n   * Caller cancellation signal (request disconnects, job/runtime cancellation).\n   * Composed with {@link timeout} into an effective signal forwarded to the\n   * adapter. Request-specific — not stored on global provider client config.\n   */\n  abortSignal?: AbortSignal\n}\n\n// ===========================\n// Activity Result Type\n// ===========================\n\n/**\n * Result type for the world generation activity.\n * - If stream is true: AsyncIterable<StreamChunk>\n * - Otherwise: Promise<WorldGenerationResult>\n */\nexport type WorldActivityResult<TStream extends boolean = false> =\n  TStream extends true\n    ? AsyncIterable<StreamChunk>\n    : Promise<WorldGenerationResult>\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 * World generation activity. Live adapters mint a session token. Job\n * adapters return a viewer URL or an in-progress operation id.\n *\n * @example Mint a session token on the server\n * ```ts\n * import { generateWorld } from '@tanstack/ai'\n * import { reactorWorld } from '@tanstack/ai-reactor'\n *\n * const world = await generateWorld({\n *   adapter: reactorWorld('visko-orbis-stable'),\n *   prompt: 'A neon cyberpunk city at night, slow aerial drift',\n * })\n *\n * // Hand world.token, world.model, and world.prompt to the browser.\n * ```\n *\n * @experimental World generation is an experimental feature and may change.\n */\nexport function generateWorld<\n  TAdapter extends WorldAdapter<string, WorldProviderOptions<TAdapter>>,\n  TStream extends boolean = false,\n>(\n  options: WorldActivityOptions<TAdapter, TStream>,\n): WorldActivityResult<TStream> {\n  if (options.stream) {\n    return streamGenerationResult(\n      (resolved) => runGenerateWorld({ ...options, runId: resolved.runId }),\n      options,\n    ) as WorldActivityResult<TStream>\n  }\n  return runGenerateWorld(options) as WorldActivityResult<TStream>\n}\n\n/**\n * Run the core world generation logic (non-streaming).\n */\nasync function runGenerateWorld<\n  TAdapter extends WorldAdapter<string, WorldProviderOptions<TAdapter>>,\n>(\n  options: WorldActivityOptions<TAdapter, boolean>,\n): Promise<WorldGenerationResult> {\n  const {\n    adapter,\n    stream: _stream,\n    debug: _debug,\n    middleware,\n    threadId,\n    runId,\n    timeout,\n    abortSignal: callerAbortSignal,\n    ...rest\n  } = options\n  const model = adapter.model\n  const requestId = createId('world')\n  const startTime = Date.now()\n  const logger: InternalLogger = resolveDebugOption(options.debug)\n  const abortControls = createActivityAbortControls({\n    timeout,\n    abortSignal: callerAbortSignal,\n  })\n  const providerName =\n    (adapter as { name?: string; provider?: string }).provider ??\n    (adapter as { name?: string }).name ??\n    'unknown'\n\n  const mwCtx = createGenerationContext({\n    requestId,\n    activity: 'world',\n    provider: adapter.name,\n    model,\n    modelOptions: rest.modelOptions,\n    threadId,\n    runId,\n    artifactInputs: { prompt: rest.prompt },\n    createId,\n  })\n\n  await runGenerationStart(middleware, mwCtx)\n\n  aiEventClient.emit('world:request:started', {\n    requestId,\n    provider: adapter.name,\n    model,\n    prompt: rest.prompt,\n    timestamp: startTime,\n    ...(rest.modelOptions !== undefined && {\n      modelOptions: rest.modelOptions as Record<string, unknown>,\n    }),\n  })\n\n  logger.request(`activity=generateWorld provider=${providerName}`, {\n    provider: providerName,\n    model,\n  })\n\n  try {\n    const rawResult = await raceWithAbort(\n      adapter.createWorld({\n        ...rest,\n        model,\n        logger,\n        ...(abortControls.signal ? { abortSignal: abortControls.signal } : {}),\n      }),\n      abortControls.signal,\n    )\n    abortControls.clear()\n    const result = await applyGenerationResultTransforms(mwCtx, rawResult)\n    const elapsedMs = Date.now() - startTime\n\n    aiEventClient.emit('world:request:completed', {\n      requestId,\n      provider: adapter.name,\n      model: result.model,\n      prompt: result.prompt,\n      status: result.status,\n      duration: elapsedMs,\n      timestamp: Date.now(),\n      ...(rest.modelOptions !== undefined && {\n        modelOptions: rest.modelOptions as Record<string, unknown>,\n      }),\n    })\n\n    if (result.usage) {\n      aiEventClient.emit('world:usage', {\n        requestId,\n        model: result.model,\n        usage: result.usage,\n        timestamp: Date.now(),\n        ...(rest.modelOptions !== undefined && {\n          modelOptions: rest.modelOptions as Record<string, unknown>,\n        }),\n      })\n    }\n\n    logger.output(`activity=generateWorld provider=${providerName}`, {\n      model: result.model,\n      status: result.status,\n    })\n\n    if (result.usage) await runGenerationUsage(middleware, mwCtx, result.usage)\n    await runGenerationFinish(middleware, mwCtx, {\n      duration: elapsedMs,\n      usage: result.usage,\n    })\n\n    return result\n  } catch (error) {\n    abortControls.clear()\n    const elapsedMs = Date.now() - startTime\n    const err = error as Error\n    aiEventClient.emit('world:request:error', {\n      requestId,\n      provider: adapter.name,\n      model,\n      error: { message: err.message, name: err.name },\n      duration: elapsedMs,\n      timestamp: Date.now(),\n      ...(rest.modelOptions !== undefined && {\n        modelOptions: rest.modelOptions as Record<string, unknown>,\n      }),\n    })\n    if (isActivityAbortError(error, abortControls.signal)) {\n      await runGenerationAbort(middleware, mwCtx, {\n        reason: abortReasonMessage(error, abortControls.signal),\n        duration: elapsedMs,\n      })\n    } else {\n      await runGenerationError(middleware, mwCtx, {\n        error,\n        duration: elapsedMs,\n      })\n    }\n    logger.errors('generateWorld activity failed', {\n      error,\n      source: 'generateWorld',\n    })\n    throw error\n  }\n}\n\n// ===========================\n// Options Factory\n// ===========================\n\n/**\n * Create typed options for the generateWorld() function without executing.\n */\nexport function createWorldOptions<\n  TAdapter extends WorldAdapter<string, WorldProviderOptions<TAdapter>>,\n  TStream extends boolean = false,\n>(\n  options: WorldActivityOptions<TAdapter, TStream>,\n): WorldActivityOptions<TAdapter, TStream> {\n  return options\n}\n\n// Re-export adapter types\nexport type {\n  WorldAdapter,\n  WorldAdapterConfig,\n  AnyWorldAdapter,\n} from './adapter'\nexport { BaseWorldAdapter } from './adapter'\n"],"mappings":"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"}

package/dist/esm/activities/index.d.ts

@@ -11,6 +11,7 @@ import { AnyRerankAdapter } from './rerank/adapter.js';
 import { AnyEvaluateAdapter } from './evaluate/adapter.js';
 import { AnyWorldAdapter } from './generateWorld/adapter.js';
 import { AnyLiveVideoAdapter } from './generateLiveVideo/adapter.js';
+import { AnyFilesAdapter } from './files/adapter.js';
 export { kind as textKind, chat, type TextActivityOptions, type TextActivityResult, } from './chat/index.js';
 export { defineAgent, type DefinedAgent, type SubagentChoiceOptions, type SubagentRunContext, } from './chat/agents/define-agent.js';
 export { subagentRoute, type SubagentRouteOptions } from './chat/agents/route.js';
@@ -42,7 +43,9 @@ export { kind as worldKind, generateWorld, type WorldActivityOptions, type World
 export { BaseWorldAdapter, type WorldAdapter, type WorldAdapterConfig, type AnyWorldAdapter, } from './generateWorld/adapter.js';
 export { kind as liveVideoKind, generateLiveVideo, type LiveVideoActivityOptions, type LiveVideoActivityResult, type LiveVideoProviderOptions, } from './generateLiveVideo/index.js';
 export { BaseLiveVideoAdapter, type LiveVideoAdapter, type LiveVideoAdapterConfig, type AnyLiveVideoAdapter, } from './generateLiveVideo/adapter.js';
-/** Union of all adapter types that can be passed to chat() */
-export type AIAdapter = AnyTextAdapter | AnySummarizeAdapter | AnyImageAdapter | AnyAudioAdapter | AnyVideoAdapter | AnyTTSAdapter | AnyVoiceAdapter | AnyTranscriptionAdapter | AnyEmbeddingAdapter | AnyRerankAdapter | AnyEvaluateAdapter | AnyWorldAdapter | AnyLiveVideoAdapter;
+export { kind as filesKind, uploadFile, getFile, deleteFile, fileSourceFromHandle, } from './files/index.js';
+export { BaseFilesAdapter, normalizeFileUploadInput, type FilesAdapter, type AnyFilesAdapter, type FileHandle, type FileUploadInput, } from './files/adapter.js';
+/** Union of all adapter types across every activity kind */
+export type AIAdapter = AnyTextAdapter | AnySummarizeAdapter | AnyImageAdapter | AnyAudioAdapter | AnyVideoAdapter | AnyTTSAdapter | AnyVoiceAdapter | AnyTranscriptionAdapter | AnyEmbeddingAdapter | AnyRerankAdapter | AnyEvaluateAdapter | AnyWorldAdapter | AnyLiveVideoAdapter | AnyFilesAdapter;
 /** Union type of all adapter kinds */
-export type AdapterKind = 'text' | 'summarize' | 'image' | 'audio' | 'video' | 'tts' | 'voice' | 'transcription' | 'embedding' | 'rerank' | 'evaluate' | 'world' | 'liveVideo';
+export type AdapterKind = 'text' | 'summarize' | 'image' | 'audio' | 'video' | 'tts' | 'voice' | 'transcription' | 'embedding' | 'rerank' | 'evaluate' | 'world' | 'liveVideo' | 'files';

package/dist/esm/activities/index.js

@@ -1,31 +1,33 @@
 import { BaseTextAdapter } from "./chat/adapter.js";
-import { chat, kind as kind$7 } from "./chat/index.js";
+import { chat, kind as kind$8 } from "./chat/index.js";
 import { defineAgent } from "./chat/agents/define-agent.js";
 import { BaseEvaluateAdapter } from "./evaluate/adapter.js";
 import { boolean, choice, decide, kind as kind$2, score } from "./evaluate/index.js";
 import { subagentRoute } from "./chat/agents/route.js";
 import { BaseSummarizeAdapter } from "./summarize/adapter.js";
 import { ChatStreamSummarizeAdapter } from "./summarize/chat-stream-summarize.js";
-import { kind as kind$6, summarize } from "./summarize/index.js";
+import { kind as kind$7, summarize } from "./summarize/index.js";
 import { BaseRerankAdapter } from "./rerank/adapter.js";
-import { createRerankOptions, kind as kind$5, rerank } from "./rerank/index.js";
+import { createRerankOptions, kind as kind$6, rerank } from "./rerank/index.js";
 import { BaseImageAdapter } from "./generateImage/adapter.js";
-import { generateImage, kind as kind$3 } from "./generateImage/index.js";
+import { generateImage, kind as kind$4 } from "./generateImage/index.js";
 import { BaseAudioAdapter } from "./generateAudio/adapter.js";
 import { generateAudio, kind } from "./generateAudio/index.js";
 import { BaseVideoAdapter } from "./generateVideo/adapter.js";
-import { generateVideo, getVideoJobStatus, kind as kind$10 } from "./generateVideo/index.js";
+import { generateVideo, getVideoJobStatus, kind as kind$11 } from "./generateVideo/index.js";
 import { snapToDurationOption } from "./generateVideo/snap.js";
 import { BaseTTSAdapter } from "./generateSpeech/adapter.js";
-import { generateSpeech, kind as kind$9, listVoices } from "./generateSpeech/index.js";
+import { generateSpeech, kind as kind$10, listVoices } from "./generateSpeech/index.js";
 import { BaseVoiceAdapter } from "./generateVoice/adapter.js";
-import { createVoiceOptions, generateVoice, kind as kind$11 } from "./generateVoice/index.js";
+import { createVoiceOptions, generateVoice, kind as kind$12 } from "./generateVoice/index.js";
 import { BaseTranscriptionAdapter } from "./generateTranscription/adapter.js";
-import { generateTranscription, kind as kind$8 } from "./generateTranscription/index.js";
+import { generateTranscription, kind as kind$9 } from "./generateTranscription/index.js";
 import { BaseEmbeddingAdapter } from "./embed/adapter.js";
 import { embed, kind as kind$1 } from "./embed/index.js";
 import { BaseWorldAdapter } from "./generateWorld/adapter.js";
-import { generateWorld, kind as kind$12 } from "./generateWorld/index.js";
+import { generateWorld, kind as kind$13 } from "./generateWorld/index.js";
 import { BaseLiveVideoAdapter } from "./generateLiveVideo/adapter.js";
-import { generateLiveVideo, kind as kind$4 } from "./generateLiveVideo/index.js";
-export { BaseAudioAdapter, BaseEmbeddingAdapter, BaseEvaluateAdapter, BaseImageAdapter, BaseLiveVideoAdapter, BaseRerankAdapter, BaseSummarizeAdapter, BaseTTSAdapter, BaseTextAdapter, BaseTranscriptionAdapter, BaseVideoAdapter, BaseVoiceAdapter, BaseWorldAdapter, ChatStreamSummarizeAdapter, kind as audioKind, boolean, chat, choice, createRerankOptions, createVoiceOptions, decide, defineAgent, embed, kind$1 as embeddingKind, kind$2 as evaluateKind, generateAudio, generateImage, generateLiveVideo, generateSpeech, generateTranscription, generateVideo, generateVoice, generateWorld, getVideoJobStatus, kind$3 as imageKind, listVoices, kind$4 as liveVideoKind, rerank, kind$5 as rerankKind, score, snapToDurationOption, subagentRoute, summarize, kind$6 as summarizeKind, kind$7 as textKind, kind$8 as transcriptionKind, kind$9 as ttsKind, kind$10 as videoKind, kind$11 as voiceKind, kind$12 as worldKind };
+import { generateLiveVideo, kind as kind$5 } from "./generateLiveVideo/index.js";
+import { deleteFile, fileSourceFromHandle, getFile, kind as kind$3, uploadFile } from "./files/index.js";
+import { BaseFilesAdapter, normalizeFileUploadInput } from "./files/adapter.js";
+export { BaseAudioAdapter, BaseEmbeddingAdapter, BaseEvaluateAdapter, BaseFilesAdapter, BaseImageAdapter, BaseLiveVideoAdapter, BaseRerankAdapter, BaseSummarizeAdapter, BaseTTSAdapter, BaseTextAdapter, BaseTranscriptionAdapter, BaseVideoAdapter, BaseVoiceAdapter, BaseWorldAdapter, ChatStreamSummarizeAdapter, kind as audioKind, boolean, chat, choice, createRerankOptions, createVoiceOptions, decide, defineAgent, deleteFile, embed, kind$1 as embeddingKind, kind$2 as evaluateKind, fileSourceFromHandle, kind$3 as filesKind, generateAudio, generateImage, generateLiveVideo, generateSpeech, generateTranscription, generateVideo, generateVoice, generateWorld, getFile, getVideoJobStatus, kind$4 as imageKind, listVoices, kind$5 as liveVideoKind, normalizeFileUploadInput, rerank, kind$6 as rerankKind, score, snapToDurationOption, subagentRoute, summarize, kind$7 as summarizeKind, kind$8 as textKind, kind$9 as transcriptionKind, kind$10 as ttsKind, uploadFile, kind$11 as videoKind, kind$12 as voiceKind, kind$13 as worldKind };

package/dist/esm/activities/summarize/chat-stream-summarize.d.ts

@@ -13,6 +13,8 @@ import { StreamChunk, SummarizationOptions, SummarizationResult, TextOptions } f
  * `SummarizationOptions<TProviderOptions>` on the wrapper itself.
  */
 export interface ChatStreamCapable {
+    /** Native token-limit option for adapters whose provider name is user-defined. */
+    readonly maxTokensKey?: string;
     chatStream: (options: TextOptions<any>) => AsyncIterable<AdapterYieldChunk>;
 }
 /**

package/dist/esm/activities/summarize/chat-stream-summarize.js

@@ -91,8 +91,8 @@ function applyDefaultTemperature(adapterName, temperature, modelOptions) {
 }
 /**
 * Resolve `maxLength` to the provider-native max-output-tokens key for the
-* given summarize-adapter `name` (this wrapper's OWN `name`, not the wrapped
-* text adapter's) and merge it into a working copy of the caller's
+* wrapped text adapter's explicit key, falling back to this wrapper's `name`,
+* and merge it into a working copy of the caller's
 * `modelOptions`. The caller always wins: if they already set any recognised
 * token-limit key (flat or, for Ollama, nested `options.num_predict`), the
 * default is left untouched. Unknown/unrecognised adapter names fall back to
@@ -108,9 +108,9 @@ function applyDefaultTemperature(adapterName, temperature, modelOptions) {
 * guaranteeing a cap; the prompt-level hint still asks the model to stay under
 * `maxLength`. Rename the key to the provider-native spelling to forward it.
 */
-function applyMaxLength(adapterName, maxLength, modelOptions) {
+function applyMaxLength(adapterName, maxLength, modelOptions, maxTokensKey) {
 	const merged = { ...modelOptions };
-	if (adapterName === "ollama") {
+	if (adapterName === "ollama" && maxTokensKey === void 0) {
 		const callerSetFlatLimit = KNOWN_MAX_TOKENS_KEYS.some((k) => typeof merged[k] === "number");
 		const existing = merged.options && typeof merged.options === "object" ? merged.options : void 0;
 		if (callerSetFlatLimit || existing && typeof existing.num_predict === "number") return merged;
@@ -120,9 +120,9 @@ function applyMaxLength(adapterName, maxLength, modelOptions) {
 		};
 		return merged;
 	}
-	const key = MAX_TOKENS_KEY_BY_ADAPTER[adapterName];
+	const key = maxTokensKey ?? MAX_TOKENS_KEY_BY_ADAPTER[adapterName];
 	if (key === void 0) return merged;
-	if (KNOWN_MAX_TOKENS_KEYS.some((k) => typeof merged[k] === "number")) return merged;
+	if (typeof merged[key] === "number" || KNOWN_MAX_TOKENS_KEYS.some((k) => typeof merged[k] === "number")) return merged;
 	merged[key] = maxLength;
 	return merged;
 }
@@ -223,8 +223,8 @@ var ChatStreamSummarizeAdapter = class extends BaseSummarizeAdapter {
 		let working = { ...options.modelOptions };
 		working = applyDefaultTemperature(this.name, .3, working);
 		if (options.maxLength !== void 0) {
-			if (!isKnownMaxTokensAdapter(this.name)) options.logger.warn(`summarize: maxLength=${options.maxLength} could not be mapped to a provider token key for adapter name "${this.name}" — it was dropped from modelOptions (the prompt still asks the model to stay under it). Construct ChatStreamSummarizeAdapter with a recognised provider name to forward the cap.`, { provider: this.name });
-			working = applyMaxLength(this.name, options.maxLength, working);
+			if (this.textAdapter.maxTokensKey === void 0 && !isKnownMaxTokensAdapter(this.name)) options.logger.warn(`summarize: maxLength=${options.maxLength} could not be mapped to a provider token key for adapter name "${this.name}" — it was dropped from modelOptions (the prompt still asks the model to stay under it). Construct ChatStreamSummarizeAdapter with a recognised provider name to forward the cap.`, { provider: this.name });
+			working = applyMaxLength(this.name, options.maxLength, working, this.textAdapter.maxTokensKey);
 		}
 		const modelOptions = working;
 		return {

package/dist/esm/activities/summarize/chat-stream-summarize.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-stream-summarize.js","names":[],"sources":["../../../../src/activities/summarize/chat-stream-summarize.ts"],"sourcesContent":["import { EventType } from '@ag-ui/core'\nimport { toRunErrorPayload } from '../error-payload'\nimport { MAX_TOKENS_KEYS } from '../../utilities/sampling-keys'\nimport { rebuildTokenUsage } from '../../utilities/ag-ui-usage'\nimport type { AdapterYieldChunk } from '../../utilities/adapter-yield-chunk'\nimport { tanstackMetadata } from '../../utilities/merge-metadata'\nimport { normalizeStreamChunk } from '../../utilities/normalize-stream-chunk'\nimport { BaseSummarizeAdapter } from './adapter'\nimport type {\n  StreamChunk,\n  SummarizationOptions,\n  SummarizationResult,\n  TextOptions,\n  TokenUsage,\n} from '../../types'\n\nfunction consumeSpecSummarizeChunk(\n  chunk: StreamChunk,\n  state: { summary: string; model: string; usage: TokenUsage },\n): void {\n  if (chunk.type === EventType.TEXT_MESSAGE_CONTENT) {\n    if (chunk.delta) state.summary += chunk.delta\n    return\n  }\n\n  const tanstack = tanstackMetadata(chunk)\n  if (\n    (chunk.type === EventType.RUN_STARTED ||\n      chunk.type === EventType.RUN_FINISHED ||\n      chunk.type === EventType.TEXT_MESSAGE_START) &&\n    typeof tanstack?.model === 'string'\n  ) {\n    state.model = tanstack.model\n  }\n\n  if (chunk.type === EventType.RUN_FINISHED) {\n    const rebuilt = rebuildTokenUsage(chunk.usage, tanstack?.usage)\n    if (rebuilt) state.usage = rebuilt\n  }\n}\n\nfunction throwRunError(\n  chunk: Extract<StreamChunk, { type: 'RUN_ERROR' }>,\n): never {\n  const message =\n    typeof chunk.message === 'string' && chunk.message.length > 0\n      ? chunk.message\n      : 'Summarization failed'\n  const err = new Error(message)\n  if (typeof chunk.code === 'string') {\n    ;(err as Error & { code?: string }).code = chunk.code\n  }\n  throw err\n}\n\n/**\n * Minimal contract for a text adapter that supports `chatStream`. Lets\n * `ChatStreamSummarizeAdapter` work with any text adapter without coupling\n * to a specific implementation.\n *\n * The provider-options shape is intentionally `any` here — the wrapper only\n * forwards `modelOptions` straight through, so a text adapter with a richer\n * per-model options type (e.g. `ResolveProviderOptions<TModel>`) is still\n * acceptable. Summarize-level type safety is enforced via\n * `SummarizationOptions<TProviderOptions>` on the wrapper itself.\n */\nexport interface ChatStreamCapable {\n  chatStream: (options: TextOptions<any>) => AsyncIterable<AdapterYieldChunk>\n}\n\n/**\n * Provider-native max-output-tokens key per summarize-adapter `name`. summarize\n * is provider-agnostic and forwards `modelOptions` opaquely to the wrapped text\n * adapter, so `maxLength` must be written under the exact key the underlying\n * provider reads — no adapter reads a generic `maxTokens`. Ollama is the one\n * exception: it nests sampling under `options`, so it has no entry here and is\n * handled as a special nested case in `applyMaxLength`/`applyDefaultTemperature`.\n *\n * Keep in sync with each adapter's wire mapping:\n * - OpenAI (Responses): `max_output_tokens`\n * - Anthropic / Grok: `max_tokens`\n * - Groq: `max_completion_tokens`\n * - Gemini: `maxOutputTokens`\n * - OpenRouter: `maxCompletionTokens`\n * - LLM Gateway: `max_tokens`\n * - Ollama: nested `options.num_predict` (no entry — see `applyMaxLength`)\n */\nconst MAX_TOKENS_KEY_BY_ADAPTER: Record<string, string> = {\n  openai: 'max_output_tokens',\n  anthropic: 'max_tokens',\n  grok: 'max_tokens',\n  groq: 'max_completion_tokens',\n  gemini: 'maxOutputTokens',\n  openrouter: 'maxCompletionTokens',\n  // LLM Gateway exposes an OpenAI-compatible Chat Completions surface whose\n  // only output cap is `max_tokens` — it does not read `max_completion_tokens`.\n  llmgateway: 'max_tokens',\n  // Workers AI's OpenAI-compatible Chat Completions surface reads `max_tokens`.\n  cloudflare: 'max_tokens',\n}\n\n/**\n * Every flat key any supported provider uses to cap output tokens (plus the\n * generic `maxTokens` spelling no adapter reads). Used to detect a\n * caller-supplied token limit so the summarize default never overrides an\n * explicit caller value. Shared with the OTel middleware via\n * `MAX_TOKENS_KEYS` so the two spelling sets cannot drift.\n */\nconst KNOWN_MAX_TOKENS_KEYS = MAX_TOKENS_KEYS\n\n/**\n * Whether `applyMaxLength` knows how to place a token limit for this adapter\n * `name` (either the nested Ollama shape or a flat provider-native key).\n * Used to surface a warning when `maxLength` would otherwise be silently\n * dropped for an unrecognised adapter name.\n */\nfunction isKnownMaxTokensAdapter(adapterName: string): boolean {\n  return (\n    adapterName === 'ollama' ||\n    MAX_TOKENS_KEY_BY_ADAPTER[adapterName] !== undefined\n  )\n}\n\n/**\n * Apply the low-temperature summarize default to a working copy of the\n * caller's `modelOptions`, placed where the wrapped provider actually reads\n * it (nested under `options` for Ollama, flat otherwise). The caller always\n * wins: if they already set `temperature` in that location, it is untouched.\n */\nfunction applyDefaultTemperature(\n  adapterName: string,\n  temperature: number,\n  modelOptions: Record<string, unknown>,\n): Record<string, unknown> {\n  const merged: Record<string, unknown> = { ...modelOptions }\n\n  if (adapterName === 'ollama') {\n    const existing =\n      merged.options && typeof merged.options === 'object'\n        ? (merged.options as Record<string, unknown>)\n        : undefined\n    if (existing && 'temperature' in existing) return merged\n    merged.options = { temperature, ...existing }\n    return merged\n  }\n\n  if ('temperature' in merged) return merged\n  merged.temperature = temperature\n  return merged\n}\n\n/**\n * Resolve `maxLength` to the provider-native max-output-tokens key for the\n * given summarize-adapter `name` (this wrapper's OWN `name`, not the wrapped\n * text adapter's) and merge it into a working copy of the caller's\n * `modelOptions`. The caller always wins: if they already set any recognised\n * token-limit key (flat or, for Ollama, nested `options.num_predict`), the\n * default is left untouched. Unknown/unrecognised adapter names fall back to\n * NOT setting a token key (the prompt hint still asks the model to stay under\n * `maxLength`) rather than writing a dead key no provider reads.\n *\n * Caveat (intentional): \"caller wins\" keys off ANY recognised spelling in\n * `KNOWN_MAX_TOKENS_KEYS`, but only the adapter's native key is read on the\n * wire. So a caller who sets a NON-native spelling for this provider — e.g.\n * `maxTokens`, or Anthropic's `max_tokens` against an OpenAI adapter — suppresses\n * the summarize default WITHOUT getting their own value applied either: neither\n * cap reaches the wire. This favours never clobbering a migration leftover over\n * guaranteeing a cap; the prompt-level hint still asks the model to stay under\n * `maxLength`. Rename the key to the provider-native spelling to forward it.\n */\nfunction applyMaxLength(\n  adapterName: string,\n  maxLength: number,\n  modelOptions: Record<string, unknown>,\n): Record<string, unknown> {\n  const merged: Record<string, unknown> = { ...modelOptions }\n\n  if (adapterName === 'ollama') {\n    // Honor a caller-set limit in either shape: a recognised flat key (e.g.\n    // left over from a migration) or the nested `options.num_predict`.\n    const callerSetFlatLimit = KNOWN_MAX_TOKENS_KEYS.some(\n      (k) => typeof merged[k] === 'number',\n    )\n    const existing =\n      merged.options && typeof merged.options === 'object'\n        ? (merged.options as Record<string, unknown>)\n        : undefined\n    if (\n      callerSetFlatLimit ||\n      (existing && typeof existing.num_predict === 'number')\n    ) {\n      return merged\n    }\n    merged.options = { num_predict: maxLength, ...existing }\n    return merged\n  }\n\n  const key = MAX_TOKENS_KEY_BY_ADAPTER[adapterName]\n  if (key === undefined) return merged\n\n  const callerSetLimit = KNOWN_MAX_TOKENS_KEYS.some(\n    (k) => typeof merged[k] === 'number',\n  )\n  if (callerSetLimit) return merged\n\n  merged[key] = maxLength\n  return merged\n}\n\n/**\n * Extract the per-model `modelOptions` type a text adapter accepts. Used by\n * provider summarize factories so their `modelOptions` IntelliSense matches\n * what the underlying text adapter actually understands.\n */\nexport type InferTextProviderOptions<TAdapter> = TAdapter extends {\n  '~types': { providerOptions: infer P }\n}\n  ? P extends object\n    ? P\n    : object\n  : object\n\n/**\n * Summarize adapter that wraps any `ChatStreamCapable` text adapter and\n * prompts it for summarization. Not tied to any wire format.\n */\nexport class ChatStreamSummarizeAdapter<\n  TModel extends string,\n  TProviderOptions extends object = Record<string, unknown>,\n> extends BaseSummarizeAdapter<TModel, TProviderOptions> {\n  readonly name: string\n\n  private readonly textAdapter: ChatStreamCapable\n\n  constructor(\n    textAdapter: ChatStreamCapable,\n    model: TModel,\n    name: string = 'chat-stream-summarize',\n  ) {\n    super({}, model)\n    this.name = name\n    this.textAdapter = textAdapter\n  }\n\n  async summarize(\n    options: SummarizationOptions<TProviderOptions>,\n  ): Promise<SummarizationResult> {\n    const systemPrompt = this.buildSummarizationPrompt(options)\n\n    const id = this.generateId()\n    const state = {\n      summary: '',\n      model: options.model,\n      usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },\n    }\n\n    options.logger.request(\n      `activity=summarize provider=${this.name} model=${options.model} text-length=${options.text.length} maxLength=${options.maxLength ?? 'unset'}`,\n      { provider: this.name, model: options.model },\n    )\n\n    try {\n      for await (const raw of this.textAdapter.chatStream(\n        this.buildTextOptions(options, systemPrompt),\n      )) {\n        for (const chunk of normalizeStreamChunk(raw as AdapterYieldChunk)) {\n          // Surface failures: the underlying chatStream emits RUN_ERROR instead\n          // of throwing, so without this branch summarize() would return an\n          // empty summary and pretend a failed run succeeded.\n          if (chunk.type === EventType.RUN_ERROR) throwRunError(chunk)\n          consumeSpecSummarizeChunk(chunk, state)\n        }\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      options.logger.errors(`${this.name}.summarize fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.summarize failed`),\n        source: `${this.name}.summarize`,\n      })\n      throw error\n    }\n\n    return {\n      id,\n      model: state.model,\n      summary: state.summary,\n      usage: state.usage,\n    }\n  }\n\n  override async *summarizeStream(\n    options: SummarizationOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    const systemPrompt = this.buildSummarizationPrompt(options)\n\n    options.logger.request(\n      `activity=summarizeStream provider=${this.name} model=${options.model} text-length=${options.text.length} maxLength=${options.maxLength ?? 'unset'}`,\n      { provider: this.name, model: options.model },\n    )\n\n    const id = this.generateId()\n    const state = {\n      summary: '',\n      model: options.model,\n      usage: {\n        promptTokens: 0,\n        completionTokens: 0,\n        totalTokens: 0,\n      } satisfies SummarizationResult['usage'],\n    }\n\n    try {\n      for await (const raw of this.textAdapter.chatStream(\n        this.buildTextOptions(options, systemPrompt),\n      )) {\n        for (const chunk of normalizeStreamChunk(raw as AdapterYieldChunk)) {\n          // Accumulate the same way `summarize()` does so consumers see deltas\n          // AND the terminal `generation:result` event below carries the same\n          // final summary that non-streaming returns.\n          consumeSpecSummarizeChunk(chunk, state)\n\n          // Emit the GenerationClient-shaped result event just before the\n          // terminal RUN_FINISHED so subscribers (useSummarize) populate\n          // `result` before flipping `status` to success.\n          if (chunk.type === EventType.RUN_FINISHED) {\n            yield {\n              type: EventType.CUSTOM,\n              name: 'generation:result',\n              value: {\n                id,\n                model: state.model,\n                summary: state.summary,\n                usage: state.usage,\n              } satisfies SummarizationResult,\n              timestamp: Date.now(),\n            }\n          }\n\n          yield chunk\n        }\n      }\n    } catch (error: unknown) {\n      options.logger.errors(`${this.name}.summarizeStream fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.summarizeStream failed`),\n        source: `${this.name}.summarizeStream`,\n      })\n      throw error\n    }\n  }\n\n  /**\n   * Build the TextOptions passed to the underlying chatStream. Provider\n   * `modelOptions` from the summarize call are forwarded as-is so knobs like\n   * Anthropic cache headers, Gemini safety settings, or Ollama tuning params\n   * still reach the wire layer.\n   */\n  protected buildTextOptions(\n    options: SummarizationOptions<TProviderOptions>,\n    systemPrompt: string,\n  ): TextOptions<TProviderOptions> {\n    // Sampling knobs now live in provider-native `modelOptions`. Apply the\n    // low-temperature default where the wrapped provider actually reads it\n    // (nested under `options` for Ollama, flat otherwise) so callers can still\n    // override it. Resolving the placement from this summarize adapter's OWN\n    // `name` keeps the default off the wire correctly per provider — a flat\n    // `temperature` would be silently dropped by Ollama while still showing up\n    // in OTel.\n    let working: Record<string, unknown> = {\n      ...(options.modelOptions as Record<string, unknown> | undefined),\n    }\n    working = applyDefaultTemperature(this.name, 0.3, working)\n    // `maxLength` must reach the wire under the provider-native token key (it\n    // differs per provider, and no adapter reads a generic `maxTokens`).\n    // Resolve it from this summarize adapter's `name` (the constructor arg,\n    // not the wrapped text adapter's name), never overriding a caller-supplied\n    // token limit.\n    if (options.maxLength !== undefined) {\n      if (!isKnownMaxTokensAdapter(this.name)) {\n        options.logger.warn(\n          `summarize: maxLength=${options.maxLength} could not be mapped to a provider token key for adapter name \"${this.name}\" — it was dropped from modelOptions (the prompt still asks the model to stay under it). Construct ChatStreamSummarizeAdapter with a recognised provider name to forward the cap.`,\n          { provider: this.name },\n        )\n      }\n      working = applyMaxLength(this.name, options.maxLength, working)\n    }\n    const modelOptions = working as TProviderOptions\n\n    return {\n      model: options.model,\n      messages: [{ role: 'user', content: options.text }],\n      systemPrompts: [systemPrompt],\n      modelOptions,\n      logger: options.logger,\n      // Forward the run identity so the wrapped chat stamps it onto RUN_STARTED\n      // (chat uses `runId` as its `runIdOverride`). Conditional spreads keep the\n      // fields absent when unset, under `exactOptionalPropertyTypes`.\n      ...(options.runId !== undefined ? { runId: options.runId } : {}),\n      ...(options.threadId !== undefined ? { threadId: options.threadId } : {}),\n    }\n  }\n\n  protected buildSummarizationPrompt(\n    options: SummarizationOptions<TProviderOptions>,\n  ): string {\n    let prompt = 'You are a professional summarizer. '\n\n    switch (options.style) {\n      case 'bullet-points':\n        prompt += 'Provide a summary in bullet point format. '\n        break\n      case 'paragraph':\n        prompt += 'Provide a summary in paragraph format. '\n        break\n      case 'concise':\n        prompt += 'Provide a very concise summary in 1-2 sentences. '\n        break\n      case undefined:\n        prompt += 'Provide a clear and concise summary. '\n        break\n      default:\n        prompt += 'Provide a clear and concise summary. '\n    }\n\n    if (options.focus && options.focus.length > 0) {\n      prompt += `Focus on the following aspects: ${options.focus.join(', ')}. `\n    }\n\n    if (options.maxLength) {\n      prompt += `Keep the summary under ${options.maxLength} tokens. `\n    }\n\n    return prompt\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"chat-stream-summarize.js","names":[],"sources":["../../../../src/activities/summarize/chat-stream-summarize.ts"],"sourcesContent":["import { EventType } from '@ag-ui/core'\nimport { toRunErrorPayload } from '../error-payload'\nimport { MAX_TOKENS_KEYS } from '../../utilities/sampling-keys'\nimport { rebuildTokenUsage } from '../../utilities/ag-ui-usage'\nimport type { AdapterYieldChunk } from '../../utilities/adapter-yield-chunk'\nimport { tanstackMetadata } from '../../utilities/merge-metadata'\nimport { normalizeStreamChunk } from '../../utilities/normalize-stream-chunk'\nimport { BaseSummarizeAdapter } from './adapter'\nimport type {\n  StreamChunk,\n  SummarizationOptions,\n  SummarizationResult,\n  TextOptions,\n  TokenUsage,\n} from '../../types'\n\nfunction consumeSpecSummarizeChunk(\n  chunk: StreamChunk,\n  state: { summary: string; model: string; usage: TokenUsage },\n): void {\n  if (chunk.type === EventType.TEXT_MESSAGE_CONTENT) {\n    if (chunk.delta) state.summary += chunk.delta\n    return\n  }\n\n  const tanstack = tanstackMetadata(chunk)\n  if (\n    (chunk.type === EventType.RUN_STARTED ||\n      chunk.type === EventType.RUN_FINISHED ||\n      chunk.type === EventType.TEXT_MESSAGE_START) &&\n    typeof tanstack?.model === 'string'\n  ) {\n    state.model = tanstack.model\n  }\n\n  if (chunk.type === EventType.RUN_FINISHED) {\n    const rebuilt = rebuildTokenUsage(chunk.usage, tanstack?.usage)\n    if (rebuilt) state.usage = rebuilt\n  }\n}\n\nfunction throwRunError(\n  chunk: Extract<StreamChunk, { type: 'RUN_ERROR' }>,\n): never {\n  const message =\n    typeof chunk.message === 'string' && chunk.message.length > 0\n      ? chunk.message\n      : 'Summarization failed'\n  const err = new Error(message)\n  if (typeof chunk.code === 'string') {\n    ;(err as Error & { code?: string }).code = chunk.code\n  }\n  throw err\n}\n\n/**\n * Minimal contract for a text adapter that supports `chatStream`. Lets\n * `ChatStreamSummarizeAdapter` work with any text adapter without coupling\n * to a specific implementation.\n *\n * The provider-options shape is intentionally `any` here — the wrapper only\n * forwards `modelOptions` straight through, so a text adapter with a richer\n * per-model options type (e.g. `ResolveProviderOptions<TModel>`) is still\n * acceptable. Summarize-level type safety is enforced via\n * `SummarizationOptions<TProviderOptions>` on the wrapper itself.\n */\nexport interface ChatStreamCapable {\n  /** Native token-limit option for adapters whose provider name is user-defined. */\n  readonly maxTokensKey?: string\n  chatStream: (options: TextOptions<any>) => AsyncIterable<AdapterYieldChunk>\n}\n\n/**\n * Provider-native max-output-tokens key per summarize-adapter `name`. summarize\n * is provider-agnostic and forwards `modelOptions` opaquely to the wrapped text\n * adapter, so `maxLength` must be written under the exact key the underlying\n * provider reads — no adapter reads a generic `maxTokens`. Ollama is the one\n * exception: it nests sampling under `options`, so it has no entry here and is\n * handled as a special nested case in `applyMaxLength`/`applyDefaultTemperature`.\n *\n * Keep in sync with each adapter's wire mapping:\n * - OpenAI (Responses): `max_output_tokens`\n * - Anthropic / Grok: `max_tokens`\n * - Groq: `max_completion_tokens`\n * - Gemini: `maxOutputTokens`\n * - OpenRouter: `maxCompletionTokens`\n * - LLM Gateway: `max_tokens`\n * - Ollama: nested `options.num_predict` (no entry — see `applyMaxLength`)\n */\nconst MAX_TOKENS_KEY_BY_ADAPTER: Record<string, string> = {\n  openai: 'max_output_tokens',\n  anthropic: 'max_tokens',\n  grok: 'max_tokens',\n  groq: 'max_completion_tokens',\n  gemini: 'maxOutputTokens',\n  openrouter: 'maxCompletionTokens',\n  // LLM Gateway exposes an OpenAI-compatible Chat Completions surface whose\n  // only output cap is `max_tokens` — it does not read `max_completion_tokens`.\n  llmgateway: 'max_tokens',\n  // Workers AI's OpenAI-compatible Chat Completions surface reads `max_tokens`.\n  cloudflare: 'max_tokens',\n}\n\n/**\n * Every flat key any supported provider uses to cap output tokens (plus the\n * generic `maxTokens` spelling no adapter reads). Used to detect a\n * caller-supplied token limit so the summarize default never overrides an\n * explicit caller value. Shared with the OTel middleware via\n * `MAX_TOKENS_KEYS` so the two spelling sets cannot drift.\n */\nconst KNOWN_MAX_TOKENS_KEYS = MAX_TOKENS_KEYS\n\n/**\n * Whether `applyMaxLength` knows how to place a token limit for this adapter\n * `name` (either the nested Ollama shape or a flat provider-native key).\n * Used to surface a warning when `maxLength` would otherwise be silently\n * dropped for an unrecognised adapter name.\n */\nfunction isKnownMaxTokensAdapter(adapterName: string): boolean {\n  return (\n    adapterName === 'ollama' ||\n    MAX_TOKENS_KEY_BY_ADAPTER[adapterName] !== undefined\n  )\n}\n\n/**\n * Apply the low-temperature summarize default to a working copy of the\n * caller's `modelOptions`, placed where the wrapped provider actually reads\n * it (nested under `options` for Ollama, flat otherwise). The caller always\n * wins: if they already set `temperature` in that location, it is untouched.\n */\nfunction applyDefaultTemperature(\n  adapterName: string,\n  temperature: number,\n  modelOptions: Record<string, unknown>,\n): Record<string, unknown> {\n  const merged: Record<string, unknown> = { ...modelOptions }\n\n  if (adapterName === 'ollama') {\n    const existing =\n      merged.options && typeof merged.options === 'object'\n        ? (merged.options as Record<string, unknown>)\n        : undefined\n    if (existing && 'temperature' in existing) return merged\n    merged.options = { temperature, ...existing }\n    return merged\n  }\n\n  if ('temperature' in merged) return merged\n  merged.temperature = temperature\n  return merged\n}\n\n/**\n * Resolve `maxLength` to the provider-native max-output-tokens key for the\n * wrapped text adapter's explicit key, falling back to this wrapper's `name`,\n * and merge it into a working copy of the caller's\n * `modelOptions`. The caller always wins: if they already set any recognised\n * token-limit key (flat or, for Ollama, nested `options.num_predict`), the\n * default is left untouched. Unknown/unrecognised adapter names fall back to\n * NOT setting a token key (the prompt hint still asks the model to stay under\n * `maxLength`) rather than writing a dead key no provider reads.\n *\n * Caveat (intentional): \"caller wins\" keys off ANY recognised spelling in\n * `KNOWN_MAX_TOKENS_KEYS`, but only the adapter's native key is read on the\n * wire. So a caller who sets a NON-native spelling for this provider — e.g.\n * `maxTokens`, or Anthropic's `max_tokens` against an OpenAI adapter — suppresses\n * the summarize default WITHOUT getting their own value applied either: neither\n * cap reaches the wire. This favours never clobbering a migration leftover over\n * guaranteeing a cap; the prompt-level hint still asks the model to stay under\n * `maxLength`. Rename the key to the provider-native spelling to forward it.\n */\nfunction applyMaxLength(\n  adapterName: string,\n  maxLength: number,\n  modelOptions: Record<string, unknown>,\n  maxTokensKey?: string,\n): Record<string, unknown> {\n  const merged: Record<string, unknown> = { ...modelOptions }\n\n  if (adapterName === 'ollama' && maxTokensKey === undefined) {\n    // Honor a caller-set limit in either shape: a recognised flat key (e.g.\n    // left over from a migration) or the nested `options.num_predict`.\n    const callerSetFlatLimit = KNOWN_MAX_TOKENS_KEYS.some(\n      (k) => typeof merged[k] === 'number',\n    )\n    const existing =\n      merged.options && typeof merged.options === 'object'\n        ? (merged.options as Record<string, unknown>)\n        : undefined\n    if (\n      callerSetFlatLimit ||\n      (existing && typeof existing.num_predict === 'number')\n    ) {\n      return merged\n    }\n    merged.options = { num_predict: maxLength, ...existing }\n    return merged\n  }\n\n  const key = maxTokensKey ?? MAX_TOKENS_KEY_BY_ADAPTER[adapterName]\n  if (key === undefined) return merged\n\n  const callerSetLimit =\n    typeof merged[key] === 'number' ||\n    KNOWN_MAX_TOKENS_KEYS.some((k) => typeof merged[k] === 'number')\n  if (callerSetLimit) return merged\n\n  merged[key] = maxLength\n  return merged\n}\n\n/**\n * Extract the per-model `modelOptions` type a text adapter accepts. Used by\n * provider summarize factories so their `modelOptions` IntelliSense matches\n * what the underlying text adapter actually understands.\n */\nexport type InferTextProviderOptions<TAdapter> = TAdapter extends {\n  '~types': { providerOptions: infer P }\n}\n  ? P extends object\n    ? P\n    : object\n  : object\n\n/**\n * Summarize adapter that wraps any `ChatStreamCapable` text adapter and\n * prompts it for summarization. Not tied to any wire format.\n */\nexport class ChatStreamSummarizeAdapter<\n  TModel extends string,\n  TProviderOptions extends object = Record<string, unknown>,\n> extends BaseSummarizeAdapter<TModel, TProviderOptions> {\n  readonly name: string\n\n  private readonly textAdapter: ChatStreamCapable\n\n  constructor(\n    textAdapter: ChatStreamCapable,\n    model: TModel,\n    name: string = 'chat-stream-summarize',\n  ) {\n    super({}, model)\n    this.name = name\n    this.textAdapter = textAdapter\n  }\n\n  async summarize(\n    options: SummarizationOptions<TProviderOptions>,\n  ): Promise<SummarizationResult> {\n    const systemPrompt = this.buildSummarizationPrompt(options)\n\n    const id = this.generateId()\n    const state = {\n      summary: '',\n      model: options.model,\n      usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },\n    }\n\n    options.logger.request(\n      `activity=summarize provider=${this.name} model=${options.model} text-length=${options.text.length} maxLength=${options.maxLength ?? 'unset'}`,\n      { provider: this.name, model: options.model },\n    )\n\n    try {\n      for await (const raw of this.textAdapter.chatStream(\n        this.buildTextOptions(options, systemPrompt),\n      )) {\n        for (const chunk of normalizeStreamChunk(raw as AdapterYieldChunk)) {\n          // Surface failures: the underlying chatStream emits RUN_ERROR instead\n          // of throwing, so without this branch summarize() would return an\n          // empty summary and pretend a failed run succeeded.\n          if (chunk.type === EventType.RUN_ERROR) throwRunError(chunk)\n          consumeSpecSummarizeChunk(chunk, state)\n        }\n      }\n    } catch (error: unknown) {\n      // Narrow before logging: raw SDK errors can carry request metadata\n      // (including auth headers) which we must never surface to user loggers.\n      options.logger.errors(`${this.name}.summarize fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.summarize failed`),\n        source: `${this.name}.summarize`,\n      })\n      throw error\n    }\n\n    return {\n      id,\n      model: state.model,\n      summary: state.summary,\n      usage: state.usage,\n    }\n  }\n\n  override async *summarizeStream(\n    options: SummarizationOptions<TProviderOptions>,\n  ): AsyncIterable<StreamChunk> {\n    const systemPrompt = this.buildSummarizationPrompt(options)\n\n    options.logger.request(\n      `activity=summarizeStream provider=${this.name} model=${options.model} text-length=${options.text.length} maxLength=${options.maxLength ?? 'unset'}`,\n      { provider: this.name, model: options.model },\n    )\n\n    const id = this.generateId()\n    const state = {\n      summary: '',\n      model: options.model,\n      usage: {\n        promptTokens: 0,\n        completionTokens: 0,\n        totalTokens: 0,\n      } satisfies SummarizationResult['usage'],\n    }\n\n    try {\n      for await (const raw of this.textAdapter.chatStream(\n        this.buildTextOptions(options, systemPrompt),\n      )) {\n        for (const chunk of normalizeStreamChunk(raw as AdapterYieldChunk)) {\n          // Accumulate the same way `summarize()` does so consumers see deltas\n          // AND the terminal `generation:result` event below carries the same\n          // final summary that non-streaming returns.\n          consumeSpecSummarizeChunk(chunk, state)\n\n          // Emit the GenerationClient-shaped result event just before the\n          // terminal RUN_FINISHED so subscribers (useSummarize) populate\n          // `result` before flipping `status` to success.\n          if (chunk.type === EventType.RUN_FINISHED) {\n            yield {\n              type: EventType.CUSTOM,\n              name: 'generation:result',\n              value: {\n                id,\n                model: state.model,\n                summary: state.summary,\n                usage: state.usage,\n              } satisfies SummarizationResult,\n              timestamp: Date.now(),\n            }\n          }\n\n          yield chunk\n        }\n      }\n    } catch (error: unknown) {\n      options.logger.errors(`${this.name}.summarizeStream fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.summarizeStream failed`),\n        source: `${this.name}.summarizeStream`,\n      })\n      throw error\n    }\n  }\n\n  /**\n   * Build the TextOptions passed to the underlying chatStream. Provider\n   * `modelOptions` from the summarize call are forwarded as-is so knobs like\n   * Anthropic cache headers, Gemini safety settings, or Ollama tuning params\n   * still reach the wire layer.\n   */\n  protected buildTextOptions(\n    options: SummarizationOptions<TProviderOptions>,\n    systemPrompt: string,\n  ): TextOptions<TProviderOptions> {\n    // Sampling knobs now live in provider-native `modelOptions`. Apply the\n    // low-temperature default where the wrapped provider actually reads it\n    // (nested under `options` for Ollama, flat otherwise) so callers can still\n    // override it. Resolving the placement from this summarize adapter's OWN\n    // `name` keeps the default off the wire correctly per provider — a flat\n    // `temperature` would be silently dropped by Ollama while still showing up\n    // in OTel.\n    let working: Record<string, unknown> = {\n      ...(options.modelOptions as Record<string, unknown> | undefined),\n    }\n    working = applyDefaultTemperature(this.name, 0.3, working)\n    // `maxLength` must reach the wire under the provider-native token key (it\n    // differs per provider, and no adapter reads a generic `maxTokens`).\n    // Prefer the wrapped adapter's explicit key, then this wrapper's name,\n    // never overriding a caller-supplied token limit.\n    if (options.maxLength !== undefined) {\n      if (\n        this.textAdapter.maxTokensKey === undefined &&\n        !isKnownMaxTokensAdapter(this.name)\n      ) {\n        options.logger.warn(\n          `summarize: maxLength=${options.maxLength} could not be mapped to a provider token key for adapter name \"${this.name}\" — it was dropped from modelOptions (the prompt still asks the model to stay under it). Construct ChatStreamSummarizeAdapter with a recognised provider name to forward the cap.`,\n          { provider: this.name },\n        )\n      }\n      working = applyMaxLength(\n        this.name,\n        options.maxLength,\n        working,\n        this.textAdapter.maxTokensKey,\n      )\n    }\n    const modelOptions = working as TProviderOptions\n\n    return {\n      model: options.model,\n      messages: [{ role: 'user', content: options.text }],\n      systemPrompts: [systemPrompt],\n      modelOptions,\n      logger: options.logger,\n      // Forward the run identity so the wrapped chat stamps it onto RUN_STARTED\n      // (chat uses `runId` as its `runIdOverride`). Conditional spreads keep the\n      // fields absent when unset, under `exactOptionalPropertyTypes`.\n      ...(options.runId !== undefined ? { runId: options.runId } : {}),\n      ...(options.threadId !== undefined ? { threadId: options.threadId } : {}),\n    }\n  }\n\n  protected buildSummarizationPrompt(\n    options: SummarizationOptions<TProviderOptions>,\n  ): string {\n    let prompt = 'You are a professional summarizer. '\n\n    switch (options.style) {\n      case 'bullet-points':\n        prompt += 'Provide a summary in bullet point format. '\n        break\n      case 'paragraph':\n        prompt += 'Provide a summary in paragraph format. '\n        break\n      case 'concise':\n        prompt += 'Provide a very concise summary in 1-2 sentences. '\n        break\n      case undefined:\n        prompt += 'Provide a clear and concise summary. '\n        break\n      default:\n        prompt += 'Provide a clear and concise summary. '\n    }\n\n    if (options.focus && options.focus.length > 0) {\n      prompt += `Focus on the following aspects: ${options.focus.join(', ')}. `\n    }\n\n    if (options.maxLength) {\n      prompt += `Keep the summary under ${options.maxLength} tokens. `\n    }\n\n    return prompt\n  }\n}\n"],"mappings":"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"}

package/dist/esm/client.d.ts

@@ -38,7 +38,9 @@ export { restoreInboundChunk } from './utilities/restore-inbound-chunk.js';
 export type { AdapterYieldChunk } from './utilities/adapter-yield-chunk.js';
 export { getChunkRunId, getChunkThreadId } from './utilities/chunk-ids.js';
 export type { WireMessage } from './utilities/ag-ui-wire.js';
-export type { AudioPart, ContentPart, ContentPartDataSource, ContentPartFileSource, SubagentHandleData, SubagentStatus, ContentPartSource, ContentPartUrlSource, CustomEvent, DocumentPart, ImagePart, MediaInputMetadata, MediaInputRole, MediaPrompt, MediaPromptPart, MessagePart, ModelMessage, PersistedArtifactActivity, PersistedArtifactRef, PersistedArtifactRole, Interrupt, RunAgentResumeItem, RunErrorEvent, RunFinishedEvent, RunFinishedOutcome, SchemaInput, StreamChunk, StructuredOutputPart, TextPart, TanStackMessageMetadata, TanStackRunMetadata, ThinkingPart, ToolCall, ToolCallPart, ToolResultPart, UIMessage, UIResourcePart, VideoPart, InferSchemaType, } from './types.js';
+export { fileSourceFromHandle } from './activities/files/index.js';
+export type { FileHandle } from './activities/files/adapter.js';
+export type { AudioPart, ContentPart, ContentPartDataSource, ContentPartFileSource, SubagentHandleData, SubagentStatus, ContentPartSource, ContentPartUrlSource, CustomEvent, DocumentPart, ImagePart, MediaInputMetadata, MediaInputRole, MediaPrompt, MediaPromptPart, MessagePart, ModelMessage, PersistedArtifactActivity, PersistedArtifactRef, PersistedArtifactRole, Interrupt, RunAgentResumeItem, RunErrorEvent, RunFinishedEvent, RunFinishedOutcome, SchemaInput, StreamChunk, StructuredOutputPart, TextPart, TanStackMessageMetadata, TanStackRunMetadata, ThinkingPart, ToolCall, ToolCallPart, ToolResultOutcome, ToolResultPart, UIMessage, UIResourcePart, VideoPart, InferSchemaType, } from './types.js';
 export { INTERRUPT_BINDING_VERSION, canonicalizeInterruptResolutions, } from './interrupts.js';
 export { defineInterrupt, hashInterruptDefinitionSchema, INTERRUPT_PAYLOAD_METADATA_KEY, } from './interrupt-definition.js';
 export { INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, genericInterruptContinuationFromDescriptor, readGenericInterruptContinuation, wrapGenericInterruptContinuation, } from './generic-interrupt-continuation.js';

package/dist/esm/client.js

@@ -13,6 +13,7 @@ import { uiMessagesToWire } from "./utilities/ag-ui-wire.js";
 import { restoreInboundChunk } from "./utilities/restore-inbound-chunk.js";
 import { defineAgent } from "./activities/chat/agents/define-agent.js";
 import { subagentRoute } from "./activities/chat/agents/route.js";
+import { fileSourceFromHandle } from "./activities/files/index.js";
 import { toolDefinition } from "./activities/chat/tools/tool-definition.js";
 import { getChunkRunId, getChunkThreadId } from "./utilities/chunk-ids.js";
 import { PartialJSONParser, defaultJSONParser, parsePartialJSON } from "./activities/chat/stream/json-parser.js";
@@ -123,6 +124,6 @@ async function generationParamsFromRequest(kind, request) {
 	return generationParamsFromBody(kind, body);
 }
 //#endregion
-export { BatchStrategy, CompositeStrategy, EventType, INTERRUPT_BINDING_METADATA_KEY, INTERRUPT_BINDING_VERSION, INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, INTERRUPT_PAYLOAD_METADATA_KEY, ImmediateStrategy, PartialJSONParser, PunctuationStrategy, StreamProcessor, WordBoundaryStrategy, canonicalInterruptJson, canonicalizeInterruptResolutions, cloneAndDeepFreezeJson, convertMessagesToModelMessages, convertSchemaToJsonSchema, defaultJSONParser, defineAgent, defineInterrupt, digestInterruptJson, fromSpecTokenUsage, generateMessageId, generationParamsFromBody, generationParamsFromRequest, genericInterruptContinuationFromDescriptor, getChunkRunId, getChunkThreadId, hashInterruptDefinitionSchema, hashSchemaInput, isStandardSchema, mergeMetadata, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeApprovalSchema, normalizeStreamChunk, normalizeToUIMessage, parsePartialJSON, parseWithStandardSchema, readGenericInterruptContinuation, readInterruptBinding, readUnopenedInterruptBinding, restoreInboundChunk, subagentRoute, tanstackMetadata, toSpecTokenUsage, toolDefinition, uiMessageToModelMessages, uiMessagesToWire, validateWithStandardSchema, withInterruptBinding, withTanstackMetadata, withoutInterruptBinding, wrapGenericInterruptContinuation };
+export { BatchStrategy, CompositeStrategy, EventType, INTERRUPT_BINDING_METADATA_KEY, INTERRUPT_BINDING_VERSION, INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, INTERRUPT_PAYLOAD_METADATA_KEY, ImmediateStrategy, PartialJSONParser, PunctuationStrategy, StreamProcessor, WordBoundaryStrategy, canonicalInterruptJson, canonicalizeInterruptResolutions, cloneAndDeepFreezeJson, convertMessagesToModelMessages, convertSchemaToJsonSchema, defaultJSONParser, defineAgent, defineInterrupt, digestInterruptJson, fileSourceFromHandle, fromSpecTokenUsage, generateMessageId, generationParamsFromBody, generationParamsFromRequest, genericInterruptContinuationFromDescriptor, getChunkRunId, getChunkThreadId, hashInterruptDefinitionSchema, hashSchemaInput, isStandardSchema, mergeMetadata, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeApprovalSchema, normalizeStreamChunk, normalizeToUIMessage, parsePartialJSON, parseWithStandardSchema, readGenericInterruptContinuation, readInterruptBinding, readUnopenedInterruptBinding, restoreInboundChunk, subagentRoute, tanstackMetadata, toSpecTokenUsage, toolDefinition, uiMessageToModelMessages, uiMessagesToWire, validateWithStandardSchema, withInterruptBinding, withTanstackMetadata, withoutInterruptBinding, wrapGenericInterruptContinuation };
 
 //# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../../src/client.ts"],"sourcesContent":["import type {\n  AudioGenerationOptions,\n  ImageGenerationOptions,\n  TTSOptions,\n  TranscriptionOptions,\n  VoiceGenerationOptions,\n  VideoGenerationOptions,\n  WorldGenerationOptions,\n  LiveVideoGenerationOptions,\n} from './types'\n\nexport type GenerationKind =\n  | 'image'\n  | 'audio'\n  | 'tts'\n  | 'voice'\n  | 'video'\n  | 'transcription'\n  | 'world'\n  | 'liveVideo'\n\ntype GenerationInputByKind = {\n  image: Omit<ImageGenerationOptions, 'logger' | 'model'>\n  audio: Omit<AudioGenerationOptions, 'logger' | 'model'>\n  tts: Omit<TTSOptions, 'logger' | 'model'>\n  voice: Omit<VoiceGenerationOptions, 'logger' | 'model'>\n  video: Omit<VideoGenerationOptions, 'logger' | 'model'>\n  transcription: Omit<TranscriptionOptions, 'logger' | 'model'>\n  world: Omit<WorldGenerationOptions, 'logger' | 'model'>\n  liveVideo: Omit<LiveVideoGenerationOptions, 'logger' | 'model'>\n}\n\nexport interface GenerationParams<TKind extends GenerationKind> {\n  input: GenerationInputByKind[TKind]\n  forwardedProps: Record<string, unknown>\n  threadId?: string\n  runId?: string\n}\n\nconst generationKinds = [\n  'image',\n  'audio',\n  'tts',\n  'voice',\n  'video',\n  'transcription',\n  'world',\n  'liveVideo',\n] as const satisfies ReadonlyArray<GenerationKind>\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction hasOwnKey(value: Record<string, unknown>, key: string): boolean {\n  return Object.prototype.hasOwnProperty.call(value, key)\n}\n\nfunction isGenerationEnvelope(body: unknown): body is Record<string, unknown> {\n  return (\n    isRecord(body) &&\n    (hasOwnKey(body, 'data') || hasOwnKey(body, 'forwardedProps'))\n  )\n}\n\nfunction assertGenerationKind(kind: unknown): asserts kind is GenerationKind {\n  if (!generationKinds.includes(kind as GenerationKind)) {\n    throw new Error(\n      `Unsupported generation kind: ${String(\n        kind,\n      )}. Expected one of ${generationKinds.join(', ')}.`,\n    )\n  }\n}\n\n/**\n * The input field(s) that identify a generation body for a kind. Most kinds\n * have exactly one; `voice` accepts either of its two creation modes, so any\n * one of its keys is enough.\n */\nfunction requiredKeysForKind(kind: GenerationKind): Array<string> {\n  // Enumerated rather than defaulted so a new generation kind has to declare\n  // the field that identifies its body instead of silently inheriting\n  // `prompt`.\n  switch (kind) {\n    case 'tts':\n      return ['text']\n    case 'transcription':\n      return ['audio']\n    case 'voice':\n      return ['prompt', 'referenceAudio']\n    case 'image':\n    case 'audio':\n    case 'video':\n    case 'world':\n    case 'liveVideo':\n      return ['prompt']\n  }\n}\n\nfunction assertInputForKind(\n  kind: GenerationKind,\n  input: unknown,\n): asserts input is GenerationInputByKind[GenerationKind] {\n  if (!isRecord(input)) {\n    throw new Error(`Generation ${kind} input must be an object.`)\n  }\n\n  const requiredKeys = requiredKeysForKind(kind)\n\n  if (!requiredKeys.some((key) => hasOwnKey(input, key))) {\n    throw new Error(\n      `Generation ${kind} input must include ${requiredKeys.join(' or ')}.`,\n    )\n  }\n}\n\nfunction isInputForKind(kind: GenerationKind, input: unknown): boolean {\n  if (!isRecord(input)) return false\n\n  return requiredKeysForKind(kind).some((key) => hasOwnKey(input, key))\n}\n\nfunction forwardedPropsFromEnvelope(\n  envelope: Record<string, unknown>,\n): Record<string, unknown> {\n  if (!hasOwnKey(envelope, 'forwardedProps')) {\n    return {}\n  }\n\n  if (!isRecord(envelope.forwardedProps)) {\n    throw new Error('Generation envelope forwardedProps must be an object.')\n  }\n\n  return envelope.forwardedProps\n}\n\nfunction optionalStringField(\n  envelope: Record<string, unknown>,\n  key: 'threadId' | 'runId',\n): string | undefined {\n  if (!hasOwnKey(envelope, key)) {\n    return undefined\n  }\n\n  const value = envelope[key]\n  if (typeof value !== 'string') {\n    throw new Error(`Generation envelope ${key} must be a string.`)\n  }\n\n  return value\n}\n\nfunction generationIdentityFields(envelope: Record<string, unknown>): {\n  threadId?: string\n  runId?: string\n} {\n  const identity: {\n    threadId?: string\n    runId?: string\n  } = {}\n  const threadId = optionalStringField(envelope, 'threadId')\n  const runId = optionalStringField(envelope, 'runId')\n\n  if (threadId !== undefined) identity.threadId = threadId\n  if (runId !== undefined) identity.runId = runId\n\n  return identity\n}\n\nexport function generationParamsFromBody<TKind extends GenerationKind>(\n  kind: TKind,\n  body: unknown,\n): GenerationParams<TKind> {\n  assertGenerationKind(kind)\n\n  if (isInputForKind(kind, body)) {\n    assertInputForKind(kind, body)\n    return {\n      input: body as GenerationInputByKind[TKind],\n      forwardedProps: {},\n    }\n  }\n\n  if (!isGenerationEnvelope(body)) {\n    assertInputForKind(kind, body)\n    return {\n      input: body as GenerationInputByKind[TKind],\n      forwardedProps: {},\n    }\n  }\n\n  if (!hasOwnKey(body, 'data')) {\n    throw new Error(`Generation ${kind} envelope must include data.`)\n  }\n\n  const input = body.data\n  assertInputForKind(kind, input)\n\n  const forwardedProps = forwardedPropsFromEnvelope(body)\n\n  return {\n    input: input as GenerationInputByKind[TKind],\n    forwardedProps,\n    ...generationIdentityFields(body),\n  }\n}\n\nexport async function generationParamsFromRequest<TKind extends GenerationKind>(\n  kind: TKind,\n  request: Request,\n): Promise<GenerationParams<TKind>> {\n  let body: unknown\n  try {\n    body = await request.json()\n  } catch (error) {\n    throw new Error('Invalid JSON request body.', { cause: error })\n  }\n\n  if (!isRecord(body)) {\n    throw new Error('Generation request body must be a JSON object.')\n  }\n\n  return generationParamsFromBody(kind, body)\n}\n\nexport { EventType } from '@ag-ui/core'\n\nexport {\n  defineAgent,\n  type DefinedAgent,\n  type SubagentChoiceOptions,\n  type SubagentRunContext,\n} from './activities/chat/agents/define-agent'\nexport {\n  subagentRoute,\n  type SubagentRouteOptions,\n} from './activities/chat/agents/route'\nexport type {\n  SubagentOrder,\n  SubagentRouterPick,\n  SubagentRouterPlan,\n  SubagentStep,\n  SubagentStepsPlan,\n} from './activities/chat/agents/spawn'\n\nexport {\n  toolDefinition,\n  type AnyClientTool,\n  type ClientTool,\n  type InferToolInput,\n  type InferToolName,\n  type InferToolOutput,\n  type ApprovalCapabilityOf,\n  type ApprovalSchemaConfig,\n  type ApprovalSchemaOf,\n  type InputSchemaOf,\n  type OutputSchemaOf,\n  type NoSchema,\n  type ToolDefinition,\n  type ToolDefinitionConfig,\n  type ToolDefinitionInstance,\n} from './activities/chat/tools/tool-definition'\n\nexport {\n  hashSchemaInput,\n  normalizeApprovalSchema,\n  type NormalizedApprovalSchema,\n  type NormalizedSchemaInput,\n} from './activities/chat/tools/approval-schema'\n\nexport {\n  canonicalInterruptJson,\n  cloneAndDeepFreezeJson,\n  digestInterruptJson,\n} from './interrupt-serialization'\n\nexport {\n  convertSchemaToJsonSchema,\n  isStandardSchema,\n  parseWithStandardSchema,\n  validateWithStandardSchema,\n} from './activities/chat/tools/schema-converter'\n\nexport {\n  convertMessagesToModelMessages,\n  generateMessageId,\n  modelMessageToUIMessage,\n  modelMessagesToUIMessages,\n  normalizeToUIMessage,\n  uiMessageToModelMessages,\n} from './activities/chat/messages'\n\nexport {\n  BatchStrategy,\n  CompositeStrategy,\n  defaultJSONParser,\n  ImmediateStrategy,\n  parsePartialJSON,\n  PartialJSONParser,\n  PunctuationStrategy,\n  StreamProcessor,\n  WordBoundaryStrategy,\n} from './activities/chat/stream/index'\nexport type {\n  ChunkRecording,\n  ChunkStrategy,\n  InternalToolCallState,\n  JSONParser,\n  ProcessorResult,\n  ProcessorState,\n  StreamProcessorEvents,\n  StreamProcessorOptions,\n  ToolCallState,\n  ToolResultState,\n} from './activities/chat/stream/index'\n\nexport { uiMessagesToWire } from './utilities/ag-ui-wire'\nexport {\n  mergeMetadata,\n  tanstackMetadata,\n  withTanstackMetadata,\n} from './utilities/merge-metadata'\nexport { fromSpecTokenUsage, toSpecTokenUsage } from './utilities/ag-ui-usage'\nexport type { SpecTokenUsage } from './utilities/ag-ui-usage'\nexport { normalizeStreamChunk } from './utilities/normalize-stream-chunk'\nexport { restoreInboundChunk } from './utilities/restore-inbound-chunk'\nexport type { AdapterYieldChunk } from './utilities/adapter-yield-chunk'\nexport { getChunkRunId, getChunkThreadId } from './utilities/chunk-ids'\nexport type { WireMessage } from './utilities/ag-ui-wire'\n\nexport type {\n  AudioPart,\n  ContentPart,\n  ContentPartDataSource,\n  ContentPartFileSource,\n  SubagentHandleData,\n  SubagentStatus,\n  ContentPartSource,\n  ContentPartUrlSource,\n  CustomEvent,\n  DocumentPart,\n  ImagePart,\n  MediaInputMetadata,\n  MediaInputRole,\n  MediaPrompt,\n  MediaPromptPart,\n  MessagePart,\n  ModelMessage,\n  PersistedArtifactActivity,\n  PersistedArtifactRef,\n  PersistedArtifactRole,\n  Interrupt,\n  RunAgentResumeItem,\n  RunErrorEvent,\n  RunFinishedEvent,\n  RunFinishedOutcome,\n  SchemaInput,\n  StreamChunk,\n  StructuredOutputPart,\n  TextPart,\n  TanStackMessageMetadata,\n  TanStackRunMetadata,\n  ThinkingPart,\n  ToolCall,\n  ToolCallPart,\n  ToolResultPart,\n  UIMessage,\n  UIResourcePart,\n  VideoPart,\n  InferSchemaType,\n} from './types'\n\n// Enumerated, not `export *` — see the matching note in `index.ts`. The\n// interrupt protocol surface is a commitment, so it is published field by\n// field.\nexport {\n  INTERRUPT_BINDING_VERSION,\n  canonicalizeInterruptResolutions,\n} from './interrupts'\nexport {\n  defineInterrupt,\n  hashInterruptDefinitionSchema,\n  INTERRUPT_PAYLOAD_METADATA_KEY,\n} from './interrupt-definition'\nexport {\n  INTERRUPT_CONTINUATION_METADATA_KEY,\n  INTERRUPT_CONTINUATION_VERSION,\n  genericInterruptContinuationFromDescriptor,\n  readGenericInterruptContinuation,\n  wrapGenericInterruptContinuation,\n} from './generic-interrupt-continuation'\nexport type {\n  GenericInterruptContinuation,\n  GenericInterruptContinuationReadResult,\n} from './generic-interrupt-continuation'\nexport type {\n  GenericInterruptRequest,\n  InterruptDefinition,\n} from './interrupt-definition'\nexport type {\n  BatchInterruptError,\n  BatchInterruptErrorCode,\n  InterruptBinding,\n  InterruptCorrelation,\n  InterruptSubmissionError,\n  ItemInterruptError,\n  ItemInterruptErrorCode,\n  ToolApprovalResolution,\n  UnopenedInterruptBinding,\n} from './interrupts'\n\nexport {\n  INTERRUPT_BINDING_METADATA_KEY,\n  readInterruptBinding,\n  readUnopenedInterruptBinding,\n  withInterruptBinding,\n  withoutInterruptBinding,\n} from './interrupt-resume'\n\nexport type {\n  AudioVisualization,\n  RealtimeAdapter,\n  RealtimeConnection,\n  RealtimeError,\n  RealtimeErrorCode,\n  RealtimeEvent,\n  RealtimeEventHandler,\n  RealtimeEventPayloads,\n  RealtimeMessage,\n  RealtimeMessagePart,\n  RealtimeMode,\n  RealtimeSessionConfig,\n  RealtimeStatus,\n  RealtimeToken,\n  RealtimeAudioPart,\n  RealtimeImagePart,\n  RealtimeTextPart,\n  RealtimeToolCallPart,\n  RealtimeToolResultPart,\n  VADConfig,\n} from './realtime/types'\n"],"mappings":"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"}
+{"version":3,"file":"client.js","names":[],"sources":["../../src/client.ts"],"sourcesContent":["import type {\n  AudioGenerationOptions,\n  ImageGenerationOptions,\n  TTSOptions,\n  TranscriptionOptions,\n  VoiceGenerationOptions,\n  VideoGenerationOptions,\n  WorldGenerationOptions,\n  LiveVideoGenerationOptions,\n} from './types'\n\nexport type GenerationKind =\n  | 'image'\n  | 'audio'\n  | 'tts'\n  | 'voice'\n  | 'video'\n  | 'transcription'\n  | 'world'\n  | 'liveVideo'\n\ntype GenerationInputByKind = {\n  image: Omit<ImageGenerationOptions, 'logger' | 'model'>\n  audio: Omit<AudioGenerationOptions, 'logger' | 'model'>\n  tts: Omit<TTSOptions, 'logger' | 'model'>\n  voice: Omit<VoiceGenerationOptions, 'logger' | 'model'>\n  video: Omit<VideoGenerationOptions, 'logger' | 'model'>\n  transcription: Omit<TranscriptionOptions, 'logger' | 'model'>\n  world: Omit<WorldGenerationOptions, 'logger' | 'model'>\n  liveVideo: Omit<LiveVideoGenerationOptions, 'logger' | 'model'>\n}\n\nexport interface GenerationParams<TKind extends GenerationKind> {\n  input: GenerationInputByKind[TKind]\n  forwardedProps: Record<string, unknown>\n  threadId?: string\n  runId?: string\n}\n\nconst generationKinds = [\n  'image',\n  'audio',\n  'tts',\n  'voice',\n  'video',\n  'transcription',\n  'world',\n  'liveVideo',\n] as const satisfies ReadonlyArray<GenerationKind>\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction hasOwnKey(value: Record<string, unknown>, key: string): boolean {\n  return Object.prototype.hasOwnProperty.call(value, key)\n}\n\nfunction isGenerationEnvelope(body: unknown): body is Record<string, unknown> {\n  return (\n    isRecord(body) &&\n    (hasOwnKey(body, 'data') || hasOwnKey(body, 'forwardedProps'))\n  )\n}\n\nfunction assertGenerationKind(kind: unknown): asserts kind is GenerationKind {\n  if (!generationKinds.includes(kind as GenerationKind)) {\n    throw new Error(\n      `Unsupported generation kind: ${String(\n        kind,\n      )}. Expected one of ${generationKinds.join(', ')}.`,\n    )\n  }\n}\n\n/**\n * The input field(s) that identify a generation body for a kind. Most kinds\n * have exactly one; `voice` accepts either of its two creation modes, so any\n * one of its keys is enough.\n */\nfunction requiredKeysForKind(kind: GenerationKind): Array<string> {\n  // Enumerated rather than defaulted so a new generation kind has to declare\n  // the field that identifies its body instead of silently inheriting\n  // `prompt`.\n  switch (kind) {\n    case 'tts':\n      return ['text']\n    case 'transcription':\n      return ['audio']\n    case 'voice':\n      return ['prompt', 'referenceAudio']\n    case 'image':\n    case 'audio':\n    case 'video':\n    case 'world':\n    case 'liveVideo':\n      return ['prompt']\n  }\n}\n\nfunction assertInputForKind(\n  kind: GenerationKind,\n  input: unknown,\n): asserts input is GenerationInputByKind[GenerationKind] {\n  if (!isRecord(input)) {\n    throw new Error(`Generation ${kind} input must be an object.`)\n  }\n\n  const requiredKeys = requiredKeysForKind(kind)\n\n  if (!requiredKeys.some((key) => hasOwnKey(input, key))) {\n    throw new Error(\n      `Generation ${kind} input must include ${requiredKeys.join(' or ')}.`,\n    )\n  }\n}\n\nfunction isInputForKind(kind: GenerationKind, input: unknown): boolean {\n  if (!isRecord(input)) return false\n\n  return requiredKeysForKind(kind).some((key) => hasOwnKey(input, key))\n}\n\nfunction forwardedPropsFromEnvelope(\n  envelope: Record<string, unknown>,\n): Record<string, unknown> {\n  if (!hasOwnKey(envelope, 'forwardedProps')) {\n    return {}\n  }\n\n  if (!isRecord(envelope.forwardedProps)) {\n    throw new Error('Generation envelope forwardedProps must be an object.')\n  }\n\n  return envelope.forwardedProps\n}\n\nfunction optionalStringField(\n  envelope: Record<string, unknown>,\n  key: 'threadId' | 'runId',\n): string | undefined {\n  if (!hasOwnKey(envelope, key)) {\n    return undefined\n  }\n\n  const value = envelope[key]\n  if (typeof value !== 'string') {\n    throw new Error(`Generation envelope ${key} must be a string.`)\n  }\n\n  return value\n}\n\nfunction generationIdentityFields(envelope: Record<string, unknown>): {\n  threadId?: string\n  runId?: string\n} {\n  const identity: {\n    threadId?: string\n    runId?: string\n  } = {}\n  const threadId = optionalStringField(envelope, 'threadId')\n  const runId = optionalStringField(envelope, 'runId')\n\n  if (threadId !== undefined) identity.threadId = threadId\n  if (runId !== undefined) identity.runId = runId\n\n  return identity\n}\n\nexport function generationParamsFromBody<TKind extends GenerationKind>(\n  kind: TKind,\n  body: unknown,\n): GenerationParams<TKind> {\n  assertGenerationKind(kind)\n\n  if (isInputForKind(kind, body)) {\n    assertInputForKind(kind, body)\n    return {\n      input: body as GenerationInputByKind[TKind],\n      forwardedProps: {},\n    }\n  }\n\n  if (!isGenerationEnvelope(body)) {\n    assertInputForKind(kind, body)\n    return {\n      input: body as GenerationInputByKind[TKind],\n      forwardedProps: {},\n    }\n  }\n\n  if (!hasOwnKey(body, 'data')) {\n    throw new Error(`Generation ${kind} envelope must include data.`)\n  }\n\n  const input = body.data\n  assertInputForKind(kind, input)\n\n  const forwardedProps = forwardedPropsFromEnvelope(body)\n\n  return {\n    input: input as GenerationInputByKind[TKind],\n    forwardedProps,\n    ...generationIdentityFields(body),\n  }\n}\n\nexport async function generationParamsFromRequest<TKind extends GenerationKind>(\n  kind: TKind,\n  request: Request,\n): Promise<GenerationParams<TKind>> {\n  let body: unknown\n  try {\n    body = await request.json()\n  } catch (error) {\n    throw new Error('Invalid JSON request body.', { cause: error })\n  }\n\n  if (!isRecord(body)) {\n    throw new Error('Generation request body must be a JSON object.')\n  }\n\n  return generationParamsFromBody(kind, body)\n}\n\nexport { EventType } from '@ag-ui/core'\n\nexport {\n  defineAgent,\n  type DefinedAgent,\n  type SubagentChoiceOptions,\n  type SubagentRunContext,\n} from './activities/chat/agents/define-agent'\nexport {\n  subagentRoute,\n  type SubagentRouteOptions,\n} from './activities/chat/agents/route'\nexport type {\n  SubagentOrder,\n  SubagentRouterPick,\n  SubagentRouterPlan,\n  SubagentStep,\n  SubagentStepsPlan,\n} from './activities/chat/agents/spawn'\n\nexport {\n  toolDefinition,\n  type AnyClientTool,\n  type ClientTool,\n  type InferToolInput,\n  type InferToolName,\n  type InferToolOutput,\n  type ApprovalCapabilityOf,\n  type ApprovalSchemaConfig,\n  type ApprovalSchemaOf,\n  type InputSchemaOf,\n  type OutputSchemaOf,\n  type NoSchema,\n  type ToolDefinition,\n  type ToolDefinitionConfig,\n  type ToolDefinitionInstance,\n} from './activities/chat/tools/tool-definition'\n\nexport {\n  hashSchemaInput,\n  normalizeApprovalSchema,\n  type NormalizedApprovalSchema,\n  type NormalizedSchemaInput,\n} from './activities/chat/tools/approval-schema'\n\nexport {\n  canonicalInterruptJson,\n  cloneAndDeepFreezeJson,\n  digestInterruptJson,\n} from './interrupt-serialization'\n\nexport {\n  convertSchemaToJsonSchema,\n  isStandardSchema,\n  parseWithStandardSchema,\n  validateWithStandardSchema,\n} from './activities/chat/tools/schema-converter'\n\nexport {\n  convertMessagesToModelMessages,\n  generateMessageId,\n  modelMessageToUIMessage,\n  modelMessagesToUIMessages,\n  normalizeToUIMessage,\n  uiMessageToModelMessages,\n} from './activities/chat/messages'\n\nexport {\n  BatchStrategy,\n  CompositeStrategy,\n  defaultJSONParser,\n  ImmediateStrategy,\n  parsePartialJSON,\n  PartialJSONParser,\n  PunctuationStrategy,\n  StreamProcessor,\n  WordBoundaryStrategy,\n} from './activities/chat/stream/index'\nexport type {\n  ChunkRecording,\n  ChunkStrategy,\n  InternalToolCallState,\n  JSONParser,\n  ProcessorResult,\n  ProcessorState,\n  StreamProcessorEvents,\n  StreamProcessorOptions,\n  ToolCallState,\n  ToolResultState,\n} from './activities/chat/stream/index'\n\nexport { uiMessagesToWire } from './utilities/ag-ui-wire'\nexport {\n  mergeMetadata,\n  tanstackMetadata,\n  withTanstackMetadata,\n} from './utilities/merge-metadata'\nexport { fromSpecTokenUsage, toSpecTokenUsage } from './utilities/ag-ui-usage'\nexport type { SpecTokenUsage } from './utilities/ag-ui-usage'\nexport { normalizeStreamChunk } from './utilities/normalize-stream-chunk'\nexport { restoreInboundChunk } from './utilities/restore-inbound-chunk'\nexport type { AdapterYieldChunk } from './utilities/adapter-yield-chunk'\nexport { getChunkRunId, getChunkThreadId } from './utilities/chunk-ids'\nexport type { WireMessage } from './utilities/ag-ui-wire'\n\n// A browser client that received an uploaded handle from its server can build\n// the `{ type: 'file' }` content source itself — `fileSourceFromHandle` is a\n// pure object builder, so exporting it here keeps the documented client flow\n// from pulling in the server entry.\nexport { fileSourceFromHandle } from './activities/files/index'\nexport type { FileHandle } from './activities/files/adapter'\n\nexport type {\n  AudioPart,\n  ContentPart,\n  ContentPartDataSource,\n  ContentPartFileSource,\n  SubagentHandleData,\n  SubagentStatus,\n  ContentPartSource,\n  ContentPartUrlSource,\n  CustomEvent,\n  DocumentPart,\n  ImagePart,\n  MediaInputMetadata,\n  MediaInputRole,\n  MediaPrompt,\n  MediaPromptPart,\n  MessagePart,\n  ModelMessage,\n  PersistedArtifactActivity,\n  PersistedArtifactRef,\n  PersistedArtifactRole,\n  Interrupt,\n  RunAgentResumeItem,\n  RunErrorEvent,\n  RunFinishedEvent,\n  RunFinishedOutcome,\n  SchemaInput,\n  StreamChunk,\n  StructuredOutputPart,\n  TextPart,\n  TanStackMessageMetadata,\n  TanStackRunMetadata,\n  ThinkingPart,\n  ToolCall,\n  ToolCallPart,\n  ToolResultOutcome,\n  ToolResultPart,\n  UIMessage,\n  UIResourcePart,\n  VideoPart,\n  InferSchemaType,\n} from './types'\n\n// Enumerated, not `export *` — see the matching note in `index.ts`. The\n// interrupt protocol surface is a commitment, so it is published field by\n// field.\nexport {\n  INTERRUPT_BINDING_VERSION,\n  canonicalizeInterruptResolutions,\n} from './interrupts'\nexport {\n  defineInterrupt,\n  hashInterruptDefinitionSchema,\n  INTERRUPT_PAYLOAD_METADATA_KEY,\n} from './interrupt-definition'\nexport {\n  INTERRUPT_CONTINUATION_METADATA_KEY,\n  INTERRUPT_CONTINUATION_VERSION,\n  genericInterruptContinuationFromDescriptor,\n  readGenericInterruptContinuation,\n  wrapGenericInterruptContinuation,\n} from './generic-interrupt-continuation'\nexport type {\n  GenericInterruptContinuation,\n  GenericInterruptContinuationReadResult,\n} from './generic-interrupt-continuation'\nexport type {\n  GenericInterruptRequest,\n  InterruptDefinition,\n} from './interrupt-definition'\nexport type {\n  BatchInterruptError,\n  BatchInterruptErrorCode,\n  InterruptBinding,\n  InterruptCorrelation,\n  InterruptSubmissionError,\n  ItemInterruptError,\n  ItemInterruptErrorCode,\n  ToolApprovalResolution,\n  UnopenedInterruptBinding,\n} from './interrupts'\n\nexport {\n  INTERRUPT_BINDING_METADATA_KEY,\n  readInterruptBinding,\n  readUnopenedInterruptBinding,\n  withInterruptBinding,\n  withoutInterruptBinding,\n} from './interrupt-resume'\n\nexport type {\n  AudioVisualization,\n  RealtimeAdapter,\n  RealtimeConnection,\n  RealtimeError,\n  RealtimeErrorCode,\n  RealtimeEvent,\n  RealtimeEventHandler,\n  RealtimeEventPayloads,\n  RealtimeMessage,\n  RealtimeMessagePart,\n  RealtimeMode,\n  RealtimeSessionConfig,\n  RealtimeStatus,\n  RealtimeToken,\n  RealtimeAudioPart,\n  RealtimeImagePart,\n  RealtimeTextPart,\n  RealtimeToolCallPart,\n  RealtimeToolResultPart,\n  VADConfig,\n} from './realtime/types'\n"],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -1,4 +1,4 @@
-export { chat, summarize, rerank, decide, choice, score, boolean, generateImage, generateAudio, generateVideo, getVideoJobStatus, generateSpeech, listVoices, generateVoice, generateTranscription, embed, generateWorld, generateLiveVideo, } from './activities/index.js';
+export { chat, summarize, rerank, decide, choice, score, boolean, generateImage, generateAudio, generateVideo, getVideoJobStatus, generateSpeech, listVoices, generateVoice, generateTranscription, embed, generateWorld, generateLiveVideo, uploadFile, getFile, deleteFile, fileSourceFromHandle, } from './activities/index.js';
 export { createChatOptions } from './activities/chat/index.js';
 export { createSummarizeOptions } from './activities/summarize/index.js';
 export { createRerankOptions } from './activities/rerank/index.js';
@@ -11,7 +11,7 @@ export { createTranscriptionOptions } from './activities/generateTranscription/i
 export { createEmbedOptions } from './activities/embed/index.js';
 export { createWorldOptions } from './activities/generateWorld/index.js';
 export { createLiveVideoOptions } from './activities/generateLiveVideo/index.js';
-export type { AIAdapter, ImageAdapter, AnyImageAdapter, TextAdapter, AnyTextAdapter, AnySummarizeAdapter, SummarizeAdapter, AnyAudioAdapter, AudioAdapter, AnyTTSAdapter, TTSAdapter, TTSCapabilities, AnyVoiceAdapter, VoiceAdapter, AnyTranscriptionAdapter, TranscriptionAdapter, AnyVideoAdapter, VideoAdapter, AnyEmbeddingAdapter, EmbeddingAdapter, AnyRerankAdapter, RerankAdapter, AnyEvaluateAdapter, EvaluateAdapter, ChoiceAnswer, ScoreAnswer, BooleanAnswer, EvaluateResult, WireQuestion, WireAnswer, AnyWorldAdapter, WorldAdapter, AnyLiveVideoAdapter, LiveVideoAdapter, } from './activities/index.js';
+export type { AIAdapter, ImageAdapter, AnyImageAdapter, TextAdapter, AnyTextAdapter, AnySummarizeAdapter, SummarizeAdapter, AnyAudioAdapter, AudioAdapter, AnyTTSAdapter, TTSAdapter, TTSCapabilities, AnyVoiceAdapter, VoiceAdapter, AnyTranscriptionAdapter, TranscriptionAdapter, AnyVideoAdapter, VideoAdapter, AnyEmbeddingAdapter, EmbeddingAdapter, AnyRerankAdapter, RerankAdapter, AnyEvaluateAdapter, EvaluateAdapter, ChoiceAnswer, ScoreAnswer, BooleanAnswer, EvaluateResult, WireQuestion, WireAnswer, AnyWorldAdapter, WorldAdapter, AnyLiveVideoAdapter, LiveVideoAdapter, FilesAdapter, AnyFilesAdapter, FileHandle, FileUploadInput, } from './activities/index.js';
 export { BaseRerankAdapter } from './activities/rerank/adapter.js';
 export { BaseEvaluateAdapter } from './activities/evaluate/adapter.js';
 export { defineAgent, type DefinedAgent, type SubagentChoiceOptions, type SubagentRunContext, } from './activities/chat/agents/define-agent.js';
@@ -86,7 +86,8 @@ export { normalizeStreamChunk } from './utilities/normalize-stream-chunk.js';
 export type { AdapterYieldChunk } from './utilities/adapter-yield-chunk.js';
 export { getChunkRunId, getChunkThreadId } from './utilities/chunk-ids.js';
 export type { WireMessage } from './utilities/ag-ui-wire.js';
-export { isContentPart, isContentPartArray, normalizeToolResult, } from './utilities/tool-result.js';
+export { isContentPart, isContentPartArray, isToolResultOutcome, normalizeToolResult, } from './utilities/tool-result.js';
+export { assertMessagesFileSourceSupport, assertPromptFileSourceSupport, fileReferenceFor, isFileSource, unsupportedFileSourceError, type FileSourceCapable, } from './utilities/content-source.js';
 export { getProviderExecutedMetadata, isProviderExecutedToolCall, } from './utilities/provider-executed.js';
 export { createModel, extendAdapter } from './extend-adapter.js';
 export type { ExtendedModelDef, ModelCapabilities } from './extend-adapter.js';

package/dist/esm/index.js

@@ -17,11 +17,12 @@ import { hashSchemaInput, normalizeApprovalSchema } from "./activities/chat/tool
 import { INTERRUPT_BINDING_METADATA_KEY, InterruptResumeValidationError, interruptItemError, readInterruptBinding, readUnopenedInterruptBinding, validateInterruptResumeBatch, withInterruptBinding, withoutInterruptBinding } from "./interrupt-resume.js";
 import { INTERRUPT_PAYLOAD_METADATA_KEY, createInterruptBinding, defineInterrupt } from "./interrupt-definition.js";
 import { INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, genericInterruptContinuationFromDescriptor, readGenericInterruptContinuation, wrapGenericInterruptContinuation } from "./generic-interrupt-continuation.js";
-import { isContentPart, isContentPartArray, normalizeToolResult } from "./utilities/tool-result.js";
-import { subagentHostMessageId, wireSubagentInfo } from "./utilities/subagent-wire.js";
 import { getProviderExecutedMetadata, isProviderExecutedToolCall } from "./utilities/provider-executed.js";
+import { isContentPart, isContentPartArray, isToolResultOutcome, normalizeToolResult } from "./utilities/tool-result.js";
+import { subagentHostMessageId, wireSubagentInfo } from "./utilities/subagent-wire.js";
 import { convertMessagesToModelMessages, generateMessageId, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeToUIMessage, uiMessageToModelMessages } from "./activities/chat/messages.js";
 import { uiMessagesToWire } from "./utilities/ag-ui-wire.js";
+import { assertMessagesFileSourceSupport, assertPromptFileSourceSupport, fileReferenceFor, isFileSource, unsupportedFileSourceError } from "./utilities/content-source.js";
 import { firstSentence, renderLazyCatalogEntry } from "./activities/chat/tools/lazy-tools.js";
 import { DISCOVERY_TOOL_NAME } from "./activities/chat/tools/lazy-tool-manager.js";
 import { DuplicateToolNameError } from "./activities/chat/tools/unique-tool-names.js";
@@ -47,6 +48,7 @@ import { countEmbeddingInputModalities, requireTextOnlyEmbeddingInput, resolveEm
 import { createEmbedOptions, embed } from "./activities/embed/index.js";
 import { createWorldOptions, generateWorld } from "./activities/generateWorld/index.js";
 import { createLiveVideoOptions, generateLiveVideo } from "./activities/generateLiveVideo/index.js";
+import { deleteFile, fileSourceFromHandle, getFile, uploadFile } from "./activities/files/index.js";
 import { toolDefinition } from "./activities/chat/tools/tool-definition.js";
 import { chatParamsFromRequest, chatParamsFromRequestBody, mergeAgentTools } from "./utilities/chat-params.js";
 import { decodeWsFrame, encodeWsFrame, resumeWebSocketResponse, resumeWebSocketStream, toWebSocketResponse, toWebSocketStream } from "./stream-to-websocket.js";
@@ -67,4 +69,4 @@ import { BatchStrategy, CompositeStrategy, ImmediateStrategy, PunctuationStrateg
 import { StreamProcessor, createReplayStream } from "./activities/chat/stream/processor.js";
 import { generationParamsFromBody, generationParamsFromRequest } from "./client.js";
 import { createModel, extendAdapter } from "./extend-adapter.js";
-export { BaseEvaluateAdapter, BaseRerankAdapter, BatchStrategy, CUSTOM_EVENT, CompositeStrategy, ConsoleLogger, DISCOVERY_TOOL_NAME, DetachableRunCapability, DuplicateToolNameError, EventType, INTERRUPT_BINDING_METADATA_KEY, INTERRUPT_BINDING_VERSION, INTERRUPT_BOUNDARY_PHASES, INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, INTERRUPT_PAYLOAD_METADATA_KEY, INTERRUPT_TOOL_RESUMES, ImmediateStrategy, InMemoryRunStore, InterruptResumeValidationError, MCPDuplicateToolNameError, MetadataCapability, PartialJSONParser, PunctuationStrategy, RUN_ACCEPTED_EVENT, RUN_CANCEL_REASON, RunDetachedCapability, SkillLimitError, StandardSchemaValidationError, StreamProcessor, ToolCallManager, WordBoundaryStrategy, boolean, brandProviderTool, buildBaseUsage, canonicalInterruptJson, canonicalizeInterruptResolutions, chat, chatParamsFromRequest, chatParamsFromRequestBody, choice, cloneAndDeepFreezeJson, combineStrategies, convertMessagesToModelMessages, convertSchemaToJsonSchema, countEmbeddingInputModalities, createAudioOptions, createCapability, createChatMiddleware, createChatOptions, createEmbedOptions, createFrozenRegistry, createImageOptions, createInterruptBinding, createLiveVideoOptions, createModel, createRealtimeEventEmitter, createReplayStream, createRerankOptions, createSpeechOptions, createSummarizeOptions, createToolRegistry, createTranscriptionOptions, createVideoOptions, createVoiceOptions, createWorldOptions, decide, decodeWsFrame, defaultJSONParser, defineAgent, defineChatMiddleware, defineInterrupt, defineRunStore, detectImageMimeType, digestInterruptJson, embed, encodeWsFrame, extendAdapter, firstSentence, fromSpecTokenUsage, generateAudio, generateImage, generateLiveVideo, generateMessageId, generateSpeech, generateTranscription, generateVideo, generateVoice, generateWorld, generationParamsFromBody, generationParamsFromRequest, genericInterruptContinuationFromDescriptor, getChunkRunId, getChunkThreadId, getDetachableRun, getMetadata, getProviderExecutedMetadata, getRunDetached, getVideoJobStatus, hashSchemaInput, interruptItemError, isCancelRequestedReason, isContentPart, isContentPartArray, isCustomEvent, isProviderExecutedToolCall, isRunStatus, isStandardSchema, isTerminalRunStatus, listVoices, maxIterations, memoryStream, mergeAgentTools, mergeMetadata, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeApprovalSchema, normalizeStreamChunk, normalizeSystemPrompts, normalizeToUIMessage, normalizeToolResult, parsePartialJSON, parseWithStandardSchema, provideDetachableRun, provideMetadata, provideRunDetached, readGenericInterruptContinuation, readInterruptBinding, readUnopenedInterruptBinding, realtimeToken, renderLazyCatalogEntry, replayRunStream, requestRunCancel, requireTextOnlyEmbeddingInput, rerank, resolveEmbeddingInput, resolveMediaPrompt, resolveResumeRunId, resumeHttpResponse, resumeServerSentEventsResponse, resumeWebSocketResponse, resumeWebSocketStream, score, streamToText, subagentHostMessageId, subagentRoute, summarize, toHttpResponse, toHttpStream, toServerSentEventsResponse, toServerSentEventsStream, toSpecTokenUsage, toWebSocketResponse, toWebSocketStream, toolDefinition, uiMessageToModelMessages, uiMessagesToWire, untilFinishReason, validateInterruptResumeBatch, validateWithStandardSchema, wasCancelRequested, wireSubagentInfo, withInterruptBinding, withTanstackMetadata, withoutInterruptBinding, wrapGenericInterruptContinuation };
+export { BaseEvaluateAdapter, BaseRerankAdapter, BatchStrategy, CUSTOM_EVENT, CompositeStrategy, ConsoleLogger, DISCOVERY_TOOL_NAME, DetachableRunCapability, DuplicateToolNameError, EventType, INTERRUPT_BINDING_METADATA_KEY, INTERRUPT_BINDING_VERSION, INTERRUPT_BOUNDARY_PHASES, INTERRUPT_CONTINUATION_METADATA_KEY, INTERRUPT_CONTINUATION_VERSION, INTERRUPT_PAYLOAD_METADATA_KEY, INTERRUPT_TOOL_RESUMES, ImmediateStrategy, InMemoryRunStore, InterruptResumeValidationError, MCPDuplicateToolNameError, MetadataCapability, PartialJSONParser, PunctuationStrategy, RUN_ACCEPTED_EVENT, RUN_CANCEL_REASON, RunDetachedCapability, SkillLimitError, StandardSchemaValidationError, StreamProcessor, ToolCallManager, WordBoundaryStrategy, assertMessagesFileSourceSupport, assertPromptFileSourceSupport, boolean, brandProviderTool, buildBaseUsage, canonicalInterruptJson, canonicalizeInterruptResolutions, chat, chatParamsFromRequest, chatParamsFromRequestBody, choice, cloneAndDeepFreezeJson, combineStrategies, convertMessagesToModelMessages, convertSchemaToJsonSchema, countEmbeddingInputModalities, createAudioOptions, createCapability, createChatMiddleware, createChatOptions, createEmbedOptions, createFrozenRegistry, createImageOptions, createInterruptBinding, createLiveVideoOptions, createModel, createRealtimeEventEmitter, createReplayStream, createRerankOptions, createSpeechOptions, createSummarizeOptions, createToolRegistry, createTranscriptionOptions, createVideoOptions, createVoiceOptions, createWorldOptions, decide, decodeWsFrame, defaultJSONParser, defineAgent, defineChatMiddleware, defineInterrupt, defineRunStore, deleteFile, detectImageMimeType, digestInterruptJson, embed, encodeWsFrame, extendAdapter, fileReferenceFor, fileSourceFromHandle, firstSentence, fromSpecTokenUsage, generateAudio, generateImage, generateLiveVideo, generateMessageId, generateSpeech, generateTranscription, generateVideo, generateVoice, generateWorld, generationParamsFromBody, generationParamsFromRequest, genericInterruptContinuationFromDescriptor, getChunkRunId, getChunkThreadId, getDetachableRun, getFile, getMetadata, getProviderExecutedMetadata, getRunDetached, getVideoJobStatus, hashSchemaInput, interruptItemError, isCancelRequestedReason, isContentPart, isContentPartArray, isCustomEvent, isFileSource, isProviderExecutedToolCall, isRunStatus, isStandardSchema, isTerminalRunStatus, isToolResultOutcome, listVoices, maxIterations, memoryStream, mergeAgentTools, mergeMetadata, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeApprovalSchema, normalizeStreamChunk, normalizeSystemPrompts, normalizeToUIMessage, normalizeToolResult, parsePartialJSON, parseWithStandardSchema, provideDetachableRun, provideMetadata, provideRunDetached, readGenericInterruptContinuation, readInterruptBinding, readUnopenedInterruptBinding, realtimeToken, renderLazyCatalogEntry, replayRunStream, requestRunCancel, requireTextOnlyEmbeddingInput, rerank, resolveEmbeddingInput, resolveMediaPrompt, resolveResumeRunId, resumeHttpResponse, resumeServerSentEventsResponse, resumeWebSocketResponse, resumeWebSocketStream, score, streamToText, subagentHostMessageId, subagentRoute, summarize, toHttpResponse, toHttpStream, toServerSentEventsResponse, toServerSentEventsStream, toSpecTokenUsage, toWebSocketResponse, toWebSocketStream, toolDefinition, uiMessageToModelMessages, uiMessagesToWire, unsupportedFileSourceError, untilFinishReason, uploadFile, validateInterruptResumeBatch, validateWithStandardSchema, wasCancelRequested, wireSubagentInfo, withInterruptBinding, withTanstackMetadata, withoutInterruptBinding, wrapGenericInterruptContinuation };

package/dist/esm/interrupt-resume.js

@@ -1,3 +1,4 @@
+import { tanstackMetadata } from "./utilities/merge-metadata.js";
 import { canonicalInterruptJson, digestInterruptJson } from "./interrupt-serialization.js";
 import { canonicalizeInterruptResolutions } from "./interrupts.js";
 import { isStandardSchema, validateWithStandardSchema } from "./activities/chat/tools/schema-converter.js";
@@ -29,6 +30,20 @@ function objectValue(value) {
 function stringField(value, key) {
 	return typeof value[key] === "string" ? value[key] : void 0;
 }
+function clientToolResult(entry) {
+	if (tanstackMetadata(entry)?.state === "output-error") {
+		const result = objectValue(entry.payload);
+		if (!result || Object.keys(result).length !== 1 || typeof result.error !== "string") return null;
+		return {
+			state: "output-error",
+			errorText: result.error
+		};
+	}
+	return {
+		state: "output-available",
+		output: entry.payload
+	};
+}
 function normalizeIssuePath(path) {
 	if (!path) return void 0;
 	return path.map((segment) => {
@@ -203,7 +218,12 @@ async function validateInterruptResumeBatch(input) {
 		}
 		if (schemaDrifted) continue;
 		if (binding.kind === "client-tool-execution") {
-			if (responseSchema !== void 0) await pushSchemaIssues({
+			const result = clientToolResult(entry);
+			if (!result) {
+				errors.push(interruptItemError(input, record.interruptId, "invalid-tool-output", `Tool ${binding.toolName} result is invalid.`));
+				continue;
+			}
+			if (result.state === "output-available" && responseSchema !== void 0) await pushSchemaIssues({
 				request: input,
 				errors,
 				interruptId: record.interruptId,
@@ -212,12 +232,12 @@ async function validateInterruptResumeBatch(input) {
 				code: "invalid-tool-output",
 				label: `Tool ${binding.toolName} output is invalid`
 			});
-			if (tool.outputSchema !== void 0) await pushSchemaIssues({
+			if (result.state === "output-available" && tool.outputSchema !== void 0) await pushSchemaIssues({
 				request: input,
 				errors,
 				interruptId: record.interruptId,
 				schema: tool.outputSchema,
-				value: entry.payload,
+				value: result.output,
 				code: "invalid-tool-output",
 				label: `Tool ${binding.toolName} output is invalid`
 			});
@@ -298,6 +318,7 @@ async function validateInterruptResumeBatch(input) {
 	const canonical = canonicalizeInterruptResolutions(input.resume ?? []);
 	const approvals = /* @__PURE__ */ new Map();
 	const clientToolResults = /* @__PURE__ */ new Map();
+	const clientToolErrors = /* @__PURE__ */ new Map();
 	const genericInterrupts = /* @__PURE__ */ new Map();
 	const deniedToolResults = /* @__PURE__ */ new Map();
 	const cancelledToolCallIds = /* @__PURE__ */ new Set();
@@ -335,7 +356,10 @@ async function validateInterruptResumeBatch(input) {
 			continue;
 		}
 		if (binding.kind === "client-tool-execution") {
-			clientToolResults.set(binding.toolCallId, entry.payload);
+			const result = clientToolResult(entry);
+			if (!result) continue;
+			if (result.state === "output-error") clientToolErrors.set(binding.toolCallId, result.errorText);
+			else clientToolResults.set(binding.toolCallId, result.output);
 			continue;
 		}
 		const envelope = objectValue(entry.payload);
@@ -358,6 +382,7 @@ async function validateInterruptResumeBatch(input) {
 		resumeToolState: {
 			approvals,
 			clientToolResults,
+			clientToolErrors,
 			genericInterrupts,
 			deniedToolResults,
 			cancelledToolCallIds