@haven_ai/connect 0.1.23-alpha.0 → 0.1.23-alpha.2

package/dist/index.d.cts

@@ -4,6 +4,23 @@ interface ConnectApiClient {
     resolveSetup(input: ResolveSetupInput): Promise<ResolvedSetup>;
     registerSetup(input: RegisterSetupInput): Promise<RegisterSetupResponse>;
     updateInstallStatus(setupId: string, apiKey: string, input: UpdateInstallStatusInput): Promise<void>;
+    /**
+     * #1377 D: the narrow status read the connector polls after registering,
+     * authenticated with the agent API key it just minted (works while the
+     * agent is still `setup_pending` — the endpoint exists for exactly that
+     * window). Returns status plus the approved budget once approval lands;
+     * never any secret material.
+     */
+    getConnectorStatus(setupId: string, apiKey: string): Promise<ConnectorStatusResponse>;
+}
+interface ConnectorStatusResponse {
+    status: string;
+    approved_budget: {
+        token_symbol: string;
+        token_address: string;
+        amount: string;
+        reset_period_min: number;
+    } | null;
 }
 interface ResolveSetupInput {
     setupToken: string;
@@ -268,7 +285,7 @@ declare function runtimeInstallCapabilities(runtime: string | undefined, env?: N
     restartRequired: boolean;
 };
 
-declare const CONNECTOR_VERSION = "0.1.23-alpha.0";
+declare const CONNECTOR_VERSION = "0.1.23-alpha.2";
 interface ConnectOptions {
     setupToken: string;
     apiBaseUrl: string;
@@ -279,6 +296,14 @@ interface ConnectOptions {
     ackSigner?: boolean;
     ackLocalTools?: boolean;
     localMcp?: boolean;
+    /**
+     * #1377 D: keep the process alive after registering and poll for the
+     * user's budget approval (default). Set false for structured/automation
+     * runs (--json) where prompt output emission matters more than narration.
+     */
+    waitForApproval?: boolean;
+    /** Test/injection overrides for the approval poll cadence and clock. */
+    approvalWait?: ApprovalWaitOptions;
 }
 /** The stable machine-readable result emitted by `haven-connect --json`. */
 declare const CONNECT_OUTCOME_SCHEMA_VERSION: 1;
@@ -349,6 +374,20 @@ declare function completionOutcome(input: {
  * filesystem detail, while this public contract must remain safe to serialize.
  */
 declare function failedConnectOutcome(runtimeHint: string | undefined, error: unknown): ConnectOutcome;
+/**
+ * #1377 D: after registering, the connector no longer goes dead while the
+ * user approves in Haven — it polls the narrow connector-status endpoint
+ * (agent-API-key auth, works during `setup_pending`) and narrates progress in
+ * the flow's voice, ending in a concrete celebration naming the granted
+ * authority. Bounds (stated per the issue): poll every 5 s, give up after
+ * 3 minutes — the connector ALWAYS terminates on its own; a timeout is a
+ * clean exit with guidance, never a hang. Injectable clock/cadence for tests.
+ */
+interface ApprovalWaitOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}
 
 interface ParsedCli {
     options: ConnectOptions;
@@ -363,11 +402,11 @@ declare function shortAddress(address: string): string;
 
 declare const MCP_RUNTIME_MANIFEST: {
     readonly mcpPackage: "@haven_ai/mcp";
-    readonly mcpVersion: "0.1.23-alpha.0";
+    readonly mcpVersion: "0.1.23-alpha.2";
     readonly sdkPackage: "@haven_ai/sdk";
-    readonly sdkVersion: "0.1.23-alpha.0";
+    readonly sdkVersion: "0.1.23-alpha.2";
     readonly signerPackage: "@haven_ai/signer";
-    readonly signerVersion: "0.1.23-alpha.0";
+    readonly signerVersion: "0.1.23-alpha.2";
     readonly minimumNodeVersion: "22.0.0";
     readonly supportedClients: readonly ["codex-cli", "codex-desktop", "claude-code"];
     readonly requiredTools: readonly string[];

package/dist/index.d.ts

@@ -4,6 +4,23 @@ interface ConnectApiClient {
     resolveSetup(input: ResolveSetupInput): Promise<ResolvedSetup>;
     registerSetup(input: RegisterSetupInput): Promise<RegisterSetupResponse>;
     updateInstallStatus(setupId: string, apiKey: string, input: UpdateInstallStatusInput): Promise<void>;
+    /**
+     * #1377 D: the narrow status read the connector polls after registering,
+     * authenticated with the agent API key it just minted (works while the
+     * agent is still `setup_pending` — the endpoint exists for exactly that
+     * window). Returns status plus the approved budget once approval lands;
+     * never any secret material.
+     */
+    getConnectorStatus(setupId: string, apiKey: string): Promise<ConnectorStatusResponse>;
+}
+interface ConnectorStatusResponse {
+    status: string;
+    approved_budget: {
+        token_symbol: string;
+        token_address: string;
+        amount: string;
+        reset_period_min: number;
+    } | null;
 }
 interface ResolveSetupInput {
     setupToken: string;
@@ -268,7 +285,7 @@ declare function runtimeInstallCapabilities(runtime: string | undefined, env?: N
     restartRequired: boolean;
 };
 
-declare const CONNECTOR_VERSION = "0.1.23-alpha.0";
+declare const CONNECTOR_VERSION = "0.1.23-alpha.2";
 interface ConnectOptions {
     setupToken: string;
     apiBaseUrl: string;
@@ -279,6 +296,14 @@ interface ConnectOptions {
     ackSigner?: boolean;
     ackLocalTools?: boolean;
     localMcp?: boolean;
+    /**
+     * #1377 D: keep the process alive after registering and poll for the
+     * user's budget approval (default). Set false for structured/automation
+     * runs (--json) where prompt output emission matters more than narration.
+     */
+    waitForApproval?: boolean;
+    /** Test/injection overrides for the approval poll cadence and clock. */
+    approvalWait?: ApprovalWaitOptions;
 }
 /** The stable machine-readable result emitted by `haven-connect --json`. */
 declare const CONNECT_OUTCOME_SCHEMA_VERSION: 1;
@@ -349,6 +374,20 @@ declare function completionOutcome(input: {
  * filesystem detail, while this public contract must remain safe to serialize.
  */
 declare function failedConnectOutcome(runtimeHint: string | undefined, error: unknown): ConnectOutcome;
+/**
+ * #1377 D: after registering, the connector no longer goes dead while the
+ * user approves in Haven — it polls the narrow connector-status endpoint
+ * (agent-API-key auth, works during `setup_pending`) and narrates progress in
+ * the flow's voice, ending in a concrete celebration naming the granted
+ * authority. Bounds (stated per the issue): poll every 5 s, give up after
+ * 3 minutes — the connector ALWAYS terminates on its own; a timeout is a
+ * clean exit with guidance, never a hang. Injectable clock/cadence for tests.
+ */
+interface ApprovalWaitOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}
 
 interface ParsedCli {
     options: ConnectOptions;
@@ -363,11 +402,11 @@ declare function shortAddress(address: string): string;
 
 declare const MCP_RUNTIME_MANIFEST: {
     readonly mcpPackage: "@haven_ai/mcp";
-    readonly mcpVersion: "0.1.23-alpha.0";
+    readonly mcpVersion: "0.1.23-alpha.2";
     readonly sdkPackage: "@haven_ai/sdk";
-    readonly sdkVersion: "0.1.23-alpha.0";
+    readonly sdkVersion: "0.1.23-alpha.2";
     readonly signerPackage: "@haven_ai/signer";
-    readonly signerVersion: "0.1.23-alpha.0";
+    readonly signerVersion: "0.1.23-alpha.2";
     readonly minimumNodeVersion: "22.0.0";
     readonly supportedClients: readonly ["codex-cli", "codex-desktop", "claude-code"];
     readonly requiredTools: readonly string[];

package/dist/index.js

@@ -1,3 +1,4 @@
+import { HAVEN_MINIMUM_NODE_VERSION, isSupportedNodeVersion, unsupportedNodeVersionMessage, SKILL_FOLDER_NAME, HAVEN_SKILL_MD, resolveTokenFromAddress } from '@haven_ai/sdk';
 import crypto from 'crypto';
 import { Wallet } from 'ethers';
 import { mkdir, rm, chmod, access, writeFile, readFile, unlink } from 'fs/promises';
@@ -7,9 +8,9 @@ import { execFile, spawn } from 'child_process';
 import { promisify } from 'util';
 import { parseDocument, isMap, stringify } from 'yaml';
 import { registeredToolNames, MCP_VERSION, ensureConsent, computeConsentHash, loadCredentials, consentInputFromClient } from '@haven_ai/mcp';
-import { HAVEN_MINIMUM_NODE_VERSION, isSupportedNodeVersion, unsupportedNodeVersionMessage, SKILL_FOLDER_NAME, HAVEN_SKILL_MD } from '@haven_ai/sdk';
 import { ensureSignerConsent, computeSignerConsentHash, loadSignerCredentials, createEdgeSigner, toolSchemas } from '@haven_ai/signer';
-import { pathToFileURL } from 'url';
+import { realpathSync } from 'fs';
+import { fileURLToPath, pathToFileURL } from 'url';
 
 // src/api.ts
 function createConnectApiClient(baseUrl, fetchImpl = fetch) {
@@ -41,6 +42,10 @@ function createConnectApiClient(baseUrl, fetchImpl = fetch) {
         }
       })
     }),
+    getConnectorStatus: (setupId, apiKey) => request(fetchImpl, `${root}/agent-connection-setups/${encodeURIComponent(setupId)}/connector-status`, {
+      method: "GET",
+      headers: { Authorization: `Bearer ${apiKey}` }
+    }),
     updateInstallStatus: async (setupId, apiKey, input) => {
       await request(fetchImpl, `${root}/agent-connection-setups/${encodeURIComponent(setupId)}/install-status`, {
         method: "POST",
@@ -67,6 +72,14 @@ function createConnectApiClient(baseUrl, fetchImpl = fetch) {
     }
   };
 }
+var ConnectRequestError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "ConnectRequestError";
+  }
+  status;
+};
 async function request(fetchImpl, url, init) {
   const response = await fetchImpl(url, {
     ...init,
@@ -79,7 +92,7 @@ async function request(fetchImpl, url, init) {
   const body = text ? JSON.parse(text) : null;
   if (!response.ok) {
     const message = body?.error ?? body?.message ?? `${response.status} ${response.statusText}`;
-    throw new Error(`Haven setup request failed: ${message}`);
+    throw new ConnectRequestError(`Haven setup request failed: ${message}`, response.status);
   }
   return body;
 }
@@ -232,9 +245,9 @@ var MCP_RUNTIME_MANIFEST = {
   mcpPackage: "@haven_ai/mcp",
   mcpVersion: MCP_VERSION,
   sdkPackage: "@haven_ai/sdk",
-  sdkVersion: "0.1.23-alpha.0",
+  sdkVersion: "0.1.23-alpha.2",
   signerPackage: "@haven_ai/signer",
-  signerVersion: "0.1.23-alpha.0",
+  signerVersion: "0.1.23-alpha.2",
   // Sourced from the SDK, never a literal (#1161). This field read '20.0.0'
   // while every package's `engines` said `>=24` and the docs said `>=24.0.0`,
   // so the guard that was supposed to enforce the floor waved Node v23 through
@@ -1933,7 +1946,7 @@ function localRuntimePrepareErrorCode(err) {
 }
 
 // src/runtime.ts
-var CONNECTOR_VERSION = "0.1.23-alpha.0";
+var CONNECTOR_VERSION = "0.1.23-alpha.2";
 var CONNECT_OUTCOME_SCHEMA_VERSION = 1;
 async function runConnect(options, deps = {}) {
   assertSupportedNodeVersion(deps.nodeVersion, MCP_RUNTIME_MANIFEST.minimumNodeVersion);
@@ -2047,7 +2060,6 @@ async function runConnect(options, deps = {}) {
   } else {
     log("Haven setup on this machine is complete.");
   }
-  printNextSteps(runtimeInstall, log);
   try {
     await api.updateInstallStatus(registration.setup_id, localApiKey, {
       runtime: runtimeInstall.runtime,
@@ -2070,6 +2082,10 @@ async function runConnect(options, deps = {}) {
   } catch (err) {
     log(`Could not report install status to Haven: ${err instanceof Error ? err.message : String(err)}`);
   }
+  if (options.waitForApproval !== false && !runtimeInstall.errorCode) {
+    await waitForBudgetApproval(api, registration.setup_id, localApiKey, log, options.approvalWait);
+  }
+  printNextSteps(runtimeInstall, log);
   return {
     setupId: registration.setup_id,
     agentId: registration.agent_id,
@@ -2185,6 +2201,61 @@ function printRuntimeInstall(result, log) {
     log("Local Haven signer still needs runtime setup.");
   }
 }
+function formatAtomicAmount(atomic, decimals) {
+  const s = atomic.toString().padStart(decimals + 1, "0");
+  const intPart = s.slice(0, s.length - decimals) || "0";
+  const fracPart = s.slice(s.length - decimals).replace(/0+$/, "");
+  return fracPart ? `${intPart}.${fracPart}` : intPart;
+}
+function describeResetPeriod(resetPeriodMin) {
+  if (resetPeriodMin === 1440) return "per day";
+  if (resetPeriodMin === 60) return "per hour";
+  if (resetPeriodMin === 0) return "with no automatic reset";
+  return `per ${resetPeriodMin} minutes`;
+}
+function describeApprovedBudget(budget) {
+  const token = resolveTokenFromAddress(budget.token_address);
+  const amount = token ? `${formatAtomicAmount(BigInt(budget.amount), token.decimals)} ${budget.token_symbol}` : `${budget.amount} ${budget.token_symbol} (atomic units)`;
+  return `${amount} ${describeResetPeriod(budget.reset_period_min)}`;
+}
+async function waitForBudgetApproval(api, setupId, apiKey, log, options = {}) {
+  const intervalMs = options.intervalMs ?? 5e3;
+  const timeoutMs = options.timeoutMs ?? 18e4;
+  const sleep = options.sleep ?? ((ms) => new Promise((resolve8) => setTimeout(resolve8, ms)));
+  const maxPolls = Math.max(1, Math.floor(timeoutMs / intervalMs));
+  const remindEvery = Math.max(1, Math.floor(3e4 / intervalMs));
+  log("Registered with Haven \u2014 waiting for you to approve the budget in the dashboard\u2026");
+  for (let i = 0; i < maxPolls; i++) {
+    await sleep(intervalMs);
+    let status;
+    try {
+      status = await api.getConnectorStatus(setupId, apiKey);
+    } catch (err) {
+      if (err instanceof ConnectRequestError && (err.status === 401 || err.status === 404)) {
+        log("This setup ended in Haven \u2014 start a fresh connection from the dashboard when ready.");
+        return "ended";
+      }
+      continue;
+    }
+    if (status.status === "active") {
+      log(
+        status.approved_budget ? `Budget approved \u{1F389} \u2014 I can now spend up to ${describeApprovedBudget(status.approved_budget)} from your Haven wallet.` : "Budget approved \u{1F389} \u2014 the agent can now spend within its Haven rules."
+      );
+      return "approved";
+    }
+    if (status.status === "cancelled" || status.status === "expired" || status.status === "failed") {
+      log(`This setup ended in Haven (${status.status}) \u2014 start a fresh connection from the dashboard when ready.`);
+      return "ended";
+    }
+    if ((i + 1) % remindEvery === 0) {
+      log("Still waiting for budget approval in Haven\u2026");
+    }
+  }
+  log(
+    "Budget approval is still pending in Haven. Approve it in the dashboard whenever you are ready \u2014 the agent tools unlock the moment you do. Verify later with the read-only haven_get_agent tool."
+  );
+  return "pending";
+}
 function completionHandoffLines(result) {
   if (result.errorCode === "manual_runtime_setup_required") {
     return [
@@ -2319,11 +2390,14 @@ async function runCli(argv, io = {
     return 0;
   }
   try {
-    const result = await runConnect(parsed.options, {
-      log: (message) => (parsed.json ? io.stderr : io.stdout)(`${message}
+    const result = await runConnect(
+      { ...parsed.options, waitForApproval: !parsed.json },
+      {
+        log: (message) => (parsed.json ? io.stderr : io.stdout)(`${message}
 `),
-      redactPaths: parsed.json
-    });
+        redactPaths: parsed.json
+      }
+    );
     if (parsed.json) io.stdout(`${JSON.stringify(result.outcome)}
 `);
     return 0;
@@ -2342,7 +2416,15 @@ async function main() {
   const exitCode = await runCli(process.argv.slice(2));
   if (exitCode !== 0) process.exitCode = exitCode;
 }
-if (process.argv[1] && pathToFileURL(process.argv[1]).href === import.meta.url) void main();
+function isCliEntrypoint(argvPath = process.argv[1], moduleUrl = import.meta.url) {
+  if (!argvPath) return false;
+  try {
+    return realpathSync(argvPath) === realpathSync(fileURLToPath(moduleUrl));
+  } catch {
+    return pathToFileURL(argvPath).href === moduleUrl;
+  }
+}
+if (isCliEntrypoint()) void main();
 
 export { CONNECTOR_VERSION, CONNECT_OUTCOME_SCHEMA_VERSION, MCP_RUNTIME_MANIFEST, completionOutcome, createConnectApiClient, defaultAgentDirectory, delegateKeyFromPrivateKey, failedConnectOutcome, generateDelegateKey, helpText, installRuntime, mcpPackageSpec, normalizeRuntime, parseArgs, prepareSignerRuntime, redactSecrets, runCli, runConnect, runtimeInstallCapabilities, runtimeProfile, sdkPackageSpec, shortAddress, signerPackageSpec, writeCredentialFiles };
 //# sourceMappingURL=index.js.map