Project Files

docs

CHANGELOG.md

src

core

tools.ts

fpzip

decompress.ts

fpzip_bridge.cpp

fpzip_loader.ts

fpzip_wasm.js

fpzip_wasm.wasm

package.json

helpers

GRPCBin2PNG.ts

imageModelMeta.ts

PNG2GRPCBin.ts

pngMetadata.ts

videoAssembler.ts

interfaces

tls

root_ca.crt

server_crt.crt

server.pem

config.fbs

imageService.proto

mcp

chatContextBridge.test.ts

chatContextBridge.ts

config.test.ts

config.ts

core-bundle.d.mts

core-bundle.mjs

index.ts

mcp.test.ts

mcpLogger.ts

package.json

resultMaterializer.test.ts

resultMaterializer.ts

scratchpadResolution.test.ts

scratchpadResolution.ts

sourceNotation.test.ts

sourceNotation.ts

toolResults.test.ts

toolResults.ts

services

customConfigsLoader.ts

drawThingsConfigMapper.ts

drawThingsGrpcService.ts

drawThingsService.ts

imageBackend.ts

modelOverlays.ts

toolResultHarvester.ts

tools

crop.ts

inpaint.ts

mask.ts

outpaint.ts

refine.ts

zoom-in.ts

types

external-shims.d.ts

grpc-shims.d.ts

config.ts

core-bundle.mjs

index.ts

toolsProvider.ts

.gitignore

.lmsignore

.npmignore

.swcrc

build.mjs

LICENSE

manifest.json

mcp-shims.d.ts

package-lock.json

package.json

README_MCP.md

README.md

rollup.config.mjs

start-mcp.mjs

tsconfig.json

tsconfig.mcp.json

dist-mcp / mcp / sourceNotation.test.js

import assert from "node:assert/strict";
import test from "node:test";
import { assertNoAttachmentNotation, collectAttachmentTokens, UnsupportedAttachmentNotationError } from "./sourceNotation.js";
const bionicPreset = { name: "bionic", includeBase64Preview: false, writeHtmlReportForMultipleResults: true, scratchpadFolderRequired: true };
const unslothPreset = { name: "unsloth", includeBase64Preview: true, writeHtmlReportForMultipleResults: false, scratchpadFolderRequired: true };
test("rejects aN in canvas (string form)", () => {
    assert.throws(() => assertNoAttachmentNotation({ canvas: "a1" }, bionicPreset), UnsupportedAttachmentNotationError);
});
test("rejects aN case-insensitively and the bare shorthand form", () => {
    assert.throws(() => assertNoAttachmentNotation({ canvas: "A5" }, bionicPreset), UnsupportedAttachmentNotationError);
    assert.throws(() => assertNoAttachmentNotation({ canvas: "a" }, bionicPreset), UnsupportedAttachmentNotationError);
});
test("rejects aN inside a canvas array", () => {
    assert.throws(() => assertNoAttachmentNotation({ canvas: ["a2"] }, bionicPreset), UnsupportedAttachmentNotationError);
});
test("rejects aN inside a moodboard array", () => {
    assert.throws(() => assertNoAttachmentNotation({ moodboard: ["v1", "a3"] }, bionicPreset), UnsupportedAttachmentNotationError);
});
test("rejects aN inside a comma/space-separated moodboard string", () => {
    assert.throws(() => assertNoAttachmentNotation({ moodboard: "v1, a3" }, bionicPreset), UnsupportedAttachmentNotationError);
    assert.throws(() => assertNoAttachmentNotation({ moodboard: "v1 a3" }, bionicPreset), UnsupportedAttachmentNotationError);
});
test("passes vN/pN/iN, filenames, and absolute paths through unchanged", () => {
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "v1" }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "p2" }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "i3" }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "source.png" }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "/abs/path/source.png" }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ moodboard: ["v1", "p2", "i3"] }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ moodboard: "v1, p2 i3" }, bionicPreset));
});
test("tolerates missing canvas/moodboard (crop/mask/zoom-in schemas have no moodboard field at all)", () => {
    assert.doesNotThrow(() => assertNoAttachmentNotation({}, bionicPreset));
});
test("no-ops entirely for the unsloth preset", () => {
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "a1" }, unslothPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ moodboard: ["a2", "aN"] }, unslothPreset));
});
test("collectAttachmentTokens gathers deduplicated aN-shaped tokens from canvas and moodboard", () => {
    assert.deepEqual(collectAttachmentTokens({ canvas: "a1", moodboard: ["a2", "a1"] }), ["a1", "a2"]);
    assert.deepEqual(collectAttachmentTokens({ moodboard: "a3, a4 a3" }), ["a3", "a4"]);
    assert.deepEqual(collectAttachmentTokens({ canvas: "v1" }), []);
});

