@oxyhq/contracts 0.25.0 → 0.26.0

package/dist/types/deviceDirectory.d.ts

@@ -0,0 +1,1317 @@
+import { z } from 'zod';
+/**
+ * The canonical device directory — the ONE server-authoritative read model an
+ * account switcher renders (issue #937, ADR 0002).
+ *
+ * It replaces the client-side union of `DeviceSessionState.accounts[]` with a
+ * separately fetched `AccountNode[]` graph. That union cannot be correct on a
+ * device holding more than one person: the client only ever holds ONE caller's
+ * account graph, so it cannot enumerate what the OTHER principals may act as.
+ * Switchability is an authorization question, so the server answers it.
+ *
+ * The directory is deterministic and revision-bound: two reads at the same
+ * `revision` describe the same device state, and `revision` only advances on a
+ * real mutation (an idempotent activation advances nothing — ADR 0002).
+ */
+/**
+ * How a principal reaches an account.
+ *
+ * Mirrors `AccountRelationship` in `@oxyhq/core`'s account graph rather than
+ * inventing a second vocabulary for the same fact:
+ *  - `self`   — the principal's own personal account (`principal.userId === accountId`)
+ *  - `owner`  — the principal owns this account
+ *  - `member` — the principal holds a membership granting `account:act_as`
+ */
+export declare const deviceContextRelationshipSchema: z.ZodEnum<["self", "owner", "member"]>;
+/**
+ * Sanitized display metadata for a principal or an account context.
+ *
+ * Deliberately NOT `userResponseSchema`: a switcher needs a handle, a name, an
+ * avatar and the accent the row is drawn in, and the directory is read by every
+ * app on the device — so it carries the minimum that renders a row and nothing
+ * that would make it a general profile feed. `name.displayName` stays OPTIONAL;
+ * consumers fall back to the handle (`getNormalizedUserHandle`), never to a
+ * synthesized name.
+ *
+ * `color` is here and `email` is not, and the line between them is what the
+ * field is FOR rather than how sensitive it looks. An accent is a property of
+ * drawing the row — without it every non-active row falls back to the ambient
+ * theme accent and a device holding two people renders them identically
+ * (issue #961). An address is somebody's contact detail, and the `@handle` the
+ * secondary line already shows fills the same slot, so putting one in a payload
+ * every installed app reads would widen the profile for no rendering gain.
+ */
+export declare const deviceDirectoryProfileSchema: z.ZodObject<{
+    id: z.ZodString;
+    username: z.ZodString;
+    name: z.ZodOptional<z.ZodType<import("./userResponse").UserNameResponse, z.ZodTypeDef, import("./userResponse").UserNameResponse>>;
+    avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /**
+     * Named Bloom color preset (e.g. `"blue"`), or null when the account has
+     * none. Same shape as `userResponseSchema.color` — one spelling of one fact,
+     * so a consumer that themes a row from either source reads the same values.
+     */
+    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    username: string;
+    id: string;
+    name?: import("./userResponse").UserNameResponse | undefined;
+    avatar?: string | null | undefined;
+    color?: string | null | undefined;
+}, {
+    username: string;
+    id: string;
+    name?: import("./userResponse").UserNameResponse | undefined;
+    avatar?: string | null | undefined;
+    color?: string | null | undefined;
+}>;
+/**
+ * One `principal acting as account` pair — the globally switchable unit.
+ *
+ * `id` is the identifier `POST /session/device/activate` takes. It names the
+ * PAIR, not the account: the same `accountId` legitimately appears under two
+ * principals on a shared device, and those are different sessions, permissions,
+ * audit actors and revocation paths.
+ *
+ * `onDevice` is `false` for a context the principal may act as but has never
+ * activated here — it exists as a row so it has a stable id to activate, and
+ * its delegated session is minted on first activation rather than eagerly for
+ * every organization the principal belongs to.
+ *
+ * `available` is `principalLive && (personal || live account:act_as)`, and the
+ * principal clause is not decoration: a principal whose own personal session
+ * has died makes EVERY context of theirs unavailable, including delegated ones
+ * whose sessions are perfectly alive. Activation verifies the principal's
+ * personal session (ADR 0002 step 3), so a client that models availability as
+ * "delegated context has a live session ⇒ activatable" will be refused by the
+ * server and the context healed away.
+ *
+ * A managed account whose membership was revoked is returned with
+ * `available: false` rather than silently omitted, so the UI can explain a row
+ * disappearing instead of just dropping it.
+ *
+ * (An earlier version of this comment described `available` as the
+ * `account:act_as` verdict alone. It was written before the server existed and
+ * was weaker than the code that shipped — the kind of wrong statement nothing
+ * recomputes, so it is spelled out here in full.)
+ */
+export declare const deviceAccountContextSchema: z.ZodObject<{
+    id: z.ZodString;
+    accountId: z.ZodString;
+    kind: z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>;
+    relationship: z.ZodEnum<["self", "owner", "member"]>;
+    account: z.ZodObject<{
+        id: z.ZodString;
+        username: z.ZodString;
+        name: z.ZodOptional<z.ZodType<import("./userResponse").UserNameResponse, z.ZodTypeDef, import("./userResponse").UserNameResponse>>;
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /**
+         * Named Bloom color preset (e.g. `"blue"`), or null when the account has
+         * none. Same shape as `userResponseSchema.color` — one spelling of one fact,
+         * so a consumer that themes a row from either source reads the same values.
+         */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        username: string;
+        id: string;
+        name?: import("./userResponse").UserNameResponse | undefined;
+        avatar?: string | null | undefined;
+        color?: string | null | undefined;
+    }, {
+        username: string;
+        id: string;
+        name?: import("./userResponse").UserNameResponse | undefined;
+        avatar?: string | null | undefined;
+        color?: string | null | undefined;
+    }>;
+    onDevice: z.ZodBoolean;
+    available: z.ZodBoolean;
+    active: z.ZodBoolean;
+    lastUsedAt: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "personal" | "organization" | "project" | "bot" | "channel";
+    accountId: string;
+    id: string;
+    relationship: "self" | "owner" | "member";
+    account: {
+        username: string;
+        id: string;
+        name?: import("./userResponse").UserNameResponse | undefined;
+        avatar?: string | null | undefined;
+        color?: string | null | undefined;
+    };
+    onDevice: boolean;
+    available: boolean;
+    active: boolean;
+    lastUsedAt: number | null;
+}, {
+    kind: "personal" | "organization" | "project" | "bot" | "channel";
+    accountId: string;
+    id: string;
+    relationship: "self" | "owner" | "member";
+    account: {
+        username: string;
+        id: string;
+        name?: import("./userResponse").UserNameResponse | undefined;
+        avatar?: string | null | undefined;
+        color?: string | null | undefined;
+    };
+    onDevice: boolean;
+    available: boolean;
+    active: boolean;
+    lastUsedAt: number | null;
+}>;
+/**
+ * A human who authenticated onto this device.
+ *
+ * Never an organization, project, channel or bot — those are subjects a
+ * principal acts as, and they appear only in `contexts`. `authuser` is the
+ * Google-style signed-in-human slot and belongs HERE, not to an account: adding
+ * an organization must never consume one.
+ */
+export declare const devicePrincipalSchema: z.ZodObject<{
+    id: z.ZodString;
+    userId: z.ZodString;
+    authuser: z.ZodNumber;
+    user: z.ZodObject<{
+        id: z.ZodString;
+        username: z.ZodString;
+        name: z.ZodOptional<z.ZodType<import("./userResponse").UserNameResponse, z.ZodTypeDef, import("./userResponse").UserNameResponse>>;
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /**
+         * Named Bloom color preset (e.g. `"blue"`), or null when the account has
+         * none. Same shape as `userResponseSchema.color` — one spelling of one fact,
+         * so a consumer that themes a row from either source reads the same values.
+         */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        username: string;
+        id: string;
+        name?: import("./userResponse").UserNameResponse | undefined;
+        avatar?: string | null | undefined;
+        color?: string | null | undefined;
+    }, {
+        username: string;
+        id: string;
+        name?: import("./userResponse").UserNameResponse | undefined;
+        avatar?: string | null | undefined;
+        color?: string | null | undefined;
+    }>;
+    contexts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        accountId: z.ZodString;
+        kind: z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>;
+        relationship: z.ZodEnum<["self", "owner", "member"]>;
+        account: z.ZodObject<{
+            id: z.ZodString;
+            username: z.ZodString;
+            name: z.ZodOptional<z.ZodType<import("./userResponse").UserNameResponse, z.ZodTypeDef, import("./userResponse").UserNameResponse>>;
+            avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            /**
+             * Named Bloom color preset (e.g. `"blue"`), or null when the account has
+             * none. Same shape as `userResponseSchema.color` — one spelling of one fact,
+             * so a consumer that themes a row from either source reads the same values.
+             */
+            color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        }, {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        }>;
+        onDevice: z.ZodBoolean;
+        available: z.ZodBoolean;
+        active: z.ZodBoolean;
+        lastUsedAt: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "personal" | "organization" | "project" | "bot" | "channel";
+        accountId: string;
+        id: string;
+        relationship: "self" | "owner" | "member";
+        account: {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        };
+        onDevice: boolean;
+        available: boolean;
+        active: boolean;
+        lastUsedAt: number | null;
+    }, {
+        kind: "personal" | "organization" | "project" | "bot" | "channel";
+        accountId: string;
+        id: string;
+        relationship: "self" | "owner" | "member";
+        account: {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        };
+        onDevice: boolean;
+        available: boolean;
+        active: boolean;
+        lastUsedAt: number | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    authuser: number;
+    userId: string;
+    id: string;
+    user: {
+        username: string;
+        id: string;
+        name?: import("./userResponse").UserNameResponse | undefined;
+        avatar?: string | null | undefined;
+        color?: string | null | undefined;
+    };
+    contexts: {
+        kind: "personal" | "organization" | "project" | "bot" | "channel";
+        accountId: string;
+        id: string;
+        relationship: "self" | "owner" | "member";
+        account: {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        };
+        onDevice: boolean;
+        available: boolean;
+        active: boolean;
+        lastUsedAt: number | null;
+    }[];
+}, {
+    authuser: number;
+    userId: string;
+    id: string;
+    user: {
+        username: string;
+        id: string;
+        name?: import("./userResponse").UserNameResponse | undefined;
+        avatar?: string | null | undefined;
+        color?: string | null | undefined;
+    };
+    contexts: {
+        kind: "personal" | "organization" | "project" | "bot" | "channel";
+        accountId: string;
+        id: string;
+        relationship: "self" | "owner" | "member";
+        account: {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        };
+        onDevice: boolean;
+        available: boolean;
+        active: boolean;
+        lastUsedAt: number | null;
+    }[];
+}>;
+/**
+ * Response of `GET /session/device/directory`.
+ *
+ * `activeContextId` is the authority for what every official app in
+ * `sessionMode: 'account'` renders. It is null when the device has no active
+ * context — a real state (every context removed, or an active context healed
+ * away), not an error.
+ */
+export declare const deviceDirectorySchema: z.ZodObject<{
+    deviceId: z.ZodString;
+    revision: z.ZodNumber;
+    activeContextId: z.ZodNullable<z.ZodString>;
+    principals: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        userId: z.ZodString;
+        authuser: z.ZodNumber;
+        user: z.ZodObject<{
+            id: z.ZodString;
+            username: z.ZodString;
+            name: z.ZodOptional<z.ZodType<import("./userResponse").UserNameResponse, z.ZodTypeDef, import("./userResponse").UserNameResponse>>;
+            avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            /**
+             * Named Bloom color preset (e.g. `"blue"`), or null when the account has
+             * none. Same shape as `userResponseSchema.color` — one spelling of one fact,
+             * so a consumer that themes a row from either source reads the same values.
+             */
+            color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        }, {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        }>;
+        contexts: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            accountId: z.ZodString;
+            kind: z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>;
+            relationship: z.ZodEnum<["self", "owner", "member"]>;
+            account: z.ZodObject<{
+                id: z.ZodString;
+                username: z.ZodString;
+                name: z.ZodOptional<z.ZodType<import("./userResponse").UserNameResponse, z.ZodTypeDef, import("./userResponse").UserNameResponse>>;
+                avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                /**
+                 * Named Bloom color preset (e.g. `"blue"`), or null when the account has
+                 * none. Same shape as `userResponseSchema.color` — one spelling of one fact,
+                 * so a consumer that themes a row from either source reads the same values.
+                 */
+                color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            }, {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            }>;
+            onDevice: z.ZodBoolean;
+            available: z.ZodBoolean;
+            active: z.ZodBoolean;
+            lastUsedAt: z.ZodNullable<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "personal" | "organization" | "project" | "bot" | "channel";
+            accountId: string;
+            id: string;
+            relationship: "self" | "owner" | "member";
+            account: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            onDevice: boolean;
+            available: boolean;
+            active: boolean;
+            lastUsedAt: number | null;
+        }, {
+            kind: "personal" | "organization" | "project" | "bot" | "channel";
+            accountId: string;
+            id: string;
+            relationship: "self" | "owner" | "member";
+            account: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            onDevice: boolean;
+            available: boolean;
+            active: boolean;
+            lastUsedAt: number | null;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        authuser: number;
+        userId: string;
+        id: string;
+        user: {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        };
+        contexts: {
+            kind: "personal" | "organization" | "project" | "bot" | "channel";
+            accountId: string;
+            id: string;
+            relationship: "self" | "owner" | "member";
+            account: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            onDevice: boolean;
+            available: boolean;
+            active: boolean;
+            lastUsedAt: number | null;
+        }[];
+    }, {
+        authuser: number;
+        userId: string;
+        id: string;
+        user: {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        };
+        contexts: {
+            kind: "personal" | "organization" | "project" | "bot" | "channel";
+            accountId: string;
+            id: string;
+            relationship: "self" | "owner" | "member";
+            account: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            onDevice: boolean;
+            available: boolean;
+            active: boolean;
+            lastUsedAt: number | null;
+        }[];
+    }>, "many">;
+    updatedAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    deviceId: string;
+    revision: number;
+    updatedAt: number;
+    activeContextId: string | null;
+    principals: {
+        authuser: number;
+        userId: string;
+        id: string;
+        user: {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        };
+        contexts: {
+            kind: "personal" | "organization" | "project" | "bot" | "channel";
+            accountId: string;
+            id: string;
+            relationship: "self" | "owner" | "member";
+            account: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            onDevice: boolean;
+            available: boolean;
+            active: boolean;
+            lastUsedAt: number | null;
+        }[];
+    }[];
+}, {
+    deviceId: string;
+    revision: number;
+    updatedAt: number;
+    activeContextId: string | null;
+    principals: {
+        authuser: number;
+        userId: string;
+        id: string;
+        user: {
+            username: string;
+            id: string;
+            name?: import("./userResponse").UserNameResponse | undefined;
+            avatar?: string | null | undefined;
+            color?: string | null | undefined;
+        };
+        contexts: {
+            kind: "personal" | "organization" | "project" | "bot" | "channel";
+            accountId: string;
+            id: string;
+            relationship: "self" | "owner" | "member";
+            account: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            onDevice: boolean;
+            available: boolean;
+            active: boolean;
+            lastUsedAt: number | null;
+        }[];
+    }[];
+}>;
+/**
+ * Request body of `POST /session/device/activate`.
+ *
+ * `contextId`, never `accountId`: an account id cannot name a context on a
+ * device where two people can both reach the same organization, and resolving
+ * that ambiguity server-side would mean guessing inside an authorization path.
+ */
+export declare const deviceActivateRequestSchema: z.ZodObject<{
+    contextId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    contextId: string;
+}, {
+    contextId: string;
+}>;
+/**
+ * Response of `POST /session/device/activate`.
+ *
+ * Carries the post-transition directory AND the bearer for the newly active
+ * context, because the client's ordering invariant is
+ * `commit token → reset caches → publish snapshot → notify` (ADR 0002). Handing
+ * the directory back without the token would force a second round trip in the
+ * middle of that sequence, which is exactly where a component would render the
+ * new subject while still holding the previous subject's bearer.
+ *
+ * `activeToken` is null when the activation legitimately produced no bearer for
+ * THIS caller — an identity-pinned client, or a caller whose application is not
+ * entitled to a token for the new context. It is never an error signal.
+ */
+export declare const deviceActivateResponseSchema: z.ZodObject<{
+    directory: z.ZodObject<{
+        deviceId: z.ZodString;
+        revision: z.ZodNumber;
+        activeContextId: z.ZodNullable<z.ZodString>;
+        principals: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            userId: z.ZodString;
+            authuser: z.ZodNumber;
+            user: z.ZodObject<{
+                id: z.ZodString;
+                username: z.ZodString;
+                name: z.ZodOptional<z.ZodType<import("./userResponse").UserNameResponse, z.ZodTypeDef, import("./userResponse").UserNameResponse>>;
+                avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                /**
+                 * Named Bloom color preset (e.g. `"blue"`), or null when the account has
+                 * none. Same shape as `userResponseSchema.color` — one spelling of one fact,
+                 * so a consumer that themes a row from either source reads the same values.
+                 */
+                color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            }, {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            }>;
+            contexts: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                accountId: z.ZodString;
+                kind: z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>;
+                relationship: z.ZodEnum<["self", "owner", "member"]>;
+                account: z.ZodObject<{
+                    id: z.ZodString;
+                    username: z.ZodString;
+                    name: z.ZodOptional<z.ZodType<import("./userResponse").UserNameResponse, z.ZodTypeDef, import("./userResponse").UserNameResponse>>;
+                    avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    /**
+                     * Named Bloom color preset (e.g. `"blue"`), or null when the account has
+                     * none. Same shape as `userResponseSchema.color` — one spelling of one fact,
+                     * so a consumer that themes a row from either source reads the same values.
+                     */
+                    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, "strip", z.ZodTypeAny, {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                }, {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                }>;
+                onDevice: z.ZodBoolean;
+                available: z.ZodBoolean;
+                active: z.ZodBoolean;
+                lastUsedAt: z.ZodNullable<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }, {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }, {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }>, "many">;
+        updatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        deviceId: string;
+        revision: number;
+        updatedAt: number;
+        activeContextId: string | null;
+        principals: {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }[];
+    }, {
+        deviceId: string;
+        revision: number;
+        updatedAt: number;
+        activeContextId: string | null;
+        principals: {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }[];
+    }>;
+    activeToken: z.ZodNullable<z.ZodObject<{
+        accessToken: z.ZodString;
+        expiresAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        accessToken: string;
+        expiresAt: string;
+    }, {
+        accessToken: string;
+        expiresAt: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    activeToken: {
+        accessToken: string;
+        expiresAt: string;
+    } | null;
+    directory: {
+        deviceId: string;
+        revision: number;
+        updatedAt: number;
+        activeContextId: string | null;
+        principals: {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }[];
+    };
+}, {
+    activeToken: {
+        accessToken: string;
+        expiresAt: string;
+    } | null;
+    directory: {
+        deviceId: string;
+        revision: number;
+        updatedAt: number;
+        activeContextId: string | null;
+        principals: {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }[];
+    };
+}>;
+/**
+ * Response of the CONTEXT-aware removals — `POST /session/device/signout` with
+ * `{ contextId }` (one `principal → account` pair) or `{ principalId }` (one
+ * person and every context they reach, and nobody else's).
+ *
+ * It carries BOTH halves because a removal elects a replacement active context,
+ * so both the directory and the flat compatibility projection move in the same
+ * transition — and a client that learned only one of them would render one
+ * half of a device that no longer exists.
+ *
+ * This is deliberately NOT {@link deviceSessionSyncSchema} and must never be
+ * merged into it. A zod object strips unknown keys, so `{directory, state,
+ * activeToken}` parses cleanly as `{state, activeToken}` — silently dropping the
+ * directory. One schema covering both shapes would therefore make "the server
+ * stopped sending the directory" and "this endpoint never sends one"
+ * indistinguishable at the parse, on the exact path that decides which identity
+ * the app is running as. Two schemas fail closed instead: `directory` is
+ * required here, so a directory-less payload is refused outright.
+ *
+ * `activeToken` is null on the same terms as everywhere else — an identity-
+ * pinned caller, or one not entitled to a bearer for the newly-elected context —
+ * and null is also the honest answer when the removal left the device with no
+ * active context at all.
+ */
+export declare const deviceDirectorySyncSchema: z.ZodObject<{
+    directory: z.ZodObject<{
+        deviceId: z.ZodString;
+        revision: z.ZodNumber;
+        activeContextId: z.ZodNullable<z.ZodString>;
+        principals: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            userId: z.ZodString;
+            authuser: z.ZodNumber;
+            user: z.ZodObject<{
+                id: z.ZodString;
+                username: z.ZodString;
+                name: z.ZodOptional<z.ZodType<import("./userResponse").UserNameResponse, z.ZodTypeDef, import("./userResponse").UserNameResponse>>;
+                avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                /**
+                 * Named Bloom color preset (e.g. `"blue"`), or null when the account has
+                 * none. Same shape as `userResponseSchema.color` — one spelling of one fact,
+                 * so a consumer that themes a row from either source reads the same values.
+                 */
+                color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            }, {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            }>;
+            contexts: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                accountId: z.ZodString;
+                kind: z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>;
+                relationship: z.ZodEnum<["self", "owner", "member"]>;
+                account: z.ZodObject<{
+                    id: z.ZodString;
+                    username: z.ZodString;
+                    name: z.ZodOptional<z.ZodType<import("./userResponse").UserNameResponse, z.ZodTypeDef, import("./userResponse").UserNameResponse>>;
+                    avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    /**
+                     * Named Bloom color preset (e.g. `"blue"`), or null when the account has
+                     * none. Same shape as `userResponseSchema.color` — one spelling of one fact,
+                     * so a consumer that themes a row from either source reads the same values.
+                     */
+                    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, "strip", z.ZodTypeAny, {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                }, {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                }>;
+                onDevice: z.ZodBoolean;
+                available: z.ZodBoolean;
+                active: z.ZodBoolean;
+                lastUsedAt: z.ZodNullable<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }, {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }, {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }>, "many">;
+        updatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        deviceId: string;
+        revision: number;
+        updatedAt: number;
+        activeContextId: string | null;
+        principals: {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }[];
+    }, {
+        deviceId: string;
+        revision: number;
+        updatedAt: number;
+        activeContextId: string | null;
+        principals: {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }[];
+    }>;
+    state: z.ZodObject<{
+        deviceId: z.ZodString;
+        accounts: z.ZodArray<z.ZodObject<{
+            accountId: z.ZodString;
+            sessionId: z.ZodString;
+            authuser: z.ZodNumber;
+            operatedByUserId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            accountId: string;
+            sessionId: string;
+            authuser: number;
+            operatedByUserId?: string | undefined;
+        }, {
+            accountId: string;
+            sessionId: string;
+            authuser: number;
+            operatedByUserId?: string | undefined;
+        }>, "many">;
+        activeAccountId: z.ZodNullable<z.ZodString>;
+        revision: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        deviceId: string;
+        accounts: {
+            accountId: string;
+            sessionId: string;
+            authuser: number;
+            operatedByUserId?: string | undefined;
+        }[];
+        activeAccountId: string | null;
+        revision: number;
+        updatedAt: number;
+    }, {
+        deviceId: string;
+        accounts: {
+            accountId: string;
+            sessionId: string;
+            authuser: number;
+            operatedByUserId?: string | undefined;
+        }[];
+        activeAccountId: string | null;
+        revision: number;
+        updatedAt: number;
+    }>;
+    activeToken: z.ZodNullable<z.ZodObject<{
+        accessToken: z.ZodString;
+        expiresAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        accessToken: string;
+        expiresAt: string;
+    }, {
+        accessToken: string;
+        expiresAt: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    state: {
+        deviceId: string;
+        accounts: {
+            accountId: string;
+            sessionId: string;
+            authuser: number;
+            operatedByUserId?: string | undefined;
+        }[];
+        activeAccountId: string | null;
+        revision: number;
+        updatedAt: number;
+    };
+    activeToken: {
+        accessToken: string;
+        expiresAt: string;
+    } | null;
+    directory: {
+        deviceId: string;
+        revision: number;
+        updatedAt: number;
+        activeContextId: string | null;
+        principals: {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }[];
+    };
+}, {
+    state: {
+        deviceId: string;
+        accounts: {
+            accountId: string;
+            sessionId: string;
+            authuser: number;
+            operatedByUserId?: string | undefined;
+        }[];
+        activeAccountId: string | null;
+        revision: number;
+        updatedAt: number;
+    };
+    activeToken: {
+        accessToken: string;
+        expiresAt: string;
+    } | null;
+    directory: {
+        deviceId: string;
+        revision: number;
+        updatedAt: number;
+        activeContextId: string | null;
+        principals: {
+            authuser: number;
+            userId: string;
+            id: string;
+            user: {
+                username: string;
+                id: string;
+                name?: import("./userResponse").UserNameResponse | undefined;
+                avatar?: string | null | undefined;
+                color?: string | null | undefined;
+            };
+            contexts: {
+                kind: "personal" | "organization" | "project" | "bot" | "channel";
+                accountId: string;
+                id: string;
+                relationship: "self" | "owner" | "member";
+                account: {
+                    username: string;
+                    id: string;
+                    name?: import("./userResponse").UserNameResponse | undefined;
+                    avatar?: string | null | undefined;
+                    color?: string | null | undefined;
+                };
+                onDevice: boolean;
+                available: boolean;
+                active: boolean;
+                lastUsedAt: number | null;
+            }[];
+        }[];
+    };
+}>;
+export type DeviceContextRelationship = z.infer<typeof deviceContextRelationshipSchema>;
+export type DeviceDirectorySync = z.infer<typeof deviceDirectorySyncSchema>;
+export type DeviceDirectoryProfile = z.infer<typeof deviceDirectoryProfileSchema>;
+export type DeviceAccountContext = z.infer<typeof deviceAccountContextSchema>;
+export type DevicePrincipal = z.infer<typeof devicePrincipalSchema>;
+export type DeviceDirectory = z.infer<typeof deviceDirectorySchema>;
+export type DeviceActivateRequest = z.infer<typeof deviceActivateRequestSchema>;
+export type DeviceActivateResponse = z.infer<typeof deviceActivateResponseSchema>;