cornerstone-autonomous-agent 2.0.0 → 2.1.0

package/src/agent/tools/mcpTools.js

@@ -1,150 +1,150 @@
-/**
- * MCP tools as LangChain tools: run_prediction, run_backtest, link_bank_account,
- * get_agent_reputation_score, get_borrower_score, get_agent_reputation_score_by_email, get_borrower_score_by_email.
- * Each invokes mcpClient.callTool(name, args) with x402 retry inside the client.
- */
-
-import { tool } from '@langchain/core/tools';
-import { z } from 'zod';
-
-/**
- * @param {{ callTool: (name: string, args: Object) => Promise<Object> }} mcpClient - from createMcpClient()
- * @returns {import('@langchain/core/tools').StructuredToolInterface[]}
- */
-export function createMcpTools(mcpClient) {
-  const run_prediction = tool(
-    async ({ symbol, horizon }) => {
-      console.log(`Calling run_prediction: symbol=${symbol}, horizon=${horizon}`);
-      const out = await mcpClient.callTool('run_prediction', {
-        symbol: symbol || 'AAPL',
-        horizon: horizon ?? 30,
-      });
-      console.log('MCP response:', JSON.stringify(out, null, 2));
-      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
-    },
-    {
-      name: 'run_prediction',
-      description: 'Run stock prediction for a ticker. Returns prediction result. x402: pay with Aptos or EVM (server offers both).',
-      schema: z.object({
-        symbol: z.string().describe('Stock symbol (e.g. AAPL)'),
-        horizon: z.number().default(30).describe('Prediction horizon in days'),
-      }),
-    }
-  );
-
-  const run_backtest = tool(
-    async ({ symbol, startDate, endDate, strategy }) => {
-      const out = await mcpClient.callTool('run_backtest', {
-        symbol: symbol || 'AAPL',
-        startDate: startDate || '',
-        endDate: endDate || '',
-        strategy: strategy || 'chronos',
-      });
-      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
-    },
-    {
-      name: 'run_backtest',
-      description: 'Run backtest for a trading strategy on a symbol. x402: pay with Aptos or EVM.',
-      schema: z.object({
-        symbol: z.string().describe('Stock symbol'),
-        startDate: z.string().nullable().default(null).describe('Start date YYYY-MM-DD'),
-        endDate: z.string().nullable().default(null).describe('End date YYYY-MM-DD'),
-        strategy: z.string().default('chronos').describe('Strategy name'),
-      }),
-    }
-  );
-
-  const link_bank_account = tool(
-    async () => {
-      const out = await mcpClient.callTool('link_bank_account', {});
-      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
-    },
-    {
-      name: 'link_bank_account',
-      description: 'Start bank linking flow (Plaid link). x402: pay with Aptos or EVM (e.g. Base Sepolia). Returns link_token or account id.',
-      schema: z.object({}),
-    }
-  );
-
-  const get_agent_reputation_score = tool(
-    async ({ agent_address, payer_wallet }) => {
-      const out = await mcpClient.callTool('get_agent_reputation_score', {
-        agent_address: agent_address || undefined,
-        payer_wallet: payer_wallet || undefined,
-      });
-      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
-    },
-    {
-      name: 'get_agent_reputation_score',
-      description: 'Get agent reputation score for an allowlisted wallet. Returns 200 with reputation_score (e.g. 100) or 403. x402 or lender credits.',
-      schema: z.object({
-        agent_address: z.string().optional().describe('Wallet to query (allowlisted agent)'),
-        payer_wallet: z.string().optional().describe('When using lender credits, your registered paying wallet'),
-      }),
-    }
-  );
-
-  const get_borrower_score = tool(
-    async ({ agent_address, payer_wallet }) => {
-      const out = await mcpClient.callTool('get_borrower_score', {
-        agent_address: agent_address || undefined,
-        payer_wallet: payer_wallet || undefined,
-      });
-      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
-    },
-    {
-      name: 'get_borrower_score',
-      description: 'Get borrower score for an allowlisted agent. Returns 200 with score (100 or 100+X when bank linked). x402 or lender credits.',
-      schema: z.object({
-        agent_address: z.string().optional().describe('Agent wallet to get score for'),
-        payer_wallet: z.string().optional().describe('When using lender credits, your registered paying wallet'),
-      }),
-    }
-  );
-
-  const get_agent_reputation_score_by_email = tool(
-    async ({ email, payer_wallet }) => {
-      const out = await mcpClient.callTool('get_agent_reputation_score_by_email', {
-        email: email || undefined,
-        payer_wallet: payer_wallet || undefined,
-      });
-      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
-    },
-    {
-      name: 'get_agent_reputation_score_by_email',
-      description: 'Get agent reputation score by email (resolves to allowlisted agent). Higher fee. Requires SCORE_BY_EMAIL_ENABLED. x402 or lender credits.',
-      schema: z.object({
-        email: z.string().describe('Email to resolve to an allowlisted agent'),
-        payer_wallet: z.string().optional().describe('When using lender credits, your registered paying wallet'),
-      }),
-    }
-  );
-
-  const get_borrower_score_by_email = tool(
-    async ({ email, payer_wallet }) => {
-      const out = await mcpClient.callTool('get_borrower_score_by_email', {
-        email: email || undefined,
-        payer_wallet: payer_wallet || undefined,
-      });
-      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
-    },
-    {
-      name: 'get_borrower_score_by_email',
-      description: 'Get borrower score by email (resolves to allowlisted agent). Higher fee. Requires SCORE_BY_EMAIL_ENABLED. x402 or lender credits.',
-      schema: z.object({
-        email: z.string().describe('Email to resolve to an allowlisted agent'),
-        payer_wallet: z.string().optional().describe('When using lender credits, your registered paying wallet'),
-      }),
-    }
-  );
-
-  return [
-    run_prediction,
-    run_backtest,
-    link_bank_account,
-    get_agent_reputation_score,
-    get_borrower_score,
-    get_agent_reputation_score_by_email,
-    get_borrower_score_by_email,
-  ];
-}
+/**
+ * MCP tools as LangChain tools: run_prediction, run_backtest, link_bank_account,
+ * get_agent_reputation_score, get_borrower_score, get_agent_reputation_score_by_email, get_borrower_score_by_email.
+ * Each invokes mcpClient.callTool(name, args) with x402 retry inside the client.
+ */
+
+import { tool } from '@langchain/core/tools';
+import { z } from 'zod';
+
+/**
+ * @param {{ callTool: (name: string, args: Object) => Promise<Object> }} mcpClient - from createMcpClient()
+ * @returns {import('@langchain/core/tools').StructuredToolInterface[]}
+ */
+export function createMcpTools(mcpClient) {
+  const run_prediction = tool(
+    async ({ symbol, horizon }) => {
+      console.log(`Calling run_prediction: symbol=${symbol}, horizon=${horizon}`);
+      const out = await mcpClient.callTool('run_prediction', {
+        symbol: symbol || 'AAPL',
+        horizon: horizon ?? 30,
+      });
+      console.log('MCP response:', JSON.stringify(out, null, 2));
+      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
+    },
+    {
+      name: 'run_prediction',
+      description: 'Run stock prediction for a ticker symbol. Returns forecast data with confidence intervals. Cost ~6c USDC via x402 (payment automatic). Prerequisite: funded + whitelisted Aptos or EVM wallet.',
+      schema: z.object({
+        symbol: z.string().describe('Stock symbol (e.g. AAPL)'),
+        horizon: z.number().default(30).describe('Prediction horizon in days'),
+      }),
+    }
+  );
+
+  const run_backtest = tool(
+    async ({ symbol, startDate, endDate, strategy }) => {
+      const out = await mcpClient.callTool('run_backtest', {
+        symbol: symbol || 'AAPL',
+        startDate: startDate || '',
+        endDate: endDate || '',
+        strategy: strategy || 'chronos',
+      });
+      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
+    },
+    {
+      name: 'run_backtest',
+      description: 'Run backtest for a trading strategy on a symbol. Returns performance metrics (returns, drawdown, sharpe). Cost ~6c USDC via x402 (payment automatic). Prerequisite: funded + whitelisted Aptos or EVM wallet.',
+      schema: z.object({
+        symbol: z.string().describe('Stock symbol'),
+        startDate: z.string().nullable().default(null).describe('Start date YYYY-MM-DD'),
+        endDate: z.string().nullable().default(null).describe('End date YYYY-MM-DD'),
+        strategy: z.string().default('chronos').describe('Strategy name'),
+      }),
+    }
+  );
+
+  const link_bank_account = tool(
+    async () => {
+      const out = await mcpClient.callTool('link_bank_account', {});
+      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
+    },
+    {
+      name: 'link_bank_account',
+      description: 'Start Plaid bank linking flow. Returns link_token for the user to complete bank connection. Cost ~5c via x402 (payment automatic). Prerequisite: funded + whitelisted EVM wallet (Base Sepolia for testnet).',
+      schema: z.object({}),
+    }
+  );
+
+  const get_agent_reputation_score = tool(
+    async ({ agent_address, payer_wallet }) => {
+      const out = await mcpClient.callTool('get_agent_reputation_score', {
+        agent_address: agent_address || undefined,
+        payer_wallet: payer_wallet || undefined,
+      });
+      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
+    },
+    {
+      name: 'get_agent_reputation_score',
+      description: 'Get agent reputation score (ability to transact via x402) for an allowlisted wallet. Returns { reputation_score } or 403 if not allowlisted. Cost ~6c via x402, or free with lender credits (pass payer_wallet). Call get_wallet_addresses first to get the address.',
+      schema: z.object({
+        agent_address: z.string().optional().describe('Wallet to query (allowlisted agent)'),
+        payer_wallet: z.string().optional().describe('When using lender credits, your registered paying wallet'),
+      }),
+    }
+  );
+
+  const get_borrower_score = tool(
+    async ({ agent_address, payer_wallet }) => {
+      const out = await mcpClient.callTool('get_borrower_score', {
+        agent_address: agent_address || undefined,
+        payer_wallet: payer_wallet || undefined,
+      });
+      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
+    },
+    {
+      name: 'get_borrower_score',
+      description: 'Get borrower score (real borrower behavior) for an allowlisted wallet. Returns { score } (100 base, higher with bank linked). Cost ~6c via x402, or free with lender credits (pass payer_wallet).',
+      schema: z.object({
+        agent_address: z.string().optional().describe('Agent wallet to get score for'),
+        payer_wallet: z.string().optional().describe('When using lender credits, your registered paying wallet'),
+      }),
+    }
+  );
+
+  const get_agent_reputation_score_by_email = tool(
+    async ({ email, payer_wallet }) => {
+      const out = await mcpClient.callTool('get_agent_reputation_score_by_email', {
+        email: email || undefined,
+        payer_wallet: payer_wallet || undefined,
+      });
+      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
+    },
+    {
+      name: 'get_agent_reputation_score_by_email',
+      description: 'Get agent reputation score by email (resolves email to allowlisted wallet). Higher fee than address-based lookup. Requires SCORE_BY_EMAIL_ENABLED on server. Returns { reputation_score } or error.',
+      schema: z.object({
+        email: z.string().describe('Email to resolve to an allowlisted agent'),
+        payer_wallet: z.string().optional().describe('When using lender credits, your registered paying wallet'),
+      }),
+    }
+  );
+
+  const get_borrower_score_by_email = tool(
+    async ({ email, payer_wallet }) => {
+      const out = await mcpClient.callTool('get_borrower_score_by_email', {
+        email: email || undefined,
+        payer_wallet: payer_wallet || undefined,
+      });
+      return typeof out?.result === 'object' ? JSON.stringify(out.result) : JSON.stringify(out);
+    },
+    {
+      name: 'get_borrower_score_by_email',
+      description: 'Get borrower score by email (resolves email to allowlisted wallet). Higher fee than address-based lookup. Requires SCORE_BY_EMAIL_ENABLED on server. Returns { score } or error.',
+      schema: z.object({
+        email: z.string().describe('Email to resolve to an allowlisted agent'),
+        payer_wallet: z.string().optional().describe('When using lender credits, your registered paying wallet'),
+      }),
+    }
+  );
+
+  return [
+    run_prediction,
+    run_backtest,
+    link_bank_account,
+    get_agent_reputation_score,
+    get_borrower_score,
+    get_agent_reputation_score_by_email,
+    get_borrower_score_by_email,
+  ];
+}

