@drakon-systems/ekho-sdk 0.6.1 → 0.7.0

package/dist/identity/verification.d.ts.map

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

package/dist/identity/verification.js

@@ -0,0 +1,503 @@
+"use strict";
+// Agent-side verification wiring (mirrors the Python plugin's verification.py):
+// pin sync (endorsement-chained, no relay TOFU), per-message verdicts, the
+// graceful execution-authority gate, and outbound signing.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NO_SNAPSHOT_VERIFICATION = exports.ADVISORY_REVOCATION_WARNING_MAX_SCOPES = exports.ADVISORY_REVOCATION_WARNING_SUMMARY_EVERY = void 0;
+exports.resetAdvisoryRevocationWarningStateForTests = resetAdvisoryRevocationWarningStateForTests;
+exports.syncPinnedOperatorKeys = syncPinnedOperatorKeys;
+exports.verifyBatch = verifyBatch;
+exports.parseRequireSignedMode = parseRequireSignedMode;
+exports.shouldAutowake = shouldAutowake;
+exports.buildSignedSendFields = buildSignedSendFields;
+exports.makeSnapshotVerifier = makeSnapshotVerifier;
+const primitives_js_1 = require("./primitives.js");
+const verify_js_1 = require("./verify.js");
+const store_js_1 = require("./store.js");
+/** How many identical advisory polls to swallow before a reminder. ~5s poll
+ *  → a reminder about every 10 minutes, not 150k lines in a day and a half. */
+exports.ADVISORY_REVOCATION_WARNING_SUMMARY_EVERY = 120;
+/** Process-local cap on identity+fleet throttle scopes. Eviction re-emits that
+ *  scope's next first-seen warning; it cannot mute a different live scope. */
+exports.ADVISORY_REVOCATION_WARNING_MAX_SCOPES = 64;
+const MAX_ADVISORY_KEYS_IN_LOG = 8;
+const MAX_ADVISORY_KID_CHARS = 32;
+/** Process-local only. Keyed by identity public key + fleet so one box cannot
+ *  mute another identity or fleet. Cleared when the advisory set goes empty. */
+const advisoryWarnByScope = new Map();
+/** Test-only isolation for the process-local Map. Not plugin runtime API. */
+function resetAdvisoryRevocationWarningStateForTests() {
+    advisoryWarnByScope.clear();
+}
+function advisoryScopeKey(identity, fleetId) {
+    return `${(0, store_js_1.identityPublicKey)(identity)}\0${fleetId ?? ""}`;
+}
+function touchAdvisoryScope(scopeKey, entry) {
+    advisoryWarnByScope.delete(scopeKey);
+    advisoryWarnByScope.set(scopeKey, entry);
+    while (advisoryWarnByScope.size > exports.ADVISORY_REVOCATION_WARNING_MAX_SCOPES) {
+        const oldest = advisoryWarnByScope.keys().next().value;
+        if (oldest === undefined || oldest === scopeKey)
+            break;
+        advisoryWarnByScope.delete(oldest);
+    }
+}
+/** Relay-supplied key IDs are untrusted. Escape C0/C1 controls (U+0000–U+001F,
+ *  U+007F–U+009F, including CSI/OSC) and Unicode line separators so each warning
+ *  stays one bounded line; truncate the escaped form, never the raw id. */
+function formatKidForLog(kid) {
+    let escaped = "";
+    for (const ch of kid) {
+        const code = ch.charCodeAt(0);
+        if (ch === "\\")
+            escaped += "\\\\";
+        else if (ch === "\n")
+            escaped += "\\n";
+        else if (ch === "\r")
+            escaped += "\\r";
+        else if (ch === "\t")
+            escaped += "\\t";
+        else if (ch === "\0")
+            escaped += "\\0";
+        else if (code < 0x20 || (code >= 0x7f && code <= 0x9f) || code === 0x2028 || code === 0x2029) {
+            escaped += `\\u${code.toString(16).padStart(4, "0")}`;
+        }
+        else {
+            escaped += ch;
+        }
+    }
+    if (escaped.length <= MAX_ADVISORY_KID_CHARS)
+        return escaped;
+    return `${escaped.slice(0, MAX_ADVISORY_KID_CHARS)}...`;
+}
+/** Bounded sample for the log line. Fingerprinting uses the complete sorted set. */
+function formatAdvisoryKeyList(kids) {
+    const shown = kids.slice(0, MAX_ADVISORY_KEYS_IN_LOG).map(formatKidForLog);
+    const omitted = kids.length - shown.length;
+    const list = shown.join(", ");
+    if (omitted <= 0)
+        return list;
+    return `${list} (+${omitted} omitted)`;
+}
+function formatAdvisoryWarning(kids) {
+    if (kids.length === 1) {
+        return (`[ekho] relay reports operator key ${formatKidForLog(kids[0])} as REVOKED without a valid revocation signature. ` +
+            `Treating the claim as ADVISORY: the key is NOT unpinned and NOT tombstoned, but it will not ` +
+            `be newly adopted until a signed revocation arrives.`);
+    }
+    return (`[ekho] relay reports ${kids.length} operator keys as REVOKED without a valid revocation signature: ` +
+        `${formatAdvisoryKeyList(kids)}. Treating the claim as ADVISORY: the keys are NOT unpinned and NOT ` +
+        `tombstoned, but they will not be newly adopted until a signed revocation arrives.`);
+}
+function formatAdvisorySummary(kids, suppressed) {
+    return (`[ekho] still treating ${kids.length} unsigned/invalid operator-key revocation claim(s) as ADVISORY ` +
+        `(suppressed ${suppressed} identical warning(s) this process). Keys: ${formatAdvisoryKeyList(kids)}. ` +
+        `Not unpinned, not tombstoned; still blocking new adoption.`);
+}
+/** One aggregate warning when the advisory set appears or changes; identical
+ *  repeats are silent; a bounded reminder keeps the condition visible; an empty
+ *  set forgets the scope so a later recurrence is logged again. Trust is
+ *  untouched — this is log volume only. */
+function warnAdvisoryRevocations(ctx, advisory) {
+    if (advisory.size === 0) {
+        advisoryWarnByScope.delete(ctx.scopeKey);
+        return;
+    }
+    const kids = [...advisory].sort();
+    // Canonical JSON is unambiguous; NUL-join collides `["a\0b"]` with `["a","b"]`.
+    const fingerprint = (0, primitives_js_1.sha256Hex)(JSON.stringify(kids));
+    const prev = advisoryWarnByScope.get(ctx.scopeKey);
+    if (!prev || prev.fingerprint !== fingerprint) {
+        ctx.log?.warn?.(formatAdvisoryWarning(kids));
+        touchAdvisoryScope(ctx.scopeKey, { fingerprint, suppressed: 0 });
+        return;
+    }
+    prev.suppressed += 1;
+    if (prev.suppressed >= exports.ADVISORY_REVOCATION_WARNING_SUMMARY_EVERY) {
+        ctx.log?.warn?.(formatAdvisorySummary(kids, prev.suppressed));
+        prev.suppressed = 0;
+        touchAdvisoryScope(ctx.scopeKey, prev);
+    }
+}
+/** Apply the relay's revocation / un-revocation claims to the working trust root
+ *  (#27). Mutates `pinned`, `revokedLedger` and `admissions` in place; a claim
+ *  only lands if a currently pinned operator key signed it. */
+function applyRelayKeyClaims(ctx) {
+    const out = {
+        advisory: new Set(),
+        pinRemoved: false,
+        ledgerChanged: false,
+        admissionsChanged: false
+    };
+    clearTombstonesOnSignedUnrevoke(ctx, out);
+    applySignedRevocations(ctx, out);
+    warnAdvisoryRevocations(ctx, out.advisory);
+    return out;
+}
+/** A SIGNED un-revoke clears a tombstone so the key can be re-admitted through
+ *  the endorsement chain. It never re-pins by itself — re-admission still costs
+ *  a valid endorsement. Runs before the revocation pass so a valid revocation in
+ *  the same batch still wins (fail closed).
+ *
+ *  The unsigned ABSENCE of `revoked` must never clear a tombstone: that was the
+ *  #14 hole, where a relay could resurrect a dead key just by not mentioning it.
+ *
+ *  #48: the payload now binds revoked_at_being_cleared + issued_at + nonce.
+ *  Missing bind fields refuse the un-revoke (fail closed). The relay still
+ *  does not emit unrevoke_sig. */
+function clearTombstonesOnSignedUnrevoke(ctx, out) {
+    for (const k of ctx.operatorKeys) {
+        const kid = k.key_id;
+        const sig = k.unrevoke_sig;
+        const revokedAt = k.unrevoke_revoked_at;
+        const issuedAt = k.unrevoke_issued_at;
+        const nonce = k.unrevoke_nonce;
+        if (!kid || !sig || !ctx.revokedLedger[kid])
+            continue;
+        if (!revokedAt || !issuedAt || !nonce) {
+            ctx.log?.warn?.(`[ekho] refusing un-revoke of operator key ${kid}: payload bind fields missing. ` +
+                `The tombstone stands.`);
+            continue;
+        }
+        if (!ctx.fleetId || !ctx.signedByAPinnedKey((0, primitives_js_1.unrevokePayload)(ctx.fleetId, kid, revokedAt, issuedAt, nonce), sig)) {
+            ctx.log?.warn?.(`[ekho] refusing un-revoke of operator key ${kid}: no currently pinned operator key signed it. ` +
+                `The tombstone stands.`);
+            continue;
+        }
+        // #52: the compare half of the compare-and-swap. Signing over
+        // revoked_at_being_cleared is only worth anything if apply-time checks it
+        // against the tombstone actually standing right now — otherwise a valid
+        // un-revoke captured for an OLD revocation clears whatever NEWER one has
+        // replaced it.
+        if (revokedAt !== ctx.revokedLedger[kid]) {
+            ctx.log?.warn?.(`[ekho] refusing un-revoke of operator key ${kid}: it is bound to a revocation at ${revokedAt}, ` +
+                `but the live tombstone is at ${ctx.revokedLedger[kid]} — a newer revocation this un-revoke ` +
+                `never authorized. The tombstone stands.`);
+            continue;
+        }
+        delete ctx.revokedLedger[kid];
+        out.ledgerChanged = true;
+        ctx.log?.info?.(`[ekho] operator key ${kid} un-revoked by a signed operator instruction; tombstone cleared. ` +
+            `The key is NOT re-pinned — it has to be re-endorsed by a pinned key.`);
+    }
+}
+/** A SIGNED revocation is the only thing that can remove trust. Anything less is
+ *  recorded as advisory: the key is skipped for new adoption and nothing else. */
+function applySignedRevocations(ctx, out) {
+    for (const k of ctx.operatorKeys) {
+        const kid = k.key_id;
+        if (!kid || !k.revoked)
+            continue;
+        const at = k.revoked_at;
+        const sig = k.revocation_sig;
+        const proven = Boolean(sig && at && ctx.fleetId && ctx.signedByAPinnedKey((0, primitives_js_1.revocationPayload)(ctx.fleetId, kid, at), sig));
+        if (!proven) {
+            noteAdvisoryClaim(out, kid);
+        }
+        else if (isLastPinnedKey(ctx, kid)) {
+            noteLastRootRefusal(ctx, kid);
+        }
+        else {
+            dropRevokedKey(ctx, out, kid, at);
+        }
+    }
+}
+/** The relay says a key is dead but cannot prove it. Skip the key for NEW
+ *  adoption, write nothing. Visibility is the process-local aggregate throttle
+ *  in warnAdvisoryRevocations — not a per-key line on every poll.
+ *
+ *  Deleting the pin here is the tempting one-liner and it is wrong twice over:
+ *  it lets whoever controls the relay drop trust unilaterally, AND a deleted pin
+ *  is re-admitted on the very next poll by the same still-valid endorsement.
+ *  Rejecting a key takes a revokedOperatorKeys tombstone, not a deletion — and a
+ *  tombstone takes a signature. */
+function noteAdvisoryClaim(out, kid) {
+    out.advisory.add(kid);
+}
+function isLastPinnedKey(ctx, kid) {
+    return Boolean(ctx.pinned[kid]) && Object.keys(ctx.pinned).length === 1;
+}
+/** Last-root protection: honoring this would leave the box with no trust root at
+ *  all — indistinguishable from the attack the signature requirement just
+ *  closed. Refuse the claim whole, so we never hold a key that is tombstoned
+ *  (unrecoverable) and still pinned (still trusted). */
+function noteLastRootRefusal(ctx, kid) {
+    ctx.log?.warn?.(`[ekho] refusing the signed revocation of operator key ${kid}: it is the LAST pinned operator key, ` +
+        `and honoring it would leave this agent with no trust root at all. Endorse a replacement key ` +
+        `first — the replacement makes this revocation safe to honor on the next poll.`);
+}
+/** Honor a proven revocation: tombstone, then unpin.
+ *
+ *  #14: the tombstone is the durable half. Unpinning alone never made a
+ *  revocation stick — the config seed re-added the key on the very next wake,
+ *  and TOFU/chaining would too. */
+function dropRevokedKey(ctx, out, kid, at) {
+    if (!ctx.revokedLedger[kid]) {
+        ctx.revokedLedger[kid] = at;
+        out.ledgerChanged = true;
+    }
+    if (ctx.pinned[kid]) {
+        Reflect.deleteProperty(ctx.pinned, kid);
+        out.pinRemoved = true;
+        ctx.log?.warn?.(`[ekho] operator key ${kid} is revoked (signed, at ${at}); it is no longer pinned.`);
+    }
+    if (ctx.admissions[kid]) {
+        // The admission record answers "why is this key trusted here?" — keep it
+        // only while the answer is "it is".
+        Reflect.deleteProperty(ctx.admissions, kid);
+        out.admissionsChanged = true;
+    }
+}
+/** Update pinned operator keys from the inbox. Adds a new key ONLY if endorsed by
+ *  an already-pinned key; removes one ONLY on a SIGNED revocation. Returns true
+ *  if the identity changed (and so must be persisted).
+ *
+ *  Trust mutates in one direction only, and never on the relay's say-so (#27).
+ *  An unsigned `revoked: true` is a HINT: the key is skipped for new adoption
+ *  and the claim is logged, but nothing is written and nothing is unpinned.
+ *  Treating it as authoritative (the #14 regression) meant one poll from a
+ *  compromised relay could tombstone and unpin an entire fleet's trust root,
+ *  permanently — the tombstone survives restarts by design, so the damage was
+ *  not even recoverable by restarting against an honest relay.
+ *
+ *  One deliberate exception to "no relay TOFU" (#5): an identity that has never
+ *  pinned ANY key can't grow a chain — endorsements need an already-pinned root,
+ *  so verification stayed dormant forever on every agent nobody hand-configured
+ *  (the Aug 2026 silent-drop incident). First contact with an empty pin set
+ *  adopts the relay's current non-revoked keys as the trust root, exactly once
+ *  (tofuAt latches). Enrollment already trusts the relay this much — it accepts
+ *  the shared secret over the same channel. Pre-pinning via config/env skips
+ *  TOFU entirely and stays the stronger option. */
+function syncPinnedOperatorKeys(identity, operatorKeys, fleetId, log = console) {
+    const pinned = { ...identity.pinnedOperatorKeys };
+    const revokedLedger = { ...(identity.revokedOperatorKeys ?? {}) };
+    const admissions = { ...(identity.operatorKeyAdmissions ?? {}) };
+    // The keys allowed to authorize a trust-root mutation this poll, snapshotted
+    // BEFORE any of them are applied. Frozen on purpose: verifying against the
+    // live map would make the outcome depend on the order the relay happened to
+    // serve its entries in, which is the relay's choice, not ours.
+    const authorities = { ...identity.pinnedOperatorKeys };
+    const signedByAPinnedKey = (payload, sig) => {
+        for (const pub of Object.values(authorities)) {
+            if ((0, primitives_js_1.verifyCanonical)(payload, sig, (0, primitives_js_1.fromB64url)(pub)))
+                return true;
+        }
+        return false;
+    };
+    // Phases 1 and 2 (#27) — mutates `pinned` / `revokedLedger` / `admissions` in
+    // place and reports back what it touched.
+    const claims = applyRelayKeyClaims({
+        operatorKeys,
+        fleetId,
+        log,
+        pinned,
+        revokedLedger,
+        admissions,
+        signedByAPinnedKey,
+        scopeKey: advisoryScopeKey(identity, fleetId)
+    });
+    const advisory = claims.advisory;
+    let changed = claims.pinRemoved;
+    let admissionsChanged = claims.admissionsChanged;
+    if (claims.ledgerChanged) {
+        identity.revokedOperatorKeys = revokedLedger;
+        changed = true; // must persist, even when the key was never pinned here
+    }
+    if (Object.keys(pinned).length === 0 && !identity.tofuAt) {
+        let adopted = false;
+        const at = new Date().toISOString();
+        for (const k of operatorKeys) {
+            if (k.key_id && k.public_key && !advisory.has(k.key_id) && !revokedLedger[k.key_id]) {
+                pinned[k.key_id] = k.public_key;
+                admissions[k.key_id] = { admitted_by: "tofu", admitted_at: at }; // #26
+                admissionsChanged = true;
+                adopted = true;
+            }
+        }
+        if (adopted) {
+            // Latch only when something was adopted — an empty roster now must not
+            // burn the one TOFU opportunity of a fresh identity. (Tracked separately
+            // from `changed`, which a revocation tombstone alone can now set.)
+            identity.tofuAt = at;
+            identity.pinnedOperatorKeys = pinned;
+            identity.operatorKeyAdmissions = admissions;
+            return true;
+        }
+    }
+    for (const k of operatorKeys) {
+        const kid = k.key_id;
+        if (!kid)
+            continue;
+        if (pinned[kid])
+            continue;
+        if (revokedLedger[kid])
+            continue; // #14: a tombstoned key never comes back
+        if (advisory.has(kid))
+            continue; // #27: claimed-revoked → no NEW adoption
+        const endorser = k.endorsed_by_key_id;
+        const esig = k.endorsement_sig;
+        const pub = k.public_key;
+        if (endorser && esig && pub && fleetId && pinned[endorser]) {
+            if ((0, primitives_js_1.verifyCanonical)((0, primitives_js_1.endorsementPayload)(fleetId, kid, pub), esig, (0, primitives_js_1.fromB64url)(pinned[endorser]))) {
+                pinned[kid] = pub;
+                changed = true;
+                // #26: keep the endorsement we just verified, so this box can answer
+                // "why is this key trusted here?" offline — the relay is exactly the
+                // party we would otherwise have to ask.
+                admissions[kid] = {
+                    admitted_by: "chain",
+                    endorsed_by_key_id: endorser,
+                    endorsement_sig: esig,
+                    admitted_at: new Date().toISOString()
+                };
+                admissionsChanged = true;
+            }
+        }
+    }
+    if (changed)
+        identity.pinnedOperatorKeys = pinned;
+    if (admissionsChanged) {
+        identity.operatorKeyAdmissions = admissions;
+        changed = true;
+    }
+    return changed;
+}
+function verifyBatch(messages, opts) {
+    const operatorKeys = { ...(opts.identity.pinnedOperatorKeys ?? {}) };
+    const out = {};
+    if (Object.keys(operatorKeys).length === 0 || !opts.fleetId) {
+        for (const m of messages)
+            out[String(m.message_id)] = null;
+        return out;
+    }
+    const rosterByAgent = {};
+    for (const r of opts.roster)
+        if (r.agent_id)
+            rosterByAgent[String(r.agent_id)] = r;
+    for (const m of messages) {
+        out[String(m.message_id)] = (0, verify_js_1.verifyInbound)(m, {
+            selfAgentId: opts.selfAgentId,
+            fleetId: opts.fleetId,
+            operatorKeys,
+            rosterByAgent,
+            seenNonces: opts.seenNonces,
+            now: opts.now
+        });
+    }
+    return out;
+}
+function parseRequireSignedMode(raw) {
+    const v = String(raw ?? "").trim().toLowerCase();
+    return v === "require" || v === "off" ? v : "warn";
+}
+/** The execution-authority gate. Signed → act iff verified; signed-but-invalid →
+ *  blocked; unsigned → per requireSigned mode (see above). */
+function shouldAutowake(msg, verification, operatorTrusted, peerEnabled, requireSigned = "warn") {
+    const isOperator = msg.sender_kind === "operator";
+    const signed = Boolean(isOperator ? msg.operator_sig : msg.agent_sig);
+    if (isOperator) {
+        if (signed && verification)
+            return Boolean(verification.verified);
+        return Boolean(operatorTrusted);
+    }
+    if (!peerEnabled)
+        return false;
+    if (requireSigned === "require") {
+        // Fail closed: signed AND verified, nothing less. A null verification
+        // (no pinned keys yet) is exactly the dormant state this mode refuses
+        // to treat as trustworthy.
+        return Boolean(signed && verification && verification.verified);
+    }
+    if (signed && verification)
+        return Boolean(verification.verified);
+    return true;
+}
+/** Sign an outbound peer message so recipients can verify it came from us.
+ *
+ *  v2 (#9) extends coverage to message_type, priority and the attachment ids —
+ *  previously a compromised relay could relabel a message (direct → alert) or
+ *  swap its attachments under a still-valid signature. Compatibility is free in
+ *  both directions: verifiers check the signature over the WHOLE canonical and
+ *  only bind the fields they know, so old verifiers accept v2 envelopes and new
+ *  verifiers enforce the extra bindings only when the envelope declares v>=2. */
+function buildSignedSendFields(opts) {
+    const seed = new Uint8Array(Buffer.from(opts.identity.seedHex, "hex"));
+    const kid = (0, primitives_js_1.keyId)((0, primitives_js_1.fromB64url)((0, primitives_js_1.publicKeyB64urlFromSeed)(seed)));
+    const canonical = {
+        v: 2,
+        fleet_id: opts.fleetId,
+        sender_agent_id: opts.selfAgentId,
+        key_id: kid,
+        recipient: opts.recipient,
+        conversation_id: opts.conversationId,
+        body_sha256: (0, primitives_js_1.sha256Hex)(opts.bodyText),
+        sent_at: opts.sentAt,
+        nonce: opts.nonce,
+        message_type: opts.messageType,
+        priority: opts.priority,
+        attachments: [...(opts.attachments ?? [])].sort()
+    };
+    return { agent_sig: (0, primitives_js_1.signCanonical)(canonical, seed), key_id: kid, sig_canonical: canonical };
+}
+/** The fail-closed default (#20): when verification cannot run — no pinned
+ *  operator keys, no fleet id, no identity — every snapshot is UNVERIFIED.
+ *  Never "it has a signature field, so call it signed". */
+const NO_SNAPSHOT_VERIFICATION = () => false;
+exports.NO_SNAPSHOT_VERIFICATION = NO_SNAPSHOT_VERIFICATION;
+/**
+ * Build the snapshot verifier for one turn, from the same trust root the
+ * autowake path uses: this agent's pinned operator keys plus the batch roster.
+ *
+ * Runs the ordinary inbound verifier (`verifyInbound`) over a snapshot mapped
+ * into its `SignedMessage` shape — there is deliberately no second, laxer
+ * verifier for quoted text. Two consequences worth naming:
+ *
+ *  - An older relay that omits `sig_canonical` (or the v2-bound `message_type` /
+ *    `priority` / `attachments`) simply fails the checks, so its snapshots read
+ *    UNVERIFIED. That is the intended direction to fail in.
+ *  - The nonce set is fresh per turn rather than the live seen-nonce set. A
+ *    quote is by definition a re-presentation of a message that may already
+ *    have been delivered and had its nonce burned; the burn exists to stop a
+ *    replayed message WAKING a turn, and a snapshot can never wake one. The
+ *    staleness window is left at the verifier's default, so a snapshot replayed
+ *    from beyond it still reads UNVERIFIED.
+ */
+function makeSnapshotVerifier(opts) {
+    const operatorKeys = { ...(opts.identity?.pinnedOperatorKeys ?? {}) };
+    const fleetId = opts.fleetId;
+    if (Object.keys(operatorKeys).length === 0 || !fleetId)
+        return exports.NO_SNAPSHOT_VERIFICATION;
+    const rosterByAgent = {};
+    for (const r of opts.roster ?? [])
+        if (r.agent_id)
+            rosterByAgent[String(r.agent_id)] = r;
+    return (snapshot) => {
+        if (!snapshot || typeof snapshot !== "object")
+            return false;
+        const asMessage = {
+            message_id: snapshot.message_id,
+            sender_kind: snapshot.sender_kind,
+            sender_agent_id: snapshot.sender_agent_id,
+            message_type: snapshot.message_type,
+            priority: snapshot.priority,
+            // `text` -> `body.text`: body_sha256 must bind the snapshot's own text.
+            body: {
+                text: typeof snapshot.text === "string" ? snapshot.text : "",
+                attachments: Array.isArray(snapshot.attachments) ? snapshot.attachments : []
+            },
+            operator_sig: snapshot.operator_sig ?? null,
+            agent_sig: snapshot.agent_sig ?? null,
+            key_id: snapshot.key_id ?? null,
+            sig_canonical: snapshot.sig_canonical ?? null
+        };
+        return (0, verify_js_1.verifyInbound)(asMessage, {
+            selfAgentId: opts.selfAgentId,
+            fleetId,
+            operatorKeys,
+            rosterByAgent,
+            seenNonces: new Set(),
+            now: opts.now
+        }).verified;
+    };
+}
+//# sourceMappingURL=verification.js.map

