@ziggs-ai/contracts 0.7.7 → 0.8.0

package/dist/inbox.d.ts

@@ -47,6 +47,53 @@ export interface DecisionRef {
     /** Signed-in review page. Following it does not approve or mark anything seen. */
     reviewUrl?: string;
     decideVia: DecideVia;
+    /**
+     * Present when what is being asked for is ACCESS to one thing.
+     *
+     * A grant request already arrives as an ordinary pending proposal, so the
+     * button was there; the card was not. `title` is the request's own prose,
+     * which leaves the person to work out what they are being asked to open, for
+     * whom, and for how long. These are the fields that answer that, taken from
+     * the request the agent actually filed — nothing here is inferred.
+     */
+    access?: AccessAsk;
+}
+/**
+ * What an access ask is asking for, as the person answering needs to read it.
+ *
+ * One resource. `scope` is the whole of what a yes opens: there is no arm here
+ * that widens to a container or to a second row, and the card says so rather
+ * than leaving the reader to assume it.
+ */
+export interface AccessAsk {
+    /** The one thing. `name` is absent when nothing readable resolves. */
+    scope: {
+        kind: string;
+        id: string;
+        name?: string | null;
+    };
+    /**
+     * The agent that would read it. A label, never an agent id.
+     *
+     * Who it reads FOR is the row's own `requestedByDisplayName` /
+     * `requestedByOrgName`: the asking side is the side the agent acts for, and
+     * repeating it here would be a second answer to one question.
+     */
+    holderDisplayName: string | null;
+    /** Why, in the requester's own words. */
+    reason: string | null;
+    /**
+     * How long a yes lasts, in hours, counted FROM the yes rather than from the
+     * ask. Null when the request names no lifetime.
+     */
+    durationHours: number | null;
+    /**
+     * The grant's real expiry, once there is one. Absent while the ask is still
+     * pending — a card must not show an expiry for access that does not exist.
+     */
+    grantedUntil?: string | null;
+    /** `from-now` reads what arrives next; `from-start` reads the history too. */
+    temporal?: 'from-now' | 'from-start' | null;
 }
 /**
  * One row in the reader's merged view. A reference, never content — following

package/dist/vocabulary.d.ts

@@ -33,7 +33,12 @@ export type ChatAddressKind = (typeof CHAT_ADDRESS_KINDS)[number];
 export declare const RESOURCE_KINDS: readonly ["message", "artifact", "task-state", "agreement", "request"];
 export type ResourceKind = (typeof RESOURCE_KINDS)[number];
 /** What kind of thing is waiting on a person. */
-export type DecisionKind = 'proposal' | 'connection_request' | 'spend_approval';
+/**
+ * What a card in the decision list is. Not an approval kind: `chat_admission`
+ * names the card for an approval the chat rail has had since ZIG-426, which
+ * was answerable all along and simply never reached this list.
+ */
+export type DecisionKind = 'proposal' | 'connection_request' | 'spend_approval' | 'chat_admission';
 /** Which mailbox a delivery copy lives in. */
 export type InboxPartyKind = 'human' | 'org';
 /** How a principal is party to an agreement. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/contracts",
-  "version": "0.7.7",
+  "version": "0.8.0",
   "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",