@blockrun/franklin 3.6.13 → 3.6.14

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

@@ -142,10 +142,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,6 +6,7 @@ import { assembleInstructions } from '../agent/context.js';
 // These will be injected at registration time
 let registeredApiUrl = '';
 let registeredChain = 'base';
+let registeredParentModel = '';
 let registeredCapabilities = [];
 async function execute(input, ctx) {
     const { prompt, description, model } = input;
@@ -54,7 +55,9 @@ async function execute(input, ctx) {
         }
         turn++;
         const { content: parts } = await client.complete({
-            model: model || 'anthropic/claude-sonnet-4.6',
+            // Inherit parent model by default. If parent is on a free model, subagent stays free.
+            // User can explicitly pass `model` to override.
+            model: model || registeredParentModel || 'nvidia/nemotron-ultra-253b',
             messages: history,
             system: systemPrompt,
             tools: toolDefs,
@@ -107,10 +110,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.14",
   "description": "Franklin — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
   "type": "module",
   "exports": {