figmanage 1.2.9 → 1.3.1

package/dist/tools/webhooks.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { defineTool, toolResult, toolError, figmaId } from './register.js';
+import { defineTool, toolResult, toolError, toolSummary, figmaId } from './register.js';
+import { formatApiError } from '../helpers.js';
 import { listWebhooks, createWebhook, updateWebhook, deleteWebhook, } from '../operations/webhooks.js';
 const eventTypeEnum = z.enum([
     'FILE_UPDATE',
@@ -15,17 +16,19 @@ defineTool({
     auth: 'pat',
     register(server, config) {
         server.registerTool('list_webhooks', {
-            description: 'List webhooks for a team.',
+            description: 'List webhook subscriptions for a team. Returns webhook IDs, endpoints, event types, and status.',
             inputSchema: {
                 team_id: figmaId.describe('Team ID'),
             },
         }, async ({ team_id }) => {
             try {
-                const webhooks = await listWebhooks(config, { team_id });
-                return toolResult(JSON.stringify(webhooks, null, 2));
+                const result = await listWebhooks(config, { team_id });
+                if (result.count === 0)
+                    return toolResult('No webhooks configured for this team.');
+                return toolSummary(`${result.count} webhook(s).`, result, 'Use create_webhook to add, or update_webhook/delete_webhook to manage.');
             }
             catch (e) {
-                return toolError(`Failed to list webhooks: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list webhooks: ${formatApiError(e)}`);
             }
         });
     },
@@ -48,10 +51,10 @@ defineTool({
         }, async ({ team_id, event_type, endpoint, passcode, description }) => {
             try {
                 const result = await createWebhook(config, { team_id, event_type, endpoint, passcode, description });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`Created webhook ${result.id || 'unknown'} for ${result.event_type || event_type} events.`, result);
             }
             catch (e) {
-                return toolError(`Failed to create webhook: ${e.response?.status || e.message}`);
+                return toolError(`Failed to create webhook: ${formatApiError(e)}`);
             }
         });
     },
@@ -63,7 +66,7 @@ defineTool({
     mutates: true,
     register(server, config) {
         server.registerTool('update_webhook', {
-            description: 'Update a webhook.',
+            description: "Update a webhook's endpoint, event type, passcode, description, or status (ACTIVE/PAUSED).",
             inputSchema: {
                 webhook_id: figmaId.describe('Webhook ID'),
                 event_type: eventTypeEnum.optional().describe('Event type to subscribe to'),
@@ -75,10 +78,10 @@ defineTool({
         }, async ({ webhook_id, event_type, endpoint, passcode, description, status }) => {
             try {
                 const result = await updateWebhook(config, { webhook_id, event_type, endpoint, passcode, description, status });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`Updated webhook ${result.id || webhook_id}.`, result);
             }
             catch (e) {
-                return toolError(`Failed to update webhook: ${e.response?.status || e.message}`);
+                return toolError(`Failed to update webhook: ${formatApiError(e)}`);
             }
         });
     },
@@ -91,7 +94,7 @@ defineTool({
     destructive: true,
     register(server, config) {
         server.registerTool('delete_webhook', {
-            description: 'Delete a webhook.',
+            description: 'Permanently delete a webhook. The webhook stops receiving events immediately. Cannot be undone.',
             inputSchema: {
                 webhook_id: figmaId.describe('Webhook ID'),
             },
@@ -101,7 +104,7 @@ defineTool({
                 return toolResult(`Deleted webhook ${webhook_id}`);
             }
             catch (e) {
-                return toolError(`Failed to delete webhook: ${e.response?.status || e.message}`);
+                return toolError(`Failed to delete webhook: ${formatApiError(e)}`);
             }
         });
     },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "figmanage",
   "mcpName": "io.github.dannykeane/figmanage",
-  "version": "1.2.9",
+  "version": "1.3.1",
   "description": "MCP server for managing your Figma workspace from the terminal.",
   "type": "module",
   "main": "dist/index.js",