@nexus-cortex/core 4.66.1 → 4.68.0

package/dist/config/tuiKeymap.d.ts

@@ -0,0 +1,39 @@
+/**
+ * TUI keymap-as-data (L-08, TUI_UX_BACKLOG_2026-08-16).
+ *
+ * THE canonical source for keybinding hints/help across every TUI surface.
+ * Before this table, hints were hardcoded in four places with contradictory
+ * contracts — the ink help screen advertised Shift+Enter where the handler
+ * implements Ctrl+J, and the chalk splash advertised "Ctrl+J new line" on a
+ * stack whose RawInput treats '\n' (what Ctrl+J sends in raw mode) as SUBMIT.
+ *
+ * RULES:
+ *  - Entries document what the HANDLERS actually do, per surface. Changing a
+ *    handler means changing its entry in the same commit (and vice versa).
+ *  - TUIs render hints/help FROM this table — never hardcode key strings.
+ *  - This file changes bindings' WORDS only; it never changes behavior.
+ *
+ * Surfaces:
+ *  - 'ink-app'  : the full Ink application (neoncortex — ink-ui/CortexApp.tsx)
+ *  - 'ink-chat' : the lightweight Ink chat UI (cortex.tsx → ChatInput/MultiLineInput)
+ *  - 'chalk'    : the chalk/raw-tty stack (fuzzycortex — ui/RawInput.ts)
+ */
+export type TuiSurface = 'ink-app' | 'ink-chat' | 'chalk';
+export interface KeyBinding {
+    /** Stable action id. */
+    action: string;
+    /** Human key label, universal notation (no mac-only glyphs). */
+    key: string;
+    /** Short hint text (footer style). */
+    hint: string;
+    /** Caveat surfaced in full help, when honesty needs a footnote. */
+    caveat?: string;
+}
+export declare const TUI_KEYMAP: Record<TuiSurface, KeyBinding[]>;
+/** Footer-style one-line hint: "/ commands • ↑↓ history • ..." */
+export declare function keymapFooterHint(surface: TuiSurface): string;
+/** Help-screen rows: [key label, description(+caveat)]. */
+export declare function keymapHelpRows(surface: TuiSurface): Array<[string, string]>;
+/** Lookup one binding's key label (e.g. for inline placeholders). */
+export declare function keymapKey(surface: TuiSurface, action: string): string | undefined;
+//# sourceMappingURL=tuiKeymap.d.ts.map

package/dist/config/tuiKeymap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuiKeymap.d.ts","sourceRoot":"","sources":["../../src/config/tuiKeymap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAoBvD,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAE5D;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAU3E;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjF"}

package/dist/config/tuiKeymap.js

