@nexus-cortex/core 4.26.0

package/dist/orchestrator/citationVerification.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Stage 2 — deterministic citation grounding.
+ *
+ * Stage 1 (generative attestation) plateaued ~5/6: a model can reconstruct a
+ * plausible-looking `verbatim_source` and still ship a fabricated
+ * coordinate, because the fabrication is a regurgitated training prior, not
+ * an observation. Steering/attestation cannot close that — only mechanically
+ * rejecting a citation whose source does NOT occur in this turn's actual
+ * tool output can. This is the Edit `old_string` forcing function applied to
+ * citations: it must match what was really read, or it is rejected.
+ *
+ * Matching is intentionally tolerant of presentation (markdown backticks,
+ * indentation, whitespace runs) but NOT of content: an elided/`...`
+ * "quote", a re-typed-from-memory line, or an invented snippet will not be a
+ * substring of the normalized tool output and is rejected. Sources too short
+ * to be a meaningful transcription claim are skipped (a stray `{` is not the
+ * fabrication risk and would match everything).
+ */
+export interface CitationEvidence {
+    reference: string;
+    verbatim_source: string;
+}
+export interface CitationVerificationResult {
+    grounded: boolean;
+    ungrounded: CitationEvidence[];
+}
+/**
+ * @param citations  the EndTurn attestation's citation list
+ * @param toolOutputs concatenated text of THIS turn's tool results
+ */
+export declare function verifyCitationsGrounded(citations: CitationEvidence[] | undefined, toolOutputs: string): CitationVerificationResult;
+//# sourceMappingURL=citationVerification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"citationVerification.d.ts","sourceRoot":"","sources":["../../src/orchestrator/citationVerification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAYD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,gBAAgB,EAAE,GAAG,SAAS,EACzC,WAAW,EAAE,MAAM,GAClB,0BAA0B,CAgB5B"}

package/dist/orchestrator/citationVerification.js

