@chipschat/protocol 0.0.0-stage → 1.0.1

package/dist/src/relay.d.ts

@@ -0,0 +1,177 @@
+/**
+ * The relay's control frames (M4.1, ADR 0038).
+ *
+ * The relay is a switchboard: a home server dials out to it and says which key it holds; a
+ * phone dials in and asks for a server by that key; the relay holds the two connections
+ * together and moves bytes between them. The bytes are ciphertext it cannot read — the tunnel
+ * inside is `@chipschat/tunnel`'s — and these frames are the only thing it does understand: text
+ * frames on the WebSocket, JSON, one `frame` word each. Data travels in binary frames beside
+ * them and is never parsed here.
+ *
+ * Every frame carries a version, and the two that open a path — `serve` and `connect` — carry
+ * a list of candidate addresses that is empty in v0 (ADR 0038, decisions 3 and 4). A peer that
+ * receives a version it does not know reads the fields it does know and uses the relay,
+ * rather than failing: the version is the room left for NAT traversal, and it costs one field.
+ */
+import { z } from "zod";
+/** The relay protocol's version. Bumped when a frame's meaning changes, never for a new field. */
+export declare const RELAY_VERSION = 1;
+/** How many bytes name a session in the relay's binary frames, before the ciphertext. */
+export declare const RELAY_SESSION_ID_BYTES = 16;
+/**
+ * The tunnel door on the server's own network (ADR 0191): a WebSocket at this path, on the same
+ * port as `/v1/ws`, where a phone at home opens the same Noise tunnel it opens through the relay
+ * when it is away, to the same key. `/v1/health` names it as `tunnel.path`, so a client reads the
+ * path rather than knowing it.
+ */
+export declare const TUNNEL_DOOR_PATH = "/v1/tunnel";
+/** A session's name: sixteen random bytes as hex. */
+export declare const relaySessionId: z.ZodString;
+/**
+ * A way a peer might be reached without the relay. Nothing sends one in v0 and nothing reads
+ * one; the shape is loose so that a v1 peer can carry a v2 peer's candidates unread rather
+ * than refuse the frame (ADR 0038, decision 3).
+ */
+export declare const candidateAddress: z.ZodObject<{
+    address: z.ZodString;
+}, z.core.$loose>;
+export declare const candidateAddresses: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    address: z.ZodString;
+}, z.core.$loose>>>;
+/** Relay → server, first: prove you hold the key you are about to claim. */
+export declare const relayChallengeFrame: z.ZodObject<{
+    frame: z.ZodLiteral<"challenge">;
+    v: z.ZodInt;
+    nonce: z.ZodString;
+    ephemeral: z.ZodString;
+}, z.core.$strip>;
+/** Server → relay: this is my key, and here is the proof. */
+export declare const relayServeFrame: z.ZodObject<{
+    frame: z.ZodLiteral<"serve">;
+    v: z.ZodInt;
+    key: z.ZodString;
+    proof: z.ZodString;
+    candidates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+    }, z.core.$loose>>>;
+}, z.core.$strip>;
+/** Relay → server: registered; phones may ask for you now. */
+export declare const relayServingFrame: z.ZodObject<{
+    frame: z.ZodLiteral<"serving">;
+    v: z.ZodInt;
+    session_limit: z.ZodInt;
+}, z.core.$strip>;
+/** Phone → relay: put me through to this server. */
+export declare const relayConnectFrame: z.ZodObject<{
+    frame: z.ZodLiteral<"connect">;
+    v: z.ZodInt;
+    key: z.ZodString;
+    candidates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+    }, z.core.$loose>>>;
+}, z.core.$strip>;
+/** Relay → phone: you are through; the binary frames from here on are the tunnel's. */
+export declare const relayConnectedFrame: z.ZodObject<{
+    frame: z.ZodLiteral<"connected">;
+    v: z.ZodInt;
+    session: z.ZodString;
+}, z.core.$strip>;
+/** Relay → server: a phone is here; its bytes arrive under this session id. */
+export declare const relayOpenFrame: z.ZodObject<{
+    frame: z.ZodLiteral<"open">;
+    v: z.ZodInt;
+    session: z.ZodString;
+    from: z.ZodUnion<readonly [z.ZodIPv4, z.ZodIPv6, z.ZodLiteral<"">]>;
+}, z.core.$strip>;
+/** Either way: a session is over. The relay tells the other side and closes the phone's socket. */
+export declare const relayCloseFrame: z.ZodObject<{
+    frame: z.ZodLiteral<"close">;
+    v: z.ZodInt;
+    session: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const RELAY_ERROR_CODES: readonly ["unknown_version", "bad_frame", "bad_proof", "no_such_server", "busy", "replaced", "not_allowed"];
+export type RelayErrorCode = (typeof RELAY_ERROR_CODES)[number];
+/** Relay → either side: no, and why. The socket closes after it. */
+export declare const relayErrorFrame: z.ZodObject<{
+    frame: z.ZodLiteral<"error">;
+    v: z.ZodInt;
+    code: z.ZodEnum<{
+        unknown_version: "unknown_version";
+        bad_frame: "bad_frame";
+        bad_proof: "bad_proof";
+        no_such_server: "no_such_server";
+        busy: "busy";
+        replaced: "replaced";
+        not_allowed: "not_allowed";
+    }>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export declare const relayFrame: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    frame: z.ZodLiteral<"challenge">;
+    v: z.ZodInt;
+    nonce: z.ZodString;
+    ephemeral: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    frame: z.ZodLiteral<"serve">;
+    v: z.ZodInt;
+    key: z.ZodString;
+    proof: z.ZodString;
+    candidates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+    }, z.core.$loose>>>;
+}, z.core.$strip>, z.ZodObject<{
+    frame: z.ZodLiteral<"serving">;
+    v: z.ZodInt;
+    session_limit: z.ZodInt;
+}, z.core.$strip>, z.ZodObject<{
+    frame: z.ZodLiteral<"connect">;
+    v: z.ZodInt;
+    key: z.ZodString;
+    candidates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+    }, z.core.$loose>>>;
+}, z.core.$strip>, z.ZodObject<{
+    frame: z.ZodLiteral<"connected">;
+    v: z.ZodInt;
+    session: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    frame: z.ZodLiteral<"open">;
+    v: z.ZodInt;
+    session: z.ZodString;
+    from: z.ZodUnion<readonly [z.ZodIPv4, z.ZodIPv6, z.ZodLiteral<"">]>;
+}, z.core.$strip>, z.ZodObject<{
+    frame: z.ZodLiteral<"close">;
+    v: z.ZodInt;
+    session: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    frame: z.ZodLiteral<"error">;
+    v: z.ZodInt;
+    code: z.ZodEnum<{
+        unknown_version: "unknown_version";
+        bad_frame: "bad_frame";
+        bad_proof: "bad_proof";
+        no_such_server: "no_such_server";
+        busy: "busy";
+        replaced: "replaced";
+        not_allowed: "not_allowed";
+    }>;
+    message: z.ZodString;
+}, z.core.$strip>], "frame">;
+export type RelayFrame = z.infer<typeof relayFrame>;
+export type RelayFrameName = RelayFrame["frame"];
+export type CandidateAddress = z.infer<typeof candidateAddress>;
+/**
+ * Read a text frame. A frame from a newer peer parses by the fields this version knows; the
+ * caller can see `v` and say so in its log. Anything else is refused with a reason the relay
+ * puts in an `error` frame.
+ */
+export declare function parseRelayFrame(text: string): {
+    ok: true;
+    frame: RelayFrame;
+} | {
+    ok: false;
+    reason: "not_json" | "bad_frame";
+};
+//# sourceMappingURL=relay.d.ts.map

