cascrow-mcp 1.1.3 → 1.1.5

package/index.js

@@ -67,16 +67,26 @@ async function uploadProof(milestoneId, filename, content) {
   return data;
 }
 
+// Stream verify with 180s timeout to handle slow AI quorums
 async function streamVerify(proofId) {
-  const res = await fetch(`${BASE_URL}/api/verify`, {
-    method: "POST",
-    headers: {
-      "Authorization": `Bearer ${API_KEY}`,
-      "Content-Type": "application/json",
-      "Accept": "text/event-stream",
-    },
-    body: JSON.stringify({ proofId }),
-  });
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 180_000);
+
+  let res;
+  try {
+    res = await fetch(`${BASE_URL}/api/verify`, {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${API_KEY}`,
+        "Content-Type": "application/json",
+        "Accept": "text/event-stream",
+      },
+      body: JSON.stringify({ proofId }),
+      signal: controller.signal,
+    });
+  } finally {
+    clearTimeout(timeout);
+  }
 
   if (!res.ok) {
     const data = await res.json().catch(() => ({}));
@@ -88,36 +98,40 @@ async function streamVerify(proofId) {
   const decoder = new TextDecoder();
   let buffer = "";
 
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    buffer += decoder.decode(value, { stream: true });
-
-    const lines = buffer.split("\n");
-    buffer = lines.pop() ?? "";
-
-    for (const line of lines) {
-      if (!line.startsWith("data:")) continue;
-      const raw = line.slice(5).trim();
-      if (!raw) continue;
-      try {
-        const msg = JSON.parse(raw);
-        if (msg.type === "model_vote") {
-          votes.push(msg);
-          // Log each vote to stderr so Claude Desktop can show live progress
-          const icon = msg.decision === "YES" ? "✅" : "❌";
-          process.stderr.write(`[cascrow] ${icon} ${msg.model}: ${msg.decision} (${msg.confidence}%)\n`);
-        } else if (msg.type === "complete") {
-          return { ...msg, votes };
-        } else if (msg.type === "error") {
-          throw new Error(msg.message);
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+
+      const lines = buffer.split("\n");
+      buffer = lines.pop() ?? "";
+
+      for (const line of lines) {
+        if (!line.startsWith("data:")) continue;
+        const raw = line.slice(5).trim();
+        if (!raw) continue;
+        try {
+          const msg = JSON.parse(raw);
+          if (msg.type === "model_vote") {
+            votes.push(msg);
+            const icon = msg.decision === "YES" ? "✅" : "❌";
+            process.stderr.write(`[cascrow] ${icon} ${msg.model}: ${msg.decision} (${msg.confidence}%)\n`);
+          } else if (msg.type === "complete") {
+            return { ...msg, votes };
+          } else if (msg.type === "error") {
+            throw new Error(msg.message);
+          }
+        } catch (e) {
+          if (e instanceof SyntaxError) continue;
+          throw e;
         }
-      } catch (e) {
-        if (e instanceof SyntaxError) continue;
-        throw e;
       }
     }
+  } finally {
+    reader.cancel().catch(() => {});
   }
+
   throw new Error("Stream ended without a complete event");
 }
 
@@ -141,20 +155,20 @@ const TOOLS = [
           description: "List of milestones to verify",
           items: {
             type: "object",
-            required: ["title", "description", "deadlineDays"],
+            required: ["title", "deadlineDays"],
             properties: {
               title: {
                 type: "string",
-                description: "Short milestone title, e.g. 'Hero section with CTA'",
-              },
-              description: {
-                type: "string",
-                description: "Detailed acceptance criteria — what exactly must be true for this milestone to pass AI verification",
+                description: "Milestone title including acceptance criteria, e.g. 'Hero section with CTA — must be responsive down to 320px, LCP < 2s'",
               },
               deadlineDays: {
                 type: "number",
                 description: "Days from now until deadline (e.g. 7)",
               },
+              amountUSD: {
+                type: "number",
+                description: "Optional RLUSD amount to lock in escrow (e.g. 1.0). Omit or set to 0 for verification-only.",
+              },
             },
           },
         },
@@ -199,7 +213,9 @@ const TOOLS = [
       "Submit proof of completion for a milestone. " +
       "Write a detailed, specific proof report describing exactly what was built, " +
       "with verifiable evidence (URLs, metrics, specific implementation details). " +
-      "The more specific and verifiable the proof, the higher the AI confidence score.",
+      "The more specific and verifiable the proof, the higher the AI confidence score. " +
+      "NOTE: After submitting, the backend automatically triggers AI verification. " +
+      "You can call cascrow_verify afterwards to stream the live results.",
     inputSchema: {
       type: "object",
       required: ["milestoneId", "proof"],
@@ -219,10 +235,11 @@ const TOOLS = [
   {
     name: "cascrow_verify",
     description:
-      "Trigger AI verification for a submitted proof and wait for the result. " +
+      "Stream live AI verification results for a submitted proof. " +
       "5 AI models vote in parallel (Claude, GPT-4o, Gemini, Mistral, Cerebras). " +
-      "Returns decision (YES/NO), confidence score, reasoning, and action taken. " +
-      "Call this after cascrow_submit_proof.",
+      "Returns decision, confidence score, action (VERIFIED/PENDING_REVIEW/REJECTED), and per-model votes. " +
+      "Call this after cascrow_submit_proof to get live results. " +
+      "Confidence > 85 + YES = VERIFIED. Confidence 60–85 = PENDING_REVIEW (manual review needed). Confidence < 60 = REJECTED.",
     inputSchema: {
       type: "object",
       required: ["proofId"],
@@ -231,6 +248,17 @@ const TOOLS = [
       },
     },
   },
+  {
+    name: "cascrow_get_contract",
+    description: "Get the current status and details of a contract, including all milestones and their statuses.",
+    inputSchema: {
+      type: "object",
+      required: ["contractId"],
+      properties: {
+        contractId: { type: "string" },
+      },
+    },
+  },
   {
     name: "cascrow_join_contract",
     description:
@@ -248,17 +276,6 @@ const TOOLS = [
       },
     },
   },
-  {
-    name: "cascrow_get_contract",
-    description: "Get the current status and details of a contract, including all milestones.",
-    inputSchema: {
-      type: "object",
-      required: ["contractId"],
-      properties: {
-        contractId: { type: "string" },
-      },
-    },
-  },
   {
     name: "cascrow_handoff",
     description:
@@ -302,24 +319,28 @@ const TOOLS = [
 async function handleCreateContract({ milestones }) {
   const deadline = (days) => {
     const d = new Date();
-    d.setDate(d.getDate() + days);
+    d.setDate(d.getDate() + (days ?? 7));
     return d.toISOString();
   };
 
   const payload = {
     milestones: milestones.map((m) => ({
-      title: `${m.title} — ${m.description}`,
-      amountUSD: 0, // verification-only — $0.10 charged per verification trigger
-      cancelAfter: deadline(m.deadlineDays ?? 7),
+      title: m.title,
+      amountUSD: m.amountUSD ?? 0,
+      cancelAfter: deadline(m.deadlineDays),
     })),
   };
 
   const data = await apiPost("/api/contracts", payload);
   const contractUrl = `${BASE_URL}/contract/${data.contractId}`;
 
+  // API returns inviteLink — expose as both keys so callers can use either
+  const inviteCode = data.inviteLink ?? null;
+
   return {
     contractId: data.contractId,
-    inviteCode: data.inviteLink,
+    inviteCode,
+    inviteLink: inviteCode,
     contractUrl,
     milestoneCount: milestones.length,
     message: `Contract created with ${milestones.length} milestone(s). View it here: ${contractUrl}`,
@@ -357,7 +378,7 @@ async function handleSubmitProof({ milestoneId, proof, filename }) {
   );
   return {
     proofId: data.proofId,
-    message: `Proof submitted. Use cascrow_verify with proofId: ${data.proofId}`,
+    message: `Proof submitted (proofId: ${data.proofId}). AI verification has been triggered automatically. Call cascrow_verify with this proofId to stream the live results.`,
   };
 }
 
@@ -369,7 +390,10 @@ async function handleVerify({ proofId }) {
   const reasoning  = result.reasoning ?? "";
   const votes      = result.votes ?? [];
 
-  const passed = decision === "YES" && confidence >= 85;
+  // Mirror backend three-tier logic exactly:
+  // > 85 + YES = VERIFIED, 60–85 = PENDING_REVIEW, < 60 = REJECTED
+  const passed = action === "VERIFIED";
+  const pendingReview = action === "PENDING_REVIEW";
 
   const TOTAL_MODELS = 5;
   const yesCount = votes.filter((v) => v.decision === "YES").length;
@@ -380,26 +404,39 @@ async function handleVerify({ proofId }) {
     .join("\n");
   const failedNote = failedCount > 0 ? `\n  ⚠️ ${failedCount} model(s) failed to respond` : "";
   const voteHeader = votes.length > 0
-    ? `${yesCount}/${TOTAL_MODELS} models approved (${failedCount > 0 ? `${failedCount} failed` : "all responded"}):\n${voteSummary}${failedNote}\n\n`
+    ? `${yesCount}/${TOTAL_MODELS} models approved:\n${voteSummary}${failedNote}\n\n`
     : "";
 
+  let statusLine;
+  if (passed) {
+    statusLine = `✅ VERIFIED (${confidence}% confidence)`;
+  } else if (pendingReview) {
+    statusLine = `⏳ PENDING_REVIEW (${confidence}% confidence) — manual review required. Resubmit stronger proof or contact hello@cascrow.com.`;
+  } else {
+    statusLine = `❌ REJECTED (${confidence}% confidence) — resubmit with stronger proof.`;
+  }
+
   return {
     decision,
     confidence,
     action,
-    reasoning,
     passed,
+    pendingReview,
+    reasoning,
     totalModels: TOTAL_MODELS,
     modelsResponded: votes.length,
     modelsFailed: failedCount,
     txHash: result.txHash ?? null,
     modelVotes: votes.map((v) => ({ model: v.model, decision: v.decision, confidence: v.confidence })),
-    message: passed
-      ? `✅ VERIFIED — Cascrow consensus confidence: ${confidence}%\n\n${voteHeader}${reasoning.slice(0, 300)}`
-      : `❌ NOT VERIFIED — Cascrow consensus confidence: ${confidence}%\n\n${voteHeader}${reasoning.slice(0, 300)}`,
+    message: `${statusLine}\n\n${voteHeader}${reasoning.slice(0, 400)}`,
   };
 }
 
+async function handleGetContract({ contractId }) {
+  const data = await apiGet(`/api/contracts/${contractId}`);
+  return data;
+}
+
 async function handleJoinContract({ inviteCode }) {
   const data = await apiPost("/api/contracts/join", { inviteCode });
   return {
@@ -408,11 +445,6 @@ async function handleJoinContract({ inviteCode }) {
   };
 }
 
-async function handleGetContract({ contractId }) {
-  const data = await apiGet(`/api/contracts/${contractId}`);
-  return data;
-}
-
 async function handleHandoff({ inviteCode, builderAgentId, contractId, message }) {
   const data = await apiPost("/api/agent/handoff", { inviteCode, builderAgentId, contractId, message });
   return {
@@ -444,7 +476,7 @@ async function handleCheckInvites() {
 // ─── MCP Server ───────────────────────────────────────────────────────────────
 
 const server = new Server(
-  { name: "cascrow", version: "1.0.0" },
+  { name: "cascrow", version: "1.1.5" },
   { capabilities: { tools: {} } }
 );
 
@@ -458,36 +490,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   try {
     let result;
     switch (name) {
-      case "cascrow_create_contract":
-        result = await handleCreateContract(args);
-        break;
-      case "cascrow_fund_milestone":
-        result = await handleFundMilestone(args);
-        break;
-      case "cascrow_escrow_fund":
-        result = await handleEscrowFund(args);
-        break;
-      case "cascrow_submit_proof":
-        result = await handleSubmitProof(args);
-        break;
-      case "cascrow_verify":
-        result = await handleVerify(args);
-        break;
-      case "cascrow_join_contract":
-        result = await handleJoinContract(args);
-        break;
-      case "cascrow_get_contract":
-        result = await handleGetContract(args);
-        break;
-      case "cascrow_handoff":
-        result = await handleHandoff(args);
-        break;
-      case "cascrow_check_invites":
-        result = await handleCheckInvites();
-        break;
-      case "cascrow_get_agent_id":
-        result = await handleGetAgentId();
-        break;
+      case "cascrow_create_contract":  result = await handleCreateContract(args);  break;
+      case "cascrow_fund_milestone":   result = await handleFundMilestone(args);   break;
+      case "cascrow_escrow_fund":      result = await handleEscrowFund(args);      break;
+      case "cascrow_submit_proof":     result = await handleSubmitProof(args);     break;
+      case "cascrow_verify":           result = await handleVerify(args);          break;
+      case "cascrow_get_contract":     result = await handleGetContract(args);     break;
+      case "cascrow_join_contract":    result = await handleJoinContract(args);    break;
+      case "cascrow_handoff":          result = await handleHandoff(args);         break;
+      case "cascrow_check_invites":    result = await handleCheckInvites();        break;
+      case "cascrow_get_agent_id":     result = await handleGetAgentId();          break;
       default:
         throw new Error(`Unknown tool: ${name}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cascrow-mcp",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "MCP server for Cascrow — agentic escrow and verification",
   "type": "module",
   "main": "index.js",
@@ -11,6 +11,6 @@
     "start": "node index.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0"
+    "@modelcontextprotocol/sdk": "^1.15.0"
   }
 }