vanspod 0.0.0-stage → 0.1.3

package/dist/codexWire/tool-guidance.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODE_MODE_HOST_CONTRACT_SENTENCE = exports.CODE_MODE_RESULT_ECHO_SENTENCE = void 0;
+exports.codexToolGuidance = codexToolGuidance;
+exports.appendToolInstructions = appendToolInstructions;
+exports.codeModeInputDescription = codeModeInputDescription;
+const types_1 = require("../adapters/types");
+// Tool prompt contracts aligned with opencodex 2.81.0 (19bd34a), adapted
+// to VansPod's reversible wire names. No runtime dependency on opencodex.
+exports.CODE_MODE_RESULT_ECHO_SENTENCE = "Nothing in the isolate is echoed automatically: a bare trailing `await tools.<name>(...)` or final expression value is DISCARDED, and the cell reports empty output. Pass anything you need to read to `text(...)` (or `notify(...)`) in the same cell — for example `text(JSON.stringify(await tools.exec_command({cmd: 'ls'})))` — and treat an empty result as your own missing `text(...)` call rather than a failed command or lost context.";
+exports.CODE_MODE_HOST_CONTRACT_SENTENCE = "Host contract for the nested helpers: `tools.apply_patch(patch)` takes exactly one string, never an object such as `{input: ...}`; the patch text opens with the bare marker line `*** Begin Patch` and closes with the bare marker line `*** End Patch`, written without a code fence, prose, or extra asterisks on those lines (blank lines or indentation around the markers are tolerated; a decorated or missing marker is rejected). The isolate has no `import`, `require`, or module loader; use the globals the exec tool description lists (for example `tools`, `text`, `notify`, `store`/`load`, `ALL_TOOLS`). For a command that may outlive `yield_time_ms`, let `tools.exec_command` return a `session_id` and poll it on later calls with `tools.write_stdin({session_id, chars: \"\"})` instead of blocking a shell in a sleep loop.";
+const NEIGHBOR_AGENT_TOOL_NAMES = ["Read", "Grep", "Glob", "Bash", "LS"];
+function quoteNames(names) { return names.map(name => "`" + name + "`").join(", "); }
+function uniqueNames(names) { return [...new Set(names.filter(name => name.trim().length > 0))]; }
+function codeModeExecWireName(advertised, verifiedName) {
+    if (!verifiedName)
+        return undefined;
+    return advertised.has(verifiedName) ? verifiedName : undefined;
+}
+function buildToolCatalogNudge(wireNames, codeModeExecName) {
+    const names = uniqueNames(wireNames ?? []);
+    if (names.length === 0)
+        return undefined;
+    const advertised = new Set(names);
+    const unavailableNeighborNames = NEIGHBOR_AGENT_TOOL_NAMES.filter(name => !advertised.has(name));
+    const verifiedCodeModeExecName = codeModeExecWireName(advertised, codeModeExecName);
+    return [
+        "Tool contract: use the current tool catalog as ground truth.",
+        "Valid tool names for this turn are exactly " + quoteNames(names) + ".",
+        "These listed names are the complete top-level tool-call surface for this turn.",
+        "Call only listed names with their listed argument keys; do not invent, translate, or rename tools.",
+        "Names mentioned only in instructions, tool descriptions, argument descriptions, or nested helper APIs are not additional top-level tools.",
+        verifiedCodeModeExecName
+            ? "`" + verifiedCodeModeExecName + "` is Codex code mode: its body is JavaScript evaluated in a V8 isolate. Nested helpers are called INSIDE that body as `await tools.<name>(...)`, for example `await tools.exec_command({cmd: \"ls\"})` or `await tools.codex_app__list_threads({})`. Absence from the top-level catalog or from `" + verifiedCodeModeExecName + "`'s description is not absence: deferred helpers stay callable on `tools.<name>`. Discover them from the isolate global `ALL_TOOLS`, not `tools.ALL_TOOLS`. Do not skip an available nested helper because it is omitted from the listed top-level names. " + exports.CODE_MODE_RESULT_ECHO_SENTENCE + " Nested `tools.apply_patch(input)` is host-executed: the string must begin exactly with `*** Begin Patch` and end with `*** End Patch`, each marker line being three asterisks, one space, the two words, then end of line with no further asterisks. VansPod does not rewrite JavaScript inside exec, so extra asterisks on a marker line are rejected by Codex before the file is touched. " + exports.CODE_MODE_HOST_CONTRACT_SENTENCE
+            : "If a listed tool exposes nested helpers such as a tools.* API, call the listed parent tool and use those helpers only inside that tool's input.",
+        unavailableNeighborNames.length > 0
+            ? "Do not use neighboring-agent tool names " + quoteNames(unavailableNeighborNames) + " unless this turn's catalog lists those exact names."
+            : undefined,
+        "If you need shell, file search, file read, edit, or discovery behavior, choose the listed tool that provides that capability.",
+        "Count a tool call only after its tool result returns; batch independent read-only calls when the runtime supports it.",
+    ].filter((line) => typeof line === "string").join(" ");
+}
+function identities(tools, namespace) {
+    return tools.flatMap(value => {
+        const tool = (0, types_1.object)(value, "tool");
+        if (tool.type === "namespace")
+            return identities((0, types_1.list)(tool.tools, "namespace tools"), String(tool.name));
+        const fn = tool.function ? (0, types_1.object)(tool.function, "function") : tool;
+        return [{ name: String(fn.name), namespace, custom: tool.type === "custom" }];
+    });
+}
+function builtin(tool) { return tool.namespace === undefined || tool.namespace === "functions"; }
+function selected(tool, choice) {
+    if (choice === "none")
+        return false;
+    if (!choice || typeof choice === "string")
+        return true;
+    const selector = (0, types_1.object)(choice, "tool_choice");
+    if (selector.type === "allowed_tools")
+        return (0, types_1.list)(selector.tools, "allowed tools").some(value => selected(tool, value));
+    const fn = selector.function ? (0, types_1.object)(selector.function, "tool choice function") : selector;
+    return fn.name === tool.name && (fn.namespace === undefined ? builtin(tool) : fn.namespace === tool.namespace);
+}
+function codexToolGuidance(body, wireNames) {
+    const tools = body.tools === undefined ? [] : identities((0, types_1.list)(body.tools, "tools"));
+    const visible = tools.map((tool, index) => ({ tool, name: wireNames?.[index] ?? tool.name })).filter(({ tool }) => selected(tool, body.tool_choice));
+    const exec = visible.find(({ tool }) => builtin(tool) && tool.name === "exec" && tool.custom);
+    const codeMode = !!exec && !visible.some(({ tool }) => builtin(tool) && ["exec_command", "shell_command"].includes(tool.name));
+    return { catalog: buildToolCatalogNudge(visible.map(value => value.name), codeMode ? exec?.name : undefined),
+        codeMode, execNames: new Set(codeMode ? [exec.name] : []) };
+}
+function appendToolInstructions(instructions, sentences) {
+    return sentences.reduce((acc, sentence) => acc.includes(sentence) ? acc : [acc, sentence].filter(Boolean).join("\n\n"), instructions);
+}
+function codeModeInputDescription(existing) {
+    return appendToolInstructions(existing ?? "", ["JavaScript source for unified exec; do not provide a bare shell command.", exports.CODE_MODE_RESULT_ECHO_SENTENCE]);
+}