package/dist/src/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kGAAkG;AAClG,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAK7C,qDAAqD;AACrD,eAAO,MAAM,cAAc,aAAqD,CAAC;AAOjF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;iBAIqC,CAAC;AAEnE,eAAO,MAAM,kBAAkB;;mBAI0C,CAAC;AAE1E,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB;;;;;iBAK9B,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,eAAe;;;;;;;;iBAQ1B,CAAC;AAEH,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,iBAAiB;;;;;;;iBAK5B,CAAC;AAEH,uFAAuF;AACvF,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAEH,+EAA+E;AAC/E,eAAO,MAAM,cAAc;;;;;iBASzB,CAAC;AAEH,mGAAmG;AACnG,eAAO,MAAM,eAAe;;;;;iBAK1B,CAAC;AAEH,eAAO,MAAM,iBAAiB,6GAYpB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,oEAAoE;AACpE,eAAO,MAAM,eAAe;;;;;;;;;;;;;iBAK1B,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BASrB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;AACjD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GACX;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAAA;CAAE,CASnF"}

package/dist/src/relay.js

@@ -0,0 +1,147 @@
+/**
+ * The relay's control frames (M4.1, ADR 0038).
+ *
+ * The relay is a switchboard: a home server dials out to it and says which key it holds; a
+ * phone dials in and asks for a server by that key; the relay holds the two connections
+ * together and moves bytes between them. The bytes are ciphertext it cannot read — the tunnel
+ * inside is `@chipschat/tunnel`'s — and these frames are the only thing it does understand: text
+ * frames on the WebSocket, JSON, one `frame` word each. Data travels in binary frames beside
+ * them and is never parsed here.
+ *
+ * Every frame carries a version, and the two that open a path — `serve` and `connect` — carry
+ * a list of candidate addresses that is empty in v0 (ADR 0038, decisions 3 and 4). A peer that
+ * receives a version it does not know reads the fields it does know and uses the relay,
+ * rather than failing: the version is the room left for NAT traversal, and it costs one field.
+ */
+import { z } from "zod";
+/** The relay protocol's version. Bumped when a frame's meaning changes, never for a new field. */
+export const RELAY_VERSION = 1;
+/** How many bytes name a session in the relay's binary frames, before the ciphertext. */
+export const RELAY_SESSION_ID_BYTES = 16;
+/**
+ * The tunnel door on the server's own network (ADR 0191): a WebSocket at this path, on the same
+ * port as `/v1/ws`, where a phone at home opens the same Noise tunnel it opens through the relay
+ * when it is away, to the same key. `/v1/health` names it as `tunnel.path`, so a client reads the
+ * path rather than knowing it.
+ */
+export const TUNNEL_DOOR_PATH = "/v1/tunnel";
+/** Thirty-two bytes as base64url without padding, which is what every key and nonce here is. */
+const bytes32 = z.string().regex(/^[A-Za-z0-9_-]{43}$/, "thirty-two bytes, base64url");
+/** A session's name: sixteen random bytes as hex. */
+export const relaySessionId = z.string().regex(/^[0-9a-f]{32}$/, "a session id");
+const version = z
+    .int()
+    .positive()
+    .describe("The relay protocol version the sender speaks. Unknown fields are ignored.");
+/**
+ * A way a peer might be reached without the relay. Nothing sends one in v0 and nothing reads
+ * one; the shape is loose so that a v1 peer can carry a v2 peer's candidates unread rather
+ * than refuse the frame (ADR 0038, decision 3).
+ */
+export const candidateAddress = z
+    .looseObject({
+    address: z.string().min(1).max(255).describe("Where, in a form the kind decides."),
+})
+    .describe("A candidate address for a direct path. Empty in v0.");
+export const candidateAddresses = z
+    .array(candidateAddress)
+    .max(16)
+    .default([])
+    .describe("Candidate addresses for a direct path. Always empty in v0.");
+/** Relay → server, first: prove you hold the key you are about to claim. */
+export const relayChallengeFrame = z.object({
+    frame: z.literal("challenge"),
+    v: version,
+    nonce: bytes32.describe("Fresh for this connection."),
+    ephemeral: bytes32.describe("The relay's X25519 ephemeral public key, for the proof."),
+});
+/** Server → relay: this is my key, and here is the proof. */
+export const relayServeFrame = z.object({
+    frame: z.literal("serve"),
+    v: version,
+    key: bytes32.describe("The server's X25519 static public key: what a phone asks for."),
+    proof: bytes32.describe("HMAC-SHA256 over the nonce and the key, keyed by X25519(static, ephemeral)."),
+    candidates: candidateAddresses,
+});
+/** Relay → server: registered; phones may ask for you now. */
+export const relayServingFrame = z.object({
+    frame: z.literal("serving"),
+    v: version,
+    session_limit: z.int().positive().describe("How many phones this relay holds open for you."),
+});
+/** Phone → relay: put me through to this server. */
+export const relayConnectFrame = z.object({
+    frame: z.literal("connect"),
+    v: version,
+    key: bytes32.describe("The server's key, from the pairing payload."),
+    candidates: candidateAddresses,
+});
+/** Relay → phone: you are through; the binary frames from here on are the tunnel's. */
+export const relayConnectedFrame = z.object({
+    frame: z.literal("connected"),
+    v: version,
+    session: relaySessionId,
+});
+/** Relay → server: a phone is here; its bytes arrive under this session id. */
+export const relayOpenFrame = z.object({
+    frame: z.literal("open"),
+    v: version,
+    session: relaySessionId,
+    from: z
+        .union([z.ipv4(), z.ipv6(), z.literal("")])
+        .describe("The phone's address as the relay saw it, for the server's limiter and its join cards: an IP address, or nothing when the relay could not tell (SEC-27)."),
+});
+/** Either way: a session is over. The relay tells the other side and closes the phone's socket. */
+export const relayCloseFrame = z.object({
+    frame: z.literal("close"),
+    v: version,
+    session: relaySessionId,
+    reason: z.string().max(120),
+});
+export const RELAY_ERROR_CODES = [
+    "unknown_version",
+    "bad_frame",
+    "bad_proof",
+    "no_such_server",
+    "busy",
+    "replaced",
+    /**
+     * A relay that serves a list of servers, and this key is not on it. Its operator adds the key
+     * to the list; the server keeps dialling meanwhile, so it is listed the moment that happens.
+     */
+    "not_allowed",
+];
+/** Relay → either side: no, and why. The socket closes after it. */
+export const relayErrorFrame = z.object({
+    frame: z.literal("error"),
+    v: version,
+    code: z.enum(RELAY_ERROR_CODES),
+    message: z.string().max(240),
+});
+export const relayFrame = z.discriminatedUnion("frame", [
+    relayChallengeFrame,
+    relayServeFrame,
+    relayServingFrame,
+    relayConnectFrame,
+    relayConnectedFrame,
+    relayOpenFrame,
+    relayCloseFrame,
+    relayErrorFrame,
+]);
+/**
+ * Read a text frame. A frame from a newer peer parses by the fields this version knows; the
+ * caller can see `v` and say so in its log. Anything else is refused with a reason the relay
+ * puts in an `error` frame.
+ */
+export function parseRelayFrame(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return { ok: false, reason: "not_json" };
+    }
+    const frame = relayFrame.safeParse(parsed);
+    return frame.success ? { ok: true, frame: frame.data } : { ok: false, reason: "bad_frame" };
+}
+//# sourceMappingURL=relay.js.map

