open-multi-agent-kit 0.98.4 → 0.99.0

package/dist/modes/interactive/resource-description.d.ts

@@ -0,0 +1,3 @@
+/** Keep decorative imported harness markers out of OMK display; source metadata stays unchanged. */
+export declare function formatResourceDescription(description: string | undefined, sourceTag?: string): string | undefined;
+//# sourceMappingURL=resource-description.d.ts.map

package/dist/modes/interactive/resource-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-description.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/resource-description.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWjH","sourcesContent":["/** Keep decorative imported harness markers out of OMK display; source metadata stays unchanged. */\nexport function formatResourceDescription(description: string | undefined, sourceTag?: string): string | undefined {\n\tlet text = description;\n\tif (description) {\n\t\tconst marker = /^\\[(OMX|OMO)\\]\\s*/.exec(description);\n\t\tif (marker) {\n\t\t\tconst body = description.slice(marker[0].length);\n\t\t\ttext = body || \"OMK resource\";\n\t\t}\n\t}\n\tif (!sourceTag) return text;\n\treturn text ? `[${sourceTag}] ${text}` : `[${sourceTag}]`;\n}\n"]}

package/dist/modes/interactive/resource-description.js

@@ -0,0 +1,15 @@
+/** Keep decorative imported harness markers out of OMK display; source metadata stays unchanged. */
+export function formatResourceDescription(description, sourceTag) {
+    let text = description;
+    if (description) {
+        const marker = /^\[(OMX|OMO)\]\s*/.exec(description);
+        if (marker) {
+            const body = description.slice(marker[0].length);
+            text = body || "OMK resource";
+        }
+    }
+    if (!sourceTag)
+        return text;
+    return text ? `[${sourceTag}] ${text}` : `[${sourceTag}]`;
+}
+//# sourceMappingURL=resource-description.js.map

package/dist/modes/interactive/resource-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-description.js","sourceRoot":"","sources":["../../../src/modes/interactive/resource-description.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,UAAU,yBAAyB,CAAC,WAA+B,EAAE,SAAkB,EAAsB;IAClH,IAAI,IAAI,GAAG,WAAW,CAAC;IACvB,IAAI,WAAW,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrD,IAAI,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,GAAG,IAAI,IAAI,cAAc,CAAC;QAC/B,CAAC;IACF,CAAC;IACD,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,GAAG,CAAC;AAAA,CAC1D","sourcesContent":["/** Keep decorative imported harness markers out of OMK display; source metadata stays unchanged. */\nexport function formatResourceDescription(description: string | undefined, sourceTag?: string): string | undefined {\n\tlet text = description;\n\tif (description) {\n\t\tconst marker = /^\\[(OMX|OMO)\\]\\s*/.exec(description);\n\t\tif (marker) {\n\t\t\tconst body = description.slice(marker[0].length);\n\t\t\ttext = body || \"OMK resource\";\n\t\t}\n\t}\n\tif (!sourceTag) return text;\n\treturn text ? `[${sourceTag}] ${text}` : `[${sourceTag}]`;\n}\n"]}

package/dist/modes/interactive/tui-diagnostics.d.ts

@@ -0,0 +1,36 @@
+import { type Component } from "omk-tui";
+import type { SessionTermination } from "../../core/session-termination-types.ts";
+import type { TuiRuntimeCapture, TuiRuntimeInfo } from "./tui-runtime-info.ts";
+type DiagnosticTermination = Pick<SessionTermination, "kind" | "phase" | "causeCode" | "source" | "sideEffects" | "retryable" | "safeToAutoRetry">;
+export interface TuiDiagnostics {
+    readonly schemaVersion: 1;
+    readonly privacy: "metadata-only";
+    readonly generatedAt: string;
+    readonly runtime: Omit<TuiRuntimeInfo, "entryPath" | "modulePath">;
+    readonly terminal: {
+        readonly columns: number;
+        readonly rows: number;
+    };
+    readonly session: {
+        readonly streaming: boolean;
+        readonly compacting: boolean;
+        readonly messageCount: number;
+        readonly lastResourceReloadAt: string | null;
+    };
+    readonly termination: DiagnosticTermination | null;
+}
+/** Project each approved field; never serialize a session, message, model, config or arbitrary error. */
+export declare function createTuiDiagnostics(input: {
+    readonly runtime: TuiRuntimeInfo;
+    readonly columns: number;
+    readonly rows: number;
+    readonly isStreaming: boolean;
+    readonly isCompacting: boolean;
+    readonly messageCount: number;
+    readonly lastResourceReloadAt: string | undefined;
+    readonly termination: SessionTermination | undefined;
+}): TuiDiagnostics;
+export declare function saveTuiDiagnostics(report: TuiDiagnostics, directory?: string): string;
+export declare function createTuiDiagnosticsView(report: TuiDiagnostics, locations: TuiRuntimeCapture): Component;
+export {};
+//# sourceMappingURL=tui-diagnostics.d.ts.map

package/dist/modes/interactive/tui-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-diagnostics.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/tui-diagnostics.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAIlF,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE/E,KAAK,qBAAqB,GAAG,IAAI,CAChC,kBAAkB,EAClB,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,iBAAiB,CAC3F,CAAC;AACF,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC;IACnE,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,QAAQ,CAAC,OAAO,EAAE;QACjB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7C,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACnD;AAED,yGAAyG;AACzG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACrD,GAAG,cAAc,CAsCjB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,SAAW,GAAG,MAAM,CAcvF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,GAAG,SAAS,CAiDxG","sourcesContent":["import { mkdtempSync, rmSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { type Component, Container, Text } from \"omk-tui\";\nimport type { SessionTermination } from \"../../core/session-termination-types.ts\";\nimport { DynamicBorder } from \"./components/dynamic-border.ts\";\nimport { diagnosticDisplayText } from \"./components/session-failure.ts\";\nimport { theme } from \"./theme/theme.ts\";\nimport type { TuiRuntimeCapture, TuiRuntimeInfo } from \"./tui-runtime-info.ts\";\n\ntype DiagnosticTermination = Pick<\n\tSessionTermination,\n\t\"kind\" | \"phase\" | \"causeCode\" | \"source\" | \"sideEffects\" | \"retryable\" | \"safeToAutoRetry\"\n>;\nexport interface TuiDiagnostics {\n\treadonly schemaVersion: 1;\n\treadonly privacy: \"metadata-only\";\n\treadonly generatedAt: string;\n\treadonly runtime: Omit<TuiRuntimeInfo, \"entryPath\" | \"modulePath\">;\n\treadonly terminal: { readonly columns: number; readonly rows: number };\n\treadonly session: {\n\t\treadonly streaming: boolean;\n\t\treadonly compacting: boolean;\n\t\treadonly messageCount: number;\n\t\treadonly lastResourceReloadAt: string | null;\n\t};\n\treadonly termination: DiagnosticTermination | null;\n}\n\n/** Project each approved field; never serialize a session, message, model, config or arbitrary error. */\nexport function createTuiDiagnostics(input: {\n\treadonly runtime: TuiRuntimeInfo;\n\treadonly columns: number;\n\treadonly rows: number;\n\treadonly isStreaming: boolean;\n\treadonly isCompacting: boolean;\n\treadonly messageCount: number;\n\treadonly lastResourceReloadAt: string | undefined;\n\treadonly termination: SessionTermination | undefined;\n}): TuiDiagnostics {\n\tconst r = input.runtime;\n\tconst t = input.termination;\n\treturn {\n\t\tschemaVersion: 1,\n\t\tprivacy: \"metadata-only\",\n\t\tgeneratedAt: new Date().toISOString(),\n\t\truntime: {\n\t\t\tversion: r.version,\n\t\t\tnodeVersion: r.nodeVersion,\n\t\t\tplatform: r.platform,\n\t\t\tarch: r.arch,\n\t\t\tcapturedAt: r.capturedAt,\n\t\t\tmoduleKind: r.moduleKind,\n\t\t\tmoduleState: r.moduleState,\n\t\t\tinitialModuleSha256: r.initialModuleSha256,\n\t\t\tcurrentModuleSha256: r.currentModuleSha256,\n\t\t\tbuildRevision: r.buildRevision,\n\t\t},\n\t\tterminal: { columns: input.columns, rows: input.rows },\n\t\tsession: {\n\t\t\tstreaming: input.isStreaming,\n\t\t\tcompacting: input.isCompacting,\n\t\t\tmessageCount: input.messageCount,\n\t\t\tlastResourceReloadAt: input.lastResourceReloadAt ?? null,\n\t\t},\n\t\ttermination: t\n\t\t\t? {\n\t\t\t\t\tkind: t.kind,\n\t\t\t\t\tphase: t.phase,\n\t\t\t\t\tcauseCode: t.causeCode,\n\t\t\t\t\tsource: t.source,\n\t\t\t\t\tsideEffects: t.sideEffects,\n\t\t\t\t\tretryable: t.retryable,\n\t\t\t\t\tsafeToAutoRetry: t.safeToAutoRetry,\n\t\t\t\t}\n\t\t\t: null,\n\t};\n}\n\nexport function saveTuiDiagnostics(report: TuiDiagnostics, directory = tmpdir()): string {\n\tconst ownedDirectory = mkdtempSync(join(directory, \"omk-debug-\"));\n\ttry {\n\t\tconst outputPath = join(ownedDirectory, \"diagnostics.json\");\n\t\twriteFileSync(outputPath, `${JSON.stringify(report, null, 2)}\\n`, { flag: \"wx\", mode: 0o600 });\n\t\treturn outputPath;\n\t} catch (error) {\n\t\ttry {\n\t\t\trmSync(ownedDirectory, { recursive: true, force: true });\n\t\t} catch (cleanupError) {\n\t\t\tthrow new AggregateError([error, cleanupError], \"Diagnostics write and cleanup failed\");\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nexport function createTuiDiagnosticsView(report: TuiDiagnostics, locations: TuiRuntimeCapture): Component {\n\treturn {\n\t\trender(width: number): string[] {\n\t\t\tconst view = new Container();\n\t\t\tview.addChild(new DynamicBorder((s) => theme.fg(\"accent\", s)));\n\t\t\tview.addChild(new Text(theme.fg(\"accent\", theme.bold(\"OMK diagnostics\")), 1, 0));\n\t\t\tconst r = report.runtime;\n\t\t\tconst t = report.termination;\n\t\t\tconst moduleStatus =\n\t\t\t\tr.moduleState === \"changed\"\n\t\t\t\t\t? \"changed since initialization — restart to load code\"\n\t\t\t\t\t: r.moduleState === \"unchanged\"\n\t\t\t\t\t\t? \"unchanged since initialization (this file only)\"\n\t\t\t\t\t\t: \"unavailable — not confirmed\";\n\t\t\tconst lines = [\n\t\t\t\t`Runtime: OMK ${r.version} · Node ${r.nodeVersion} · ${r.platform}/${r.arch}`,\n\t\t\t\t`Loaded UI: ${r.moduleKind} · Initialized: ${r.capturedAt}`,\n\t\t\t\t`UI file on disk: ${moduleStatus}`,\n\t\t\t\t`UI SHA256 at initialization: ${r.initialModuleSha256 ?? \"unavailable\"}`,\n\t\t\t\t\"Build revision: unavailable (checkout HEAD is not a build identity)\",\n\t\t\t\t`Last resource reload: ${report.session.lastResourceReloadAt ?? \"not reloaded in this TUI\"}`,\n\t\t\t\t\"/reload refreshes resources, not core code. Core updates require a restart.\",\n\t\t\t\t`Terminal: ${report.terminal.columns}×${report.terminal.rows} · Messages: ${report.session.messageCount}`,\n\t\t\t\t`Streaming: ${report.session.streaming ? \"yes\" : \"no\"} · Compacting: ${report.session.compacting ? \"yes\" : \"no\"}`,\n\t\t\t\tt ? `Latest outcome: ${t.kind} · ${t.causeCode} · ${t.source}` : \"Latest outcome: none recorded\",\n\t\t\t\t...(t\n\t\t\t\t\t? [\n\t\t\t\t\t\t\t`Effects: ${t.sideEffects} · Retryable: ${t.retryable ? \"yes\" : \"no\"} · Automatic retry: ${t.safeToAutoRetry ? \"yes\" : \"no\"}`,\n\t\t\t\t\t\t]\n\t\t\t\t\t: []),\n\t\t\t\t`Launch path (local only): ${locations.entryPath ?? \"unavailable\"}`,\n\t\t\t\t`UI module (local only): ${locations.modulePath ?? \"unavailable\"}`,\n\t\t\t];\n\t\t\tview.addChild(new Text(lines.map(diagnosticDisplayText).join(\"\\n\"), 1, 0));\n\t\t\tview.addChild(\n\t\t\t\tnew Text(\n\t\t\t\t\ttheme.fg(\n\t\t\t\t\t\t\"muted\",\n\t\t\t\t\t\t\"Saving is explicit: /debug save writes a metadata-only JSON report locally.\\nMessages, prompts, outputs, config, paths, route names and session/run IDs are excluded. No upload.\",\n\t\t\t\t\t),\n\t\t\t\t\t1,\n\t\t\t\t\t0,\n\t\t\t\t),\n\t\t\t);\n\t\t\tview.addChild(new DynamicBorder((s) => theme.fg(\"accent\", s)));\n\t\t\treturn view.render(width);\n\t\t},\n\t\tinvalidate(): void {},\n\t};\n}\n"]}

package/dist/modes/interactive/tui-diagnostics.js

@@ -0,0 +1,105 @@
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { Container, Text } from "omk-tui";
+import { DynamicBorder } from "./components/dynamic-border.js";
+import { diagnosticDisplayText } from "./components/session-failure.js";
+import { theme } from "./theme/theme.js";
+/** Project each approved field; never serialize a session, message, model, config or arbitrary error. */
+export function createTuiDiagnostics(input) {
+    const r = input.runtime;
+    const t = input.termination;
+    return {
+        schemaVersion: 1,
+        privacy: "metadata-only",
+        generatedAt: new Date().toISOString(),
+        runtime: {
+            version: r.version,
+            nodeVersion: r.nodeVersion,
+            platform: r.platform,
+            arch: r.arch,
+            capturedAt: r.capturedAt,
+            moduleKind: r.moduleKind,
+            moduleState: r.moduleState,
+            initialModuleSha256: r.initialModuleSha256,
+            currentModuleSha256: r.currentModuleSha256,
+            buildRevision: r.buildRevision,
+        },
+        terminal: { columns: input.columns, rows: input.rows },
+        session: {
+            streaming: input.isStreaming,
+            compacting: input.isCompacting,
+            messageCount: input.messageCount,
+            lastResourceReloadAt: input.lastResourceReloadAt ?? null,
+        },
+        termination: t
+            ? {
+                kind: t.kind,
+                phase: t.phase,
+                causeCode: t.causeCode,
+                source: t.source,
+                sideEffects: t.sideEffects,
+                retryable: t.retryable,
+                safeToAutoRetry: t.safeToAutoRetry,
+            }
+            : null,
+    };
+}
+export function saveTuiDiagnostics(report, directory = tmpdir()) {
+    const ownedDirectory = mkdtempSync(join(directory, "omk-debug-"));
+    try {
+        const outputPath = join(ownedDirectory, "diagnostics.json");
+        writeFileSync(outputPath, `${JSON.stringify(report, null, 2)}\n`, { flag: "wx", mode: 0o600 });
+        return outputPath;
+    }
+    catch (error) {
+        try {
+            rmSync(ownedDirectory, { recursive: true, force: true });
+        }
+        catch (cleanupError) {
+            throw new AggregateError([error, cleanupError], "Diagnostics write and cleanup failed");
+        }
+        throw error;
+    }
+}
+export function createTuiDiagnosticsView(report, locations) {
+    return {
+        render(width) {
+            const view = new Container();
+            view.addChild(new DynamicBorder((s) => theme.fg("accent", s)));
+            view.addChild(new Text(theme.fg("accent", theme.bold("OMK diagnostics")), 1, 0));
+            const r = report.runtime;
+            const t = report.termination;
+            const moduleStatus = r.moduleState === "changed"
+                ? "changed since initialization — restart to load code"
+                : r.moduleState === "unchanged"
+                    ? "unchanged since initialization (this file only)"
+                    : "unavailable — not confirmed";
+            const lines = [
+                `Runtime: OMK ${r.version} · Node ${r.nodeVersion} · ${r.platform}/${r.arch}`,
+                `Loaded UI: ${r.moduleKind} · Initialized: ${r.capturedAt}`,
+                `UI file on disk: ${moduleStatus}`,
+                `UI SHA256 at initialization: ${r.initialModuleSha256 ?? "unavailable"}`,
+                "Build revision: unavailable (checkout HEAD is not a build identity)",
+                `Last resource reload: ${report.session.lastResourceReloadAt ?? "not reloaded in this TUI"}`,
+                "/reload refreshes resources, not core code. Core updates require a restart.",
+                `Terminal: ${report.terminal.columns}×${report.terminal.rows} · Messages: ${report.session.messageCount}`,
+                `Streaming: ${report.session.streaming ? "yes" : "no"} · Compacting: ${report.session.compacting ? "yes" : "no"}`,
+                t ? `Latest outcome: ${t.kind} · ${t.causeCode} · ${t.source}` : "Latest outcome: none recorded",
+                ...(t
+                    ? [
+                        `Effects: ${t.sideEffects} · Retryable: ${t.retryable ? "yes" : "no"} · Automatic retry: ${t.safeToAutoRetry ? "yes" : "no"}`,
+                    ]
+                    : []),
+                `Launch path (local only): ${locations.entryPath ?? "unavailable"}`,
+                `UI module (local only): ${locations.modulePath ?? "unavailable"}`,
+            ];
+            view.addChild(new Text(lines.map(diagnosticDisplayText).join("\n"), 1, 0));
+            view.addChild(new Text(theme.fg("muted", "Saving is explicit: /debug save writes a metadata-only JSON report locally.\nMessages, prompts, outputs, config, paths, route names and session/run IDs are excluded. No upload."), 1, 0));
+            view.addChild(new DynamicBorder((s) => theme.fg("accent", s)));
+            return view.render(width);
+        },
+        invalidate() { },
+    };
+}
+//# sourceMappingURL=tui-diagnostics.js.map

package/dist/modes/interactive/tui-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-diagnostics.js","sourceRoot":"","sources":["../../../src/modes/interactive/tui-diagnostics.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdtempSync, rmSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { type Component, Container, Text } from \"omk-tui\";\nimport type { SessionTermination } from \"../../core/session-termination-types.ts\";\nimport { DynamicBorder } from \"./components/dynamic-border.ts\";\nimport { diagnosticDisplayText } from \"./components/session-failure.ts\";\nimport { theme } from \"./theme/theme.ts\";\nimport type { TuiRuntimeCapture, TuiRuntimeInfo } from \"./tui-runtime-info.ts\";\n\ntype DiagnosticTermination = Pick<\n\tSessionTermination,\n\t\"kind\" | \"phase\" | \"causeCode\" | \"source\" | \"sideEffects\" | \"retryable\" | \"safeToAutoRetry\"\n>;\nexport interface TuiDiagnostics {\n\treadonly schemaVersion: 1;\n\treadonly privacy: \"metadata-only\";\n\treadonly generatedAt: string;\n\treadonly runtime: Omit<TuiRuntimeInfo, \"entryPath\" | \"modulePath\">;\n\treadonly terminal: { readonly columns: number; readonly rows: number };\n\treadonly session: {\n\t\treadonly streaming: boolean;\n\t\treadonly compacting: boolean;\n\t\treadonly messageCount: number;\n\t\treadonly lastResourceReloadAt: string | null;\n\t};\n\treadonly termination: DiagnosticTermination | null;\n}\n\n/** Project each approved field; never serialize a session, message, model, config or arbitrary error. */\nexport function createTuiDiagnostics(input: {\n\treadonly runtime: TuiRuntimeInfo;\n\treadonly columns: number;\n\treadonly rows: number;\n\treadonly isStreaming: boolean;\n\treadonly isCompacting: boolean;\n\treadonly messageCount: number;\n\treadonly lastResourceReloadAt: string | undefined;\n\treadonly termination: SessionTermination | undefined;\n}): TuiDiagnostics {\n\tconst r = input.runtime;\n\tconst t = input.termination;\n\treturn {\n\t\tschemaVersion: 1,\n\t\tprivacy: \"metadata-only\",\n\t\tgeneratedAt: new Date().toISOString(),\n\t\truntime: {\n\t\t\tversion: r.version,\n\t\t\tnodeVersion: r.nodeVersion,\n\t\t\tplatform: r.platform,\n\t\t\tarch: r.arch,\n\t\t\tcapturedAt: r.capturedAt,\n\t\t\tmoduleKind: r.moduleKind,\n\t\t\tmoduleState: r.moduleState,\n\t\t\tinitialModuleSha256: r.initialModuleSha256,\n\t\t\tcurrentModuleSha256: r.currentModuleSha256,\n\t\t\tbuildRevision: r.buildRevision,\n\t\t},\n\t\tterminal: { columns: input.columns, rows: input.rows },\n\t\tsession: {\n\t\t\tstreaming: input.isStreaming,\n\t\t\tcompacting: input.isCompacting,\n\t\t\tmessageCount: input.messageCount,\n\t\t\tlastResourceReloadAt: input.lastResourceReloadAt ?? null,\n\t\t},\n\t\ttermination: t\n\t\t\t? {\n\t\t\t\t\tkind: t.kind,\n\t\t\t\t\tphase: t.phase,\n\t\t\t\t\tcauseCode: t.causeCode,\n\t\t\t\t\tsource: t.source,\n\t\t\t\t\tsideEffects: t.sideEffects,\n\t\t\t\t\tretryable: t.retryable,\n\t\t\t\t\tsafeToAutoRetry: t.safeToAutoRetry,\n\t\t\t\t}\n\t\t\t: null,\n\t};\n}\n\nexport function saveTuiDiagnostics(report: TuiDiagnostics, directory = tmpdir()): string {\n\tconst ownedDirectory = mkdtempSync(join(directory, \"omk-debug-\"));\n\ttry {\n\t\tconst outputPath = join(ownedDirectory, \"diagnostics.json\");\n\t\twriteFileSync(outputPath, `${JSON.stringify(report, null, 2)}\\n`, { flag: \"wx\", mode: 0o600 });\n\t\treturn outputPath;\n\t} catch (error) {\n\t\ttry {\n\t\t\trmSync(ownedDirectory, { recursive: true, force: true });\n\t\t} catch (cleanupError) {\n\t\t\tthrow new AggregateError([error, cleanupError], \"Diagnostics write and cleanup failed\");\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nexport function createTuiDiagnosticsView(report: TuiDiagnostics, locations: TuiRuntimeCapture): Component {\n\treturn {\n\t\trender(width: number): string[] {\n\t\t\tconst view = new Container();\n\t\t\tview.addChild(new DynamicBorder((s) => theme.fg(\"accent\", s)));\n\t\t\tview.addChild(new Text(theme.fg(\"accent\", theme.bold(\"OMK diagnostics\")), 1, 0));\n\t\t\tconst r = report.runtime;\n\t\t\tconst t = report.termination;\n\t\t\tconst moduleStatus =\n\t\t\t\tr.moduleState === \"changed\"\n\t\t\t\t\t? \"changed since initialization — restart to load code\"\n\t\t\t\t\t: r.moduleState === \"unchanged\"\n\t\t\t\t\t\t? \"unchanged since initialization (this file only)\"\n\t\t\t\t\t\t: \"unavailable — not confirmed\";\n\t\t\tconst lines = [\n\t\t\t\t`Runtime: OMK ${r.version} · Node ${r.nodeVersion} · ${r.platform}/${r.arch}`,\n\t\t\t\t`Loaded UI: ${r.moduleKind} · Initialized: ${r.capturedAt}`,\n\t\t\t\t`UI file on disk: ${moduleStatus}`,\n\t\t\t\t`UI SHA256 at initialization: ${r.initialModuleSha256 ?? \"unavailable\"}`,\n\t\t\t\t\"Build revision: unavailable (checkout HEAD is not a build identity)\",\n\t\t\t\t`Last resource reload: ${report.session.lastResourceReloadAt ?? \"not reloaded in this TUI\"}`,\n\t\t\t\t\"/reload refreshes resources, not core code. Core updates require a restart.\",\n\t\t\t\t`Terminal: ${report.terminal.columns}×${report.terminal.rows} · Messages: ${report.session.messageCount}`,\n\t\t\t\t`Streaming: ${report.session.streaming ? \"yes\" : \"no\"} · Compacting: ${report.session.compacting ? \"yes\" : \"no\"}`,\n\t\t\t\tt ? `Latest outcome: ${t.kind} · ${t.causeCode} · ${t.source}` : \"Latest outcome: none recorded\",\n\t\t\t\t...(t\n\t\t\t\t\t? [\n\t\t\t\t\t\t\t`Effects: ${t.sideEffects} · Retryable: ${t.retryable ? \"yes\" : \"no\"} · Automatic retry: ${t.safeToAutoRetry ? \"yes\" : \"no\"}`,\n\t\t\t\t\t\t]\n\t\t\t\t\t: []),\n\t\t\t\t`Launch path (local only): ${locations.entryPath ?? \"unavailable\"}`,\n\t\t\t\t`UI module (local only): ${locations.modulePath ?? \"unavailable\"}`,\n\t\t\t];\n\t\t\tview.addChild(new Text(lines.map(diagnosticDisplayText).join(\"\\n\"), 1, 0));\n\t\t\tview.addChild(\n\t\t\t\tnew Text(\n\t\t\t\t\ttheme.fg(\n\t\t\t\t\t\t\"muted\",\n\t\t\t\t\t\t\"Saving is explicit: /debug save writes a metadata-only JSON report locally.\\nMessages, prompts, outputs, config, paths, route names and session/run IDs are excluded. No upload.\",\n\t\t\t\t\t),\n\t\t\t\t\t1,\n\t\t\t\t\t0,\n\t\t\t\t),\n\t\t\t);\n\t\t\tview.addChild(new DynamicBorder((s) => theme.fg(\"accent\", s)));\n\t\t\treturn view.render(width);\n\t\t},\n\t\tinvalidate(): void {},\n\t};\n}\n"]}

