@blockrun/franklin 3.15.57 → 3.15.59

package/dist/commands/content.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `franklin content` CLI surface — human-facing read access to the
+ * Content library that lives at ~/.blockrun/content.json.
+ *
+ * Tools (ContentCreate / ContentAddAsset) write the library during agent
+ * sessions; before this command, there was no way to see the resulting
+ * spend without scripting against the JSON file. Verified 2026-05-04 in
+ * a live session: user asked "我花了多少钱做这个", agent ran
+ * `franklin content list` and got "no content subcommand", fell back to
+ * estimating from memory.
+ *
+ * Subcommands:
+ *   - list             : table of id, type, title, status, spent/budget, assets
+ *   - show <idOrPrefix>: full detail of one Content, including each asset
+ */
+import { Command } from 'commander';
+export declare function buildContentCommand(): Command;

package/dist/commands/content.js

@@ -0,0 +1,141 @@
+/**
+ * `franklin content` CLI surface — human-facing read access to the
+ * Content library that lives at ~/.blockrun/content.json.
+ *
+ * Tools (ContentCreate / ContentAddAsset) write the library during agent
+ * sessions; before this command, there was no way to see the resulting
+ * spend without scripting against the JSON file. Verified 2026-05-04 in
+ * a live session: user asked "我花了多少钱做这个", agent ran
+ * `franklin content list` and got "no content subcommand", fell back to
+ * estimating from memory.
+ *
+ * Subcommands:
+ *   - list             : table of id, type, title, status, spent/budget, assets
+ *   - show <idOrPrefix>: full detail of one Content, including each asset
+ */
+import os from 'node:os';
+import path from 'node:path';
+import { Command } from 'commander';
+import { loadLibrary } from '../content/store.js';
+const DEFAULT_PATH = path.join(os.homedir(), '.blockrun', 'content.json');
+function fmtUsd(n) {
+    return `$${n.toFixed(2)}`;
+}
+/**
+ * Resolve a user-typed id-or-prefix to a single Content record. Returns
+ * either the matching record or an error message; the caller prints.
+ *
+ * Accepts the full UUID, a prefix (≥4 chars), or — for convenience — a
+ * substring match against the title (case-insensitive). Ambiguity returns
+ * the candidates so the user can disambiguate without rerunning blind.
+ */
+function resolveContent(all, input) {
+    const q = input.trim();
+    if (!q)
+        return { error: 'Provide an id, id-prefix, or title substring.' };
+    const exact = all.find(c => c.id === q);
+    if (exact)
+        return { found: exact };
+    const prefix = q.length >= 4 ? all.filter(c => c.id.startsWith(q)) : [];
+    if (prefix.length === 1)
+        return { found: prefix[0] };
+    if (prefix.length > 1) {
+        return { error: `Ambiguous prefix "${q}" — matches:\n${prefix.map(c => `  ${c.id}  ${c.title}`).join('\n')}` };
+    }
+    const lower = q.toLowerCase();
+    const titled = all.filter(c => c.title.toLowerCase().includes(lower));
+    if (titled.length === 1)
+        return { found: titled[0] };
+    if (titled.length > 1) {
+        return { error: `Ambiguous title "${q}" — matches:\n${titled.map(c => `  ${c.id}  ${c.title}`).join('\n')}` };
+    }
+    return { error: `No Content matches "${q}".` };
+}
+export function buildContentCommand() {
+    const cmd = new Command('content').description('Inspect Content library (assets, spend, budget)');
+    cmd
+        .command('list')
+        .description('List all Content records, newest first')
+        .action(() => {
+        const lib = loadLibrary(DEFAULT_PATH);
+        if (!lib) {
+            console.log('No Content library yet. Tools like ContentCreate populate it during agent sessions.');
+            return;
+        }
+        const all = lib.list();
+        if (all.length === 0) {
+            console.log('No Content records.');
+            return;
+        }
+        // Header + rows. Truncate id to 8-char prefix and title to 40 chars
+        // so common terminal widths (80-100) fit a row on one line.
+        console.log(['id'.padEnd(8), 'type'.padEnd(8), 'status'.padEnd(10), 'spent/cap'.padEnd(13), 'assets', 'title'].join('  '));
+        for (const c of all) {
+            const id8 = c.id.slice(0, 8);
+            const spend = `${fmtUsd(c.spentUsd)}/${fmtUsd(c.budgetUsd)}`;
+            const title = c.title.length > 40 ? c.title.slice(0, 39) + '…' : c.title;
+            console.log([
+                id8.padEnd(8),
+                c.type.padEnd(8),
+                c.status.padEnd(10),
+                spend.padEnd(13),
+                String(c.assets.length).padEnd(6),
+                title,
+            ].join('  '));
+        }
+        // Footer with rolled-up spend.
+        const totalSpent = all.reduce((s, c) => s + c.spentUsd, 0);
+        const totalBudget = all.reduce((s, c) => s + c.budgetUsd, 0);
+        console.log();
+        console.log(`Total: ${fmtUsd(totalSpent)} spent across ${all.length} content${all.length === 1 ? '' : 's'} (cap ${fmtUsd(totalBudget)}).`);
+    });
+    cmd
+        .command('show <idOrPrefix>')
+        .description('Show full detail for one Content record (id, prefix, or title substring)')
+        .action((input) => {
+        const lib = loadLibrary(DEFAULT_PATH);
+        if (!lib) {
+            console.log('No Content library yet.');
+            process.exit(1);
+        }
+        const result = resolveContent(lib.list(), input);
+        if ('error' in result) {
+            console.error(result.error);
+            process.exit(1);
+        }
+        const c = result.found;
+        console.log(`# ${c.title}`);
+        console.log();
+        console.log(`id:        ${c.id}`);
+        console.log(`type:      ${c.type}`);
+        console.log(`status:    ${c.status}`);
+        console.log(`spent:     ${fmtUsd(c.spentUsd)} / ${fmtUsd(c.budgetUsd)} cap`);
+        console.log(`created:   ${new Date(c.createdAt).toISOString()}`);
+        if (c.publishedAt)
+            console.log(`published: ${new Date(c.publishedAt).toISOString()}`);
+        console.log();
+        if (c.assets.length > 0) {
+            console.log(`## Assets (${c.assets.length})`);
+            for (const a of c.assets) {
+                console.log(`- ${a.kind.padEnd(6)} ${fmtUsd(a.costUsd).padStart(7)}  ${a.source}`);
+                console.log(`    ${a.data}`);
+            }
+            console.log();
+        }
+        if (c.drafts.length > 0) {
+            console.log(`## Drafts (${c.drafts.length})`);
+            c.drafts.forEach((d, i) => {
+                const preview = d.text.length > 80 ? d.text.slice(0, 79) + '…' : d.text;
+                console.log(`- #${i + 1}  ${preview}`);
+            });
+            console.log();
+        }
+        if (c.distribution.length > 0) {
+            console.log(`## Distribution (${c.distribution.length})`);
+            for (const dist of c.distribution) {
+                console.log(`- ${dist.channel}${dist.url ? `  ${dist.url}` : ''}  (${new Date(dist.at).toISOString()})`);
+            }
+        }
+    });
+    return cmd;
+}