package/dist/commandRunner.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectOutput = collectOutput;
+exports.shellLaunch = shellLaunch;
+exports.runCommand = runCommand;
+const node_child_process_1 = require("node:child_process");
+const ABORTED_NOTICE = "\n已中止。\n";
+const ABORT_GRACE_MS = 5000;
+function collectOutput(command, args, cwd, onOutput, signal) {
+    return new Promise((resolve) => {
+        let settled = false;
+        let aborted = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            signal?.removeEventListener("abort", abort);
+            resolve({ ...result, aborted });
+        };
+        const child = (0, node_child_process_1.spawn)(command, args, {
+            cwd,
+            env: { ...process.env, PYTHONUTF8: "1", PYTHONIOENCODING: "utf-8" },
+            windowsHide: process.platform === "win32",
+            // A process group lets abort reach grandchildren such as servers started by uv.
+            detached: process.platform !== "win32",
+            // cmd.exe parses the complete command itself; Node's CRT escaping would
+            // turn embedded quotes into literal characters passed to tools like uv.
+            windowsVerbatimArguments: process.platform === "win32" && command === "cmd.exe",
+        });
+        const abort = () => {
+            if (settled || aborted)
+                return;
+            aborted = true;
+            // An escaped descendant may hold the output pipe open, so an aborted
+            // command ends when its own process exits rather than on "close".
+            const abandon = () => finish({
+                exitCode: child.exitCode ?? undefined, output: Buffer.concat(chunks).toString("utf8"), spawnError: false,
+            });
+            if (child.exitCode !== null || child.signalCode !== null) {
+                abandon();
+                return;
+            }
+            child.once("exit", abandon);
+            setTimeout(() => { child.kill(); abandon(); }, ABORT_GRACE_MS).unref();
+            killTree(child);
+        };
+        const chunks = [];
+        const receive = (chunk) => {
+            chunks.push(chunk);
+            onOutput?.(Buffer.concat(chunks).toString("utf8"));
+        };
+        child.stdout?.on("data", receive);
+        child.stderr?.on("data", receive);
+        child.on("error", () => finish({
+            exitCode: 1, output: Buffer.concat(chunks).toString("utf8"), spawnError: true,
+        }));
+        child.on("close", (code) => finish({
+            exitCode: code ?? undefined, output: Buffer.concat(chunks).toString("utf8"), spawnError: false,
+        }));
+        if (signal?.aborted)
+            abort();
+        else
+            signal?.addEventListener("abort", abort, { once: true });
+    });
+}
+function killTree(child) {
+    if (child.pid === undefined)
+        return;
+    if (process.platform === "win32") {
+        (0, node_child_process_1.spawn)("taskkill", ["/PID", String(child.pid), "/T", "/F"], { stdio: "ignore", windowsHide: true })
+            .on("error", () => child.kill())
+            .on("exit", (code) => { if (code)
+            child.kill(); });
+        return;
+    }
+    try {
+        process.kill(-child.pid, "SIGKILL");
+    }
+    catch {
+        child.kill("SIGKILL");
+    }
+}
+function shellLaunch(command) {
+    if (process.platform === "win32") {
+        return { command: "cmd.exe", args: ["/d", "/s", "/c", `"${command}"`] };
+    }
+    return { command: "sh", args: ["-c", command] };
+}
+async function runCommand(cwd, command, onOutput, signal) {
+    const launch = shellLaunch(command);
+    const result = await collectOutput(launch.command, launch.args, cwd, onOutput, signal);
+    if (result.aborted)
+        return { output: `${result.output}${ABORTED_NOTICE}`, exitCode: result.exitCode, aborted: true };
+    if (result.spawnError)
+        throw new Error("command failed");
+    if (result.exitCode !== 0) {
+        return { output: `${result.output}\n指令執行失敗（結束碼：${result.exitCode ?? "未知"}）。\n`, exitCode: result.exitCode };
+    }
+    return { output: result.output, exitCode: result.exitCode };
+}

