pmx-canvas 0.7.3 → 0.8.0

package/.github/extensions/pmx-canvas/THIRD_PARTY_LICENSES.txt

@@ -0,0 +1,331 @@
+@modelcontextprotocol/sdk@1.28.0
+
+MIT License
+
+Copyright (c) 2024 Anthropic, PBC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+---
+
+ajv@8.18.0
+
+The MIT License (MIT)
+
+Copyright (c) 2015-2021 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+
+---
+
+ajv-formats@3.0.1
+
+MIT License
+
+Copyright (c) 2020 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+---
+
+cross-spawn@7.0.6
+
+The MIT License (MIT)
+
+Copyright (c) 2018 Made With MOXY Lda <hello@moxy.studio>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
+---
+
+fast-deep-equal@3.1.3
+
+MIT License
+
+Copyright (c) 2017 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+---
+
+fast-uri@3.1.0
+
+Copyright (c) 2011-2021, Gary Court until https://github.com/garycourt/uri-js/commit/a1acf730b4bba3f1097c9f52e7d9d3aba8cdcaae
+Copyright (c) 2021-present The Fastify team
+All rights reserved.
+
+The Fastify team members are listed at https://github.com/fastify/fastify#team.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * The names of any contributors may not be used to endorse or promote
+      products derived from this software without specific prior written
+      permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+                                  *   *   *
+
+The complete list of contributors can be found at:
+- https://github.com/garycourt/uri-js/graphs/contributors
+
+---
+
+isexe@2.0.0
+
+The ISC License
+
+Copyright (c) Isaac Z. Schlueter and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+---
+
+json-schema-traverse@1.0.0
+
+MIT License
+
+Copyright (c) 2017 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+---
+
+path-key@3.1.1
+
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+---
+
+shebang-command@2.0.0
+
+MIT License
+
+Copyright (c) Kevin Mårtensson <kevinmartensson@gmail.com> (github.com/kevva)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+---
+
+shebang-regex@3.0.0
+
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+---
+
+which@2.0.2
+
+The ISC License
+
+Copyright (c) Isaac Z. Schlueter and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+---
+
+zod@4.3.6
+
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+---
+
+zod-to-json-schema@3.25.1
+
+ISC License
+
+Copyright (c) 2020, Stefan Terdell
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/.github/extensions/pmx-canvas/extension.mjs

@@ -1,63 +1,28 @@
-import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { createServer as createHttpServer } from "node:http";
-import { createServer as createNetServer } from "node:net";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { CanvasError, createCanvas, joinSession } from "@github/copilot-sdk/extension";
 import { createSteeringDeliveryPump } from "./steering-delivery.mjs";
+import { canonicalWorkspace, ensurePmxServer, explicitServerUrl, findPmxServer, preferredPort, runtimeCommand } from "./runtime.mjs";
 
 const EXTENSION_DIR = dirname(fileURLToPath(import.meta.url));
 const PROJECT_ROOT = resolve(EXTENSION_DIR, "../../..");
-const DEFAULT_PORT = 4313;
 const MAX_AX_CONTEXT_CHARS = 16_000;
-const MANAGED_START_TIMEOUT_MS = 10_000;
 const HEALTH_TIMEOUT_MS = 500;
 const STEERING_WAIT_MS = 30_000;
 
 let copilotSession;
 let steeringDeliveryPump;
-let managedProcess = null;
-let managedBaseUrl = null;
-let managedWorkspaceRoot = null;
-let managedPort = null;
-const managedLogs = [];
+let sessionWorkspaceRoot = resolve(process.env.PMX_CANVAS_WORKSPACE_ROOT || process.cwd());
 const panelServers = new Map();
 // Canvas actions are invoked separately from `open`, and their context can
 // omit the canvas input. Keep the server selected for each visible instance so
 // an action cannot fall back to the process/default port behind the panel.
 const panelTargets = new Map();
 
