harnery 0.39.0 → 0.41.0

package/dist/commands/webview.js

@@ -0,0 +1,94 @@
+import { resolve } from "node:path";
+import { commandPaceGate } from "../lib/pace/index.js";
+import { parseWebViewTypeStep, parseWebViewViewport, runWebView, WebViewUnavailableError, } from "../lib/webview/index.js";
+export function registerWebviewCommand(program, emit, binName) {
+    program
+        .command("webview <url>")
+        .description("Lightweight headless page probe through Bun.WebView (experimental, Bun 1.4+). " +
+        `Fresh ephemeral browser per call; use ${binName} browse for login, cookies, HAR, and QA.`)
+        .option("--backend <engine>", "Browser engine: auto | chrome | webkit", "auto")
+        .option("--user-agent <ua>", "Chrome user agent: shared store by default; auto refreshes, native disables")
+        .option("--viewport <WxH>", "Viewport in CSS pixels", "1280x800")
+        .option("--profile <dir>", "Persist cookies and local storage in this directory (default is ephemeral)")
+        .option("--chrome-path <path>", "Chrome-family executable; implies the Chrome backend")
+        .option("--browser-arg <flag>", "Extra Chrome launch flag (repeatable)", collect, [])
+        .option("--timeout <ms>", "Navigation and selector timeout in milliseconds", "30000")
+        .option("--wait-for <css>", "Wait for a CSS selector after navigation")
+        .option("--type <css=>text>", "Focus a selector and insert text (repeatable; runs before clicks)", collect, [])
+        .option("--click <css>", "Scroll to and click a CSS selector (repeatable)", collect, [])
+        .option("--press <key>", "Press a key in the currently focused element (repeatable)", collect, [])
+        .option("--evaluate <expression>", "Evaluate a JavaScript expression after actions")
+        .option("--settle <ms>", "Extra delay after actions before capture", "0")
+        .option("--screenshot <path>", "Save a viewport PNG (Bun.WebView does not provide full-page capture)")
+        .option("--html", "Print the final document HTML instead of body text")
+        .option("--json", "Print the full result envelope")
+        .option("--no-pace", "Skip the human-pace gap (3 to 9 s) between page loads of the same site for this run. " +
+        "HARNERY_PACE=off disables it machine-wide; local and private hosts never wait.")
+        .action(async (url, opts) => {
+        try {
+            await runWebview(url, opts, emit);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            emit.error({
+                code: err instanceof WebViewUnavailableError ? err.code : "webview_error",
+                message,
+            });
+            process.exit(1);
+        }
+    });
+}
+async function runWebview(url, opts, emit) {
+    if (!isBackend(opts.backend)) {
+        throw new Error(`Invalid backend "${opts.backend}". Expected auto, chrome, or webkit.`);
+    }
+    const backend = opts.backend === "auto" && opts.chromePath ? "chrome" : opts.backend;
+    const result = await runWebView(url, {
+        backend,
+        viewport: parseWebViewViewport(opts.viewport),
+        profileDir: opts.profile ? resolve(opts.profile) : undefined,
+        chromePath: opts.chromePath ? resolve(opts.chromePath) : undefined,
+        browserArgs: opts.browserArg,
+        timeoutMs: parseNonNegativeInteger(opts.timeout, "--timeout", false),
+        waitFor: opts.waitFor,
+        typeSteps: opts.type.map(parseWebViewTypeStep),
+        clicks: opts.click,
+        presses: opts.press,
+        evaluate: opts.evaluate,
+        settleMs: parseNonNegativeInteger(opts.settle, "--settle", true),
+        screenshotPath: opts.screenshot ? resolve(opts.screenshot) : undefined,
+        captureHtml: opts.html === true,
+        pace: commandPaceGate(opts.pace !== false, (message) => emit.log(message, "info")),
+        userAgent: opts.userAgent,
+    });
+    if (opts.json) {
+        emit.data(result);
+    }
+    else if (opts.html) {
+        emit.text(result.html?.endsWith("\n") ? result.html : `${result.html ?? ""}\n`);
+    }
+    else if (opts.evaluate !== undefined) {
+        const value = typeof result.evaluation === "string"
+            ? result.evaluation
+            : JSON.stringify(result.evaluation, null, 2);
+        emit.text(`${value ?? "undefined"}\n`);
+    }
+    else {
+        emit.text(result.text.endsWith("\n") ? result.text : `${result.text}\n`);
+    }
+}
+function collect(value, previous) {
+    return [...previous, value];
+}
+function isBackend(value) {
+    return value === "auto" || value === "chrome" || value === "webkit";
+}
+function parseNonNegativeInteger(value, flag, allowZero) {
+    if (!/^\d+$/.test(value))
+        throw new Error(`${flag} expects an integer, got "${value}".`);
+    const parsed = Number.parseInt(value, 10);
+    if ((!allowZero && parsed < 1) || (allowZero && parsed < 0)) {
+        throw new Error(`${flag} must be ${allowZero ? "zero or greater" : "greater than zero"}.`);
+    }
+    return parsed;
+}