package/dist/src/relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.js","sourceRoot":"","sources":["../../src/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kGAAkG;AAClG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B,yFAAyF;AACzF,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE7C,gGAAgG;AAChG,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE,6BAA6B,CAAC,CAAC;AAEvF,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;AAEjF,MAAM,OAAO,GAAG,CAAC;KACd,GAAG,EAAE;KACL,QAAQ,EAAE;KACV,QAAQ,CAAC,2EAA2E,CAAC,CAAC;AAEzF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,WAAW,CAAC;IACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACnF,CAAC;KACD,QAAQ,CAAC,qDAAqD,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,KAAK,CAAC,gBAAgB,CAAC;KACvB,GAAG,CAAC,EAAE,CAAC;KACP,OAAO,CAAC,EAAE,CAAC;KACX,QAAQ,CAAC,4DAA4D,CAAC,CAAC;AAE1E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC7B,CAAC,EAAE,OAAO;IACV,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACrD,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,yDAAyD,CAAC;CACvF,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC,EAAE,OAAO;IACV,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,+DAA+D,CAAC;IACtF,KAAK,EAAE,OAAO,CAAC,QAAQ,CACrB,6EAA6E,CAC9E;IACD,UAAU,EAAE,kBAAkB;CAC/B,CAAC,CAAC;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC3B,CAAC,EAAE,OAAO;IACV,aAAa,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAC7F,CAAC,CAAC;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC3B,CAAC,EAAE,OAAO;IACV,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACpE,UAAU,EAAE,kBAAkB;CAC/B,CAAC,CAAC;AAEH,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC7B,CAAC,EAAE,OAAO;IACV,OAAO,EAAE,cAAc;CACxB,CAAC,CAAC;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC,EAAE,OAAO;IACV,OAAO,EAAE,cAAc;IACvB,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;SAC1C,QAAQ,CACP,yJAAyJ,CAC1J;CACJ,CAAC,CAAC;AAEH,mGAAmG;AACnG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC,EAAE,OAAO;IACV,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,iBAAiB;IACjB,WAAW;IACX,WAAW;IACX,gBAAgB;IAChB,MAAM;IACN,UAAU;IACV;;;OAGG;IACH,aAAa;CACL,CAAC;AAGX,oEAAoE;AACpE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC,EAAE,OAAO;IACV,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE;IACtD,mBAAmB;IACnB,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,cAAc;IACd,eAAe;IACf,eAAe;CAChB,CAAC,CAAC;AAMH;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY;IAEZ,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC3C,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AAC9F,CAAC"}