package/dist/index.js

@@ -24,6 +24,7 @@ import { initCommand } from './commands/init.js';
 import { uninitCommand } from './commands/uninit.js';
 import { proxyCommand } from './commands/proxy.js';
 import { buildTaskCommand } from './commands/task.js';
+import { buildContentCommand } from './commands/content.js';
 import { VERSION as version } from './config.js';
 const program = new Command();
 program
@@ -221,6 +222,10 @@ program
 // `franklin task <subcmd>` — human-facing CLI for detached background tasks.
 // Defined in src/commands/task.ts; subcommands: list, tail, cancel, wait.
 program.addCommand(buildTaskCommand());
+// `franklin content <subcmd>` — read access to the Content library
+// (~/.blockrun/content.json) so users + agent shell-outs can inspect
+// spend without scripting against the JSON file. Subcommands: list, show.
+program.addCommand(buildContentCommand());
 // Hidden internal subcommand — invoked by startDetachedTask via spawn(detached).
 // The underscore prefix signals "not for humans"; we still register it via
 // commander so exit codes and arg parsing stay consistent with the rest of

package/dist/tools/videogen.js

@@ -44,7 +44,7 @@ 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 } = rawInput;
+        const { output_path, model, image_url, duration_seconds, contentId, aspect_ratio } = rawInput;
         if (!rawInput.prompt)
             return { output: 'Error: prompt is required', isError: true };
         // Resolve image_url before sending. The gateway requires a URL (http(s)