package/dist/modes/interactive/tui-runtime-info.d.ts

@@ -0,0 +1,20 @@
+export interface TuiRuntimeCapture {
+    readonly version: string;
+    readonly nodeVersion: string;
+    readonly platform: NodeJS.Platform;
+    readonly arch: string;
+    readonly capturedAt: string;
+    readonly entryPath: string | null;
+    readonly modulePath: string | null;
+    readonly moduleKind: "source" | "dist" | "bundled" | "unknown";
+    readonly initialModuleSha256: string | null;
+}
+export interface TuiRuntimeInfo extends TuiRuntimeCapture {
+    readonly currentModuleSha256: string | null;
+    readonly moduleState: "unchanged" | "changed" | "unavailable";
+    /** The package currently supplies no build-to-commit binding. Never substitute checkout HEAD. */
+    readonly buildRevision: null;
+}
+export declare function captureTuiRuntime(moduleUrl: string): TuiRuntimeCapture;
+export declare function inspectTuiRuntime(capture: TuiRuntimeCapture): TuiRuntimeInfo;
+//# sourceMappingURL=tui-runtime-info.d.ts.map

package/dist/modes/interactive/tui-runtime-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-runtime-info.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/tui-runtime-info.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AACD,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACxD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;IAC9D,iGAAiG;IACjG,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC;CAC7B;AAqBD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAkCtE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAS5E","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { closeSync, constants, fstatSync, openSync, readSync, realpathSync } from \"node:fs\";\nimport { extname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { VERSION } from \"../../config.ts\";\n\nexport interface TuiRuntimeCapture {\n\treadonly version: string;\n\treadonly nodeVersion: string;\n\treadonly platform: NodeJS.Platform;\n\treadonly arch: string;\n\treadonly capturedAt: string;\n\treadonly entryPath: string | null;\n\treadonly modulePath: string | null;\n\treadonly moduleKind: \"source\" | \"dist\" | \"bundled\" | \"unknown\";\n\treadonly initialModuleSha256: string | null;\n}\nexport interface TuiRuntimeInfo extends TuiRuntimeCapture {\n\treadonly currentModuleSha256: string | null;\n\treadonly moduleState: \"unchanged\" | \"changed\" | \"unavailable\";\n\t/** The package currently supplies no build-to-commit binding. Never substitute checkout HEAD. */\n\treadonly buildRevision: null;\n}\n\nfunction moduleDigest(filePath: string | null): string | null {\n\tif (!filePath) return null;\n\tlet fd: number | undefined;\n\ttry {\n\t\tfd = openSync(filePath, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);\n\t\tconst stat = fstatSync(fd);\n\t\tif (!stat.isFile() || stat.size > 1_048_576) return null;\n\t\tconst bytes = Buffer.alloc(stat.size + 1);\n\t\tconst count = readSync(fd, bytes, 0, bytes.length, 0);\n\t\tif (count !== stat.size || fstatSync(fd).mtimeMs !== stat.mtimeMs) return null;\n\t\treturn createHash(\"sha256\").update(bytes.subarray(0, count)).digest(\"hex\");\n\t} catch {\n\t\t// A missing/unreadable/virtual entry is an unavailable observation, not a clean bill of health.\n\t\treturn null;\n\t} finally {\n\t\tif (fd !== undefined) closeSync(fd);\n\t}\n}\n\nexport function captureTuiRuntime(moduleUrl: string): TuiRuntimeCapture {\n\tlet modulePath: string | null = null;\n\ttry {\n\t\tmodulePath = fileURLToPath(moduleUrl);\n\t} catch {\n\t\t// Bundled runtimes need not expose a file URL.\n\t}\n\tlet entryPath = process.argv[1] ? resolve(process.argv[1]) : null;\n\tif (entryPath) {\n\t\ttry {\n\t\t\tentryPath = realpathSync(entryPath);\n\t\t} catch {\n\t\t\t/* Keep the observed launch path when unavailable. */\n\t\t}\n\t}\n\tconst normalized = modulePath?.replaceAll(\"\\\\\", \"/\") ?? moduleUrl;\n\tconst moduleKind = /(?:^bun:|\\/\\$bunfs\\/|\\/~BUN\\/)/u.test(normalized)\n\t\t? \"bundled\"\n\t\t: modulePath && [\".ts\", \".tsx\", \".mts\", \".cts\"].includes(extname(modulePath))\n\t\t\t? \"source\"\n\t\t\t: normalized.includes(\"/dist/\")\n\t\t\t\t? \"dist\"\n\t\t\t\t: \"unknown\";\n\treturn Object.freeze({\n\t\tversion: VERSION,\n\t\tnodeVersion: process.versions.node,\n\t\tplatform: process.platform,\n\t\tarch: process.arch,\n\t\tcapturedAt: new Date().toISOString(),\n\t\tentryPath,\n\t\tmodulePath,\n\t\tmoduleKind,\n\t\tinitialModuleSha256: moduleKind === \"bundled\" ? null : moduleDigest(modulePath),\n\t});\n}\n\nexport function inspectTuiRuntime(capture: TuiRuntimeCapture): TuiRuntimeInfo {\n\tconst currentModuleSha256 = capture.moduleKind === \"bundled\" ? null : moduleDigest(capture.modulePath);\n\tconst moduleState =\n\t\t!capture.initialModuleSha256 || !currentModuleSha256\n\t\t\t? \"unavailable\"\n\t\t\t: capture.initialModuleSha256 === currentModuleSha256\n\t\t\t\t? \"unchanged\"\n\t\t\t\t: \"changed\";\n\treturn { ...capture, currentModuleSha256, moduleState, buildRevision: null };\n}\n"]}

