figmanage 1.2.9 → 1.3.1

package/dist/tools/compound.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { defineTool, toolResult, toolError, figmaId } from './register.js';
+import { defineTool, toolError, toolSummary, figmaId } from './register.js';
+import { formatApiError } from '../helpers.js';
 import { fileSummary, workspaceOverview, openComments, cleanupStaleFiles, organizeProject, setupProjectStructure, seatOptimization, permissionAudit, branchCleanup, } from '../operations/compound.js';
 // -- file_summary --
 defineTool({
@@ -14,10 +15,10 @@ defineTool({
         }, async ({ file_key }) => {
             try {
                 const result = await fileSummary(config, { file_key });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`${result.name}: ${result.pages?.length || 0} pages, ${result.component_count} components, ${result.unresolved_comment_count} unresolved comments.`, result);
             }
             catch (e) {
-                return toolError(`Failed to summarize file: ${e.response?.status || e.message}`);
+                return toolError(`Failed to summarize file: ${formatApiError(e)}`);
             }
         });
     },
@@ -35,10 +36,11 @@ defineTool({
         }, async ({ org_id }) => {
             try {
                 const result = await workspaceOverview(config, { org_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                const teamCount = result.teams?.length || 0;
+                return toolSummary(`${teamCount} team(s). Seats and billing included.`, result);
             }
             catch (e) {
-                return toolError(`Failed to fetch workspace overview: ${e.response?.status || e.message}`);
+                return toolError(`Failed to fetch workspace overview: ${formatApiError(e)}`);
             }
         });
     },
@@ -56,10 +58,12 @@ defineTool({
         }, async ({ project_id }) => {
             try {
                 const result = await openComments(config, { project_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                const total = result.total_unresolved || 0;
+                const fileCount = result.files?.length || 0;
+                return toolSummary(`${total} unresolved comment(s) across ${fileCount} file(s).`, result, 'Use post_comment with file_key and parent_id to reply.');
             }
             catch (e) {
-                return toolError(`Failed to fetch open comments: ${e.response?.status || e.message}`);
+                return toolError(`Failed to fetch open comments: ${formatApiError(e)}`);
             }
         });
     },
@@ -72,7 +76,7 @@ defineTool({
     destructive: true,
     register(server, config) {
         server.registerTool('cleanup_stale_files', {
-            description: 'Find files not modified in N days and optionally trash them. Defaults to dry run.',
+            description: 'Find files not modified in N days and optionally trash them. dry_run=true (default) previews which files would be trashed without trashing them. Set dry_run=false to execute.',
             inputSchema: {
                 project_id: figmaId.describe('Project ID'),
                 days_stale: z.number().optional().default(90).describe('Days since last modification (default: 90)'),
@@ -85,10 +89,12 @@ defineTool({
                     days_stale: days_stale ?? 90,
                     dry_run: rawDryRun ?? true,
                 });
-                return toolResult(JSON.stringify(result, null, 2));
+                const count = result.stale_files?.length || 0;
+                const action = result.dry_run ? `${count} stale file(s) found. Set dry_run=false to trash them.` : `Trashed ${result.trashed_count || 0} file(s).`;
+                return toolSummary(action, result);
             }
             catch (e) {
-                return toolError(`Failed to cleanup stale files: ${e.response?.status || e.message}`);
+                return toolError(`Failed to cleanup stale files: ${formatApiError(e)}`);
             }
         });
     },
@@ -100,7 +106,7 @@ defineTool({
     mutates: true,
     register(server, config) {
         server.registerTool('organize_project', {
-            description: 'Move multiple files into a target project in a single batch.',
+            description: 'Move files into a target project in a single batch. Files are moved (not copied) from their current project.',
             inputSchema: {
                 file_keys: z.array(figmaId).min(1).describe('File keys to move'),
                 target_project_id: figmaId.describe('Destination project ID'),
@@ -108,10 +114,10 @@ defineTool({
         }, async ({ file_keys, target_project_id }) => {
             try {
                 const result = await organizeProject(config, { file_keys, target_project_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`Moved ${result.moved} file(s) to project ${result.target_project_id}.`, result);
             }
             catch (e) {
-                return toolError(`Failed to organize project: ${e.response?.status || e.message}`);
+                return toolError(`Failed to organize project: ${formatApiError(e)}`);
             }
         });
     },
@@ -134,10 +140,10 @@ defineTool({
         }, async ({ team_id, projects }) => {
             try {
                 const result = await setupProjectStructure(config, { team_id, projects });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`Created ${result.created?.length || 0} project(s).`, result);
             }
             catch (e) {
-                return toolError(`Failed to setup project structure: ${e.response?.status || e.message}`);
+                return toolError(`Failed to setup project structure: ${formatApiError(e)}`);
             }
         });
     },
@@ -161,10 +167,13 @@ defineTool({
                     days_inactive: days_inactive ?? 90,
                     include_cost: include_cost ?? true,
                 });
-                return toolResult(JSON.stringify(result, null, 2));
+                const inactive = result.summary?.inactive_paid || 0;
+                const savingsCents = result.summary?.monthly_waste_cents || 0;
+                const savingsStr = savingsCents > 0 ? ` Potential savings: $${(savingsCents / 100).toFixed(2)}/mo.` : '';
+                return toolSummary(`${inactive} inactive paid seat(s).${savingsStr}`, result, 'Use change_seat to downgrade inactive users, or offboard_user for full removal.');
             }
             catch (e) {
-                return toolError(`Failed to analyze seat optimization: ${e.response?.status || e.message}`);
+                return toolError(`Failed to analyze seat optimization: ${formatApiError(e)}`);
             }
         });
     },
@@ -190,10 +199,11 @@ defineTool({
                     flag_external: flag_external ?? true,
                     org_id,
                 });
-                return toolResult(JSON.stringify(result, null, 2));
+                const flagCount = result.flags?.length || 0;
+                return toolSummary(`${flagCount} issue(s) flagged.`, result, flagCount > 0 ? 'Use revoke_access or set_permissions to address flagged issues.' : undefined);
             }
             catch (e) {
-                return toolError(`Failed to audit permissions: ${e.response?.status || e.message}`);
+                return toolError(`Failed to audit permissions: ${formatApiError(e)}`);
             }
         });
     },
