open-multi-agent-kit 0.98.4 → 0.98.5

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/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/release-audit-0.98.5.md

@@ -0,0 +1,84 @@
+# Release audit: v0.98.5
+
+Date: 2026-09-12. This records candidate preparation and verification, not proof of
+semantic correctness, comparative performance or completed publication.
+
+## Scope and changelog audit
+
+The candidate retains the public v0.98.4 ancestry and the committed implementation
+range through `b84d0d9b8e`. The audit covers index-preserving Git checks, execution
+ownership/shared budgets, protected verified runs and candidate recovery, input
+checkpoint writer restart, static DAG retry, and TUI diagnostics. Tool timeout
+messages now distinguish requested cancellation from observed termination and use
+a monotonic teardown grace period.
+
+Preparation adds release metadata, this audit, and focused verification fixes:
+initial failure-card expansion is applied at construction, execution wrappers
+preserve lazy context-sensitive timeouts, and the commit hook handles changed-file
+status under Husky's errexit mode. Existing dirty provider, retry,
+parallel-frontier, resource-label and TB changes are excluded.
+Their working files are preserved, and their pending changelog entries stay out of
+the candidate. Published v0.98.4 and earlier changelog bodies remain unchanged.
+Model catalogs are reused rather than fetched or regenerated. Credentials, private
+agent-home configuration and the user's running TUI are not changed.
+
+## Version and artifact contract
+
+All seven public packages target 0.98.5: `open-multi-agent-kit`, `omk-ai`,
+`omk-agent-core`, `omk-tui`, `omk-protocol`, `omk-adaptorch-wpl` and
+`omk-book-to-skill`. Root/example manifests and locks, internal dependency ranges,
+the book compiler's source version constant, CLI shrinkwrap and README pointers
+are synchronized. External dependency versions and integrity values are unchanged.
+
+The release candidate is selected by path/hunk and inspected as a complete staged
+diff. Verification uses an isolated candidate, not the mixed working tree. Temporary
+homes contain no provider credentials; live inference and benchmarks are not run.
+
+## Observed verification
+
+- The diagnostics implementation passed type checking and 104 focused tests in its
+  staged snapshot. Its canonical installed launcher passed offline 120/80-column
+  inspection, save, failure, reload and quit checks without model prompts.
+- Version preparation passed 13-manifest/root-lock parity, source-version tests,
+  book metadata tests and the canonical `omk --version` check for 0.98.5.
+- The isolated candidate build and `npm run check` exited 0. Module-size and
+  import-cycle baselines were not raised.
+- The final full offline run exited 0: 8,181 passed, 837 environment/live-condition
+  skips, no failures. Package passes were WPL 149, agent 870, AI 631, book compiler
+  22, coding-agent 5,653, protocol 126 and TUI 730. Vitest workers were bounded at
+  four; the TUI package used its Node test runner.
+- Seven-package npm pack dry runs and release-surface checks passed. They checked
+  package version/file metadata without publication or lifecycle scripts.
+- Gitleaks found no leaks in the staged changes or the six implementation commits
+  since v0.98.4. Reports were redacted; this is not clearance for private histories
+  outside that range.
+
+## Verification repairs
+
+The isolated candidate exposed a two-line module-size overrun that the mixed tree
+hid. Passing initial expansion to the failure-card constructor avoids a redundant
+rebuild and keeps the existing size baseline; both initial states are tested.
+
+The full suite exposed an execution wrapper spreading a tool's dynamic timeout
+getter into a fixed value. The wrapper now projects tool metadata and forwards
+that getter lazily. Regression checks cover no eager evaluation, timeout changes,
+stale-context rejection and retained execution metadata.
+
+The commit hook had only been tested under plain `sh`, while Husky invokes `sh -e`.
+A changed-file `git diff --quiet` status of 1 therefore stopped valid release
+commits. Capturing that status in an OR-list preserves errexit for real failures;
+all six hook fixtures now run under `sh -e`, including changed paths with spaces,
+index preservation and a fatal git-diff error.
+
+An initial test launch resolved to the wrong checkout and was cancelled, not counted
+as candidate evidence. Subsequent launches fix both process cwd and npm prefix.
+An isolated HOME also hid the installed Rust toolchain: explicitly supplying its
+location restored the real cargo diagnostic check without changing the test or
+copying credentials. Neither fixture failure was treated as a product pass.
+
+A source-file fingerprint is not an executed-build attestation. Linux observations
+do not establish behavior on every target platform. CI must validate the exact tag,
+build the six platform archives, run checks/tests, publish all seven npm packages
+and create the GitHub Release. Existing token-based CI authentication is unchanged;
+OIDC/Sigstore provenance is not claimed. Publication is complete only when the main
+tag, GitHub Release and seven npm `latest` values agree.

package/docs/run-protocol.md

