@odla-ai/ai 0.3.0 → 0.3.2

package/dist/index.d.cts

@@ -179,10 +179,14 @@ declare class OdlaAIError extends Error {
     readonly code: OracleErrorType;
     readonly providerStatus?: number;
     readonly retryAfter?: number;
+    /** Sanitized provider usage when a response was received before a later
+     * validation/tool-shape failure. Omitted when usage is genuinely unknown. */
+    readonly usage?: OracleUsage;
     constructor(code: OracleErrorType, message: string, opts?: {
         providerStatus?: number;
         retryAfter?: number;
         cause?: unknown;
+        usage?: OracleUsage;
     });
     toShape(): OracleErrorShape;
 }
@@ -233,6 +237,7 @@ declare class ToolInputError extends OdlaAIError {
     constructor(message: string, opts?: {
         tool?: string;
         cause?: unknown;
+        usage?: OracleUsage;
     });
 }
 /** The caller cancelled a request. This is not an upstream failure and should
@@ -254,6 +259,7 @@ declare class ProviderError extends OdlaAIError {
     constructor(message: string, opts?: {
         providerStatus?: number;
         cause?: unknown;
+        usage?: OracleUsage;
     });
 }
 

package/dist/index.d.ts

@@ -179,10 +179,14 @@ declare class OdlaAIError extends Error {
     readonly code: OracleErrorType;
     readonly providerStatus?: number;
     readonly retryAfter?: number;
+    /** Sanitized provider usage when a response was received before a later
+     * validation/tool-shape failure. Omitted when usage is genuinely unknown. */
+    readonly usage?: OracleUsage;
     constructor(code: OracleErrorType, message: string, opts?: {
         providerStatus?: number;
         retryAfter?: number;
         cause?: unknown;
+        usage?: OracleUsage;
     });
     toShape(): OracleErrorShape;
 }
@@ -233,6 +237,7 @@ declare class ToolInputError extends OdlaAIError {
     constructor(message: string, opts?: {
         tool?: string;
         cause?: unknown;
+        usage?: OracleUsage;
     });
 }
 /** The caller cancelled a request. This is not an upstream failure and should
@@ -254,6 +259,7 @@ declare class ProviderError extends OdlaAIError {
     constructor(message: string, opts?: {
         providerStatus?: number;
         cause?: unknown;
+        usage?: OracleUsage;
     });
 }
 

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   normalizeError,
   signalWithDeadline,
   throwIfAborted
-} from "./chunk-PXXCN2EU.js";
+} from "./chunk-XVU2W4TU.js";
 
 // src/shape/helpers.ts
 function isTextBlock(b) {
@@ -658,17 +658,17 @@ async function createProvider(id, apiKey) {
   let provider;
   switch (id) {
     case "anthropic": {
-      const { AnthropicProvider } = await import("./anthropic-2NPMHJZT.js");
+      const { AnthropicProvider } = await import("./anthropic-THZJJEGB.js");
       provider = new AnthropicProvider(apiKey);
       break;
     }
     case "openai": {
-      const { OpenAIProvider } = await import("./openai-NTQCF577.js");
+      const { OpenAIProvider } = await import("./openai-3XRICNAW.js");
       provider = new OpenAIProvider(apiKey);
       break;
     }
     case "google": {
-      const { GoogleProvider } = await import("./google-3XV2VWVB.js");
+      const { GoogleProvider } = await import("./google-SXQOKV2S.js");
       provider = new GoogleProvider(apiKey);
       break;
     }
@@ -764,12 +764,12 @@ function init(opts = {}) {
     const res = await provider.create(spec, req);
     const block = res.content.find((b) => b.type === "tool_use" && b.name === c.tool.name);
     if (!block || block.type !== "tool_use") {
-      throw new ProviderError(`Model "${model}" did not return the forced tool call "${c.tool.name}".`);
+      throw new ProviderError(`Model "${model}" did not return the forced tool call "${c.tool.name}".`, { usage: res.usage });
     }
     const validation = validateJsonSchema(c.tool.parameters, block.input);
     if (!validation.valid) {
       const detail = validation.issues.slice(0, 5).map((i) => `${i.path} ${i.message}`).join("; ");
-      throw new ToolInputError(`Tool "${c.tool.name}" returned invalid input: ${detail}`, { tool: c.tool.name });
+      throw new ToolInputError(`Tool "${c.tool.name}" returned invalid input: ${detail}`, { tool: c.tool.name, usage: res.usage });
     }
     return { value: block.input, usage: res.usage };
   };
@@ -943,6 +943,11 @@ Every error is an OdlaAIError subclass with a stable \`code\` \u2014 branch on e
 config, auth, rate_limit, capability_unsupported, context_window, invalid_request,
 tool_input_invalid, cancelled, deadline_exceeded, provider_error.
 
+OdlaAIError.usage is an optional frozen token-usage record. It exists only when
+the provider returned a response before a later forced-tool/schema validation
+failure, and may be absent for every earlier failure. It is intentionally not
+included in toShape() or streaming OracleErrorShape.
+
 ## Models
 
 ${models}