genaicode 2.0.0 → 2.3.0

package/dist/core/errors.js

@@ -0,0 +1,118 @@
+function readStatus(error) {
+    if (!error || typeof error !== 'object')
+        return undefined;
+    const candidate = error;
+    for (const value of [candidate.status, candidate.statusCode, candidate.response?.status]) {
+        if (typeof value === 'number')
+            return value;
+    }
+    return undefined;
+}
+function readCode(error) {
+    if (!error || typeof error !== 'object')
+        return undefined;
+    const code = error.code;
+    return typeof code === 'string' ? code : undefined;
+}
+function messageOf(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+/**
+ * Classify a provider/SDK error for application-owned retry loops.
+ *
+ * GenAIcode does not retry automatically. Use this helper (or your own policy)
+ * inside ordinary application control flow. See docs/retry.md.
+ */
+export function classifyError(error) {
+    const status = readStatus(error);
+    const code = readCode(error);
+    const message = messageOf(error).toLowerCase();
+    if (error instanceof DOMException && error.name === 'AbortError') {
+        return { class: 'permanent', retryable: false, reason: 'aborted', cause: error };
+    }
+    if (code === 'ECONNRESET' || code === 'ETIMEDOUT' || code === 'ECONNREFUSED' || code === 'ENOTFOUND') {
+        return { class: 'transient', retryable: true, reason: `network:${code}`, code, cause: error };
+    }
+    if (status === 408 || status === 425 || status === 429 || (status !== undefined && status >= 500)) {
+        return {
+            class: 'transient',
+            retryable: true,
+            reason: `http:${status}`,
+            status,
+            code,
+            cause: error,
+        };
+    }
+    if (status !== undefined && status >= 400 && status < 500) {
+        return {
+            class: 'permanent',
+            retryable: false,
+            reason: `http:${status}`,
+            status,
+            code,
+            cause: error,
+        };
+    }
+    if (message.includes('rate limit') ||
+        message.includes('timeout') ||
+        message.includes('temporar') ||
+        message.includes('unavailable') ||
+        message.includes('overloaded')) {
+        return { class: 'transient', retryable: true, reason: 'message-heuristic', status, code, cause: error };
+    }
+    if (message.includes('invalid') ||
+        message.includes('authentication') ||
+        message.includes('unauthorized') ||
+        message.includes('permission') ||
+        message.includes('not found')) {
+        return { class: 'permanent', retryable: false, reason: 'message-heuristic', status, code, cause: error };
+    }
+    return { class: 'unknown', retryable: false, reason: 'unclassified', status, code, cause: error };
+}
+export function isRetryable(error) {
+    return classifyError(error).retryable;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason instanceof Error ? signal.reason : new DOMException('Aborted', 'AbortError'));
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(timer);
+            reject(signal.reason instanceof Error ? signal.reason : new DOMException('Aborted', 'AbortError'));
+        }, { once: true });
+    });
+}
+/**
+ * Explicit retry helper for application code. Not wired into the client by default.
+ *
+ * Idempotency: only wrap operations that are safe to repeat (most pure generation
+ * calls are; tool side effects are not unless the application makes them idempotent).
+ */
+export async function withRetry(operation, options = {}) {
+    const attempts = Math.max(1, options.attempts ?? 3);
+    const delayMs = options.delayMs ?? 250;
+    const maxDelayMs = options.maxDelayMs ?? 5000;
+    const shouldRetry = options.shouldRetry ?? ((error) => isRetryable(error));
+    let lastError;
+    for (let attempt = 1; attempt <= attempts; attempt += 1) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt >= attempts || !shouldRetry(error, attempt)) {
+                throw error;
+            }
+            const wait = Math.min(maxDelayMs, delayMs * 2 ** (attempt - 1));
+            options.onRetry?.({ attempt, error, delayMs: wait });
+            await sleep(wait, options.signal);
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/middleware.d.ts