@@ -206,7 +216,7 @@ defineTool({
     destructive: true,
     register(server, config) {
         server.registerTool('branch_cleanup', {
-            description: 'Find stale branches across a project and optionally archive them. Defaults to dry run.',
+            description: 'Find stale branches across a project and optionally archive them. dry_run=true (default) previews which branches would be archived. Archives move branch files to trash (recoverable).',
             inputSchema: {
                 project_id: figmaId.describe('Project ID'),
                 days_stale: z.number().min(1).max(365).optional().default(60).describe('Days since last modification to flag as stale (default: 60)'),
@@ -219,10 +229,12 @@ defineTool({
                     days_stale: days_stale ?? 60,
                     dry_run: rawDryRun ?? true,
                 });
-                return toolResult(JSON.stringify(result, null, 2));
+                const stale = result.stale_branches?.length || 0;
+                const action = result.dry_run ? `${stale} stale branch(es) found. Set dry_run=false to archive.` : `Archived ${result.archived_count || 0} branch(es).`;
+                return toolSummary(action, result);
             }
             catch (e) {
-                return toolError(`Failed to cleanup branches: ${e.response?.status || e.message}`);
+                return toolError(`Failed to cleanup branches: ${formatApiError(e)}`);
             }
         });
     },

package/dist/tools/export.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 { exportNodes, getImageFills } from '../operations/export.js';
 // -- export_nodes --
 defineTool({
@@ -17,10 +18,10 @@ defineTool({
         }, async ({ file_key, node_ids, format, scale }) => {
             try {
                 const result = await exportNodes(config, { file_key, node_ids, format, scale });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`Exported ${result.length} node(s). URLs valid ~14 days.`, result);
             }
             catch (e) {
-                return toolError(`Failed to export nodes: ${e.response?.status || e.message}`);
+                return toolError(`Failed to export nodes: ${formatApiError(e)}`);
             }
         });
     },
@@ -40,10 +41,10 @@ defineTool({
                 const results = await getImageFills(config, { file_key });
                 if (results.length === 0)
                     return toolResult('No image fills in this file.');
-                return toolResult(JSON.stringify(results, null, 2));
+                return toolSummary(`${results.length} image fill(s).`, results);
             }
             catch (e) {
-                return toolError(`Failed to get image fills: ${e.response?.status || e.message}`);
+                return toolError(`Failed to get image fills: ${formatApiError(e)}`);
             }
         });
     },

package/dist/tools/files.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 { createFile, renameFile, moveFiles, duplicateFile, trashFiles, restoreFiles, favoriteFile, setLinkAccess, } from '../operations/files.js';
 // -- create_file --
 defineTool({
@@ -17,10 +18,10 @@ defineTool({
         }, async ({ project_id, editor_type, org_id }) => {
             try {
                 const result = await createFile(config, { project_id, editor_type, org_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`Created ${result.editor_type || 'design'} file.`, result);
             }
             catch (e) {
-                return toolError(`Failed to create file: ${e.response?.status || e.message}`);
+                return toolError(`Failed to create file: ${formatApiError(e)}`);
             }
         });
     },
@@ -43,7 +44,7 @@ defineTool({
                 return toolResult(`Renamed to "${name}"`);
             }
             catch (e) {
-                return toolError(`Failed to rename file: ${e.response?.status || e.message}`);
+                return toolError(`Failed to rename file: ${formatApiError(e)}`);
             }
         });
     },
