@cleocode/contracts 2026.10.3 → 2026.10.5-rc.ci.672

package/dist/__tests__/cloud-replica-retirement.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cloud contract mirror of cleo-nexus #41 (T123 replica retirement, contract
+ * v2.28; T13284): the E31 request and answer, the stored retirement, and the
+ * `retiredAt` / `successor` fields home replicas gain, as the server validates
+ * them.
+ *
+ * @task T13284
+ */
+export {};
+//# sourceMappingURL=cloud-replica-retirement.test.d.ts.map

package/dist/__tests__/cloud-replica-retirement.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-replica-retirement.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cloud-replica-retirement.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/cloud-replica-retirement.test.js

@@ -0,0 +1,111 @@
+/**
+ * Cloud contract mirror of cleo-nexus #41 (T123 replica retirement, contract
+ * v2.28; T13284): the E31 request and answer, the stored retirement, and the
+ * `retiredAt` / `successor` fields home replicas gain, as the server validates
+ * them.
+ *
+ * @task T13284
+ */
+import { describe, expect, it } from 'vitest';
+import { AttachHomeReplicaResult, HomeReplica, ListHomeReplicasResult, ReplicaRetirement, RetireReplicaRequest, RetireReplicaResult, } from '../cloud/index.js';
+import { NEXUS_REPLICA_RETIREMENT_REASONS } from '../nexus-vault.js';
+const DEVICE = '0192f1c2-7d3e-4abc-8def-0000000000b0';
+const R1 = '0192f1c2-7d3e-7abc-8def-0000000000a1';
+const R2 = '0192f1c2-7d3e-7abc-8def-0000000000b1';
+const STREAM = 'project:0192f1c2-7d3e-7abc-8def-0123456789ab';
+const SIG = Buffer.alloc(64, 7).toString('base64');
+const request = {
+    deviceId: DEVICE,
+    successor: R2,
+    lastReplicaSeq: 4,
+    txnId: `${R1}:17`,
+    signature: SIG,
+};
+describe('RetireReplicaRequest (T13284)', () => {
+    it('takes a successor, lastReplicaSeq and txn id, each nullable', () => {
+        expect(RetireReplicaRequest.safeParse(request).success).toBe(true);
+        expect(RetireReplicaRequest.safeParse({
+            ...request,
+            successor: null,
+            lastReplicaSeq: null,
+            txnId: null,
+        }).success).toBe(true);
+    });
+    it('refuses a negative or fractional lastReplicaSeq and a malformed txn id', () => {
+        expect(RetireReplicaRequest.safeParse({ ...request, lastReplicaSeq: -1 }).success).toBe(false);
+        expect(RetireReplicaRequest.safeParse({ ...request, lastReplicaSeq: 1.5 }).success).toBe(false);
+        for (const txnId of [
+            R1,
+            `${R1}:`,
+            `${R1}:01`,
+            `${R1}:-1`,
+            `not-a-uuid:3`,
+            `${R1}:12345678901234567`,
+        ]) {
+            expect(RetireReplicaRequest.safeParse({ ...request, txnId }).success).toBe(false);
+        }
+        // Any UUID may emit the transaction (the successor on a rebind), not only a v7 replica id.
+        expect(RetireReplicaRequest.safeParse({ ...request, txnId: `${DEVICE}:0` }).success).toBe(true);
+    });
+    it('a successor must be a replica id (UUIDv7)', () => {
+        expect(RetireReplicaRequest.safeParse({ ...request, successor: DEVICE }).success).toBe(false);
+    });
+});
+describe('ReplicaRetirement and RetireReplicaResult (T13284)', () => {
+    const stored = {
+        streamId: STREAM,
+        replicaId: R1,
+        successor: R2,
+        lastReplicaSeq: null,
+        signerDeviceId: DEVICE,
+        txnId: null,
+        signature: SIG,
+        retiredAt: '2026-10-06T07:00:00.000Z',
+    };
+    it('is the stored record, wrapped as { retirement }', () => {
+        expect(ReplicaRetirement.safeParse(stored).success).toBe(true);
+        expect(RetireReplicaResult.safeParse({ retirement: stored }).success).toBe(true);
+        expect(RetireReplicaResult.safeParse(stored).success).toBe(false);
+        const { retiredAt: _retiredAt, ...undated } = stored;
+        expect(ReplicaRetirement.safeParse(undated).success).toBe(false);
+    });
+});
+describe('home replicas carry retiredAt and successor (T13284)', () => {
+    const replica = {
+        replicaId: R1,
+        deviceId: DEVICE,
+        deviceState: 'active',
+        attachedAt: '2026-10-01T00:00:00.000Z',
+        lastSyncAt: null,
+        presence: null,
+        presenceAt: null,
+    };
+    it('parses an older server without them, and a retired replica with them', () => {
+        expect(HomeReplica.safeParse(replica).success).toBe(true);
+        const retired = { ...replica, retiredAt: '2026-10-06T07:00:00.000Z', successor: R2 };
+        expect(HomeReplica.parse(retired)).toMatchObject({
+            retiredAt: retired.retiredAt,
+            successor: R2,
+        });
+        expect(HomeReplica.safeParse({ ...replica, retiredAt: null, successor: null }).success).toBe(true);
+        expect(HomeReplica.safeParse({ ...replica, successor: DEVICE }).success).toBe(false);
+    });
+    it('the attach answer and the list follow HomeReplica', () => {
+        expect(AttachHomeReplicaResult).toBe(HomeReplica);
+        expect(ListHomeReplicasResult.shape.replicas.element).toBe(HomeReplica);
+    });
+});
+describe('E31 refusal reasons (T13284)', () => {
+    it('are the seven server reasons', () => {
+        expect([...NEXUS_REPLICA_RETIREMENT_REASONS].sort()).toEqual([
+            'not-pinned-or-owner',
+            'replica-retired',
+            'retire-below-head',
+            'retired',
+            'successor-other-user',
+            'successor-retired',
+            'successor-taken',
+        ].sort());
+    });
+});
+//# sourceMappingURL=cloud-replica-retirement.test.js.map

