190proof 1.0.119 → 1.0.122

package/README.md

@@ -323,6 +323,19 @@ interface ParsedResponseMessage {
 }
 ```
 
+### `setLogger(sink | null)`
+
+190proof logs each call and retry to the console. Route those lines to your own logger, or pass `null` to silence them (useful when 190proof is a dependency of a library):
+
+```typescript
+import { setLogger } from "190proof";
+
+setLogger(null); // silent
+setLogger({ log: myLog.info, warn: myLog.warn, error: myLog.error });
+```
+
+Errors thrown by `callWithRetries` never carry the HTTP request (and so never the API key); provider status and response body stay on `error.response`.
+
 ### `parseModelString(model)`
 
 Parses a model string into its provider and model ID components.

package/dist/index.d.mts

@@ -206,6 +206,17 @@ interface ParsedResponseMessage {
          * when the provider reports none.
          */
         thoughts_tokens?: number;
+        /**
+         * Prompt tokens written to the provider's cache (subset of prompt_tokens).
+         * Billed above the plain input rate on Anthropic (1.25x 5m, 2x 1h).
+         * Currently populated from Anthropic's `cache_creation_input_tokens`.
+         */
+        cache_write_tokens?: number;
+        /**
+         * USD actually billed for this call, as reported by the provider.
+         * Currently populated from OpenRouter's `usage.cost`; undefined elsewhere.
+         */
+        cost?: number;
     } | null;
 }
 interface FunctionCall {
@@ -359,6 +370,26 @@ interface GenericPayload {
     signal?: AbortSignal;
 }
 
+/** Where 190proof's own log lines go. Defaults to the console. */
+interface LogSink {
+    log(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+/**
+ * Route 190proof's logging to your own logger, or pass null to silence it
+ * (useful when embedding the SDK in a library).
+ */
+declare function setLogger(next: LogSink | null): void;
+/**
+ * HTTP client errors (axios) carry the full request config, API-key headers
+ * included; logging or rethrowing one as a `cause` leaks the key into every
+ * log that prints it. Rebuild a plain Error with only what callers use:
+ * message, name, code, and the response status + body. Non-HTTP errors pass
+ * through untouched.
+ */
+declare function redactError<T>(err: T): T | Error;
+
 /**
  * In-process memory of OpenRouter models that rejected image input (the
  * routing-layer 404 "No endpoints found that support image input"). Payloads
@@ -382,4 +413,4 @@ declare function parseModelString(model: string): {
 };
 declare function callWithRetries(id: string | string[], aiPayload: GenericPayload, aiConfig?: OpenAIConfig | AnthropicAIConfig, retries?: number, chunkTimeoutMs?: number): Promise<ParsedResponseMessage>;
 
-export { type AnyModel, ClaudeModel, type FunctionCall, type FunctionDefinition, GPTModel, GeminiModel, type GenericMessage, type GenericPayload, GroqModel, MIN_STREAM_ATTEMPT_MS, OPENROUTER_NONSTREAM_TIMEOUT_MS, OPENROUTER_STREAM_TIMEOUT_MS, type OpenAIConfig, OpenRouterModel, type OpenRouterProviderPreferences, type ParsedResponseMessage, type Provider, type ToolResult, callWithRetries, openRouterImageRejectedModels, parseModelString };
+export { type AnyModel, ClaudeModel, type FunctionCall, type FunctionDefinition, GPTModel, GeminiModel, type GenericMessage, type GenericPayload, GroqModel, type LogSink, MIN_STREAM_ATTEMPT_MS, OPENROUTER_NONSTREAM_TIMEOUT_MS, OPENROUTER_STREAM_TIMEOUT_MS, type OpenAIConfig, OpenRouterModel, type OpenRouterProviderPreferences, type ParsedResponseMessage, type Provider, type ToolResult, callWithRetries, openRouterImageRejectedModels, parseModelString, redactError, setLogger };

package/dist/index.d.ts

@@ -206,6 +206,17 @@ interface ParsedResponseMessage {
          * when the provider reports none.
          */
         thoughts_tokens?: number;
+        /**
+         * Prompt tokens written to the provider's cache (subset of prompt_tokens).
+         * Billed above the plain input rate on Anthropic (1.25x 5m, 2x 1h).
+         * Currently populated from Anthropic's `cache_creation_input_tokens`.
+         */
+        cache_write_tokens?: number;
+        /**
+         * USD actually billed for this call, as reported by the provider.
+         * Currently populated from OpenRouter's `usage.cost`; undefined elsewhere.
+         */
+        cost?: number;
     } | null;
 }
 interface FunctionCall {
@@ -359,6 +370,26 @@ interface GenericPayload {
     signal?: AbortSignal;
 }
 
+/** Where 190proof's own log lines go. Defaults to the console. */
+interface LogSink {
+    log(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+/**
+ * Route 190proof's logging to your own logger, or pass null to silence it
+ * (useful when embedding the SDK in a library).
+ */
+declare function setLogger(next: LogSink | null): void;
+/**
+ * HTTP client errors (axios) carry the full request config, API-key headers
+ * included; logging or rethrowing one as a `cause` leaks the key into every
+ * log that prints it. Rebuild a plain Error with only what callers use:
+ * message, name, code, and the response status + body. Non-HTTP errors pass
+ * through untouched.
+ */
+declare function redactError<T>(err: T): T | Error;
+
 /**
  * In-process memory of OpenRouter models that rejected image input (the
  * routing-layer 404 "No endpoints found that support image input"). Payloads
@@ -382,4 +413,4 @@ declare function parseModelString(model: string): {
 };
 declare function callWithRetries(id: string | string[], aiPayload: GenericPayload, aiConfig?: OpenAIConfig | AnthropicAIConfig, retries?: number, chunkTimeoutMs?: number): Promise<ParsedResponseMessage>;
 
-export { type AnyModel, ClaudeModel, type FunctionCall, type FunctionDefinition, GPTModel, GeminiModel, type GenericMessage, type GenericPayload, GroqModel, MIN_STREAM_ATTEMPT_MS, OPENROUTER_NONSTREAM_TIMEOUT_MS, OPENROUTER_STREAM_TIMEOUT_MS, type OpenAIConfig, OpenRouterModel, type OpenRouterProviderPreferences, type ParsedResponseMessage, type Provider, type ToolResult, callWithRetries, openRouterImageRejectedModels, parseModelString };
+export { type AnyModel, ClaudeModel, type FunctionCall, type FunctionDefinition, GPTModel, GeminiModel, type GenericMessage, type GenericPayload, GroqModel, type LogSink, MIN_STREAM_ATTEMPT_MS, OPENROUTER_NONSTREAM_TIMEOUT_MS, OPENROUTER_STREAM_TIMEOUT_MS, type OpenAIConfig, OpenRouterModel, type OpenRouterProviderPreferences, type ParsedResponseMessage, type Provider, type ToolResult, callWithRetries, openRouterImageRejectedModels, parseModelString, redactError, setLogger };

package/dist/index.js

@@ -40,7 +40,9 @@ __export(index_exports, {
   OpenRouterModel: () => OpenRouterModel,
   callWithRetries: () => callWithRetries,
   openRouterImageRejectedModels: () => openRouterImageRejectedModels,
-  parseModelString: () => parseModelString
+  parseModelString: () => parseModelString,
+  redactError: () => redactError,
+  setLogger: () => setLogger
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -113,14 +115,34 @@ function formatIdentifier(identifier) {
 function formatMessage(level, identifier, message) {
   return `[${level}] ${formatIdentifier(identifier)} ${message}`;
 }
+var sink = console;
+function setLogger(next) {
+  sink = next;
+}
 function log(identifier, message, ...args) {
-  console.log(formatMessage("LOG", identifier, message), ...args);
+  sink == null ? void 0 : sink.log(formatMessage("LOG", identifier, message), ...args);
 }
 function warn(identifier, message, ...args) {
-  console.warn(formatMessage("WARN", identifier, message), ...args);
+  sink == null ? void 0 : sink.warn(formatMessage("WARN", identifier, message), ...args);
 }
 function error(identifier, message, ...args) {
-  console.error(formatMessage("ERROR", identifier, message), ...args);
+  sink == null ? void 0 : sink.error(formatMessage("ERROR", identifier, message), ...args);
+}
+function redactError(err) {
+  const e = err;
+  if (!e || typeof e !== "object" || !(e.config || e.request || e.isAxiosError)) {
+    return err;
+  }
+  const clean = new Error(e.message);
+  clean.name = e.name;
+  if (e.code !== void 0) clean.code = e.code;
+  if (e.status !== void 0) clean.status = e.status;
+  if (e.response) {
+    clean.response = { status: e.response.status, statusText: e.response.statusText, data: e.response.data };
+  }
+  if (e.data !== void 0) clean.data = e.data;
+  if (e.cause) clean.cause = redactError(e.cause);
+  return clean;
 }
 var logger_default = {
   log,
@@ -180,7 +202,7 @@ async function withRetries(identifier, apiName, fn, options = {}) {
         logger_default.error(
           identifier,
           `Retry #${attempt} error: ${error3.message}`,
