@ziggs-ai/ziggs-mcp 0.6.0 → 0.6.2

package/dist/pendingDecisions.js

@@ -73,14 +73,29 @@ function proposalToItem(p, origin) {
         sayReject: `reject ${id}`,
     };
 }
+function linkRequesterHeadline(c) {
+    // ZIG-1039: consent cards lead with a readable name + org, id as fallback.
+    const name = c.requesterDisplayName?.trim();
+    const org = c.requesterOrgName?.trim();
+    if (name && org)
+        return `${name} (${org})`;
+    if (name)
+        return name;
+    return c.requesterAgentId;
+}
 function linkToItem(c, origin) {
     const id = c.requestId;
     const note = c.message?.trim() || null;
+    const headline = linkRequesterHeadline(c);
     return {
         kind: 'link_request',
         agreementId: id,
-        title: truncateText(`Agent link · ${c.requesterAgentId}`),
-        subtitle: note ? truncateText(note, 96) : null,
+        title: truncateText(`Agent link · ${headline}`),
+        subtitle: note
+            ? truncateText(note, 96)
+            : c.requesterAgentId && headline !== c.requesterAgentId
+                ? truncateText(`id: ${c.requesterAgentId}`, 96)
+                : null,
         proposedAt: c.requestedAt,
         proposedAtLabel: formatWhen(c.requestedAt),
         appUrl: agreementAppUrl(origin, id),

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';
@@ -395,7 +395,7 @@ export function registerZiggsTools(server, creds, cfg) {
             return toolError(e.message);
         }
     });
-    server.tool('ziggs_agreement_propose', 'Propose an agreement — direct, broadcast, or link; there are no separate publish tools. DIRECT: proposedTo = one counterparty id, chatId required. Omit providerId (or set it to proposedTo) to commission the recipient (they work, your side pays); set providerId to your own agent id to offer (you work, proposedTo pays); a third-party providerId brokers (they work, proposedTo pays) and requires that provider to have a matching active offer. BROADCAST: proposedTo "everyone" (fully public) or "org" (your active org only), chatId optional — with no providerId this publishes a QUEST (whoever claims does the work, your side pays); with providerId = your own id it publishes a STANDING OFFER (you work, the claimer pays). Claiming is ziggs_agreement_claim; browsing is ziggs_marketplace_view. LINK: engagementKind "link" with proposedTo = an agent id proposes bilateral trust (no chat, no money; the target owner approves via ziggs_agreement_respond). The payer is always derived server-side as the non-providing side — there is no payer input. engagementKind "service" (default) = one deliverable; "hire" = ongoing engagement. Agreements are STANDING by default (lifecycle "open": no expiry, unlimited tasks) — hire once, then keep spawning tasks under the same agreement; set expiresAt (time-bound) or maxExecutions (count-bound) only when the engagement should end on its own. price is recorded on the agreement but does not itself trigger a transfer.', {
+    server.tool('ziggs_agreement_propose', 'Propose an agreement — direct, broadcast, or link; there are no separate publish tools. DIRECT: proposedTo = one counterparty id, chatId required. Omit providerId (or set it to proposedTo) to commission the recipient (they work, your side pays); set providerId to your own agent id to offer (you work, proposedTo pays); a third-party providerId brokers (they work, proposedTo pays) and requires that provider to have a matching active offer. BROADCAST: proposedTo "everyone" (fully public) or "org" (your active org only), chatId optional — with no providerId this publishes a QUEST (whoever claims does the work, your side pays); with providerId = your own id it publishes a STANDING OFFER (you work, the claimer pays). Claiming is ziggs_agreement_claim; browsing is ziggs_marketplace_view. LINK: engagementKind "link" with proposedTo = an agent id proposes bilateral trust (no chat, no money). The server routes parties.proposedTo to that agent\'s owner human (a person decides who their delegate trusts) — the id you pass may differ from parties.proposedTo in the response; when it does, `note` explains the rewrite. Approve via ziggs_agreement_respond. The payer is always derived server-side as the non-providing side — there is no payer input. engagementKind "service" (default) = one deliverable; "hire" = ongoing engagement. Agreements are STANDING by default (lifecycle "open": no expiry, unlimited tasks) — hire once, then keep spawning tasks under the same agreement; set expiresAt (time-bound) or maxExecutions (count-bound) only when the engagement should end on its own. price is recorded on the agreement but does not itself trigger a transfer.', {
         proposedTo: z
             .string()
             .describe('Counterparty id for a direct proposal, or "everyone"/"org" to broadcast'),
@@ -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,20 @@ 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;
+            // ZIG-1039: surface the owner-routing rewrite so agents do not think
+            // the id they passed was ignored silently.
+            const routedProposedTo = shape === 'link' &&
+                agreement?.parties?.proposedTo &&
+                proposedTo &&
+                proposedTo !== agreement.parties.proposedTo
+                ? `Routed approval to the target agent's owner (${agreement.parties.proposedTo}): a person decides who their delegate trusts. You passed proposedTo=${proposedTo}.`
+                : undefined;
             return textResult({
                 shape,
-                agreement,
+                agreement: agreementOut,
+                ...(routedProposedTo ? { note: routedProposedTo } : {}),
                 ...(shape === 'quest' || shape === 'offer'
                     ? {
                         nextSteps: 'Published to the marketplace — claimable via ziggs_agreement_claim; it also appears in ziggs_marketplace_view.',
@@ -466,10 +481,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 +525,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 +539,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 +564,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.2",
   "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"
   },