unity-open-mcp 1.2.3 → 1.3.0

package/dist/jobs/job-manager.js

@@ -0,0 +1,290 @@
+import { randomUUID } from "node:crypto";
+export const JOB_STATES = ["queued", "running", "succeeded", "failed", "cancel_requested", "cancelled", "orphaned"];
+export class JobManagerError extends Error {
+    code;
+    constructor(code, message) { super(message); this.code = code; }
+}
+const terminal = (state) => ["succeeded", "failed", "cancelled", "orphaned"].includes(state);
+const sameProject = (a, b) => a.project === b.project && a.port === b.port;
+const sameOwner = (a, b) => sameProject(a, b) && a.agent === b.agent;
+function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(",")}]`;
+    if (value && typeof value === "object")
+        return `{${Object.keys(value).sort().map(k => `${JSON.stringify(k)}:${canonical(value[k])}`).join(",")}}`;
+    return JSON.stringify(value);
+}
+const defaults = {
+    maxJobs: 256, retentionMs: 30 * 60_000, maxConcurrent: 4, perProject: 1, perAgent: 1,
+    maxEvents: 32, maxPayloadBytes: 256 * 1024, maxWaiters: 128,
+};
+/** Session-only owner. No replay, disk persistence, or automatic transport retries. */
+export class JobManager {
+    operations = new Map();
+    entries = new Map();
+    keys = new Map();
+    sequence = 0;
+    session = randomUUID();
+    options;
+    cleanupTimer;
+    closed = false;
+    now;
+    constructor(options = {}, now = Date.now) {
+        this.now = now;
+        this.options = { ...defaults, ...options };
+        for (const value of Object.values(this.options))
+            if (!Number.isSafeInteger(value) || value < 1)
+                throw new Error("Job limits must be positive integers");
+        this.cleanupTimer = setInterval(() => this.cleanup(), Math.min(this.options.retentionMs, 60_000));
+        this.cleanupTimer.unref();
+    }
+    hasOperation(name) { return this.operations.has(name); }
+    /** Whether an owner's idempotency key already names a retained job, whose retried start needs no adapter resolution. */
+    hasKey(owner, key) {
+        this.cleanup();
+        return this.keys.has(this.scopedKey(owner, key));
+    }
+    operation(name) { return this.operations.get(name); }
+    /** `replace` swaps an adapter whose bridge-side contract changed; jobs already running keep the operation they started with. */
+    register(name, operation, replace = false) {
+        if (!replace && this.operations.has(name))
+            throw new Error(`Duplicate job operation: ${name}`);
+        this.operations.set(name, operation);
+    }
+    copy(value) {
+        const json = JSON.stringify(value);
+        if (json === undefined || Buffer.byteLength(json) > this.options.maxPayloadBytes)
+            throw new JobManagerError("job_payload_too_large", "Job payload exceeds the configured JSON byte limit.");
+        return JSON.parse(json);
+    }
+    /** A terminal result above the payload limit is dropped, never allowed to turn a known outcome into an orphan. */
+    boundedResult(value) {
+        if (value === undefined)
+            return undefined;
+        try {
+            return this.copy(value);
+        }
+        catch (error) {
+            if (!(error instanceof JobManagerError) || error.code !== "job_payload_too_large")
+                throw error;
+            return { truncated: true, code: error.code, message: `Result exceeded ${this.options.maxPayloadBytes} bytes and was not retained; the job state is authoritative.` };
+        }
+    }
+    event(entry, kind, detail) {
+        entry.view.updated_at = this.now();
+        entry.view.events.push({ at: entry.view.updated_at, kind, detail: detail.slice(0, 1024) });
+        entry.view.events = entry.view.events.slice(-this.options.maxEvents);
+    }
+    transition(entry, state) {
+        if (terminal(entry.view.state))
+            return;
+        entry.view.state = state;
+        this.event(entry, "state", state);
+        if (terminal(state)) {
+            entry.view.finished_at = this.now();
+            entry.args = {};
+            for (const wake of entry.waiters)
+                wake();
+            entry.waiters.clear();
+        }
+    }
+    snapshot(entry) { return structuredClone(entry.view); }
+    scopedKey(owner, key) { return JSON.stringify([owner.project, owner.port ?? null, owner.agent, key]); }
+    find(owner, id) {
+        this.cleanup();
+        const entry = this.entries.get(id);
+        if (!entry || !sameOwner(owner, entry.view.owner))
+            throw new JobManagerError("job_not_found", "Job is unknown, expired, or belongs to another project/agent.");
+        return entry;
+    }
+    start(owner, name, args, key) {
+        if (this.closed)
+            throw new JobManagerError("jobs_closed", "Job manager is closed.");
+        if (!owner.project || !owner.agent)
+            throw new JobManagerError("invalid_job_owner", "Project and agent identity are required.");
+        this.cleanup();
+        const safeArgs = this.copy(args);
+        const fingerprint = canonical({ name, args: safeArgs });
+        const scopedKey = key === undefined ? undefined : this.scopedKey(owner, key);
+        const existing = scopedKey === undefined ? undefined : this.keys.get(scopedKey);
+        if (existing) {
+            const entry = this.entries.get(existing);
+            if (entry.fingerprint !== fingerprint)
+                throw new JobManagerError("idempotency_conflict", "Key already identifies a different operation or arguments.");
+            return this.snapshot(entry);
+        }
+        const operation = this.operations.get(name);
+        if (!operation)
+            throw new JobManagerError("job_operation_unsupported", "Operation has no registered asynchronous job adapter.");
+        if ((operation.mutating || key !== undefined) && (!key?.trim() || key.length > 256))
+            throw new JobManagerError("idempotency_key_required", "Provide a nonempty idempotency_key of at most 256 characters.");
+        operation.validate(safeArgs);
+        // Never evict unexpired idempotency records to make room for new starts.
+        if (this.entries.size >= this.options.maxJobs)
+            throw new JobManagerError("job_capacity", "Job retention capacity reached; retry after terminal records expire.");
+        const at = this.now();
+        const entry = {
+            view: { job_id: randomUUID(), operation: name, owner: { ...owner }, state: "queued", created_at: at, updated_at: at,
+                started_at: null, finished_at: null, progress: null, cancellable: operation.cancellable,
+                lifecycle: { state: "not_started", evidence: null }, events: [] },
+            sequence: ++this.sequence, key: scopedKey, fingerprint, args: safeArgs, operation,
+            controller: new AbortController(), executing: false, waiters: new Set(),
+        };
+        this.entries.set(entry.view.job_id, entry);
+        if (scopedKey !== undefined)
+            this.keys.set(scopedKey, entry.view.job_id);
+        this.event(entry, "state", "queued");
+        // Scheduling is independent of the lifetime of start/wait MCP calls.
+        setImmediate(() => this.pump());
+        return this.snapshot(entry);
+    }
+    status(owner, id) { return this.snapshot(this.find(owner, id)); }
+    async wait(owner, id, timeoutMs = 10_000) {
+        if (!Number.isInteger(timeoutMs) || timeoutMs < 0 || timeoutMs > 30_000)
+            throw new JobManagerError("invalid_arguments", "wait timeout_ms must be between 0 and 30000.");
+        const entry = this.find(owner, id);
+        if (terminal(entry.view.state) || timeoutMs === 0)
+            return this.snapshot(entry);
+        const waiters = [...this.entries.values()].reduce((sum, e) => sum + e.waiters.size, 0);
+        if (waiters >= this.options.maxWaiters)
+            throw new JobManagerError("job_wait_capacity", "Too many concurrent observers.");
+        await new Promise(resolve => {
+            const wake = () => { clearTimeout(timer); entry.waiters.delete(wake); resolve(); };
+            const timer = setTimeout(wake, timeoutMs);
+            entry.waiters.add(wake);
+        });
+        return this.snapshot(entry);
+    }
+    cancel(owner, id) {
+        const entry = this.find(owner, id);
+        if (!entry.operation.cancellable)
+            throw new JobManagerError("not_cancellable", "Operation has no cooperative cancellation contract.");
+        if (terminal(entry.view.state) || entry.view.state === "cancel_requested")
+            return this.snapshot(entry);
+        if (entry.view.state === "queued")
+            this.transition(entry, "cancelled");
+        else {
+            this.transition(entry, "cancel_requested");
+            entry.controller.abort();
+        }
+        return this.snapshot(entry);
+    }
+    list(owner, filters = {}, cursor, limit = 20) {
+        this.cleanup();
+        if (!Number.isInteger(limit) || limit < 1 || limit > 100)
+            throw new JobManagerError("invalid_arguments", "limit must be 1..100.");
+        const binding = canonical({ owner, filters, session: this.session });
+        let after = 0, ceiling = this.sequence;
+        if (cursor) {
+            try {
+                const parsed = JSON.parse(Buffer.from(cursor, "base64url").toString());
+                if (parsed.binding !== binding || !Number.isSafeInteger(parsed.after) || !Number.isSafeInteger(parsed.ceiling) || parsed.after < 0 || parsed.ceiling < parsed.after || parsed.ceiling > this.sequence)
+                    throw new Error();
+                after = parsed.after;
+                ceiling = parsed.ceiling;
+            }
+            catch {
+                throw new JobManagerError("invalid_cursor", "Cursor does not match this owner/filter or server session.");
+            }
+        }
+        const matches = [...this.entries.values()].filter(e => sameOwner(owner, e.view.owner) && e.sequence > after && e.sequence <= ceiling
+            && (!filters.state || e.view.state === filters.state) && (!filters.operation || e.view.operation === filters.operation));
+        const page = matches.slice(0, limit);
+        return { jobs: page.map(e => this.snapshot(e)), next_cursor: matches.length > limit
+                ? Buffer.from(JSON.stringify({ binding, after: page.at(-1).sequence, ceiling })).toString("base64url") : null };
+    }
+    cleanup() {
+        for (const [id, entry] of this.entries) {
+            if (!entry.executing && entry.view.finished_at !== null && this.now() - entry.view.finished_at >= this.options.retentionMs) {
+                this.entries.delete(id);
+                if (entry.key !== undefined)
+                    this.keys.delete(entry.key);
+            }
+        }
+    }
+    close() {
+        this.closed = true;
+        clearInterval(this.cleanupTimer);
+        for (const entry of this.entries.values())
+            if (!terminal(entry.view.state)) {
+                entry.view.error = { code: "job_owner_lost", message: "Server job manager closed; execution outcome is unknown." };
+                this.transition(entry, "orphaned");
+            }
+    }
+    pump() {
+        if (this.closed)
+            return;
+        for (const entry of this.entries.values()) {
+            if (entry.view.state !== "queued")
+                continue;
+            const active = [...this.entries.values()].filter(e => e.executing);
+            if (active.length >= this.options.maxConcurrent)
+                break;
+            if (active.filter(e => sameProject(e.view.owner, entry.view.owner)).length >= this.options.perProject ||
+                active.filter(e => sameOwner(e.view.owner, entry.view.owner)).length >= this.options.perAgent)
+                continue;
+            entry.executing = true;
+            entry.view.started_at = this.now();
+            this.transition(entry, "running");
+            void this.execute(entry);
+        }
+    }
+    async execute(entry) {
+        const context = {
+            jobId: entry.view.job_id, owner: { ...entry.view.owner }, signal: entry.controller.signal,
+            report: progress => {
+                if (terminal(entry.view.state))
+                    return;
+                if (typeof progress.phase !== "string" || (progress.fraction !== undefined && (!Number.isFinite(progress.fraction) || progress.fraction < 0 || progress.fraction > 1)))
+                    throw new JobManagerError("invalid_progress", "Progress requires a phase and optional fraction in [0,1].");
+                entry.view.progress = { phase: progress.phase.slice(0, 1024),
+                    ...(progress.fraction === undefined ? {} : { fraction: progress.fraction }) };
+                this.event(entry, "progress", progress.phase);
+            },
+            lifecycle: (state, evidence, ownershipProven) => {
+                if (terminal(entry.view.state))
+                    return;
+                entry.view.lifecycle = { state, evidence: evidence.slice(0, 1024) };
+                this.event(entry, "lifecycle", `${state}: ${evidence}`);
+                if (!ownershipProven || !evidence.trim()) {
+                    entry.view.error = { code: "job_owner_lost", message: "Operation ownership cannot be proven; do not blindly retry." };
+                    this.transition(entry, "orphaned");
+                }
+            },
+        };
+        try {
+            const outcome = await entry.operation.run(entry.args, context);
+            if (terminal(entry.view.state)) {
+                // The adapter orphaned the job through lifecycle() (or the manager
+                // closed) and only THEN returned: the terminal state stays
+                // authoritative, but the payload it came back with — e.g. the bridge's
+                // own timeout envelope with the run id — is the evidence an operator
+                // needs, so keep it instead of dropping it on the floor.
+                if ("result" in outcome && entry.view.result === undefined)
+                    entry.view.result = this.boundedResult(outcome.result);
+                if (outcome.state === "failed")
+                    this.event(entry, "adapter_outcome", `${outcome.error.code}: ${outcome.error.message}`);
+                return;
+            }
+            if ("result" in outcome)
+                entry.view.result = this.boundedResult(outcome.result);
+            if (outcome.state === "failed")
+                entry.view.error = this.copy(outcome.error);
+            else if (outcome.state !== "succeeded" && (outcome.state !== "cancelled" || !entry.operation.cancellable || !entry.controller.signal.aborted))
+                throw new Error("Invalid terminal outcome or cancellation without acknowledgement");
+            this.transition(entry, outcome.state);
+        }
+        catch (error) {
+            if (!terminal(entry.view.state)) {
+                // A thrown transport/runtime error does not prove that remote work failed.
+                entry.view.error = { code: "job_outcome_unknown", message: String(error).slice(0, 1024) };
+                this.transition(entry, "orphaned");
+            }
+        }
+        finally {
+            entry.executing = false;
+            this.pump();
+        }
+    }
+}
+//# sourceMappingURL=job-manager.js.map

package/dist/jobs/job-manager.js.map

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

package/dist/live-client.d.ts

@@ -1,6 +1,6 @@
 import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import type { Router } from "./router.js";
-import type { PingCache, PingSnapshot } from "./ping-cache.js";
+import { PingCache, type PingSnapshot } from "./ping-cache.js";
 import type { BridgeToolsInventory } from "./bridge-tools-cache.js";
 import { type PollAndDismissOptions } from "./dialog-dismiss.js";
 /**
@@ -33,6 +33,11 @@ import { type PollAndDismissOptions } from "./dialog-dismiss.js";
  * (TypeError).
  */
 export declare function shouldRetryPostAfterFailure(err: unknown, endpointChanged: boolean): boolean;
+/** `/project-command-jobs` answered without a job snapshot; `status` is its non-OK HTTP status. */
+export declare class ProjectJobHttpError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
 export declare class LiveClient implements Router {
     private baseUrl;
     private pingCache;
@@ -67,6 +72,8 @@ export declare class LiveClient implements Router {
     /** specs/feedback.md 2026-07-03 — opt-in for the "Unsaved changes to scene"
      *  modal (destructive under every policy, off by default). */
     private allowUnsavedSceneDismiss;
+    /** Explicit opt-in for continuing through a non-matching Editor warning. */
+    private allowVersionMismatch;
     /** M14 — per-session bearer token auto-discovered from the instance lock.
      *  Undefined when no live lock was found (older bridge / env port override);
      *  in that case no Authorization header is sent and the bridge must be in
@@ -97,6 +104,8 @@ export declare class LiveClient implements Router {
      *  the constructor used; without it a refresh would silently switch from an
      *  env-pinned port to the lock port. */
     private readonly envPort;
+    /** Memoized outcome of the bridge-vs-server project-path comparison. */
+    private projectMatch;
     constructor(port: number, pingCache: PingCache, authToken?: string, projectPath?: string, agentId?: string, envPort?: number);
     /**
      * Emit the server/bridge version-compatibility warning at most once per
@@ -104,6 +113,22 @@ export declare class LiveClient implements Router {
      * entirely by UNITY_OPEN_MCP_SKIP_VERSION_CHECK=1. See docs/versioning.md.
      */
     private maybeWarnCompat;
+    /** Bounded read-only main-thread snapshot; unavailable bridges fail open to logs. */
+    readCompileState(): Promise<Record<string, unknown> | null>;
+    /** The compile state that qualifies a tool result: the snapshot the bridge
+     *  took inside the call's own dispatch when the call asked for it
+     *  (COMPILE_STATE_HEADER), else a fresh read. An older bridge never attaches
+     *  one, and the bridge leaves it off once a compile ran during the call's
+     *  settle wait, so neither path can qualify a result with a state older
+     *  than the call. */
+    private compileStateFor;
+    /** A well-formed compile state reported for this client's project, else null. */
+    private acceptCompileState;
+    /** The bridge reports DirectoryInfo.FullName while the server holds a
+     *  path.resolve'd string; separators, drive-letter case and /private-style
+     *  symlinks can differ for the same project, and a strict compare would
+     *  silently disable live compile state. Compare canonical forms instead. */
+    private sameProject;
     isLiveAvailable(fetchTimeoutMs?: number): Promise<boolean>;
     /**
      * M14 — return the most recent cached /ping snapshot (any age), or null when
@@ -112,9 +137,28 @@ export declare class LiveClient implements Router {
      * "what's its state?" without a second `/ping` round-trip per poll.
      */
     getCachedPing(): PingSnapshot | null;
-    route(toolName: string, args: Record<string, unknown>): Promise<CallToolResult>;
+    route(toolName: string, args: Record<string, unknown>, commandLifecycle?: string): Promise<CallToolResult>;
     private handlePing;
     private handleToolCall;
+    /**
+     * Transient client for a per-request `_meta.port` override. The override
+     * names a bridge, not a project, so the client binds to the project whose
+     * instance lock claims that port: its lock-derived diagnostics
+     * (bridge_compile_failed, cold Safe Mode, the ping lockCheck, the offline
+     * hint) and its bearer token then describe the Editor actually called, not
+     * the configured project. With no claiming lock it binds to the configured
+     * project only when that project has no lock and the port is its
+     * deterministic one; otherwise it runs without a project, so a failure
+     * reports plain bridge_offline instead of another Editor's state. The port
+     * is passed as envPort: an explicit override never re-resolves from a lock.
+     * A private PingCache keeps the default bridge's readiness snapshot from
+     * short-circuiting this bridge's own /ping.
+     */
+    static forPortOverride(port: number, defaultProjectPath: string | undefined, agentId: string): LiveClient;
+    /** Preserve configured endpoint/auth when attaching an independent job owner. */
+    forAgent(agent: string): LiveClient;
+    /** Job-owned test start has no transport replay; poll the existing file handoff. */
+    runTestsJob(args: Record<string, unknown>, onStarted: () => void): Promise<CallToolResult>;
     private handleRunTests;
     private pollTestResults;
     /**
@@ -261,6 +305,10 @@ export declare class LiveClient implements Router {
      */
     protected runDismissLoop(opts: PollAndDismissOptions): Promise<void>;
     readResource(route: string): Promise<Record<string, unknown>>;
+    /** Private job transport: one bounded request, never an automatic mutation retry. */
+    projectCommandJob(args: Record<string, unknown>): Promise<Record<string, any>>;
+    /** Fresh authenticated bounded catalog read; no disk/session cache can hide a reload. */
+    projectCommands(args: Record<string, unknown>): Promise<Record<string, unknown>>;
     /**
      * M18 Plan 2 / T18.2.3 — fetch the compiled-state tool inventory from the
      * bridge (`GET /tools`). Returns the set of tool names the bridge compiled