@aeye/core 0.3.1 → 0.3.4

package/dist/agent.d.ts

@@ -21,6 +21,10 @@ export interface AgentInput<TContext = {}, TMetadata = {}, TName extends string
     call: (input: TInput, refs: TRefs, ctx: Context<TContext, TMetadata>) => TOutput;
     /** Optional function to determine if the component is applicable in the given context */
     applicable?: (ctx: Context<TContext, TMetadata>) => boolean | Promise<boolean>;
+    /** Metadata about the agent to be passed during execution/streaming. Typically contains requirements, configuration, etc. */
+    metadata?: TMetadata;
+    /** A function/promise that returns metadata about the agent to be passed during execution/streaming. */
+    metadataFn?: (input: TInput, ctx: Context<TContext, TMetadata>) => TMetadata | Promise<TMetadata>;
     /** Optional way to explicitly declare the types used in this component */
     types?: {
         input?: TInput;
@@ -54,12 +58,13 @@ export interface AgentInput<TContext = {}, TMetadata = {}, TName extends string
  */
 export declare class Agent<TContext = {}, TMetadata = {}, TName extends string = string, TInput extends object = {}, TOutput = string, TRefs extends Tuple<ComponentCompatible<TContext, TMetadata>> = []> implements Component<TContext, TMetadata, TName, TInput, TOutput, TRefs> {
     input: AgentInput<TContext, TMetadata, TName, TInput, TOutput, TRefs>;
+    private metadataFn;
     /**
      * Creates a new Agent instance.
      *
      * @param input - The agent input configuration.
      */
-    constructor(input: AgentInput<TContext, TMetadata, TName, TInput, TOutput, TRefs>);
+    constructor(input: AgentInput<TContext, TMetadata, TName, TInput, TOutput, TRefs>, metadataFn?: (input: TInput, ctx: Context<TContext, TMetadata>) => Promise<TMetadata | undefined>);
     get kind(): 'agent';
     get name(): TName;
     get description(): string;
@@ -81,5 +86,15 @@ export declare class Agent<TContext = {}, TMetadata = {}, TName extends string =
      * @returns A promise that resolves to true if the agent is applicable, false otherwise.
      */
     applicable<TRuntimeContext extends TContext, TRuntimeMetadata extends TMetadata, TCoreContext extends Context<TRuntimeContext, TRuntimeMetadata>>(...[contextMaybe]: OptionalParams<[TCoreContext]>): Promise<boolean>;
+    /**
+     * Returns metadata for the agent based on the input and context.
+     * Combines static metadata with dynamically generated metadata from metadataFn.
+     *
+     * @param input - The input for the agent.
+     * @param ctx - The context for the agent's operation.
+     * @returns The metadata for the agent.
+     */
+    metadata(): TMetadata;
+    metadata<TRuntimeContext extends TContext, TRuntimeMetadata extends TMetadata, TCoreContext extends Context<TRuntimeContext, TRuntimeMetadata>>(input?: TInput, ctx?: TCoreContext): Promise<TMetadata>;
 }
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEvG;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU,CACzB,QAAQ,GAAG,EAAE,EACb,SAAS,GAAG,EAAE,EACd,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,MAAM,SAAS,MAAM,GAAG,EAAE,EAC1B,OAAO,GAAG,MAAM,EAChB,KAAK,SAAS,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE;IAEtC,mCAAmC;IACnC,IAAI,EAAE,KAAK,CAAC;IACZ,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,IAAI,EAAE,KAAK,CAAC;IACZ,wDAAwD;IACxD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,KAAK,OAAO,CAAC;IACjF,yFAAyF;IACzF,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/E,0EAA0E;IAC1E,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;KACtB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,KAAK,CAChB,QAAQ,GAAG,EAAE,EACb,SAAS,GAAG,EAAE,EACd,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,MAAM,SAAS,MAAM,GAAG,EAAE,EAC1B,OAAO,GAAG,MAAM,EAChB,KAAK,SAAS,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,GAAG,EAAE,CAClE,YAAW,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;IAQ/D,KAAK,EAAE,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;IAN9E;;;;OAIG;gBAEM,KAAK,EAAE,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;IAG9E,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,IAAI,IAAI,KAAK,CAEhB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,IAAI,IAAI,KAAK,CAEhB;IAED;;;;;;;OAOG;IACH,GAAG,CACD,eAAe,SAAS,QAAQ,EAChC,gBAAgB,SAAS,SAAS,EAClC,YAAY,SAAS,OAAO,CAAC,eAAe,EAAE,gBAAgB,CAAC,EAC/D,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,cAAc,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,GAAG,OAAO;IAUjF;;;;;;OAMG;IACG,UAAU,CACd,eAAe,SAAS,QAAQ,EAChC,gBAAgB,SAAS,SAAS,EAClC,YAAY,SAAS,OAAO,CAAC,eAAe,EAAE,gBAAgB,CAAC,EAC/D,GAAG,CAAC,YAAY,CAAC,EAAE,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAevE"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/dist/agent.js

@@ -1,3 +1,4 @@
+import { resolveFn } from "./common";
 /**
  * An Agent component that orchestrates complex workflows by composing other AI components.
  * Agents can utilize tools, prompts, and other agents to accomplish sophisticated tasks.
@@ -23,13 +24,15 @@
  */
 export class Agent {
     input;
+    metadataFn;
     /**
      * Creates a new Agent instance.
      *
      * @param input - The agent input configuration.
      */
-    constructor(input) {
+    constructor(input, metadataFn = resolveFn(input.metadataFn)) {
         this.input = input;
+        this.metadataFn = metadataFn;
     }
     get kind() {
         return 'agent';
@@ -77,5 +80,17 @@ export class Agent {
         }
         return await Promise.all(this.refs.map(ref => ref.applicable(ctx))).then(results => results.some(r => r));
     }
+    metadata(input, ctx) {
+        // If both input and context are not specified, just return static metadata
+        if (input === undefined && ctx === undefined) {
+            return (this.input.metadata || {});
+        }
+        const actualInput = (input || {});
+        const actualCtx = (ctx || {});
+        return this.metadataFn(actualInput, actualCtx).then(dynamicMetadata => ({
+            ...(this.input.metadata || {}),
+            ...(dynamicMetadata || {}),
+        }));
+    }
 }
 //# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAwCA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,KAAK;IAeP;IANT;;;;OAIG;IACH,YACS,KAAqE;QAArE,UAAK,GAAL,KAAK,CAAgE;IAC1E,CAAC;IAEL,IAAI,IAAI;QACN,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;IAChC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CAID,GAAG,CAAC,UAAU,EAAE,YAAY,CAAyC;QACrE,MAAM,KAAK,GAAG,CAAC,UAAU,IAAI,EAAE,CAAW,CAAC;QAC3C,MAAM,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAiC,CAAC;QACjE,MAAM,KAAK,GAAG,IAAqE,CAAC;QAEpF,OAAO,GAAG,CAAC,MAAM;YACf,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAChG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAId,GAAG,CAAC,YAAY,CAAiC;QACjD,MAAM,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAiC,CAAC;QAEjE,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;QAED,mEAAmE;QACnE,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5G,CAAC;CAEF"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/dist/browser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Browser-safe exports from @aeye/core.
+ * This entry point excludes Node.js-only utilities (to.ts) that depend on fs, path, and stream.
+ */
+export * from './types';
+export * from './common';
+export * from './schema';
+export * from './tool';
+export * from './prompt';
+export * from './agent';
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/browser.js

@@ -0,0 +1,11 @@
+/**
+ * Browser-safe exports from @aeye/core.
+ * This entry point excludes Node.js-only utilities (to.ts) that depend on fs, path, and stream.
+ */
+export * from './types';
+export * from './common';
+export * from './schema';
+export * from './tool';
+export * from './prompt';
+export * from './agent';
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/common.d.ts

@@ -1,5 +1,4 @@
-import { Chunk, Model, ModelInput, Response, Runner, Usage, Events, Resource } from "./types";
-import { Readable } from 'stream';
+import { Chunk, Events, Model, ModelInput, Reasoning, Response, Runner, Usage } from "./types";
 /**
  * A flexible function type that can be:
  * - A direct value of type R
@@ -96,74 +95,6 @@ export declare function consumeAll<E>(gen: AsyncGenerator<E, any, any>): Promise
  * Resolves the type R from a value passed to `resolve`.
  */
 export type Resolved<T> = T extends Promise<infer U> ? Resolved<U> : T extends AsyncGenerator<any, infer U, any> ? Resolved<U> : T;
-/**
- * Determines the ideal format of a given resource.
- *
- * @param resource
- * @returns
- */
-export declare function getResourceFormat(resource: Resource): 'url' | 'base64' | 'stream';
-/**
- * Converts the input resource to a URL string.
- *
- * For input string:
- * - If input is already a URL or string, it is returned as-is.
- * - If input is a data URL (e.g. base64), it is returned as-is.
- * - Otherwise it is base64-encoded and returned as a data URL.
- *
- * For URL:
- * - It is returned with toString().
- *
- * For Uint8Array/File/ReadStream/ReadableStream:
- * - It is base64-encoded and returned as a data URL.
- *
- * @param input - The resource to convert.
- * @param mimeType - Optional MIME type for the data URL if one cannot be determined.
- * @param fallback - Optional fallback string to return if input type is invalid.
- * @returns http(s) URL or data URL string
- */
-export declare function toURL(input: Resource, mimeType?: string, fallback?: string): Promise<string>;
-/**
- * Converts the input resource to a Base64 data URL string.
- * This will represent the content of the resouce as a data URL.
- *
- * @param input - The resource to convert.
- * @param mimeType - Optional MIME type for the data URL if one cannot be determined.
- * @param fallback - Optional fallback string to return if input type is invalid.
- * @returns - A promise that resolves to a Base64 data URL string.
- */
-export declare function toBase64(input: Resource, mimeType?: string, fallback?: string): Promise<string>;
-/**
- * Converts the input resource to a text string. It assumes it points to resource
- * that is text or points to a text file.
- *
- * @param input - The resource to convert.
- * @param fallback - Optional fallback string to return if conversion fails.
- * @returns - A promise that resolves to a text string.
- */
-export declare function toText(input: Resource, fallback?: string): Promise<string>;
-/**
- * Converts the input resource to an AsyncIterable stream of Uint8Array chunks.
- *
- * @param input - The resource to convert.
- * @returns A promise that resolves to an AsyncIterable of Uint8Array chunks, or null if conversion fails.
- */
-export declare function toStream(input: Resource, fallback?: Readable): Promise<Readable>;
-/**
- * Converts the input resource to a ReadableStream.
- *
- * @param input - The resource to convert.
- * @param fallback - Optional fallback ReadableStream to use if conversion fails.
- * @returns A promise that resolves to a ReadableStream.
- */
-export declare function toReadableStream(input: Resource, fallback?: ReadableStream): Promise<ReadableStream>;
-/**
- * Converts the input resource to a File.
- *
- * @param input - The resource to convert.
- * @returns A promise that resolves to an AsyncIterable of Uint8Array chunks, or null if conversion fails.
- */
-export declare function toFile(input: Resource, mimeType?: string, filename?: string): Promise<File>;
 /**
  * Accumulates usage statistics by adding values from one Usage object to another.
  * Handles the nested structure matching ModelPricing.
@@ -214,6 +145,21 @@ export declare function getModel(input: ModelInput | undefined): Model | undefin
  * @returns The aggregated Response object.
  */
 export declare function getResponseFromChunks(chunks: Chunk[], model?: ModelInput): Response;
+/**
+ * Generates a plain text representation of reasoning data.
+ *
+ * @param reasoning - The reasoning data to convert.
+ * @returns A plain text string representing the reasoning.
+ */
+export declare function getReasoningText(reasoning: Reasoning | undefined): string;
+/**
+ * Accumulates reasoning data by merging an additional Reasoning object into a target Reasoning object.
+ *
+ * @param target - The target Reasoning object to accumulate into.
+ * @param add - The Reasoning object to add from.
+ * @returns - The updated Reasoning object.
+ */
+export declare function accumulateReasoning(target: Reasoning | undefined, add?: Reasoning): Reasoning | undefined;
 /**
  * Converts a Response object into an array of Chunk objects.
  *

package/dist/common.d.ts.map

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

package/dist/common.js

@@ -1,7 +1,3 @@
-import fs from 'fs';
-import path from 'path';
-import url from 'url';
-import { Readable } from 'stream';
 export function resolveFn(fn, reprocess) {
     if (!fn) {
         return async () => undefined;
@@ -131,312 +127,6 @@ export async function consumeAll(gen) {
     }
     return results;
 }
-function hasUrl(x) {
-    return x && typeof x.url === 'function';
-}
-function hasBlob(x) {
-    return x && typeof x.blob === 'function';
-}
-function hasRead(x) {
-    return x && typeof x.read === 'function';
-}
-function isAsyncIterable(x) {
-    return x && typeof x[Symbol.asyncIterator] === 'function';
-}
-/**
- * Determines the ideal format of a given resource.
- *
- * @param resource
- * @returns
- */
-export function getResourceFormat(resource) {
-    if (typeof resource === 'string') {
-        if (resource.startsWith('data:')) {
-            return 'base64';
-        }
-        else if (resource.startsWith('http://') || resource.startsWith('https://')) {
-            return 'url';
-        }
-        else {
-            return 'base64';
-        }
-    }
-    if (hasUrl(resource) || resource instanceof URL) {
-        return 'url';
-    }
-    return 'stream';
-}
-/**
- * Converts the input resource to a URL string.
- *
- * For input string:
- * - If input is already a URL or string, it is returned as-is.
- * - If input is a data URL (e.g. base64), it is returned as-is.
- * - Otherwise it is base64-encoded and returned as a data URL.
- *
- * For URL:
- * - It is returned with toString().
- *
- * For Uint8Array/File/ReadStream/ReadableStream:
- * - It is base64-encoded and returned as a data URL.
- *
- * @param input - The resource to convert.
- * @param mimeType - Optional MIME type for the data URL if one cannot be determined.
- * @param fallback - Optional fallback string to return if input type is invalid.
- * @returns http(s) URL or data URL string
- */
-export async function toURL(input, mimeType, fallback) {
-    if (input instanceof URL) {
-        return input.toString();
-    }
-    if (typeof input === 'string' && (input.startsWith('data:') || input.startsWith('http://') || input.startsWith('https://'))) {
-        return input;
-    }
-    if (hasUrl(input)) {
-        return input.url();
-    }
-    return toBase64(input, mimeType, fallback);
-}
-/**
- * Converts the input resource to a Base64 data URL string.
- * This will represent the content of the resouce as a data URL.
- *
- * @param input - The resource to convert.
- * @param mimeType - Optional MIME type for the data URL if one cannot be determined.
- * @param fallback - Optional fallback string to return if input type is invalid.
- * @returns - A promise that resolves to a Base64 data URL string.
- */
-export async function toBase64(input, mimeType, fallback) {
-    if (typeof input === 'string') {
-        if (input.startsWith('data:')) {
-            return input;
-        }
-        if (input.startsWith('http://') || input.startsWith('https://')) {
-            input = new URL(input);
-        }
-        else if (input.startsWith('file://')) {
-            const filePath = url.fileURLToPath(input);
-            input = fs.createReadStream(filePath);
-        }
-        else {
-            return `data:${mimeType || 'text/plain'};base64,${Buffer.from(input).toString('base64')}`;
-        }
-    }
-    if (hasUrl(input)) {
-        input = new URL(input.url());
-    }
-    if (input instanceof URL) {
-        input = await (await fetch(input)).blob();
-    }
-    if (typeof input !== 'object') {
-        if (fallback !== undefined) {
-            return fallback;
-        }
-        throw new Error('Invalid input type');
-    }
-    if (hasBlob(input)) {
-        input = await input.blob();
-    }
-    if (hasRead(input)) {
-        input = await input.read();
-    }
-    if ('type' in input && typeof input.type === 'string' && input.type.length > 0) {
-        mimeType = input.type;
-    }
-    if ('mimeType' in input && typeof input.mimeType === 'string' && input.mimeType.length > 0) {
-        mimeType = input.mimeType;
-    }
-    if (input instanceof Blob) {
-        input = await input.arrayBuffer();
-    }
-    if (input instanceof DataView) {
-        input = Buffer.from(input.buffer);
-    }
-    if (input instanceof ArrayBuffer) {
-        input = Buffer.from(input);
-    }
-    if (isAsyncIterable(input)) {
-        const chunks = [];
-        for await (const chunk of input) {
-            chunks.push(chunk);
-        }
-        input = Buffer.concat(chunks);
-    }
-    const buffer = Buffer.isBuffer(input)
-        ? input
-        : Buffer.from(input);
-    const base64 = buffer.toString('base64');
-    return `data:${mimeType || 'application/octet-stream'};base64,${base64}`;
-}
-/**
- * Converts the input resource to a text string. It assumes it points to resource
- * that is text or points to a text file.
- *
- * @param input - The resource to convert.
- * @param fallback - Optional fallback string to return if conversion fails.
- * @returns - A promise that resolves to a text string.
- */
-export async function toText(input, fallback = 'Unable to convert resource to text') {
-    if (typeof input === 'string') {
-        if (input.startsWith('data:')) {
-            const commaIndex = input.indexOf(',');
-            if (commaIndex >= 0) {
-                const base64Part = input.substring(commaIndex + 1);
-                const buffer = Buffer.from(base64Part, 'base64');
-                return buffer.toString('utf-8');
-            }
-        }
-        return input;
-    }
-    const stream = await toStream(input);
-    if (!stream) {
-        return fallback;
-    }
-    const decoded = new TextDecoder();
-    let text = '';
-    for await (const chunk of stream) {
-        text += decoded.decode(chunk);
-    }
-    return text;
-}
-/**
- * Converts the input resource to an AsyncIterable stream of Uint8Array chunks.
- *
- * @param input - The resource to convert.
- * @returns A promise that resolves to an AsyncIterable of Uint8Array chunks, or null if conversion fails.
- */
-export async function toStream(input, fallback) {
-    if (typeof input === 'string') {
-        if (input.startsWith('data:')) {
-            const commaIndex = input.indexOf(',');
-            if (commaIndex >= 0) {
-                const base64Part = input.substring(commaIndex + 1);
-                const buffer = Buffer.from(base64Part, 'base64');
-                return Readable.from([buffer]);
-            }
-        }
-        if (input.startsWith('http://') || input.startsWith('https://')) {
-            input = new URL(input);
-        }
-        else if (input.startsWith('file://')) {
-            const filePath = url.fileURLToPath(input);
-            input = fs.createReadStream(filePath);
-        }
-        else {
-            return Readable.from([Buffer.from(input, 'utf-8')]);
-        }
-    }
-    if (hasUrl(input)) {
-        input = new URL(input.url());
-    }
-    if (input instanceof URL) {
-        const response = await fetch(input);
-        if (!response.ok) {
-            if (fallback) {
-                return fallback;
-            }
-            throw new Error(`Failed to fetch ${input}: ${response.status} ${response.statusText}`);
-        }
-        if (!response.body) {
-            if (fallback) {
-                return fallback;
-            }
-            throw new Error(`No response body from ${input}`);
-        }
-        return Readable.from(response.body);
-    }
-    if (hasRead(input)) {
-        input = await input.read();
-    }
-    if (hasBlob(input)) {
-        input = await input.blob();
-    }
-    if (input instanceof Blob) {
-        input = input.stream();
-    }
-    if (input instanceof DataView) {
-        input = Buffer.from(input.buffer);
-    }
-    if (input instanceof ArrayBuffer) {
-        input = Buffer.from(input);
-    }
-    return Readable.from(input);
-}
-/**
- * Converts the input resource to a ReadableStream.
- *
- * @param input - The resource to convert.
- * @param fallback - Optional fallback ReadableStream to use if conversion fails.
- * @returns A promise that resolves to a ReadableStream.
- */
-export async function toReadableStream(input, fallback) {
-    return ReadableStream.from(await toStream(input, fallback ? Readable.fromWeb(fallback) : undefined));
-}
-/**
- * Converts the input resource to a File.
- *
- * @param input - The resource to convert.
- * @returns A promise that resolves to an AsyncIterable of Uint8Array chunks, or null if conversion fails.
- */
-export async function toFile(input, mimeType, filename) {
-    if (typeof input === 'string') {
-        if (input.startsWith('data:')) {
-            const [, type, base64Part] = input.substring(5).split(';base64,', 2);
-            mimeType = type || mimeType;
-            input = Buffer.from(base64Part, 'base64');
-        }
-        else if (input.startsWith('http://') || input.startsWith('https://')) {
-            input = new URL(input);
-        }
-        else if (input.startsWith('file://')) {
-            const filePath = url.fileURLToPath(input);
-            input = await fs.openAsBlob(filePath);
-            if (!filename) {
-                filename = path.basename(filePath);
-            }
-            if (input.type && !mimeType) {
-                mimeType = input.type;
-            }
-        }
-        else {
-            if (!mimeType) {
-                mimeType = 'text/plain';
-            }
-            input = Buffer.from(input, 'utf-8');
-        }
-    }
-    if (input instanceof File) {
-        return input;
-    }
-    if (hasUrl(input)) {
-        input = new URL(input.url());
-    }
-    if (input instanceof URL) {
-        if (!filename) {
-            filename = path.basename(input.pathname);
-        }
-        input = await fetch(input);
-    }
-    if (hasBlob(input)) {
-        input = await input.blob();
-    }
-    if (hasRead(input)) {
-        input = await input.read();
-    }
-    if (input instanceof ArrayBuffer) {
-        input = new Blob([input]);
-    }
-    if (isAsyncIterable(input)) {
-        const chunks = [];
-        for await (const chunk of input) {
-            chunks.push(chunk);
-        }
-        input = new Blob(chunks);
-    }
-    return new File([input], filename || 'file', {
-        type: mimeType || 'application/octet-stream',
-    });
-}
 /**
  * Accumulates usage statistics by adding values from one Usage object to another.
  * Handles the nested structure matching ModelPricing.
@@ -613,7 +303,7 @@ export function getResponseFromChunks(chunks, model = 'unknown') {
             resp.finishReason = chunk.finishReason;
         }
         if (chunk.reasoning) {
-            resp.reasoning = (resp.reasoning || '') + chunk.reasoning;
+            resp.reasoning = accumulateReasoning(resp.reasoning, chunk.reasoning);
         }
         if (chunk.model) {
             resp.model = chunk.model;
@@ -632,6 +322,80 @@ export function getResponseFromChunks(chunks, model = 'unknown') {
     }
     return resp;
 }
+/**
+ * Generates a plain text representation of reasoning data.
+ *
+ * @param reasoning - The reasoning data to convert.
+ * @returns A plain text string representing the reasoning.
+ */
+export function getReasoningText(reasoning) {
+    if (!reasoning) {
+        return '';
+    }
+    const parts = [];
+    if (reasoning.content) {
+        parts.push(reasoning.content);
+    }
+    else if (reasoning?.details) {
+        for (const detail of reasoning.details) {
+            if (detail.summary) {
+                parts.push(detail.summary);
+            }
+            if (detail.text) {
+                parts.push(detail.text);
+            }
+        }
+    }
+    return parts.join('\n\n');
+}
+/**
+ * Accumulates reasoning data by merging an additional Reasoning object into a target Reasoning object.
+ *
+ * @param target - The target Reasoning object to accumulate into.
+ * @param add - The Reasoning object to add from.
+ * @returns - The updated Reasoning object.
+ */
+export function accumulateReasoning(target, add) {
+    if (!target) {
+        return add;
+    }
+    if (!add) {
+        return target;
+    }
+    if (add.content) {
+        target.content = (target.content || '') + add.content;
+    }
+    if (add.details?.length) {
+        target.details = target.details || [];
+        for (const detail of add.details) {
+            let existing = target.details.find(d => (detail.id && d.id && detail.id === d.id) ||
+                (detail.index !== undefined && d.index !== undefined && detail.index === d.index));
+            const missingIdentifiers = add.details.every(d => !d.id && d.index === undefined) &&
+                target.details.every(d => !d.id && d.index === undefined);
+            if (missingIdentifiers) {
+                existing = target.details.find(d => d.type === detail.type);
+            }
+            if (existing) {
+                if (detail.data) {
+                    existing.data = (existing.data || '') + detail.data;
+                }
+                if (detail.text) {
+                    existing.text = (existing.text || '') + detail.text;
+                    if (detail.signature) {
+                        existing.signature = detail.signature;
+                    }
+                }
+                if (detail.summary) {
+                    existing.summary = (existing.summary || '') + detail.summary;
+                }
+            }
+            else {
+                target.details.push(detail);
+            }
+        }
+    }
+    return target;
+}
 /**
  * Converts a Response object into an array of Chunk objects.
  *