package/dist/connectionMascot.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectionMascotScript = exports.connectionMascotStyles = exports.connectionMascot = void 0;
+/** Keep the original brand artwork; animate its layers in the browser. */
+exports.connectionMascot = `<div class="connection-mascot">
+  <div class="mascot-traveler">
+  <div class="mascot-arrival">
+    <button type="button" class="mascot-play" aria-label="和法鬥超人打招呼" title="和法鬥超人打招呼">
+      <span class="mascot-idle">
+        <span class="mascot-facing">
+        <svg class="mascot-art" viewBox="0 0 1024 1024" aria-hidden="true" focusable="false">
+          <defs>
+            <clipPath id="mascot-arm-clip"><path d="M85 320H220L235 400L222 462L241 508L254 530L207 589L149 522L104 451L85 410Z"/></clipPath>
+            <mask id="mascot-arm-mask"><rect width="1024" height="1024" fill="white"/><path d="M85 320H220L235 400L222 462L241 508L254 530L207 589L149 522L104 451L85 410Z" fill="black"/></mask>
+            <clipPath id="mascot-left-foot-clip"><rect x="235" y="915" width="175" height="100"/></clipPath>
+            <clipPath id="mascot-right-foot-clip"><rect x="490" y="927" width="185" height="88"/></clipPath>
+            <clipPath id="mascot-logo-clip"><rect x="283" y="612" width="315" height="105"/></clipPath>
+            <filter id="mascot-logo-alpha" x="0" y="0" width="100%" height="100%" color-interpolation-filters="sRGB">
+              <feColorMatrix in="SourceGraphic" values="1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 32 -32 0 0.6" result="lettering"/>
+              <feColorMatrix in="SourceGraphic" values="1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 -16 0 0 3.5" result="outline"/>
+              <feComposite in="lettering" in2="outline" operator="arithmetic" k2="1" k3="1" result="ink"/>
+              <feComposite in="SourceGraphic" in2="ink" operator="in"/>
+            </filter>
+            <filter id="mascot-logo-erase" x="0" y="0" width="100%" height="100%" color-interpolation-filters="sRGB">
+              <feColorMatrix in="SourceGraphic" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 32 -32 0 0.6" result="lettering"/>
+              <feColorMatrix in="SourceGraphic" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -16 0 0 3.5" result="outline"/>
+              <feComposite in="lettering" in2="outline" operator="arithmetic" k2="1" k3="1"/>
+            </filter>
+            <linearGradient id="mascot-shirt-fill"><stop stop-color="#3d6878"/><stop offset="0.5" stop-color="#3a677a"/><stop offset="1" stop-color="#356270"/></linearGradient>
+            <mask id="mascot-detail-mask"><rect width="1024" height="1024" fill="white"/><rect x="235" y="915" width="175" height="100" fill="black"/><rect x="490" y="927" width="185" height="88" fill="black"/><image href="/fadou-superhero.png" width="1024" height="1024" clip-path="url(#mascot-logo-clip)" filter="url(#mascot-logo-erase)"/></mask>
+            <clipPath id="mascot-body-clip"><path d="M0 0H1024V490H700L670 534L739 601L768 638L765 681L740 718L702 749L691 778L668 803L646 813V1024H0Z"/></clipPath>
+            <clipPath id="mascot-cape-clip"><path d="M688 490L1024 490V850H640V789L670 760L704 730L744 679L744 620L668 545Z"/></clipPath>
+            <clipPath id="mascot-eyes-clip"><ellipse cx="334" cy="359" rx="52" ry="43"/><ellipse cx="535" cy="369" rx="53" ry="43"/></clipPath>
+          </defs>
+          <g class="mascot-cape"><image href="/fadou-superhero.png" width="1024" height="1024" clip-path="url(#mascot-cape-clip)"/></g>
+          <rect x="283" y="612" width="315" height="105" fill="url(#mascot-shirt-fill)"/>
+          <g mask="url(#mascot-detail-mask)"><image href="/fadou-superhero.png" width="1024" height="1024" clip-path="url(#mascot-body-clip)" mask="url(#mascot-arm-mask)"/></g>
+          <g class="mascot-foot mascot-left-foot"><image href="/fadou-superhero.png" width="1024" height="1024" clip-path="url(#mascot-left-foot-clip)"/></g>
+          <g class="mascot-foot mascot-right-foot"><image href="/fadou-superhero.png" width="1024" height="1024" clip-path="url(#mascot-right-foot-clip)"/></g>
+          <g class="mascot-logo"><image href="/fadou-superhero.png" width="1024" height="1024" clip-path="url(#mascot-logo-clip)" filter="url(#mascot-logo-alpha)"/></g>
+          <g class="mascot-arm"><image href="/fadou-superhero.png" width="1024" height="1024" clip-path="url(#mascot-arm-clip)"/></g>
+          <g class="mascot-blink" clip-path="url(#mascot-eyes-clip)"><image href="/fadou-superhero-blink.png" x="11" y="4" width="1024" height="1024"/></g>
+        </svg>
+        </span>
+      </span>
+    </button>
+  </div>
+  </div>
+  <button type="button" class="mascot-pause" aria-label="暫停法鬥超人動畫" aria-pressed="false" title="暫停動畫"><svg viewBox="0 0 24 24" width="14" height="14" aria-hidden="true"><path d="M8 5v14M16 5v14" fill="none" stroke="currentColor" stroke-width="2"/></svg></button>
+</div>`;
+// One lap: centre → left (6s), rest (6s), right (12s), rest (6s), centre (6s).
+// Both feet settle at each edge; no stepping in place during the rests.
+function footstepKeyframes(name, direction) {
+    const frames = [];
+    for (const [start, end] of [[0, 6], [12, 24], [30, 36]]) {
+        for (let time = start; time <= end; time += 0.5) {
+            const phase = (time - start) % 1;
+            const angle = time === start || time === end ? 0 : (phase === 0.5 ? -5 : 5) * direction;
+            frames.push(`${time / 36 * 100}% { transform: translateY(${angle < 0 ? -6 : 0}px) rotate(${angle}deg); }`);
+        }
+    }
+    return `@keyframes ${name} { ${frames.join("\n")} }`;
+}
+exports.connectionMascotStyles = `
+  .settings-card[data-setting="連線"]:has(.connection-mascot) { row-gap: 0; }
+  .settings-card[data-setting="連線"]:has(.connection-mascot) .settings-content { padding-top: 16px; }
+  .settings-card[data-setting="連線"]:has(.connection-mascot) .connection-feedback { order: -1; }
+  .connection-mascot { position: relative; flex: 1 0 144px; width: 100%; min-height: 144px; overflow: hidden; container-type: inline-size; }
+  /* Compensate for the PNG's transparent space below the soles. */
+  .mascot-traveler { position: absolute; bottom: -4px; left: 8px; width: 136px; max-width: calc(100% - 16px); animation: mascot-walk 36s linear 780ms infinite both; }
+  .mascot-facing { display: block; animation: mascot-turn 36s linear 780ms infinite; }
+  .mascot-logo { transform-origin: 440.5px 664.5px; animation: mascot-turn 36s linear 780ms infinite; }
+  .mascot-left-foot { transform-origin: 322px 915px; animation: mascot-left-step 36s linear 780ms infinite; }
+  .mascot-right-foot { transform-origin: 580px 927px; animation: mascot-right-step 36s linear 780ms infinite; }
+  .mascot-waiting { flex-basis: 164px; min-height: 164px; padding: 12px 148px 32px 0; }
+  .mascot-waiting .mascot-traveler { left: auto; right: 8px; transform: none; }
+  .mascot-waiting .mascot-traveler, .mascot-waiting .mascot-facing, .mascot-waiting .mascot-logo, .mascot-waiting .mascot-foot, .mascot-waiting .mascot-arrival { animation: none; }
+  .mascot-speech { position: relative; padding: 10px 12px; border: 1px solid var(--line); border-radius: 12px; background: var(--input); font-size: 12px; line-height: 1.6; overflow-wrap: anywhere; }
+  .mascot-speech:has(> .connection-feedback:empty) { display: none; }
+  .mascot-speech::after { content: ''; position: absolute; right: -7px; top: 28px; width: 12px; height: 12px; background: var(--input); border-right: 1px solid var(--line); border-top: 1px solid var(--line); transform: rotate(45deg); }
+  .mascot-quote { color: var(--text); }
+  .mascot-speech .connection-error, .mascot-speech .connection-message { padding: 0; margin-top: 6px; border-radius: 0; background: transparent; color: var(--muted); font-size: 11px; }
+  .mascot-speech .connection-error svg, .mascot-speech .connection-message svg { display: none; }
+  .mascot-speaking .connection-message { margin-top: 0; color: var(--text); font-size: 12px; }
+  .mascot-speaking { flex-basis: 144px; min-height: 144px; padding-bottom: 0; }
+  main button.mascot-speech-close { margin-top: 6px; padding: 4px 0; min-height: 24px; background: transparent; color: var(--muted); border: 0; border-radius: 4px; font-size: 11px; }
+  main button.mascot-speech-close:hover { color: var(--text); }
+  main button.mascot-pause { position: absolute; right: 0; bottom: 0; display: grid; place-items: center; min-height: 24px; width: 24px; padding: 0; border: 0; border-radius: 6px; background: transparent; color: var(--muted); opacity: 0.65; }
+  main button.mascot-pause:hover, main button.mascot-pause:focus-visible { opacity: 1; background: var(--input); }
+  .connection-mascot:hover .mascot-traveler, .connection-mascot:hover .mascot-facing, .connection-mascot:hover .mascot-logo, .connection-mascot:hover .mascot-foot,
+  .connection-mascot:focus-within .mascot-traveler, .connection-mascot:focus-within .mascot-facing, .connection-mascot:focus-within .mascot-logo, .connection-mascot:focus-within .mascot-foot,
+  .connection-mascot[data-paused] * { animation-play-state: paused; }
+  .mascot-arrival { animation: mascot-arrive 780ms cubic-bezier(0.22, 1, 0.36, 1) both; transform-origin: center bottom; }
+  main button.mascot-play { display: block; width: 136px; max-width: 100%; min-height: 0; padding: 0; border: 0; border-radius: 16px; background: transparent; color: inherit; touch-action: manipulation; }
+  .mascot-play:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+  .mascot-play:active { transform: scale(0.97); }
+  .mascot-idle { display: block; user-select: none; transform-origin: 50% 97%; animation: mascot-breathe 3200ms ease-in-out 780ms infinite; }
+  .mascot-art { display: block; width: 100%; height: auto; overflow: visible; }
+  .mascot-cape { transform-origin: 680px 530px; animation: mascot-cape 2400ms ease-in-out infinite; }
+  .mascot-arm { transform-origin: 235px 540px; }
+  .mascot-blink { opacity: 0; animation: mascot-blink 7400ms steps(1, end) infinite; }
+  @keyframes mascot-arrive {
+    0% { opacity: 0; transform: translateY(16px) scale(0.9); }
+    35% { opacity: 1; transform: translateY(-7px) scale(1.02); }
+    60% { transform: translateY(2px) scale(0.99); }
+    80% { transform: translateY(-2px) scale(1); }
+    100% { opacity: 1; transform: translateY(0) scale(1); }
+  }
+  @keyframes mascot-breathe {
+    0%, 100% { transform: translateY(0) scale(1); }
+    50% { transform: scale(1.012, 1.018); }
+  }
+  @keyframes mascot-cape {
+    0%, 100% { transform: rotate(0deg) scale(1); }
+    50% { transform: rotate(-1.5deg) scale(1.012, 0.99); }
+  }
+  @keyframes mascot-blink {
+    0%, 42%, 85%, 90%, 100% { opacity: 0; }
+    40%, 83%, 88% { opacity: 1; }
+  }
+  @keyframes mascot-walk {
+    0%, 100% { transform: translateX(max(0px, calc((100cqw - 152px) / 2))); }
+    16.666667%, 33.333333% { transform: translateX(0); }
+    66.666667%, 83.333333% { transform: translateX(max(0px, calc(100cqw - 152px))); }
+  }
+  @keyframes mascot-turn {
+    0%, 16.666667% { transform: scaleX(1); }
+    18%, 66.666667% { transform: scaleX(-1); }
+    68%, 100% { transform: scaleX(1); }
+  }
+  ${footstepKeyframes("mascot-left-step", 1)}
+  ${footstepKeyframes("mascot-right-step", -1)}
+  @media (prefers-reduced-motion: reduce) {
+    .mascot-arrival, .mascot-idle, .mascot-cape, .mascot-blink, .mascot-traveler, .mascot-facing, .mascot-logo, .mascot-foot { animation: none; }
+    .mascot-traveler { left: 50%; transform: translateX(-50%); }
+    .mascot-waiting .mascot-traveler { left: auto; transform: none; }
+    main button.mascot-pause { display: none; }
+    .mascot-play:active { transform: none; }
+  }
+  @media (prefers-contrast: more) { .mascot-play:focus-visible { outline-width: 3px; } }
+`;
+exports.connectionMascotScript = `
+  var mascotSpeechDismissed = false;
+  function updateCopyFeedback(updated) {
+    var card = document.querySelector('[data-setting="連線"]');
+    var nextCard = updated.querySelector('[data-setting="連線"]');
+    var stage = card?.querySelector('.connection-mascot') || document.querySelector('.classroom-update .connection-mascot');
+    var nextStage = nextCard?.querySelector('.connection-mascot');
+    if (!stage || !nextStage || !nextCard.querySelector('.connection-copy')) return false;
+    var speech = nextStage.querySelector('.mascot-speech');
+    var feedback = nextCard.querySelector('.settings-content > .connection-feedback');
+    if (!speech && !feedback) return false;
+    card.querySelector('.settings-content > .connection-feedback')?.remove();
+    stage.querySelector('.mascot-speech')?.remove();
+    if (nextStage.classList.contains('mascot-speaking')) {
+      if (!speech) return false;
+      mascotSpeechDismissed = false;
+      stage.classList.add('mascot-waiting', 'mascot-speaking');
+      stage.prepend(speech);
+    } else {
+      if (stage.classList.contains('mascot-speaking')) hideMascotSpeech(stage);
+      card.querySelector('.settings-content').append(feedback);
+    }
+    return true;
+  }
+  function hideMascotSpeech(stage) {
+    stage.querySelector('.mascot-speech')?.remove();
+    stage.classList.remove('mascot-waiting', 'mascot-speaking');
+    stage.getAnimations({ subtree: true }).forEach(function (animation) {
+      if (animation.animationName === 'mascot-arrive') animation.currentTime = 780;
+      if (['mascot-walk', 'mascot-turn', 'mascot-left-step', 'mascot-right-step'].includes(animation.animationName)) animation.currentTime = 27780;
+    });
+  }
+  function mascotAnimationState() {
+    var mascot = document.querySelector('.connection-mascot');
+    return { speechDismissed: mascotSpeechDismissed, paused: mascot?.hasAttribute('data-paused') || false, animations: mascot ? mascot.getAnimations({ subtree: true }).filter(function (animation) {
+      return typeof animation.animationName === 'string';
+    }).map(function (animation) {
+      return { name: animation.animationName, time: animation.currentTime };
+    }) : [] };
+  }
+  function restoreMascotAnimationState(state) {
+    var mascot = document.querySelector('.connection-mascot');
+    if (!mascot) return;
+    mascotSpeechDismissed = Boolean(state.speechDismissed);
+    if (mascotSpeechDismissed && mascot.classList.contains('mascot-speaking')) hideMascotSpeech(mascot);
+    if (state.paused) {
+      mascot.setAttribute('data-paused', '');
+      var pause = mascot.querySelector('.mascot-pause');
+      pause.setAttribute('aria-pressed', 'true');
+      pause.setAttribute('aria-label', '繼續法鬥超人動畫');
+      pause.title = '繼續動畫';
+    }
+    mascot.getAnimations({ subtree: true }).forEach(function (animation) {
+      var saved = (state.animations || []).find(function (value) { return value.name === animation.animationName; });
+      if (saved && saved.time !== null) animation.currentTime = saved.time;
+    });
+  }
+  document.addEventListener('click', function (event) {
+    var close = event.target.closest?.('.mascot-speech-close');
+    if (close && !close.disabled) {
+      var speaking = close.closest('.connection-mascot');
+      mascotSpeechDismissed = true;
+      hideMascotSpeech(speaking);
+      document.querySelector('[data-setting="連線"] .connection-copy')?.focus({ preventScroll: true });
+      return;
+    }
+    var pause = event.target.closest?.('.mascot-pause');
+    if (pause && !pause.disabled) {
+      var stage = pause.closest('.connection-mascot');
+      var paused = stage.toggleAttribute('data-paused');
+      pause.setAttribute('aria-pressed', String(paused));
+      pause.setAttribute('aria-label', paused ? '繼續法鬥超人動畫' : '暫停法鬥超人動畫');
+      pause.title = paused ? '繼續動畫' : '暫停動畫';
+      return;
+    }
+    var button = event.target.closest?.('.mascot-play');
+    if (!button || button.disabled) return;
+    var reduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+    var arm = button.querySelector('.mascot-arm');
+    arm.getAnimations().forEach(function (animation) { animation.cancel(); });
+    if (!reduced) arm.animate([
+      { transform: 'rotate(0deg)' }, { transform: 'rotate(-8deg)', offset: 0.25 },
+      { transform: 'rotate(5deg)', offset: 0.5 }, { transform: 'rotate(-6deg)', offset: 0.75 },
+      { transform: 'rotate(0deg)' }
+    ], { duration: 800, easing: 'ease-in-out' });
+    button.getAnimations().forEach(function (animation) { animation.cancel(); });
+    button.animate(reduced ? [{ opacity: 0.65 }, { opacity: 1 }] : [
+      { transform: 'translateY(0) rotate(0deg)' },
+      { transform: 'translateY(-8px) rotate(-4deg)', offset: 0.35 },
+      { transform: 'translateY(-3px) rotate(3deg)', offset: 0.65 },
+      { transform: 'translateY(0) rotate(0deg)' }
+    ], { duration: reduced ? 180 : 600, easing: 'ease-out' });
+  });
+`;