package/dist/src/room-files.d.ts

@@ -0,0 +1,146 @@
+/**
+ * The room's files (ADR 0099). A file posted in a room is the room's: the files of one name are
+ * its versions, in the order they were posted, and the newest is the current one. The ASCII Art
+ * room (2 October 2026) had none of this: its agents were handed a path on another machine, and
+ * the one page they shared was written over by whoever posted last.
+ *
+ * - **Versions.** Walking a room's files of one name in order, a file whose bytes differ from the
+ *   version before it is the next version. The same bytes again are the same version, and bytes
+ *   of an older one again are a new one: a revert is a change.
+ * - **What a harness is handed.** The current version of each name, newest first, with a message
+ *   for it (`context.files`), from `GET /v1/spaces/:id/files`, and from the context route.
+ * - **Made from what.** A post says which version each of its files was made from (`replaces`). One
+ *   made from bytes that are no longer the current version's is refused, `stale_file`, so two agents
+ *   editing one file at once lose nothing silently: the one that loses is told who won, fetches the
+ *   current version and redoes. A post that says nothing is the next version, unchecked.
+ *
+ * The server, the conformance fake and the SDK hand over the same list and refuse the same posts,
+ * so the rules and the words live here, with the schemas.
+ */
+import { z } from "zod";
+/** The most of a room's files a message hands over: its newest. The rest are the route's. */
+export declare const ROOM_FILES_IN_CONTEXT = 20;
+/** The most `GET /v1/spaces/:id/files` lists. */
+export declare const ROOM_FILES_CEILING = 200;
+/** The heading the room's files open with in the plain form. */
+export declare const ROOM_FILES_HEADING = "Files in this space:";
+/** The code a post is refused with when a file in it was made from a version no longer current. */
+export declare const STALE_FILE = "stale_file";
+export declare const roomFile: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodInt;
+    attachment_id: z.ZodString;
+    sha256: z.ZodString;
+    byte_size: z.ZodInt;
+    mime_type: z.ZodString;
+    by: z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            person: "person";
+            harness: "harness";
+            agent: "agent";
+            system: "system";
+        }>;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    at: z.ZodISODateTime;
+    message_id: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodInt>;
+    height: z.ZodOptional<z.ZodInt>;
+    duration_ms: z.ZodOptional<z.ZodInt>;
+    replaces: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodURL>;
+    url_expires_at: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+export type RoomFile = z.infer<typeof roomFile>;
+export declare const roomFiles: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodInt;
+    attachment_id: z.ZodString;
+    sha256: z.ZodString;
+    byte_size: z.ZodInt;
+    mime_type: z.ZodString;
+    by: z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            person: "person";
+            harness: "harness";
+            agent: "agent";
+            system: "system";
+        }>;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    at: z.ZodISODateTime;
+    message_id: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodInt>;
+    height: z.ZodOptional<z.ZodInt>;
+    duration_ms: z.ZodOptional<z.ZodInt>;
+    replaces: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodURL>;
+    url_expires_at: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>>;
+/** A file a message carried, where and by whom: what versions are worked out from. */
+export interface PostedFile {
+    /** The seq of the message that carried it. */
+    readonly seq: number;
+    readonly at: string;
+    /** Who posted it: a participant id. */
+    readonly by: string;
+    readonly attachment_id: string;
+    readonly filename: string;
+    readonly sha256: string;
+    readonly byte_size: number;
+    readonly mime_type: string;
+    /** The message that carried it. */
+    readonly message_id?: string | undefined;
+    /** Pixels and milliseconds, where the server measured them. */
+    readonly width?: number | undefined;
+    readonly height?: number | undefined;
+    readonly duration_ms?: number | undefined;
+}
+/** A version of a file: the post that made it, and which version it is. */
+export interface FileVersion extends PostedFile {
+    readonly version: number;
+}
+/**
+ * Each name's versions, oldest first, from a room's files in the order they were posted. A file
+ * whose bytes are the version before it is no version of its own.
+ */
+export declare function versionsOf(posted: readonly PostedFile[]): Map<string, FileVersion[]>;
+/** The current version of each name, newest first, as many as `most`. */
+export declare function currentFiles(posted: readonly PostedFile[], most: number): FileVersion[];
+/** One name's versions, newest first, as many as `most` (ADR 0100). None for a name never posted. */
+export declare function versionsNamed(posted: readonly PostedFile[], name: string, most: number): FileVersion[];
+/** A file a post carries that says which version it was made from. */
+export interface MadeFrom {
+    readonly filename: string;
+    /** The bytes posted. */
+    readonly sha256: string;
+    /** The bytes of the version it says it was made from. */
+    readonly from: string;
+}
+/** Why a post may not be taken: the first of its files made from a version no longer current. */
+export interface StaleRefusal {
+    readonly kind: typeof STALE_FILE;
+    readonly message: string;
+}
+/**
+ * The current version a post's file was not made from, when one was not: the first file made from
+ * bytes that are not its name's current version, unless what it posts is the current version
+ * already. A name with no version left in the room (each one taken back) has nothing to be stale
+ * against. Nothing when the post may be taken.
+ */
+export declare function staleVersion(made: readonly MadeFrom[], versions: ReadonlyMap<string, readonly FileVersion[]>): FileVersion | undefined;
+/** The refusal of a post made from a version no longer current, naming who posted the current one. */
+export declare function staleRefusal(current: Pick<FileVersion, "filename" | "version">, by: string): StaleRefusal;
+/**
+ * The refusal's words, which name the file so an adapter can leave out just that one:
+ * `ascii-alphabet.html is now v3, by Oc2. Fetch it and redo.`
+ */
+export declare function staleWords(current: Pick<FileVersion, "filename" | "version">, by: string): string;
+/**
+ * The room's files in the plain form, after the lines: one per file, `name · v3 · by Oc2 · when ·
+ * url`. Nothing when there are none.
+ */
+export declare function renderRoomFiles(files: readonly RoomFile[] | undefined): string;
+//# sourceMappingURL=room-files.d.ts.map

