@framers/agentos 0.1.68 → 0.1.70

package/dist/api/model.d.ts

@@ -1,28 +1,98 @@
+/**
+ * @file model.ts
+ * Provider resolution utilities for the AgentOS high-level API.
+ *
+ * This module is responsible for parsing `provider:model` strings, resolving
+ * credentials from environment variables or caller overrides, and constructing
+ * an {@link AIModelProviderManager} ready for use by {@link generateText} and
+ * {@link streamText}.
+ */
 import { AIModelProviderManager } from '../core/llm/providers/AIModelProviderManager.js';
+/**
+ * The result of splitting a `provider:model` string at the first colon.
+ * Produced by {@link parseModelString}.
+ */
 export interface ParsedModel {
+    /** The provider identifier (e.g. `"openai"`, `"anthropic"`, `"ollama"`). */
     providerId: string;
+    /** The model identifier within the provider (e.g. `"gpt-4o"`, `"llama3.2"`). */
     modelId: string;
 }
+/**
+ * A fully resolved provider configuration including optional credentials.
+ * Produced by {@link resolveProvider} and {@link resolveMediaProvider}.
+ */
 export interface ResolvedProvider {
+    /** Canonical provider identifier after any fallback remapping (e.g. anthropic → openrouter). */
     providerId: string;
+    /** Model identifier, potentially rewritten for the remapped provider. */
     modelId: string;
+    /** API key to use. Absent for providers that rely solely on a base URL (e.g. Ollama). */
     apiKey?: string;
+    /** Base URL override forwarded to the provider SDK. */
     baseUrl?: string;
 }
 /**
- * Parses 'provider:model' string format.
- * Examples: 'openai:gpt-4o', 'ollama:llama3.2', 'openrouter:anthropic/claude-sonnet-4-5-20250929'
+ * Splits a `provider:model` string into its constituent parts.
+ *
+ * The format is strict: the provider portion must be non-empty, separated from
+ * the model portion by exactly one colon, and the model portion must also be
+ * non-empty.
+ *
+ * @param model - A `provider:model` string such as `"openai:gpt-4o"`,
+ *   `"ollama:llama3.2"`, or `"openrouter:anthropic/claude-sonnet-4-5-20250929"`.
+ * @returns A {@link ParsedModel} with `providerId` and `modelId` fields.
+ * @throws {Error} When the string is missing, not a string, or does not match
+ *   the expected `provider:model` format.
  */
 export declare function parseModelString(model: string): ParsedModel;
 /**
- * Resolves provider config from env vars, with optional overrides.
+ * Resolves a complete provider configuration for LLM text providers.
+ *
+ * Reads API keys and base URLs from well-known environment variables
+ * (e.g. `OPENAI_API_KEY`, `OLLAMA_BASE_URL`) and merges caller-supplied
+ * `overrides`.  Applies the Anthropic → OpenRouter fallback when
+ * `ANTHROPIC_API_KEY` is absent but `OPENROUTER_API_KEY` is set.
+ *
+ * @param providerId - Provider identifier (e.g. `"openai"`, `"anthropic"`, `"ollama"`).
+ * @param modelId - Model identifier within the provider.
+ * @param overrides - Optional explicit API key and/or base URL that take precedence
+ *   over environment variable lookups.
+ * @returns A {@link ResolvedProvider} ready for {@link createProviderManager}.
+ * @throws {Error} When no credentials can be resolved for the given provider.
  */
 export declare function resolveProvider(providerId: string, modelId: string, overrides?: {
     apiKey?: string;
     baseUrl?: string;
 }): ResolvedProvider;
 /**
- * Creates an AIModelProviderManager from a resolved provider config.
+ * Resolves a provider configuration for image and other media providers.
+ *
+ * Behaves like {@link resolveProvider} but relaxes the API-key requirement:
+ * when the provider is not listed in the known key map, the call succeeds
+ * without a key (allowing custom or keyless providers).  Ollama still
+ * requires a `baseUrl`.
+ *
+ * @param providerId - Provider identifier (e.g. `"stability"`, `"replicate"`, `"ollama"`).
+ * @param modelId - Model identifier within the provider.
+ * @param overrides - Optional explicit API key and/or base URL overrides.
+ * @returns A {@link ResolvedProvider} ready for use with an image provider factory.
+ * @throws {Error} When a known provider is missing its required API key or base URL.
+ */
+export declare function resolveMediaProvider(providerId: string, modelId: string, overrides?: {
+    apiKey?: string;
+    baseUrl?: string;
+}): ResolvedProvider;
+/**
+ * Instantiates and initialises an {@link AIModelProviderManager} for a single provider.
+ *
+ * Constructs the provider config object from the `resolved` credentials and calls
+ * `manager.initialize()` before returning.  The returned manager is ready for
+ * immediate use via `manager.getProvider(providerId)`.
+ *
+ * @param resolved - A {@link ResolvedProvider} produced by {@link resolveProvider}
+ *   or {@link resolveMediaProvider}.
+ * @returns A fully initialised {@link AIModelProviderManager} instance.
  */
 export declare function createProviderManager(resolved: ResolvedProvider): Promise<AIModelProviderManager>;
 //# sourceMappingURL=model.d.ts.map