@@ -0,0 +1,67 @@
+/**
+ * TUI keymap-as-data (L-08, TUI_UX_BACKLOG_2026-08-16).
+ *
+ * THE canonical source for keybinding hints/help across every TUI surface.
+ * Before this table, hints were hardcoded in four places with contradictory
+ * contracts — the ink help screen advertised Shift+Enter where the handler
+ * implements Ctrl+J, and the chalk splash advertised "Ctrl+J new line" on a
+ * stack whose RawInput treats '\n' (what Ctrl+J sends in raw mode) as SUBMIT.
+ *
+ * RULES:
+ *  - Entries document what the HANDLERS actually do, per surface. Changing a
+ *    handler means changing its entry in the same commit (and vice versa).
+ *  - TUIs render hints/help FROM this table — never hardcode key strings.
+ *  - This file changes bindings' WORDS only; it never changes behavior.
+ *
+ * Surfaces:
+ *  - 'ink-app'  : the full Ink application (neoncortex — ink-ui/CortexApp.tsx)
+ *  - 'ink-chat' : the lightweight Ink chat UI (cortex.tsx → ChatInput/MultiLineInput)
+ *  - 'chalk'    : the chalk/raw-tty stack (fuzzycortex — ui/RawInput.ts)
+ */
+const COMMON = [
+    { action: 'commands', key: '/', hint: '/ commands' },
+    { action: 'history', key: '↑↓', hint: '↑↓ history' },
+    { action: 'cursor', key: '←→', hint: '←→ cursor' },
+];
+export const TUI_KEYMAP = {
+    'ink-app': [
+        ...COMMON,
+        { action: 'newline', key: 'Ctrl+J', hint: 'Ctrl+J new line' },
+        { action: 'submit', key: 'Enter', hint: 'Enter send' },
+    ],
+    'ink-chat': [
+        ...COMMON,
+        {
+            action: 'newline', key: 'Shift+Enter', hint: 'Shift+Enter new line',
+            caveat: 'requires a terminal that distinguishes Shift+Enter (e.g. kitty keyboard protocol); plain terminals send Enter',
+        },
+        { action: 'submit', key: 'Enter', hint: 'Enter send' },
+    ],
+    // The chalk RawInput stack has NO newline-insert: '\n' (Ctrl+J) submits,
+    // same as Enter. Do not advertise multiline here until a handler exists.
+    'chalk': [
+        ...COMMON,
+        { action: 'submit', key: 'Enter', hint: 'Enter send' },
+    ],
+};
+/** Footer-style one-line hint: "/ commands • ↑↓ history • ..." */
+export function keymapFooterHint(surface) {
+    return TUI_KEYMAP[surface].map((b) => b.hint).join(' • ');
+}
+/** Help-screen rows: [key label, description(+caveat)]. */
+export function keymapHelpRows(surface) {
+    return TUI_KEYMAP[surface].map((b) => [
+        b.key,
+        b.action === 'newline'
+            ? `Multi-line input (new line)${b.caveat ? ` — ${b.caveat}` : ''}`
+            : b.action === 'submit' ? 'Send message'
+                : b.action === 'commands' ? 'Slash commands'
+                    : b.action === 'history' ? 'Input history'
+                        : 'Move cursor',
+    ]);
+}
+/** Lookup one binding's key label (e.g. for inline placeholders). */
+export function keymapKey(surface, action) {
+    return TUI_KEYMAP[surface].find((b) => b.action === action)?.key;
+}
+//# sourceMappingURL=tuiKeymap.js.map

package/dist/config/tuiKeymap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuiKeymap.js","sourceRoot":"","sources":["../../src/config/tuiKeymap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAeH,MAAM,MAAM,GAAiB;IAC3B,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE;IACpD,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE;IACpD,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE;CACnD,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAqC;IAC1D,SAAS,EAAE;QACT,GAAG,MAAM;QACT,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE;QAC7D,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE;KACvD;IACD,UAAU,EAAE;QACV,GAAG,MAAM;QACT;YACE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,sBAAsB;YACnE,MAAM,EAAE,+GAA+G;SACxH;QACD,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE;KACvD;IACD,yEAAyE;IACzE,yEAAyE;IACzE,OAAO,EAAE;QACP,GAAG,MAAM;QACT,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE;KACvD;CACF,CAAC;AAEF,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IAClD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,OAAmB;IAChD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACpC,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,MAAM,KAAK,SAAS;YACpB,CAAC,CAAC,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YAClE,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc;gBACxC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,gBAAgB;oBAC5C,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe;wBAC1C,CAAC,CAAC,aAAa;KAClB,CAAC,CAAC;AACL,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,SAAS,CAAC,OAAmB,EAAE,MAAc;IAC3D,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC;AACnE,CAAC"}

package/dist/config/tuiOnboarding.d.ts

@@ -0,0 +1,27 @@
+/**
+ * TUI first-run onboarding block (L-05 + S-03, TUI_UX_BACKLOG_2026-08-16).
+ *
+ * Before this, first paint was a bare prompt: no statement of what the tool
+ * is, no example, no pointer to the slash-command surface — the splash screen
+ * existed but was reachable only via /about. Canonical-in-the-library: the
+ * CONTENT lives here; each TUI wrapper styles and prints it.
+ *
+ * RULES:
+ *  - Advertise ONLY features that exist on the surface rendering the block.
+ *    (The backlog's own "@file/!shell" phrasing was ungrounded — neither is
+ *    implemented anywhere in this repo; they are deliberately absent here.)
+ *  - Key hints come from TUI_KEYMAP, never hardcoded (L-08 rule).
+ *  - Shown once per machine (~/.cortex/onboarded marker), because the block
+ *    is orientation, not chrome. Wrappers may re-show it via /about.
+ */
+import { type TuiSurface } from './tuiKeymap.js';
+/** Plain-text onboarding lines — wrappers apply their own styling. */
+export declare function onboardingLines(surface: TuiSurface): string[];
+/** True when this machine has never shown the first-run block. Fails closed
+ *  (returns false) on filesystem errors so a broken home dir never loops the
+ *  block forever. `configDir` is injectable for tests (vitest worker threads
+ *  proxy process.env, so os.homedir() can't be steered via $HOME there). */
+export declare function shouldShowOnboarding(configDir?: string): boolean;
+/** Persist the shown-once marker. Non-fatal on failure. */
+export declare function markOnboardingShown(configDir?: string): void;
+//# sourceMappingURL=tuiOnboarding.d.ts.map