package/dist/__tests__/cloud-replica-retirement.test.js.map

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

package/dist/__tests__/cloud-status-checkpoint-reads.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cloud contract mirrors of cleo-nexus #38 (`DeviceScope`, `StatusQuery`;
+ * T13282) and #39 (`GetCheckpointResult`; T13283): the shapes the server
+ * validates, so a client that parses with them agrees with it.
+ *
+ * @task T13282
+ * @task T13283
+ */
+export {};
+//# sourceMappingURL=cloud-status-checkpoint-reads.test.d.ts.map

package/dist/__tests__/cloud-status-checkpoint-reads.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-status-checkpoint-reads.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cloud-status-checkpoint-reads.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/cloud-status-checkpoint-reads.test.js

@@ -0,0 +1,49 @@
+/**
+ * Cloud contract mirrors of cleo-nexus #38 (`DeviceScope`, `StatusQuery`;
+ * T13282) and #39 (`GetCheckpointResult`; T13283): the shapes the server
+ * validates, so a client that parses with them agrees with it.
+ *
+ * @task T13282
+ * @task T13283
+ */
+import { describe, expect, it } from 'vitest';
+import { DeviceScope, GetCheckpointResult, ListCheckpointsResult, StatusQuery, } from '../cloud/index.js';
+const PROJECT = '0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b';
+const REPLICA = '0198a1b2-0000-7000-8000-0000000000a1';
+describe('DeviceScope and StatusQuery (T13282)', () => {
+    it('DeviceScope is the eight §2.3 scopes and nothing else', () => {
+        expect(DeviceScope.options).toEqual([
+            'account:read',
+            'devices:read',
+            'projects:read',
+            'projects:write',
+            'sync:read',
+            'sync:write',
+            'keys:read',
+            'keys:write',
+        ]);
+        expect(DeviceScope.safeParse('admin').success).toBe(false);
+    });
+    it('StatusQuery: both optional, replicaId requires projectId and must be a UUIDv7', () => {
+        expect(StatusQuery.safeParse({}).success).toBe(true);
+        expect(StatusQuery.safeParse({ projectId: PROJECT }).success).toBe(true);
+        expect(StatusQuery.safeParse({ projectId: PROJECT, replicaId: REPLICA }).success).toBe(true);
+        const orphan = StatusQuery.safeParse({ replicaId: REPLICA });
+        expect(orphan.success).toBe(false);
+        expect(orphan.error?.issues[0]?.message).toBe('replicaId requires projectId');
+        // A UUIDv4 is not a replica id.
+        expect(StatusQuery.safeParse({
+            projectId: PROJECT,
+            replicaId: '0198a1b2-0000-4000-8000-0000000000a1',
+        }).success).toBe(false);
+    });
+});
+describe('GetCheckpointResult (T13283)', () => {
+    it('is one checkpoint shaped exactly as a list item', () => {
+        const listItem = ListCheckpointsResult.shape.checkpoints.element;
+        expect(GetCheckpointResult.shape.checkpoint).toBe(listItem);
+        expect(Object.keys(GetCheckpointResult.shape)).toEqual(['checkpoint']);
+        expect(GetCheckpointResult.safeParse({ checkpoints: [] }).success).toBe(false);
+    });
+});
+//# sourceMappingURL=cloud-status-checkpoint-reads.test.js.map