@@ -0,0 +1,43 @@
+import type { GenerationRequest, ModelProvider } from './types.js';
+import { type GenAIPlugin } from './plugins.js';
+export interface TimingPluginOptions {
+    onTiming?: (info: {
+        plugin: string;
+        provider?: string;
+        durationMs: number;
+        ok: boolean;
+    }) => void;
+}
+/** Observability middleware: records wall-clock duration around each generate call. */
+export declare function timingPlugin(options?: TimingPluginOptions): GenAIPlugin;
+export interface RateLimitPluginOptions {
+    /** Maximum concurrent in-flight generate calls. Defaults to 1. */
+    concurrency?: number;
+    /** Minimum delay between starting successive calls, in milliseconds. */
+    minIntervalMs?: number;
+}
+/** Simple concurrency / interval limiter. Does not talk to external rate-limit stores. */
+export declare function rateLimitPlugin(options?: RateLimitPluginOptions): GenAIPlugin;
+export interface CachePluginOptions {
+    /** Stable cache key. Defaults to a JSON serialization of the request (excluding signal). */
+    key?: (request: GenerationRequest) => string;
+    maxEntries?: number;
+}
+/** In-memory response cache. Intentionally short-circuits `next` on hit. */
+export declare function cachePlugin(options?: CachePluginOptions): GenAIPlugin;
+export interface FallbackPluginOptions {
+    /** Additional providers tried after the primary provider fails. */
+    providers: readonly ModelProvider[];
+    /** Decide whether an error should trigger fallback. Defaults to always. */
+    shouldFallback?: (error: unknown, attempt: number) => boolean;
+}
+/**
+ * Fallback middleware: on primary failure, try alternate providers in order.
+ * Each alternate receives the same GenerationRequest.
+ */
+export declare function fallbackPlugin(options: FallbackPluginOptions): GenAIPlugin;
+/**
+ * Compose multiple providers into one ModelProvider that tries each until one succeeds.
+ * Prefer this when there is no single "primary" provider wired through plugins.
+ */
+export declare function fallbackProvider(providers: readonly ModelProvider[], name?: string): ModelProvider;

package/dist/core/middleware.js

