@autopo/mcp 0.1.1 → 0.4.0

package/dist/files.js

@@ -0,0 +1,378 @@
+/**
+ * Your own files into the Studio. When the server runs on the person's machine (stdio, `npx -y @autopo/mcp`), a tool
+ * can take paths: the server reads them itself and uploads in 8 MB chunks through the Studio's upload API, the same
+ * way the web app does. Hosted, it takes URLs. Nothing travels through the MCP connection, which carries only JSON.
+ */
+import { open, readdir, readFile, stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, extname, join, relative, resolve } from 'node:path';
+import { ApiError } from './api.js';
+import { ToolError } from './kit.js';
+import { bufferRange, handleRange, isZip, zipDataOffset, zipEntries, zipRead } from './zip.js';
+export const MEDIA_TYPES = {
+    '.mp4': 'video/mp4', '.m4v': 'video/mp4', '.mov': 'video/quicktime', '.webm': 'video/webm', '.mkv': 'video/x-matroska', '.avi': 'video/x-msvideo',
+    '.mp3': 'audio/mpeg', '.wav': 'audio/wav', '.m4a': 'audio/mp4', '.aac': 'audio/aac', '.ogg': 'audio/ogg', '.flac': 'audio/flac', '.aif': 'audio/aiff', '.aiff': 'audio/aiff',
+    '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.webp': 'image/webp', '.gif': 'image/gif', '.heic': 'image/heic', '.avif': 'image/avif', '.bmp': 'image/bmp', '.tif': 'image/tiff', '.tiff': 'image/tiff',
+};
+export function mediaType(name) {
+    return MEDIA_TYPES[extname(name).toLowerCase()];
+}
+const MAX_IN_MEMORY = 512 * 1024 * 1024;
+export function expandHome(path) {
+    return path.replace(/^~(?=$|\/)/, homedir());
+}
+const byName = (a, b) => a.localeCompare(b, undefined, { numeric: true, sensitivity: 'base' });
+/** A file, or a folder's media files in name order (2 before 10). */
+export async function expandPath(path) {
+    const full = resolve(expandHome(path));
+    const info = await stat(full).catch(() => null);
+    if (!info)
+        throw new ToolError(`${path}: no such file or folder on this machine (paths are read where the server runs; absolute paths are safest).`);
+    if (info.isFile())
+        return [full];
+    const names = (await readdir(full, { withFileTypes: true }))
+        .filter((d) => d.isFile() && !d.name.startsWith('.') && mediaType(d.name))
+        .map((d) => d.name)
+        .sort(byName);
+    if (names.length === 0)
+        throw new ToolError(`${path}: no images, clips or audio files in that folder.`);
+    return names.map((n) => join(full, n));
+}
+export async function pathSource(path) {
+    const full = resolve(expandHome(path));
+    const info = await stat(full).catch(() => null);
+    if (!info?.isFile())
+        throw new ToolError(`${path}: no such file on this machine.`);
+    const type = mediaType(full) ?? '';
+    return {
+        name: basename(full),
+        size: info.size,
+        type,
+        async *chunks(size) {
+            const handle = await open(full, 'r');
+            try {
+                let offset = 0;
+                while (offset < info.size) {
+                    const want = Math.min(size, info.size - offset);
+                    const part = await handleRange(handle, info.size).read(offset, want);
+                    if (part.length === 0)
+                        break;
+                    offset += part.length;
+                    yield part;
+                }
+            }
+            finally {
+                await handle.close();
+            }
+        },
+    };
+}
+function nameFromResponse(url, response) {
+    const disposition = response.headers.get('content-disposition') ?? '';
+    const m = /filename\*?=(?:UTF-8'')?"?([^";]+)"?/i.exec(disposition);
+    if (m?.[1])
+        return decodeURIComponent(m[1]);
+    const last = new URL(url).pathname.split('/').filter(Boolean).pop();
+    return last ? decodeURIComponent(last) : 'download';
+}
+/** A public link: streamed when its size is known, read whole (up to 512 MB) when it is not. */
+export async function urlSource(url, fetchImpl = globalThis.fetch) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new ToolError(`${url}: not a URL.`);
+    }
+    if (!['http:', 'https:'].includes(parsed.protocol))
+        throw new ToolError(`${url}: only http(s) links can be fetched.`);
+    const response = await fetchImpl(url);
+    if (!response.ok || !response.body)
+        throw new ToolError(`${url}: HTTP ${response.status}.`);
+    const name = nameFromResponse(url, response);
+    const header = (response.headers.get('content-type') ?? '').split(';')[0].trim();
+    const type = /^(image|video|audio)\//.test(header) ? header : (mediaType(name) ?? '');
+    const length = Number(response.headers.get('content-length'));
+    if (Number.isFinite(length) && length > 0) {
+        const body = response.body;
+        return {
+            name,
+            size: length,
+            type,
+            async *chunks(size) {
+                const reader = body.getReader();
+                let pending = [];
+                let have = 0;
+                for (;;) {
+                    const { done, value } = await reader.read();
+                    if (value) {
+                        pending.push(value);
+                        have += value.length;
+                    }
+                    while (have >= size || (done && have > 0)) {
+                        const out = Buffer.concat(pending);
+                        const piece = out.subarray(0, Math.min(size, out.length));
+                        const rest = out.subarray(piece.length);
+                        pending = rest.length ? [rest] : [];
+                        have = rest.length;
+                        yield piece;
+                    }
+                    if (done)
+                        break;
+                }
+            },
+        };
+    }
+    const data = Buffer.from(await response.arrayBuffer());
+    if (data.length > MAX_IN_MEMORY)
+        throw new ToolError(`${url}: over 512 MB with no Content-Length; upload it from a machine instead.`);
+    return bytesSource(name, data, type);
+}
+export function bytesSource(name, data, type = mediaType(name) ?? '') {
+    return {
+        name,
+        size: data.length,
+        type,
+        async *chunks(size) {
+            for (let offset = 0; offset < data.length; offset += size)
+                yield data.subarray(offset, Math.min(offset + size, data.length));
+        },
+    };
+}
+/** A zip entry: streamed by range when stored, inflated whole when deflated. */
+export function zipSource(range, entry) {
+    const name = basename(entry.name);
+    return {
+        name,
+        size: entry.size,
+        type: mediaType(name) ?? '',
+        async *chunks(size) {
+            if (entry.method === 0) {
+                const start = await zipDataOffset(range, entry);
+                for (let offset = 0; offset < entry.size; offset += size)
+                    yield await range.read(start + offset, Math.min(size, entry.size - offset));
+                return;
+            }
+            const data = await zipRead(range, entry);
+            for (let offset = 0; offset < data.length; offset += size)
+                yield data.subarray(offset, Math.min(offset + size, data.length));
+        },
+    };
+}
+/** Progress notifications to the host, when it asked for them (a progressToken on the request). */
+export function progressOf(ctx) {
+    const token = ctx.mcpReq._meta?.progressToken;
+    return async (progress, total, message) => {
+        if (token === undefined || token === null)
+            return;
+        try {
+            await ctx.mcpReq.notify({ method: 'notifications/progress', params: { progressToken: token, progress, ...(total !== undefined ? { total } : {}), message } });
+        }
+        catch {
+            /* a host that takes no progress loses nothing */
+        }
+    };
+}
+export const mb = (n) => `${(n / (1024 * 1024)).toFixed(n < 10 * 1024 * 1024 ? 1 : 0)} MB`;
+/** One file into the library: begin, the chunks in order, complete. Returns the media (processing, soon ready). */
+export async function upload(s, companyId, source, options = {}) {
+    if (source.size <= 0)
+        throw new ToolError(`${source.name}: the file is empty.`);
+    const begun = await s.api.post(`/api/companies/${companyId}/studio/uploads`, {
+        filename: source.name,
+        content_type: source.type,
+        byte_size: source.size,
+        ...(options.production ? { production: options.production } : {}),
+    });
+    const id = begun.media.id;
+    const chunkBytes = begun.chunk_bytes && begun.chunk_bytes > 0 ? begun.chunk_bytes : 8 * 1024 * 1024;
+    let offset = 0;
+    for await (const part of source.chunks(chunkBytes)) {
+        if (options.signal?.aborted)
+            throw new ToolError(`${source.name}: upload cancelled.`);
+        const bytes = new Uint8Array(part.buffer, part.byteOffset, part.byteLength);
+        await s.api.send('PUT', `/api/studio/uploads/${id}`, bytes, 'application/octet-stream', { offset });
+        offset += part.byteLength;
+        await options.onBytes?.(offset, source.size);
+    }
+    if (offset !== source.size)
+        throw new ToolError(`${source.name}: read ${offset} of ${source.size} bytes; the file changed while uploading.`);
+    let media = await s.api.post(`/api/studio/uploads/${id}/complete`);
+    if (options.title && options.title !== media.title)
+        media = await s.api.patch(`/api/studio/media/${id}`, { title: options.title });
+    return media;
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** Wait until uploads are ready (the Studio reads each file's shape and makes a thumbnail; recordings become web video). */
+export async function waitReady(s, ids, options = {}) {
+    const out = {};
+    const deadline = Date.now() + (options.timeoutMs ?? 240_000);
+    let waiting = [...ids];
+    while (waiting.length > 0) {
+        const still = [];
+        for (const id of waiting) {
+            const media = await s.api.get(`/api/studio/media/${id}`);
+            if (media.status === 'ready')
+                out[id] = media;
+            else if (media.status === 'failed')
+                throw new ToolError(`${media.title ?? id} couldn't be read: ${media.error ?? 'the Studio could not process it'}.`);
+            else
+                still.push(id);
+        }
+        waiting = still;
+        if (waiting.length === 0)
+            break;
+        if (options.signal?.aborted)
+            throw new ToolError('Cancelled while the Studio was processing the files.');
+        if (Date.now() > deadline)
+            throw new ToolError(`${waiting.length} file(s) are still processing; try again in a minute (list_media shows their state).`);
+        await options.progress?.(ids.length - waiting.length, ids.length, `Processing ${ids.length - waiting.length}/${ids.length} files…`);
+        await sleep(2000);
+    }
+    return out;
+}
+export const FILE_REF = 'file:';
+export const ICON_REF = 'icon:';
+/** The plan's `file:…` and `icon:…` references, found like the platform does: exact path, else the file's name, else its stem. */
+export function findFile(files, ref) {
+    const name = ref.slice(ref.indexOf(':') + 1).trim();
+    if (name in files)
+        return name;
+    const wanted = basename(name);
+    const stem = wanted.replace(/\.[^.]+$/, '');
+    for (const key of Object.keys(files)) {
+        const base = basename(key);
+        if (base === wanted || base.replace(/\.[^.]+$/, '') === stem)
+            return key;
+    }
+    return undefined;
+}
+export function isFileRef(value) {
+    return typeof value === 'string' && (value.startsWith(FILE_REF) || value.startsWith(ICON_REF));
+}
+/** Every file reference in a plan, deep, in order of first appearance. */
+export function fileRefs(value, out = []) {
+    if (isFileRef(value)) {
+        if (!out.includes(value))
+            out.push(value);
+    }
+    else if (Array.isArray(value)) {
+        for (const v of value)
+            fileRefs(v, out);
+    }
+    else if (value && typeof value === 'object') {
+        for (const v of Object.values(value))
+            fileRefs(v, out);
+    }
+    return out;
+}
+/** The plan with each file reference replaced by the id it became. */
+export function rewriteRefs(value, ids) {
+    if (isFileRef(value))
+        return (ids[value] ?? value);
+    if (Array.isArray(value))
+        return value.map((v) => rewriteRefs(v, ids));
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value))
+            out[k] = rewriteRefs(v, ids);
+        return out;
+    }
+    return value;
+}
+function parsePlan(text, where) {
+    let plan;
+    try {
+        plan = JSON.parse(text);
+    }
+    catch (error) {
+        throw new ToolError(`${where}: the plan isn't valid JSON (${error.message}).`);
+    }
+    if (!plan || typeof plan !== 'object' || Array.isArray(plan))
+        throw new ToolError(`${where}: the plan is an object {title, shots, …}.`);
+    return plan;
+}
+async function walk(dir, root = dir, out = []) {
+    for (const entry of await readdir(dir, { withFileTypes: true })) {
+        if (entry.name.startsWith('.') || entry.name === 'node_modules')
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory())
+            await walk(full, root, out);
+        else if (entry.isFile())
+            out.push(relative(root, full).split('\\').join('/'));
+    }
+    return out;
+}
+async function zipBundle(range, where, close) {
+    const entries = await zipEntries(range);
+    const planEntry = entries.find((e) => basename(e.name) === 'plan.json');
+    if (!planEntry) {
+        await close();
+        throw new ToolError(`${where}: the zip has no plan.json.`);
+    }
+    const root = planEntry.name.slice(0, -'plan.json'.length);
+    const plan = parsePlan((await zipRead(range, planEntry)).toString('utf8'), where);
+    const files = {};
+    for (const entry of entries) {
+        if (entry === planEntry || basename(entry.name).startsWith('.'))
+            continue;
+        const key = entry.name.startsWith(root) ? entry.name.slice(root.length) : entry.name;
+        files[key] = async () => zipSource(range, entry);
+    }
+    return { plan, files, close };
+}
+/** A plan from this machine: a zip, a plan.json (the files beside it come along), or a folder holding plan.json. */
+export async function planFromPath(path) {
+    const full = resolve(expandHome(path));
+    const info = await stat(full).catch(() => null);
+    if (!info)
+        throw new ToolError(`${path}: no such file or folder on this machine.`);
+    let dir = full;
+    let planPath = full;
+    if (info.isDirectory()) {
+        planPath = join(full, 'plan.json');
+        if (!(await stat(planPath).catch(() => null)))
+            throw new ToolError(`${path}: no plan.json in that folder.`);
+    }
+    else {
+        const handle = await open(full, 'r');
+        const range = handleRange(handle, info.size);
+        if (await isZip(range))
+            return zipBundle(range, path, () => handle.close());
+        await handle.close();
+        dir = resolve(full, '..');
+    }
+    const plan = parsePlan(await readFile(planPath, 'utf8'), path);
+    const files = {};
+    for (const rel of await walk(dir)) {
+        if (join(dir, rel) === planPath)
+            continue;
+        files[rel] = () => pathSource(join(dir, rel));
+    }
+    return { plan, files, close: async () => { } };
+}
+/** A plan from a link: a zip or a plan.json, read whole (up to 512 MB). */
+export async function planFromUrl(url, fetchImpl = globalThis.fetch) {
+    const response = await fetchImpl(url);
+    if (!response.ok)
+        throw new ToolError(`${url}: HTTP ${response.status}.`);
+    const data = Buffer.from(await response.arrayBuffer());
+    if (data.length > MAX_IN_MEMORY)
+        throw new ToolError(`${url}: over 512 MB; import it from a machine with the file instead.`);
+    const range = bufferRange(data);
+    if (await isZip(range))
+        return zipBundle(range, url, async () => { });
+    return { plan: parsePlan(data.toString('utf8'), url), files: {}, close: async () => { } };
+}
+/** Why a path can't be read on this connection, with the way out. */
+export function noLocalFiles(s, companyId) {
+    const studio = companyId ? ` or drop the files into the Studio library (${s.link(`/c/${companyId}/studio`)}) and use their media ids` : '';
+    return new ToolError(`This connection runs in the cloud, so it can't read files on your computer. Give public URLs instead, run the server on your machine (npx -y @autopo/mcp, see https://docs.autopoiesis.app/clients)${studio}.`);
+}
+export function describeApiError(error) {
+    if (error instanceof ApiError)
+        return `${error.message} (HTTP ${error.status})`;
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

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

package/dist/guides.d.ts

@@ -1,3 +1,4 @@
 /** Guides served as resources and read by the prompts: short, in plain words, the way the platform writes. */
-export declare const STUDIO_GUIDE = "# The Studio, in short\n\nThe Studio makes images, clips, voice lines and music, and cuts them into videos. A video is a storyboard: shots in\norder, each with a picture (generated, footage you have, a title card, or a presenter), a line of voice-over, text on\nscreen, a length in seconds, and direction for the critic.\n\n## Who does what\n- **You** say what the video is for and how it should feel. One paragraph is enough: who it is for, what it must show,\n  the one thing to feel.\n- **The platform** drafts the storyboard from that brief for free (create_video with draft on).\n- **Rose, the Creative Director** (ask_agent creative, with production set to the video id) tightens shots, writes\n  better lines, picks looks and models, and proposes changes you apply with apply_chat_action.\n- **The critic** (critique_video) judges takes against each shot's direction and keeps the best.\n\n## Models and money\nstudio_overview lists every model the company can run with its price per image, per second of clip, per voice line or\nper track. update_video {style: {models: {clip, keyframe, voice, music}}} picks them for one video; studio_settings\nsets the defaults. Keyframes (one still per shot) cost cents and lock the look before clips, which cost the most. Every\ntool that spends asks you first, through your tool's own dialog, with the amount.\n\n## The order that works\n1. create_video \u2192 2. get_video, read the shots \u2192 3. ask_agent creative to tighten \u2192 4. update_video models if needed \u2192\n5. video_keyframes \u2192 wait_for_video \u2192 critique_video keyframes \u2192 6. make_video_media all \u2192 wait_for_video \u2192\ncritique_video clips \u2192 7. render_video \u2192 wait_for_video \u2192 the render link, or open_in_app video.\n\n## Shapes and lengths\n16:9 for the web and decks, 9:16 for Reels, Shorts and TikTok, 1:1 and 4:5 for feeds. Teasers run 15 to 30 seconds;\na product walkthrough 60 to 90. Fewer, longer shots read better than many short ones.\n\n## When something is missing\nget_video and wait_for_video list what still blocks a render: a shot without media, a voice line not made, music not\ncomposed. make_video_media takes a `what` (visuals, voice, music or all) to fill only that gap. A failed generation can\nbe retried with update_media {action: retry}.\n";
-export declare const TEASER_GUIDE = "# Making a teaser from a terminal\n\nThe loop, tool by tool (the make_a_teaser prompt runs it for you):\n\n1. brand_brain: the voice, the audience, the enemy.\n2. create_video {title, brief, aspect_ratio, seconds: 20}: a storyboard is drafted for free.\n3. get_video: read the shots. ask_agent {agent: \"creative\", production: <video id>, message: ...}: Rose tightens them;\n   apply_chat_action on her proposals, or set_video_shots to write them yourself.\n4. studio_overview, then update_video {style: {models}} only if the defaults don't fit.\n5. video_keyframes: cents per shot, you confirm. wait_for_video. critique_video {stage: \"keyframes\"}.\n6. make_video_media {what: \"all\"}: the clips and voice lines, you confirm the cost. wait_for_video until nothing is\n   generating. critique_video {stage: \"clips\"}.\n7. render_video (free). wait_for_video. The render link is in the result; open_in_app {what: \"video\", id} shows it.\n\nNothing is spent without the dialog. wait_for_video returns what is still missing when it cannot go on.\n";
+export declare const STUDIO_GUIDE = "# The Studio, in short\n\nThe Studio makes images, clips, voice lines and music, and cuts them into videos. A video is a storyboard: shots in\norder, each with a picture (generated, footage you have, a title card, or a presenter), a line of voice-over, text on\nscreen, a length in seconds, and direction for the critic.\n\n## Who does what\n- **You** say what the video is for and how it should feel. One paragraph is enough: who it is for, what it must show,\n  the one thing to feel.\n- **The platform** drafts the storyboard from that brief for free (create_video with draft on).\n- **Rose, the Creative Director** (ask_agent creative, with production set to the video id) tightens shots, writes\n  better lines, picks looks and models, and proposes changes you apply with apply_chat_action.\n- **The critic** (critique_video) judges takes against each shot's direction and keeps the best.\n\n## Models and money\nstudio_overview lists every model the company can run with its price per image, per second of clip, per voice line or\nper track. update_video {style: {models: {clip, keyframe, voice, music}}} picks them for one video; studio_settings\nsets the defaults. Keyframes (one still per shot) cost cents and lock the look before clips, which cost the most. Every\ntool that spends asks you first, through your tool's own dialog, with the amount.\n\n## The order that works\n1. create_video \u2192 2. get_video, read the shots \u2192 3. ask_agent creative to tighten \u2192 4. update_video models if needed \u2192\n5. video_keyframes \u2192 wait_for_video \u2192 critique_video keyframes \u2192 6. make_video_media all \u2192 wait_for_video \u2192\ncritique_video clips \u2192 7. render_video \u2192 wait_for_video \u2192 the render link, or open_in_app video.\n\n## Shapes and lengths\n16:9 for the web and decks, 9:16 for Reels, Shorts and TikTok, 1:1 and 4:5 for feeds. Teasers run 15 to 30 seconds;\na product walkthrough 60 to 90. Fewer, longer shots read better than many short ones.\n\n## Your own files\nRecordings, screen captures, photos, a voice track, music: upload_media puts them in the library. When the server runs\non your machine (npx -y @autopo/mcp, what Claude Code, Codex and Cursor launch), each file is a path, or a folder of\nthem; hosted, each is a public URL. With a video, in_order puts the files on the shots that have no picture yet, and\nshot puts one file on one shot (a clip or image as its footage, audio as its voice line); attach_media does the same\nfor something already in the library. A whole plan with its files (a zip with plan.json, or the folder) goes in with\nimport_video_plan {path}. Files never travel through the MCP connection: the server uploads them to the platform.\n\n## When something is missing\nget_video and wait_for_video list what still blocks a render: a shot without media, a voice line not made, music not\ncomposed. make_video_media takes a `what` (visuals, voice, music or all) to fill only that gap. A failed generation can\nbe retried with update_media {action: retry}.\n\n## Code films\nA video can be cut in code instead of by the joiner: convert_video_to_code compiles its storyboard into a small Remotion\nproject (src/film.json holds every word, picture and timing; TypeScript scenes under src/ draw the shots). get_video_code\nreads the project or one file, write_video_code writes files (a new version, checked at once: tsc and the lint, with file\nand line), check_video_code checks again, video_frames draws stills to look at, video_code_versions and restore_video_code\ngo back, and render_video renders the last checked version. None of it spends credits. get_video says the engine and where\nthe code stands. The loop from a terminal: autopoiesis://guide/code-film. Rose cuts in code herself on a film task\n(ask_agent creative, with production): ask her for a scene and read what she wrote with get_video_code.\n";
+export declare const CODE_FILM_GUIDE = "# Making a code film from a terminal\n\nA code film is a video whose cut is a small Remotion project instead of the ffmpeg joiner. The storyboard (shots, lines,\nmedia, direction) stays the Studio's and compiles into src/film.json; TypeScript scenes under src/ draw each shot. The\nplatform checks every write (tsc and its lint), builds the preview the web Studio plays, draws stills on request and\nrenders through Remotion. Nothing here spends credits; renders and frames are free.\n\n## The loop, tool by tool\n1. A video with its material: create_video, then ask_agent {agent: \"creative\", production: <video id>, message: ...} so\n   Rose tightens the shots; make_video_media and critique_video as for any video (the teaser guide).\n2. convert_video_to_code {video}: the storyboard compiles to version 1 (src/Film.tsx, src/Root.tsx, src/scenes.ts,\n   src/film.json). The result lists the files, the scenes with their frames and the first check. A company whose Studio\n   default engine is remotion gets this at create_video already; get_video's engine and code say where a video stands.\n3. get_video_code {video} reads the project; get_video_code {video, file: \"src/Film.tsx\"} one file. Read film.json first:\n   it is the contract between the storyboard and your scenes, and the compiler owns it.\n4. write_video_code {video, files: [{path: \"src/scenes/Hook.tsx\", content: ...}], note}: a new version, checked at once.\n   Read check.ok and check.errors (file, line, message) before anything else; warnings are craft notes (a card over 7\n   words, no hook by 2 s, text outside the 9:16 safe box). Point a shot at your scene by naming it in src/scenes.ts.\n5. check_video_code {video} runs the check again without a write (after the storyboard changed, say).\n6. video_frames {video, frames: [0, 45, 90]} or {every_seconds: 2}: up to 12 stills as Studio images, with links to look\n   at. Fix, write, check, look again.\n7. render_video {video} renders the last checked version; wait_for_video returns the link. A refusal names the film's own\n   problem (\"the code film's check failed: ...\") and the tool to fix it.\n8. video_code_versions and restore_video_code {video, version} go back to any earlier version (a new version, checked).\n\n## The three rules that never bend\n- Words live in film.json, not in code: a line, a card's text or a title comes from the storyboard (set_video_shots), so\n  the Studio, the captions and the QC agree with the picture.\n- Product UI is footage: record the real screen (upload_media) and show it in a FootageScene; never draw a fake UI.\n- Only the kit's imports: @autopo/film, react, remotion, @remotion/*, zod and the film's own files. No fetch, timers,\n  Math.random, CSS animations or the clock: the lint refuses them and the render would drift.\n\n## Where the depth is\nThe compiler's own files are the best example: read src/Film.tsx and src/film.json with get_video_code. The Film Kit's API\n(@autopo/film: scenes, cards, hooks, media helpers, the numbers a scene is held to) and the film.json contract are the\nCreative Director's guide, served by the hosted server as read_studio_guide {file: \"film-code/references/kit.md\"} and the\nresources autopoiesis://film-kit/kit.md and autopoiesis://film-kit/contract.md; here, api_request GET\n/api/skills/autopoiesis-film-code returns the guide's method and its file list, and autopoiesis://film-kit/SKILL.md serves it.\n";
+export declare const TEASER_GUIDE = "# Making a teaser from a terminal\n\nThe loop, tool by tool (the make_a_teaser prompt runs it for you):\n\n1. brand_brain: the voice, the audience, the enemy.\n2. create_video {title, brief, aspect_ratio, seconds: 20}: a storyboard is drafted for free.\n3. get_video: read the shots. ask_agent {agent: \"creative\", production: <video id>, message: ...}: Rose tightens them;\n   apply_chat_action on her proposals, or set_video_shots to write them yourself.\n4. studio_overview, then update_video {style: {models}} only if the defaults don't fit.\n5. video_keyframes: cents per shot, you confirm. wait_for_video. critique_video {stage: \"keyframes\"}.\n6. make_video_media {what: \"all\"}: the clips and voice lines, you confirm the cost. wait_for_video until nothing is\n   generating. critique_video {stage: \"clips\"}.\n7. render_video (free). wait_for_video. The render link is in the result; open_in_app {what: \"video\", id} shows it.\n\nFootage you already have (recordings, screen captures): upload_media {video, files: [{path: \"footage/\"}], in_order: true}\nputs the files on the shots in order, so nothing is generated for them; a whole plan with its files comes in with\nimport_video_plan {path: \"teaser.zip\"}. Paths work when the server runs on your machine; hosted, give URLs.\n\nNothing is spent without the dialog. wait_for_video returns what is still missing when it cannot go on.\n";

package/dist/guides.js

@@ -28,10 +28,66 @@ critique_video clips → 7. render_video → wait_for_video → the render link,
 16:9 for the web and decks, 9:16 for Reels, Shorts and TikTok, 1:1 and 4:5 for feeds. Teasers run 15 to 30 seconds;
 a product walkthrough 60 to 90. Fewer, longer shots read better than many short ones.
 
+## Your own files
+Recordings, screen captures, photos, a voice track, music: upload_media puts them in the library. When the server runs
+on your machine (npx -y @autopo/mcp, what Claude Code, Codex and Cursor launch), each file is a path, or a folder of
+them; hosted, each is a public URL. With a video, in_order puts the files on the shots that have no picture yet, and
+shot puts one file on one shot (a clip or image as its footage, audio as its voice line); attach_media does the same
+for something already in the library. A whole plan with its files (a zip with plan.json, or the folder) goes in with
+import_video_plan {path}. Files never travel through the MCP connection: the server uploads them to the platform.
+
 ## When something is missing
 get_video and wait_for_video list what still blocks a render: a shot without media, a voice line not made, music not
 composed. make_video_media takes a \`what\` (visuals, voice, music or all) to fill only that gap. A failed generation can
 be retried with update_media {action: retry}.
+
+## Code films
+A video can be cut in code instead of by the joiner: convert_video_to_code compiles its storyboard into a small Remotion
+project (src/film.json holds every word, picture and timing; TypeScript scenes under src/ draw the shots). get_video_code
+reads the project or one file, write_video_code writes files (a new version, checked at once: tsc and the lint, with file
+and line), check_video_code checks again, video_frames draws stills to look at, video_code_versions and restore_video_code
+go back, and render_video renders the last checked version. None of it spends credits. get_video says the engine and where
+the code stands. The loop from a terminal: autopoiesis://guide/code-film. Rose cuts in code herself on a film task
+(ask_agent creative, with production): ask her for a scene and read what she wrote with get_video_code.
+`;
+export const CODE_FILM_GUIDE = `# Making a code film from a terminal
+
+A code film is a video whose cut is a small Remotion project instead of the ffmpeg joiner. The storyboard (shots, lines,
+media, direction) stays the Studio's and compiles into src/film.json; TypeScript scenes under src/ draw each shot. The
+platform checks every write (tsc and its lint), builds the preview the web Studio plays, draws stills on request and
+renders through Remotion. Nothing here spends credits; renders and frames are free.
+
+## The loop, tool by tool
+1. A video with its material: create_video, then ask_agent {agent: "creative", production: <video id>, message: ...} so
+   Rose tightens the shots; make_video_media and critique_video as for any video (the teaser guide).
+2. convert_video_to_code {video}: the storyboard compiles to version 1 (src/Film.tsx, src/Root.tsx, src/scenes.ts,
+   src/film.json). The result lists the files, the scenes with their frames and the first check. A company whose Studio
+   default engine is remotion gets this at create_video already; get_video's engine and code say where a video stands.
+3. get_video_code {video} reads the project; get_video_code {video, file: "src/Film.tsx"} one file. Read film.json first:
+   it is the contract between the storyboard and your scenes, and the compiler owns it.
+4. write_video_code {video, files: [{path: "src/scenes/Hook.tsx", content: ...}], note}: a new version, checked at once.
+   Read check.ok and check.errors (file, line, message) before anything else; warnings are craft notes (a card over 7
+   words, no hook by 2 s, text outside the 9:16 safe box). Point a shot at your scene by naming it in src/scenes.ts.
+5. check_video_code {video} runs the check again without a write (after the storyboard changed, say).
+6. video_frames {video, frames: [0, 45, 90]} or {every_seconds: 2}: up to 12 stills as Studio images, with links to look
+   at. Fix, write, check, look again.
+7. render_video {video} renders the last checked version; wait_for_video returns the link. A refusal names the film's own
+   problem ("the code film's check failed: ...") and the tool to fix it.
+8. video_code_versions and restore_video_code {video, version} go back to any earlier version (a new version, checked).
+
+## The three rules that never bend
+- Words live in film.json, not in code: a line, a card's text or a title comes from the storyboard (set_video_shots), so
+  the Studio, the captions and the QC agree with the picture.
+- Product UI is footage: record the real screen (upload_media) and show it in a FootageScene; never draw a fake UI.
+- Only the kit's imports: @autopo/film, react, remotion, @remotion/*, zod and the film's own files. No fetch, timers,
+  Math.random, CSS animations or the clock: the lint refuses them and the render would drift.
+
+## Where the depth is
+The compiler's own files are the best example: read src/Film.tsx and src/film.json with get_video_code. The Film Kit's API
+(@autopo/film: scenes, cards, hooks, media helpers, the numbers a scene is held to) and the film.json contract are the
+Creative Director's guide, served by the hosted server as read_studio_guide {file: "film-code/references/kit.md"} and the
+resources autopoiesis://film-kit/kit.md and autopoiesis://film-kit/contract.md; here, api_request GET
+/api/skills/autopoiesis-film-code returns the guide's method and its file list, and autopoiesis://film-kit/SKILL.md serves it.
 `;
 export const TEASER_GUIDE = `# Making a teaser from a terminal
 
@@ -47,6 +103,10 @@ The loop, tool by tool (the make_a_teaser prompt runs it for you):
    generating. critique_video {stage: "clips"}.
 7. render_video (free). wait_for_video. The render link is in the result; open_in_app {what: "video", id} shows it.
 
+Footage you already have (recordings, screen captures): upload_media {video, files: [{path: "footage/"}], in_order: true}
+puts the files on the shots in order, so nothing is generated for them; a whole plan with its files comes in with
+import_video_plan {path: "teaser.zip"}. Paths work when the server runs on your machine; hosted, give URLs.
+
 Nothing is spent without the dialog. wait_for_video returns what is still missing when it cannot go on.
 `;
 //# sourceMappingURL=guides.js.map

package/dist/guides.js.map

@@ -1 +1 @@
-{"version":3,"file":"guides.js","sourceRoot":"","sources":["../src/guides.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAE9G,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC3B,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;CAe3B,CAAA"}
+{"version":3,"file":"guides.js","sourceRoot":"","sources":["../src/guides.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAE9G,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkD3B,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsC9B,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;CAmB3B,CAAA"}

package/dist/http.d.ts

@@ -12,6 +12,8 @@ export interface HttpOptions {
     appUrl: string;
     publicUrl?: string;
     mediaDomains: string[];
+    /** Let tools read paths on this host (only for a server you run for yourself; off for a shared one). */
+    local?: boolean;
     /** Hostnames this server answers for; empty: any (a public service behind its own DNS). */
     allowedHosts?: string[];
     /** Seconds a 2025-era session may idle before it is closed. */

package/dist/http.js

@@ -35,7 +35,7 @@ async function readBody(req) {
 }
 export function serveHttp(options) {
     const idleMs = (options.sessionIdleSeconds ?? 1800) * 1000;
-    const make = (token) => createServer({ token, apiUrl: options.apiUrl, appUrl: options.appUrl, mediaDomains: options.mediaDomains, ...(options.publicUrl ? { publicUrl: options.publicUrl } : {}) });
+    const make = (token) => createServer({ token, apiUrl: options.apiUrl, appUrl: options.appUrl, mediaDomains: options.mediaDomains, local: options.local ?? false, ...(options.publicUrl ? { publicUrl: options.publicUrl } : {}) });
     // modern leg: stateless, a fresh server per request from the caller's token
     const modern = createMcpHandler((ctx) => make(ctx.authInfo?.token ?? ''), { legacy: 'reject', onerror: (e) => console.error('[mcp]', e.message) });
     const modernNode = toNodeHandler(modern, { onerror: (e) => console.error('[mcp]', e.message) });

package/dist/http.js.map

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

package/dist/kit.d.ts

@@ -34,6 +34,8 @@ export interface SessionOptions {
     mediaDomains?: string[];
     /** The public address of this server when it is hosted (for the Claude sandbox domain). */
     publicUrl?: string;
+    /** True when the server runs on the person's own machine (stdio): tools may then read files by path. */
+    local?: boolean;
 }
 /** One person's connection: their API plus a short-lived cache of what tools keep asking for. */
 export declare class Session {
@@ -41,6 +43,7 @@ export declare class Session {
     readonly appUrl: string;
     readonly mediaDomains: string[];
     readonly publicUrl: string | undefined;
+    readonly local: boolean;
     private companiesCache;
     private studioCache;
     private schemaCache;

package/dist/kit.js

@@ -9,6 +9,7 @@ export class Session {
     appUrl;
     mediaDomains;
     publicUrl;
+    local;
     companiesCache = null;
     studioCache = new Map();
     schemaCache = null;
@@ -17,6 +18,7 @@ export class Session {
         this.appUrl = options.appUrl.replace(/\/+$/, '');
         this.mediaDomains = options.mediaDomains ?? [];
         this.publicUrl = options.publicUrl;
+        this.local = options.local ?? false;
     }
     async companies() {
         if (this.companiesCache && Date.now() - this.companiesCache.at < 60_000)