open-multi-agent-kit 0.96.2 → 0.97.0

package/docs/compaction.md

@@ -95,7 +95,7 @@ By default, compaction uses the active session model. Set `compaction.model` to
 
 Every compaction and branch-summary LLM call flows through one choke point (`completeSummarization`):
 
-- **Retries**: transient stream drops (`terminated`, socket close, 5xx, DNS/transport errors) follow the configured `retry` settings (`enabled`, `maxRetries`, `baseDelayMs`) with exponential backoff instead of failing the whole operation on the first attempt. Quota/billing errors fail fast, and aborts are never retried. Retry progress is emitted as `summarization_retry_scheduled` / `summarization_retry_attempt_start` / `summarization_retry_finished` session events (surfaced in the TUI and RPC stream).
+- **Retries**: transient stream drops (`terminated`, socket close, 5xx, DNS/transport errors) follow the configured `retry` settings (`enabled`, `maxRetries`, `baseDelayMs`) with exponential backoff instead of failing the whole operation on the first attempt. Quota/billing exhaustion on the summarization model triggers one pass through the resilience failover chain ([provider-resilience.md](provider-resilience.md)); only when every candidate is also quota-blocked does the run fail with a non-retryable `compaction.quota_exhausted` termination cause whose guidance suggests `/model`, setting `compaction.model`, or waiting for reset. Aborts are never retried. Retry progress is emitted as `summarization_retry_scheduled` / `summarization_retry_attempt_start` / `summarization_retry_finished` session events (surfaced in the TUI and RPC stream).
 - **Isolation**: each summarization request runs with prompt caching disabled (`cacheRetention: "none"`) and a fresh routing `sessionId`, so summaries never write unusable provider cache entries or inherit interactive session affinity.
 
 ### How It Works

package/docs/extensions.md

@@ -505,15 +505,24 @@ The `systemPromptOptions` field gives extensions access to the same structured d
 
 Inside `before_agent_start`, `event.systemPrompt` and `ctx.getSystemPrompt()` both reflect the chained system prompt as of the current handler. Later `before_agent_start` handlers can still modify it again.
 
-#### agent_start / agent_end
+#### agent_start / agent_end / agent_settled
 
-Fired once per user prompt.
+`agent_start` and `agent_end` fire once per agent-loop attempt. When the session
+retries a transient provider failure, the prompt produces several `agent_end`
+events, so `agent_end` alone does not mark the end of the work.
+
+`agent_settled` fires once, immediately after the `agent_end` that no retry
+follows. Use it to release per-run state exactly once.
 
 ```typescript
 omk.on("agent_start", async (_event, ctx) => {});
 
 omk.on("agent_end", async (event, ctx) => {
-  // event.messages - messages from this prompt
+  // event.messages - messages from this attempt; a retry may still follow
+});
+
+omk.on("agent_settled", async (event, ctx) => {
+  // No retry follows. Safe to clear activity, finalize queues, or release locks.
 });
 ```
 

package/docs/index.md

@@ -1,6 +1,8 @@
 # OMK Documentation
 
-OMK is a provider-neutral coding agent with multi-agent orchestration, durable harness controls, replayable sessions, SDK/RPC integration, and evidence-backed verification. Its core stays small while extensions, skills, prompts, themes, and packages add workflows.
+OMK is a provider-neutral coding agent with multi-agent orchestration, durable harness controls, replayable sessions, SDK/RPC integration, and evidence-backed verification. Extensions, skills, prompts, themes, and packages add workflows without changing the run contract.
+
+OMK targets state-of-the-art quality as a CLI coding-agent harness. That target is not a claim of current leadership; see [Turn metrics and harness evaluation](metrics.md) for the qualification rules and current status.
 
 ## Quick start
 
@@ -59,6 +61,7 @@ For the full first-run flow, see [Quickstart](quickstart.md).
 
 - [SDK and Session Control](sdk.md) - embed omk, reuse policy helpers, or inspect stored sessions from scripts.
 - [Run Protocol and Durable Goals](run-protocol.md) - canonical run contracts and the durable-goal lifecycle.
