@keeperhub/wallet 0.1.12 → 0.1.13

package/dist/mcp-server.cjs

@@ -118,26 +118,6 @@ function fund(walletAddress) {
   };
 }
 
-// src/mpp-detect.ts
-var MPP_PREFIX = "Payment ";
-function parseMppChallenge(response) {
-  const header = response.headers.get("WWW-Authenticate");
-  if (!header) {
-    return null;
-  }
-  if (!header.startsWith(MPP_PREFIX)) {
-    return null;
-  }
-  const serialized = header.slice(MPP_PREFIX.length).trim();
-  if (serialized.length === 0) {
-    return null;
-  }
-  return { serialized };
-}
-
-// src/payment-signer.ts
-var import_node_crypto3 = require("crypto");
-
 // src/hmac.ts
 var import_node_crypto = require("crypto");
 function computeSignature(secret, method, path, subOrgId, body, timestamp) {
@@ -166,6 +146,26 @@ function buildHmacHeaders(secret, method, path, subOrgId, body) {
   };
 }
 
+// src/mpp-detect.ts
+var MPP_PREFIX = "Payment ";
+function parseMppChallenge(response) {
+  const header = response.headers.get("WWW-Authenticate");
+  if (!header) {
+    return null;
+  }
+  if (!header.startsWith(MPP_PREFIX)) {
+    return null;
+  }
+  const serialized = header.slice(MPP_PREFIX.length).trim();
+  if (serialized.length === 0) {
+    return null;
+  }
+  return { serialized };
+}
+
+// src/payment-signer.ts
+var import_node_crypto3 = require("crypto");
+
 // src/types.ts
 var KeeperHubError = class extends Error {
   code;
@@ -1144,6 +1144,94 @@ async function handleInfo(deps) {
     } : {}
   });
 }
+var submitFeedbackInputSchema = {
+  executionId: import_zod.z.string().min(1).describe(
+    "Workflow execution id returned in the `executionId` field of a previous successful call_workflow response."
+  ),
+  value: import_zod.z.number().int().describe(
+    "Rating value as a raw int128. With valueDecimals=0 this is a 1-5 star score; with valueDecimals=1 it is 0.1-step score. Server validates int128 range."
+  ),
+  valueDecimals: import_zod.z.number().int().min(0).max(18).describe(
+    "Decimals for value. Use 0 for an integer 1-5 score, 1 for a 0.1-step 0-50 score, etc."
+  ),
+  comment: import_zod.z.string().max(2e3).optional().describe(
+    "Optional plain-text comment included in the feedbackURI JSON."
+  ),
+  agentChainId: import_zod.z.number().int().optional().describe(
+    "Chain id where the rated agent NFT lives. Defaults to 1 (Ethereum mainnet); only 1 is supported today."
+  ),
+  agentId: import_zod.z.string().optional().describe(
+    "Rated agent NFT id (uint256, decimal string). Defaults to KeeperHub's own ERC-8004 agent (31875)."
+  )
+};
+async function handleSubmitFeedback(args, deps) {
+  let ensured;
+  try {
+    ensured = await ensureWallet(deps);
+  } catch (err) {
+    return toolErrorEnvelope(err);
+  }
+  const baseUrl = resolveKeeperhubBaseUrl();
+  const path = "/api/agentic-wallet/feedback";
+  const url = `${baseUrl}${path}`;
+  const body = JSON.stringify({
+    executionId: args.executionId,
+    value: args.value,
+    valueDecimals: args.valueDecimals,
+    ...args.comment !== void 0 ? { comment: args.comment } : {},
+    ...args.agentChainId !== void 0 ? { agentChainId: args.agentChainId } : {},
+    ...args.agentId !== void 0 ? { agentId: args.agentId } : {}
+  });
+  const hmacHeaders = buildHmacHeaders(
+    ensured.hmacSecret,
+    "POST",
+    path,
+    ensured.subOrgId,
+    body
+  );
+  let response;
+  try {
+    response = await deps.fetchImpl(url, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        ...hmacHeaders
+      },
+      body,
+      signal: AbortSignal.timeout(HTTP_TIMEOUT_MS)
+    });
+  } catch (err) {
+    return toolErrorEnvelope(err);
+  }
+  let parsedBody;
+  try {
+    parsedBody = await response.json();
+  } catch {
+    const fallback = await response.text();
+    return structuredError({
+      code: "FEEDBACK_UNPARSEABLE_RESPONSE",
+      message: sanitise(
+        `Server returned non-JSON ${response.status}: ${fallback.slice(0, 512)}`
+      )
+    });
+  }
+  if (!response.ok) {
+    const errBody = parsedBody;
+    return structuredError({
+      code: errBody.code ?? `FEEDBACK_HTTP_${response.status}`,
+      message: sanitise(errBody.error ?? `HTTP ${response.status}`),
+      ...errBody.feedbackId ? { feedbackId: errBody.feedbackId } : {}
+    });
+  }
+  const okBody = parsedBody;
+  return structuredOk({
+    feedbackId: okBody.feedbackId,
+    txHash: okBody.txHash,
+    publicUrl: okBody.publicUrl,
+    // Help the agent surface a confirmation message.
+    summary: okBody.txHash !== void 0 ? `Feedback submitted on-chain. Tx: ${okBody.txHash}` : "Feedback submitted"
+  });
+}
 function buildMcpServer(options = {}) {
   const deps = { ...defaultDeps(), ...options.deps };
   const server = new import_mcp.McpServer({
@@ -1177,6 +1265,17 @@ function buildMcpServer(options = {}) {
     },
     async () => await withToolLogging("info", () => handleInfo(deps))
   );
+  server.registerTool(
+    "feedback",
+    {
+      description: "Submit ERC-8004 ReputationRegistry feedback for a workflow execution this wallet paid for. Signs and broadcasts a giveFeedback() transaction on Ethereum mainnet via the KeeperHub server proxy. Caller wallet pays gas natively (~$0.05-2 per call at typical mainnet gas). Use AFTER call_workflow returns successfully and the user has confirmed they want to rate the workflow. The executionId comes from the call_workflow response. Defaults to rating KeeperHub's own ERC-8004 agent (id 31875 on Ethereum) but agentId/agentChainId may be overridden to rate any agent.",
+      inputSchema: submitFeedbackInputSchema
+    },
+    async (args) => await withToolLogging(
+      "feedback",
+      () => handleSubmitFeedback(args, deps)
+    )
+  );
   return server;
 }
 async function runMcpServer() {