@suveren/gateway 0.36.1 → 0.37.0

package/content/integrations/erp.json

@@ -6,7 +6,7 @@
   "icon": "briefcase",
   "profile": "sales",
   "npmPackage": "@humanagencyp/erp-mcp",
-  "npmVersion": "0.9.4",
+  "npmVersion": "0.9.5",
   "mcp": {
     "command": "erp-mcp",
     "args": [],

package/dist/mcp-server/http.mjs

@@ -4801,6 +4801,15 @@ async function readPreview(integrationManager2, integrationId, previewTool, args
     };
   }
 }
+function unavailableReadMessage(integrationManager2, read, connector, tool, declaredAt) {
+  if (read.reason === "no_connector") {
+    const running = integrationManager2.getAllTools().some((t) => t.integrationId === connector);
+    if (running) {
+      return `Connector "${connector}" is running but has no tool "${tool}" (declared in ${declaredAt}) \u2014 the installed connector version does not offer it.`;
+    }
+  }
+  return read.message ?? `Connector "${connector}" could not be reached.`;
+}
 function hashPreviewBody(body) {
   if (body.structured !== void 0) {
     return computeContentHash({ kind: "jcs", version: "1" }, body.structured);
@@ -5461,7 +5470,8 @@ async function resolveDocumentReference(integrationManager2, ref) {
     return { ok: false, error: { code: "NOT_FOUND", message: read.message ?? `No document "${ref.kind}"/"${ref.id}" on "${ref.connector}".` } };
   }
   if (read.status !== "ok") {
-    return { ok: false, error: { code: "UNAVAILABLE", message: read.message ?? `Connector "${ref.connector}" could not be reached.` } };
+    const message = unavailableReadMessage(integrationManager2, read, ref.connector, docConfig.tool, `documents.${ref.kind}`);
+    return { ok: false, error: { code: "UNAVAILABLE", message } };
   }
   const body = structuredOrJsonText(read.body);
   if (!body || typeof body !== "object") {
@@ -5542,7 +5552,8 @@ async function resolveInsertValue(integrationManager2, ref) {
     return { ok: false, error: { code: "NOT_FOUND", message: read.message ?? `No value "${ref.kind}"/"${ref.id}" on "${ref.connector}".` } };
   }
   if (read.status !== "ok") {
-    return { ok: false, error: { code: "UNAVAILABLE", message: read.message ?? `Connector "${ref.connector}" could not be reached.` } };
+    const message = unavailableReadMessage(integrationManager2, read, ref.connector, valueConfig.tool, `values.${ref.kind}`);
+    return { ok: false, error: { code: "UNAVAILABLE", message } };
   }
   const body = structuredOrJsonText(read.body);
   if (!body || typeof body !== "object") {
@@ -6829,7 +6840,9 @@ function createGatedToolHandlerInner(tool, integrationManager2, state2) {
             content: [{
               type: "text",
               text: `Awaiting commitment from domain${auth.deferredCommitmentDomains.length > 1 ? "s" : ""} "${auth.deferredCommitmentDomains.join('", "')}" for tool ${tool.originalName}.
-Proposal ID: ${proposal.id}. Check status with check-pending-commitments(proposal_id: "${proposal.id}").` + await unreadableForNote(unreadableFor ?? [], state2)
+Proposal ID: ${proposal.id}. Check status with check-pending-commitments(proposal_id: "${proposal.id}").` + await unreadableForNote(unreadableFor ?? [], state2) + // Optional wait (2026-10-19): the AI can stay on the line instead of ending its turn.
+              `
+Tell the person what you proposed and that it waits for their approval in the gateway; then you may wait for the decision: check-pending-commitments(proposal_id: "${proposal.id}", wait_seconds: 50).`
             }]
           };
         } catch (err) {
@@ -8043,6 +8056,18 @@ Reason: ${detail}` : "";
     isError: false
   };
 }
+var MAX_WAIT_SECONDS = 50;
+var WAIT_POLL_MS = 2e3;
+async function getProposalWaiting(get, id, waitSeconds, sleep2 = (ms) => new Promise((r) => setTimeout(r, ms)), now = Date.now) {
+  const waitMs = Math.min(Math.max(Number(waitSeconds) || 0, 0), MAX_WAIT_SECONDS) * 1e3;
+  const deadline = now() + waitMs;
+  let match = await get(id);
+  while (match && match.status === "pending" && now() < deadline) {
+    await sleep2(Math.min(WAIT_POLL_MS, deadline - now()));
+    match = await get(id);
+  }
+  return match;
+}
 function checkPendingCommitmentsHandler(state2, integrationManager2) {
   return async (args) => {
     if (!state2.spClient.isUnlocked()) {
@@ -8050,7 +8075,11 @@ function checkPendingCommitmentsHandler(state2, integrationManager2) {
     }
     try {
       if (args.proposal_id) {
-        const match = await state2.spClient.getProposalById(args.proposal_id);
+        const match = await getProposalWaiting(
+          (id) => state2.spClient.getProposalById(id),
+          args.proposal_id,
+          args.wait_seconds
+        );
         if (!match) {
           return {
             content: [{
@@ -8304,9 +8333,10 @@ function createMcpServer(state2, integrationManager2) {
   server.registerTool(
     "check-pending-commitments",
     {
-      description: "Check status of pending proposals awaiting domain owner commitment. Call with a proposal_id to check a specific proposal, or without to see all.",
+      description: "Check status of pending proposals awaiting domain owner commitment. Call with a proposal_id to check a specific proposal, or without to see all. With a proposal_id you may also pass wait_seconds (max 50): the gateway then waits until the person decides and answers at once \u2014 first tell the person what you proposed and that it waits for their approval in the gateway.",
       inputSchema: {
-        proposal_id: z2.string().optional().describe("Specific proposal ID to check. Omit to see all.")
+        proposal_id: z2.string().optional().describe("Specific proposal ID to check. Omit to see all."),
+        wait_seconds: z2.number().int().min(0).max(50).optional().describe("Only with proposal_id: wait up to this many seconds (max 50) while the proposal is still pending; answers as soon as the person decides. Omit or 0 to answer at once.")
       }
     },
     withOutcomeOutbox(checkPendingCommitmentsHandler(state2, integrationManager2))
@@ -10497,7 +10527,7 @@ function unifiedLineDiff(before, after) {
 }
 
 // src/lib/builtins/setup.ts
-import { getProfile as getProfile9 } from "@hap/core";
+import { getProfile as getProfile9, listProfiles } from "@hap/core";
 var DELEGATION_PROFILE = "delegation";
 var DELEGATION_INTENT_HINT = [
   "Why \u2014 With test data only, I want to find out which routine parts of my work an AI could take over, so people gain time \u2014 before anything touches real systems.",
@@ -10541,10 +10571,28 @@ function shortName(idOrName) {
 function versionOf(id) {
   return id.split("@")[1] ?? "";
 }
-function delegationItselfRefusal(args) {
-  const requested = typeof args.profile === "string" ? args.profile : "";
-  if (shortName(requested) === DELEGATION_PROFILE) {
-    return "Delegation can never be proposed \u2014 the AI cannot widen its own delegation.";
+var MANDATE_ACTION = "mandate";
+function knownVersions(short) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const key of listProfiles()) {
+    if (shortName(key) !== short) continue;
+    const p = getProfile9(key);
+    if (p) byId.set(p.id, p);
+  }
+  return [...byId.values()];
+}
+function proposalTargetRefusal(args) {
+  const requested = typeof args.profile === "string" ? shortName(args.profile.trim()) : "";
+  const versions = requested ? knownVersions(requested) : [];
+  if (versions.length === 0) {
+    return { code: "UNKNOWN_PROFILE", message: `Unknown profile "${requested}" \u2014 not in this gateway's profile catalog.` };
+  }
+  if (versions.some((p) => p.boundsSchema?.actionTypes?.includes(MANDATE_ACTION))) {
+    const name = versions.map((p) => p.name).find(Boolean) ?? requested;
+    return {
+      code: "DELEGATION_NOT_PROPOSABLE",
+      message: `${name} can never be proposed \u2014 it lets an AI propose mandates, and the AI cannot widen its own delegation.`
+    };
   }
   return void 0;
 }
@@ -10711,7 +10759,7 @@ function setupBuiltin(deps) {
         },
         create_mandate: {
           executionMapping: { profile: "allowed_profiles", mode: "allowed_modes" },
-          staticExecution: { action_type: "mandate" },
+          staticExecution: { action_type: MANDATE_ACTION },
           actionLabel: "Mandate proposed",
           hideUnlessAuthorized: true,
           // Shown like the mandate screen: limits and scope by the profile's own names.
@@ -10800,7 +10848,7 @@ ${body}`);
         description: "Propose a new mandate for the person running this gateway \u2014 the authority another tool needs (e.g. sales quotes up to a value). Always goes to the person's current workspace (their team, or Personal if they are not in one) \u2014 there is no way to name a different one. A person approves or rejects the proposal; only after approval is the mandate created, exactly as if they had signed it on the mandate screen. Checked against the profile before the proposal: unknown limits, a mode the profile does not allow, or a team where the person may not give this mandate are refused at once. Outside simulation mode, the profile and mode you may propose are themselves limited by your Delegation mandate's scope \u2014 Delegation itself can never be proposed. Create only.",
         inputSchema: CREATE_MANDATE_INPUT_SCHEMA,
         validate: async (args) => {
-          const fixed = delegationItselfRefusal(args);
+          const fixed = proposalTargetRefusal(args);
           if (fixed) {
             deps.state.denialLog?.record({
               ts: Date.now(),
@@ -10808,18 +10856,18 @@ ${body}`);
               integrationId: "setup",
               profile: DELEGATION_PROFILE,
               kind: "bound",
-              detail: fixed,
+              detail: fixed.message,
               who: "gateway",
-              code: "DELEGATION_NOT_PROPOSABLE"
+              code: fixed.code
             });
-            return fixed;
+            return fixed.message;
           }
           const check = await controlPlaneMandate(true, mandateRequest(args));
           return check.ok ? void 0 : check.message;
         },
         handler: async (args) => {
-          const fixed = delegationItselfRefusal(args);
-          if (fixed) return { ...builtinText(`Refused: ${fixed}`), isError: true };
+          const fixed = proposalTargetRefusal(args);
+          if (fixed) return { ...builtinText(`Refused: ${fixed.message}`), isError: true };
           const r = await controlPlaneMandate(false, mandateRequest(args));
           if (!r.ok) return { ...builtinText(`Refused: ${r.message}`), isError: true };
           return builtinText(