@ziggs-ai/contracts 0.24.3 → 0.25.1

package/dist/generated/agreements.d.ts

@@ -120,7 +120,7 @@ export type AgreementRead = {
             kind: string;
             id: string;
         };
-        access?: "read" | "write";
+        access?: "list" | "read" | "write";
         temporal?: "from-now" | "from-start";
         resumeAgreementId?: string;
         durationHours?: number;

package/dist/generated/grants.d.ts

@@ -3,7 +3,7 @@
  * Family: grants. Regenerate: backend 'pnpm docs:generate' then this script.
  */
 export type GrantScopeView = {
-    kind: "chat" | "agreement" | "org" | "artifact" | "task" | "connection" | "wallet" | "consent" | "inbox";
+    kind: "chat" | "agreement" | "org" | "artifact" | "task" | "person" | "connection" | "wallet" | "consent" | "inbox";
     id: string;
     label?: string;
 };
@@ -28,7 +28,7 @@ export type GrantView = {
     createdAt: string;
     health: "active" | "expired" | "revoked";
     holderKind?: "user" | "org" | "agent";
-    access?: "read" | "write" | "admit";
+    access?: "list" | "read" | "write" | "admit";
     basis?: GrantBasis;
 };
 export type UnreadableRail = {

package/dist/inbox.d.ts

@@ -63,8 +63,12 @@ export interface DecisionRef {
  * than leaving the reader to assume it.
  */
 export interface AccessAsk {
-    /** A reply grant includes reading and writing in this one conversation. */
-    permission?: 'read' | 'reply';
+    /**
+     * A reply grant includes reading and writing in this one conversation.
+     * `list` (ZIG-2170) is asked of a person scope: which rooms they are in,
+     * never what is in them.
+     */
+    permission?: 'list' | 'read' | 'reply';
     /** The one thing. `name` is absent when nothing readable resolves. */
     scope: {
         kind: string;

package/dist/vocabulary.d.ts

@@ -12,11 +12,15 @@
  * `read`, `admit` implies both. A required kind is satisfied by any kind at
  * least that strong.
  *
+ *  - `list`   — know that the scope's rooms exist: their names, who is in
+ *               them, last activity. Never their contents. Held only on a
+ *               `person` scope (ZIG-2170), so no room grant ever means less
+ *               than `read`.
  *  - `read`   — see the scope and its contents. Observing, not participating.
  *  - `write`  — take part: post entries, be a delivery participant.
  *  - `admit`  — bring others in: issue grants on this scope to new holders.
  */
-export declare const GRANT_ACCESS_KINDS: readonly ["read", "write", "admit"];
+export declare const GRANT_ACCESS_KINDS: readonly ["list", "read", "write", "admit"];
 export type GrantAccessKind = (typeof GRANT_ACCESS_KINDS)[number];
 /**
  * The name a room can be reached by, when it has one.
@@ -130,12 +134,12 @@ export declare const AGREEMENT_TERMINAL_STATES: readonly AgreementStatusValue[];
  * Context-rail scopes, then the other rails a grant can name.
  * Order is the order the grants read and the OpenAPI enum publish.
  */
-export declare const CONTEXT_GRANT_SCOPE_KINDS: readonly ["chat", "agreement", "org", "artifact", "task"];
-export declare const GRANT_SCOPE_KINDS: readonly ["chat", "agreement", "org", "artifact", "task", "connection", "wallet", "consent", "inbox"];
+export declare const CONTEXT_GRANT_SCOPE_KINDS: readonly ["chat", "agreement", "org", "artifact", "task", "person"];
+export declare const GRANT_SCOPE_KINDS: readonly ["chat", "agreement", "org", "artifact", "task", "person", "connection", "wallet", "consent", "inbox"];
 export type GrantScopeKind = (typeof GRANT_SCOPE_KINDS)[number];
 export type ContextGrantScopeKind = (typeof CONTEXT_GRANT_SCOPE_KINDS)[number];
 /** What an access request may name. Always one resource. */
-export declare const ACCESS_REQUEST_SCOPE_KINDS: readonly ["artifact", "chat", "agreement", "task"];
+export declare const ACCESS_REQUEST_SCOPE_KINDS: readonly ["artifact", "chat", "agreement", "task", "person"];
 export type AccessRequestScopeKind = (typeof ACCESS_REQUEST_SCOPE_KINDS)[number];
 /**
  * Who an artifact access request may ask a grant FOR. Each reader is named

package/dist/vocabulary.js

@@ -20,11 +20,15 @@ exports.isTerminalTaskState = isTerminalTaskState;
  * `read`, `admit` implies both. A required kind is satisfied by any kind at
  * least that strong.
  *
+ *  - `list`   — know that the scope's rooms exist: their names, who is in
+ *               them, last activity. Never their contents. Held only on a
+ *               `person` scope (ZIG-2170), so no room grant ever means less
+ *               than `read`.
  *  - `read`   — see the scope and its contents. Observing, not participating.
  *  - `write`  — take part: post entries, be a delivery participant.
  *  - `admit`  — bring others in: issue grants on this scope to new holders.
  */
-exports.GRANT_ACCESS_KINDS = ['read', 'write', 'admit'];
+exports.GRANT_ACCESS_KINDS = ['list', 'read', 'write', 'admit'];
 /**
  * The name a room can be reached by, when it has one.
  *
@@ -147,6 +151,9 @@ exports.CONTEXT_GRANT_SCOPE_KINDS = [
     'org',
     'artifact',
     'task',
+    // ZIG-2170 — every room one person is in, now and later, and never more
+    // than that person sees. Held only at `list`.
+    'person',
 ];
 exports.GRANT_SCOPE_KINDS = [
     ...exports.CONTEXT_GRANT_SCOPE_KINDS,
@@ -161,6 +168,7 @@ exports.ACCESS_REQUEST_SCOPE_KINDS = [
     'chat',
     'agreement',
     'task',
+    'person',
 ];
 /**
  * Who an artifact access request may ask a grant FOR. Each reader is named

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/contracts",
-  "version": "0.24.3",
+  "version": "0.25.1",
   "description": "Wire contracts for the Ziggs API — response shapes, error body, and socket events, shared by every client.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,6 +24,10 @@
     "types"
   ],
   "license": "MIT",
+  "homepage": "https://ziggsai.com/docs",
+  "bugs": {
+    "url": "https://ziggsai.com/support"
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"