harnery 0.34.1 → 0.36.0

package/dist/core/events/v3/coordination-transaction-recovery.js

@@ -0,0 +1,342 @@
+import { randomUUID } from "node:crypto";
+import { chmodSync, closeSync, existsSync, fsyncSync, linkSync, mkdirSync, openSync, readdirSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { fsyncParentDirectory } from "../../workflow/durable-record.js";
+import { authorityRecoveryIntentPathV3, readAuthorityTransactionV3, } from "./authority-outbox.js";
+import { canonicalJsonV3, sha256V3 } from "./canonical.js";
+import { findPendingCoordinationTransactionV3, withPendingCoordinationTransactionRecoveryV3, } from "./producers/coordination-recorder.js";
+import { readLedgerV3 } from "./reader.js";
+import { ensureEventV3Layout } from "./writer.js";
+const SHA256_PATTERN = /^sha256:[a-f0-9]{64}$/;
+const TX_PATTERN = /^txn_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+const INSTANCE_PATTERN = /^inst_[a-zA-Z0-9._-]{1,128}$/;
+const PRODUCER_STATE_PATTERN = /^hid_[a-f0-9]{64}\.json$/;
+const APPROVAL_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._:/-]{0,199}$/;
+/**
+ * Abandon one authority transaction only after proving that normal recovery is
+ * impossible and that its event never entered the ledger or ready spool.
+ */
+export function quarantineConflictingCoordinationTransactionV3(coordRoot, input) {
+    assertTransactionId(input.transaction_id);
+    assertInstanceId(input.actor_instance_id);
+    assertDigest(input.observed_current_state_digest, "observed current state digest");
+    assertApprovalRecordId(input.approval_record_id);
+    const paths = recoveryPaths(coordRoot, input.transaction_id);
+    ensureRecoveryLayout(paths);
+    if (existsSync(paths.receipt)) {
+        const receipt = readReceipt(paths.receipt);
+        assertRecoveryBinding(receipt, input);
+        removeIfExists(paths.intent);
+        return receipt;
+    }
+    let intent;
+    let transaction;
+    let serializedTransaction;
+    const recoveryAlreadyStarted = existsSync(paths.intent);
+    if (recoveryAlreadyStarted) {
+        intent = readIntent(paths.intent);
+        assertRecoveryBinding(intent, input);
+        ({ transaction, serialized: serializedTransaction } = readQuarantinedOrReadyTransaction(paths));
+        assertTransactionMatchesIntent(transaction, serializedTransaction, intent);
+    }
+    else {
+        if (!existsSync(paths.ready)) {
+            throw new Error("authority transaction is not ready for recovery");
+        }
+        transaction = readAuthorityTransactionV3(paths.ready);
+        serializedTransaction = readFileSync(paths.ready, "utf8");
+        if (transaction.actor_instance_id !== input.actor_instance_id) {
+            throw new Error("authority transaction actor does not match the recovery target");
+        }
+        if (input.observed_current_state_digest === transaction.expected_prior_state_digest ||
+            input.observed_current_state_digest === transaction.desired_state_digest) {
+            throw new Error("authority transaction is still reconcilable and cannot be quarantined");
+        }
+        assertEventNeverCommitted(coordRoot, transaction.event_id, paths.committed);
+        const pending = findPendingCoordinationTransactionV3(coordRoot, transaction.transaction_id);
+        if (!pending)
+            throw new Error("authority transaction has no matching pending producer state");
+        if (canonicalJsonV3(pending.transaction) !== canonicalJsonV3(transaction)) {
+            throw new Error("authority outbox and producer state transactions do not match");
+        }
+        const createdAt = (input.now ?? (() => new Date()))().toISOString();
+        intent = {
+            format: "harnery-v3-coordination-transaction-quarantine-intent",
+            format_version: 1,
+            ...transactionFacts(transaction, serializedTransaction),
+            observed_current_state_digest: input.observed_current_state_digest,
+            approval_record_id: input.approval_record_id,
+            producer_state_file: pending.producer_state_file,
+            reason: "current_state_conflict",
+            created_at: createdAt,
+        };
+    }
+    return withPendingCoordinationTransactionRecoveryV3(coordRoot, intent.producer_state_file, transaction, recoveryAlreadyStarted, ({ clearPending }) => {
+        assertEventNeverCommitted(coordRoot, transaction.event_id, paths.committed);
+        publishCanonicalExclusive(paths.intent, intent);
+        input.onStep?.("intent_published");
+        publishSerializedExclusive(paths.quarantine, serializedTransaction);
+        input.onStep?.("transaction_quarantined");
+        clearPending();
+        input.onStep?.("producer_pending_cleared");
+        if (existsSync(paths.ready)) {
+            if (readFileSync(paths.ready, "utf8") !== serializedTransaction) {
+                throw new Error("authority ready transaction changed during recovery");
+            }
+            unlinkSync(paths.ready);
+            fsyncParentDirectory(paths.ready);
+        }
+        input.onStep?.("outbox_ready_removed");
+        const receipt = {
+            format: "harnery-v3-coordination-transaction-quarantine-receipt",
+            format_version: 1,
+            ...commonIntentFields(intent),
+            completed_at: (input.now ?? (() => new Date()))().toISOString(),
+            quarantine_file: `quarantine/${input.transaction_id}.json`,
+        };
+        if (Date.parse(receipt.completed_at) < Date.parse(receipt.created_at)) {
+            throw new Error("authority transaction recovery clock moved backwards");
+        }
+        publishCanonicalExclusive(paths.receipt, receipt);
+        input.onStep?.("receipt_committed");
+        removeIfExists(paths.intent);
+        return receipt;
+    });
+}
+function transactionFacts(transaction, serialized) {
+    return {
+        transaction_id: transaction.transaction_id,
+        transaction_digest: sha256V3(serialized),
+        event_id: transaction.event_id,
+        event_row_digest: sha256V3(transaction.event_row),
+        actor_instance_id: transaction.actor_instance_id,
+        subject_instance_id: transaction.subject_instance_id,
+        mutation_kind: transaction.mutation.kind,
+        expected_prior_state_digest: transaction.expected_prior_state_digest,
+        desired_state_digest: transaction.desired_state_digest,
+    };
+}
+function commonIntentFields(intent) {
+    const { format: _format, format_version: _formatVersion, ...common } = intent;
+    return common;
+}
+function assertEventNeverCommitted(coordRoot, eventId, committedReceiptPath) {
+    if (existsSync(committedReceiptPath)) {
+        throw new Error("authority transaction already has a committed receipt");
+    }
+    if (readLedgerV3(coordRoot).events.some(({ event }) => event.event_id === eventId)) {
+        throw new Error("authority transaction event is already present in the ledger");
+    }
+    const spool = ensureEventV3Layout(coordRoot).spool;
+    for (const name of readdirSync(spool)
+        .filter((entry) => entry.endsWith(".ready"))
+        .sort()) {
+        let event;
+        try {
+            event = JSON.parse(readFileSync(join(spool, name), "utf8"));
+        }
+        catch {
+            throw new Error("V3 ready spool is unreadable during authority recovery");
+        }
+        if (event &&
+            typeof event === "object" &&
+            !Array.isArray(event) &&
+            event.event_id === eventId) {
+            throw new Error("authority transaction event is already present in the ready spool");
+        }
+    }
+}
+function readQuarantinedOrReadyTransaction(paths) {
+    const path = existsSync(paths.quarantine) ? paths.quarantine : paths.ready;
+    if (!existsSync(path))
+        throw new Error("authority transaction recovery lost its durable record");
+    return { transaction: readAuthorityTransactionV3(path), serialized: readFileSync(path, "utf8") };
+}
+function assertTransactionMatchesIntent(transaction, serialized, intent) {
+    const facts = transactionFacts(transaction, serialized);
+    for (const [key, value] of Object.entries(facts)) {
+        if (intent[key] !== value) {
+            throw new Error("authority transaction recovery intent no longer matches its transaction");
+        }
+    }
+}
+function assertRecoveryBinding(record, input) {
+    if (record.transaction_id !== input.transaction_id ||
+        record.actor_instance_id !== input.actor_instance_id ||
+        record.approval_record_id !== input.approval_record_id) {
+        throw new Error("authority transaction recovery record does not match this request");
+    }
+}
+function recoveryPaths(coordRoot, transactionId) {
+    const ledger = ensureEventV3Layout(coordRoot);
+    const root = join(ledger.root, "authority-recoveries");
+    return {
+        root,
+        quarantineRoot: join(root, "quarantine"),
+        intent: authorityRecoveryIntentPathV3(coordRoot, transactionId),
+        receipt: join(root, `${transactionId}.committed.json`),
+        quarantine: join(root, "quarantine", `${transactionId}.json`),
+        ready: join(ledger.authorityOutbox, `${transactionId}.ready.json`),
+        committed: join(ledger.authorityOutbox, `${transactionId}.committed.json`),
+    };
+}
+function ensureRecoveryLayout(paths) {
+    for (const path of [paths.root, paths.quarantineRoot]) {
+        mkdirSync(path, { recursive: true, mode: 0o700 });
+        chmodSync(path, 0o700);
+    }
+}
+function publishCanonicalExclusive(path, value) {
+    publishSerializedExclusive(path, `${canonicalJsonV3(value)}\n`);
+}
+function publishSerializedExclusive(path, serialized) {
+    if (existsSync(path)) {
+        if (readFileSync(path, "utf8") !== serialized) {
+            throw new Error("authority transaction recovery record conflicts with an existing record");
+        }
+        return;
+    }
+    const temporary = `${path}.tmp-${process.pid}-${randomUUID()}`;
+    let fd;
+    try {
+        fd = openSync(temporary, "wx", 0o600);
+        writeFileSync(fd, serialized, "utf8");
+        fsyncSync(fd);
+        closeSync(fd);
+        fd = undefined;
+        linkSync(temporary, path);
+        fsyncParentDirectory(path);
+        unlinkSync(temporary);
+    }
+    finally {
+        if (fd !== undefined)
+            closeSync(fd);
+        if (existsSync(temporary))
+            unlinkSync(temporary);
+    }
+}
+function readIntent(path) {
+    return readCanonicalRecord(path, validateIntent);
+}
+function readReceipt(path) {
+    return readCanonicalRecord(path, validateReceipt);
+}
+function readCanonicalRecord(path, validate) {
+    let text;
+    let parsed;
+    try {
+        text = readFileSync(path, "utf8");
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error("authority transaction recovery record is malformed");
+    }
+    const value = validate(parsed);
+    if (text !== `${canonicalJsonV3(value)}\n`) {
+        throw new Error("authority transaction recovery record is not canonical");
+    }
+    return value;
+}
+function validateIntent(value) {
+    const record = validateCommon(value, ["format", "format_version"]);
+    if (record.format !== "harnery-v3-coordination-transaction-quarantine-intent" ||
+        record.format_version !== 1) {
+        throw new Error("authority transaction recovery intent is invalid");
+    }
+    return record;
+}
+function validateReceipt(value) {
+    const record = validateCommon(value, [
+        "completed_at",
+        "format",
+        "format_version",
+        "quarantine_file",
+    ]);
+    if (record.format !== "harnery-v3-coordination-transaction-quarantine-receipt" ||
+        record.format_version !== 1 ||
+        !timestamp(record.completed_at) ||
+        Date.parse(String(record.completed_at)) < Date.parse(String(record.created_at)) ||
+        record.quarantine_file !== `quarantine/${record.transaction_id}.json`) {
+        throw new Error("authority transaction recovery receipt is invalid");
+    }
+    return record;
+}
+function validateCommon(value, extraKeys) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("authority transaction recovery record is invalid");
+    }
+    const record = value;
+    const commonKeys = [
+        "actor_instance_id",
+        "approval_record_id",
+        "created_at",
+        "desired_state_digest",
+        "event_id",
+        "event_row_digest",
+        "expected_prior_state_digest",
+        "mutation_kind",
+        "observed_current_state_digest",
+        "producer_state_file",
+        "reason",
+        "subject_instance_id",
+        "transaction_digest",
+        "transaction_id",
+    ];
+    if (Object.keys(record).sort().join("\0") !== [...commonKeys, ...extraKeys].sort().join("\0")) {
+        throw new Error("authority transaction recovery record has unsupported fields");
+    }
+    if (typeof record.transaction_id !== "string" ||
+        !TX_PATTERN.test(record.transaction_id) ||
+        typeof record.transaction_digest !== "string" ||
+        !SHA256_PATTERN.test(record.transaction_digest) ||
+        typeof record.event_id !== "string" ||
+        record.event_id.length === 0 ||
+        typeof record.event_row_digest !== "string" ||
+        !SHA256_PATTERN.test(record.event_row_digest) ||
+        typeof record.actor_instance_id !== "string" ||
+        !INSTANCE_PATTERN.test(record.actor_instance_id) ||
+        typeof record.subject_instance_id !== "string" ||
+        !INSTANCE_PATTERN.test(record.subject_instance_id) ||
+        typeof record.mutation_kind !== "string" ||
+        record.mutation_kind.length === 0 ||
+        typeof record.expected_prior_state_digest !== "string" ||
+        !SHA256_PATTERN.test(record.expected_prior_state_digest) ||
+        typeof record.desired_state_digest !== "string" ||
+        !SHA256_PATTERN.test(record.desired_state_digest) ||
+        typeof record.observed_current_state_digest !== "string" ||
+        !SHA256_PATTERN.test(record.observed_current_state_digest) ||
+        typeof record.approval_record_id !== "string" ||
+        !APPROVAL_PATTERN.test(record.approval_record_id) ||
+        typeof record.producer_state_file !== "string" ||
+        !PRODUCER_STATE_PATTERN.test(record.producer_state_file) ||
+        record.reason !== "current_state_conflict" ||
+        !timestamp(record.created_at)) {
+        throw new Error("authority transaction recovery record values are invalid");
+    }
+    return record;
+}
+function assertTransactionId(value) {
+    if (!TX_PATTERN.test(value))
+        throw new Error("authority transaction ID is invalid");
+}
+function assertInstanceId(value) {
+    if (!INSTANCE_PATTERN.test(value))
+        throw new Error("authority recovery actor is invalid");
+}
+function assertDigest(value, label) {
+    if (!SHA256_PATTERN.test(value))
+        throw new Error(`${label} is invalid`);
+}
+function assertApprovalRecordId(value) {
+    if (!APPROVAL_PATTERN.test(value))
+        throw new Error("approval record ID is invalid");
+}
+function timestamp(value) {
+    return typeof value === "string" && Number.isFinite(Date.parse(value));
+}
+function removeIfExists(path) {
+    if (!existsSync(path))
+        return;
+    unlinkSync(path);
+    fsyncParentDirectory(path);
+}

