@node-llm/core 1.15.2 → 1.16.0

package/dist/providers/openai/Streaming.js

@@ -4,7 +4,7 @@ import { buildUrl } from "./utils.js";
 import { APIError } from "../../errors/index.js";
 import { logger } from "../../utils/logger.js";
 import { fetchWithTimeout } from "../../utils/fetch.js";
-import { mapSystemMessages } from "../utils.js";
+import { mapSystemMessages, normalizeOpenAIToolChoice } from "../utils.js";
 import { enforceStrictSchema } from "../../schema/strict.js";
 export class OpenAIStreaming {
     providerOrUrl;
@@ -72,6 +72,12 @@ export class OpenAIStreaming {
                 return tool;
             });
         }
+        if (request.tool_choice) {
+            body.tool_choice = normalizeOpenAIToolChoice(request.tool_choice);
+        }
+        if (request.parallel_tool_calls !== undefined) {
+            body.parallel_tool_calls = request.parallel_tool_calls;
+        }
         if (request.prediction) {
             body.prediction = {
                 type: "content",

package/dist/providers/openai/Transcription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transcription.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/Transcription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAwB,MAAM,gBAAgB,CAAC;AAQnG,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM;IAG3B,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;YAU9D,oBAAoB;YA8DpB,iBAAiB;CAgIhC"}
+{"version":3,"file":"Transcription.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/Transcription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAwB,MAAM,gBAAgB,CAAC;AAQnG,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM;IAG3B,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;YAU9D,oBAAoB;YAuEpB,iBAAiB;CAgIhC"}

package/dist/providers/openai/Transcription.js

@@ -32,6 +32,9 @@ export class OpenAITranscription {
         if (request.language) {
             formData.append("language", request.language);
         }
+        if (request.timestamp_granularities) {
+            request.timestamp_granularities.forEach((g) => formData.append("timestamp_granularities[]", g));
+        }
         const url = buildUrl(this.baseUrl, "/audio/transcriptions");
         logger.logRequest("OpenAI", "POST", url, {
             model: request.model || DEFAULT_MODELS.TRANSCRIPTION,
@@ -57,8 +60,10 @@ export class OpenAITranscription {
                 id: s.id,
                 start: s.start,
                 end: s.end,
-                text: s.text
-            }))
+                text: s.text,
+                speaker: s.speaker
+            })),
+            words: json.words
         };
     }
     async transcribeViaChat(request) {

package/dist/providers/openrouter/Capabilities.d.ts

@@ -1,13 +1,14 @@
 export declare class OpenRouterCapabilities {
     private static findModel;
-    static supportsVision(model: string): boolean;
-    static supportsTools(model: string): boolean;
-    static supportsStructuredOutput(model: string): boolean;
-    static supportsEmbeddings(model: string): boolean;
-    static supportsImageGeneration(_model: string): boolean;
-    static supportsTranscription(_model: string): boolean;
-    static supportsModeration(_model: string): boolean;
-    static supportsReasoning(model: string): boolean;
-    static getContextWindow(model: string): number | null;
+    static supportsVision(modelId: string): boolean;
+    static supportsTools(modelId: string): boolean;
+    static supportsStructuredOutput(modelId: string): boolean;
+    static supportsEmbeddings(modelId: string): boolean;
+    static supportsImageGeneration(_modelId: string): boolean;
+    static supportsTranscription(_modelId: string): boolean;
+    static supportsModeration(_modelId: string): boolean;
+    static supportsReasoning(modelId: string): boolean;
+    static supportsToolChoice(_modelId: string): boolean;
+    static getContextWindow(modelId: string): number | null;
 }
 //# sourceMappingURL=Capabilities.d.ts.map

package/dist/providers/openrouter/Capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Capabilities.d.ts","sourceRoot":"","sources":["../../../src/providers/openrouter/Capabilities.ts"],"names":[],"mappings":"AAEA,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,SAAS;IAIxB,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAiB7C,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAU5C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAQvD,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAQjD,MAAM,CAAC,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIvD,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIrD,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIlD,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAahD,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAItD"}
+{"version":3,"file":"Capabilities.d.ts","sourceRoot":"","sources":["../../../src/providers/openrouter/Capabilities.ts"],"names":[],"mappings":"AAEA,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,SAAS;IAIxB,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAO/C,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAQ9C,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAOzD,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMnD,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzD,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIvD,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpD,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAOlD,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAGxD"}

package/dist/providers/openrouter/Capabilities.js

@@ -1,64 +1,41 @@
 import { ModelRegistry } from "../../models/ModelRegistry.js";
 export class OpenRouterCapabilities {
-    static findModel(model) {
-        return ModelRegistry.find(model, "openrouter");
+    static findModel(modelId) {
+        return ModelRegistry.find(modelId, "openrouter");
     }
-    static supportsVision(model) {
-        const info = this.findModel(model);
-        if (info)
-            return info.capabilities.includes("vision") || info.modalities.input.includes("image");
-        // Fallback heuristics
-        return (model.includes("vision") ||
-            model.includes("gpt-4o") ||
-            model.includes("claude-3") ||
-            model.includes("gemini-1.5") ||
-            model.includes("gemini-2.0") ||
-            model.includes("flash") ||
-            model.includes("gemini-pro-vision"));
+    static supportsVision(modelId) {
+        return (ModelRegistry.supports(modelId, "vision", "openrouter") ||
+            /vision|gpt-4o|claude-3|gemini|flash/.test(modelId.toLowerCase()));
     }
-    static supportsTools(model) {
-        const info = this.findModel(model);
-        if (info)
-            return info.capabilities.includes("tools") || info.capabilities.includes("function_calling");
-        // Fallback: Default to true for OpenRouter as most models support tools
-        // but this is the "honest" check we wanted.
-        return true;
+    static supportsTools(modelId) {
+        return (ModelRegistry.supports(modelId, "tools", "openrouter") ||
+            ModelRegistry.supports(modelId, "function_calling", "openrouter") ||
+            true); // OpenRouter usually supports tools on most modern models
     }
-    static supportsStructuredOutput(model) {
-        const info = this.findModel(model);
-        if (info)
-            return info.capabilities.includes("structured_output") || info.id.includes("gpt-4");
-        // Fallback heuristics
-        return model.includes("gpt-4") || model.includes("gpt-3.5") || model.includes("claude-3");
+    static supportsStructuredOutput(modelId) {
+        return (ModelRegistry.supports(modelId, "structured_output", "openrouter") ||
+            /gpt-4|gpt-3\.5|claude-3/.test(modelId.toLowerCase()));
     }
-    static supportsEmbeddings(model) {
-        const info = this.findModel(model);
-        if (info)
-            return info.capabilities.includes("embeddings");
-        // Fallback heuristics
-        return model.includes("embedding") || model.includes("text-sdk");
+    static supportsEmbeddings(modelId) {
+        return (ModelRegistry.supports(modelId, "embeddings", "openrouter") || modelId.includes("embedding"));
     }
-    static supportsImageGeneration(_model) {
+    static supportsImageGeneration(_modelId) {
         return false;
     }
-    static supportsTranscription(_model) {
+    static supportsTranscription(_modelId) {
         return false;
     }
-    static supportsModeration(_model) {
+    static supportsModeration(_modelId) {
         return false;
     }
-    static supportsReasoning(model) {
-        const info = this.findModel(model);
-        if (info)
-            return info.capabilities.includes("reasoning");
-        // Fallback heuristics
-        return (model.includes("o1") ||
-            model.includes("o3") ||
-            model.includes("deepseek-r1") ||
-            model.includes("qwq"));
+    static supportsReasoning(modelId) {
+        return (ModelRegistry.supports(modelId, "reasoning", "openrouter") ||
+            /o1-|o3-|reasoner|-r1|qwq/.test(modelId.toLowerCase()));
+    }
+    static supportsToolChoice(_modelId) {
+        return true;
     }
-    static getContextWindow(model) {
-        const info = this.findModel(model);
-        return info?.context_window ?? null;
+    static getContextWindow(modelId) {
+        return ModelRegistry.getContextWindow(modelId, "openrouter") ?? null;
     }
 }

package/dist/providers/utils.d.ts

@@ -5,4 +5,8 @@ import { Message } from "../chat/Message.js";
  * If supportsDeveloperRole is false, both "system" and "developer" messages are mapped to "system".
  */
 export declare function mapSystemMessages(messages: Message[], supportsDeveloperRole: boolean): Message[];
+/**
+ * Normalizes tool choice for OpenAI-compatible providers.
+ */
+export declare function normalizeOpenAIToolChoice(choice: any): any;
 //# sourceMappingURL=utils.d.ts.map

package/dist/providers/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/providers/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,qBAAqB,EAAE,OAAO,GAAG,OAAO,EAAE,CAUhG"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/providers/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,qBAAqB,EAAE,OAAO,GAAG,OAAO,EAAE,CAUhG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAM1D"}

package/dist/providers/utils.js

@@ -14,3 +14,14 @@ export function mapSystemMessages(messages, supportsDeveloperRole) {
         return msg;
     });
 }
+/**
+ * Normalizes tool choice for OpenAI-compatible providers.
+ */
+export function normalizeOpenAIToolChoice(choice) {
+    if (!choice)
+        return undefined;
+    if (typeof choice === "string" && !["auto", "none", "required"].includes(choice)) {
+        return { type: "function", function: { name: choice } };
+    }
+    return choice;
+}

package/dist/providers/xai/Capabilities.d.ts

@@ -1,12 +1,16 @@
+import { ModelPricing } from "../../models/types.js";
 export declare class Capabilities {
-    static supportsVision(model: string): boolean;
-    static supportsTools(model: string): boolean;
-    static supportsStructuredOutput(model: string): boolean;
-    static supportsEmbeddings(model: string): boolean;
-    static supportsImageGeneration(model: string): boolean;
-    static supportsTranscription(model: string): boolean;
-    static supportsModeration(model: string): boolean;
-    static supportsReasoning(model: string): boolean;
-    static getContextWindow(model: string): number;
+    static supportsVision(modelId: string): boolean;
+    static supportsTools(modelId: string): boolean;
+    static supportsStructuredOutput(modelId: string): boolean;
+    static supportsEmbeddings(modelId: string): boolean;
+    static supportsImageGeneration(modelId: string): boolean;
+    static supportsTranscription(modelId: string): boolean;
+    static supportsModeration(modelId: string): boolean;
+    static supportsReasoning(modelId: string): boolean;
+    static supportsToolChoice(_modelId: string): boolean;
+    static getContextWindow(modelId: string): number;
+    static getPricing(modelId: string): ModelPricing | undefined;
+    private static findModel;
 }
 //# sourceMappingURL=Capabilities.d.ts.map

package/dist/providers/xai/Capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Capabilities.d.ts","sourceRoot":"","sources":["../../../src/providers/xai/Capabilities.ts"],"names":[],"mappings":"AAsBA,qBAAa,YAAY;IACvB,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAO7C,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAS5C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IASvD,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOjD,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOtD,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOpD,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOjD,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOhD,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAM/C"}
+{"version":3,"file":"Capabilities.d.ts","sourceRoot":"","sources":["../../../src/providers/xai/Capabilities.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,qBAAa,YAAY;IACvB,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI/C,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAS9C,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAOzD,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAInD,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAQxD,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAItD,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAInD,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlD,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIhD,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI5D,OAAO,CAAC,MAAM,CAAC,SAAS;CAGzB"}

package/dist/providers/xai/Capabilities.js

@@ -1,79 +1,48 @@
 import { ModelRegistry } from "../../models/ModelRegistry.js";
-const VISION_MODELS = [
-    "grok-2-vision-1212",
-    "grok-4-0709",
-    "grok-4-fast-non-reasoning",
-    "grok-4-fast-reasoning",
-    "grok-4.1-fast-non-reasoning",
-    "grok-4.1-fast-reasoning",
-    "grok-4-1-fast-non-reasoning",
-    "grok-4-1-fast-reasoning"
-];
-const REASONING_MODELS = [
-    "grok-3-mini",
-    "grok-4-0709",
-    "grok-4-fast-reasoning",
-    "grok-4.1-fast-reasoning",
-    "grok-4-1-fast-reasoning",
-    "grok-code-fast-1"
-];
+import { PricingRegistry } from "../../models/PricingRegistry.js";
 export class Capabilities {
-    static supportsVision(model) {
-        const registryModel = ModelRegistry.find(model, "xai");
-        if (registryModel?.capabilities.includes("vision"))
-            return true;
-        return model.includes("vision") || VISION_MODELS.includes(model);
+    static supportsVision(modelId) {
+        return ModelRegistry.supports(modelId, "vision", "xai");
     }
-    static supportsTools(model) {
-        if (this.supportsImageGeneration(model))
+    static supportsTools(modelId) {
+        if (this.supportsImageGeneration(modelId))
             return false;
-        const registryModel = ModelRegistry.find(model, "xai");
-        if (registryModel?.capabilities.includes("tools"))
-            return true;
-        return true;
+        return (ModelRegistry.supports(modelId, "tools", "xai") ||
+            ModelRegistry.supports(modelId, "function_calling", "xai") ||
+            !modelId.includes("image"));
     }
-    static supportsStructuredOutput(model) {
-        if (this.supportsImageGeneration(model))
+    static supportsStructuredOutput(modelId) {
+        if (this.supportsImageGeneration(modelId))
             return false;
-        const registryModel = ModelRegistry.find(model, "xai");
-        if (registryModel?.capabilities.includes("structured_output"))
-            return true;
-        return true;
+        return (ModelRegistry.supports(modelId, "structured_output", "xai") || !modelId.includes("image"));
+    }
+    static supportsEmbeddings(modelId) {
+        return ModelRegistry.supports(modelId, "embeddings", "xai");
     }
-    static supportsEmbeddings(model) {
-        const registryModel = ModelRegistry.find(model, "xai");
-        if (registryModel?.capabilities.includes("embeddings"))
-            return true;
-        return false;
+    static supportsImageGeneration(modelId) {
+        return (ModelRegistry.supports(modelId, "image_generation", "xai") ||
+            modelId.includes("image") ||
+            modelId.includes("imagine"));
     }
-    static supportsImageGeneration(model) {
-        const registryModel = ModelRegistry.find(model, "xai");
-        if (registryModel?.capabilities.includes("image_generation"))
-            return true;
-        return model.includes("image") || model.includes("imagine");
+    static supportsTranscription(modelId) {
+        return ModelRegistry.supports(modelId, "transcription", "xai");
     }
-    static supportsTranscription(model) {
-        const registryModel = ModelRegistry.find(model, "xai");
-        if (registryModel?.capabilities.includes("transcription"))
-            return true;
-        return false;
+    static supportsModeration(modelId) {
+        return ModelRegistry.supports(modelId, "moderation", "xai");
+    }
+    static supportsReasoning(modelId) {
+        return ModelRegistry.supports(modelId, "reasoning", "xai") || modelId.includes("reasoning");
+    }
+    static supportsToolChoice(_modelId) {
+        return true;
     }
-    static supportsModeration(model) {
-        const registryModel = ModelRegistry.find(model, "xai");
-        if (registryModel?.capabilities.includes("moderation"))
-            return true;
-        return false;
+    static getContextWindow(modelId) {
+        return ModelRegistry.getContextWindow(modelId, "xai") ?? 128_000;
     }
-    static supportsReasoning(model) {
-        const registryModel = ModelRegistry.find(model, "xai");
-        if (registryModel?.capabilities.includes("reasoning"))
-            return true;
-        return model.includes("reasoning") || REASONING_MODELS.includes(model);
+    static getPricing(modelId) {
+        return PricingRegistry.getPricing(modelId, "xai");
     }
-    static getContextWindow(model) {
-        const registryModel = ModelRegistry.find(model, "xai");
-        if (registryModel?.context_window)
-            return registryModel.context_window;
-        return 128000;
+    static findModel(modelId) {
+        return ModelRegistry.find(modelId, "xai");
     }
 }

package/dist/transcription/Transcription.d.ts

@@ -1,11 +1,33 @@
-import { TranscriptionResponse, TranscriptionSegment } from "../providers/Provider.js";
+import { TranscriptionResponse, TranscriptionSegment, TranscriptionWord } from "../providers/Provider.js";
 export declare class Transcription {
     private readonly response;
     constructor(response: TranscriptionResponse);
     get text(): string;
     get model(): string;
     get segments(): TranscriptionSegment[];
+    get words(): TranscriptionWord[];
     get duration(): number | undefined;
+    /**
+     * Serializable object containing all response metadata.
+     * Perfect for database persistence — mirrors ChatResponseString.meta.
+     */
+    get meta(): {
+        text: string;
+        model: string;
+        duration: number | undefined;
+        segments: TranscriptionSegment[] | undefined;
+        words: TranscriptionWord[] | undefined;
+    };
+    /**
+     * Alias for meta (backwards compatibility).
+     */
+    get raw(): {
+        text: string;
+        model: string;
+        duration: number | undefined;
+        segments: TranscriptionSegment[] | undefined;
+        words: TranscriptionWord[] | undefined;
+    };
     toString(): string;
 }
 //# sourceMappingURL=Transcription.d.ts.map

package/dist/transcription/Transcription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transcription.d.ts","sourceRoot":"","sources":["../../src/transcription/Transcription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,qBAAqB;IAE5D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,QAAQ,IAAI,oBAAoB,EAAE,CAErC;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED,QAAQ,IAAI,MAAM;CAGnB"}
+{"version":3,"file":"Transcription.d.ts","sourceRoot":"","sources":["../../src/transcription/Transcription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE1G,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,qBAAqB;IAE5D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,QAAQ,IAAI,oBAAoB,EAAE,CAErC;IAED,IAAI,KAAK,IAAI,iBAAiB,EAAE,CAE/B;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED;;;OAGG;IACH,IAAI,IAAI;;;;;;MAQP;IAED;;OAEG;IACH,IAAI,GAAG;;;;;;MAEN;IAED,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/transcription/Transcription.js

@@ -12,9 +12,31 @@ export class Transcription {
     get segments() {
         return this.response.segments || [];
     }
+    get words() {
+        return this.response.words || [];
+    }
     get duration() {
         return this.response.duration;
     }
+    /**
+     * Serializable object containing all response metadata.
+     * Perfect for database persistence — mirrors ChatResponseString.meta.
+     */
+    get meta() {
+        return {
+            text: this.response.text,
+            model: this.response.model,
+            duration: this.response.duration,
+            segments: this.response.segments,
+            words: this.response.words
+        };
+    }
+    /**
+     * Alias for meta (backwards compatibility).
+     */
+    get raw() {
+        return this.meta;
+    }
     toString() {
         return this.text;
     }

package/dist/utils/Binary.d.ts

@@ -7,6 +7,14 @@ export declare class BinaryUtils {
      * Converts a URL (data:, http:, or local path) to a base64 string and mime type.
      */
     static toBase64(url: string): Promise<Base64Data | null>;
+    /**
+     * Converts a Base64Data object to a Blob.
+     */
+    static base64ToBlob(binary: Base64Data): Blob;
+    /**
+     * Converts a Base64Data object to a Buffer.
+     */
+    static base64ToBuffer(binary: Base64Data): Buffer;
     private static guessMimeType;
 }
 //# sourceMappingURL=Binary.d.ts.map

package/dist/utils/Binary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Binary.d.ts","sourceRoot":"","sources":["../../src/utils/Binary.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IACtB;;OAEG;WACU,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA0C9D,OAAO,CAAC,MAAM,CAAC,aAAa;CA0B7B"}
+{"version":3,"file":"Binary.d.ts","sourceRoot":"","sources":["../../src/utils/Binary.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IACtB;;OAEG;WACU,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA0C9D;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAI7C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAIjD,OAAO,CAAC,MAAM,CAAC,aAAa;CA0B7B"}

package/dist/utils/Binary.js

@@ -51,6 +51,18 @@ export class BinaryUtils {
         }
         return null;
     }
+    /**
+     * Converts a Base64Data object to a Blob.
+     */
+    static base64ToBlob(binary) {
+        return new Blob([new Uint8Array(this.base64ToBuffer(binary))], { type: binary.mimeType });
+    }
+    /**
+     * Converts a Base64Data object to a Buffer.
+     */
+    static base64ToBuffer(binary) {
+        return Buffer.from(binary.data, "base64");
+    }
     static guessMimeType(filePath) {
         const ext = path.extname(filePath).toLowerCase();
         switch (ext) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-llm/core",
-  "version": "1.15.2",
+  "version": "1.16.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",