@@ -69,7 +70,7 @@ defineTool({
                 return toolResult(msg);
             }
             catch (e) {
-                return toolError(`Failed to move files: ${e.response?.status || e.message}`);
+                return toolError(`Failed to move files: ${formatApiError(e)}`);
             }
         });
     },
@@ -89,10 +90,10 @@ defineTool({
         }, async ({ file_key, project_id }) => {
             try {
                 const result = await duplicateFile(config, { file_key, project_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`Duplicated file.`, result);
             }
             catch (e) {
-                return toolError(`Failed to duplicate file: ${e.response?.status || e.message}`);
+                return toolError(`Failed to duplicate file: ${formatApiError(e)}`);
             }
         });
     },
@@ -105,7 +106,7 @@ defineTool({
     destructive: true,
     register(server, config) {
         server.registerTool('trash_files', {
-            description: 'Move files to trash. Supports batch operations.',
+            description: 'Move files to trash (recoverable via restore_files). Supports batch operations.',
             inputSchema: {
                 file_keys: z.array(figmaId).min(1).describe('Array of file keys to trash'),
             },
@@ -115,7 +116,7 @@ defineTool({
                 return toolResult(`Trashed ${result.succeeded} file(s)`);
             }
             catch (e) {
-                return toolError(`Failed to trash files: ${e.response?.status || e.message}`);
+                return toolError(`Failed to trash files: ${formatApiError(e)}`);
             }
         });
     },
@@ -140,7 +141,7 @@ defineTool({
                 return toolResult(msg);
             }
             catch (e) {
-                return toolError(`Failed to restore files: ${e.response?.status || e.message}`);
+                return toolError(`Failed to restore files: ${formatApiError(e)}`);
             }
         });
     },
@@ -163,7 +164,7 @@ defineTool({
                 return toolResult(`${result.favorited ? 'Favorited' : 'Unfavorited'} file ${file_key}`);
             }
             catch (e) {
-                return toolError(`Failed to toggle favorite: ${e.response?.status || e.message}`);
+                return toolError(`Failed to toggle favorite: ${formatApiError(e)}`);
             }
         });
     },
@@ -186,7 +187,7 @@ defineTool({
                 return toolResult(`Set link access to "${result.link_access}" on file ${file_key}`);
             }
             catch (e) {
-                return toolError(`Failed to set link access: ${e.response?.status || e.message}`);
+                return toolError(`Failed to set link access: ${formatApiError(e)}`);
             }
         });
     },

package/dist/tools/libraries.js

@@ -1,4 +1,5 @@
-import { defineTool, toolResult, toolError, figmaId } from './register.js';
+import { defineTool, toolResult, toolError, toolSummary, figmaId } from './register.js';
+import { formatApiError } from '../helpers.js';
 import { listOrgLibraries } from '../operations/libraries.js';
 // -- list_org_libraries --
 defineTool({
@@ -13,10 +14,12 @@ defineTool({
         }, async ({ org_id }) => {
             try {
                 const result = await listOrgLibraries(config, { org_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                if (result.length === 0)
+                    return toolResult('No libraries found.');
+                return toolSummary(`${result.length} library/libraries.`, result, 'Use library_usage to see adoption metrics.');
             }
             catch (e) {
-                return toolError(`Failed to list org libraries: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list org libraries: ${formatApiError(e)}`);
             }
         });
     },

package/dist/tools/navigate.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 { checkAuthStatus, listOrgs, switchOrg, listTeams, listProjects, listFiles, listRecentFiles, search, getFileInfo, listFavorites, } from '../operations/navigate.js';
 // -- check_auth --
 defineTool({
@@ -34,10 +35,10 @@ defineTool({
                 if (orgs.length === 0) {
                     return toolResult('No workspaces found. You may be on a free/starter plan.');
                 }
-                return toolResult(JSON.stringify(orgs, null, 2));
+                return toolSummary(`Found ${orgs.length} workspace(s).`, orgs, 'Use switch_org to change workspace, or list_teams to browse.');
             }
             catch (e) {
-                return toolError(`Failed to list orgs: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list orgs: ${formatApiError(e)}`);
             }
         });
     },
@@ -60,7 +61,7 @@ defineTool({
                 return toolResult(`Switched workspace: ${result.previous} -> ${result.current.name} (${result.current.id})`);
             }
             catch (e) {
-                return toolError(`Failed to switch org: ${e.response?.status || e.message}`);
+                return toolError(`Failed to switch org: ${formatApiError(e)}`);
             }
         });
     },
@@ -75,10 +76,12 @@ defineTool({
         }, async () => {
             try {
                 const teams = await listTeams(config);
-                return toolResult(JSON.stringify(teams, null, 2));
+                if (teams.length === 0)
+                    return toolResult('No teams found.');
+                return toolSummary(`Found ${teams.length} team(s).`, teams, 'Use list_projects with a team_id to browse projects.');
             }
             catch (e) {
-                return toolError(`Failed to list teams: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list teams: ${formatApiError(e)}`);
             }
         });
     },
