190proof 1.0.118 → 1.0.120

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

@@ -359,6 +359,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 +402,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

@@ -359,6 +359,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 +402,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

@@ -27,7 +27,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// index.ts
+// src/index.ts
 var index_exports = {};
 __export(index_exports, {
   ClaudeModel: () => ClaudeModel,
@@ -40,11 +40,13 @@ __export(index_exports, {
   OpenRouterModel: () => OpenRouterModel,
   callWithRetries: () => callWithRetries,
   openRouterImageRejectedModels: () => openRouterImageRejectedModels,
-  parseModelString: () => parseModelString
+  parseModelString: () => parseModelString,
+  redactError: () => redactError,
+  setLogger: () => setLogger
 });
 module.exports = __toCommonJS(index_exports);
 
-// interfaces.ts
+// src/interfaces.ts
 var ClaudeModel = /* @__PURE__ */ ((ClaudeModel2) => {
   ClaudeModel2["HAIKU_3"] = "claude-3-haiku-20240307";
   ClaudeModel2["SONNET_3"] = "claude-3-sonnet-20240229";
@@ -103,7 +105,7 @@ var GeminiModel = /* @__PURE__ */ ((GeminiModel2) => {
   return GeminiModel2;
 })(GeminiModel || {});
 
-// logger.ts
+// src/logger.ts
 function formatIdentifier(identifier) {
   if (Array.isArray(identifier)) {
     return identifier.map((id) => `[${id}]`).join(" ");
@@ -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,
@@ -128,11 +150,11 @@ var logger_default = {
   error
 };
 
-// index.ts
+// src/index.ts
 var import_client_bedrock_runtime = require("@aws-sdk/client-bedrock-runtime");
 var import_axios = __toESM(require("axios"));
 
-// utils.ts
+// src/utils.ts
 function timeout(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -142,7 +164,7 @@ function isHeicImage(name, mime) {
   return ["heic", "heif", "heics"].includes(extension) || !!(mime && ["image/heic", "image/heif", "image/heic-sequence"].includes(mime));
 }
 
-// index.ts
+// src/index.ts
 var sharp = require("sharp");
 var decode = require("heic-decode");
 function anySignal(signals) {
@@ -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");
@@ -1218,7 +1240,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;
       }
@@ -1565,6 +1587,14 @@ async function callOpenRouterStream(id, payload, streamTimeoutMs = OPENROUTER_ST
   let finishReason = null;
   let sawDone = false;
   let dataChunks = 0;
+  const RAW_HEAD_MAX = 3e3;
+  const RAW_TAIL_MAX = 1500;
+  let rawHead = "";
+  let rawTail = "";
+  let generationId;
+  const unreadKeys = /* @__PURE__ */ new Set();
+  const KNOWN_DELTA_KEYS = /* @__PURE__ */ new Set(["role", "content", "reasoning", "reasoning_details", "tool_calls"]);
+  const KNOWN_CHOICE_KEYS = /* @__PURE__ */ new Set(["index", "delta", "finish_reason", "native_finish_reason", "logprobs"]);
   try {
     armStallTimer();
     const response = await fetch(openRouterEndpoint(), {
@@ -1616,6 +1646,11 @@ async function callOpenRouterStream(id, payload, streamTimeoutMs = OPENROUTER_ST
           sawDone = true;
           break outer;
         }
+        if (rawHead.length < RAW_HEAD_MAX) {
+          rawHead += dataStr.slice(0, RAW_HEAD_MAX - rawHead.length) + "\n";
+        } else {
+          rawTail = (rawTail + dataStr + "\n").slice(-RAW_TAIL_MAX);
+        }
         let json;
         try {
           json = JSON.parse(dataStr);
@@ -1637,6 +1672,7 @@ async function callOpenRouterStream(id, payload, streamTimeoutMs = OPENROUTER_ST
           throw error2;
         }
         if (json.provider) provider = json.provider;
+        if (json.id && !generationId) generationId = json.id;
         let useful = false;
         if (json.usage) {
           usage = json.usage;
@@ -1645,6 +1681,12 @@ async function callOpenRouterStream(id, payload, streamTimeoutMs = OPENROUTER_ST
         const choice = (_c = json.choices) == null ? void 0 : _c[0];
         if (choice) {
           const delta = (_d = choice.delta) != null ? _d : {};
+          for (const k of Object.keys(choice)) {
+            if (!KNOWN_CHOICE_KEYS.has(k) && choice[k] != null) unreadKeys.add(`choice.${k}`);
+          }
+          for (const k of Object.keys(delta)) {
+            if (!KNOWN_DELTA_KEYS.has(k) && delta[k] != null && delta[k] !== "") unreadKeys.add(`delta.${k}`);
+          }
           if (delta.content) {
             paragraph += delta.content;
             useful = true;
@@ -1701,7 +1743,12 @@ async function callOpenRouterStream(id, payload, streamTimeoutMs = OPENROUTER_ST
         usage,
         paragraph: paragraph.slice(0, 500),
         reasoningChars: reasoning.length,
-        toolCalls
+        toolCalls,
+        generationId,
+        dataChunks,
+        unreadKeys: [...unreadKeys],
+        rawHead,
+        rawTail: rawTail || void 0
       })
     });
   } catch (error2) {
@@ -1976,7 +2023,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,
@@ -1998,7 +2045,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:
@@ -2013,6 +2060,8 @@ async function callWithRetries(id, aiPayload, aiConfig, retries = 5, chunkTimeou
   OpenRouterModel,
   callWithRetries,
   openRouterImageRejectedModels,
-  parseModelString
+  parseModelString,
+  redactError,
+  setLogger
 });
 //# sourceMappingURL=index.js.map