@haven_ai/sdk 0.0.0-dev.202609180817.b16be14 → 0.0.0-dev.202609181540.08a5f50

package/dist/index.cjs

@@ -4738,8 +4738,10 @@ the \`mcp__haven-signer__\` namespace and keep the delegate key on this machine.
 That namespacing is Claude-family; other runtimes name the servers by their
 own config keys (Codex: \`haven\`, \`haven_signer\`). Tool results carry the
 exact next step (\`next_action\`, \`next_tool\`, \`next_arguments\`, plus the
-runtime-neutral \`next_tool_server\` + \`next_tool_name\` \u2014 the bare tool name
-on that logical server, whatever your runtime calls it).
+runtime-neutral \`next_tool_server\` + \`next_tool_name\` + \`next_tool_server_role\`
+\u2014 the bare tool name on that logical server, whatever your runtime calls it).
+When no tool follows, \`next_tool\` is absent and \`next_tool_omitted_reason\`
+says why; that is a complete answer.
 Follow those fields first; the prose below is fallback and orientation, not
 the source of truth.
 
@@ -4954,8 +4956,10 @@ check on in-flight payments. Do not poll in a tight loop.
 ## Failure handling
 
 Haven tool failures are shaped like \`{ success: false, code, message, ... }\`
-or older \`{ error, status, details? }\` responses. Branch on \`code\` when
-present and surface \`message\` or \`error\` verbatim. Common cases:
+or older \`{ error, status, details? }\` responses. A failure carries the same
+\`next_action\` / \`next_tool\` / \`next_arguments\` / \`next_tool_omitted_reason\`
+fields a success does; follow them first, then branch on \`code\` and surface
+\`message\` or \`error\` verbatim. Common cases:
 
 - \`insufficient_funds\`: the Haven wallet doesn't hold enough of that token.
   Suggest the user add funds in the Haven dashboard.
@@ -5016,6 +5020,64 @@ for that credential.
 var SKILL_FOLDER_NAME = "haven-pay";
 var HAVEN_SKILL_BODY_MD = HAVEN_SKILL_MD.replace(/^---\n[\s\S]*?\n---\n+/, "");
 
+// src/next-step.ts
+var NEXT_TOOL_SERVER_NAMES = {
+  hosted: "haven",
+  signer: "haven-signer"
+};
+var NEXT_TOOL_SERVER_ROLES = {
+  haven: "hosted",
+  "haven-signer": "signer"
+};
+function renderNextTool(role, name) {
+  return `mcp__${NEXT_TOOL_SERVER_NAMES[role]}__${name}`;
+}
+function parseNextTool(literal) {
+  const m = /^mcp__([a-z0-9-]+)__([a-z0-9_]+)$/.exec(literal);
+  if (!m) return null;
+  const role = NEXT_TOOL_SERVER_ROLES[m[1]];
+  return { server: m[1], name: m[2], ...role ? { role } : {} };
+}
+var DEFAULT_NEXT_TOOL_BY_ACTION = {
+  check_status_later: "haven_get_payment_status",
+  sweep_stranded_funds: "haven_sweep_delegate"
+  // `retry_original_x402_request` is NOT here: its only live emitter
+  // (state-direct-recovery.ts, erc7710) names no tool on purpose — the retry
+  // is the agent's own HTTP call — so a default would contradict the site.
+};
+function defaultNextToolFor(action) {
+  return DEFAULT_NEXT_TOOL_BY_ACTION[action];
+}
+function createNextStepBuilder(targets) {
+  return function nextStep(input) {
+    const i = input;
+    const base = {
+      next_action: input.nextAction,
+      safe_to_continue: input.safeToContinue,
+      reason: input.reason
+    };
+    if (i.nextTool === null) {
+      return { ...base, next_tool_omitted_reason: i.nextToolOmittedReason ?? "no next tool" };
+    }
+    const target = targets[i.nextTool];
+    if (!target) {
+      return { ...base, next_tool_omitted_reason: `${i.nextTool} is not a registered next-step target` };
+    }
+    const problem = target.validate(i.nextArguments);
+    if (problem) {
+      return { ...base, next_tool_omitted_reason: `next_arguments do not parse under ${i.nextTool}: ${problem}` };
+    }
+    return {
+      ...base,
+      next_tool: renderNextTool(target.role, i.nextTool),
+      next_tool_server: NEXT_TOOL_SERVER_NAMES[target.role],
+      next_tool_name: i.nextTool,
+      next_tool_server_role: target.role,
+      next_arguments: i.nextArguments
+    };
+  };
+}
+
 // src/node-version.ts
 var HAVEN_MINIMUM_NODE_VERSION = "22.0.0";
 function parseNodeVersion(value) {
@@ -5128,6 +5190,7 @@ exports.AgentPaymentRailSchema = AgentPaymentRailSchema;
 exports.AgentPaymentWarningCode = AgentPaymentWarningCode;
 exports.CONNECTOR_PACKAGE_NAME = CONNECTOR_PACKAGE_NAME;
 exports.DEFAULT_CONFIRMATION_TIMEOUT_MS = DEFAULT_CONFIRMATION_TIMEOUT_MS;
+exports.DEFAULT_NEXT_TOOL_BY_ACTION = DEFAULT_NEXT_TOOL_BY_ACTION;
 exports.DISCOVERY_MAX_BYTES = DISCOVERY_MAX_BYTES;
 exports.ERC7710_ASSET_TRANSFER_METHOD = ERC7710_ASSET_TRANSFER_METHOD;
 exports.HAVEN_AGENT_RUNBOOK_MD = HAVEN_AGENT_RUNBOOK_MD;
@@ -5147,6 +5210,8 @@ exports.HavenZeroSettlementHashError = HavenZeroSettlementHashError;
 exports.INSECURE_RETRY_TARGET_CODE = INSECURE_RETRY_TARGET_CODE;
 exports.MERCHANT_DISCOVERY_PATHS = MERCHANT_DISCOVERY_PATHS;
 exports.MerchantTimeoutError = MerchantTimeoutError;
+exports.NEXT_TOOL_SERVER_NAMES = NEXT_TOOL_SERVER_NAMES;
+exports.NEXT_TOOL_SERVER_ROLES = NEXT_TOOL_SERVER_ROLES;
 exports.RECEIPT_VERSION = RECEIPT_VERSION;
 exports.SIGNER_UPDATE_FALLBACK = SIGNER_UPDATE_FALLBACK;
 exports.SKILL_FOLDER_NAME = SKILL_FOLDER_NAME;
@@ -5175,8 +5240,10 @@ exports.compareNodeVersions = compareNodeVersions;
 exports.composeDescription = composeDescription;
 exports.connectorRerunCommand = connectorRerunCommand;
 exports.connectorSpec = connectorSpec;
+exports.createNextStepBuilder = createNextStepBuilder;
 exports.decodeBase64Json = decodeBase64Json;
 exports.decodeBase64Utf8 = decodeBase64Utf8;
+exports.defaultNextToolFor = defaultNextToolFor;
 exports.discoverMerchantMcpUrl = discoverMerchantMcpUrl;
 exports.encodeBase64Json = encodeBase64Json;
 exports.encodeBase64Utf8 = encodeBase64Utf8;
@@ -5189,9 +5256,11 @@ exports.isSupportedNodeVersion = isSupportedNodeVersion;
 exports.isSweepableChain = isSweepableChain;
 exports.isZeroSettlementTxHash = isZeroSettlementTxHash;
 exports.normalizePaymentRequired = normalizePaymentRequired;
+exports.parseNextTool = parseNextTool;
 exports.parsePaymentRequired = parsePaymentRequired;
 exports.parsePaymentRequiredResponse = parsePaymentRequiredResponse;
 exports.readX402ReceiptPayer = readX402ReceiptPayer;
+exports.renderNextTool = renderNextTool;
 exports.resolveConnectorChannel = resolveConnectorChannel;
 exports.resolveTokenFromAddress = resolveTokenFromAddress;
 exports.resolveX402RetryTarget = resolveX402RetryTarget;