@ziggs-ai/api-client 0.40.5 → 0.40.6

package/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## Unreleased
 
+## 0.40.6
+
 ## 0.40.5
 
 - An artifact reaches people only by being added to a bucket. The `artifact_share` tool, `shareArtifactCapability` and `ContextGrantsClient.shareArtifact` are removed, `context_delegate` no longer takes `scopeKind: 'artifact'`, and `link_list` no longer suggests sharing an artifact. The server refuses artifact grants issued or passed on directly.

package/dist/capabilities/agreementVerbs.d.ts

@@ -23,6 +23,12 @@ import type { CapabilityDefinition, CapabilityParam } from './types.js';
  * Hosted-agent tools spread this instead of keeping a shorter copy.
  */
 export declare const AGREEMENT_TERMS_PARAMS: Record<string, CapabilityParam>;
+/** The bucket a hire goes into. Exported for the claim verb. */
+export declare const BUCKET_PARAM: CapabilityParam;
+/** The named bucket off a validated arg bag, as the wire field. */
+export declare function bucketFrom(args: Record<string, unknown>): {
+    bucketId?: string;
+};
 export declare const agreementBuyCapability: CapabilityDefinition;
 export declare const agreementBidCapability: CapabilityDefinition;
 export declare const agreementBrokerCapability: CapabilityDefinition;

package/dist/capabilities/agreementVerbs.js

@@ -92,6 +92,16 @@ const MANDATE_PARAM = {
     type: 'string',
     description: 'Parent job: an active agreement you participate in. Ending it ends this work. It grants neither hiring nor representation authority.',
 };
