@tanstack/ai 0.0.3 → 0.1.0

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

@@ -0,0 +1,100 @@
+import { SummarizeAdapter } from './adapter.js';
+import { StreamChunk, SummarizationResult } from '../../types.js';
+/** The adapter kind this activity handles */
+export declare const kind: "summarize";
+/** Extract provider options from a SummarizeAdapter via ~types */
+export type SummarizeProviderOptions<TAdapter> = TAdapter extends SummarizeAdapter<any, any> ? TAdapter['~types']['providerOptions'] : object;
+/**
+ * Options for the summarize activity.
+ * The model is extracted from the adapter's model property.
+ *
+ * @template TAdapter - The summarize adapter type
+ * @template TStream - Whether to stream the output
+ */
+export interface SummarizeActivityOptions<TAdapter extends SummarizeAdapter<string, object>, TStream extends boolean = false> {
+    /** The summarize adapter to use (must be created with a model) */
+    adapter: TAdapter & {
+        kind: typeof kind;
+    };
+    /** The text to summarize */
+    text: string;
+    /** Maximum length of the summary (in words or characters, provider-dependent) */
+    maxLength?: number;
+    /** Style of summary to generate */
+    style?: 'bullet-points' | 'paragraph' | 'concise';
+    /** Topics or aspects to focus on in the summary */
+    focus?: Array<string>;
+    /** Provider-specific options */
+    modelOptions?: SummarizeProviderOptions<TAdapter>;
+    /**
+     * Whether to stream the summarization result.
+     * When true, returns an AsyncIterable<StreamChunk> for streaming output.
+     * When false or not provided, returns a Promise<SummarizationResult>.
+     *
+     * @default false
+     */
+    stream?: TStream;
+}
+/**
+ * Result type for the summarize activity.
+ * - If stream is true: AsyncIterable<StreamChunk>
+ * - Otherwise: Promise<SummarizationResult>
+ */
+export type SummarizeActivityResult<TStream extends boolean> = TStream extends true ? AsyncIterable<StreamChunk> : Promise<SummarizationResult>;
+/**
+ * Summarize activity - generates summaries from text.
+ *
+ * Supports both streaming and non-streaming modes.
+ *
+ * @example Basic summarization
+ * ```ts
+ * import { summarize } from '@tanstack/ai'
+ * import { openaiSummarize } from '@tanstack/ai-openai'
+ *
+ * const result = await summarize({
+ *   adapter: openaiSummarize('gpt-4o-mini'),
+ *   text: 'Long article text here...'
+ * })
+ *
+ * console.log(result.summary)
+ * ```
+ *
+ * @example Summarization with style
+ * ```ts
+ * const result = await summarize({
+ *   adapter: openaiSummarize('gpt-4o-mini'),
+ *   text: 'Long article text here...',
+ *   style: 'bullet-points',
+ *   maxLength: 100
+ * })
+ * ```
+ *
+ * @example Focused summarization
+ * ```ts
+ * const result = await summarize({
+ *   adapter: openaiSummarize('gpt-4o-mini'),
+ *   text: 'Long technical document...',
+ *   focus: ['key findings', 'methodology']
+ * })
+ * ```
+ *
+ * @example Streaming summarization
+ * ```ts
+ * for await (const chunk of summarize({
+ *   adapter: openaiSummarize('gpt-4o-mini'),
+ *   text: 'Long article text here...',
+ *   stream: true
+ * })) {
+ *   if (chunk.type === 'content') {
+ *     process.stdout.write(chunk.delta)
+ *   }
+ * }
+ * ```
+ */
+export declare function summarize<TAdapter extends SummarizeAdapter<string, object>, TStream extends boolean = false>(options: SummarizeActivityOptions<TAdapter, TStream>): SummarizeActivityResult<TStream>;
+/**
+ * Create typed options for the summarize() function without executing.
+ */
+export declare function createSummarizeOptions<TAdapter extends SummarizeAdapter<string, object>, TStream extends boolean = false>(options: SummarizeActivityOptions<TAdapter, TStream>): SummarizeActivityOptions<TAdapter, TStream>;
+export type { SummarizeAdapter, SummarizeAdapterConfig, AnySummarizeAdapter, } from './adapter.js';
+export { BaseSummarizeAdapter } from './adapter.js';

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

