@nexus-cortex/core 4.114.2 → 4.115.0

package/dist/orchestrator/emptyResponseClassifier.d.ts

@@ -60,7 +60,11 @@ export interface ReasoningExhaustBackoffConfig {
 }
 /** CORTEX_REASONING_EXHAUST_BACKOFF (default on; 'false' disables) / CORTEX_REASONING_EXHAUST_BACKOFF_TURNS (default 2, 1..10). */
 export declare function resolveReasoningExhaustBackoff(env?: NodeJS.ProcessEnv): ReasoningExhaustBackoffConfig;
-export declare function reasoningExhaustionNudge(level: ReasoningEffortLevel | undefined): string;
+export declare function reasoningExhaustionNudge(level: ReasoningEffortLevel | undefined, opts?: {
+    contract?: string;
+    outputCap?: number;
+    env?: NodeJS.ProcessEnv;
+}): string;
 /** Kind-tailored nudge that also knows the exhaustion special case (falls back to emptyResponseNudge). */
-export declare function emptyResponseNudgeFor(cls: EmptyResponseClassification, backoffLevel?: ReasoningEffortLevel): string;
+export declare function emptyResponseNudgeFor(cls: EmptyResponseClassification, backoffLevel?: ReasoningEffortLevel, outputCap?: number): string;
 //# sourceMappingURL=emptyResponseClassifier.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"emptyResponseClassifier.d.ts","sourceRoot":"","sources":["../../src/orchestrator/emptyResponseClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,gBAAgB,GAChB,uBAAuB,GACvB,oBAAoB,GACpB,WAAW,CAAC;AAKhB,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,iBAAiB,CAAC;IACxB,2DAA2D;IAC3D,YAAY,EAAE,OAAO,CAAC;IACtB,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAC;CACrB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,OAAO,GACtB,2BAA2B,CAuB7B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAWlE;AAED;;wGAEwG;AACxG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAElE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAElG;AAED,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7D,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,oBAAoB,CAMhF;AAED,MAAM,WAAW,6BAA6B;IAAG,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAElF,mIAAmI;AACnI,wBAAgB,8BAA8B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,6BAA6B,CAOlH;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS,GAAG,MAAM,CAQxF;AAED,0GAA0G;AAC1G,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,2BAA2B,EAAE,YAAY,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAGnH"}
