rtistree 0.5.0

package/dist/index.js

@@ -0,0 +1,28 @@
+export * from './schema.js';
+export * from './loader.js';
+export * from './layout.js';
+export * from './commands.js';
+export * from './project.js';
+export * from './render.js';
+export * from './verify.js';
+export * from './workflow.js';
+export * from './artifacts.js';
+export { sceneHash, sha256, canonical } from './assets.js';
+export * from './benchmark.js';
+export * from './critique.js';
+export * from './components.js';
+export * from './spatial.js';
+export * from './merge.js';
+export * from './document.js';
+export * from './project-config.js';
+export * from './export.js';
+export * from './svg.js';
+export * from './raster-studio.js';
+export * from './program.js';
+export * from './raster-edit.js';
+export * from './pipeline.js';
+export * from './production-workflow.js';
+export * from './techniques.js';
+export * from './construction.js';
+export * from './art-direction.js';
+//# 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,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAE3B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/layout.d.ts

@@ -0,0 +1,18 @@
+import type { Bounds, Layer, Scene } from './schema.js';
+export type Matrix = [number, number, number, number, number, number];
+export interface ResolvedLayer {
+    layer: Layer;
+    visible: boolean;
+    bounds: Bounds;
+    worldBounds: Bounds;
+    matrix: Matrix;
+    children: ResolvedLayer[];
+}
+export declare const identity: Matrix;
+export declare function multiply(a: Matrix, b: Matrix): Matrix;
+export declare function transformedBounds(m: Matrix, w: number, h: number): Bounds;
+export declare function intersects(a: Bounds, b: Bounds): boolean;
+export declare function resolveLayout(scene: Scene): ResolvedLayer[];
+export declare function flattenResolved(nodes: ResolvedLayer[]): ResolvedLayer[];
+/** Flatten only isolation-free groups for vector export; preserve groups with compositing context. */
+export declare function exportLayers(nodes: ResolvedLayer[]): ResolvedLayer[];

package/dist/layout.js