-function normalizeBaseUrl(value) {
-    if (typeof value !== "string" || value.trim() === "") return null;
-    try {
-        const url = new URL(value.trim());
-        if (url.protocol !== "http:" && url.protocol !== "https:") return null;
-        url.pathname = url.pathname.replace(/\/$/, "");
-        url.search = "";
-        url.hash = "";
-        return url.toString().replace(/\/$/, "");
-    } catch {
-        return null;
-    }
-}
-
-function normalizePort(value) {
-    if (typeof value !== "string" && typeof value !== "number") return null;
-    const parsed = Number(value);
-    if (!Number.isFinite(parsed) || parsed <= 0) return null;
-    return Math.floor(parsed);
-}
-
-function preferredPort(input) {
-    return normalizePort(input?.port) ??
-        normalizePort(process.env.PMX_CANVAS_PORT) ??
-        normalizePort(process.env.PMX_WEB_CANVAS_PORT) ??
-        DEFAULT_PORT;
-}
-
 function candidateBaseUrls(input) {
-    const explicit = normalizeBaseUrl(input?.serverUrl) ?? normalizeBaseUrl(process.env.PMX_CANVAS_URL);
+    const explicit = explicitServerUrl(input);
     if (explicit) return [{ baseUrl: explicit, explicit: true }];
 
     const port = preferredPort(input);
@@ -70,13 +35,12 @@ function candidateBaseUrls(input) {
 function workspaceRootFrom(ctxOrInput) {
     const inputWorkspace = typeof ctxOrInput?.input?.workspaceRoot === "string" ? ctxOrInput.input.workspaceRoot : null;
     const sessionWorkspace = typeof ctxOrInput?.session?.workingDirectory === "string" ? ctxOrInput.session.workingDirectory : null;
-    const currentWorkspace = typeof copilotSession?.workspacePath === "string" ? copilotSession.workspacePath : null;
-    return resolve(inputWorkspace ?? sessionWorkspace ?? currentWorkspace ?? PROJECT_ROOT);
+    return resolve(inputWorkspace ?? sessionWorkspace ?? sessionWorkspaceRoot);
 }
 
 function workspaceMatches(health, workspaceRoot) {
     if (!health || typeof health.workspace !== "string") return false;
-    return resolve(health.workspace) === resolve(workspaceRoot);
+    return canonicalWorkspace(health.workspace) === canonicalWorkspace(workspaceRoot);
 }
 
 function delay(ms) {
@@ -116,137 +80,24 @@ async function probeServer(baseUrl, workspaceRoot, options = {}) {
     }
 }
 
-async function isPortAvailable(port) {
-    return await new Promise((resolveAvailable) => {
-        const server = createNetServer();
-        server.once("error", () => resolveAvailable(false));
-        server.once("listening", () => {
-            server.close(() => resolveAvailable(true));
-        });
-        server.listen(port, "127.0.0.1");
-    });
-}
-
-async function pickManagedPort(startPort) {
-    for (let port = startPort; port < startPort + 20; port += 1) {
-        if (await isPortAvailable(port)) return port;
-    }
-    throw new Error(`No available PMX Canvas port found near ${startPort}`);
-}
-
-function captureManagedLog(chunk) {
-    const text = chunk.toString("utf8").trim();
-    if (!text) return;
-    managedLogs.push(text);
-    while (managedLogs.length > 20) managedLogs.shift();
-}
-
-function stopManagedServer() {
-    if (managedProcess && managedProcess.exitCode === null && !managedProcess.killed) {
-        managedProcess.kill("SIGTERM");
-    }
-    managedProcess = null;
-    managedBaseUrl = null;
-    managedWorkspaceRoot = null;
-    managedPort = null;
-}
-
-function managedCommand(workspaceRoot, port) {
+function managedCommand(workspaceRoot) {
     const sourceEntry = resolve(workspaceRoot, "src/cli/index.ts");
-    const localBin = resolve(workspaceRoot, "node_modules/.bin/pmx-canvas");
-    if (existsSync(sourceEntry)) {
+    if (workspaceRoot === PROJECT_ROOT && existsSync(sourceEntry)) {
         return {
             command: "bun",
-            args: ["run", "src/cli/index.ts", "--no-open", `--port=${port}`],
-        };
-    }
-    if (existsSync(localBin)) {
-        return {
-            command: localBin,
-            args: ["--no-open", `--port=${port}`],
+            args: ["run", sourceEntry],
         };
     }
-    return {
-        command: "pmx-canvas",
-        args: ["--no-open", `--port=${port}`],
-    };
-}
-
-async function startManagedServer(workspaceRoot, input) {
-    if (managedProcess && managedBaseUrl && managedWorkspaceRoot === workspaceRoot) {
-        const probe = await probeServer(managedBaseUrl, workspaceRoot, { allowWorkspaceMismatch: false });
-        if (probe.ok) return probe;
-    }
-
-    stopManagedServer();
-    const port = await pickManagedPort(preferredPort(input));
-    const baseUrl = `http://127.0.0.1:${port}`;
-    const managed = managedCommand(workspaceRoot, port);
-    let managedError = null;
-    managedLogs.length = 0;
-    managedProcess = spawn(managed.command, managed.args, {
-        cwd: workspaceRoot,
-        env: {
-            ...process.env,
-            PMX_CANVAS_DISABLE_BROWSER_OPEN: "1",
-            PMX_WEB_CANVAS_PORT: String(port),
-        },
-        stdio: ["ignore", "pipe", "pipe"],
-    });
-    managedBaseUrl = baseUrl;
-    managedWorkspaceRoot = workspaceRoot;
-    managedPort = port;
-    managedProcess.stdout?.on("data", captureManagedLog);
-    managedProcess.stderr?.on("data", captureManagedLog);
-    managedProcess.once("error", (error) => {
-        managedError = error;
-        captureManagedLog(Buffer.from(error.message));
-    });
-    managedProcess.once("exit", () => {
-        managedProcess = null;
-        managedBaseUrl = null;
-        managedWorkspaceRoot = null;
-        managedPort = null;
-    });
-
-    const startedAt = Date.now();
-    while (Date.now() - startedAt < MANAGED_START_TIMEOUT_MS) {
-        const probe = await probeServer(baseUrl, workspaceRoot, {
-            allowWorkspaceMismatch: false,
-            timeoutMs: HEALTH_TIMEOUT_MS,
-        });
-        if (probe.ok) return probe;
-        if (managedError) throw managedError;
-        if (!managedProcess || managedProcess.exitCode !== null) break;
-        await delay(250);
-    }
-
-    const tail = managedLogs.slice(-4).join("\n");
-    throw new Error(`PMX Canvas did not become healthy on port ${port}.${tail ? `\n${tail}` : ""}`);
+    return runtimeCommand();
 }
 
 async function resolvePmxServer(ctxOrInput, options = {}) {
     const workspaceRoot = workspaceRootFrom(ctxOrInput);
     const input = ctxOrInput?.input ?? ctxOrInput ?? {};
-    const allowWorkspaceMismatch = input?.allowWorkspaceMismatch === true;
-    for (const candidate of candidateBaseUrls(input)) {
-        const probe = await probeServer(candidate.baseUrl, workspaceRoot, {
-            allowWorkspaceMismatch,
-        });
-        if (probe.ok) return probe;
-    }
-
     if (options.autoStart === false || input?.autoStart === false) {
-        return {
-            ok: false,
-            baseUrl: null,
-            health: null,
-            workspaceOk: false,
-            error: "No matching PMX Canvas server is running.",
-        };
+        return await findPmxServer(workspaceRoot, input);
     }
-
-    return await startManagedServer(workspaceRoot, input);
+    return await ensurePmxServer(workspaceRoot, input, managedCommand(workspaceRoot));
 }
 
 async function resolvePanelTarget(ctx, options = {}) {
@@ -372,7 +223,7 @@ function renderShell(entry) {
           if (response.ok && target.ok && target.baseUrl) {
             // Load the real workbench at its own origin, including its token,
             // Home, boards, and relative API paths. The shell is not a proxy.
-            window.location.replace(target.baseUrl + '/workbench?theme=light');
+            window.location.replace(target.baseUrl + '/workbench?theme=daylight');
             return;
           }
           status.textContent = target.error || 'No matching PMX Canvas server is running.';
@@ -627,7 +478,7 @@ async function postPresence(workspaceRoot, payload, options = {}) {
 async function getCopilotPresence() {
     try {
         const resolved = await resolvePmxServer(
-            { input: {}, session: { workingDirectory: PROJECT_ROOT } },
+            { input: {}, session: { workingDirectory: sessionWorkspaceRoot } },
             { autoStart: false },
         );
         if (!resolved.ok || !resolved.baseUrl) return null;
@@ -652,7 +503,7 @@ function recordCopilotSteering(ctx, message) {
 }
 
 async function claimCopilotSteering(consumer) {
-    const workspaceRoot = PROJECT_ROOT;
+    const workspaceRoot = sessionWorkspaceRoot;
     const resolved = await resolvePmxServer(
         { input: {}, session: { workingDirectory: workspaceRoot } },
         { autoStart: false },
@@ -669,7 +520,7 @@ async function claimCopilotSteering(consumer) {
 }
 
 async function markCopilotSteering(id, consumer) {
-    const workspaceRoot = PROJECT_ROOT;
+    const workspaceRoot = sessionWorkspaceRoot;
     const resolved = await resolvePmxServer(
         { input: {}, session: { workingDirectory: workspaceRoot } },
         { autoStart: false },
@@ -962,7 +813,7 @@ const pmxCanvas = createCanvas({
             return {
                 title: "PMX Canvas",
                 status: "Connected",
-                url: `${pmx.baseUrl}/workbench?theme=light`,
+                url: `${pmx.baseUrl}/workbench?theme=daylight`,
             };
         }
 
@@ -995,7 +846,8 @@ copilotSession = await joinSession({
     canvases: [pmxCanvas],
     hooks: {
         onUserPromptSubmitted: async (input) => {
-            const workspaceRoot = resolve(input?.workingDirectory ?? copilotSession?.workspacePath ?? PROJECT_ROOT);
+            const workspaceRoot = resolve(input?.workingDirectory ?? sessionWorkspaceRoot);
+            sessionWorkspaceRoot = workspaceRoot;
             // A submitted prompt means the agent is about to think: attach (idempotent)
             // and flip the phase. The agent's subsequent canvas writes reach the server
             // as MCP/HTTP tool calls and are attributed to this session.
@@ -1010,13 +862,15 @@ copilotSession = await joinSession({
     },
 });
 
+sessionWorkspaceRoot = resolve((await copilotSession.rpc.metadata.snapshot()).workingDirectory);
+
 steeringDeliveryPump = createSteeringDeliveryPump({
     consumer: "copilot",
     claim: claimCopilotSteering,
     send: async (message) => await copilotSession.send({ prompt: message }),
     mark: markCopilotSteering,
     getPresence: getCopilotPresence,
-    setPresence: async (patch) => await postPresence(PROJECT_ROOT, patch),
+    setPresence: async (patch) => await postPresence(sessionWorkspaceRoot, patch),
     shouldSend: (() => {
         const startedAt = Date.now();
         return (steering) => Date.parse(steering.createdAt) >= startedAt;
@@ -1028,7 +882,7 @@ void steeringDeliveryPump.start();
 
 // Attach the session as soon as the host joins (the canvas may not be running
 // yet — the prompt hook above re-attaches lazily in that case).
-void postPresence(resolve(copilotSession?.workspacePath ?? PROJECT_ROOT), { attached: true });
+void postPresence(sessionWorkspaceRoot, { attached: true });
 
 // Real context window (rail-chrome-v2): Copilot emits `session.usage_info`
 // with the live token count and the model's window after each turn. Report it
@@ -1049,7 +903,7 @@ function reportContextUsage(event) {
         usageFlush = null;
         const usage = pendingUsage;
         pendingUsage = null;
-        if (usage) void postPresence(resolve(copilotSession?.workspacePath ?? PROJECT_ROOT), { contextUsage: usage });
+        if (usage) void postPresence(sessionWorkspaceRoot, { contextUsage: usage });
     }, 500);
 }
 if (typeof copilotSession?.on === "function") {
@@ -1063,14 +917,13 @@ if (typeof copilotSession?.on === "function") {
 async function shutdown() {
     steeringDeliveryPump?.stop();
     // Detach the presence first so the canvas returns to the quiet board the
-    // moment the host goes away, then stop any managed server. The whole
+    // moment the host goes away. The shared daemon belongs to the workspace. The whole
     // detach is capped at 800ms (server probing + the POST) so a host with a
     // short SIGTERM grace window can never be held past it.
     await Promise.race([
-        postPresence(resolve(copilotSession?.workspacePath ?? PROJECT_ROOT), { attached: false }, { timeoutMs: 500 }),
+        postPresence(sessionWorkspaceRoot, { attached: false }, { timeoutMs: 500 }),
         delay(800),
     ]);
-    stopManagedServer();
     process.exit(0);
 }
 process.once("SIGTERM", () => void shutdown());