@ziggs-ai/api-client 0.9.2 → 0.9.3

package/dist/capabilities/grants.js

@@ -38,16 +38,25 @@ export const listGrantsCapability = {
     key: 'grant_list',
     names: { sdk: 'grant_list', mcp: 'ziggs_grant_list' },
     descriptions: {
-        sdk: 'List every grant this agent holds across all rails in one call — context (chat/agreement/org/artifact), connection, and wallet — as canonical grants (grantId, scope, caveats, expiresAt, health; no message/artifact content or credentials). Holder-scoped and cross-session. It answers "what grants do I HOLD?", which is narrower than "what can I reach?": reach you have by authoring something, by sitting in a chat, by being a party to an agreement, or through your org is not a grant row and never appears here — so an empty list means "no grants", never "no access". Filter by scopeKind (rail) and health (defaults to active). Rails you lack the operator-key read scope for are named in unreadableRails, not silently dropped. Cursor-paginated: pass cursor from a prior nextCursor. To answer "what can I reach?" instead, use context_expand_reach to enumerate a scope, or context_read to read through a grant.',
-        mcp: 'List every grant this delegate holds across all rails in one call — context (chat/agreement/org/artifact), connection, and wallet — as canonical grants (grantId, scope, caveats, expiresAt, health; no content or credentials). Holder-scoped and cross-session. It answers "what grants do I HOLD?", which is narrower than "what can I reach?": reach you have by authoring something, by sitting in a chat, by being a party to an agreement, or through your org is not a grant row and never appears here — so an empty list means "no grants", never "no access". Filter by scopeKind (rail) and health (defaults to active). Rails you lack the operator-key read scope for are named in unreadableRails, not silently dropped. Cursor-paginated: pass cursor from a prior nextCursor to page. To answer "what can I reach?" instead, use ziggs_context_expand_reach to enumerate a scope, or pass a grantId to ziggs_context_read to pin a specific grant.',
+        sdk: 'List grants this agent holds — or, with role=issuer, grants this agent caused (author-shares and delegate children). Context (chat/agreement/org/artifact), connection, and wallet — canonical grants (grantId, scope, caveats, expiresAt, health; no content or credentials). Default role=holder answers "what grants do I HOLD?", which is narrower than "what can I reach?": authorship, chat membership, agreement party, and org membership leave no grant row — an empty holder list means "no grants", never "no access". role=issuer answers "who did I share with / what did I mint?" after artifact_share. Filter by scopeKind, scopeId, and health (defaults to active). Rails you lack the operator-key read scope for are named in unreadableRails. Cursor-paginated.',
+        mcp: 'List grants this delegate holds — or, with role=issuer, grants this delegate caused (author-shares and delegate children). Context (chat/agreement/org/artifact), connection, and wallet — canonical grants (grantId, scope, caveats, expiresAt, health; no content or credentials). Default role=holder answers "what grants do I HOLD?", which is narrower than "what can I reach?": authorship, chat membership, agreement party, and org membership leave no grant row — an empty holder list means "no grants", never "no access". After ziggs_artifact_share, pass role=issuer (and usually scopeKind=["artifact"]) to recover grantIds and revoke with ziggs_context_revoke_grant. Filter by scopeKind, scopeId, and health (defaults to active). Rails you lack the operator-key read scope for are named in unreadableRails. Cursor-paginated.',
     },
     annotation: 'read-only',
     params: {
+        role: {
+            type: 'string',
+            enum: ['holder', 'issuer'],
+            description: 'holder (default): grants you hold. issuer: grants you caused — author-shares you made and delegate children you minted (not your human owner\'s full issuer view).',
+        },
         scopeKind: {
             type: 'array',
             items: { type: 'string', enum: SCOPE_KINDS },
             description: 'Rail filter (repeatable): chat | agreement | org | artifact (context) | connection | wallet. Omit for every rail you can read.',
         },
+        scopeId: {
+            type: 'string',
+            description: 'Narrow to one resource id (e.g. one artifactId) within the rails above.',
+        },
         health: {
             type: 'string',
             enum: HEALTHS,
@@ -64,8 +73,14 @@ export const listGrantsCapability = {
         if (healthArg !== undefined && !HEALTHS.includes(healthArg)) {
             throw new Error(`health must be one of ${HEALTHS.join(', ')}`);
         }
+        const roleArg = args['role'];
+        if (roleArg !== undefined && roleArg !== 'holder' && roleArg !== 'issuer') {
+            throw new Error('role must be holder or issuer');
+        }
         const { items, nextCursor, unreadableRails } = await new GrantsClient(creds.operatorKey, creds.agentId, env.baseUrl).listGrants({
             scopeKind,
+            scopeId: typeof args['scopeId'] === 'string' ? args['scopeId'] : undefined,
+            role: roleArg,
             // Reach = live grants only by default; pass health to see expired/revoked.
             health: healthArg ?? 'active',
             cursor: args['cursor'],

package/dist/http/GrantsClient.d.ts

@@ -10,6 +10,15 @@ export interface ListGrantsQuery {
      * kinds: chat, agreement, org). Absent = every rail.
      */
     scopeKind?: GrantScopeKind | GrantScopeKind[];
+    /**
+     * Narrow to one resource id (e.g. one artifact). Server-side page filter.
+     */
+    scopeId?: string;
+    /**
+     * `'holder'` (default) = grants you hold. `'issuer'` = grants you caused
+     * (ZIG-1217 for agents: author-shares + delegate children).
+     */
+    role?: 'holder' | 'issuer';
     /** Filter to grants of one health. */
     health?: GrantHealth;
     cursor?: string;

package/dist/http/GrantsClient.js

@@ -30,6 +30,10 @@ export class GrantsClient {
             for (const k of kinds)
                 url.searchParams.append('scopeKind', k);
         }
+        if (query.scopeId)
+            url.searchParams.set('scopeId', query.scopeId);
+        if (query.role)
+            url.searchParams.set('role', query.role);
         if (query.health)
             url.searchParams.set('health', query.health);
         if (query.cursor)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
   "main": "dist/index.js",