@nodetool-ai/manimgx-nodes 0.0.0-stage → 0.8.3

package/README.md

@@ -1,3 +1,43 @@
-# Temporary Holding Version
+# @nodetool-ai/manimgx-nodes
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[ManimGX](https://github.com/academa-labs/manimgx) nodes for NodeTool: math and
+3D animations written in Manim Community Edition's Python API, rendered to
+video by a Rust GPU engine.
+
+The nodes shell out to the `manimgx` command, resolved from the `MANIMGX_PATH`
+setting, `MANIMGX_PATH`, PATH, or `~/.local/bin`. In the desktop app, install
+ManimGX from the Package Manager: it runs `uv tool install manimgx` on a Python
+3.13 that uv downloads into the app's data directory, which is on the server's
+PATH. A node run without it asks for that install. Elsewhere, install it with:
+
+```bash
+uv tool install manimgx   # or: pip install manimgx (Python 3.13+)
+```
+
+They do not run in the hosted cloud, because a scene is a Python program that
+runs with the server's permissions.
+
+## Nodes
+
+| Node | Does |
+|---|---|
+| `RenderScene` | Scene code → MP4, with the storyboard, layout report and subtitles |
+| `InspectScene` | Storyboard, timeline and 2D layout checks, without video |
+| `GenerateScene` | A language model writes the scene, fixes it from the inspection, then renders |
+
+Each node takes dynamic inputs. The scene reads them with
+`from nodetool_inputs import inputs`; image, audio and video inputs arrive as
+file paths.
+
+## Tests
+
+```bash
+npm run test --workspace=packages/manimgx-nodes
+npm run test:real --workspace=packages/manimgx-nodes
+```
+
+The first runs against a fake `manimgx` and skips the real renders when none is
+installed. The second fails without a real install and renders through it.
+
+The authoring guide agents load is the
+[`manimgx` system skill](../system-skills/manimgx/SKILL.md).

package/dist/.nodetool-build-stamp

@@ -0,0 +1 @@
+2026-10-12T12:30:25.449Z

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@nodetool-ai/manimgx-nodes` — ManimGX scenes as workflow nodes.
+ *
+ * ManimGX renders math and 3D animations written with Manim Community
+ * Edition's Python API on a Rust GPU engine. These nodes run its command
+ * line: `RenderScene` (scene → MP4), `InspectScene` (storyboard, timeline and
+ * layout checks without video) and `GenerateScene` (a language model writes
+ * the scene and fixes it from the inspection). `MANIMGX_NODES` is registered
+ * in `@nodetool-ai/base-nodes` alongside the other node arrays.
+ */
+export { RenderSceneNode, MANIMGX_RENDER_NODES } from "./nodes/render-scene.js";
+export { InspectSceneNode, MANIMGX_INSPECT_NODES } from "./nodes/inspect-scene.js";
+export { GenerateSceneNode, MANIMGX_GENERATE_NODES, SCENE_AUTHOR_SYSTEM_PROMPT, extractSceneCode } from "./nodes/generate-scene.js";
+export { MANIMGX_INSTALL_HINT, resolveManimgxBinary, resetManimgxBinaryCache } from "./manimgx-binary.js";
+export type { ManimgxBinary } from "./manimgx-binary.js";
+export { MANIMGX_DISABLED_ERROR, MANIMGX_PRESETS, ManimgxError, childEnv, isManimgxEnabled, manimgxArgs, runManimgx } from "./run-manimgx.js";
+export type { ManimgxPreset, ManimgxRenderSettings, ManimgxResult, ManimgxRun, ManimgxRunOptions, ManimgxScene } from "./run-manimgx.js";
+export declare const MANIMGX_NODES: (typeof import("./nodes/render-scene.js").RenderSceneNode | typeof import("./nodes/inspect-scene.js").InspectSceneNode | typeof import("./nodes/generate-scene.js").GenerateSceneNode)[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,WAAW,EACX,UAAU,EACX,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAM1B,eAAO,MAAM,aAAa,0LAIzB,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * `@nodetool-ai/manimgx-nodes` — ManimGX scenes as workflow nodes.
+ *
+ * ManimGX renders math and 3D animations written with Manim Community
+ * Edition's Python API on a Rust GPU engine. These nodes run its command
+ * line: `RenderScene` (scene → MP4), `InspectScene` (storyboard, timeline and
+ * layout checks without video) and `GenerateScene` (a language model writes
+ * the scene and fixes it from the inspection). `MANIMGX_NODES` is registered
+ * in `@nodetool-ai/base-nodes` alongside the other node arrays.
+ */
+export { RenderSceneNode, MANIMGX_RENDER_NODES } from "./nodes/render-scene.js";
+export { InspectSceneNode, MANIMGX_INSPECT_NODES } from "./nodes/inspect-scene.js";
+export { GenerateSceneNode, MANIMGX_GENERATE_NODES, SCENE_AUTHOR_SYSTEM_PROMPT, extractSceneCode } from "./nodes/generate-scene.js";
+export { MANIMGX_INSTALL_HINT, resolveManimgxBinary, resetManimgxBinaryCache } from "./manimgx-binary.js";
+export { MANIMGX_DISABLED_ERROR, MANIMGX_PRESETS, ManimgxError, childEnv, isManimgxEnabled, manimgxArgs, runManimgx } from "./run-manimgx.js";
+import { MANIMGX_RENDER_NODES } from "./nodes/render-scene.js";
+import { MANIMGX_INSPECT_NODES } from "./nodes/inspect-scene.js";
+import { MANIMGX_GENERATE_NODES } from "./nodes/generate-scene.js";
+export const MANIMGX_NODES = [
+    ...MANIMGX_RENDER_NODES,
+    ...MANIMGX_INSPECT_NODES,
+    ...MANIMGX_GENERATE_NODES
+];
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,WAAW,EACX,UAAU,EACX,MAAM,kBAAkB,CAAC;AAU1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,oBAAoB;IACvB,GAAG,qBAAqB;IACxB,GAAG,sBAAsB;CAC1B,CAAC"}

package/dist/manimgx-binary.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ManimGX executable discovery.
+ *
+ * Order: the user's `MANIMGX_PATH` setting, the process `MANIMGX_PATH`, then
+ * `manimgx` on PATH, then `~/.local/bin/manimgx` (where `uv tool install`
+ * and `pip install --user` put it, which an app started from the desktop
+ * often lacks on PATH). The desktop Package Manager installs it into a
+ * directory the server's PATH already holds. The first candidate whose
+ * `--version` runs wins. Nothing found throws a `MissingRuntimePackageError`
+ * for `manimgx`, so the editor offers the install.
+ *
+ * The result is cached per process and invalidated when the configured path
+ * changes, so tests pointing `MANIMGX_PATH` at a fake re-resolve.
+ */
+export interface ManimgxBinary {
+    path: string;
+    version: string;
+}
+/** What to do when no ManimGX is found. */
+export declare const MANIMGX_INSTALL_HINT: string;
+/**
+ * Resolve the ManimGX executable. `configuredPath` is the user's
+ * `MANIMGX_PATH` setting; callers pass null under the cloud profile.
+ */
+export declare function resolveManimgxBinary(options?: {
+    configuredPath?: string | null;
+}): Promise<ManimgxBinary>;
+/** Forget the cached resolution. Tests use this after mutating the environment. */
+export declare function resetManimgxBinaryCache(): void;
+//# sourceMappingURL=manimgx-binary.d.ts.map

package/dist/manimgx-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manimgx-binary.d.ts","sourceRoot":"","sources":["../src/manimgx-binary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,eAAO,MAAM,oBAAoB,QAGiB,CAAC;AA2CnD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAC/C,OAAO,CAAC,aAAa,CAAC,CAoBxB;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/manimgx-binary.js

@@ -0,0 +1,89 @@
+/**
+ * ManimGX executable discovery.
+ *
+ * Order: the user's `MANIMGX_PATH` setting, the process `MANIMGX_PATH`, then
+ * `manimgx` on PATH, then `~/.local/bin/manimgx` (where `uv tool install`
+ * and `pip install --user` put it, which an app started from the desktop
+ * often lacks on PATH). The desktop Package Manager installs it into a
+ * directory the server's PATH already holds. The first candidate whose
+ * `--version` runs wins. Nothing found throws a `MissingRuntimePackageError`
+ * for `manimgx`, so the editor offers the install.
+ *
+ * The result is cached per process and invalidated when the configured path
+ * changes, so tests pointing `MANIMGX_PATH` at a fake re-resolve.
+ */
+import { execFile } from "node:child_process";
+import os from "node:os";
+import path from "node:path";
+import { promisify } from "node:util";
+import { MissingRuntimePackageError } from "@nodetool-ai/protocol";
+import { HostBinaryMissingError } from "@nodetool-ai/runtime";
+const execFileAsync = promisify(execFile);
+/** What to do when no ManimGX is found. */
+export const MANIMGX_INSTALL_HINT = "Install ManimGX from the Package Manager in the desktop app. Elsewhere, run " +
+    "`uv tool install manimgx` or `pip install manimgx` (Python 3.13 or newer), " +
+    "or set MANIMGX_PATH to the manimgx executable.";
+function parseVersion(output) {
+    const match = /manimgx\s+(\S+)/i.exec(output);
+    return match ? match[1] : null;
+}
+function firstLine(text) {
+    const line = text.trim().split("\n", 1)[0] ?? "";
+    return line.length > 200 ? `${line.slice(0, 200)}…` : line;
+}
+async function probe(candidate) {
+    try {
+        const { stdout, stderr } = await execFileAsync(candidate, ["--version"], {
+            timeout: 30000,
+            windowsHide: true
+        });
+        const version = parseVersion(`${stdout}\n${stderr}`);
+        if (version === null)
+            return { failure: firstLine(`${stdout}\n${stderr}`) };
+        return { binary: { path: candidate, version } };
+    }
+    catch (err) {
+        return {
+            failure: firstLine(err instanceof Error ? err.message : String(err))
+        };
+    }
+}
+function candidates(configuredPath) {
+    const list = [];
+    if (configuredPath)
+        list.push(configuredPath);
+    const envPath = process.env["MANIMGX_PATH"];
+    if (envPath !== undefined && envPath !== "")
+        list.push(envPath);
+    list.push("manimgx");
+    const exe = process.platform === "win32" ? "manimgx.exe" : "manimgx";
+    list.push(path.join(os.homedir(), ".local", "bin", exe));
+    return [...new Set(list)];
+}
+let cached = null;
+/**
+ * Resolve the ManimGX executable. `configuredPath` is the user's
+ * `MANIMGX_PATH` setting; callers pass null under the cloud profile.
+ */
+export async function resolveManimgxBinary(options = {}) {
+    const key = `${options.configuredPath ?? ""}\0${process.env["MANIMGX_PATH"] ?? ""}`;
+    if (cached && cached.key === key)
+        return cached.binary;
+    const failures = [];
+    for (const candidate of candidates(options.configuredPath)) {
+        const result = await probe(candidate);
+        if ("binary" in result) {
+            cached = { key, binary: result.binary };
+            return result.binary;
+        }
+        if (candidate === options.configuredPath || candidate === process.env["MANIMGX_PATH"]) {
+            failures.push(` MANIMGX_PATH=${JSON.stringify(candidate)} failed: ${result.failure}`);
+        }
+    }
+    throw new MissingRuntimePackageError(`manimgx was not found. ${MANIMGX_INSTALL_HINT}${failures.join("")}`, "manimgx", { cause: new HostBinaryMissingError("manimgx") });
+}
+/** Forget the cached resolution. Tests use this after mutating the environment. */
+export function resetManimgxBinaryCache() {
+    cached = null;
+}
+//# sourceMappingURL=manimgx-binary.js.map

package/dist/manimgx-binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manimgx-binary.js","sourceRoot":"","sources":["../src/manimgx-binary.ts"],"names":[],"mappings":"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"}

package/dist/nodes/generate-scene.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `nodetool.manimgx.GenerateScene` — a prompt → a ManimGX scene → video.
+ *
+ * A language model writes the scene; `manimgx inspect` checks it; the
+ * traceback or the layout report (and, by default, the storyboard pictures)
+ * go back to the model until the scene runs clean or the attempts run out.
+ * Then `manimgx render` makes the video. The code comes out with the video,
+ * so a person or a RenderScene node can take it from there.
+ *
+ * Layout problems are advisory: a scene that still has some after the last
+ * attempt renders anyway, with them in `report`. A scene that never runs
+ * throws its last traceback.
+ */
+import { BaseNode } from "@nodetool-ai/node-sdk";
+import type { LanguageModel } from "@nodetool-ai/protocol";
+import { type ProcessingContext } from "@nodetool-ai/runtime";
+import { type ImageOutput, type VideoOutput } from "./scene-base.js";
+export declare const SCENE_AUTHOR_SYSTEM_PROMPT = "You write ManimGX scenes. ManimGX is a Rust GPU animation engine with Manim Community Edition's Python API.\n\nWrite one Python module:\n- `import manimgx as m`, then exactly one class deriving m.Scene (or m.ThreeDScene for a 3D camera) with `def construct(self) -> None`.\n- Time advances only through self.play(...) and self.wait(...). self.add(...) adds without animating.\n- Place with VGroup, arrange, next_to, to_edge and center so labels follow their subjects. The frame is about 14.2 units wide and 8 tall, centred on the origin; keep everything inside it.\n- Text for prose, MathTex(r\"...\") with raw strings for LaTeX mathematics. No LaTeX installation is needed.\n- For changing values, animate a ValueTracker and derive geometry from it with always_redraw or updaters. Updaters use elapsed time or state, never frame counts.\n- For 3D: m.ThreeDScene, self.set_camera_orientation(phi=..., theta=...), Surface, Sphere, Cube, ThreeDAxes, self.begin_ambient_camera_rotation(rate=...).\n- Values from the workflow are `from nodetool_inputs import inputs` (a dict). Media inputs are file paths: m.ImageMobject(path) for images, self.add_sound(path) for audio.\n- Read no other files and touch no network: the scene runs headless.\n\nReply with the complete module in a single ```python code block, nothing after it. When told about an error or layout problems, reply with the whole corrected module.";
+/** The longest fenced code block, or the whole reply when it is bare code. */
+export declare function extractSceneCode(reply: string): string;
+type GenerateSceneOutputs = {
+    video: VideoOutput;
+    code: string;
+    storyboard: ImageOutput[];
+    report: string;
+    attempts: number;
+};
+export declare class GenerateSceneNode extends BaseNode {
+    static readonly nodeType = "nodetool.manimgx.GenerateScene";
+    static readonly title = "Generate ManimGX Scene";
+    static readonly description = "Describe a math or 3D animation and get a video: a language model writes a ManimGX scene, ManimGX inspects it, and the model fixes errors and layout problems from the report and storyboard before the final render.\n    manim, manimgx, animation, math, explainer, generate, llm, agent, 3d, video, python\n\n    Use cases:\n    - Explain a formula, theorem or algorithm as a short animation\n    - Make a 3D visualization from a sentence\n    - Draft a scene to refine in a RenderScene node";
+    static readonly metadataOutputTypes: {
+        video: string;
+        code: string;
+        storyboard: string;
+        report: string;
+        attempts: string;
+    };
+    static readonly inputFields: string[];
+    static readonly supportsDynamicInputs = true;
+    static readonly requiredRuntimes: string[];
+    model: LanguageModel;
+    prompt: string;
+    max_attempts: number;
+    send_storyboard: boolean;
+    width: number;
+    height: number;
+    fps: number;
+    timeout: number;
+    process(context?: ProcessingContext): Promise<GenerateSceneOutputs>;
+}
+export declare const MANIMGX_GENERATE_NODES: readonly [typeof GenerateSceneNode];
+export {};
+//# sourceMappingURL=generate-scene.d.ts.map

package/dist/nodes/generate-scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-scene.d.ts","sourceRoot":"","sources":["../../src/nodes/generate-scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAQ,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAUzB,eAAO,MAAM,0BAA0B,m4CAYmI,CAAC;AAE3K,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBtD;AAoCD,KAAK,oBAAoB,GAAG;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,MAAM,CAAC,QAAQ,CAAC,QAAQ,oCAAoC;IAC5D,MAAM,CAAC,QAAQ,CAAC,KAAK,4BAA4B;IACjD,MAAM,CAAC,QAAQ,CAAC,WAAW,8eACkd;IAC7e,MAAM,CAAC,QAAQ,CAAC,mBAAmB;QACjC,KAAK;QACL,IAAI;QACJ,UAAU;QACV,MAAM;QACN,QAAQ;MACR;IACF,MAAM,CAAC,QAAQ,CAAC,WAAW,WAAc;IACzC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,QAAQ;IAC7C,MAAM,CAAC,QAAQ,CAAC,gBAAgB,WAAe;IAQvC,KAAK,EAAE,aAAa,CAAC;IAQrB,MAAM,EAAE,MAAM,CAAC;IAGf,YAAY,EAAE,MAAM,CAAC;IAQrB,eAAe,EAAE,OAAO,CAAC;IAGzB,KAAK,EAAE,MAAM,CAAC;IAGd,MAAM,EAAE,MAAM,CAAC;IAGf,GAAG,EAAE,MAAM,CAAC;IAGZ,OAAO,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4FxE;CACF;AAED,eAAO,MAAM,sBAAsB,qCAA+B,CAAC"}

package/dist/nodes/generate-scene.js

@@ -0,0 +1,242 @@
+/**
+ * `nodetool.manimgx.GenerateScene` — a prompt → a ManimGX scene → video.
+ *
+ * A language model writes the scene; `manimgx inspect` checks it; the
+ * traceback or the layout report (and, by default, the storyboard pictures)
+ * go back to the model until the scene runs clean or the attempts run out.
+ * Then `manimgx render` makes the video. The code comes out with the video,
+ * so a person or a RenderScene node can take it from there.
+ *
+ * Layout problems are advisory: a scene that still has some after the last
+ * attempt renders anyway, with them in `report`. A scene that never runs
+ * throws its last traceback.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseNode, prop } from "@nodetool-ai/node-sdk";
+import { meterProviderSpend } from "@nodetool-ai/llm-nodes/nodes/provider-spend";
+import { messageText } from "@nodetool-ai/runtime";
+import { ManimgxError, runManimgx } from "../run-manimgx.js";
+import { imageOutput, runNodeStep, videoOutput } from "./scene-base.js";
+const NODE_NAME = "nodetool.manimgx.GenerateScene";
+/** Tokens one scene may take. Long films run a few hundred lines. */
+const MAX_SCENE_TOKENS = 12000;
+/** Storyboard sheets sent back per attempt: each holds up to six frames. */
+const MAX_FEEDBACK_SHEETS = 2;
+export const SCENE_AUTHOR_SYSTEM_PROMPT = `You write ManimGX scenes. ManimGX is a Rust GPU animation engine with Manim Community Edition's Python API.
+
+Write one Python module:
+- \`import manimgx as m\`, then exactly one class deriving m.Scene (or m.ThreeDScene for a 3D camera) with \`def construct(self) -> None\`.
+- Time advances only through self.play(...) and self.wait(...). self.add(...) adds without animating.
+- Place with VGroup, arrange, next_to, to_edge and center so labels follow their subjects. The frame is about 14.2 units wide and 8 tall, centred on the origin; keep everything inside it.
+- Text for prose, MathTex(r"...") with raw strings for LaTeX mathematics. No LaTeX installation is needed.
+- For changing values, animate a ValueTracker and derive geometry from it with always_redraw or updaters. Updaters use elapsed time or state, never frame counts.
+- For 3D: m.ThreeDScene, self.set_camera_orientation(phi=..., theta=...), Surface, Sphere, Cube, ThreeDAxes, self.begin_ambient_camera_rotation(rate=...).
+- Values from the workflow are \`from nodetool_inputs import inputs\` (a dict). Media inputs are file paths: m.ImageMobject(path) for images, self.add_sound(path) for audio.
+- Read no other files and touch no network: the scene runs headless.
+
+Reply with the complete module in a single \`\`\`python code block, nothing after it. When told about an error or layout problems, reply with the whole corrected module.`;
+/** The longest fenced code block, or the whole reply when it is bare code. */
+export function extractSceneCode(reply) {
+    // A line scan, not a regex: the reply is model output of any shape.
+    const blocks = [];
+    let open = null;
+    for (const line of reply.split("\n")) {
+        if (line.trimStart().startsWith("```")) {
+            if (open) {
+                blocks.push(open.join("\n"));
+                open = null;
+            }
+            else {
+                open = [];
+            }
+        }
+        else if (open) {
+            open.push(line);
+        }
+    }
+    if (blocks.length > 0) {
+        return blocks.reduce((a, b) => (b.length > a.length ? b : a)).trim();
+    }
+    return /\bimport manimgx\b/.test(reply) ? reply.trim() : "";
+}
+function describeInputs(inputs) {
+    const names = Object.keys(inputs);
+    if (names.length === 0)
+        return "";
+    const lines = names.map((name) => {
+        const value = inputs[name];
+        const kind = value && typeof value === "object" && "type" in value
+            ? `${String(value.type)} file path`
+            : JSON.stringify(value)?.slice(0, 200) ?? "null";
+        return `- inputs[${JSON.stringify(name)}]: ${kind}`;
+    });
+    return `\n\nThe scene can read these values:\n${lines.join("\n")}`;
+}
+function feedbackMessage(result, sendStoryboard) {
+    if (!result.ok) {
+        return {
+            role: "user",
+            content: `The scene failed:\n\n${result.report}\n\nFix it and reply with the whole module.`
+        };
+    }
+    const text = `The scene runs, but inspection found layout problems:\n\n${result.report}\n\n` +
+        "Fix them (the storyboard numbers each one) and reply with the whole module.";
+    if (!sendStoryboard || result.storyboards.length === 0) {
+        return { role: "user", content: text };
+    }
+    const content = [{ type: "text", text }];
+    for (const sheet of result.storyboards.slice(0, MAX_FEEDBACK_SHEETS)) {
+        content.push({ type: "image_url", image: { data: sheet, mimeType: "image/png" } });
+    }
+    return { role: "user", content };
+}
+export class GenerateSceneNode extends BaseNode {
+    static nodeType = "nodetool.manimgx.GenerateScene";
+    static title = "Generate ManimGX Scene";
+    static description = "Describe a math or 3D animation and get a video: a language model writes a ManimGX scene, ManimGX inspects it, and the model fixes errors and layout problems from the report and storyboard before the final render.\n    manim, manimgx, animation, math, explainer, generate, llm, agent, 3d, video, python\n\n    Use cases:\n    - Explain a formula, theorem or algorithm as a short animation\n    - Make a 3D visualization from a sentence\n    - Draft a scene to refine in a RenderScene node";
+    static metadataOutputTypes = {
+        video: "video",
+        code: "str",
+        storyboard: "list[image]",
+        report: "str",
+        attempts: "int"
+    };
+    static inputFields = ["prompt"];
+    static supportsDynamicInputs = true;
+    static requiredRuntimes = ["manimgx"];
+    async process(context) {
+        if (!context)
+            throw new Error(`${NODE_NAME} requires a processing context`);
+        const prompt = this.prompt?.trim() ?? "";
+        if (!prompt)
+            throw new Error(`${NODE_NAME}: prompt is empty — describe the animation`);
+        const providerId = this.model?.provider ?? "";
+        const modelId = this.model?.id ?? "";
+        if (!providerId || providerId === "empty" || !modelId) {
+            throw new Error(`${NODE_NAME}: pick a model — the scene needs a writer`);
+        }
+        const inputs = Object.fromEntries([...this.dynamicProps.entries()].filter(([name]) => !name.startsWith("_")));
+        const timeoutMs = Math.max(1, Math.round(Number(this.timeout ?? 300))) * 1000;
+        const maxAttempts = Math.min(8, Math.max(1, Math.round(Number(this.max_attempts ?? 3))));
+        const signal = context.signal;
+        return runNodeStep(NODE_NAME, signal, async () => {
+            const provider = await context.getProvider(providerId);
+            const spend = meterProviderSpend(context, provider, modelId);
+            try {
+                const messages = [
+                    { role: "system", content: SCENE_AUTHOR_SYSTEM_PROMPT },
+                    { role: "user", content: `${prompt}${describeInputs(inputs)}` }
+                ];
+                let scene = null;
+                let inspected = null;
+                let attempts = 0;
+                while (attempts < maxAttempts) {
+                    signal?.throwIfAborted();
+                    attempts += 1;
+                    const reply = await provider.generateMessage({
+                        messages: [...messages],
+                        model: modelId,
+                        maxTokens: MAX_SCENE_TOKENS
+                    });
+                    const text = messageText(reply.content);
+                    messages.push({ role: "assistant", content: text });
+                    const code = extractSceneCode(text);
+                    if (!code) {
+                        messages.push({
+                            role: "user",
+                            content: "Reply with the complete scene module in a single ```python code block."
+                        });
+                        continue;
+                    }
+                    scene = { code, inputs };
+                    inspected = await runManimgx(context, scene, { command: "inspect" }, { timeoutMs, signal });
+                    context.postMessage?.({
+                        type: "log_update",
+                        node_id: this.__node_id,
+                        node_name: NODE_NAME,
+                        content: `Attempt ${attempts}: ${inspected.ok ? (inspected.problems ? "layout problems" : "clean") : "scene failed"}`,
+                        severity: inspected.ok ? "info" : "warning"
+                    });
+                    if (inspected.ok && !inspected.problems)
+                        break;
+                    messages.push(feedbackMessage(inspected, this.send_storyboard !== false));
+                }
+                if (!scene || !inspected) {
+                    throw new ManimgxError(`the model wrote no scene code in ${attempts} attempts`);
+                }
+                if (!inspected.ok) {
+                    throw new ManimgxError(`the scene still fails after ${attempts} attempts:\n${inspected.report}`);
+                }
+                const rendered = await runManimgx(context, scene, {
+                    command: "render",
+                    settings: {
+                        width: Number(this.width ?? 1920),
+                        height: Number(this.height ?? 1080),
+                        fps: Number(this.fps ?? 30),
+                        preset: "medium",
+                        crf: 23
+                    }
+                }, { timeoutMs, signal });
+                if (!rendered.ok || !rendered.video) {
+                    throw new ManimgxError(`the scene failed to render:\n${rendered.report}`);
+                }
+                return {
+                    video: videoOutput(rendered.video),
+                    code: scene.code,
+                    storyboard: rendered.storyboards.map(imageOutput),
+                    report: rendered.report,
+                    attempts
+                };
+            }
+            finally {
+                spend.report();
+            }
+        });
+    }
+}
+__decorate([
+    prop({
+        type: "language_model",
+        default: { type: "language_model", provider: "empty", id: "", name: "", path: null, supported_tasks: [] },
+        title: "Model",
+        description: "Model that writes the scene. A vision model also reads the storyboard."
+    })
+], GenerateSceneNode.prototype, "model", void 0);
+__decorate([
+    prop({
+        type: "str",
+        default: "",
+        title: "Prompt",
+        description: "What to animate. Wired dynamic inputs reach the scene as `inputs`."
+    })
+], GenerateSceneNode.prototype, "prompt", void 0);
+__decorate([
+    prop({ type: "int", default: 3, title: "Max Attempts", description: "Write-and-inspect rounds before rendering", min: 1, max: 8 })
+], GenerateSceneNode.prototype, "max_attempts", void 0);
+__decorate([
+    prop({
+        type: "bool",
+        default: true,
+        title: "Send Storyboard",
+        description: "Show the model the storyboard pictures with layout problems (needs a vision model)"
+    })
+], GenerateSceneNode.prototype, "send_storyboard", void 0);
+__decorate([
+    prop({ type: "int", default: 1920, title: "Width", description: "Video width in pixels", min: 16, max: 7680 })
+], GenerateSceneNode.prototype, "width", void 0);
+__decorate([
+    prop({ type: "int", default: 1080, title: "Height", description: "Video height in pixels", min: 16, max: 4320 })
+], GenerateSceneNode.prototype, "height", void 0);
+__decorate([
+    prop({ type: "int", default: 30, title: "FPS", description: "Frames per second", min: 1, max: 120 })
+], GenerateSceneNode.prototype, "fps", void 0);
+__decorate([
+    prop({ type: "int", default: 300, title: "Timeout", description: "Maximum seconds for each ManimGX run", min: 1, max: 3600 })
+], GenerateSceneNode.prototype, "timeout", void 0);
+export const MANIMGX_GENERATE_NODES = [GenerateSceneNode];
+//# sourceMappingURL=generate-scene.js.map

package/dist/nodes/generate-scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-scene.js","sourceRoot":"","sources":["../../src/nodes/generate-scene.ts"],"names":[],"mappings":"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"}

package/dist/nodes/inspect-scene.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `nodetool.manimgx.InspectScene` — check a ManimGX scene without video.
+ *
+ * Runs `manimgx inspect`: the storyboard (the frame at each play's end, or at
+ * the times asked for, layout problems outlined and numbered), the timeline
+ * of plays with their source lines, and 2D layout checks (clipped content,
+ * overlapping text, small labels). This is the feedback half of an authoring
+ * loop, so a scene that fails is a result here, not an error: `ok` is false
+ * and `report` carries the traceback with ManimGX's hint.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import { ManimgxSceneNode, type ImageOutput } from "./scene-base.js";
+type InspectSceneOutputs = {
+    ok: boolean;
+    problems: boolean;
+    report: string;
+    storyboard: ImageOutput[];
+    duration: number;
+};
+export declare class InspectSceneNode extends ManimgxSceneNode {
+    static readonly nodeType = "nodetool.manimgx.InspectScene";
+    static readonly title = "Inspect ManimGX Scene";
+    static readonly description = "Check a ManimGX scene without rendering video: a storyboard of key frames, the timeline of plays, and 2D layout problems such as clipped content or overlapping text.\n    manim, manimgx, inspect, storyboard, layout, check, preview, animation, python\n\n    Use cases:\n    - Preview a scene's key frames before a full render\n    - Feed layout problems and tracebacks back to an LLM that writes the scene\n    - Grab stills at chosen times";
+    static readonly metadataOutputTypes: {
+        ok: string;
+        problems: string;
+        report: string;
+        storyboard: string;
+        duration: string;
+    };
+    times: string;
+    process(context?: ProcessingContext): Promise<InspectSceneOutputs>;
+}
+export declare const MANIMGX_INSPECT_NODES: readonly [typeof InspectSceneNode];
+export {};
+//# sourceMappingURL=inspect-scene.d.ts.map

package/dist/nodes/inspect-scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-scene.d.ts","sourceRoot":"","sources":["../../src/nodes/inspect-scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EACL,gBAAgB,EAGhB,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAIzB,KAAK,mBAAmB,GAAG;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,MAAM,CAAC,QAAQ,CAAC,QAAQ,mCAAmC;IAC3D,MAAM,CAAC,QAAQ,CAAC,KAAK,2BAA2B;IAChD,MAAM,CAAC,QAAQ,CAAC,WAAW,6bACia;IAC5b,MAAM,CAAC,QAAQ,CAAC,mBAAmB;QACjC,EAAE;QACF,QAAQ;QACR,MAAM;QACN,UAAU;QACV,QAAQ;MACR;IAQM,KAAK,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgBvE;CACF;AAED,eAAO,MAAM,qBAAqB,oCAA8B,CAAC"}