agent-protocols 0.10.1 → 0.11.1

package/dist/mail-schema.js

@@ -0,0 +1,376 @@
+// Generated from docs/protocols/agent-mail/1.0.schema.json.
+export const MAIL_SCHEMA = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: "https://agent-protocols.dev/schemas/agent-mail/1.0.schema.json",
+    title: "Agent Mail Protocol 1.0",
+    description: "Structural definitions for owner-signed cards, sender-signed encrypted packets, plaintext messages and HTTP records. Signatures, sender/recipient/AAD binding, canonical encoding, time, size, sender policy and logical message deduplication require semantic validation.",
+    $defs: {
+        agentId: {
+            type: "string",
+            pattern: "^did:agent:[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$(?![\\s\\S])",
+        },
+        hash32: {
+            type: "string",
+            pattern: "^[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$(?![\\s\\S])",
+        },
+        id16: {
+            type: "string",
+            pattern: "^[A-Za-z0-9_-]{21}[AQgw]$(?![\\s\\S])",
+        },
+        signature: {
+            type: "string",
+            pattern: "^[A-Za-z0-9_-]{85}[AQgw]$(?![\\s\\S])",
+        },
+        base64url: {
+            type: "string",
+            pattern: "^(?:[A-Za-z0-9_-]{4})*(?:[A-Za-z0-9_-][AQgw]|[A-Za-z0-9_-]{2}[AEIMQUYcgkosw048])?$(?![\\s\\S])",
+        },
+        timestampMs: {
+            type: "integer",
+            minimum: 0,
+            maximum: 9007199254740991,
+        },
+        positiveSafeInteger: {
+            type: "integer",
+            minimum: 1,
+            maximum: 9007199254740991,
+        },
+        httpsOrigin: {
+            type: "string",
+            pattern: "^https://[^/?#@\\s]+$(?![\\s\\S])",
+            not: {
+                pattern: ":443$(?![\\s\\S])",
+            },
+            description: "Approximate syntax only. Identity canonical HTTPS origin parsing and serialization are a semantic requirement.",
+        },
+        mailboxCardPayload: {
+            type: "object",
+            required: [
+                "mailbox_id",
+                "expires_at",
+                "receive_until",
+                "public_key",
+                "routes",
+                "max_packet_bytes",
+            ],
+            properties: {
+                mailbox_id: {
+                    $ref: "#/$defs/id16",
+                },
+                expires_at: {
+                    $ref: "#/$defs/timestampMs",
+                },
+                receive_until: {
+                    $ref: "#/$defs/timestampMs",
+                },
+                public_key: {
+                    $ref: "#/$defs/hash32",
+                },
+                routes: {
+                    type: "array",
+                    items: {
+                        $ref: "#/$defs/httpsOrigin",
+                    },
+                    minItems: 0,
+                    maxItems: 8,
+                    uniqueItems: true,
+                },
+                max_packet_bytes: {
+                    type: "integer",
+                    minimum: 4096,
+                    maximum: 1048576,
+                },
+            },
+            additionalProperties: false,
+        },
+        part: {
+            type: "object",
+            required: ["media_type", "data"],
+            properties: {
+                media_type: {
+                    type: "string",
+                    maxLength: 127,
+                    pattern: "^[a-z0-9][a-z0-9!#$&^_.+\\-]*/[a-z0-9][a-z0-9!#$&^_.+\\-]*$(?![\\s\\S])",
+                },
+                data: {
+                    $ref: "#/$defs/base64url",
+                },
+                name: {
+                    type: "string",
+                    minLength: 1,
+                    maxLength: 255,
+                },
+            },
+            additionalProperties: false,
+        },
+        messagePayload: {
+            type: "object",
+            required: [
+                "message_id",
+                "from",
+                "created_at",
+                "to",
+                "expires_at",
+                "thread_id",
+                "parts",
+            ],
+            properties: {
+                message_id: {
+                    $ref: "#/$defs/hash32",
+                },
+                from: {
+                    $ref: "#/$defs/agentId",
+                },
+                created_at: {
+                    $ref: "#/$defs/timestampMs",
+                },
+                to: {
+                    $ref: "#/$defs/agentId",
+                },
+                expires_at: {
+                    $ref: "#/$defs/timestampMs",
+                },
+                thread_id: {
+                    $ref: "#/$defs/id16",
+                },
+                parts: {
+                    type: "array",
+                    items: {
+                        $ref: "#/$defs/part",
+                    },
+                    minItems: 1,
+                    maxItems: 32,
+                },
+                subject: {
+                    type: "string",
+                    maxLength: 1024,
+                },
+                in_reply_to: {
+                    $ref: "#/$defs/hash32",
+                },
+                reply_card: {
+                    $ref: "#/$defs/mailboxCardEnvelope",
+                },
+            },
+            additionalProperties: false,
+        },
+        mailboxCardEvent: {
+            type: "object",
+            required: ["protocol", "type", "actor", "created_at", "nonce", "payload"],
+            properties: {
+                protocol: {
+                    const: "agent-mail/1.0",
+                },
+                type: {
+                    const: "mailbox.publish",
+                },
+                actor: {
+                    $ref: "#/$defs/agentId",
+                },
+                created_at: {
+                    $ref: "#/$defs/timestampMs",
+                },
+                nonce: {
+                    $ref: "#/$defs/positiveSafeInteger",
+                },
+                payload: {
+                    $ref: "#/$defs/mailboxCardPayload",
+                },
+            },
+            additionalProperties: false,
+        },
+        mailboxCardEnvelope: {
+            type: "object",
+            required: ["event", "hash", "signature"],
+            properties: {
+                event: {
+                    $ref: "#/$defs/mailboxCardEvent",
+                },
+                hash: {
+                    $ref: "#/$defs/hash32",
+                },
+                signature: {
+                    $ref: "#/$defs/signature",
+                },
+            },
+            additionalProperties: false,
+        },
+        envelope: {
+            oneOf: [
+                {
+                    $ref: "#/$defs/mailboxCardEnvelope",
+                },
+                {
+                    $ref: "#/$defs/packetEnvelope",
+                },
+            ],
+        },
+        packetHeader: {
+            type: "object",
+            required: ["mailbox_id", "card_hash", "expires_at"],
+            properties: {
+                mailbox_id: {
+                    $ref: "#/$defs/id16",
+                },
+                card_hash: {
+                    $ref: "#/$defs/hash32",
+                },
+                expires_at: {
+                    $ref: "#/$defs/timestampMs",
+                },
+            },
+            additionalProperties: false,
+        },
+        packetPayload: {
+            type: "object",
+            required: ["header", "enc", "ciphertext"],
+            properties: {
+                header: {
+                    $ref: "#/$defs/packetHeader",
+                },
+                enc: {
+                    $ref: "#/$defs/hash32",
+                },
+                ciphertext: {
+                    allOf: [
+                        {
+                            $ref: "#/$defs/base64url",
+                        },
+                    ],
+                    minLength: 1387,
+                    maxLength: 1048576,
+                    description: "Decoded length must be >= 1040 and 16 modulo 1024. Total JCS(packet) length must fit the card and protocol limits; these are semantic checks.",
+                },
+            },
+            additionalProperties: false,
+        },
+        cardAcceptedRecord: {
+            type: "object",
+            required: ["envelope", "accepted_at"],
+            properties: {
+                envelope: {
+                    $ref: "#/$defs/mailboxCardEnvelope",
+                },
+                accepted_at: {
+                    $ref: "#/$defs/timestampMs",
+                },
+            },
+            additionalProperties: false,
+        },
+        deliveryResult: {
+            type: "object",
+            required: ["packet_id", "accepted_at"],
+            properties: {
+                packet_id: {
+                    $ref: "#/$defs/hash32",
+                },
+                accepted_at: {
+                    $ref: "#/$defs/timestampMs",
+                },
+            },
+            additionalProperties: false,
+        },
+        packetRecord: {
+            type: "object",
+            required: ["packet_id", "packet", "accepted_at", "seq"],
+            properties: {
+                packet_id: {
+                    $ref: "#/$defs/hash32",
+                },
+                packet: {
+                    $ref: "#/$defs/packetEnvelope",
+                },
+                accepted_at: {
+                    $ref: "#/$defs/timestampMs",
+                },
+                seq: {
+                    $ref: "#/$defs/positiveSafeInteger",
+                },
+            },
+            additionalProperties: false,
+        },
+        packetList: {
+            type: "object",
+            required: ["result"],
+            properties: {
+                result: {
+                    type: "array",
+                    items: {
+                        $ref: "#/$defs/packetRecord",
+                    },
+                    minItems: 0,
+                    maxItems: 1000,
+                },
+                next_cursor: {
+                    type: "string",
+                    minLength: 1,
+                },
+            },
+            additionalProperties: true,
+        },
+        discoveryDocument: {
+            type: "object",
+            required: ["protocol", "service"],
+            properties: {
+                protocol: {
+                    const: "agent-mail/1.0",
+                },
+                service: {
+                    $ref: "#/$defs/httpsOrigin",
+                },
+                features: {
+                    type: "array",
+                    items: {
+                        type: "string",
+                    },
+                    uniqueItems: true,
+                },
+            },
+            additionalProperties: true,
+            description: "Mail defines no endpoint names; delivery paths are fixed at each card route. Other members are inert extensions.",
+        },
+        packetEvent: {
+            type: "object",
+            required: ["protocol", "type", "actor", "created_at", "nonce", "payload"],
+            properties: {
+                protocol: {
+                    const: "agent-mail/1.0",
+                },
+                type: {
+                    const: "mail.submit",
+                },
+                actor: {
+                    $ref: "#/$defs/agentId",
+                },
+                created_at: {
+                    $ref: "#/$defs/timestampMs",
+                },
+                nonce: {
+                    $ref: "#/$defs/positiveSafeInteger",
+                },
+                payload: {
+                    $ref: "#/$defs/packetPayload",
+                },
+            },
+            additionalProperties: false,
+        },
+        packetEnvelope: {
+            type: "object",
+            required: ["event", "hash", "signature"],
+            properties: {
+                event: {
+                    $ref: "#/$defs/packetEvent",
+                },
+                hash: {
+                    $ref: "#/$defs/hash32",
+                },
+                signature: {
+                    $ref: "#/$defs/signature",
+                },
+            },
+            additionalProperties: false,
+        },
+    },
+    $ref: "#/$defs/envelope",
+};
+//# sourceMappingURL=mail-schema.js.map

