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

package/dist/index.d.cts

@@ -285,7 +285,7 @@ declare function runtimeInstallCapabilities(runtime: string | undefined, env?: N
     restartRequired: boolean;
 };
 
-declare const CONNECTOR_VERSION = "0.1.23-alpha.2";
+declare const CONNECTOR_VERSION = "0.1.25-alpha.0";
 interface ConnectOptions {
     setupToken: string;
     apiBaseUrl: string;
@@ -402,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.2";
+    readonly mcpVersion: "0.1.25-alpha.0";
     readonly sdkPackage: "@haven_ai/sdk";
-    readonly sdkVersion: "0.1.23-alpha.2";
+    readonly sdkVersion: "0.1.25-alpha.0";
     readonly signerPackage: "@haven_ai/signer";
-    readonly signerVersion: "0.1.23-alpha.2";
+    readonly signerVersion: "0.1.25-alpha.0";
     readonly minimumNodeVersion: "22.0.0";
     readonly supportedClients: readonly ["codex-cli", "codex-desktop", "claude-code"];
     readonly requiredTools: readonly string[];

package/dist/index.d.ts

@@ -285,7 +285,7 @@ declare function runtimeInstallCapabilities(runtime: string | undefined, env?: N
     restartRequired: boolean;
 };
 
-declare const CONNECTOR_VERSION = "0.1.23-alpha.2";
+declare const CONNECTOR_VERSION = "0.1.25-alpha.0";
 interface ConnectOptions {
     setupToken: string;
     apiBaseUrl: string;
@@ -402,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.2";
+    readonly mcpVersion: "0.1.25-alpha.0";
     readonly sdkPackage: "@haven_ai/sdk";
-    readonly sdkVersion: "0.1.23-alpha.2";
+    readonly sdkVersion: "0.1.25-alpha.0";
     readonly signerPackage: "@haven_ai/signer";
-    readonly signerVersion: "0.1.23-alpha.2";
+    readonly signerVersion: "0.1.25-alpha.0";
     readonly minimumNodeVersion: "22.0.0";
     readonly supportedClients: readonly ["codex-cli", "codex-desktop", "claude-code"];
     readonly requiredTools: readonly string[];

package/dist/index.js

@@ -1,4 +1,4 @@
-import { HAVEN_MINIMUM_NODE_VERSION, isSupportedNodeVersion, unsupportedNodeVersionMessage, SKILL_FOLDER_NAME, HAVEN_SKILL_MD, resolveTokenFromAddress } from '@haven_ai/sdk';
+import { HAVEN_MINIMUM_NODE_VERSION, isSupportedNodeVersion, unsupportedNodeVersionMessage, SKILL_FOLDER_NAME, resolveTokenFromAddress, HAVEN_SKILL_MD, HAVEN_SKILL_BODY_MD } from '@haven_ai/sdk';
 import crypto from 'crypto';
 import { Wallet } from 'ethers';
 import { mkdir, rm, chmod, access, writeFile, readFile, unlink } from 'fs/promises';
@@ -245,9 +245,9 @@ var MCP_RUNTIME_MANIFEST = {
   mcpPackage: "@haven_ai/mcp",
   mcpVersion: MCP_VERSION,
   sdkPackage: "@haven_ai/sdk",
-  sdkVersion: "0.1.23-alpha.2",
+  sdkVersion: "0.1.25-alpha.0",
   signerPackage: "@haven_ai/signer",
-  signerVersion: "0.1.23-alpha.2",
+  signerVersion: "0.1.25-alpha.0",
   // 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
@@ -1402,6 +1402,109 @@ async function assertFileExists2(path, label) {
     throw new Error(`Missing ${label}: ${path}`);
   }
 }
+var CODEX_AGENTS_BEGIN_MARKER = "<!-- BEGIN haven-pay (managed by @haven_ai/connect; edits inside this section are overwritten on re-setup) -->";
+var CODEX_AGENTS_END_MARKER = "<!-- END haven-pay -->";
+async function installSkillForRuntime(runtime, deps = {}) {
+  switch (runtime) {
+    case "claude-code":
+      return installSkillFile(
+        resolve(deps.homeDir ?? homedir(), ".claude", "skills", SKILL_FOLDER_NAME),
+        "~/.claude/skills/haven-pay"
+      );
+    case "hermes":
+      return installSkillFile(
+        join(hermesHome(deps), "skills", SKILL_FOLDER_NAME),
+        "the Hermes skills folder"
+      );
+    case "codex-cli":
+    case "codex-desktop":
+      return installCodexAgentsSection(deps);
+    default:
+      return void 0;
+  }
+}
+async function installSkillFile(skillDir, label) {
+  try {
+    await mkdir(skillDir, { recursive: true });
+    const target = join(skillDir, "SKILL.md");
+    await writeFile(target, HAVEN_SKILL_MD, "utf8");
+    return {
+      installed: true,
+      target,
+      messages: [`Installed the generic Haven payment skill (${label}). It contains no secrets.`]
+    };
+  } catch (err) {
+    return {
+      installed: false,
+      messages: [
+        `Could not install the Haven payment skill: ${err instanceof Error ? err.message : String(err)}. Download it from the Haven dashboard instead.`
+      ]
+    };
+  }
+}
+async function installCodexAgentsSection(deps) {
+  try {
+    const codexDir = resolve(deps.homeDir ?? homedir(), ".codex");
+    const target = join(codexDir, "AGENTS.md");
+    await mkdir(codexDir, { recursive: true });
+    const existing = await readFile(target, "utf8").catch(() => null);
+    const next = upsertManagedSection(existing, codexManagedSection());
+    if (next !== existing) {
+      await writeFile(target, next, "utf8");
+    }
+    return {
+      installed: true,
+      target,
+      messages: [
+        "Installed the generic Haven payment guidance as a managed section in ~/.codex/AGENTS.md (Codex reads it as global instructions). It contains no secrets; your own content in that file is untouched."
+      ]
+    };
+  } catch (err) {
+    return {
+      installed: false,
+      messages: [
+        `Could not install the Haven payment guidance into ~/.codex/AGENTS.md: ${err instanceof Error ? err.message : String(err)}. Download the skill from the Haven dashboard instead.`
+      ]
+    };
+  }
+}
+function codexManagedSection() {
+  return `${CODEX_AGENTS_BEGIN_MARKER}
+
+${HAVEN_SKILL_BODY_MD.trimEnd()}
+
+${CODEX_AGENTS_END_MARKER}
+`;
+}
+function upsertManagedSection(existing, section) {
+  if (existing === null || existing.trim() === "") return section;
+  const begins = markerLineIndexes(existing, CODEX_AGENTS_BEGIN_MARKER);
+  const ends = markerLineIndexes(existing, CODEX_AGENTS_END_MARKER);
+  if (begins.length === 1 && ends.length === 1 && ends[0] > begins[0]) {
+    const afterEnd = ends[0] + CODEX_AGENTS_END_MARKER.length;
+    const tail = existing.startsWith("\r\n", afterEnd) ? existing.slice(afterEnd + 2) : existing.startsWith("\n", afterEnd) ? existing.slice(afterEnd + 1) : existing.slice(afterEnd);
+    return existing.slice(0, begins[0]) + section + tail;
+  }
+  if (begins.length > 0 || ends.length > 0) {
+    throw new Error(
+      "found a damaged Haven marker section (orphaned or duplicated markers); remove the leftover marker lines and re-run setup"
+    );
+  }
+  return `${existing.replace(/\n*$/, "\n\n")}${section}`;
+}
+function markerLineIndexes(text, marker) {
+  const indexes = [];
+  for (let from = 0; ; ) {
+    const at = text.indexOf(marker, from);
+    if (at === -1) return indexes;
+    if (at === 0 || text[at - 1] === "\n") indexes.push(at);
+    from = at + marker.length;
+  }
+}
+function hermesHome(deps) {
+  const env = deps.env ?? process.env;
+  return env.HERMES_HOME ?? join(deps.homeDir ?? homedir(), ".hermes");
+}
 
 // src/runtime-registry.ts
 var RUNTIME_PROFILES = {
@@ -1713,7 +1816,7 @@ async function installRuntime(input, deps = {}) {
   const errorCode = configResult.errorCode ?? (configResult.runtimeMcpMode === "local_stdio" ? localMcpErrorCode(signerCredentialReady, localMcpConsent, localMcpProbe?.status) : hostedMcpErrorCode(configResult.hostedConfigured, hostedProbe.status) ?? signerConsentErrorCode(signerCredentialReady, signerConsent));
   const hostedProbeMessages = configResult.hostedConfigured && hostedProbe.status !== "ok" ? [`Hosted Haven MCP probe failed: ${hostedProbe.status}.`] : configResult.hostedConfigured ? ["Verified hosted Haven MCP tools with a read-only handshake."] : [];
   const localProbeMessages = localMcpProbe && localMcpProbe.status !== "ok" ? [`Local Haven MCP handshake failed: ${localMcpProbe.status}.`] : localMcpProbe?.status === "ok" ? ["Verified local Haven MCP tools with a stdio handshake."] : [];
-  const skillInstall = runtime === "claude-code" && !configResult.errorCode ? await installClaudeSkill(deps.homeDir) : void 0;
+  const skillInstall = !configResult.errorCode ? await installSkillForRuntime(runtime, { homeDir: deps.homeDir, env: deps.env }) : void 0;
   return {
     runtime,
     runtimeMcpMode: configResult.runtimeMcpMode,
@@ -1837,22 +1940,6 @@ async function configureClaudeCodeHosted(deps, input, signerCommand) {
 async function defaultRunCommand(command, args) {
   await execFileAsync3(command, args, { timeout: 1e4 });
 }
-async function installClaudeSkill(homeDir) {
-  try {
-    const skillDir = resolve(homeDir ?? homedir(), ".claude", "skills", SKILL_FOLDER_NAME);
-    await mkdir(skillDir, { recursive: true });
-    await writeFile(join(skillDir, "SKILL.md"), HAVEN_SKILL_MD, "utf8");
-    return {
-      installed: true,
-      messages: ["Installed the generic Haven payment skill (~/.claude/skills/haven-pay). It contains no secrets."]
-    };
-  } catch (err) {
-    return {
-      installed: false,
-      messages: [`Could not install the Haven payment skill: ${err instanceof Error ? err.message : String(err)}. Download it from the Haven dashboard instead.`]
-    };
-  }
-}
 function buildProbeResult(mode, hostedConfigured, hostedStatus, signerReady, localMcpReady, localMcpProbeStatus) {
   if (mode === "local_stdio") {
     if (localMcpReady) return "local_stdio_mcp_ready";
@@ -1946,7 +2033,7 @@ function localRuntimePrepareErrorCode(err) {
 }
 
 // src/runtime.ts
-var CONNECTOR_VERSION = "0.1.23-alpha.2";
+var CONNECTOR_VERSION = "0.1.25-alpha.0";
 var CONNECT_OUTCOME_SCHEMA_VERSION = 1;
 async function runConnect(options, deps = {}) {
   assertSupportedNodeVersion(deps.nodeVersion, MCP_RUNTIME_MANIFEST.minimumNodeVersion);
@@ -2209,9 +2296,11 @@ function formatAtomicAmount(atomic, decimals) {
 }
 function describeResetPeriod(resetPeriodMin) {
   if (resetPeriodMin === 1440) return "per day";
+  if (resetPeriodMin === 10080) return "per week";
+  if (resetPeriodMin === 43200) return "per month";
   if (resetPeriodMin === 60) return "per hour";
-  if (resetPeriodMin === 0) return "with no automatic reset";
-  return `per ${resetPeriodMin} minutes`;
+  if (resetPeriodMin === 0) return "in total";
+  return `every ${resetPeriodMin} minutes`;
 }
 function describeApprovedBudget(budget) {
   const token = resolveTokenFromAddress(budget.token_address);