@ziggs-ai/ziggs-mcp 0.6.0 → 0.6.1

package/dist/tools.js

@@ -1,6 +1,6 @@
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
-import { getAgreement, getMyAgreements, listMyChats, proposeUnified, delegateAgreement, provisionRelayWorkers, respondToAgreement, revokeAgreement, counterAgreement, fulfillAgreement, sendChatMessage, ConnectionsClient, PaymentsClient, ContextReadClient, GrantsClient, InboxClient, createTask, updateTaskState, replaceTaskPlan, listTasks, getTask, getBackendUrl, fetchMyOrgs, fetchDelegateAccess, GRANTS_CAPABILITIES, contextReadCapability, contextExpandReachCapability, contextDiscoverGrantableCapability, recordArtifactCapability, openConversationCapability, connectionProxyCapability, requestConnectionCapability, agreementClaimCapability, marketplaceViewCapability, } from '@ziggs-ai/api-client';
+import { getAgreement, getMyAgreements, listMyChats, proposeUnified, delegateAgreement, provisionRelayWorkers, respondToAgreement, revokeAgreement, counterAgreement, fulfillAgreement, sendChatMessage, ConnectionsClient, PaymentsClient, ContextReadClient, GrantsClient, InboxClient, createTask, updateTaskState, replaceTaskPlan, listTasks, getTask, getBackendUrl, fetchMyOrgs, fetchDelegateAccess, GRANTS_CAPABILITIES, contextReadCapability, contextExpandReachCapability, contextDiscoverGrantableCapability, recordArtifactCapability, openConversationCapability, connectionProxyCapability, requestConnectionCapability, agreementClaimCapability, marketplaceViewCapability, linkSummary, } from '@ziggs-ai/api-client';
 import { decodeOperatorKeyClaims } from './operatorKey.js';
 import { registerTrustTools } from './trustTools.js';
 import { registerPaymentTools } from './paymentTools.js';
@@ -408,7 +408,11 @@ export function registerZiggsTools(server, creds, cfg) {
             .string()
             .optional()
             .describe('Who does the work. Direct: omitted = proposedTo (commission), your id = offer, another id = broker. Broadcast: omitted = quest, your id = standing offer.'),
-        price: z.number().optional().describe('Optional; does not trigger transfer by itself'),
+        price: z
+            .number()
+            .optional()
+            .describe('Amount in CENTS — 500 means $5.00. Optional; does not trigger a transfer by itself. ' +
+            'When you quote it to a human, convert: saying "$500" for 500 is off by 100x.'),
         engagementKind: z
             .enum(['hire', 'service', 'link'])
             .optional()
@@ -445,9 +449,11 @@ export function registerZiggsTools(server, creds, cfg) {
                 lifecycle,
                 billing,
             }, creds);
+            // ZIG-957: link mutations return linkSummary, not the raw Mongo doc.
+            const agreementOut = shape === 'link' && agreement ? linkSummary(agreement) : agreement;
             return textResult({
                 shape,
-                agreement,
+                agreement: agreementOut,
                 ...(shape === 'quest' || shape === 'offer'
                     ? {
                         nextSteps: 'Published to the marketplace — claimable via ziggs_agreement_claim; it also appears in ziggs_marketplace_view.',
@@ -466,10 +472,16 @@ export function registerZiggsTools(server, creds, cfg) {
         chatId: z.string().describe('Chat the delegation is coordinated in'),
         description: z.string().describe('What the sub-agreement covers'),
         parentTaskId: z.string().optional(),
-        price: z.number().optional(),
+        price: z
+            .number()
+            .optional()
+            .describe('Amount in CENTS — 500 means $5.00.'),
         expiresAt: z.string().optional(),
         maxExecutions: z.number().int().positive().optional(),
-        lifecycle: z.string().optional(),
+        lifecycle: z
+            .enum(['open', 'time-bound', 'count-bound'])
+            .optional()
+            .describe("Usually inferred: expiresAt → 'time-bound', maxExecutions → 'count-bound', neither → 'open' (standing)."),
         agreementDescription: z.string().optional(),
     }, WRITE, async ({ parentAgreementId, executorId, chatId, description, parentTaskId, price, expiresAt, maxExecutions, lifecycle, agreementDescription, }) => {
         try {
@@ -504,7 +516,9 @@ export function registerZiggsTools(server, creds, cfg) {
             const updated = await respondToAgreement(agreementId, action, creds, {
                 ownerUserId: ownerId,
             });
-            return textResult({ agreement: updated });
+            // ZIG-957: link approvals/rejects share the same summary shape as claim/revoke.
+            const agreement = updated?.engagementKind === 'link' ? linkSummary(updated) : updated;
+            return textResult({ agreement });
         }
         catch (e) {
             return toolError(e.message);
@@ -516,13 +530,17 @@ export function registerZiggsTools(server, creds, cfg) {
         try {
             const result = await revokeAgreement(agreementId, creds);
             const isLink = result.agreement?.engagementKind === 'link';
+            // ZIG-957: same summary shape as create/list/claim link tools (not the raw Mongo doc).
+            const agreement = result.agreement
+                ? (isLink ? linkSummary(result.agreement) : result.agreement)
+                : undefined;
             return textResult({
                 status: 'revoked',
                 agreementId,
                 ...(isLink
                     ? { note: 'Link revoked — unpublished cross-org reach to this peer is blocked again.' }
                     : {}),
-                agreement: result.agreement,
+                agreement,
             });
         }
         catch (e) {
@@ -537,8 +555,11 @@ export function registerZiggsTools(server, creds, cfg) {
             .optional()
             .describe('Revised agreement description / terms'),
         expiresAt: z.string().optional().describe('Revised expiry (ISO-8601)'),
-        lifecycle: z.string().optional().describe('Revised lifecycle'),
-        maxExecutions: z.number().optional().describe('Revised max executions'),
+        lifecycle: z
+            .enum(['open', 'time-bound', 'count-bound'])
+            .optional()
+            .describe('Revised lifecycle: open | time-bound | count-bound'),
+        maxExecutions: z.number().int().positive().optional().describe('Revised max executions'),
         description: z
             .string()
             .optional()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/ziggs-mcp",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "MCP server for Claude Code, Cursor, and other MCP hosts — act as your Ziggs delegate agent",
   "type": "module",
   "bin": {
@@ -36,7 +36,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@ziggs-ai/api-client": "^0.6.0",
+    "@ziggs-ai/api-client": "^0.6.1",
     "dotenv": "^16.6.1",
     "zod": "^3.24.2"
   },