@haven_ai/mcp 0.7.0-alpha.0 → 0.8.0-alpha.0

package/dist/index.d.cts

@@ -66,7 +66,7 @@ declare function loadCredentials(source?: string | HavenCredentialSource | undef
  * which is where URL-hardening would matter.)
  */
 
-type HavenMcpToolName = 'haven_send' | 'haven_pay_mcp_tool' | 'haven_quote_x402' | 'haven_pay_x402_quote' | 'haven_pay_x402' | 'haven_resume_x402_payment' | 'haven_get_payment_status' | 'haven_get_resume_state' | 'haven_get_agent' | 'haven_get_allowances' | 'haven_list_receipts' | 'haven_verify_receipt' | 'haven_sweep_delegate' | 'haven_discover_tools' | 'haven_submit_catalog_entry' | 'haven_open_task_budget' | 'haven_close_task_budget' | 'haven_submit';
+type HavenMcpToolName = 'haven_send' | 'haven_pay_mcp_tool' | 'haven_quote_x402' | 'haven_pay_x402_quote' | 'haven_pay_x402' | 'haven_resume_x402_payment' | 'haven_get_payment_status' | 'haven_get_resume_state' | 'haven_get_agent' | 'haven_get_allowances' | 'haven_list_receipts' | 'haven_verify_receipt' | 'haven_sweep_delegate' | 'haven_discover_tools' | 'haven_submit_catalog_entry' | 'haven_open_task_budget' | 'haven_close_task_budget' | 'haven_get_task_budget' | 'haven_submit';
 declare const toolSchemas: {
     readonly haven_send: {
         readonly asset: z.ZodEnum<["ETH", "USDC"]>;
@@ -167,8 +167,12 @@ declare const toolSchemas: {
     readonly haven_close_task_budget: {
         readonly task_budget_id: z.ZodString;
     };
+    readonly haven_get_task_budget: {
+        readonly task_budget_id: z.ZodString;
+    };
     readonly haven_submit: {
         readonly task_budget_id: z.ZodOptional<z.ZodString>;
+        readonly sub_budget_id: z.ZodOptional<z.ZodString>;
         readonly payment_id: z.ZodOptional<z.ZodString>;
         readonly signature: z.ZodString;
     };
@@ -407,7 +411,7 @@ declare function createHavenMcpServer(options?: HavenMcpServerOptions): Promise<
  * `agent_tool_invocations` rows are always attributed to the right tool.
  */
 declare const MCP_NAME = "@haven_ai/mcp";
-declare const MCP_VERSION = "0.7.0-alpha.0";
+declare const MCP_VERSION = "0.8.0-alpha.0";
 /**
  * Refuse to start on an unsupported Node (#1161).
  *

package/dist/index.d.ts

@@ -66,7 +66,7 @@ declare function loadCredentials(source?: string | HavenCredentialSource | undef
  * which is where URL-hardening would matter.)
  */
 
-type HavenMcpToolName = 'haven_send' | 'haven_pay_mcp_tool' | 'haven_quote_x402' | 'haven_pay_x402_quote' | 'haven_pay_x402' | 'haven_resume_x402_payment' | 'haven_get_payment_status' | 'haven_get_resume_state' | 'haven_get_agent' | 'haven_get_allowances' | 'haven_list_receipts' | 'haven_verify_receipt' | 'haven_sweep_delegate' | 'haven_discover_tools' | 'haven_submit_catalog_entry' | 'haven_open_task_budget' | 'haven_close_task_budget' | 'haven_submit';
+type HavenMcpToolName = 'haven_send' | 'haven_pay_mcp_tool' | 'haven_quote_x402' | 'haven_pay_x402_quote' | 'haven_pay_x402' | 'haven_resume_x402_payment' | 'haven_get_payment_status' | 'haven_get_resume_state' | 'haven_get_agent' | 'haven_get_allowances' | 'haven_list_receipts' | 'haven_verify_receipt' | 'haven_sweep_delegate' | 'haven_discover_tools' | 'haven_submit_catalog_entry' | 'haven_open_task_budget' | 'haven_close_task_budget' | 'haven_get_task_budget' | 'haven_submit';
 declare const toolSchemas: {
     readonly haven_send: {
         readonly asset: z.ZodEnum<["ETH", "USDC"]>;
@@ -167,8 +167,12 @@ declare const toolSchemas: {
     readonly haven_close_task_budget: {
         readonly task_budget_id: z.ZodString;
     };
+    readonly haven_get_task_budget: {
+        readonly task_budget_id: z.ZodString;
+    };
     readonly haven_submit: {
         readonly task_budget_id: z.ZodOptional<z.ZodString>;
+        readonly sub_budget_id: z.ZodOptional<z.ZodString>;
         readonly payment_id: z.ZodOptional<z.ZodString>;
         readonly signature: z.ZodString;
     };
@@ -407,7 +411,7 @@ declare function createHavenMcpServer(options?: HavenMcpServerOptions): Promise<
  * `agent_tool_invocations` rows are always attributed to the right tool.
  */
 declare const MCP_NAME = "@haven_ai/mcp";
-declare const MCP_VERSION = "0.7.0-alpha.0";
+declare const MCP_VERSION = "0.8.0-alpha.0";
 /**
  * Refuse to start on an unsupported Node (#1161).
  *

package/dist/index.js

@@ -351,12 +351,19 @@ var toolSchemas = {
   haven_close_task_budget: {
     task_budget_id: z.string().min(1)
   },
-  // #3329: relays a signature from the local signer — either the open/close
-  // signature for a task budget, or (schema parity with the hosted surface)
-  // a direct-payment signature by payment_id. Exactly one of task_budget_id /
-  // payment_id, never both or neither.
+  // #3518: read ONE task budget by id, any status — the status check a close
+  // refusal's "re-check the budget's status" points at, on the local surface
+  // too (schema and wording parity with the hosted read).
+  haven_get_task_budget: {
+    task_budget_id: z.string().min(1)
+  },
+  // #3329 / #3506: relays a signature from the local signer — the open/close
+  // signature for a task budget or a sub-budget row, or (schema parity with
+  // the hosted surface) a direct-payment signature by payment_id. Exactly one
+  // of task_budget_id / sub_budget_id / payment_id, never two or none.
   haven_submit: {
     task_budget_id: z.string().min(1).optional(),
+    sub_budget_id: z.string().min(1).optional(),
     payment_id: z.string().min(1).optional(),
     signature: z.string().regex(/^0x[0-9a-fA-F]+$/, "signature must be a 0x-prefixed hex string")
   }
@@ -384,11 +391,19 @@ var CLOSE_TASK_BUDGET_DESCRIPTION = [
   "the signature with haven_submit. A task budget past its own deadline closes immediately, the",
   "same as the pending case."
 ].join(" ");
+var GET_TASK_BUDGET_DESCRIPTION = [
+  "Read one task budget by id, any status.",
+  "Returns { task_budget } with status (pending | open | closing | closed), isExpired, maxDisplay, recipientAddress, label and expiresAt \u2014",
+  "the check to run after a close or submit refusal says to re-check the budget's status.",
+  "haven_get_agent lists live task budgets only; this reads any one, closed or expired included."
+].join(" ");
 var SUBMIT_DESCRIPTION = [
   "Relay a signature from the local signer. Pass exactly one of task_budget_id (from",
-  "haven_open_task_budget or haven_close_task_budget) or payment_id \u2014 never both, never neither \u2014",
-  "plus signature. For a task budget this opens or closes it on-chain and returns { task_budget,",
-  'status }; a close in progress may return { task_budget, status: "closed", close_tx_hash }.'
+  "haven_open_task_budget or haven_close_task_budget), sub_budget_id (from haven_get_agent",
+  "pendingSubBudgetSignatures[]) or payment_id \u2014 never two, never none \u2014 plus signature.",
+  "For a task budget this opens or closes it on-chain and returns { task_budget,",
+  'status }; a close in progress may return { task_budget, status: "closed", close_tx_hash }.',
+  "A sub_budget_id returns { sub_budget, status } with the next signer step, if one is owed."
 ].join(" ");
 var toolDescriptions = {
   haven_send: composeDescription(toolDescriptions$1.send),
@@ -408,8 +423,101 @@ var toolDescriptions = {
   haven_verify_receipt: composeDescription(toolDescriptions$1.verifyReceipt),
   haven_open_task_budget: OPEN_TASK_BUDGET_DESCRIPTION,
   haven_close_task_budget: CLOSE_TASK_BUDGET_DESCRIPTION,
+  haven_get_task_budget: GET_TASK_BUDGET_DESCRIPTION,
   haven_submit: SUBMIT_DESCRIPTION
 };
+function subBudgetSignStep(subBudgetId) {
+  return {
+    next_action: "sign",
+    next_tool: "mcp__haven-signer__haven_sign",
+    next_arguments: { sub_budget_id: subBudgetId }
+  };
+}
+async function submitSubBudgetTool(haven, subBudgetId, signature) {
+  let result;
+  try {
+    result = await haven.submitSubBudget(subBudgetId, signature);
+  } catch (err) {
+    const code = err instanceof HavenApiError ? err.body?.error_code : void 0;
+    if (code === "close_needs_reprepare") {
+      let fresh;
+      try {
+        fresh = await haven.closeSubBudget(subBudgetId);
+      } catch (closeErr) {
+        return normalizeError(closeErr);
+      }
+      if (fresh.status === "closed") {
+        return {
+          success: true,
+          data: {
+            sub_budget: fresh.subBudget,
+            status: "closed",
+            next_action: "none",
+            next_tool_omitted_reason: "the sub-budget is closed on-chain; nothing further to sign or submit for it"
+          }
+        };
+      }
+      return {
+        success: false,
+        code: "CLOSE_NEEDS_REPREPARE",
+        message: "The stored close operation for this sub-budget was stale, so nothing was relayed. Haven prepared a fresh one: sign it with haven_sign, then call haven_submit again with the new signature.",
+        statusCode: 409,
+        ...subBudgetSignStep(subBudgetId)
+      };
+    }
+    if (code === "close_outcome_unconfirmed") {
+      return {
+        success: false,
+        code: "CLOSE_OUTCOME_UNCONFIRMED",
+        message: "The close operation was sent but its outcome is not confirmed yet (on Base that can take tens of minutes). Wait, then call haven_submit again with the same arguments: it reports closed once the chain has finalised the disable, or prepares a fresh operation to sign if the earlier one did not land.",
+        statusCode: 502,
+        next_action: "check_status_later",
+        next_tool: "haven_submit",
+        next_arguments: { sub_budget_id: subBudgetId, signature }
+      };
+    }
+    return normalizeError(err);
+  }
+  return runTool(async () => {
+    const submitted = {
+      sub_budget: result.subBudget,
+      status: result.status,
+      ...result.closeTxHash !== void 0 ? { close_tx_hash: result.closeTxHash } : {}
+    };
+    if (result.status === "closed") {
+      return {
+        ...submitted,
+        next_action: "none",
+        next_tool_omitted_reason: "the sub-budget is closed on-chain; nothing further to sign or submit for it"
+      };
+    }
+    let pending;
+    try {
+      pending = await haven.listPendingSubBudgetSignatures();
+    } catch {
+      pending = null;
+    }
+    if (pending === null) {
+      return {
+        ...submitted,
+        next_action: "check_status_later",
+        next_tool: "haven_get_agent",
+        next_arguments: {},
+        reason: "This sub-budget row is open, but Haven could not say whether its tree has another row awaiting your signature. Call haven_get_agent and sign any pendingSubBudgetSignatures row."
+      };
+    }
+    const tree = result.subBudget.parentSubBudgetId ?? result.subBudget.id;
+    const sibling = pending.find(
+      (row) => row.purpose === "open" && row.subBudgetId !== result.subBudget.id && (row.parentSubBudgetId ?? row.subBudgetId) === tree
+    );
+    if (sibling) return { ...submitted, ...subBudgetSignStep(sibling.subBudgetId) };
+    return {
+      ...submitted,
+      next_action: "none",
+      next_tool_omitted_reason: "no other row of this sub-budget awaits your signature, so the sub-budget is fully open and the sub-agent can spend through its grant"
+    };
+  });
+}
 function createToolHandlers(haven) {
   return {
     haven_send: async (input) => {
@@ -565,7 +673,17 @@ function createToolHandlers(haven) {
       const args = objectInput("haven_get_resume_state", input);
       return runTool(async () => haven.getResumeState(args.payment_id));
     },
-    haven_get_agent: async () => runTool(async () => haven.getAgentSummary()),
+    haven_get_agent: async () => runTool(async () => {
+      const summary = await haven.getAgentSummary();
+      if (!Array.isArray(summary.pendingSubBudgetSignatures)) return summary;
+      return {
+        ...summary,
+        pendingSubBudgetSignatures: summary.pendingSubBudgetSignatures.map((row) => ({
+          ...row,
+          ...subBudgetSignStep(row.subBudgetId)
+        }))
+      };
+    }),
     haven_get_allowances: async () => runTool(async () => haven.getAllowances()),
     haven_sweep_delegate: async () => runTool(async () => haven.sweepDelegate()),
     haven_discover_tools: async (input) => {
@@ -692,17 +810,32 @@ function createToolHandlers(haven) {
         };
       });
     },
+    // #3518: read ONE task budget by id, any status — the status check a
+    // close/submit refusal's "re-check the budget's status" points at. The
+    // SDK relays `GET /task-budgets/:id` (the backend route answers any
+    // status) and a 404 carries the backend's own message through runTool.
+    haven_get_task_budget: async (input) => {
+      const args = objectInput("haven_get_task_budget", input);
+      return runTool(async () => {
+        const taskBudget = await haven.getTaskBudget(args.task_budget_id);
+        return { task_budget: taskBudget };
+      });
+    },
     haven_submit: async (input) => {
       const args = objectInput("haven_submit", input);
       const hasTaskBudget = typeof args.task_budget_id === "string" && args.task_budget_id.length > 0;
+      const hasSubBudget = typeof args.sub_budget_id === "string" && args.sub_budget_id.length > 0;
       const hasPayment = typeof args.payment_id === "string" && args.payment_id.length > 0;
-      if (hasTaskBudget === hasPayment) {
+      if ([hasTaskBudget, hasSubBudget, hasPayment].filter(Boolean).length !== 1) {
         return {
           success: false,
           code: "INVALID_INPUT",
-          message: "haven_submit takes exactly one of task_budget_id or payment_id, never both or neither. Nothing was relayed."
+          message: "haven_submit takes exactly one of payment_id, task_budget_id or sub_budget_id, never two or none. Nothing was relayed."
         };
       }
+      if (hasSubBudget) {
+        return submitSubBudgetTool(haven, args.sub_budget_id, args.signature);
+      }
       return runTool(async () => {
         if (hasTaskBudget) {
           const result = await haven.submitTaskBudget(args.task_budget_id, args.signature);
@@ -713,7 +846,7 @@ function createToolHandlers(haven) {
           };
         }
         throw new HavenApiError(
-          "haven_submit with payment_id is not supported on the local MCP surface: haven_send signs and submits a direct payment in one call, so there is no separate relay step. Use haven_submit with task_budget_id to relay a task-budget open/close signature.",
+          "haven_submit with payment_id is not supported on the local MCP surface: haven_send signs and submits a direct payment in one call, so there is no separate relay step. Use haven_submit with task_budget_id or sub_budget_id to relay a budget open/close signature.",
           400
         );
       });
@@ -1153,7 +1286,7 @@ async function createHavenMcpServer(options = {}) {
   return buildMcpServer(haven);
 }
 var MCP_NAME = "@haven_ai/mcp";
-var MCP_VERSION = "0.7.0-alpha.0";
+var MCP_VERSION = "0.8.0-alpha.0";
 var MCP_INSTRUCTIONS = [
   "Haven local MCP server: signs in-process with the delegate key it holds on",
   "this machine \u2014 the key never leaves this process. Call haven_get_agent",