package/dist/config/tuiOnboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuiOnboarding.d.ts","sourceRoot":"","sources":["../../src/config/tuiOnboarding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEnE,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,EAAE,CAU7D;AAID;;;4EAG4E;AAC5E,wBAAgB,oBAAoB,CAAC,SAAS,GAAE,MAA6B,GAAG,OAAO,CAMtF;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,SAAS,GAAE,MAA6B,GAAG,IAAI,CAOlF"}

package/dist/config/tuiOnboarding.js

@@ -0,0 +1,56 @@
+/**
+ * TUI first-run onboarding block (L-05 + S-03, TUI_UX_BACKLOG_2026-08-16).
+ *
+ * Before this, first paint was a bare prompt: no statement of what the tool
+ * is, no example, no pointer to the slash-command surface — the splash screen
+ * existed but was reachable only via /about. Canonical-in-the-library: the
+ * CONTENT lives here; each TUI wrapper styles and prints it.
+ *
+ * RULES:
+ *  - Advertise ONLY features that exist on the surface rendering the block.
+ *    (The backlog's own "@file/!shell" phrasing was ungrounded — neither is
+ *    implemented anywhere in this repo; they are deliberately absent here.)
+ *  - Key hints come from TUI_KEYMAP, never hardcoded (L-08 rule).
+ *  - Shown once per machine (~/.cortex/onboarded marker), because the block
+ *    is orientation, not chrome. Wrappers may re-show it via /about.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { getGlobalConfigDir } from './SettingsLoader.js';
+import { keymapFooterHint } from './tuiKeymap.js';
+/** Plain-text onboarding lines — wrappers apply their own styling. */
+export function onboardingLines(surface) {
+    return [
+        'cortex — an agentic coding assistant in your terminal.',
+        'Ask in plain language; it reads files, runs commands, and edits code.',
+        '',
+        'Try:  explain this repo    or    fix the failing test in src/',
+        '',
+        'Type / for the command palette — /help lists everything, /model switches models.',
+        keymapFooterHint(surface),
+    ];
+}
+const ONBOARDED_MARKER = 'onboarded';
+/** True when this machine has never shown the first-run block. Fails closed
+ *  (returns false) on filesystem errors so a broken home dir never loops the
+ *  block forever. `configDir` is injectable for tests (vitest worker threads
+ *  proxy process.env, so os.homedir() can't be steered via $HOME there). */
+export function shouldShowOnboarding(configDir = getGlobalConfigDir()) {
+    try {
+        return !fs.existsSync(path.join(configDir, ONBOARDED_MARKER));
+    }
+    catch {
+        return false;
+    }
+}
+/** Persist the shown-once marker. Non-fatal on failure. */
+export function markOnboardingShown(configDir = getGlobalConfigDir()) {
+    try {
+        fs.mkdirSync(configDir, { recursive: true });
+        fs.writeFileSync(path.join(configDir, ONBOARDED_MARKER), `${new Date().toISOString()}\n`);
+    }
+    catch {
+        /* non-fatal — worst case the block shows again next launch */
+    }
+}
+//# sourceMappingURL=tuiOnboarding.js.map

