@cello-protocol/daemon 0.0.228 → 0.0.230

package/dist/channel-publisher.js

@@ -0,0 +1,394 @@
+import { decodeRelayPostReceipt, encodeBroadcastArtifact, encodeChannelInfo, signBroadcastArtifact, signChannelInfo, verifyRelayPostReceipt, buildChannelPruneTbs, } from "@cello-protocol/protocol-types";
+/**
+ * Gap between deposits during a refill, so a long backlog stays under the relay's per-publisher
+ * rate limit. Only `resendMissing` paces — an ordinary publish is two deposits and pacing it would
+ * add latency to every post to protect against a burst that cannot happen.
+ */
+export const DEFAULT_RESEND_PACE_MS = 50;
+export class ChannelPublisher {
+    #opts;
+    #now;
+    constructor(opts) {
+        this.#opts = opts;
+        this.#now = opts.now ?? (() => Date.now());
+    }
+    async publish(agentName, channelHex, title, body, correlationId) {
+        const { logger, log } = this.#opts;
+        const info = this.#opts.channelInfo(channelHex);
+        if (!info)
+            return { ok: false, reason: "channel_unknown", detail: "no channel info for that pubkey" };
+        const channelKey = this.#opts.getChannelKey(channelHex);
+        const agentKey = this.#opts.getAgentKey(agentName);
+        if (!channelKey || !agentKey) {
+            return { ok: false, reason: "key_unavailable", detail: "the channel key or the agent key is not loaded" };
+        }
+        // 1. Screen BEFORE anything is signed or stored. The subscriber's inbound screen is the
+        //    enforcement; this is the early check that spares an honest publisher the friction of
+        //    publishing something every reader will refuse.
+        const verdict = await this.#opts.screenOutbound(new TextEncoder().encode(`${title}\n${body}`), { agentName, ...(correlationId !== undefined ? { correlationId } : {}) });
+        if (verdict.disposition !== "allow") {
+            logger.info("channel.publish.refused", {
+                ...(correlationId !== undefined ? { correlationId } : {}),
+                channel_pubkey: channelHex, disposition: verdict.disposition, reason: verdict.reason ?? "blocked",
+            });
+            return { ok: false, reason: "blocked_by_screen", detail: verdict.reason ?? verdict.disposition };
+        }
+        // 2. A public channel is readable by anyone, so encrypting it would be theatre — and would lock
+        //    out the subscribers it exists for, who hold no key.
+        const plaintext = new TextEncoder().encode(body);
+        const wire = info.access === "public" ? plaintext : await this.#opts.encryptBody(plaintext, channelHex);
+        // 3. Position and signatures.
+        log.ensureChannel(channelHex);
+        const { seq } = log.nextPosition(channelHex);
+        let post;
+        try {
+            post = await signBroadcastArtifact(channelKey, agentKey, {
+                seq, published_at: this.#now(), title, body: wire, supersedes: null, ext: null,
+            });
+        }
+        catch (err) {
+            return { ok: false, reason: "post_invalid", detail: extract(err) };
+        }
+        // 4. THE LOG, BEFORE THE NETWORK.
+        log.append(channelHex, post, correlationId);
+        // 5. Both relays, in parallel — a deposit is independent of the other, and making the second
+        //    wait on the first would double the latency of the ordinary case for no gain.
+        let deposited = await Promise.all(info.relays.map((relay) => this.#depositOnce(relay, post, channelHex, correlationId)));
+        let ok = deposited.filter((d) => d.ok);
+        /**
+         * ⚠️ **THE CLOCK-SKEW CORRECTION IS ONE POST FOR ALL RELAYS, AND ONLY WHILE NONE HAS TAKEN IT.**
+         *
+         * `published_at` is inside both signatures, so a corrected post is different BYTES at the same
+         * number. Correcting per relay would let relay A hold one body at seq N and relay B another —
+         * and a subscriber taking the union of the two sees exactly what a fork looks like, produced by
+         * an honest publisher with a wrong clock. So the correction happens here, once, and only when
+         * NO relay accepted the original: a relay that already answered holds a receipt bound to those
+         * bytes by hash, and re-signing under it would strand the proof.
+         */
+        if (ok.length === 0 && deposited.some((d) => d.reason === "clock_skew")) {
+            const corrected = await this.#resignForSkew(agentName, channelHex, post, deposited, correlationId);
+            if (corrected) {
+                post = corrected;
+                deposited = await Promise.all(info.relays.map((relay) => this.#depositOnce(relay, post, channelHex, correlationId)));
+                ok = deposited.filter((d) => d.ok);
+            }
+        }
+        logger.info("channel.post.published", {
+            ...(correlationId !== undefined ? { correlationId } : {}),
+            channel_pubkey: channelHex,
+            seq,
+            relays_ok: ok.map((d) => d.relay),
+            relays_failed: deposited.filter((d) => !d.ok).map((d) => d.relay),
+        });
+        if (ok.length === 0) {
+            // The post STAYS in the log. A retry must send these bytes, not a new post at a new number:
+            // the number and the time are inside both signatures.
+            return { ok: false, reason: "no_relay_accepted", seq, deposited };
+        }
+        return { ok: true, seq, deposited };
+    }
+    /**
+     * One deposit on one relay. No retry lives here — see the skew note in `publish`, which is where
+     * a correction has to happen if it is to produce the same bytes for every relay.
+     *
+     * A relay that TOOK the post is `ok: true` even when its receipt could not be filed. The two facts
+     * are reported separately because folding them together turned a post that is safely on two relays
+     * into `no_relay_accepted`, and sent the operator to resend something already there.
+     */
+    async #depositOnce(relay, post, channelHex, correlationId) {
+        const { logger } = this.#opts;
+        let answer;
+        try {
+            answer = await this.#opts.deposit(relay, { post_cbor: encodeBroadcastArtifact(post) });
+        }
+        catch (err) {
+            logger.warn("channel.post.deposit_failed", {
+                ...(correlationId !== undefined ? { correlationId } : {}),
+                channel_pubkey: channelHex, seq: post.seq, relay, reason: extract(err),
+            });
+            return { relay, ok: false, reason: extract(err) };
+        }
+        if (answer.ok) {
+            const filed = this.#storeReceipt(channelHex, post, answer.receipt_cbor, relay, correlationId);
+            return filed.ok ? { relay, ok: true } : { relay, ok: true, receipt_unfiled: filed.reason };
+        }
+        logger.warn("channel.post.deposit_failed", {
+            ...(correlationId !== undefined ? { correlationId } : {}),
+            channel_pubkey: channelHex, seq: post.seq, relay, reason: answer.reason,
+        });
+        return {
+            relay, ok: false, reason: answer.reason,
+            ...(answer.skew_ms !== undefined ? { skew_ms: answer.skew_ms } : {}),
+        };
+    }
+    /**
+     * Re-sign a post ONCE at a clock the relays will accept, and put the corrected bytes in the log.
+     *
+     * The correction is the LARGEST skew any relay reported: a post the fastest relay will take is one
+     * the others will too, and correcting to the smallest would leave the strictest relay refusing
+     * again with no retry left.
+     *
+     * Returns `null` when the correction cannot be made — the keys are gone, or the log refuses to
+     * replace bytes it has already receipted. `null` leaves the ORIGINAL post standing, which is the
+     * safe direction: the post is in the log at its number and `resendMissing` can carry it later.
+     */
+    async #resignForSkew(agentName, channelHex, post, deposited, correlationId) {
+        const { logger } = this.#opts;
+        const channelKey = this.#opts.getChannelKey(channelHex);
+        // BY NAME, from the caller. This read the empty string once, which is no agent, so the lookup
+        // was always null and the correction never ran in production — the test harness ignored the
+        // argument, so nothing said so.
+        const agentKey = this.#opts.getAgentKey(agentName);
+        if (!channelKey || !agentKey) {
+            logger.warn("channel.post.resign_failed", {
+                ...(correlationId !== undefined ? { correlationId } : {}),
+                channel_pubkey: channelHex, seq: post.seq, reason: "key_unavailable",
+            });
+            return null;
+        }
+        const skews = deposited.map((d) => d.skew_ms ?? 0);
+        const corrected = this.#now() - Math.max(...skews);
+        let resigned;
+        try {
+            resigned = await signBroadcastArtifact(channelKey, agentKey, {
+                seq: post.seq, published_at: corrected, title: post.title,
+                body: post.body, supersedes: post.supersedes, ext: null,
+            });
+            this.#opts.log.replaceUnreceipted(channelHex, resigned, correlationId);
+        }
+        catch (err) {
+            logger.warn("channel.post.resign_failed", {
+                ...(correlationId !== undefined ? { correlationId } : {}),
+                channel_pubkey: channelHex, seq: post.seq, reason: extract(err),
+            });
+            return null;
+        }
+        return resigned;
+    }
+    /** Verify a receipt against the post it names before storing it; an unverified one is worthless. */
+    #storeReceipt(channelHex, post, receiptCbor, relay, correlationId) {
+        const decoded = decodeRelayPostReceipt(receiptCbor);
+        if (!decoded.ok || !verifyRelayPostReceipt(decoded.receipt, post)) {
+            this.#opts.logger.warn("channel.post.deposit_failed", {
+                ...(correlationId !== undefined ? { correlationId } : {}),
+                channel_pubkey: channelHex, seq: post.seq, relay, reason: "receipt_invalid",
+            });
+            return { ok: false, reason: "receipt_invalid" };
+        }
+        try {
+            this.#opts.log.recordReceipt(channelHex, decoded.receipt, correlationId);
+            return { ok: true };
+        }
+        catch (err) {
+            // A receipt naming bytes this log does not hold. The relay DID take the post — the caller
+            // reports that separately, because calling the deposit failed would send the operator to
+            // resend a post the relay already has.
+            this.#opts.logger.warn("channel.post.receipt_unfiled", {
+                ...(correlationId !== undefined ? { correlationId } : {}),
+                channel_pubkey: channelHex, seq: post.seq, relay, reason: extract(err),
+            });
+            return { ok: false, reason: extract(err) };
+        }
+    }
+    /**
+     * Re-deposit everything a relay has not receipted, oldest first.
+     *
+     * This is what refills a relay that lost content and what fills a newly added one — the same path,
+     * which is why it is exercised by ordinary operation rather than only by a crash.
+     */
+    async resendMissing(agentName, channelHex, relay, correlationId) {
+        const { log, logger } = this.#opts;
+        // A channel that has been set up but never published has no log row yet, and `head` THROWS on
+        // one. Nothing to resend is an ANSWER — `deposited: 0` — not an error: a freshly created channel
+        // is the most likely thing an operator runs this against, and it came back looking broken.
+        log.ensureChannel(channelHex);
+        const head = log.head(channelHex);
+        if (head.first_seq === null || head.last_seq === null)
+            return { deposited: 0 };
+        /**
+         * ⚠️ WHAT THE RELAY HOLDS NOW, NOT WHAT IT ONCE RECEIPTED — and this is a deviation from the
+         * order, raised there.
+         *
+         * The order says to deposit "every logged post that relay has not receipted". But a receipt
+         * proves the relay TOOK the post once, not that it still has it — and the case the same sentence
+         * names, "refills a relay that lost content", is precisely a relay whose receipts are all in the
+         * log and whose queue is empty. Skipping on receipts refills nothing, which the enforcer caught:
+         * a restarted relay got 3 posts back out of 6.
+         *
+         * So the relay is asked where its queue begins and ends, and anything outside that is sent. When
+         * it cannot be asked, every logged post is sent — a repeat is a no-op the relay answers with the
+         * receipt it already signed, so the cost of over-sending is bandwidth and the cost of
+         * under-sending is a relay permanently missing posts.
+         */
+        let holds = null;
+        if (this.#opts.relayHead) {
+            try {
+                const reported = await this.#opts.relayHead(relay, channelHex);
+                if (reported.first_held_seq !== null && reported.last_seq !== null) {
+                    holds = { first: reported.first_held_seq, last: reported.last_seq };
+                }
+            }
+            catch (err) {
+                logger.warn("channel.resend.head_unavailable", {
+                    channel_pubkey: channelHex, relay, reason: extract(err),
+                    impact: "every logged post is re-sent; a repeat is a no-op at the relay",
+                });
+            }
+        }
+        let deposited = 0;
+        // Oldest first: a relay's queue only accepts the next number, so any other order stalls at the
+        // first gap and refills nothing after it.
+        for (const post of log.readRange(channelHex, head.first_seq, head.last_seq)) {
+            if (holds !== null && post.seq >= holds.first && post.seq <= holds.last)
+                continue;
+            // PACED. A refill of a long backbone is the one path that deposits hundreds of posts in a
+            // row, and the relay rate-limits per publisher — so an unpaced refill trips the limiter part
+            // way through and the rest of the backlog is refused, which looks exactly like a relay that
+            // will not take the channel's posts at all.
+            if (deposited > 0)
+                await this.#pause(this.#opts.resendPaceMs ?? DEFAULT_RESEND_PACE_MS);
+            const outcome = await this.#depositOnce(relay, post, channelHex, correlationId);
+            if (outcome.ok)
+                deposited += 1;
+        }
+        logger.info("channel.resend.completed", {
+            ...(correlationId !== undefined ? { correlationId } : {}),
+            // WHO ran it. A refill and a prune are the two verbs that change what the world can read, and
+            // an operator asking "why did the backbone change" needs the acting agent in the line.
+            agent: agentName,
+            channel_pubkey: channelHex, relay, deposited,
+        });
+        return { deposited };
+    }
+    /**
+     * Prune the log, then tell both relays to drop the same range.
+     *
+     * ⚠️ **EACH RELAY'S OUTCOME IS THE ONE IT GAVE.** This used to report `ok: true` for every relay
+     * without contacting any of them, so an operator pruning 500 posts was shown two successful
+     * relays while both still held and served every post. A relay that is down is `ok: false` with its
+     * reason, and its copy survives until its own retention sweeps it — which is what retention is for.
+     */
+    async pruneChannel(agentName, channelHex, throughSeq, correlationId) {
+        const { logger } = this.#opts;
+        // Same as `resendMissing`: pruning a channel with nothing in it yet is "pruned 0", not an error.
+        this.#opts.log.ensureChannel(channelHex);
+        const { pruned } = this.#opts.log.pruneThrough(channelHex, throughSeq);
+        const info = this.#opts.channelInfo(channelHex);
+        const relays = info?.relays ?? [];
+        /**
+         * ⚠️ THE PRUNE IS SIGNED BY THE CHANNEL KEY, and it has to be: the frame is not a post, so
+         * nothing else proves the caller owns the channel. An unsigned prune would let anyone who knows
+         * a channel's public key delete its backbone from both relays.
+         */
+        const channelKey = this.#opts.getChannelKey(channelHex);
+        const timeMs = this.#now();
+        const signature = channelKey
+            ? await channelKey.sign(buildChannelPruneTbs(Buffer.from(channelHex, "hex"), throughSeq, timeMs))
+            : null;
+        const outcomes = await Promise.all(relays.map(async (relay) => {
+            if (!this.#opts.prune || signature === null) {
+                // No seam wired, or no key to sign with, is not a successful prune. Say which it was.
+                return { relay, ok: false, reason: signature === null ? "key_unavailable" : "relay_prune_unavailable" };
+            }
+            try {
+                const answer = await this.#opts.prune(relay, { channelHex, throughSeq, timeMs, signature });
+                if (!answer.ok) {
+                    logger.warn("channel.prune.relay_refused", {
+                        ...(correlationId !== undefined ? { correlationId } : {}),
+                        channel_pubkey: channelHex, relay, through_seq: throughSeq, reason: answer.reason,
+                    });
+                    return { relay, ok: false, reason: answer.reason };
+                }
+                return { relay, ok: true };
+            }
+            catch (err) {
+                logger.warn("channel.prune.relay_unreachable", {
+                    ...(correlationId !== undefined ? { correlationId } : {}),
+                    channel_pubkey: channelHex, relay, through_seq: throughSeq, reason: extract(err),
+                });
+                return { relay, ok: false, reason: extract(err) };
+            }
+        }));
+        logger.info("channel.log.pruned", {
+            ...(correlationId !== undefined ? { correlationId } : {}),
+            agent: agentName,
+            channel_pubkey: channelHex, through_seq: throughSeq, pruned,
+            relays_pruned: outcomes.filter((o) => o.ok).map((o) => o.relay),
+            relays_still_holding: outcomes.filter((o) => !o.ok).map((o) => o.relay),
+        });
+        return { pruned, relays: outcomes };
+    }
+    /**
+     * Sign and deposit the channel's info record. Only the CHANNEL key signs it.
+     *
+     * ⚠️ **THE DEPOSIT IS THE POINT, NOT THE SIGNATURE.** The record is the only way a subscriber
+     * learns a channel's relays, access and admin key. This used to sign it, log
+     * `channel.info.published` and return the bytes to the caller without contacting a relay — so an
+     * operator was told their channel was published while no one could find it. The event now names
+     * only the relays that actually took it.
+     */
+    async publishInfo(agentName, channelHex, correlationId) {
+        const { logger } = this.#opts;
+        const info = this.#opts.channelInfo(channelHex);
+        const channelKey = this.#opts.getChannelKey(channelHex);
+        const agentKey = this.#opts.getAgentKey(agentName);
+        if (!info)
+            return { ok: false, reason: "channel_unknown" };
+        if (!channelKey || !agentKey)
+            return { ok: false, reason: "key_unavailable" };
+        const record = await signChannelInfo(channelKey, {
+            access: info.access,
+            admin_pubkey: await agentKey.getPublicKey(),
+            relays: info.relays,
+            guidance: info.guidance,
+            retention_seconds: info.retention_seconds,
+            updated_at: this.#now(),
+            ext: null,
+        });
+        const info_cbor = encodeChannelInfo(record);
+        const outcomes = await Promise.all(info.relays.map(async (relay) => {
+            try {
+                const answer = await this.#opts.depositInfo(relay, { info_cbor });
+                if (!answer.ok)
+                    return { relay, ok: false, reason: answer.reason };
+                return { relay, ok: true };
+            }
+            catch (err) {
+                return { relay, ok: false, reason: extract(err) };
+            }
+        }));
+        const took = outcomes.filter((o) => o.ok);
+        if (took.length === 0) {
+            logger.warn("channel.info.deposit_failed", {
+                ...(correlationId !== undefined ? { correlationId } : {}),
+                channel_pubkey: channelHex,
+                reasons: outcomes.map((o) => o.reason ?? "unknown"),
+            });
+            return { ok: false, reason: "no_relay_accepted", detail: outcomes.map((o) => `${o.relay}: ${o.reason ?? "unknown"}`).join("; ") };
+        }
+        logger.info("channel.info.published", {
+            ...(correlationId !== undefined ? { correlationId } : {}),
+            channel_pubkey: channelHex, access: info.access,
+            relays_ok: took.map((o) => o.relay),
+            relays_failed: outcomes.filter((o) => !o.ok).map((o) => o.relay),
+        });
+        return { ok: true, info_cbor, relays: outcomes };
+    }
+    /** The relays this channel publishes to, so a caller can refill all of them without naming one. */
+    relaysFor(channelHex) {
+        return this.#opts.channelInfo(channelHex)?.relays ?? [];
+    }
+    /** The pacing gap between refill deposits. Its own method so a test can drive it to zero. */
+    #pause(ms) {
+        if (ms <= 0)
+            return Promise.resolve();
+        return new Promise((resolve) => { setTimeout(resolve, ms); });
+    }
+}
+function extract(err) {
+    if (err instanceof Error)
+        return err.message;
+    const m = err?.message;
+    return typeof m === "string" ? m : JSON.stringify(err);
+}
+//# sourceMappingURL=channel-publisher.js.map