+{"version":3,"file":"emptyResponseClassifier.d.ts","sourceRoot":"","sources":["../../src/orchestrator/emptyResponseClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,gBAAgB,GAChB,uBAAuB,GACvB,oBAAoB,GACpB,WAAW,CAAC;AAKhB,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,iBAAiB,CAAC;IACxB,2DAA2D;IAC3D,YAAY,EAAE,OAAO,CAAC;IACtB,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAC;CACrB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,OAAO,GACtB,2BAA2B,CAuB7B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAWlE;AAED;;wGAEwG;AACxG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAElE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAElG;AAED,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7D,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,oBAAoB,CAMhF;AAED,MAAM,WAAW,6BAA6B;IAAG,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAElF,mIAAmI;AACnI,wBAAgB,8BAA8B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,6BAA6B,CASlH;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS,EAAE,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GAAG,MAAM,CAkBvK;AAED,0GAA0G;AAC1G,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,2BAA2B,EAAE,YAAY,CAAC,EAAE,oBAAoB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvI"}

package/dist/orchestrator/emptyResponseClassifier.js

@@ -98,13 +98,23 @@ export function stepDownEffort(current) {
 /** CORTEX_REASONING_EXHAUST_BACKOFF (default on; 'false' disables) / CORTEX_REASONING_EXHAUST_BACKOFF_TURNS (default 2, 1..10). */
 export function resolveReasoningExhaustBackoff(env = process.env) {
     const v = (env.CORTEX_REASONING_EXHAUST_BACKOFF ?? '').trim().toLowerCase();
-    const enabled = v === '' ? true : !(v === 'false' || v === '0' || v === 'off');
+    // HB-TURN-CONTRACT: the channel contract re-issues at the SAME effort — backoff defaults OFF there (explicit 'true' overrides).
+    const channel = String(env.CORTEX_TURN_CONTRACT ?? '').trim().toLowerCase() === 'channel';
+    const enabled = v === '' ? !channel : !(v === 'false' || v === '0' || v === 'off');
     const rawTurns = (env.CORTEX_REASONING_EXHAUST_BACKOFF_TURNS ?? '').trim();
     const n = rawTurns === '' ? 2 : Number(rawTurns);
     const turns = Number.isFinite(n) && n >= 1 ? Math.min(10, Math.floor(n)) : 2;
     return { enabled, turns };
 }
-export function reasoningExhaustionNudge(level) {
+export function reasoningExhaustionNudge(level, opts = {}) {
+    const contract = opts.contract ?? String((opts.env ?? process.env).CORTEX_TURN_CONTRACT ?? '').trim().toLowerCase();
+    if (contract === 'channel') {
+        // HB-TURN-CONTRACT: the Terminus-2 recovery — say exactly what happened and re-issue at the SAME effort (no step-down).
+        const cap = opts.outputCap && opts.outputCap > 0 ? `${opts.outputCap} tokens` : 'the maximum output length';
+        return (`NONE of the actions you intended were performed: your reasoning consumed the entire output budget (${cap}, reasoning ` +
+            'counts against it) and no answer was produced. Re-issue this turn: state ANALYSIS and PLAN in a few sentences, then ' +
+            'make the tool call. Break the work into smaller steps, each well under that budget.');
+    }
     const lv = level ? ` Reasoning effort is temporarily lowered to '${level}' for your next calls.` : '';
     return ('Your previous turn spent the ENTIRE output budget on internal reasoning and delivered nothing — no text, no tool ' +
         'call — so it was wasted. Do not restart that analysis. Decide in a few sentences and ACT: call the single most ' +
@@ -112,9 +122,9 @@ export function reasoningExhaustionNudge(level) {
         'done.' + lv);
 }
 /** Kind-tailored nudge that also knows the exhaustion special case (falls back to emptyResponseNudge). */
-export function emptyResponseNudgeFor(cls, backoffLevel) {
+export function emptyResponseNudgeFor(cls, backoffLevel, outputCap) {
     if (isReasoningExhaustion(cls))
-        return reasoningExhaustionNudge(backoffLevel);
+        return reasoningExhaustionNudge(backoffLevel, { outputCap });
     return emptyResponseNudge(cls.kind);
 }
 //# sourceMappingURL=emptyResponseClassifier.js.map

package/dist/orchestrator/emptyResponseClassifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"emptyResponseClassifier.js","sourceRoot":"","sources":["../../src/orchestrator/emptyResponseClassifier.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"emptyResponseClassifier.js","sourceRoot":"","sources":["../../src/orchestrator/emptyResponseClassifier.ts"],"names":[],"mappings":"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"}

package/dist/system-messages/promptPresets.d.ts

@@ -31,6 +31,18 @@ export declare const BOOT_MINIMAL_PROMPT: string;
  * the zero-discovery gap (0 Skill/SearchTools calls in ~11K bench tool calls).
  */
 export declare function buildBootMinimalPrompt(orientPath?: string, env?: NodeJS.ProcessEnv): string;
+/**
+ * HB-TURN-CONTRACT (2026-09-17, Terminus-2 disparity #3 — suppress vs channel). The boot-minimal door SUPPRESSES
+ * deliberation ("Prefer acting over deliberating") and was tuned at low effort; at high effort the model fought it
+ * (R153: 58 turns/63 sessions reasoned to the 65536 cap and emitted nothing). Terminus 2 CHANNELS deliberation instead:
+ * think as long as you like, then every response must carry analysis + plan + the action. CORTEX_TURN_CONTRACT=channel
+ * swaps the suppression clause for that output contract; '' (default) = the shipped door, byte-identical.
+ */
+export type TurnContract = 'channel' | '';
+export declare function resolveTurnContract(env?: NodeJS.ProcessEnv): TurnContract;
+export declare const SUPPRESS_CLAUSE = "Prefer acting over deliberating. ";
+export declare const TURN_CONTRACT_CLAUSE: string;
+export declare function applyTurnContract(prompt: string, env?: NodeJS.ProcessEnv): string;
 /**
  * HB-DELEGATION-DOCTRINE (4.108.1, DARK by default): CORTEX_DELEGATION_HINT=true appends one clause to the boot-minimal
  * prompt naming the Task tool for large independent sub-tasks / output-heavy exploration. Fleet evidence: 0 Task

package/dist/system-messages/promptPresets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promptPresets.d.ts","sourceRoot":"","sources":["../../src/system-messages/promptPresets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC;AAE1C,eAAO,MAAM,mBAAmB,QAOsC,CAAC;AAEvE;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAYxG;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAGnF;AACD,eAAO,MAAM,sBAAsB,QAGuD,CAAC;AAE3F,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAEnF;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAEpB"}
+{"version":3,"file":"promptPresets.d.ts","sourceRoot":"","sources":["../../src/system-messages/promptPresets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC;AAE1C,eAAO,MAAM,mBAAmB,QAOsC,CAAC;AAEvE;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAaxG;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,EAAE,CAAC;AAC1C,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAGtF;AACD,eAAO,MAAM,eAAe,sCAAsC,CAAC;AACnE,eAAO,MAAM,oBAAoB,QAIgD,CAAC;AAClF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAG9F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAGnF;AACD,eAAO,MAAM,sBAAsB,QAGuD,CAAC;AAE3F,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAEnF;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAEpB"}

package/dist/system-messages/promptPresets.js

@@ -38,14 +38,28 @@ export const BOOT_MINIMAL_PROMPT = 'You are Cortex, a coding agent working in th
 export function buildBootMinimalPrompt(orientPath, env = process.env) {
     const hint = resolveDelegationHint(env) ? DELEGATION_HINT_CLAUSE : '';
     if (!orientPath)
-        return BOOT_MINIMAL_PROMPT + hint;
-    return ('You are Cortex, a coding agent working in this workspace through the provided tools. ' +
+        return applyTurnContract(BOOT_MINIMAL_PROMPT + hint, env);
+    return applyTurnContract('You are Cortex, a coding agent working in this workspace through the provided tools. ' +
         'Complete the user\'s task by reading and running real code — never answer from memory ' +
         'when a command can verify. Prefer acting over deliberating. For workspace tasks, orient ' +
         `first: run \`sh ${orientPath}\` via Bash — its output maps the workspace and indexes ` +
         'your skill guides; consult a guide when the task matches its domain. If you did not ' +
         'finish the task, say so plainly — never claim work you have not done. When the task is ' +
-        'complete, reply with the final answer only.' + hint);
+        'complete, reply with the final answer only.' + hint, env);
+}
+export function resolveTurnContract(env = process.env) {
+    const v = String(env.CORTEX_TURN_CONTRACT ?? '').trim().toLowerCase();
+    return v === 'channel' ? 'channel' : '';
+}
+export const SUPPRESS_CLAUSE = 'Prefer acting over deliberating. ';
+export const TURN_CONTRACT_CLAUSE = ' Think as long as you need before you answer. Then every response must contain, in this order: ANALYSIS — what the ' +
+    'latest outputs show, what is done and what is still open; PLAN — the next concrete steps and what each should ' +
+    'prove; then the tool call(s) that carry out the first step. Keep each step small enough that its output fits ' +
+    'comfortably, and verify against the task\'s own criteria, not your own tests.';
+export function applyTurnContract(prompt, env = process.env) {
+    if (resolveTurnContract(env) !== 'channel')
+        return prompt;
+    return prompt.replace(SUPPRESS_CLAUSE, '') + TURN_CONTRACT_CLAUSE;
 }
 /**
  * HB-DELEGATION-DOCTRINE (4.108.1, DARK by default): CORTEX_DELEGATION_HINT=true appends one clause to the boot-minimal

package/dist/system-messages/promptPresets.js.map

@@ -1 +1 @@
-{"version":3,"file":"promptPresets.js","sourceRoot":"","sources":["../../src/system-messages/promptPresets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,uFAAuF;IACvF,wFAAwF;IACxF,0FAA0F;IAC1F,0FAA0F;IAC1F,2FAA2F;IAC3F,2FAA2F;IAC3F,oEAAoE,CAAC;AAEvE;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAmB,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC9F,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,IAAI,CAAC,UAAU;QAAE,OAAO,mBAAmB,GAAG,IAAI,CAAC;IACnD,OAAO,CACL,uFAAuF;QACvF,wFAAwF;QACxF,0FAA0F;QAC1F,mBAAmB,UAAU,0DAA0D;QACvF,sFAAsF;QACtF,yFAAyF;QACzF,6CAA6C,GAAG,IAAI,CACrD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACxE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxE,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC;AACjD,CAAC;AACD,MAAM,CAAC,MAAM,sBAAsB,GACjC,oHAAoH;IACpH,uHAAuH;IACvH,wFAAwF,CAAC;AAE3F,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAAC,MAAgC;IAC7D,OAAO,MAAM,KAAK,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AACxD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAChC,MAAgC,EAChC,UAAmB;IAEnB,OAAO,MAAM,KAAK,cAAc,CAAC,CAAC,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC"}
+{"version":3,"file":"promptPresets.js","sourceRoot":"","sources":["../../src/system-messages/promptPresets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,uFAAuF;IACvF,wFAAwF;IACxF,0FAA0F;IAC1F,0FAA0F;IAC1F,2FAA2F;IAC3F,2FAA2F;IAC3F,oEAAoE,CAAC;AAEvE;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAmB,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC9F,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,IAAI,CAAC,UAAU;QAAE,OAAO,iBAAiB,CAAC,mBAAmB,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3E,OAAO,iBAAiB,CACtB,uFAAuF;QACvF,wFAAwF;QACxF,0FAA0F;QAC1F,mBAAmB,UAAU,0DAA0D;QACvF,sFAAsF;QACtF,yFAAyF;QACzF,6CAA6C,GAAG,IAAI,EACpD,GAAG,CACJ,CAAC;AACJ,CAAC;AAUD,MAAM,UAAU,mBAAmB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACtE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtE,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC;AACD,MAAM,CAAC,MAAM,eAAe,GAAG,mCAAmC,CAAC;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAC/B,qHAAqH;IACrH,gHAAgH;IAChH,+GAA+G;IAC/G,+EAA+E,CAAC;AAClF,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,MAAyB,OAAO,CAAC,GAAG;IACpF,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC1D,OAAO,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,GAAG,oBAAoB,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACxE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxE,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC;AACjD,CAAC;AACD,MAAM,CAAC,MAAM,sBAAsB,GACjC,oHAAoH;IACpH,uHAAuH;IACvH,wFAAwF,CAAC;AAE3F,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAAC,MAAgC;IAC7D,OAAO,MAAM,KAAK,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AACxD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAChC,MAAgC,EAChC,UAAmB;IAEnB,OAAO,MAAM,KAAK,cAAc,CAAC,CAAC,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC"}

package/package.json

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