package/dist/__tests__/cloud-status-checkpoint-reads.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-status-checkpoint-reads.test.js","sourceRoot":"","sources":["../../src/__tests__/cloud-status-checkpoint-reads.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,MAAM,OAAO,GAAG,sCAAsC,CAAC;AACvD,MAAM,OAAO,GAAG,sCAAsC,CAAC;AAEvD,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YAClC,cAAc;YACd,cAAc;YACd,eAAe;YACf,gBAAgB;YAChB,WAAW;YACX,YAAY;YACZ,WAAW;YACX,YAAY;SACb,CAAC,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzE,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC9E,gCAAgC;QAChC,MAAM,CACJ,WAAW,CAAC,SAAS,CAAC;YACpB,SAAS,EAAE,OAAO;YAClB,SAAS,EAAE,sCAAsC;SAClD,CAAC,CAAC,OAAO,CACX,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC;QACjE,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QACvE,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/agent-registry.d.ts

@@ -37,7 +37,11 @@ export interface AgentCredential {
      * device). Re-register with `cleo agent register --id <id> --api-key <key>`.
      */
     requiresReauth?: boolean;
-    /** Base URL of the messaging API (default: api.signaldock.io). */
+    /**
+     * Base URL of the cloud messaging API, or `'local'` for none. Rows from
+     * before T13169 may still hold the retired `https://api.signaldock.io`;
+     * CLEO never calls a SignalDock host.
+     */
     apiBaseUrl: string;
     /** Agent classification from the registry (e.g. 'code_dev', 'orchestrator'). */
     classification?: string;

package/dist/agent-registry.d.ts.map

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

package/dist/cloud/api.d.ts