package/dist/src/room-files.d.ts.map

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

package/dist/src/room-files.js

@@ -0,0 +1,135 @@
+/**
+ * The room's files (ADR 0099). A file posted in a room is the room's: the files of one name are
+ * its versions, in the order they were posted, and the newest is the current one. The ASCII Art
+ * room (2 October 2026) had none of this: its agents were handed a path on another machine, and
+ * the one page they shared was written over by whoever posted last.
+ *
+ * - **Versions.** Walking a room's files of one name in order, a file whose bytes differ from the
+ *   version before it is the next version. The same bytes again are the same version, and bytes
+ *   of an older one again are a new one: a revert is a change.
+ * - **What a harness is handed.** The current version of each name, newest first, with a message
+ *   for it (`context.files`), from `GET /v1/spaces/:id/files`, and from the context route.
+ * - **Made from what.** A post says which version each of its files was made from (`replaces`). One
+ *   made from bytes that are no longer the current version's is refused, `stale_file`, so two agents
+ *   editing one file at once lose nothing silently: the one that loses is told who won, fetches the
+ *   current version and redoes. A post that says nothing is the next version, unchecked.
+ *
+ * The server, the conformance fake and the SDK hand over the same list and refuse the same posts,
+ * so the rules and the words live here, with the schemas.
+ */
+import { z } from "zod";
+import { id, isoTimestamp } from "./primitives.js";
+/** The most of a room's files a message hands over: its newest. The rest are the route's. */
+export const ROOM_FILES_IN_CONTEXT = 20;
+/** The most `GET /v1/spaces/:id/files` lists. */
+export const ROOM_FILES_CEILING = 200;
+/** The heading the room's files open with in the plain form. */
+export const ROOM_FILES_HEADING = "Files in this space:";
+/** The code a post is refused with when a file in it was made from a version no longer current. */
+export const STALE_FILE = "stale_file";
+export const roomFile = z
+    .object({
+    name: z.string().min(1).max(255).describe("The file's name, which its versions share."),
+    version: z
+        .int()
+        .positive()
+        .describe("Which version this is: 1 for the first, counting each change of its bytes."),
+    attachment_id: id("attachment").describe("The attachment that is this version: what a post names in `replaces` when it changes it."),
+    sha256: z
+        .string()
+        .regex(/^[a-f0-9]{64}$/)
+        .describe("Lowercase hex digest of this version's bytes."),
+    byte_size: z.int().nonnegative().describe("Size in bytes."),
+    mime_type: z.string().min(1).max(255).describe("Sniffed from the bytes on upload."),
+    by: z
+        .object({
+        id: z.string().min(1).max(120).describe("Their participant id."),
+        kind: z.enum(["person", "harness", "agent", "system"]),
+        name: z.string().min(1).max(120).describe("What they go by now."),
+    })
+        .describe("Who posted this version, as a line's `from` says it."),
+    at: isoTimestamp.describe("When this version was posted."),
+    message_id: id("message").optional().describe("The message that posted this version."),
+    width: z.int().positive().optional().describe("Pixels, for a photo or a video."),
+    height: z.int().positive().optional().describe("Pixels, for a photo or a video."),
+    duration_ms: z.int().nonnegative().optional().describe("Milliseconds, for a sound or a video."),
+    replaces: id("attachment")
+        .optional()
+        .describe("In one name's versions (`?name=`): the version this one was made from, as its post said (`message.post.replaces`). Absent where the post said nothing, or named no version of this file."),
+    url: z
+        .url()
+        .optional()
+        .describe("For a harness: a signed URL for this version, bound to its token, as a message's attachments are. Absent for a person, who fetches it by id."),
+    url_expires_at: isoTimestamp.optional().describe("When `url` stops working."),
+})
+    .describe("One of a room's files at one of its versions: the current one, in the room's list (ADR 0099).");
+export const roomFiles = z
+    .array(roomFile)
+    .max(ROOM_FILES_CEILING)
+    .describe("The current version of each of the room's files, newest first (ADR 0099); or, asked for one name (`?name=`), that name's versions, newest first (ADR 0100).");
+/**
+ * Each name's versions, oldest first, from a room's files in the order they were posted. A file
+ * whose bytes are the version before it is no version of its own.
+ */
+export function versionsOf(posted) {
+    const versions = new Map();
+    for (const file of posted) {
+        const known = versions.get(file.filename) ?? [];
+        if (known.at(-1)?.sha256 === file.sha256)
+            continue;
+        known.push({ ...file, version: known.length + 1 });
+        versions.set(file.filename, known);
+    }
+    return versions;
+}
+/** The current version of each name, newest first, as many as `most`. */
+export function currentFiles(posted, most) {
+    const current = [...versionsOf(posted).values()].flatMap((known) => known.slice(-1));
+    return current.sort((a, b) => b.seq - a.seq).slice(0, Math.max(0, most));
+}
+/** One name's versions, newest first, as many as `most` (ADR 0100). None for a name never posted. */
+export function versionsNamed(posted, name, most) {
+    const known = versionsOf(posted.filter((file) => file.filename === name)).get(name) ?? [];
+    return [...known].reverse().slice(0, Math.max(0, most));
+}
+/**
+ * The current version a post's file was not made from, when one was not: the first file made from
+ * bytes that are not its name's current version, unless what it posts is the current version
+ * already. A name with no version left in the room (each one taken back) has nothing to be stale
+ * against. Nothing when the post may be taken.
+ */
+export function staleVersion(made, versions) {
+    for (const file of made) {
+        const current = versions.get(file.filename)?.at(-1);
+        if (current === undefined)
+            continue;
+        if (file.from === current.sha256 || file.sha256 === current.sha256)
+            continue;
+        return current;
+    }
+    return undefined;
+}
+/** The refusal of a post made from a version no longer current, naming who posted the current one. */
+export function staleRefusal(current, by) {
+    return { kind: STALE_FILE, message: staleWords(current, by) };
+}
+/**
+ * The refusal's words, which name the file so an adapter can leave out just that one:
+ * `ascii-alphabet.html is now v3, by Oc2. Fetch it and redo.`
+ */
+export function staleWords(current, by) {
+    return `${current.filename} is now v${current.version}, by ${by}. Fetch it and redo.`;
+}
+/**
+ * The room's files in the plain form, after the lines: one per file, `name · v3 · by Oc2 · when ·
+ * url`. Nothing when there are none.
+ */
+export function renderRoomFiles(files) {
+    if (files === undefined || files.length === 0)
+        return "";
+    const lines = files.map((file) => [file.name, `v${file.version}`, `by ${file.by.name}`, file.at, file.url]
+        .filter((part) => part !== undefined)
+        .join(" · "));
+    return [ROOM_FILES_HEADING, ...lines].join("\n");
+}
+//# sourceMappingURL=room-files.js.map

package/dist/src/room-files.js.map

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