@nexus-cortex/core 4.69.1 → 4.71.0

package/dist/training/toolOutcome.d.ts

@@ -0,0 +1,20 @@
+export interface ToolOutcome {
+    status: 'ok' | 'failed' | 'error';
+    /** Normalized failure fingerprint (present when status !== 'ok'). */
+    family?: string;
+    /** Normalized "same approach" hash — near-duplicate retries collide. */
+    approachHash: string;
+    /** Byte-sensitive input hash (the existing exact-prior key). */
+    exactHash: string;
+}
+interface ToolResultLike {
+    content: string;
+    is_error?: boolean;
+    metadata?: {
+        exitCode?: number | null;
+    } & Record<string, unknown>;
+}
+export declare function approachHash(toolName: string, input: unknown): string;
+export declare function classifyToolOutcome(toolName: string, input: unknown, result: ToolResultLike): ToolOutcome;
+export {};
+//# sourceMappingURL=toolOutcome.d.ts.map

package/dist/training/toolOutcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolOutcome.d.ts","sourceRoot":"","sources":["../../src/training/toolOutcome.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;IAClC,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnE;AA+BD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAYrE;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,cAAc,GACrB,WAAW,CAwBb"}

package/dist/training/toolOutcome.js

@@ -0,0 +1,100 @@
+/**
+ * toolOutcome — the SINGLE failure semantics every guard consumes.
+ * (docs/UNIFIED_OUTCOME_LADDER.md; TB2 root cause: ShellTool returns a
+ * success result for exit!=0 commands, so consecutive-error breaking,
+ * decision-store priors, and the family lens all recorded thrash as wins.)
+ *
+ * status:
+ *   ok     — the tool ran and succeeded (exitCode 0, or no exit semantics
+ *            and not an error result)
+ *   failed — the tool RAN but did not succeed (nonzero exitCode in result
+ *            metadata, or a recognized failure signature in content)
+ *   error  — transport/abort/exception results (wire is_error; untouched
+ *            semantics — we never rewrite what the model sees)
+ */
+import { createHash } from 'crypto';
+import { classifyErrorFamily } from './errorFamily.js';
+import { stableInputHash } from './DecisionStore.js';
+/** Content signatures that mean "the command ran and failed" even when the
+ *  result carries no exit metadata (older executors, remote shells). */
+const FAILURE_SIGNATURES = [
+    /Command failed with exit code \d+/,
+    /Command timed out after/i,
+];
+/** Normalize an input's text the way errorFamily normalizes error snippets:
+ *  quoted strings, hex ids, paths, and digit runs collapse so "retry with a
+ *  tweaked flag/version/path" lands on the same approach bucket. */
+function normalizeApproachText(text) {
+    return text
+        .toLowerCase()
+        .replace(/(["'])(?:\\.|(?!\1).)*\1/g, '<q>')
+        .replace(/\b0x[0-9a-f]+\b/g, '<hex>')
+        .replace(/(?:^|[\s='"([{:,])((?:\/|(?:[a-z]:)?\\)[^\s'")\]},:]*)/g, ' <path>')
+        // Version-pin skeletons and option flags are RETRY VARIATION, not a new
+        // approach (probe-3 finding: `pkg`, `pkg==2.1`, `pkg --no-cache-dir` must
+        // land in one bucket or the ladder never counts past 1).
+        .replace(/[=<>!~]=[\w.*]+/g, '')
+        .replace(/(?:^|\s)--?[\w-]+(=\S*)?/g, ' ')
+        .replace(/\d+/g, '#')
+        // A standalone number token is a flag argument or count, not an approach.
+        .replace(/(?:^|\s)#+(?=\s|$)/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 160);
+}
+export function approachHash(toolName, input) {
+    let text;
+    if (input && typeof input === 'object') {
+        // Sort keys so property order can't split a bucket; normalize each value.
+        const entries = Object.entries(input)
+            .sort(([a], [b]) => (a < b ? -1 : 1))
+            .map(([k, v]) => `${k}=${normalizeApproachText(typeof v === 'string' ? v : JSON.stringify(v))}`);
+        text = entries.join('|');
+    }
+    else {
+        text = normalizeApproachText(String(input));
+    }
+    return createHash('sha256').update(`${toolName}\n${text}`).digest('hex').slice(0, 16);
+}
+export function classifyToolOutcome(toolName, input, result) {
+    const exactHash = stableInputHash(input);
+    const aHash = approachHash(toolName, input);
+    const content = String(result.content ?? '');
+    let status;
+    if (result.is_error) {
+        status = 'error';
+    }
+    else {
+        const exit = result.metadata?.exitCode;
+        if (typeof exit === 'number' && exit !== 0)
+            status = 'failed';
+        else if (typeof exit === 'number')
+            status = 'ok';
+        else if (FAILURE_SIGNATURES.some((re) => re.test(content)))
+            status = 'failed';
+        else
+            status = 'ok';
+    }
+    return {
+        status,
+        ...(status !== 'ok'
+            ? { family: classifyErrorFamily(stripLeadingReminders(content).slice(0, 200)) || 'unclassified' }
+            : {}),
+        approachHash: aHash,
+        exactHash,
+    };
+}
+/** Loop-level classification sees results ALREADY augmented with prepended
+ *  <system-reminder> blocks (processToolTraining runs first) — strip them so
+ *  the family fingerprint reflects the tool's own output, not our reminder. */
+function stripLeadingReminders(content) {
+    let out = content;
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const next = out.replace(/^\s*<system-reminder>[\s\S]*?<\/system-reminder>\s*/, '');
+        if (next === out)
+            return out;
+        out = next;
+    }
+}
+//# sourceMappingURL=toolOutcome.js.map

package/dist/training/toolOutcome.js.map

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

package/package.json

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