@carlonicora/nestjs-neo4jsonapi 1.110.3 → 1.112.0

package/dist/config/interfaces/config.ai.interface.d.ts

@@ -81,6 +81,35 @@ export interface ConfigAiInterface {
      * `ENV === "production"` to enforce this. Driven by MOCK_AI=true.
      */
     mock: boolean;
+    /**
+     * Per-ATTEMPT wall-clock budget for one provider request, in milliseconds.
+     * Driven by AI_REQUEST_TIMEOUT_MS (default 120000).
+     *
+     * Without it the only bound is the OpenAI SDK's own 600s default, so a
+     * provider that accepts a request and never answers freezes the caller for
+     * ten minutes with no error, no log and no dump (the dump file is written on
+     * close). Callers that need a different bound pass `timeout` per call.
+     *
+     * This is the budget for ONE attempt: the LangChain retry layer may re-issue
+     * (on OpenRouter each retry escalates `allow_fallbacks`, so a stalled provider
+     * is rerouted rather than waited on again). {@link requestDeadlineAttempts}
+     * bounds the total.
+     */
+    requestTimeoutMs: number;
+    /**
+     * How many attempts the absolute deadline budgets for before it force-fails a
+     * call, so an adapter that ignores its own timeout still settles. Driven by
+     * AI_REQUEST_DEADLINE_ATTEMPTS (default 3 — matches LangChain's maxRetries: 2
+     * plus the first attempt).
+     */
+    requestDeadlineAttempts: number;
+    /**
+     * How often, in milliseconds, a still-pending provider request logs a warning.
+     * Driven by AI_REQUEST_WATCHDOG_MS (default 30000). A stall used to be
+     * completely silent until it resolved; this makes it visible while it happens.
+     * Set to 0 to disable.
+     */
+    requestWatchdogMs: number;
     /**
      * Mistral Document AI (OCR) on Azure AI Foundry — see DocumentAiService.
      * Driven by DOCUMENT_AI_{ENABLED,PROVIDER,API_KEY,MODEL,URL,API_VERSION}.

package/dist/config/interfaces/config.ai.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.ai.interface.d.ts","sourceRoot":"","sources":["../../../src/config/interfaces/config.ai.interface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.ai.interface.d.ts","sourceRoot":"","sources":["../../../src/config/interfaces/config.ai.interface.ts"],"names":[],"mappings":"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"}

package/dist/config/interfaces/config.mcp.interface.d.ts

@@ -0,0 +1,34 @@
+/**
+ * MCP (Model Context Protocol) Server Configuration Interface
+ *
+ * Controls the MCP server exposed at POST /mcp, which lets external AI agents
+ * (claude.ai connectors, Claude Desktop, ChatGPT) interact with the application
+ * through OAuth-authenticated, RBAC-gated tools.
+ *
+ * @see https://modelcontextprotocol.io - Model Context Protocol specification
+ */
+export interface ConfigMcpInterface {
+    /**
+     * Master switch to enable/disable the MCP server.
+     * When false, the MCP endpoint is not served.
+     * @default false
+     */
+    enabled: boolean;
+    /**
+     * Server name advertised to MCP clients during initialization.
+     * @default "neural-erp"
+     */
+    serverName: string;
+    /**
+     * Optional instructions string advertised to MCP clients,
+     * describing how to best use this server's tools.
+     */
+    instructions?: string;
+    /**
+     * JSON:API types promoted to dedicated per-entity MCP tools,
+     * parsed from a comma-separated environment variable.
+     * @default []
+     */
+    promotedEntities: string[];
+}
+//# sourceMappingURL=config.mcp.interface.d.ts.map

package/dist/config/interfaces/config.mcp.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mcp.interface.d.ts","sourceRoot":"","sources":["../../../src/config/interfaces/config.mcp.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B"}

package/dist/config/interfaces/config.mcp.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.mcp.interface.js.map

package/dist/config/interfaces/config.mcp.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mcp.interface.js","sourceRoot":"","sources":["../../../src/config/interfaces/config.mcp.interface.ts"],"names":[],"mappings":""}

package/dist/config/interfaces/index.d.ts

@@ -21,6 +21,7 @@ export * from "./config.interface";
 export * from "./config.job.names.interface";
 export * from "./config.jwt.interface";
 export * from "./config.logging.interface";
+export * from "./config.mcp.interface";
 export * from "./config.neo4j.interface";
 export * from "./config.oauth.interface";
 export * from "./config.operator.interface";

package/dist/config/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/interfaces/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/interfaces/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC"}

package/dist/config/interfaces/index.js

@@ -37,6 +37,7 @@ __exportStar(require("./config.interface"), exports);
 __exportStar(require("./config.job.names.interface"), exports);
 __exportStar(require("./config.jwt.interface"), exports);
 __exportStar(require("./config.logging.interface"), exports);
+__exportStar(require("./config.mcp.interface"), exports);
 __exportStar(require("./config.neo4j.interface"), exports);
 __exportStar(require("./config.oauth.interface"), exports);
 __exportStar(require("./config.operator.interface"), exports);

package/dist/config/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/interfaces/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,0DAAwC;AACxC,wDAAsC;AACtC,yDAAuC;AACvC,yDAAuC;AACvC,0DAAwC;AACxC,2DAAyC;AACzC,6DAA2C;AAC3C,kEAAgD;AAChD,mEAAiD;AACjD,0DAAwC;AACxC,6DAA2C;AAC3C,uEAAqD;AACrD,4DAA0C;AAC1C,2DAAyC;AACzC,gEAA8C;AAC9C,iEAA+C;AAC/C,qDAAmC;AACnC,+DAA6C;AAC7C,yDAAuC;AACvC,6DAA2C;AAC3C,2DAAyC;AACzC,2DAAyC;AACzC,8DAA4C;AAC5C,6DAA2C;AAC3C,+DAA6C;AAC7C,2DAAyC;AACzC,wDAAsC;AACtC,4DAA0C;AAC1C,2DAAyC;AACzC,gEAA8C;AAC9C,2DAAyC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/interfaces/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,0DAAwC;AACxC,wDAAsC;AACtC,yDAAuC;AACvC,yDAAuC;AACvC,0DAAwC;AACxC,2DAAyC;AACzC,6DAA2C;AAC3C,kEAAgD;AAChD,mEAAiD;AACjD,0DAAwC;AACxC,6DAA2C;AAC3C,uEAAqD;AACrD,4DAA0C;AAC1C,2DAAyC;AACzC,gEAA8C;AAC9C,iEAA+C;AAC/C,qDAAmC;AACnC,+DAA6C;AAC7C,yDAAuC;AACvC,6DAA2C;AAC3C,yDAAuC;AACvC,2DAAyC;AACzC,2DAAyC;AACzC,8DAA4C;AAC5C,6DAA2C;AAC3C,+DAA6C;AAC7C,2DAAyC;AACzC,wDAAsC;AACtC,4DAA0C;AAC1C,2DAAyC;AACzC,gEAA8C;AAC9C,2DAAyC"}

package/dist/core/llm/services/llm.service.d.ts

@@ -10,6 +10,23 @@ import { LLMCacheService } from "./llm-cache.service";
 import { ModelService } from "../../llm/services/model.service";
 import { LLMCallDumper } from "./llm-call-dumper.service";
 export { injectOpenRouterProvider } from "./openrouter-fetch";
+/**
+ * True for the abort a request timeout raises, whichever layer raised it — the
+ * OpenAI SDK's `APIConnectionTimeoutError`, undici's `TimeoutError`/
+ * `AbortError` DOMException, or a LangChain wrapper around either. Matched on
+ * name and message because the concrete class differs per transport.
+ */
+export declare function isTimeoutError(error: unknown): boolean;
+/**
+ * Thrown when a provider call burns its whole deadline without settling.
+ * Distinguishable from a provider error so callers can treat a stall
+ * differently from a refusal if they choose — both are retryable.
+ */
+export declare class LLMTimeoutError extends Error {
+    readonly label: string;
+    readonly deadlineMs: number;
+    constructor(label: string, deadlineMs: number);
+}
 /**
  * Parameters for LLM service calls
  */
@@ -47,6 +64,39 @@ export declare class LLMService {
     private readonly cache?;
     private readonly logger;
     constructor(modelService: ModelService, config: ConfigService<BaseConfigInterface>, dumper: LLMCallDumper, tokenUsageService: TokenUsageService, cache?: LLMCacheService);
+    /**
+     * The per-ATTEMPT budget for one provider request. `params.timeout` wins;
+     * otherwise the configured default (`AI_REQUEST_TIMEOUT_MS`).
+     */
+    private attemptTimeoutMs;
+    /**
+     * Runs one provider call under a WATCHDOG and an ABSOLUTE DEADLINE.
+     *
+     * Why this exists (game e51493e4 r002, 2026-07-26): a plotter request was
+     * accepted by the provider and never answered. Nothing in the stack could
+     * interrupt it — no timeout was configured anywhere, the dump file is only
+     * written when the call closes, and the callers' retry/fallback wrappers catch
+     * ERRORS, not promises that never settle. The round froze for 639 seconds with
+     * no log, no dump and no error, and only unfroze because the OpenAI SDK's own
+     * 600s default finally fired. Three such stalls are on record (547s, 514s,
+     * 639s) across two tiers and two models, so this is a property of talking to a
+     * provider, not of one model.
+     *
+     * Two independent guarantees, because the first one can be ignored by an
+     * adapter that owns its own transport:
+     *  - the WATCHDOG logs every `requestWatchdogMs` while the call is pending, so
+     *    a stall is visible AS IT HAPPENS instead of after it resolves;
+     *  - the DEADLINE aborts the signal and rejects with {@link LLMTimeoutError}
+     *    once the call has burned its whole attempt budget, so the promise ALWAYS
+     *    settles and the caller's existing retry/fallback path gets to run.
+     *
+     * The deadline is deliberately the LAST line of defence: it budgets
+     * `requestDeadlineAttempts` attempts, so in normal operation the per-attempt
+     * timeout fires first and the retry escalates the OpenRouter pin onto a
+     * healthy provider — which is the outcome we actually want. Reaching the
+     * deadline means the adapter never honoured its own timeout.
+     */
+    private runBounded;
     /**
      * Records token usage for cost/observability attribution. Never throws —
      * a persistence failure logs a warning and the LLM call continues, so
@@ -331,6 +381,8 @@ export declare class LLMService {
          * systemPrompts/prompt). A hit returns early WITHOUT invoking the provider,
          * so it costs no tokens. Default: false. */
         cacheable?: boolean;
+        /** Per-attempt request budget in ms. Defaults to `ai.requestTimeoutMs`. */
+        timeout?: number;
     }): Promise<T>;
     /**
      * Single-step model invocation with tools bound — the durable-checkpointing

package/dist/core/llm/services/llm.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm.service.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/services/llm.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,WAAW,EAA4C,MAAM,0BAA0B,CAAC;AAE5G,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAqB,MAAM,4BAA4B,CAAC;AAEpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6DAA6D,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAiB,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAShE,OAAO,EAAuC,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAa/F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;GAEG;AACH,UAAU,aAAa,CAAC,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAsGD,qBACa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAKtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAXrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;gBAGnC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAC1C,MAAM,EAAE,aAAa,EACrB,iBAAiB,EAAE,iBAAiB,EAKxB,KAAK,CAAC,EAAE,eAAe;IAGtD;;;;OAIG;YACW,YAAY;IA0B1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IA6CjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,OAAO,CAAC,iCAAiC;IA0BzC;;OAEG;IACH,OAAO,CAAC,eAAe;IA6CvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqEG;IACG,IAAI,CAAC,CAAC,EACV,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,GAAG;QAAE,UAAU,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,WAAW,EAAE,WAAW,CAAA;KAAE,CAAC;YA0F7E,eAAe;IAiV7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACG,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5C,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC;QACT,mBAAmB,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG;YAAE,UAAU,EAAE;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,WAAW,EAAE,WAAW,CAAA;SAAE,CAAC,CAAC;KAClG,CAAC;IAkKF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,UAAU,CAAC,MAAM,EAAE;QACvB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC;QACV,UAAU,EAAE,aAAa,CAAC;YAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACzE,MAAM,EAAE,OAAO,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC;YAC9C,WAAW,EAAE,WAAW,CAAC;SAC1B,CAAC,CAAC;KACJ,CAAC;IAsJF;;;;;OAKG;IACG,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE;QAC9B,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;SAAE,CAAC;QAChE,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B;;qFAE6E;QAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;;oDAE4C;QAC5C,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,OAAO,CAAC,CAAC,CAAC;IAiLd;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,QAAQ,CAAC,MAAM,EAAE;QACrB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,KAAK,EAAE,qBAAqB,EAAE,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,SAAS,CAAC;QAAC,UAAU,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CA+EnF"}
+{"version":3,"file":"llm.service.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/services/llm.service.ts"],"names":[],"mappings":"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"}

package/dist/core/llm/services/llm.service.js

@@ -46,7 +46,8 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 var LLMService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LLMService = exports.injectOpenRouterProvider = void 0;
+exports.LLMService = exports.LLMTimeoutError = exports.injectOpenRouterProvider = void 0;
+exports.isTimeoutError = isTimeoutError;
 const openai_compatible_1 = require("@ai-sdk/openai-compatible");
 const messages_1 = require("@langchain/core/messages");
 const prompts_1 = require("@langchain/core/prompts");
@@ -77,6 +78,40 @@ const { streamText, streamObject } = (0, vercel_1.wrapAISDK)(ai);
 // Re-export for the existing test import path.
 var openrouter_fetch_2 = require("./openrouter-fetch");
 Object.defineProperty(exports, "injectOpenRouterProvider", { enumerable: true, get: function () { return openrouter_fetch_2.injectOpenRouterProvider; } });
+/** Fallbacks used only when no `ai` config block is registered (test harnesses). */
+const DEFAULT_REQUEST_TIMEOUT_MS = 120_000;
+const DEFAULT_REQUEST_WATCHDOG_MS = 30_000;
+const DEFAULT_REQUEST_DEADLINE_ATTEMPTS = 3;
+/** Grace on top of the budgeted attempts, covering backoff between retries. */
+const DEADLINE_SLACK_MS = 15_000;
+/**
+ * True for the abort a request timeout raises, whichever layer raised it — the
+ * OpenAI SDK's `APIConnectionTimeoutError`, undici's `TimeoutError`/
+ * `AbortError` DOMException, or a LangChain wrapper around either. Matched on
+ * name and message because the concrete class differs per transport.
+ */
+function isTimeoutError(error) {
+    const name = error?.name ?? "";
+    const message = error instanceof Error ? error.message : String(error ?? "");
+    return (name === "TimeoutError" ||
+        name === "AbortError" ||
+        name === "APIConnectionTimeoutError" ||
+        /aborted due to timeout|timed? ?out|Request was aborted/i.test(message));
+}
+/**
+ * Thrown when a provider call burns its whole deadline without settling.
+ * Distinguishable from a provider error so callers can treat a stall
+ * differently from a refusal if they choose — both are retryable.
+ */
+class LLMTimeoutError extends Error {
+    constructor(label, deadlineMs) {
+        super(`LLM call "${label}" exceeded its ${Math.round(deadlineMs / 1000)}s deadline`);
+        this.label = label;
+        this.deadlineMs = deadlineMs;
+        this.name = "LLMTimeoutError";
+    }
+}
+exports.LLMTimeoutError = LLMTimeoutError;
 /**
  * Best-effort extraction of a JSON object from free-form model text. Local
  * models (notably Gemma over Ollama) routinely ignore a forced `tool_choice`
@@ -187,6 +222,73 @@ let LLMService = LLMService_1 = class LLMService {
         this.cache = cache;
         this.logger = new common_1.Logger(LLMService_1.name);
     }
+    /**
+     * The per-ATTEMPT budget for one provider request. `params.timeout` wins;
+     * otherwise the configured default (`AI_REQUEST_TIMEOUT_MS`).
+     */
+    attemptTimeoutMs(explicit) {
+        return explicit ?? this.config.get("ai")?.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    }
+    /**
+     * Runs one provider call under a WATCHDOG and an ABSOLUTE DEADLINE.
+     *
+     * Why this exists (game e51493e4 r002, 2026-07-26): a plotter request was
+     * accepted by the provider and never answered. Nothing in the stack could
+     * interrupt it — no timeout was configured anywhere, the dump file is only
+     * written when the call closes, and the callers' retry/fallback wrappers catch
+     * ERRORS, not promises that never settle. The round froze for 639 seconds with
+     * no log, no dump and no error, and only unfroze because the OpenAI SDK's own
+     * 600s default finally fired. Three such stalls are on record (547s, 514s,
+     * 639s) across two tiers and two models, so this is a property of talking to a
+     * provider, not of one model.
+     *
+     * Two independent guarantees, because the first one can be ignored by an
+     * adapter that owns its own transport:
+     *  - the WATCHDOG logs every `requestWatchdogMs` while the call is pending, so
+     *    a stall is visible AS IT HAPPENS instead of after it resolves;
+     *  - the DEADLINE aborts the signal and rejects with {@link LLMTimeoutError}
+     *    once the call has burned its whole attempt budget, so the promise ALWAYS
+     *    settles and the caller's existing retry/fallback path gets to run.
+     *
+     * The deadline is deliberately the LAST line of defence: it budgets
+     * `requestDeadlineAttempts` attempts, so in normal operation the per-attempt
+     * timeout fires first and the retry escalates the OpenRouter pin onto a
+     * healthy provider — which is the outcome we actually want. Reaching the
+     * deadline means the adapter never honoured its own timeout.
+     */
+    async runBounded(label, attemptTimeoutMs, controller, work) {
+        const aiConfig = this.config.get("ai");
+        const watchdogMs = aiConfig?.requestWatchdogMs ?? DEFAULT_REQUEST_WATCHDOG_MS;
+        const attempts = aiConfig?.requestDeadlineAttempts ?? DEFAULT_REQUEST_DEADLINE_ATTEMPTS;
+        const deadlineMs = attemptTimeoutMs * Math.max(1, attempts) + DEADLINE_SLACK_MS;
+        const startedAt = Date.now();
+        const watchdog = watchdogMs > 0
+            ? setInterval(() => {
+                this.logger.warn(`[${label}] still pending after ${Math.round((Date.now() - startedAt) / 1000)}s ` +
+                    `(attempt budget ${Math.round(attemptTimeoutMs / 1000)}s, hard deadline ${Math.round(deadlineMs / 1000)}s)`);
+            }, watchdogMs)
+            : undefined;
+        watchdog?.unref?.();
+        let deadline;
+        try {
+            return await new Promise((resolve, reject) => {
+                deadline = setTimeout(() => {
+                    // Abort first so the in-flight socket is released, then reject — the
+                    // caller must not be left waiting on a request nobody is reading.
+                    controller.abort();
+                    reject(new LLMTimeoutError(label, deadlineMs));
+                }, deadlineMs);
+                deadline.unref?.();
+                work().then(resolve, reject);
+            });
+        }
+        finally {
+            if (watchdog)
+                clearInterval(watchdog);
+            if (deadline)
+                clearTimeout(deadline);
+        }
+    }
     /**
      * Records token usage for cost/observability attribution. Never throws —
      * a persistence failure logs a warning and the LLM call continues, so
@@ -478,12 +580,18 @@ let LLMService = LLMService_1 = class LLMService {
         let totalCached = 0;
         const parseFallbacks = [];
         const warnings = [];
+        // Bounded from here on: the request carries an abort signal, a watchdog
+        // reports it while it is still open, and the deadline guarantees this
+        // promise settles even if the provider never answers.
+        const attemptTimeoutMs = this.attemptTimeoutMs(params.timeout);
+        const controller = new AbortController();
+        const label = `${params.metadata?.nodeName ?? "llm.call"}:${aiConfig.model}`;
         try {
-            const result = await this._invokeOriginal(params, session, (i, o, c) => {
+            const result = await this.runBounded(label, attemptTimeoutMs, controller, () => this._invokeOriginal(params, session, (i, o, c) => {
                 totalInput += i;
                 totalOutput += o;
                 totalCached += c;
-            }, (kind) => parseFallbacks.push(kind), (w) => warnings.push(w));
+            }, (kind) => parseFallbacks.push(kind), (w) => warnings.push(w), { attemptTimeoutMs, signal: controller.signal }));
             session.close({
                 finalStatus: "success",
                 totalTokens: { input: totalInput, output: totalOutput, cached: totalCached },
@@ -517,7 +625,10 @@ let LLMService = LLMService_1 = class LLMService {
             throw new Error(`LLM service error: ${message}`);
         }
     }
-    async _invokeOriginal(params, session, addTokens, addParseFallback, addWarning) {
+    async _invokeOriginal(params, session, addTokens, addParseFallback, addWarning, 
+    // The per-attempt budget and the deadline's abort signal, supplied by
+    // `call()`. Optional so direct callers (tests) keep working unbounded.
+    bounds) {
         // Optional: Validate input parameters against schema
         if (params.inputSchema && params.validateInput) {
             try {
@@ -538,11 +649,15 @@ let LLMService = LLMService_1 = class LLMService {
             maxHistoryMessages: params.maxHistoryMessages,
         });
         const prompt = prompts_1.ChatPromptTemplate.fromMessages(template);
-        // Get base model
+        // Get base model. The per-attempt budget rides on the model itself: the
+        // OpenAI client is built with it, so each attempt aborts on schedule and the
+        // LangChain retry re-issues (escalating the OpenRouter pin) instead of the
+        // whole call sitting on one dead socket.
         const baseModel = this.modelService.getLLM({
             temperature: params.temperature,
             modelWeight: params.modelWeight,
             disableThinking: params.disableThinking,
+            timeoutMs: bounds?.attemptTimeoutMs ?? params.timeout,
         });
         // Build config options for the invocation
         const configOptions = {};
@@ -554,6 +669,10 @@ let LLMService = LLMService_1 = class LLMService {
             configOptions.metadata = params.metadata;
         if (params.timeout)
             configOptions.timeout = params.timeout;
+        // The deadline's signal — aborting it releases the in-flight request rather
+        // than leaving an orphaned socket behind a rejected promise.
+        if (bounds?.signal)
+            configOptions.signal = bounds.signal;
         // Track token usage across tool iterations
         let totalInputTokens = 0;
         let totalOutputTokens = 0;
@@ -684,7 +803,33 @@ let LLMService = LLMService_1 = class LLMService {
             });
         }
         session.startIteration("final-structured", conversationMessages);
-        const response = (await structuredLlm.invoke(conversationMessages, Object.keys(configOptions).length > 0 ? configOptions : undefined));
+        // A timed-out attempt is RE-ISSUED ONCE on the same model instance, because
+        // that is what actually recovers a stall: the instance's
+        // `openRouterEscalatingFetch` closure escalates on its second request, so
+        // the retry allows fallbacks and OpenRouter reroutes off the provider that
+        // went quiet. (This is precisely how the 639s stall eventually resolved —
+        // the SDK's 600s abort, then a rerouted retry that answered in 39s. Here it
+        // happens after the attempt budget instead of after ten minutes.)
+        //
+        // A fresh call would NOT get this: `getLLM` builds a new instance per call,
+        // resetting the escalation, so a hard-pinned tier would retry straight back
+        // onto the stalled provider. An abort is the ONLY thing retried here —
+        // provider errors and parse failures stay the caller's business.
+        const invokeStructured = async () => (await structuredLlm.invoke(conversationMessages, Object.keys(configOptions).length > 0 ? configOptions : undefined));
+        let response;
+        try {
+            response = await invokeStructured();
+        }
+        catch (error) {
+            // The deadline's own abort is NOT a stall to reroute around — it means the
+            // whole call is over, so let it through.
+            if (!isTimeoutError(error) || bounds?.signal?.aborted)
+                throw error;
+            const msg = `[LLMService] attempt timed out after ${Math.round((bounds?.attemptTimeoutMs ?? 0) / 1000)}s — re-issuing with provider fallbacks escalated`;
+            console.warn(msg);
+            addWarning(msg);
+            response = await invokeStructured();
+        }
         // Extract token usage with type guard (includes tool iteration tokens)
         const raw = (0, llm_raw_response_1.isValidRaw)(response.raw) ? response.raw : undefined;
         session.recordResponse({
@@ -910,7 +1055,7 @@ let LLMService = LLMService_1 = class LLMService {
         // the session open indefinitely. The AbortError surfaces as a rejection on
         // the awaited promises below (caught + logged).
         const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), params.timeout ?? 60_000);
+        const timeoutId = setTimeout(() => controller.abort(), this.attemptTimeoutMs(params.timeout));
         // Schema cast: `streamObject`'s typing is a conditional union over the
         // output mode (`object` / `enum` / `array` / `no-schema`). Our T is always
         // a Zod object schema; the runtime call is correct.
@@ -1055,7 +1200,7 @@ let LLMService = LLMService_1 = class LLMService {
         // Abort the stream if the provider stalls (see streamCall). The AbortError
         // surfaces as a rejection on the awaited promises below (caught + logged).
         const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), params.timeout ?? 60_000);
+        const timeoutId = setTimeout(() => controller.abort(), this.attemptTimeoutMs(params.timeout));
         const streamResult = streamText({
             model,
             system,
@@ -1175,6 +1320,7 @@ let LLMService = LLMService_1 = class LLMService {
             tools: [{ name: params.tool.name, description: params.tool.description, schema: params.tool.schema }],
             outputSchemaName: params.tool.name,
         });
+        const attemptTimeoutMs = this.attemptTimeoutMs(params.timeout);
         try {
             const model = this.modelService.getLLM({
                 modelWeight,
@@ -1182,6 +1328,7 @@ let LLMService = LLMService_1 = class LLMService {
                 maxOutputTokens: params.maxOutputTokens,
                 frequencyPenalty: params.frequencyPenalty,
                 temperature: params.temperature,
+                timeoutMs: attemptTimeoutMs,
             });
             const tool = new tools_1.DynamicStructuredTool({
                 name: params.tool.name,
@@ -1251,14 +1398,20 @@ let LLMService = LLMService_1 = class LLMService {
                 }
                 return null;
             };
-            let response = (await bound.invoke(baseMessages));
+            // Each provider invocation is bounded independently — the nudge retry is a
+            // second request and gets its own budget, not the leftovers of the first.
+            const invokeBounded = async (messages, attempt) => {
+                const controller = new AbortController();
+                return (await this.runBounded(`extractViaTool:${params.tool.name}:${attempt}`, attemptTimeoutMs, controller, () => bound.invoke(messages, { signal: controller.signal })));
+            };
+            let response = await invokeBounded(baseMessages, "attempt-1");
             let parsed = tryExtract(response);
             // One retry with an explicit nudge — local models frequently comply on a
             // second pass once told plainly that prose is not acceptable.
             if (parsed === null) {
                 describe(response, "attempt-1");
                 const nudge = new messages_1.HumanMessage(`You did NOT call the \`${params.tool.name}\` tool. Do not write prose, refusals, or explanations. Respond ONLY by calling \`${params.tool.name}\` with valid arguments now.`);
-                response = (await bound.invoke([...baseMessages, nudge]));
+                response = await invokeBounded([...baseMessages, nudge], "attempt-2");
                 parsed = tryExtract(response);
                 if (parsed === null)
                     describe(response, "attempt-2");