@@ -156,6 +156,12 @@ function buildExecute(deps) {
             prompt: chosenPrompt,
             ...(resolvedImageUrl ? { image_url: resolvedImageUrl } : {}),
             ...(duration_seconds ? { duration_seconds } : {}),
+            // aspect_ratio passes through to the gateway. Models that support it
+            // (newer Seedance / grok variants) honor it; models that ignore it
+            // produce their default size. If the gateway rejects an unknown
+            // value, the 400 body surfaces via 3.15.45 diagnostic so the agent
+            // can drop the param and retry.
+            ...(aspect_ratio ? { aspect_ratio } : {}),
         });
         const headers = {
             'Content-Type': 'application/json',
@@ -456,7 +462,15 @@ export function createVideoGenCapability(deps = {}) {
                 "xai/grok-imagine-video bills $0.05/s (8s default ≈ $0.42). Generation " +
                 "takes ~20–60s. ALWAYS confirm with the user before calling — videos " +
                 "are expensive and slow. Pass contentId to attach to a Content piece " +
-                "(budget is checked before paying; asset is recorded on success).",
+                "(budget is checked before paying; asset is recorded on success). " +
+                "PLATFORM TARGETING: when the user says they'll post to X / Twitter, " +
+                "set aspect_ratio: '16:9' AND plan a follow-up `ffmpeg -vf scale=1280:720` " +
+                "step — X rejects videos under 720p with 'aspect ratio too small'. " +
+                "TikTok / Reels / Shorts: aspect_ratio '9:16'. Instagram Square: '1:1'. " +
+                "MODERATION: bytedance/seedance-* refuses photorealistic human faces " +
+                "(`InputImageSensitiveContentDetected.PrivacyInformation`); when the " +
+                "seed image has a real-looking person, use xai/grok-imagine-video " +
+                "instead, or regenerate the keyframe in a more stylized style first.",
             input_schema: {
                 type: 'object',
                 properties: {
@@ -471,6 +485,15 @@ export function createVideoGenCapability(deps = {}) {
                     },
                     image_url: { type: 'string', description: 'Optional seed image (image-to-video). Accepts http(s) URL, data: URI, or local file path — local paths get inlined as base64 data URIs automatically.' },
                     duration_seconds: { type: 'number', description: 'Duration billed for. Default depends on model (8s for grok-imagine-video).' },
+                    aspect_ratio: {
+                        type: 'string',
+                        description: 'Optional aspect ratio hint passed to the model. Common values: ' +
+                            '"16:9" (landscape — X/Twitter, YouTube, TikTok-landscape), ' +
+                            '"9:16" (vertical — TikTok, Reels, Shorts), ' +
+                            '"1:1" (square — Instagram feed). Models that don\'t support the ' +
+                            'param ignore it; if the gateway 400s on an unknown value, the ' +
+                            'error body surfaces — drop the param and retry.',
+                    },
                     contentId: { type: 'string', description: 'Optional Content id to attach and budget against.' },
                 },
                 required: ['prompt'],

package/package.json

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