unity-open-mcp 0.6.1 → 0.8.2

package/dist/process-diagnostics.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Mono's internal file-descriptor ceiling — the real trip point for the Bee
+ * build-driver fd-exhaustion hang. Mono's IOSelector refuses to register a
+ * descriptor whose number crosses this (kqueue/kevent on macOS/BSD, epoll on
+ * Linux). The OS `ulimit -n` soft limit is only a loose upper bound and is
+ * misleading for a GUI-launched Unity on macOS (it inherits `launchctl limit
+ * maxfiles`, not the shell's ulimit). Documented in the tool response via
+ * `launchContextCaveat`.
+ */
+export declare const FD_CEILING = 1024;
+/**
+ * Headroom fraction (of FD_CEILING) at or below which the state is `warn`:
+ * the Editor is approaching the Mono ceiling and an agent should surface the
+ * trend so the operator can save + restart before the hang. ≥80% usage.
+ */
+export declare const FD_WARN_RATIO = 0.8;
+/**
+ * Headroom fraction at or below which the state is `critical`: the next
+ * domain reload is likely to trip the Bee build-driver hang. ≥90% usage.
+ */
+export declare const FD_CRITICAL_RATIO = 0.9;
+/** execFileSync timeout for the macOS `lsof` probe (ms). */
+export declare const FD_PROBE_TIMEOUT_MS = 3000;
+/** OS method used to count file descriptors for a PID. */
+export type FdCountMethod = "lsof" | "proc" | "handle_count";
+/** Successful fd-count probe. */
+export interface FdCountOk {
+    /** The raw fd count (or Windows handle count — see `approximate`). */
+    count: number;
+    method: FdCountMethod;
+    /**
+     * `true` when the count is a Windows HandleCount approximation rather than
+     * a Unix fd count. Windows handles cover more than just fds (kernel +
+     * GDI + user objects), so the headroom math is looser there. The response
+     * flags this so an agent does not over-react to a naturally-higher number.
+     */
+    approximate: boolean;
+}
+/** Failed fd-count probe. The count is unknown — callers must NOT treat
+ *  this as "low pressure" (it is "unknown pressure"). */
+export interface FdCountFailed {
+    count: null;
+    method: FdCountMethod;
+    /**
+     * Machine-readable reason for branching. Each reason is paired with the
+     * matching {@link FdCountMethod} — `lsof_failed` only comes from the macOS
+     * probe, `proc_unreadable` only from the Linux probe, and
+     * `handle_count_failed` only from the Windows probe.
+     */
+    reason: "not_found" | "proc_unreadable" | "lsof_failed" | "handle_count_failed" | "unsupported_platform";
+    message: string;
+}
+export type FdCountResult = FdCountOk | FdCountFailed;
+/** Coarse pressure state derived from `computeFdHeadroom`. */
+export type FdPressureState = "ok" | "warn" | "critical" | "unknown";
+/** Headroom metric against the Mono fd ceiling. */
+export interface FdHeadroom {
+    /** Open fds / FD_CEILING, clamped to [0, 1] when count is known. */
+    pressureRatio: number;
+    /** FD_CEILING - count, clamped at 0. */
+    headroom: number;
+    /** The fixed ceiling (Mono ~1024). */
+    ceiling: number;
+    state: FdPressureState;
+    /** `false` when the underlying count was an approximation (Windows). */
+    reliable: boolean;
+}
+/**
+ * Injectable fd-count probe. Tests swap in a fake via the setter below so no
+ * `lsof` / `/proc` / PowerShell I/O runs in unit tests — same seam pattern as
+ * `UnityProcessScanner` / `ProcessKiller`.
+ */
+export interface FdProbe {
+    count(pid: number): FdCountResult;
+}
+/** Read the active probe. Production callers use this via `countFileDescriptors`. */
+export declare function getFdProbe(): FdProbe;
+/**
+ * Install a fake probe for tests. Returns a restore function that re-binds the
+ * previous probe. Production code MUST NOT call this.
+ */
+export declare function setFdProbeForTest(fake: FdProbe | null): () => void;
+/**
+ * Count the open file descriptors for a live Unity PID. Never throws —
+ * failures (process gone, lsof/proc unreadable, unsupported platform) surface
+ * as `FdCountFailed`. The result's `method` records how the count was obtained
+ * so an agent can interpret the headroom math correctly (Windows
+ * `handle_count` is approximate).
+ *
+ * @param pid the live Unity PID (from `findUnityForProject`).
+ */
+export declare function countFileDescriptors(pid: number): FdCountResult;
+/**
+ * Pure headroom math against the fixed Mono fd ceiling. The OS soft limit
+ * (`ulimit -n`) is intentionally NOT used — it is a loose upper bound and is
+ * misleading for GUI-launched Unity on macOS (inherits `launchctl limit
+ * maxfiles`, not the shell ulimit).
+ *
+ * `null` count (probe failed) → `state: "unknown"` with `reliable: false`. An
+ * agent must NOT treat "unknown" as "ok"; it should surface the trend (if any
+ * prior samples exist) and tell the operator the live count could not be read.
+ */
+export declare function computeFdHeadroom(count: number | null, approximate?: boolean): FdHeadroom;
+/** One fd sample recorded in the session-scoped ring. */
+export interface FdSample {
+    /** Wall-clock timestamp (ms since epoch). */
+    ts: number;
+    /** The Unity PID the sample was taken against. */
+    pid: number;
+    /** Open fd count at sample time (`null` when the probe failed). */
+    count: number | null;
+}
+/**
+ * Trend classification across successive fd samples. A monotonic climb across
+ * domain reloads is the leak signature — the agent should warn the operator to
+ * save + restart BEFORE the next reload trips the ceiling. Absolute count is
+ * NOT enough: a stable 600 fds is healthy; a climb 600 → 800 → 950 across
+ * three reloads is a leak in progress.
+ */
+export type FdTrendState = "no_history" | "stable" | "rising" | "leaking" | "unknown";
+export interface FdTrend {
+    state: FdTrendState;
+    /**
+     * First-to-last delta in fd count (negative for a leak — the count grew).
+     * `null` when there are fewer than two samples with known counts for the
+     * same PID.
+     */
+    delta: number | null;
+    /** Number of samples used for the trend (same-PID, known-count). */
+    sampleCount: number;
+}
+/**
+ * Pure trend detector over a sample list. Only considers samples with a known
+ * count for the SAME pid (a Unity restart changes the PID; the trend must not
+ * mix pre- and post-restart samples). A monotonic climb of ≥10% of the
+ * ceiling across ≥3 samples is `leaking`; a non-monotonic climb is `rising`;
+ * otherwise `stable`. Fewer than two usable samples → `no_history`.
+ */
+export declare function analyzeFdTrend(samples: readonly FdSample[]): FdTrend;
+/**
+ * Caveat string surfaced in the resource_pressure response so an agent (and
+ * the operator) understand the launch-context nuance: the Mono ceiling, not
+ * the OS soft limit, is the trip point; a GUI-launched Unity inherits
+ * `launchctl limit maxfiles` (macOS) rather than the shell's ulimit.
+ */
+export declare const LAUNCH_CONTEXT_CAVEAT: string;

package/dist/process-diagnostics.js

@@ -0,0 +1,333 @@
+// M31 Plan 3 / T31.4 — Editor fd-exhaustion prediction (proactive fd-usage
+// monitoring).
+//
+// Companion to `editor-process-control.ts` (the reactive kill half). Where the
+// kill tool acts AFTER the Editor is hung, this module samples the live Unity
+// process's file-descriptor count BEFORE exhaustion so an agent can warn the
+// operator to save and restart while the bridge is still healthy. The bridge
+// is the thing that dies on fd-exhaustion, so the probe MUST NOT depend on it
+// — it runs server-side against the OS, exactly like the process scan in
+// `running-unity.ts`.
+//
+// Threshold rationale (the plan's "Mono ceiling, not OS soft limit" point):
+//
+//   Mono's IOSelector (kqueue/kevent on macOS/BSD, epoll on Linux) refuses to
+//   register a descriptor whose number crosses an internal ~1024 ceiling —
+//   that is the real trip point for the Bee build-driver hang. The OS
+//   `ulimit -n` soft limit is only a loose upper bound and is misleading on
+//   macOS: a GUI-launched Unity inherits `launchctl limit maxfiles`, not the
+//   MCP server's shell `ulimit`. So we measure headroom against the fixed
+//   Mono ceiling (FD_CEILING), not the variable OS limit.
+//
+// Cross-platform probe:
+//   - macOS: `lsof -p <pid>` (no /proc on macOS). Bounded execFileSync
+//     timeout; line count is the fd total. Heavy — callers cache briefly.
+//   - Linux: `readdirSync(/proc/<pid>/fd).length` (no shell-out).
+//   - Windows: `Get-Process -Id <pid>.HandleCount` (approximate — Windows
+//     handle count is broader than Unix fds; the threshold differs and the
+//     result is flagged `approximate: true`).
+import { execFileSync } from "node:child_process";
+import { readdirSync } from "node:fs";
+/**
+ * Mono's internal file-descriptor ceiling — the real trip point for the Bee
+ * build-driver fd-exhaustion hang. Mono's IOSelector refuses to register a
+ * descriptor whose number crosses this (kqueue/kevent on macOS/BSD, epoll on
+ * Linux). The OS `ulimit -n` soft limit is only a loose upper bound and is
+ * misleading for a GUI-launched Unity on macOS (it inherits `launchctl limit
+ * maxfiles`, not the shell's ulimit). Documented in the tool response via
+ * `launchContextCaveat`.
+ */
+export const FD_CEILING = 1024;
+/**
+ * Headroom fraction (of FD_CEILING) at or below which the state is `warn`:
+ * the Editor is approaching the Mono ceiling and an agent should surface the
+ * trend so the operator can save + restart before the hang. ≥80% usage.
+ */
+export const FD_WARN_RATIO = 0.8;
+/**
+ * Headroom fraction at or below which the state is `critical`: the next
+ * domain reload is likely to trip the Bee build-driver hang. ≥90% usage.
+ */
+export const FD_CRITICAL_RATIO = 0.9;
+/** execFileSync timeout for the macOS `lsof` probe (ms). */
+export const FD_PROBE_TIMEOUT_MS = 3_000;
+// ---------------------------------------------------------------------------
+// Platform-specific probe implementations.
+// ---------------------------------------------------------------------------
+/** macOS `lsof -p <pid>` scanner. Returns the line count (one line per fd). */
+function probeMacos(pid) {
+    let stdout;
+    try {
+        stdout = execFileSync("lsof", ["-p", String(pid)], {
+            encoding: "utf8",
+            timeout: FD_PROBE_TIMEOUT_MS,
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        // lsof exits non-zero when the PID is gone. Treat that as not_found.
+        if (/no such file|exit code: 1/i.test(message)) {
+            return {
+                count: null,
+                method: "lsof",
+                reason: "not_found",
+                message: `lsof reported no process for PID ${pid}.`,
+            };
+        }
+        return {
+            count: null,
+            method: "lsof",
+            reason: "lsof_failed",
+            message: `lsof failed for PID ${pid}: ${message}`,
+        };
+    }
+    // `lsof -p <pid>` prints a header line ("COMMAND PID USER FD TYPE ...") then
+    // one line per open fd. Subtract the header. An empty/blank stdout means the
+    // PID vanished between the spawn and the read — treat as not_found.
+    const lines = stdout.split(/\r?\n/).filter((l) => l.length > 0);
+    if (lines.length === 0) {
+        return {
+            count: null,
+            method: "lsof",
+            reason: "not_found",
+            message: `lsof produced no output for PID ${pid}.`,
+        };
+    }
+    // Header is the first line; its FD column says "FD" literally. The rest are
+    // per-fd rows. Subtract 1 for the header.
+    return {
+        count: Math.max(0, lines.length - 1),
+        method: "lsof",
+        approximate: false,
+    };
+}
+/** Linux `/proc/<pid>/fd` directory entry count (no shell-out). */
+function probeLinux(pid) {
+    let entries;
+    try {
+        entries = readdirSync(`/proc/${pid}/fd`);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT") {
+            return {
+                count: null,
+                method: "proc",
+                reason: "not_found",
+                message: `No /proc/${pid}/fd (process gone).`,
+            };
+        }
+        return {
+            count: null,
+            method: "proc",
+            reason: "proc_unreadable",
+            message: `Could not read /proc/${pid}/fd: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    // `/proc/<pid>/fd` contains one entry per open fd (symbolic links). readdir
+    // returns the names — the count is the length.
+    return {
+        count: entries.length,
+        method: "proc",
+        approximate: false,
+    };
+}
+/** Windows `Get-Process -Id <pid>.HandleCount` (approximate). */
+function probeWindows(pid) {
+    let stdout;
+    try {
+        stdout = execFileSync("powershell", [
+            "-NoProfile",
+            "-NonInteractive",
+            "-Command",
+            `(Get-Process -Id ${pid} -ErrorAction SilentlyContinue).HandleCount`,
+        ], {
+            encoding: "utf8",
+            windowsHide: true,
+            timeout: FD_PROBE_TIMEOUT_MS,
+        });
+    }
+    catch (err) {
+        return {
+            count: null,
+            method: "handle_count",
+            reason: "handle_count_failed",
+            message: `PowerShell handle-count probe failed for PID ${pid}: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    const trimmed = stdout.trim();
+    if (trimmed.length === 0) {
+        return {
+            count: null,
+            method: "handle_count",
+            reason: "not_found",
+            message: `Get-Process reported no process for PID ${pid}.`,
+        };
+    }
+    const parsed = Number.parseInt(trimmed, 10);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return {
+            count: null,
+            method: "handle_count",
+            reason: "handle_count_failed",
+            message: `Unparseable HandleCount '${trimmed}' for PID ${pid}.`,
+        };
+    }
+    return {
+        count: parsed,
+        method: "handle_count",
+        // Windows HandleCount includes kernel + GDI + user handles — broader
+        // than Unix fds. The headroom math still applies as a loose signal.
+        approximate: true,
+    };
+}
+const realProbe = {
+    count(pid) {
+        if (!Number.isInteger(pid) || pid <= 0) {
+            return {
+                count: null,
+                method: "lsof",
+                reason: "not_found",
+                message: `Invalid PID ${pid}.`,
+            };
+        }
+        if (process.platform === "darwin")
+            return probeMacos(pid);
+        if (process.platform === "linux")
+            return probeLinux(pid);
+        if (process.platform === "win32")
+            return probeWindows(pid);
+        return {
+            count: null,
+            method: "lsof",
+            reason: "unsupported_platform",
+            message: `fd-count probe is not implemented for platform '${process.platform}'.`,
+        };
+    },
+};
+// Mutable binding so tests can swap in a fake probe.
+let currentProbe = realProbe;
+/** Read the active probe. Production callers use this via `countFileDescriptors`. */
+export function getFdProbe() {
+    return currentProbe;
+}
+/**
+ * Install a fake probe for tests. Returns a restore function that re-binds the
+ * previous probe. Production code MUST NOT call this.
+ */
+export function setFdProbeForTest(fake) {
+    const prev = currentProbe;
+    currentProbe = fake ?? realProbe;
+    return () => {
+        currentProbe = prev;
+    };
+}
+/**
+ * Count the open file descriptors for a live Unity PID. Never throws —
+ * failures (process gone, lsof/proc unreadable, unsupported platform) surface
+ * as `FdCountFailed`. The result's `method` records how the count was obtained
+ * so an agent can interpret the headroom math correctly (Windows
+ * `handle_count` is approximate).
+ *
+ * @param pid the live Unity PID (from `findUnityForProject`).
+ */
+export function countFileDescriptors(pid) {
+    return currentProbe.count(pid);
+}
+/**
+ * Pure headroom math against the fixed Mono fd ceiling. The OS soft limit
+ * (`ulimit -n`) is intentionally NOT used — it is a loose upper bound and is
+ * misleading for GUI-launched Unity on macOS (inherits `launchctl limit
+ * maxfiles`, not the shell ulimit).
+ *
+ * `null` count (probe failed) → `state: "unknown"` with `reliable: false`. An
+ * agent must NOT treat "unknown" as "ok"; it should surface the trend (if any
+ * prior samples exist) and tell the operator the live count could not be read.
+ */
+export function computeFdHeadroom(count, approximate = false) {
+    if (count === null || !Number.isFinite(count)) {
+        return {
+            pressureRatio: 0,
+            headroom: FD_CEILING,
+            ceiling: FD_CEILING,
+            state: "unknown",
+            reliable: false,
+        };
+    }
+    const clamped = Math.max(0, count);
+    const pressureRatio = Math.min(1, clamped / FD_CEILING);
+    const headroom = Math.max(0, FD_CEILING - clamped);
+    let state;
+    if (approximate) {
+        // Windows HandleCount is naturally higher than Unix fds — only flag
+        // critical, never warn, so an agent does not over-react.
+        state = pressureRatio >= FD_CRITICAL_RATIO ? "critical" : "ok";
+    }
+    else if (pressureRatio >= FD_CRITICAL_RATIO) {
+        state = "critical";
+    }
+    else if (pressureRatio >= FD_WARN_RATIO) {
+        state = "warn";
+    }
+    else {
+        state = "ok";
+    }
+    return {
+        pressureRatio,
+        headroom,
+        ceiling: FD_CEILING,
+        state,
+        reliable: !approximate,
+    };
+}
+/**
+ * Pure trend detector over a sample list. Only considers samples with a known
+ * count for the SAME pid (a Unity restart changes the PID; the trend must not
+ * mix pre- and post-restart samples). A monotonic climb of ≥10% of the
+ * ceiling across ≥3 samples is `leaking`; a non-monotonic climb is `rising`;
+ * otherwise `stable`. Fewer than two usable samples → `no_history`.
+ */
+export function analyzeFdTrend(samples) {
+    if (samples.length === 0) {
+        return { state: "no_history", delta: null, sampleCount: 0 };
+    }
+    // Take the tail for the most-recent PID (a restart changes the PID).
+    const lastPid = samples[samples.length - 1].pid;
+    const usable = samples.filter((s) => s.pid === lastPid && s.count !== null && Number.isFinite(s.count));
+    if (usable.length < 2) {
+        return { state: "no_history", delta: null, sampleCount: usable.length };
+    }
+    const first = usable[0].count;
+    const last = usable[usable.length - 1].count;
+    const delta = last - first;
+    // `rising` = strictly non-decreasing across all usable samples (each step
+    // ≥ the previous). `leaking` = rising AND the total climb is ≥10% of the
+    // Mono ceiling (a meaningful leak, not measurement noise).
+    let monotonic = true;
+    for (let i = 1; i < usable.length; i++) {
+        if (usable[i].count < usable[i - 1].count) {
+            monotonic = false;
+            break;
+        }
+    }
+    if (monotonic && delta >= FD_CEILING * 0.1) {
+        return { state: "leaking", delta, sampleCount: usable.length };
+    }
+    if (delta > 0) {
+        return { state: "rising", delta, sampleCount: usable.length };
+    }
+    return { state: "stable", delta, sampleCount: usable.length };
+}
+/**
+ * Caveat string surfaced in the resource_pressure response so an agent (and
+ * the operator) understand the launch-context nuance: the Mono ceiling, not
+ * the OS soft limit, is the trip point; a GUI-launched Unity inherits
+ * `launchctl limit maxfiles` (macOS) rather than the shell's ulimit.
+ */
+export const LAUNCH_CONTEXT_CAVEAT = "Headroom is measured against Mono's internal ~1024 file-descriptor ceiling " +
+    "(the real trip point for the Bee build-driver hang), NOT the OS soft limit " +
+    "(ulimit -n / launchctl limit maxfiles). A GUI-launched Unity inherits the " +
+    "desktop environment's file limit, not the MCP server's shell limit, so the " +
+    "OS soft limit is only a loose upper bound.";
+//# sourceMappingURL=process-diagnostics.js.map

package/dist/process-diagnostics.js.map

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

package/dist/schema-defaults.d.ts

@@ -8,3 +8,14 @@ import type { Tool } from "@modelcontextprotocol/sdk/types.js";
  * are preserved verbatim, including `undefined`/`null`.
  */
 export declare function withSchemaDefaults(tool: Tool, args: Record<string, unknown>): Record<string, unknown>;
+/**
+ * M15 — validate that every field in the tool's `inputSchema.required` array is
+ * present (and not `undefined`/`null`) in `args`. The MCP SDK does not enforce
+ * `required`, so without this a missing required argument flows downstream as
+ * the literal `undefined` (e.g. `regression_check` without `baseline_path`
+ * spawns Unity with `--baseline-path undefined`).
+ *
+ * @returns the list of missing required field names (empty when all present).
+ *          The caller decides how to surface the error.
+ */
+export declare function missingRequiredArgs(tool: Tool, args: Record<string, unknown>): string[];

package/dist/schema-defaults.js

@@ -1,4 +1,4 @@
-// Schema-default injection.
+// Schema-default injection + required-argument validation.
 //
 // MCP JSON-Schema documents advertise per-property `default` values (e.g.
 // `run_tests` documents `timeout_ms` default 60000). Those defaults are advisory:
@@ -13,6 +13,13 @@
 // any missing top-level argument whose property declares a scalar `default`
 // before dispatching. This keeps client-supplied values authoritative and only
 // ever adds missing fields.
+//
+// M15 — the MCP SDK does NOT validate `inputSchema.required`: an agent can call
+// `regression_check` without `baseline_path` (declared required) and the value
+// reaches the bridge / batch spawn as the literal `undefined`, e.g. Unity is
+// spawned with `--baseline-path undefined`. validateRequiredArgs closes that
+// gap by checking the schema's `required` array up front and returning a stable
+// `missing_required_argument` error listing every missing field.
 function isScalarDefault(value) {
     return (typeof value === "number" ||
         typeof value === "boolean" ||
@@ -40,4 +47,28 @@ export function withSchemaDefaults(tool, args) {
     }
     return out;
 }
+/**
+ * M15 — validate that every field in the tool's `inputSchema.required` array is
+ * present (and not `undefined`/`null`) in `args`. The MCP SDK does not enforce
+ * `required`, so without this a missing required argument flows downstream as
+ * the literal `undefined` (e.g. `regression_check` without `baseline_path`
+ * spawns Unity with `--baseline-path undefined`).
+ *
+ * @returns the list of missing required field names (empty when all present).
+ *          The caller decides how to surface the error.
+ */
+export function missingRequiredArgs(tool, args) {
+    const required = tool.inputSchema?.required;
+    if (!Array.isArray(required) || required.length === 0)
+        return [];
+    const missing = [];
+    for (const field of required) {
+        if (typeof field !== "string")
+            continue;
+        const v = args[field];
+        if (v === undefined || v === null)
+            missing.push(field);
+    }
+    return missing;
+}
 //# sourceMappingURL=schema-defaults.js.map

package/dist/schema-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-defaults.js","sourceRoot":"","sources":["../src/schema-defaults.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,0EAA0E;AAC1E,kFAAkF;AAClF,8EAA8E;AAC9E,8EAA8E;AAC9E,0EAA0E;AAC1E,0EAA0E;AAC1E,oEAAoE;AACpE,6CAA6C;AAC7C,EAAE;AACF,+EAA+E;AAC/E,4EAA4E;AAC5E,+EAA+E;AAC/E,4BAA4B;AAY5B,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,OAAO,KAAK,KAAK,QAAQ,CAC1B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAU,EACV,IAA6B;IAE7B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,UAExB,CAAC;IACd,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IAEpC,MAAM,GAAG,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACvD,IAAI,GAAG,IAAI,GAAG;YAAE,SAAS;QACzB,MAAM,GAAG,GAAG,MAAM,EAAE,OAAO,CAAC;QAC5B,IAAI,eAAe,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"schema-defaults.js","sourceRoot":"","sources":["../src/schema-defaults.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,0EAA0E;AAC1E,kFAAkF;AAClF,8EAA8E;AAC9E,8EAA8E;AAC9E,0EAA0E;AAC1E,0EAA0E;AAC1E,oEAAoE;AACpE,6CAA6C;AAC7C,EAAE;AACF,+EAA+E;AAC/E,4EAA4E;AAC5E,+EAA+E;AAC/E,4BAA4B;AAC5B,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,6EAA6E;AAC7E,6EAA6E;AAC7E,gFAAgF;AAChF,iEAAiE;AAYjE,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,OAAO,KAAK,KAAK,QAAQ,CAC1B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAU,EACV,IAA6B;IAE7B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,UAExB,CAAC;IACd,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IAEpC,MAAM,GAAG,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACvD,IAAI,GAAG,IAAI,GAAG;YAAE,SAAS;QACzB,MAAM,GAAG,GAAG,MAAM,EAAE,OAAO,CAAC;QAC5B,IAAI,eAAe,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAU,EACV,IAA6B;IAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QACxC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/server-instructions.js

@@ -51,8 +51,13 @@ export function buildServerInstructions() {
         "`unity_open_mcp_*` tools route through the live bridge (or fall back to a",
         "headless batch Unity / offline disk parsers); `unity_senses_*` tools are",
         "live-only and never batch. Call `unity_open_mcp_capabilities` first to",
-        "learn the full surface, then `unity_open_mcp_manage_tools(action=\"list_groups\")`",
-        "to see which tool groups are compiled in and active.",
+        "learn the full surface, then activate the tools you need. Prefer the",
+        "intent path `unity_open_mcp_manage_tools(action=\"activate_for\",",
+        "intent=\"…\")` over hand-picking group ids — state what you are about to",
+        "do and the server brings the right groups online in one call (use",
+        "action=\"suggest\" with the same intent/tags to preview without changing",
+        "state). `action=\"list_groups\"` lists every group with its active flag,",
+        "compiled-state availability, and tool roster.",
         "",
         "PAYLOAD SIZING & PAGING (avoid flooding context)",
         "- The heavy tools (`read_asset`, `search_assets`, `scene_get_data`,",

package/dist/server-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../src/server-instructions.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,gDAAgD;AAChD,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,uEAAuE;AACvE,wEAAwE;AACxE,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;AAC7E,sEAAsE;AACtE,EAAE;AACF,sEAAsE;AACtE,8EAA8E;AAC9E,+EAA+E;AAC/E,wDAAwD;AACxD,EAAE;AACF,4EAA4E;AAC5E,4DAA4D;AAE5D,6EAA6E;AAC7E,wEAAwE;AACxE,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,+DAA+D;AAC/D,MAAM,2BAA2B,GAAa;IAC5C,kBAAkB,EAAE,uBAAuB;IAC3C,oBAAoB,EAAE,qBAAqB;IAC3C,UAAU;IACV,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,uBAAuB;IACvB,oBAAoB;IACpB,gBAAgB;IAChB,qBAAqB;IACrB,aAAa;IACb,SAAS;CACV,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,oEAAoE;QACpE,2EAA2E;QAC3E,0EAA0E;QAC1E,wEAAwE;QACxE,oFAAoF;QACpF,sDAAsD;QACtD,EAAE;QACF,kDAAkD;QAClD,qEAAqE;QACrE,0EAA0E;QAC1E,4EAA4E;QAC5E,wEAAwE;QACxE,yEAAyE;QACzE,4EAA4E;QAC5E,2EAA2E;QAC3E,4EAA4E;QAC5E,kEAAkE;QAClE,8EAA8E;QAC9E,oEAAoE;QACpE,sEAAsE;QACtE,gCAAgC;QAChC,yEAAyE;QACzE,wEAAwE;QACxE,gCAAgC;QAChC,EAAE;QACF,sDAAsD;QACtD,iEAAiE;QACjE,2EAA2E;QAC3E,eAAe;QACf,4EAA4E;QAC5E,+DAA+D;QAC/D,2DAA2D;QAC3D,6DAA6D;QAC7D,2EAA2E;QAC3E,yEAAyE;QACzE,uEAAuE;QACvE,4EAA4E;QAC5E,EAAE;QACF,qBAAqB;QACrB,mEAAmE;QACnE,6DAA6D;QAC7D,uEAAuE;QACvE,yEAAyE;QACzE,8CAA8C;QAC9C,uEAAuE;QACvE,uEAAuE;QACvE,4EAA4E;QAC5E,wEAAwE;QACxE,0EAA0E;QAC1E,0EAA0E;QAC1E,EAAE;QACF,mBAAmB;QACnB,wEAAwE;QACxE,4EAA4E;QAC5E,6CAA6C;QAC7C,qEAAqE;QACrE,wEAAwE;QACxE,yEAAyE;QACzE,wDAAwD;QACxD,yEAAyE;QACzE,2EAA2E;QAC3E,kDAAkD;QAClD,EAAE;QACF,kBAAkB;QAClB,mEAAmE;QACnE,uDAAuD;KACxD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,GAAG,uBAAuB,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAAC,IAAY;IAC3D,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,2BAA2B,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK;YAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../src/server-instructions.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,17 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+/**
+ * Resolve env for the MCP server. UNITY_PROJECT_PATH is mandatory. The port
+ * uses M13 T4.3 instance discovery:
+ *   1. UNITY_OPEN_MCP_BRIDGE_PORT env var (override wins; users who pin a
+ *      port keep working as before)
+ *   2. ~/.unity-open-mcp/instances/<hash>.json lock file (when its pid is alive)
+ *   3. deterministic hash of the project path (20000 + sha256 % 10000)
+ * The resolved port is logged so users can see which bridge was picked.
+ */
+export declare function getEnv(): {
+    projectPath: string;
+    port: number;
+    authToken?: string;
+    envPort?: number;
+};
+export declare function createServer(projectPath: string, port: number, authToken?: string, envPort?: number): Server;