package/dist/core/adapter.d.ts

@@ -1,5 +1,54 @@
 /** First-party harness adapters supported by Harnery's canonical V3 ledger. */
-export type Adapter = "claude-code" | "cursor" | "codex";
+export type Adapter = "claude-code" | "cursor" | "codex" | "opencode";
 /** Canonical producer classes used by V3 provenance. */
 export type EventSource = "agent-hooks" | "agent-coord" | "user" | "system";
+/**
+ * Runtime census of the workflow adapters. Adding a member to `Adapter`
+ * without listing it here is a compile error (see `adaptersComplete`), so a
+ * new adapter can never slip past the shared normalizer.
+ */
+export declare const ADAPTERS: readonly ["claude-code", "cursor", "codex", "opencode"];
+/** Every adapter falls back to this identity when a platform value carries no usable evidence. */
+export declare const DEFAULT_ADAPTER: Adapter;
+/** Why a platform value could not be normalized to a known adapter. */
+export type AdapterFallbackReason = "missing" | "unknown";
+export interface AdapterFallback {
+    /** The raw value that was normalized. */
+    value: unknown;
+    /** `missing` for null, undefined, or an empty string; `unknown` for anything else. */
+    reason: AdapterFallbackReason;
+    /** The adapter that was substituted. */
+    fallback: string;
+    /** Caller-supplied label naming the code path, for the diagnostic line. */
+    context?: string;
+}
+export interface AdapterFallbackOptions {
+    /** Names the caller in the diagnostic line, e.g. `"claim-conflict"`. */
+    context?: string;
+    /**
+     * Receives every fallback. The default writes one stderr line per unknown
+     * value; a missing value is a pre-heartbeat state rather than a
+     * misattribution, so it is passed here but not printed.
+     */
+    onFallback?: (fallback: AdapterFallback) => void;
+}
+/**
+ * Generic membership normalizer shared by every adapter census. Returns the
+ * matching id or `null`; it never substitutes a default.
+ */
+export declare function normalizeAdapterId<T extends string>(value: unknown, census: readonly T[]): T | null;
+/**
+ * Normalize with an explicit, reported fallback. Every caller that must end up
+ * with *some* adapter routes through here so the substitution is visible.
+ */
+export declare function resolveAdapterId<T extends string>(value: unknown, census: readonly T[], fallback: T, options?: AdapterFallbackOptions): T;
+/** Default fallback sink: one stderr line for an unrecognized platform value. */
+export declare function reportAdapterFallback(fallback: AdapterFallback): void;
+/** Strict workflow-adapter normalizer: a known id or `null`. */
+export declare function normalizeAdapter(value: unknown): Adapter | null;
+/**
+ * Heartbeat `platform` (or any adapter-shaped string) to a workflow adapter,
+ * substituting `DEFAULT_ADAPTER` and reporting the substitution.
+ */
+export declare function adapterFromPlatform(value: unknown, options?: AdapterFallbackOptions): Adapter;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/core/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/core/adapter.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzD,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/core/adapter.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtE,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,QAAQ,yDAKkB,CAAC;AAMxC,kGAAkG;AAClG,eAAO,MAAM,eAAe,EAAE,OAAuB,CAAC;AAEtD,uEAAuE;AACvE,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,sFAAsF;IACtF,MAAM,EAAE,qBAAqB,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,CAAC,GAAG,IAAI,CAGV;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,QAAQ,EAAE,CAAC,EACX,OAAO,GAAE,sBAA2B,GACnC,CAAC,CAYH;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAMrE;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAE/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAE7F"}

package/dist/core/adapter.js