@@ -96,10 +99,12 @@ defineTool({
         }, async ({ team_id }) => {
             try {
                 const projects = await listProjects(config, { team_id });
-                return toolResult(JSON.stringify(projects, null, 2));
+                if (projects.length === 0)
+                    return toolResult('No projects found.');
+                return toolSummary(`Found ${projects.length} project(s).`, projects, 'Use list_files with a project_id to see files.');
             }
             catch (e) {
-                return toolError(`Failed to list projects: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list projects: ${formatApiError(e)}`);
             }
         });
     },
@@ -119,10 +124,12 @@ defineTool({
         }, async ({ project_id, page_size, page_token }) => {
             try {
                 const result = await listFiles(config, { project_id, page_size, page_token });
-                return toolResult(JSON.stringify(result, null, 2));
+                const count = result.files.length;
+                const summary = `${count} file(s).` + (result.pagination?.has_more ? ' More pages available.' : '');
+                return toolSummary(summary, result, 'Use get_file_info or get_file for details.');
             }
             catch (e) {
-                return toolError(`Failed to list files: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list files: ${formatApiError(e)}`);
             }
         });
     },
@@ -137,10 +144,12 @@ defineTool({
         }, async () => {
             try {
                 const files = await listRecentFiles(config);
-                return toolResult(JSON.stringify(files, null, 2));
+                if (files.length === 0)
+                    return toolResult('No recent files.');
+                return toolSummary(`${files.length} recently accessed file(s).`, files, 'Use get_file_info for details.');
             }
             catch (e) {
-                return toolError(`Failed to list recent files: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list recent files: ${formatApiError(e)}`);
             }
         });
     },
@@ -163,10 +172,10 @@ defineTool({
                 if (results.length === 0) {
                     return toolResult('No results. Try list_recent_files or browse via list_projects + list_files.');
                 }
-                return toolResult(JSON.stringify(results, null, 2));
+                return toolSummary(`Found ${results.length} result(s).`, results, 'Use get_file_info for file details.');
             }
             catch (e) {
-                return toolError(`Search failed: ${e.response?.status || e.message}`);
+                return toolError(`Search failed: ${formatApiError(e)}`);
             }
         });
     },
@@ -184,10 +193,10 @@ defineTool({
         }, async ({ file_key }) => {
             try {
                 const info = await getFileInfo(config, { file_key });
-                return toolResult(JSON.stringify(info, null, 2));
+                return toolSummary(`${info.name} (${info.editor_type || 'design'})`, info);
             }
             catch (e) {
-                return toolError(`Failed to get file info: ${e.response?.status || e.message}`);
+                return toolError(`Failed to get file info: ${formatApiError(e)}`);
             }
         });
     },
@@ -202,10 +211,12 @@ defineTool({
         }, async () => {
             try {
                 const favorites = await listFavorites(config);
-                return toolResult(JSON.stringify(favorites, null, 2));
+                if (favorites.length === 0)
+                    return toolResult('No favorites found.');
+                return toolSummary(`${favorites.length} favorited file(s).`, favorites, 'Use get_file_info for details.');
             }
             catch (e) {
-                return toolError(`Failed to list favorites: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list favorites: ${formatApiError(e)}`);
             }
         });
     },

package/dist/tools/org.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 { listAdmins, listOrgTeams, seatUsage, listTeamMembers, billingOverview, listInvoices, orgDomains, aiCreditUsage, exportMembers, listOrgMembers, contractRates, changeSeat, } from '../operations/org.js';
 // -- list_admins --
 defineTool({
@@ -15,10 +16,10 @@ defineTool({
         }, async ({ org_id, include_license_admins }) => {
             try {
                 const result = await listAdmins(config, { org_id, include_license_admins });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`${result.length} admin(s).`, result);
             }
             catch (e) {
-                return toolError(`Failed to list admins: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list admins: ${formatApiError(e)}`);
             }
         });
     },
