unity-open-mcp 1.5.0 → 1.6.0

package/dist/playtest/png.js

@@ -0,0 +1,248 @@
+// Playtest session report — PNG thumbnails without an image dependency.
+//
+// The bridge writes full-size frames to disk; the session report needs small
+// previews of them. Decoding happens here, in the server, so a report can be
+// written after the Editor is gone (an MCP server restart, a crashed Editor)
+// and the bridge contract does not change. Only `node:zlib` is used: PNG is
+// zlib-compressed scanlines with a per-row filter, so a reader for the
+// non-interlaced 8/16-bit formats Unity's EncodeToPNG produces is short.
+// Anything else (interlaced, < 8-bit gray) returns null and the report links
+// the full frame without a thumbnail.
+import { deflateSync, inflateSync } from "node:zlib";
+const SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+/** Refuse images whose raw RGBA would exceed this (a corrupt header, a 16K frame). */
+const MAX_PIXELS = 64 * 1024 * 1024;
+let crcTable = null;
+function crc32(bytes) {
+    if (!crcTable) {
+        crcTable = new Uint32Array(256);
+        for (let n = 0; n < 256; n++) {
+            let c = n;
+            for (let k = 0; k < 8; k++)
+                c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+            crcTable[n] = c >>> 0;
+        }
+    }
+    let crc = 0xffffffff;
+    for (let i = 0; i < bytes.length; i++)
+        crc = crcTable[(crc ^ bytes[i]) & 0xff] ^ (crc >>> 8);
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/** Read the width / height from a PNG header without decoding it. */
+export function pngSize(bytes) {
+    if (bytes.length < 24 || !Buffer.from(bytes.subarray(0, 8)).equals(SIGNATURE))
+        return null;
+    const view = Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    if (view.toString("latin1", 12, 16) !== "IHDR")
+        return null;
+    return { width: view.readUInt32BE(16), height: view.readUInt32BE(20) };
+}
+/** Decode a PNG into 8-bit RGBA, or null for a format this reader does not cover. */
+export function decodePng(bytes) {
+    const buf = Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    if (buf.length < 8 || !buf.subarray(0, 8).equals(SIGNATURE))
+        return null;
+    let offset = 8;
+    let width = 0, height = 0, depth = 0, colorType = -1, interlace = 0;
+    let palette = null;
+    let transparency = null;
+    const idat = [];
+    while (offset + 12 <= buf.length) {
+        const length = buf.readUInt32BE(offset);
+        const type = buf.toString("latin1", offset + 4, offset + 8);
+        const start = offset + 8;
+        if (start + length + 4 > buf.length)
+            return null;
+        const chunk = buf.subarray(start, start + length);
+        if (type === "IHDR") {
+            width = chunk.readUInt32BE(0);
+            height = chunk.readUInt32BE(4);
+            depth = chunk[8];
+            colorType = chunk[9];
+            interlace = chunk[12];
+        }
+        else if (type === "PLTE")
+            palette = chunk;
+        else if (type === "tRNS")
+            transparency = chunk;
+        else if (type === "IDAT")
+            idat.push(chunk);
+        else if (type === "IEND")
+            break;
+        offset = start + length + 4;
+    }
+    if (!width || !height || width * height > MAX_PIXELS || interlace !== 0)
+        return null;
+    const channels = colorType === 0 ? 1 : colorType === 2 ? 3 : colorType === 3 ? 1 : colorType === 4 ? 2 : colorType === 6 ? 4 : 0;
+    if (!channels)
+        return null;
+    if (colorType === 3 ? depth !== 8 || !palette : depth !== 8 && depth !== 16)
+        return null;
+    const bytesPerSample = depth / 8;
+    const bpp = channels * bytesPerSample;
+    const stride = width * bpp;
+    let raw;
+    try {
+        raw = inflateSync(Buffer.concat(idat));
+    }
+    catch {
+        return null;
+    }
+    if (raw.length < (stride + 1) * height)
+        return null;
+    const out = new Uint8Array(width * height * 4);
+    let prev = new Uint8Array(stride);
+    let row = new Uint8Array(stride);
+    for (let y = 0; y < height; y++) {
+        const base = y * (stride + 1);
+        const filter = raw[base];
+        for (let x = 0; x < stride; x++) {
+            const value = raw[base + 1 + x];
+            const left = x >= bpp ? row[x - bpp] : 0;
+            const up = prev[x];
+            const upLeft = x >= bpp ? prev[x - bpp] : 0;
+            let predictor;
+            switch (filter) {
+                case 0:
+                    predictor = 0;
+                    break;
+                case 1:
+                    predictor = left;
+                    break;
+                case 2:
+                    predictor = up;
+                    break;
+                case 3:
+                    predictor = (left + up) >> 1;
+                    break;
+                case 4: {
+                    const p = left + up - upLeft;
+                    const pa = Math.abs(p - left), pb = Math.abs(p - up), pc = Math.abs(p - upLeft);
+                    predictor = pa <= pb && pa <= pc ? left : pb <= pc ? up : upLeft;
+                    break;
+                }
+                default: return null;
+            }
+            row[x] = (value + predictor) & 0xff;
+        }
+        for (let x = 0; x < width; x++) {
+            const s = x * bpp, d = (y * width + x) * 4;
+            // 16-bit samples keep their high byte.
+            const sample = (i) => row[s + i * bytesPerSample];
+            switch (colorType) {
+                case 0:
+                    out[d] = out[d + 1] = out[d + 2] = sample(0);
+                    out[d + 3] = 255;
+                    break;
+                case 2:
+                    out[d] = sample(0);
+                    out[d + 1] = sample(1);
+                    out[d + 2] = sample(2);
+                    out[d + 3] = 255;
+                    break;
+                case 3: {
+                    const index = row[s];
+                    out[d] = palette[index * 3] ?? 0;
+                    out[d + 1] = palette[index * 3 + 1] ?? 0;
+                    out[d + 2] = palette[index * 3 + 2] ?? 0;
+                    out[d + 3] = transparency && index < transparency.length ? transparency[index] : 255;
+                    break;
+                }
+                case 4:
+                    out[d] = out[d + 1] = out[d + 2] = sample(0);
+                    out[d + 3] = sample(1);
+                    break;
+                default:
+                    out[d] = sample(0);
+                    out[d + 1] = sample(1);
+                    out[d + 2] = sample(2);
+                    out[d + 3] = sample(3);
+            }
+        }
+        const swap = prev;
+        prev = row;
+        row = swap;
+    }
+    return { width, height, data: out };
+}
+/** Box-filter downscale so the image fits maxWidth × maxHeight (never upscales). */
+export function downscale(image, maxWidth, maxHeight) {
+    const ratio = Math.min(1, maxWidth / image.width, maxHeight / image.height);
+    const width = Math.max(1, Math.round(image.width * ratio));
+    const height = Math.max(1, Math.round(image.height * ratio));
+    if (width === image.width && height === image.height)
+        return image;
+    const out = new Uint8Array(width * height * 4);
+    for (let ty = 0; ty < height; ty++) {
+        const y0 = Math.floor((ty * image.height) / height);
+        const y1 = Math.max(y0 + 1, Math.floor(((ty + 1) * image.height) / height));
+        for (let tx = 0; tx < width; tx++) {
+            const x0 = Math.floor((tx * image.width) / width);
+            const x1 = Math.max(x0 + 1, Math.floor(((tx + 1) * image.width) / width));
+            let r = 0, g = 0, b = 0, a = 0;
+            for (let y = y0; y < y1; y++) {
+                let i = (y * image.width + x0) * 4;
+                for (let x = x0; x < x1; x++, i += 4) {
+                    r += image.data[i];
+                    g += image.data[i + 1];
+                    b += image.data[i + 2];
+                    a += image.data[i + 3];
+                }
+            }
+            const n = (y1 - y0) * (x1 - x0);
+            const d = (ty * width + tx) * 4;
+            out[d] = Math.round(r / n);
+            out[d + 1] = Math.round(g / n);
+            out[d + 2] = Math.round(b / n);
+            out[d + 3] = Math.round(a / n);
+        }
+    }
+    return { width, height, data: out };
+}
+function chunk(type, data) {
+    const head = Buffer.alloc(8);
+    head.writeUInt32BE(data.length, 0);
+    head.write(type, 4, "latin1");
+    const crc = Buffer.alloc(4);
+    crc.writeUInt32BE(crc32(Buffer.concat([head.subarray(4), data])), 0);
+    return Buffer.concat([head, data, crc]);
+}
+/** Encode RGBA as a PNG (RGB when every pixel is opaque). */
+export function encodePng(image) {
+    let opaque = true;
+    for (let i = 3; i < image.data.length; i += 4)
+        if (image.data[i] !== 255) {
+            opaque = false;
+            break;
+        }
+    const channels = opaque ? 3 : 4;
+    const stride = image.width * channels;
+    const raw = Buffer.alloc((stride + 1) * image.height);
+    for (let y = 0; y < image.height; y++) {
+        const base = y * (stride + 1);
+        raw[base] = 1; // Sub filter: cheap and compresses UI frames well.
+        for (let x = 0; x < image.width; x++) {
+            const s = (y * image.width + x) * 4;
+            for (let c = 0; c < channels; c++) {
+                const value = image.data[s + c];
+                const left = x > 0 ? image.data[s - 4 + c] : 0;
+                raw[base + 1 + x * channels + c] = (value - left) & 0xff;
+            }
+        }
+    }
+    const header = Buffer.alloc(13);
+    header.writeUInt32BE(image.width, 0);
+    header.writeUInt32BE(image.height, 4);
+    header[8] = 8;
+    header[9] = opaque ? 2 : 6;
+    return Buffer.concat([SIGNATURE, chunk("IHDR", header), chunk("IDAT", deflateSync(raw, { level: 9 })), chunk("IEND", new Uint8Array(0))]);
+}
+/** Decode, fit into the box and re-encode; null when the source cannot be decoded. */
+export function thumbnail(bytes, maxWidth, maxHeight) {
+    const image = decodePng(bytes);
+    if (!image)
+        return null;
+    const small = downscale(image, maxWidth, maxHeight);
+    return { png: encodePng(small), width: small.width, height: small.height, source: { width: image.width, height: image.height } };
+}
+//# sourceMappingURL=png.js.map

package/dist/playtest/png.js.map

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

package/dist/playtest/recorder.d.ts

@@ -0,0 +1,203 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { BridgeEvent } from "../event-stream.js";
+import { Redactor } from "./redact.js";
+import { SessionStore, type SessionMeta, type SessionOwner } from "./session-store.js";
+export declare const PLAYTEST_SESSION_TOOL = "unity_open_mcp_playtest_session";
+export declare const RECORDING_LIMITS: {
+    /** Recorded calls per session; later calls are counted, not logged. */
+    readonly maxCalls: 500;
+    readonly maxMarks: 200;
+    /** Frames linked / copied into the report folder per session. */
+    readonly maxFrames: 300;
+    readonly maxFrameBytes: number;
+    /** Thumbnails written by `end` (downscaled; the full frames stay files). */
+    readonly maxThumbnails: 60;
+    readonly maxErrorsPerCall: 20;
+    /** Occurrences of one console message logged per session; later ones are counted, not logged. */
+    readonly maxErrorRepeats: 20;
+    /** Console errors logged per session; later ones are counted, not logged. */
+    readonly maxErrors: 2000;
+    readonly maxEditorEvents: 200;
+    readonly maxArgsChars: 2000;
+    readonly maxPendingErrors: 500;
+};
+export type CallKind = "input" | "wait" | "capture" | "command" | "control";
+/** Which recorded category a call falls in (null = not recorded). */
+export declare function classifyCall(tool: string, args: Record<string, unknown>): {
+    kind: CallKind;
+    label: string;
+    args: unknown;
+} | null;
+export declare function ownerKey(owner: SessionOwner): string;
+interface PendingError {
+    ts: number;
+    type: string;
+    message: string;
+    stack?: string;
+    source: "stream" | "response";
+}
+/** A finished call's time window and its response-only errors, each waiting for the stream's copy (with the stack). */
+interface CallWindow {
+    seq: number;
+    start: number;
+    end: number;
+    messages: Set<string>;
+}
+interface OpenSession {
+    meta: SessionMeta;
+    dir: string;
+    nextSeq: number;
+    nextStep: number;
+    calls: number;
+    droppedCalls: number;
+    marks: number;
+    frames: number;
+    frameBytes: number;
+    framesSkipped: number;
+    editorEvents: number;
+    lastEditorState: string | null;
+    streamReady: number;
+    windows: CallWindow[];
+    inflight: Map<number, number>;
+    pending: PendingError[];
+    /** Stream errors dropped because the pending backlog was full. */
+    pendingDropped: number;
+    streamGaps: number;
+    /** Logged occurrences per error message, and how many errors were logged. */
+    errorSeen: Map<string, number>;
+    errorsLogged: number;
+    /** Counted, not logged: repeats of one message past maxErrorRepeats, and errors past maxErrors / maxErrorsPerCall. */
+    errorRepeats: Map<string, {
+        type: string;
+        message: string;
+        count: number;
+    }>;
+    errorsOverLimit: number;
+    /** Stream errors already written (ts + message), so a job result's own copy is not a second error. */
+    recentErrors: Array<{
+        ts: number;
+        key: string;
+    }>;
+    jobs: Map<string, {
+        seq: number;
+        kind: CallKind;
+        tool: string;
+    }>;
+    limitNoted: Set<string>;
+    sinceMark: {
+        calls: number;
+        errors: number;
+        captures: number;
+        failed: number;
+    };
+}
+export interface CallHandle {
+    session: OpenSession;
+    seq: number;
+    tool: string;
+    kind: CallKind;
+    start: number;
+}
+/** Calls a tool through the normal route on behalf of the session owner. */
+export type ToolCaller = (tool: string, args: Record<string, unknown>) => Promise<CallToolResult>;
+export declare class PlaytestError extends Error {
+    readonly code: string;
+    readonly detail: Record<string, unknown>;
+    constructor(code: string, message: string, detail?: Record<string, unknown>);
+}
+export interface RecorderOptions {
+    root: string;
+    projectPath: string;
+    knownSecrets?: Iterable<string | undefined | null>;
+    now?: () => number;
+    pid?: number;
+    /** Process-liveness probe for adoption (tests inject). */
+    isAlive?: (pid: number) => boolean;
+    /** Whether the bridge event stream is connected (errors without it come from responses only). */
+    streamConnected?: () => boolean;
+}
+export declare class PlaytestRecorder {
+    readonly store: SessionStore;
+    readonly redactor: Redactor;
+    private readonly projectPath;
+    private readonly now;
+    private readonly pid;
+    private readonly isAlive;
+    private readonly streamConnected;
+    private readonly open;
+    /** Owners whose `start` is between its check and its session (awaiting the bridge). */
+    private readonly starting;
+    private identity;
+    constructor(options: RecorderOptions);
+    /** Cheap hot-path check: is any session open in this process? */
+    get openCount(): number;
+    isRecording(owner: SessionOwner): boolean;
+    begin(owner: SessionOwner, tool: string, args: Record<string, unknown>): CallHandle | null;
+    finish(handle: CallHandle, _args: Record<string, unknown>, result: CallToolResult | null, thrown?: unknown): void;
+    /** `jobs wait` / `jobs status` reached a terminal state for a job a recorded call started. */
+    observeJob(owner: SessionOwner, args: Record<string, unknown>, result: CallToolResult): void;
+    /** Bridge event stream listener (every event, every open session). */
+    onEvent(event: BridgeEvent): void;
+    start(owner: SessionOwner, args: Record<string, unknown>, call: ToolCaller): Promise<Record<string, unknown>>;
+    private startClaimed;
+    mark(owner: SessionOwner, args: Record<string, unknown>, sessionArg?: string): Record<string, unknown>;
+    status(owner: SessionOwner): Record<string, unknown>;
+    resume(owner: SessionOwner, sessionArg: string | undefined): Record<string, unknown>;
+    end(owner: SessionOwner, args: Record<string, unknown>, call: ToolCaller): Promise<Record<string, unknown>>;
+    list(owner: SessionOwner, limit: number): Record<string, unknown>;
+    private openSession;
+    private isOpen;
+    private append;
+    private noteLimit;
+    /** A call over maxCalls: counted (the count is logged, so an adopting process keeps it), not recorded. */
+    private dropCall;
+    /**
+     * Whether this console error is written to the log. Each message is logged
+     * maxErrorRepeats times and the session maxErrors times; the rest are counted
+     * (per message, written at end), so an error thrown every frame cannot grow
+     * the log without bound. `occurrence: false` is a second copy of an error
+     * already counted (the stream's copy of a response error): written while the
+     * message is under its cap, never counted.
+     */
+    private keepError;
+    private rememberStreamError;
+    private requireOpen;
+    /** Take over an open session whose owner is this caller or whose server process is gone. */
+    private adopt;
+    private lostInFlight;
+    private findSession;
+    /** An open on-disk session owned by exactly this owner (a stable explicit agent id after a restart). */
+    private diskSessionOf;
+    private stateOf;
+    private orphanedSessions;
+    private describe;
+    /** Resolve company / product once per process (live Player Settings, else ProjectSettings.asset). */
+    prepare(call: ToolCaller): Promise<void>;
+    private resolveIdentity;
+    private describeDevice;
+    private pushWindow;
+    /**
+     * Which recorded call an error at `ts` belongs to: the call whose window
+     * contains it; else one within 50 ms of it (clock rounding, the stream's
+     * latency); else the last call that ended before it ("after" — a tap's
+     * consequence logged frames later). A call whose response already reported
+     * this message wins over another call sharing the same millisecond.
+     */
+    private attribute;
+    /**
+     * Attribute pending stream errors that can no longer belong to an in-flight
+     * call (see attribute). An error the call's own response already reported
+     * is still logged (it carries the stack) but not counted twice.
+     */
+    private settle;
+    /**
+     * Errors logged inside the call's window: stream events first, then the
+     * response's own evidence. `total` counts every occurrence; `errors` holds
+     * the ones written (per-call, per-message and per-session caps).
+     */
+    private collectErrors;
+    /** Frames a call wrote (file paths anywhere in its output, inline images) → linked into the report folder. */
+    private collectCaptures;
+    private summarize;
+}
+export {};