package/dist/mail-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-schema.js","sourceRoot":"","sources":["../src/mail-schema.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,8CAA8C;IACvD,GAAG,EAAE,gEAAgE;IACrE,KAAK,EAAE,yBAAyB;IAChC,WAAW,EACT,6QAA6Q;IAC/Q,KAAK,EAAE;QACL,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,6DAA6D;SACvE;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,mDAAmD;SAC7D;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,uCAAuC;SACjD;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,uCAAuC;SACjD;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,OAAO,EACL,gGAAgG;SACnG;QACD,WAAW,EAAE;YACX,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,gBAAgB;SAC1B;QACD,mBAAmB,EAAE;YACnB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,gBAAgB;SAC1B;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,mCAAmC;YAC5C,GAAG,EAAE;gBACH,OAAO,EAAE,mBAAmB;aAC7B;YACD,WAAW,EACT,gHAAgH;SACnH;QACD,kBAAkB,EAAE;YAClB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE;gBACR,YAAY;gBACZ,YAAY;gBACZ,eAAe;gBACf,YAAY;gBACZ,QAAQ;gBACR,kBAAkB;aACnB;YACD,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,cAAc;iBACrB;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,qBAAqB;iBAC5B;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,qBAAqB;iBAC5B;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,gBAAgB;iBACvB;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,qBAAqB;qBAC5B;oBACD,QAAQ,EAAE,CAAC;oBACX,QAAQ,EAAE,CAAC;oBACX,WAAW,EAAE,IAAI;iBAClB;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,OAAO;iBACjB;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC;YAChC,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,GAAG;oBACd,OAAO,EACL,yEAAyE;iBAC5E;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,mBAAmB;iBAC1B;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,CAAC;oBACZ,SAAS,EAAE,GAAG;iBACf;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE;gBACR,YAAY;gBACZ,MAAM;gBACN,YAAY;gBACZ,IAAI;gBACJ,YAAY;gBACZ,WAAW;gBACX,OAAO;aACR;YACD,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,gBAAgB;iBACvB;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,iBAAiB;iBACxB;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,qBAAqB;iBAC5B;gBACD,EAAE,EAAE;oBACF,IAAI,EAAE,iBAAiB;iBACxB;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,qBAAqB;iBAC5B;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,cAAc;iBACrB;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,cAAc;qBACrB;oBACD,QAAQ,EAAE,CAAC;oBACX,QAAQ,EAAE,EAAE;iBACb;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,IAAI;iBAChB;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,gBAAgB;iBACvB;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,6BAA6B;iBACpC;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC;YACzE,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,KAAK,EAAE,gBAAgB;iBACxB;gBACD,IAAI,EAAE;oBACJ,KAAK,EAAE,iBAAiB;iBACzB;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,iBAAiB;iBACxB;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,qBAAqB;iBAC5B;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,6BAA6B;iBACpC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,4BAA4B;iBACnC;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,mBAAmB,EAAE;YACnB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC;YACxC,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,0BAA0B;iBACjC;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,gBAAgB;iBACvB;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,mBAAmB;iBAC1B;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,QAAQ,EAAE;YACR,KAAK,EAAE;gBACL;oBACE,IAAI,EAAE,6BAA6B;iBACpC;gBACD;oBACE,IAAI,EAAE,wBAAwB;iBAC/B;aACF;SACF;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;YACnD,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,cAAc;iBACrB;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,gBAAgB;iBACvB;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,qBAAqB;iBAC5B;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC;YACzC,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,sBAAsB;iBAC7B;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,gBAAgB;iBACvB;gBACD,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,mBAAmB;yBAC1B;qBACF;oBACD,SAAS,EAAE,IAAI;oBACf,SAAS,EAAE,OAAO;oBAClB,WAAW,EACT,+IAA+I;iBAClJ;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,kBAAkB,EAAE;YAClB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC;YACrC,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,6BAA6B;iBACpC;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,qBAAqB;iBAC5B;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;YACtC,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,gBAAgB;iBACvB;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,qBAAqB;iBAC5B;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC;YACvD,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,gBAAgB;iBACvB;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,wBAAwB;iBAC/B;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,qBAAqB;iBAC5B;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,6BAA6B;iBACpC;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,QAAQ,CAAC;YACpB,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,sBAAsB;qBAC7B;oBACD,QAAQ,EAAE,CAAC;oBACX,QAAQ,EAAE,IAAI;iBACf;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,CAAC;iBACb;aACF;YACD,oBAAoB,EAAE,IAAI;SAC3B;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;YACjC,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,KAAK,EAAE,gBAAgB;iBACxB;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,qBAAqB;iBAC5B;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;qBACf;oBACD,WAAW,EAAE,IAAI;iBAClB;aACF;YACD,oBAAoB,EAAE,IAAI;YAC1B,WAAW,EACT,kHAAkH;SACrH;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC;YACzE,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,KAAK,EAAE,gBAAgB;iBACxB;gBACD,IAAI,EAAE;oBACJ,KAAK,EAAE,aAAa;iBACrB;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,iBAAiB;iBACxB;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,qBAAqB;iBAC5B;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,6BAA6B;iBACpC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,uBAAuB;iBAC9B;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC;YACxC,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,qBAAqB;iBAC5B;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,gBAAgB;iBACvB;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,mBAAmB;iBAC1B;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD,IAAI,EAAE,kBAAkB;CAChB,CAAC"}

