treewide: rename blue-agent-connect → blue-js-sdk/ai-path

The agent-facing SDK is published as 'blue-js-sdk', with the AI-path surface
exported from 'blue-js-sdk/ai-path'. The old 'blue-agent-connect' name does
not exist on npm — every agent that copy-pasted our examples got
MODULE_NOT_FOUND. This commit aligns the live runtime with the docs that
were just shipped.

Surface area:
- README.md, MANIFESTO.md, server/README.md  — public-facing examples
- server/src/sentinel.ts                      — provisioning response
                                                 'instructions' field
- fresh-test/test-ai-agent.mjs                — live E2E test that imports
                                                 the SDK by name
- server/test/test-agent-connect.mjs          — header comment

server/test/test-fresh-agent.mjs is also updated to drop the now-unneeded
ETH gas funding step (EIP-3009 means the agent's EVM key never broadcasts).

Deprecated 'sdk/' directory and the E2E-TEST-RESULTS.txt log artifact are
left untouched (per CLAUDE.md, sdk/ is unpublished legacy).

Author: Sentinel-Bluebuilder

MANIFESTO.md

@@ -152,7 +152,7 @@ To compete, someone would need: a working decentralized VPN network (years to bu
 ```typescript
 import { x402Client, wrapFetchWithPayment } from '@x402/fetch';
 import { ExactEvmScheme } from '@x402/evm/exact/client';
-import { createWallet, connect } from 'blue-agent-connect';
+import { createWallet, connect } from 'blue-js-sdk/ai-path';
 
 // 1. Sentinel wallet (one-time — persist the mnemonic)
 const wallet = await createWallet();
@@ -220,7 +220,7 @@ This is a flywheel. Every agent that connects makes the network more valuable fo
 | **Live** | Self-hosted facilitator (`server/src/facilitator.ts`) — no Coinbase dependency required |
 | **Live** | Subscription pool manager — handles 8-allocation-per-sub chain limit |
 | **Live** | Fee-grant flow — agent's `MsgStartSession` pays zero gas |
-| **Live** | Reference agent example using `@x402/fetch` + `blue-agent-connect` |
+| **Live** | Reference agent example using `@x402/fetch` + `blue-js-sdk/ai-path` |
 | **Pending** | Solana support (code written, env wiring not enabled) |
 | **Pending** | MCP server — Claude/GPT/Gemini tool integration |
 
@@ -229,7 +229,7 @@ This is a flywheel. Every agent that connects makes the network more valuable fo
 - Fee grant module
 - MsgShareSubscription
 - blue-js-sdk (Sentinel chain operations)
-- blue-agent-connect (WireGuard + V2Ray E2E)
+- blue-js-sdk/ai-path (WireGuard + V2Ray E2E)
 - Node tester (Sentinel nodes validated)
 - P2P treasury (funded)
 

README.md

@@ -9,7 +9,7 @@ One HTTP request. No KYC. No accounts. No P2P tokens. No custom contract to depl
 ```typescript
 import { x402Client, wrapFetchWithPayment } from '@x402/fetch';
 import { ExactEvmScheme } from '@x402/evm/exact/client';
-import { createWallet, connect } from 'blue-agent-connect';
+import { createWallet, connect } from 'blue-js-sdk/ai-path';
 
 const wallet = await createWallet();
 
@@ -121,7 +121,7 @@ You need:
 ### Connect as an agent
 
 ```bash
-npm install @x402/fetch @x402/evm blue-agent-connect viem
+npm install @x402/fetch @x402/evm blue-js-sdk viem
 ```
 
 ```typescript
@@ -130,7 +130,7 @@ import { ExactEvmScheme } from '@x402/evm/exact/client';
 import { createWalletClient, http } from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';
 import { base } from 'viem/chains';
-import { createWallet, connect, disconnect } from 'blue-agent-connect';
+import { createWallet, connect, disconnect } from 'blue-js-sdk/ai-path';
 
 // 1. Sentinel wallet (one-time — persist the mnemonic)
 const wallet = await createWallet();

fresh-test/test-ai-agent.mjs

@@ -7,7 +7,7 @@
  *
  * The page says (Managed Plan flow):
  *   1. npm install @x402/fetch @x402/evm blue-js-sdk viem
- *   2. Create Sentinel wallet via createWallet() from blue-agent-connect
+ *   2. Create Sentinel wallet via createWallet() from blue-js-sdk/ai-path
  *   3. Set up x402Client + ExactEvmScheme + wrapFetchWithPayment
  *   4. POST /vpn/connect/1day with { sentinelAddr }
  *   5. connect({ mnemonic, nodeAddress: provision.nodeAddress, subscriptionId, feeGranter })
@@ -116,7 +116,7 @@ console.log('\n--- PHASE 2: PACKAGE INSTALL ---\n');
 // Page says: npm install @x402/fetch @x402/evm blue-js-sdk viem
 // Verify all packages are importable
 let installOk = true;
-const requiredPackages = ['@x402/fetch', '@x402/evm/exact/client', 'blue-agent-connect', 'viem'];
+const requiredPackages = ['@x402/fetch', '@x402/evm/exact/client', 'blue-js-sdk/ai-path', 'viem'];
 
 for (const pkg of requiredPackages) {
   try {
@@ -141,9 +141,9 @@ console.log('\n--- PHASE 3: WALLET CREATION ---\n');
 let sentWallet;
 let evmWallet;
 
-// Page says: import { createWallet } from 'blue-agent-connect'
+// Page says: import { createWallet } from 'blue-js-sdk/ai-path'
 try {
-  const { createWallet } = await import('blue-agent-connect');
+  const { createWallet } = await import('blue-js-sdk/ai-path');
   sentWallet = await createWallet();
   note('Wallet', `Sentinel wallet created: ${sentWallet.address}`);
   if (sentWallet.mnemonic) note('Wallet', 'Mnemonic returned — agent can persist it');
@@ -269,7 +269,7 @@ try {
   if (provision.instructions) note('Payment', `Instructions present: "${provision.instructions.slice(0, 80)}..."`);
   else note('Payment', 'MISSING instructions — agent has no guidance for next step', 5);
 
-  // Verify instructions reference blue-agent-connect (not old packages)
+  // Verify instructions reference blue-js-sdk/ai-path (not old packages)
   if (provision.instructions && provision.instructions.includes('sentinel-ai-connect')) {
     note('Payment', 'Instructions reference deprecated sentinel-ai-connect package', 3);
   }
@@ -291,15 +291,15 @@ console.log('\n--- PHASE 6: VPN CONNECTION ---\n');
 
 let connect, disconnect, status;
 
-// Page says: import { connect, disconnect } from 'blue-agent-connect'
+// Page says: import { connect, disconnect } from 'blue-js-sdk/ai-path'
 try {
-  const agentConnect = await import('blue-agent-connect');
+  const agentConnect = await import('blue-js-sdk/ai-path');
   connect = agentConnect.connect;
   disconnect = agentConnect.disconnect;
   status = agentConnect.status;
-  note('Connect', 'Imported connect/disconnect from blue-agent-connect');
+  note('Connect', 'Imported connect/disconnect from blue-js-sdk/ai-path');
 } catch (err) {
-  note('Connect', `Cannot import from blue-agent-connect: ${err.message}`, 10);
+  note('Connect', `Cannot import from blue-js-sdk/ai-path: ${err.message}`, 10);
   writeResults();
   process.exit(1);
 }

server/README.md

@@ -105,7 +105,7 @@ Response (after payment):
   "sentinelTxHash": "ABC123...",
   "expiresAt": "2026-04-15T18:50:48Z",
   "operatorAddress": "0xCC689D...",
-  "instructions": "import { connect } from 'blue-agent-connect'; await connect({ mnemonic, subscriptionId: 1192288, feeGranter: 'sent12e03...' })"
+  "instructions": "import { connect } from 'blue-js-sdk/ai-path'; await connect({ mnemonic, subscriptionId: 1192288, feeGranter: 'sent12e03...' })"
 }
 ```
 

server/src/sentinel.ts

@@ -254,7 +254,7 @@ export async function provisionAgent(
           sentinelTxHash: result.transactionHash,
           expiresAt: expirationDate.toISOString(),
           operatorAddress,
-          instructions: `import { connect } from 'blue-agent-connect'; await connect({ mnemonic, nodeAddress: '${recommended}', subscriptionId: '${slot.id}', feeGranter: '${operatorAddress}' })`,
+          instructions: `import { connect } from 'blue-js-sdk/ai-path'; await connect({ mnemonic, nodeAddress: '${recommended}', subscriptionId: '${slot.id}', feeGranter: '${operatorAddress}' })`,
         };
       }
 
@@ -313,7 +313,7 @@ export async function provisionAgent(
     sentinelTxHash: result.transactionHash,
     expiresAt: expirationDate.toISOString(),
     operatorAddress,
-    instructions: `import { connect } from 'blue-agent-connect'; await connect({ mnemonic, nodeAddress: '${recommended}', subscriptionId: '${subscriptionId}', feeGranter: '${operatorAddress}' })`,
+    instructions: `import { connect } from 'blue-js-sdk/ai-path'; await connect({ mnemonic, nodeAddress: '${recommended}', subscriptionId: '${subscriptionId}', feeGranter: '${operatorAddress}' })`,
   };
 }
 

