beauticode-dsh 1.0.0

package/themes/internal-beyond/NOTICE.md

@@ -0,0 +1,9 @@
+# Internal / Infernal atmosphere assets
+
+`bg-internal.jpg`, `bg-infernal.jpg`, `bg-canvas.png`, and the local
+`bg-canvas-4k.png` (Real-ESRGAN 4x then 3840×2160) are visual materials
+from [Internal Beyond](https://github.com/Sui-IB/InternalBeyond) by Sui.
+
+They remain under that project's CC BY-NC-SA 4.0 terms for visual assets.
+BeautiCode ships them as bundled workspace themes for local, non-commercial use.
+The project name, logo, and character identity are not licensed here.

package/ui-host.mjs

@@ -0,0 +1,292 @@
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import crypto from "node:crypto";
+import { pipeline } from "node:stream/promises";
+import { Transform } from "node:stream";
+import { createBeauticodeActions } from "./agent.mjs";
+import { callDshControl } from "./control-client.mjs";
+import { hasLiveTray, resolveApplyBackend, stopInProcessSession } from "./host-apply.mjs";
+
+const IMAGE_EXTENSIONS = new Set([".jpg", ".jpeg", ".png", ".webp", ".avif"]);
+const MAX_IMAGE_BYTES = 18 * 1024 * 1024;
+const MAX_VIDEO_BYTES = 800 * 1024 * 1024;
+
+export function parseImportFilename(raw) {
+  if (typeof raw !== "string" || !raw.trim()) {
+    return { ok: false, error: "缺少文件名。" };
+  }
+  let decoded = raw.trim();
+  try {
+    decoded = decodeURIComponent(decoded);
+  } catch {
+    /* keep raw */
+  }
+  const name = path.basename(decoded.replaceAll("\\", "/"));
+  if (!name || name === "." || name === "..") {
+    return { ok: false, error: "文件名无效。" };
+  }
+  const ext = path.extname(name).toLowerCase();
+  if (ext === ".mp4") {
+    return { ok: true, name, ext, kind: "video", maxBytes: MAX_VIDEO_BYTES };
+  }
+  if (IMAGE_EXTENSIONS.has(ext)) {
+    return { ok: true, name, ext, kind: "image", maxBytes: MAX_IMAGE_BYTES };
+  }
+  return { ok: false, error: "只支持图片（jpg / jpeg / png / webp / avif）或 MP4 视频。" };
+}
+
+function limitBytes(maxBytes) {
+  let size = 0;
+  return new Transform({
+    transform(chunk, _enc, callback) {
+      size += chunk.length;
+      if (size > maxBytes) {
+        const error = new Error("文件过大。");
+        error.statusCode = 413;
+        callback(error);
+        return;
+      }
+      callback(null, chunk);
+    },
+  });
+}
+
+function publicThemes(list) {
+  return (Array.isArray(list) ? list : []).map((theme) => ({
+    id: theme.id,
+    name: theme.name,
+    type: theme.type ?? null,
+    ...(theme.bundled ? { bundled: true } : {}),
+  }));
+}
+
+async function canReachBridge(baseUrl) {
+  const origin = typeof baseUrl === "string" && baseUrl ? baseUrl : "http://127.0.0.1:3080";
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 800);
+  try {
+    const response = await fetch(new URL("__beauticode/version", origin.endsWith("/") ? origin : `${origin}/`), {
+      signal: controller.signal,
+    });
+    return response.ok;
+  } catch {
+    return false;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+export function createBeauticodeUi({ dataRoot, baseUrl, getBaseUrl, sendJson, isSameOrigin, readJson }) {
+  const options = {
+    dataRoot,
+    get baseUrl() {
+      if (typeof getBaseUrl === "function") return getBaseUrl();
+      return baseUrl;
+    },
+  };
+  const actions = createBeauticodeActions(options);
+  let restoreStarted = false;
+
+  async function restoreOnce() {
+    if (await hasLiveTray(dataRoot)) {
+      return callDshControl(dataRoot, {
+        method: "POST",
+        path: "/reapply",
+        body: {},
+        timeoutMs: 30_000,
+      });
+    }
+    if (!(await canReachBridge(options.baseUrl))) return;
+    const resolved = await resolveApplyBackend(options);
+    if (resolved.kind === "tray") {
+      return callDshControl(dataRoot, {
+        method: "POST",
+        path: "/reapply",
+        body: {},
+        timeoutMs: 30_000,
+      });
+    }
+    return resolved.session.reapply();
+  }
+
+  return {
+    dispose() {
+      return stopInProcessSession(dataRoot);
+    },
+    scheduleRestore() {
+      if (restoreStarted) return;
+      restoreStarted = true;
+      queueMicrotask(() => {
+        void restoreOnce().catch(() => {
+          restoreStarted = false;
+        });
+      });
+    },
+
+    async status(req, res) {
+      if (req.method !== "GET") {
+        res.writeHead(405).end();
+        return;
+      }
+      if (!isSameOrigin(req)) {
+        res.writeHead(403).end();
+        return;
+      }
+      try {
+        const status = await actions.status();
+        const listed = await actions.listThemes();
+        const background = status.background ?? null;
+        sendJson(res, 200, {
+          ok: true,
+          media: background?.type ?? null,
+          muted: status.muted !== false,
+          atmosphere: background?.effects?.preset ?? null,
+          themes: publicThemes(listed.themes),
+          message: status.message,
+        });
+      } catch (error) {
+        sendJson(res, 200, {
+          ok: false,
+          error: error instanceof Error ? error.message : String(error),
+        });
+      }
+    },
+
+    async importFile(req, res) {
+      if (req.method !== "POST") {
+        res.writeHead(405).end();
+        return;
+      }
+      if (!isSameOrigin(req)) {
+        res.writeHead(403).end();
+        return;
+      }
+      const parsed = parseImportFilename(req.headers["x-beauticode-filename"]);
+      if (!parsed.ok) {
+        req.resume();
+        sendJson(res, 400, { ok: false, error: parsed.error });
+        return;
+      }
+      const length = Number(req.headers["content-length"]);
+      if (Number.isFinite(length) && length > parsed.maxBytes) {
+        req.resume();
+        sendJson(res, 413, { ok: false, error: "文件过大。" });
+        return;
+      }
+      const tmpDir = path.join(dataRoot, "tmp");
+      await fsp.mkdir(tmpDir, { recursive: true });
+      const tmpPath = path.join(
+        tmpDir,
+        `${Date.now()}-${crypto.randomBytes(8).toString("hex")}${parsed.ext}`,
+      );
+      try {
+        await pipeline(req, limitBytes(parsed.maxBytes), fs.createWriteStream(tmpPath));
+        const result =
+          parsed.kind === "video"
+            ? await actions.applyVideo({ path: tmpPath })
+            : await actions.applyImage(tmpPath);
+        sendJson(res, 200, result);
+      } catch (error) {
+        const status = error?.statusCode === 413 ? 413 : 422;
+        sendJson(res, status, {
+          ok: false,
+          error: error instanceof Error ? error.message : String(error),
+        });
+      } finally {
+        await fsp.rm(tmpPath, { force: true }).catch(() => {});
+      }
+    },
+
+    async clear(req, res) {
+      if (req.method !== "POST") {
+        res.writeHead(405).end();
+        return;
+      }
+      if (!isSameOrigin(req)) {
+        res.writeHead(403).end();
+        return;
+      }
+      try {
+        sendJson(res, 200, await actions.clear());
+      } catch (error) {
+        sendJson(res, 422, {
+          ok: false,
+          error: error instanceof Error ? error.message : String(error),
+        });
+      }
+    },
+
+    async mode(req, res) {
+      if (req.method !== "POST") {
+        res.writeHead(405).end();
+        return;
+      }
+      if (!isSameOrigin(req)) {
+        res.writeHead(403).end();
+        return;
+      }
+      const body = await readJson(req);
+      if (typeof body.muted !== "boolean" || Object.keys(body).some((key) => key !== "muted")) {
+        sendJson(res, 400, { ok: false, error: "只接受 muted 开关。" });
+        return;
+      }
+      try {
+        sendJson(res, 200, await actions.setMuted(body.muted));
+      } catch (error) {
+        sendJson(res, 422, {
+          ok: false,
+          error: error instanceof Error ? error.message : String(error),
+        });
+      }
+    },
+
+    async useTheme(req, res) {
+      if (req.method !== "POST") {
+        res.writeHead(405).end();
+        return;
+      }
+      if (!isSameOrigin(req)) {
+        res.writeHead(403).end();
+        return;
+      }
+      const body = await readJson(req);
+      if (typeof body.id !== "string" || !body.id.trim()) {
+        sendJson(res, 400, { ok: false, error: "必须提供主题。" });
+        return;
+      }
+      try {
+        sendJson(res, 200, await actions.useTheme(body.id.trim()));
+      } catch (error) {
+        sendJson(res, 422, {
+          ok: false,
+          error: error instanceof Error ? error.message : String(error),
+        });
+      }
+    },
+
+    async applyPreset(req, res) {
+      if (req.method !== "POST") {
+        res.writeHead(405).end();
+        return;
+      }
+      if (!isSameOrigin(req)) {
+        res.writeHead(403).end();
+        return;
+      }
+      const body = await readJson(req);
+      if (body.id !== "internal" && body.id !== "infernal") {
+        sendJson(res, 400, { ok: false, error: "未知的内置主题。" });
+        return;
+      }
+      try {
+        sendJson(res, 200, await actions.applyPreset(body.id));
+      } catch (error) {
+        sendJson(res, 422, {
+          ok: false,
+          error: error instanceof Error ? error.message : String(error),
+        });
+      }
+    },
+  };
+}

package/vendor/adapter-dsh/bridge.js

@@ -0,0 +1,215 @@
+export function normalizeDshBaseUrl(value) {
+    const url = new URL(value);
+    const hostname = url.hostname.toLowerCase();
+    if (url.protocol !== "http:" ||
+        !["127.0.0.1", "localhost", "[::1]"].includes(hostname) ||
+        url.username ||
+        url.password ||
+        (url.pathname !== "" && url.pathname !== "/") ||
+        url.search ||
+        url.hash) {
+        throw new Error("DeepSeek Harness URL must be loopback HTTP.");
+    }
+    url.pathname = url.pathname.replace(/\/+$/, "") || "/";
+    return url;
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export class DshHostApplier {
+    baseUrl;
+    requestTimeoutMs;
+    pollMs;
+    token;
+    lastStatus = null;
+    constructor(opts) {
+        this.baseUrl = normalizeDshBaseUrl(opts.baseUrl ?? "http://127.0.0.1:3080");
+        this.token = opts.token;
+        this.requestTimeoutMs = opts.requestTimeoutMs ?? 3_000;
+        this.pollMs = opts.pollMs ?? 150;
+    }
+    get origin() {
+        return this.baseUrl.origin;
+    }
+    get activeSessionCount() {
+        return this.lastStatus?.connectedClients ?? 0;
+    }
+    async status() {
+        try {
+            const status = await this.#request("status", { method: "GET" });
+            if (!status || status.ok !== true || !Number.isInteger(status.connectedClients)) {
+                throw new Error("DeepSeek Harness bridge returned an invalid status.");
+            }
+            this.lastStatus = status;
+            return status;
+        }
+        catch (error) {
+            this.lastStatus = null;
+            throw error;
+        }
+    }
+    async apply(payload) {
+        if (payload.media !== "clear" && !payload.imageUrl) {
+            throw new Error("DeepSeek Harness background apply requires a loopback poster URL.");
+        }
+        if (payload.media === "video" && !payload.video?.srcUrl) {
+            throw new Error("DeepSeek Harness video apply requires a loopback MP4 URL.");
+        }
+        const body = {
+            generation: payload.generation,
+            media: payload.media,
+            imageUrl: payload.media === "clear" ? null : payload.imageUrl,
+            videoUrl: payload.media === "video" ? payload.video?.srcUrl : null,
+            startAt: payload.media === "video" && Number.isFinite(payload.video?.startAt)
+                ? Math.max(0, Number(payload.video?.startAt))
+                : null,
+        };
+        if (payload.atmosphere?.preset)
+            body.atmosphere = payload.atmosphere;
+        await this.#request("apply", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+    }
+    async setFishMode(enabled) {
+        const result = await this.#setMode({ fish: Boolean(enabled) });
+        return { ok: result.ok, fish: Boolean(enabled), sessions: result.sessions, ...(result.error ? { error: result.error } : {}) };
+    }
+    async setMuted(muted) {
+        const result = await this.#setMode({ muted: Boolean(muted) });
+        return {
+            ok: result.ok,
+            muted: Boolean(muted),
+            blocked: result.blocked,
+            sessions: result.sessions,
+            ...(result.error ? { error: result.error } : {}),
+        };
+    }
+    async setBackgroundTone(tone) {
+        const normalized = tone === "light" || tone === "auto" ? tone : "dark";
+        const result = await this.#setMode({ tone: normalized });
+        return { ok: result.ok, tone: normalized, sessions: result.sessions, ...(result.error ? { error: result.error } : {}) };
+    }
+    async getPlaybackPosition() {
+        const status = await this.status();
+        const playback = status.playback;
+        if (!playback?.hasVideo) {
+            return { ok: false, currentTime: 0, duration: 0, hasVideo: false };
+        }
+        return {
+            ok: true,
+            currentTime: Number.isFinite(playback.currentTime) ? playback.currentTime : 0,
+            duration: Number.isFinite(playback.duration) ? playback.duration : 0,
+            hasVideo: true,
+        };
+    }
+    async verify(expected, opts) {
+        const deadline = Date.now() + Math.max(0, opts.deadlineMs);
+        let last = null;
+        let lastError = "DeepSeek Harness bridge is unavailable.";
+        do {
+            try {
+                last = await this.status();
+                const currentMatches = last.current?.generation === expected.generation &&
+                    last.current.media === expected.media;
+                if (currentMatches && last.readyClients > 0) {
+                    return {
+                        status: "pass",
+                        reason: "DeepSeek Harness client acknowledged the background.",
+                        details: { ...last },
+                    };
+                }
+                if (currentMatches && last.failedClients > 0 && last.readyClients === 0) {
+                    return {
+                        status: "fail",
+                        reason: "DeepSeek Harness client failed to render the background.",
+                        details: { ...last },
+                    };
+                }
+                lastError =
+                    last.connectedClients === 0
+                        ? "No DeepSeek Harness browser client is connected."
+                        : "DeepSeek Harness client has not acknowledged this generation.";
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error.message : String(error);
+            }
+            if (Date.now() >= deadline)
+                break;
+            await delay(Math.min(this.pollMs, Math.max(0, deadline - Date.now())));
+        } while (true);
+        return {
+            status: "inconclusive",
+            reason: lastError,
+            ...(last ? { details: { ...last } } : {}),
+        };
+    }
+    async #request(route, init) {
+        const endpoint = new URL(`__beauticode/${route}`, this.baseUrl);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.requestTimeoutMs);
+        try {
+            const response = await fetch(endpoint, {
+                ...init,
+                signal: controller.signal,
+                headers: {
+                    Authorization: `Bearer ${this.token}`,
+                    "Content-Type": "application/json",
+                    ...(init.headers ?? {}),
+                },
+            });
+            const body = (await response.json().catch(() => null));
+            if (!response.ok) {
+                const detail = typeof body?.error === "string" ? body.error : `HTTP ${response.status}`;
+                throw new Error(`DeepSeek Harness bridge request failed: ${detail}`);
+            }
+            return body;
+        }
+        catch (error) {
+            if (error?.name === "AbortError") {
+                throw new Error("DeepSeek Harness bridge request timed out.");
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async #setMode(change) {
+        await this.#request("mode", { method: "POST", body: JSON.stringify(change) });
+        const deadline = Date.now() + this.requestTimeoutMs;
+        let last = null;
+        do {
+            try {
+                last = await this.status();
+                if (last.connectedClients === 0) {
+                    return { ok: true, sessions: 0, blocked: false };
+                }
+                if (last.modeReadyClients > 0) {
+                    return {
+                        ok: true,
+                        sessions: last.modeReadyClients,
+                        blocked: last.blockedClients > 0,
+                    };
+                }
+            }
+            catch (error) {
+                if (Date.now() >= deadline) {
+                    return { ok: false, sessions: 0, blocked: false, error: error instanceof Error ? error.message : String(error) };
+                }
+            }
+            if (Date.now() >= deadline)
+                break;
+            await delay(Math.min(this.pollMs, Math.max(0, deadline - Date.now())));
+        } while (true);
+        return {
+            ok: false,
+            sessions: 0,
+            blocked: false,
+            error: last?.connectedClients
+                ? "DeepSeek Harness client did not acknowledge the mode change."
+                : "No DeepSeek Harness browser client is connected.",
+        };
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/vendor/adapter-dsh/host-descriptor.js

@@ -0,0 +1,15 @@
+export const DSH_HOST_DESCRIPTOR = Object.freeze({
+    kind: "dsh",
+    displayName: "DeepSeek Harness",
+    capabilities: Object.freeze({
+        image: true,
+        clear: true,
+        reapply: true,
+        savedThemes: true,
+        video: true,
+        fish: true,
+        muted: true,
+        tone: true,
+    }),
+});
+//# sourceMappingURL=host-descriptor.js.map

package/vendor/adapter-dsh/index.js

@@ -0,0 +1,6 @@
+export { DshHostApplier, normalizeDshBaseUrl, } from "./bridge.js";
+export { DSH_HOST_DESCRIPTOR } from "./host-descriptor.js";
+export { DshSession } from "./session.js";
+export { DSH_BRIDGE_TOKEN_FILE, bridgeTokenPath, ensureBridgeToken, } from "./token.js";
+export { toChineseErrorMessage } from "../core/index.js";
+//# sourceMappingURL=index.js.map

package/vendor/adapter-dsh/injector-lock.js

@@ -0,0 +1,27 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { acquireFileLock } from "../core/index.js";
+/** Shares injector.lock with the Codex adapter to prevent cross-host writes. */
+export async function acquireDshInjectorLock(dataRoot) {
+    await fs.mkdir(dataRoot, { recursive: true });
+    const file = path.join(dataRoot, "injector.lock");
+    const lease = await acquireFileLock(file, { purpose: "beautiCode injector" });
+    const lock = {
+        pid: lease.owner.pid,
+        port: 0,
+        host: "dsh",
+        startedAt: lease.owner.startedAt,
+        nonce: lease.owner.nonce,
+    };
+    const handle = await fs.open(file, "r+");
+    try {
+        await handle.truncate(0);
+        await handle.writeFile(`${JSON.stringify(lock, null, 2)}\n`, "utf8");
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    return () => lease.release();
+}
+//# sourceMappingURL=injector-lock.js.map

package/vendor/adapter-dsh/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@beauticode/adapter-dsh",
+  "type": "module",
+  "main": "./index.js"
+}