@nexus-cortex/core 4.95.0 → 4.96.1

package/dist/orchestrator/emptyResponseClassifier.d.ts

@@ -11,7 +11,7 @@
  *
  * Pure — no orchestrator state.
  */
-export type EmptyResponseKind = 'not_empty' | 'reasoning_only' | 'no_visible_content' | 'truncated';
+export type EmptyResponseKind = 'not_empty' | 'reasoning_only' | 'reasoning_only_active' | 'no_visible_content' | 'truncated';
 export interface EmptyResponseClassification {
     kind: EmptyResponseKind;
     /** The model emitted thinking/redacted_thinking blocks. */
@@ -19,14 +19,27 @@ export interface EmptyResponseClassification {
     /** The model emitted an (unexecuted) tool_use — not an empty turn. */
     hadToolUse: boolean;
 }
-export declare function classifyEmptyResponse(content: unknown, stopReason?: string): EmptyResponseClassification;
+/**
+ * @param loopHasBudget — HB-ENDTURN-TERMINAL (2026-09-08): the tool loop still has budget/iterations
+ *   left (computed by the orchestrator; gated behind CORTEX_EMPTY_TURN_CONTINUE). A reasoning-only turn
+ *   that ISN'T truncated is AMBIGUOUS: "reasoned to a final answer, forgot to surface it" (exhausted →
+ *   force the answer, no tools) vs "reasoned about the NEXT action mid-recon" (has budget → CONTINUE with
+ *   tools). The budget-blind classifier previously routed BOTH to `reasoning_only` (write-your-answer +
+ *   forbid tools), which forced premature terminal surrender on DeepSeek mid-recon builds. With budget
+ *   remaining we split it into `reasoning_only_active` (continue-with-tools), mirroring the D-E `truncated`
+ *   carve-out. When loopHasBudget is undefined/false the behavior is byte-identical to before.
+ */
+export declare function classifyEmptyResponse(content: unknown, stopReason?: string, loopHasBudget?: boolean): EmptyResponseClassification;
 /**
  * Nudge tailored to the empty-response kind. `reasoning_only` means the model
  * did the thinking but never surfaced the answer — tell it exactly that;
- * `no_visible_content` gets the generic completion prompt.
+ * `reasoning_only_active` (budget remaining) means it was thinking about its
+ * NEXT action — tell it to continue; `no_visible_content` gets the generic
+ * completion prompt.
  */
 export declare function emptyResponseNudge(kind: EmptyResponseKind): string;
 /** D-E: a truncated turn was cut off — it should be allowed to CONTINUE (incl. tools), not be told
- * "do not call any more tools" (which the reasoning_only/no_content path appends). */
+ * "do not call any more tools" (which the reasoning_only/no_content path appends).
+ * HB-ENDTURN-TERMINAL: `reasoning_only_active` (mid-recon, budget remaining) is likewise a CONTINUE. */
 export declare function nudgeForbidsTools(kind: EmptyResponseKind): boolean;
 //# 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,GAAG,WAAW,GAAG,gBAAgB,GAAG,oBAAoB,GAAG,WAAW,CAAC;AAKpG,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,iBAAiB,CAAC;IACxB,2DAA2D;IAC3D,YAAY,EAAE,OAAO,CAAC;IACtB,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAC;CACrB;AAMD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,2BAA2B,CAsBxG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAQlE;AAED;sFACsF;AACtF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAElE"}
+{"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"}

package/dist/orchestrator/emptyResponseClassifier.js

@@ -17,7 +17,17 @@ const TRUNCATION_STOP = new Set(['max_tokens', 'length', 'max_output_tokens', 'm
 function blocks(content) {
     return Array.isArray(content) ? content : [];
 }
-export function classifyEmptyResponse(content, stopReason) {
+/**
+ * @param loopHasBudget — HB-ENDTURN-TERMINAL (2026-09-08): the tool loop still has budget/iterations
+ *   left (computed by the orchestrator; gated behind CORTEX_EMPTY_TURN_CONTINUE). A reasoning-only turn
+ *   that ISN'T truncated is AMBIGUOUS: "reasoned to a final answer, forgot to surface it" (exhausted →
+ *   force the answer, no tools) vs "reasoned about the NEXT action mid-recon" (has budget → CONTINUE with
+ *   tools). The budget-blind classifier previously routed BOTH to `reasoning_only` (write-your-answer +
+ *   forbid tools), which forced premature terminal surrender on DeepSeek mid-recon builds. With budget
+ *   remaining we split it into `reasoning_only_active` (continue-with-tools), mirroring the D-E `truncated`
+ *   carve-out. When loopHasBudget is undefined/false the behavior is byte-identical to before.
+ */
+export function classifyEmptyResponse(content, stopReason, loopHasBudget) {
     const bs = blocks(content);
     const hadReasoning = bs.some((b) => b?.type === 'thinking' || b?.type === 'redacted_thinking');
     const hadToolUse = bs.some((b) => b?.type === 'tool_use');
@@ -31,29 +41,36 @@ export function classifyEmptyResponse(content, stopReason) {
     if (stopReason && TRUNCATION_STOP.has(stopReason.trim().toLowerCase())) {
         return { kind: 'truncated', hadReasoning, hadToolUse };
     }
-    return {
-        kind: hadReasoning ? 'reasoning_only' : 'no_visible_content',
-        hadReasoning,
-        hadToolUse,
-    };
+    if (hadReasoning) {
+        // HB-ENDTURN-TERMINAL: with budget remaining this is a mid-recon reasoning turn (continue), not a
+        // finished-but-unsurfaced answer. Only when budget is spent do we demand the final answer (no tools).
+        return { kind: loopHasBudget ? 'reasoning_only_active' : 'reasoning_only', hadReasoning, hadToolUse };
+    }
+    return { kind: 'no_visible_content', hadReasoning, hadToolUse };
 }
 /**
  * Nudge tailored to the empty-response kind. `reasoning_only` means the model
  * did the thinking but never surfaced the answer — tell it exactly that;
- * `no_visible_content` gets the generic completion prompt.
+ * `reasoning_only_active` (budget remaining) means it was thinking about its
+ * NEXT action — tell it to continue; `no_visible_content` gets the generic
+ * completion prompt.
  */
 export function emptyResponseNudge(kind) {
     if (kind === 'truncated') {
         return 'Your previous response was cut off by the output token limit before you finished — it was NOT complete. Continue from where you stopped and finish concisely; do not restart from the beginning.';
     }
+    if (kind === 'reasoning_only_active') {
+        return 'You produced reasoning but took no action and gave no final answer, and you still have budget remaining. Continue the task now — take your next concrete action (call a tool), or give your complete, verified final answer only if you are actually finished.';
+    }
     if (kind === 'reasoning_only') {
         return 'You produced reasoning but no visible answer. Write out your complete final answer now, in plain text, based on that reasoning.';
     }
     return 'Your previous response had no content. Provide your complete final answer now in plain text.';
 }
 /** D-E: a truncated turn was cut off — it should be allowed to CONTINUE (incl. tools), not be told
- * "do not call any more tools" (which the reasoning_only/no_content path appends). */
+ * "do not call any more tools" (which the reasoning_only/no_content path appends).
+ * HB-ENDTURN-TERMINAL: `reasoning_only_active` (mid-recon, budget remaining) is likewise a CONTINUE. */
 export function nudgeForbidsTools(kind) {
-    return kind !== 'truncated';
+    return kind !== 'truncated' && kind !== 'reasoning_only_active';
 }
 //# 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":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAIrE,qGAAqG;AACrG,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC;AAU/F,SAAS,MAAM,CAAC,OAAgB;IAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,UAAmB;IACzE,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,YAAY,GAAG,EAAE,CAAC,IAAI,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,UAAU,IAAI,CAAC,EAAE,IAAI,KAAK,mBAAmB,CACjE,CAAC;IACF,MAAM,UAAU,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC;IAE1D,IAAI,uBAAuB,CAAC,OAAc,CAAC,IAAI,UAAU,EAAE,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IACzD,CAAC;IACD,gGAAgG;IAChG,gGAAgG;IAChG,+FAA+F;IAC/F,+FAA+F;IAC/F,IAAI,UAAU,IAAI,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IACzD,CAAC;IACD,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,oBAAoB;QAC5D,YAAY;QACZ,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,kMAAkM,CAAC;IAC5M,CAAC;IACD,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC9B,OAAO,iIAAiI,CAAC;IAC3I,CAAC;IACD,OAAO,8FAA8F,CAAC;AACxG,CAAC;AAED;sFACsF;AACtF,MAAM,UAAU,iBAAiB,CAAC,IAAuB;IACvD,OAAO,IAAI,KAAK,WAAW,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"emptyResponseClassifier.js","sourceRoot":"","sources":["../../src/orchestrator/emptyResponseClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AASrE,qGAAqG;AACrG,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC;AAU/F,SAAS,MAAM,CAAC,OAAgB;IAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAgB,EAChB,UAAmB,EACnB,aAAuB;IAEvB,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,YAAY,GAAG,EAAE,CAAC,IAAI,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,UAAU,IAAI,CAAC,EAAE,IAAI,KAAK,mBAAmB,CACjE,CAAC;IACF,MAAM,UAAU,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC;IAE1D,IAAI,uBAAuB,CAAC,OAAc,CAAC,IAAI,UAAU,EAAE,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IACzD,CAAC;IACD,gGAAgG;IAChG,gGAAgG;IAChG,+FAA+F;IAC/F,+FAA+F;IAC/F,IAAI,UAAU,IAAI,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,kGAAkG;QAClG,sGAAsG;QACtG,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IACxG,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AAClE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,kMAAkM,CAAC;IAC5M,CAAC;IACD,IAAI,IAAI,KAAK,uBAAuB,EAAE,CAAC;QACrC,OAAO,gQAAgQ,CAAC;IAC1Q,CAAC;IACD,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC9B,OAAO,iIAAiI,CAAC;IAC3I,CAAC;IACD,OAAO,8FAA8F,CAAC;AACxG,CAAC;AAED;;wGAEwG;AACxG,MAAM,UAAU,iBAAiB,CAAC,IAAuB;IACvD,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,uBAAuB,CAAC;AAClE,CAAC"}

package/package.json

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