package/dist/api/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/api/model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAEzF,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAY3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,gBAAgB,CA4BlB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAoBjC"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/api/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAEzF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gGAAgG;IAChG,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAY3D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,gBAAgB,CA4BlB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,gBAAgB,CAmBlB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAoBjC"}

package/dist/api/model.js

@@ -1,17 +1,40 @@
-// packages/agentos/src/api/model.ts
+/**
+ * @file model.ts
+ * Provider resolution utilities for the AgentOS high-level API.
+ *
+ * This module is responsible for parsing `provider:model` strings, resolving
+ * credentials from environment variables or caller overrides, and constructing
+ * an {@link AIModelProviderManager} ready for use by {@link generateText} and
+ * {@link streamText}.
+ */
 import { AIModelProviderManager } from '../core/llm/providers/AIModelProviderManager.js';
 const ENV_KEY_MAP = {
     openai: 'OPENAI_API_KEY',
     anthropic: 'ANTHROPIC_API_KEY',
     openrouter: 'OPENROUTER_API_KEY',
     gemini: 'GEMINI_API_KEY',
+    stability: 'STABILITY_API_KEY',
+    replicate: 'REPLICATE_API_TOKEN',
 };
 const ENV_URL_MAP = {
+    openai: 'OPENAI_BASE_URL',
+    openrouter: 'OPENROUTER_BASE_URL',
+    stability: 'STABILITY_BASE_URL',
+    replicate: 'REPLICATE_BASE_URL',
     ollama: 'OLLAMA_BASE_URL',
 };
 /**
- * Parses 'provider:model' string format.
- * Examples: 'openai:gpt-4o', 'ollama:llama3.2', 'openrouter:anthropic/claude-sonnet-4-5-20250929'
+ * Splits a `provider:model` string into its constituent parts.
+ *
+ * The format is strict: the provider portion must be non-empty, separated from
+ * the model portion by exactly one colon, and the model portion must also be
+ * non-empty.
+ *
+ * @param model - A `provider:model` string such as `"openai:gpt-4o"`,
+ *   `"ollama:llama3.2"`, or `"openrouter:anthropic/claude-sonnet-4-5-20250929"`.
+ * @returns A {@link ParsedModel} with `providerId` and `modelId` fields.
+ * @throws {Error} When the string is missing, not a string, or does not match
+ *   the expected `provider:model` format.
  */
 export function parseModelString(model) {
     if (!model || typeof model !== 'string') {
@@ -27,7 +50,19 @@ export function parseModelString(model) {
     };
 }
 /**
- * Resolves provider config from env vars, with optional overrides.
+ * Resolves a complete provider configuration for LLM text providers.
+ *
+ * Reads API keys and base URLs from well-known environment variables
+ * (e.g. `OPENAI_API_KEY`, `OLLAMA_BASE_URL`) and merges caller-supplied
+ * `overrides`.  Applies the Anthropic → OpenRouter fallback when
+ * `ANTHROPIC_API_KEY` is absent but `OPENROUTER_API_KEY` is set.
+ *
+ * @param providerId - Provider identifier (e.g. `"openai"`, `"anthropic"`, `"ollama"`).
+ * @param modelId - Model identifier within the provider.
+ * @param overrides - Optional explicit API key and/or base URL that take precedence
+ *   over environment variable lookups.
+ * @returns A {@link ResolvedProvider} ready for {@link createProviderManager}.
+ * @throws {Error} When no credentials can be resolved for the given provider.
  */
 export function resolveProvider(providerId, modelId, overrides) {
     const apiKey = overrides?.apiKey
@@ -55,7 +90,46 @@ export function resolveProvider(providerId, modelId, overrides) {
     return { providerId, modelId, apiKey, baseUrl };
 }
 /**
- * Creates an AIModelProviderManager from a resolved provider config.
+ * Resolves a provider configuration for image and other media providers.
+ *
+ * Behaves like {@link resolveProvider} but relaxes the API-key requirement:
+ * when the provider is not listed in the known key map, the call succeeds
+ * without a key (allowing custom or keyless providers).  Ollama still
+ * requires a `baseUrl`.
+ *
+ * @param providerId - Provider identifier (e.g. `"stability"`, `"replicate"`, `"ollama"`).
+ * @param modelId - Model identifier within the provider.
+ * @param overrides - Optional explicit API key and/or base URL overrides.
+ * @returns A {@link ResolvedProvider} ready for use with an image provider factory.
+ * @throws {Error} When a known provider is missing its required API key or base URL.
+ */
+export function resolveMediaProvider(providerId, modelId, overrides) {
+    const apiKey = overrides?.apiKey
+        ?? (ENV_KEY_MAP[providerId] ? process.env[ENV_KEY_MAP[providerId]] : undefined);
+    const baseUrl = overrides?.baseUrl
+        ?? (ENV_URL_MAP[providerId] ? process.env[ENV_URL_MAP[providerId]] : undefined);
+    if (providerId === 'ollama') {
+        if (!baseUrl) {
+            throw new Error(`No base URL for ollama. Set OLLAMA_BASE_URL or pass baseUrl.`);
+        }
+        return { providerId, modelId, baseUrl };
+    }
+    const envVar = ENV_KEY_MAP[providerId];
+    if (envVar && !apiKey) {
+        throw new Error(`No API key for ${providerId}. Set ${envVar} or pass apiKey.`);
+    }
+    return { providerId, modelId, apiKey, baseUrl };
+}
+/**
+ * Instantiates and initialises an {@link AIModelProviderManager} for a single provider.
+ *
+ * Constructs the provider config object from the `resolved` credentials and calls
+ * `manager.initialize()` before returning.  The returned manager is ready for
+ * immediate use via `manager.getProvider(providerId)`.
+ *
+ * @param resolved - A {@link ResolvedProvider} produced by {@link resolveProvider}
+ *   or {@link resolveMediaProvider}.
+ * @returns A fully initialised {@link AIModelProviderManager} instance.
  */
 export async function createProviderManager(resolved) {
     const manager = new AIModelProviderManager();

package/dist/api/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/api/model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/api/model.ts"],"names":[],"mappings":"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"}

package/dist/api/streamText.d.ts

@@ -1,4 +1,13 @@
 import type { GenerateTextOptions, TokenUsage, ToolCallRecord } from './generateText.js';
+/**
+ * A discriminated union representing a single event emitted by the
+ * {@link StreamTextResult.fullStream} iterable.
+ *
+ * - `"text"` — incremental token delta from the model.
+ * - `"tool-call"` — the model requested a tool invocation.
+ * - `"tool-result"` — the tool has been executed and the result is available.
+ * - `"error"` — an unrecoverable error occurred; the stream ends after this part.
+ */
 export type StreamPart = {
     type: 'text';
     text: string;
@@ -14,15 +23,42 @@ export type StreamPart = {
     type: 'error';
     error: Error;
 };
+/**
+ * The object returned immediately by {@link streamText}.
+ *
+ * Consumers may iterate `textStream` for raw token deltas, `fullStream` for
+ * all event types, or simply `await` the promise properties for aggregated
+ * results once the stream has drained.
+ */
 export interface StreamTextResult {
+    /** Async iterable that yields only raw text-delta strings (filters out non-text parts). */
     textStream: AsyncIterable<string>;
+    /** Async iterable that yields all {@link StreamPart} events in order. */
     fullStream: AsyncIterable<StreamPart>;
+    /** Resolves to the fully assembled assistant reply when the stream completes. */
     text: Promise<string>;
+    /** Resolves to aggregated {@link TokenUsage} when the stream completes. */
     usage: Promise<TokenUsage>;
+    /** Resolves to the ordered list of {@link ToolCallRecord}s when the stream completes. */
     toolCalls: Promise<ToolCallRecord[]>;
 }
 /**
- * Stateless streaming text generation. Returns immediately with async iterables.
+ * Stateless streaming text generation with optional multi-step tool calling.
+ *
+ * Returns a {@link StreamTextResult} immediately; the underlying provider call
+ * begins lazily when a consumer starts iterating `textStream` or `fullStream`.
+ * Awaiting `text`, `usage`, or `toolCalls` will also drain the stream.
+ *
+ * @param opts - Generation options (same shape as {@link generateText}).
+ * @returns A {@link StreamTextResult} with async iterables and awaitable promises.
+ *
+ * @example
+ * ```ts
+ * const { textStream } = streamText({ model: 'openai:gpt-4o', prompt: 'Tell me a joke.' });
+ * for await (const chunk of textStream) {
+ *   process.stdout.write(chunk);
+ * }
+ * ```
  */
 export declare function streamText(opts: GenerateTextOptions): StreamTextResult;
 //# sourceMappingURL=streamText.d.ts.map

package/dist/api/streamText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streamText.d.ts","sourceRoot":"","sources":["../../src/api/streamText.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAW,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElG,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,gBAAgB,CA6FtE"}
+{"version":3,"file":"streamText.d.ts","sourceRoot":"","sources":["../../src/api/streamText.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIzF;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2FAA2F;IAC3F,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,yEAAyE;IACzE,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACtC,iFAAiF;IACjF,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,2EAA2E;IAC3E,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3B,yFAAyF;IACzF,SAAS,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,gBAAgB,CA2NtE"}

package/dist/api/streamText.js

@@ -1,8 +1,32 @@
-// packages/agentos/src/api/streamText.ts
+/**
+ * @file streamText.ts
+ * Stateless streaming text generation for the AgentOS high-level API.
+ *
+ * Accepts the same {@link GenerateTextOptions} as {@link generateText} but returns
+ * immediately with async iterables so callers can process tokens incrementally.
+ * Multi-step tool calling is supported: tool-call and tool-result parts are
+ * yielded inline before the next LLM step begins.
+ */
 import { parseModelString, resolveProvider, createProviderManager } from './model.js';
-import { adaptTools } from './tool-adapter.js';
+import { adaptTools } from './toolAdapter.js';
+import { StreamingReconstructor } from '../core/llm/streaming/StreamingReconstructor.js';
 /**
- * Stateless streaming text generation. Returns immediately with async iterables.
+ * Stateless streaming text generation with optional multi-step tool calling.
+ *
+ * Returns a {@link StreamTextResult} immediately; the underlying provider call
+ * begins lazily when a consumer starts iterating `textStream` or `fullStream`.
+ * Awaiting `text`, `usage`, or `toolCalls` will also drain the stream.
+ *
+ * @param opts - Generation options (same shape as {@link generateText}).
+ * @returns A {@link StreamTextResult} with async iterables and awaitable promises.
+ *
+ * @example
+ * ```ts
+ * const { textStream } = streamText({ model: 'openai:gpt-4o', prompt: 'Tell me a joke.' });
+ * for await (const chunk of textStream) {
+ *   process.stdout.write(chunk);
+ * }
+ * ```
  */
 export function streamText(opts) {
     let resolveText;
@@ -12,57 +36,172 @@ export function streamText(opts) {
     const usagePromise = new Promise(r => { resolveUsage = r; });
     const toolCallsPromise = new Promise(r => { resolveToolCalls = r; });
     const parts = [];
-    let fullText = '';
     const allToolCalls = [];
     async function* runStream() {
-        const { providerId, modelId } = parseModelString(opts.model);
-        const resolved = resolveProvider(providerId, modelId, { apiKey: opts.apiKey, baseUrl: opts.baseUrl });
-        const manager = await createProviderManager(resolved);
-        const provider = manager.getProvider(resolved.providerId);
-        if (!provider)
-            throw new Error(`Provider ${resolved.providerId} not available.`);
-        const messages = [];
-        if (opts.system)
-            messages.push({ role: 'system', content: opts.system });
-        if (opts.messages)
-            for (const m of opts.messages)
-                messages.push({ role: m.role, content: m.content });
-        if (opts.prompt)
-            messages.push({ role: 'user', content: opts.prompt });
-        const tools = adaptTools(opts.tools);
-        const toolSchemas = tools.length > 0
-            ? tools.map(t => ({
-                type: 'function',
-                function: { name: t.name, description: t.description, parameters: t.inputSchema },
-            }))
-            : undefined;
-        const stream = provider.generateCompletionStream(resolved.modelId, messages, {
-            tools: toolSchemas,
-            temperature: opts.temperature,
-            maxTokens: opts.maxTokens,
-        });
         const usage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
-        for await (const chunk of stream) {
-            // ModelCompletionResponse uses responseTextDelta for streaming
-            const textDelta = chunk.responseTextDelta
-                ?? chunk.choices?.[0]?.message?.content
-                ?? '';
-            if (textDelta) {
-                fullText += textDelta;
-                const part = { type: 'text', text: textDelta };
-                parts.push(part);
-                yield part;
-            }
-            if (chunk.usage) {
-                const u = chunk.usage;
-                usage.promptTokens += u.promptTokens ?? u.prompt_tokens ?? 0;
-                usage.completionTokens += u.completionTokens ?? u.completion_tokens ?? 0;
-                usage.totalTokens += u.totalTokens ?? u.total_tokens ?? 0;
+        let finalText = '';
+        try {
+            const { providerId, modelId } = parseModelString(opts.model);
+            const resolved = resolveProvider(providerId, modelId, { apiKey: opts.apiKey, baseUrl: opts.baseUrl });
+            const manager = await createProviderManager(resolved);
+            const provider = manager.getProvider(resolved.providerId);
+            if (!provider)
+                throw new Error(`Provider ${resolved.providerId} not available.`);
+            const messages = [];
+            if (opts.system)
+                messages.push({ role: 'system', content: opts.system });
+            if (opts.messages)
+                for (const m of opts.messages)
+                    messages.push({ role: m.role, content: m.content });
+            if (opts.prompt)
+                messages.push({ role: 'user', content: opts.prompt });
+            const tools = adaptTools(opts.tools);
+            const toolMap = new Map();
+            for (const tool of tools)
+                toolMap.set(tool.name, tool);
+            const toolSchemas = tools.length > 0
+                ? tools.map((tool) => ({
+                    type: 'function',
+                    function: { name: tool.name, description: tool.description, parameters: tool.inputSchema },
+                }))
+                : undefined;
+            const maxSteps = opts.maxSteps ?? 1;
+            for (let step = 0; step < maxSteps; step++) {
+                const stream = provider.generateCompletionStream(resolved.modelId, messages, {
+                    tools: toolSchemas,
+                    temperature: opts.temperature,
+                    maxTokens: opts.maxTokens,
+                });
+                const reconstructor = new StreamingReconstructor();
+                for await (const chunk of stream) {
+                    reconstructor.push(chunk);
+                    const textDelta = chunk.responseTextDelta ?? '';
+                    if (textDelta) {
+                        const part = { type: 'text', text: textDelta };
+                        parts.push(part);
+                        yield part;
+                    }
+                    if (chunk.error) {
+                        const error = new Error(chunk.error.message);
+                        const part = { type: 'error', error };
+                        parts.push(part);
+                        yield part;
+                        resolveText(finalText);
+                        resolveUsage(usage);
+                        resolveToolCalls(allToolCalls);
+                        return;
+                    }
+                    if (chunk.isFinal && chunk.usage) {
+                        usage.promptTokens += chunk.usage.promptTokens ?? 0;
+                        usage.completionTokens += chunk.usage.completionTokens ?? 0;
+                        usage.totalTokens += chunk.usage.totalTokens ?? 0;
+                    }
+                }
+                const stepText = reconstructor.getFullText();
+                const finalChunk = reconstructor.getFinalChunk();
+                const streamedToolCalls = finalChunk?.choices?.[0]?.message?.tool_calls
+                    ?? reconstructor.getToolCalls()
+                        .filter((toolCall) => toolCall.id && toolCall.name)
+                        .map((toolCall) => ({
+                        id: toolCall.id,
+                        type: 'function',
+                        function: {
+                            name: toolCall.name,
+                            arguments: toolCall.rawArguments || JSON.stringify(toolCall.arguments ?? {}),
+                        },
+                    }));
+                if (!streamedToolCalls || streamedToolCalls.length === 0) {
+                    finalText = stepText;
+                    resolveText(finalText);
+                    resolveUsage(usage);
+                    resolveToolCalls(allToolCalls);
+                    return;
+                }
+                messages.push({
+                    role: 'assistant',
+                    content: stepText || null,
+                    tool_calls: streamedToolCalls,
+                });
+                for (const toolCall of streamedToolCalls) {
+                    const fnName = toolCall.function?.name ?? '';
+                    const rawArgs = toolCall.function?.arguments ?? '{}';
+                    const toolCallId = toolCall.id ?? '';
+                    let parsedArgs;
+                    try {
+                        parsedArgs = typeof rawArgs === 'string' ? JSON.parse(rawArgs) : rawArgs;
+                    }
+                    catch {
+                        parsedArgs = {};
+                    }
+                    const toolCallRecord = {
+                        name: fnName,
+                        args: parsedArgs,
+                    };
+                    const requestPart = { type: 'tool-call', toolName: fnName, args: parsedArgs };
+                    parts.push(requestPart);
+                    yield requestPart;
+                    const tool = toolMap.get(fnName);
+                    if (!tool) {
+                        toolCallRecord.error = `Tool "${fnName}" not found.`;
+                        const resultPart = { type: 'tool-result', toolName: fnName, result: { error: toolCallRecord.error } };
+                        parts.push(resultPart);
+                        yield resultPart;
+                        messages.push({
+                            role: 'tool',
+                            tool_call_id: toolCallId,
+                            content: JSON.stringify({ error: toolCallRecord.error }),
+                        });
+                        allToolCalls.push(toolCallRecord);
+                        continue;
+                    }
+                    try {
+                        const result = await tool.execute(parsedArgs, {});
+                        toolCallRecord.result = result.output;
+                        toolCallRecord.error = result.success ? undefined : result.error;
+                        const resultPart = {
+                            type: 'tool-result',
+                            toolName: fnName,
+                            result: result.output ?? { error: result.error },
+                        };
+                        parts.push(resultPart);
+                        yield resultPart;
+                        messages.push({
+                            role: 'tool',
+                            tool_call_id: toolCallId,
+                            content: JSON.stringify(result.output ?? { error: result.error ?? 'Tool execution failed.' }),
+                        });
+                    }
+                    catch (err) {
+                        toolCallRecord.error = err?.message ?? String(err);
+                        const resultPart = {
+                            type: 'tool-result',
+                            toolName: fnName,
+                            result: { error: toolCallRecord.error },
+                        };
+                        parts.push(resultPart);
+                        yield resultPart;
+                        messages.push({
+                            role: 'tool',
+                            tool_call_id: toolCallId,
+                            content: JSON.stringify({ error: toolCallRecord.error }),
+                        });
+                    }
+                    allToolCalls.push(toolCallRecord);
+                }
             }
+            resolveText(finalText);
+            resolveUsage(usage);
+            resolveToolCalls(allToolCalls);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            const part = { type: 'error', error };
+            parts.push(part);
+            yield part;
+            resolveText(finalText);
+            resolveUsage(usage);
+            resolveToolCalls(allToolCalls);
         }
-        resolveText(fullText);
-        resolveUsage(usage);
-        resolveToolCalls(allToolCalls);
     }
     const fullStreamIterable = runStream();
     const textStreamIterable = {

package/dist/api/streamText.js.map

@@ -1 +1 @@
-{"version":3,"file":"streamText.js","sourceRoot":"","sources":["../../src/api/streamText.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"streamText.js","sourceRoot":"","sources":["../../src/api/streamText.ts"],"names":[],"mappings":"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"}

package/dist/api/toolAdapter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @file toolAdapter.ts
+ * Adapts user-supplied tool definitions (plain objects, Zod schemas, or {@link ITool}
+ * instances) into the canonical {@link ITool} shape expected by the AgentOS runtime.
+ *
+ * This module is used internally by {@link generateText} and {@link streamText} to
+ * normalise the `tools` option before handing them to a provider.
+ */
+import type { ITool } from '../core/tools/ITool.js';
+/**
+ * Loose tool definition accepted by the high-level API.
+ * Consumers may supply a plain object with an optional Zod or JSON Schema
+ * `parameters` shape plus an `execute` callback.
+ */
+export interface ToolDefinition {
+    /** Human-readable description forwarded to the model in the tool schema. */
+    description?: string;
+    /**
+     * Parameter schema for the tool. Accepts a JSON Schema object or a Zod schema.
+     * When a Zod schema is detected (`_def` property present) the adapter attempts
+     * to convert it via `zod-to-json-schema`, falling back to an empty object schema
+     * if that package is not installed.
+     */
+    parameters?: Record<string, unknown>;
+    /**
+     * Async function that receives the parsed tool arguments and returns any value.
+     * Omit to create a no-op tool (returns `{ success: true }`).
+     */
+    execute?: (args: any) => Promise<any>;
+}
+/** Map of tool name → definition accepted by the high-level API. */
+export type ToolDefinitionMap = Record<string, ToolDefinition | ITool>;
+/**
+ * Converts a {@link ToolDefinitionMap} into an array of {@link ITool} instances
+ * suitable for use with the AgentOS provider layer.
+ *
+ * - Existing {@link ITool} instances (identified by `inputSchema` + `id` properties)
+ *   are passed through unchanged.
+ * - Plain {@link ToolDefinition} objects are wrapped in a minimal {@link ITool}
+ *   implementation.  Zod schemas are converted to JSON Schema when `zod-to-json-schema`
+ *   is available.
+ *
+ * @param tools - Optional map of tool names to definitions. Returns `[]` when falsy.
+ * @returns Flat array of normalised {@link ITool} instances ready for provider dispatch.
+ *
+ * @example
+ * ```ts
+ * const tools = adaptTools({
+ *   getWeather: {
+ *     description: 'Returns current weather for a city.',
+ *     parameters: { type: 'object', properties: { city: { type: 'string' } }, required: ['city'] },
+ *     execute: async ({ city }) => fetchWeather(city),
+ *   },
+ * });
+ * ```
+ */
+export declare function adaptTools(tools: ToolDefinitionMap | undefined): ITool[];
+//# sourceMappingURL=toolAdapter.d.ts.map