package/dist/channel-publisher.js.map

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

package/dist/channel-relay-client.d.ts

@@ -0,0 +1,88 @@
+import type { CelloNode } from "@cello-protocol/transport";
+import type { Logger } from "./types.js";
+export declare const CHANNEL_PROTOCOL_ID = "/cello/channel/1.0.0";
+export interface ChannelRelayClientOptions {
+    getNode: () => CelloNode | null;
+    logger: Logger;
+}
+export declare class ChannelRelayClient {
+    #private;
+    constructor(opts: ChannelRelayClientOptions);
+    /**
+     * One request, one stream. THROWS when the relay could not be reached at all, and RESOLVES with
+     * whatever the relay said otherwise — including a refusal, which is an answer.
+     */
+    request(relayAddr: string, frame: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Deposit one post. A refusal comes back as `{ ok: false, reason }`, never as a throw. */
+    deposit(relayAddr: string, req: {
+        post_cbor: Uint8Array;
+        fetch_key?: {
+            pubkey: Uint8Array;
+            time_ms: number;
+            signature: Uint8Array;
+        };
+    }): Promise<{
+        ok: true;
+        receipt_cbor: Uint8Array;
+    } | {
+        ok: false;
+        reason: string;
+        skew_ms?: number;
+    }>;
+    /** Fetch from a post number. The caller verifies everything that comes back. */
+    fetch(relayAddr: string, req: {
+        channel_pubkey: Uint8Array;
+        since_seq: number;
+        max_bytes: number;
+        auth?: {
+            signature: Uint8Array;
+            time_ms: number;
+        };
+        agent_pubkeys?: Uint8Array[];
+    }): Promise<{
+        ok: true;
+        posts: Array<{
+            seq: number;
+            post_cbor: Uint8Array;
+            receipt_cbor?: Uint8Array;
+        }>;
+        first_held_seq: number | null;
+        last_seq: number | null;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    /** Where a relay's queue begins and ends, without pulling any posts. */
+    head(relayAddr: string, channelPubkey: Uint8Array): Promise<{
+        first_held_seq: number | null;
+        last_seq: number | null;
+    }>;
+    /**
+     * Deposit the channel's info record. No receipt: the record carries no post number, so there is
+     * nothing for a relay to order or countersign — it either holds the latest one or it does not.
+     */
+    depositInfo(relayAddr: string, req: {
+        info_cbor: Uint8Array;
+    }): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    /** Ask a relay to drop everything through a post number. Oldest end only — the relay enforces that. */
+    prune(relayAddr: string, req: {
+        channel_pubkey: Uint8Array;
+        through_seq: number;
+        time_ms: number;
+        signature: Uint8Array;
+    }): Promise<{
+        ok: true;
+        dropped?: number;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    /** The channel's info record as this relay holds it, or null. */
+    info(relayAddr: string, channelPubkey: Uint8Array): Promise<Uint8Array | null>;
+}
+//# sourceMappingURL=channel-relay-client.d.ts.map

package/dist/channel-relay-client.d.ts.map

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