package/dist/modes/interactive/tui-runtime-info.js

@@ -0,0 +1,76 @@
+import { createHash } from "node:crypto";
+import { closeSync, constants, fstatSync, openSync, readSync, realpathSync } from "node:fs";
+import { extname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { VERSION } from "../../config.js";
+function moduleDigest(filePath) {
+    if (!filePath)
+        return null;
+    let fd;
+    try {
+        fd = openSync(filePath, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+        const stat = fstatSync(fd);
+        if (!stat.isFile() || stat.size > 1_048_576)
+            return null;
+        const bytes = Buffer.alloc(stat.size + 1);
+        const count = readSync(fd, bytes, 0, bytes.length, 0);
+        if (count !== stat.size || fstatSync(fd).mtimeMs !== stat.mtimeMs)
+            return null;
+        return createHash("sha256").update(bytes.subarray(0, count)).digest("hex");
+    }
+    catch {
+        // A missing/unreadable/virtual entry is an unavailable observation, not a clean bill of health.
+        return null;
+    }
+    finally {
+        if (fd !== undefined)
+            closeSync(fd);
+    }
+}
+export function captureTuiRuntime(moduleUrl) {
+    let modulePath = null;
+    try {
+        modulePath = fileURLToPath(moduleUrl);
+    }
+    catch {
+        // Bundled runtimes need not expose a file URL.
+    }
+    let entryPath = process.argv[1] ? resolve(process.argv[1]) : null;
+    if (entryPath) {
+        try {
+            entryPath = realpathSync(entryPath);
+        }
+        catch {
+            /* Keep the observed launch path when unavailable. */
+        }
+    }
+    const normalized = modulePath?.replaceAll("\\", "/") ?? moduleUrl;
+    const moduleKind = /(?:^bun:|\/\$bunfs\/|\/~BUN\/)/u.test(normalized)
+        ? "bundled"
+        : modulePath && [".ts", ".tsx", ".mts", ".cts"].includes(extname(modulePath))
+            ? "source"
+            : normalized.includes("/dist/")
+                ? "dist"
+                : "unknown";
+    return Object.freeze({
+        version: VERSION,
+        nodeVersion: process.versions.node,
+        platform: process.platform,
+        arch: process.arch,
+        capturedAt: new Date().toISOString(),
+        entryPath,
+        modulePath,
+        moduleKind,
+        initialModuleSha256: moduleKind === "bundled" ? null : moduleDigest(modulePath),
+    });
+}
+export function inspectTuiRuntime(capture) {
+    const currentModuleSha256 = capture.moduleKind === "bundled" ? null : moduleDigest(capture.modulePath);
+    const moduleState = !capture.initialModuleSha256 || !currentModuleSha256
+        ? "unavailable"
+        : capture.initialModuleSha256 === currentModuleSha256
+            ? "unchanged"
+            : "changed";
+    return { ...capture, currentModuleSha256, moduleState, buildRevision: null };
+}
+//# sourceMappingURL=tui-runtime-info.js.map

package/dist/modes/interactive/tui-runtime-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-runtime-info.js","sourceRoot":"","sources":["../../../src/modes/interactive/tui-runtime-info.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { closeSync, constants, fstatSync, openSync, readSync, realpathSync } from \"node:fs\";\nimport { extname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { VERSION } from \"../../config.ts\";\n\nexport interface TuiRuntimeCapture {\n\treadonly version: string;\n\treadonly nodeVersion: string;\n\treadonly platform: NodeJS.Platform;\n\treadonly arch: string;\n\treadonly capturedAt: string;\n\treadonly entryPath: string | null;\n\treadonly modulePath: string | null;\n\treadonly moduleKind: \"source\" | \"dist\" | \"bundled\" | \"unknown\";\n\treadonly initialModuleSha256: string | null;\n}\nexport interface TuiRuntimeInfo extends TuiRuntimeCapture {\n\treadonly currentModuleSha256: string | null;\n\treadonly moduleState: \"unchanged\" | \"changed\" | \"unavailable\";\n\t/** The package currently supplies no build-to-commit binding. Never substitute checkout HEAD. */\n\treadonly buildRevision: null;\n}\n\nfunction moduleDigest(filePath: string | null): string | null {\n\tif (!filePath) return null;\n\tlet fd: number | undefined;\n\ttry {\n\t\tfd = openSync(filePath, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);\n\t\tconst stat = fstatSync(fd);\n\t\tif (!stat.isFile() || stat.size > 1_048_576) return null;\n\t\tconst bytes = Buffer.alloc(stat.size + 1);\n\t\tconst count = readSync(fd, bytes, 0, bytes.length, 0);\n\t\tif (count !== stat.size || fstatSync(fd).mtimeMs !== stat.mtimeMs) return null;\n\t\treturn createHash(\"sha256\").update(bytes.subarray(0, count)).digest(\"hex\");\n\t} catch {\n\t\t// A missing/unreadable/virtual entry is an unavailable observation, not a clean bill of health.\n\t\treturn null;\n\t} finally {\n\t\tif (fd !== undefined) closeSync(fd);\n\t}\n}\n\nexport function captureTuiRuntime(moduleUrl: string): TuiRuntimeCapture {\n\tlet modulePath: string | null = null;\n\ttry {\n\t\tmodulePath = fileURLToPath(moduleUrl);\n\t} catch {\n\t\t// Bundled runtimes need not expose a file URL.\n\t}\n\tlet entryPath = process.argv[1] ? resolve(process.argv[1]) : null;\n\tif (entryPath) {\n\t\ttry {\n\t\t\tentryPath = realpathSync(entryPath);\n\t\t} catch {\n\t\t\t/* Keep the observed launch path when unavailable. */\n\t\t}\n\t}\n\tconst normalized = modulePath?.replaceAll(\"\\\\\", \"/\") ?? moduleUrl;\n\tconst moduleKind = /(?:^bun:|\\/\\$bunfs\\/|\\/~BUN\\/)/u.test(normalized)\n\t\t? \"bundled\"\n\t\t: modulePath && [\".ts\", \".tsx\", \".mts\", \".cts\"].includes(extname(modulePath))\n\t\t\t? \"source\"\n\t\t\t: normalized.includes(\"/dist/\")\n\t\t\t\t? \"dist\"\n\t\t\t\t: \"unknown\";\n\treturn Object.freeze({\n\t\tversion: VERSION,\n\t\tnodeVersion: process.versions.node,\n\t\tplatform: process.platform,\n\t\tarch: process.arch,\n\t\tcapturedAt: new Date().toISOString(),\n\t\tentryPath,\n\t\tmodulePath,\n\t\tmoduleKind,\n\t\tinitialModuleSha256: moduleKind === \"bundled\" ? null : moduleDigest(modulePath),\n\t});\n}\n\nexport function inspectTuiRuntime(capture: TuiRuntimeCapture): TuiRuntimeInfo {\n\tconst currentModuleSha256 = capture.moduleKind === \"bundled\" ? null : moduleDigest(capture.modulePath);\n\tconst moduleState =\n\t\t!capture.initialModuleSha256 || !currentModuleSha256\n\t\t\t? \"unavailable\"\n\t\t\t: capture.initialModuleSha256 === currentModuleSha256\n\t\t\t\t? \"unchanged\"\n\t\t\t\t: \"changed\";\n\treturn { ...capture, currentModuleSha256, moduleState, buildRevision: null };\n}\n"]}