package/dist/config/tuiOnboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuiOnboarding.js","sourceRoot":"","sources":["../../src/config/tuiOnboarding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,gBAAgB,CAAC;AAEnE,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,OAAmB;IACjD,OAAO;QACL,wDAAwD;QACxD,uEAAuE;QACvE,EAAE;QACF,+DAA+D;QAC/D,EAAE;QACF,kFAAkF;QAClF,gBAAgB,CAAC,OAAO,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAErC;;;4EAG4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,YAAoB,kBAAkB,EAAE;IAC3E,IAAI,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB,CAAC,YAAoB,kBAAkB,EAAE;IAC1E,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC5F,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;IAChE,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -55,4 +55,6 @@ export type { ExperimentArms, RunExperimentOptions, ExperimentResult, Experiment
 export * as RuntimeInterfaces from './interfaces/index.js';
 export { NodeConfigProvider, NodeHistoryStoreAdapter, NodeToolExecutorAdapter, NodePermissionAdapter, GitHistoryStore } from './adapters/node/index.js';
 export type { GitHistoryStoreConfig } from './adapters/node/index.js';
+export { TUI_KEYMAP, keymapFooterHint, keymapHelpRows, keymapKey, type TuiSurface, type KeyBinding } from './config/tuiKeymap.js';
+export { onboardingLines, shouldShowOnboarding, markOnboardingShown } from './config/tuiOnboarding.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -72,4 +72,6 @@ export { runExperiment } from './training/ExperimentRunner.js';
 export * as RuntimeInterfaces from './interfaces/index.js';
 // Node.js runtime adapters (wraps existing services behind runtime-agnostic interfaces)
 export { NodeConfigProvider, NodeHistoryStoreAdapter, NodeToolExecutorAdapter, NodePermissionAdapter, GitHistoryStore } from './adapters/node/index.js';
+export { TUI_KEYMAP, keymapFooterHint, keymapHelpRows, keymapKey } from './config/tuiKeymap.js';
+export { onboardingLines, shouldShowOnboarding, markOnboardingShown } from './config/tuiOnboarding.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,gDAAgD;AAChD,kBAAkB;AAClB,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AAEjC,yBAAyB;AACzB,cAAc,mBAAmB,CAAC;AAElC,uDAAuD;AACvD,kCAAkC;AAClC,2FAA2F;AAC3F,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAExF,oDAAoD;AACpD,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB;AACpB,qBAAqB;AACrB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAAE,sCAAsC;AAC1D,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB;AACjB,oEAAoE;AACpE,4BAA4B,EAC5B,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC7B,MAAM,uBAAuB,CAAC;AAa/B,oDAAoD;AACpD,6BAA6B;AAC7B,oEAAoE;AACpE,iEAAiE;AACjE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG3F,2BAA2B;AAC3B,cAAc,kBAAkB,CAAC;AAEjC,6BAA6B;AAC7B,cAAc,gBAAgB,CAAC;AAE/B,+BAA+B;AAC/B,cAAc,mBAAmB,CAAC;AAElC,wBAAwB;AACxB,uBAAuB;AACvB,cAAc,yBAAyB,CAAC;AAExC,2CAA2C;AAC3C,0BAA0B;AAC1B,cAAc,0BAA0B,CAAC;AAEzC,0BAA0B;AAC1B,cAAc,4BAA4B,CAAC;AAE3C,2BAA2B;AAC3B,cAAc,mBAAmB,CAAC;AAElC,+BAA+B;AAC/B,cAAc,qBAAqB,CAAC;AAEpC,kBAAkB;AAClB,cAAc,kBAAkB,CAAC;AAEjC,6DAA6D;AAC7D,cAAc,eAAe,CAAC;AAE9B,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,YAAY,IAAI,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC9H,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAG3H,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,eAAe,IAAI,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEhG,OAAO,EACL,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EACjF,eAAe,EAAE,UAAU,GAC5B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,kBAAkB,IAAI,8BAA8B,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEvH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK7E,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAK/D,mEAAmE;AACnE,qGAAqG;AACrG,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAC;AAE3D,wFAAwF;AACxF,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cortex/core",
-  "version": "4.66.1",
+  "version": "4.68.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.66.1",
-    "@nexus-cortex/types": "4.66.1",
+    "@nexus-cortex/executors": "4.68.0",
+    "@nexus-cortex/types": "4.68.0",
     "@types/uuid": "^10.0.0",
     "ajv": "^8.12.0",
     "chokidar": "^3.6.0",
@@ -56,7 +56,7 @@
     "tiktoken": "^1.0.22",
     "undici": "^5.28.4",
     "uuid": "^13.0.0",
-    "nexus-canon": "1.9.3"
+    "nexus-canon": "1.9.4"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",