@@ -0,0 +1,155 @@
+export const identity = [1, 0, 0, 1, 0, 0];
+export function multiply(a, b) {
+    return [
+        a[0] * b[0] + a[2] * b[1],
+        a[1] * b[0] + a[3] * b[1],
+        a[0] * b[2] + a[2] * b[3],
+        a[1] * b[2] + a[3] * b[3],
+        a[0] * b[4] + a[2] * b[5] + a[4],
+        a[1] * b[4] + a[3] * b[5] + a[5],
+    ];
+}
+export function transformedBounds(m, w, h) {
+    const points = [
+        [0, 0],
+        [w, 0],
+        [w, h],
+        [0, h],
+    ].map(([x, y]) => [m[0] * x + m[2] * y + m[4], m[1] * x + m[3] * y + m[5]]);
+    const xs = points.map((p) => p[0]), ys = points.map((p) => p[1]);
+    const x = Math.min(...xs), y = Math.min(...ys);
+    return [x, y, Math.max(...xs) - x, Math.max(...ys) - y];
+}
+export function intersects(a, b) {
+    return a[0] < b[0] + b[2] && a[0] + a[2] > b[0] && a[1] < b[1] + b[3] && a[1] + a[3] > b[1];
+}
+export function resolveLayout(scene) {
+    const dimension = (value, total, fallback) => typeof value === 'string' ? (parseFloat(value) / 100) * total : (value ?? fallback);
+    function resolve(layers, pw, ph, matrix, layout, parentVisible = true) {
+        const padding = layout?.padding ?? 0, gap = layout?.gap ?? 0;
+        const w = pw - padding * 2, h = ph - padding * 2;
+        if (w <= 0 || h <= 0)
+            throw new Error('Layout padding consumes the parent bounds');
+        const horizontal = layout?.type === 'horizontal', vertical = layout?.type === 'vertical';
+        const count = layers.length;
+        let cursor = padding;
+        // Percentages on the flow axis share space remaining after gaps.
+        const aw = w - (horizontal ? gap * Math.max(0, count - 1) : 0), ah = h - (vertical ? gap * Math.max(0, count - 1) : 0);
+        const axis = horizontal ? 'width' : 'height', baseSize = horizontal ? aw : ah;
+        const growing = layers.filter((l) => (l.grow ?? 0) > 0), totalGrow = growing.reduce((sum, l) => sum + l.grow, 0);
+        const fixed = layers
+            .filter((l) => !growing.includes(l))
+            .reduce((sum, l) => sum +
+            dimension(l[axis], baseSize, l.bounds?.[horizontal ? 2 : 3] ?? baseSize / Math.max(1, count)), 0);
+        const free = Math.max(0, baseSize - fixed);
+        const sizes = layers.map((layer) => {
+            const width = horizontal && layer.grow
+                ? (free * layer.grow) / totalGrow
+                : dimension(layer.width, aw, layer.bounds?.[2] ?? (horizontal ? aw / Math.max(1, count) : w));
+            let height = vertical && layer.grow
+                ? (free * layer.grow) / totalGrow
+                : dimension(layer.height, ah, layer.bounds?.[3] ?? (vertical ? ah / Math.max(1, count) : h));
+            if (layer.aspect_ratio && layer.height === undefined)
+                height = width / layer.aspect_ratio;
+            return [width, height];
+        });
+        const remaining = (horizontal ? w : h) -
+            sizes.reduce((sum, s) => sum + s[horizontal ? 0 : 1], 0) -
+            gap * Math.max(0, count - 1);
+        let effectiveGap = gap;
+        if (horizontal || vertical) {
+            if (layout?.justify === 'center')
+                cursor += remaining / 2;
+            if (layout?.justify === 'end')
+                cursor += remaining;
+            if (layout?.justify === 'space-between' && count > 1)
+                effectiveGap += remaining / (count - 1);
+        }
+        return layers.map((layer, layerIndex) => {
+            const [width, height] = sizes[layerIndex];
+            if (width <= 0 || height <= 0 || width > 8192 || height > 8192)
+                throw new Error(`Invalid resolved size: ${layer.id}`);
+            let x = layer.bounds?.[0] ?? padding, y = layer.bounds?.[1] ?? padding;
+            if (horizontal || vertical) {
+                const crossSpace = horizontal ? h - height : w - width;
+                const cross = padding +
+                    (layout?.align === 'center' ? crossSpace / 2 : layout?.align === 'end' ? crossSpace : 0);
+                if (horizontal) {
+                    x = cursor;
+                    y = cross;
+                    cursor += width + effectiveGap;
+                }
+                else {
+                    y = cursor;
+                    x = cross;
+                    cursor += height + effectiveGap;
+                }
+            }
+            else if (layer.anchor !== 'top-left') {
+                if (layer.anchor === 'center') {
+                    x += (w - width) / 2;
+                    y += (h - height) / 2;
+                }
+                if (layer.anchor.endsWith('right'))
+                    x += w - width;
+                if (layer.anchor.startsWith('bottom'))
+                    y += h - height;
+            }
+            const rad = ((layer.transform?.rotation ?? 0) * Math.PI) / 180, [sx, sy] = layer.transform?.scale ?? [1, 1];
+            const rotation = [
+                Math.cos(rad) * sx,
+                Math.sin(rad) * sx,
+                -Math.sin(rad) * sy,
+                Math.cos(rad) * sy,
+                0,
+                0,
+            ];
+            const local = layer.affine ??
+                multiply(multiply([1, 0, 0, 1, x + width / 2, y + height / 2], rotation), [
+                    1,
+                    0,
+                    0,
+                    1,
+                    -width / 2,
+                    -height / 2,
+                ]);
+            const world = multiply(matrix, local);
+            return {
+                layer,
+                visible: parentVisible && layer.visible && layer.opacity > 0,
+                bounds: [x, y, width, height],
+                worldBounds: transformedBounds(world, width, height),
+                matrix: world,
+                children: resolve(layer.children, width, height, world, layer.layout, parentVisible && layer.visible && layer.opacity > 0),
+            };
+        });
+    }
+    return resolve(scene.layers, scene.canvas.width, scene.canvas.height, identity);
+}
+export function flattenResolved(nodes) {
+    return nodes.flatMap((node) => [node, ...flattenResolved(node.children)]);
+}
+/** Flatten only isolation-free groups for vector export; preserve groups with compositing context. */
+export function exportLayers(nodes) {
+    const contextFree = (n) => n.layer.blend_mode === 'normal' &&
+        n.layer.type !== 'adjustment' &&
+        n.children.every(contextFree);
+    return [...nodes]
+        .sort((a, b) => a.layer.z - b.layer.z)
+        .flatMap((n) => {
+        const l = n.layer;
+        if (!n.visible)
+            return [];
+        return l.type === 'group' &&
+            l.opacity === 1 &&
+            !l.mask &&
+            !l.effects.length &&
+            !l.operations.length &&
+            !l.tiles.length &&
+            !l.regions?.length &&
+            contextFree(n)
+            ? exportLayers(n.children)
+            : [n];
+    });
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

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

package/dist/loader.d.ts

@@ -0,0 +1,9 @@
+import { type Scene } from './schema.js';
+export interface SceneSource {
+    scene: Scene;
+    root: string;
+    file: string;
+    files: string[];
+}
+/** Includes are fragments with {include?, assets?, layers?}; IDs share one namespace. */
+export declare function loadScene(file: string): Promise<SceneSource>;

package/dist/loader.js

@@ -0,0 +1,108 @@
+import { componentsSchema, expandComponents } from './components.js';
+import { readFile, realpath } from 'node:fs/promises';
+import { dirname, relative, resolve } from 'node:path';
+import { parse } from 'yaml';
+import { localAssetPath } from './assets.js';
+import { parseScene } from './schema.js';
+/** Includes are fragments with {include?, assets?, layers?}; IDs share one namespace. */
+export async function loadScene(file) {
+    const absolute = await realpath(resolve(file)), root = dirname(absolute), files = [], active = new Set();
+    const components = Object.create(null);
+    const fonts = Object.create(null);
+    const assets = Object.create(null);
+    async function read(path, isRoot = false) {
+        const safe = await localAssetPath(root, relative(root, path));
+        if (active.has(safe))
+            throw new Error(`Cyclic scene include: ${relative(root, safe)}`);
+        if (files.length >= 128)
+            throw new Error('Scene has too many includes (maximum 128)');
+        active.add(safe);
+        files.push(safe);
+        const raw = await readFile(safe, 'utf8');
+        if (raw.length > 8 * 1024 * 1024)
+            throw new Error('Scene file exceeds 8 MiB');
+        const doc = parse(raw, { maxAliasCount: 100 });
+        if (!doc || typeof doc !== 'object' || Array.isArray(doc))
+            throw new Error(`Expected an object in ${safe}`);
+        if (!isRoot)
+            for (const key of Object.keys(doc))
+                if (!['include', 'assets', 'layers', 'components', 'fonts'].includes(key))
+                    throw new Error(`Unknown fragment field: ${key}`);
+        const layers = [];
+        if (doc.include !== undefined) {
+            if (!Array.isArray(doc.include) || doc.include.some((p) => typeof p !== 'string'))
+                throw new Error('include must be a list of relative file paths');
+            for (const part of doc.include) {
+                if (part.startsWith('/') || /^[a-z]+:/i.test(part))
+                    throw new Error('Includes must be relative local paths');
+                const fragment = await read(resolve(dirname(safe), part));
+                layers.push(...fragment.layers);
+            }
+        }
+        if (doc.assets !== undefined) {
+            if (!doc.assets || typeof doc.assets !== 'object' || Array.isArray(doc.assets))
+                throw new Error('assets must be a mapping');
+            for (const [id, asset] of Object.entries(doc.assets)) {
+                if (Object.hasOwn(assets, id))
+                    throw new Error(`Duplicate asset id across files: ${id}`);
+                if (!asset || typeof asset.source !== 'string')
+                    throw new Error(`Asset ${id} requires a source`);
+                if (asset.source.startsWith('/') || /^[a-z]+:/i.test(asset.source))
+                    throw new Error('Assets must be relative local paths');
+                assets[id] = {
+                    ...asset,
+                    source: relative(root, resolve(dirname(safe), asset.source)),
+                    ...(asset.recipe
+                        ? {
+                            recipe: {
+                                ...asset.recipe,
+                                source: relative(root, resolve(dirname(safe), asset.recipe.source)),
+                            },
+                        }
+                        : {}),
+                };
+            }
+        }
+        if (doc.components) {
+            for (const [id, component] of Object.entries(componentsSchema.parse(doc.components))) {
+                if (Object.hasOwn(components, id))
+                    throw new Error(`Duplicate component: ${id}`);
+                components[id] = component;
+            }
+        }
+        if (doc.fonts) {
+            if (typeof doc.fonts !== 'object' || Array.isArray(doc.fonts))
+                throw new Error('fonts must be a mapping');
+            for (const [id, font] of Object.entries(doc.fonts)) {
+                if (Object.hasOwn(fonts, id))
+                    throw new Error('Duplicate font');
+                if (typeof font?.source !== 'string' ||
+                    font.source.startsWith('/') ||
+                    /^[a-z]+:/i.test(font.source))
+                    throw new Error('Font requires a relative source');
+                fonts[id] = { ...font, source: relative(root, resolve(dirname(safe), font.source)) };
+            }
+        }
+        if (doc.layers !== undefined) {
+            if (!Array.isArray(doc.layers))
+                throw new Error('layers must be an array');
+            layers.push(...doc.layers);
+        }
+        active.delete(safe);
+        const { include: _include, components: _components, ...rest } = doc;
+        return { ...rest, layers };
+    }
+    const document = await read(absolute, true);
+    return {
+        scene: parseScene({
+            ...document,
+            assets,
+            ...(Object.keys(fonts).length ? { fonts } : {}),
+            layers: expandComponents(document.layers, components),
+        }),
+        root,
+        file: absolute,
+        files,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Project } from './project.js';
+export declare function createServer(project: Project): McpServer;
+export declare function serve(project: Project): Promise<void>;

package/dist/mcp.js

@@ -0,0 +1,223 @@
+import { buildPipeline, pipelineSchema } from './pipeline.js';
+import { production, productionRequestSchema } from './production-workflow.js';
+import { exportArtwork, preflight, softProof } from './export.js';
+import { exportPresetSchema } from './document.js';
+import { critiqueSchema } from './critique.js';
+import { programSchema, runProgram, replayRecipe } from './program.js';
+import { studioReference } from './studio-reference.js';
+import { artDirectionGuide, artDirectionResourceUri, rtistreeAgentInstructions, } from './art-direction.js';
+import { rasterReadSchema, rasterWriteSchema, readRasterRegion, writeRasterRegion, } from './raster-edit.js';
+import { ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { join } from 'node:path';
+import { patchSchema } from './commands.js';
+import { boundsSchema } from './schema.js';
+import { writeRender } from './artifacts.js';
+const json = (value) => ({
+    content: [{ type: 'text', text: JSON.stringify(value) }],
+});
+const image = (render) => ({
+    type: 'image',
+    data: render.png.toString('base64'),
+    mimeType: 'image/png',
+});
+export function createServer(project) {
+    const server = new McpServer({ name: 'rtistree', version: '0.5.0' }, { instructions: rtistreeAgentInstructions });
+    server.registerResource('art-direction', artDirectionResourceUri, {
+        title: 'Rtistree art direction and trial lessons',
+        description: 'Read before creating artwork: representative samples, subject-specific construction and motion checks, separate acceptance axes, calibration failures and a production plan template.',
+        mimeType: 'application/json',
+    }, async (uri) => ({
+        contents: [
+            { uri: uri.href, mimeType: 'application/json', text: JSON.stringify(artDirectionGuide) },
+        ],
+    }));
+    const definitions = [];
+    // Share recursive definitions in discovery while retaining SDK runtime validation.
+    function registerTool(name, config, callback) {
+        definitions.push({
+            name,
+            description: config.description,
+            annotations: config.annotations,
+            inputSchema: z.toJSONSchema(z.object(config.inputSchema), {
+                reused: 'ref',
+                target: 'draft-7',
+                io: 'input',
+            }),
+        });
+        return server.registerTool(name, config, callback);
+    }
+    const readOnly = { readOnlyHint: true, destructiveHint: false, openWorldHint: false };
+    const mutate = { readOnlyHint: false, destructiveHint: false, openWorldHint: false };
+    registerTool('buildPipeline', {
+        description: 'Before creating artwork, read studioHelp for construction and review guidance. Explicitly execute trusted local 2D painting code in a dependency graph. Reuse unchanged nodes and atomically commit all changed outputs. Graph code and parameters are retained in scene metadata. Build success is not a visual-quality pass. Native code is not sandboxed.',
+        inputSchema: { pipeline: pipelineSchema, expected_hash: z.string().optional() },
+        annotations: { ...mutate, openWorldHint: true },
+    }, async ({ pipeline, expected_hash }) => json(await buildPipeline(project, pipeline, expected_hash)));
+    registerTool('production', {
+        description: 'Plan stages, capture image candidates and detail crops, record human/vision reviews, compare, restore the best candidate with undo, and advance gated stages. Reviews require actual visual observation; technical checks do not rate art. Read studioHelp first.',
+        inputSchema: { request: productionRequestSchema },
+        annotations: mutate,
+    }, async ({ request }) => json(await production(project, request)));
+    registerTool('studioHelp', {
+        description: 'Read before creating artwork: representative samples, reference study, distinct poses, connected construction, shared perspective, functional motion checks, observed visual review, targeted revision and blocking defects. Includes trial lessons, a starter production plan, named 2D guides, the raster API and trusted-code limits.',
+        inputSchema: {},
+        annotations: readOnly,
+    }, async () => json(studioReference));
+    registerTool('runProgram', {
+        description: 'Before creating artwork, read studioHelp for construction and review guidance. Execute a trusted local JavaScript raster program with seeded studio helpers; bake and pin its output, recipe and input snapshots, optionally update a target layer. Successful execution is not a visual-quality pass. Native worker isolation is not a security sandbox; only run code you trust. Scene rendering never executes programs.',
+        inputSchema: { program: programSchema },
+        annotations: { ...mutate, openWorldHint: true },
+    }, async ({ program }) => json(await runProgram(project, program)));
+    registerTool('replayProgram', {
+        description: 'Explicitly re-execute a trusted baked asset recipe and compare output hashes. This runs local code, not a security sandbox.',
+        inputSchema: { asset: z.string() },
+        annotations: { ...mutate, openWorldHint: true },
+    }, async ({ asset }) => {
+        const reference = (await project.scene()).assets[asset]?.recipe;
+        if (!reference)
+            throw new Error('Asset has no recipe');
+        const { png, ...result } = await replayRecipe(project.root, reference);
+        return json(result);
+    });
+    registerTool('readRasterRegion', {
+        description: 'Read an exact canvas-space PNG region of the composite or isolated layer, with a scene hash for subsequent dense edits.',
+        inputSchema: { request: rasterReadSchema },
+        annotations: mutate,
+    }, async ({ request }) => {
+        const { render, ...result } = await readRasterRegion(project, request);
+        return { content: [...json(result).content, image(render)] };
+    });
+    registerTool('writeRasterRegion', {
+        description: 'Atomically replace or composite a dense local PNG patch into a layer, with exact dimensions, stale-scene protection, locality validation and undo. Layer-space patches follow later object transforms.',
+        inputSchema: { request: rasterWriteSchema },
+        annotations: mutate,
+    }, async ({ request }) => json(await writeRasterRegion(project, request)));
+    registerTool('inspectScene', {
+        description: 'Inspect semantic layers, resolved bounds, scene hash and undo state. Start here before editing.',
+        inputSchema: {},
+        annotations: readOnly,
+    }, async () => json(await project.inspect()));
+    registerTool('inspectLayer', {
+        description: 'Inspect one layer including its semantic source, masks, effects, raster operations and tiles.',
+        inputSchema: { id: z.string() },
+        annotations: readOnly,
+    }, async ({ id }) => json(await project.inspectLayer(id)));
+    registerTool('inspectRegion', {
+        description: 'Return an exact PNG crop, intersecting layers, quantized dominant colours and mean luma. Coordinates are canvas pixels.',
+        inputSchema: { bounds: boundsSchema },
+        annotations: readOnly,
+    }, async ({ bounds }) => {
+        const { render, ...region } = await project.inspectRegion(bounds);
+        return { content: [...json(region).content, image(render)] };
+    });
+    registerTool('render', {
+        description: 'Render the current persisted scene and return a PNG image, artifact paths and deterministic evidence.',
+        inputSchema: { quality: z.enum(['draft', 'preview', 'final']).default('preview') },
+        annotations: mutate,
+    }, async ({ quality }) => {
+        const render = await project.render({ quality });
+        const artifact = await writeRender(join(project.outputDirectory, `${render.evidence.render.png_hash.slice(7)}.png`), render);
+        return { content: [...json(artifact).content, image(render)] };
+    });
+    registerTool('renderRegion', {
+        description: 'Render an exact crop with full compositing context. No approximation at crop edges.',
+        inputSchema: { bounds: boundsSchema },
+        annotations: readOnly,
+    }, async ({ bounds }) => {
+        const render = await project.render({ region: bounds });
+        return { content: [...json(render.evidence).content, image(render)] };
+    });
+    registerTool('apply', {
+        description: 'Atomically apply typed semantic or raster commands. Include the inspected expected_hash to reject stale edits and a reason for the audit log. Raster commands are rejected if any final pixel outside their bounds changes. Prefer semantic edits to pixels.',
+        inputSchema: { patch: patchSchema },
+        annotations: mutate,
+    }, async ({ patch }) => {
+        try {
+            const entry = await project.apply(patch);
+            return json({
+                sequence: entry.sequence,
+                scene_hash: entry.after_hash,
+                locality: entry.locality,
+            });
+        }
+        catch (error) {
+            return {
+                isError: true,
+                ...json({ error: error instanceof Error ? error.message : String(error) }),
+            };
+        }
+    });
+    registerTool('undo', {
+        description: 'Undo the last transaction; record the reversal in append-only history.',
+        inputSchema: {},
+        annotations: mutate,
+    }, async () => {
+        const entry = await project.undo();
+        return json({ scene_hash: entry.after_hash });
+    });
+    registerTool('redo', {
+        description: 'Redo the last undone transaction; new edits clear the redo branch.',
+        inputSchema: {},
+        annotations: mutate,
+    }, async () => {
+        const entry = await project.redo();
+        return json({ scene_hash: entry.after_hash });
+    });
+    registerTool('verify', {
+        description: 'Return measured scene-rule findings and render provenance. Does not assess aesthetic quality; inspect the image for visual critique.',
+        inputSchema: {},
+        annotations: readOnly,
+    }, async () => json(await project.verify()));
+    registerTool('history', {
+        description: 'Read the audit trail with reasons, scene hashes, commands and measured edit locality.',
+        inputSchema: {},
+        annotations: readOnly,
+    }, async () => json((await project.history()).map(({ after, ...entry }) => entry)));
+    registerTool('recordCritique', {
+        description: 'Record a human or vision-agent critique of the actual current image, with exact scene/PNG hashes. Findings can block the iterative pass condition.',
+        inputSchema: { critique: critiqueSchema },
+        annotations: mutate,
+    }, async ({ critique }) => json(await project.recordCritique(critique)));
+    registerTool('readCritique', {
+        description: 'Read the critique for the current scene/render, or null if it has not been reviewed.',
+        inputSchema: {},
+        annotations: readOnly,
+    }, async () => json(await project.critique()));
+    registerTool('rebase', {
+        description: 'Merge nonconflicting manual source changes into the working scene; conflicting paths are reported without committing.',
+        inputSchema: {},
+        annotations: mutate,
+    }, async () => {
+        const e = await project.rebase();
+        return json({ hash: e.after_hash });
+    });
+    registerTool('compactHistory', {
+        description: 'Compress the full audit trail while retaining every undo/redo state.',
+        inputSchema: {},
+        annotations: mutate,
+    }, async () => json(await project.compactHistory()));
+    registerTool('exportArtwork', {
+        description: 'Export PNG, JPEG, TIFF, or physically sized PDF into the project output directory with profile and geometry read-back validation.',
+        inputSchema: { name: z.string().regex(/^[a-zA-Z0-9_-]+$/), options: exportPresetSchema },
+        annotations: mutate,
+    }, async ({ name, options }) => json(await exportArtwork(project, join(project.outputDirectory, `${name}.${options.format}`), options)));
+    registerTool('softProof', {
+        description: 'Create an sRGB preview of a round-trip through the project CMYK ICC profile.',
+        inputSchema: { options: exportPresetSchema },
+        annotations: mutate,
+    }, async ({ options }) => json(await softProof(project, join(project.outputDirectory, 'proof.png'), options)));
+    registerTool('preflight', {
+        description: 'Inspect physical print geometry, source image resolution and ICC requirements before export.',
+        inputSchema: { options: exportPresetSchema },
+        annotations: readOnly,
+    }, async ({ options }) => json(await preflight(project, options)));
+    server.server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: definitions }));
+    return server;
+}
+export async function serve(project) {
+    await createServer(project).connect(new StdioServerTransport());
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/merge.d.ts

@@ -0,0 +1,6 @@
+export declare class SourceConflict extends Error {
+    readonly paths: string[];
+    constructor(paths: string[]);
+}
+/** Preserve disjoint source and agent edits. ID-bearing arrays are merged by identity. */
+export declare function mergeSource(base: unknown, working: unknown, incoming: unknown): unknown;