@@ -37,10 +38,10 @@ defineTool({
         }, async ({ org_id, include_secret_teams }) => {
             try {
                 const result = await listOrgTeams(config, { org_id, include_secret_teams });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`${result.length} team(s) in the org.`, result, 'Use list_team_members for member details.');
             }
             catch (e) {
-                return toolError(`Failed to list org teams: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list org teams: ${formatApiError(e)}`);
             }
         });
     },
@@ -59,10 +60,10 @@ defineTool({
         }, async ({ org_id, search_query }) => {
             try {
                 const result = await seatUsage(config, { org_id, search_query });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary('Seat usage breakdown:', result);
             }
             catch (e) {
-                return toolError(`Failed to fetch seat usage: ${e.response?.status || e.message}`);
+                return toolError(`Failed to fetch seat usage: ${formatApiError(e)}`);
             }
         });
     },
@@ -80,10 +81,10 @@ defineTool({
         }, async ({ team_id }) => {
             try {
                 const result = await listTeamMembers(config, { team_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`${result.length} member(s).`, result);
             }
             catch (e) {
-                return toolError(`Failed to list team members: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list team members: ${formatApiError(e)}`);
             }
         });
     },
@@ -101,10 +102,10 @@ defineTool({
         }, async ({ org_id }) => {
             try {
                 const result = await billingOverview(config, { org_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary('Billing overview:', result);
             }
             catch (e) {
-                return toolError(`Failed to fetch billing overview: ${e.response?.status || e.message}`);
+                return toolError(`Failed to fetch billing overview: ${formatApiError(e)}`);
             }
         });
     },
@@ -122,10 +123,10 @@ defineTool({
         }, async ({ org_id }) => {
             try {
                 const result = await listInvoices(config, { org_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`${result.length} invoice(s).`, result);
             }
             catch (e) {
-                return toolError(`Failed to list invoices: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list invoices: ${formatApiError(e)}`);
             }
         });
     },
@@ -143,10 +144,10 @@ defineTool({
         }, async ({ org_id }) => {
             try {
                 const result = await orgDomains(config, { org_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary('Domain configuration:', result);
             }
             catch (e) {
-                return toolError(`Failed to fetch org domains: ${e.response?.status || e.message}`);
+                return toolError(`Failed to fetch org domains: ${formatApiError(e)}`);
             }
         });
     },
@@ -164,10 +165,10 @@ defineTool({
         }, async ({ plan_id }) => {
             try {
                 const result = await aiCreditUsage(config, { plan_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary('AI credit usage:', result);
             }
             catch (e) {
-                return toolError(`Failed to fetch AI credit usage: ${e.response?.status || e.message}`);
+                return toolError(`Failed to fetch AI credit usage: ${formatApiError(e)}`);
             }
         });
     },
@@ -189,7 +190,7 @@ defineTool({
                 return toolResult(msg);
             }
             catch (e) {
-                return toolError(`Failed to export members: ${e.response?.status || e.message}`);
+                return toolError(`Failed to export members: ${formatApiError(e)}`);
             }
         });
     },
@@ -208,10 +209,10 @@ defineTool({
         }, async ({ org_id, search_query }) => {
             try {
                 const result = await listOrgMembers(config, { org_id, search_query });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary(`${result.length} member(s).`, result, 'Use change_seat to modify seat types.');
             }
             catch (e) {
-                return toolError(`Failed to list org members: ${e.response?.status || e.message}`);
+                return toolError(`Failed to list org members: ${formatApiError(e)}`);
             }
         });
     },
@@ -229,10 +230,10 @@ defineTool({
         }, async ({ org_id }) => {
             try {
                 const result = await contractRates(config, { org_id });
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary('Seat pricing:', result);
             }
             catch (e) {
-                return toolError(`Failed to fetch contract rates: ${e.response?.status || e.message}`);
+                return toolError(`Failed to fetch contract rates: ${formatApiError(e)}`);
             }
         });
     },
@@ -257,10 +258,10 @@ defineTool({
                 const result = await changeSeat(config, { user_id, seat_type, org_id, confirm });
                 if (typeof result === 'string')
                     return toolResult(result);
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolSummary('Seat change requires confirmation.', result);
             }
             catch (e) {
-                return toolError(e.response?.status ? `Failed to change seat: ${e.response.status}` : e.message);
+                return toolError(`Failed to change seat: ${formatApiError(e)}`);
             }
         });
     },