@@ -0,0 +1,175 @@
+import { definePlugin } from './plugins.js';
+import { providerStream } from './stream.js';
+/** Observability middleware: records wall-clock duration around each generate call. */
+export function timingPlugin(options = {}) {
+    const onTiming = options.onTiming ??
+        ((info) => {
+            console.log(`[genaicode] ${info.plugin} ${info.ok ? 'ok' : 'error'} in ${info.durationMs.toFixed(1)}ms`);
+        });
+    return definePlugin({
+        name: 'timing',
+        async generate(request, next) {
+            const startedAt = performance.now();
+            try {
+                const result = await next(request);
+                onTiming({ plugin: 'timing', durationMs: performance.now() - startedAt, ok: true });
+                return result;
+            }
+            catch (error) {
+                onTiming({ plugin: 'timing', durationMs: performance.now() - startedAt, ok: false });
+                throw error;
+            }
+        },
+    });
+}
+/** Simple concurrency / interval limiter. Does not talk to external rate-limit stores. */
+export function rateLimitPlugin(options = {}) {
+    const concurrency = Math.max(1, options.concurrency ?? 1);
+    const minIntervalMs = Math.max(0, options.minIntervalMs ?? 0);
+    let active = 0;
+    let lastStartedAt = 0;
+    const waiters = [];
+    const pump = () => {
+        while (active < concurrency && waiters.length > 0) {
+            const now = Date.now();
+            // Enforce spacing between starts even when no call is currently in flight
+            // (important for concurrency=1 + minIntervalMs).
+            const waitMs = lastStartedAt === 0 ? 0 : Math.max(0, minIntervalMs - (now - lastStartedAt));
+            if (waitMs > 0) {
+                setTimeout(pump, waitMs);
+                return;
+            }
+            const next = waiters.shift();
+            if (!next)
+                return;
+            active += 1;
+            lastStartedAt = Date.now();
+            next();
+        }
+    };
+    const acquire = () => new Promise((resolve) => {
+        waiters.push(resolve);
+        pump();
+    });
+    const release = () => {
+        active = Math.max(0, active - 1);
+        pump();
+    };
+    return definePlugin({
+        name: 'rate-limit',
+        async generate(request, next) {
+            await acquire();
+            try {
+                return await next(request);
+            }
+            finally {
+                release();
+            }
+        },
+    });
+}
+function defaultCacheKey(request) {
+    return JSON.stringify({
+        prompt: request.prompt,
+        model: request.model,
+        temperature: request.temperature,
+        maxOutputTokens: request.maxOutputTokens,
+        tools: request.tools,
+        toolChoice: request.toolChoice,
+        responseFormat: request.responseFormat,
+        thinking: request.thinking,
+        metadata: request.metadata,
+    });
+}
+/** In-memory response cache. Intentionally short-circuits `next` on hit. */
+export function cachePlugin(options = {}) {
+    const keyOf = options.key ?? defaultCacheKey;
+    const maxEntries = options.maxEntries ?? 128;
+    const cache = new Map();
+    return definePlugin({
+        name: 'cache',
+        async generate(request, next) {
+            const key = keyOf(request);
+            const hit = cache.get(key);
+            if (hit) {
+                cache.delete(key);
+                cache.set(key, hit);
+                return hit;
+            }
+            const result = await next(request);
+            cache.set(key, result);
+            if (cache.size > maxEntries) {
+                const oldest = cache.keys().next().value;
+                if (oldest !== undefined)
+                    cache.delete(oldest);
+            }
+            return result;
+        },
+    });
+}
+/**
+ * Fallback middleware: on primary failure, try alternate providers in order.
+ * Each alternate receives the same GenerationRequest.
+ */
+export function fallbackPlugin(options) {
+    const shouldFallback = options.shouldFallback ?? (() => true);
+    return definePlugin({
+        name: 'fallback',
+        async generate(request, next) {
+            try {
+                return await next(request);
+            }
+            catch (error) {
+                if (!shouldFallback(error, 0))
+                    throw error;
+                let lastError = error;
+                for (let index = 0; index < options.providers.length; index += 1) {
+                    if (!shouldFallback(lastError, index + 1) && index > 0)
+                        throw lastError;
+                    try {
+                        return await options.providers[index].generate(request);
+                    }
+                    catch (fallbackError) {
+                        lastError = fallbackError;
+                    }
+                }
+                throw lastError;
+            }
+        },
+    });
+}
+/**
+ * Compose multiple providers into one ModelProvider that tries each until one succeeds.
+ * Prefer this when there is no single "primary" provider wired through plugins.
+ */
+export function fallbackProvider(providers, name = 'fallback') {
+    if (providers.length === 0) {
+        throw new Error('fallbackProvider requires at least one provider.');
+    }
+    const streamProvider = providers.find((provider) => Boolean(provider.stream)) ?? providers[0];
+    return {
+        name,
+        capabilities: {
+            streaming: providers.some((provider) => provider.capabilities?.streaming || Boolean(provider.stream)),
+            tools: providers.every((provider) => provider.capabilities?.tools !== false),
+            systemPrompt: providers.every((provider) => provider.capabilities?.systemPrompt !== false),
+        },
+        async generate(request) {
+            let lastError;
+            for (const provider of providers) {
+                try {
+                    return await provider.generate(request);
+                }
+                catch (error) {
+                    lastError = error;
+                }
+            }
+            throw lastError instanceof Error ? lastError : new Error(String(lastError));
+        },
+        stream(request) {
+            // Prefer the first provider with a native stream implementation.
+            return providerStream(streamProvider, request);
+        },
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/core/middleware.js.map

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

package/dist/core/plugins.d.ts

@@ -1,8 +1,14 @@
-import type { GenerationRequest, GenerationResult, ModelProvider } from './types.js';
+import type { GenerationRequest, GenerationResult, ModelProvider, StreamEvent } from './types.js';
 export type GenerateNext = (request?: GenerationRequest) => Promise<GenerationResult>;
+export type StreamNext = (request?: GenerationRequest) => AsyncIterable<StreamEvent>;
 export interface GenAIPlugin {
     readonly name: string;
     generate(request: GenerationRequest, next: GenerateNext): Promise<GenerationResult>;
+    /**
+     * Optional streaming middleware. When omitted, the stream path passes through
+     * to the next plugin / provider unchanged.
+     */
+    stream?(request: GenerationRequest, next: StreamNext): AsyncIterable<StreamEvent>;
 }
 export declare function definePlugin(plugin: GenAIPlugin): GenAIPlugin;
 /**
@@ -10,5 +16,6 @@ export declare function definePlugin(plugin: GenAIPlugin): GenAIPlugin;
  *
  * Plugins run in registration order. Each plugin may modify the request passed
  * to `next`, transform its result, handle an error, or intentionally short-circuit.
+ * Streaming uses the same order; plugins without `stream` pass through.
  */
 export declare function withPlugins(provider: ModelProvider, plugins: readonly GenAIPlugin[]): ModelProvider;

package/dist/core/plugins.js

@@ -1,3 +1,4 @@
+import { generateAsStream, providerStream } from './stream.js';
 export function definePlugin(plugin) {
     return plugin;
 }
@@ -6,12 +7,14 @@ export function definePlugin(plugin) {
  *
  * Plugins run in registration order. Each plugin may modify the request passed
  * to `next`, transform its result, handle an error, or intentionally short-circuit.
+ * Streaming uses the same order; plugins without `stream` pass through.
  */
 export function withPlugins(provider, plugins) {
     if (plugins.length === 0)
         return provider;
-    return {
+    const wrapped = {
         name: provider.name,
+        capabilities: provider.capabilities,
         generate(request) {
             let lastIndex = -1;
             const dispatch = (index, currentRequest) => {
@@ -26,6 +29,27 @@ export function withPlugins(provider, plugins) {
             };
             return dispatch(0, request);
         },
+        stream(request) {
+            let lastIndex = -1;
+            const dispatch = (index, currentRequest) => {
+                if (index <= lastIndex) {
+                    throw new Error('A GenAIcode plugin called next() more than once.');
+                }
+                lastIndex = index;
+                const plugin = plugins[index];
+                if (!plugin) {
+                    return provider.stream
+                        ? providerStream(provider, currentRequest)
+                        : generateAsStream((nextRequest) => provider.generate(nextRequest), currentRequest);
+                }
+                if (plugin.stream) {
+                    return plugin.stream(currentRequest, (nextRequest = currentRequest) => dispatch(index + 1, nextRequest));
+                }
+                return dispatch(index + 1, currentRequest);
+            };
+            return dispatch(0, request);
+        },
     };
+    return wrapped;
 }
 //# sourceMappingURL=plugins.js.map

package/dist/core/plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/core/plugins.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAuB,EAAE,OAA+B;IAClF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE1C,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,QAAQ,CAAC,OAAO;YACd,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;YACnB,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,cAAiC,EAA6B,EAAE;gBAC/F,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;oBACvB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC,CAAC;gBACvF,CAAC;gBACD,SAAS,GAAG,KAAK,CAAC;gBAClB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC9B,IAAI,CAAC,MAAM;oBAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;gBACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,WAAW,GAAG,cAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;YAC7G,CAAC,CAAC;YACF,OAAO,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/core/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgB/D,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,QAAuB,EAAE,OAA+B;IAClF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE1C,MAAM,OAAO,GAAkB;QAC7B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,QAAQ,CAAC,OAAO;YACd,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;YACnB,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,cAAiC,EAA6B,EAAE;gBAC/F,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;oBACvB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC,CAAC;gBACvF,CAAC;gBACD,SAAS,GAAG,KAAK,CAAC;gBAClB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC9B,IAAI,CAAC,MAAM;oBAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;gBACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,WAAW,GAAG,cAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;YAC7G,CAAC,CAAC;YACF,OAAO,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,CAAC,OAAO;YACZ,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;YACnB,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,cAAiC,EAA8B,EAAE;gBAChG,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;gBACtE,CAAC;gBACD,SAAS,GAAG,KAAK,CAAC;gBAClB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,QAAQ,CAAC,MAAM;wBACpB,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC;wBAC1C,CAAC,CAAC,gBAAgB,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,CAAC;gBACxF,CAAC;gBACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAClB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,WAAW,GAAG,cAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;gBAC3G,CAAC;gBACD,OAAO,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC;YAC7C,CAAC,CAAC;YACF,OAAO,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/result.d.ts

@@ -1,5 +1,5 @@
-import type { GenerationResult, PromptItem, ToolCall } from './types.js';
+import type { GenerationResult, JsonResultParser, PromptItem, ToolCall } from './types.js';
 export declare function resultText(result: GenerationResult): string;
 export declare function resultToolCalls(result: GenerationResult): ToolCall[];
 export declare function resultToPromptItem(result: GenerationResult): PromptItem;
-export declare function parseJsonResult<T = unknown>(result: GenerationResult, parse?: (value: unknown) => T): T;
+export declare function parseJsonResult<T = unknown>(result: GenerationResult, parse?: JsonResultParser<T>): T;

package/dist/core/result.js

@@ -18,6 +18,10 @@ export function resultToPromptItem(result) {
 export function parseJsonResult(result, parse = (value) => value) {
     const text = resultText(result).trim();
     const fenced = /^```(?:json)?\s*([\s\S]*?)\s*```$/i.exec(text);
-    return parse(JSON.parse(fenced?.[1] ?? text));
+    const parsedValue = JSON.parse(fenced?.[1] ?? text);
+    if (typeof parse === 'function') {
+        return parse(parsedValue);
+    }
+    return parse.parse(parsedValue);
 }
 //# sourceMappingURL=result.js.map

package/dist/core/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,MAAwB;IACjD,OAAO,MAAM,CAAC,KAAK;SAChB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAwB;IACzD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,SAAS;QACrC,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC;QAClC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;KACvF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAAwB,EACxB,QAA+B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAU;IAEpD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAY,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,MAAwB;IACjD,OAAO,MAAM,CAAC,KAAK;SAChB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAwB;IACzD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,SAAS;QACrC,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC;QAClC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;KACvF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAAwB,EACxB,QAA6B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAU;IAElD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAY,CAAC;IAC/D,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC"}

package/dist/core/stream.d.ts

@@ -0,0 +1,11 @@
+import type { GenerationResult, ModelProvider, StreamEvent } from './types.js';
+/**
+ * Turn a completed generation into a short synthetic stream.
+ * Used when a provider (or plugin chain) has no native `stream` implementation.
+ */
+export declare function generateAsStream(generate: (request: Parameters<ModelProvider['generate']>[0]) => Promise<GenerationResult>, request: Parameters<ModelProvider['generate']>[0]): AsyncGenerator<StreamEvent>;
+export declare function providerStream(provider: ModelProvider, request: Parameters<ModelProvider['generate']>[0]): AsyncIterable<StreamEvent>;
+/** Collect a stream into the final `GenerationResult` (from `done` or by accumulation). */
+export declare function collectStream(events: AsyncIterable<StreamEvent>): Promise<GenerationResult>;
+/** Yield only text deltas from a stream. */
+export declare function streamTextDeltas(events: AsyncIterable<StreamEvent>): AsyncGenerator<string>;

package/dist/core/stream.js

@@ -0,0 +1,93 @@
+import { resultText, resultToolCalls } from './result.js';
+/**
+ * Turn a completed generation into a short synthetic stream.
+ * Used when a provider (or plugin chain) has no native `stream` implementation.
+ */
+export async function* generateAsStream(generate, request) {
+    try {
+        const result = await generate(request);
+        const text = resultText(result);
+        if (text) {
+            yield { type: 'text-delta', text };
+        }
+        for (const toolCall of resultToolCalls(result)) {
+            yield { type: 'tool-call', toolCall };
+        }
+        for (const part of result.parts) {
+            if (part.type === 'image') {
+                yield { type: 'image', image: part.image };
+            }
+        }
+        if (result.usage) {
+            yield { type: 'usage', usage: result.usage };
+        }
+        yield { type: 'done', result };
+    }
+    catch (error) {
+        yield { type: 'error', error };
+        throw error;
+    }
+}
+export function providerStream(provider, request) {
+    if (provider.stream) {
+        return provider.stream(request);
+    }
+    return generateAsStream((nextRequest) => provider.generate(nextRequest), request);
+}
+/** Collect a stream into the final `GenerationResult` (from `done` or by accumulation). */
+export async function collectStream(events) {
+    let text = '';
+    const toolCalls = [];
+    const images = [];
+    let usage;
+    let model;
+    let finishReason;
+    let raw;
+    let doneResult;
+    for await (const event of events) {
+        switch (event.type) {
+            case 'text-delta':
+                text += event.text;
+                break;
+            case 'tool-call':
+                toolCalls.push(event.toolCall);
+                break;
+            case 'image':
+                images.push({ type: 'image', image: event.image });
+                break;
+            case 'usage':
+                usage = event.usage;
+                break;
+            case 'done':
+                doneResult = event.result;
+                break;
+            case 'error':
+                throw event.error instanceof Error ? event.error : new Error(String(event.error));
+            case 'tool-call-delta':
+                break;
+        }
+    }
+    if (doneResult) {
+        return doneResult;
+    }
+    const parts = [];
+    if (text)
+        parts.push({ type: 'text', text });
+    for (const toolCall of toolCalls) {
+        parts.push({ type: 'toolCall', toolCall });
+    }
+    parts.push(...images);
+    return { parts, model, finishReason, usage, raw };
+}
+/** Yield only text deltas from a stream. */
+export async function* streamTextDeltas(events) {
+    for await (const event of events) {
+        if (event.type === 'text-delta' && event.text) {
+            yield event.text;
+        }
+        else if (event.type === 'error') {
+            throw event.error instanceof Error ? event.error : new Error(String(event.error));
+        }
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/core/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/core/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG1D;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,gBAAgB,CACrC,QAA0F,EAC1F,OAAiD;IAEjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QACrC,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC1B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/C,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC/B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,QAAuB,EACvB,OAAiD;IAEjD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,gBAAgB,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;AACpF,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAkC;IACpE,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,IAAI,KAAgC,CAAC;IACrC,IAAI,KAAyB,CAAC;IAC9B,IAAI,YAAgC,CAAC;IACrC,IAAI,GAAY,CAAC;IACjB,IAAI,UAAwC,CAAC;IAE7C,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,YAAY;gBACf,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;gBACnB,MAAM;YACR,KAAK,WAAW;gBACd,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;gBACnD,MAAM;YACR,KAAK,OAAO;gBACV,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;gBACpB,MAAM;YACR,KAAK,MAAM;gBACT,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC1B,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACpF,KAAK,iBAAiB;gBACpB,MAAM;QACV,CAAC;IACH,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAEtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACpD,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,gBAAgB,CAAC,MAAkC;IACxE,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC9C,MAAM,KAAK,CAAC,IAAI,CAAC;QACnB,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAClC,MAAM,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;AACH,CAAC"}