unity-open-mcp 1.2.3 → 1.3.0

package/dist/instance-discovery.js

@@ -144,6 +144,51 @@ export function readInstanceLock(projectPath) {
         return null;
     }
 }
+/**
+ * The instance lock whose bridge claims `port`, scanning every lock in
+ * {@link instancesDir}. A per-request port override names a bridge, not a
+ * project, so this is how the server learns which Editor (and therefore which
+ * lock) the override targets. A lock with a live PID wins; otherwise the most
+ * recently heartbeated stale claim is returned so the caller classifies it as
+ * "gone" exactly like a stale lock found by project path. Locks whose
+ * `projectPath` does not hash to their own file name are skipped — re-reading
+ * them by project path would land on a different file. Returns null when no
+ * lock claims the port. Never throws.
+ *
+ * @param port  bridge port to match against each lock's `port`
+ * @param dir   lock directory (injectable for tests). Defaults to
+ *              {@link instancesDir}.
+ */
+export function findInstanceLockByPort(port, dir = instancesDir()) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    let stale = null;
+    for (const entry of entries) {
+        if (!entry.endsWith(".json"))
+            continue;
+        let lock;
+        try {
+            lock = JSON.parse(readFileSync(join(dir, entry), "utf8"));
+        }
+        catch {
+            continue;
+        }
+        if (!lock || lock.port !== port || typeof lock.projectPath !== "string" || !lock.projectPath)
+            continue;
+        if (`${projectHash(lock.projectPath)}.json` !== entry)
+            continue;
+        if (isPidAlive(lock.pid))
+            return lock;
+        if (!stale || heartbeatAgeMs(lock) < heartbeatAgeMs(stale))
+            stale = lock;
+    }
+    return stale;
+}
 /**
  * kill -0 equivalent. Returns true if a process with the given pid exists.
  * Wrapped in try/catch: EPERM (exists but can't be probed) → true,

package/dist/instance-discovery.js.map

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

package/dist/jobs/adapters.d.ts

@@ -0,0 +1,15 @@
+import { type LiveClient } from "../live-client.js";
+import { type JobOperation, type JobOwner } from "./job-manager.js";
+type ClientFor = (owner: JobOwner) => LiveClient;
+export declare function testRunOperation(client: ClientFor): JobOperation;
+/** Bound the bridge status poll so a hung async command cannot own the project queue forever. */
+export declare const PROJECT_JOB_DEFAULT_DEADLINE_MS: number;
+/** How long the bridge may leave status polls unanswered before the job's outcome counts as unknown. */
+export declare const PROJECT_JOB_DEFAULT_UNREACHABLE_MS: number;
+export interface ProjectJobPollOptions {
+    deadlineMs?: number;
+    pollIntervalMs?: number;
+    unreachableMs?: number;
+}
+export declare function projectCommandOperation(id: string, cancellable: boolean, client: ClientFor, poll?: ProjectJobPollOptions): JobOperation;
+export {};

package/dist/jobs/adapters.js