-          ((_b = error3.response) == null ? void 0 : _b.data) || error3
+          ((_b = error3.response) == null ? void 0 : _b.data) || redactError(error3)
         );
       }
       await timeout(baseDelayMs * attempt);
@@ -190,7 +212,7 @@ async function withRetries(identifier, apiName, fn, options = {}) {
   const error2 = new Error(
     `Failed to call ${apiName} API after ${retries} attempts: ${detail}`
   );
-  error2.cause = lastError;
+  error2.cause = redactError(lastError);
   throw error2;
 }
 function parseStreamedResponse(identifier, paragraph, toolCallAccumulators, allowedFunctionNames, reasoning) {
@@ -660,7 +682,7 @@ async function callOpenAiWithRetries(id, openAiPayload, openAiConfig, retries =
         logger_default.error(
           id,
           `Retry #${attempt} error: ${error2.message}`,
-          ((_a = error2.response) == null ? void 0 : _a.data) || error2.data || error2
+          ((_a = error2.response) == null ? void 0 : _a.data) || error2.data || redactError(error2)
         );
         if (((_b = error2.data) == null ? void 0 : _b.code) === "content_policy_violation") {
           logger_default.log(id, "Removing images due to content policy violation");
@@ -906,7 +928,8 @@ ${text}` : text;
       prompt_tokens: promptTokens,
       completion_tokens: data.usage.output_tokens,
       total_tokens: promptTokens + data.usage.output_tokens,
-      cached_tokens: cacheRead
+      cached_tokens: cacheRead,
+      cache_write_tokens: cacheWrite
     };
   }
   return {
@@ -1218,7 +1241,7 @@ async function callGoogleAIWithRetries(id, payload, retries = 5, requestTimeoutM
         const fetchError = new Error(
           "Google AI could not fetch the provided image URL(s)."
         );
-        fetchError.cause = error2;
+        fetchError.cause = redactError(error2);
         fetchError.googleFetchFailure = true;
         throw fetchError;
       }
@@ -1516,7 +1539,8 @@ function finalizeOpenRouterMessage(id, raw) {
       prompt_tokens: raw.usage.prompt_tokens,
       completion_tokens: raw.usage.completion_tokens,
       total_tokens: raw.usage.total_tokens,
-      cached_tokens: (_e = (_d = raw.usage.prompt_tokens_details) == null ? void 0 : _d.cached_tokens) != null ? _e : 0
+      cached_tokens: (_e = (_d = raw.usage.prompt_tokens_details) == null ? void 0 : _d.cached_tokens) != null ? _e : 0,
+      cost: typeof raw.usage.cost === "number" ? raw.usage.cost : void 0
     } : null
   };
 }
@@ -1796,7 +1820,7 @@ async function callOpenRouterNonStreaming(id, payload, requestTimeoutMs = OPENRO
     "OpenRouter",
     requestTimeoutMs,
     signal,
-    (mergedSignal) => import_axios.default.post(openRouterEndpoint(), payload, {
+    (mergedSignal) => import_axios.default.post(openRouterEndpoint(), { ...payload, usage: { include: true } }, {
       headers: {
         "content-type": "application/json",
         Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`
@@ -2001,7 +2025,7 @@ async function callWithRetries(id, aiPayload, aiConfig, retries = 5, chunkTimeou
     (_e = result.provider) != null ? _e : result.provider = provider;
     return result;
   } catch (error2) {
-    if ((_f = aiPayload.signal) == null ? void 0 : _f.aborted) throw error2;
+    if ((_f = aiPayload.signal) == null ? void 0 : _f.aborted) throw redactError(error2);
     if (aiPayload.fallbackModel) {
       logger_default.error(
         id,
@@ -2023,7 +2047,7 @@ async function callWithRetries(id, aiPayload, aiConfig, retries = 5, chunkTimeou
         chunkTimeoutMs
       );
     }
-    throw error2;
+    throw redactError(error2);
   }
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -2038,6 +2062,8 @@ async function callWithRetries(id, aiPayload, aiConfig, retries = 5, chunkTimeou
   OpenRouterModel,
   callWithRetries,
   openRouterImageRejectedModels,
-  parseModelString
+  parseModelString,
+  redactError,
+  setLogger
 });
 //# sourceMappingURL=index.js.map