@@ -6,7 +6,7 @@ The OMK Run Protocol defines one versioned contract for task execution and evalu
 TaskSpec -> ExecutionAttempt -> Observation -> EvaluationResult -> RuntimeDecision
 ```
 
-`omk-protocol` owns these records and the pure reducers that connect them. Tool execution, persistence, scheduling, routing, and topology remain outside the package.
+`omk-protocol` owns these records and the pure reducers that connect them. Tool execution, persistence, runtime scheduling, routing, and topology selection remain outside the package.
 
 ## Implemented scope
 
@@ -24,6 +24,38 @@ The first v1 slice is available under `packages/protocol` with schema version `o
 
 Every top-level record carries `schemaVersion`. Parsers reject unsupported versions, malformed timestamps, duplicate claim IDs, invalid JSON facts, and empty logical conditions.
 
+## Isolated command-run profile
+
+`RunContract` and `RunStartCommand` add strict, immutable parsers for the opt-in
+`linux-command-v1` and `linux-scripted-agent-v1` profiles. They pin the input digest,
+write scope, commands, stdout assertions and finite phase/snapshot limits. The
+scripted profile also pins 1–16 approved steps and a 1–32 logical request cap for
+an offline AgentSession reference adapter. Unknown authority/provider fields are
+rejected; the host must separately authorize the exact contract digest.
+`RunResumeCommand` / `parseRunResumeCommand()` pin the contract, candidate and exact
+expected revision/generation. The host may acquire at most three generations under
+`MAX_VERIFIED_RUN_GENERATIONS`; a resume command does not authorize replay of a writer.
+The separate `RunWriterRestartCommand` / `parseRunWriterRestartCommand()` binds
+`baseDigest` to a durable input checkpoint for an explicit local writer restart.
+Recovery commands share command IDs and the generation cap; none resets budgets.
+
+`linux-command-dag-v1` adds `RunDagWriter` / `RunDagTask` with 1–16 nodes, explicit
+artifact dependencies, disjoint write scopes and 1–2 preapproved command attempts per
+node. `orderRunDag()` provides deterministic FIFO topological order and
+`runDagAncestors()` includes the full transitive input closure. `RunTaskRetryCommand`
+/ `parseRunTaskRetryCommand()` pins a task selection to the original input and exact
+run revision/generation. These pure contracts never authorize dispatch or authenticate
+cached output; the Coordinator checks stored material and records adoption before reuse.
+
+The coding-agent's `RunCoordinator` owns execution and its separate v2 journal.
+It binds native v3 receipt cores to the candidate through a supervisor attestation,
+then supplies authenticated checks to the existing claim-closure reducer.
+This does not replace the task/attempt/evaluation contracts or add execution to
+this package. See [Verified Run](verified-run.md) for the implemented CLI/SDK
+path, candidate recovery and checkpoint-based local writer restart, plus the
+serial command DAG and selective retry, plus remaining live-model, parallel frontier,
+plan amendment and control-surface work.
+
 ## Durable goal lifecycle
 
 A durable goal is working-directory state, not a session-file field or a `TaskSpec`. `/goal <objective>` creates or edits `.omk/goals/current.json`; `/goal` without arguments shows its status and round count.

package/docs/runtime-algorithms.md

@@ -1,5 +1,31 @@
 # Runtime Algorithms and Direction
 
+## Working-tree shared run budgets
+
+The SDK `prompt(..., { runBudget })` path now shares a monotonic deadline and
+logical request/concurrency limits across the active prompt's main stream,
+retries, continuations, and first-party summaries using that stream. Exhaustion
+is a non-retryable `budget_exhausted` termination; snapshots keep outstanding
+streams until terminal metadata arrives. No request/time budget is imposed by
+default. Preflight is now owned even for unbounded prompts; unresolved streams
+block a later prompt instead of being discarded when their budget scope closes.
+See [Shared run budgets](sdk.md#shared-run-budgets-sdk-opt-in) for units, zero
+semantics, cancellation, and uncovered paths. This is not billing enforcement,
+a persisted budget, or a hard process-termination deadline.
+
+## Working-tree execution ownership (2026-09-10)
+
+The live session now retains registered tool-promise ownership after timeout or
+abort, defers prompt settlement/resource-lease release until actual termination,
+and rejects overlapping prompt admission. Shared permits capture request values,
+honor zero capacity, and wake FIFO followers after head cancellation/expiry.
+The internal lane launcher forwards cancellation and respects zero/heavy caps.
+Independent bash calls now own separate cancellation controllers, and one call's
+completion cannot hide another active call. Core teardown waits use a monotonic
+clock, preserving the existing grace interval across wall-clock changes.
+See [Prompt settlement](sdk.md#prompt-settlement) for tests, compatibility, and
+uncovered paths. These changes do not implement a durable verified-run product.
+
 ## v0.98.3 release delta (2026-09-06)
 
 The explicit advisory SDK requires normal first-party model completion, honors cancellation,