package/dist/core/events/v3/coordination-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coordination-view.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/coordination-view.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"coordination-view.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/coordination-view.ts"],"names":[],"mappings":"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"}

package/dist/core/events/v3/coordination-view.js

@@ -9,6 +9,16 @@ export class CoordinationViewV3Error extends Error {
         this.name = "CoordinationViewV3Error";
     }
 }
+/**
+ * A canonical ledger read is immutable and readLedgerV3 returns the same result
+ * object until the authority changes. Several web helpers derive the
+ * coordination view independently during one server render; without this
+ * cache each helper reduces the complete append-only history again.
+ *
+ * Weak keys bind the projection lifetime to the reader snapshot. A newly
+ * appended event produces a new ReadLedgerV3Result and therefore a fresh view.
+ */
+const coordinationViewCacheV3 = new WeakMap();
 /** Read the complete V3 catalog and derive the disposable coordination view. */
 export function readCoordinationViewV3(coordRoot) {
     return projectCoordinationViewV3(readLedgerV3(coordRoot));
@@ -18,6 +28,9 @@ export function readCoordinationViewV3(coordRoot) {
  * finalization, web, and Codec adapters. This function performs no writes.
  */
 export function projectCoordinationViewV3(read) {
+    const cached = coordinationViewCacheV3.get(read);
+    if (cached)
+        return cached;
     const safety = reduceSafetyProjectionV3(read);
     const starts = new Map();
     const eventGeneration = new Map();
@@ -97,7 +110,7 @@ export function projectCoordinationViewV3(read) {
             instances[state.instance_id] = view;
         }
     }
-    return {
+    const view = {
         projection_version: EVENT_V3_COORDINATION_VIEW_VERSION,
         contract_major: 2,
         reducer_build_id: EVENT_V3_SAFETY_REDUCER_BUILD,
@@ -110,6 +123,8 @@ export function projectCoordinationViewV3(read) {
         decisions: safety.decisions,
         health: safety.health,
     };
+    coordinationViewCacheV3.set(read, view);
+    return view;
 }
 /** Refuse authority decisions while still allowing callers to render diagnostics. */
 export function requireAuthoritySafeCoordinationViewV3(view) {

package/dist/core/events/v3/generated.d.ts

@@ -1,4 +1,4 @@
 /** Generated by scripts/generate-event-v3-contract.ts. Do not edit. */
-export declare const EVENT_V3_SCHEMA_DIGEST: "sha256:682272a35f16177217a272e119c4dea2bf1980a522a183fefd6dceaf1e4509b8";
+export declare const EVENT_V3_SCHEMA_DIGEST: "sha256:bdcee8d7839add0c786740ba9d5cfd0b6573f0ad4974bf53272737468734aa36";
 export declare const EVENT_V3_GENERATED_CORE_TYPES: readonly ["ledger.genesis", "ledger.activated", "ledger.schema_advanced", "ledger.comparability_advanced", "session.started", "session.attestation_changed", "session.resumed", "session.ended", "session.termination_observed", "run.started", "run.completed", "turn.started", "turn.completed", "tool.requested", "tool.completed", "command.started", "command.output_observed", "command.completed", "context.observed", "context.compaction_started", "context.compaction_completed", "context.checkpointed", "context.recovery_injected", "agent.delegated", "agent.started", "agent.completed", "artifact.observed", "progress.observed", "coord.task_changed", "coord.lifecycle_changed", "coord.status_observed", "coord.claim_changed", "coord.presence_changed", "coord.message_observed", "coord.identity_attested", "council.state_changed", "decision.state_changed", "lifecycle.recovered", "lifecycle.sweep_observed", "health.observed", "wait.started", "wait.ended", "health.capability_drift"];
 //# sourceMappingURL=generated.d.ts.map

package/dist/core/events/v3/generated.js

@@ -1,5 +1,5 @@
 /** Generated by scripts/generate-event-v3-contract.ts. Do not edit. */
-export const EVENT_V3_SCHEMA_DIGEST = "sha256:682272a35f16177217a272e119c4dea2bf1980a522a183fefd6dceaf1e4509b8";
+export const EVENT_V3_SCHEMA_DIGEST = "sha256:bdcee8d7839add0c786740ba9d5cfd0b6573f0ad4974bf53272737468734aa36";
 export const EVENT_V3_GENERATED_CORE_TYPES = [
     "ledger.genesis",
     "ledger.activated",

package/dist/core/events/v3/index.d.ts

@@ -3,20 +3,22 @@ export { type AuthorityMutationV3, type AuthorityReceiptV3, type AuthorityReconc
 export { ensureEventLedgerV3, type InitializeEventLedgerV3Input, type InitializeEventLedgerV3Result, initializeEventLedgerV3, } from "./bootstrap.js";
 export { type BuildEventV3Input, buildEventV3 } from "./builder.js";
 export { canonicalJsonV3, EVENT_V3_CANONICALIZER, type FingerprintContextV3, type FingerprintV3, fingerprintV3, normalizeNativeIdV3, sha256V3, } from "./canonical.js";
-export { ADAPTER_CAPABILITY_PROFILES_V3, type AdapterCapabilityProfileV3, type AdapterSignalV3, adapterCapabilityProfileDigestV3, adapterCapabilityProfileV3, adapterSignalSupportV3, type CapabilitySupportV3, } from "./capabilities.js";
+export { ADAPTER_CAPABILITY_PROFILES_V3, ADAPTER_WAIT_KINDS_V3, type AdapterCapabilityProfileV3, type AdapterSignalV3, type AdapterWaitKindV3, adapterCapabilityProfileDigestV3, adapterCapabilityProfileV3, adapterSignalSupportV3, adapterWaitCoverageMatrixV3, adapterWaitKindSupportV3, type CapabilitySupportV3, type CursorExecutionModeV3, type WaitKindCapabilityV3, } from "./capabilities.js";
 export { type CapabilityDeliveryV3, type CapabilityDriftPayloadV3, capabilityDriftPayloadsV3, measurableDeliveriesV3, } from "./capability-drift.js";
 export { EVENT_V3_CONTRACT_MAJOR, EVENT_V3_CONTRACT_NAME, EVENT_V3_CORE_EVENT_TYPES, EVENT_V3_SCHEMA_ID, type EventOfTypeV3, type EventPayloadV3, type EventTypeV3, type EventV3, EventV3Schema, ObservationV3Schema, OutcomeV3Schema, RecoveryV3Schema, type SpanSummaryV3, SpanSummaryV3Schema, type TurnHarnessV3, type TurnInferenceV3, type TurnUsageV3, type WaitKindV3, WaitKindV3Schema, } from "./contract.js";
-export { type ActivationManifestV3, type BuildActivationManifestV3Input, type BuildCandidateGenesisManifestV3Input, buildActivationManifestV3, buildCandidateGenesisManifestV3, type CandidateGenesisManifestV3, type CandidateProfileV3, type ControlManifestValidationV3, type ControlProducerV3, candidateManifestDigestV3, candidateProfileDigestV3, EVENT_V3_ACTIVATION_MANIFEST, EVENT_V3_GENESIS_MANIFEST, type EventV3ControlState, type EventV3WriteMode, eventV3WriteGateOpen, readEventV3ControlState, repairEventV3ControlPair, validateActivationManifestV3, validateCandidateGenesisManifestV3, } from "./control.js";
+export { type ActivationManifestV3, type BuildActivationManifestV3Input, type BuildCandidateGenesisManifestV3Input, buildActivationManifestV3, buildCandidateGenesisManifestV3, type CandidateGenesisManifestV3, type CandidateProfileV3, type ControlManifestValidationV3, type ControlProducerV3, candidateManifestDigestV3, candidateProfileDigestV3, EVENT_V3_ACTIVATION_MANIFEST, EVENT_V3_GENESIS_MANIFEST, type EventV3ControlState, type EventV3WriteMode, eventV3WriteGateOpen, readEventV3ControlState, validateActivationManifestV3, validateCandidateGenesisManifestV3, } from "./control.js";
+export { repairEventV3ControlPair } from "./control-writer.js";
 export { type CoordinationGenerationViewV3, type CoordinationViewV3, CoordinationViewV3Error, EVENT_V3_COORDINATION_VIEW_VERSION, projectCoordinationViewV3, readCoordinationViewV3, requireAuthoritySafeCoordinationViewV3, } from "./coordination-view.js";
 export { type CostMetricV3, type DelegationRollupDiagnosticCodeV3, type DelegationRollupV3, type EconomicsProjectionOptionsV3, type EconomicsProjectionV3, EVENT_V3_ECONOMICS_PROJECTION_VERSION, type GenerationEconomicsV3, type ModelPricingV3, projectDelegationRollupV3, projectEconomicsV3, type TokenTotalsMetricV3, type TokenTotalsV3, type TurnEconomicsV3, } from "./economics.js";
 export { EVENT_V3_FINALIZATION_VIEW_VERSION, type FinalizationScopeV3, FinalizationScopeV3Error, type FinalizationScopeV3ErrorCode, projectFinalizationScopeV3, readFinalizationScopeV3, } from "./finalization-view.js";
 export { FINGERPRINT_KEY_STORE_RELATIVE_PATH, type FingerprintKeyEpochV3, type FingerprintKeyStoreV3, fingerprintContextV3, fingerprintKeyStorePathV3, loadOrCreateFingerprintKeyStoreV3, type RotateFingerprintEpochV3Options, readFingerprintKeyStoreV3, rotateFingerprintEpochV3, } from "./fingerprint-keys.js";
 export { EVENT_V3_SCHEMA_DIGEST } from "./generated.js";
 export { activationIdV3, attestationIdV3, clockIdV3, delegationIdV3, eventIdV3, generationIdV3, genesisIdV3, spanIdV3, } from "./ids.js";
-export { type ContextCoverageStateV3, type ContextCoverageV3, EVENT_V3_LATENCY_PROJECTION_VERSION, type LatencyMetricV3, type LatencyProjectionDiagnosticCodeV3, type LatencyProjectionDiagnosticV3, type LatencyProjectionV3, projectLatencyV3, type ToolLatencyV3, type TurnLatencyV3, } from "./latency.js";
+export { type ContextCoverageStateV3, type ContextCoverageV3, EVENT_V3_LATENCY_PROJECTION_VERSION, type LatencyMetricV3, type LatencyProjectionDiagnosticCodeV3, type LatencyProjectionDiagnosticV3, type LatencyProjectionV3, projectLatencyV3, type ResponseLatencyV3, runtimeTelemetryEvidenceKeyV3, type ToolLatencyV3, type TurnLatencyV3, type WaitKindCompletenessV3, type WaitKindCoverageV3, } from "./latency.js";
 export { EVENT_V3_LIVE_RELATIVE_ROOT, janitorLiveDisplayV3, type LiveDisplayInputV3, type LiveDisplayJanitorResultV3, type LiveDisplayRowV3, listLiveDisplayV3, readLiveDisplayV3, safeIntentDisplayV3, tryWriteLiveDisplayV3, writeLiveDisplayV3, } from "./live-feed.js";
 export type { LiveCoordinationObservationV3 } from "./live-observation.js";
-export { hookSignalV3, LIVE_COMMAND_V3_PRODUCER_ID, LIVE_HOOK_V3_PRODUCER_ID, type LiveEventLedgerRouteV3, liveEventV3BuildId, liveInstanceIdV3, livePlatformV3, nativeInstanceIdV3, recordLiveHookSignalV3, resolveLiveEventLedgerRouteV3, } from "./live-routing.js";
+export { type LiveEventLedgerRouteV3, observeLiveEventLedgerRouteV3, } from "./live-route-observer.js";
+export { hookSignalV3, LIVE_COMMAND_V3_PRODUCER_ID, LIVE_HOOK_V3_PRODUCER_ID, liveEventV3BuildId, liveInstanceIdV3, livePlatformV3, nativeInstanceIdV3, recordLiveHookSignalV3, resolveLiveEventLedgerRouteV3, } from "./live-routing.js";
 export { type CommandObservationV3, type CommandProducerContextV3, type CommandSignalV3, normalizeCommandEventV3, } from "./producers/command.js";
 export { type RecordCommandSignalV3Input, type RecordCommandSignalV3Result, recordCommandSignalV3, } from "./producers/command-recorder.js";
 export { type ClaimChangedObservationV3, type CoordinationAuthoritySignalV3, type CoordinationObservationBySignalV3, type CoordinationProducerContextV3, type DecisionStateChangedObservationV3, type IdentityAttestedObservationV3, type LifecycleChangedObservationV3, type NormalizedCoordinationAuthorityV3, normalizeCoordinationAuthorityV3, type TaskChangedObservationV3, type WaitEndedObservationV3, type WaitStartedObservationV3, } from "./producers/coordination.js";
@@ -24,9 +26,10 @@ export { type RecordCoordinationAuthorityV3Input, type RecordCoordinationAuthori
 export { type HookEventV3, type HookProducerContextV3, normalizeHookEventV3, upgradeHookEventV3, } from "./producers/hook.js";
 export { type ApprovedSessionEndReasonV3, type DrainHookIntakeSpoolV3Result, drainHookIntakeSpoolV3, type HookProducerStateRecordV3, type HookProducerStateV3, listHookProducerStateRecordsV3, type RecordApprovedSessionEndV3Input, type RecordApprovedSessionEndV3Result, type RecordHookSignalV3Input, type RecordHookSignalV3Result, readHookProducerStateV3, recordApprovedSessionEndV3, recordHookSignalV3, } from "./producers/recorder.js";
 export { type ClaimProjectionV3, type DelegationProjectionV3, EVENT_V3_SAFETY_REDUCER_BUILD, type GenerationSafetyStateV3, reduceSafetyProjectionV3, type SafetyProjectionDiagnosticCodeV3, type SafetyProjectionDiagnosticV3, type SafetyProjectionV3, type WaitProjectionV3, } from "./projection.js";
-export { digestEventV3AuthorityDirectoryV3, inspectInvalidActiveAuthorityV3, type LedgerCursorV3, type LedgerDiagnosticCodeV3, type LedgerDiagnosticV3, type LedgerFrameV3, type PositionedEventV3, type ReadLedgerV3Options, type ReadLedgerV3Result, type ReadLedgerV3SinceResult, readLedgerFramesV3, readLedgerFramesV3Since, readLedgerV3, readLedgerV3Since, type SchemaAdvanceV3, } from "./reader.js";
+export { digestEventV3AuthorityDirectoryV3, eventV3ActiveWatchPath, inspectInvalidActiveAuthorityV3, type LedgerCursorV3, type LedgerDiagnosticCodeV3, type LedgerDiagnosticV3, type LedgerFrameV3, type PositionedEventV3, type ReadLedgerV3Options, type ReadLedgerV3Result, type ReadLedgerV3SinceResult, readLedgerFramesV3, readLedgerFramesV3Since, readLedgerV3, readLedgerV3Since, type SchemaAdvanceV3, } from "./reader.js";
 export { type RecoverInvalidEventLedgerV3Input, type RecoverInvalidEventLedgerV3Result, recoverInvalidEventLedgerV3, } from "./recovery.js";
 export { type EventV3RecoveryDiagnostic, type EventV3RecoveryFailure, type EventV3RecoveryIntent, type EventV3RecoveryReceipt, eventV3RecoveryRecordsRoot, listEventV3RecoveryReceipts, readEventV3RecoveryIntent, readEventV3RecoveryReceipt, validateEventV3RecoveryIntent, validateEventV3RecoveryReceipt, } from "./recovery-record.js";
+export { effectiveRuntimeTelemetryCapabilitiesV3, type RuntimeContextCapabilityEvidenceV3, type RuntimeTelemetryCapabilitiesV3, type RuntimeTelemetryCapabilityEvidenceV3, type RuntimeTelemetryCapabilityObservationV3, type RuntimeTelemetryCapabilityValueV3, type RuntimeTelemetryChannelV3, type RuntimeTelemetryCompletenessV3, } from "./runtime-telemetry-capabilities.js";
 export { type CloseSpanV3Input, captureSpanClockV3, closeSpanStateV3, linuxUptimeNanosecondsV3, type OpenSpanStateV3, type OpenSpanV3Input, openSpanStateV3, type SpanClockV3, } from "./span-state.js";
 export { type DescribePathTargetV3Input, describePathTargetV3, type ExtractTargetsV3Input, exactToolInputFingerprintV3, extractTargetsV3, type TargetDescriptorV3, } from "./targets.js";
 export { type ContextMeasurementV3, emptyHarnessTimingV3, extractTurnTelemetryV3, type HarnessTimingAccumulatorV3, harnessObservationV3, recordHarnessTimingV3, type TelemetryObservationV3, type TurnTelemetryV3, } from "./turn-telemetry.js";

package/dist/core/events/v3/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/index.ts"],"names":[],"mappings":"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"}

package/dist/core/events/v3/index.js

@@ -3,18 +3,20 @@ export { buildAuthorityTransactionV3, listPendingAuthorityTransactionsV3, prepar
 export { ensureEventLedgerV3, initializeEventLedgerV3, } from "./bootstrap.js";
 export { buildEventV3 } from "./builder.js";
 export { canonicalJsonV3, EVENT_V3_CANONICALIZER, fingerprintV3, normalizeNativeIdV3, sha256V3, } from "./canonical.js";
-export { ADAPTER_CAPABILITY_PROFILES_V3, adapterCapabilityProfileDigestV3, adapterCapabilityProfileV3, adapterSignalSupportV3, } from "./capabilities.js";
+export { ADAPTER_CAPABILITY_PROFILES_V3, ADAPTER_WAIT_KINDS_V3, adapterCapabilityProfileDigestV3, adapterCapabilityProfileV3, adapterSignalSupportV3, adapterWaitCoverageMatrixV3, adapterWaitKindSupportV3, } from "./capabilities.js";
 export { capabilityDriftPayloadsV3, measurableDeliveriesV3, } from "./capability-drift.js";
 export { EVENT_V3_CONTRACT_MAJOR, EVENT_V3_CONTRACT_NAME, EVENT_V3_CORE_EVENT_TYPES, EVENT_V3_SCHEMA_ID, EventV3Schema, ObservationV3Schema, OutcomeV3Schema, RecoveryV3Schema, SpanSummaryV3Schema, WaitKindV3Schema, } from "./contract.js";
-export { buildActivationManifestV3, buildCandidateGenesisManifestV3, candidateManifestDigestV3, candidateProfileDigestV3, EVENT_V3_ACTIVATION_MANIFEST, EVENT_V3_GENESIS_MANIFEST, eventV3WriteGateOpen, readEventV3ControlState, repairEventV3ControlPair, validateActivationManifestV3, validateCandidateGenesisManifestV3, } from "./control.js";
+export { buildActivationManifestV3, buildCandidateGenesisManifestV3, candidateManifestDigestV3, candidateProfileDigestV3, EVENT_V3_ACTIVATION_MANIFEST, EVENT_V3_GENESIS_MANIFEST, eventV3WriteGateOpen, readEventV3ControlState, validateActivationManifestV3, validateCandidateGenesisManifestV3, } from "./control.js";
+export { repairEventV3ControlPair } from "./control-writer.js";
 export { CoordinationViewV3Error, EVENT_V3_COORDINATION_VIEW_VERSION, projectCoordinationViewV3, readCoordinationViewV3, requireAuthoritySafeCoordinationViewV3, } from "./coordination-view.js";
 export { EVENT_V3_ECONOMICS_PROJECTION_VERSION, projectDelegationRollupV3, projectEconomicsV3, } from "./economics.js";
 export { EVENT_V3_FINALIZATION_VIEW_VERSION, FinalizationScopeV3Error, projectFinalizationScopeV3, readFinalizationScopeV3, } from "./finalization-view.js";
 export { FINGERPRINT_KEY_STORE_RELATIVE_PATH, fingerprintContextV3, fingerprintKeyStorePathV3, loadOrCreateFingerprintKeyStoreV3, readFingerprintKeyStoreV3, rotateFingerprintEpochV3, } from "./fingerprint-keys.js";
 export { EVENT_V3_SCHEMA_DIGEST } from "./generated.js";
 export { activationIdV3, attestationIdV3, clockIdV3, delegationIdV3, eventIdV3, generationIdV3, genesisIdV3, spanIdV3, } from "./ids.js";
-export { EVENT_V3_LATENCY_PROJECTION_VERSION, projectLatencyV3, } from "./latency.js";
+export { EVENT_V3_LATENCY_PROJECTION_VERSION, projectLatencyV3, runtimeTelemetryEvidenceKeyV3, } from "./latency.js";
 export { EVENT_V3_LIVE_RELATIVE_ROOT, janitorLiveDisplayV3, listLiveDisplayV3, readLiveDisplayV3, safeIntentDisplayV3, tryWriteLiveDisplayV3, writeLiveDisplayV3, } from "./live-feed.js";
+export { observeLiveEventLedgerRouteV3, } from "./live-route-observer.js";
 export { hookSignalV3, LIVE_COMMAND_V3_PRODUCER_ID, LIVE_HOOK_V3_PRODUCER_ID, liveEventV3BuildId, liveInstanceIdV3, livePlatformV3, nativeInstanceIdV3, recordLiveHookSignalV3, resolveLiveEventLedgerRouteV3, } from "./live-routing.js";
 export { normalizeCommandEventV3, } from "./producers/command.js";
 export { recordCommandSignalV3, } from "./producers/command-recorder.js";
@@ -23,9 +25,10 @@ export { recordCoordinationAuthorityV3, } from "./producers/coordination-recorde
 export { normalizeHookEventV3, upgradeHookEventV3, } from "./producers/hook.js";
 export { drainHookIntakeSpoolV3, listHookProducerStateRecordsV3, readHookProducerStateV3, recordApprovedSessionEndV3, recordHookSignalV3, } from "./producers/recorder.js";
 export { EVENT_V3_SAFETY_REDUCER_BUILD, reduceSafetyProjectionV3, } from "./projection.js";
-export { digestEventV3AuthorityDirectoryV3, inspectInvalidActiveAuthorityV3, readLedgerFramesV3, readLedgerFramesV3Since, readLedgerV3, readLedgerV3Since, } from "./reader.js";
+export { digestEventV3AuthorityDirectoryV3, eventV3ActiveWatchPath, inspectInvalidActiveAuthorityV3, readLedgerFramesV3, readLedgerFramesV3Since, readLedgerV3, readLedgerV3Since, } from "./reader.js";
 export { recoverInvalidEventLedgerV3, } from "./recovery.js";
 export { eventV3RecoveryRecordsRoot, listEventV3RecoveryReceipts, readEventV3RecoveryIntent, readEventV3RecoveryReceipt, validateEventV3RecoveryIntent, validateEventV3RecoveryReceipt, } from "./recovery-record.js";
+export { effectiveRuntimeTelemetryCapabilitiesV3, } from "./runtime-telemetry-capabilities.js";
 export { captureSpanClockV3, closeSpanStateV3, linuxUptimeNanosecondsV3, openSpanStateV3, } from "./span-state.js";
 export { describePathTargetV3, exactToolInputFingerprintV3, extractTargetsV3, } from "./targets.js";
 export { emptyHarnessTimingV3, extractTurnTelemetryV3, harnessObservationV3, recordHarnessTimingV3, } from "./turn-telemetry.js";

package/dist/core/events/v3/latency.d.ts

@@ -1,5 +1,7 @@
+import { type AdapterWaitKindV3 } from "./capabilities.js";
 import type { ReadLedgerV3Result } from "./reader.js";
-export declare const EVENT_V3_LATENCY_PROJECTION_VERSION: "event-v3-latency-v1";
+import type { RuntimeTelemetryCapabilitiesV3 } from "./runtime-telemetry-capabilities.js";
+export declare const EVENT_V3_LATENCY_PROJECTION_VERSION: "event-v3-latency-v3";
 export type LatencyMetricV3 = {
     state: "observed";
     value_ms: number;
@@ -21,6 +23,27 @@ export interface ContextCoverageV3 {
     event_id: string | null;
     reason: string | null;
 }
+export interface ResponseLatencyV3 {
+    /** Turn start to first tool request, or terminal response for an attested no-tool turn. */
+    agent_action_ms: LatencyMetricV3;
+    /** Turn start to first tool request; unknown with `no_tool_request` for no-tool turns. */
+    first_tool_request_ms: LatencyMetricV3;
+    /** Last complete tool terminal to the turn terminal. */
+    post_tool_response_ms: LatencyMetricV3;
+    /** Turn start to terminal response, only when an attested turn used no tools. */
+    no_tool_terminal_response_ms: LatencyMetricV3;
+    method: "canonical_event_timestamps_v1";
+}
+export type WaitKindCompletenessV3 = "complete" | "lower_bound" | "unknown" | "unsupported";
+export interface WaitKindCoverageV3 {
+    kind: AdapterWaitKindV3;
+    started_count: number;
+    ended_count: number;
+    open_count: number;
+    duration_ms: LatencyMetricV3;
+    completeness: WaitKindCompletenessV3;
+    reason: string | null;
+}
 export interface TurnLatencyV3 {
     generation_id: string;
     turn_id: string;
@@ -35,6 +58,7 @@ export interface TurnLatencyV3 {
     wait_ms: LatencyMetricV3;
     occupied_ms: LatencyMetricV3;
     inference_ms: LatencyMetricV3;
+    response_latency: ResponseLatencyV3;
     harness_ms: LatencyMetricV3;
     slowest_hook: string | null;
     slowest_hook_ms: number | null;
@@ -42,6 +66,10 @@ export interface TurnLatencyV3 {
     over_attributed_ms: number;
     context_percent: number | null;
     context_coverage: ContextCoverageV3;
+    telemetry_capabilities: RuntimeTelemetryCapabilitiesV3 | null;
+    /** Equal keys are required before a report compares telemetry-backed values. */
+    telemetry_evidence_key: `sha256:${string}` | null;
+    wait_coverage_by_kind: Record<AdapterWaitKindV3, WaitKindCoverageV3>;
     span_counts: {
         tool: number;
         command: number;
@@ -60,4 +88,6 @@ export interface LatencyProjectionV3 {
     diagnostics: LatencyProjectionDiagnosticV3[];
 }
 export declare function projectLatencyV3(read: ReadLedgerV3Result): LatencyProjectionV3;
+/** Reports may compare a telemetry-backed channel only inside one evidence key. */
+export declare function runtimeTelemetryEvidenceKeyV3(telemetry: RuntimeTelemetryCapabilitiesV3): `sha256:${string}`;
 //# sourceMappingURL=latency.d.ts.map

package/dist/core/events/v3/latency.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"latency.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/latency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,mCAAmC,EAAG,qBAA8B,CAAC;AAElF,MAAM,MAAM,eAAe,GACvB;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,SAAS,GACT,aAAa,GACb,sBAAsB,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,eAAe,CAAC;IACzB,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,UAAU,EAAE,eAAe,CAAC;IAC5B,oBAAoB,EAAE,eAAe,CAAC;IACtC,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,eAAe,CAAC;IAC7B,YAAY,EAAE,eAAe,CAAC;IAC9B,UAAU,EAAE,eAAe,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,eAAe,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED,MAAM,MAAM,iCAAiC,GACzC,yBAAyB,GACzB,yBAAyB,GACzB,mBAAmB,GACnB,kCAAkC,GAClC,iBAAiB,CAAC;AAEtB,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,iCAAiC,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,OAAO,mCAAmC,CAAC;IAC/D,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,WAAW,EAAE,6BAA6B,EAAE,CAAC;CAC9C;AAqBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,mBAAmB,CAyB9E"}
+{"version":3,"file":"latency.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/latency.ts"],"names":[],"mappings":"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"}