@blockrun/franklin 3.21.1 → 3.21.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/panel/html.js +2 -2
  2. package/dist/tools/videogen.js +44 -1
  3. package/package.json +1 -1
package/dist/panel/html.js CHANGED
@@ -10,7 +10,7 @@ export function getHTML() {
10
10
  <head>
11
11
  <meta charset="utf-8">
12
12
  <meta name="viewport" content="width=device-width, initial-scale=1">
13
- <title>Franklin Panel</title>
13
+ <title>Franklin Agent Panel</title>
14
14
  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg width='100' height='100' viewBox='0 0 100 100' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Crect x='30' y='20' width='55' height='60' rx='14' stroke='white' stroke-width='8' fill='none'/%3E%3Cpath d='M15 35 L25 35' stroke='white' stroke-width='6' stroke-linecap='round'/%3E%3Cpath d='M10 50 L25 50' stroke='white' stroke-width='6' stroke-linecap='round'/%3E%3Cpath d='M15 65 L25 65' stroke='white' stroke-width='6' stroke-linecap='round'/%3E%3C/svg%3E">
15
15
  <link rel="preconnect" href="https://fonts.googleapis.com">
16
16
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
@@ -489,7 +489,7 @@ a:hover { text-decoration:underline; }
489
489
  <div class="sidebar-header">
490
490
  <div class="sidebar-brand">
491
491
  <div class="icon"><img src="/assets/franklin-portrait.jpg" alt="F"></div>
492
- <h1>Franklin</h1>
492
+ <h1>Franklin Agent</h1>
493
493
  </div>
494
494
  <div class="sidebar-sub">by <span style="color:var(--success)">BlockRun.ai</span></div>
495
495
  <div class="sidebar-status">
package/dist/tools/videogen.js CHANGED
@@ -28,6 +28,13 @@ import { ModelClient } from '../agent/llm.js';
28
28
  import { analyzeMediaRequest, renderProposalForAskUser } from '../agent/media-router.js';
29
29
  import { recordUsage } from '../stats/tracker.js';
30
30
  import { findModel, estimateCostUsd } from '../gateway-models.js';
31
+ // BytePlus RealFace asset IDs from token360 Asset UI (after H5 verification).
32
+ // Format: `ta_` + alphanumeric.
33
+ const REAL_FACE_ASSET_ID_REGEX = /^ta_[A-Za-z0-9]+$/;
34
+ const REAL_FACE_MODELS = new Set([
35
+ 'bytedance/seedance-2.0',
36
+ 'bytedance/seedance-2.0-fast',
37
+ ]);
31
38
  const DEFAULT_MODEL = 'xai/grok-imagine-video';
32
39
  const DEFAULT_DURATION = 8;
33
40
  const PRICE_PER_SECOND_USD = 0.05;
@@ -44,9 +51,33 @@ function estimateVideoCostUsd(durationSeconds = DEFAULT_DURATION) {
44
51
  function buildExecute(deps) {
45
52
  return async function execute(input, ctx) {
46
53
  const rawInput = input;
47
- const { output_path, model, image_url, duration_seconds, contentId, aspect_ratio } = rawInput;
54
+ const { output_path, model, image_url, duration_seconds, contentId, aspect_ratio, real_face_asset_id } = rawInput;
48
55
  if (!rawInput.prompt)
49
56
  return { output: 'Error: prompt is required', isError: true };
57
+ // RealFace asset client-side validations (the gateway 400s on the same
58
+ // conditions but a local check is friendlier — and the rejected request
59
+ // doesn't burn an x402 round-trip).
60
+ if (real_face_asset_id !== undefined) {
61
+ if (typeof real_face_asset_id !== 'string' || !REAL_FACE_ASSET_ID_REGEX.test(real_face_asset_id)) {
62
+ return {
63
+ output: `Error: real_face_asset_id must match "ta_<alphanumeric>" (e.g. ta_abc123). Got: ${JSON.stringify(real_face_asset_id)}`,
64
+ isError: true,
65
+ };
66
+ }
67
+ const chosenModel = model || DEFAULT_MODEL;
68
+ if (!REAL_FACE_MODELS.has(chosenModel)) {
69
+ return {
70
+ output: `Error: real_face_asset_id is only supported on Seedance 2.0 variants (${[...REAL_FACE_MODELS].join(', ')}). Current model: ${chosenModel}.`,
71
+ isError: true,
72
+ };
73
+ }
74
+ if (image_url) {
75
+ return {
76
+ 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.',
77
+ isError: true,
78
+ };
79
+ }
80
+ }
50
81
  // Resolve image_url before sending. The gateway requires a URL (http(s)
51
82
  // or data: URI), but agents naturally pass a local file path —
52
83
  // verified 2026-05-04 in a live session: agent passed
@@ -162,6 +193,10 @@ function buildExecute(deps) {
162
193
  // value, the 400 body surfaces via 3.15.45 diagnostic so the agent
163
194
  // can drop the param and retry.
164
195
  ...(aspect_ratio ? { aspect_ratio } : {}),
196
+ // RealFace (BytePlus, Seedance 2.0 only) — seeds the first frame from
197
+ // a real-person asset for cross-frame character consistency. Client
198
+ // already validated the ID + model gate above; just pass through.
199
+ ...(real_face_asset_id ? { real_face_asset_id } : {}),
165
200
  });
166
201
  const headers = {
167
202
  'Content-Type': 'application/json',
@@ -502,6 +537,14 @@ export function createVideoGenCapability(deps = {}) {
502
537
  'error body surfaces — drop the param and retry.',
503
538
  },
504
539
  contentId: { type: 'string', description: 'Optional Content id to attach and budget against.' },
540
+ real_face_asset_id: {
541
+ type: 'string',
542
+ description: 'Optional BytePlus RealFace asset id (format `ta_<alphanumeric>`) for cross-frame ' +
543
+ 'character consistency. Users get asset IDs from token360\'s Asset UI after H5 ' +
544
+ 'verification. Seedance 2.0 variants only (bytedance/seedance-2.0, ' +
545
+ 'bytedance/seedance-2.0-fast). Mutually exclusive with image_url — both seed the ' +
546
+ 'first frame; pick one.',
547
+ },
505
548
  },
506
549
  required: ['prompt'],
507
550
  },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@blockrun/franklin",
3
- "version": "3.21.1",
3
+ "version": "3.21.2",
4
4
  "description": "Franklin Agent — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
5
5
  "type": "module",
6
6
  "exports": {