package/dist/courseCatalog.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACTION_KIND_LABELS = exports.ACTION_KINDS = void 0;
+exports.actionKindLabel = actionKindLabel;
+exports.parseCourseCatalog = parseCourseCatalog;
+const yaml_1 = require("yaml");
+exports.ACTION_KINDS = ["skill", "package", "mcp"];
+exports.ACTION_KIND_LABELS = {
+    skill: "Skill",
+    package: "套件",
+    mcp: "MCP",
+};
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function isActionKind(value) {
+    return typeof value === "string" && exports.ACTION_KINDS.includes(value);
+}
+function actionKindLabel(kind) {
+    return exports.ACTION_KIND_LABELS[kind];
+}
+/** 解析 Course Catalog YAML。失敗時不回半套清單。 */
+function parseCourseCatalog(source) {
+    let doc;
+    try {
+        doc = (0, yaml_1.parse)(source);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: `YAML 無法解析：${message}` };
+    }
+    if (!doc || typeof doc !== "object" || Array.isArray(doc)) {
+        return { ok: false, error: "根層必須是物件，且含 actions 陣列" };
+    }
+    const actionsRaw = doc.actions;
+    if (!Array.isArray(actionsRaw)) {
+        return { ok: false, error: "缺少頂層鍵 actions（陣列）" };
+    }
+    const actions = [];
+    for (let i = 0; i < actionsRaw.length; i++) {
+        const row = actionsRaw[i];
+        if (!row || typeof row !== "object" || Array.isArray(row)) {
+            return { ok: false, error: `actions[${i}] 必須是物件` };
+        }
+        const { id, title, command, description, kind } = row;
+        if (!isNonEmptyString(id) || !isNonEmptyString(title) || !isNonEmptyString(command)) {
+            return {
+                ok: false,
+                error: `actions[${i}] 缺少必填欄位 id／title／command`,
+            };
+        }
+        const kindValue = isNonEmptyString(kind) ? kind.trim() : kind;
+        if (!isActionKind(kindValue)) {
+            return {
+                ok: false,
+                error: `actions[${i}].kind 必須是 skill／package／mcp`,
+            };
+        }
+        const action = {
+            id: id.trim(),
+            title: title.trim(),
+            kind: kindValue,
+            command: command.trim(),
+        };
+        if (description !== undefined) {
+            if (!isNonEmptyString(description)) {
+                return {
+                    ok: false,
+                    error: `actions[${i}].description 若提供須為非空字串`,
+                };
+            }
+            action.description = description.trim();
+        }
+        actions.push(action);
+    }
+    const snippetsResult = parseSnippets(doc.snippets);
+    if (!snippetsResult.ok) {
+        return snippetsResult;
+    }
+    return { ok: true, actions, snippets: snippetsResult.snippets };
+}
+function parseSnippets(snippetsRaw) {
+    if (snippetsRaw === undefined || snippetsRaw === null) {
+        return { ok: true, snippets: [] };
+    }
+    if (!Array.isArray(snippetsRaw)) {
+        return { ok: false, error: "頂層鍵 snippets 若提供須為陣列" };
+    }
+    const snippets = [];
+    const seenIds = new Set();
+    for (let i = 0; i < snippetsRaw.length; i++) {
+        const row = snippetsRaw[i];
+        if (!row || typeof row !== "object" || Array.isArray(row)) {
+            return { ok: false, error: `snippets[${i}] 必須是物件` };
+        }
+        const { id, title, body, paste_hint: pasteHintRaw } = row;
+        if (!isNonEmptyString(id) || !isNonEmptyString(title)) {
+            return {
+                ok: false,
+                error: `snippets[${i}] 缺少必填欄位 id／title／body`,
+            };
+        }
+        if (typeof body !== "string" || body.length === 0) {
+            return {
+                ok: false,
+                error: `snippets[${i}] 缺少必填欄位 id／title／body`,
+            };
+        }
+        const snippetId = id.trim();
+        if (seenIds.has(snippetId)) {
+            return { ok: false, error: `snippets 內 id 重複：${snippetId}` };
+        }
+        seenIds.add(snippetId);
+        const snippet = {
+            id: snippetId,
+            title: title.trim(),
+            body,
+        };
+        if (pasteHintRaw !== undefined) {
+            if (!isNonEmptyString(pasteHintRaw)) {
+                return {
+                    ok: false,
+                    error: `snippets[${i}].paste_hint 若提供須為非空字串`,
+                };
+            }
+            snippet.pasteHint = pasteHintRaw.trim();
+        }
+        snippets.push(snippet);
+    }
+    return { ok: true, snippets };
+}