@@ -1 +1,59 @@
-export {};
+/**
+ * Runtime census of the workflow adapters. Adding a member to `Adapter`
+ * without listing it here is a compile error (see `adaptersComplete`), so a
+ * new adapter can never slip past the shared normalizer.
+ */
+export const ADAPTERS = [
+    "claude-code",
+    "cursor",
+    "codex",
+    "opencode",
+];
+const adaptersComplete = true;
+void adaptersComplete;
+/** Every adapter falls back to this identity when a platform value carries no usable evidence. */
+export const DEFAULT_ADAPTER = "claude-code";
+/**
+ * Generic membership normalizer shared by every adapter census. Returns the
+ * matching id or `null`; it never substitutes a default.
+ */
+export function normalizeAdapterId(value, census) {
+    if (typeof value !== "string")
+        return null;
+    return census.includes(value) ? value : null;
+}
+/**
+ * Normalize with an explicit, reported fallback. Every caller that must end up
+ * with *some* adapter routes through here so the substitution is visible.
+ */
+export function resolveAdapterId(value, census, fallback, options = {}) {
+    const normalized = normalizeAdapterId(value, census);
+    if (normalized !== null)
+        return normalized;
+    const reason = value === undefined || value === null || value === "" ? "missing" : "unknown";
+    (options.onFallback ?? reportAdapterFallback)({
+        value,
+        reason,
+        fallback,
+        context: options.context,
+    });
+    return fallback;
+}
+/** Default fallback sink: one stderr line for an unrecognized platform value. */
+export function reportAdapterFallback(fallback) {
+    if (fallback.reason !== "unknown")
+        return;
+    const where = fallback.context ? ` (${fallback.context})` : "";
+    process.stderr.write(`harnery: unknown adapter platform ${JSON.stringify(fallback.value)}${where}; treating it as ${fallback.fallback}\n`);
+}
+/** Strict workflow-adapter normalizer: a known id or `null`. */
+export function normalizeAdapter(value) {
+    return normalizeAdapterId(value, ADAPTERS);
+}
+/**
+ * Heartbeat `platform` (or any adapter-shaped string) to a workflow adapter,
+ * substituting `DEFAULT_ADAPTER` and reporting the substitution.
+ */
+export function adapterFromPlatform(value, options) {
+    return resolveAdapterId(value, ADAPTERS, DEFAULT_ADAPTER, options);
+}

package/dist/core/adapters/attestation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attestation.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/attestation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/E,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;uBAEuB;AACvB,eAAO,MAAM,qBAAqB,2FAMxB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB;kFAC8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IACvB;kDAC8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB;;8DAE0D;IAC1D,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB;6DACyD;IACzD,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACtE,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,uBAA4B,GAAG,MAAM,CAI1E;AAED;wDACwD;AACxD,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAM7D;AAMD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,CAAC,GAChD,kBAAkB,CAEpB;AASD;;aAEa;AACb,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,EAC1B,IAAI,GAAE,uBAA4B,GACjC,MAAM,CAmBR;AAED;;kEAEkE;AAClE,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,EAClB,IAAI,GAAE,uBAA4B,GACjC,kBAAkB,GAAG,IAAI,CAc3B;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,SAAS,GAClB,kBAAkB,GAAG,IAAI,CAe3B;AAED;uBACuB;AACvB,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,GAAG,IAAI,EACjC,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,OAAO,EAAE,cAAc,EACvB,gBAAgB,CAAC,EAAE,OAAO,GACzB,MAAM,IAAI,kBAAkB,CAK9B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,uBAA4B,GAAG,kBAAkB,EAAE,CAczF;AAED;;;oDAGoD;AACpD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,IAAI,EAAE,uBAAuB,GAAG;IAC9B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAChD;wCACoC;IACpC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GACA;IACD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC,cAAc,CAAC,CAAA;KAAE,CAAC,CAAC;IAClG,mBAAmB,EAAE,MAAM,CACzB,MAAM,EACN;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CACvE,CAAC;CACH,CAoCA"}
+{"version":3,"file":"attestation.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/attestation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAcH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/E,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;uBAEuB;AACvB,eAAO,MAAM,qBAAqB,2FAMxB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB;kFAC8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IACvB;kDAC8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB;;8DAE0D;IAC1D,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB;6DACyD;IACzD,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACtE,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,uBAA4B,GAAG,MAAM,CAI1E;AAED;wDACwD;AACxD,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAM7D;AAMD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,CAAC,GAChD,kBAAkB,CAEpB;AASD;;aAEa;AACb,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,EAC1B,IAAI,GAAE,uBAA4B,GACjC,MAAM,CAmBR;AAED;;kEAEkE;AAClE,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,EAClB,IAAI,GAAE,uBAA4B,GACjC,kBAAkB,GAAG,IAAI,CAc3B;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,SAAS,GAClB,kBAAkB,GAAG,IAAI,CAe3B;AAED;uBACuB;AACvB,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,GAAG,IAAI,EACjC,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,OAAO,EAAE,cAAc,EACvB,gBAAgB,CAAC,EAAE,OAAO,GACzB,MAAM,IAAI,kBAAkB,CAK9B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,uBAA4B,GAAG,kBAAkB,EAAE,CAczF;AAED;;;oDAGoD;AACpD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,IAAI,EAAE,uBAAuB,GAAG;IAC9B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAChD;wCACoC;IACpC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GACA;IACD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC,cAAc,CAAC,CAAA;KAAE,CAAC,CAAC;IAClG,mBAAmB,EAAE,MAAM,CACzB,MAAM,EACN;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CACvE,CAAC;CACH,CAoCA"}