@@ -0,0 +1,47 @@
+/**
+ * Stage 2 — deterministic citation grounding.
+ *
+ * Stage 1 (generative attestation) plateaued ~5/6: a model can reconstruct a
+ * plausible-looking `verbatim_source` and still ship a fabricated
+ * coordinate, because the fabrication is a regurgitated training prior, not
+ * an observation. Steering/attestation cannot close that — only mechanically
+ * rejecting a citation whose source does NOT occur in this turn's actual
+ * tool output can. This is the Edit `old_string` forcing function applied to
+ * citations: it must match what was really read, or it is rejected.
+ *
+ * Matching is intentionally tolerant of presentation (markdown backticks,
+ * indentation, whitespace runs) but NOT of content: an elided/`...`
+ * "quote", a re-typed-from-memory line, or an invented snippet will not be a
+ * substring of the normalized tool output and is rejected. Sources too short
+ * to be a meaningful transcription claim are skipped (a stray `{` is not the
+ * fabrication risk and would match everything).
+ */
+/** Min normalized length for a source to be worth verifying. */
+const MIN_SOURCE_LEN = 8;
+function normalize(s) {
+    return s
+        .replace(/`+/g, '') // markdown code fences/inline ticks
+        .replace(/\s+/g, ' ') // collapse all whitespace runs
+        .trim();
+}
+/**
+ * @param citations  the EndTurn attestation's citation list
+ * @param toolOutputs concatenated text of THIS turn's tool results
+ */
+export function verifyCitationsGrounded(citations, toolOutputs) {
+    if (!Array.isArray(citations) || citations.length === 0) {
+        return { grounded: true, ungrounded: [] };
+    }
+    const haystack = normalize(toolOutputs);
+    const ungrounded = [];
+    for (const c of citations) {
+        const src = normalize(c?.verbatim_source ?? '');
+        if (src.length < MIN_SOURCE_LEN)
+            continue; // too short to verify meaningfully
+        if (!haystack.includes(src)) {
+            ungrounded.push(c);
+        }
+    }
+    return { grounded: ungrounded.length === 0, ungrounded };
+}
+//# sourceMappingURL=citationVerification.js.map

package/dist/orchestrator/citationVerification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citationVerification.js","sourceRoot":"","sources":["../../src/orchestrator/citationVerification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAYH,gEAAgE;AAChE,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC;SACL,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,oCAAoC;SACvD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,+BAA+B;SACpD,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAyC,EACzC,WAAmB;IAEnB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,UAAU,GAAuB,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,EAAE,eAAe,IAAI,EAAE,CAAC,CAAC;QAChD,IAAI,GAAG,CAAC,MAAM,GAAG,cAAc;YAAE,SAAS,CAAC,mCAAmC;QAC9E,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;AAC3D,CAAC"}

package/dist/orchestrator/coordinateVerification.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Stage 3 — deterministic coordinate verification.
+ *
+ * Q1 established the fabrication is intrinsic regurgitation: grok emits
+ * `(line 446)` from training priors even when nothing asks for it and
+ * nothing forbids it. Steering and self-attestation plateaued ~5/6 because
+ * a model can rubber-stamp. The only thing that closes it is mechanically
+ * rejecting a coordinate that does not correspond to something actually
+ * read this turn.
+ *
+ * Rule (Edit `old_string` standard, applied to coordinates): a line number
+ * appearing in the answer is valid IFF some EndTurn citation's
+ * `verbatim_source` actually occurs at that exact line in this turn's
+ * `cat -n` tool output. A bare prose number with no backing citation is
+ * unverifiable → violation (forces quote-or-drop, the empirically-6/6
+ * behavior). When there is no parseable `cat -n` output we cannot verify,
+ * so we do not false-reject.
+ */
+export interface CitationEvidence {
+    reference: string;
+    verbatim_source: string;
+}
+export interface CoordinateViolation {
+    /** The raw claim substring from the answer, e.g. "line 446". */
+    claim: string;
+    /** The fabricated/unbacked line number. */
+    line: number;
+}
+export interface CoordinateVerificationResult {
+    ok: boolean;
+    violations: CoordinateViolation[];
+}
+/**
+ * @param answerText   the model's drafted final answer
+ * @param toolOutputs  concatenated this-turn tool result text (Read = cat -n)
+ * @param citations    EndTurn attestation citations (Stage 2 evidence)
+ */
+export declare function verifyCoordinates(answerText: string, toolOutputs: string, citations: CitationEvidence[] | undefined): CoordinateVerificationResult;
+/**
+ * Deterministic-only score in [0,1] for the audit-OFF path (no EndTurn
+ * citations exist). Signal: of the line-number claims in the answer, what
+ * fraction correspond to a line that actually exists in this turn's
+ * `cat -n` reads. With the ReadFileTool root-cause fix the model
+ * transcribes real numbers (→ 1.0); a regurgitated prior (446 in a
+ * 260-line file) won't exist (→ lower). No coordinate claims = no risk
+ * taken (1.0). Claims but no numbered reads = cannot verify (0.5,
+ * conservative). Pure → unit-tested.
+ */
+export declare function deterministicCoordinateScore(answerText: string, toolOutputs: string): number;
+//# sourceMappingURL=coordinateVerification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coordinateVerification.d.ts","sourceRoot":"","sources":["../../src/orchestrator/coordinateVerification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,mBAAmB,EAAE,CAAC;CACnC;AA+CD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAAE,GAAG,SAAS,GACxC,4BAA4B,CA2B9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAOR"}

package/dist/orchestrator/coordinateVerification.js

@@ -0,0 +1,114 @@
+/**
+ * Stage 3 — deterministic coordinate verification.
+ *
+ * Q1 established the fabrication is intrinsic regurgitation: grok emits
+ * `(line 446)` from training priors even when nothing asks for it and
+ * nothing forbids it. Steering and self-attestation plateaued ~5/6 because
+ * a model can rubber-stamp. The only thing that closes it is mechanically
+ * rejecting a coordinate that does not correspond to something actually
+ * read this turn.
+ *
+ * Rule (Edit `old_string` standard, applied to coordinates): a line number
+ * appearing in the answer is valid IFF some EndTurn citation's
+ * `verbatim_source` actually occurs at that exact line in this turn's
+ * `cat -n` tool output. A bare prose number with no backing citation is
+ * unverifiable → violation (forces quote-or-drop, the empirically-6/6
+ * behavior). When there is no parseable `cat -n` output we cannot verify,
+ * so we do not false-reject.
+ */
+const MIN_SOURCE_LEN = 8;
+function normalize(s) {
+    return s
+        .replace(/`+/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/** Parse Read `cat -n` output → Map<lineNo, normalizedCode>. Tolerates the
+ *  ` N→code`, `N\tcode`, and `N | code` shapes. */
+function parseLineMap(toolOutputs) {
+    const map = new Map();
+    for (const raw of toolOutputs.split('\n')) {
+        const m = raw.match(/^\s*(\d{1,7})(?:→|\t|\s\|\s)\s?(.*)$/);
+        if (!m)
+            continue;
+        const n = parseInt(m[1], 10);
+        if (!Number.isFinite(n))
+            continue;
+        map.set(n, normalize(m[2] ?? ''));
+    }
+    return map;
+}
+/** Distinct line-number claims in the answer, with the raw matched text. */
+function extractClaims(answerText) {
+    const out = [];
+    const seen = new Set();
+    const patterns = [
+        /\blines?\s*#?\s*(\d{1,6})/gi,
+        /[\w./-]+\.(?:ts|tsx|js|jsx|mjs|cjs|rs|py|go|java|rb|c|cpp|h|hpp):(\d{1,6})/g,
+        /\(\s*lines?\s*(\d{1,6})/gi,
+        /\bL(\d{1,6})\b/g,
+    ];
+    for (const re of patterns) {
+        let m;
+        while ((m = re.exec(answerText)) !== null) {
+            const line = parseInt(m[1], 10);
+            if (!Number.isFinite(line) || seen.has(line))
+                continue;
+            seen.add(line);
+            out.push({ claim: m[0], line });
+        }
+    }
+    return out;
+}
+/**
+ * @param answerText   the model's drafted final answer
+ * @param toolOutputs  concatenated this-turn tool result text (Read = cat -n)
+ * @param citations    EndTurn attestation citations (Stage 2 evidence)
+ */
+export function verifyCoordinates(answerText, toolOutputs, citations) {
+    const lineMap = parseLineMap(toolOutputs);
+    if (lineMap.size === 0) {
+        // No parseable cat -n reads this turn → nothing to verify against.
+        return { ok: true, violations: [] };
+    }
+    const claims = extractClaims(answerText);
+    if (claims.length === 0) {
+        return { ok: true, violations: [] };
+    }
+    // Which line numbers are *backed* by a citation whose verbatim_source
+    // actually appears at that line in this turn's reads.
+    const backedLines = new Set();
+    for (const c of citations ?? []) {
+        const src = normalize(c?.verbatim_source ?? '');
+        if (src.length < MIN_SOURCE_LEN)
+            continue;
+        for (const [lineNo, code] of lineMap) {
+            if (code.includes(src) || src.includes(code)) {
+                backedLines.add(lineNo);
+            }
+        }
+    }
+    const violations = claims.filter((c) => !backedLines.has(c.line));
+    return { ok: violations.length === 0, violations };
+}
+/**
+ * Deterministic-only score in [0,1] for the audit-OFF path (no EndTurn
+ * citations exist). Signal: of the line-number claims in the answer, what
+ * fraction correspond to a line that actually exists in this turn's
+ * `cat -n` reads. With the ReadFileTool root-cause fix the model
+ * transcribes real numbers (→ 1.0); a regurgitated prior (446 in a
+ * 260-line file) won't exist (→ lower). No coordinate claims = no risk
+ * taken (1.0). Claims but no numbered reads = cannot verify (0.5,
+ * conservative). Pure → unit-tested.
+ */
+export function deterministicCoordinateScore(answerText, toolOutputs) {
+    const claims = extractClaims(answerText);
+    if (claims.length === 0)
+        return 1; // no coordinate assertions → nothing fabricated
+    const lineMap = parseLineMap(toolOutputs);
+    if (lineMap.size === 0)
+        return 0.5; // claims present, no numbered reads → uncertain
+    const grounded = claims.filter((c) => lineMap.has(c.line)).length;
+    return grounded / claims.length;
+}
+//# sourceMappingURL=coordinateVerification.js.map

package/dist/orchestrator/coordinateVerification.js.map

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

package/dist/orchestrator/cortexTrainingRecord.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Cortex-channel training/review records.
+ *
+ * Schema-mirrors the nexus DBAI corpus tables (leaf-verified:
+ * tables/training_streams.rs `RouterTrainingSample` / `ReasonerTrainingSample`,
+ * training_fanout.rs `sample_id_for_decision` / `derive_channel_source`).
+ * nexus-cortex has no SpacetimeDB, so these are emitted as local JSONL
+ * rows for later ingestion by the nexus pipeline. They populate the slot
+ * the schema explicitly reserves but nexus leaves unimplemented:
+ * outcome_score "from the alignment scorer or CHALLENGE-graded review"
+ * (training_streams.rs:71-72).
+ *
+ * Gotchas honored: channel_source is exactly "cortex" (lowercase — the
+ * 30% per-channel cap clamps anything else to "external"); outcome_score
+ * clamped to [0,1]; sample_id deterministic over (kind, decision_id,
+ * agent_id) for idempotent re-scoring. The 16-hex agent hash is a JS
+ * FNV-1a, NOT byte-identical to nexus's Rust DefaultHasher — the nexus
+ * ingest reducer recomputes sample_id from (kind, decision_id, agent_id)
+ * anyway; ours is for local dedup only. agent_kind left null: nexus
+ * downstream packers clamp unknown agent_kind values, so we do not invent
+ * one (it defaults at ingest).
+ */
+export interface RouterSampleRecord {
+    sample_id: string;
+    decision_id: string | null;
+    agent_id: string;
+    agent_kind: string | null;
+    archetype_id: string | null;
+    channel_source: string;
+    input_context: string;
+    selected_tool: string | null;
+    selected_args_json: string | null;
+    outcome_score: number | null;
+    training_weight: number | null;
+    timestamp_ms: number;
+    exported: boolean;
+}
+export interface ReasonerTurn {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    thinking?: string;
+    tool_calls?: unknown[];
+    tool_results?: unknown[];
+}
+export interface ReasonerSampleRecord {
+    sample_id: string;
+    conversation_id: string | null;
+    agent_id: string;
+    agent_kind: string | null;
+    archetype_id: string | null;
+    channel_source: string;
+    turn_sequence_json: string;
+    final_outcome_score: number | null;
+    training_weight: number | null;
+    timestamp_ms: number;
+    exported: boolean;
+}
+/** Default cap before cortex-samples.jsonl rotates (5 MB). Write-only,
+ *  low-volume (≈1/finalized-turn), no read-back hot path — so a larger
+ *  cap than DecisionStore is fine. */
+export declare const DEFAULT_SAMPLES_MAX_BYTES: number;
+/**
+ * Append one JSONL line, bounding the file with single-generation rotation
+ * (main → `.1`, replacing any prior `.1`). Rotate-before-append so the
+ * newest record is never dropped and main always exists afterward. Sync
+ * (called from the orchestrator's fail-safe emit block). The `.1` plus the
+ * record schema's `exported` flag make ingested rows prune-safe.
+ */
+export declare function appendJsonlRotating(filePath: string, line: string, maxBytes?: number): void;
+export declare function buildRouterSample(params: {
+    decisionId: string;
+    sessionId: string;
+    inputContext: string;
+    selectedTool?: string | null;
+    selectedArgsJson?: string | null;
+    outcomeScore: number;
+    trainingWeight?: number | null;
+    timestampMs: number;
+}): RouterSampleRecord;
+export declare function buildReasonerSample(params: {
+    decisionId: string;
+    sessionId: string;
+    turns: ReasonerTurn[];
+    finalOutcomeScore: number;
+    trainingWeight?: number | null;
+    timestampMs: number;
+}): ReasonerSampleRecord;
+//# sourceMappingURL=cortexTrainingRecord.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cortexTrainingRecord.d.ts","sourceRoot":"","sources":["../../src/orchestrator/cortexTrainingRecord.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAOD;;sCAEsC;AACtC,eAAO,MAAM,yBAAyB,QAAkB,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAkC,GAC3C,IAAI,CAUN;AAuBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,kBAAkB,CAiBrB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,oBAAoB,CAevB"}

package/dist/orchestrator/cortexTrainingRecord.js

@@ -0,0 +1,102 @@
+/**
+ * Cortex-channel training/review records.
+ *
+ * Schema-mirrors the nexus DBAI corpus tables (leaf-verified:
+ * tables/training_streams.rs `RouterTrainingSample` / `ReasonerTrainingSample`,
+ * training_fanout.rs `sample_id_for_decision` / `derive_channel_source`).
+ * nexus-cortex has no SpacetimeDB, so these are emitted as local JSONL
+ * rows for later ingestion by the nexus pipeline. They populate the slot
+ * the schema explicitly reserves but nexus leaves unimplemented:
+ * outcome_score "from the alignment scorer or CHALLENGE-graded review"
+ * (training_streams.rs:71-72).
+ *
+ * Gotchas honored: channel_source is exactly "cortex" (lowercase — the
+ * 30% per-channel cap clamps anything else to "external"); outcome_score
+ * clamped to [0,1]; sample_id deterministic over (kind, decision_id,
+ * agent_id) for idempotent re-scoring. The 16-hex agent hash is a JS
+ * FNV-1a, NOT byte-identical to nexus's Rust DefaultHasher — the nexus
+ * ingest reducer recomputes sample_id from (kind, decision_id, agent_id)
+ * anyway; ours is for local dedup only. agent_kind left null: nexus
+ * downstream packers clamp unknown agent_kind values, so we do not invent
+ * one (it defaults at ingest).
+ */
+import { appendFileSync, mkdirSync, renameSync, statSync } from 'fs';
+import { dirname } from 'path';
+const CHANNEL_CORTEX = 'cortex';
+/** Default cap before cortex-samples.jsonl rotates (5 MB). Write-only,
+ *  low-volume (≈1/finalized-turn), no read-back hot path — so a larger
+ *  cap than DecisionStore is fine. */
+export const DEFAULT_SAMPLES_MAX_BYTES = 5 * 1024 * 1024;
+/**
+ * Append one JSONL line, bounding the file with single-generation rotation
+ * (main → `.1`, replacing any prior `.1`). Rotate-before-append so the
+ * newest record is never dropped and main always exists afterward. Sync
+ * (called from the orchestrator's fail-safe emit block). The `.1` plus the
+ * record schema's `exported` flag make ingested rows prune-safe.
+ */
+export function appendJsonlRotating(filePath, line, maxBytes = DEFAULT_SAMPLES_MAX_BYTES) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    try {
+        if (statSync(filePath).size > maxBytes) {
+            renameSync(filePath, filePath + '.1'); // replaces any prior .1
+        }
+    }
+    catch {
+        /* ENOENT (no file yet) or rename race — non-fatal */
+    }
+    appendFileSync(filePath, line + '\n');
+}
+function clamp01(n) {
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.max(0, Math.min(1, n));
+}
+/** FNV-1a 64-bit → 16 lowercase hex. Deterministic; local-dedup only. */
+function hash16(s) {
+    let h = 0xcbf29ce484222325n;
+    const prime = 0x100000001b3n;
+    const mask = (1n << 64n) - 1n;
+    for (let i = 0; i < s.length; i++) {
+        h = (h ^ BigInt(s.charCodeAt(i) & 0xff)) & mask;
+        h = (h * prime) & mask;
+    }
+    return h.toString(16).padStart(16, '0');
+}
+function sampleId(kind, decisionId, agentId) {
+    return `${kind}-${decisionId}-${hash16(agentId)}`;
+}
+export function buildRouterSample(params) {
+    const agentId = `cortex-${params.sessionId}`;
+    return {
+        sample_id: sampleId('router', params.decisionId, agentId),
+        decision_id: params.decisionId,
+        agent_id: agentId,
+        agent_kind: null,
+        archetype_id: null,
+        channel_source: CHANNEL_CORTEX,
+        input_context: params.inputContext,
+        selected_tool: params.selectedTool ?? null,
+        selected_args_json: params.selectedArgsJson ?? null,
+        outcome_score: clamp01(params.outcomeScore),
+        training_weight: params.trainingWeight ?? null,
+        timestamp_ms: params.timestampMs,
+        exported: false,
+    };
+}
+export function buildReasonerSample(params) {
+    const agentId = `cortex-${params.sessionId}`;
+    return {
+        sample_id: sampleId('reasoner', params.decisionId, agentId),
+        conversation_id: params.sessionId,
+        agent_id: agentId,
+        agent_kind: null,
+        archetype_id: null,
+        channel_source: CHANNEL_CORTEX,
+        turn_sequence_json: JSON.stringify(params.turns),
+        final_outcome_score: clamp01(params.finalOutcomeScore),
+        training_weight: params.trainingWeight ?? null,
+        timestamp_ms: params.timestampMs,
+        exported: false,
+    };
+}
+//# sourceMappingURL=cortexTrainingRecord.js.map

package/dist/orchestrator/cortexTrainingRecord.js.map

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

package/dist/orchestrator/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Orchestrator module
+ * Coordinates all Claude CLI systems together
+ */
+export * from './CortexOrchestrator.js';
+export * from './OrchestratorFactory.js';
+export * from './APIClient.js';
+export * from './SubAgentTypes.js';
+export * from './SubAgentEventEmitter.js';
+export * from './SubAgentPermissionChecker.js';
+export * from './SubAgentOrchestrator.js';
+export * from './SubAgentManager.js';
+export * from './PauseController.js';
+export * from './SubAgentProcessManager.js';
+export * from './SubAgentIPC.js';
+export type { OrchestratorConfig, SendMessageOptions, OrchestratorResponse, Session, SubAgentEvent, SubAgentEventType, SubAgentEventCallback, } from './CortexOrchestrator.js';
+export type { StreamChunk, StreamingResponse } from './APIClient.js';
+export type { AgentDefinition, SubAgentConfig, SubAgentContext, SubAgentResult, SubAgentEvents, ISubAgentManager, ISubAgentEventEmitter, IPauseController, SpawnAgentOptions, ToolUsageSummary, SubAgentCostMetrics, SubAgentErrorDetails, SubAgentArtifact, } from './SubAgentTypes.js';
+export type { ParentToChildMessage, ChildToParentMessage, IPCStartMessage, IPCAbortMessage, IPCCompletedMessage, IPCProgressMessage, IPCToolCallMessage, IPCTextMessage, IPCErrorMessage, IPCPermissionRequestMessage, IPCPermissionResponseMessage, } from './SubAgentIPC.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestrator/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AAGjC,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,WAAW,EACX,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,kBAAkB,CAAC"}

package/dist/orchestrator/index.js

@@ -0,0 +1,18 @@
+/**
+ * Orchestrator module
+ * Coordinates all Claude CLI systems together
+ */
+export * from './CortexOrchestrator.js';
+export * from './OrchestratorFactory.js';
+export * from './APIClient.js';
+// Sub-Agent System (Phase 2 - Task Agent Implementation)
+export * from './SubAgentTypes.js';
+export * from './SubAgentEventEmitter.js';
+export * from './SubAgentPermissionChecker.js';
+export * from './SubAgentOrchestrator.js';
+export * from './SubAgentManager.js';
+export * from './PauseController.js';
+// Sub-Agent Process System (true parallelism via child processes)
+export * from './SubAgentProcessManager.js';
+export * from './SubAgentIPC.js';
+//# sourceMappingURL=index.js.map

package/dist/orchestrator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestrator/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAE/B,yDAAyD;AACzD,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AAErC,kEAAkE;AAClE,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC"}

package/dist/orchestrator/mcpAutoInjectPolicy.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP auto-injection policy.
+ *
+ * Determines whether discovered MCP tools should be auto-injected into every
+ * request's `tools` array. Two conditions must hold:
+ *
+ * 1. At least one MCP server is connected (otherwise there's nothing to inject).
+ * 2. The operator has not opted out via `MCP_AUTO_INJECT=false`.
+ *
+ * The env var must gate INJECTION, not just config LOAD. Loading
+ * `MCP_CONFIG.md` and connecting servers is harmless; what costs tokens is
+ * shipping every discovered tool's schema on every request. nexus-browser
+ * alone contributes ~43 tools / ~12.5K input tokens. The previous behavior
+ * ignored the env var and unconditionally enabled injection whenever any
+ * server connected.
+ */
+export declare function shouldAutoInjectMcp(connectedCount: number, envValue: string | undefined): boolean;
+//# sourceMappingURL=mcpAutoInjectPolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcpAutoInjectPolicy.d.ts","sourceRoot":"","sources":["../../src/orchestrator/mcpAutoInjectPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAIT"}

package/dist/orchestrator/mcpAutoInjectPolicy.js

@@ -0,0 +1,24 @@
+/**
+ * MCP auto-injection policy.
+ *
+ * Determines whether discovered MCP tools should be auto-injected into every
+ * request's `tools` array. Two conditions must hold:
+ *
+ * 1. At least one MCP server is connected (otherwise there's nothing to inject).
+ * 2. The operator has not opted out via `MCP_AUTO_INJECT=false`.
+ *
+ * The env var must gate INJECTION, not just config LOAD. Loading
+ * `MCP_CONFIG.md` and connecting servers is harmless; what costs tokens is
+ * shipping every discovered tool's schema on every request. nexus-browser
+ * alone contributes ~43 tools / ~12.5K input tokens. The previous behavior
+ * ignored the env var and unconditionally enabled injection whenever any
+ * server connected.
+ */
+export function shouldAutoInjectMcp(connectedCount, envValue) {
+    if (connectedCount <= 0)
+        return false;
+    if (envValue === 'false')
+        return false;
+    return true;
+}
+//# sourceMappingURL=mcpAutoInjectPolicy.js.map

package/dist/orchestrator/mcpAutoInjectPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpAutoInjectPolicy.js","sourceRoot":"","sources":["../../src/orchestrator/mcpAutoInjectPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CACjC,cAAsB,EACtB,QAA4B;IAE5B,IAAI,cAAc,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/orchestrator/staticSystemPromptPin.d.ts

@@ -0,0 +1,20 @@
+/**
+ * R28f: pin the static system prompt per conversation for xAI cross-turn
+ * prompt-cache stability.
+ *
+ * The static system prompt is assembled from a turn-conditional system-message
+ * loader (`SystemMessageLoader.checkConditions` filters on turnNumber /
+ * turnNumberModulo / sessionPhase). A large first-turn-only block drops out by
+ * the next turn, so the provider `system` field was byte-unstable across turns
+ * (measured 68854 -> 12134 chars in one conversation). xAI prefix caching
+ * requires a byte-identical `system` across turns; the collapse capped every
+ * cross-turn request at the ~128-token floor.
+ *
+ * This pins the first non-empty computed system prompt per conversation and
+ * replays it byte-identically on every later turn, so the first-turn superset
+ * persists and the cached prefix survives. The extra tokens on later turns are
+ * served as cache reads (~$0.20/M on xAI), which is far cheaper than
+ * re-processing an uncached prefix every turn.
+ */
+export declare function pinStaticSystemPrompt(store: Map<string, string>, conversationId: string | undefined, computed: string | undefined): string | undefined;
+//# sourceMappingURL=staticSystemPromptPin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"staticSystemPromptPin.d.ts","sourceRoot":"","sources":["../../src/orchestrator/staticSystemPromptPin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CAapB"}

package/dist/orchestrator/staticSystemPromptPin.js

@@ -0,0 +1,33 @@
+/**
+ * R28f: pin the static system prompt per conversation for xAI cross-turn
+ * prompt-cache stability.
+ *
+ * The static system prompt is assembled from a turn-conditional system-message
+ * loader (`SystemMessageLoader.checkConditions` filters on turnNumber /
+ * turnNumberModulo / sessionPhase). A large first-turn-only block drops out by
+ * the next turn, so the provider `system` field was byte-unstable across turns
+ * (measured 68854 -> 12134 chars in one conversation). xAI prefix caching
+ * requires a byte-identical `system` across turns; the collapse capped every
+ * cross-turn request at the ~128-token floor.
+ *
+ * This pins the first non-empty computed system prompt per conversation and
+ * replays it byte-identically on every later turn, so the first-turn superset
+ * persists and the cached prefix survives. The extra tokens on later turns are
+ * served as cache reads (~$0.20/M on xAI), which is far cheaper than
+ * re-processing an uncached prefix every turn.
+ */
+export function pinStaticSystemPrompt(store, conversationId, computed) {
+    // No conversation id (e.g. stateless mode) → cannot key a memo; pass through.
+    if (!conversationId)
+        return computed;
+    const pinned = store.get(conversationId);
+    if (pinned !== undefined)
+        return pinned;
+    // Establish the baseline from the first DEFINED, non-empty turn. Until then
+    // (undefined/empty), pass through and let a later turn set the baseline.
+    if (computed !== undefined && computed.length > 0) {
+        store.set(conversationId, computed);
+    }
+    return computed;
+}
+//# sourceMappingURL=staticSystemPromptPin.js.map

package/dist/orchestrator/staticSystemPromptPin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticSystemPromptPin.js","sourceRoot":"","sources":["../../src/orchestrator/staticSystemPromptPin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAA0B,EAC1B,cAAkC,EAClC,QAA4B;IAE5B,8EAA8E;IAC9E,IAAI,CAAC,cAAc;QAAE,OAAO,QAAQ,CAAC;IAErC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,4EAA4E;IAC5E,yEAAyE;IACzE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}