mulmoterminal 8.8.0 → 9.1.0

package/README.md

@@ -289,6 +289,7 @@ Needs **Node ≥ 22.12**, plus these CLIs — on your `PATH`, or named by the ma
 | Recommended | `tmux` | [session persistence](#session-persistence-tmux) — terminals survive a server restart | `brew install tmux` · `sudo apt install tmux` · `sudo dnf install tmux` · no native Windows build (falls back to plain PTYs) |
 | Optional | any other agent CLI | a cell can run **Codex**, **Antigravity** (`agy`), **Grok**, **Muse**, **GitHub Copilot CLI** or **Cursor CLI** instead of Claude — install only the ones you use, and a missing one simply fails to start that cell. What each can do is [the capability matrix](docs/agent-capability-matrix.md); how to install and pick one is the [agents guide](https://receptron.github.io/mulmoterminal/guide/en/agents.html) | e.g. `npm i -g @openai/codex` |
 | Optional | `ffmpeg` | video rendering from the [mulmo-script panel](#wiki-collections--the-gui-panel) (its plugin ships enabled) | `brew install ffmpeg` · `sudo apt install ffmpeg` · `sudo dnf install ffmpeg` |
+| Optional | `remotion` packages | MulmoCast's `remotion` beats, where Claude Code writes each scene as a Remotion component (mulmocast 2.13.0). Not a dependency of this app: install them yourself, into your home directory so an `npx` upgrade does not lose them — `init` reports whether mulmocast can see them | [Remotion scenes](https://receptron.github.io/mulmoterminal/guide/en/mulmocast.html#remotion) · [日本語](https://receptron.github.io/mulmoterminal/guide/ja/mulmocast.html#remotion) |
 | Optional | `ollama` | [`claude-ollama`](https://receptron.github.io/mulmoterminal/guide/en/claude-ollama.html) — Claude Code against a fully local model | [ollama.com/download](https://ollama.com/download) |
 | Linux only | a file dialog | the launcher's **Choose a folder** button and the path menu's **Insert a file path**, which open an OS dialog on the machine the server runs on. macOS and Windows have one built in; **WSL** uses the Windows one over interop and needs nothing installed. A Linux desktop needs one of these — without any, they say so and you type the path instead (#1447) | `sudo apt install zenity` · `sudo dnf install zenity` · `kdialog`, `qarma` and `yad` also work |
 

package/bin/mulmoterminal.js

@@ -14,6 +14,7 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { computeUpdateNotice, isUpdateCheckDisabled } from "./update-check.js";
 import { detectNpxCacheDir, npxCacheHintLines } from "./npx-cache-hint.js";
+import { remotionCheck } from "./remotion-check.js";
 import { configuredRemoteServer, sshTunnelHintLines } from "./ssh-hint.js";
 import { planAfterServerExit } from "./server-supervision.js";
 import { waitUntilReady } from "./wait-ready.js";
@@ -254,6 +255,8 @@ async function runInit(initArgs) {
   }
 
   [...PATH_TOOLS, fileDialogTool()].filter(Boolean).forEach((tool) => console.log(toolCheckLine(tool)));
+  const remotionLine = await remotionCheck(PKG_DIR);
+  if (remotionLine) console.log(remotionLine);
 
   // Config half: derive working-dir presets from Claude history + write config.json.
   console.log("");

package/bin/remotion-check.d.ts

@@ -0,0 +1,5 @@
+export declare function resolverFromMulmocast(pkgDir: string): ((name: string) => boolean) | null;
+export declare function remotionPackagesFromMulmocast(pkgDir: string): Promise<readonly string[] | null>;
+export declare function missingRemotionPackages(packages: readonly string[], isResolvable: (name: string) => boolean): string[];
+export declare function remotionCheckLine(missing: readonly string[], total: number): string;
+export declare function remotionCheck(pkgDir: string): Promise<string | null>;

package/bin/remotion-check.js

@@ -0,0 +1,61 @@
+// Whether mulmocast can render a `remotion` beat on this machine. Its packages are optional peers of
+// mulmocast that a user installs only if they want it — usually into ~/node_modules, since an npx
+// entry is replaced on every release — so the question is asked FROM mulmocast's own location, the
+// way its pre-flight does, rather than from this package.
+
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+
+const GUIDE_URL = "https://receptron.github.io/mulmoterminal/guide/en/mulmocast.html#remotion";
+const WHY = "Remotion scenes in MulmoCast videos";
+
+/** A resolver answering from where mulmocast is installed, or null when mulmocast is not found. */
+export function resolverFromMulmocast(pkgDir) {
+  try {
+    const mulmocastEntry = createRequire(join(pkgDir, "package.json")).resolve("mulmocast");
+    const fromMulmocast = createRequire(mulmocastEntry);
+    // A package that hides its package.json behind `exports` (three does) is installed; any other
+    // failure — a malformed package.json included — is reported, since this check is a diagnosis.
+    return (name) => {
+      try {
+        fromMulmocast.resolve(`${name}/package.json`);
+        return true;
+      } catch (error) {
+        return error instanceof Error && "code" in error && error.code === "ERR_PACKAGE_PATH_NOT_EXPORTED";
+      }
+    };
+  } catch {
+    return null;
+  }
+}
+
+/** mulmocast's own list of what a remotion beat needs, or null when mulmocast or that export is missing. */
+export async function remotionPackagesFromMulmocast(pkgDir) {
+  try {
+    const entry = createRequire(join(pkgDir, "package.json")).resolve("mulmocast/remotion");
+    const { REMOTION_PACKAGES } = await import(pathToFileURL(entry).href);
+    return Array.isArray(REMOTION_PACKAGES) && REMOTION_PACKAGES.every((name) => typeof name === "string") ? REMOTION_PACKAGES : null;
+  } catch {
+    return null;
+  }
+}
+
+export function missingRemotionPackages(packages, isResolvable) {
+  return packages.filter((name) => !isResolvable(name));
+}
+
+export function remotionCheckLine(missing, total) {
+  if (missing.length === 0) return `  ✓ remotion — ${WHY}`;
+  const head =
+    missing.length === total ? `  ○ remotion — optional (${WHY})` : `  ○ remotion — optional (${WHY}), installed only in part; missing: ${missing.join(", ")}`;
+  return `${head}\n      → ${GUIDE_URL}`;
+}
+
+/** The `init` line for remotion, or null when mulmocast cannot be asked. */
+export async function remotionCheck(pkgDir) {
+  const isResolvable = resolverFromMulmocast(pkgDir);
+  const packages = await remotionPackagesFromMulmocast(pkgDir);
+  if (!isResolvable || !packages) return null;
+  return remotionCheckLine(missingRemotionPackages(packages, isResolvable), packages.length);
+}

package/common/dirConfigSource.ts

@@ -33,6 +33,7 @@ export const DIR_CONFIG_KEYS = [
   "commands",
   "skills",
   "decks",
+  "mobileFiles",
   "provider",
   "model",
   "addDirs",
@@ -76,6 +77,10 @@ export interface DirConfigExtras {
   model: string | null;
   skills: string[] | null;
   decks: string[] | null;
+  // What the phone may see (#2911): the declared directories relative to this one, and the
+  // extensions that survived the host's allowlist. Empty when the key is absent or was dropped.
+  mobileFileDirs: string[];
+  mobileFileExtensions: string[];
   addDirs: string[] | null;
   // Tri-state on purpose: `false` is a setting this file made, and the preview has to show it as
   // one. Carried here because a boolean cannot be read back off the per-cell config the way a
@@ -99,6 +104,8 @@ export const EMPTY_DIR_CONFIG_EXTRAS: DirConfigExtras = {
   model: null,
   skills: null,
   decks: null,
+  mobileFileDirs: [],
+  mobileFileExtensions: [],
   addDirs: null,
   appendSystemPrompt: null,
   buttonLabels: [],

package/common/mobileFiles.ts

@@ -0,0 +1,113 @@
+// Which files a project lets the phone see (#2911), and the wire shapes the two commands answer.
+//
+// Declared, never discovered: a project lists the directories and extensions in its
+// `.mulmoterminal.json` under `mobileFiles`, and nothing is visible without that. These rules are
+// pure so the containment-adjacent decisions (which extension, which name) are testable without a
+// filesystem; the filesystem half lives in server/config/dir-file.ts and the remote-host backend.
+
+export const MOBILE_FILE_KINDS = ["markdown", "html", "pdf", "image"] as const;
+export type MobileFileKind = (typeof MOBILE_FILE_KINDS)[number];
+
+// The host's allowlist. A project can narrow it, never widen it. svg is absent on purpose: it can
+// carry script, and an image on the phone is shown as an image, not run.
+export const MOBILE_FILE_EXTENSIONS = ["md", "markdown", "html", "htm", "pdf", "png", "jpg", "jpeg", "gif", "webp"] as const;
+export type MobileFileExtension = (typeof MOBILE_FILE_EXTENSIONS)[number];
+
+const SERVABLE_EXTENSIONS: Readonly<Record<MobileFileExtension, { kind: MobileFileKind; contentType: string }>> = {
+  md: { kind: "markdown", contentType: "text/markdown" },
+  markdown: { kind: "markdown", contentType: "text/markdown" },
+  html: { kind: "html", contentType: "text/html" },
+  htm: { kind: "html", contentType: "text/html" },
+  pdf: { kind: "pdf", contentType: "application/pdf" },
+  png: { kind: "image", contentType: "image/png" },
+  jpg: { kind: "image", contentType: "image/jpeg" },
+  jpeg: { kind: "image", contentType: "image/jpeg" },
+  gif: { kind: "image", contentType: "image/gif" },
+  webp: { kind: "image", contentType: "image/webp" },
+};
+
+const isMobileFileExtension = (value: string): value is MobileFileExtension => MOBILE_FILE_EXTENSIONS.some((extension) => extension === value);
+
+export const MAX_MOBILE_FILE_DIRS = 16;
+
+/** One `extensions` entry as a person writes it — any case, an optional leading dot. The editor's
+ *  schema needs a pattern rather than a list, and a spec pins it to MOBILE_FILE_EXTENSIONS. */
+export const MOBILE_FILE_EXTENSION_PATTERN = /^\s*\.?(?:md|markdown|html?|pdf|png|jpe?g|gif|webp)\s*$/i;
+
+/** The extension of the last path segment, lowercased, without the dot; "" when there is none. */
+export function extensionOf(relativePath: string): string {
+  const name = relativePath.split("/").pop() ?? "";
+  const dot = name.lastIndexOf(".");
+  return dot <= 0 ? "" : name.slice(dot + 1).toLowerCase();
+}
+
+export function mobileFileKind(relativePath: string): MobileFileKind | null {
+  const extension = extensionOf(relativePath);
+  return isMobileFileExtension(extension) ? SERVABLE_EXTENSIONS[extension].kind : null;
+}
+
+export function mobileFileContentType(relativePath: string): string {
+  const extension = extensionOf(relativePath);
+  return isMobileFileExtension(extension) ? SERVABLE_EXTENSIONS[extension].contentType : "application/octet-stream";
+}
+
+/** A project's `extensions`, reduced to the allowlist: trimmed, lowercased, leading dot dropped,
+ *  deduped. Anything the host does not serve is dropped rather than kept. */
+export function normalizeMobileFileExtensions(input: unknown): MobileFileExtension[] {
+  if (!Array.isArray(input)) return [];
+  const cleaned = input
+    .filter((entry): entry is string => typeof entry === "string")
+    .map((entry) => entry.trim().replace(/^\./, "").toLowerCase())
+    .filter(isMobileFileExtension);
+  return [...new Set(cleaned)];
+}
+
+/** A path segment the phone never sees into: hidden (`.env`, `.git`) or a vendored dependency tree. */
+export const isExcludedSegment = (segment: string): boolean => segment.startsWith(".") || segment === "node_modules";
+
+/** Whether a path (POSIX, relative to a declared directory) names a file the phone may see:
+ *  no excluded segment (`.env`, anything under `.git` or `node_modules`), no empty or `..`
+ *  segment, and an extension the project declared. */
+export function isServableMobilePath(relativePath: string, extensions: readonly MobileFileExtension[]): boolean {
+  const segments = relativePath.split("/");
+  if (segments.some((segment) => segment === "" || segment === ".." || isExcludedSegment(segment))) return false;
+  const extension = extensionOf(relativePath);
+  return isMobileFileExtension(extension) && extensions.includes(extension);
+}
+
+/** One row of `listMobileFiles`. `path` is relative to the PROJECT root, POSIX — never absolute,
+ *  so no home directory travels to the phone. */
+export interface MobileFileEntry {
+  path: string;
+  kind: MobileFileKind;
+  bytes: number;
+  modifiedAt: string;
+}
+
+export interface MobileFileListing {
+  /** False when the project declares no `mobileFiles`: the phone says how to turn it on. */
+  configured: boolean;
+  files: MobileFileEntry[];
+  total: number;
+  offset: number;
+  limit: number;
+  /** The walk stopped at its budget, so older files may be missing from `total`. */
+  truncated: boolean;
+}
+
+/** What `getMobileFile` answers. Text small enough to ride in the command document comes inline
+ *  (`html` already wrapped in its isolating CSP); anything else is staged in the owner's Storage
+ *  and read there with the owner's own credentials. */
+export type MobileFileContent =
+  | { delivery: "inline"; kind: "markdown" | "html"; path: string; text: string; omittedImages: number }
+  | {
+      delivery: "storage";
+      kind: MobileFileKind;
+      path: string;
+      /** Read with the owner's own credentials (`getBlob`); deleted at `expiresAt`. */
+      storagePath: string;
+      contentType: string;
+      bytes: number;
+      expiresAt: string;
+      omittedImages: number;
+    };

package/dist/assets/{abnfDiagram-O67JEVCF-ByeTkitP.js → abnfDiagram-O67JEVCF-Cql7eDy4.js}

@@ -1 +1 @@
-import{m as e,t}from"./mermaid-parser.core-CEi2Px_a.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-CllyRBe0.js";import"./chunk-O7XYJQB3-GC1aNmH_.js";import{n as i,r as a,t as o}from"./chunk-GTNCS2PH-SdNqERG5.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-_gwfjuDB.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=n(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=n(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};
+import{m as e,t}from"./mermaid-parser.core-DaS4aeEe.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-CllyRBe0.js";import"./chunk-O7XYJQB3-BWsd-NGX.js";import{n as i,r as a,t as o}from"./chunk-GTNCS2PH-C-P8WS3W.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-CnYkvp8n.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=n(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=n(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};

package/dist/assets/architecture-7GRP2DOG-CZIYYJ4J.js

@@ -0,0 +1 @@
+import"./chunk-FOHPRMQF-DzxwRta7.js";import{M as e}from"./mermaid-parser.core-DaS4aeEe.js";export{e as createArchitectureServices};