package/dist/core/adapters/attestation.js

@@ -14,6 +14,7 @@
 import { mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
 import { resolve } from "node:path";
 import { monorepoRoot } from "../agents/coord-client.js";
+import { stateDirMode, stateFileMode } from "../storage/modes.js";
 import { stableDigest } from "../workflow/durable-record.js";
 export const ATTESTATION_SCHEMA_VERSION = 2;
 /** Dimensions one minimal live turn can honestly establish. Everything else
@@ -58,12 +59,12 @@ function attestationPath(adapter, opts) {
  * create. */
 export function writeAttestation(record, opts = {}) {
     const path = attestationPath(record.adapter, opts);
-    mkdirSync(attestationsDir(opts), { recursive: true, mode: 0o700 });
+    mkdirSync(attestationsDir(opts), { recursive: true, mode: stateDirMode() });
     const temporary = `${path}.tmp-${process.pid}`;
     try {
         writeFileSync(temporary, `${JSON.stringify(record, null, 2)}\n`, {
             encoding: "utf8",
-            mode: 0o600,
+            mode: stateFileMode(),
         });
         renameSync(temporary, path);
     }

package/dist/core/adapters/profiles.d.ts

@@ -55,14 +55,31 @@ export declare const BUILTIN_ADAPTER_PROFILES: {
         readonly modelFamily: "multi";
         readonly effortValues: readonly [];
         readonly verified: {
-            readonly date: "2026-08-18";
-            readonly version: "2026.08.11-e8db854";
+            readonly date: "2026-09-20";
+            readonly version: "2026.09.18-9a7762b";
+        };
+        readonly capabilities: AdapterCapabilities;
+    };
+    readonly opencode: {
+        readonly id: "opencode";
+        readonly displayName: "OpenCode";
+        readonly binary: "opencode";
+        readonly installHint: "curl -fsSL https://opencode.ai/install | bash";
+        readonly loginHint: "opencode auth login";
+        readonly apiKeyEnv: "OPENCODE_API_KEY";
+        readonly integrationMode: "cli-subprocess";
+        readonly authModel: "own-auth";
+        readonly modelFamily: "multi";
+        readonly effortValues: readonly [];
+        readonly verified: {
+            readonly date: "2026-09-20";
+            readonly version: "opencode v2.0.11";
         };
         readonly capabilities: AdapterCapabilities;
     };
 };
 export type BuiltinAdapterId = keyof typeof BUILTIN_ADAPTER_PROFILES;
-export declare const BUILTIN_ADAPTER_IDS: readonly ("claude-code" | "cursor" | "codex")[];
+export declare const BUILTIN_ADAPTER_IDS: readonly ("claude-code" | "cursor" | "codex" | "opencode")[];
 export declare function isBuiltinAdapter(id: string): id is BuiltinAdapterId;
 export declare function builtinAdapterProfile(id: string): AdapterProfile | undefined;
 export declare function validateAdapterEffort(id: string, effort: string | undefined): void;

package/dist/core/adapters/profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAmB,MAAM,YAAY,CAAC;AAgCvF;gFACgF;AAChF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyFc,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,wBAAwB,CAAC;AAErE,eAAO,MAAM,mBAAmB,iDAE/B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,gBAAgB,CAEnE;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE5E;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUlF"}
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAmB,MAAM,YAAY,CAAC;AAgCvF;gFACgF;AAChF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkIc,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,wBAAwB,CAAC;AAErE,eAAO,MAAM,mBAAmB,8DAE/B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,gBAAgB,CAEnE;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE5E;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUlF"}

package/dist/core/adapters/profiles.js

@@ -92,17 +92,48 @@ export const BUILTIN_ADAPTER_PROFILES = {
         authModel: "own-auth",
         modelFamily: "multi",
         effortValues: [],
-        verified: { date: "2026-08-18", version: "2026.08.11-e8db854" },
+        verified: { date: "2026-09-20", version: "2026.09.18-9a7762b" },
         capabilities: capabilities({
             effortSelection: unsupported("Cursor embeds effort in some parameterized model ids; Harnery does not rewrite model ids."),
             maxTurns: unsupported("cursor-agent exposes no turn-ceiling flag."),
             sessionId: supported("Read from the JSON result envelope."),
             cost: unsupported("The JSON result envelope carries no cost."),
+            // Still unknown on 2026-09-20 against cursor-agent 2026.09.18: the live
+            // `cursor_composer_context_percent` reader serves IDE hook sessions from
+            // the composer `state.vscdb`, and headless `cursor-agent` children (this
+            // workflow adapter) leave no composer row and no usage in the JSON result.
             contextTelemetry: unknown("No stable Cursor context-usage payload has been certified."),
             preCompactionSignal: supported("Cursor preCompact is wired to a durable checkpoint."),
             postCompactionSignal: unsupported("Harnery does not wire an unverified Cursor postCompact hook."),
         }),
     },
+    opencode: {
+        id: "opencode",
+        displayName: "OpenCode",
+        binary: "opencode",
+        installHint: "curl -fsSL https://opencode.ai/install | bash",
+        loginHint: "opencode auth login",
+        apiKeyEnv: "OPENCODE_API_KEY",
+        integrationMode: "cli-subprocess",
+        authModel: "own-auth",
+        modelFamily: "multi",
+        // Model reasoning is selected through the `provider/model#variant` id;
+        // OpenCode exposes no separate effort dial for Harnery to map.
+        effortValues: [],
+        verified: { date: "2026-09-20", version: "opencode v2.0.11" },
+        capabilities: capabilities({
+            effortSelection: unsupported("OpenCode selects reasoning through the model id variant; there is no separate effort flag."),
+            maxTurns: unsupported("`opencode run` exposes no turn-ceiling flag."),
+            sessionId: supported("Read from the `sessionID` on every `--format json` NDJSON line."),
+            cost: unsupported("`opencode run --format json` streams parts without a final cost; cost lives in `session export`."),
+            // Tool evidence is delivered on the event axis by the Harnery OpenCode
+            // plugin, not by the final-result workflow spawn, which retains no tool
+            // events (as with Codex and Cursor).
+            contextTelemetry: unknown("OpenCode stores context in SQLite; no context-window bridge is certified yet."),
+            preCompactionSignal: supported('OpenCode session.hook("compaction") is bridged to a durable checkpoint.'),
+            postCompactionSignal: unsupported("No post-compact hook is wired; OpenCode post-compaction recovery is not yet certified."),
+        }),
+    },
 };
 export const BUILTIN_ADAPTER_IDS = Object.freeze(Object.keys(BUILTIN_ADAPTER_PROFILES));
 export function isBuiltinAdapter(id) {

package/dist/core/adapters/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/registry.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAqErD;+EAC+E;AAC/E,qBAAa,eAAe;;gBAGd,QAAQ,GAAE,QAAQ,CAAC,OAAO,CAAM;IAI5C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAYhC,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS;IAIvC,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO;IAU/B,IAAI,IAAI,OAAO,EAAE;IAIjB,GAAG,IAAI,SAAS,EAAE;IAIlB,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CAGhD;AAED,wBAAgB,4BAA4B,IAAI,eAAe,CAE9D"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/registry.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAqGrD;+EAC+E;AAC/E,qBAAa,eAAe;;gBAGd,QAAQ,GAAE,QAAQ,CAAC,OAAO,CAAM;IAI5C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAYhC,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS;IAIvC,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO;IAU/B,IAAI,IAAI,OAAO,EAAE;IAIjB,GAAG,IAAI,SAAS,EAAE;IAIlB,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CAGhD;AAED,wBAAgB,4BAA4B,IAAI,eAAe,CAE9D"}

