@blockrun/franklin 3.6.13 → 3.6.15

package/dist/agent/compact.js

@@ -367,8 +367,14 @@ function formatCompactSummary(raw) {
 }
 /**
  * Pick a cheaper/faster model for compaction to save cost.
+ * If the primary model is free (NVIDIA), compaction also stays free
+ * so users don't get silent charges when their context fills up.
  */
 function pickCompactionModel(primaryModel) {
+    // Free parent → free compaction (no silent charge)
+    if (primaryModel.startsWith('nvidia/') || primaryModel === 'blockrun/free') {
+        return 'nvidia/nemotron-ultra-253b';
+    }
     // Use cheapest capable model for summarization to save cost
     // Tier down: opus/pro → sonnet, sonnet → haiku, everything else → flash (cheapest capable)
     if (primaryModel.includes('opus') || primaryModel.includes('pro')) {
@@ -380,7 +386,7 @@ function pickCompactionModel(primaryModel) {
     if (primaryModel.includes('haiku') || primaryModel.includes('mini') || primaryModel.includes('nano')) {
         return 'google/gemini-2.5-flash'; // Cheapest capable model
     }
-    // Free/unknown models — use flash
+    // Unknown models — use flash
     return 'google/gemini-2.5-flash';
 }
 /**

package/dist/commands/start.js

@@ -72,22 +72,12 @@ export async function startCommand(options) {
     }
     printBanner(version);
     const workDir = process.cwd();
-    // Show session info immediately, fetch balance in background
-    // Model is shown in the live status bar — no static line needed.
-    console.log(chalk.dim(`  Wallet: ${walletAddress || 'not set'}`));
-    console.log(chalk.dim(`  Dir:    ${workDir}`));
-    // First-run tip: show if no config file exists yet
-    if (!configModel && !options.model) {
-        console.log(chalk.dim(`\n  Tip: /model to switch models · /compact to save tokens · /help for all commands`));
-    }
-    // Welcome message — show things Hermes/OpenClaw can't do.
-    // Only on first run or when no model is configured (new user indicator).
-    // After the user's first session, the tip fades and they go straight to the prompt.
-    console.log('');
-    console.log(chalk.dim('  Try something only Franklin can do:'));
-    console.log(chalk.dim('    ') + chalk.hex('#FFD700')('"what\'s BTC looking like today?"') + chalk.dim('  ← live market data'));
-    console.log(chalk.dim('    ') + chalk.hex('#60A5FA')('"generate a logo for my startup"') + chalk.dim('  ← AI image gen'));
-    console.log(chalk.dim('  Code with 55+ models. No API keys. Pay per use.'));
+    // Session info — aligned, minimal. Model + balance live in the input bar below.
+    const short = (s) => s.length > 14 ? s.slice(0, 6) + '...' + s.slice(-4) : s;
+    console.log(chalk.dim('  Wallet:    ') + (walletAddress ? short(walletAddress) : chalk.yellow('not set')));
+    console.log(chalk.dim('  Dir:       ') + workDir);
+    console.log(chalk.dim('  Dashboard: ') + chalk.cyan('franklin panel') + chalk.dim(' → http://localhost:3100'));
+    console.log(chalk.dim('  Help:      ') + chalk.cyan('/help'));
     console.log('');
     // Balance fetcher — used at startup and after each turn
     const fetchBalance = async () => {
@@ -142,10 +132,11 @@ export async function startCommand(options) {
         }
     }
     // Build capabilities (built-in + MCP + sub-agent + MoA)
-    const subAgent = createSubAgentCapability(apiUrl, chain, allCapabilities);
+    // Pass parent model so sub-agents inherit it (no silent paid spawns from free parents)
+    const subAgent = createSubAgentCapability(apiUrl, chain, allCapabilities, model);
     // Register MoA tool config (needs API URL for parallel model queries)
     const { registerMoAConfig } = await import('../tools/moa.js');
-    registerMoAConfig(apiUrl, chain);
+    registerMoAConfig(apiUrl, chain, model);
     const capabilities = [...allCapabilities, ...mcpTools, subAgent];
     // Validate tool descriptions (self-evolution: detect SearchX-style description bugs)
     if (options.debug) {

package/dist/tools/moa.d.ts

@@ -13,4 +13,4 @@
 import type { CapabilityHandler } from '../agent/types.js';
 export declare const moaCapability: CapabilityHandler;
 /** Register the API URL for MoA tool (called during agent setup). */
-export declare function registerMoAConfig(apiUrl: string, chain: 'base' | 'solana'): void;
+export declare function registerMoAConfig(apiUrl: string, chain: 'base' | 'solana', parentModel?: string): void;

package/dist/tools/moa.js

@@ -31,13 +31,18 @@ const REFERENCE_TIMEOUT_MS = 60_000;
 // These will be injected at registration time
 let registeredApiUrl = '';
 let registeredChain = 'base';
+let registeredParentModel = '';
 async function execute(input, ctx) {
     const { prompt, models, aggregator, include_reasoning } = input;
     if (!prompt) {
         return { output: 'Error: prompt is required', isError: true };
     }
     const referenceModels = models || REFERENCE_MODELS;
-    const aggregatorModel = aggregator || AGGREGATOR_MODEL;
+    // If parent agent is on a free model, default aggregator to a free model too
+    // so MoA doesn't silently charge the user. Explicit `aggregator` arg wins.
+    const parentIsFree = registeredParentModel.startsWith('nvidia/') ||
+        registeredParentModel === 'blockrun/free';
+    const aggregatorModel = aggregator || (parentIsFree ? 'nvidia/nemotron-ultra-253b' : AGGREGATOR_MODEL);
     const client = new ModelClient({
         apiUrl: registeredApiUrl,
         chain: registeredChain,
@@ -167,7 +172,9 @@ Parameters:
     concurrent: true,
 };
 /** Register the API URL for MoA tool (called during agent setup). */
-export function registerMoAConfig(apiUrl, chain) {
+export function registerMoAConfig(apiUrl, chain, parentModel) {
     registeredApiUrl = apiUrl;
     registeredChain = chain;
+    if (parentModel)
+        registeredParentModel = parentModel;
 }

package/dist/tools/subagent.d.ts

@@ -2,4 +2,4 @@
  * SubAgent capability — spawn a child agent for independent tasks.
  */
 import type { CapabilityHandler } from '../agent/types.js';
-export declare function createSubAgentCapability(apiUrl: string, chain: 'base' | 'solana', capabilities: CapabilityHandler[]): CapabilityHandler;
+export declare function createSubAgentCapability(apiUrl: string, chain: 'base' | 'solana', capabilities: CapabilityHandler[], parentModel?: string): CapabilityHandler;

package/dist/tools/subagent.js

@@ -6,12 +6,31 @@ import { assembleInstructions } from '../agent/context.js';
 // These will be injected at registration time
 let registeredApiUrl = '';
 let registeredChain = 'base';
+let registeredParentModel = '';
 let registeredCapabilities = [];
+// Heuristic: which model IDs are free?
+function isFreeModel(m) {
+    return m.startsWith('nvidia/') || m === 'blockrun/free' || m === '';
+}
 async function execute(input, ctx) {
     const { prompt, description, model } = input;
     if (!prompt) {
         return { output: 'Error: prompt is required', isError: true };
     }
+    // Resolve which model the sub-agent will actually run on
+    const subModel = model || registeredParentModel || 'nvidia/nemotron-ultra-253b';
+    // Cost gate: if parent is free but sub-agent wants paid, ask user first.
+    // Prevents silent charges when the agent decides to spawn a more capable sub-agent.
+    if (isFreeModel(registeredParentModel) && !isFreeModel(subModel) && ctx.onAskUser) {
+        const shortLabel = subModel.split('/').pop() || subModel;
+        const answer = await ctx.onAskUser(`Sub-agent wants to use ${shortLabel} (paid). Approve?`, ['y', 'n']);
+        if (answer.toLowerCase() !== 'y' && answer.toLowerCase() !== 'yes') {
+            return {
+                output: `Sub-agent skipped — user declined paid model (${shortLabel}). Retry with a free model like nemotron.`,
+                isError: true,
+            };
+        }
+    }
     const client = new ModelClient({
         apiUrl: registeredApiUrl,
         chain: registeredChain,
@@ -54,7 +73,7 @@ async function execute(input, ctx) {
         }
         turn++;
         const { content: parts } = await client.complete({
-            model: model || 'anthropic/claude-sonnet-4.6',
+            model: subModel,
             messages: history,
             system: systemPrompt,
             tools: toolDefs,
@@ -107,10 +126,12 @@ async function execute(input, ctx) {
         output: finalText || `[${label}] completed after ${turn} turn(s) with no text output.`,
     };
 }
-export function createSubAgentCapability(apiUrl, chain, capabilities) {
+export function createSubAgentCapability(apiUrl, chain, capabilities, parentModel) {
     registeredApiUrl = apiUrl;
     registeredChain = chain;
     registeredCapabilities = capabilities;
+    if (parentModel)
+        registeredParentModel = parentModel;
     return {
         spec: {
             name: 'Agent',

package/package.json

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