@tanstack/ai 0.0.2 → 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;
@@ -277,35 +263,8 @@ export interface AIDevtoolsEventMap {
         timestamp: number;
     };
 }
-type StripPrefix<T extends string> = T extends `tanstack-ai-devtools:${infer Suffix}` ? Suffix : never;
-type EventSuffix = StripPrefix<keyof AIDevtoolsEventMap & string>;
 declare class AiEventClient extends EventClient<AIDevtoolsEventMap> {
-    private eventTarget;
     constructor();
-    /**
-     * Subscribe to events using both the parent EventClient and EventTarget API
-     * @param eventSuffix - The event name without the prefix (e.g., "stream:started")
-     * @param handler - The event handler function
-     * @param options - Optional configuration for event subscription
-     * @returns A function to unsubscribe from the event
-     */
-    on<TSuffix extends EventSuffix>(eventSuffix: TSuffix, handler: (event: {
-        type: `tanstack-ai-devtools:${TSuffix}`;
-        payload: AIDevtoolsEventMap[`tanstack-ai-devtools:${TSuffix}`];
-    }) => void, options?: {
-        withEventTarget?: boolean;
-    }): () => void;
-    /**
-     * Emit an event to both the parent EventClient and the EventTarget
-     * @param eventSuffix - The event name without the prefix (e.g., "stream:started")
-     * @param data - The event data
-     */
-    emit<TSuffix extends EventSuffix>(eventSuffix: TSuffix, data: AIDevtoolsEventMap[`tanstack-ai-devtools:${TSuffix}`]): void;
-    /**
-     * Get the underlying EventTarget for advanced use cases
-     * @returns The EventTarget instance
-     */
-    getEventTarget(): EventTarget;
 }
 declare const aiEventClient: AiEventClient;
 export { aiEventClient };

package/dist/esm/event-client.js