package/dist/mail.d.ts

@@ -0,0 +1,244 @@
+import { AgentSigner, type NonceStore, type Event, type Envelope, type AcceptedRecord, type ListResponse } from "./identity.js";
+export { MAIL_SCHEMA } from "./mail-schema.js";
+export declare const MAIL_PROTOCOL = "agent-mail/1.0";
+export declare const MAIL_MAX_TTL_MS: number;
+export declare const MAIL_FUTURE_SKEW_MS = 300000;
+export declare const MAIL_MAX_PACKET_BYTES = 1048576;
+export interface MailboxCardPayload {
+    mailbox_id: string;
+    expires_at: number;
+    receive_until: number;
+    public_key: string;
+    routes: string[];
+    max_packet_bytes: number;
+}
+export type MailboxCard = Envelope<MailboxCardPayload>;
+export interface MailPart {
+    media_type: string;
+    data: string;
+    name?: string;
+}
+export interface MailMessagePayload {
+    message_id: string;
+    from: string;
+    created_at: number;
+    to: string;
+    expires_at: number;
+    thread_id: string;
+    parts: MailPart[];
+    subject?: string;
+    in_reply_to?: string;
+    reply_card?: MailboxCard;
+}
+/** The signed `mail.submit` envelope: the wire object relays store and recipients open. */
+export type MailPacket = Envelope<MailPacketPayload>;
+export interface MailPacketHeader {
+    mailbox_id: string;
+    card_hash: string;
+    expires_at: number;
+}
+export interface MailPacketPayload {
+    header: MailPacketHeader;
+    enc: string;
+    ciphertext: string;
+}
+export interface MailDeliveryResult {
+    packet_id: string;
+    accepted_at: number;
+}
+export interface MailPacketRecord extends MailDeliveryResult {
+    packet: MailPacket;
+    seq: number;
+}
+export interface MailDiscovery {
+    protocol: typeof MAIL_PROTOCOL;
+    service: string;
+    features?: string[];
+    [key: string]: unknown;
+}
+export type MailCardRecord = AcceptedRecord<MailboxCardPayload>;
+export type MailPacketList = ListResponse<MailPacketRecord> & {
+    [key: string]: unknown;
+};
+/** Canonical, strict I-JSON bytes. This never silently drops undefined members. */
+export declare function mailCanonicalBytes(value: unknown): Uint8Array;
+export declare function validateMailSchema(value: unknown, definition?: string): void;
+export declare function decodeMailBytes(value: string, length?: number): Uint8Array;
+export declare function newMailId(): string;
+/** A parsed mailbox address (Mail Section 3.3). `routes` is empty for the stable form. */
+export interface MailAddress {
+    owner: string;
+    mailbox_id: string;
+    routes: string[];
+}
+/** Parse `did:agent:<key>/mail/<mailbox_id>[?route=<origin>...]`. */
+export declare function parseMailAddress(value: unknown): MailAddress;
+/** Format the stable address, or a contact address when routes are given. */
+export declare function formatMailAddress(owner: string, mailboxId: string, routes?: string[]): string;
+export declare function mailTextPart(text: string, name?: string): MailPart;
+/** Returns inert text only; does not render markup or perform network/file actions. */
+export declare function mailPartText(part: MailPart): string;
+/** Historical verification: shape, signature, owner, intrinsic times, routes, and key. */
+export declare function validateMailboxCard(card: unknown, owner?: string): asserts card is MailboxCard;
+/** A card usable for new encryption: not future-dated, open (non-empty routes), unexpired. */
+export declare function validateMailSenderCard(card: unknown, owner: string, now?: number): asserts card is MailboxCard;
+/** Validate immutable plaintext; sender authentication comes from its signed packet. */
+export declare function validateMailMessage(message: unknown): asserts message is MailMessagePayload;
+export declare function mailboxPublishEvent(actor: string, createdAt: number, nonce: number, payload: MailboxCardPayload): Event<MailboxCardPayload>;
+export declare function newMailMessageId(): string;
+export declare function createMailMessage(actor: string, createdAt: number, payload: Omit<MailMessagePayload, "message_id" | "from" | "created_at">): MailMessagePayload;
+export declare function validateMailReply(reply: MailMessagePayload, parent: MailMessagePayload): void;
+export declare function validateMailPacket(packet: unknown, expectedId?: string): asserts packet is MailPacket;
+export declare function mailPacketId(packet: MailPacket): string;
+/** HPKE AAD: the packet's five metadata fields and header, from the verified outer event. */
+export declare function mailPacketAad(event: Event<MailPacketPayload>): Uint8Array;
+export declare function frameMailBytes(bytes: Uint8Array): Uint8Array;
+export declare function unframeMailMessage(frame: Uint8Array): MailMessagePayload;
+/** Independent raw X25519 secret. Never derive this from an Identity signing key. */
+export declare class MailEncryptionKey {
+    private secret;
+    private destroyed;
+    private constructor();
+    static generate(): MailEncryptionKey;
+    static fromBytes(secret: Uint8Array): MailEncryptionKey;
+    publicKey(): string;
+    /** Sensitive backup material: store only in an owner-controlled encrypted key store. */
+    exportSecret(): Uint8Array;
+    destroy(): void;
+}
+/** Stateless encryption with fresh HPKE randomness. Pin the card with MailCardCache first. */
+export declare function sealMailPacket(message: MailMessagePayload, card: MailboxCard, signer: AgentSigner, nonce: number, now?: number): Promise<MailPacket>;
+/** Verify/decrypt a queued packet; expiration of new acceptance is checked by MailInbox. */
+export declare function openMailPacket(packet: MailPacket, card: MailboxCard, key: MailEncryptionKey, owner: string, now?: number, expectedId?: string): Promise<MailMessagePayload>;
+export interface MailCardCacheSnapshot {
+    version: 1;
+    pins: MailboxCard[];
+}
+/**
+ * Sender-side card pins: the greatest-nonce card seen per (owner, mailbox),
+ * including closed or expired cards. Persist the snapshot after every observe,
+ * even one that throws because the new pin is unusable.
+ */
+export declare class MailCardCache {
+    private readonly pins;
+    constructor(snapshot?: MailCardCacheSnapshot);
+    private id;
+    snapshot(): MailCardCacheSnapshot;
+    /** Pin a verified card, then (by default) require that it is usable for new encryption. */
+    observe(card: MailboxCard, owner: string, now?: number, requireUsable?: boolean): MailboxCard;
+    /** Drop pins old enough that every earlier card of the mailbox has expired. */
+    prune(now?: number): void;
+    seal(message: MailMessagePayload, card: MailboxCard, signer: AgentSigner, nonce: number, now?: number): Promise<MailPacket>;
+}
+export interface MailKeyringSnapshot {
+    version: 1;
+    owner: string;
+    entries: {
+        card: MailboxCard;
+        secret: string;
+    }[];
+}
+/** Retained verified cards and their secrets, looked up by card hash until receive_until. */
+export declare class MailKeyring {
+    readonly owner: string;
+    private readonly entries;
+    constructor(owner: string);
+    add(card: MailboxCard, key: MailEncryptionKey): void;
+    /** Sensitive snapshot, including raw encryption secrets. Protect it separately from logs and application data. */
+    exportSnapshot(): MailKeyringSnapshot;
+    static restore(snapshot: MailKeyringSnapshot): MailKeyring;
+    prune(now?: number): void;
+    open(packet: MailPacket, now?: number, expectedId?: string): Promise<MailMessagePayload>;
+    /** @internal Open a packet already checked by `packetBytes`; used by `MailInbox`. */
+    openChecked(packet: MailPacket, bytes: Uint8Array, now: number): Promise<MailMessagePayload>;
+}
+export interface MailInboxSnapshot {
+    version: 1;
+    owner: string;
+    accepted: [string, number, string][];
+    blocked_senders: string[];
+}
+export declare class MailInbox {
+    readonly keyring: MailKeyring;
+    private readonly accepted;
+    private readonly blocked;
+    constructor(keyring: MailKeyring, snapshot?: MailInboxSnapshot);
+    setSenderBlocked(sender: string, blocked?: boolean): void;
+    snapshot(): MailInboxSnapshot;
+    has(sender: string, messageId: string): boolean;
+    /** Verify the packet once, apply sender policy before decryption, then deduplicate the message. */
+    accept(packet: MailPacket, now?: number, expectedId?: string): Promise<{
+        kind: "accepted" | "duplicate";
+        message: MailMessagePayload;
+    }>;
+    prune(now?: number): void;
+}
+export declare function validateMailDiscovery(value: unknown, service: string): asserts value is MailDiscovery;
+/** Identity request JWT for this relay origin whose subject is the mailbox owner. */
+export declare function validateMailOwnerJwt(token: string, service: string, owner: string, now?: number): void;
+export declare function validateMailCardRecord(value: unknown, owner?: string, mailboxId?: string, hash?: string): asserts value is MailCardRecord;
+export declare function validateMailDeliveryResult(value: unknown, packet?: MailPacket): asserts value is MailDeliveryResult;
+export declare function validateMailPacketRecord(value: unknown, mailboxId?: string): asserts value is MailPacketRecord;
+export declare function validateMailPacketList(value: unknown, mailboxId: string, limit?: number): asserts value is MailPacketList;
+export interface MailRelaySnapshot {
+    version: 1;
+    origin: string;
+    mailboxes: {
+        current: MailCardRecord;
+        last_seq: number;
+        blocked_senders: string[];
+        packets: MailPacketRecord[];
+        tombstones: {
+            packet_id: string;
+            accepted_at: number;
+            expires_at: number;
+        }[];
+    }[];
+}
+export interface MailRelayOptions {
+    clock?: () => number;
+    /** Service-wide Identity nonce cache for card publishes; packets are not live writes. */
+    nonceStore?: NonceStore;
+    /** Per-mailbox limits on retained packets. */
+    maxPackets?: number;
+    maxBytes?: number;
+    snapshot?: MailRelaySnapshot;
+}
+/**
+ * Synchronous process-local relay model. All validation precedes mutation;
+ * persist the snapshot atomically before emitting a successful HTTP response.
+ * The short-lived nonce cache is not part of the snapshot.
+ */
+export declare class MailRelayStore {
+    readonly origin: string;
+    private readonly boxes;
+    private readonly nonces;
+    private readonly clock;
+    private readonly maxPackets;
+    private readonly maxBytes;
+    constructor(origin: string, options?: MailRelayOptions);
+    snapshot(): MailRelaySnapshot;
+    discovery(): MailDiscovery;
+    publish(card: MailboxCard, now?: number): MailCardRecord;
+    card(mailboxId: string): MailCardRecord;
+    publishJson(text: string, now?: number): MailCardRecord;
+    deliverJson(mailboxId: string, text: string, now?: number): MailDeliveryResult;
+    /** Packets are asynchronous signed objects: no live-write window or nonce maximum applies. */
+    deliver(mailboxId: string, packet: MailPacket, now?: number): MailDeliveryResult;
+    /**
+     * Owner sender policy for new packets. Mail defines no management endpoint:
+     * the host authenticates the mailbox owner before calling this.
+     */
+    setSenderBlocked(mailboxId: string, sender: string, blocked: boolean): void;
+    private ownerBox;
+    list(mailboxId: string, jwt: string, options?: {
+        limit?: number;
+        cursor?: string;
+        now?: number;
+    }): MailPacketList;
+    delete(mailboxId: string, packetId: string, jwt: string, now?: number): void;
+    /** Drop expired packets and tombstones, then forget mailboxes whose current card's `receive_until` passed. */
+    prune(now?: number): void;
+    private dropExpired;
+}
+//# sourceMappingURL=mail.d.ts.map

package/dist/mail.d.ts.map

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