package/docs/development.md

@@ -76,6 +76,16 @@ LIVE_E2E=0 node ../../node_modules/vitest/dist/cli.js --run test/adaptorch-onboa
 Keep explicit file filters for routine work. A keyless regression pass is not a
 live-provider or release verification, and unfiltered suites may include e2e tests.
 
+## Commit checks
+
+The pre-commit hook validates the working tree without changing the selected
+index. It never auto-stages checker edits or unstaged hunks. If a checker changes
+the index, the hook fails and asks you to review the selection again; it does not
+restore or discard those changes. The checks still run against the working tree,
+not an isolated staged snapshot, so review partially staged changes separately.
+
+Hook regression: `node --test scripts/test/pre-commit-index.test.mjs`.
+
 ## Project Structure
 
 ```

package/docs/devin-harness.md

@@ -0,0 +1,121 @@
+# Devin SWE-2 harness
+
+This page is the canonical operator guide for the built-in `devin` provider and its only logical model, `swe-2`. Use `/login devin` for the Devin CLI subscription PKCE flow or `DEVIN_API_KEY` for an already-owned CLI session token. A user-local `~/.omk/agent/devin.md` may add operator notes, but it is not the portable product contract.
+
+Authentication, transport, and verification limits are owned by [Providers](providers.md#devin-cli); this page covers how OMK drives SWE-2 as a harness.
+
+## Presets
+
+Project presets live in `.omk/presets.json` (or `~/.omk/agent/presets.json`) and are consumed by the preset extension from `packages/coding-agent/examples/extensions/preset.ts`. The shared SWE-2 presets intentionally omit the `tools` key so role/domain lane grants keep control of the active tools.
+
+| Preset | Provider | Model | Thinking | Use |
+| --- | --- | --- | --- | --- |
+| `swe2-verified` | `devin` | `swe-2` | `high` | Default SWE-2 coding baseline: multi-file edits with tests. |
+| `swe2-max` | `devin` | `swe-2` | `max` | Long-horizon, uncertain, or repository-wide work that should use the 1M budget. |
+| `swe2-fast-edit` | `devin` | `swe-2` | `medium` | Small, well-specified edits where medium acts sooner and costs less. |
+
+```json
+{
+  "swe2-verified": { "provider": "devin", "model": "swe-2", "thinkingLevel": "high" },
+  "swe2-max": { "provider": "devin", "model": "swe-2", "thinkingLevel": "max" },
+  "swe2-fast-edit": { "provider": "devin", "model": "swe-2", "thinkingLevel": "medium" }
+}
+```
+
+For a new session without presets:
+
+```bash
+omk --provider devin --model swe-2 --thinking max
+```
+
+## Effort tiers
+
+SWE-2 exposes exactly three server-declared efforts. OMK maps its thinking tiers as follows and rejects anything else before sending credentials; `max` is a reasoning level, not the Devin Max subscription tier.
+
+| OMK tier | `swe-2` |
+| --- | --- |
+| `off`, `minimal`, `low` | unavailable |
+| `medium` | `medium` |
+| `high` | `high` |
+| `xhigh`, `ultra` | unavailable |
+| `max` | `max` |
+
+Guidance from the [SWE-2 announcement](https://cognition.com/blog/swe-2): `medium` makes its first real edit sooner and is the cost-efficient choice for simple and intermediate tasks; `high` and `max` plan more, explore more of the codebase, and verify more on complex tasks. `recommendedDevinEffortForIntent()` encodes the same split (`code` → `medium`, `test` → `high`, `debug`/`repo` → `max`).
+
+## Context budget: 1,000,000 tokens
+
+`devin/swe-2` ships with `contextWindow: 1000000` and `maxTokens: 16384`. These are local budgets that drive OMK's context budgeting and compaction, **not published SWE-2 limits**; Cognition has not published a context window for SWE-2. The budget also selects the catalog lane:
+
+1. Before each turn OMK reads `GetCliModelConfigs`. SWE-2 family entries may carry a `1M Context` axis (order `1`) beside the effort axis. A local budget of 1,000,000 or more asks for that 1M-context lane; below it, the standard lane is used and 1M entries are ignored.
+2. A catalog with no 1M-context lane keeps the standard lane for the selected effort.
+3. If the chosen lane declares a context window smaller than the local budget, the request fails with `... declares a N-token context window; lower the models.json contextWindow before retrying`. OMK never shrinks the budget silently, never invents a wire UID, and never downgrades to another effort.
+4. Fast-lane (`Fast Mode`) entries are always excluded. Output is capped against the authenticated catalog's declared maximum.
+
+To lower the budget (for example if your account only serves the standard lane at 262,144 tokens), override the built-in model in `~/.omk/agent/models.json`:
+
+```json
+{
+  "providers": {
+    "devin": {
+      "modelOverrides": {
+        "swe-2": { "contextWindow": 262144 }
+      }
+    }
+  }
+}
+```
+
+Recommended compaction settings for 1M sessions keep the defaults but raise the recent-token window so summaries do not discard the working set:
+
+```json
+{
+  "compaction": { "enabled": true, "reserveTokens": 16384, "keepRecentTokens": 60000, "maxUsageRatio": 0.85 }
+}
+```
+
+Context discipline still applies: the budget is room for the repository, not an invitation to dump it. Prefer targeted reads and searches, keep tool output bounded, and let `precompact-checkpoint` snapshot state before compaction rather than restarting sessions. Quota is per account; a larger window consumes more of it per turn.
+
+With a Devin credential configured, the status rail's USAGE section shows the account's daily and weekly quota meters from `GetUserStatus` (or the plan name and credit balances when the plan reports no quota windows), matching the CLI's `/usage` surface.
+
+## Domain routing
+
+Selecting the `devin` provider auto-applies the `devin-harness` loadout by default; this does not require `OMK_DOMAIN_ROUTING=1`. Set `OMK_DEVIN_HARNESS=0` to disable that provider-specific dispatch. The flag is independent from `OMK_GROK_HARNESS`.
+
+Loadout policies reject extension tools that shadow builtins fail-closed. A host that intentionally replaces the builtin `bash` (for example a Landstrip shell provider) should keep `OMK_DEVIN_HARNESS=0` in its launcher until the replacement is removed or bridged; the `devin.md` overlay and the model budget still apply in that case.
+
+General prompt-based domain routing is separate and opt-in through `OMK_DOMAIN_ROUTING=1`. It selects one of the profiles under [`loadout-domains/`](loadout-domains/README.md) and composes it with the active role loadout. SWE-2 presets only set provider, model, thinking level, and instruction pointers.
+
+## Model selection
+
+The `devin` catalog contains only the logical `swe-2` model; the server's SWE-2 family metadata supplies each effort's wire UID at request time. Use `/model` or `omk --list-models devin` for the current list. Image input is unsupported; provide text.
+
+## Skill and MCP matrix summary
+
+Use the normal OMK lane grant model: grant the smallest skill and MCP surface that matches the task.
+
+For each non-queued `devin` request started through `AgentSession.prompt()`, OMK calls `selectDevinHarnessSkills()` against the live discovered skill descriptions after ordinary prompt-template expansion. It merges up to three matches with explicit/settings selections and rebuilds that turn's `<active_skills source="devin-harness">` marker. The scorer is the same `selectSkills()` used by the Grok harness: weak 0.35 / strong 0.7 thresholds, deterministic input-order ties, first-name-wins deduplication, explicit-only skills never auto-selected, and `headroom` only for lexical pressure cues or the session's measured context-pressure bucket. A task with no signals yields an empty automatic grant rather than the full allowlist. Queued `steer`, `followUp`, or `prompt(..., { streamingBehavior })` messages retain the active run's system prompt.
+
+| Task class | Skills | MCP |
+| --- | --- | --- |
+| Multi-package or repo-context work | `packages`; add `headroom` only under context pressure | none by default |
+| Repo graph or broad comprehension | `understand-anything`; optionally `packages` | `understand-anything` |
+| TypeScript/Rust/Python/Go edits | `programming`; add `lsp` or `ast-grep` only for symbol/structural work | none by default |
+| New behavior or bug fix with regression test | `tdd-workflow`, `programming` | none by default |
+| Runtime failures or broken behavior | `debugging` | task-specific only |
+| Library API lookup | task skill as needed | `context7` |
+| Current public URL or docs lookup | task skill as needed | `fetch` |
+| UI/TUI verification | task skill as needed | `playwright` only when browser/UI evidence is required |
+
+Relevant evidence hooks for SWE-2 lanes are `pre-shell-guard`, `protect-secrets`, `typecheck-after-edit`, `stop-verify`, `session-context`, and `precompact-checkpoint`. Hook output is incremental evidence; code changes still need the project's required final verification command before claiming type/lint cleanliness.
+
+## Suggested TUI flow
+
+1. Run `/login devin` once; the account picker stores the CLI session token in `auth.json`.
+2. Select `/preset swe2-verified` for normal coding work, `/preset swe2-max` for long-horizon or repository-wide tasks, and `/preset swe2-fast-edit` for small edits.
+3. Use `/think medium`, `/think high`, or `/think max` to change effort mid-session; other levels are rejected.
+4. If a turn fails with an "unavailable or ambiguous" route or a smaller declared context window, treat it as a configuration signal: check `devin models list`, or lower `contextWindow` as shown above. Do not retry with a guessed wire UID.
+5. Keep credentials out of preset JSON, prompts, and logs: the session token, the exchanged user JWT, and `auth.json` contents are secrets under `protect-secrets`.
+
+## Local overlay
+
+When the `devin` provider is active, OMK appends `~/.omk/agent/devin.md` (capped at 24,000 characters) to the system prompt, mirroring the Grok `grok.md` overlay. Treat that file as optional host configuration for effort defaults, compaction notes, or team conventions; this page and the current provider documentation remain authoritative and it cannot override higher-priority instructions.

package/docs/docs.json

@@ -27,6 +27,10 @@
           "title": "Native xAI Grok",
           "path": "grok-harness.md"
         },
+        {
+          "title": "Devin SWE-2",
+          "path": "devin-harness.md"
+        },
         {
           "title": "Containerization",
           "path": "containerization.md"

package/docs/environment-variables.md

@@ -100,7 +100,8 @@ These variables are read by OMK itself. The four built-in harness flags below ar
 | `OMK_YOLO`, `OMK_COMMAND_SAFETY`, `OMK_DISABLE_COMMAND_SAFETY` | Disable the command-safety gate entirely (YOLO mode). `OMK_YOLO` and `OMK_DISABLE_COMMAND_SAFETY` accept `1`, `true`, `yes`, or `on`; `OMK_COMMAND_SAFETY` accepts `0`, `false`, `off`, `disable`, or `disabled`. Every verdict, including block-tier and privilege commands, is skipped in interactive and headless runs. Use only when a verified outer sandbox owns the boundary |
 | `OMK_COMMAND_SAFETY_ASSUME_YES` | `1` or `true` auto-accepts non-privilege confirm-tier commands in interactive **and headless** runs. Privilege confirmation and block-tier commands remain denied. Use only under a trusted outer sandbox when headless auto-accept is intended |
 | `OMK_GROK_HARNESS` | Default-on native `xai` provider dispatch to the `grok-harness` loadout. `0`, `false`, `off`, or `no` disables it |
-| `OMK_DOMAIN_ROUTING` | Set to `1` to enable general prompt-based domain routing. Native xAI harness dispatch does not require it |
+| `OMK_DEVIN_HARNESS` | Default-on `devin` provider dispatch to the `devin-harness` loadout. `0`, `false`, `off`, or `no` disables it; independent from `OMK_GROK_HARNESS` |
+| `OMK_DOMAIN_ROUTING` | Set to `1` to enable general prompt-based domain routing. Native xAI and Devin harness dispatch do not require it |
 | `VISUAL`, `EDITOR` | External editor fallback when `externalEditor` is unset |
 | `HTTP_PROXY`, `HTTPS_PROXY` | Proxy outbound HTTP requests |
 | `OMK_RESOURCE_GOVERNOR` | Resource-governor mode: `off`, `observe` (default), `adaptive`, or `strict`. Feeds `/resource [probe\|policy]` and `omk doctor resources [--json]`; see the resource governor section in [Settings](settings.md) |

package/docs/index.md

@@ -39,6 +39,7 @@ For the full first-run flow, see [Quickstart](quickstart.md).
 - [Providers](providers.md) - subscription and API-key setup for built-in providers.
 - [Provider Resilience](provider-resilience.md) - retry, failover, quota, and safety-stop recovery.
 - [Native xAI Grok](grok-harness.md) - authentication, weekly SuperGrok usage, presets, and thinking tiers.
+- [Devin SWE-2](devin-harness.md) - presets, effort tiers, the 1M-token context budget and lane rule, and the `devin-harness` loadout.
 - [Containerization](containerization.md) - sandbox omk with OpenShell, Gondolin, or Docker.
 - [Settings](settings.md) - global and project settings.
 - [Environment Variables](environment-variables.md) - process configuration, harness opt-outs, and bash-tool session environment.

package/docs/keybindings.md

@@ -118,7 +118,7 @@ Modifier combinations: `ctrl+shift+x`, `alt+ctrl+x`, `ctrl+shift+alt+x`, `ctrl+1
 
 | Keybinding id | Default | Description |
 |--------|---------|-------------|