server/test/test-agent-connect.mjs

@@ -3,7 +3,7 @@
  *
  * Tests the FULL agent flow after x402 provisioning:
  *   Agent has: subscription 1192288 on Plan 42, fee grant from operator, 0 P2P
- *   Agent does: connect via blue-agent-connect → session → handshake → tunnel
+ *   Agent does: connect via blue-js-sdk/ai-path → session → handshake → tunnel
  *
  * This validates both SDK bug fixes:
  *   Bug 1: node-connect.js balance check now skips when feeGranter is set

server/test/test-fresh-agent.mjs

@@ -186,39 +186,13 @@ async function main() {
     });
 
     // ════════════════════════════════════════════════════════════════════
-    // STEP 4: Fund agent — ETH gas on Base
+    // STEP 4: Verify agent funded (no ETH needed — EIP-3009 = 0 gas)
     // ════════════════════════════════════════════════════════════════════
-    const s4 = step('Fund agent: send ETH on Base', {
-      from: opWallet.address,
-      to: evmWallet.address,
-      amount: '0.00005 ETH',
-    });
-
-    const ethTx = await opWallet.sendTransaction({ to: evmWallet.address, value: ethers.parseEther('0.00005') });
-    console.log(`    TX submitted: ${ethTx.hash}`);
-    const ethRcpt = await ethTx.wait(1);
-    s4.confirmed = ts();
-    s4.block = ethRcpt.blockNumber;
-    console.log(`    Confirmed block ${ethRcpt.blockNumber}`);
-
-    tx('Base — ETH gas funding (operator → agent)', 'Base', ethTx.hash, {
-      block: ethRcpt.blockNumber,
-      from: opWallet.address,
-      to: evmWallet.address,
-      amount: '0.00005 ETH',
-    });
-
-    // ════════════════════════════════════════════════════════════════════
-    // STEP 5: Verify agent funded
-    // ════════════════════════════════════════════════════════════════════
-    const [aEth, aUsdc] = await Promise.all([
-      provider.getBalance(evmWallet.address),
-      usdc.balanceOf(evmWallet.address),
-    ]);
-    balances.postFunding = { usdc: ethers.formatUnits(aUsdc, 6), eth: ethers.formatEther(aEth) };
+    const aUsdc = await usdc.balanceOf(evmWallet.address);
+    balances.postFunding = { usdc: ethers.formatUnits(aUsdc, 6), eth: '0' };
     step('Verify agent funded', {
       agentUSDC: `${balances.postFunding.usdc} USDC`,
-      agentETH: `${balances.postFunding.eth} ETH`,
+      agentETH: '0 ETH — agent never needs gas (EIP-3009 = facilitator pays)',
       agentP2P: '0.00 P2P (fee-granted — no tokens needed)',
       onChain: 'read-only',
     });