package/dist/identity/verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.js","sourceRoot":"","sources":["../../src/identity/verification.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,2EAA2E;AAC3E,2DAA2D;;;AAmF3D,kGAEC;AAoQD,wDAkGC;AAED,kCA8BC;AAaD,wDAGC;AAID,wCAsBC;AAUD,sDA8BC;AA+CD,oDAuCC;AAjoBD,mDAUyB;AACzB,2CAAyG;AACzG,yCAA6F;AAkD7F;+EAC+E;AAClE,QAAA,yCAAyC,GAAG,GAAG,CAAC;AAC7D;8EAC8E;AACjE,QAAA,sCAAsC,GAAG,EAAE,CAAC;AACzD,MAAM,wBAAwB,GAAG,CAAC,CAAC;AACnC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAOlC;gFACgF;AAChF,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEjE,6EAA6E;AAC7E,SAAgB,2CAA2C;IACzD,mBAAmB,CAAC,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAsB,EAAE,OAAkC;IAClF,OAAO,GAAG,IAAA,4BAAiB,EAAC,QAAQ,CAAC,KAAK,OAAO,IAAI,EAAE,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB,EAAE,KAAwB;IACpE,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACzC,OAAO,mBAAmB,CAAC,IAAI,GAAG,8CAAsC,EAAE,CAAC;QACzE,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QACvD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ;YAAE,MAAM;QACvD,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;2EAE2E;AAC3E,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,EAAE,KAAK,IAAI;YAAE,OAAO,IAAI,MAAM,CAAC;aAC9B,IAAI,EAAE,KAAK,IAAI;YAAE,OAAO,IAAI,KAAK,CAAC;aAClC,IAAI,EAAE,KAAK,IAAI;YAAE,OAAO,IAAI,KAAK,CAAC;aAClC,IAAI,EAAE,KAAK,IAAI;YAAE,OAAO,IAAI,KAAK,CAAC;aAClC,IAAI,EAAE,KAAK,IAAI;YAAE,OAAO,IAAI,KAAK,CAAC;aAClC,IAAI,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7F,OAAO,IAAI,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,IAAI,sBAAsB;QAAE,OAAO,OAAO,CAAC;IAC7D,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,KAAK,CAAC;AAC1D,CAAC;AAED,oFAAoF;AACpF,SAAS,qBAAqB,CAAC,IAAc;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,GAAG,IAAI,MAAM,OAAO,WAAW,CAAC;AACzC,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAc;IAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CACL,qCAAqC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,oDAAoD;YAC/G,8FAA8F;YAC9F,qDAAqD,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,CACL,wBAAwB,IAAI,CAAC,MAAM,kEAAkE;QACnG,GAAG,qBAAqB,CAAC,IAAI,CAAC,sEAAsE;QACpG,mFAAmF,CACtF,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAc,EAAE,UAAkB;IAC/D,OAAO,CACL,yBAAyB,IAAI,CAAC,MAAM,iEAAiE;QACnG,eAAe,UAAU,8CAA8C,qBAAqB,CAAC,IAAI,CAAC,IAAI;QACtG,4DAA4D,CAC/D,CAAC;AACJ,CAAC;AAED;;;2CAG2C;AAC3C,SAAS,uBAAuB,CAAC,GAAa,EAAE,QAAqB;IACnE,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,gFAAgF;IAChF,MAAM,WAAW,GAAG,IAAA,yBAAS,EAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QAC9C,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IACD,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;IACrB,IAAI,IAAI,CAAC,UAAU,IAAI,iDAAyC,EAAE,CAAC;QACjE,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;+DAE+D;AAC/D,SAAS,mBAAmB,CAAC,GAAa;IACxC,MAAM,GAAG,GAAmB;QAC1B,QAAQ,EAAE,IAAI,GAAG,EAAU;QAC3B,UAAU,EAAE,KAAK;QACjB,aAAa,EAAE,KAAK;QACpB,iBAAiB,EAAE,KAAK;KACzB,CAAC;IACF,+BAA+B,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1C,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjC,uBAAuB,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;kCAUkC;AAClC,SAAS,+BAA+B,CAAC,GAAa,EAAE,GAAmB;IACzE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,MAAM,GAAG,GAAG,CAAC,CAAC,YAAY,CAAC;QAC3B,MAAM,SAAS,GAAG,CAAC,CAAC,mBAAmB,CAAC;QACxC,MAAM,QAAQ,GAAG,CAAC,CAAC,kBAAkB,CAAC;QACtC,MAAM,KAAK,GAAG,CAAC,CAAC,cAAc,CAAC;QAC/B,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC;YAAE,SAAS;QACtD,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACtC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CACb,6CAA6C,GAAG,iCAAiC;gBAC/E,uBAAuB,CAC1B,CAAC;YACF,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAA,+BAAe,EAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAChH,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CACb,6CAA6C,GAAG,gDAAgD;gBAC9F,uBAAuB,CAC1B,CAAC;YACF,SAAS;QACX,CAAC;QACD,8DAA8D;QAC9D,0EAA0E;QAC1E,wEAAwE;QACxE,yEAAyE;QACzE,eAAe;QACf,IAAI,SAAS,KAAK,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CACb,6CAA6C,GAAG,oCAAoC,SAAS,IAAI;gBAC/F,gCAAgC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,uCAAuC;gBAC7F,yCAAyC,CAC5C,CAAC;YACF,SAAS;QACX,CAAC;QACD,OAAO,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC9B,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC;QACzB,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CACb,uBAAuB,GAAG,mEAAmE;YAC3F,sEAAsE,CACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;kFACkF;AAClF,SAAS,sBAAsB,CAAC,GAAa,EAAE,GAAmB;IAChE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,SAAS;QACjC,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC;QACxB,MAAM,GAAG,GAAG,CAAC,CAAC,cAAc,CAAC;QAC7B,MAAM,MAAM,GAAG,OAAO,CACpB,GAAG,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,kBAAkB,CAAC,IAAA,iCAAiB,EAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CACjG,CAAC;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACrC,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;mCAQmC;AACnC,SAAS,iBAAiB,CAAC,GAAmB,EAAE,GAAW;IACzD,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,eAAe,CAAC,GAAa,EAAE,GAAW;IACjD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED;;;wDAGwD;AACxD,SAAS,mBAAmB,CAAC,GAAa,EAAE,GAAW;IACrD,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CACb,yDAAyD,GAAG,wCAAwC;QAClG,8FAA8F;QAC9F,+EAA+E,CAClF,CAAC;AACJ,CAAC;AAED;;;;mCAImC;AACnC,SAAS,cAAc,CAAC,GAAa,EAAE,GAAmB,EAAE,GAAW,EAAE,EAAU;IACjF,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QAC5B,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC;IAC3B,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACxC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;QACtB,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,uBAAuB,GAAG,2BAA2B,EAAE,4BAA4B,CAAC,CAAC;IACvG,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,yEAAyE;QACzE,oCAAoC;QACpC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC5C,GAAG,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;mDAmBmD;AACnD,SAAgB,sBAAsB,CACpC,QAAsB,EACtB,YAAoC,EACpC,OAAkC,EAClC,MAAe,OAAO;IAEtB,MAAM,MAAM,GAA2B,EAAE,GAAG,QAAQ,CAAC,kBAAkB,EAAE,CAAC;IAC1E,MAAM,aAAa,GAA2B,EAAE,GAAG,CAAC,QAAQ,CAAC,mBAAmB,IAAI,EAAE,CAAC,EAAE,CAAC;IAC1F,MAAM,UAAU,GAAyC,EAAE,GAAG,CAAC,QAAQ,CAAC,qBAAqB,IAAI,EAAE,CAAC,EAAE,CAAC;IAEvG,6EAA6E;IAC7E,2EAA2E;IAC3E,4EAA4E;IAC5E,+DAA+D;IAC/D,MAAM,WAAW,GAA2B,EAAE,GAAG,QAAQ,CAAC,kBAAkB,EAAE,CAAC;IAC/E,MAAM,kBAAkB,GAAG,CAAC,OAAgB,EAAE,GAAW,EAAW,EAAE;QACpE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7C,IAAI,IAAA,+BAAe,EAAC,OAAO,EAAE,GAAG,EAAE,IAAA,0BAAU,EAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QAClE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,8EAA8E;IAC9E,0CAA0C;IAC1C,MAAM,MAAM,GAAG,mBAAmB,CAChC;QACE,YAAY;QACZ,OAAO;QACP,GAAG;QACH,MAAM;QACN,aAAa;QACb,UAAU;QACV,kBAAkB;QAClB,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC;KAC9C,CACF,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,IAAI,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC;IAChC,IAAI,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAEjD,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,QAAQ,CAAC,mBAAmB,GAAG,aAAa,CAAC;QAC7C,OAAO,GAAG,IAAI,CAAC,CAAC,wDAAwD;IAC1E,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACzD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpF,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;gBAChC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM;gBACvE,iBAAiB,GAAG,IAAI,CAAC;gBACzB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,uEAAuE;YACvE,yEAAyE;YACzE,mEAAmE;YACnE,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC;YACrB,QAAQ,CAAC,kBAAkB,GAAG,MAAM,CAAC;YACrC,QAAQ,CAAC,qBAAqB,GAAG,UAAU,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,MAAM,CAAC,GAAG,CAAC;YAAE,SAAS;QAC1B,IAAI,aAAa,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,yCAAyC;QAC3E,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,yCAAyC;QAC1E,MAAM,QAAQ,GAAG,CAAC,CAAC,kBAAkB,CAAC;QACtC,MAAM,IAAI,GAAG,CAAC,CAAC,eAAe,CAAC;QAC/B,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC;QACzB,IAAI,QAAQ,IAAI,IAAI,IAAI,GAAG,IAAI,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,IAAI,IAAA,+BAAe,EAAC,IAAA,kCAAkB,EAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,IAAA,0BAAU,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/F,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;gBAClB,OAAO,GAAG,IAAI,CAAC;gBACf,qEAAqE;gBACrE,qEAAqE;gBACrE,wCAAwC;gBACxC,UAAU,CAAC,GAAG,CAAC,GAAG;oBAChB,WAAW,EAAE,OAAO;oBACpB,kBAAkB,EAAE,QAAQ;oBAC5B,eAAe,EAAE,IAAI;oBACrB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACtC,CAAC;gBACF,iBAAiB,GAAG,IAAI,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,OAAO;QAAE,QAAQ,CAAC,kBAAkB,GAAG,MAAM,CAAC;IAClD,IAAI,iBAAiB,EAAE,CAAC;QACtB,QAAQ,CAAC,qBAAqB,GAAG,UAAU,CAAC;QAC5C,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,WAAW,CACzB,QAAyB,EACzB,IAOC;IAED,MAAM,YAAY,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,IAAI,EAAE,CAAC,EAAE,CAAC;IACrE,MAAM,GAAG,GAAwC,EAAE,CAAC;IACpD,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5D,KAAK,MAAM,CAAC,IAAI,QAAQ;YAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC;QAC3D,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,aAAa,GAAoC,EAAE,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,CAAC,QAAQ;YAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;IACnF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,IAAA,yBAAa,EAAC,CAAC,EAAE;YAC3C,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY;YACZ,aAAa;YACb,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAaD,SAAgB,sBAAsB,CAAC,GAA8B;IACnE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACrD,CAAC;AAED;8DAC8D;AAC9D,SAAgB,cAAc,CAC5B,GAAkB,EAClB,YAA6C,EAC7C,eAAwB,EACxB,WAAoB,EACpB,gBAAmC,MAAM;IAEzC,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,KAAK,UAAU,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtE,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,MAAM,IAAI,YAAY;YAAE,OAAO,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAClE,OAAO,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAC/B,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,sEAAsE;QACtE,sEAAsE;QACtE,2BAA2B;QAC3B,OAAO,OAAO,CAAC,MAAM,IAAI,YAAY,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,MAAM,IAAI,YAAY;QAAE,OAAO,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;iFAOiF;AACjF,SAAgB,qBAAqB,CAAC,IAYrC;IACC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,IAAA,qBAAW,EAAC,IAAA,0BAAU,EAAC,IAAA,uCAAuB,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,SAAS,GAA4B;QACzC,CAAC,EAAE,CAAC;QACJ,QAAQ,EAAE,IAAI,CAAC,OAAO;QACtB,eAAe,EAAE,IAAI,CAAC,WAAW;QACjC,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,eAAe,EAAE,IAAI,CAAC,cAAc;QACpC,WAAW,EAAE,IAAA,yBAAS,EAAC,IAAI,CAAC,QAAQ,CAAC;QACrC,OAAO,EAAE,IAAI,CAAC,MAAM;QACpB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,YAAY,EAAE,IAAI,CAAC,WAAW;QAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;KAClD,CAAC;IACF,OAAO,EAAE,SAAS,EAAE,IAAA,6BAAa,EAAC,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAC9F,CAAC;AAwBD;;2DAE2D;AACpD,MAAM,wBAAwB,GAAqB,GAAG,EAAE,CAAC,KAAK,CAAC;AAAzD,QAAA,wBAAwB,4BAAiC;AAEtE;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,oBAAoB,CAAC,IAMpC;IACC,MAAM,YAAY,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,IAAI,EAAE,CAAC,EAAE,CAAC;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,gCAAwB,CAAC;IACxF,MAAM,aAAa,GAAoC,EAAE,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE;QAAE,IAAI,CAAC,CAAC,QAAQ;YAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;IACzF,OAAO,CAAC,QAAQ,EAAE,EAAE;QAClB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5D,MAAM,SAAS,GAAkB;YAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,wEAAwE;YACxE,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAC5D,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;aAC7E;YACD,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,IAAI;YAC3C,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;YACrC,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,IAAI;YAC/B,aAAa,EAAE,QAAQ,CAAC,aAAa,IAAI,IAAI;SAC9C,CAAC;QACF,OAAO,IAAA,yBAAa,EAAC,SAAS,EAAE;YAC9B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO;YACP,YAAY;YACZ,aAAa;YACb,UAAU,EAAE,IAAI,GAAG,EAAU;YAC7B,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC,QAAQ,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}

