open-multi-agent-kit 0.91.0 → 0.93.0

package/docs/json.md

@@ -8,7 +8,7 @@ Outputs all session events as JSON lines to stdout. Useful for integrating omk i
 
 ## Event Types
 
-Events are defined in [`AgentSessionEvent`](https://github.com/earendil-works/omk-mono/blob/main/packages/coding-agent/src/core/agent-session.ts#L102):
+Events are defined in [`AgentSessionEvent`](https://github.com/dmae97/omk/blob/main/packages/coding-agent/src/core/agent-session.ts#L102):
 
 ```typescript
 type AgentSessionEvent =
@@ -22,7 +22,7 @@ type AgentSessionEvent =
 
 `queue_update` emits the full pending steering and follow-up queues whenever they change. `compaction_start` and `compaction_end` cover both manual and automatic compaction.
 
-Base events from [`AgentEvent`](https://github.com/earendil-works/omk-mono/blob/main/packages/agent/src/types.ts#L179):
+Base events from [`AgentEvent`](https://github.com/dmae97/omk/blob/main/packages/agent/src/types.ts#L179):
 
 ```typescript
 type AgentEvent =
@@ -44,12 +44,12 @@ type AgentEvent =
 
 ## Message Types
 
-Base messages from [`packages/ai/src/types.ts`](https://github.com/earendil-works/omk-mono/blob/main/packages/ai/src/types.ts#L134):
+Base messages from [`packages/ai/src/types.ts`](https://github.com/dmae97/omk/blob/main/packages/ai/src/types.ts#L134):
 - `UserMessage` (line 134)
 - `AssistantMessage` (line 140)
 - `ToolResultMessage` (line 152)
 
-Extended messages from [`packages/coding-agent/src/core/messages.ts`](https://github.com/earendil-works/omk-mono/blob/main/packages/coding-agent/src/core/messages.ts#L29):
+Extended messages from [`packages/coding-agent/src/core/messages.ts`](https://github.com/dmae97/omk/blob/main/packages/coding-agent/src/core/messages.ts#L29):
 - `BashExecutionMessage` (line 29)
 - `CustomMessage` (line 46)
 - `BranchSummaryMessage` (line 55)

package/docs/providers.md

@@ -89,7 +89,7 @@ omk
 | Xiaomi MiMo Token Plan (Singapore) | `XIAOMI_TOKEN_PLAN_SGP_API_KEY` | `xiaomi-token-plan-sgp` |
 | Zyloo | `ZYLOO_API_KEY` | `zyloo` |
 
-Reference for environment variables and `auth.json` keys: [`const envMap`](https://github.com/earendil-works/omk-mono/blob/main/packages/ai/src/env-api-keys.ts) in [`packages/ai/src/env-api-keys.ts`](https://github.com/earendil-works/omk-mono/blob/main/packages/ai/src/env-api-keys.ts).
+Reference for environment variables and `auth.json` keys: [`const envMap`](https://github.com/dmae97/omk/blob/main/packages/ai/src/env-api-keys.ts) in [`packages/ai/src/env-api-keys.ts`](https://github.com/dmae97/omk/blob/main/packages/ai/src/env-api-keys.ts).
 
 #### Zyloo
 

package/docs/rpc.md

@@ -424,12 +424,14 @@ Response:
 
 #### bash
 
-Execute a shell command and add output to conversation context.
+Execute a shell command and add output to conversation context. Output streams as `bash_execution_update` events while the command runs; the response contains the final result.
 
 ```json
-{"type": "bash", "command": "ls -la"}
+{"id": "req-1", "type": "bash", "command": "ls -la"}
 ```
 
+Include an `id` to associate streamed `bash_execution_update` events with this command.
+
 Response:
 ```json
 {
@@ -753,6 +755,7 @@ Events are streamed to stdout as JSON lines during agent operation. Events do NO
 | `message_start` | Message begins |
 | `message_update` | Streaming update (text/thinking/toolcall deltas) |
 | `message_end` | Message completes |
+| `bash_execution_update` | Direct RPC bash command output chunk (includes originating command `id`) |
 | `tool_execution_start` | Tool begins execution |
 | `tool_execution_update` | Tool execution progress (streaming output) |
 | `tool_execution_end` | Tool completes |

package/docs/session-format.md

@@ -28,11 +28,11 @@ Existing sessions are automatically migrated to the current version (v3) when lo
 
 ## Source Files
 
-Source on GitHub ([omk-mono](https://github.com/earendil-works/omk-mono)):
-- [`packages/coding-agent/src/core/session-manager.ts`](https://github.com/earendil-works/omk-mono/blob/main/packages/coding-agent/src/core/session-manager.ts) - Session entry types and SessionManager
-- [`packages/coding-agent/src/core/messages.ts`](https://github.com/earendil-works/omk-mono/blob/main/packages/coding-agent/src/core/messages.ts) - Extended message types (BashExecutionMessage, CustomMessage, etc.)
-- [`packages/ai/src/types.ts`](https://github.com/earendil-works/omk-mono/blob/main/packages/ai/src/types.ts) - Base message types (UserMessage, AssistantMessage, ToolResultMessage)
-- [`packages/agent/src/types.ts`](https://github.com/earendil-works/omk-mono/blob/main/packages/agent/src/types.ts) - AgentMessage union type
+Source on GitHub ([omk-mono](https://github.com/dmae97/omk)):
+- [`packages/coding-agent/src/core/session-manager.ts`](https://github.com/dmae97/omk/blob/main/packages/coding-agent/src/core/session-manager.ts) - Session entry types and SessionManager
+- [`packages/coding-agent/src/core/messages.ts`](https://github.com/dmae97/omk/blob/main/packages/coding-agent/src/core/messages.ts) - Extended message types (BashExecutionMessage, CustomMessage, etc.)
+- [`packages/ai/src/types.ts`](https://github.com/dmae97/omk/blob/main/packages/ai/src/types.ts) - Base message types (UserMessage, AssistantMessage, ToolResultMessage)
+- [`packages/agent/src/types.ts`](https://github.com/dmae97/omk/blob/main/packages/agent/src/types.ts) - AgentMessage union type
 
 For TypeScript definitions in your project, inspect `node_modules/open-multi-agent-kit/dist/` and `node_modules/omk-ai/dist/`.
 

package/docs/settings.md

@@ -77,6 +77,7 @@ Advisory-only hint source for the v4 auto thinking-level resolver. Read from the
 | `editorPaddingX` | number | `0` | Horizontal padding for input editor (0-3) |
 | `autocompleteMaxVisible` | number | `5` | Max visible items in autocomplete dropdown (3-20) |
 | `showHardwareCursor` | boolean | `false` | Show the terminal cursor while TUI positions it for IME support |
+| `pinStatusSidebar` | boolean | `false` | Pin the bottom status bar as a responsive right rail (opencode-style): width scales with the terminal (~26%, 34–48 cols), the MCP roster grows on taller terminals, and the content column shrinks to match so the prompt is never covered. Toggle anytime with `Ctrl+Q`. Also enabled by `OMK_PIN_STATUS_SIDEBAR=1` |
 
 ### Telemetry and update checks
 

package/docs/skills.md

@@ -4,6 +4,8 @@
 
 Skills are self-contained capability packages that the agent loads on-demand. A skill provides specialized workflows, setup instructions, helper scripts, and reference documentation for specific tasks.
 
+OMK ships with **no built-in skills** — every skill is user-installed via the locations below, an OMK package, or `--skill`. The default session has zero skills and zero MCP servers configured.
+
 OMK implements the [Agent Skills standard](https://agentskills.io/specification), warning about most violations but remaining lenient. OMK allows skill names to differ from their parent directory even though the standard disallows it; that rule is suboptimal for shared skill directories used across multiple agent harnesses.
 
 ## Table of Contents

package/docs/themes.md

@@ -56,7 +56,7 @@ vim ~/.omk/agent/themes/my-theme.json
 
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/earendil-works/omk/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "$schema": "https://raw.githubusercontent.com/dmae97/omk/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
   "name": "my-theme",
   "vars": {
     "primary": "#00aaff",
@@ -126,7 +126,7 @@ vim ~/.omk/agent/themes/my-theme.json
 
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/earendil-works/omk/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "$schema": "https://raw.githubusercontent.com/dmae97/omk/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
   "name": "my-theme",
   "vars": {
     "blue": "#0066cc",

package/docs/tui.md

@@ -4,7 +4,7 @@
 
 Extensions and custom tools can render custom TUI components for interactive user interfaces. This page covers the component system and available building blocks.
 
-**Source:** [`omk-tui`](https://github.com/earendil-works/omk-mono/tree/main/packages/tui)
+**Source:** [`omk-tui`](https://github.com/dmae97/omk/tree/main/packages/tui)
 
 ## Component Interface
 
@@ -742,7 +742,7 @@ ctx.ui.setStatus("my-ext", ctx.ui.theme.fg("accent", "● active"));
 ctx.ui.setStatus("my-ext", undefined);
 ```
 
-**Examples:** [status-line.ts](../examples/extensions/status-line.ts), [plan-mode.ts](../examples/extensions/plan-mode.ts), [preset.ts](../examples/extensions/preset.ts)
+**Examples:** [status-line.ts](../examples/extensions/status-line.ts), [plan-mode.ts](../examples/extensions/plan-mode/index.ts), [preset.ts](../examples/extensions/preset.ts)
 
 ### Pattern 4b: Working Indicator Customization
 
@@ -802,7 +802,7 @@ ctx.ui.setWidget("my-widget", (_tui, theme) => {
 ctx.ui.setWidget("my-widget", undefined);
 ```
 
-**Examples:** [plan-mode.ts](../examples/extensions/plan-mode.ts)
+**Examples:** [plan-mode.ts](../examples/extensions/plan-mode/index.ts)
 
 ### Pattern 6: Custom Footer
 
@@ -919,7 +919,7 @@ export default function (omk: ExtensionAPI) {
 - **Selection UI**: [examples/extensions/preset.ts](../examples/extensions/preset.ts) - SelectList with DynamicBorder framing
 - **Async with cancel**: [examples/extensions/qna.ts](../examples/extensions/qna.ts) - BorderedLoader for LLM calls
 - **Settings toggles**: [examples/extensions/tools.ts](../examples/extensions/tools.ts) - SettingsList for tool enable/disable
-- **Status indicators**: [examples/extensions/plan-mode.ts](../examples/extensions/plan-mode.ts) - setStatus and setWidget
+- **Status indicators**: [examples/extensions/plan-mode/index.ts](../examples/extensions/plan-mode/index.ts) - setStatus and setWidget
 - **Working indicator**: [examples/extensions/working-indicator.ts](../examples/extensions/working-indicator.ts) - setWorkingIndicator
 - **Custom footer**: [examples/extensions/custom-footer.ts](../examples/extensions/custom-footer.ts) - setFooter with stats
 - **Custom editor**: [examples/extensions/modal-editor.ts](../examples/extensions/modal-editor.ts) - Vim-like modal editing

package/docs/usage.md

@@ -151,6 +151,8 @@ OMK loads `AGENTS.md` or `CLAUDE.md` at startup from:
 
 Use context files for project conventions, commands, safety rules, and preferences. Disable loading with `--no-context-files` or `-nc`.
 
+The core prompt builder places a fixed runtime trust boundary before loaded context and skill metadata. Global context can constrain project context, but loaded resources cannot expand user authorization or override active runtime/security controls. Context paths and text are XML-escaped before prompt assembly so resource content cannot break out of its structural envelope. This is defense in depth, not a code sandbox: extensions are executable trusted code and can explicitly rewrite the system prompt or final provider payload.
+
 ### System Prompt Files
 
 Replace the default system prompt with:
@@ -160,6 +162,8 @@ Replace the default system prompt with:
 
 Append to the default prompt without replacing it with `APPEND_SYSTEM.md` in either location.
 
+Replacing or appending the default prompt does not remove the core runtime trust boundary; OMK inserts it after custom prompt text and before context files and skills.
+
 ## Exporting and Sharing Sessions
 
 Use `/export [file]` to write a session to HTML.

package/examples/extensions/custom-provider-anthropic/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "omk-extension-custom-provider-anthropic",
-  "version": "0.91.0",
+  "version": "0.93.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "omk-extension-custom-provider-anthropic",
-      "version": "0.91.0",
+      "version": "0.93.0",
       "dependencies": {
         "@anthropic-ai/sdk": "0.52.0"
       }

package/examples/extensions/custom-provider-anthropic/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "omk-extension-custom-provider-anthropic",
 	"private": true,
-	"version": "0.91.0",
+	"version": "0.93.0",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/custom-provider-gitlab-duo/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "omk-extension-custom-provider-gitlab-duo",
 	"private": true,
-	"version": "0.91.0",
+	"version": "0.93.0",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/gondolin/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "omk-extension-gondolin",
-	"version": "0.91.0",
+	"version": "0.93.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "omk-extension-gondolin",
-			"version": "0.91.0",
+			"version": "0.93.0",
 			"dependencies": {
 				"@earendil-works/gondolin": "0.12.0"
 			}

package/examples/extensions/gondolin/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "omk-extension-gondolin",
 	"private": true,
-	"version": "0.91.0",
+	"version": "0.93.0",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/sandbox/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "omk-extension-sandbox",
-	"version": "0.91.0",
+	"version": "0.93.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "omk-extension-sandbox",
-			"version": "0.91.0",
+			"version": "0.93.0",
 			"dependencies": {
 				"@anthropic-ai/sandbox-runtime": "0.0.26"
 			}

package/examples/extensions/sandbox/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "omk-extension-sandbox",
 	"private": true,
-	"version": "0.91.0",
+	"version": "0.93.0",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/subagent/README.md

@@ -9,15 +9,25 @@ Delegate tasks to specialized subagents with isolated context windows.
 - **Parallel streaming**: All parallel tasks stream updates simultaneously
 - **Markdown rendering**: Final output rendered with proper formatting (expanded view)
 - **Usage tracking**: Shows turns, tokens, cost, and context usage per agent
-- **Abort support**: Ctrl+C propagates to kill subagent processes
+- **Abort support**: Ctrl+C propagates to the entire detached subagent process tree
+- **Dual-budget planning**: Predictive sharding uses both estimated tokens and learned wall-clock demand
+- **Checkpoint resume**: A cutoff resumes only the unfinished shard with bounded prior evidence
+- **Cutoff learning**: Completion/cutoff history is persisted per provider and model under the agent state directory
+- **Bounded cost**: At most 3 semantic shards and 1 resume across the whole logical task by default
 
 ## Structure
 
 ```
 subagent/
 ├── README.md            # This file
-├── index.ts             # The extension (entry point)
-├── agents.ts            # Agent discovery logic
+├── index.ts                    # The extension entry point
+├── adaptive-agent-runtime.ts   # Shard/checkpoint/resume coordinator
+├── checkpoint-runtime.ts       # Bounded checkpoint protocol
+├── deadline-budget.ts          # Token + wall-clock planning and cutoff learning
+├── deadline-profile-store.ts   # Persistent provider/model profiles
+├── managed-process.ts          # Process-tree termination and cleanup
+├── subagent-runtime-types.ts   # Typed result/deadline metadata
+├── agents.ts                   # Agent discovery logic
 ├── agents/              # Sample agent definitions
 │   ├── scout.md         # Fast recon, returns compressed context
 │   ├── planner.md       # Creates implementation plans
@@ -36,8 +46,12 @@ From the repository root, symlink the files:
 ```bash
 # Symlink the extension (must be in a subdirectory with index.ts)
 mkdir -p ~/.omk/agent/extensions/subagent
-ln -sf "$(pwd)/packages/coding-agent/examples/extensions/subagent/index.ts" ~/.omk/agent/extensions/subagent/index.ts
-ln -sf "$(pwd)/packages/coding-agent/examples/extensions/subagent/agents.ts" ~/.omk/agent/extensions/subagent/agents.ts
+src="$(pwd)/packages/coding-agent/examples/extensions/subagent"
+for f in index.ts agents.ts agent-capability-router.ts capabilities.ts domain-profiles.ts \
+  adaptive-agent-runtime.ts adaptive-result.ts checkpoint-runtime.ts deadline-budget.ts \
+  deadline-profile-store.ts managed-process.ts subagent-runtime-types.ts; do
+  ln -sf "$src/$f" ~/.omk/agent/extensions/subagent/$f
+done
 
 # Symlink agents
 mkdir -p ~/.omk/agent/agents
@@ -92,9 +106,16 @@ Use a chain: first have scout find the read tool, then have planner suggest impr
 
 | Mode | Parameter | Description |
 |------|-----------|-------------|
-| Single | `{ agent, task }` | One agent, one task |
-| Parallel | `{ tasks: [...] }` | Multiple agents run concurrently (max 8, 4 concurrent) |
-| Chain | `{ chain: [...] }` | Sequential with `{previous}` placeholder |
+| Single | `{ agent, task }` | One logical task; the runtime may split it into bounded semantic shards |
+| Parallel | `{ tasks: [...] }` | Multiple logical tasks run concurrently (max 8, 4 concurrent) |
+| Chain | `{ chain: [...] }` | Sequential with `{previous}` placeholder and a fair deadline share per remaining step |
+
+Optional execution controls:
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `executionBudgetMs` | `840000` | Internal hard budget, leaving 60 seconds before a configured 900000 ms tool timeout |
+| `maxResumeAttempts` | `1` | Retries only the active unfinished shard; accepted range is 0-2 |
 
 ## Output Display
 
@@ -164,8 +185,10 @@ Project agents override user agents with the same name when `agentScope: "both"`
 
 - **Exit code != 0**: Tool returns error with stderr/output
 - **stopReason "error"**: LLM error propagated with error message
-- **stopReason "aborted"**: User abort (Ctrl+C) kills subprocess, throws error
-- **Chain mode**: Stops at first failing step, reports which step failed
+- **stopReason "aborted"**: User abort (Ctrl+C) terminates and reaps the subprocess tree
+- **stopReason "deadline"**: Internal cutoff returns elapsed/deadline/checkpoint/resume metadata instead of reaching the outer tool timeout
+- **Chain mode**: Stops at first failing step, reports which step failed, and preserves completed earlier steps
+- **Duplicate prevention**: A cutoff with no new checkpoint or streamed evidence is not retried
 
 ## Limitations
 
@@ -173,3 +196,5 @@ Project agents override user agents with the same name when `agentScope: "both"`
 - Parallel model-visible output is capped at 50 KB per task; full results remain in tool details
 - Agents discovered fresh on each invocation (allows editing mid-session)
 - Parallel mode limited to 8 tasks, 4 concurrent
+- Automatic semantic pre-sharding requires an explicit numbered/checklist action list; indivisible prose is checkpointed and resumed as one shard
+- Checkpoints are best-effort child artifacts plus runtime-captured stream evidence; workspace side effects remain the source of truth after a cutoff

package/examples/extensions/subagent/adaptive-agent-runtime.test.ts

@@ -0,0 +1,234 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import type { Message } from "omk-ai";
+import { afterEach, describe, expect, it } from "vitest";
+import { type RunAttemptInput, runAdaptiveAgent } from "./adaptive-agent-runtime.ts";
+import { createExecutionBudget } from "./deadline-budget.ts";
+import { DeadlineProfileStore } from "./deadline-profile-store.ts";
+import { emptyUsage, type SingleResult, type SubagentAttemptResult } from "./subagent-runtime-types.ts";
+
+const cleanupPaths: string[] = [];
+
+function assistant(text: string): Message {
+	return { role: "assistant", content: [{ type: "text", text }] } as Message;
+}
+
+function attempt(input: RunAttemptInput, outcome: "completed" | "cutoff" | "failed", text = ""): SubagentAttemptResult {
+	const exitCode = outcome === "completed" ? 0 : outcome === "failed" ? 1 : 124;
+	const result: SingleResult = {
+		agent: "reviewer",
+		agentSource: "user",
+		task: input.logicalTask,
+		exitCode,
+		messages: text === "" ? [] : [assistant(text)],
+		stderr: "",
+		usage: emptyUsage(),
+		output: text,
+		model: "openai-codex/gpt-5.6",
+		...(outcome === "cutoff"
+			? { stopReason: "deadline", errorMessage: "attempt cutoff" }
+			: { stopReason: outcome === "failed" ? "error" : "end" }),
+	};
+	return {
+		result,
+		process: {
+			reason: outcome === "failed" ? "completed" : outcome,
+			elapsedMs: outcome === "completed" ? 10 : input.cutoffMs,
+			cleanup: { termSent: outcome === "cutoff", killSent: false, processGroup: true },
+		},
+	};
+}
+
+afterEach(async () => {
+	await Promise.all(cleanupPaths.splice(0).map((entry) => fs.promises.rm(entry, { recursive: true, force: true })));
+});
+
+describe("adaptive subagent execution", () => {
+	it("resumes only the unfinished shard from bounded checkpoint evidence", async () => {
+		const dir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "omk-adaptive-resume-"));
+		cleanupPaths.push(dir);
+		const calls: RunAttemptInput[] = [];
+		const outputs = ["completed boundary inspection", "finished remaining cleanup"];
+		const result = await runAdaptiveAgent({
+			agentName: "reviewer",
+			agentSource: "user",
+			logicalTask: "Review and fix the process boundary.",
+			model: "openai-codex/gpt-5.6",
+			budget: createExecutionBudget({
+				hardDeadlineMs: 5_000,
+				cleanupReserveMs: 100,
+				maxResumeAttempts: 1,
+				maxTaskShards: 3,
+			}),
+			pendingSequentialTasks: 1,
+			checkpointPrefix: path.join(dir, "checkpoint-"),
+			profileStore: new DeadlineProfileStore(path.join(dir, "profiles.json")),
+			policy: { fallbackAttemptMs: 1_000, minimumAttemptMs: 1, maxTokensPerShard: 6_000 },
+			runAttempt: async (input) => {
+				calls.push(input);
+				return attempt(input, calls.length === 1 ? "cutoff" : "completed", outputs[calls.length - 1]);
+			},
+		});
+
+		expect(calls).toHaveLength(2);
+		expect(calls[1]?.task).toContain("completed boundary inspection");
+		expect(calls[1]?.task).toContain("Do not repeat completed side effects");
+		expect(result.deadline).toMatchObject({ outcome: "completed", resumeCount: 1, completedShardIds: ["shard-1"] });
+		expect(result.output).toContain("completed boundary inspection");
+		expect(result.output).toContain("finished remaining cleanup");
+	});
+
+	it("learns the provider/model observed from output when the agent inherits its model", async () => {
+		const dir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "omk-adaptive-observed-model-"));
+		cleanupPaths.push(dir);
+		const store = new DeadlineProfileStore(path.join(dir, "profiles.json"));
+		const result = await runAdaptiveAgent({
+			agentName: "reviewer",
+			agentSource: "user",
+			logicalTask: "Review the process boundary.",
+			budget: createExecutionBudget({
+				hardDeadlineMs: 5_000,
+				cleanupReserveMs: 100,
+				maxResumeAttempts: 1,
+				maxTaskShards: 3,
+			}),
+			pendingSequentialTasks: 1,
+			checkpointPrefix: path.join(dir, "checkpoint-"),
+			profileStore: store,
+			policy: { fallbackAttemptMs: 1_000, minimumAttemptMs: 1, maxTokensPerShard: 6_000 },
+			runAttempt: async (input) => attempt(input, "completed", "review complete"),
+		});
+
+		expect(result.deadline).toMatchObject({ provider: "openai-codex", model: "gpt-5.6" });
+		expect(await store.profileFor("openai-codex", "gpt-5.6")).toMatchObject({ samples: 1, completions: 1 });
+	});
+
+	it("preserves process failures instead of labeling them as deadline cutoffs", async () => {
+		const dir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "omk-adaptive-failure-"));
+		cleanupPaths.push(dir);
+		const result = await runAdaptiveAgent({
+			agentName: "reviewer",
+			agentSource: "user",
+			logicalTask: "Run the failing fixture.",
+			budget: createExecutionBudget({
+				hardDeadlineMs: 5_000,
+				cleanupReserveMs: 100,
+				maxResumeAttempts: 1,
+				maxTaskShards: 3,
+			}),
+			pendingSequentialTasks: 1,
+			checkpointPrefix: path.join(dir, "checkpoint-"),
+			profileStore: new DeadlineProfileStore(path.join(dir, "profiles.json")),
+			policy: { fallbackAttemptMs: 1_000, minimumAttemptMs: 1, maxTokensPerShard: 6_000 },
+			runAttempt: async (input) => attempt(input, "failed", ""),
+		});
+
+		expect(result).toMatchObject({ exitCode: 1, stopReason: "error", errorMessage: "Subagent process failed" });
+		expect(result.deadline).toMatchObject({ outcome: "failed" });
+	});
+
+	it("does not retry a cutoff that produced no checkpoint or streamed progress", async () => {
+		const dir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "omk-adaptive-duplicate-"));
+		cleanupPaths.push(dir);
+		let calls = 0;
+		const result = await runAdaptiveAgent({
+			agentName: "reviewer",
+			agentSource: "user",
+			logicalTask: "Review the process boundary.",
+			model: "openai-codex/gpt-5.6",
+			budget: createExecutionBudget({
+				hardDeadlineMs: 5_000,
+				cleanupReserveMs: 100,
+				maxResumeAttempts: 2,
+				maxTaskShards: 3,
+			}),
+			pendingSequentialTasks: 1,
+			checkpointPrefix: path.join(dir, "checkpoint-"),
+			profileStore: new DeadlineProfileStore(path.join(dir, "profiles.json")),
+			policy: { fallbackAttemptMs: 1_000, minimumAttemptMs: 1, maxTokensPerShard: 6_000 },
+			runAttempt: async (input) => {
+				calls += 1;
+				return attempt(input, "cutoff");
+			},
+		});
+
+		expect(calls).toBe(1);
+		expect(result.deadline).toMatchObject({ outcome: "cutoff", resumeCount: 0, duplicateResumeBlocked: true });
+	});
+
+	it("never re-executes shards that already completed", async () => {
+		const dir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "omk-adaptive-shards-"));
+		cleanupPaths.push(dir);
+		const shardIds: string[] = [];
+		const task = [
+			"Upgrade runtime:",
+			"1. Inspect the process.",
+			"2. Add cleanup.",
+			"3. Implement metadata.",
+			"4. Run tests.",
+		].join("\n");
+		const result = await runAdaptiveAgent({
+			agentName: "worker",
+			agentSource: "user",
+			logicalTask: task,
+			model: "anthropic/claude-sonnet",
+			budget: createExecutionBudget({
+				hardDeadlineMs: 5_000,
+				cleanupReserveMs: 100,
+				maxResumeAttempts: 1,
+				maxTaskShards: 3,
+			}),
+			pendingSequentialTasks: 1,
+			checkpointPrefix: path.join(dir, "checkpoint-"),
+			profileStore: new DeadlineProfileStore(path.join(dir, "profiles.json")),
+			policy: { fallbackAttemptMs: 200, minimumAttemptMs: 1, maxTokensPerShard: 20 },
+			runAttempt: async (input) => {
+				shardIds.push(input.shardId);
+				return attempt(input, "completed", `done ${input.shardId}`);
+			},
+		});
+
+		expect(shardIds.length).toBeGreaterThan(1);
+		expect(new Set(shardIds).size).toBe(shardIds.length);
+		expect(result.deadline?.remainingShardIds).toEqual([]);
+	});
+
+	it("caps resume cost across the whole logical task rather than once per shard", async () => {
+		const dir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "omk-adaptive-cost-cap-"));
+		cleanupPaths.push(dir);
+		const shardIds: string[] = [];
+		const task = [
+			"Upgrade runtime:",
+			"1. Inspect the process.",
+			"2. Add cleanup.",
+			"3. Implement metadata.",
+			"4. Run tests.",
+		].join("\n");
+		const result = await runAdaptiveAgent({
+			agentName: "worker",
+			agentSource: "user",
+			logicalTask: task,
+			model: "openai-codex/gpt-5.6",
+			budget: createExecutionBudget({
+				hardDeadlineMs: 5_000,
+				cleanupReserveMs: 100,
+				maxResumeAttempts: 1,
+				maxTaskShards: 3,
+			}),
+			pendingSequentialTasks: 1,
+			checkpointPrefix: path.join(dir, "checkpoint-"),
+			profileStore: new DeadlineProfileStore(path.join(dir, "profiles.json")),
+			policy: { fallbackAttemptMs: 200, minimumAttemptMs: 1, maxTokensPerShard: 20 },
+			runAttempt: async (input) => {
+				shardIds.push(input.shardId);
+				const outcome = shardIds.length === 2 ? "completed" : "cutoff";
+				return attempt(input, outcome, `progress ${input.shardId} ${shardIds.length}`);
+			},
+		});
+
+		expect(shardIds).toEqual(["shard-1", "shard-1", "shard-2"]);
+		expect(result.deadline).toMatchObject({ resumeCount: 1, outcome: "cutoff" });
+		expect(result.deadline?.remainingShardIds).toContain("shard-2");
+	});
+});