@joe-broadhead/messaging 0.7.0 → 0.7.1

package/dist/types/core/schema/envelope.d.ts

@@ -429,6 +429,8 @@ export declare const ReceiptPayload: z.ZodObject<{
         binding_invalid: "binding_invalid";
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
+        conv_conflict: "conv_conflict";
+        stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";
         admission_invalid: "admission_invalid";
@@ -443,6 +445,7 @@ export declare const ReceiptPayload: z.ZodObject<{
         ticket_invalid: "ticket_invalid";
         daemon_unavailable: "daemon_unavailable";
         daemon_mismatch: "daemon_mismatch";
+        store_refused: "store_refused";
         internal: "internal";
     }>>;
     note: z.ZodOptional<z.ZodString>;
@@ -682,6 +685,8 @@ export declare const PAYLOAD_BY_TYPE: {
             binding_invalid: "binding_invalid";
             jelly_unavailable: "jelly_unavailable";
             log_conflict: "log_conflict";
+            conv_conflict: "conv_conflict";
+            stale_epoch: "stale_epoch";
             device_limit: "device_limit";
             admission_required: "admission_required";
             admission_invalid: "admission_invalid";
@@ -696,6 +701,7 @@ export declare const PAYLOAD_BY_TYPE: {
             ticket_invalid: "ticket_invalid";
             daemon_unavailable: "daemon_unavailable";
             daemon_mismatch: "daemon_mismatch";
+            store_refused: "store_refused";
             internal: "internal";
         }>>;
         note: z.ZodOptional<z.ZodString>;

package/dist/types/core/schema/errors.d.ts

@@ -28,6 +28,8 @@ export declare const ErrorCode: z.ZodEnum<{
     binding_invalid: "binding_invalid";
     jelly_unavailable: "jelly_unavailable";
     log_conflict: "log_conflict";
+    conv_conflict: "conv_conflict";
+    stale_epoch: "stale_epoch";
     device_limit: "device_limit";
     admission_required: "admission_required";
     admission_invalid: "admission_invalid";
@@ -42,9 +44,28 @@ export declare const ErrorCode: z.ZodEnum<{
     ticket_invalid: "ticket_invalid";
     daemon_unavailable: "daemon_unavailable";
     daemon_mismatch: "daemon_mismatch";
+    store_refused: "store_refused";
     internal: "internal";
 }>;
 export type ErrorCode = z.infer<typeof ErrorCode>;
+/**
+ * The exit status of a messagingd or messaging-relay that refuses its store and changes nothing (spec §8.8): `EX_CONFIG`
+ * of sysexits(3), for either reason. messagingd also prints one stderr line,
+ * `messagingd: store_refused: <reason>: <why and how to start over>`. A client matches this status, the code and the
+ * reason, never the wording.
+ */
+export declare const STORE_REFUSED_EXIT = 78;
+/**
+ * Why a store is refused (spec §8.8):
+ * - `pre-reset`: it records no store generation, or another one. Starting over (moving the home aside) is the remedy.
+ * - `newer`: its `min_reader` is above this reader's schema: a newer messagingd wrote it. Upgrading is the remedy;
+ *   moving the home aside would set a newer home aside.
+ */
+export declare const StoreRefusedReason: z.ZodEnum<{
+    "pre-reset": "pre-reset";
+    newer: "newer";
+}>;
+export type StoreRefusedReason = z.infer<typeof StoreRefusedReason>;
 export declare const ErrorBody: z.ZodObject<{
     code: z.ZodEnum<{
         expired: "expired";
@@ -74,6 +95,8 @@ export declare const ErrorBody: z.ZodObject<{
         binding_invalid: "binding_invalid";
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
+        conv_conflict: "conv_conflict";
+        stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";
         admission_invalid: "admission_invalid";
@@ -88,6 +111,7 @@ export declare const ErrorBody: z.ZodObject<{
         ticket_invalid: "ticket_invalid";
         daemon_unavailable: "daemon_unavailable";
         daemon_mismatch: "daemon_mismatch";
+        store_refused: "store_refused";
         internal: "internal";
     }>;
     message: z.ZodString;
@@ -101,4 +125,18 @@ export declare class MessagingError extends Error {
     });
     toBody(): ErrorBody;
 }
+/** `store_refused`, with its reason as a field: clients branch on `reason`, never on the message. */
+export declare class StoreRefusedError extends MessagingError {
+    readonly reason: StoreRefusedReason;
+    constructor(reason: StoreRefusedReason, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** The stderr line of a messagingd that refuses its store: `messagingd: store_refused: <reason>: <text>`. */
+export declare function storeRefusedLine(reason: StoreRefusedReason, text: string): string;
+/**
+ * The reason on a messagingd refusal line, or undefined for any other line. Reads the tokens only; the text after
+ * them may change between releases.
+ */
+export declare function storeRefusedReason(line: string): StoreRefusedReason | undefined;
 export declare function isMessagingError(value: unknown): value is MessagingError;

package/dist/types/core/schema/index.d.ts

@@ -13,3 +13,4 @@ export * from "./directory-frames.js";
 export * from "./ipc.js";
 export * from "./ipc/device.js";
 export * from "./ipc/consent.js";
+export * from "./conversation.js";

package/dist/types/core/schema/ipc/device.d.ts

@@ -236,6 +236,8 @@ export declare const LoginState: z.ZodDiscriminatedUnion<[z.ZodObject<{
         binding_invalid: "binding_invalid";
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
+        conv_conflict: "conv_conflict";
+        stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";
         admission_invalid: "admission_invalid";
@@ -250,6 +252,7 @@ export declare const LoginState: z.ZodDiscriminatedUnion<[z.ZodObject<{
         ticket_invalid: "ticket_invalid";
         daemon_unavailable: "daemon_unavailable";
         daemon_mismatch: "daemon_mismatch";
+        store_refused: "store_refused";
         internal: "internal";
     }>;
     message: z.ZodString;
@@ -523,6 +526,8 @@ export declare const DEVICE_METHODS: {
                 binding_invalid: "binding_invalid";
                 jelly_unavailable: "jelly_unavailable";
                 log_conflict: "log_conflict";
+                conv_conflict: "conv_conflict";
+                stale_epoch: "stale_epoch";
                 device_limit: "device_limit";
                 admission_required: "admission_required";
                 admission_invalid: "admission_invalid";
@@ -537,6 +542,7 @@ export declare const DEVICE_METHODS: {
                 ticket_invalid: "ticket_invalid";
                 daemon_unavailable: "daemon_unavailable";
                 daemon_mismatch: "daemon_mismatch";
+                store_refused: "store_refused";
                 internal: "internal";
             }>;
             message: z.ZodString;

package/dist/types/core/schema/ipc/shapes.d.ts

@@ -331,6 +331,8 @@ export declare const SendResult: z.ZodObject<{
         binding_invalid: "binding_invalid";
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
+        conv_conflict: "conv_conflict";
+        stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";
         admission_invalid: "admission_invalid";
@@ -345,6 +347,7 @@ export declare const SendResult: z.ZodObject<{
         ticket_invalid: "ticket_invalid";
         daemon_unavailable: "daemon_unavailable";
         daemon_mismatch: "daemon_mismatch";
+        store_refused: "store_refused";
         internal: "internal";
     }>>;
     expect: z.ZodOptional<z.ZodEnum<{

package/dist/types/core/schema/ipc/surfaces.d.ts

@@ -219,6 +219,8 @@ export declare const SURFACE_METHODS: {
                     binding_invalid: "binding_invalid";
                     jelly_unavailable: "jelly_unavailable";
                     log_conflict: "log_conflict";
+                    conv_conflict: "conv_conflict";
+                    stale_epoch: "stale_epoch";
                     device_limit: "device_limit";
                     admission_required: "admission_required";
                     admission_invalid: "admission_invalid";
@@ -233,6 +235,7 @@ export declare const SURFACE_METHODS: {
                     ticket_invalid: "ticket_invalid";
                     daemon_unavailable: "daemon_unavailable";
                     daemon_mismatch: "daemon_mismatch";
+                    store_refused: "store_refused";
                     internal: "internal";
                 }>>;
                 expect: z.ZodOptional<z.ZodEnum<{
@@ -375,6 +378,8 @@ export declare const SURFACE_METHODS: {
                     binding_invalid: "binding_invalid";
                     jelly_unavailable: "jelly_unavailable";
                     log_conflict: "log_conflict";
+                    conv_conflict: "conv_conflict";
+                    stale_epoch: "stale_epoch";
                     device_limit: "device_limit";
                     admission_required: "admission_required";
                     admission_invalid: "admission_invalid";
@@ -389,6 +394,7 @@ export declare const SURFACE_METHODS: {
                     ticket_invalid: "ticket_invalid";
                     daemon_unavailable: "daemon_unavailable";
                     daemon_mismatch: "daemon_mismatch";
+                    store_refused: "store_refused";
                     internal: "internal";
                 }>>;
                 note: z.ZodOptional<z.ZodString>;

package/dist/types/core/schema/ipc.d.ts

@@ -294,6 +294,8 @@ export declare const IPC_METHODS: {
                     binding_invalid: "binding_invalid";
                     jelly_unavailable: "jelly_unavailable";
                     log_conflict: "log_conflict";
+                    conv_conflict: "conv_conflict";
+                    stale_epoch: "stale_epoch";
                     device_limit: "device_limit";
                     admission_required: "admission_required";
                     admission_invalid: "admission_invalid";
@@ -308,6 +310,7 @@ export declare const IPC_METHODS: {
                     ticket_invalid: "ticket_invalid";
                     daemon_unavailable: "daemon_unavailable";
                     daemon_mismatch: "daemon_mismatch";
+                    store_refused: "store_refused";
                     internal: "internal";
                 }>>;
                 expect: z.ZodOptional<z.ZodEnum<{
@@ -445,6 +448,8 @@ export declare const IPC_METHODS: {
                     binding_invalid: "binding_invalid";
                     jelly_unavailable: "jelly_unavailable";
                     log_conflict: "log_conflict";
+                    conv_conflict: "conv_conflict";
+                    stale_epoch: "stale_epoch";
                     device_limit: "device_limit";
                     admission_required: "admission_required";
                     admission_invalid: "admission_invalid";
@@ -459,6 +464,7 @@ export declare const IPC_METHODS: {
                     ticket_invalid: "ticket_invalid";
                     daemon_unavailable: "daemon_unavailable";
                     daemon_mismatch: "daemon_mismatch";
+                    store_refused: "store_refused";
                     internal: "internal";
                 }>>;
                 note: z.ZodOptional<z.ZodString>;
@@ -2515,6 +2521,8 @@ export declare const IPC_METHODS: {
                 binding_invalid: "binding_invalid";
                 jelly_unavailable: "jelly_unavailable";
                 log_conflict: "log_conflict";
+                conv_conflict: "conv_conflict";
+                stale_epoch: "stale_epoch";
                 device_limit: "device_limit";
                 admission_required: "admission_required";
                 admission_invalid: "admission_invalid";
@@ -2529,6 +2537,7 @@ export declare const IPC_METHODS: {
                 ticket_invalid: "ticket_invalid";
                 daemon_unavailable: "daemon_unavailable";
                 daemon_mismatch: "daemon_mismatch";
+                store_refused: "store_refused";
                 internal: "internal";
             }>;
             message: z.ZodString;
@@ -2805,6 +2814,8 @@ export declare const IpcEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
         binding_invalid: "binding_invalid";
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
+        conv_conflict: "conv_conflict";
+        stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";
         admission_invalid: "admission_invalid";
@@ -2819,6 +2830,7 @@ export declare const IpcEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
         ticket_invalid: "ticket_invalid";
         daemon_unavailable: "daemon_unavailable";
         daemon_mismatch: "daemon_mismatch";
+        store_refused: "store_refused";
         internal: "internal";
     }>>;
 }, z.core.$strip>, z.ZodObject<{
@@ -3052,6 +3064,8 @@ export declare const IpcEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
         binding_invalid: "binding_invalid";
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
+        conv_conflict: "conv_conflict";
+        stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";
         admission_invalid: "admission_invalid";
@@ -3066,6 +3080,7 @@ export declare const IpcEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
         ticket_invalid: "ticket_invalid";
         daemon_unavailable: "daemon_unavailable";
         daemon_mismatch: "daemon_mismatch";
+        store_refused: "store_refused";
         internal: "internal";
     }>>;
 }, z.core.$strip>, z.ZodObject<{

package/dist/types/core/schema/relay.d.ts

@@ -84,6 +84,8 @@ export declare const NackFrame: z.ZodObject<{
         binding_invalid: "binding_invalid";
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
+        conv_conflict: "conv_conflict";
+        stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";
         admission_invalid: "admission_invalid";
@@ -98,6 +100,7 @@ export declare const NackFrame: z.ZodObject<{
         ticket_invalid: "ticket_invalid";
         daemon_unavailable: "daemon_unavailable";
         daemon_mismatch: "daemon_mismatch";
+        store_refused: "store_refused";
         internal: "internal";
     }>;
     message: z.ZodString;
@@ -285,6 +288,8 @@ export declare const ErrorFrame: z.ZodObject<{
         binding_invalid: "binding_invalid";
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
+        conv_conflict: "conv_conflict";
+        stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";
         admission_invalid: "admission_invalid";
@@ -299,6 +304,7 @@ export declare const ErrorFrame: z.ZodObject<{
         ticket_invalid: "ticket_invalid";
         daemon_unavailable: "daemon_unavailable";
         daemon_mismatch: "daemon_mismatch";
+        store_refused: "store_refused";
         internal: "internal";
     }>;
     message: z.ZodString;
@@ -360,6 +366,8 @@ export declare const RelayToClient: z.ZodDiscriminatedUnion<[z.ZodObject<{
         binding_invalid: "binding_invalid";
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
+        conv_conflict: "conv_conflict";
+        stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";
         admission_invalid: "admission_invalid";
@@ -374,6 +382,7 @@ export declare const RelayToClient: z.ZodDiscriminatedUnion<[z.ZodObject<{
         ticket_invalid: "ticket_invalid";
         daemon_unavailable: "daemon_unavailable";
         daemon_mismatch: "daemon_mismatch";
+        store_refused: "store_refused";
         internal: "internal";
     }>;
     message: z.ZodString;
@@ -556,6 +565,8 @@ export declare const RelayToClient: z.ZodDiscriminatedUnion<[z.ZodObject<{
         binding_invalid: "binding_invalid";
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
+        conv_conflict: "conv_conflict";
+        stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";
         admission_invalid: "admission_invalid";
@@ -570,6 +581,7 @@ export declare const RelayToClient: z.ZodDiscriminatedUnion<[z.ZodObject<{
         ticket_invalid: "ticket_invalid";
         daemon_unavailable: "daemon_unavailable";
         daemon_mismatch: "daemon_mismatch";
+        store_refused: "store_refused";
         internal: "internal";
     }>;
     message: z.ZodString;

package/dist/types/core/testing.d.ts

@@ -7,6 +7,7 @@ export { encodeTicket } from "./roster.js";
 export { grantHash } from "./delegation.js";
 export { signJellyToken } from "./directory/jelly-issuer.js";
 export { jellyHostDouble, type JellyHostDouble } from "./jelly-host-double.js";
+export { sealConvMetaWith, sealConvMsgWith, sealKeySharesWith, type ShareRandomness } from "./conversation/seal.js";
 /**
  * Narrows a result whose `kind` tells its shape (`item.read`, `conv.read`) to the expected kind, and
  * throws with both kinds named otherwise: `client.call("item.read", p).then(asKind("received"))`.

package/dist/types/core/version.d.ts

@@ -3,4 +3,4 @@
  * its IPC hello and a client compares it with its own (spec §8.2). A test keeps it equal to the
  * root package.json.
  */
-export declare const VERSION = "0.7.0";
+export declare const VERSION = "0.7.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joe-broadhead/messaging",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Messaging: the relay, the per-machine daemon and its CLI, and the MCP server as bundled single files, plus the client libraries and the protocol spec. Zero dependencies.",
   "type": "module",
   "license": "MIT",