package/dist/core/adapters/registry.js

@@ -1,6 +1,7 @@
 import { buildClaudeInvocation, claudeCodeSpawner, normalizeClaudeResult, } from "../workflow/spawn-claude.js";
 import { buildCodexInvocation, codexSpawner, normalizeCodexResult, } from "../workflow/spawn-codex.js";
 import { buildCursorInvocation, cursorSpawner, normalizeCursorResult, } from "../workflow/spawn-cursor.js";
+import { buildOpenCodeInvocation, normalizeOpenCodeResult, openCodeSpawner, } from "../workflow/spawn-opencode.js";
 import { BUILTIN_ADAPTER_IDS, BUILTIN_ADAPTER_PROFILES, } from "./profiles.js";
 const BUILTIN_ADAPTERS = {
     "claude-code": {
@@ -67,6 +68,38 @@ const BUILTIN_ADAPTERS = {
             },
         },
     },
+    opencode: {
+        profile: BUILTIN_ADAPTER_PROFILES.opencode,
+        spawn: openCodeSpawner,
+        buildInvocation: buildOpenCodeInvocation,
+        normalizeResult: normalizeOpenCodeResult,
+        fixture: {
+            // `opencode run --format json` streams NDJSON: a step-start line then one
+            // or more text parts, each carrying the same sessionID.
+            raw: {
+                stdout: [
+                    JSON.stringify({
+                        type: "step_start",
+                        sessionID: "opencode-bench-session",
+                        part: { type: "step-start" },
+                    }),
+                    JSON.stringify({
+                        type: "text",
+                        sessionID: "opencode-bench-session",
+                        part: { type: "text", text: "HARNERY_BENCH_OK" },
+                    }),
+                ].join("\n"),
+                stderr: "",
+                exitCode: 0,
+                durationMs: 11,
+            },
+            expected: {
+                ok: true,
+                text: "HARNERY_BENCH_OK",
+                sessionId: "opencode-bench-session",
+            },
+        },
+    },
 };
 /** Mutable registry for embedders, initialized empty unless adapters are
  * provided. Duplicate ids fail loud instead of silently replacing behavior. */