package/src/cli.js

@@ -44,7 +44,7 @@ function main() {
     return;
   }
 
-  // Default: run the agent (backward compatibility: npx cornerstone-autonomous-agent "some message")
+  // Default: run the skill demo (backward compatibility: npx cornerstone-autonomous-agent "some message")
   const runAgentPath = join(root, 'src/run-agent.js');
   const child = spawn(process.execPath, [runAgentPath, ...args], {
     stdio: 'inherit',

package/src/lib/aptos/signPayment.js

@@ -28,7 +28,7 @@ export async function buildAptosPaymentPayload(paymentRequirements, wallet) {
   // Aptos SDK parses payTo as address; empty string causes "Hex string is too short"
   if (!payTo || payTo.length < 32) {
     throw new Error(
-      'Payment requirements missing valid payTo address. Set APTOS_PAYTO_ADDRESS in server .env or register a pay_to address at http://localhost:4024/flow.html'
+      'Payment requirements missing valid payTo address. Set APTOS_PAYTO_ADDRESS in server .env or register a pay_to address at https://arnstein.ch/flow.html'
     );
   }
 

package/src/lib/evm/signPayment.js

@@ -26,7 +26,7 @@ export async function getEvmPaymentPayload(paymentRequirements) {
   const to = (paymentRequirements.payTo || '').trim();
   if (!to || !to.startsWith('0x') || to.length < 40) {
     throw new Error(
-      'Payment requirements missing valid payTo address. Set BASE_SEPOLIA_PAYTO in server .env or register a pay_to address at http://localhost:4024/flow.html'
+      'Payment requirements missing valid payTo address. Set BASE_SEPOLIA_PAYTO in server .env or register a pay_to address at https://arnstein.ch/flow.html'
     );
   }
   const value = BigInt(

package/src/lib/mcp/client.js

@@ -1,5 +1,6 @@
 /**
- * MCP client with x402 retry: uses official MCP SDK with StreamableHTTP transport.
+ * MCP client with x402 retry: uses official MCP SDK.
+ * Tries StreamableHTTP transport first; falls back to SSE if the server returns 405.
  * On 402 from tool call, pays via facilitator and retries in one shot (agent calls
  * the tool once; 402 + verify + settle + retry happen inside callTool; agent gets
  * final result or error, never 402).
@@ -7,6 +8,7 @@
 
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
 import { verifyPayment, settlePayment } from '../x402/index.js';
 
 /** Max time for a single callTool (connect + call + payment flow + retry); ms. MCP responses (e.g. prediction) can take > 1 min. */
@@ -21,9 +23,9 @@ function withTimeout(promise, ms, label) {
 
 /**
  * @param {Object} config
- * @param {string} config.baseUrl - MCP server base URL (e.g. http://localhost:4023)
+ * @param {string} config.baseUrl - MCP server base URL (e.g. https://arnstein.ch); client appends /mcp
  * @param {string} config.facilitatorUrl - x402 facilitator base URL (Aptos)
- * @param {string} [config.evmFacilitatorUrl] - facilitator for EVM (open_bank_account); defaults to facilitatorUrl (use public for EVM when Aptos is local)
+ * @param {string} [config.evmFacilitatorUrl] - facilitator for EVM (open_bank_account); defaults to facilitatorUrl
  * @param {(r: import('../x402/types.js').PaymentRequirements) => Promise<Object>} config.getAptosPaymentPayload
  * @param {(r: import('../x402/types.js').PaymentRequirements) => Promise<Object>} config.getEvmPaymentPayload
  * @param {number} [config.maxRetries]
@@ -43,7 +45,7 @@ export function createMcpClient(config) {
   let isConnected = false;
 
   /**
-   * Connect to MCP server
+   * Connect to MCP server (StreamableHTTP first, SSE fallback)
    */
   async function connect() {
     if (isConnected && mcpClient) {
@@ -51,24 +53,40 @@ export function createMcpClient(config) {
       return;
     }
 
-    console.log(`Connecting to MCP server at ${mcpUrl}`);
-    try {
-      const transport = new StreamableHTTPClientTransport(
-        new URL(mcpUrl)
-      );
+    const clientInfo = { name: 'cornerstone-agent', version: '1.0.0' };
+    const clientOpts = { capabilities: {} };
 
-      mcpClient = new Client({
-        name: 'cornerstone-agent',
-        version: '1.0.0',
-      }, {
-        capabilities: {},
-      });
+    // Try StreamableHTTP first
+    console.log(`Connecting to MCP server at ${mcpUrl} (StreamableHTTP)...`);
+    try {
+      const transport = new StreamableHTTPClientTransport(new URL(mcpUrl));
+      mcpClient = new Client(clientInfo, clientOpts);
+      await mcpClient.connect(transport);
+      isConnected = true;
+      console.log('Connected to MCP server via StreamableHTTP');
+      return;
+    } catch (error) {
+      // 405 = server doesn't support StreamableHTTP, try SSE
+      if (error.code === 405 || error.message?.includes('405') || error.message?.includes('Method Not Allowed')) {
+        console.log('StreamableHTTP not supported, trying SSE transport...');
+        mcpClient = null;
+      } else {
+        console.error('Failed to connect to MCP server:', error);
+        throw error;
+      }
+    }
 
+    // Fallback: SSE transport (uses /sse endpoint by convention)
+    const sseUrl = `${baseUrl}/sse`;
+    console.log(`Connecting to MCP server at ${sseUrl} (SSE)...`);
+    try {
+      const transport = new SSEClientTransport(new URL(sseUrl));
+      mcpClient = new Client(clientInfo, clientOpts);
       await mcpClient.connect(transport);
       isConnected = true;
-      console.log('Successfully connected to MCP server');
+      console.log('Connected to MCP server via SSE');
     } catch (error) {
-      console.error('Failed to connect to MCP server:', error);
+      console.error('Failed to connect to MCP server (SSE):', error);
       throw error;
     }
   }

package/src/run-agent.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Entrypoint for the autonomous agent (x402 MCP + LangChain.js).
+ * Entrypoint for the skill demo (x402 MCP + LangChain.js runner).
  * Usage: node src/run-agent.js [message]
  * If no message, runs demo prompt.
  */
@@ -17,7 +17,7 @@ const DEMO_PROMPT =
 async function main() {
   const message = process.argv.slice(2).join(' ').trim() || DEMO_PROMPT;
 
-  const mcpServerUrl = process.env.MCP_SERVER_URL || 'http://localhost:4023';
+  const mcpServerUrl = process.env.MCP_SERVER_URL || 'https://arnstein.ch';
   const defaultFacilitator = 'https://x402-navy.vercel.app/facilitator';
   let facilitatorUrl = process.env.X402_FACILITATOR_URL || defaultFacilitator;
   if (facilitatorUrl.includes('facilitator.x402.org')) {

package/src/show-agent-addresses.js

@@ -1,33 +1,33 @@
-#!/usr/bin/env node
-/**
- * Print all agent wallet addresses for whitelisting during a demo.
- * Run from agent project: node src/show-agent-addresses.js (or npm run addresses).
- * Package: https://github.com/FinTechTonic/autonomous-agent
- * Then add each address at http://localhost:4024/flow.html (EVM and Aptos rows; optional testnet/mainnet tag).
- */
-
-import { getAllWalletInfos as getAptosAll, exists as aptosExists } from './lib/aptos/wallet.js';
-import { getAllWalletInfos as getEvmAll, exists as evmExists } from './lib/wallet.js';
-
-const aptosList = aptosExists() ? getAptosAll() : [];
-const evmList = evmExists() ? getEvmAll() : [];
-
-console.log('\nAgent wallet addresses (whitelist these at http://localhost:4024/flow.html):');
-console.log('  Add multiple EVM and Aptos rows as needed; optionally tag each as testnet or mainnet.\n');
-if (aptosList.length) {
-  aptosList.forEach((w, i) => {
-    const net = w.network ? ` [${w.network}]` : '';
-    console.log(`  Aptos (run_prediction, run_backtest)${net}: ${w.address}`);
-  });
-} else {
-  console.log('  Aptos: none. Run: node src/setup-aptos.js or create_aptos_wallet (optionally network: "testnet"|"mainnet").');
-}
-if (evmList.length) {
-  evmList.forEach((w, i) => {
-    const net = w.network ? ` [${w.network}]` : '';
-    console.log(`  EVM (link_bank_account)${net}:             ${w.address}`);
-  });
-} else {
-  console.log('  EVM: none. Run: node src/setup.js or create_evm_wallet (optionally network: "testnet"|"mainnet"); or set EVM_PRIVATE_KEY.');
-}
-console.log('');
+#!/usr/bin/env node
+/**
+ * Print all agent wallet addresses for whitelisting during a demo.
+ * Run from agent project: node src/show-agent-addresses.js (or npm run addresses).
+ * Package: https://github.com/FinTechTonic/autonomous-agent
+ * Then add each address at https://arnstein.ch/flow.html (EVM and Aptos rows; optional testnet/mainnet tag).
+ */
+
+import { getAllWalletInfos as getAptosAll, exists as aptosExists } from './lib/aptos/wallet.js';
+import { getAllWalletInfos as getEvmAll, exists as evmExists } from './lib/wallet.js';
+
+const aptosList = aptosExists() ? getAptosAll() : [];
+const evmList = evmExists() ? getEvmAll() : [];
+
+console.log('\nAgent wallet addresses (whitelist these at https://arnstein.ch/flow.html):');
+console.log('  Add multiple EVM and Aptos rows as needed; optionally tag each as testnet or mainnet.\n');
+if (aptosList.length) {
+  aptosList.forEach((w, i) => {
+    const net = w.network ? ` [${w.network}]` : '';
+    console.log(`  Aptos (run_prediction, run_backtest)${net}: ${w.address}`);
+  });
+} else {
+  console.log('  Aptos: none. Run: node src/setup-aptos.js or create_aptos_wallet (optionally network: "testnet"|"mainnet").');
+}
+if (evmList.length) {
+  evmList.forEach((w, i) => {
+    const net = w.network ? ` [${w.network}]` : '';
+    console.log(`  EVM (link_bank_account)${net}:             ${w.address}`);
+  });
+} else {
+  console.log('  EVM: none. Run: node src/setup.js or create_evm_wallet (optionally network: "testnet"|"mainnet"); or set EVM_PRIVATE_KEY.');
+}
+console.log('');