@@ -0,0 +1,90 @@
+import { aiEventClient } from "../../event-client.js";
+const kind = "summarize";
+function createId(prefix) {
+  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+}
+function summarize(options) {
+  const { stream } = options;
+  if (stream) {
+    return runStreamingSummarize(
+      options
+    );
+  }
+  return runSummarize(
+    options
+  );
+}
+async function runSummarize(options) {
+  const { adapter, text, maxLength, style, focus } = options;
+  const model = adapter.model;
+  const requestId = createId("summarize");
+  const inputLength = text.length;
+  const startTime = Date.now();
+  aiEventClient.emit("summarize:started", {
+    requestId,
+    model,
+    inputLength,
+    timestamp: startTime
+  });
+  const summarizeOptions = {
+    model,
+    text,
+    maxLength,
+    style,
+    focus
+  };
+  const result = await adapter.summarize(summarizeOptions);
+  const duration = Date.now() - startTime;
+  const outputLength = result.summary.length;
+  aiEventClient.emit("summarize:completed", {
+    requestId,
+    model,
+    inputLength,
+    outputLength,
+    duration,
+    timestamp: Date.now()
+  });
+  return result;
+}
+async function* runStreamingSummarize(options) {
+  const { adapter, text, maxLength, style, focus } = options;
+  const model = adapter.model;
+  const summarizeOptions = {
+    model,
+    text,
+    maxLength,
+    style,
+    focus
+  };
+  if (adapter.summarizeStream) {
+    yield* adapter.summarizeStream(summarizeOptions);
+    return;
+  }
+  const result = await adapter.summarize(summarizeOptions);
+  yield {
+    type: "content",
+    id: result.id,
+    model: result.model,
+    timestamp: Date.now(),
+    delta: result.summary,
+    content: result.summary,
+    role: "assistant"
+  };
+  yield {
+    type: "done",
+    id: result.id,
+    model: result.model,
+    timestamp: Date.now(),
+    finishReason: "stop",
+    usage: result.usage
+  };
+}
+function createSummarizeOptions(options) {
+  return options;
+}
+export {
+  createSummarizeOptions,
+  kind,
+  summarize
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../src/activities/summarize/index.ts"],"sourcesContent":["/**\n * Summarize Activity\n *\n * Generates summaries from text input.\n * This is a self-contained module with implementation, types, and JSDoc.\n */\n\nimport { aiEventClient } from '../../event-client.js'\nimport type { SummarizeAdapter } from './adapter'\nimport type {\n  StreamChunk,\n  SummarizationOptions,\n  SummarizationResult,\n} from '../../types'\n\n// ===========================\n// Activity Kind\n// ===========================\n\n/** The adapter kind this activity handles */\nexport const kind = 'summarize' as const\n\n// ===========================\n// Type Extraction Helpers\n// ===========================\n\n/** Extract provider options from a SummarizeAdapter via ~types */\nexport type SummarizeProviderOptions<TAdapter> =\n  TAdapter extends SummarizeAdapter<any, any>\n    ? TAdapter['~types']['providerOptions']\n    : object\n\n// ===========================\n// Activity Options Type\n// ===========================\n\n/**\n * Options for the summarize activity.\n * The model is extracted from the adapter's model property.\n *\n * @template TAdapter - The summarize adapter type\n * @template TStream - Whether to stream the output\n */\nexport interface SummarizeActivityOptions<\n  TAdapter extends SummarizeAdapter<string, object>,\n  TStream extends boolean = false,\n> {\n  /** The summarize adapter to use (must be created with a model) */\n  adapter: TAdapter & { kind: typeof kind }\n  /** The text to summarize */\n  text: string\n  /** Maximum length of the summary (in words or characters, provider-dependent) */\n  maxLength?: number\n  /** Style of summary to generate */\n  style?: 'bullet-points' | 'paragraph' | 'concise'\n  /** Topics or aspects to focus on in the summary */\n  focus?: Array<string>\n  /** Provider-specific options */\n  modelOptions?: SummarizeProviderOptions<TAdapter>\n  /**\n   * Whether to stream the summarization result.\n   * When true, returns an AsyncIterable<StreamChunk> for streaming output.\n   * When false or not provided, returns a Promise<SummarizationResult>.\n   *\n   * @default false\n   */\n  stream?: TStream\n}\n\n// ===========================\n// Activity Result Type\n// ===========================\n\n/**\n * Result type for the summarize activity.\n * - If stream is true: AsyncIterable<StreamChunk>\n * - Otherwise: Promise<SummarizationResult>\n */\nexport type SummarizeActivityResult<TStream extends boolean> =\n  TStream extends true\n    ? AsyncIterable<StreamChunk>\n    : Promise<SummarizationResult>\n\n// ===========================\n// Helper Functions\n// ===========================\n\nfunction createId(prefix: string): string {\n  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`\n}\n\n// ===========================\n// Activity Implementation\n// ===========================\n\n/**\n * Summarize activity - generates summaries from text.\n *\n * Supports both streaming and non-streaming modes.\n *\n * @example Basic summarization\n * ```ts\n * import { summarize } from '@tanstack/ai'\n * import { openaiSummarize } from '@tanstack/ai-openai'\n *\n * const result = await summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long article text here...'\n * })\n *\n * console.log(result.summary)\n * ```\n *\n * @example Summarization with style\n * ```ts\n * const result = await summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long article text here...',\n *   style: 'bullet-points',\n *   maxLength: 100\n * })\n * ```\n *\n * @example Focused summarization\n * ```ts\n * const result = await summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long technical document...',\n *   focus: ['key findings', 'methodology']\n * })\n * ```\n *\n * @example Streaming summarization\n * ```ts\n * for await (const chunk of summarize({\n *   adapter: openaiSummarize('gpt-4o-mini'),\n *   text: 'Long article text here...',\n *   stream: true\n * })) {\n *   if (chunk.type === 'content') {\n *     process.stdout.write(chunk.delta)\n *   }\n * }\n * ```\n */\nexport function summarize<\n  TAdapter extends SummarizeAdapter<string, object>,\n  TStream extends boolean = false,\n>(\n  options: SummarizeActivityOptions<TAdapter, TStream>,\n): SummarizeActivityResult<TStream> {\n  const { stream } = options\n\n  if (stream) {\n    return runStreamingSummarize(\n      options as unknown as SummarizeActivityOptions<\n        SummarizeAdapter<string, object>,\n        true\n      >,\n    ) as SummarizeActivityResult<TStream>\n  }\n\n  return runSummarize(\n    options as unknown as SummarizeActivityOptions<\n      SummarizeAdapter<string, object>,\n      false\n    >,\n  ) as SummarizeActivityResult<TStream>\n}\n\n/**\n * Run non-streaming summarization\n */\nasync function runSummarize(\n  options: SummarizeActivityOptions<SummarizeAdapter<string, object>, false>,\n): Promise<SummarizationResult> {\n  const { adapter, text, maxLength, style, focus } = options\n  const model = adapter.model\n  const requestId = createId('summarize')\n  const inputLength = text.length\n  const startTime = Date.now()\n\n  aiEventClient.emit('summarize:started', {\n    requestId,\n    model,\n    inputLength,\n    timestamp: startTime,\n  })\n\n  const summarizeOptions: SummarizationOptions = {\n    model,\n    text,\n    maxLength,\n    style,\n    focus,\n  }\n\n  const result = await adapter.summarize(summarizeOptions)\n\n  const duration = Date.now() - startTime\n  const outputLength = result.summary.length\n\n  aiEventClient.emit('summarize:completed', {\n    requestId,\n    model,\n    inputLength,\n    outputLength,\n    duration,\n    timestamp: Date.now(),\n  })\n\n  return result\n}\n\n/**\n * Run streaming summarization\n * Uses the adapter's native streaming if available, otherwise falls back\n * to non-streaming and yields the result as a single chunk.\n */\nasync function* runStreamingSummarize(\n  options: SummarizeActivityOptions<SummarizeAdapter<string, object>, true>,\n): AsyncIterable<StreamChunk> {\n  const { adapter, text, maxLength, style, focus } = options\n  const model = adapter.model\n\n  const summarizeOptions: SummarizationOptions = {\n    model,\n    text,\n    maxLength,\n    style,\n    focus,\n  }\n\n  // Use real streaming if the adapter supports it\n  if (adapter.summarizeStream) {\n    yield* adapter.summarizeStream(summarizeOptions)\n    return\n  }\n\n  // Fall back to non-streaming and yield as a single chunk\n  const result = await adapter.summarize(summarizeOptions)\n\n  // Yield content chunk with the summary\n  yield {\n    type: 'content',\n    id: result.id,\n    model: result.model,\n    timestamp: Date.now(),\n    delta: result.summary,\n    content: result.summary,\n    role: 'assistant',\n  }\n\n  // Yield done chunk\n  yield {\n    type: 'done',\n    id: result.id,\n    model: result.model,\n    timestamp: Date.now(),\n    finishReason: 'stop',\n    usage: result.usage,\n  }\n}\n\n// ===========================\n// Options Factory\n// ===========================\n\n/**\n * Create typed options for the summarize() function without executing.\n */\nexport function createSummarizeOptions<\n  TAdapter extends SummarizeAdapter<string, object>,\n  TStream extends boolean = false,\n>(\n  options: SummarizeActivityOptions<TAdapter, TStream>,\n): SummarizeActivityOptions<TAdapter, TStream> {\n  return options\n}\n\n// Re-export adapter types\nexport type {\n  SummarizeAdapter,\n  SummarizeAdapterConfig,\n  AnySummarizeAdapter,\n} from './adapter'\nexport { BaseSummarizeAdapter } from './adapter'\n"],"names":[],"mappings":";AAoBO,MAAM,OAAO;AAmEpB,SAAS,SAAS,QAAwB;AACxC,SAAO,GAAG,MAAM,IAAI,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;AAC1E;AAwDO,SAAS,UAId,SACkC;AAClC,QAAM,EAAE,WAAW;AAEnB,MAAI,QAAQ;AACV,WAAO;AAAA,MACL;AAAA,IAAA;AAAA,EAKJ;AAEA,SAAO;AAAA,IACL;AAAA,EAAA;AAKJ;AAKA,eAAe,aACb,SAC8B;AAC9B,QAAM,EAAE,SAAS,MAAM,WAAW,OAAO,UAAU;AACnD,QAAM,QAAQ,QAAQ;AACtB,QAAM,YAAY,SAAS,WAAW;AACtC,QAAM,cAAc,KAAK;AACzB,QAAM,YAAY,KAAK,IAAA;AAEvB,gBAAc,KAAK,qBAAqB;AAAA,IACtC;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW;AAAA,EAAA,CACZ;AAED,QAAM,mBAAyC;AAAA,IAC7C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAGF,QAAM,SAAS,MAAM,QAAQ,UAAU,gBAAgB;AAEvD,QAAM,WAAW,KAAK,IAAA,IAAQ;AAC9B,QAAM,eAAe,OAAO,QAAQ;AAEpC,gBAAc,KAAK,uBAAuB;AAAA,IACxC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,KAAK,IAAA;AAAA,EAAI,CACrB;AAED,SAAO;AACT;AAOA,gBAAgB,sBACd,SAC4B;AAC5B,QAAM,EAAE,SAAS,MAAM,WAAW,OAAO,UAAU;AACnD,QAAM,QAAQ,QAAQ;AAEtB,QAAM,mBAAyC;AAAA,IAC7C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAIF,MAAI,QAAQ,iBAAiB;AAC3B,WAAO,QAAQ,gBAAgB,gBAAgB;AAC/C;AAAA,EACF;AAGA,QAAM,SAAS,MAAM,QAAQ,UAAU,gBAAgB;AAGvD,QAAM;AAAA,IACJ,MAAM;AAAA,IACN,IAAI,OAAO;AAAA,IACX,OAAO,OAAO;AAAA,IACd,WAAW,KAAK,IAAA;AAAA,IAChB,OAAO,OAAO;AAAA,IACd,SAAS,OAAO;AAAA,IAChB,MAAM;AAAA,EAAA;AAIR,QAAM;AAAA,IACJ,MAAM;AAAA,IACN,IAAI,OAAO;AAAA,IACX,OAAO,OAAO;AAAA,IACd,WAAW,KAAK,IAAA;AAAA,IAChB,cAAc;AAAA,IACd,OAAO,OAAO;AAAA,EAAA;AAElB;AASO,SAAS,uBAId,SAC6C;AAC7C,SAAO;AACT;"}

package/dist/esm/event-client.d.ts

@@ -98,7 +98,7 @@ export interface AIDevtoolsEventMap {
         duration: number;
         timestamp: number;
     };
-    'tanstack-ai-devtools:chat:started': {
+    'tanstack-ai-devtools:text:started': {
         requestId: string;
         streamId: string;
         provider: string;
@@ -110,9 +110,9 @@ export interface AIDevtoolsEventMap {
         clientId?: string;
         toolNames?: Array<string>;
         options?: Record<string, unknown>;
-        providerOptions?: Record<string, unknown>;
+        modelOptions?: Record<string, unknown>;
     };
-    'tanstack-ai-devtools:chat:completed': {
+    'tanstack-ai-devtools:text:completed': {
         requestId: string;
         streamId: string;
         model: string;
@@ -126,7 +126,7 @@ export interface AIDevtoolsEventMap {
         };
         timestamp: number;
     };
-    'tanstack-ai-devtools:chat:iteration': {
+    'tanstack-ai-devtools:text:iteration': {
         requestId: string;
         streamId: string;
         iterationNumber: number;
@@ -146,20 +146,6 @@ export interface AIDevtoolsEventMap {
         };
         timestamp: number;
     };
-    'tanstack-ai-devtools:embedding:started': {
-        requestId: string;
-        model: string;
-        inputCount: number;
-        timestamp: number;
-        clientId?: string;
-    };
-    'tanstack-ai-devtools:embedding:completed': {
-        requestId: string;
-        model: string;
-        inputCount: number;
-        duration: number;
-        timestamp: number;
-    };
     'tanstack-ai-devtools:summarize:started': {
         requestId: string;
         model: string;

package/dist/esm/event-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-client.js","sources":["../../src/event-client.ts"],"sourcesContent":["import { EventClient } from '@tanstack/devtools-event-client'\n\n/**\n * Tool call states - track the lifecycle of a tool call\n * Must match @tanstack/ai-client ToolCallState\n */\ntype ToolCallState =\n  | 'awaiting-input' // Received start but no arguments yet\n  | 'input-streaming' // Partial arguments received\n  | 'input-complete' // All arguments received\n  | 'approval-requested' // Waiting for user approval\n  | 'approval-responded' // User has approved/denied\n\n/**\n * Tool result states - track the lifecycle of a tool result\n * Must match @tanstack/ai-client ToolResultState\n */\ntype ToolResultState =\n  | 'streaming' // Placeholder for future streamed output\n  | 'complete' // Result is complete\n  | 'error' // Error occurred\n\nexport interface AIDevtoolsEventMap {\n  // AI Stream events - from @tanstack/ai package\n  'tanstack-ai-devtools:stream:started': {\n    streamId: string\n    model: string\n    provider: string\n    timestamp: number\n    clientId?: string\n  }\n  'tanstack-ai-devtools:stream:chunk:content': {\n    streamId: string\n    messageId?: string\n    content: string\n    delta?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:tool-call': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    index: number\n    arguments: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:tool-result': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    result: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:done': {\n    streamId: string\n    messageId?: string\n    finishReason: string | null\n    usage?: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:error': {\n    streamId: string\n    messageId?: string\n    error: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:thinking': {\n    streamId: string\n    messageId?: string\n    content: string\n    delta?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:approval-requested': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    input: any\n    approvalId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:tool-input-available': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    input: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:call-completed': {\n    requestId: string\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    result: any\n    duration: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:ended': {\n    requestId: string\n    streamId: string\n    totalChunks: number\n    duration: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:chat:started': {\n    requestId: string\n    streamId: string\n    provider: string\n    model: string\n    messageCount: number\n    hasTools: boolean\n    streaming: boolean\n    timestamp: number\n    clientId?: string\n    toolNames?: Array<string>\n    options?: Record<string, unknown>\n    providerOptions?: Record<string, unknown>\n  }\n  'tanstack-ai-devtools:chat:completed': {\n    requestId: string\n    streamId: string\n    model: string\n    content: string\n    messageId?: string\n    finishReason?: string\n    usage?: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n  'tanstack-ai-devtools:chat:iteration': {\n    requestId: string\n    streamId: string\n    iterationNumber: number\n    messageCount: number\n    toolCallCount: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:usage:tokens': {\n    requestId: string\n    streamId: string\n    model: string\n    messageId?: string\n    usage: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n\n  // Embedding events\n  'tanstack-ai-devtools:embedding:started': {\n    requestId: string\n    model: string\n    inputCount: number\n    timestamp: number\n    clientId?: string\n  }\n  'tanstack-ai-devtools:embedding:completed': {\n    requestId: string\n    model: string\n    inputCount: number\n    duration: number\n    timestamp: number\n  }\n\n  // Summarize events\n  'tanstack-ai-devtools:summarize:started': {\n    requestId: string\n    model: string\n    inputLength: number\n    timestamp: number\n    clientId?: string\n  }\n  'tanstack-ai-devtools:summarize:completed': {\n    requestId: string\n    model: string\n    inputLength: number\n    outputLength: number\n    duration: number\n    timestamp: number\n  }\n\n  // Chat Client events - from @tanstack/ai-client package\n  'tanstack-ai-devtools:client:created': {\n    clientId: string\n    initialMessageCount: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:message-appended': {\n    clientId: string\n    messageId: string\n    role: 'user' | 'assistant' | 'system' | 'tool'\n    contentPreview: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:message-sent': {\n    clientId: string\n    messageId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:loading-changed': {\n    clientId: string\n    isLoading: boolean\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:error-changed': {\n    clientId: string\n    error: string | null\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:messages-cleared': {\n    clientId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:reloaded': {\n    clientId: string\n    fromMessageIndex: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:stopped': {\n    clientId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:result-added': {\n    clientId: string\n    toolCallId: string\n    toolName: string\n    output: any\n    state: 'output-available' | 'output-error'\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:approval-responded': {\n    clientId: string\n    approvalId: string\n    toolCallId: string\n    approved: boolean\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:text-updated': {\n    streamId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:tool-call-state-changed': {\n    streamId: string\n    toolCallId: string\n    toolName: string\n    state: ToolCallState\n    arguments: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:tool-result-state-changed': {\n    streamId: string\n    toolCallId: string\n    content: any\n    state: ToolResultState\n    error?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:assistant-message-updated': {\n    clientId: string\n    messageId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:tool-call-updated': {\n    clientId: string\n    messageId: string\n    toolCallId: string\n    toolName: string\n    state: ToolCallState\n    arguments: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:approval-requested': {\n    clientId: string\n    messageId: string\n    toolCallId: string\n    toolName: string\n    input: any\n    approvalId: string\n    timestamp: number\n  }\n}\n\nclass AiEventClient extends EventClient<AIDevtoolsEventMap> {\n  constructor() {\n    super({\n      pluginId: 'tanstack-ai-devtools',\n    })\n  }\n}\n\nconst aiEventClient = new AiEventClient()\n\nexport { aiEventClient }\n"],"names":[],"mappings":";AA0SA,MAAM,sBAAsB,YAAgC;AAAA,EAC1D,cAAc;AACZ,UAAM;AAAA,MACJ,UAAU;AAAA,IAAA,CACX;AAAA,EACH;AACF;AAEA,MAAM,gBAAgB,IAAI,cAAA;"}
+{"version":3,"file":"event-client.js","sources":["../../src/event-client.ts"],"sourcesContent":["import { EventClient } from '@tanstack/devtools-event-client'\n\n/**\n * Tool call states - track the lifecycle of a tool call\n * Must match @tanstack/ai-client ToolCallState\n */\ntype ToolCallState =\n  | 'awaiting-input' // Received start but no arguments yet\n  | 'input-streaming' // Partial arguments received\n  | 'input-complete' // All arguments received\n  | 'approval-requested' // Waiting for user approval\n  | 'approval-responded' // User has approved/denied\n\n/**\n * Tool result states - track the lifecycle of a tool result\n * Must match @tanstack/ai-client ToolResultState\n */\ntype ToolResultState =\n  | 'streaming' // Placeholder for future streamed output\n  | 'complete' // Result is complete\n  | 'error' // Error occurred\n\nexport interface AIDevtoolsEventMap {\n  // AI Stream events - from @tanstack/ai package\n  'tanstack-ai-devtools:stream:started': {\n    streamId: string\n    model: string\n    provider: string\n    timestamp: number\n    clientId?: string\n  }\n  'tanstack-ai-devtools:stream:chunk:content': {\n    streamId: string\n    messageId?: string\n    content: string\n    delta?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:tool-call': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    index: number\n    arguments: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:tool-result': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    result: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:done': {\n    streamId: string\n    messageId?: string\n    finishReason: string | null\n    usage?: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:error': {\n    streamId: string\n    messageId?: string\n    error: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:chunk:thinking': {\n    streamId: string\n    messageId?: string\n    content: string\n    delta?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:approval-requested': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    input: any\n    approvalId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:tool-input-available': {\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    input: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:call-completed': {\n    requestId: string\n    streamId: string\n    messageId?: string\n    toolCallId: string\n    toolName: string\n    result: any\n    duration: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:stream:ended': {\n    requestId: string\n    streamId: string\n    totalChunks: number\n    duration: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:text:started': {\n    requestId: string\n    streamId: string\n    provider: string\n    model: string\n    messageCount: number\n    hasTools: boolean\n    streaming: boolean\n    timestamp: number\n    clientId?: string\n    toolNames?: Array<string>\n    options?: Record<string, unknown>\n    modelOptions?: Record<string, unknown>\n  }\n  'tanstack-ai-devtools:text:completed': {\n    requestId: string\n    streamId: string\n    model: string\n    content: string\n    messageId?: string\n    finishReason?: string\n    usage?: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n  'tanstack-ai-devtools:text:iteration': {\n    requestId: string\n    streamId: string\n    iterationNumber: number\n    messageCount: number\n    toolCallCount: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:usage:tokens': {\n    requestId: string\n    streamId: string\n    model: string\n    messageId?: string\n    usage: {\n      promptTokens: number\n      completionTokens: number\n      totalTokens: number\n    }\n    timestamp: number\n  }\n\n  // Summarize events\n  'tanstack-ai-devtools:summarize:started': {\n    requestId: string\n    model: string\n    inputLength: number\n    timestamp: number\n    clientId?: string\n  }\n  'tanstack-ai-devtools:summarize:completed': {\n    requestId: string\n    model: string\n    inputLength: number\n    outputLength: number\n    duration: number\n    timestamp: number\n  }\n\n  // Text Client events - from @tanstack/ai-client package\n  'tanstack-ai-devtools:client:created': {\n    clientId: string\n    initialMessageCount: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:message-appended': {\n    clientId: string\n    messageId: string\n    role: 'user' | 'assistant' | 'system' | 'tool'\n    contentPreview: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:message-sent': {\n    clientId: string\n    messageId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:loading-changed': {\n    clientId: string\n    isLoading: boolean\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:error-changed': {\n    clientId: string\n    error: string | null\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:messages-cleared': {\n    clientId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:reloaded': {\n    clientId: string\n    fromMessageIndex: number\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:stopped': {\n    clientId: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:result-added': {\n    clientId: string\n    toolCallId: string\n    toolName: string\n    output: any\n    state: 'output-available' | 'output-error'\n    timestamp: number\n  }\n  'tanstack-ai-devtools:tool:approval-responded': {\n    clientId: string\n    approvalId: string\n    toolCallId: string\n    approved: boolean\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:text-updated': {\n    streamId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:tool-call-state-changed': {\n    streamId: string\n    toolCallId: string\n    toolName: string\n    state: ToolCallState\n    arguments: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:processor:tool-result-state-changed': {\n    streamId: string\n    toolCallId: string\n    content: any\n    state: ToolResultState\n    error?: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:assistant-message-updated': {\n    clientId: string\n    messageId: string\n    content: string\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:tool-call-updated': {\n    clientId: string\n    messageId: string\n    toolCallId: string\n    toolName: string\n    state: ToolCallState\n    arguments: any\n    timestamp: number\n  }\n  'tanstack-ai-devtools:client:approval-requested': {\n    clientId: string\n    messageId: string\n    toolCallId: string\n    toolName: string\n    input: any\n    approvalId: string\n    timestamp: number\n  }\n}\n\nclass AiEventClient extends EventClient<AIDevtoolsEventMap> {\n  constructor() {\n    super({\n      pluginId: 'tanstack-ai-devtools',\n    })\n  }\n}\n\nconst aiEventClient = new AiEventClient()\n\nexport { aiEventClient }\n"],"names":[],"mappings":";AA0RA,MAAM,sBAAsB,YAAgC;AAAA,EAC1D,cAAc;AACZ,UAAM;AAAA,MACJ,UAAU;AAAA,IAAA,CACX;AAAA,EACH;AACF;AAEA,MAAM,gBAAgB,IAAI,cAAA;"}

package/dist/esm/index.d.ts

@@ -1,16 +1,18 @@
-export { chat } from './core/chat.js';
-export { summarize } from './core/summarize.js';
-export { embedding } from './core/embedding.js';
-export { toolDefinition, type ToolDefinition, type ToolDefinitionInstance, type ToolDefinitionConfig, type ServerTool, type ClientTool, type AnyClientTool, type InferToolName, type InferToolInput, type InferToolOutput, } from './tools/tool-definition.js';
-export { convertZodToJsonSchema } from './tools/zod-converter.js';
-export { toServerSentEventsStream, toStreamResponse, } from './utilities/stream-to-response.js';
-export { BaseAdapter } from './base-adapter.js';
-export { ToolCallManager } from './tools/tool-calls.js';
-export { maxIterations, untilFinishReason, combineStrategies, } from './utilities/agent-loop-strategies.js';
+export { chat, summarize, generateImage, generateVideo, getVideoJobStatus, generateSpeech, generateTranscription, } from './activities/index.js';
+export { createChatOptions } from './activities/chat/index.js';
+export { createSummarizeOptions } from './activities/summarize/index.js';
+export { createImageOptions } from './activities/generateImage/index.js';
+export { createVideoOptions } from './activities/generateVideo/index.js';
+export { createSpeechOptions } from './activities/generateSpeech/index.js';
+export { createTranscriptionOptions } from './activities/generateTranscription/index.js';
+export type { AIAdapter, ImageAdapter, AnyImageAdapter, TextAdapter, AnyTextAdapter, AnySummarizeAdapter, SummarizeAdapter, AnyTTSAdapter, TTSAdapter, AnyTranscriptionAdapter, TranscriptionAdapter, AnyVideoAdapter, VideoAdapter, } from './activities/index.js';
+export { toolDefinition, type ToolDefinition, type ToolDefinitionInstance, type ToolDefinitionConfig, type ServerTool, type ClientTool, type AnyClientTool, type InferToolName, type InferToolInput, type InferToolOutput, } from './activities/chat/tools/tool-definition.js';
+export { convertZodToJsonSchema } from './activities/chat/tools/zod-converter.js';
+export { streamToText, toServerSentEventsStream, toStreamResponse, toHttpStream, } from './stream-to-response.js';
+export { ToolCallManager } from './activities/chat/tools/tool-calls.js';
+export { maxIterations, untilFinishReason, combineStrategies, } from './activities/chat/agent-loop-strategies.js';
 export * from './types.js';
-export { chatOptions } from './utilities/chat-options.js';
-export { messages } from './utilities/messages.js';
 export { aiEventClient } from './event-client.js';
-export { convertMessagesToModelMessages, uiMessageToModelMessages, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeToUIMessage, generateMessageId, } from './message-converters.js';
-export { StreamProcessor, createReplayStream, ImmediateStrategy, PunctuationStrategy, BatchStrategy, WordBoundaryStrategy, CompositeStrategy, PartialJSONParser, defaultJSONParser, parsePartialJSON, } from './stream.js';
-export type { ChunkStrategy, ChunkRecording, InternalToolCallState, ProcessorResult, ProcessorState, StreamProcessorEvents, StreamProcessorHandlers, StreamProcessorOptions, ToolCallState, ToolResultState, JSONParser, } from './stream.js';
+export { convertMessagesToModelMessages, generateMessageId, uiMessageToModelMessages, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeToUIMessage, } from './activities/chat/messages.js';
+export { StreamProcessor, createReplayStream, ImmediateStrategy, PunctuationStrategy, BatchStrategy, WordBoundaryStrategy, CompositeStrategy, PartialJSONParser, defaultJSONParser, parsePartialJSON, } from './activities/chat/stream/index.js';
+export type { ChunkStrategy, ChunkRecording, InternalToolCallState, ProcessorResult, ProcessorState, StreamProcessorEvents, StreamProcessorHandlers, StreamProcessorOptions, ToolCallState, ToolResultState, JSONParser, } from './activities/chat/stream/index.js';

package/dist/esm/index.js

@@ -1,21 +1,20 @@
-import { chat } from "./core/chat.js";
-import { summarize } from "./core/summarize.js";
-import { embedding } from "./core/embedding.js";
-import { toolDefinition } from "./tools/tool-definition.js";
-import { convertZodToJsonSchema } from "./tools/zod-converter.js";
-import { toServerSentEventsStream, toStreamResponse } from "./utilities/stream-to-response.js";
-import { BaseAdapter } from "./base-adapter.js";
-import { ToolCallManager } from "./tools/tool-calls.js";
-import { combineStrategies, maxIterations, untilFinishReason } from "./utilities/agent-loop-strategies.js";
-import { chatOptions } from "./utilities/chat-options.js";
-import { messages } from "./utilities/messages.js";
+import { chat, createChatOptions } from "./activities/chat/index.js";
+import { createSummarizeOptions, summarize } from "./activities/summarize/index.js";
+import { createImageOptions, generateImage } from "./activities/generateImage/index.js";
+import { createVideoOptions, generateVideo, getVideoJobStatus } from "./activities/generateVideo/index.js";
+import { createSpeechOptions, generateSpeech } from "./activities/generateSpeech/index.js";
+import { createTranscriptionOptions, generateTranscription } from "./activities/generateTranscription/index.js";
+import { toolDefinition } from "./activities/chat/tools/tool-definition.js";
+import { convertZodToJsonSchema } from "./activities/chat/tools/zod-converter.js";
+import { streamToText, toHttpStream, toServerSentEventsStream, toStreamResponse } from "./stream-to-response.js";
+import { ToolCallManager } from "./activities/chat/tools/tool-calls.js";
+import { combineStrategies, maxIterations, untilFinishReason } from "./activities/chat/agent-loop-strategies.js";
 import { aiEventClient } from "./event-client.js";
-import { convertMessagesToModelMessages, generateMessageId, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeToUIMessage, uiMessageToModelMessages } from "./message-converters.js";
-import { StreamProcessor, createReplayStream } from "./stream/processor.js";
-import { BatchStrategy, CompositeStrategy, ImmediateStrategy, PunctuationStrategy, WordBoundaryStrategy } from "./stream/strategies.js";
-import { PartialJSONParser, defaultJSONParser, parsePartialJSON } from "./stream/json-parser.js";
+import { convertMessagesToModelMessages, generateMessageId, modelMessageToUIMessage, modelMessagesToUIMessages, normalizeToUIMessage, uiMessageToModelMessages } from "./activities/chat/messages.js";
+import { StreamProcessor, createReplayStream } from "./activities/chat/stream/processor.js";
+import { BatchStrategy, CompositeStrategy, ImmediateStrategy, PunctuationStrategy, WordBoundaryStrategy } from "./activities/chat/stream/strategies.js";
+import { PartialJSONParser, defaultJSONParser, parsePartialJSON } from "./activities/chat/stream/json-parser.js";
 export {
-  BaseAdapter,
   BatchStrategy,
   CompositeStrategy,
   ImmediateStrategy,
@@ -26,21 +25,31 @@ export {
   WordBoundaryStrategy,
   aiEventClient,
   chat,
-  chatOptions,
   combineStrategies,
   convertMessagesToModelMessages,
   convertZodToJsonSchema,
+  createChatOptions,
+  createImageOptions,
   createReplayStream,
+  createSpeechOptions,
+  createSummarizeOptions,
+  createTranscriptionOptions,
+  createVideoOptions,
   defaultJSONParser,
-  embedding,
+  generateImage,
   generateMessageId,
+  generateSpeech,
+  generateTranscription,
+  generateVideo,
+  getVideoJobStatus,
   maxIterations,
-  messages,
   modelMessageToUIMessage,
   modelMessagesToUIMessages,
   normalizeToUIMessage,
   parsePartialJSON,
+  streamToText,
   summarize,
+  toHttpStream,
   toServerSentEventsStream,
   toStreamResponse,
   toolDefinition,

package/dist/esm/stream-to-response.d.ts

@@ -0,0 +1,95 @@
+import { StreamChunk } from './types.js';
+/**
+ * Collect all text content from a StreamChunk async iterable and return as a string.
+ *
+ * This function consumes the entire stream, accumulating content from 'content' type chunks,
+ * and returns the final concatenated text.
+ *
+ * @param stream - AsyncIterable of StreamChunks from chat()
+ * @returns Promise<string> - The accumulated text content
+ *
+ * @example
+ * ```typescript
+ * const stream = chat({
+ *   adapter: openaiText(),
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Hello!' }]
+ * });
+ * const text = await streamToText(stream);
+ * console.log(text); // "Hello! How can I help you today?"
+ * ```
+ */
+export declare function streamToText(stream: AsyncIterable<StreamChunk>): Promise<string>;
+/**
+ * Convert a StreamChunk async iterable to a ReadableStream in Server-Sent Events format
+ *
+ * This creates a ReadableStream that emits chunks in SSE format:
+ * - Each chunk is prefixed with "data: "
+ * - Each chunk is followed by "\n\n"
+ * - Stream ends with "data: [DONE]\n\n"
+ *
+ * @param stream - AsyncIterable of StreamChunks from chat()
+ * @param abortController - Optional AbortController to abort when stream is cancelled
+ * @returns ReadableStream in Server-Sent Events format
+ *
+ * @example
+ * ```typescript
+ * const stream = chat({ adapter: openaiText(), model: "gpt-4o", messages: [...] });
+ * const readableStream = toServerSentEventsStream(stream);
+ * // Use with Response, or any API that accepts ReadableStream
+ * ```
+ */
+export declare function toServerSentEventsStream(stream: AsyncIterable<StreamChunk>, abortController?: AbortController): ReadableStream<Uint8Array>;
+/**
+ * Convert a StreamChunk async iterable to a ReadableStream in HTTP stream format (newline-delimited JSON)
+ *
+ * This creates a ReadableStream that emits chunks as newline-delimited JSON:
+ * - Each chunk is JSON.stringify'd and followed by "\n"
+ * - No SSE formatting (no "data: " prefix)
+ *
+ * This format is compatible with `fetchHttpStream` connection adapter.
+ *
+ * @param stream - AsyncIterable of StreamChunks from chat()
+ * @param abortController - Optional AbortController to abort when stream is cancelled
+ * @returns ReadableStream in HTTP stream format (newline-delimited JSON)
+ *
+ * @example
+ * ```typescript
+ * const stream = chat({ adapter: openaiText(), model: "gpt-4o", messages: [...] });
+ * const readableStream = toHttpStream(stream);
+ * // Use with Response for HTTP streaming (not SSE)
+ * return new Response(readableStream, {
+ *   headers: { 'Content-Type': 'application/x-ndjson' }
+ * });
+ * ```
+ */
+export declare function toHttpStream(stream: AsyncIterable<StreamChunk>, abortController?: AbortController): ReadableStream<Uint8Array>;
+/**
+ * Create a streaming HTTP response from a StreamChunk async iterable
+ * Includes proper headers for Server-Sent Events
+ *
+ * @deprecated Use `toServerSentEventsStream` instead. This function will be removed in a future version.
+ *
+ * @param stream - AsyncIterable of StreamChunks from chat()
+ * @param init - Optional Response initialization options
+ * @param abortController - Optional AbortController to abort when client disconnects
+ * @returns Response object with SSE headers and streaming body
+ *
+ * @example
+ * ```typescript
+ * export async function POST(request: Request) {
+ *   const { messages } = await request.json();
+ *   const abortController = new AbortController();
+ *   const stream = chat({
+ *     adapter: openaiText(),
+ *     model: "gpt-4o",
+ *     messages,
+ *     options: { abortSignal: abortController.signal }
+ *   });
+ *   return toStreamResponse(stream, undefined, abortController);
+ * }
+ * ```
+ */
+export declare function toStreamResponse(stream: AsyncIterable<StreamChunk>, init?: ResponseInit & {
+    abortController?: AbortController;
+}): Response;

package/dist/esm/stream-to-response.js

@@ -0,0 +1,118 @@
+async function streamToText(stream) {
+  let accumulatedContent = "";
+  for await (const chunk of stream) {
+    if (chunk.type === "content" && chunk.delta) {
+      accumulatedContent += chunk.delta;
+    }
+  }
+  return accumulatedContent;
+}
+function toServerSentEventsStream(stream, abortController) {
+  const encoder = new TextEncoder();
+  return new ReadableStream({
+    async start(controller) {
+      try {
+        for await (const chunk of stream) {
+          if (abortController?.signal.aborted) {
+            break;
+          }
+          controller.enqueue(
+            encoder.encode(`data: ${JSON.stringify(chunk)}
+
+`)
+          );
+        }
+        controller.enqueue(encoder.encode("data: [DONE]\n\n"));
+        controller.close();
+      } catch (error) {
+        if (abortController?.signal.aborted) {
+          controller.close();
+          return;
+        }
+        controller.enqueue(
+          encoder.encode(
+            `data: ${JSON.stringify({
+              type: "error",
+              error: {
+                message: error.message || "Unknown error occurred",
+                code: error.code
+              }
+            })}
+
+`
+          )
+        );
+        controller.close();
+      }
+    },
+    cancel() {
+      if (abortController) {
+        abortController.abort();
+      }
+    }
+  });
+}
+function toHttpStream(stream, abortController) {
+  const encoder = new TextEncoder();
+  return new ReadableStream({
+    async start(controller) {
+      try {
+        for await (const chunk of stream) {
+          if (abortController?.signal.aborted) {
+            break;
+          }
+          controller.enqueue(encoder.encode(`${JSON.stringify(chunk)}
+`));
+        }
+        controller.close();
+      } catch (error) {
+        if (abortController?.signal.aborted) {
+          controller.close();
+          return;
+        }
+        controller.enqueue(
+          encoder.encode(
+            `${JSON.stringify({
+              type: "error",
+              error: {
+                message: error.message || "Unknown error occurred",
+                code: error.code
+              }
+            })}
+`
+          )
+        );
+        controller.close();
+      }
+    },
+    cancel() {
+      if (abortController) {
+        abortController.abort();
+      }
+    }
+  });
+}
+function toStreamResponse(stream, init) {
+  if (typeof console !== "undefined") {
+    console.warn(
+      "`toStreamResponse` is deprecated. Use `toServerSentEventsStream` instead. Example:\n  const readableStream = toServerSentEventsStream(stream, abortController);\n  return new Response(readableStream, {\n    headers: { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', Connection: 'keep-alive' }\n  });"
+    );
+  }
+  const { headers, abortController, ...responseInit } = init ?? {};
+  return new Response(toServerSentEventsStream(stream, abortController), {
+    ...responseInit,
+    headers: {
+      "Content-Type": "text/event-stream",
+      "Cache-Control": "no-cache",
+      Connection: "keep-alive",
+      ...headers || {}
+    }
+  });
+}
+export {
+  streamToText,
+  toHttpStream,
+  toServerSentEventsStream,
+  toStreamResponse
+};
+//# sourceMappingURL=stream-to-response.js.map

package/dist/esm/stream-to-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-to-response.js","sources":["../../src/stream-to-response.ts"],"sourcesContent":["import type { StreamChunk } from './types'\n\n/**\n * Collect all text content from a StreamChunk async iterable and return as a string.\n *\n * This function consumes the entire stream, accumulating content from 'content' type chunks,\n * and returns the final concatenated text.\n *\n * @param stream - AsyncIterable of StreamChunks from chat()\n * @returns Promise<string> - The accumulated text content\n *\n * @example\n * ```typescript\n * const stream = chat({\n *   adapter: openaiText(),\n *   model: 'gpt-4o',\n *   messages: [{ role: 'user', content: 'Hello!' }]\n * });\n * const text = await streamToText(stream);\n * console.log(text); // \"Hello! How can I help you today?\"\n * ```\n */\nexport async function streamToText(\n  stream: AsyncIterable<StreamChunk>,\n): Promise<string> {\n  let accumulatedContent = ''\n\n  for await (const chunk of stream) {\n    if (chunk.type === 'content' && chunk.delta) {\n      accumulatedContent += chunk.delta\n    }\n  }\n\n  return accumulatedContent\n}\n\n/**\n * Convert a StreamChunk async iterable to a ReadableStream in Server-Sent Events format\n *\n * This creates a ReadableStream that emits chunks in SSE format:\n * - Each chunk is prefixed with \"data: \"\n * - Each chunk is followed by \"\\n\\n\"\n * - Stream ends with \"data: [DONE]\\n\\n\"\n *\n * @param stream - AsyncIterable of StreamChunks from chat()\n * @param abortController - Optional AbortController to abort when stream is cancelled\n * @returns ReadableStream in Server-Sent Events format\n *\n * @example\n * ```typescript\n * const stream = chat({ adapter: openaiText(), model: \"gpt-4o\", messages: [...] });\n * const readableStream = toServerSentEventsStream(stream);\n * // Use with Response, or any API that accepts ReadableStream\n * ```\n */\nexport function toServerSentEventsStream(\n  stream: AsyncIterable<StreamChunk>,\n  abortController?: AbortController,\n): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder()\n\n  return new ReadableStream({\n    async start(controller) {\n      try {\n        for await (const chunk of stream) {\n          // Check if stream was cancelled/aborted\n          if (abortController?.signal.aborted) {\n            break\n          }\n\n          // Send each chunk as Server-Sent Events format\n          controller.enqueue(\n            encoder.encode(`data: ${JSON.stringify(chunk)}\\n\\n`),\n          )\n        }\n\n        // Send completion marker\n        controller.enqueue(encoder.encode('data: [DONE]\\n\\n'))\n        controller.close()\n      } catch (error: any) {\n        // Don't send error if aborted\n        if (abortController?.signal.aborted) {\n          controller.close()\n          return\n        }\n\n        // Send error chunk\n        controller.enqueue(\n          encoder.encode(\n            `data: ${JSON.stringify({\n              type: 'error',\n              error: {\n                message: error.message || 'Unknown error occurred',\n                code: error.code,\n              },\n            })}\\n\\n`,\n          ),\n        )\n        controller.close()\n      }\n    },\n    cancel() {\n      // When the ReadableStream is cancelled (e.g., client disconnects),\n      // abort the underlying stream\n      if (abortController) {\n        abortController.abort()\n      }\n    },\n  })\n}\n\n/**\n * Convert a StreamChunk async iterable to a ReadableStream in HTTP stream format (newline-delimited JSON)\n *\n * This creates a ReadableStream that emits chunks as newline-delimited JSON:\n * - Each chunk is JSON.stringify'd and followed by \"\\n\"\n * - No SSE formatting (no \"data: \" prefix)\n *\n * This format is compatible with `fetchHttpStream` connection adapter.\n *\n * @param stream - AsyncIterable of StreamChunks from chat()\n * @param abortController - Optional AbortController to abort when stream is cancelled\n * @returns ReadableStream in HTTP stream format (newline-delimited JSON)\n *\n * @example\n * ```typescript\n * const stream = chat({ adapter: openaiText(), model: \"gpt-4o\", messages: [...] });\n * const readableStream = toHttpStream(stream);\n * // Use with Response for HTTP streaming (not SSE)\n * return new Response(readableStream, {\n *   headers: { 'Content-Type': 'application/x-ndjson' }\n * });\n * ```\n */\nexport function toHttpStream(\n  stream: AsyncIterable<StreamChunk>,\n  abortController?: AbortController,\n): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder()\n\n  return new ReadableStream({\n    async start(controller) {\n      try {\n        for await (const chunk of stream) {\n          // Check if stream was cancelled/aborted\n          if (abortController?.signal.aborted) {\n            break\n          }\n\n          // Send each chunk as newline-delimited JSON\n          controller.enqueue(encoder.encode(`${JSON.stringify(chunk)}\\n`))\n        }\n\n        controller.close()\n      } catch (error: any) {\n        // Don't send error if aborted\n        if (abortController?.signal.aborted) {\n          controller.close()\n          return\n        }\n\n        // Send error chunk\n        controller.enqueue(\n          encoder.encode(\n            `${JSON.stringify({\n              type: 'error',\n              error: {\n                message: error.message || 'Unknown error occurred',\n                code: error.code,\n              },\n            })}\\n`,\n          ),\n        )\n        controller.close()\n      }\n    },\n    cancel() {\n      // When the ReadableStream is cancelled (e.g., client disconnects),\n      // abort the underlying stream\n      if (abortController) {\n        abortController.abort()\n      }\n    },\n  })\n}\n\n/**\n * Create a streaming HTTP response from a StreamChunk async iterable\n * Includes proper headers for Server-Sent Events\n *\n * @deprecated Use `toServerSentEventsStream` instead. This function will be removed in a future version.\n *\n * @param stream - AsyncIterable of StreamChunks from chat()\n * @param init - Optional Response initialization options\n * @param abortController - Optional AbortController to abort when client disconnects\n * @returns Response object with SSE headers and streaming body\n *\n * @example\n * ```typescript\n * export async function POST(request: Request) {\n *   const { messages } = await request.json();\n *   const abortController = new AbortController();\n *   const stream = chat({\n *     adapter: openaiText(),\n *     model: \"gpt-4o\",\n *     messages,\n *     options: { abortSignal: abortController.signal }\n *   });\n *   return toStreamResponse(stream, undefined, abortController);\n * }\n * ```\n */\nexport function toStreamResponse(\n  stream: AsyncIterable<StreamChunk>,\n  init?: ResponseInit & { abortController?: AbortController },\n): Response {\n  if (typeof console !== 'undefined') {\n    console.warn(\n      '`toStreamResponse` is deprecated. Use `toServerSentEventsStream` instead. Example:\\n' +\n        '  const readableStream = toServerSentEventsStream(stream, abortController);\\n' +\n        '  return new Response(readableStream, {\\n' +\n        \"    headers: { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', Connection: 'keep-alive' }\\n\" +\n        '  });',\n    )\n  }\n\n  const { headers, abortController, ...responseInit } = init ?? {}\n  return new Response(toServerSentEventsStream(stream, abortController), {\n    ...responseInit,\n    headers: {\n      'Content-Type': 'text/event-stream',\n      'Cache-Control': 'no-cache',\n      Connection: 'keep-alive',\n      ...(headers || {}),\n    },\n  })\n}\n"],"names":[],"mappings":"AAsBA,eAAsB,aACpB,QACiB;AACjB,MAAI,qBAAqB;AAEzB,mBAAiB,SAAS,QAAQ;AAChC,QAAI,MAAM,SAAS,aAAa,MAAM,OAAO;AAC3C,4BAAsB,MAAM;AAAA,IAC9B;AAAA,EACF;AAEA,SAAO;AACT;AAqBO,SAAS,yBACd,QACA,iBAC4B;AAC5B,QAAM,UAAU,IAAI,YAAA;AAEpB,SAAO,IAAI,eAAe;AAAA,IACxB,MAAM,MAAM,YAAY;AACtB,UAAI;AACF,yBAAiB,SAAS,QAAQ;AAEhC,cAAI,iBAAiB,OAAO,SAAS;AACnC;AAAA,UACF;AAGA,qBAAW;AAAA,YACT,QAAQ,OAAO,SAAS,KAAK,UAAU,KAAK,CAAC;AAAA;AAAA,CAAM;AAAA,UAAA;AAAA,QAEvD;AAGA,mBAAW,QAAQ,QAAQ,OAAO,kBAAkB,CAAC;AACrD,mBAAW,MAAA;AAAA,MACb,SAAS,OAAY;AAEnB,YAAI,iBAAiB,OAAO,SAAS;AACnC,qBAAW,MAAA;AACX;AAAA,QACF;AAGA,mBAAW;AAAA,UACT,QAAQ;AAAA,YACN,SAAS,KAAK,UAAU;AAAA,cACtB,MAAM;AAAA,cACN,OAAO;AAAA,gBACL,SAAS,MAAM,WAAW;AAAA,gBAC1B,MAAM,MAAM;AAAA,cAAA;AAAA,YACd,CACD,CAAC;AAAA;AAAA;AAAA,UAAA;AAAA,QACJ;AAEF,mBAAW,MAAA;AAAA,MACb;AAAA,IACF;AAAA,IACA,SAAS;AAGP,UAAI,iBAAiB;AACnB,wBAAgB,MAAA;AAAA,MAClB;AAAA,IACF;AAAA,EAAA,CACD;AACH;AAyBO,SAAS,aACd,QACA,iBAC4B;AAC5B,QAAM,UAAU,IAAI,YAAA;AAEpB,SAAO,IAAI,eAAe;AAAA,IACxB,MAAM,MAAM,YAAY;AACtB,UAAI;AACF,yBAAiB,SAAS,QAAQ;AAEhC,cAAI,iBAAiB,OAAO,SAAS;AACnC;AAAA,UACF;AAGA,qBAAW,QAAQ,QAAQ,OAAO,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,CAAI,CAAC;AAAA,QACjE;AAEA,mBAAW,MAAA;AAAA,MACb,SAAS,OAAY;AAEnB,YAAI,iBAAiB,OAAO,SAAS;AACnC,qBAAW,MAAA;AACX;AAAA,QACF;AAGA,mBAAW;AAAA,UACT,QAAQ;AAAA,YACN,GAAG,KAAK,UAAU;AAAA,cAChB,MAAM;AAAA,cACN,OAAO;AAAA,gBACL,SAAS,MAAM,WAAW;AAAA,gBAC1B,MAAM,MAAM;AAAA,cAAA;AAAA,YACd,CACD,CAAC;AAAA;AAAA,UAAA;AAAA,QACJ;AAEF,mBAAW,MAAA;AAAA,MACb;AAAA,IACF;AAAA,IACA,SAAS;AAGP,UAAI,iBAAiB;AACnB,wBAAgB,MAAA;AAAA,MAClB;AAAA,IACF;AAAA,EAAA,CACD;AACH;AA4BO,SAAS,iBACd,QACA,MACU;AACV,MAAI,OAAO,YAAY,aAAa;AAClC,YAAQ;AAAA,MACN;AAAA,IAAA;AAAA,EAMJ;AAEA,QAAM,EAAE,SAAS,iBAAiB,GAAG,aAAA,IAAiB,QAAQ,CAAA;AAC9D,SAAO,IAAI,SAAS,yBAAyB,QAAQ,eAAe,GAAG;AAAA,IACrE,GAAG;AAAA,IACH,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,iBAAiB;AAAA,MACjB,YAAY;AAAA,MACZ,GAAI,WAAW,CAAA;AAAA,IAAC;AAAA,EAClB,CACD;AACH;"}