@@ -337,16 +311,13 @@ async function main() {
     // ════════════════════════════════════════════════════════════════════
     // STEP 9: Check post-payment balance on Base
     // ════════════════════════════════════════════════════════════════════
-    const [postEth, postUsdc] = await Promise.all([
-      provider.getBalance(evmWallet.address),
-      usdc.balanceOf(evmWallet.address),
-    ]);
-    balances.postPayment = { usdc: ethers.formatUnits(postUsdc, 6), eth: ethers.formatEther(postEth) };
+    const postUsdc = await usdc.balanceOf(evmWallet.address);
+    balances.postPayment = { usdc: ethers.formatUnits(postUsdc, 6) };
     const paid = (parseFloat(balances.postFunding.usdc) - parseFloat(balances.postPayment.usdc)).toFixed(6);
 
     step('Post-payment agent balance', {
       agentUSDC: `${balances.postPayment.usdc} USDC (was ${balances.postFunding.usdc}, paid ${paid})`,
-      agentETH: `${balances.postPayment.eth} ETH (unchanged — EIP-3009 = 0 agent gas)`,
+      agentGas: 'ZERO — EIP-3009 means agent never sends a TX on Base',
       onChain: 'read-only',
     });
 
@@ -553,20 +524,17 @@ async function main() {
     // ════════════════════════════════════════════════════════════════════
     // STEP 18: Query final balances
     // ════════════════════════════════════════════════════════════════════
-    const [fEth, fUsdc, oEth, oUsdc] = await Promise.all([
-      provider.getBalance(evmWallet.address),
+    const [fUsdc, oUsdc] = await Promise.all([
       usdc.balanceOf(evmWallet.address),
-      provider.getBalance(opWallet.address),
       usdc.balanceOf(opWallet.address),
     ]);
-    balances.final = { usdc: ethers.formatUnits(fUsdc, 6), eth: ethers.formatEther(fEth) };
-    balances.operator = { usdc: ethers.formatUnits(oUsdc, 6), eth: ethers.formatEther(oEth) };
+    balances.final = { usdc: ethers.formatUnits(fUsdc, 6) };
+    balances.operator = { usdc: ethers.formatUnits(oUsdc, 6) };
 
     step('Final balances', {
       agentUSDC: `${balances.final.usdc} USDC`,
-      agentETH: `${balances.final.eth} ETH`,
+      agentGas: 'ZERO on both chains (EIP-3009 on Base, fee grant on Sentinel)',
       operatorUSDC: `${balances.operator.usdc} USDC`,
-      operatorETH: `${balances.operator.eth} ETH`,
     });
 
     // Cleanup RPC
@@ -684,16 +652,16 @@ function writeResults(testStart, wallets, balances, provision, conn, feeGrantDat
   L.push(HR);
   L.push('');
   L.push('Agent (Base):');
-  L.push(`  After funding:    ${balances.postFunding?.usdc || '?'} USDC / ${balances.postFunding?.eth || '?'} ETH`);
-  L.push(`  After payment:    ${balances.postPayment?.usdc || '?'} USDC / ${balances.postPayment?.eth || '?'} ETH`);
-  L.push(`  Final:            ${balances.final?.usdc || '?'} USDC / ${balances.final?.eth || '?'} ETH`);
+  L.push(`  After funding:    ${balances.postFunding?.usdc || '?'} USDC`);
+  L.push(`  After x402:       ${balances.postPayment?.usdc || '?'} USDC`);
+  L.push(`  Final:            ${balances.final?.usdc || '?'} USDC`);
+  L.push('  ETH:              0 — agent never needs gas (EIP-3009 = facilitator pays)');
   L.push('');
   L.push('Agent (Sentinel):');
   L.push('  P2P:              0.00 (all TXs covered by fee grant)');
   L.push('');
   L.push('Operator:');
   L.push(`  USDC:             ${balances.operator?.usdc || '?'}`);
-  L.push(`  ETH:              ${balances.operator?.eth || '?'}`);
   L.push('');
   L.push('');