@hapticpaper/mcp-server 1.0.17 → 1.0.19

package/dist/tools/workers.js

@@ -2,6 +2,7 @@ import { z } from "zod";
 import { requireScopes } from "../auth/access.js";
 import { HAPTICPAPER_WIDGET_URI } from "../constants/widget.js";
 import crypto from 'node:crypto';
+// --- Shared Helpers ---
 function stableSessionId(prefix, value) {
     const raw = value ?? 'unknown';
     const hash = crypto.createHash('sha256').update(raw).digest('hex').slice(0, 16);
@@ -9,10 +10,7 @@ function stableSessionId(prefix, value) {
 }
 function oauthSecuritySchemes(scopes) {
     return [
-        {
-            type: 'oauth2',
-            scopes,
-        },
+        { type: 'oauth2', scopes },
     ];
 }
 function toolDescriptorMeta(invoking, invoked, scopes) {
@@ -31,6 +29,7 @@ function toolInvocationMeta(invoking, invoked, widgetSessionId) {
         'openai/widgetSessionId': widgetSessionId,
     };
 }
+// --- Schema Definitions ---
 const SearchWorkersSchema = z.object({
     taskDescription: z.string().describe("Description of what needs to be done"),
     location: z.object({
@@ -39,82 +38,63 @@ const SearchWorkersSchema = z.object({
     }).optional(),
     skills: z.array(z.string()).optional()
 });
+const WorkersToolSchema = z.object({
+    action: z.enum(['search', 'get_profile']).describe("Action to perform on the workers resource"),
+    // Search params
+    taskDescription: SearchWorkersSchema.shape.taskDescription.optional(),
+    location: SearchWorkersSchema.shape.location.optional(),
+    skills: SearchWorkersSchema.shape.skills.optional(),
+    // Get params
+    workerId: z.string().uuid().optional().describe("Worker ID to retrieve profile"),
+}).describe("Find and view worker profiles. Actions: search, get_profile.");
 export function registerWorkerTools(server, client) {
-    const searchWorkersInvoking = 'Searching nearby workers';
-    const searchWorkersInvoked = 'Worker results ready';
-    const searchWorkersHandler = async (args, extra) => {
+    const workersHandler = async (args, extra) => {
         try {
-            const auth = requireScopes(extra, ['workers:read']);
-            const result = await client.searchWorkers(args, auth?.token);
-            const widgetSessionId = stableSessionId('workers', JSON.stringify({ userId: auth?.userId ?? auth?.clientId, args }));
-            if (!result.workers || result.workers.length === 0) {
-                return {
-                    structuredContent: { workers: [], suggestedBudget: result?.suggestedBudget },
-                    content: [{ type: 'text', text: 'No workers found matching criteria.' }],
-                    _meta: {
-                        ...toolInvocationMeta(searchWorkersInvoking, searchWorkersInvoked, widgetSessionId),
-                        result,
-                    },
-                };
+            switch (args.action) {
+                case 'search': {
+                    const auth = requireScopes(extra, ['workers:read']);
+                    if (!args.taskDescription)
+                        throw new Error("Missing taskDescription for search action");
+                    const searchArgs = {
+                        taskDescription: args.taskDescription,
+                        location: args.location,
+                        skills: args.skills
+                    };
+                    const result = await client.searchWorkers(searchArgs, auth?.token);
+                    const widgetSessionId = stableSessionId('workers', JSON.stringify({ userId: auth?.userId ?? auth?.clientId, args: searchArgs }));
+                    if (!result.workers || result.workers.length === 0) {
+                        return {
+                            structuredContent: { workers: [], suggestedBudget: result?.suggestedBudget },
+                            content: [{ type: 'text', text: 'No workers found matching criteria.' }],
+                            _meta: { ...toolInvocationMeta('Searching workers', 'Worker results ready', widgetSessionId), result }
+                        };
+                    }
+                    return {
+                        structuredContent: {
+                            workers: result.workers.map((w) => ({
+                                id: w.id, name: w.name, rating: w.rating, distanceMiles: w.distanceMiles, estimatedArrival: w.estimatedArrival,
+                            })),
+                            suggestedBudget: result.suggestedBudget,
+                        },
+                        content: [{ type: 'text', text: `Found ${result.workers.length} workers. Suggested budget: $${result.suggestedBudget}` }],
+                        _meta: { ...toolInvocationMeta('Searching workers', 'Worker results ready', widgetSessionId), result }
+                    };
+                }
+                case 'get_profile': {
+                    const auth = requireScopes(extra, ['workers:read']);
+                    if (!args.workerId)
+                        throw new Error("Missing workerId for get_profile action");
+                    const worker = await client.getWorkerProfile(args.workerId, auth?.token);
+                    const widgetSessionId = `worker:${args.workerId}`;
+                    return {
+                        structuredContent: { worker },
+                        content: [{ type: 'text', text: `Worker profile loaded: ${worker?.id ?? args.workerId}` }],
+                        _meta: { ...toolInvocationMeta('Loading profile', 'Worker profile ready', widgetSessionId), worker }
+                    };
+                }
+                default:
+                    throw new Error(`Unknown action: ${args.action}`);
             }
-            return {
-                structuredContent: {
-                    workers: result.workers.map((w) => ({
-                        id: w.id,
-                        name: w.name,
-                        rating: w.rating,
-                        distanceMiles: w.distanceMiles,
-                        estimatedArrival: w.estimatedArrival,
-                    })),
-                    suggestedBudget: result.suggestedBudget,
-                },
-                content: [
-                    {
-                        type: 'text',
-                        text: `Found ${result.workers.length} workers. Suggested budget: $${result.suggestedBudget}`,
-                    },
-                ],
-                _meta: {
-                    ...toolInvocationMeta(searchWorkersInvoking, searchWorkersInvoked, widgetSessionId),
-                    result,
-                },
-            };
-        }
-        catch (err) {
-            return {
-                content: [{ type: 'text', text: `Error: ${err.message}` }],
-                isError: true,
-            };
-        }
-    };
-    for (const toolName of ['search_workers', 'workers_search']) {
-        server.registerTool(toolName, {
-            title: 'Search workers',
-            description: 'Search for available workers. Returns anonymized profiles.',
-            inputSchema: SearchWorkersSchema,
-            annotations: {
-                readOnlyHint: true,
-                openWorldHint: false,
-                destructiveHint: false,
-            },
-            _meta: toolDescriptorMeta(searchWorkersInvoking, searchWorkersInvoked, ['workers:read']),
-        }, searchWorkersHandler);
-    }
-    const getWorkerInvoking = 'Loading worker profile';
-    const getWorkerInvoked = 'Worker profile ready';
-    const getWorkerProfileHandler = async (args, extra) => {
-        try {
-            const auth = requireScopes(extra, ['workers:read']);
-            const worker = await client.getWorkerProfile(args.workerId, auth?.token);
-            const widgetSessionId = `worker:${args.workerId}`;
-            return {
-                structuredContent: { worker },
-                content: [{ type: 'text', text: `Worker profile loaded: ${worker?.id ?? args.workerId}` }],
-                _meta: {
-                    ...toolInvocationMeta(getWorkerInvoking, getWorkerInvoked, widgetSessionId),
-                    worker,
-                },
-            };
         }
         catch (err) {
             return {
@@ -123,17 +103,10 @@ export function registerWorkerTools(server, client) {
             };
         }
     };
-    for (const toolName of ['get_worker_profile', 'workers_get_profile']) {
-        server.registerTool(toolName, {
-            title: 'Get worker profile',
-            description: 'Get a detailed worker profile by ID.',
-            inputSchema: z.object({ workerId: z.string().uuid() }),
-            annotations: {
-                readOnlyHint: true,
-                openWorldHint: false,
-                destructiveHint: false,
-            },
-            _meta: toolDescriptorMeta(getWorkerInvoking, getWorkerInvoked, ['workers:read']),
-        }, getWorkerProfileHandler);
-    }
+    server.registerTool('workers', {
+        title: 'Manage Workers',
+        description: 'Find and view worker profiles. Actions: search, get_profile. Use this to find talent or check worker details.',
+        inputSchema: WorkersToolSchema,
+        _meta: toolDescriptorMeta('Managing workers', 'Worker operation complete', ['workers:read']),
+    }, workersHandler);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hapticpaper/mcp-server",
   "mcpName": "com.hapticpaper/mcp",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "description": "Official MCP Server for Haptic Paper - Connect your account to create human tasks from agentic pipelines.",
   "type": "module",
   "main": "dist/index.js",

package/server.json

@@ -25,7 +25,7 @@
     "subfolder": "packages/mcp-server"
   },
   "websiteUrl": "https://hapticpaper.com/developer",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "remotes": [
     {
       "type": "streamable-http",
@@ -37,7 +37,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@hapticpaper/mcp-server",
-      "version": "1.0.17",
+      "version": "1.0.19",
       "transport": {
         "type": "stdio"
       },