@dfosco/storyboard 0.6.0-beta.4 → 0.6.0-beta.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dfosco/storyboard",
-  "version": "0.6.0-beta.4",
+  "version": "0.6.0-beta.6",
   "type": "module",
   "license": "MIT",
   "description": "Storyboard prototyping framework — core engine, React integration, and canvas",
@@ -21,7 +21,8 @@
     "toolbar.config.json",
     "widgets.config.json",
     "paste.config.json",
-    "commandpalette.config.json"
+    "commandpalette.config.json",
+    "terminal.config.json"
   ],
   "scripts": {
     "build:css": "tailwindcss -i src/core/styles/tailwind.css -o dist/tailwind.css --minify",

package/scaffold/gitignore

@@ -52,8 +52,18 @@ packages/core/dist/storyboard-ui.*
 # Agent Browser
 agent-browser.json
 
-# Selected widgets bridge (real-time canvas selection for Copilot)
-.storyboard
+# Auto-generated scaffold dir (copies of library config defaults — overwritten on every dev-server boot)
+.storyboard/scaffold/
+
+# Real-time canvas selection bridge for Copilot
+.storyboard/.selectedwidgets.json
+
+# Runtime/transient state (per-machine, per-session)
+.storyboard/agent-sessions/
+.storyboard/hot-pool/
+.storyboard/logs/
+.storyboard/terminal-buffers/
+.storyboard/messages/
 
 # Private canvas images (tilde prefix = not committed)
 src/canvas/images/~*

package/scaffold/skills/migrate/SKILL.md

@@ -37,65 +37,81 @@ The storyboard homepage URL changed from `/viewfinder` to `/workspace`. The old
 
 #### 2. Canvas config — terminal + agents + hot pool
 
-Clients on 4.1.x likely have no `canvas` block at all. The full canvas config is required for terminal widgets, agent widgets, and prompt widgets to work on canvases.
+**As of `0.6.0-beta.4`, terminal + agent config has its own dedicated file: `terminal.config.json` at the project root.** The library ships full defaults in `node_modules/@dfosco/storyboard/terminal.config.json` and a copy is auto-scaffolded to `.storyboard/scaffold/terminal.config.json` on every dev-server boot. Most clients won't need any project-level config — the defaults already cover Copilot/Claude/Codex with auto-resume.
 
-**Read the client's `storyboard.config.json`.** If the `canvas` key is missing or incomplete, merge the missing sections. Here is the complete reference config — adapt values to the client's environment:
+**Only create a root `terminal.config.json`** if you want to override specific keys. Leaf-level merge means you set only what you change; everything else inherits the library defaults (so future agents and tweaks reach you automatically). Example minimal override:
 
 ```jsonc
 {
-  "canvas": {
-    // Terminal widget settings (the plain terminal, not agents)
-    "terminal": {
-      "fontSize": 18,
-      "fontFamily": "'SF Mono', 'Menlo', 'Monaco', 'Courier New', monospace",
-      "prompt": "❯ ",
-      "startupCommand": null,
-      "defaultStartupSequence": null,
-      "resizable": true,
-      "defaultWidth": 1000,
-      "defaultHeight": 600
-    },
+  "terminal": {
+    "fontSize": 18,
+    "fontFamily": "'Ghostty', 'SF Mono', monospace"
+  },
+  "agents": {
+    "copilot": {
+      "startupCommand": "copilot --remote --agent terminal-agent"
+    }
+  }
+}
+```
+
+**Legacy back-compat.** Existing clients with `canvas.terminal` and `canvas.agents` blocks under `storyboard.config.json` continue to work — the loader merges them with the new file (with `terminal.config.json` winning on overlap, and a warning logged). New clients should prefer `terminal.config.json` and keep `storyboard.config.json` lean.
 
-    // Agent widgets — each key becomes an entry in the "Add Agent" menu
-    // Remove any agents the client doesn't have installed
-    "agents": {
-      "copilot": {
-        "label": "Copilot CLI",
-        "default": true,
-        "icon": "primer/copilot",
-        "startupCommand": "copilot --agent terminal-agent",
-        "resumeCommand": "copilot --resume={id} --agent terminal-agent",
-        "sessionIdEnv": "COPILOT_AGENT_SESSION_ID",
-        "postStartup": "/allow-all on",
-        "readinessSignal": "Environment loaded:",
-        "resizable": true
-      },
-      "claude": {
-        "label": "Claude Code",
-        "icon": "claude",
-        "startupCommand": "claude --agent terminal-agent --dangerously-skip-permissions",
-        "resumeCommand": "claude --resume {id} --agent terminal-agent --dangerously-skip-permissions",
-        "sessionIdEnv": "CLAUDE_SESSION_ID",
-        "sessionStateGlob": "~/.claude/projects/*/{id}.jsonl",
-        "resizable": true,
-        "readinessSignal": "bypass permissions"
-      },
-      "codex": {
-        "label": "Codex CLI",
-        "icon": "codex",
-        "startupCommand": "codex --full-auto",
-        "resumeCommand": "codex resume {id}",
-        "sessionIdEnv": "CODEX_SESSION_ID",
-        "sessionStateGlob": "~/.codex/sessions/**/rollout-*-{id}.jsonl",
-        "configFiles": [".codex/config.toml"],
-        "resizable": true
-      }
+**Full reference for what `terminal.config.json` accepts** (don't copy this into a new project unless you actually need to override every key — the library ships these as defaults):
+
+```jsonc
+{
+  // Terminal widget settings (the plain terminal, not agents)
+  "terminal": {
+    "fontSize": 18,
+    "fontFamily": "'SF Mono', 'Menlo', 'Monaco', 'Courier New', monospace",
+    "prompt": "❯ ",
+    "startupCommand": null,
+    "defaultStartupSequence": null,
+    "resizable": true,
+    "defaultWidth": 1000,
+    "defaultHeight": 600
+  },
+
+  // Agent widgets — each key becomes an entry in the "Add Agent" menu
+  // Remove any agents the client doesn't have installed
+  "agents": {
+    "copilot": {
+      "label": "Copilot CLI",
+      "default": true,
+      "icon": "primer/copilot",
+      "startupCommand": "copilot --agent terminal-agent",
+      "resumeCommand": "copilot --resume={id} --agent terminal-agent",
+      "sessionIdEnv": "COPILOT_AGENT_SESSION_ID",
+      "postStartup": "/allow-all on",
+      "readinessSignal": "Environment loaded:",
+      "resizable": true
     },
+    "claude": {
+      "label": "Claude Code",
+      "icon": "claude",
+      "startupCommand": "claude --agent terminal-agent --dangerously-skip-permissions",
+      "resumeCommand": "claude --resume {id} --agent terminal-agent --dangerously-skip-permissions",
+      "sessionIdEnv": "CLAUDE_SESSION_ID",
+      "sessionStateGlob": "~/.claude/projects/*/{id}.jsonl",
+      "resizable": true,
+      "readinessSignal": "bypass permissions"
+    },
+    "codex": {
+      "label": "Codex CLI",
+      "icon": "codex",
+      "startupCommand": "codex --full-auto",
+      "resumeCommand": "codex resume {id}",
+      "sessionIdEnv": "CODEX_SESSION_ID",
+      "sessionStateGlob": "~/.codex/sessions/**/rollout-*-{id}.jsonl",
+      "configFiles": [".codex/config.toml"],
+      "resizable": true
+    }
+  },
 
-    // Set to true to show agent entries in the canvas "+" add menu
-    // Set to false to only show them in the command palette
-    "showAgentsInAddMenu": false
-  }
+  // Set to true to show agent entries in the canvas "+" add menu
+  // Set to false to only show them in the command palette
+  "showAgentsInAddMenu": false
 }
 ```
 

package/scaffold/storyboard.config.json

@@ -33,39 +33,6 @@
       "resizable": false,
       "defaultWidth": 800,
       "defaultHeight": 450
-    },
-    "agents": {
-      "copilot": {
-        "label": "Copilot CLI",
-        "default": true,
-        "icon": "primer/copilot",
-        "startupCommand": "copilot --agent terminal-agent",
-        "resumeCommand": "copilot --resume={id} --agent terminal-agent",
-        "sessionIdEnv": "COPILOT_AGENT_SESSION_ID",
-        "postStartup": "/allow-all on",
-        "readinessSignal": "Environment loaded:",
-        "resizable": true
-      },
-      "claude": {
-        "label": "Claude Code",
-        "icon": "claude",
-        "startupCommand": "claude --agent terminal-agent --dangerously-skip-permissions",
-        "resumeCommand": "claude --resume {id} --agent terminal-agent --dangerously-skip-permissions",
-        "sessionIdEnv": "CLAUDE_SESSION_ID",
-        "sessionStateGlob": "~/.claude/projects/*/{id}.jsonl",
-        "readinessSignal": "bypass permissions",
-        "resizable": true
-      },
-      "codex": {
-        "label": "Codex CLI",
-        "icon": "codex",
-        "startupCommand": "codex --ask-for-approval never",
-        "resumeCommand": "codex resume {id}",
-        "sessionIdEnv": "CODEX_SESSION_ID",
-        "sessionStateGlob": "~/.codex/sessions/**/rollout-*-{id}.jsonl",
-        "configFiles": [".codex/config.toml"],
-        "resizable": true
-      }
     }
   },
   "customerMode": {

package/src/core/canvas/agent-session.js

@@ -11,11 +11,11 @@
  *
  * A watcher on the per-widget capture file persists the captured id onto
  * the widget's terminal config as `lastAgentSessionId`. On the next cold
- * restart, the launch is rewritten to `copilot --resume=<id> --agent ...`,
- * with a pre-flight check that the session-state directory still exists
- * (copilot exits non-interactively when `--resume=<id>` doesn't match an
- * existing session, so we can't rely on `||` shell fallback — we have to
- * pre-validate).
+ * restart, the launch is rewritten to `copilot --resume=<id> --agent ...`
+ * (with a pre-flight check that the on-disk session still exists), and is
+ * shell-chained with a `|| <fresh-startup>` fallback so that if the agent
+ * CLI rejects the id at runtime the widget still ends up with a working
+ * fresh session instead of a dead terminal.
  */
 
 import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, watch as fsWatch, readdirSync, statSync } from 'node:fs'
@@ -220,7 +220,16 @@ export function buildResumeStartupCommand({ startupCommand, sessionId, agentCfg
   const template = agentCfg?.resumeCommand
   if (!template || !template.includes('{id}')) return startupCommand
 
-  return template.replace('{id}', sessionId)
+  const resumeCmd = template.replace('{id}', sessionId)
+
+  // Graceful fallback: if the resume command exits non-zero (e.g. the agent
+  // CLI rejected the id, the on-disk session is corrupt, or the binary
+  // doesn't actually support resume the way we expect), fall through to a
+  // fresh session instead of leaving the widget with a dead terminal.
+  // A clean exit (user `/exit`s) returns 0 and skips the fallback.
+  if (agentCfg?.resumeFallback === false) return resumeCmd
+  const notice = `printf '\\n\\033[33m[storyboard] resume failed; starting fresh session...\\033[0m\\n'`
+  return `${resumeCmd} || { ${notice}; ${startupCommand}; }`
 }
 
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i

package/src/core/canvas/agent-session.test.js

@@ -82,7 +82,7 @@ describe('agent-session', () => {
       expect(out).toBe('copilot --agent terminal-agent')
     })
 
-    it('substitutes {id} into resumeCommand when valid', () => {
+    it('substitutes {id} into resumeCommand and chains a fresh-session fallback', () => {
       const out = buildResumeStartupCommand({
         startupCommand: 'copilot --agent terminal-agent',
         sessionId: '11111111-2222-4333-8444-555555555555',
@@ -91,6 +91,21 @@ describe('agent-session', () => {
           resumeCommand: 'copilot --resume={id} --agent terminal-agent',
         },
       })
+      expect(out).toContain('copilot --resume=11111111-2222-4333-8444-555555555555 --agent terminal-agent')
+      expect(out).toContain('|| {')
+      expect(out).toContain('copilot --agent terminal-agent')
+    })
+
+    it('skips the fallback when resumeFallback: false', () => {
+      const out = buildResumeStartupCommand({
+        startupCommand: 'copilot --agent terminal-agent',
+        sessionId: '11111111-2222-4333-8444-555555555555',
+        agentCfg: {
+          sessionStateDir: null,
+          resumeCommand: 'copilot --resume={id} --agent terminal-agent',
+          resumeFallback: false,
+        },
+      })
       expect(out).toBe('copilot --resume=11111111-2222-4333-8444-555555555555 --agent terminal-agent')
     })
 

package/src/core/canvas/configReader.js

@@ -0,0 +1,110 @@
+/**
+ * Server-side reader for terminal + agents config.
+ *
+ * Replaces direct `JSON.parse(readFileSync('storyboard.config.json')).canvas.agents`
+ * reads in terminal-server / hot-pool / canvas server / terminal-welcome /
+ * server-plugin so the new `terminal.config.json` (and the library's default
+ * one shipped under `node_modules/@dfosco/storyboard/terminal.config.json`)
+ * is honored everywhere with leaf-level merge.
+ *
+ * Resolution order (lowest → highest priority), all leaf-merged:
+ *   1. Library default `<root>/{packages/storyboard,node_modules/@dfosco/storyboard}/terminal.config.json`
+ *   2. `storyboard.config.json` `canvas.terminal` + `canvas.agents` (legacy)
+ *   3. Root `terminal.config.json`
+ *
+ * Returns `{ terminal, agents, showAgentsInAddMenu }`. Empty objects when
+ * nothing is configured (rather than null) so callers can spread freely.
+ */
+
+import { readFileSync, existsSync } from 'node:fs'
+import { resolve, join } from 'node:path'
+
+/** Same shape as data-plugin's `deepMergeBuild`. */
+function deepMerge(target, source) {
+  if (!source || typeof source !== 'object') return target
+  if (!target || typeof target !== 'object') return source
+  const result = { ...target }
+  for (const key of Object.keys(source)) {
+    const sv = source[key]
+    const tv = target[key]
+    if (sv && typeof sv === 'object' && !Array.isArray(sv) && tv && typeof tv === 'object' && !Array.isArray(tv)) {
+      result[key] = deepMerge(tv, sv)
+    } else {
+      result[key] = sv
+    }
+  }
+  return result
+}
+
+function readJson(filePath) {
+  try {
+    return JSON.parse(readFileSync(filePath, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+function resolveLibTerminalConfig(root) {
+  const candidates = [
+    join(root, 'packages', 'storyboard', 'terminal.config.json'),
+    join(root, 'node_modules', '@dfosco', 'storyboard', 'terminal.config.json'),
+  ]
+  for (const p of candidates) {
+    if (existsSync(p)) {
+      const parsed = readJson(p)
+      if (parsed) return parsed
+    }
+  }
+  return null
+}
+
+/**
+ * Read the merged terminal + agents + hotPool config for a project root.
+ *
+ * @param {string} [root] - Project root, defaults to `process.cwd()`.
+ * @returns {{ terminal: object, agents: object, showAgentsInAddMenu: boolean|undefined, hotPool: object }}
+ */
+export function readTerminalConfigMerged(root = process.cwd()) {
+  const lib = resolveLibTerminalConfig(root) || {}
+  const sb = readJson(resolve(root, 'storyboard.config.json')) || {}
+  const userTerminal = readJson(resolve(root, 'terminal.config.json')) || {}
+
+  const sbCanvas = sb.canvas || {}
+  const sbLayer = {
+    ...(sbCanvas.terminal ? { terminal: sbCanvas.terminal } : {}),
+    ...(sbCanvas.agents ? { agents: sbCanvas.agents } : {}),
+    ...(sbCanvas.showAgentsInAddMenu !== undefined
+      ? { showAgentsInAddMenu: sbCanvas.showAgentsInAddMenu }
+      : {}),
+    ...(sb.hotPool ? { hotPool: sb.hotPool } : {}),
+  }
+
+  const merged = deepMerge(deepMerge(lib, sbLayer), userTerminal)
+  return {
+    terminal: merged.terminal || {},
+    agents: merged.agents || {},
+    showAgentsInAddMenu: merged.showAgentsInAddMenu,
+    hotPool: merged.hotPool || {},
+  }
+}
+
+/**
+ * Convenience: just the agents map.
+ */
+export function readAgentsConfig(root = process.cwd()) {
+  return readTerminalConfigMerged(root).agents
+}
+
+/**
+ * Convenience: just the terminal-widget settings.
+ */
+export function readTerminalSettings(root = process.cwd()) {
+  return readTerminalConfigMerged(root).terminal
+}
+
+/**
+ * Convenience: just the hotPool config.
+ */
+export function readHotPoolConfig(root = process.cwd()) {
+  return readTerminalConfigMerged(root).hotPool
+}

package/src/core/canvas/hot-pool.js

@@ -25,7 +25,7 @@
  * Scale-down: After cooldown minutes with no acquisitions, the pool scales
  *             back to pool_size by killing excess warm sessions.
  *
- * ## Configuration (storyboard.config.json → hotPool)
+ * ## Configuration (terminal.config.json → hotPool, or storyboard.config.json → hotPool for legacy back-compat)
  *
  *   hotPool.enabled         — enable/disable all pools (default: true)
  *   hotPool.verbose         — log to Vite terminal (default: false)

package/src/core/canvas/server.js

@@ -52,6 +52,7 @@ import { markCanvasWrite, unmarkCanvasWrite } from './writeGuard.js'
 import { devLog } from '../logger/devLogger.js'
 import widgetsConfig from '../../../widgets.config.json' with { type: 'json' }
 import { listHubRoles, getDefaultRoleId } from './hub-roles.js'
+import { readAgentsConfig } from './configReader.js'
 
 /**
  * Read the prompt widget's execution config from widgets.config.json.
@@ -713,9 +714,7 @@ export function createCanvasHandler(ctx) {
     // For agent widgets, resolve startupCommand from canvas.agents config if not provided
     if (type === 'agent' && props.agentId && !props.startupCommand) {
       try {
-        const configPath = path.join(root, 'storyboard.config.json')
-        const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
-        const agentCfg = config?.canvas?.agents?.[props.agentId]
+        const agentCfg = readAgentsConfig(root)?.[props.agentId]
         if (agentCfg?.startupCommand) {
           props.startupCommand = agentCfg.startupCommand
         }
@@ -725,9 +724,7 @@ export function createCanvasHandler(ctx) {
     // For agent widgets without agentId, default to the first canvas.agents entry
     if (type === 'agent' && !props.agentId) {
       try {
-        const configPath = path.join(root, 'storyboard.config.json')
-        const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
-        const agents = config?.canvas?.agents || {}
+        const agents = readAgentsConfig(root) || {}
         const defaultEntry = Object.entries(agents).find(([, cfg]) => cfg.default) || Object.entries(agents)[0]
         if (defaultEntry) {
           const [id, cfg] = defaultEntry
@@ -3112,9 +3109,7 @@ export function Default() {
         // Resolve agent config from storyboard.config.json
         let agentConfig = null
         try {
-          const configPath = path.join(root, 'storyboard.config.json')
-          const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
-          const agents = config?.canvas?.agents || {}
+          const agents = readAgentsConfig(root) || {}
           if (agentId && agents[agentId]) {
             agentConfig = agents[agentId]
           } else {

package/src/core/canvas/terminal-server.js

@@ -158,15 +158,11 @@ function cleanEnv() {
   return filtered
 }
 
-/** Read terminal config from storyboard.config.json */
+import { readTerminalSettings, readAgentsConfig } from './configReader.js'
+
+/** Read terminal-widget settings (merged from lib defaults + storyboard.config.json + terminal.config.json). */
 function readTerminalConfig() {
-  try {
-    const raw = readFileSync(resolve(process.cwd(), 'storyboard.config.json'), 'utf8')
-    const config = JSON.parse(raw)
-    return config?.canvas?.terminal ?? {}
-  } catch {
-    return {}
-  }
+  return readTerminalSettings()
 }
 
 /**
@@ -175,22 +171,19 @@ function readTerminalConfig() {
  */
 function resolveAgentConfig(startupCommand) {
   if (!startupCommand || startupCommand === 'shell') return null
-  try {
-    const raw = readFileSync(resolve(process.cwd(), 'storyboard.config.json'), 'utf8')
-    const agentsConfig = JSON.parse(raw)?.canvas?.agents
-    if (!agentsConfig || typeof agentsConfig !== 'object') return null
-    for (const [id, cfg] of Object.entries(agentsConfig)) {
-      if (!cfg?.startupCommand) continue
-      // Prefer exact/prefix match for deterministic routing; keep binary fallback for backwards compat.
-      if (
-        startupCommand === cfg.startupCommand
-        || startupCommand.startsWith(`${cfg.startupCommand} `)
-        || startupCommand.startsWith(cfg.startupCommand.split(' ')[0])
-      ) {
-        return { id, cfg }
-      }
+  const agentsConfig = readAgentsConfig()
+  if (!agentsConfig || typeof agentsConfig !== 'object') return null
+  for (const [id, cfg] of Object.entries(agentsConfig)) {
+    if (!cfg?.startupCommand) continue
+    // Prefer exact/prefix match for deterministic routing; keep binary fallback for backwards compat.
+    if (
+      startupCommand === cfg.startupCommand
+      || startupCommand.startsWith(`${cfg.startupCommand} `)
+      || startupCommand.startsWith(cfg.startupCommand.split(' ')[0])
+    ) {
+      return { id, cfg }
     }
-  } catch { /* empty */ }
+  }
   return null
 }
 
@@ -1107,8 +1100,7 @@ function handleConnection(ws, widgetId, canvasId, prettyName, widgetStartupComma
 
         // Agent shorthand scripts (copilot, claude, codex, etc.)
         try {
-          const raw = readFileSync(resolve(process.cwd(), 'storyboard.config.json'), 'utf8')
-          const agentsConfig = JSON.parse(raw)?.canvas?.agents
+          const agentsConfig = readAgentsConfig()
           if (agentsConfig && typeof agentsConfig === 'object') {
             for (const [id, cfg] of Object.entries(agentsConfig)) {
               if (!cfg.startupCommand) continue
@@ -1138,8 +1130,7 @@ function handleConnection(ws, widgetId, canvasId, prettyName, widgetStartupComma
           `start() { if [ $# -eq 0 ]; then ${welcomeBase}; else ${welcomeBase} --startup "$*"; fi; }`,
         ]
         try {
-          const raw = readFileSync(resolve(process.cwd(), 'storyboard.config.json'), 'utf8')
-          const agentsConfig = JSON.parse(raw)?.canvas?.agents
+          const agentsConfig = readAgentsConfig()
           if (agentsConfig && typeof agentsConfig === 'object') {
             for (const [id, cfg] of Object.entries(agentsConfig)) {
               if (!cfg.startupCommand) continue
@@ -1246,17 +1237,23 @@ function handleConnection(ws, widgetId, canvasId, prettyName, widgetStartupComma
         const binDir = join(cwd, '.storyboard', 'terminals', 'bin')
         envParts.push(`export PATH="${binDir}:$PATH"`)
 
-        // Chain clear before exports so the typed env soup is wiped from
-        // view as soon as Enter executes, then chain clear again after so
-        // the agent starts on a clean screen.
-        let envExports = envParts.join(' && ')
-        if (startupCommand) {
-          envExports = `clear && ${envExports} && clear`
-        }
+        // Write env exports to a per-widget shell script and source it via a
+        // short send-keys. Avoids tmux send-keys -l truncation when the env
+        // soup (especially PATH expansion) gets large — observed: a 4 KB+
+        // chain stops mid-line on macOS, the agent command never runs.
+        const envScriptDir = join(cwd, '.storyboard', 'terminals')
+        try { mkdirSync(envScriptDir, { recursive: true }) } catch { /* empty */ }
+        const envScriptPath = join(envScriptDir, `${widgetId}.env.sh`)
+        try {
+          writeFileSync(envScriptPath, envParts.join('\n') + '\n')
+        } catch { /* empty */ }
+        const envSourceCmd = startupCommand
+          ? `clear && source ${JSON.stringify(envScriptPath)} && clear`
+          : `source ${JSON.stringify(envScriptPath)}`
 
         setTimeout(() => {
           try {
-            execSync(`tmux send-keys -t "${tmuxName}" -l ${JSON.stringify(envExports)}`, { stdio: 'ignore' })
+            execSync(`tmux send-keys -t "${tmuxName}" -l ${JSON.stringify(envSourceCmd)}`, { stdio: 'ignore' })
             execSync(`tmux send-keys -t "${tmuxName}" Enter`, { stdio: 'ignore' })
           } catch { /* empty */ }
         }, 300)

package/src/core/cli/setup.js

@@ -12,7 +12,7 @@
 import * as p from '@clack/prompts'
 import { existsSync, writeFileSync, readFileSync, mkdirSync, readdirSync, symlinkSync } from 'fs'
 import path from 'path'
-import { execSync } from 'child_process'
+import { execSync, spawn } from 'child_process'
 import { gettingStartedLines, dim, magenta, bold, yellow, green } from './intro.js'
 import { parseFlags } from './flags.js'
 
@@ -43,7 +43,8 @@ if (flags.nuke) {
 
 /**
  * Run a potentially slow task with a spinner that only appears after 500ms.
- * If the task completes quickly, shows the done message immediately.
+ * IMPORTANT: `fn` must be async (don't use execSync — it blocks the event loop
+ * and prevents the spinner from animating).
  */
 async function withSpin(label, doneMsg, fn) {
   const spin = p.spinner()
@@ -59,6 +60,54 @@ async function withSpin(label, doneMsg, fn) {
   }
 }
 
+/**
+ * Async command runner — does NOT block the event loop, so spinners animate.
+ */
+function runAsync(cmd, args = [], opts = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, args, { stdio: 'ignore', ...opts })
+    child.on('error', reject)
+    child.on('exit', (code) => {
+      if (code === 0) resolve()
+      else reject(new Error(`${cmd} exited with code ${code}`))
+    })
+  })
+}
+
+/**
+ * Install a brew package with an animated spinner.
+ */
+async function brewInstall(pkg, label) {
+  const spin = p.spinner()
+  spin.start(`Installing ${label}`)
+  try {
+    await runAsync('brew', ['install', pkg])
+    spin.stop(`${label} installed`)
+    return true
+  } catch {
+    spin.stop(`Failed to install ${label}`)
+    p.log.warning(`Install manually: brew install ${pkg}`)
+    return false
+  }
+}
+
+/**
+ * Quick network probe — alerts the user if GitHub looks unreachable.
+ * We don't block on failure; downstream installers will surface their own errors.
+ */
+async function checkNetwork() {
+  const http = await import('node:https')
+  return new Promise((resolve) => {
+    const req = http.request('https://api.github.com', { method: 'HEAD', timeout: 4000 }, (res) => {
+      resolve(res.statusCode != null && res.statusCode < 500)
+      res.resume()
+    })
+    req.on('error', () => resolve(false))
+    req.on('timeout', () => { req.destroy(); resolve(false) })
+    req.end()
+  })
+}
+
 function mascot() {
   const d = dim('·')
   const f = magenta
@@ -87,13 +136,20 @@ function isInstalled(cmd) {
 
 p.intro('storyboard setup')
 
-// 1. Check for node_modules (quick sanity check — full install runs at the end)
-if (!existsSync('node_modules')) {
-  p.log.info('node_modules not found — will install at end of setup')
-} else {
-  p.log.success('Dependencies present')
+// 0. Network probe — alert if GitHub is unreachable; don't block.
+{
+  const online = await checkNetwork()
+  if (!online) {
+    p.log.warning('Network looks offline — installers/downloads may fail')
+    p.log.info(dim('  Tried HEAD https://api.github.com; check VPN/proxy/DNS'))
+  } else {
+    p.log.success('Network reachable')
+  }
 }
 
+// Node is assumed to be present (you already ran `npx storyboard setup`).
+// node_modules will be installed at the end if missing.
+
 // 2. Homebrew
 let hasBrew = isInstalled('brew')
 if (!hasBrew) {
@@ -121,35 +177,43 @@ if (hasBrew) {
   if (isInstalled('git')) {
     p.log.success('Git installed')
   } else {
-    const gitSpin = p.spinner()
-    gitSpin.start('Installing Git')
-    try {
-      run('brew install git')
-      gitSpin.stop('Git installed')
-    } catch {
-      gitSpin.stop('Failed to install Git')
-      p.log.warning('Install manually: brew install git')
-    }
+    await brewInstall('git', 'Git')
   }
 }
 
 // 4. Caddy is no longer used. Worktrees run their own Vite directly on
-//    `http://localhost:<port>/storyboard/`. The block below intentionally
-//    skips the previous Caddy install + start steps.
+//    `http://localhost:<port>/storyboard/`.
 
 if (hasBrew) {
-  // 5. GitHub CLI
+  // 5. GitHub CLI — required for `gh auth`, `gh pr`, `gh issue` in agents.
+  let ghNewlyInstalled = false
   if (isInstalled('gh')) {
     p.log.success('GitHub CLI installed')
   } else {
-    const ghSpin = p.spinner()
-    ghSpin.start('Installing GitHub CLI')
+    ghNewlyInstalled = await brewInstall('gh', 'GitHub CLI')
+  }
+
+  // 5a. tmux (required for headless agent sessions)
+  if (isInstalled('tmux')) {
+    p.log.success('tmux installed')
+  } else {
+    await brewInstall('tmux', 'tmux')
+  }
+
+  // 5b. Surface gh auth status. Even if gh was already installed, we should
+  //     prompt the user to log in — agents that shell out to `gh` will fail
+  //     silently otherwise.
+  if (isInstalled('gh')) {
+    let authed = false
     try {
-      run('brew install gh')
-      ghSpin.stop('GitHub CLI installed')
-    } catch {
-      ghSpin.stop('Failed to install GitHub CLI')
-      p.log.warning('Install manually: brew install gh')
+      execSync('gh auth status', { stdio: 'ignore' })
+      authed = true
+    } catch { /* not authed */ }
+    if (authed) {
+      p.log.success('GitHub CLI authenticated')
+    } else {
+      p.log.warning(ghNewlyInstalled ? 'GitHub CLI installed but not logged in' : 'GitHub CLI is not logged in')
+      p.log.info(`  Run ${yellow('gh auth login')} to authenticate`)
     }
   }
 }
@@ -195,24 +259,37 @@ if (isInstalled('code')) {
   }
 }
 
-// 6a. Copilot CLI
-if (isInstalled('copilot')) {
-  p.log.success('Copilot CLI installed')
-} else {
-  const copilotSpin = p.spinner()
-  copilotSpin.start('Installing Copilot CLI')
-  try {
-    run('curl -fsSL https://gh.io/copilot-install | bash')
-    // Add ~/.local/bin to PATH if not already there
-    const localBin = `${process.env.HOME}/.local/bin`
-    if (!process.env.PATH.includes(localBin)) {
-      process.env.PATH = `${localBin}:${process.env.PATH}`
+// 6a. Copilot CLI — install via the official script (no homebrew dependency).
+//     curl ships with macOS and all major Linux distros.
+//     Auth is separate from `gh`: copilot has its own credential store.
+{
+  let copilotNewlyInstalled = false
+  if (isInstalled('copilot')) {
+    p.log.success('Copilot CLI installed')
+  } else {
+    const spin = p.spinner()
+    spin.start('Installing Copilot CLI')
+    try {
+      await runAsync('bash', ['-c', 'curl -fsSL https://gh.io/copilot-install | bash'])
+      // Install script drops the binary in ~/.local/bin when run as
+      // non-root. Make sure the current process can find it for the
+      // remainder of setup, and warn the user to add it to their shell rc.
+      const localBin = `${process.env.HOME}/.local/bin`
+      if (!process.env.PATH.includes(localBin)) {
+        process.env.PATH = `${localBin}:${process.env.PATH}`
+      }
+      spin.stop('Copilot CLI installed')
+      copilotNewlyInstalled = true
+      if (!isInstalled('copilot')) {
+        p.log.warning(`copilot not on PATH — add ${yellow('export PATH="$HOME/.local/bin:$PATH"')} to your shell rc`)
+      }
+    } catch {
+      spin.stop('Failed to install Copilot CLI')
+      p.log.warning('Install manually: curl -fsSL https://gh.io/copilot-install | bash')
     }
-    copilotSpin.stop('Copilot CLI installed')
-    p.log.info(dim('  Note: You may need to restart your terminal or add ~/.local/bin to PATH'))
-  } catch {
-    copilotSpin.stop('Failed to install Copilot CLI')
-    p.log.warning('Install manually: curl -fsSL https://gh.io/copilot-install | bash')
+  }
+  if (copilotNewlyInstalled || isInstalled('copilot')) {
+    p.log.info(`  Auth is separate from gh — run ${yellow('copilot')} then ${yellow('/login')}`)
   }
 }
 
@@ -352,14 +429,14 @@ if (isInstalled('copilot')) {
 
 // 10. Install / sync dependencies
 {
+  const installSpin = p.spinner()
+  installSpin.start('Installing dependencies')
   try {
-    await withSpin(
-      'Installing dependencies...',
-      'Dependencies installed',
-      () => { run('npm install', { stdio: 'ignore' }) }
-    )
+    await runAsync('npm', ['install'])
+    installSpin.stop('Dependencies installed')
   } catch {
-    p.log.warning('npm install failed — run it manually to see details')
+    installSpin.stop('npm install failed')
+    p.log.warning('Run it manually to see details:')
     p.log.info(`  ${dim('npm install')}`)
   }
 }

package/src/core/cli/terminal-welcome.js

@@ -17,11 +17,12 @@
 
 import * as p from '@clack/prompts'
 import { execSync, spawn } from 'node:child_process'
-import { readFileSync, existsSync } from 'node:fs'
-import { resolve, join } from 'node:path'
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
 import { parseFlags } from './flags.js'
 import { dim, bold } from './intro.js'
 import { takePendingMessages } from '../canvas/terminal-config.js'
+import { readAgentsConfig } from '../canvas/configReader.js'
 
 const blue = (s) => `\x1b[34m${s}\x1b[0m`
 const yellow = (s) => `\x1b[33m${s}\x1b[0m`
@@ -76,14 +77,12 @@ function agentEnv() {
 }
 
 /**
- * Read agents config from storyboard.config.json.
+ * Read agents config (lib defaults + storyboard.config.json + terminal.config.json merged).
  * Returns an array of { id, label, startupCommand, resumeCommand } entries.
  */
 function loadAgents() {
   try {
-    const raw = readFileSync(resolve(process.cwd(), 'storyboard.config.json'), 'utf8')
-    const config = JSON.parse(raw)
-    const agents = config?.canvas?.agents
+    const agents = readAgentsConfig()
     if (!agents || typeof agents !== 'object') return []
     return Object.entries(agents).map(([id, cfg]) => ({
       id,

package/src/core/stores/configSchema.js

@@ -65,6 +65,7 @@
  * @property {string}  [sessionIdEnv]   — env var exposed in the agent's SessionStart hook payload that holds its session id (e.g. "COPILOT_AGENT_SESSION_ID"). When set, the server captures the id per-widget so cold restarts can auto-resume.
  * @property {string}  [sessionStateDir] — directory where the agent stores per-session state, used to pre-flight `--resume` (e.g. "~/.copilot/session-state"). Pass `null` to skip the fs check (UUID-only validation).
  * @property {string}  [sessionStateGlob] — alternative to sessionStateDir for agents that store sessions under a per-project subdir, with `{id}` placeholder (e.g. "~/.claude/projects/*‍/{id}.jsonl").
+ * @property {boolean} [resumeFallback]  — when true (default), the resume command is shell-chained with `|| <startupCommand>` so a runtime resume failure falls through to a fresh session instead of leaving the widget with a dead terminal. Set false to opt out.
  * @property {boolean} [resizable]     — override terminal resizability for this agent
  * @property {number}  [defaultWidth]  — override default width
  * @property {number}  [defaultHeight] — override default height

package/src/core/vite/server-plugin.js

@@ -19,6 +19,7 @@ import { serverFeatures as workshopFeatures } from '../workshop/features/registr
 import { docsHandler, collectFiles } from './docs-handler.js'
 import { createCanvasHandler } from '../canvas/server.js'
 import { setupSelectedWidgets } from '../canvas/selectedWidgets.js'
+import { readAgentsConfig, readHotPoolConfig } from '../canvas/configReader.js'
 import { HotPoolManager } from '../canvas/hot-pool.js'
 import { createAutosyncHandler } from '../autosync/server.js'
 import { setupTerminalServer } from '../canvas/terminal-server.js'
@@ -279,8 +280,8 @@ export default function storyboardServer() {
       routeHandlers.set('docs', docsHandler({ root, sendJson: sendJsonLogged }))
 
       // Create shared hot pool manager (per-type pre-warmed sessions)
-      const hotPoolConfig = config.hotPool || {}
-      const agentsConfig = config.canvas?.agents || {}
+      const hotPoolConfig = readHotPoolConfig(root)
+      const agentsConfig = readAgentsConfig(root)
       const wsSend = server.ws.send.bind(server.ws)
       const hotPool = new HotPoolManager({ root, config: hotPoolConfig, agentsConfig, wsSend })
       hotPool.start().catch((err) => {

package/src/internals/vite/data-plugin.js

@@ -547,6 +547,90 @@ function readCoreConfigFile(root, filename) {
   return null
 }
 
+/**
+ * Resolve the absolute path of a library config file (returns the first
+ * candidate that exists, or null). Used by syncScaffoldDir to copy raw
+ * file contents (including comments) rather than re-serializing parsed JSON.
+ */
+function resolveCoreConfigFilePath(root, filename) {
+  const candidates = [
+    path.resolve(root, `packages/storyboard/${filename}`),
+    path.resolve(root, `node_modules/@dfosco/storyboard/${filename}`),
+  ]
+  for (const p of candidates) {
+    try { fs.accessSync(p); return p } catch { /* try next */ }
+  }
+  return null
+}
+
+const SCAFFOLD_README = `# .storyboard/scaffold/
+
+This directory is **always rewritten on dev-server boot** to reflect the
+library's current default config files. The Storyboard server **never reads
+config from this directory** — these files are reference copies for you to
+customize.
+
+## How to customize
+
+1. Pick the config file you want to override (e.g. \`terminal.config.json\`).
+2. **Copy it to your project root** (next to \`storyboard.config.json\`).
+3. Edit only the keys you care about — leaf-level merge means everything
+   else continues to inherit the library defaults, so future updates
+   (new agents, new readiness signals, etc.) reach you automatically.
+
+## Why a separate directory?
+
+- Customers who don't want to customize don't see config clutter at the root.
+- Customers who do want to customize have all the defaults available as a
+  living reference, version-bumped with every storyboard release.
+- Files at the root override the defaults; missing files mean "use library
+  defaults". No empty placeholder files cluttering the project.
+
+## What's in here
+
+| File | What it covers |
+|------|----------------|
+| \`terminal.config.json\` | Terminal widgets + canvas agent CLIs (copilot/claude/codex) |
+| \`toolbar.config.json\` | Toolbar tool registry + visibility |
+| \`commandpalette.config.json\` | Command palette entries |
+| \`paste.config.json\` | URL → widget paste rules |
+| \`widgets.config.json\` | Widget defaults (size, behavior) |
+
+Don't edit files in this directory — your changes will be overwritten on
+the next dev-server boot. Always copy to the project root first.
+`
+
+const SCAFFOLD_FILES = [
+  'terminal.config.json',
+  'toolbar.config.json',
+  'commandpalette.config.json',
+  'paste.config.json',
+  'widgets.config.json',
+]
+
+/**
+ * Sync `.storyboard/scaffold/` with the library's current default config
+ * files. Always overwrites — users must copy to the project root to
+ * customize. Idempotent and best-effort.
+ */
+function syncScaffoldDir(root) {
+  const scaffoldDir = path.resolve(root, '.storyboard', 'scaffold')
+  try { fs.mkdirSync(scaffoldDir, { recursive: true }) } catch { /* empty */ }
+
+  const readmePath = path.resolve(scaffoldDir, 'README.md')
+  try { fs.writeFileSync(readmePath, SCAFFOLD_README) } catch { /* empty */ }
+
+  for (const filename of SCAFFOLD_FILES) {
+    const src = resolveCoreConfigFilePath(root, filename)
+    if (!src) continue
+    const dest = path.resolve(scaffoldDir, filename)
+    try {
+      const raw = fs.readFileSync(src, 'utf-8')
+      fs.writeFileSync(dest, raw)
+    } catch { /* skip on error */ }
+  }
+}
+
 /**
  * Deep-merge helper (same as loader.js deepMerge but available at build time).
  * Arrays are replaced, not concatenated. Objects are recursively merged.
@@ -597,6 +681,7 @@ function buildUnifiedConfig(root) {
   const coreCommandPalette = readCoreConfigFile(root, 'commandpalette.config.json') || {}
   const corePaste = readCoreConfigFile(root, 'paste.config.json') || {}
   const coreWidgets = readCoreConfigFile(root, 'widgets.config.json') || {}
+  const coreTerminal = readCoreConfigFile(root, 'terminal.config.json') || {}
 
   // 2. Read storyboard.config.json (middle priority)
   // Use the schema-defaulted config for most things, but also read
@@ -619,6 +704,17 @@ function buildUnifiedConfig(root) {
   const afterSbWidgets = rawSbConfig.widgets
     ? deepMergeBuild(coreWidgets, sbConfig.widgets || {})
     : coreWidgets
+  // For terminal/agents, slot canvas.terminal + canvas.agents from storyboard.config.json
+  // into the same shape as terminal.config.json so the merge is uniform.
+  const sbTerminalLike = (rawSbConfig.canvas && (rawSbConfig.canvas.terminal || rawSbConfig.canvas.agents))
+    ? {
+        ...(rawSbConfig.canvas.terminal ? { terminal: sbConfig.canvas.terminal } : {}),
+        ...(rawSbConfig.canvas.agents ? { agents: sbConfig.canvas.agents } : {}),
+      }
+    : null
+  const afterSbTerminal = sbTerminalLike
+    ? deepMergeBuild(coreTerminal, sbTerminalLike)
+    : coreTerminal
 
   // 4. Read user domain config files (highest priority)
   const userFiles = [
@@ -626,6 +722,7 @@ function buildUnifiedConfig(root) {
     { domain: 'paste', filename: 'paste.config.json' },
     { domain: 'toolbar', filename: 'toolbar.config.json' },
     { domain: 'commandPalette', filename: 'commandpalette.config.json' },
+    { domain: 'terminal', filename: 'terminal.config.json' },
   ]
 
   const userConfigs = {}
@@ -648,6 +745,9 @@ function buildUnifiedConfig(root) {
   const finalWidgets = userConfigs.widgets
     ? deepMergeBuild(afterSbWidgets, userConfigs.widgets.data)
     : afterSbWidgets
+  const finalTerminal = userConfigs.terminal
+    ? deepMergeBuild(afterSbTerminal, userConfigs.terminal.data)
+    : afterSbTerminal
 
   // 6. Detect overlaps between storyboard.config.json and user domain configs
   const domainOverlapChecks = [
@@ -664,18 +764,32 @@ function buildUnifiedConfig(root) {
       }
     }
   }
+  // Terminal overlap check: storyboard.config.json.canvas.{terminal,agents} vs terminal.config.json
+  if (sbTerminalLike && userConfigs.terminal) {
+    const overlaps = findOverlappingKeys(sbTerminalLike, userConfigs.terminal.data)
+    for (const key of overlaps) {
+      warnings.push(`Config overlap: "${key}" is defined in both storyboard.config.json.canvas and terminal.config.json — terminal.config.json wins.`)
+    }
+  }
 
   // 7. Build the unified config object.
   // Start from the schema-defaulted sbConfig so every top-level key from
   // storyboard.config.json (and every schema default) flows to initConfig().
   // Then override the domain-specific slices that have their own dedicated
-  // config files merged above (toolbar/commandPalette/paste/widgets).
+  // config files merged above (toolbar/commandPalette/paste/widgets/terminal).
+  const sbCanvas = sbConfig?.canvas || {}
   const unified = {
-    ...sbConfig,
+    ...(sbConfig || {}),
     toolbar: finalToolbar,
     commandPalette: finalCommandPalette,
     paste: finalPaste,
     widgets: finalWidgets,
+    canvas: {
+      ...sbCanvas,
+      terminal: deepMergeBuild(sbCanvas.terminal || {}, finalTerminal.terminal || {}),
+      agents: deepMergeBuild(sbCanvas.agents || {}, finalTerminal.agents || {}),
+      ...(finalTerminal.showAgentsInAddMenu !== undefined ? { showAgentsInAddMenu: finalTerminal.showAgentsInAddMenu } : {}),
+    },
   }
 
   return { unified, warnings }
@@ -1063,6 +1177,14 @@ export default function storyboardDataPlugin() {
       // dev so users can hit their routes, excluded from production builds
       // so private experiments don't ship.
       includeTilde = config.command === 'serve'
+
+      // On dev boot, sync .storyboard/scaffold/ with the library's current
+      // default config files so users always have an up-to-date copy-source
+      // for customizations. Files in .storyboard/scaffold/ are NEVER read by
+      // the server — only files at the project root are. Always overwrites.
+      if (config.command === 'serve') {
+        try { syncScaffoldDir(root) } catch { /* best-effort */ }
+      }
     },
 
     resolveId(id) {
@@ -1209,7 +1331,7 @@ export default function storyboardDataPlugin() {
         }
 
         // Invalidate when any config file inside a prototype changes
-        const protoConfigPattern = /\/(toolbar|commandpalette|widgets|paste)\.config\.json$/
+        const protoConfigPattern = /\/(toolbar|commandpalette|widgets|paste|terminal)\.config\.json$/
         if (protoConfigPattern.test(normalized) && normalized.includes('/prototypes/')) {
           buildResult = null
           const mod = server.moduleGraph.getModuleById(RESOLVED_ID)
@@ -1368,6 +1490,7 @@ export default function storyboardDataPlugin() {
         'commandpalette.config.json',
         'paste.config.json',
         'widgets.config.json',
+        'terminal.config.json',
       ].map(f => path.resolve(root, f))
       const watchedConfigPaths = new Set([configPath, ...domainConfigFiles])
       for (const p of domainConfigFiles) watcher.add(p)

package/terminal.config.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "./terminal.schema.json",
+  "$comment": "Defaults for terminal widgets and canvas agents. Users can override at the project root by copying this file from .storyboard/scaffold/terminal.config.json. Leaf-level merge: only the specific keys you set are overridden, everything else inherits the library defaults — so future agent additions or readinessSignal tweaks reach you automatically.",
+  "terminal": {
+    "resizable": true,
+    "defaultWidth": 1000,
+    "defaultHeight": 800,
+    "fontSize": 14,
+    "fontFamily": "'SF Mono', 'Menlo', 'Monaco', 'Courier New', monospace",
+    "prompt": "❯ ",
+    "startupCommand": null,
+    "defaultStartupSequence": null
+  },
+  "agents": {
+    "copilot": {
+      "label": "Copilot CLI",
+      "default": true,
+      "icon": "primer/copilot",
+      "startupCommand": "copilot --agent terminal-agent",
+      "resumeCommand": "copilot --resume={id} --agent terminal-agent",
+      "sessionIdEnv": "COPILOT_AGENT_SESSION_ID",
+      "postStartup": "/allow-all on",
+      "readinessSignal": "Environment loaded:",
+      "resizable": true
+    },
+    "claude": {
+      "label": "Claude Code",
+      "icon": "claude",
+      "startupCommand": "claude --agent terminal-agent --dangerously-skip-permissions",
+      "resumeCommand": "claude --resume {id} --agent terminal-agent --dangerously-skip-permissions",
+      "sessionIdEnv": "CLAUDE_SESSION_ID",
+      "sessionStateGlob": "~/.claude/projects/*/{id}.jsonl",
+      "readinessSignal": "bypass permissions",
+      "resizable": true
+    },
+    "codex": {
+      "label": "Codex CLI",
+      "icon": "codex",
+      "startupCommand": "codex --ask-for-approval never",
+      "resumeCommand": "codex resume {id}",
+      "sessionIdEnv": "CODEX_SESSION_ID",
+      "sessionStateGlob": "~/.codex/sessions/**/rollout-*-{id}.jsonl",
+      "configFiles": [".codex/config.toml"],
+      "resizable": true
+    }
+  },
+  "showAgentsInAddMenu": false,
+  "hotPool": {
+    "enabled": true,
+    "verbose": false,
+    "default_pool_size": 1,
+    "default_max_pool_size": 3,
+    "load_balancer": true,
+    "load_balancer_cooldown_mins": 10,
+    "pools": {
+      "terminal": { "pool_size": 1 },
+      "copilot": { "pool_size": 1, "webgl_ready_slots": 1 },
+      "claude": { "pool_size": 1, "webgl_ready_slots": 1 },
+      "codex": { "pool_size": 0 },
+      "prompt": { "pool_size": 1, "webgl_ready_slots": 1 }
+    }
+  }
+}