package/dist/desktop.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openBrowser = openBrowser;
+exports.asset = asset;
+const node_child_process_1 = require("node:child_process");
+const node_sea_1 = require("node:sea");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+function openBrowser(url) {
+    if (process.env.CLASSROOM_APP_HEADLESS === "1")
+        return;
+    const child = process.platform === "win32"
+        ? (0, node_child_process_1.spawn)("cmd.exe", ["/d", "/c", "start", "", url], { detached: true, stdio: "ignore", windowsHide: true })
+        : (0, node_child_process_1.spawn)("open", [url], { detached: true, stdio: "ignore" });
+    child.on("error", () => process.stderr.write("請用瀏覽器開啟顯示的本機網址。\n"));
+    child.unref();
+}
+function asset(name) {
+    return (0, node_sea_1.isSea)()
+        ? Promise.resolve(Buffer.from((0, node_sea_1.getAsset)(name)))
+        : promises_1.default.readFile(node_path_1.default.join(__dirname, "..", name.startsWith("brand-") || name.startsWith("fadou-superhero") ? "media" : "scripts", name));
+}

package/dist/entry.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const launcher_1 = require("./launcher");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const instance_1 = require("./instance");
+void (0, launcher_1.runCli)().catch(async (error) => {
+    const message = error instanceof Error ? error.message : "VansPod 操作失敗。";
+    if (process.env.VANSPOD_WORKER_TOKEN) {
+        await promises_1.default.writeFile(node_path_1.default.join((0, instance_1.managementDirectory)(), "startup-error.json"), JSON.stringify({ message }), { mode: 0o600 }).catch(() => undefined);
+    }
+    process.stderr.write(`${message}\n`);
+    process.exitCode = 1;
+});