@@ -4,55 +4,6 @@ class AiEventClient extends EventClient {
     super({
       pluginId: "tanstack-ai-devtools"
     });
-    this.eventTarget = new EventTarget();
-  }
-  /**
-   * Subscribe to events using both the parent EventClient and EventTarget API
-   * @param eventSuffix - The event name without the prefix (e.g., "stream:started")
-   * @param handler - The event handler function
-   * @param options - Optional configuration for event subscription
-   * @returns A function to unsubscribe from the event
-   */
-  on(eventSuffix, handler, options) {
-    const parentUnsubscribe = super.on(eventSuffix, handler);
-    const withEventTarget = options?.withEventTarget ?? true;
-    let eventListener;
-    if (withEventTarget) {
-      eventListener = (event) => {
-        if (event instanceof CustomEvent) {
-          handler({
-            type: `${eventSuffix}`,
-            payload: event.detail
-          });
-        }
-      };
-      this.eventTarget.addEventListener(eventSuffix, eventListener);
-    }
-    return () => {
-      parentUnsubscribe();
-      if (withEventTarget && eventListener) {
-        this.eventTarget.removeEventListener(eventSuffix, eventListener);
-      }
-    };
-  }
-  /**
-   * Emit an event to both the parent EventClient and the EventTarget
-   * @param eventSuffix - The event name without the prefix (e.g., "stream:started")
-   * @param data - The event data
-   */
-  emit(eventSuffix, data) {
-    super.emit(eventSuffix, data);
-    const customEvent = new CustomEvent(eventSuffix, {
-      detail: data
-    });
-    this.eventTarget.dispatchEvent(customEvent);
-  }
-  /**
-   * Get the underlying EventTarget for advanced use cases
-   * @returns The EventTarget instance
-   */
-  getEventTarget() {
-    return this.eventTarget;
   }
 }
 const aiEventClient = new AiEventClient();

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\n// Helper type to strip the prefix at the type level\ntype StripPrefix<T extends string> =\n  T extends `tanstack-ai-devtools:${infer Suffix}` ? Suffix : never\n\n// Get all event names without the prefix\ntype EventSuffix = StripPrefix<keyof AIDevtoolsEventMap & string>\n\nclass AiEventClient extends EventClient<AIDevtoolsEventMap> {\n  private eventTarget: EventTarget\n\n  constructor() {\n    super({\n      pluginId: 'tanstack-ai-devtools',\n    })\n    this.eventTarget = new EventTarget()\n  }\n\n  /**\n   * Subscribe to events using both the parent EventClient and EventTarget API\n   * @param eventSuffix - The event name without the prefix (e.g., \"stream:started\")\n   * @param handler - The event handler function\n   * @param options - Optional configuration for event subscription\n   * @returns A function to unsubscribe from the event\n   */\n  override on<TSuffix extends EventSuffix>(\n    eventSuffix: TSuffix,\n    handler: (event: {\n      type: `tanstack-ai-devtools:${TSuffix}`\n      payload: AIDevtoolsEventMap[`tanstack-ai-devtools:${TSuffix}`]\n    }) => void,\n    options?: { withEventTarget?: boolean },\n  ): () => void {\n    const parentUnsubscribe = super.on(eventSuffix, handler)\n\n    const withEventTarget = options?.withEventTarget ?? true\n    let eventListener: ((event: Event) => void) | undefined\n\n    if (withEventTarget) {\n      // Create a wrapper to handle CustomEvent for EventTarget\n      eventListener = (event: Event) => {\n        if (event instanceof CustomEvent) {\n          handler({\n            type: `${eventSuffix}` as `tanstack-ai-devtools:${TSuffix}`,\n            payload: event.detail,\n          })\n        }\n      }\n\n      // Add listener to EventTarget\n      this.eventTarget.addEventListener(eventSuffix, eventListener)\n    }\n\n    // Return unsubscribe function that cleans up both subscriptions\n    return () => {\n      parentUnsubscribe()\n      if (withEventTarget && eventListener) {\n        this.eventTarget.removeEventListener(eventSuffix, eventListener)\n      }\n    }\n  }\n\n  /**\n   * Emit an event to both the parent EventClient and the EventTarget\n   * @param eventSuffix - The event name without the prefix (e.g., \"stream:started\")\n   * @param data - The event data\n   */\n  override emit<TSuffix extends EventSuffix>(\n    eventSuffix: TSuffix,\n    data: AIDevtoolsEventMap[`tanstack-ai-devtools:${TSuffix}`],\n  ): void {\n    super.emit(eventSuffix, data)\n\n    // Always dispatch to EventTarget (for local listeners)\n    const customEvent = new CustomEvent(eventSuffix, {\n      detail: data,\n    })\n    this.eventTarget.dispatchEvent(customEvent)\n  }\n\n  /**\n   * Get the underlying EventTarget for advanced use cases\n   * @returns The EventTarget instance\n   */\n  getEventTarget(): EventTarget {\n    return this.eventTarget\n  }\n}\n\nconst aiEventClient = new AiEventClient()\n\nexport { aiEventClient }\n"],"names":[],"mappings":";AAiTA,MAAM,sBAAsB,YAAgC;AAAA,EAG1D,cAAc;AACZ,UAAM;AAAA,MACJ,UAAU;AAAA,IAAA,CACX;AACD,SAAK,cAAc,IAAI,YAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASS,GACP,aACA,SAIA,SACY;AACZ,UAAM,oBAAoB,MAAM,GAAG,aAAa,OAAO;AAEvD,UAAM,kBAAkB,SAAS,mBAAmB;AACpD,QAAI;AAEJ,QAAI,iBAAiB;AAEnB,sBAAgB,CAAC,UAAiB;AAChC,YAAI,iBAAiB,aAAa;AAChC,kBAAQ;AAAA,YACN,MAAM,GAAG,WAAW;AAAA,YACpB,SAAS,MAAM;AAAA,UAAA,CAChB;AAAA,QACH;AAAA,MACF;AAGA,WAAK,YAAY,iBAAiB,aAAa,aAAa;AAAA,IAC9D;AAGA,WAAO,MAAM;AACX,wBAAA;AACA,UAAI,mBAAmB,eAAe;AACpC,aAAK,YAAY,oBAAoB,aAAa,aAAa;AAAA,MACjE;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOS,KACP,aACA,MACM;AACN,UAAM,KAAK,aAAa,IAAI;AAG5B,UAAM,cAAc,IAAI,YAAY,aAAa;AAAA,MAC/C,QAAQ;AAAA,IAAA,CACT;AACD,SAAK,YAAY,cAAc,WAAW;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,iBAA8B;AAC5B,WAAO,KAAK;AAAA,EACd;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;