@nexus-cortex/core 4.124.35 → 4.124.36

package/dist/orchestrator/effortRamp.d.ts

@@ -2,13 +2,15 @@
  * HB-EFFORT-RAMP (CORTEX_EFFORT_RAMP, DARK — 2026-09-30).
  *
  * Evidence (TB4.0 t4cw traces, photonic-waveguide-routing r2 / protein-autointerp-disulfide r1): the action model hit the
- * 65,536-token output wall right after reading the task — trying to solve the routing plan / the hidden rule in its head
- * before writing any code — and only began acting after being forced down to low. The lift planner has already written the
- * plan of attack at that point. This lever runs the first N action calls of a turn at a lower effort, then hands back to
- * the configured effort (CORTEX_ACTION_EFFORT / request param / card). NOTE: a GLOBAL low was measured harmful on TB4.0
- * (e6: 3/29 vs high 10/29) — this lever only covers the opening calls.
+ * 65,536-token output wall right after reading the task — on its 3rd and 6th calls — trying to solve the routing plan / the
+ * hidden rule in its head before writing any code, and only began acting after being forced down to low. A window of action
+ * calls runs at a lower effort, then the configured effort (CORTEX_ACTION_EFFORT / request param / card) returns.
+ * Calls are counted from 1 per turn (1 = the initial request). The initial call should stay at the configured effort: the
+ * 4.124.35 smoke with the window starting at call 1 skipped the boot prompt's orient step in 2 of 3 runs (0 of 1 without).
+ * NOTE: a GLOBAL low was measured harmful on TB4.0 (e6: 3/29 vs high 10/29) — this lever covers only the window.
  *
- *   CORTEX_EFFORT_RAMP = off (default) | <level>[:<calls>] (e.g. low:8; calls 1..100, default 8) | on (= low:8)
+ *   CORTEX_EFFORT_RAMP = off (default) | <level>:<from>-<to> (e.g. low:2-8, calls from..to inclusive, 1..100)
+ *                      | <level>:<n> (calls 2..n+1 — the initial call is never ramped) | on (= low:2-8)
  *
  * Precedence at a call: R153 exhaustion backoff > effort pulse > ramp > request param > card.
  */
@@ -16,9 +18,10 @@ import type { ReasoningEffortLevel } from './emptyResponseClassifier.js';
 export interface EffortRampConfig {
     enabled: boolean;
     level: ReasoningEffortLevel;
-    calls: number;
+    from: number;
+    to: number;
 }
 export declare function resolveEffortRamp(env?: NodeJS.ProcessEnv): EffortRampConfig;
-/** The ramp level for the call with this index in the turn (0 = the initial request), or undefined once the ramp is over. */
+/** The ramp level for the call with this 0-based index in the turn (0 = the initial request = call 1), or undefined. */
 export declare function rampEffortFor(cfg: EffortRampConfig, callIndex: number): ReasoningEffortLevel | undefined;
 //# sourceMappingURL=effortRamp.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"effortRamp.d.ts","sourceRoot":"","sources":["../../src/orchestrator/effortRamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAAG,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAKlG,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,gBAAgB,CASxF;AAED,6HAA6H;AAC7H,wBAAgB,aAAa,CAAC,GAAG,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAExG"}