@@ -81,12 +81,45 @@ export declare const ListDevicesResult: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ListDevicesResult = z.infer<typeof ListDevicesResult>;
+/** What a device credential may do (§2.3). A signed-in session holds every scope. */
+export declare const DeviceScope: z.ZodEnum<{
+    "account:read": "account:read";
+    "devices:read": "devices:read";
+    "projects:read": "projects:read";
+    "projects:write": "projects:write";
+    "sync:read": "sync:read";
+    "sync:write": "sync:write";
+    "keys:read": "keys:read";
+    "keys:write": "keys:write";
+}>;
+/** One device credential scope. */
+export type DeviceScope = z.infer<typeof DeviceScope>;
+/** E3 `GET /v1/status` query (§4.1): `replicaId` (a UUIDv7) requires `projectId`. */
+export declare const StatusQuery: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    replicaId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** The E3 status query. */
+export type StatusQuery = z.infer<typeof StatusQuery>;
+/**
+ * A new project's first data key, stored in the same transaction as its registration (onboarding B): key
+ * version 1, wrapped by the registrant's account master key. Needs keys:write on top of projects:write, and is
+ * honoured only when the call creates the project. Later versions stay rotations
+ * (PUT /v1/projects/:projectId/keys/:userId).
+ */
+export declare const InitialProjectKey: z.ZodObject<{
+    wrappedProjectKey: z.ZodString;
+}, z.core.$strip>;
+export type InitialProjectKey = z.infer<typeof InitialProjectKey>;
 export declare const RegisterProjectRequest: z.ZodObject<{
     projectId: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
     encryptedName: z.ZodOptional<z.ZodString>;
     remoteUrl: z.ZodOptional<z.ZodString>;
     organizationId: z.ZodOptional<z.ZodString>;
+    initialKey: z.ZodOptional<z.ZodObject<{
+        wrappedProjectKey: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type RegisterProjectRequest = z.infer<typeof RegisterProjectRequest>;
 export declare const Project: z.ZodObject<{
@@ -110,6 +143,7 @@ export declare const RegisterProjectResult: z.ZodObject<{
         createdAt: z.ZodISODateTime;
     }, z.core.$strip>;
     streamId: z.ZodString;
+    initialKeyVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 export type RegisterProjectResult = z.infer<typeof RegisterProjectResult>;
 /**
@@ -186,6 +220,8 @@ export declare const HomeReplica: z.ZodObject<{
         observedAt: z.ZodISODateTime;
     }, z.core.$strip>>;
     presenceAt: z.ZodNullable<z.ZodISODateTime>;
+    retiredAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    successor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type HomeReplica = z.infer<typeof HomeReplica>;
 /**
@@ -223,6 +259,8 @@ export declare const AttachHomeReplicaResult: z.ZodObject<{
         observedAt: z.ZodISODateTime;
     }, z.core.$strip>>;
     presenceAt: z.ZodNullable<z.ZodISODateTime>;
+    retiredAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    successor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type AttachHomeReplicaResult = z.infer<typeof AttachHomeReplicaResult>;
 /** `PUT /v1/account/home/replicas/:replicaId/presence` (body: ReplicaPresence). */
@@ -264,6 +302,8 @@ export declare const ListHomeReplicasResult: z.ZodObject<{
             observedAt: z.ZodISODateTime;
         }, z.core.$strip>>;
         presenceAt: z.ZodNullable<z.ZodISODateTime>;
+        retiredAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        successor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ListHomeReplicasResult = z.infer<typeof ListHomeReplicasResult>;
@@ -770,6 +810,79 @@ export declare const ListCheckpointsResult: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ListCheckpointsResult = z.infer<typeof ListCheckpointsResult>;
+/**
+ * E29 `GET …/checkpoints/head` and E30 `GET …/checkpoints/:checkpointId` (cleo-nexus T122, contract
+ * v2.27): one checkpoint, shaped as a list item. Both answer 404 when there is no head, or the id is
+ * unknown, malformed or on another stream.
+ */
+export declare const GetCheckpointResult: z.ZodObject<{
+    checkpoint: z.ZodObject<{
+        checkpointId: z.ZodString;
+        streamId: z.ZodString;
+        parentCheckpointId: z.ZodNullable<z.ZodString>;
+        replicaId: z.ZodString;
+        deviceId: z.ZodString;
+        coversSeq: z.ZodNumber;
+        manifest: z.ZodObject<{
+            schemaVersion: z.ZodNumber;
+            tables: z.ZodRecord<z.ZodString, z.ZodObject<{
+                rows: z.ZodNumber;
+                hash: z.ZodString;
+            }, z.core.$strip>>;
+            pending: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                replicaId: z.ZodString;
+                replicaSeq: z.ZodNumber;
+                txn: z.ZodNumber;
+            }, z.core.$strip>>>;
+            voided: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                ref: z.ZodObject<{
+                    replicaId: z.ZodString;
+                    replicaSeq: z.ZodNumber;
+                    txn: z.ZodNumber;
+                }, z.core.$strip>;
+                deltas: z.ZodRecord<z.ZodString, z.ZodObject<{
+                    created: z.ZodNumber;
+                    deleted: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            revived: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                ref: z.ZodObject<{
+                    replicaId: z.ZodString;
+                    replicaSeq: z.ZodNumber;
+                    txn: z.ZodNumber;
+                }, z.core.$strip>;
+                deltas: z.ZodRecord<z.ZodString, z.ZodObject<{
+                    created: z.ZodNumber;
+                    deleted: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            pruned: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            replayPin: z.ZodOptional<z.ZodObject<{
+                journal: z.ZodString;
+                triggerSetHash: z.ZodString;
+                transitions: z.ZodArray<z.ZodObject<{
+                    seq: z.ZodNumber;
+                    schemaVersion: z.ZodNumber;
+                    journal: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        replicas: z.ZodRecord<z.ZodString, z.ZodObject<{
+            deviceId: z.ZodString;
+            lastReplicaSeq: z.ZodNumber;
+        }, z.core.$strip>>;
+        blobSha256: z.ZodString;
+        sizeBytes: z.ZodNumber;
+        signature: z.ZodString;
+        endorsements: z.ZodArray<z.ZodObject<{
+            deviceId: z.ZodString;
+            signature: z.ZodString;
+        }, z.core.$strip>>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** One checkpoint read by id or as the head. */
+export type GetCheckpointResult = z.infer<typeof GetCheckpointResult>;
 export declare const PresignUploadRequest: z.ZodObject<{
     sha256: z.ZodString;
     sizeBytes: z.ZodNumber;
@@ -879,6 +992,49 @@ export declare const ListLeasesResult: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ListLeasesResult = z.infer<typeof ListLeasesResult>;
+/**
+ * E31 `POST /v1/streams/:streamId/replicas/:replicaId/retirements` (cleo-nexus T123, contract v2.28): the replica
+ * writes no segment past `lastReplicaSeq` (none at all when it is null). The journal's own `retire` transaction
+ * travels E2E-encrypted; this is the server's signed copy, so it can refuse later appends and show the retirement in
+ * the reads.
+ */
+export declare const RetireReplicaRequest: z.ZodObject<{
+    deviceId: z.ZodString;
+    successor: z.ZodNullable<z.ZodString>;
+    lastReplicaSeq: z.ZodNullable<z.ZodNumber>;
+    txnId: z.ZodNullable<z.ZodString>;
+    signature: z.ZodString;
+}, z.core.$strip>;
+/** The E31 request body. */
+export type RetireReplicaRequest = z.infer<typeof RetireReplicaRequest>;
+/** A stored retirement: one per (stream, replica), insert-only. */
+export declare const ReplicaRetirement: z.ZodObject<{
+    streamId: z.ZodString;
+    replicaId: z.ZodString;
+    successor: z.ZodNullable<z.ZodString>;
+    lastReplicaSeq: z.ZodNullable<z.ZodNumber>;
+    signerDeviceId: z.ZodString;
+    txnId: z.ZodNullable<z.ZodString>;
+    signature: z.ZodString;
+    retiredAt: z.ZodISODateTime;
+}, z.core.$strip>;
+/** A stored replica retirement. */
+export type ReplicaRetirement = z.infer<typeof ReplicaRetirement>;
+/** 201 for a new retirement, 200 with the stored one for a repeat with the same successor and lastReplicaSeq. */
+export declare const RetireReplicaResult: z.ZodObject<{
+    retirement: z.ZodObject<{
+        streamId: z.ZodString;
+        replicaId: z.ZodString;
+        successor: z.ZodNullable<z.ZodString>;
+        lastReplicaSeq: z.ZodNullable<z.ZodNumber>;
+        signerDeviceId: z.ZodString;
+        txnId: z.ZodNullable<z.ZodString>;
+        signature: z.ZodString;
+        retiredAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** The E31 answer. */
+export type RetireReplicaResult = z.infer<typeof RetireReplicaResult>;
 /**
  * Bounds on Argon2id parameters. The server stores the parameters, so a client must not trust them: too
  * low weakens the passphrase, too high is a denial of service (a 64 GiB allocation). Both sides enforce these.

package/dist/cloud/api.d.ts.map

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

package/dist/cloud/api.js

@@ -55,7 +55,35 @@ export const Device = z.object({
     certificateKeyVersion: KeyVersion.nullable(),
 });
 export const ListDevicesResult = z.object({ devices: z.array(Device) });
+// ---------- device credential scopes and E3 status (§4.1) ----------
+/** What a device credential may do (§2.3). A signed-in session holds every scope. */
+export const DeviceScope = z.enum([
+    'account:read',
+    'devices:read',
+    'projects:read',
+    'projects:write',
+    'sync:read',
+    'sync:write',
+    'keys:read',
+    'keys:write',
+]);
+/** E3 `GET /v1/status` query (§4.1): `replicaId` (a UUIDv7) requires `projectId`. */
+export const StatusQuery = z
+    .object({ projectId: ProjectId.optional(), replicaId: ReplicaId.optional() })
+    .refine((q) => q.replicaId === undefined || q.projectId !== undefined, {
+    message: 'replicaId requires projectId',
+});
 // ---------- projects ----------
+/**
+ * A new project's first data key, stored in the same transaction as its registration (onboarding B): key
+ * version 1, wrapped by the registrant's account master key. Needs keys:write on top of projects:write, and is
+ * honoured only when the call creates the project. Later versions stay rotations
+ * (PUT /v1/projects/:projectId/keys/:userId).
+ */
+export const InitialProjectKey = z.object({
+    /** The project data key, wrapped by the registrant's master key at key version 1. */
+    wrappedProjectKey: Base64,
+});
 export const RegisterProjectRequest = z.object({
     projectId: ProjectId,
     /**
@@ -72,6 +100,8 @@ export const RegisterProjectRequest = z.object({
      * caller's personal organization, which every account has.
      */
     organizationId: z.string().uuid().optional(),
+    /** The project's first data key (onboarding B). Honoured only when this call creates the project. */
+    initialKey: InitialProjectKey.optional(),
 });
 export const Project = z.object({
     projectId: ProjectId,
@@ -84,7 +114,16 @@ export const Project = z.object({
     createdByUserId: z.string().uuid().nullable(),
     createdAt: z.iso.datetime(),
 });
-export const RegisterProjectResult = z.object({ project: Project, streamId: StreamId });
+export const RegisterProjectResult = z.object({
+    project: Project,
+    streamId: StreamId,
+    /**
+     * The key version `initialKey` is stored at for the caller: 1 when this call created the project with it,
+     * or repeated the caller's identical version 1; null when no initialKey was sent, or the project already
+     * existed with no key (initialKey ignored). Absent from servers older than initialKey.
+     */
+    initialKeyVersion: KeyVersion.nullable().optional(),
+});
 /**
  * Which devices hold a project. The server stores NO filesystem path, not even as a hint.
  * Paths are per-device local state (cleo-dev review, 2026-09-27).
@@ -135,6 +174,10 @@ export const HomeReplica = z.object({
     lastSyncAt: z.iso.datetime().nullable(),
     presence: ReplicaPresence.nullable(),
     presenceAt: z.iso.datetime().nullable(),
+    /** When the replica was retired (T123), else null. Absent from servers older than retirement. */
+    retiredAt: z.iso.datetime().nullable().optional(),
+    /** The retired replica's named successor, else null (not retired, or retired with none). */
+    successor: ReplicaId.nullable().optional(),
 });
 /**
  * `POST /v1/account/home/replicas`: the attached replica, flat like the project attach answer (`replicaId` at the
@@ -404,6 +447,12 @@ export const EndorseCheckpointRequest = z.object({ deviceId: DeviceId, signature
 export const CreateCheckpointResult = z.object({ checkpoint: Checkpoint });
 /** Newest first, at most 100. */
 export const ListCheckpointsResult = z.object({ checkpoints: z.array(Checkpoint) });
+/**
+ * E29 `GET …/checkpoints/head` and E30 `GET …/checkpoints/:checkpointId` (cleo-nexus T122, contract
+ * v2.27): one checkpoint, shaped as a list item. Both answer 404 when there is no head, or the id is
+ * unknown, malformed or on another stream.
+ */
+export const GetCheckpointResult = z.object({ checkpoint: Checkpoint });
 // ---------- blobs ----------
 export const PresignUploadRequest = z.object({
     sha256: Sha256Hex,
@@ -472,6 +521,55 @@ export const ListedLease = Lease.extend({
 });
 /** `GET /v1/streams/:streamId/leases`: the stream's live leases, by role. Expired leases are omitted. */
 export const ListLeasesResult = z.object({ leases: z.array(ListedLease) });
+// ---------- replica retirement (T123; cleocode journal spec §1.3, §3.5 D5) ----------
+/**
+ * A journal transaction id, `<emittingReplicaId>:<localTxnSeq>`: the replica that emitted the transaction and its own
+ * transaction counter. Only the format is checked: the emitting replica may be the successor (a rebind), not the
+ * retired one.
+ */
+const JournalTxnId = z
+    .string()
+    .regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}:(0|[1-9][0-9]{0,15})$/, 'expected <uuid>:<non-negative integer>');
+/**
+ * E31 `POST /v1/streams/:streamId/replicas/:replicaId/retirements` (cleo-nexus T123, contract v2.28): the replica
+ * writes no segment past `lastReplicaSeq` (none at all when it is null). The journal's own `retire` transaction
+ * travels E2E-encrypted; this is the server's signed copy, so it can refuse later appends and show the retirement in
+ * the reads.
+ */
+export const RetireReplicaRequest = z.object({
+    /** The signing device. It must be the calling device. */
+    deviceId: DeviceId,
+    /** The replica that carries on this one's history, or null. Never the retired replica itself. */
+    successor: ReplicaId.nullable(),
+    /**
+     * The replica's last segment: at least its highest appended replicaSeq, and late segments up to it still land. Null
+     * when the replica wrote nothing: then no segment of it is stored, and none may land.
+     */
+    lastReplicaSeq: z.number().int().nonnegative().nullable(),
+    /**
+     * The journal transaction that carries the retire (`${emittingReplicaId}:${localTxnSeq}`), or null for an owner's
+     * retirement with no journal transaction.
+     */
+    txnId: JournalTxnId.nullable(),
+    /** Ed25519 by the calling device over replicaRetireMessage(...). */
+    signature: Base64,
+});
+/** A stored retirement: one per (stream, replica), insert-only. */
+export const ReplicaRetirement = z.object({
+    streamId: StreamId,
+    replicaId: ReplicaId,
+    successor: ReplicaId.nullable(),
+    /** Null: the replica wrote nothing. */
+    lastReplicaSeq: z.number().int().nonnegative().nullable(),
+    /** The device that signed it: the replica's own, a project owner's, or (home streams) another of the account's. */
+    signerDeviceId: DeviceId,
+    txnId: JournalTxnId.nullable(),
+    /** The signer's Ed25519 over replicaRetireMessage(...), so a client or an auditor can verify the record. */
+    signature: Base64,
+    retiredAt: z.iso.datetime(),
+});
+/** 201 for a new retirement, 200 with the stored one for a repeat with the same successor and lastReplicaSeq. */
+export const RetireReplicaResult = z.object({ retirement: ReplicaRetirement });
 // ---------- keys (wrapped project keys; the account master key is escrowed on the server, T082: encryption at rest, not end-to-end) ----------
 /**
  * Bounds on Argon2id parameters. The server stores the parameters, so a client must not trust them: too