@agentvalet/mcp-server 0.3.4 → 0.3.6

package/dist/index.js

@@ -51,6 +51,26 @@ const LIST_PLATFORMS_TOOL = {
     name: "list_platforms",
     description: "list_platforms: List the platforms and permission scopes this agent has access to.\nInput: None.\nReturns: { platforms: [{ platformId, platformName, scopes, requireApproval }], version: \"<hex>\" }.\nVersion: a deterministic hash that only changes when the platform set or scopes change. Cache the value across calls in the same session — only refresh when you suspect platforms have changed (e.g. user mentions a new connection).\nAuth: Bearer JWT.",
     inputSchema: { type: "object", properties: {} },
+    outputSchema: {
+        type: "object",
+        properties: {
+            platforms: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        platformId: { type: "string" },
+                        platformName: { type: "string" },
+                        scopes: { type: "array", items: { type: "string" } },
+                        requireApproval: { type: "boolean" },
+                    },
+                    required: ["platformId", "platformName", "scopes"],
+                },
+            },
+            version: { type: "string" },
+        },
+        required: ["platforms"],
+    },
 };
 const USE_PLATFORM_TOOL = {
     name: "use_platform",
@@ -112,6 +132,17 @@ const AGENT_REGISTER_TOOL = {
         },
         required: ["owner_id", "agent_name", "requested_scopes"],
     },
+    outputSchema: {
+        type: "object",
+        properties: {
+            registration_token: { type: "string" },
+            poll_url: { type: "string" },
+            client_id: { type: "string" },
+            scope: { type: "string" },
+            expires_in: { type: "number" },
+        },
+        required: ["registration_token"],
+    },
 };
 const AGENT_STATUS_TOOL = {
     name: "agent_status",
@@ -126,6 +157,15 @@ const AGENT_STATUS_TOOL = {
         },
         required: ["token"],
     },
+    outputSchema: {
+        type: "object",
+        properties: {
+            status: { type: "string", enum: ["pending_approval", "approved", "rejected"] },
+            agent_id: { type: "string" },
+            mcp_config: { type: "object" },
+        },
+        required: ["status"],
+    },
 };
 const AUTHZEN_EVALUATE_TOOL = {
     name: "authzen_evaluate",
@@ -144,6 +184,14 @@ const AUTHZEN_EVALUATE_TOOL = {
         },
         required: ["platform_id", "scope"],
     },
+    outputSchema: {
+        type: "object",
+        properties: {
+            decision: { type: "boolean" },
+            context: { type: "object", properties: { reason: { type: "string" } } },
+        },
+        required: ["decision"],
+    },
 };
 const REPORT_SELF_DIAGNOSTIC_TOOL = {
     name: "report_self_diagnostic",
@@ -183,11 +231,55 @@ const REPORT_SELF_DIAGNOSTIC_TOOL = {
         },
         required: ["severity", "message"],
     },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            received_at: { type: "string" },
+        },
+        required: ["id"],
+    },
 };
 const LIST_MY_PENDING_ACTIONS_TOOL = {
     name: "list_my_pending_actions",
     description: "list_my_pending_actions: Returns this agent's currently-pending approval requests AND any that completed in the last 24 hours. Use this at session start when the user mentions an earlier action, or when use_platform's long-poll timed out and the user comes back asking what happened.\nInput: None.\nReturns: { pending: [{approval_id, platform_id, scope, created_at, expires_at}], recently_completed: [{approval_id, platform_id, scope, status, executed_at, result_summary, execution_error}] }.\nAuth: Bearer agent JWT (sent automatically).",
     inputSchema: { type: "object", properties: {} },
+    outputSchema: {
+        type: "object",
+        properties: {
+            pending: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        approval_id: { type: "string" },
+                        platform_id: { type: "string" },
+                        scope: { type: "string" },
+                        created_at: { type: "string" },
+                        expires_at: { type: "string" },
+                    },
+                    required: ["approval_id", "platform_id", "scope"],
+                },
+            },
+            recently_completed: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        approval_id: { type: "string" },
+                        platform_id: { type: "string" },
+                        scope: { type: "string" },
+                        status: { type: "string" },
+                        executed_at: { type: "string" },
+                        result_summary: { type: "string" },
+                        execution_error: { type: "string" },
+                    },
+                    required: ["approval_id", "status"],
+                },
+            },
+        },
+        required: ["pending", "recently_completed"],
+    },
 };
 // TODO: intent_resolve tool — planned for future release
 // ---------------------------------------------------------------------------
@@ -471,13 +563,27 @@ async function waitForApproval(approvalId, originalCall, progressToken) {
             // Re-execution complete. Return the upstream response transparently —
             // the agent sees this as if the original use_platform call just succeeded.
             const r = status.result;
-            const summary = `[Owner approved after ${Math.round(elapsed / 1000)}s]\n` +
-                JSON.stringify(r.data ?? null);
             // Mirror the non-2xx-from-upstream behaviour of the regular path.
             if (r.status < 200 || r.status >= 300) {
                 return errorContent(`Upstream returned ${r.status}: ${JSON.stringify(r.data)}`);
             }
-            return { content: [{ type: "text", text: summary }] };
+            // Two-channel return: the text envelope carries the human-readable
+            // "[Owner approved after Ns]" prefix (visible to non-structured-aware
+            // clients), and structuredContent carries the parsed upstream JSON
+            // directly so MCP-aware hosts (Claude Desktop ≥ MCP spec 2025-06-18)
+            // never have to strip-the-prefix-and-reparse. Without the second
+            // channel the prefix forces Claude into the same wrapper-parse
+            // round-trip the bare /v1/actions path used to.
+            const data = r.data ?? null;
+            const summary = `[Owner approved after ${Math.round(elapsed / 1000)}s]\n` +
+                JSON.stringify(data);
+            const result = {
+                content: [{ type: "text", text: summary }],
+            };
+            if (data && typeof data === "object" && !Array.isArray(data)) {
+                result.structuredContent = data;
+            }
+            return result;
         }
         if (status.status === "denied") {
             return errorContent(`Owner denied this action${status.execution_error ? `: ${status.execution_error}` : "."}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentvalet/mcp-server",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "AgentValet MCP server — lets AI agents call approved platforms via the AgentValet proxy",
   "type": "module",
   "main": "dist/index.js",