harnery 0.38.0 → 0.40.0

package/src/core/events/v3/producers/command-recorder.ts

@@ -15,10 +15,10 @@ import {
 } from "node:fs";
 import { hostname } from "node:os";
 import { join, resolve } from "node:path";
-import type { Adapter } from "../../../adapter.ts";
 import { fsyncParentDirectory } from "../../../workflow/durable-record.ts";
 import { acquireNoClobberLease } from "../../../workflow/workspaces/leases.ts";
 import { selectCommandParentSpan } from "../../span-parent.ts";
+import { EVENT_ADAPTER_IDS_V3, type EventAdapterIdV3 } from "../adapter-id.ts";
 import { buildEventV3 } from "../builder.ts";
 import { normalizeNativeIdV3 } from "../canonical.ts";
 import { markObservedClockRegressionV3 } from "../clock-order.ts";
@@ -59,7 +59,7 @@ interface PendingCommandEventV3 {
 interface CommandRecorderStateV3 {
   format: typeof COMMAND_STATE_FORMAT;
   format_version: typeof COMMAND_STATE_VERSION;
-  adapter: Adapter;
+  adapter: EventAdapterIdV3;
   instance_id: `inst_${string}`;
   session_id: `sid_${string}`;
   generation_id: `gen_${string}`;
@@ -86,7 +86,7 @@ export interface RecordCommandSignalV3Input {
   mode: EventV3WriteMode;
   signal: CommandSignalV3;
   observation: CommandObservationV3;
-  adapter: Adapter;
+  adapter: EventAdapterIdV3;
   instance_id: `inst_${string}`;
   producer_id: `prd_${string}`;
   build_id: `build_${string}`;
@@ -576,7 +576,7 @@ function readCommandState(path: string): CommandRecorderStateV3 {
     Object.keys(state).some((key) => !allowed.has(key)) ||
     state.format !== COMMAND_STATE_FORMAT ||
     state.format_version !== COMMAND_STATE_VERSION ||
-    !["claude-code", "codex", "cursor"].includes(state.adapter) ||
+    !(EVENT_ADAPTER_IDS_V3 as readonly string[]).includes(state.adapter) ||
     !/^inst_[a-zA-Z0-9._-]{1,128}$/.test(state.instance_id) ||
     !/^sid_[a-f0-9]{64}$/.test(state.session_id) ||
     !/^gen_[0-9a-f-]{36}$/.test(state.generation_id) ||

package/src/core/events/v3/producers/coordination-recorder.ts

@@ -15,9 +15,9 @@ import {
 } from "node:fs";
 import { hostname } from "node:os";
 import { basename, join, resolve } from "node:path";
-import type { Adapter } from "../../../adapter.ts";
 import { fsyncParentDirectory } from "../../../workflow/durable-record.ts";
 import { acquireNoClobberLease } from "../../../workflow/workspaces/leases.ts";
+import { EVENT_ADAPTER_IDS_V3, type EventAdapterIdV3 } from "../adapter-id.ts";
 import {
   type AuthorityReceiptV3,
   type AuthorityReconcilerV3,
@@ -60,7 +60,7 @@ interface PendingCoordinationTransactionV3 {
 interface CoordinationRecorderStateV3 {
   format: typeof COORDINATION_STATE_FORMAT;
   format_version: typeof COORDINATION_STATE_VERSION;
-  adapter: Adapter;
+  adapter: EventAdapterIdV3;
   actor_instance_id: `inst_${string}`;
   session_id: `sid_${string}`;
   generation_id: `gen_${string}`;
@@ -92,7 +92,7 @@ export interface RecordCoordinationAuthorityV3Input<
   mode: EventV3WriteMode;
   signal: S;
   observation: CoordinationObservationBySignalV3[S];
-  adapter: Adapter;
+  adapter: EventAdapterIdV3;
   native_actor_session_id: string;
   actor_instance_id: `inst_${string}`;
   subject_instance_id: `inst_${string}`;
@@ -562,7 +562,7 @@ function readCoordinationState(path: string): CoordinationRecorderStateV3 {
     Object.keys(state).some((key) => !allowed.has(key)) ||
     state.format !== COORDINATION_STATE_FORMAT ||
     state.format_version !== COORDINATION_STATE_VERSION ||
-    !["claude-code", "codex", "cursor"].includes(state.adapter) ||
+    !(EVENT_ADAPTER_IDS_V3 as readonly string[]).includes(state.adapter) ||
     !/^inst_[a-zA-Z0-9._-]{1,128}$/.test(state.actor_instance_id) ||
     !/^sid_[a-f0-9]{64}$/.test(state.session_id) ||
     !/^gen_[0-9a-f-]{36}$/.test(state.generation_id) ||

package/src/core/events/v3/producers/hook-base.ts

@@ -1,9 +1,10 @@
-import type { Adapter } from "../../../adapter.ts";
 import type { ParsedPayload } from "../../../hooks/adapter/parse.ts";
+import type { EventAdapterIdV3 } from "../adapter-id.ts";
 import { buildEventV3Base } from "../base-builder.ts";
 import type { EventV3Base, RuntimeAttestationV3Base } from "../base-contract.ts";
 import { type FingerprintContextV3, fingerprintV3, normalizeNativeIdV3 } from "../canonical.ts";
 import {
+  adapterDurationSupportV3,
   adapterSignalSupportV3,
   adapterTurnWaitCountSupportV3,
   type CursorExecutionModeV3,
@@ -33,7 +34,7 @@ export type HookSignalV3Base =
 
 export interface HookProducerContextV3Base {
   coordRoot: string;
-  adapter: Adapter;
+  adapter: EventAdapterIdV3;
   adapterVersion?: string;
   harnessVersion?: string;
   root_id: `root_${string}`;
@@ -191,7 +192,13 @@ export function normalizeHookEventV3Base(
               attestation: "native",
               confidence: "exact",
             }
-          : { state: "expected_but_missing", capability: "model_identity", reason: "not_reported" },
+          : adapterSignalSupportV3(context.adapter, "model_identity") === "unsupported"
+            ? { state: "unsupported", capability: "model_identity" }
+            : {
+                state: "expected_but_missing",
+                capability: "model_identity",
+                reason: "not_reported",
+              },
         tuning: tuningObservation(context, payload),
         telemetry: context.runtime_telemetry ?? initialTelemetryCapabilities(context),
         capability_profile: context.capability_profile,
@@ -263,11 +270,10 @@ export function normalizeHookEventV3Base(
         links: { caused_by: causedBy },
         payload: {
           outcome: signal === "stop" ? "succeeded" : "failed",
-          duration_ms: measuredOrMissing(
-            context.duration_ms,
-            "turn_duration",
-            "turn_timing_not_supplied",
-          ),
+          duration_ms:
+            adapterDurationSupportV3(context.adapter, "turn_duration") === "unsupported"
+              ? { state: "unsupported", capability: "turn_duration" }
+              : measuredOrMissing(context.duration_ms, "turn_duration", "turn_timing_not_supplied"),
           tool_call_count:
             context.tool_call_count_support === "unsupported"
               ? { state: "unsupported", capability: "turn_tool_call_count" }
@@ -338,11 +344,10 @@ export function normalizeHookEventV3Base(
         payload: {
           tool: { namespace: context.adapter, name: safeToolName(payload.tool_name) },
           outcome: signal === "post-tool-use" ? "succeeded" : "failed",
-          duration_ms: measuredOrMissing(
-            context.duration_ms,
-            "tool_duration",
-            "span_timing_not_supplied",
-          ),
+          duration_ms:
+            adapterDurationSupportV3(context.adapter, "tool_duration") === "unsupported"
+              ? { state: "unsupported", capability: "tool_duration" }
+              : measuredOrMissing(context.duration_ms, "tool_duration", "span_timing_not_supplied"),
           result: {
             storage: "omitted",
             media_type:
@@ -447,7 +452,7 @@ export function normalizeHookEventV3Base(
 }
 
 function turnRitualObservation(
-  adapter: Adapter,
+  adapter: EventAdapterIdV3,
   evidence: TurnRitualEvidenceV3,
 ): TurnRitualObservationV3 {
   if (adapter === "cursor") {
@@ -655,10 +660,10 @@ function observedIdentity(id: string, version: string | undefined) {
   };
 }
 
-function providerFor(adapter: Adapter): string {
+function providerFor(adapter: EventAdapterIdV3): string {
   if (adapter === "claude-code") return "anthropic";
   if (adapter === "codex") return "openai";
-  return "cursor";
+  return adapter;
 }
 
 function safeModelId(value: string): string {

package/src/core/events/v3/producers/hook.ts

@@ -1,5 +1,6 @@
 import type { ParsedPayload } from "../../../hooks/adapter/parse.ts";
 import type { EventV3Base } from "../base-contract.ts";
+import { adapterDurationSupportV3, adapterSignalSupportV3 } from "../capabilities.ts";
 import type { EventOfTypeV3, EventTypeV3, SpanSummaryV3 } from "../contract.ts";
 import { EVENT_V3_CONTRACT_MAJOR, EVENT_V3_CONTRACT_NAME } from "../contract.ts";
 import { EVENT_V3_SCHEMA_DIGEST } from "../generated.ts";
@@ -95,9 +96,22 @@ function terminalPayload(
   context: HookProducerContextV3,
 ): object {
   if (!TERMINAL_EVENT_TYPES.has(eventType)) return basePayload;
-  const span = context.terminal_span as SpanSummaryV3;
+  const sourceSpan = context.terminal_span as SpanSummaryV3;
+  const durationCapability =
+    eventType === "turn.completed"
+      ? "turn_duration"
+      : eventType === "tool.completed"
+        ? "tool_duration"
+        : undefined;
+  const duration =
+    durationCapability &&
+    adapterDurationSupportV3(context.adapter, durationCapability) === "unsupported"
+      ? { state: "unsupported" as const, capability: durationCapability }
+      : sourceSpan.duration_ms;
+  const span =
+    duration === sourceSpan.duration_ms ? sourceSpan : { ...sourceSpan, duration_ms: duration };
   if (eventType === "tool.completed") {
-    return { ...basePayload, duration_ms: span.duration_ms, span };
+    return { ...basePayload, duration_ms: duration, span };
   }
   if (eventType !== "turn.completed") return { ...basePayload, span };
 
@@ -110,10 +124,13 @@ function terminalPayload(
     );
   return {
     ...basePayload,
-    duration_ms: span.duration_ms,
+    duration_ms: duration,
     span,
     usage: telemetry.usage,
     inference: telemetry.inference,
-    harness: harnessObservationV3(context.harness_timing ?? emptyHarnessTimingV3()),
+    harness:
+      adapterSignalSupportV3(context.adapter, "harness_timing") === "unsupported"
+        ? { state: "unsupported", capability: "harness_timing" }
+        : harnessObservationV3(context.harness_timing ?? emptyHarnessTimingV3()),
   };
 }

package/src/core/events/v3/producers/intake.ts

@@ -13,9 +13,9 @@ import {
   writeFileSync,
 } from "node:fs";
 import { dirname, join, resolve } from "node:path";
-import type { Adapter } from "../../../adapter.ts";
 import type { ParsedPayload } from "../../../hooks/adapter/parse.ts";
 import { fsyncParentDirectory } from "../../../workflow/durable-record.ts";
+import { EVENT_ADAPTER_IDS_V3, type EventAdapterIdV3 } from "../adapter-id.ts";
 import type { EventV3WriteMode } from "../control.ts";
 import { EVENT_V3_LEDGER_RELATIVE_ROOT } from "../writer.ts";
 import {
@@ -90,7 +90,7 @@ export interface HookIntakeRecordV3 {
   mode: EventV3WriteMode;
   signal: HookSignalV3;
   payload: ParsedPayload;
-  adapter: Adapter;
+  adapter: EventAdapterIdV3;
   instance_id: `inst_${string}`;
   producer_id: `prd_${string}`;
   build_id: `build_${string}`;
@@ -113,7 +113,7 @@ export interface HookIntakeRecordV3 {
 }
 
 export interface HookIntakeGroupV3 {
-  adapter: Adapter;
+  adapter: EventAdapterIdV3;
   session_hash: `hid_${string}`;
   directory: string;
 }
@@ -135,7 +135,7 @@ function diagnosticsRoot(coordRoot: string): string {
 
 export function hookIntakeGroupDirV3(
   coordRoot: string,
-  adapter: Adapter,
+  adapter: EventAdapterIdV3,
   sessionHash: `hid_${string}`,
 ): string {
   return join(intakeRoot(coordRoot), adapter, sessionHash);
@@ -187,7 +187,7 @@ export function listHookIntakeGroupsV3(coordRoot: string): HookIntakeGroupV3[] {
   const root = intakeRoot(coordRoot);
   if (!existsSync(root)) return [];
   const groups: HookIntakeGroupV3[] = [];
-  for (const adapter of ["claude-code", "codex", "cursor"] as const) {
+  for (const adapter of EVENT_ADAPTER_IDS_V3) {
     const adapterDir = join(root, adapter);
     if (!existsSync(adapterDir)) continue;
     const metadata = lstatSync(adapterDir);
@@ -254,7 +254,7 @@ function readIntakeRecord(path: string): HookIntakeRecordV3 | undefined {
     !HOOK_SIGNALS.has(record.signal) ||
     !record.payload ||
     typeof record.payload !== "object" ||
-    !["claude-code", "codex", "cursor"].includes(record.adapter) ||
+    !(EVENT_ADAPTER_IDS_V3 as readonly string[]).includes(record.adapter) ||
     !/^inst_[a-zA-Z0-9._-]{1,128}$/.test(record.instance_id) ||
     !/^prd_[a-zA-Z0-9._-]{1,64}$/.test(record.producer_id) ||
     !/^build_[a-zA-Z0-9._-]{1,127}$/.test(record.build_id) ||

package/src/core/events/v3/producers/producer-state-observer.ts

@@ -1,5 +1,6 @@
 import { existsSync, lstatSync, readdirSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
+import { EVENT_ADAPTER_IDS_V3 } from "../adapter-id.ts";
 import { readEventV3ControlState } from "../control.ts";
 import { EVENT_V3_LEDGER_RELATIVE_ROOT } from "../reader.ts";
 
@@ -16,7 +17,7 @@ export function listHookProducerStateSummariesV3(coordRoot: string): HookProduce
   const producerRoot = join(resolve(coordRoot), EVENT_V3_LEDGER_RELATIVE_ROOT, "private-producers");
   if (!existsSync(producerRoot)) return [];
   const summaries: HookProducerStateSummaryV3[] = [];
-  for (const adapter of ["claude-code", "codex", "cursor"] as const) {
+  for (const adapter of EVENT_ADAPTER_IDS_V3) {
     const directory = join(producerRoot, adapter);
     if (!existsSync(directory)) continue;
     const directoryMetadata = lstatSync(directory);

package/src/core/events/v3/producers/recorder.ts

@@ -15,7 +15,6 @@ import {
 } from "node:fs";
 import { hostname } from "node:os";
 import { basename, join, resolve } from "node:path";
-import type { Adapter } from "../../../adapter.ts";
 import { extractBashCommand, type ParsedPayload } from "../../../hooks/adapter/parse.ts";
 import {
   discoverCodexSessionTranscript,
@@ -26,6 +25,7 @@ import {
 } from "../../../hooks/adapter/runtime-telemetry.ts";
 import { fsyncParentDirectory } from "../../../workflow/durable-record.ts";
 import { acquireNoClobberLease } from "../../../workflow/workspaces/leases.ts";
+import { EVENT_ADAPTER_IDS_V3, type EventAdapterIdV3 } from "../adapter-id.ts";
 import type { RuntimeAttestationV3Base } from "../base-contract.ts";
 import { buildEventV3 } from "../builder.ts";
 import { canonicalJsonV3, fingerprintV3, normalizeNativeIdV3 } from "../canonical.ts";
@@ -108,7 +108,12 @@ const APPROVED_END_RUNTIME_CONTEXT_RETRY_DELAYS_MS = [0, 250, 250] as const;
  * Kept in code, outside the digested capability profiles, so tuning recovery
  * never changes an adapter capability digest (ADR 0078).
  */
-const RECOVERY_ENABLED_ADAPTERS: ReadonlySet<Adapter> = new Set(["claude-code", "codex", "cursor"]);
+const RECOVERY_ENABLED_ADAPTERS: ReadonlySet<string> = new Set([
+  "claude-code",
+  "codex",
+  "cursor",
+  "openclaw",
+]);
 
 interface SpanStateV3 extends OpenSpanStateV3 {
   source_id: `hid_${string}`;
@@ -187,7 +192,7 @@ interface DelegationStateV3 extends OpenSpanStateV3 {
 export interface HookProducerStateV3 {
   format: typeof STATE_FORMAT;
   format_version: typeof STATE_VERSION;
-  adapter: Adapter;
+  adapter: EventAdapterIdV3;
   instance_id: `inst_${string}`;
   session_id: `sid_${string}`;
   generation_id: `gen_${string}`;
@@ -263,7 +268,7 @@ export interface RecordHookSignalV3Input {
   mode: EventV3WriteMode;
   signal: HookSignalV3;
   payload: ParsedPayload;
-  adapter: Adapter;
+  adapter: EventAdapterIdV3;
   instance_id: `inst_${string}`;
   run_id?: `run_${string}`;
   workflow_id?: `wf_${string}`;
@@ -290,6 +295,13 @@ export interface RecordHookSignalV3Input {
   /** Optional roots and read budgets for runtime telemetry adapters. */
   runtimeTelemetryOptions?: RuntimeTelemetryOptions;
   writerOptions?: WriteEventV3Options;
+  /**
+   * Skip the crash-recovery intake file when the caller already owns a
+   * bounded, drainable queue. This prevents raw hook payloads from touching
+   * disk before normalization. The default remains the durable spool used by
+   * interactive harness hooks.
+   */
+  intake?: "durable" | "memory_only";
 }
 
 export type RecordHookSignalV3Result =
@@ -308,6 +320,8 @@ export type RecordHookSignalV3Result =
     }
   /** Durably queued in the intake spool; a lease holder or drain hook records it. */
   | { state: "spooled" }
+  /** Memory-only delivery could not acquire the producer lease and was dropped. */
+  | { state: "busy" }
   | { state: "recorded"; event: EventV3; durability: WriteEventV3Result; recovered: boolean };
 
 export type ApprovedSessionEndReasonV3 =
@@ -387,6 +401,16 @@ export function recordHookSignalV3(input: RecordHookSignalV3Input): RecordHookSi
   const rootFingerprintContext = fingerprintContextV3(input.coordRoot, rootId, undefined, epochId);
   const sessionHash = sessionHashForSignal(input, rootFingerprintContext);
   const path = producerStatePath(input.coordRoot, input.adapter, sessionHash);
+  if (input.intake === "memory_only") {
+    const lease = acquireStateLeaseWithRetry(input.coordRoot, path, STATE_LEASE_RETRY_ATTEMPTS);
+    if (!lease) return { state: "busy" };
+    try {
+      drainSessionIntakeLocked(input.coordRoot, control, input.adapter, sessionHash, path);
+      return processHookSignalLocked(control, input, sessionHash, path);
+    } finally {
+      lease.release();
+    }
+  }
   const spoolPath = appendHookIntakeRecordV3(input.coordRoot, sessionHash, intakeRecord(input));
   const lease = acquireStateLeaseWithRetry(input.coordRoot, path, STATE_LEASE_RETRY_ATTEMPTS);
   if (!lease) return { state: "spooled" };
@@ -404,7 +428,7 @@ export function recordHookSignalV3(input: RecordHookSignalV3Input): RecordHookSi
 
 function hookSignalGate(
   control: OpenHookControlStateV3,
-  adapter: Adapter,
+  adapter: EventAdapterIdV3,
   signal: HookSignalV3,
 ): RecordHookSignalV3Result | undefined {
   const expectedCapabilityDigest = `sha256:${adapterCapabilityProfileDigestV3(adapter).slice(4)}`;
@@ -531,7 +555,7 @@ interface OwnIntakeRecordV3 {
 function drainSessionIntakeLocked(
   coordRoot: string,
   control: OpenHookControlStateV3,
-  adapter: Adapter,
+  adapter: EventAdapterIdV3,
   sessionHash: `hid_${string}`,
   statePath: string,
   own?: OwnIntakeRecordV3,
@@ -2128,6 +2152,10 @@ function maybeCommitActiveRuntimeContextObservation(
     publishProducerState(input.coordRoot, path, state);
     return;
   }
+  if (input.adapter === "openclaw") {
+    publishProducerState(input.coordRoot, path, state);
+    return;
+  }
 
   const transcriptPath = runtimeTranscriptPath(input, state);
   if (!transcriptPath && input.adapter !== "cursor") {
@@ -2472,6 +2500,7 @@ function turnTelemetryForTerminal(
 ): TurnTelemetryV3 {
   const native = extractTurnTelemetryV3(input.adapter, input.payload.raw, observedAt);
   if (native.context.state === "observed") return native;
+  if (input.adapter === "openclaw") return native;
   if (input.adapter === "cursor" && state.cursor_mode === "cloud") {
     return {
       ...native,
@@ -2848,10 +2877,10 @@ function commitRuntimeAttestationChange(
   commitEventLocked(input, state, path, event);
 }
 
-function modelProviderFor(adapter: Adapter): string {
+function modelProviderFor(adapter: EventAdapterIdV3): string {
   if (adapter === "claude-code") return "anthropic";
   if (adapter === "codex") return "openai";
-  return "cursor";
+  return adapter;
 }
 
 function recordRuntimeTelemetryTiming(state: HookProducerStateV3, durationMs: number): void {
@@ -3436,7 +3465,7 @@ export function listHookProducerStateRecordsV3(
   const producerRoot = join(resolve(coordRoot), EVENT_V3_LEDGER_RELATIVE_ROOT, "private-producers");
   if (!existsSync(producerRoot)) return [];
   const records: HookProducerStateRecordV3[] = [];
-  for (const adapter of ["claude-code", "codex", "cursor"] as const) {
+  for (const adapter of EVENT_ADAPTER_IDS_V3) {
     const directory = join(producerRoot, adapter);
     if (!existsSync(directory)) continue;
     const metadata = lstatSync(directory);
@@ -3588,7 +3617,7 @@ function listArchivedHookProducerStatesV3(
   const producerRoot = join(resolve(archivedEpoch), "private-producers");
   if (!existsSync(producerRoot)) return [];
   const records: Array<{ sessionHash: `hid_${string}`; state: HookProducerStateV3 }> = [];
-  for (const adapter of ["claude-code", "codex", "cursor"] as const) {
+  for (const adapter of EVENT_ADAPTER_IDS_V3) {
     const directory = join(producerRoot, adapter);
     if (!existsSync(directory)) continue;
     const metadata = lstatSync(directory);
@@ -3644,7 +3673,7 @@ function hookSignalCapability(signal: HookSignalV3): AdapterSignalV3 {
 
 export function readHookProducerStateV3(
   coordRoot: string,
-  adapter: Adapter,
+  adapter: EventAdapterIdV3,
   nativeSessionId: string,
 ): HookProducerStateV3 | undefined {
   const control = readEventV3ControlState(coordRoot);
@@ -3761,12 +3790,12 @@ export function readTerminalHookProducerStateV3(
   nativeSessionId: string,
   instanceId: `inst_${string}`,
 ): HookProducerStateV3 | undefined {
-  const matches = (["claude-code", "codex", "cursor"] as const)
-    .map((adapter) => readHookProducerStateV3(coordRoot, adapter, nativeSessionId))
-    .filter(
-      (state): state is HookProducerStateV3 =>
-        state?.terminal === true && state.instance_id === instanceId,
-    );
+  const matches = EVENT_ADAPTER_IDS_V3.map((adapter) =>
+    readHookProducerStateV3(coordRoot, adapter, nativeSessionId),
+  ).filter(
+    (state): state is HookProducerStateV3 =>
+      state?.terminal === true && state.instance_id === instanceId,
+  );
   return matches.length === 1 ? matches[0] : undefined;
 }
 
@@ -3779,7 +3808,7 @@ export function readHookProducerStateByInstanceV3(
   const producerRoot = join(resolve(coordRoot), EVENT_V3_LEDGER_RELATIVE_ROOT, "private-producers");
   if (!existsSync(producerRoot)) return undefined;
   const matches: HookProducerStateV3[] = [];
-  for (const adapter of ["claude-code", "codex", "cursor"] as const) {
+  for (const adapter of EVENT_ADAPTER_IDS_V3) {
     const directory = join(producerRoot, adapter);
     if (!existsSync(directory)) continue;
     const metadata = lstatSync(directory);
@@ -3807,7 +3836,7 @@ export function readHookProducerStateByInstanceV3(
  */
 export function readJoinableHookProducerStateV3(
   coordRoot: string,
-  adapter: Adapter,
+  adapter: EventAdapterIdV3,
   nativeSessionId: string,
   instanceId: `inst_${string}`,
 ): HookProducerStateV3 | undefined {
@@ -4171,7 +4200,7 @@ function safeTokenOrUndefined(value: unknown): string | undefined {
 
 function producerStatePath(
   coordRoot: string,
-  adapter: Adapter,
+  adapter: EventAdapterIdV3,
   sessionHash: `hid_${string}`,
 ): string {
   return join(
@@ -4335,7 +4364,7 @@ function readProducerState(path: string): HookProducerStateV3 {
     Object.keys(state).some((key) => !allowedKeys.has(key)) ||
     state.format !== STATE_FORMAT ||
     state.format_version !== STATE_VERSION ||
-    !["claude-code", "codex", "cursor"].includes(state.adapter) ||
+    !(EVENT_ADAPTER_IDS_V3 as readonly string[]).includes(state.adapter) ||
     (state.cursor_mode !== undefined &&
       !["local", "cloud", "unknown"].includes(state.cursor_mode)) ||
     !/^inst_[a-zA-Z0-9._-]{1,128}$/.test(state.instance_id) ||

package/src/core/events/v3/reader.ts

@@ -480,18 +480,12 @@ export function readLedgerV3Since(
   cursor?: LedgerCursorV3,
   options: ReadLedgerV3Options = {},
 ): ReadLedgerV3SinceResult {
-  const discovered = discoverLedgerFramesV3(coordRoot);
-  const read = readLedgerFramesV3Since(discovered.frames, cursor, options);
-  const recovery = discoverRecoveryReceiptsV3(coordRoot);
-  const diagnostics = [...discovered.diagnostics, ...read.diagnostics, ...recovery.diagnostics];
-  return {
-    ...read,
-    events: diagnostics.length === 0 ? read.events : [],
-    diagnostics,
-    complete: diagnostics.length === 0,
-    bytes: discovered.bytes,
-    failed_epochs: recovery.receipts,
-  };
+  // Read through the validated snapshot cache that readLedgerV3 keeps, so a caller that
+  // polls the tail pays for the bytes appended since its last call, not for the whole
+  // authority. Until 2026-09-06 this rediscovered and revalidated every frame on every
+  // call: a 24.5 MB active segment cost about 0.5 s to return zero new events, and the
+  // semantic service asked once a second for three days (3.2 cores on an idle host).
+  return sliceLedgerReadSinceV3(readLedgerV3(coordRoot, options), cursor);
 }
 
 function discoverRecoveryReceiptsV3(coordRoot: string): {
@@ -740,7 +734,14 @@ export function readLedgerFramesV3Since(
   cursor?: LedgerCursorV3,
   options: ReadLedgerV3Options = {},
 ): ReadLedgerV3SinceResult {
-  const read = readLedgerFramesV3(frames, options);
+  return sliceLedgerReadSinceV3(readLedgerFramesV3(frames, options), cursor);
+}
+
+/** Apply a resume cursor to a validated read: the events after it, plus the next cursor. */
+function sliceLedgerReadSinceV3(
+  read: ReadLedgerV3Result,
+  cursor?: LedgerCursorV3,
+): ReadLedgerV3SinceResult {
   if (!read.genesis_id || !read.complete) {
     return { ...read, events: [], cursor, reset_required: Boolean(cursor) };
   }

package/src/core/events/v3/runtime-build.ts

@@ -1,6 +1,7 @@
 import { spawnSync } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
-import { resolve } from "node:path";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 
 export { liveEventV3BuildId, livePlatformV3 } from "./runtime-identity.ts";
 
@@ -37,5 +38,5 @@ export function currentHarneryRuntimeBuild(): string {
 }
 
 export function harneryPackageRoot(): string {
-  return resolve(import.meta.dir, "../../../..");
+  return resolve(dirname(fileURLToPath(import.meta.url)), "../../../..");
 }

package/src/core/events/v3/runtime-telemetry-capabilities.ts

@@ -1,4 +1,4 @@
-import type { Adapter } from "../../adapter.ts";
+import type { EventAdapterIdV3 } from "./adapter-id.ts";
 import {
   adapterSignalSupportV3,
   type CapabilitySupportV3,
@@ -47,7 +47,7 @@ export type RuntimeContextCapabilityEvidenceV3 =
   | { state: "unsupported" };
 
 export interface RuntimeTelemetryCapabilityEvidenceV3 {
-  adapter: Adapter;
+  adapter: EventAdapterIdV3;
   cursor_mode?: CursorExecutionModeV3;
   context: RuntimeContextCapabilityEvidenceV3;
   canonical_turn_boundaries: boolean;
@@ -102,7 +102,7 @@ function contextCapability(
 }
 
 function waitSpanCapability(
-  adapter: Adapter,
+  adapter: EventAdapterIdV3,
   cursorMode: CursorExecutionModeV3 | undefined,
 ): RuntimeTelemetryCapabilityObservationV3 {
   if (adapter === "cursor" && cursorMode === "cloud") {

package/src/core/events/v3/turn-telemetry.ts

@@ -1,4 +1,4 @@
-import type { Adapter } from "../../adapter.ts";
+import type { EventAdapterIdV3 } from "./adapter-id.ts";
 import {
   type AdapterSignalV3,
   adapterSignalSupportV3,
@@ -66,7 +66,7 @@ export interface HarnessTimingAccumulatorV3 {
 
 /** Extract only telemetry explicitly reported by a hook/status payload. */
 export function extractTurnTelemetryV3(
-  adapter: Adapter,
+  adapter: EventAdapterIdV3,
   payload: Record<string, unknown>,
   observedAt = new Date().toISOString(),
   support: TurnTelemetryCapabilitySupportV3 = {},
@@ -162,7 +162,7 @@ export function extractTurnTelemetryV3(
 }
 
 function contextObservation(
-  adapter: Adapter,
+  adapter: EventAdapterIdV3,
   usedTokens: number | undefined,
   limitTokens: number | undefined,
   usedPercent: number | undefined,
@@ -269,7 +269,7 @@ export function harnessObservationV3(
 }
 
 function missing(
-  adapter: Adapter,
+  adapter: EventAdapterIdV3,
   signal: "model_usage" | "inference_timing" | "context_usage",
   override: CapabilitySupportV3 | undefined,
 ) {