package/dist/environmentIcons.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.environmentIcons = void 0;
+// Brand icons from https://github.com/simple-icons/simple-icons (CC0-1.0).
+// PowerShell from 11.15.0; other icons from develop.
+exports.environmentIcons = {
+    "uv": "<svg aria-hidden=\"true\" fill=\"currentColor\"  viewBox=\"0 0 24 24\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"m0 .1058.0504 11.9496.0403 9.5597c.0055 1.3199 1.08 2.3854 2.4 2.3798l9.5596-.0403 5.9749-.0252.6075-.0026c1.316-.0056 2.3799-1.0963 2.3799-2.4123h1.0946v2.3894L24 23.9042 23.8992.005 12.9056.0513l.0463 9.5245v5.9637h-1.9583L11.04 9.584 10.9936.0594Z\"/></svg>",
+    "git": "<svg aria-hidden=\"true\" fill=\"currentColor\"  viewBox=\"0 0 24 24\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M13.09 23.549a1.54 1.54 0 0 1-2.18 0L.451 13.089a1.54 1.54 0 0 1 0-2.179l7.191-7.19 2.733 2.733a1.85 1.85 0 0 0 .964 2.326v6.66a1.849 1.849 0 1 0 1.54 0V8.957l2.508 2.508a1.85 1.85 0 1 0 1.09-1.09l-2.634-2.634a1.85 1.85 0 0 0-2.378-2.377L8.73 2.63 10.91.451a1.54 1.54 0 0 1 2.179 0l10.459 10.46a1.54 1.54 0 0 1 0 2.179z\"/></svg>",
+    "node": "<svg aria-hidden=\"true\" fill=\"currentColor\"  viewBox=\"0 0 24 24\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M11.998,24c-0.321,0-0.641-0.084-0.922-0.247l-2.936-1.737c-0.438-0.245-0.224-0.332-0.08-0.383 c0.585-0.203,0.703-0.25,1.328-0.604c0.065-0.037,0.151-0.023,0.218,0.017l2.256,1.339c0.082,0.045,0.197,0.045,0.272,0l8.795-5.076 c0.082-0.047,0.134-0.141,0.134-0.238V6.921c0-0.099-0.053-0.192-0.137-0.242l-8.791-5.072c-0.081-0.047-0.189-0.047-0.271,0 L3.075,6.68C2.99,6.729,2.936,6.825,2.936,6.921v10.15c0,0.097,0.054,0.189,0.139,0.235l2.409,1.392 c1.307,0.654,2.108-0.116,2.108-0.89V7.787c0-0.142,0.114-0.253,0.256-0.253h1.115c0.139,0,0.255,0.112,0.255,0.253v10.021 c0,1.745-0.95,2.745-2.604,2.745c-0.508,0-0.909,0-2.026-0.551L2.28,18.675c-0.57-0.329-0.922-0.945-0.922-1.604V6.921 c0-0.659,0.353-1.275,0.922-1.603l8.795-5.082c0.557-0.315,1.296-0.315,1.848,0l8.794,5.082c0.57,0.329,0.924,0.944,0.924,1.603 v10.15c0,0.659-0.354,1.273-0.924,1.604l-8.794,5.078C12.643,23.916,12.324,24,11.998,24z M19.099,13.993 c0-1.9-1.284-2.406-3.987-2.763c-2.731-0.361-3.009-0.548-3.009-1.187c0-0.528,0.235-1.233,2.258-1.233 c1.807,0,2.473,0.389,2.747,1.607c0.024,0.115,0.129,0.199,0.247,0.199h1.141c0.071,0,0.138-0.031,0.186-0.081 c0.048-0.054,0.074-0.123,0.067-0.196c-0.177-2.098-1.571-3.076-4.388-3.076c-2.508,0-4.004,1.058-4.004,2.833 c0,1.925,1.488,2.457,3.895,2.695c2.88,0.282,3.103,0.703,3.103,1.269c0,0.983-0.789,1.402-2.642,1.402 c-2.327,0-2.839-0.584-3.011-1.742c-0.02-0.124-0.126-0.215-0.253-0.215h-1.137c-0.141,0-0.254,0.112-0.254,0.253 c0,1.482,0.806,3.248,4.655,3.248C17.501,17.007,19.099,15.91,19.099,13.993z\"/></svg>",
+    "pwsh": "<svg aria-hidden=\"true\" fill=\"currentColor\"  viewBox=\"0 0 24 24\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M23.181 2.974c.568 0 .923.463.792 1.035l-3.659 15.982c-.13.572-.697 1.035-1.265 1.035H.819c-.568 0-.923-.463-.792-1.035L3.686 4.009c.13-.572.697-1.035 1.265-1.035zm-8.375 9.346c.251-.394.227-.905-.09-1.243L9.122 5.125c-.38-.404-1.037-.407-1.466-.003-.429.402-.468 1.056-.088 1.46l4.662 4.96v.11l-7.42 5.374c-.45.327-.533.977-.187 1.453.346.476.991.597 1.44.27l8.229-5.91c.28-.196.438-.365.514-.52zm-2.796 4.399a.928.928 0 00-.934.923c0 .51.418.923.934.923h4.433a.928.928 0 00.934-.923.928.928 0 00-.934-.923z\"/></svg>"
+};

package/dist/exitGuard.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exitDecision = exitDecision;
+exports.removalInterruptions = removalInterruptions;
+/** 安裝與模型回答合併成一次確認；未確認不中斷任何工作。 */
+function exitDecision(action, work, confirmed) {
+    const running = [
+        ...(work.installing ? ["安裝仍在執行"] : []),
+        ...(work.activeRequests ? ["仍有模型回答"] : []),
+    ];
+    if (!running.length || confirmed)
+        return { proceed: true };
+    return { proceed: false, message: `${running.join("、")}，確認中止並${action === "stop" ? "結束" : "移除"} VansPod？` };
+}
+function removalInterruptions(work) {
+    return `${work.installing ? "\n安裝仍在執行，移除前將中止安裝。" : ""}${work.activeRequests ? "\n仍有模型回答，移除將中斷目前回答。" : ""}`;
+}