+{"version":3,"file":"effortRamp.d.ts","sourceRoot":"","sources":["../../src/orchestrator/effortRamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAAG,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAM7G,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,gBAAgB,CAWxF;AAED,wHAAwH;AACxH,wBAAgB,aAAa,CAAC,GAAG,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAGxG"}

package/dist/orchestrator/effortRamp.js

@@ -1,21 +1,34 @@
 const LEVELS = ['low', 'medium', 'high', 'max'];
-const OFF = { enabled: false, level: 'low', calls: 0 };
+const OFF = { enabled: false, level: 'low', from: 0, to: 0 };
+const int = (x) => (x !== undefined && /^\d+$/.test(x.trim()) ? Number(x.trim()) : NaN);
 export function resolveEffortRamp(env = process.env) {
     const v = String(env.CORTEX_EFFORT_RAMP ?? '').trim().toLowerCase();
     if (v === '' || v === 'off' || v === 'false' || v === '0')
         return OFF;
     if (v === 'on' || v === 'true' || v === '1')
-        return { enabled: true, level: 'low', calls: 8 };
-    const [lv, n] = v.split(':');
-    if (!LEVELS.includes(lv))
+        return { enabled: true, level: 'low', from: 2, to: 8 };
+    const [lv, spec] = v.split(':');
+    if (!LEVELS.includes(lv) || spec === undefined)
         return OFF;
-    const calls = n === undefined || n === '' ? 8 : Number(n);
-    if (!Number.isFinite(calls) || calls < 1)
-        return OFF;
-    return { enabled: true, level: lv, calls: Math.min(100, Math.floor(calls)) };
+    let from;
+    let to;
+    if (spec.includes('-')) {
+        const [a, b] = spec.split('-');
+        from = int(a);
+        to = int(b);
+    }
+    else {
+        const n = int(spec);
+        from = 2;
+        to = n + 1;
+    }
+    if (!Number.isFinite(from) || !Number.isFinite(to) || from < 2 || to < from)
+        return OFF; // the initial call is never ramped
+    return { enabled: true, level: lv, from, to: Math.min(100, to) };
 }
-/** The ramp level for the call with this index in the turn (0 = the initial request), or undefined once the ramp is over. */
+/** The ramp level for the call with this 0-based index in the turn (0 = the initial request = call 1), or undefined. */
 export function rampEffortFor(cfg, callIndex) {
-    return cfg.enabled && callIndex < cfg.calls ? cfg.level : undefined;
+    const call = callIndex + 1;
+    return cfg.enabled && call >= cfg.from && call <= cfg.to ? cfg.level : undefined;
 }
 //# sourceMappingURL=effortRamp.js.map

package/dist/orchestrator/effortRamp.js.map

@@ -1 +1 @@
-{"version":3,"file":"effortRamp.js","sourceRoot":"","sources":["../../src/orchestrator/effortRamp.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,GAAoC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACjF,MAAM,GAAG,GAAqB,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAEzE,MAAM,UAAU,iBAAiB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACpE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IACtE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC9F,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAA0B,CAAC;QAAE,OAAO,GAAG,CAAC;IAC7D,MAAM,KAAK,GAAG,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAA0B,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AACvG,CAAC;AAED,6HAA6H;AAC7H,MAAM,UAAU,aAAa,CAAC,GAAqB,EAAE,SAAiB;IACpE,OAAO,GAAG,CAAC,OAAO,IAAI,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC"}
+{"version":3,"file":"effortRamp.js","sourceRoot":"","sources":["../../src/orchestrator/effortRamp.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,GAAoC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACjF,MAAM,GAAG,GAAqB,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;AAC/E,MAAM,GAAG,GAAG,CAAC,CAAqB,EAAU,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpH,MAAM,UAAU,iBAAiB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACpE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IACtE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IACpG,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAA0B,CAAC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACnF,IAAI,IAAY,CAAC;IAAC,IAAI,EAAU,CAAC;IACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAAC,CAAC;SAClF,CAAC;QAAC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,GAAG,CAAC,CAAC;QAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,CAAC,mCAAmC;IAC5H,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAA0B,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED,wHAAwH;AACxH,MAAM,UAAU,aAAa,CAAC,GAAqB,EAAE,SAAiB;IACpE,MAAM,IAAI,GAAG,SAAS,GAAG,CAAC,CAAC;IAC3B,OAAO,GAAG,CAAC,OAAO,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACnF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cortex/core",
-  "version": "4.124.35",
+  "version": "4.124.36",
   "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.35",
-    "@nexus-cortex/types": "4.124.35",
+    "@nexus-cortex/executors": "4.124.36",
+    "@nexus-cortex/types": "4.124.36",
     "@types/uuid": "^10.0.0",
     "ajv": "^8.12.0",
     "chokidar": "^3.6.0",