@@ -0,0 +1,147 @@
+import { setTimeout as delay } from "node:timers/promises";
+import { ProjectJobHttpError } from "../live-client.js";
+import { validateSchema } from "../tool-contract.js";
+import { runTests } from "../tools/run-tests.js";
+import { JobManagerError } from "./job-manager.js";
+function invalid(errors) {
+    if (errors.length)
+        throw new JobManagerError("invalid_arguments", errors.join("; "));
+}
+export function testRunOperation(client) {
+    return {
+        // A test run has side effects even though the legacy tool is classified as a sense.
+        mutating: true, cancellable: false,
+        validate(args) {
+            invalid(validateSchema(args, runTests.inputSchema));
+            if (args.run_id !== undefined)
+                throw new JobManagerError("invalid_arguments", "Jobs own run_id; use idempotency_key to retry.");
+        },
+        async run(args, context) {
+            context.report({ phase: "starting test run" });
+            const response = await client(context.owner).runTestsJob({ ...args, run_id: context.jobId, timeout_ms: args.timeout_ms ?? 600000 }, () => {
+                context.lifecycle("connected", `Test results owned by run id ${context.jobId}`, true);
+                context.report({ phase: "awaiting test result file" });
+            });
+            const text = response.content.find(item => item.type === "text");
+            const result = text?.type === "text" ? JSON.parse(text.text) : {};
+            if (result.error?.code === "test_results_timeout" || result.error?.code === "timeout") {
+                context.lifecycle("disconnected", "Test result observation budget expired; run may still be executing.", false);
+            }
+            if (response.isError || result.status === "aborted" || result.summary?.failed > 0)
+                return { state: "failed", error: { code: result.error?.code ?? "test_run_failed", message: result.error?.message ?? "Test run did not pass." }, result };
+            if (result.status !== "completed" || result.runId !== context.jobId || !result.summary)
+                throw new Error("Test result did not confirm terminal ownership.");
+            context.report({ phase: "test results received" });
+            return { state: "succeeded", result };
+        },
+    };
+}
+/** Bound the bridge status poll so a hung async command cannot own the project queue forever. */
+export const PROJECT_JOB_DEFAULT_DEADLINE_MS = 30 * 60_000;
+/** How long the bridge may leave status polls unanswered before the job's outcome counts as unknown. */
+export const PROJECT_JOB_DEFAULT_UNREACHABLE_MS = 5 * 60_000;
+export function projectCommandOperation(id, cancellable, client, poll = {}) {
+    const deadlineMs = poll.deadlineMs ?? PROJECT_JOB_DEFAULT_DEADLINE_MS;
+    const pollIntervalMs = poll.pollIntervalMs ?? 500;
+    const unreachableMs = poll.unreachableMs ?? PROJECT_JOB_DEFAULT_UNREACHABLE_MS;
+    return {
+        mutating: true, cancellable,
+        validate(args) {
+            const allowed = ["args", "schema_version", "paths_hint", "gate", "ignore_scene_dirty", "confirm_bypass"];
+            invalid(Object.keys(args).filter(key => !allowed.includes(key)).map(key => `Unknown project job option: ${key}`));
+        },
+        async run(args, context) {
+            const live = client(context.owner);
+            context.report({ phase: "preflight" });
+            const catalog = await live.projectCommands({ action: "describe", id });
+            const command = catalog.command;
+            if (!command?.available || !command.async || command.cancellable !== cancellable)
+                return { state: "failed", error: { code: "command_unavailable", message: "Describe the command again; async contract is unavailable or changed." } };
+            const errors = validateSchema(args.args ?? {}, command.inputSchema);
+            if (errors.length)
+                return { state: "failed", error: { code: "invalid_arguments", message: errors.join("; ") } };
+            let response = await live.projectCommandJob({ action: "start", job_id: context.jobId,
+                invocation: { ...args, action: "invoke", command_id: id, schema_version: args.schema_version ?? command.schemaVersion } });
+            let cancelSent = false;
+            let phase;
+            let ownershipConfirmed = false;
+            const startedAt = Date.now();
+            while (true) {
+                if (response.error || response.mutation?.success === false) {
+                    if (response.error?.code === "job_not_found")
+                        context.lifecycle("disconnected", "Bridge lost domain-local job ownership.", false);
+                    return { state: "failed", error: { code: response.error?.code ?? response.mutation?.error?.code ?? "command_rejected", message: response.error?.message ?? response.mutation?.error?.message ?? "Bridge rejected command." }, result: response };
+                }
+                if (response.job_id !== context.jobId)
+                    throw new Error("Bridge did not confirm job ownership");
+                if (!ownershipConfirmed) {
+                    context.lifecycle("connected", `Bridge owns job ${context.jobId}`, true);
+                    ownershipConfirmed = true;
+                }
+                if (phase !== response.phase) {
+                    phase = response.phase;
+                    context.report({ phase: response.phase });
+                }
+                if (response.state === "succeeded")
+                    return { state: "succeeded", result: response.result };
+                if (response.state === "cancelled")
+                    return { state: "cancelled", result: response.result };
+                if (response.state === "failed")
+                    return { state: "failed", error: { code: "command_failed", message: "See terminal gate/command result." }, result: response.result };
+                // A poll only observes work the bridge keeps running. A main thread busy
+                // past the bridge's dispatch timeout (an import, synchronous project code)
+                // answers HTTP 500 or not at all, so an unanswered poll is retried with
+                // backoff. A cancel is not resent: it may still be queued, and the status
+                // polls after it show whether it was acknowledged.
+                const answeredAt = Date.now();
+                let failures = 0;
+                while (true) {
+                    if (Date.now() - startedAt >= deadlineMs) {
+                        // The bridge never reported a terminal state. Ask it to stop when the
+                        // contract allows, then release this job's execution slot as orphaned:
+                        // the remote outcome is unknown, so a blind retry is not safe.
+                        if (cancellable && !cancelSent) {
+                            cancelSent = true;
+                            try {
+                                await live.projectCommandJob({ action: "cancel", job_id: context.jobId });
+                            }
+                            catch { /* best effort */ }
+                        }
+                        context.lifecycle("disconnected", `Bridge job reported no terminal state within ${deadlineMs} ms; outcome unknown.`, false);
+                        return { state: "failed", error: { code: "job_deadline_exceeded", message: `No terminal state within ${deadlineMs} ms.` }, result: response };
+                    }
+                    if (failures && Date.now() - answeredAt >= unreachableMs) {
+                        context.lifecycle("disconnected", `Bridge answered no job poll for ${unreachableMs} ms; outcome unknown.`, false);
+                        return { state: "failed", error: { code: "job_status_unavailable", message: `No job status within ${unreachableMs} ms.` }, result: response };
+                    }
+                    // The backoff yields to a cancel request: an abort while sleeping
+                    // ends the sleep so the cancel goes out now, not after the backoff.
+                    // Once the cancel has been sent the signal stays aborted, so the
+                    // remaining status polls sleep without it.
+                    try {
+                        await delay(pollIntervalMs * 2 ** Math.min(failures, 3), undefined, cancelSent ? undefined : { signal: context.signal });
+                    }
+                    catch { /* aborted: forward the cancel below */ }
+                    const action = context.signal.aborted && !cancelSent ? "cancel" : "status";
+                    if (action === "cancel")
+                        cancelSent = true;
+                    try {
+                        response = await live.projectCommandJob({ action, job_id: context.jobId });
+                        break;
+                    }
+                    catch (error) {
+                        // A 4xx is the bridge refusing the transport itself; retrying cannot help.
+                        if (error instanceof ProjectJobHttpError && error.status < 500)
+                            throw error;
+                        if (failures++ === 0) {
+                            // Ownership was confirmed by the last answer; the next answer reconfirms it.
+                            ownershipConfirmed = false;
+                            context.lifecycle("disconnected", `Job poll failed (${String(error).slice(0, 200)}); retrying while the bridge owns job ${context.jobId}.`, true);
+                        }
+                    }
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/jobs/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/jobs/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAmB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAoC,MAAM,kBAAkB,CAAC;AAGrF,SAAS,OAAO,CAAC,MAAgB;IAC/B,IAAI,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACvF,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,OAAO;QACL,oFAAoF;QACpF,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK;QAClC,QAAQ,CAAC,IAAI;YACX,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;YACpD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;gBAAE,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAAE,gDAAgD,CAAC,CAAC;QAClI,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO;YACrB,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,MAAM,EAAE,EAAE,GAAG,EAAE;gBACvI,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,gCAAgC,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;gBACtF,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC,CAAC;YACzD,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;YACjE,MAAM,MAAM,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,KAAK,sBAAsB,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;gBACtF,OAAO,CAAC,SAAS,CAAC,cAAc,EAAE,qEAAqE,EAAE,KAAK,CAAC,CAAC;YAClH,CAAC;YACD,IAAI,QAAQ,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC;gBAC/E,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,iBAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,wBAAwB,EAAE,EAAE,MAAM,EAAE,CAAC;YAC3J,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO;gBACpF,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YACnD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QACxC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,GAAG,MAAM,CAAC;AAC3D,wGAAwG;AACxG,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,GAAG,MAAM,CAAC;AAG7D,MAAM,UAAU,uBAAuB,CAAC,EAAU,EAAE,WAAoB,EAAE,MAAiB,EAAE,OAA8B,EAAE;IAC3H,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,+BAA+B,CAAC;IACtE,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,GAAG,CAAC;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,kCAAkC,CAAC;IAC/E,OAAO;QACL,QAAQ,EAAE,IAAI,EAAE,WAAW;QAC3B,QAAQ,CAAC,IAAI;YACX,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;YACzG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC,CAAC;QACpH,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO;YACrB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,OAAO,CAAC,OAA0C,CAAC;YACnE,IAAI,CAAC,OAAO,EAAE,SAAS,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,WAAW,KAAK,WAAW;gBAC9E,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,uEAAuE,EAAE,EAAE,CAAC;YACvJ,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;YACpE,IAAI,MAAM,CAAC,MAAM;gBAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YAChH,IAAI,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK;gBAClF,UAAU,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;YAC7H,IAAI,UAAU,GAAG,KAAK,CAAC;YACvB,IAAI,KAAyB,CAAC;YAC9B,IAAI,kBAAkB,GAAG,KAAK,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,OAAO,IAAI,EAAE,CAAC;gBACZ,IAAI,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,QAAQ,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;oBAC3D,IAAI,QAAQ,CAAC,KAAK,EAAE,IAAI,KAAK,eAAe;wBAAE,OAAO,CAAC,SAAS,CAAC,cAAc,EAAE,yCAAyC,EAAE,KAAK,CAAC,CAAC;oBAClI,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,IAAI,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,IAAI,kBAAkB,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,IAAI,0BAA0B,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;gBACnP,CAAC;gBACD,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;gBAC/F,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBACxB,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,mBAAmB,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;oBACzE,kBAAkB,GAAG,IAAI,CAAC;gBAC5B,CAAC;gBACD,IAAI,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;oBAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;oBAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBAAC,CAAC;gBACpG,IAAI,QAAQ,CAAC,KAAK,KAAK,WAAW;oBAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC3F,IAAI,QAAQ,CAAC,KAAK,KAAK,WAAW;oBAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC3F,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ;oBAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,mCAAmC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACtK,yEAAyE;gBACzE,2EAA2E;gBAC3E,wEAAwE;gBACxE,0EAA0E;gBAC1E,mDAAmD;gBACnD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC9B,IAAI,QAAQ,GAAG,CAAC,CAAC;gBACjB,OAAO,IAAI,EAAE,CAAC;oBACZ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,UAAU,EAAE,CAAC;wBACzC,sEAAsE;wBACtE,uEAAuE;wBACvE,+DAA+D;wBAC/D,IAAI,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;4BAC/B,UAAU,GAAG,IAAI,CAAC;4BAClB,IAAI,CAAC;gCAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;4BAAC,CAAC;4BAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;wBAChH,CAAC;wBACD,OAAO,CAAC,SAAS,CAAC,cAAc,EAAE,gDAAgD,UAAU,uBAAuB,EAAE,KAAK,CAAC,CAAC;wBAC5H,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,4BAA4B,UAAU,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;oBAChJ,CAAC;oBACD,IAAI,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,IAAI,aAAa,EAAE,CAAC;wBACzD,OAAO,CAAC,SAAS,CAAC,cAAc,EAAE,mCAAmC,aAAa,uBAAuB,EAAE,KAAK,CAAC,CAAC;wBAClH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,wBAAwB,aAAa,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;oBAChJ,CAAC;oBACD,kEAAkE;oBAClE,oEAAoE;oBACpE,iEAAiE;oBACjE,2CAA2C;oBAC3C,IAAI,CAAC;wBACH,MAAM,KAAK,CAAC,cAAc,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,SAAS,EAChE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;oBACzD,CAAC;oBAAC,MAAM,CAAC,CAAC,uCAAuC,CAAC,CAAC;oBACnD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;oBAC3E,IAAI,MAAM,KAAK,QAAQ;wBAAE,UAAU,GAAG,IAAI,CAAC;oBAC3C,IAAI,CAAC;wBACH,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;wBAC3E,MAAM;oBACR,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,2EAA2E;wBAC3E,IAAI,KAAK,YAAY,mBAAmB,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;4BAAE,MAAM,KAAK,CAAC;wBAC5E,IAAI,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;4BACrB,6EAA6E;4BAC7E,kBAAkB,GAAG,KAAK,CAAC;4BAC3B,OAAO,CAAC,SAAS,CAAC,cAAc,EAAE,oBAAoB,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,yCAAyC,OAAO,CAAC,KAAK,GAAG,EAAE,IAAI,CAAC,CAAC;wBACpJ,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/jobs/handler.d.ts

@@ -0,0 +1,3 @@
+import { JobManager, type JobOwner } from "./job-manager.js";
+/** Action-specific validation also applies when invoked outside the stdio server. */
+export declare function handleJobs(manager: JobManager, owner: JobOwner, args: Record<string, unknown>): Promise<unknown>;

package/dist/jobs/handler.js

@@ -0,0 +1,29 @@
+import { JobManagerError } from "./job-manager.js";
+/** Action-specific validation also applies when invoked outside the stdio server. */
+export async function handleJobs(manager, owner, args) {
+    const allowed = {
+        start: ["tool_or_command", "args", "idempotency_key"], status: ["job_id"],
+        wait: ["job_id", "timeout_ms"], cancel: ["job_id"], list: ["state", "operation", "cursor", "limit"],
+    };
+    const action = String(args.action);
+    if (!Object.hasOwn(allowed, action) || Object.keys(args).some(key => key !== "action" && !allowed[action].includes(key)))
+        throw new JobManagerError("invalid_arguments", "Use only arguments belonging to the selected jobs action.");
+    if (action === "start") {
+        if (typeof args.tool_or_command !== "string" || !args.tool_or_command.trim())
+            throw new JobManagerError("invalid_arguments", "start requires tool_or_command.");
+        return manager.start(owner, args.tool_or_command, (args.args ?? {}), args.idempotency_key);
+    }
+    if (action === "list")
+        return manager.list(owner, {
+            ...(args.state === undefined ? {} : { state: args.state }),
+            ...(args.operation === undefined ? {} : { operation: args.operation }),
+        }, args.cursor, args.limit);
+    if (typeof args.job_id !== "string" || !args.job_id.trim())
+        throw new JobManagerError("invalid_arguments", `${action} requires job_id.`);
+    if (action === "status")
+        return manager.status(owner, args.job_id);
+    if (action === "cancel")
+        return manager.cancel(owner, args.job_id);
+    return manager.wait(owner, args.job_id, args.timeout_ms);
+}
+//# sourceMappingURL=handler.js.map

package/dist/jobs/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/jobs/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,eAAe,EAAgC,MAAM,kBAAkB,CAAC;AAE7F,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAmB,EAAE,KAAe,EAAE,IAA6B;IAClG,MAAM,OAAO,GAA6B;QACxC,KAAK,EAAE,CAAC,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC;QACzE,IAAI,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC;KACpG,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtH,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAAE,2DAA2D,CAAC,CAAC;IAC9G,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,IAAI,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAAE,iCAAiC,CAAC,CAAC;QAChK,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAA4B,EAAE,IAAI,CAAC,eAAqC,CAAC,CAAC;IAC9I,CAAC;IACD,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE;YAChD,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAiB,EAAE,CAAC;YACtE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAmB,EAAE,CAAC;SACjF,EAAE,IAAI,CAAC,MAA4B,EAAE,IAAI,CAAC,KAA2B,CAAC,CAAC;IACxE,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAAE,GAAG,MAAM,mBAAmB,CAAC,CAAC;IACzI,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAgC,CAAC,CAAC;AACjF,CAAC"}

package/dist/jobs/job-manager.d.ts

@@ -0,0 +1,123 @@
+export declare const JOB_STATES: readonly ["queued", "running", "succeeded", "failed", "cancel_requested", "cancelled", "orphaned"];
+export type JobState = typeof JOB_STATES[number];
+export interface JobOwner {
+    project: string;
+    agent: string;
+    port?: number;
+}
+export interface JobError {
+    code: string;
+    message: string;
+}
+export type JobOutcome = {
+    state: "succeeded";
+    result: unknown;
+} | {
+    state: "failed";
+    error: JobError;
+    result?: unknown;
+} | {
+    state: "cancelled";
+    result?: unknown;
+};
+export interface JobContext {
+    jobId: string;
+    owner: JobOwner;
+    signal: AbortSignal;
+    report(progress: {
+        phase: string;
+        fraction?: number;
+    }): void;
+    /** Call on disconnect/reload. Only operation-specific ownership evidence permits continuation. */
+    lifecycle(state: "connected" | "reloading" | "disconnected", evidence: string, ownershipProven: boolean): void;
+}
+export interface JobOperation {
+    mutating: boolean;
+    cancellable: boolean;
+    /** Pure preflight. Execution must preserve the owning operation's scope/gate/validation contract. */
+    validate(args: Record<string, unknown>): void;
+    /** Must yield promptly; use callbacks/async transport, never a blocking main-thread operation. */
+    run(args: Record<string, unknown>, context: JobContext): Promise<JobOutcome>;
+}
+export interface JobSnapshot {
+    job_id: string;
+    operation: string;
+    owner: JobOwner;
+    state: JobState;
+    created_at: number;
+    updated_at: number;
+    started_at: number | null;
+    finished_at: number | null;
+    progress: {
+        phase: string;
+        fraction?: number;
+    } | null;
+    cancellable: boolean;
+    lifecycle: {
+        state: "not_started" | "connected" | "reloading" | "disconnected";
+        evidence: string | null;
+    };
+    events: Array<{
+        at: number;
+        kind: string;
+        detail: string;
+    }>;
+    result?: unknown;
+    error?: JobError;
+}
+export declare class JobManagerError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export interface JobManagerOptions {
+    maxJobs: number;
+    retentionMs: number;
+    maxConcurrent: number;
+    perProject: number;
+    perAgent: number;
+    maxEvents: number;
+    maxPayloadBytes: number;
+    maxWaiters: number;
+}
+/** Session-only owner. No replay, disk persistence, or automatic transport retries. */
+export declare class JobManager {
+    private readonly operations;
+    private readonly entries;
+    private readonly keys;
+    private sequence;
+    private readonly session;
+    private readonly options;
+    private readonly cleanupTimer;
+    private closed;
+    private readonly now;
+    constructor(options?: Partial<JobManagerOptions>, now?: () => number);
+    hasOperation(name: string): boolean;
+    /** Whether an owner's idempotency key already names a retained job, whose retried start needs no adapter resolution. */
+    hasKey(owner: JobOwner, key: string): boolean;
+    operation(name: string): JobOperation | undefined;
+    /** `replace` swaps an adapter whose bridge-side contract changed; jobs already running keep the operation they started with. */
+    register(name: string, operation: JobOperation, replace?: boolean): void;
+    private copy;
+    /** A terminal result above the payload limit is dropped, never allowed to turn a known outcome into an orphan. */
+    private boundedResult;
+    private event;
+    private transition;
+    private snapshot;
+    private scopedKey;
+    private find;
+    start(owner: JobOwner, name: string, args: Record<string, unknown>, key?: string): JobSnapshot;
+    status(owner: JobOwner, id: string): JobSnapshot;
+    wait(owner: JobOwner, id: string, timeoutMs?: number): Promise<JobSnapshot>;
+    cancel(owner: JobOwner, id: string): JobSnapshot;
+    list(owner: JobOwner, filters?: {
+        state?: JobState;
+        operation?: string;
+    }, cursor?: string, limit?: number): {
+        jobs: JobSnapshot[];
+        next_cursor: string | null;
+    };
+    cleanup(): void;
+    close(): void;
+    private pump;
+    private execute;
+}