@blockrun/franklin 3.21.9 → 3.23.0

package/dist/tools/videogen.js

@@ -28,6 +28,13 @@ 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';
+// BytePlus RealFace asset IDs from the RealFace tool (after H5 liveness +
+// enrollment). Format: `ta_` + alphanumeric.
+const REAL_FACE_ASSET_ID_REGEX = /^ta_[A-Za-z0-9]+$/;
+const REAL_FACE_MODELS = new Set([
+    'bytedance/seedance-2.0',
+    'bytedance/seedance-2.0-fast',
+]);
 const DEFAULT_MODEL = 'xai/grok-imagine-video';
 const DEFAULT_DURATION = 8;
 const PRICE_PER_SECOND_USD = 0.05;
@@ -44,9 +51,33 @@ function estimateVideoCostUsd(durationSeconds = DEFAULT_DURATION) {
 function buildExecute(deps) {
     return async function execute(input, ctx) {
         const rawInput = input;
-        const { output_path, model, image_url, duration_seconds, contentId, aspect_ratio } = rawInput;
+        const { output_path, model, image_url, duration_seconds, contentId, aspect_ratio, real_face_asset_id } = rawInput;
         if (!rawInput.prompt)
             return { output: 'Error: prompt is required', isError: true };
+        // RealFace asset client-side validations (the gateway 400s on the same
+        // conditions but a local check is friendlier — and the rejected request
+        // doesn't burn an x402 round-trip).
+        if (real_face_asset_id !== undefined) {
+            if (typeof real_face_asset_id !== 'string' || !REAL_FACE_ASSET_ID_REGEX.test(real_face_asset_id)) {
+                return {
+                    output: `Error: real_face_asset_id must match "ta_<alphanumeric>" (e.g. ta_abc123). Enroll one with the RealFace tool. Got: ${JSON.stringify(real_face_asset_id)}`,
+                    isError: true,
+                };
+            }
+            const chosenModel = model || DEFAULT_MODEL;
+            if (!REAL_FACE_MODELS.has(chosenModel)) {
+                return {
+                    output: `Error: real_face_asset_id is only supported on Seedance 2.0 variants (${[...REAL_FACE_MODELS].join(', ')}). Current model: ${chosenModel}.`,
+                    isError: true,
+                };
+            }
+            if (image_url) {
+                return {
+                    output: 'Error: real_face_asset_id and image_url both seed the first frame — pick one. Drop image_url to use RealFace, or drop real_face_asset_id to use the image.',
+                    isError: true,
+                };
+            }
+        }
         // Resolve image_url before sending. The gateway requires a URL (http(s)
         // or data: URI), but agents naturally pass a local file path —
         // verified 2026-05-04 in a live session: agent passed
@@ -162,6 +193,10 @@ function buildExecute(deps) {
             // value, the 400 body surfaces via 3.15.45 diagnostic so the agent
             // can drop the param and retry.
             ...(aspect_ratio ? { aspect_ratio } : {}),
+            // RealFace (BytePlus, Seedance 2.0 only) — seeds the first frame from
+            // a real-person asset for cross-frame character consistency. Client
+            // already validated the ID + model gate above; just pass through.
+            ...(real_face_asset_id ? { real_face_asset_id } : {}),
         });
         const headers = {
             'Content-Type': 'application/json',
@@ -502,6 +537,14 @@ export function createVideoGenCapability(deps = {}) {
                             'error body surfaces — drop the param and retry.',
                     },
                     contentId: { type: 'string', description: 'Optional Content id to attach and budget against.' },
+                    real_face_asset_id: {
+                        type: 'string',
+                        description: 'Optional BytePlus RealFace asset id (format `ta_<alphanumeric>`) for cross-frame ' +
+                            'character consistency from a real person. Enroll one with the RealFace tool ' +
+                            '(init → phone liveness → enroll). Seedance 2.0 variants only (bytedance/seedance-2.0, ' +
+                            'bytedance/seedance-2.0-fast). Mutually exclusive with image_url — both seed the ' +
+                            'first frame; pick one.',
+                    },
                 },
                 required: ['prompt'],
             },

package/dist/ui/model-picker.js

@@ -19,7 +19,8 @@ export const MODEL_SHORTCUTS = {
     sonnet: 'anthropic/claude-sonnet-4.6',
     claude: 'anthropic/claude-sonnet-4.6',
     'sonnet-4.6': 'anthropic/claude-sonnet-4.6',
-    opus: 'anthropic/claude-opus-4.7',
+    opus: 'anthropic/claude-opus-4.8',
+    'opus-4.8': 'anthropic/claude-opus-4.8',
     'opus-4.7': 'anthropic/claude-opus-4.7',
     'opus-4.6': 'anthropic/claude-opus-4.6',
     haiku: 'anthropic/claude-haiku-4.5-20251001',
@@ -149,7 +150,7 @@ export const PICKER_CATEGORIES = [
         // free-tier entries and v3.9.2 used to retire Kimi K2.5.
         category: '✨ Premium frontier',
         models: [
-            { id: 'anthropic/claude-opus-4.7', shortcut: 'opus', label: 'Claude Opus 4.7', price: '$5/$25', highlight: true },
+            { id: 'anthropic/claude-opus-4.8', shortcut: 'opus', label: 'Claude Opus 4.8', price: '$5/$25', highlight: true },
             { id: 'anthropic/claude-sonnet-4.6', shortcut: 'sonnet', label: 'Claude Sonnet 4.6', price: '$3/$15' },
             { id: 'openai/gpt-5.5', shortcut: 'gpt', label: 'GPT-5.5', price: '$5/$30', highlight: true },
             { id: 'google/gemini-3.1-pro', shortcut: 'gemini-3', label: 'Gemini 3.1 Pro', price: '$2/$12' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/franklin",
-  "version": "3.21.9",
+  "version": "3.23.0",
   "description": "Franklin Agent — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
   "type": "module",
   "exports": {
@@ -31,7 +31,7 @@
     "build": "tsc && node scripts/copy-plugin-assets.mjs",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
-    "test": "npm run build && node --test --test-reporter=spec test/local.mjs test/skills.local.mjs",
+    "test": "npm run build && node --test --test-reporter=spec test/local.mjs test/skills.local.mjs test/repair.mjs",
     "test:e2e": "npm run build && node --test --test-reporter=spec test/e2e.mjs",
     "test:free-models": "npm run build && node --test --test-reporter=spec test/free-model-matrix.mjs",
     "test:all": "npm run test && npm run test:e2e",