package/dist/identity/verify.d.ts

@@ -0,0 +1,41 @@
+export interface SignedMessage {
+    message_id?: string;
+    sender_kind?: string;
+    sender_agent_id?: string;
+    message_type?: string;
+    priority?: string;
+    body?: {
+        text?: string;
+    } & Record<string, unknown>;
+    operator_sig?: string | null;
+    agent_sig?: string | null;
+    key_id?: string | null;
+    sig_canonical?: Record<string, unknown> | null;
+}
+export interface RosterEntryLike {
+    agent_id?: string;
+    identity_public_key?: string | null;
+    key_id?: string | null;
+    endorsed_by_key_id?: string | null;
+    endorsement_sig?: string | null;
+}
+export interface VerifyResult {
+    verified: boolean;
+    kind: "operator" | "peer";
+    reason: string | null;
+    keyId: string | null;
+}
+export interface VerifyOpts {
+    selfAgentId: string;
+    fleetId: string;
+    operatorKeys: Record<string, string>;
+    rosterByAgent: Record<string, RosterEntryLike>;
+    seenNonces: Set<string>;
+    now: Date;
+    maxSkewSeconds?: number;
+    maxFutureSkewSeconds?: number;
+}
+export declare const MAX_PAST_SKEW_SECONDS: number;
+export declare const MAX_FUTURE_SKEW_SECONDS = 300;
+export declare function verifyInbound(msg: SignedMessage, opts: VerifyOpts): VerifyResult;
+//# sourceMappingURL=verify.d.ts.map

package/dist/identity/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/identity/verify.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC/C,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,GAAG,EAAE,IAAI,CAAC;IACV,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AASD,eAAO,MAAM,qBAAqB,QAAc,CAAC;AACjD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,CA8EhF"}