import assert from "node:assert/strict";
import test from "node:test";
import { assertNoAttachmentNotation, collectAttachmentTokens, UnsupportedAttachmentNotationError } from "./sourceNotation.js";
const bionicPreset = { name: "bionic", includeBase64Preview: false, writeHtmlReportForMultipleResults: true, scratchpadFolderRequired: true };
const unslothPreset = { name: "unsloth", includeBase64Preview: true, writeHtmlReportForMultipleResults: false, scratchpadFolderRequired: true };
test("rejects aN in canvas (string form)", () => {
    assert.throws(() => assertNoAttachmentNotation({ canvas: "a1" }, bionicPreset), UnsupportedAttachmentNotationError);
});
test("rejects aN case-insensitively and the bare shorthand form", () => {
    assert.throws(() => assertNoAttachmentNotation({ canvas: "A5" }, bionicPreset), UnsupportedAttachmentNotationError);
    assert.throws(() => assertNoAttachmentNotation({ canvas: "a" }, bionicPreset), UnsupportedAttachmentNotationError);
});
test("rejects aN inside a canvas array", () => {
    assert.throws(() => assertNoAttachmentNotation({ canvas: ["a2"] }, bionicPreset), UnsupportedAttachmentNotationError);
});
test("rejects aN inside a moodboard array", () => {
    assert.throws(() => assertNoAttachmentNotation({ moodboard: ["v1", "a3"] }, bionicPreset), UnsupportedAttachmentNotationError);
});
test("rejects aN inside a comma/space-separated moodboard string", () => {
    assert.throws(() => assertNoAttachmentNotation({ moodboard: "v1, a3" }, bionicPreset), UnsupportedAttachmentNotationError);
    assert.throws(() => assertNoAttachmentNotation({ moodboard: "v1 a3" }, bionicPreset), UnsupportedAttachmentNotationError);
});
test("passes vN/pN/iN, filenames, and absolute paths through unchanged", () => {
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "v1" }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "p2" }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "i3" }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "source.png" }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "/abs/path/source.png" }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ moodboard: ["v1", "p2", "i3"] }, bionicPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ moodboard: "v1, p2 i3" }, bionicPreset));
});
test("tolerates missing canvas/moodboard (crop/mask/zoom-in schemas have no moodboard field at all)", () => {
    assert.doesNotThrow(() => assertNoAttachmentNotation({}, bionicPreset));
});
test("no-ops entirely for the unsloth preset", () => {
    assert.doesNotThrow(() => assertNoAttachmentNotation({ canvas: "a1" }, unslothPreset));
    assert.doesNotThrow(() => assertNoAttachmentNotation({ moodboard: ["a2", "aN"] }, unslothPreset));
});
test("collectAttachmentTokens gathers deduplicated aN-shaped tokens from canvas and moodboard", () => {
    assert.deepEqual(collectAttachmentTokens({ canvas: "a1", moodboard: ["a2", "a1"] }), ["a1", "a2"]);
    assert.deepEqual(collectAttachmentTokens({ moodboard: "a3, a4 a3" }), ["a3", "a4"]);
    assert.deepEqual(collectAttachmentTokens({ canvas: "v1" }), []);
});

process-image

process-image

process-image

process-image