storymode-cli 1.3.0 → 1.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "storymode-cli",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Play AI-animated pixel art characters in your terminal",
   "type": "module",
   "bin": {

package/src/api.mjs

@@ -25,7 +25,9 @@ function request(url) {
 
 export async function fetchGallery() {
   const { buffer } = await request(`${BASE}/gallery`);
-  return JSON.parse(buffer.toString('utf-8'));
+  const data = JSON.parse(buffer.toString('utf-8'));
+  // Handle both new {featured_id, curated_ids, items} and legacy bare array
+  return Array.isArray(data) ? { featured_id: null, curated_ids: null, items: data } : data;
 }
 
 export async function fetchFrames(galleryId, { size, mode, animId } = {}) {

package/src/browse.mjs

@@ -19,7 +19,8 @@ export async function browse() {
   const spinner = startSpinner('Fetching gallery...');
   let items;
   try {
-    items = await fetchGallery();
+    const gallery = await fetchGallery();
+    items = gallery.items;
   } finally {
     stopSpinner(spinner);
   }

package/src/cli.mjs

@@ -1,6 +1,9 @@
 import { execSync } from 'node:child_process';
 import { createInterface } from 'node:readline';
-import { fetchFrames, fetchCharacter, fetchPngFrames } from './api.mjs';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { fetchFrames, fetchCharacter, fetchPngFrames, fetchGallery } from './api.mjs';
 import { playAnimation, playCompanion, playReactiveCompanion, showFrame, playHdAnimation, detectGraphicsProtocol } from './player.mjs';
 import { browse } from './browse.mjs';
 import { startMcpServer } from './mcp.mjs';
@@ -111,12 +114,41 @@ function parseFlags(args) {
   return { flags, positional };
 }
 
-const DEFAULT_CHARACTER = 3; // Zephyr
+const DEFAULT_CHARACTER = 3; // Zephyr (fallback if server has no featured_id)
+const CONFIG_CACHE_PATH = join(homedir(), '.storymode', 'cache', 'gallery-config.json');
+
+/** Get the featured character ID: positional arg > cached config > fetch from server > fallback */
+async function resolveFeaturedId() {
+  // Try cached config first
+  try {
+    if (existsSync(CONFIG_CACHE_PATH)) {
+      const cached = JSON.parse(readFileSync(CONFIG_CACHE_PATH, 'utf-8'));
+      if (cached.featured_id != null) return cached.featured_id;
+    }
+  } catch { /* ignore corrupt cache */ }
+
+  // Fetch from server and cache
+  try {
+    const gallery = await fetchGallery();
+    const cacheDir = join(homedir(), '.storymode', 'cache');
+    mkdirSync(cacheDir, { recursive: true });
+    writeFileSync(CONFIG_CACHE_PATH, JSON.stringify({
+      featured_id: gallery.featured_id,
+      curated_ids: gallery.curated_ids,
+    }));
+    if (gallery.featured_id != null) return gallery.featured_id;
+  } catch { /* network failure — fall through */ }
+
+  return DEFAULT_CHARACTER;
+}
 
 export async function run(args) {
   const cmd = args[0];
   const { flags, positional } = parseFlags(args.slice(1));
-  const id = positional[0] || (cmd === 'play' || cmd === 'companion' ? DEFAULT_CHARACTER : undefined);
+  let id = positional[0];
+  if (!id && (cmd === 'play' || cmd === 'companion')) {
+    id = await resolveFeaturedId();
+  }
 
   switch (cmd) {
     // --- Main command: reactive companion ---
@@ -167,8 +199,12 @@ export async function run(args) {
       const reactive = !flags['no-reactive'];
 
       // Auto-detect graphics protocol for HD rendering
+      // iTerm2 inside tmux can't clear previous inline images (no equivalent of
+      // Kitty's a=d,d=a — \x1b[2J is intercepted by tmux, not forwarded to iTerm2).
+      // So HD only works for: Kitty/Ghostty (any context) or iTerm2 (direct, no tmux).
       const renderMode = detectGraphicsProtocol();
-      const useHd = !!renderMode.protocol; // auto-detect only
+      const useHd = renderMode.protocol === 'kitty'
+        || (renderMode.protocol === 'iterm2' && !renderMode.inTmux);
       const paneWidth = useHd && size === 'full' ? 80 : size === 'full' ? 62 : size === 'tiny' ? 14 : 22;
 
       // If we're already the companion pane (spawned by tmux split), play inline

package/src/mcp.mjs

@@ -47,7 +47,8 @@ function findAnimation(animations, query) {
 async function handleToolCall(name, args) {
   switch (name) {
     case 'list_characters': {
-      const items = await fetchGallery();
+      const gallery = await fetchGallery();
+      const items = gallery.items;
       if (!items.length) return 'Gallery is empty.';
       const chars = await Promise.all(
         items.map(item => fetchCharacter(item.id).catch(() => null))

package/src/player.mjs

@@ -751,10 +751,10 @@ export function detectGraphicsProtocol() {
       // Map client_termname back to protocol
       if (clientTerm === 'xterm-ghostty') return { protocol: 'kitty', inTmux };
       if (clientTerm.includes('kitty')) return { protocol: 'kitty', inTmux };
-      // For iTerm2, client_termname is usually "xterm-256color" — check LC_TERMINAL
-      const lcTerminal = process.env.LC_TERMINAL || '';
-      if (lcTerminal === 'iTerm2') return { protocol: 'iterm2', inTmux };
-    } catch { /* fall through to env-based detection */ }
+    } catch { /* tmux command failed — fall through */ }
+    // LC_TERMINAL survives tmux env overwriting (iTerm2 sets it)
+    const lcTerminal = process.env.LC_TERMINAL || '';
+    if (lcTerminal === 'iTerm2') return { protocol: 'iterm2', inTmux };
   }
 
   if (kittyId) return { protocol: 'kitty', inTmux };