-| `app.tools.expand` | `ctrl+o` | Collapse or expand tool output |
+| `app.tools.expand` | `ctrl+o` | Collapse or expand tool output and typed failure details |
 | `app.message.followUp` | `alt+enter` | Queue follow-up message |
 | `app.message.dequeue` | `alt+up` | Restore queued messages to editor |
 

package/docs/loadout-domains/README.md

@@ -21,7 +21,7 @@ OMK routes incoming tasks to a **domain capability profile** ("inherited documen
 
 Thresholds: `STRONG_THRESHOLD = 8`, `WEAK_THRESHOLD = 4`, `AMBIGUITY_MARGIN = 2`.
 
-## Domains (13 + 1 fallback)
+## Domains (14 + 1 fallback)
 
 - [`frontend-ui`](frontend-ui.md) — Frontend & UI
 - [`visual-qa`](visual-qa.md) — Visual QA & Website Cloning
@@ -35,6 +35,7 @@ Thresholds: `STRONG_THRESHOLD = 8`, `WEAK_THRESHOLD = 4`, `AMBIGUITY_MARGIN = 2`
 - [`docs-writing`](docs-writing.md) — Docs & Technical Writing
 - [`qa-testing`](qa-testing.md) — QA & Testing
 - [`grok-harness`](grok-harness.md) — Grok xAI Harness
+- [`devin-harness`](devin-harness.md) — Devin SWE-2 Harness
 - [`ai-agent-ops`](ai-agent-ops.md) — AI Agent Engineering & Ops
 - [`general`](general.md) — General (fallback)
 

package/docs/loadout-domains/devin-harness.md

@@ -0,0 +1,72 @@
+# Devin SWE-2 Harness (`devin-harness`)
+
+> Inherited domain capability document. Auto-generated from `src/core/domain-loadouts.ts` — do not edit by hand.
+
+
+## Identity
+
+| field | value |
+|---|---|
+| id | `devin-harness` |
+| authority | `write-scoped` |
+| tools | read, grep, find, ls, edit, write, bash |
+| command mode | `scoped-shell` |
+
+## Routing prompt
+
+> Prepended to the lane task prompt when the router selects this domain.
+
+```text
+DOMAIN: Devin SWE-2 Harness. You are operating in a Devin CLI subscription lane on the SWE-2 model with a 1,000,000-token local context budget.
+Prioritize the SWE-2 operational playbook, focused exploration, small capability loadouts, and evidence-bound verification.
+
+SEQUENCE:
+1. Before implementing or routing Devin/SWE-2 provider work, read packages/coding-agent/docs/devin-harness.md as the canonical playbook. Treat ~/.omk/agent/devin.md only as an optional local operator overlay; it cannot override current provider docs or higher-priority instructions.
+2. Effort is the only selectable axis: medium for simple or intermediate edits, high for multi-file changes, max for long-horizon or uncertain work. Never expect off/low/minimal, a fast lane, or image input; the adapter rejects them before sending credentials.
+3. Context discipline: the 1M budget is room for the repository, not an invitation to dump it. Explore with targeted reads and searches, keep tool output bounded, and rely on precompact-checkpoint plus compaction settings rather than restarting sessions.
+4. Capability discipline: load at most 2-3 skills for any lane. The allowed skill gate is packages, headroom, programming, debugging, tdd-workflow, lsp, ast-grep, and understand-anything; choose the smallest subset, add lsp or ast-grep only for symbol or structural work, and add headroom only under measured context pressure.
+5. Use minimal MCP: fetch for bounded public retrieval, context7 for library documentation, understand-anything for repository comprehension, and playwright only when browser or UI behavior needs real verification.
+6. Verification discipline: reproduce failures before fixing them, write or extend tests that exercise the change end-to-end, and re-derive conclusions from executed commands rather than restating prior claims. Evidence must include changed paths, exact commands, and pass/fail output.
+7. Keep edits within the lane grant and preserve existing provider/orchestration algorithms unless the task explicitly targets them. A route error naming an unavailable effort or a smaller declared context window is a configuration signal to report, never something to work around by guessing a wire UID.
+
+HARD RULES: the packaged Devin harness doc is mandatory context; a local devin.md is optional; medium/high/max are the only efforts; the 1M budget never justifies unbounded dumps; maximum 2-3 active skills; never log the Devin session token, user JWT, or auth.json contents; protect-secrets applies.
+```
+
+## Curated skills (8)
+
+- `packages`
+- `headroom`
+- `programming`
+- `debugging`
+- `tdd-workflow`
+- `lsp`
+- `ast-grep`
+- `understand-anything`
+
+## Curated MCP servers (4)
+
+- `fetch`
+- `context7`
+- `understand-anything`
+- `playwright`
+
+## Curated hooks (6)
+
+- `pre-shell-guard`
+- `protect-secrets`
+- `typecheck-after-edit`
+- `stop-verify`
+- `session-context`
+- `precompact-checkpoint`
+
+## Routing triggers (7)
+
+| kind | pattern | weight |
+|---|---|---|
+| keyword | `devin` | 8 |
+| keyword | `swe-2` | 8 |
+| keyword | `swe2` | 8 |
+| keyword | `cognition` | 6 |
+| keyword | `devin cli` | 8 |
+| keyword | `1m context` | 5 |
+| regex | `\b(devin|swe[- ]?2|cognition)\b` | 7 |