+/** The bucket a hire goes into. Exported for the claim verb. */
+export const BUCKET_PARAM = {
+    type: 'string',
+    description: "Bucket it goes into. Default: your run's bucket, else a new one.",
+};
+/** The named bucket off a validated arg bag, as the wire field. */
+export function bucketFrom(args) {
+    const id = args['bucketId'];
+    return typeof id === 'string' && id.trim() ? { bucketId: id.trim() } : {};
+}
 /** Pull the declared mandate off a validated arg bag, as the wire field. */
 function mandateFrom(args) {
     const declared = args['parentAgreementId'] ?? args['mandateAgreementId'];
@@ -162,6 +172,7 @@ export const agreementBuyCapability = {
         addressId: CHAT_PARAM,
         ...AGREEMENT_TERMS_PARAMS,
         mandateAgreementId: MANDATE_PARAM,
+        bucketId: BUCKET_PARAM,
         parentAgreementId: { type: 'string', description: 'The job this work is part of; ending it ends this work. Not a link, and no spending consent.' },
     },
     needsAgentId: true,
@@ -170,6 +181,7 @@ export const agreementBuyCapability = {
         const agreement = await proposeDirectTo({
             ...termsFrom(args),
             ...mandateFrom(args),
+            ...bucketFrom(args),
             proposedTo: counterparty,
             addressId: args['addressId'],
             // They provide. The payer is derived server-side as the other side.
@@ -193,6 +205,7 @@ export const agreementBidCapability = {
         addressId: CHAT_PARAM,
         ...AGREEMENT_TERMS_PARAMS,
         mandateAgreementId: MANDATE_PARAM,
+        bucketId: BUCKET_PARAM,
         parentAgreementId: { type: 'string', description: 'The job this work is part of; ending it ends this work. Not a link, and no spending consent.' },
     },
     needsAgentId: true,
@@ -201,6 +214,7 @@ export const agreementBidCapability = {
         const agreement = await proposeDirectTo({
             ...termsFrom(args),
             ...mandateFrom(args),
+            ...bucketFrom(args),
             proposedTo: args['counterparty'],
             addressId: args['addressId'],
             // You provide, so the counterparty pays.
@@ -262,6 +276,7 @@ export const agreementRequestCapability = {
         ...AGREEMENT_TERMS_PARAMS,
         match: MATCH_PARAM,
         mandateAgreementId: MANDATE_PARAM,
+        bucketId: BUCKET_PARAM,
         parentAgreementId: { type: 'string', description: 'The job this work is part of; ending it ends this work. Not a link, and no spending consent.' },
     },
     needsAgentId: true,
@@ -269,6 +284,7 @@ export const agreementRequestCapability = {
         const agreement = await proposeBroadcast({
             ...termsFrom(args),
             ...mandateFrom(args),
+            ...bucketFrom(args),
             addressId: '',
             audience: args['audience'],
             engagementKind: engagementKindFrom(args),
@@ -392,6 +408,7 @@ export const agreementSubcontractCapability = {
             type: 'string',
             description: 'Who pays for the subcontracted work. Defaults to the delegating side.',
         },
+        bucketId: BUCKET_PARAM,
     },
     needsAgentId: true,
     handler: async (args, env) => {
@@ -417,6 +434,7 @@ export const agreementSubcontractCapability = {
             ...(args['payerId'] === undefined
                 ? {}
                 : { payerId: args['payerId'] }),
+            ...bucketFrom(args),
         }, fullCreds(env));
         return { agreement };
     },

package/dist/capabilities/agreements.js

@@ -1,6 +1,7 @@
 import { agreementAppUrl } from '../utils/appUrls.js';
 import { claimOpenAgreement } from '../http/agreementFlows.js';
 import { linkIsReachOnly, webAppOrigin } from './links.js';
+import { BUCKET_PARAM, bucketFrom } from './agreementVerbs.js';
 import { workContextFromEnv } from './nextCall.js';
 import { fullCreds } from './types.js';
 /** Plain outcome once the hire is active. `kind` stays on the result, not in this sentence. */
@@ -86,11 +87,12 @@ export const agreementClaimCapability = {
             enum: ['me', 'workspace'],
             description: "Listing hire: me (default) keeps work private; workspace shares with that workspace. Ask your person if unclear.",
         },
+        bucketId: BUCKET_PARAM,
     },
     needsAgentId: true,
     handler: async (args, env) => {
         const declaredMandate = args['mandateAgreementId'];
-        const { agreement, kind } = await claimOpenAgreement(args['agreementId'], fullCreds(env), { ...(typeof declaredMandate === 'string' && declaredMandate ? { mandateAgreementId: declaredMandate } : {}), ...(typeof args['parentAgreementId'] === 'string' ? { parentAgreementId: args['parentAgreementId'] } : {}), ...(claimConnections(args['connections']) ?? {}), ...(args['hireFor'] === 'workspace' ? { hireFor: 'workspace' } : {}) });
+        const { agreement, kind } = await claimOpenAgreement(args['agreementId'], fullCreds(env), { ...(typeof declaredMandate === 'string' && declaredMandate ? { mandateAgreementId: declaredMandate } : {}), ...(typeof args['parentAgreementId'] === 'string' ? { parentAgreementId: args['parentAgreementId'] } : {}), ...(claimConnections(args['connections']) ?? {}), ...(args['hireFor'] === 'workspace' ? { hireFor: 'workspace' } : {}), ...bucketFrom(args) });
         return presentClaimResult(agreement, kind, env);
     },
 };

package/dist/http/AgreementClient.d.ts

@@ -45,6 +45,11 @@ export interface ProposeDirectInput extends ProposeTerms {
     proposedTo: string;
     /** Optional display-reference context for resolving a masked party; does not publish or share. */
     addressId?: string;
+    /**
+     * The bucket the agreement goes into, one you are in. Left out: the bucket
+     * your run works in, else a new one. The other side comes in when it starts.
+     */
+    bucketId?: string;
 }
 /**
  * Open buyer-broadcast. `audience` selects who may see/claim it:
@@ -134,6 +139,11 @@ export interface DelegateAgreementData {
     interactionMode?: 'messages' | 'tasks' | 'both';
     agreementDescription?: string;
     payerId?: string;
+    /**
+     * The bucket the sub-agreement goes into, one you are in. Left out: the
+     * bucket your run works in, else the parent's buckets, else a new one.
+     */
+    bucketId?: string;
     idempotencyKey?: string;
 }
 export declare function delegateAgreement(proposalData: DelegateAgreementData, creds: Creds): Promise<Agreement>;
@@ -328,6 +338,11 @@ export type ClaimedKind = 'link' | 'offer' | 'request' | 'hand-off';
  */
 export interface ClaimOptions {
     parentAgreementId?: string;
+    /**
+     * The bucket the hire goes into, one you are in. Left out: the bucket your
+     * run works in, else a new one. The other side comes in when it starts.
+     */
+    bucketId?: string;
     /**
      * The active agreement whose work this claim is part of. An agent acting
      * inside a job its human approved does not need a second consent for the

package/dist/http/AgreementClient.js

@@ -559,7 +559,7 @@ export async function claimAgreement(agreementId, creds, opts = {}) {
     const res = await fetch(`${getAgreementBaseUrl()}/${encodeURIComponent(agreementId)}/claim`, {
         method: 'POST',
         headers: buildHeaders(creds),
-        body: JSON.stringify({ ...(opts.mandateAgreementId ? { mandateAgreementId: opts.mandateAgreementId } : {}), ...(opts.parentAgreementId ? { parentAgreementId: opts.parentAgreementId } : {}), ...(opts.connections && Object.keys(opts.connections).length ? { connections: opts.connections } : {}), ...(opts.hireFor === 'workspace' ? { hireFor: 'workspace' } : {}) }),
+        body: JSON.stringify({ ...(opts.mandateAgreementId ? { mandateAgreementId: opts.mandateAgreementId } : {}), ...(opts.parentAgreementId ? { parentAgreementId: opts.parentAgreementId } : {}), ...(opts.connections && Object.keys(opts.connections).length ? { connections: opts.connections } : {}), ...(opts.hireFor === 'workspace' ? { hireFor: 'workspace' } : {}), ...(opts.bucketId ? { bucketId: opts.bucketId } : {}) }),
     });
     if (!res.ok) {
         const body = await res.text().catch(() => '');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.40.5",
+  "version": "0.40.6",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "homepage": "https://ziggsai.com/docs",
   "bugs": {