@nexus-cortex/core 4.124.59 → 4.124.61

package/dist/orchestrator/wallRetryLadder.d.ts

@@ -0,0 +1,29 @@
+/**
+ * HB-WALL-RETRY-LADDER (R241 / R240, 2026-10-06, DARK).
+ *
+ * Why: under the 393,216-token cap every reasoning wall in the 10-05 TB4 cell was a DEGENERATE REPETITION LOOP (40/40), and the retry
+ * after a wall re-entered the same loop from its first tokens at full cap price (~$0.47 + ~20 min each). DeepSeek offers no server-side
+ * cycle breaker in thinking mode (penalties deprecated, temperature inert, stop sequences do not reach reasoning_content — probed 10-06),
+ * and the bench's action call is non-streaming, so the only bound is the retry's own max_tokens and its mode.
+ *
+ * What: after the n-th reasoning-exhaustion wall in a turn, the empty-response RETRY is sent with (a) max_tokens from a ladder
+ * (CORTEX_WALL_RETRY_LADDER="65536,16384": wall 1 → 65,536, wall 2+ → 16,384; shorter ladders repeat the last rung) and, from wall
+ * CORTEX_WALL_FORCE_ACTION_AT (default 2) on, (b) `tool_choice: required` — which on DeepSeek the gateway already turns into thinking OFF
+ * (AC ~1011-1016 / 1056-1062): the model must emit a tool call and act. Probed 10-06: the forced thinking-off tool call works
+ * mid-conversation and thinking resumes on the next call; the switch costs ONE uncached prefix read (thinking mode is in the cache key).
+ * Only exhaustion kinds qualify — never a "do not call tools" nudge kind (nudgeForbidsTools). Off = byte-identical.
+ */
+import type { EmptyResponseClassification } from './emptyResponseClassifier.js';
+export interface WallRetryLadderConfig {
+    enabled: boolean;
+    /** max_tokens per wall index (1-based); the last rung repeats. */
+    rungs: number[];
+    /** wall index (1-based) from which the retry forces an action (tool_choice required → thinking off on DeepSeek); 0 = never. */
+    forceActionAt: number;
+}
+export declare function resolveWallRetryLadder(env?: NodeJS.ProcessEnv): WallRetryLadderConfig;
+/** max_tokens for the retry after wall number `wallIndex` (1-based); `baseCap` bounds it (never raise above the request's own cap). */
+export declare function ladderCapFor(cfg: WallRetryLadderConfig, wallIndex: number, baseCap: number | undefined): number | undefined;
+/** Force an action on this retry? Only for reasoning-exhaustion walls, never for nudge kinds that forbid tools. */
+export declare function shouldForceAction(cfg: WallRetryLadderConfig, wallIndex: number, cls: EmptyResponseClassification | null | undefined): boolean;
+//# sourceMappingURL=wallRetryLadder.d.ts.map

package/dist/orchestrator/wallRetryLadder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallRetryLadder.d.ts","sourceRoot":"","sources":["../../src/orchestrator/wallRetryLadder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAGhF,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+HAA+H;IAC/H,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,qBAAqB,CASlG;AAED,uIAAuI;AACvI,wBAAgB,YAAY,CAAC,GAAG,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI3H;AAED,mHAAmH;AACnH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAK7I"}

package/dist/orchestrator/wallRetryLadder.js

@@ -0,0 +1,29 @@
+import { isReasoningExhaustion, nudgeForbidsTools } from './emptyResponseClassifier.js';
+export function resolveWallRetryLadder(env = process.env) {
+    const raw = String(env.CORTEX_WALL_RETRY_LADDER ?? '').trim();
+    const rungs = raw.split(',').map((s) => parseInt(s.trim(), 10)).filter((n) => Number.isInteger(n) && n >= 1024);
+    const fa = parseInt(String(env.CORTEX_WALL_FORCE_ACTION_AT ?? '').trim(), 10);
+    return {
+        enabled: rungs.length > 0,
+        rungs,
+        forceActionAt: Number.isInteger(fa) && fa >= 0 ? fa : 2,
+    };
+}
+/** max_tokens for the retry after wall number `wallIndex` (1-based); `baseCap` bounds it (never raise above the request's own cap). */
+export function ladderCapFor(cfg, wallIndex, baseCap) {
+    if (!cfg.enabled || cfg.rungs.length === 0 || wallIndex < 1)
+        return baseCap;
+    const rung = cfg.rungs[Math.min(wallIndex, cfg.rungs.length) - 1];
+    return baseCap && baseCap > 0 ? Math.min(baseCap, rung) : rung;
+}
+/** Force an action on this retry? Only for reasoning-exhaustion walls, never for nudge kinds that forbid tools. */
+export function shouldForceAction(cfg, wallIndex, cls) {
+    if (!cfg.enabled || cfg.forceActionAt <= 0 || wallIndex < cfg.forceActionAt)
+        return false;
+    if (!isReasoningExhaustion(cls))
+        return false;
+    if (cls && nudgeForbidsTools(cls.kind))
+        return false;
+    return true;
+}
+//# sourceMappingURL=wallRetryLadder.js.map

package/dist/orchestrator/wallRetryLadder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallRetryLadder.js","sourceRoot":"","sources":["../../src/orchestrator/wallRetryLadder.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAUxF,MAAM,UAAU,sBAAsB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACzE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IAChH,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9E,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;QACzB,KAAK;QACL,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,uIAAuI;AACvI,MAAM,UAAU,YAAY,CAAC,GAA0B,EAAE,SAAiB,EAAE,OAA2B;IACrG,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAC5E,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAE,CAAC;IACnE,OAAO,OAAO,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjE,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,iBAAiB,CAAC,GAA0B,EAAE,SAAiB,EAAE,GAAmD;IAClI,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,aAAa,IAAI,CAAC,IAAI,SAAS,GAAG,GAAG,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IAC1F,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,GAAG,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cortex/core",
-  "version": "4.124.59",
+  "version": "4.124.61",
   "description": "Core orchestration library implementing Claude CLI architecture patterns",
   "type": "module",
   "main": "./dist/index.js",
@@ -47,8 +47,8 @@
     "@google/generative-ai": "^0.2.1",
     "@gradio/client": "^2.3.1",
     "@modelcontextprotocol/sdk": "^1.20.2",
-    "@nexus-cortex/executors": "4.124.59",
-    "@nexus-cortex/types": "4.124.59",
+    "@nexus-cortex/executors": "4.124.61",
+    "@nexus-cortex/types": "4.124.61",
     "@types/uuid": "^10.0.0",
     "ajv": "^8.12.0",
     "chokidar": "^3.6.0",