package/dist/core/agents/canonical-emit.d.ts

@@ -9,7 +9,7 @@
  * a 15-second safety budget; loaded-host checks normally finish in a few
  * seconds and record the observation before the parent command exits.
  */
-import type { EventAdapterIdV3 } from "../events/v3/adapter-id.js";
+import { type EventAdapterIdV3 } from "../events/v3/adapter-id.js";
 import type { LiveCoordinationObservationV3 } from "../events/v3/live-observation.js";
 import type { Heartbeat } from "./state/heartbeat-reader.js";
 export type EventV3EmitObservation = LiveCoordinationObservationV3 | {

package/dist/core/agents/canonical-emit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-emit.d.ts","sourceRoot":"","sources":["../../../src/core/agents/canonical-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAGtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAC9B,6BAA6B,GAC7B;IACE,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,WAAW,EAAE,sBAAsB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CA4C5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAK/E;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,mBAAmB,GAAG,YAAY,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3E,QAAQ,EAAE,MAAM,GACf,MAAM,CAQR"}
+{"version":3,"file":"canonical-emit.d.ts","sourceRoot":"","sources":["../../../src/core/agents/canonical-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,KAAK,gBAAgB,EAAgC,MAAM,4BAA4B,CAAC;AACjG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAGtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAC9B,6BAA6B,GAC7B;IACE,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,WAAW,EAAE,sBAAsB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CA4C5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAE/E;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,mBAAmB,GAAG,YAAY,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3E,QAAQ,EAAE,MAAM,GACf,MAAM,CAQR"}

package/dist/core/agents/canonical-emit.js

@@ -10,6 +10,7 @@
  * seconds and record the observation before the parent command exits.
  */
 import { spawnSync } from "node:child_process";
+import { eventAdapterIdV3FromPlatform } from "../events/v3/adapter-id.js";
 import { coordBinPath } from "./coord-bin.js";
 import { resolveCoordRoot } from "./coord-client.js";
 /**
@@ -74,13 +75,7 @@ export function emitEventV3(input) {
  * Normalize the heartbeat's `platform` field to the canonical Adapter type.
  */
 export function normalizeAdapter(platform) {
-    if (platform === "cursor")
-        return "cursor";
-    if (platform === "codex")
-        return "codex";
-    if (platform === "openclaw")
-        return "openclaw";
-    return "claude-code";
+    return eventAdapterIdV3FromPlatform(platform, { context: "canonical-emit" });
 }
 /** Producer joins use the private native session ID, never its V3 fingerprint. */
 export function nativeSessionIdentity(row, fallback) {

package/dist/core/agents/cli.js

@@ -12,6 +12,8 @@ import { appendFile, mkdir } from "node:fs/promises";
 import { hostname } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { coordEnv } from "../../lib/env.js";
+import { normalizeAdapter, adapterFromPlatform as sharedAdapterFromPlatform } from "../adapter.js";
+import { resolveBinName } from "../config.js";
 import { closeProcessLoggers, legacyLogFields, processLogger } from "../storage/logger.js";
 import { acquireNoClobberLease } from "../workflow/workspaces/leases.js";
 function sharedDiagnostic(root, event, fields, error) {
@@ -152,13 +154,6 @@ async function handleProject(root, rest) {
     process.stdout.write(`${JSON.stringify(report, null, rest.includes("--json") ? 2 : 0)}\n`);
     return view.authority_safe ? 0 : 1;
 }
-function adapterFromPlatform(platform) {
-    if (platform === "cursor")
-        return "cursor";
-    if (platform === "codex")
-        return "codex";
-    return "claude-code";
-}
 const coordinationRetryCell = new Int32Array(new SharedArrayBuffer(4));
 const COORDINATION_RETRY_ATTEMPTS = 240;
 const COORDINATION_RETRY_DELAY_MS = 25;
@@ -237,7 +232,10 @@ async function handleStateAction(root, action, rest) {
                 // same durable, idempotent pool path used by normal SessionStart.
                 if (task && before && humanFacing && !before.name?.trim()) {
                     const { assignName } = await import("./state/names.js");
-                    const name = assignName(root, owner, "session");
+                    const { coordFreshnessSeconds } = await import("../config.js");
+                    const name = assignName(root, owner, "session", {
+                        freshnessSecs: coordFreshnessSeconds(root),
+                    });
                     before = writer.setAssignedNameCache(root, owner, name, "session");
                     if (!before) {
                         process.stderr.write(`agent-coord set-task: could not restore assigned name for ${owner}\n`);
@@ -253,7 +251,7 @@ async function handleStateAction(root, action, rest) {
                                 coordRoot: root,
                                 owner,
                                 nativeSessionId: before?.session_id ?? owner,
-                                adapter: adapterFromPlatform(before?.platform),
+                                adapter: sharedAdapterFromPlatform(before?.platform, { context: "agent-coord" }),
                                 task,
                             });
                             break;
@@ -273,12 +271,21 @@ async function handleStateAction(root, action, rest) {
                         currentHumanFacing &&
                         (!hb.name?.trim() || /^Agent unknown - /.test(hb.suggested_session_name ?? ""))) {
                         const { assignName } = await import("./state/names.js");
-                        const name = hb.name?.trim() || assignName(root, owner, "session");
+                        const { coordFreshnessSeconds } = await import("../config.js");
+                        const name = hb.name?.trim() ||
+                            assignName(root, owner, "session", { freshnessSecs: coordFreshnessSeconds(root) });
                         hb = writer.setAssignedNameCache(root, owner, name, "session");
                     }
                 }
                 catch (error) {
-                    process.stderr.write(`agent-coord set-task: V3 authority refused (${error instanceof Error ? error.message : String(error)})\n`);
+                    const detail = error instanceof Error ? error.message : String(error);
+                    // A missing heartbeat here means the session's generation ended
+                    // while its process lived on. Name the reopen command (ADR 0088);
+                    // set-task is usually the first thing such a session runs.
+                    const hint = detail.includes("heartbeat_missing:")
+                        ? `; run \`${resolveBinName(root)} agents lifecycle active\` to open a fresh generation for this continuing session`
+                        : "";
+                    process.stderr.write(`agent-coord set-task: V3 authority refused (${detail})${hint}\n`);
                     return 1;
                 }
                 if (!hb) {
@@ -308,7 +315,7 @@ async function handleStateAction(root, action, rest) {
                     coordRoot: root,
                     owner,
                     nativeSessionId: before?.session_id ?? owner,
-                    adapter: adapterFromPlatform(before?.platform),
+                    adapter: sharedAdapterFromPlatform(before?.platform, { context: "agent-coord" }),
                     operation: "released",
                     path,
                     access: "write",
@@ -366,11 +373,11 @@ async function handleStateAction(root, action, rest) {
                         coordRoot: root,
                         owner,
                         nativeSessionId: sessionId ?? owner,
-                        adapter: adapterFromPlatform(adapter),
+                        adapter: sharedAdapterFromPlatform(adapter, { context: "agent-coord" }),
                     });
                 }
                 const { repairLiveCoordinationHeartbeat } = await import("./state/live-coordination-writer.js");
-                hb = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, adapterFromPlatform(adapter), model);
+                hb = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, sharedAdapterFromPlatform(adapter, { context: "agent-coord" }), model);
             }
             catch (error) {
                 process.stderr.write(`agent-coord repair-coordination-cache: V3 route refused (${error instanceof Error ? error.message : String(error)})\n`);
@@ -392,7 +399,7 @@ async function handleStateAction(root, action, rest) {
                 liveCoordinationWriteModeV3(root);
                 const { liveInstanceIdV3 } = await import("../events/v3/live-routing.js");
                 const { repairLiveCoordinationHeartbeat } = await import("./state/live-coordination-writer.js");
-                const heartbeat = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, adapterFromPlatform(adapter));
+                const heartbeat = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, sharedAdapterFromPlatform(adapter, { context: "agent-coord" }));
                 if (!heartbeat) {
                     throw new Error("authoritative coordination cache could not be materialized");
                 }
@@ -403,7 +410,7 @@ async function handleStateAction(root, action, rest) {
                     observed_current_state_digest: coordinationAuthorityStateDigestV3(heartbeat),
                     approval_record_id: approvalRecordId,
                 });
-                const repaired = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, adapterFromPlatform(adapter));
+                const repaired = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, sharedAdapterFromPlatform(adapter, { context: "agent-coord" }));
                 process.stdout.write(`${JSON.stringify({
                     instance_id: owner,
                     receipt,
@@ -557,7 +564,11 @@ async function handleAssignName(root, rest) {
         process.stderr.write(`agent-coord assign-name: invalid kind ${kindArg}\n`);
         return 2;
     }
-    const name = assignName(root, owner, kindArg, forkedFrom ? { forkedFrom } : undefined);
+    const { coordFreshnessSeconds } = await import("../config.js");
+    const name = assignName(root, owner, kindArg, {
+        freshnessSecs: coordFreshnessSeconds(root),
+        ...(forkedFrom ? { forkedFrom } : {}),
+    });
     process.stdout.write(`${JSON.stringify({
         instance_id: owner,
         name,
@@ -768,7 +779,7 @@ async function handleEmitEvent(root, rest) {
     const eventType = args.type;
     const instanceId = args.owner;
     const sessionId = args.session;
-    const adapter = args.adapter;
+    const adapter = normalizeAdapter(args.adapter) ?? undefined;
     const dataJson = args["data-stdin"] === "true" ? await readStdin() : "";
     if (!eventType || !instanceId || !sessionId || !adapter || !dataJson) {
         process.stderr.write("agent-coord emit-event --type <V3_TYPE> --owner <id> --session <id> --adapter <h> --data-stdin\n");
@@ -936,7 +947,7 @@ async function handleGitHook(fallbackRoot, rest) {
                             owner,
                             subject: hit.instance_id,
                             nativeSessionId: hit.session_id ?? owner,
-                            adapter: adapterFromPlatform(hit.platform),
+                            adapter: sharedAdapterFromPlatform(hit.platform, { context: "agent-coord" }),
                             operation: "released",
                             path,
                             access: "write",

package/dist/core/agents/coord-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coord-client.d.ts","sourceRoot":"","sources":["../../../src/core/agents/coord-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAWhE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI5E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOhF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CA+B7E;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAeD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAiED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2CxD;AAgCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;CAC5F,CAsEA;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsB5C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAClD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,iBAAiB,GAAG,MAAM,CAAC;CAC/C,CAyBA;AAqBD,sFAAsF;AACtF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAEtD;AAuCD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAmB9C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOpE"}
+{"version":3,"file":"coord-client.d.ts","sourceRoot":"","sources":["../../../src/core/agents/coord-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAWhE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI5E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOhF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CA+B7E;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAeD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAiED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2CxD;AAgCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;CAC5F,CAsEA;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsB5C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAClD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,iBAAiB,GAAG,MAAM,CAAC;CAC/C,CAyBA;AAyBD,sFAAsF;AACtF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAEtD;AAuCD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAmB9C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOpE"}

package/dist/core/agents/coord-client.js

@@ -506,6 +506,10 @@ const SESSION_ID_ENV_VARS = [
     "CURSOR_CONVERSATION_ID",
     "CODEX_SESSION_ID",
     "CODEX_THREAD_ID",
+    // OpenCode exports no session id into the tool shell; the Harnery OpenCode
+    // plugin stamps this via shell.hook("create.before") so a coord CLI run as a
+    // Bash tool recovers its identity.
+    "OPENCODE_SESSION_ID",
 ];
 /** Read normalized candidates from the first non-empty adapter session-id env var. */
 /**
@@ -607,9 +611,10 @@ export function resolveSingleActiveOwner(root) {
 }
 function adapterCandidatesFromEnv() {
     const value = process.env.HARNERY_AGENT_COORD_PLATFORM?.trim();
-    if (value === "claude-code" || value === "codex" || value === "cursor")
+    if (value === "claude-code" || value === "codex" || value === "cursor" || value === "opencode") {
         return [value];
-    return ["claude-code", "codex", "cursor"];
+    }
+    return ["claude-code", "codex", "cursor", "opencode"];
 }
 function nativeOwnerForV3Instance(root, instanceId) {
     const activeDir = resolve(root, ".harnery", "active");

package/dist/core/agents/rules/claim-conflict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claim-conflict.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/claim-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAgBlD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,aAAa,CA4GjF"}
+{"version":3,"file":"claim-conflict.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/claim-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAgBlD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,aAAa,CA4GjF"}