@ziggs-ai/api-client 0.37.4 → 0.37.5

package/dist/capabilities/context.d.ts

@@ -50,6 +50,5 @@ export declare const RESOURCE_UNREADABLE_MESSAGE = "This exists and you cannot r
 export declare function explainRefusedRead(kind: 'agreement' | 'task' | 'chat' | 'artifact', id: string, env: CapabilityEnv): Promise<RefusedRead | null>;
 export declare const openCapability: CapabilityDefinition;
 export declare const accessExplainCapability: CapabilityDefinition;
-export declare const contextRequestCapability: CapabilityDefinition;
 export declare const accessRequestCapability: CapabilityDefinition;
 export declare const CONTEXT_CAPABILITIES: CapabilityDefinition[];

package/dist/capabilities/context.js

@@ -391,36 +391,6 @@ export const accessExplainCapability = {
         return presentOpenResult(result, env);
     },
 };
-export const contextRequestCapability = {
-    key: 'context_request',
-    names: { sdk: 'context_request', mcp: 'ziggs_context_request' },
-    title: 'Ask an owner for artifact access',
-    descriptions: {
-        sdk: 'Ask a human owner for temporary read-only access to one artifact you were given a reference for. Use your existing chat with that owner. Creates an approval agreement; gives no access until the owner approves. You are the only recipient. After approval, open the original artifact. Never use a generic service agreement as a substitute for this access request.',
-    },
-    annotation: 'destructive', needsAgentId: true,
-    params: {
-        artifactId: { type: 'string', required: true },
-        chatId: { type: 'string', required: true },
-        ownerId: { type: 'string', required: true, description: 'Who to ask, from your work brief: workBrief.actingFor.customer.id or workBrief.actingFor.operator.id. Anyone else is refused, and the refusal lists who you can ask.' },
-        reason: { type: 'string', required: true, description: 'Purpose, including whom you will summarize the artifact to' },
-        durationHours: { type: 'number', description: 'Integer 1–168 hours after approval; default 24' },
-        idempotencyKey: { type: 'string', description: 'Reuse for the same request; do not create duplicate approval cards' },
-    },
-    handler: async (args, env) => {
-        for (const key of ['artifactId', 'chatId', 'ownerId', 'reason'])
-            if (typeof args[key] !== 'string' || !String(args[key]).trim())
-                throw new Error(`${key} is required`);
-        const durationHours = args.durationHours === undefined ? 24 : Number(args.durationHours);
-        if (!Number.isInteger(durationHours) || durationHours < 1 || durationHours > 168)
-            throw new Error('durationHours must be an integer between 1 and 168');
-        const creds = fullCreds(env);
-        const result = await new ContextGrantsClient(creds.operatorKey, creds.agentId, env.baseUrl).requestArtifactAccess(args.artifactId, {
-            chatId: args.chatId, ownerId: args.ownerId, reason: args.reason, durationHours,
-        }, { idempotencyKey: args.idempotencyKey, laneId: creds.laneId });
-        return { ...result, outcome: 'pending', state: 'requested', appUrl: `${(env.webUrl ?? 'https://ziggsai.com').replace(/\/$/, '')}/app/agreements/${encodeURIComponent(result.agreementId)}`, note: `${result.message ?? 'Waiting for the artifact owner.'} No access granted yet; open the original artifact only after approval.` };
-    },
-};
 /** A suggested request still needs a purpose; it is never a grant or an approval. */
 function requestAccessAction(args, env) {
     return {
@@ -543,7 +513,6 @@ export const CONTEXT_CAPABILITIES = [
     openCapability,
     accessExplainCapability,
     accessRequestCapability,
-    contextRequestCapability,
     contextDelegateCapability,
     contextExpandReachCapability,
     contextDiscoverGrantableCapability,

package/dist/capabilities/index.d.ts

@@ -12,7 +12,7 @@ export { TASK_CAPABILITIES, listTasksCapability, cancelTaskCapability, presentTa
 export { AGREEMENT_PROPOSE_PROVIDER_ID_DESCRIPTION } from './proposeProviderId.js';
 export { MARKETPLACE_CAPABILITIES, marketplaceViewCapability } from './marketplace.js';
 export { GRANTS_CAPABILITIES, listGrantsCapability } from './grants.js';
-export { CONTEXT_CAPABILITIES, contextReadCapability, openCapability, accessExplainCapability, contextDelegateCapability, contextRequestCapability, accessRequestCapability, contextExpandReachCapability, contextDiscoverGrantableCapability, contextBounds, resolveOrgScopeId, explainRefusedRead, RESOURCE_HIDDEN_MESSAGE, RESOURCE_UNREADABLE_MESSAGE, type RefusedRead, } from './context.js';
+export { CONTEXT_CAPABILITIES, contextReadCapability, openCapability, accessExplainCapability, contextDelegateCapability, accessRequestCapability, contextExpandReachCapability, contextDiscoverGrantableCapability, contextBounds, resolveOrgScopeId, explainRefusedRead, RESOURCE_HIDDEN_MESSAGE, RESOURCE_UNREADABLE_MESSAGE, type RefusedRead, } from './context.js';
 export { CONNECTION_CAPABILITIES, connectionProxyCapability, requestConnectionCapability, } from './connections.js';
 export { DISCOVERY_CAPABILITIES, agentSearchCapability, agentGetCapability, } from './discovery.js';
 export { ARTIFACT_CAPABILITIES, recordArtifactCapability, listArtifactsCapability, findArtifactsCapability, type UnsearchedContext, shareArtifactCapability, attachArtifactCapability, uploadArtifactUrlCapability, completeArtifactFileCapability, downloadArtifactCapability, reextractArtifactCapability, } from './artifacts.js';

package/dist/capabilities/index.js

@@ -12,7 +12,7 @@ export { TASK_CAPABILITIES, listTasksCapability, cancelTaskCapability, presentTa
 export { AGREEMENT_PROPOSE_PROVIDER_ID_DESCRIPTION } from './proposeProviderId.js';
 export { MARKETPLACE_CAPABILITIES, marketplaceViewCapability } from './marketplace.js';
 export { GRANTS_CAPABILITIES, listGrantsCapability } from './grants.js';
-export { CONTEXT_CAPABILITIES, contextReadCapability, openCapability, accessExplainCapability, contextDelegateCapability, contextRequestCapability, accessRequestCapability, contextExpandReachCapability, contextDiscoverGrantableCapability, contextBounds, resolveOrgScopeId, explainRefusedRead, RESOURCE_HIDDEN_MESSAGE, RESOURCE_UNREADABLE_MESSAGE, } from './context.js';
+export { CONTEXT_CAPABILITIES, contextReadCapability, openCapability, accessExplainCapability, contextDelegateCapability, accessRequestCapability, contextExpandReachCapability, contextDiscoverGrantableCapability, contextBounds, resolveOrgScopeId, explainRefusedRead, RESOURCE_HIDDEN_MESSAGE, RESOURCE_UNREADABLE_MESSAGE, } from './context.js';
 export { CONNECTION_CAPABILITIES, connectionProxyCapability, requestConnectionCapability, } from './connections.js';
 export { DISCOVERY_CAPABILITIES, agentSearchCapability, agentGetCapability, } from './discovery.js';
 export { ARTIFACT_CAPABILITIES, recordArtifactCapability, listArtifactsCapability, findArtifactsCapability, shareArtifactCapability, attachArtifactCapability, uploadArtifactUrlCapability, completeArtifactFileCapability, downloadArtifactCapability, reextractArtifactCapability, } from './artifacts.js';

package/dist/capabilities/links.d.ts

@@ -5,10 +5,9 @@ export declare function webAppOrigin(env: CapabilityEnv): string;
  *
  * Opening a chat is itself the admission: the backend issues a standing from-now
  * write grant to each side as it creates the room, so both delegates can
- * read and post immediately. Do NOT tell agents to follow chat_open with an
- * issue_grant on that same new chat — that only mints a duplicate grant carrying
- * the default 30-day expiry. issue_grant / context_delegate are for scopes that
- * already exist (an older chat, an agreement, an org).
+ * read and post immediately. Sharing what already exists is artifact_share for
+ * one artifact, a chat_open invite for a room, or context_delegate for a slice
+ * of a grant the agent holds.
  */
 export declare function linkIsReachOnly(env: CapabilityEnv): string;
 export declare const listLinksCapability: CapabilityDefinition;

package/dist/capabilities/links.js

@@ -10,14 +10,13 @@ export function webAppOrigin(env) {
  *
  * Opening a chat is itself the admission: the backend issues a standing from-now
  * write grant to each side as it creates the room, so both delegates can
- * read and post immediately. Do NOT tell agents to follow chat_open with an
- * issue_grant on that same new chat — that only mints a duplicate grant carrying
- * the default 30-day expiry. issue_grant / context_delegate are for scopes that
- * already exist (an older chat, an agreement, an org).
+ * read and post immediately. Sharing what already exists is artifact_share for
+ * one artifact, a chat_open invite for a room, or context_delegate for a slice
+ * of a grant the agent holds.
  */
 export function linkIsReachOnly(env) {
     return env.surface === 'mcp'
-        ? 'A link is reach-only — it shares no context on its own. Open a chat with the PERSON on the other side (ziggs_chat_open, participantId = that link\'s `peer.id`): delivery lands in their mailbox and whoever runs that side picks it up, which is not yours to choose. Use `peer.id`, never a principal out of `parties` — those are display faces, and chat_open refuses a face because it names no single party. Opening the room admits both sides to read and post from then on. To share context that already exists, issue a grant on it with ziggs_context_issue_grant or share a slice of one you hold with ziggs_context_delegate.'
+        ? 'A link is reach-only — it shares no context on its own. Open a chat with the PERSON on the other side (ziggs_chat_open, participantId = that link\'s `peer.id`): delivery lands in their mailbox and whoever runs that side picks it up, which is not yours to choose. Use `peer.id`, never a principal out of `parties` — those are display faces, and chat_open refuses a face because it names no single party. Opening the room admits both sides to read and post from then on. To share context that already exists, share one artifact with ziggs_artifact_share, invite them into a room you hold with ziggs_chat_open (chatId plus participantIds), or share a slice of a grant you hold with ziggs_context_delegate.'
         : 'A link is reach-only — it shares no context on its own. Open a chat with the PERSON on the other side; delivery lands in their mailbox and whoever runs that side picks it up, which is not yours to choose. Opening the room admits both sides to it from then on. To share context that already exists, share a slice of a grant you hold with context_delegate, or ask the peer owner to issue one.';
 }
 const LINK_STATUSES = ['active', 'open', 'cancelled', 'all'];
@@ -84,7 +83,7 @@ export const listLinksCapability = {
             readPlan.push(nextCall(env, 'chat_open', undefined, 'open a room with a linked peer: participantId is that link\'s `peer.id`. Do NOT pass a principal out of `parties` — those are display faces and chat_open refuses them'));
         }
         if (active.length) {
-            readPlan.push(nextCall(env, 'context_issue_grant', undefined, 'share context that already exists: a link does not share any on its own'));
+            readPlan.push(nextCall(env, 'artifact_share', undefined, 'share context that already exists: a link does not share any on its own. One artifact with artifact_share; a room you hold by inviting them with chat_open (chatId plus participantIds)'));
         }
         return {
             count: links.length,

package/dist/capabilities/mcpBriefs.js

@@ -137,14 +137,6 @@ const BRIEFS = {
         does: 'Asks for access to an artifact, chat, agreement or task for this agent. recipientId names who decides (a refusal lists who you can ask); an artifact needs chatId.',
         changes: 'creates a pending approval; grants nothing until approved',
     },
-    ziggs_context_request: {
-        does: 'Asks an artifact’s owner for read access to it, for 1 to 168 hours.',
-        changes: 'creates a pending approval; grants nothing until approved',
-    },
-    ziggs_context_issue_grant: {
-        does: 'Admits another agent to a room. Agreement, org, artifact and task grants need your person’s authority.',
-        changes: 'admits it, pending until the people there consent',
-    },
     ziggs_context_delegate: {
         does: 'Gives another agent a narrower slice of a grant you hold.',
         changes: 'grants it, or opens a request its owner approves (pending_approval)',
@@ -204,7 +196,7 @@ const BRIEFS = {
         changes: 'the old steps are replaced',
     },
     ziggs_task_set_result: {
-        does: 'Closes a task as completed, failed or cancelled; the result is for the next agent, a person reads it in your conversation. The agreement stays active.',
+        does: 'Closes a task as completed or failed; the result is for the next agent, a person reads it in your conversation. The agreement stays active.',
         changes: 'closes the task, proving nobody read or paid; the same idempotencyKey is a no-op',
     },
     ziggs_task_cancel: {

package/dist/capabilities/nextCall.js

@@ -28,7 +28,6 @@ const REQUIRED_ARGS = {
     agreement_subcontract: ['parentAgreementId', 'executorId', 'description'],
     agreement_respond: ['agreementId'],
     introduction_redeem: ['token'],
-    context_issue_grant: ['holderId', 'scopeKind', 'scopeId'],
     artifact_share: ['artifactId', 'holderId'],
     context_delegate: ['parentGrantId', 'holderId', 'scopeKind', 'scopeId', 'temporal'],
     task_create: ['agreementId', 'description'],
@@ -59,7 +58,6 @@ const HTTP_BINDINGS = {
         path: '/agreements/:agreementId/approvals/:partyId',
     },
     marketplace_view: { method: 'GET', path: '/marketplace/offers' },
-    context_issue_grant: { method: 'POST', path: '/context/grants' },
     artifact_share: { method: 'POST', path: '/context/artifacts/:artifactId/share' },
     context_delegate: { method: 'POST', path: '/context/grants/:parentGrantId/delegate' },
     open: { method: 'POST', path: '/context/open' },
@@ -74,11 +72,9 @@ const HTTP_BINDINGS = {
 };
 /**
  * Intentional surface exclusions. A ready next call has to exist as a tool
- * on the calling surface — SDK context exposes delegate, not a top-level
- * issue grant (tool-surface-parity).
+ * on the calling surface (tool-surface-parity).
  */
 const SURFACE_EXPOSURE = {
-    context_issue_grant: ['mcp'],
     // The hosted SDK surface enumerates its own work with task_list and reads a
     // task from the wake it arrived on; ziggs_task_get is the MCP delegate's
     // one-task read. Naming it to an SDK agent would offer a tool it cannot call.
@@ -98,9 +94,6 @@ const MATERIAL_EFFECTS = {
     introduction_redeem: {
         relationship: 'a stranger redeem stages a link both humans must approve — it is not a live connection yet',
     },
-    context_issue_grant: {
-        disclosure: 'issues a grant that widens who can read that scope',
-    },
     link_propose: {
         relationship: 'proposes a reach-only link; nothing is shared until they accept',
     },

package/dist/http/ContextGrantsClient.d.ts

@@ -115,18 +115,6 @@ export declare class ContextGrantsClient {
         idempotencyKey?: string;
         laneId?: string;
     }): Promise<AccessRequestResult>;
-    requestArtifactAccess(artifactId: string, input: {
-        chatId: string;
-        ownerId: string;
-        reason: string;
-        durationHours?: number;
-    }, opts?: {
-        idempotencyKey?: string;
-        laneId?: string;
-    }): Promise<{
-        status: 'pending_approval';
-        agreementId: string;
-    } & RequestSentTo>;
     delegateGrant(parentGrantId: string, input: DelegateContextGrantInput, opts?: {
         idempotencyKey?: string;
     }): Promise<DelegateContextGrantResult>;

package/dist/http/ContextGrantsClient.js

@@ -94,24 +94,6 @@ export class ContextGrantsClient {
         }
         return { status: 'pending_approval', agreementId: result.agreementId, ...common };
     }
-    async requestArtifactAccess(artifactId, input, opts) {
-        const res = await fetch(`${this.baseUrl}/context/artifacts/${encodeURIComponent(artifactId)}/access-requests`, {
-            method: 'POST',
-            headers: buildOperatorHeaders(this.operatorKey, this.agentId, {
-                'content-type': 'application/json',
-                ...(opts?.idempotencyKey ? { 'Idempotency-Key': opts.idempotencyKey } : {}),
-                ...(opts?.laneId ? { 'x-ziggs-lane': opts.laneId } : {}),
-            }),
-            body: JSON.stringify(input),
-        });
-        const body = await res.text().catch(() => '');
-        if (!res.ok)
-            throwApiError(res, body, `requestArtifactAccess failed: ${res.status}`);
-        const result = JSON.parse(body);
-        if (result.status !== 'pending_approval' || !result.agreementId)
-            throw new Error('Expected a pending artifact access request');
-        return { status: 'pending_approval', agreementId: result.agreementId, ...sentToOf(result) };
-    }
     async delegateGrant(parentGrantId, input, opts) {
         const res = await fetch(`${this.baseUrl}/context/grants/${encodeURIComponent(parentGrantId)}/delegate`, {
             method: 'POST',

package/dist/http/TaskClient.d.ts

@@ -48,6 +48,8 @@ export interface CreateTaskGraphNodeData {
     assigneeId?: string;
     waitsOn?: string[];
     joinKind?: 'all' | 'any';
+    /** A yes/no question over the steps this one waits on; it runs only on yes. */
+    runIf?: string;
 }
 export interface CreateTaskGraphData {
     nodes: CreateTaskGraphNodeData[];

package/dist/types.d.ts

@@ -112,6 +112,20 @@ export interface Task {
     } | null;
     graphNodeId?: string | null;
     heldByGraphReview?: boolean;
+    /**
+     * A graph step that runs only if a yes/no question holds over the steps it
+     * waits on. Once asked: `run`, `skipped` (closed cancelled without running),
+     * `held` (waiting for the buyer to acknowledge its plan) or `buyer_run`.
+     */
+    runIf?: {
+        question: string;
+        outcome?: 'run' | 'skipped' | 'held' | 'buyer_run';
+        answer?: 'yes' | 'no' | null;
+        confidence?: number | null;
+        reason?: string;
+        decidedAt?: string;
+        decidedBy?: string | null;
+    } | null;
     plan?: {
         steps?: PlanStep[];
     };

package/package.json

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