@blockrun/franklin 3.15.21 → 3.15.23

package/dist/brain/store.js

@@ -11,6 +11,16 @@ const ENTITIES_FILE = path.join(BRAIN_DIR, 'entities.jsonl');
 const OBSERVATIONS_FILE = path.join(BRAIN_DIR, 'observations.jsonl');
 const RELATIONS_FILE = path.join(BRAIN_DIR, 'relations.jsonl');
 const MAX_ENTITIES = 200;
+// Observations and relations were previously unbounded — `extract.ts`
+// runs at every session end (commands/start.ts:515) so they grew
+// linearly forever. Caps below give comfortable headroom for a year+
+// of normal use without making per-entity scans pathological:
+//  - 2000 obs / 200 entities = ~10 observations per entity on average
+//  - 500 relations covers heavy cross-references between the entity set
+// On cap breach we drop the oldest entries — younger observations are
+// usually more relevant and more confident than an aging one.
+const MAX_OBSERVATIONS = 2000;
+const MAX_RELATIONS = 500;
 function uid() { return crypto.randomBytes(8).toString('hex'); }
 function ensureDir() {
     fs.mkdirSync(BRAIN_DIR, { recursive: true });
@@ -110,7 +120,7 @@ export function addObservation(entityId, content, source, confidence = 0.8, tags
     if (existing.some(o => o.entity_id === entityId && o.content.toLowerCase().trim() === contentLower)) {
         return;
     }
-    appendJsonl(OBSERVATIONS_FILE, {
+    const next = {
         id: uid(),
         entity_id: entityId,
         content,
@@ -118,7 +128,18 @@ export function addObservation(entityId, content, source, confidence = 0.8, tags
         confidence,
         tags,
         created_at: Date.now(),
-    });
+    };
+    // Cap reached — rewrite the file with the trimmed set instead of
+    // appending. saveJsonl is atomic (tmp + rename) so a crash mid-write
+    // can't corrupt observations.
+    if (existing.length >= MAX_OBSERVATIONS) {
+        existing.sort((a, b) => b.created_at - a.created_at);
+        existing.length = MAX_OBSERVATIONS - 1;
+        existing.unshift(next);
+        saveJsonl(OBSERVATIONS_FILE, existing);
+        return;
+    }
+    appendJsonl(OBSERVATIONS_FILE, next);
 }
 // ─── Relations ────────────────────────────────────────────────────────────
 export function loadRelations() {
@@ -140,7 +161,7 @@ export function upsertRelation(fromId, toId, type, confidence = 0.8) {
         saveJsonl(RELATIONS_FILE, relations);
     }
     else {
-        appendJsonl(RELATIONS_FILE, {
+        const next = {
             id: uid(),
             from_id: fromId,
             to_id: toId,
@@ -148,7 +169,25 @@ export function upsertRelation(fromId, toId, type, confidence = 0.8) {
             confidence,
             count: 1,
             last_seen: Date.now(),
-        });
+        };
+        // Same cap pattern as observations. When the relation set is at
+        // its ceiling we drop the lowest-count, oldest-seen entries to
+        // make room — count + recency together approximate "this
+        // relation is still being seen", so eviction targets entries the
+        // brain extractor hasn't reinforced in a while.
+        if (relations.length >= MAX_RELATIONS) {
+            relations.sort((a, b) => {
+                if (b.count !== a.count)
+                    return b.count - a.count;
+                return b.last_seen - a.last_seen;
+            });
+            relations.length = MAX_RELATIONS - 1;
+            relations.unshift(next);
+            saveJsonl(RELATIONS_FILE, relations);
+        }
+        else {
+            appendJsonl(RELATIONS_FILE, next);
+        }
     }
 }
 // ─── Search ───────────────────────────────────────────────────────────────

package/dist/mcp/client.js

@@ -5,6 +5,7 @@
  */
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { logger } from '../logger.js';
 // ─── Connection Management ────────────────────────────────────────────────
 const connections = new Map();
 /**
@@ -168,13 +169,9 @@ export async function connectMcpServers(config, debug) {
         if (serverConfig.disabled)
             continue;
         try {
-            if (debug) {
-                console.error(`[franklin] Connecting to MCP server: ${name}...`);
-            }
+            logger.debug(`[franklin] Connecting to MCP server: ${name}...`);
             if (serverConfig.transport !== 'stdio') {
-                if (debug) {
-                    console.error(`[franklin] MCP HTTP transport not yet supported for ${name}`);
-                }
+                logger.debug(`[franklin] MCP HTTP transport not yet supported for ${name}`);
                 continue;
             }
             // Timeout: don't let a slow server block startup
@@ -182,14 +179,18 @@ export async function connectMcpServers(config, debug) {
             const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('connection timeout (5s)')), MCP_CONNECT_TIMEOUT));
             const connected = await Promise.race([connectPromise, timeoutPromise]);
             allTools.push(...connected.tools);
-            if (debug) {
-                console.error(`[franklin] MCP ${name}: ${connected.tools.length} tools discovered`);
-            }
+            logger.info(`[franklin] MCP ${name}: ${connected.tools.length} tools discovered`);
         }
         catch (err) {
             // Graceful degradation — one-line warning, continue without this server.
-            // Always visible (not debug-only) so the user knows why tools are missing.
+            // Always written to franklin-debug.log so the user can post-mortem
+            // why tools went missing; ALSO printed to stderr at session boot
+            // so the user sees it in real time before the agent eats the
+            // terminal. Two separate writes (logger + stderr) is fine here —
+            // the user-visible "tool missing" notice has different timing
+            // requirements than the persistent log entry.
             const shortMsg = err.message?.split('\n')[0]?.slice(0, 100) || 'unknown error';
+            logger.warn(`[franklin] MCP ${name}: ${shortMsg}`);
             console.error(`  ${name}: ${shortMsg} ${debug ? '' : '(--debug for details)'}`);
         }
     }

package/dist/tools/defillama.js

@@ -17,6 +17,7 @@
  */
 import { getOrCreateWallet, getOrCreateSolanaWallet, createPaymentPayload, createSolanaPaymentPayload, parsePaymentRequired, extractPaymentDetails, solanaKeyToBytes, SOLANA_NETWORK, } from '@blockrun/llm';
 import { loadChain, API_URLS, VERSION } from '../config.js';
+import { logger } from '../logger.js';
 const TIMEOUT_MS = 30_000;
 // ─── Shared GET-with-x402 flow ────────────────────────────────────────────
 async function getWithPayment(path, ctx) {
@@ -90,7 +91,7 @@ async function signPayment(response, chain, endpoint) {
         return { 'PAYMENT-SIGNATURE': payload };
     }
     catch (err) {
-        console.error(`[franklin] DefiLlama payment error: ${err.message}`);
+        logger.warn(`[franklin] DefiLlama payment error: ${err.message}`);
         return null;
     }
 }

package/dist/tools/exa.js

@@ -19,6 +19,7 @@
  */
 import { getOrCreateWallet, getOrCreateSolanaWallet, createPaymentPayload, createSolanaPaymentPayload, parsePaymentRequired, extractPaymentDetails, solanaKeyToBytes, SOLANA_NETWORK, } from '@blockrun/llm';
 import { loadChain, API_URLS, VERSION } from '../config.js';
+import { logger } from '../logger.js';
 const GEN_TIMEOUT_MS = 30_000;
 // ─── Shared payment flow ─────────────────────────────────────────────
 async function postWithPayment(path, body, ctx) {
@@ -95,7 +96,7 @@ async function signPayment(response, chain, endpoint) {
         return { 'PAYMENT-SIGNATURE': payload };
     }
     catch (err) {
-        console.error(`[franklin] Exa payment error: ${err.message}`);
+        logger.warn(`[franklin] Exa payment error: ${err.message}`);
         return null;
     }
 }

package/dist/tools/imagegen.js

@@ -11,6 +11,7 @@ import { ModelClient } from '../agent/llm.js';
 import { analyzeMediaRequest, renderProposalForAskUser } from '../agent/media-router.js';
 import { recordUsage } from '../stats/tracker.js';
 import { findModel, estimateCostUsd } from '../gateway-models.js';
+import { logger } from '../logger.js';
 /**
  * Models that accept a reference image via /v1/images/image2image. Currently
  * limited to OpenAI's edit endpoint — Gemini Nano Banana Pro and Grok Imagine
@@ -391,7 +392,7 @@ async function signPayment(response, chain, endpoint) {
         }
     }
     catch (err) {
-        console.error(`[franklin] Image payment error: ${err.message}`);
+        logger.warn(`[franklin] Image payment error: ${err.message}`);
         return null;
     }
 }

package/dist/tools/modal.js

@@ -29,6 +29,7 @@ import { getOrCreateWallet, getOrCreateSolanaWallet, createPaymentPayload, creat
 import { loadChain, API_URLS, VERSION } from '../config.js';
 import { walletReservation } from '../wallet/reservation.js';
 import { recordUsage } from '../stats/tracker.js';
+import { logger } from '../logger.js';
 // ─── Pricing table (probed from /.well-known/x402 + 402 responses) ─────────
 const CREATE_PRICE_USD = {
     cpu: 0.01,
@@ -95,7 +96,7 @@ async function signPayment(response, chain, endpoint, resourceDescription) {
         }
     }
     catch (err) {
-        console.error(`[franklin] Modal payment error: ${err.message}`);
+        logger.warn(`[franklin] Modal payment error: ${err.message}`);
         return null;
     }
 }

package/dist/tools/musicgen.js

@@ -17,6 +17,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { getOrCreateWallet, getOrCreateSolanaWallet, createPaymentPayload, createSolanaPaymentPayload, parsePaymentRequired, extractPaymentDetails, solanaKeyToBytes, SOLANA_NETWORK, } from '@blockrun/llm';
 import { loadChain, API_URLS, VERSION } from '../config.js';
+import { logger } from '../logger.js';
 const DEFAULT_MODEL = 'minimax/music-2.5+';
 const PRICE_USD = 0.1575;
 // MiniMax generation is 1-3 minutes + small buffer for payment + download.
@@ -199,7 +200,7 @@ async function signPayment(response, chain, endpoint) {
         return { 'PAYMENT-SIGNATURE': payload };
     }
     catch (err) {
-        console.error(`[franklin] Music payment error: ${err.message}`);
+        logger.warn(`[franklin] Music payment error: ${err.message}`);
         return null;
     }
 }

package/dist/tools/prediction.js

@@ -163,7 +163,7 @@ async function execute(input, ctx) {
     try {
         switch (action) {
             case 'searchPolymarket': {
-                const raw = await getWithPayment('/api/v1/pm/polymarket/markets', {
+                const raw = await getWithPayment('/v1/pm/polymarket/markets', {
                     search,
                     status: status ?? 'active',
                     sort: sort ?? 'volume',
@@ -193,7 +193,7 @@ async function execute(input, ctx) {
                 return { output: lines.join('\n') };
             }
             case 'searchKalshi': {
-                const raw = await getWithPayment('/api/v1/pm/kalshi/markets', {
+                const raw = await getWithPayment('/v1/pm/kalshi/markets', {
                     search,
                     status: status ?? 'open',
                     sort: sort ?? 'volume',
@@ -223,7 +223,7 @@ async function execute(input, ctx) {
                 return { output: lines.join('\n') };
             }
             case 'crossPlatform': {
-                const raw = await getWithPayment('/api/v1/pm/matching-markets/pairs', {
+                const raw = await getWithPayment('/v1/pm/matching-markets/pairs', {
                     limit: cappedLimit,
                 }, ctx);
                 const pairs = unwrapList(raw);
@@ -249,7 +249,7 @@ async function execute(input, ctx) {
                 if (!conditionId) {
                     return { output: 'Error: conditionId is required for smartMoney (Polymarket condition_id from a prior searchPolymarket call)', isError: true };
                 }
-                const path = `/api/v1/pm/polymarket/market/${encodeURIComponent(conditionId)}/smart-money`;
+                const path = `/v1/pm/polymarket/market/${encodeURIComponent(conditionId)}/smart-money`;
                 const data = await getWithPayment(path, {}, ctx);
                 const buyers = (data.buyers ?? []).slice(0, 5);
                 const sellers = (data.sellers ?? []).slice(0, 5);

package/dist/tools/videogen.js

@@ -22,6 +22,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { getOrCreateWallet, getOrCreateSolanaWallet, createPaymentPayload, createSolanaPaymentPayload, parsePaymentRequired, extractPaymentDetails, solanaKeyToBytes, SOLANA_NETWORK, } from '@blockrun/llm';
 import { loadChain, API_URLS, VERSION } from '../config.js';
+import { logger } from '../logger.js';
 import { ModelClient } from '../agent/llm.js';
 import { analyzeMediaRequest, renderProposalForAskUser } from '../agent/media-router.js';
 import { recordUsage } from '../stats/tracker.js';
@@ -385,7 +386,7 @@ async function signPayment(response, chain, endpoint) {
         return { 'PAYMENT-SIGNATURE': payload };
     }
     catch (err) {
-        console.error(`[franklin] Video payment error: ${err.message}`);
+        logger.warn(`[franklin] Video payment error: ${err.message}`);
         return null;
     }
 }

package/dist/tools/zerox-gasless.js

@@ -24,6 +24,7 @@ import { createWalletClient, http, publicActions } from 'viem';
 import { getOrCreateWallet } from '@blockrun/llm';
 import { loadConfig } from '../commands/config.js';
 import { loadChain, API_URLS, VERSION } from '../config.js';
+import { logger } from '../logger.js';
 // ─── Constants ────────────────────────────────────────────────────────────
 const ZEROX_GATEWAY_PATH = '/v1/zerox/gasless';
 const QUOTE_TIMEOUT_MS = 30_000;
@@ -235,7 +236,7 @@ async function pollUntilDone(tradeHash, ctx) {
         }
         catch (err) {
             // Surface a transient failure but keep polling — relayer might be backlogged.
-            console.error(`[franklin] gasless status poll error: ${err.message}`);
+            logger.warn(`[franklin] gasless status poll error: ${err.message}`);
         }
         if (last.status === 'confirmed' ||
             last.status === 'succeeded' ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/franklin",
-  "version": "3.15.21",
+  "version": "3.15.23",
   "description": "Franklin — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
   "type": "module",
   "exports": {