@steve31415/baselib 3.39.1 → 3.40.1

package/dist/llm/complete.js

@@ -83,6 +83,7 @@ export async function llmComplete(request) {
             continue;
         }
         const provider = providers[modelEntry.provider];
+        const attemptStartedAt = Date.now();
         try {
             const result = await provider.complete({
                 apiModelId: modelEntry.apiModelId,
@@ -124,6 +125,7 @@ export async function llmComplete(request) {
                     fallbackModel: modelName,
                     fallbackProvider: modelEntry.provider,
                     attemptsBeforeSuccess: failedAttempts.length,
+                    ...(request.callSite ? { callSite: request.callSite } : {}),
                 });
             }
             return {
@@ -162,6 +164,12 @@ export async function llmComplete(request) {
                 declined: err instanceof LLMError && err.declined === true,
                 attemptNumber: failedAttempts.length,
                 nextModel: modelsToTry[failedAttempts.length] ?? 'none',
+                // Which caller, and whether it ran out its own deadline: a timeout tail is a
+                // headroom question for that call site, an HTTP error is not (reader task 58b65ec9).
+                ...(request.callSite ? { callSite: request.callSite } : {}),
+                timedOut: err instanceof LLMError && err.timedOut === true,
+                timeoutMs,
+                attemptMs: Date.now() - attemptStartedAt,
             });
         }
     }

package/dist/llm/providers/anthropic.js

@@ -140,6 +140,7 @@ export const anthropicProvider = {
                 provider: 'anthropic',
                 model: request.apiModelId,
                 isRetryable: true,
+                timedOut: err instanceof Error && err.name === 'AbortError',
             });
         }
         finally {

package/dist/llm/providers/gemini.js

@@ -125,6 +125,7 @@ export const geminiProvider = {
                 provider: 'gemini',
                 model: request.apiModelId,
                 isRetryable: true,
+                timedOut: err instanceof Error && err.name === 'AbortError',
             });
         }
         finally {

package/dist/llm/providers/openai.js

@@ -149,6 +149,7 @@ export const openaiProvider = {
                 provider: 'openai',
                 model: request.apiModelId,
                 isRetryable: true,
+                timedOut: err instanceof Error && err.name === 'AbortError',
             });
         }
         finally {

package/dist/llm/types.d.ts

@@ -155,6 +155,8 @@ export declare class LLMError extends Error {
      * not a defect.
      */
     declined: boolean;
+    /** True when the attempt hit its per-provider `timeoutMs` deadline. */
+    timedOut: boolean;
     constructor(opts: {
         message: string;
         provider: ProviderName;
@@ -162,6 +164,7 @@ export declare class LLMError extends Error {
         statusCode?: number;
         isRetryable: boolean;
         declined?: boolean;
+        timedOut?: boolean;
     });
 }
 export interface ProviderAdapter {

package/dist/llm/types.js

@@ -20,6 +20,8 @@ export class LLMError extends Error {
      * not a defect.
      */
     declined;
+    /** True when the attempt hit its per-provider `timeoutMs` deadline. */
+    timedOut;
     constructor(opts) {
         super(opts.message);
         this.name = 'LLMError';
@@ -28,5 +30,6 @@ export class LLMError extends Error {
         this.statusCode = opts.statusCode;
         this.isRetryable = opts.isRetryable;
         this.declined = opts.declined ?? false;
+        this.timedOut = opts.timedOut ?? false;
     }
 }

package/dist/log-core.js

@@ -22,6 +22,23 @@ function errorCode(err) {
         return code;
     return undefined;
 }
+/** A non-Error cause as text. A plain object (gaxios 7 sets a Google API
+ *  error's cause to the AIP-193 body { code, message, status }) is rendered
+ *  as JSON, which String() would flatten to "[object Object]" (watchdog task
+ *  4454314a, 2026-10-28); an object JSON cannot render falls back to String(). */
+function causeText(cause) {
+    if (typeof cause === 'object' && cause !== null) {
+        try {
+            const json = JSON.stringify(cause);
+            if (typeof json === 'string')
+                return json;
+        }
+        catch {
+            // circular or a throwing toJSON: fall through
+        }
+    }
+    return String(cause);
+}
 export function serializeError(err) {
     if (err instanceof Error) {
         const out = { name: err.name, message: err.message };
@@ -36,7 +53,7 @@ export function serializeError(err) {
                 out.cause.code = causeCode;
         }
         else if (err.cause !== undefined) {
-            out.cause = { name: 'cause', message: truncate(String(err.cause), 500) };
+            out.cause = { name: 'cause', message: truncate(causeText(err.cause), 500) };
         }
         return out;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steve31415/baselib",
-  "version": "3.39.1",
+  "version": "3.40.1",
   "description": "Plasticine new-world shared platform library: logging, auth, service-to-service auth, db, HTTP, sync, app updates",
   "type": "module",
   "license": "MIT",