unity-open-mcp 0.1.0

package/dist/cli/args.js.map

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

package/dist/cli/cli.d.ts

@@ -0,0 +1,23 @@
+export interface CliRunOptions {
+    /** Package version, used by --version. */
+    version: string;
+    /** Invocation name for help text (e.g. "unity-open-mcp"). */
+    binName?: string;
+    /** argv after the node binary + script path. Defaults to process.argv.slice(2). */
+    argv?: string[];
+}
+export interface CliRunOutcome {
+    /** True when argv recognized a CLI subcommand (or --help/--version). */
+    handled: boolean;
+    /** Process exit code; only meaningful when handled === true. */
+    exitCode: number;
+}
+/**
+ * Run the CLI. Returns whether the invocation was a CLI subcommand (handled)
+ * so index.ts can decide whether to fall through to the stdio server.
+ *
+ * This function writes to stdout/stderr itself and is meant to be the top of
+ * the process. It does NOT call process.exit — the caller does, so tests can
+ * drive it without tearing down the test runner.
+ */
+export declare function runCli(opts: CliRunOptions): Promise<CliRunOutcome>;

package/dist/cli/cli.js

@@ -0,0 +1,125 @@
+// M15 T6.1 — CLI dispatcher.
+//
+// This module is the entry point for `unity-open-mcp <command>`. It:
+//   1. parses argv (src/cli/args.ts)
+//   2. builds the shared router stack (src/routers.ts)
+//   3. dispatches to the right command (src/cli/commands.ts)
+//   4. prints JSON or human-readable output and sets the exit code
+//
+// When argv[0] is NOT a known subcommand, runCli returns null — the caller
+// (index.ts) then falls through to the stdio MCP server. That keeps a single
+// `bin` working for both `npx unity-open-mcp wait-for-ready` and an MCP client
+// spawning `node dist/index.js`.
+import { parseCliArgs } from "./args.js";
+import { runPingCommand, runWaitForReadyCommand, runStatusCommand, runRunToolCommand, helpText, versionText, DEFAULT_WAIT_TIMEOUT_MS, DEFAULT_POLL_INTERVAL_MS, } from "./commands.js";
+import { resolveEnv, buildRouterStack, ResolveEnvError, } from "../routers.js";
+const PING_DEFAULT_TIMEOUT_MS = 5_000;
+/**
+ * Run the CLI. Returns whether the invocation was a CLI subcommand (handled)
+ * so index.ts can decide whether to fall through to the stdio server.
+ *
+ * This function writes to stdout/stderr itself and is meant to be the top of
+ * the process. It does NOT call process.exit — the caller does, so tests can
+ * drive it without tearing down the test runner.
+ */
+export async function runCli(opts) {
+    const argv = opts.argv ?? process.argv.slice(2);
+    const parsed = parseCliArgs(argv);
+    const binName = opts.binName ?? "unity-open-mcp";
+    // --help / --version short-circuit before any project-path requirement.
+    if (parsed.command === "help") {
+        process.stdout.write(helpText(binName) + "\n");
+        return { handled: true, exitCode: 0 };
+    }
+    if (parsed.command === "version") {
+        process.stdout.write(versionText(opts.version) + "\n");
+        return { handled: true, exitCode: 0 };
+    }
+    // No command → caller falls through to the MCP server.
+    if (!parsed.command) {
+        return { handled: false, exitCode: 0 };
+    }
+    if (parsed.error) {
+        process.stderr.write(`unity-open-mcp: ${parsed.error}\n\n`);
+        process.stderr.write(helpText(binName) + "\n");
+        return { handled: true, exitCode: 2 };
+    }
+    // Build the router stack. Every command needs a project path + resolved
+    // bridge port.
+    let stack;
+    try {
+        const env = resolveEnv(parsed.projectPath, parsed.port);
+        logResolve(env.port, env.projectPath, env.authToken);
+        stack = buildRouterStack(env);
+    }
+    catch (err) {
+        if (err instanceof ResolveEnvError) {
+            process.stderr.write(`unity-open-mcp: ${err.message}\n`);
+            return { handled: true, exitCode: 2 };
+        }
+        throw err;
+    }
+    let result;
+    try {
+        switch (parsed.command) {
+            case "ping":
+                result = await runPingCommand(stack, {
+                    json: parsed.json,
+                    timeoutMs: parsed.timeoutMs ?? PING_DEFAULT_TIMEOUT_MS,
+                });
+                break;
+            case "wait-for-ready":
+                result = await runWaitForReadyCommand(stack, {
+                    json: parsed.json,
+                    timeoutMs: parsed.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS,
+                    intervalMs: parsed.intervalMs ?? DEFAULT_POLL_INTERVAL_MS,
+                });
+                break;
+            case "status":
+                result = await runStatusCommand(stack, { json: parsed.json });
+                break;
+            case "run-tool":
+                result = await runRunToolCommand(stack, {
+                    json: parsed.json,
+                    toolName: parsed.toolName,
+                    toolArgs: parsed.toolArgs,
+                });
+                break;
+            default:
+                // Unreachable: parsed.command is one of the cases above or help/version.
+                process.stderr.write(`unity-open-mcp: internal error — unhandled command '${parsed.command}'.\n`);
+                return { handled: true, exitCode: 2 };
+        }
+    }
+    finally {
+        // The event stream opens an SSE reader; tear it down so the process can
+        // exit cleanly. (run-tool may have started a subscription via pull_events.)
+        try {
+            stack.eventStream.stop();
+        }
+        catch {
+            // best-effort
+        }
+    }
+    emitResult(result, parsed.json);
+    return { handled: true, exitCode: result.exitCode };
+}
+function logResolve(port, projectPath, authToken) {
+    // Match the stdio server's startup log shape so `status`/logs look the same
+    // regardless of how the process was launched.
+    process.stderr.write(`[unity-open-mcp] Bridge port resolved to ${port} for project ${projectPath}\n`);
+    if (authToken) {
+        process.stderr.write("[unity-open-mcp] Bridge auth token discovered from instance lock.\n");
+    }
+}
+function emitResult(result, json) {
+    const stream = result.exitCode === 0 ? process.stdout : process.stderr;
+    if (json) {
+        process.stdout.write(JSON.stringify(result.json, null, 2) + "\n");
+        return;
+    }
+    // Human-readable: keep success on stdout, failures on stderr so a CI pipeline
+    // can capture the message without mixing it into stdout JSON downstream.
+    stream.write(result.human + "\n");
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli/cli.js.map

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

package/dist/cli/commands.d.ts

@@ -0,0 +1,37 @@
+import type { RouterStack } from "../routers.js";
+import { DEFAULT_WAIT_TIMEOUT_MS, DEFAULT_POLL_INTERVAL_MS } from "./ping-poller.js";
+export interface CliCommandResult {
+    /** Process exit code. 0 = success, non-zero = failure. */
+    exitCode: number;
+    /** JSON-serializable payload. Always populated — `--json` prints it verbatim. */
+    json: unknown;
+    /** Human-readable multi-line summary; printed when --json is NOT set. */
+    human: string;
+    /** Optional structured error label (e.g. "unknown_tool") surfaced in JSON. */
+    errorLabel?: string;
+}
+export interface PingCommandOptions {
+    json: boolean;
+    timeoutMs: number;
+}
+export declare function runPingCommand(stack: RouterStack, opts: PingCommandOptions): Promise<CliCommandResult>;
+export interface WaitForReadyCommandOptions {
+    json: boolean;
+    timeoutMs: number;
+    intervalMs: number;
+}
+export declare function runWaitForReadyCommand(stack: RouterStack, opts: WaitForReadyCommandOptions): Promise<CliCommandResult>;
+export interface StatusCommandOptions {
+    json: boolean;
+}
+export declare function runStatusCommand(stack: RouterStack, _opts: StatusCommandOptions): Promise<CliCommandResult>;
+export interface RunToolCommandOptions {
+    json: boolean;
+    toolName: string;
+    /** Raw caller args (before schema defaults). */
+    toolArgs: Record<string, unknown>;
+}
+export declare function runRunToolCommand(stack: RouterStack, opts: RunToolCommandOptions): Promise<CliCommandResult>;
+export declare function helpText(binName: string): string;
+export declare function versionText(version: string): string;
+export { DEFAULT_WAIT_TIMEOUT_MS, DEFAULT_POLL_INTERVAL_MS, };

package/dist/cli/commands.js

@@ -0,0 +1,277 @@
+// M15 T6.1 — CLI command implementations.
+//
+// Each command is a plain async function returning a CliCommandResult. The
+// dispatcher (cli.ts) owns stdout/stderr/exit-code; the commands are pure and
+// therefore unit-testable. Commands always produce JSON-shaped data; the
+// `--json` flag toggles whether the dispatcher prints that JSON verbatim or
+// renders a human-readable summary.
+//
+// Commands share the same router stack the MCP server uses (buildRouterStack),
+// so a `run-tool` call returns byte-for-byte the same JSON an MCP client would
+// receive — that parity is the primary acceptance criterion of T6.1.
+import { ALL_TOOLS } from "../tools/index.js";
+import { withSchemaDefaults } from "../schema-defaults.js";
+import { readInstanceLock, classifyInstance, lockPath, } from "../instance-discovery.js";
+import { pollUntilReady, singlePing, DEFAULT_WAIT_TIMEOUT_MS, DEFAULT_POLL_INTERVAL_MS, PING_FETCH_TIMEOUT_MS, } from "./ping-poller.js";
+import { checkBridgeCompat } from "../compat.js";
+const TOOL_BY_NAME = new Map(ALL_TOOLS.map((t) => [t.name, t]));
+export async function runPingCommand(stack, opts) {
+    const poll = await singlePing(stack.live, opts.timeoutMs);
+    const json = {
+        command: "ping",
+        baseUrl: `http://127.0.0.1:${stack.port}`,
+        status: poll.status,
+        ready: poll.status === "ready",
+        body: poll.body,
+    };
+    if (poll.status === "ready" && poll.body) {
+        return {
+            exitCode: 0,
+            json,
+            human: formatPingHuman(stack.port, poll.body),
+        };
+    }
+    const reason = poll.status === "compiling"
+        ? "Bridge is reachable but Unity is compiling."
+        : poll.status === "offline"
+            ? `Bridge is not reachable at http://127.0.0.1:${stack.port}.`
+            : `Ping failed (${poll.status}).`;
+    return {
+        exitCode: 1,
+        json,
+        human: reason,
+        errorLabel: poll.status,
+    };
+}
+function formatPingHuman(port, body) {
+    const lines = [
+        `Bridge: http://127.0.0.1:${port}`,
+        `connected: ${body.connected ?? "unknown"}`,
+        `compiling: ${body.compiling ?? "unknown"}`,
+        `isPlaying: ${body.isPlaying ?? "unknown"}`,
+    ];
+    if (body.unityVersion)
+        lines.push(`unityVersion: ${body.unityVersion}`);
+    if (body.bridgeVersion)
+        lines.push(`bridgeVersion: ${body.bridgeVersion}`);
+    if (body.projectPath)
+        lines.push(`projectPath: ${body.projectPath}`);
+    if (body.mode)
+        lines.push(`mode: ${body.mode}`);
+    return lines.join("\n");
+}
+export async function runWaitForReadyCommand(stack, opts) {
+    const outcome = await pollUntilReady(stack.live, stack.projectPath, (live) => singlePing(live, PING_FETCH_TIMEOUT_MS), {
+        timeoutMs: opts.timeoutMs,
+        intervalMs: opts.intervalMs,
+    });
+    const json = {
+        command: "wait-for-ready",
+        ready: outcome.ready,
+        status: outcome.status,
+        elapsedMs: outcome.elapsedMs,
+        reason: outcome.reason,
+        lastPing: outcome.lastPing,
+    };
+    return {
+        exitCode: outcome.ready ? 0 : 1,
+        json,
+        human: outcome.reason,
+        errorLabel: outcome.ready ? undefined : outcome.status,
+    };
+}
+export async function runStatusCommand(stack, _opts) {
+    const lockPathOnDisk = lockPath(stack.projectPath);
+    const lock = readInstanceLock(stack.projectPath);
+    const classification = classifyInstance(lock);
+    // Cheap readiness probe — one /ping, no compile-wait.
+    const poll = await singlePing(stack.live, PING_FETCH_TIMEOUT_MS);
+    // Advisory version-compat between this CLI/server and the running bridge.
+    // Computed from the bridge's reported bridgeVersion; ok=false means the pair
+    // is considered incompatible (pre-1.0: minor differs). The status command
+    // never hard-fails on this — it just surfaces the line so operators see drift.
+    const compat = poll.body?.bridgeVersion !== undefined && poll.body?.bridgeVersion !== null
+        ? checkBridgeCompat(String(poll.body.bridgeVersion))
+        : null;
+    const json = {
+        command: "status",
+        projectPath: stack.projectPath,
+        port: stack.port,
+        baseUrl: `http://127.0.0.1:${stack.port}`,
+        authTokenDiscovered: stack.authToken !== undefined,
+        instance: {
+            lockPath: lockPathOnDisk,
+            classification,
+            lock: lock ? summarizeLock(lock) : null,
+        },
+        bridge: {
+            status: poll.status,
+            ready: poll.status === "ready",
+            body: poll.body,
+        },
+        compat: compat
+            ? {
+                ok: compat.ok,
+                serverVersion: compat.serverVersion,
+                bridgeVersion: compat.bridgeVersion,
+                message: compat.message,
+            }
+            : null,
+    };
+    return {
+        exitCode: 0,
+        json,
+        human: formatStatusHuman(json),
+    };
+}
+function summarizeLock(lock) {
+    return {
+        pid: lock.pid,
+        port: lock.port,
+        state: lock.state,
+        isCompiling: lock.isCompiling,
+        isPlaying: lock.isPlaying,
+        heartbeatAt: lock.heartbeatAt,
+        bridgeVersion: lock.bridgeVersion,
+        unityVersion: lock.unityVersion,
+    };
+}
+function formatStatusHuman(json) {
+    const lines = [
+        `Project:   ${json.projectPath}`,
+        `Bridge:    ${json.baseUrl}`,
+        `Auth:      ${json.authTokenDiscovered ? "token discovered (sent as Bearer)" : "no token (authMode must be 'none')"}`,
+        `Instance:  ${json.instance.classification}`,
+        `Bridge:    ${json.bridge.status}${json.bridge.ready ? " (ready)" : ""}`,
+    ];
+    const body = json.bridge.body;
+    if (body) {
+        if (body.unityVersion)
+            lines.push(`Unity:    ${body.unityVersion}`);
+        if (body.bridgeVersion)
+            lines.push(`Bridge ver: ${body.bridgeVersion}`);
+        if (body.compiling)
+            lines.push(`State:     compiling`);
+        if (body.isPlaying)
+            lines.push(`Playmode:  playing`);
+    }
+    if (json.compat) {
+        const tag = json.compat.ok
+            ? json.compat.message
+                ? "ok (drift)"
+                : "ok"
+            : "WARN";
+        lines.push(`Compat:   ${tag} (server ${json.compat.serverVersion} / bridge ${json.compat.bridgeVersion})`);
+    }
+    return lines.join("\n");
+}
+export async function runRunToolCommand(stack, opts) {
+    const tool = TOOL_BY_NAME.get(opts.toolName);
+    if (!tool) {
+        const json = {
+            command: "run-tool",
+            tool: opts.toolName,
+            error: {
+                code: "unknown_tool",
+                message: `Unknown tool '${opts.toolName}'.`,
+                available: ALL_TOOLS.map((t) => t.name),
+            },
+        };
+        return {
+            exitCode: 2,
+            json,
+            human: `Unknown tool '${opts.toolName}'.\n` +
+                `Available tools (${ALL_TOOLS.length}):\n` +
+                wrapList(ALL_TOOLS.map((t) => t.name)),
+            errorLabel: "unknown_tool",
+        };
+    }
+    // Apply the same schema-default injection the MCP server's CallTool handler
+    // does (index.ts). Without this, a CLI caller omitting timeout_ms would get
+    // a different default than an MCP client — parity requires it.
+    const routedArgs = withSchemaDefaults(tool, opts.toolArgs);
+    const result = await stack.router.route(opts.toolName, routedArgs);
+    const body = extractResultBody(result);
+    const isError = result.isError === true;
+    const json = {
+        command: "run-tool",
+        tool: opts.toolName,
+        isError,
+        result: body,
+    };
+    const human = formatRunToolHuman(opts.toolName, isError, body);
+    return {
+        exitCode: isError ? 1 : 0,
+        json,
+        human,
+        errorLabel: isError ? "tool_error" : undefined,
+    };
+}
+function extractResultBody(result) {
+    const first = result.content[0];
+    if (!first || first.type !== "text" || typeof first.text !== "string") {
+        return result;
+    }
+    try {
+        return JSON.parse(first.text);
+    }
+    catch {
+        return first.text;
+    }
+}
+function formatRunToolHuman(toolName, isError, body) {
+    const head = `${toolName}: ${isError ? "ERROR" : "ok"}`;
+    const bodyStr = typeof body === "string" ? body : JSON.stringify(body, null, 2);
+    return `${head}\n${bodyStr}`;
+}
+function wrapList(items, perLine = 4) {
+    const out = [];
+    for (let i = 0; i < items.length; i += perLine) {
+        out.push("  " + items.slice(i, i + perLine).join(", "));
+    }
+    return out.join("\n");
+}
+// ---------------------------------------------------------------------------
+// help / version
+// ---------------------------------------------------------------------------
+export function helpText(binName) {
+    return [
+        `Usage: ${binName} <command> [options]`,
+        "",
+        "Thin CLI for Unity Open MCP — wraps the MCP server for CI / scripting.",
+        "When invoked with no command, runs the stdio MCP server (MCP client mode).",
+        "",
+        "Commands:",
+        "  ping                          One /ping against the bridge; exit 0 if ready.",
+        "  wait-for-ready                Poll /ping until the bridge is ready; exit 0/non-zero.",
+        "  status                        Show resolved bridge port, instance lock, and readiness.",
+        "  run-tool <name>               Invoke an MCP tool by name; print its JSON result.",
+        "  --help, -h                    Show this help.",
+        "  --version, -V                 Print the package version.",
+        "",
+        "Options:",
+        "  --json                        Emit JSON instead of human-readable output (all commands).",
+        "  --project <path>, -P <path>   Unity project path (default: UNITY_PROJECT_PATH).",
+        "  --port <n>, -p <n>            Bridge port override (default: UNITY_OPEN_MCP_BRIDGE_PORT).",
+        "  --timeout-ms <n>              Ping / wait-for-ready timeout in ms.",
+        "  --interval-ms <n>             wait-for-ready poll interval in ms.",
+        "  --args '<json>'               JSON object of tool args (run-tool).",
+        "  --arg key=value               One tool arg (run-tool, repeatable; JSON-parsed if valid).",
+        "",
+        "Environment:",
+        "  UNITY_PROJECT_PATH             Required for every command.",
+        "  UNITY_OPEN_MCP_BRIDGE_PORT     Optional port override.",
+        "  UNITY_PATH                     Unity Editor executable for batch-only tools.",
+        "",
+        "Examples:",
+        `  ${binName} wait-for-ready`,
+        `  ${binName} run-tool unity_open_mcp_ping --json`,
+        `  ${binName} run-tool unity_open_mcp_list_assets --arg folder=Assets --arg max_per_folder=10`,
+        `  ${binName} status --json`,
+    ].join("\n");
+}
+export function versionText(version) {
+    return `unity-open-mcp ${version}`;
+}
+export { DEFAULT_WAIT_TIMEOUT_MS, DEFAULT_POLL_INTERVAL_MS, };
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

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

package/dist/cli/ping-poller.d.ts

@@ -0,0 +1,81 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { LiveClient } from "../live-client.js";
+/** Poll outcome. `ready` true ⇒ exit 0; false ⇒ the caller exits non-zero. */
+export interface PollOutcome {
+    ready: boolean;
+    /** One of: ready | compiling | offline | dead_bridge | timeout. */
+    status: "ready" | "compiling" | "offline" | "dead_bridge" | "timeout";
+    /** Last /ping body captured (when one ever succeeded). */
+    lastPing: PingBody | null;
+    /** Human-friendly reason for the outcome; shown in non-JSON mode. */
+    reason: string;
+    /** Elapsed wall time of the poll, in ms. */
+    elapsedMs: number;
+}
+/** Subset of /ping the poller cares about. Mirrors the bridge contract. */
+export interface PingBody {
+    connected?: boolean;
+    compiling?: boolean;
+    isPlaying?: boolean;
+    projectPath?: string | null;
+    unityVersion?: string | null;
+    bridgeVersion?: string;
+    mode?: string;
+}
+export declare const DEFAULT_WAIT_TIMEOUT_MS = 120000;
+export declare const DEFAULT_POLL_INTERVAL_MS = 1000;
+export declare const PING_FETCH_TIMEOUT_MS = 5000;
+export interface PollOptions {
+    /** Total budget for the wait, in ms. */
+    timeoutMs: number;
+    /** Sleep between polls, in ms. */
+    intervalMs: number;
+    /** Per-fetch timeout forwarded to the LiveClient, in ms. */
+    fetchTimeoutMs?: number;
+    /** Wall clock used for deadline checks; injectable for tests. */
+    now?: () => number;
+    /** Sleep implementation; injectable for tests. Default: setTimeout. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Poll the bridge until it is ready (connected, not compiling) or the deadline
+ * passes. A 503 from /ping and `compiling: true` both keep the wait alive —
+ * "ready" means usable, not just listening. The poll fails fast on a
+ * dead-bridge signature (live PID, stale heartbeat) because /ping will never
+ * recover in that state.
+ *
+ * @param live           LiveClient pointed at the resolved bridge port.
+ * @param projectPath    Project path, used to read the instance lock for
+ *                       dead-bridge classification. Optional; when absent the
+ *                       dead-bridge shortcut is skipped.
+ * @param singlePoll     One /ping attempt. Returns `{ ok, status, body }`:
+ *                       `ok` true only when connected AND not compiling.
+ *                       Indirected so tests can stub the network hop.
+ * @param opts           Timing + clock injection.
+ */
+export declare function pollUntilReady(live: LiveClient, projectPath: string | undefined, singlePoll: (live: LiveClient) => Promise<SinglePollResult>, opts: PollOptions): Promise<PollOutcome>;
+export interface SinglePollResult {
+    /** `ready` only when connected AND not compiling. */
+    status: "ready" | "compiling" | "offline" | "error";
+    body: PingBody | null;
+}
+/**
+ * Single /ping attempt translated into a poll status. Centralizes the
+ * "connected AND not compiling" readiness rule so every command agrees on it.
+ *
+ * Implementation note: this calls `live.isLiveAvailable()` first to get the
+ * ping-cache population side effect + 503/compiling handling, then falls back
+ * to a direct route of `unity_open_mcp_ping`. The LiveClient's ping handler
+ * already returns the full body; we re-read it from the ping cache so a single
+ * network round-trip answers both "is it up?" and "what's its state?".
+ */
+export declare function singlePing(live: LiveClient, fetchTimeoutMs?: number): Promise<SinglePollResult>;
+/** Extract the typed ping body from a CallToolResult's first text content. */
+export declare function extractPingBody(result: {
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+}): PingBody | null;
+/** Re-exported for command code that needs to render a CallToolResult. */
+export type { CallToolResult };