+- [Turn metrics and harness evaluation](metrics.md) - cost, latency, tool reliability, capability baselines, and comparative-claim rules.
 - [RPC mode](rpc.md) - integrate over stdin/stdout JSONL.
 - [JSON event stream mode](json.md) - print mode with structured events.
 - [TUI components](tui.md) - build custom terminal UI for extensions.

package/docs/metrics.md

@@ -3,6 +3,76 @@
 OMK records one JSON line per agent turn so harness changes can be measured
 instead of guessed.
 
+## CLI harness SOTA target
+
+OMK targets state-of-the-art quality as a CLI coding-agent harness. **SOTA is
+not verified.** This is a product target, not a statement that the current
+release leads a benchmark or a named competitor cohort.
+
+The target covers the harness layer:
+
+| Dimension | Primary measure |
+| --- | --- |
+| Task success | solved tasks and pass rate |
+| Cost efficiency | model cost and tokens per solved task |
+| Latency | wall-clock p50/p95 per solved task |
+| Context efficiency | input, cache, compaction, and tool-output tokens per solved task |
+| Tool reliability | failure, retry, refusal, and intervention rates |
+| Orchestration | critical-path time, useful concurrency, and duplicate work |
+| Recovery | interrupted-run resume accuracy and repeated-run variance |
+| Safety | policy violations, unauthorized effects, and false-positive blocks |
+| Maintainability | complexity, module-size debt, and regression-gate health |
+
+No single feature count or self-score establishes leadership. OMK reports a
+dimension-specific result unless a preregistered aggregation defines an overall
+score.
+
+### Controlled comparison contract
+
+A comparative harness run MUST hold the **same model**, **same provider** and
+model configuration, **same task** and revision, **same budget**, equivalent
+tool permissions, and comparable container, hardware, region, and concurrency
+constant. The harness is the treatment variable. If a factor cannot be held
+constant, the report must label the result non-comparative.
+
+Every comparative report must include:
+
+- the date, harness versions, and **named comparison cohort**, with its inclusion rule frozen before execution;
+- immutable model, provider, container, environment, and configuration identities;
+- the task manifest, seeds, public prompt or sanitized prompt digest, budgets, run order, and stop policy;
+- sanitized per-task outcomes plus cost, token, latency, retry, and intervention data;
+- the confidence interval, significance threshold, minimum effect, and statistical test chosen before inspecting the result;
+- the exact commands and immutable manifests needed for **reproducible evidence**.
+
+Use paired A/B measurements. Randomize or interleave pair order when provider or
+machine drift can bias one side. Do not combine values produced by different
+methods, working directories, task revisions, or warm/cold conditions. A
+roadmap projection remains a hypothesis even when its inputs are measured.
+
+### Evidence privacy
+
+Benchmark evidence is private by default. Public artifacts may contain public
+or synthetic task identifiers, version and image digests, allowlisted runtime
+metadata, sanitized outcomes, and aggregate statistics. They must not contain
+credentials, private prompts, proprietary source, raw tool arguments or output,
+environment values, personal data, or absolute user paths.
+
+Keep restricted raw evidence local or in an access-controlled store with an
+explicit owner and retention period. Normalize paths, redact content, scan for
+secrets and PII, and obtain human approval before publication. Digests and
+public task manifests preserve reproducibility without disclosing restricted
+content.
+
+A public “SOTA,” “best,” “leading,” or “#1” claim requires a dated controlled
+comparison that places OMK on the relevant quality/cost/latency frontier without
+violating declared safety and regression floors. Until then, use “targets
+state-of-the-art quality.”
+
+[Harbor's Terminal-Bench runner](https://www.harborframework.com/docs/tutorials/running-terminal-bench)
+and the [SWE-bench containerized harness](https://www.swebench.com/SWE-bench/api/harness/)
+are reference evaluation surfaces. Their presence or a selected task list is
+infrastructure, not a benchmark result.
+
 This is separate from the two things that already existed:
 
 | Surface | Purpose |
@@ -83,5 +153,7 @@ node scripts/tb-mini-suite.mjs --seed 7    # a different fixed subset
 
 Selection is a pure function of (tasks directory, seed, size): the same inputs
 always produce the same task list, which is the whole point of using it as a
-regression gate. The scoring run itself requires Docker, `harbor`, and real
-model spend — it is deliberately not wired into `npm run check`.
+regression gate. Selection alone is not a capability result. The scoring run
+itself requires Docker, `harbor`, and real model spend — it is deliberately not
+wired into `npm run check`. Any comparison produced from it must follow the
+controlled comparison contract above.

package/docs/provider-resilience.md

@@ -6,6 +6,7 @@ OMK can recover an agent turn from provider failures that are unlikely to succee
 - billing-cycle or quota exhaustion
 - orphaned `tool_call_id` protocol errors
 - transient transport and server failures
+- gateway/upstream availability failures (5xx passthroughs, streams that end without a finish reason)
 
 This is availability behavior, not a safety bypass. Provider safety policy and the user's configured model access remain authoritative.
 
@@ -53,6 +54,8 @@ A content/safety stop gets at most one automatic retry, including a retry that s
 
 Recognized quota shapes include billing-cycle usage limits, `insufficient_quota`, exhausted balances, `GoUsageLimitError`, `FreeUsageLimitError`, and out-of-budget responses. These are classified as `provider.rate_limit`, even when a provider wraps them in HTTP 403.
 
+Gateway/upstream availability failures — "503 Upstream request failed", "Endpoint is unavailable", or a stream that ended without a finish reason — are classified as `provider.network`: transport problems that heal by retry or model switch, never by transcript sanitization.
+
 The default candidate order is:
 
 1. `kimi-coding/k3`
@@ -63,6 +66,14 @@ The default candidate order is:
 6. `modelstudio-maas/deepseek-v4-pro`
 7. `kimi-coding/kimi-for-coding`
 
+## Same-model route rotation
+
+The same underlying model is often served by several provider routes (for example `openrouter/stealth/ox-alpha` and `opencode-go/ox-alpha-free`). When the active route fails with an upstream availability error, OMK rotates to another authenticated route of the same model family before touching the cross-model failover chain, so the retry lands on a live endpoint instead of hammering the dead one.
+
+Routes already visited this turn and routes without configured authentication are excluded from rotation. Route rotation runs inside the normal retry budget; when no sibling route remains, the standard failover behavior applies.
+
+Compaction summarization reuses the same chain: when the summarization model hits quota/billing exhaustion, the configured failover candidates are tried once each before the run fails with a non-retryable `compaction.quota_exhausted` termination cause. See [Compaction](compaction.md).
+
 ## Retry and termination events
 
 Each provider attempt is journaled separately and emits `session_termination`. A retryable failure is attempt-level when an `auto_retry_start` event follows it. A recovered retry later emits a `completed` termination; an exhausted retry budget leaves the last provider failure as the final termination.

package/docs/usage.md

@@ -22,7 +22,7 @@ The editor can be replaced temporarily by built-in UI such as `/settings` or by
 | File reference | Type `@` to fuzzy-search project files |
 | Path completion | Press Tab to complete paths |
 | Multi-line input | Shift+Enter, or Ctrl+Enter on Windows Terminal |
-| Images | Paste with Ctrl+V, Alt+V on Windows, or drag into the terminal |
+| Images | Paste with Ctrl+V (Alt+V on Windows) or drag into the terminal; pastes attach as preview chips above the editor and send with your next prompt |
 | Skill/bash launcher | `!` opens skill completion; `!skill:name prompt` invokes a skill; `!omk <role-or-request>` routes through OMK role hubs |
 | Shell command | `! command` runs and sends output to the model |
 | Hidden shell command | `!! command` runs without sending output to the model |

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

@@ -1,12 +1,12 @@
 {
   "name": "omk-extension-custom-provider-anthropic",
-  "version": "0.96.2",
+  "version": "0.97.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "omk-extension-custom-provider-anthropic",
-      "version": "0.96.2",
+      "version": "0.97.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.96.2",
+	"version": "0.97.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.96.2",
+	"version": "0.97.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.96.2",
+	"version": "0.97.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "omk-extension-gondolin",
-			"version": "0.96.2",
+			"version": "0.97.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.96.2",
+	"version": "0.97.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.96.2",
+	"version": "0.97.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "omk-extension-sandbox",
-			"version": "0.96.2",
+			"version": "0.97.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.96.2",
+	"version": "0.97.0",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "omk-extension-with-deps",
-  "version": "0.96.2",
+  "version": "0.97.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "omk-extension-with-deps",
-      "version": "0.96.2",
+      "version": "0.97.0",
       "dependencies": {
         "ms": "2.1.3"
       },

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "omk-extension-with-deps",
 	"private": true,
-	"version": "0.96.2",
+	"version": "0.97.0",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
 	"name": "open-multi-agent-kit",
-	"version": "0.96.2",
+	"version": "0.97.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "open-multi-agent-kit",
-			"version": "0.96.2",
+			"version": "0.97.0",
 			"license": "MIT",
 			"dependencies": {
-				"omk-agent-core": "^0.96.2",
-				"omk-ai": "^0.96.2",
-				"omk-tui": "^0.96.2",
+				"omk-agent-core": "^0.97.0",
+				"omk-ai": "^0.97.0",
+				"omk-tui": "^0.97.0",
 				"@silvia-odwyer/photon-node": "0.3.4",
 				"canonicalize": "4.0.0",
 				"chalk": "5.6.2",
@@ -27,8 +27,8 @@
 				"typebox": "1.3.11",
 				"undici": "8.10.0",
 				"yaml": "2.9.0",
-				"omk-adaptorch-wpl": "^0.96.2",
-				"omk-protocol": "^0.96.2"
+				"omk-adaptorch-wpl": "^0.97.0",
+				"omk-protocol": "^0.97.0"
 			},
 			"optionalDependencies": {
 				"@mariozechner/clipboard": "0.3.9"
@@ -1285,19 +1285,19 @@
 			}
 		},
 		"node_modules/omk-adaptorch-wpl": {
-			"version": "0.96.2",
-			"resolved": "https://registry.npmjs.org/omk-adaptorch-wpl/-/omk-adaptorch-wpl-0.96.2.tgz",
+			"version": "0.97.0",
+			"resolved": "https://registry.npmjs.org/omk-adaptorch-wpl/-/omk-adaptorch-wpl-0.97.0.tgz",
 			"license": "MIT",
 			"engines": {
 				"node": ">=22.19.0"
 			}
 		},
 		"node_modules/omk-agent-core": {
-			"version": "0.96.2",
-			"resolved": "https://registry.npmjs.org/omk-agent-core/-/omk-agent-core-0.96.2.tgz",
+			"version": "0.97.0",
+			"resolved": "https://registry.npmjs.org/omk-agent-core/-/omk-agent-core-0.97.0.tgz",
 			"license": "MIT",
 			"dependencies": {
-				"omk-ai": "^0.96.2",
+				"omk-ai": "^0.97.0",
 				"ignore": "7.0.6",
 				"typebox": "1.3.11",
 				"yaml": "2.9.0"
@@ -1307,8 +1307,8 @@
 			}
 		},
 		"node_modules/omk-ai": {
-			"version": "0.96.2",
-			"resolved": "https://registry.npmjs.org/omk-ai/-/omk-ai-0.96.2.tgz",
+			"version": "0.97.0",
+			"resolved": "https://registry.npmjs.org/omk-ai/-/omk-ai-0.97.0.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"@anthropic-ai/sdk": "0.91.1",
@@ -1330,16 +1330,16 @@
 			}
 		},
 		"node_modules/omk-protocol": {
-			"version": "0.96.2",
-			"resolved": "https://registry.npmjs.org/omk-protocol/-/omk-protocol-0.96.2.tgz",
+			"version": "0.97.0",
+			"resolved": "https://registry.npmjs.org/omk-protocol/-/omk-protocol-0.97.0.tgz",
 			"license": "MIT",
 			"engines": {
 				"node": ">=22.19.0"
 			}
 		},
 		"node_modules/omk-tui": {
-			"version": "0.96.2",
-			"resolved": "https://registry.npmjs.org/omk-tui/-/omk-tui-0.96.2.tgz",
+			"version": "0.97.0",
+			"resolved": "https://registry.npmjs.org/omk-tui/-/omk-tui-0.97.0.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"get-east-asian-width": "1.6.0",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "open-multi-agent-kit",
-	"version": "0.96.2",
+	"version": "0.97.0",
 	"description": "OMK (Open Multi-Agent Kit) coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"omkConfig": {
@@ -32,7 +32,7 @@
 	],
 	"scripts": {
 		"clean": "shx rm -rf dist",
-		"build": "node ./scripts/link-workspace-deps.mjs && tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js && npm run copy-assets",
+		"build": "node ./scripts/link-workspace-deps.mjs && tsgo -p tsconfig.build.json && node ../../scripts/prune-dist-orphans.mjs . && shx chmod +x dist/cli.js && npm run copy-assets",
 		"build:binary": "npm --prefix ../tui run build && npm --prefix ../ai run build && npm --prefix ../agent run build && npm run build && bun build --compile ./dist/bun/cli.js ./src/utils/image-resize-worker.ts --outfile dist/omk && npm run copy-binary-assets",
 		"copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/",
 		"copy-binary-assets": "shx cp package.json dist/ && shx cp README.md dist/ && shx cp CHANGELOG.md dist/ && shx mkdir -p dist/theme && shx cp src/modes/interactive/theme/*.json dist/theme/ && shx mkdir -p dist/assets && shx cp src/modes/interactive/assets/*.png dist/assets/ && shx mkdir -p dist/export-html/vendor && shx cp src/core/export-html/template.html dist/export-html/ && shx cp src/core/export-html/vendor/*.js dist/export-html/vendor/ && shx cp -r docs dist/ && shx cp -r examples dist/ && shx cp ../../node_modules/@silvia-odwyer/photon-node/photon_rs_bg.wasm dist/",
@@ -42,9 +42,9 @@
 		"link-workspace-deps": "node ./scripts/link-workspace-deps.mjs"
 	},
 	"dependencies": {
-		"omk-agent-core": "^0.96.2",
-		"omk-ai": "^0.96.2",
-		"omk-tui": "^0.96.2",
+		"omk-agent-core": "^0.97.0",
+		"omk-ai": "^0.97.0",
+		"omk-tui": "^0.97.0",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"canonicalize": "4.0.0",
 		"chalk": "5.6.2",
@@ -60,8 +60,8 @@
 		"typebox": "1.3.11",
 		"undici": "8.10.0",
 		"yaml": "2.9.0",
-		"omk-adaptorch-wpl": "^0.96.2",
-		"omk-protocol": "^0.96.2"
+		"omk-adaptorch-wpl": "^0.97.0",
+		"omk-protocol": "^0.97.0"
 	},
 	"overrides": {
 		"rimraf": "6.1.2",

package/dist/core/tools/omp-pure-seams.d.ts

@@ -1,41 +0,0 @@
-/** Error categories raised by the OMP pure-seam loader. */
-export type OmpSeamsErrorCode = "DISABLED" | "VENDOR_NOT_FOUND" | "INVALID_SEAM";
-/** Typed error thrown by {@link loadOmpPureSeams}. */
-export declare class OmpSeamsError extends Error {
-    readonly code: OmpSeamsErrorCode;
-    constructor(code: OmpSeamsErrorCode, message: string);
-}
-/** The validated set of pure oh-my-pi seams (data/proposal-only). */
-export interface OmpPureSeams {
-    planRead(input: unknown): unknown;
-    presentRead(plan: unknown, file: unknown): unknown;
-    planSearch(input: unknown): unknown;
-    presentSearch(plan: unknown, matches: unknown, sourceDigests?: unknown): unknown;
-    parseHashlineProposal(text: string): unknown;
-    hashProposalLine(text: string): Promise<string>;
-    hashProposalSource(text: string): Promise<string>;
-}
-/**
- * Returns true unless the seams feature is explicitly disabled
- * (OMK_OMP_SEAMS === "0"). Enabled by default per ADR-OMP-009.
- * Reads `process.env` when no record is supplied.
- */
-export declare function isOmpSeamsEnabled(env?: Record<string, string | undefined>): boolean;
-/**
- * Walks up from `startDir` (inclusive) looking for a `vendor/oh-my-pi`
- * directory that contains the pure read seam marker file. Returns the absolute
- * vendor directory path, or `undefined` when none is found within the level cap.
- */
-export declare function resolveOmpVendorDir(startDir: string): string | undefined;
-/**
- * Loads and validates the three pure seam modules from the vendored oh-my-pi
- * tree and returns a frozen {@link OmpPureSeams} record. Throws
- * {@link OmpSeamsError} with code DISABLED when the feature is off,
- * VENDOR_NOT_FOUND when the vendor tree cannot be located, or INVALID_SEAM when
- * any expected export is missing or not a function.
- */
-export declare function loadOmpPureSeams(options?: {
-    vendorDir?: string;
-    env?: Record<string, string | undefined>;
-}): Promise<OmpPureSeams>;
-//# sourceMappingURL=omp-pure-seams.d.ts.map

package/dist/core/tools/omp-pure-seams.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"omp-pure-seams.d.ts","sourceRoot":"","sources":["../../../src/core/tools/omp-pure-seams.ts"],"names":[],"mappings":"AAiBA,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAEjF,sDAAsD;AACtD,qBAAa,aAAc,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAEjC,YAAY,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAInD;CACD;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAClC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACnD,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IACpC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACjF,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAGnF;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWxE;AAwBD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC,GAAG,OAAO,CAAC,YAAY,CAAC,CAqExB","sourcesContent":["/**\n * Flag-gated loader for the vendored oh-my-pi \"pure\" read/search/hashline seams.\n *\n * These seams are pure data/proposal-only functions (planning + presentation +\n * hashline parsing). They do NOT touch edit/write/file-mutation paths. The\n * loader is enabled by default and opts out via OMK_OMP_SEAMS=0 (ADR-OMP-009);\n * when disabled it throws DISABLED and tool behavior falls back to the\n * pre-seam implementation byte-identically.\n *\n * The file is erasable TypeScript: no `enum`, no parameter properties, no `as`,\n * no non-null assertions, no `any` annotations, and no runtime dependencies\n * beyond the Node.js standard library.\n */\nimport { existsSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, resolve } from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\n\n/** Error categories raised by the OMP pure-seam loader. */\nexport type OmpSeamsErrorCode = \"DISABLED\" | \"VENDOR_NOT_FOUND\" | \"INVALID_SEAM\";\n\n/** Typed error thrown by {@link loadOmpPureSeams}. */\nexport class OmpSeamsError extends Error {\n\treadonly code: OmpSeamsErrorCode;\n\n\tconstructor(code: OmpSeamsErrorCode, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"OmpSeamsError\";\n\t\tthis.code = code;\n\t}\n}\n\n/** The validated set of pure oh-my-pi seams (data/proposal-only). */\nexport interface OmpPureSeams {\n\tplanRead(input: unknown): unknown;\n\tpresentRead(plan: unknown, file: unknown): unknown;\n\tplanSearch(input: unknown): unknown;\n\tpresentSearch(plan: unknown, matches: unknown, sourceDigests?: unknown): unknown;\n\tparseHashlineProposal(text: string): unknown;\n\thashProposalLine(text: string): Promise<string>;\n\thashProposalSource(text: string): Promise<string>;\n}\n\n/**\n * Returns true unless the seams feature is explicitly disabled\n * (OMK_OMP_SEAMS === \"0\"). Enabled by default per ADR-OMP-009.\n * Reads `process.env` when no record is supplied.\n */\nexport function isOmpSeamsEnabled(env?: Record<string, string | undefined>): boolean {\n\tconst source: Record<string, string | undefined> = env ?? process.env;\n\treturn source.OMK_OMP_SEAMS !== \"0\";\n}\n\nconst VENDOR_SEGMENT = join(\"vendor\", \"oh-my-pi\");\nconst VENDOR_MARKER = join(VENDOR_SEGMENT, \"packages\", \"coding-agent\", \"src\", \"pure\", \"read.ts\");\nconst MAX_WALK_UP_LEVELS = 8;\n\n/**\n * Walks up from `startDir` (inclusive) looking for a `vendor/oh-my-pi`\n * directory that contains the pure read seam marker file. Returns the absolute\n * vendor directory path, or `undefined` when none is found within the level cap.\n */\nexport function resolveOmpVendorDir(startDir: string): string | undefined {\n\tlet dir = isAbsolute(startDir) ? startDir : resolve(startDir);\n\tfor (let level = 0; level <= MAX_WALK_UP_LEVELS; level += 1) {\n\t\tif (existsSync(join(dir, VENDOR_MARKER))) {\n\t\t\treturn join(dir, VENDOR_SEGMENT);\n\t\t}\n\t\tconst parent = dirname(dir);\n\t\tif (parent === dir) break;\n\t\tdir = parent;\n\t}\n\treturn undefined;\n}\n\n// --- internal narrowing helpers (no `as`; type guards carry the signatures) ---\n\ntype SeamFn = (...args: never[]) => unknown;\ntype SeamAsyncStrFn = (...args: never[]) => Promise<string>;\n\nfunction isSeamFn(member: unknown): member is SeamFn {\n\treturn typeof member === \"function\";\n}\n\nfunction isSeamAsyncStrFn(member: unknown): member is SeamAsyncStrFn {\n\treturn typeof member === \"function\";\n}\n\nfunction expectFn<T extends SeamFn>(member: unknown, guard: (m: unknown) => m is T, name: string): T {\n\tif (guard(member)) return member;\n\tthrow new OmpSeamsError(\"INVALID_SEAM\", `OMP seam missing or non-function: ${name}`);\n}\n\nconst READ_SEAM = join(\"packages\", \"coding-agent\", \"src\", \"pure\", \"read.ts\");\nconst SEARCH_SEAM = join(\"packages\", \"coding-agent\", \"src\", \"pure\", \"search.ts\");\nconst PROPOSAL_SEAM = join(\"packages\", \"hashline\", \"src\", \"proposal.ts\");\n\n/**\n * Loads and validates the three pure seam modules from the vendored oh-my-pi\n * tree and returns a frozen {@link OmpPureSeams} record. Throws\n * {@link OmpSeamsError} with code DISABLED when the feature is off,\n * VENDOR_NOT_FOUND when the vendor tree cannot be located, or INVALID_SEAM when\n * any expected export is missing or not a function.\n */\nexport async function loadOmpPureSeams(options?: {\n\tvendorDir?: string;\n\tenv?: Record<string, string | undefined>;\n}): Promise<OmpPureSeams> {\n\tconst env: Record<string, string | undefined> = options?.env ?? process.env;\n\tif (!isOmpSeamsEnabled(env)) {\n\t\tthrow new OmpSeamsError(\n\t\t\t\"DISABLED\",\n\t\t\t\"OMP pure seams are disabled (OMK_OMP_SEAMS=0; unset or set to any other value to enable).\",\n\t\t);\n\t}\n\n\tlet vendorDir: string | undefined = options?.vendorDir ?? env.OMK_OMP_VENDOR_DIR;\n\tif (!vendorDir) {\n\t\tconst moduleUrl = new URL(\".\", import.meta.url);\n\t\tif (moduleUrl.protocol !== \"file:\") {\n\t\t\tthrow new OmpSeamsError(\n\t\t\t\t\"VENDOR_NOT_FOUND\",\n\t\t\t\t\"OMP vendor dir was not provided and the module is not a file URL.\",\n\t\t\t);\n\t\t}\n\t\tconst found = resolveOmpVendorDir(fileURLToPath(moduleUrl));\n\t\tif (!found) {\n\t\t\tthrow new OmpSeamsError(\n\t\t\t\t\"VENDOR_NOT_FOUND\",\n\t\t\t\t\"OMP vendor dir not found by walking up from the module directory.\",\n\t\t\t);\n\t\t}\n\t\tvendorDir = found;\n\t}\n\tif (!existsSync(vendorDir)) {\n\t\tthrow new OmpSeamsError(\"VENDOR_NOT_FOUND\", `OMP vendor dir does not exist: ${vendorDir}`);\n\t}\n\n\tconst readUrl = pathToFileURL(join(vendorDir, READ_SEAM)).href;\n\tconst searchUrl = pathToFileURL(join(vendorDir, SEARCH_SEAM)).href;\n\tconst proposalUrl = pathToFileURL(join(vendorDir, PROPOSAL_SEAM)).href;\n\n\tconst readMod = await import(readUrl);\n\tconst searchMod = await import(searchUrl);\n\tconst proposalMod = await import(proposalUrl);\n\n\t// Validate every expected member up front so the INVALID_SEAM error lists\n\t// ALL missing/non-function exports, not just the first one encountered.\n\tconst expected: ReadonlyArray<readonly [unknown, string]> = [\n\t\t[readMod.planRead, \"planRead\"],\n\t\t[readMod.presentRead, \"presentRead\"],\n\t\t[searchMod.planSearch, \"planSearch\"],\n\t\t[searchMod.presentSearch, \"presentSearch\"],\n\t\t[proposalMod.parseHashlineProposal, \"parseHashlineProposal\"],\n\t\t[proposalMod.hashProposalLine, \"hashProposalLine\"],\n\t\t[proposalMod.hashProposalSource, \"hashProposalSource\"],\n\t];\n\tconst missing: string[] = [];\n\tfor (const [member, name] of expected) {\n\t\tif (typeof member !== \"function\") missing.push(name);\n\t}\n\tif (missing.length > 0) {\n\t\tthrow new OmpSeamsError(\"INVALID_SEAM\", `OMP seams missing or non-function: ${missing.join(\", \")}`);\n\t}\n\n\tconst rec: OmpPureSeams = {\n\t\tplanRead: expectFn(readMod.planRead, isSeamFn, \"planRead\"),\n\t\tpresentRead: expectFn(readMod.presentRead, isSeamFn, \"presentRead\"),\n\t\tplanSearch: expectFn(searchMod.planSearch, isSeamFn, \"planSearch\"),\n\t\tpresentSearch: expectFn(searchMod.presentSearch, isSeamFn, \"presentSearch\"),\n\t\tparseHashlineProposal: expectFn(proposalMod.parseHashlineProposal, isSeamFn, \"parseHashlineProposal\"),\n\t\thashProposalLine: expectFn(proposalMod.hashProposalLine, isSeamAsyncStrFn, \"hashProposalLine\"),\n\t\thashProposalSource: expectFn(proposalMod.hashProposalSource, isSeamAsyncStrFn, \"hashProposalSource\"),\n\t};\n\tObject.freeze(rec);\n\treturn rec;\n}\n"]}