@tcb-sandbox/cli 0.3.7

package/dist/sdk-client.js

@@ -0,0 +1,50 @@
+import { TcbSandboxClient } from "@tcb-sandbox/sdk-js";
+export { TcbSandboxClient };
+export async function createSdkClient(clientClass, opts) {
+    const client = new clientClass({
+        baseUrl: opts.endpoint,
+        cloudbaseSessionId: opts.sessionId,
+        headers: opts.headers,
+        timeoutInSeconds: opts.timeoutMs ? Math.floor(opts.timeoutMs / 1000) : undefined,
+    });
+    return client;
+}
+export const TOOL_METHOD_MAP = {
+    bash: "execution.bash",
+    batch: "execution.batch",
+    read: "fileOperations.read",
+    write: "fileOperations.write",
+    edit: "fileOperations.edit",
+    filesUpload: "fileOperations.filesUpload",
+    filesDownload: "fileOperations.filesDownload",
+    grep: "search.grep",
+    glob: "search.glob",
+    ls: "search.ls",
+    ptyCreate: "ptyTerminal.ptyCreate",
+    ptySendInput: "ptyTerminal.ptySendInput",
+    ptyResize: "ptyTerminal.ptyResize",
+    ptyReadOutput: "ptyTerminal.ptyReadOutput",
+    ptyKill: "ptyTerminal.ptyKill",
+    set: "secrets.set",
+    get: "secrets.get",
+    list: "secrets.list",
+    delete: "secrets.delete",
+    ports: "preview.ports",
+    url: "preview.url",
+    push: "git.push",
+    capabilityList: "capabilitySystem.capabilityList",
+    capabilityInstall: "capabilitySystem.capabilityInstall",
+    capabilityRegister: "capabilitySystem.capabilityRegister",
+    capabilityRemove: "capabilitySystem.capabilityRemove",
+    capabilityDescribe: "capabilitySystem.capabilityDescribe",
+    capabilityInvoke: "capabilitySystem.capabilityInvoke",
+    listMcpServers: "mcpServerManagement.listMcpServers",
+    mcporterCli: "mcpServerManagement.mcporterCli",
+    addMcpServers: "mcpServerManagement.addMcpServers",
+    removeMcpServers: "mcpServerManagement.removeMcpServers",
+    workspaceSnapshot: "other.workspaceSnapshot",
+    workspaceSnapshotStatus: "other.workspaceSnapshotStatus",
+    workspaceRestore: "other.workspaceRestore",
+    health: "system.health",
+    apiDocs: "system.apiDocs",
+};

package/dist/serve.d.ts

@@ -0,0 +1,13 @@
+export interface ServeOptions {
+    host: string;
+    port: number;
+    workspaceRoot: string;
+}
+export declare function resolveTrwMain(): string;
+/** Default workspace root for local multi-session sandboxes. */
+export declare function defaultWorkspaceRoot(): string;
+export declare function printServeBanner(opts: ServeOptions, trwMain: string): void;
+/**
+ * Spawn TRW with inherited stdio; resolve when the child exits.
+ */
+export declare function runServe(opts: ServeOptions): Promise<number | null>;

package/dist/serve.js

@@ -0,0 +1,197 @@
+import { execFileSync, spawn } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+function readJsonVersion(pkgPath) {
+    try {
+        const raw = fs.readFileSync(pkgPath, "utf8");
+        const j = JSON.parse(raw);
+        return typeof j.version === "string" ? j.version : "?";
+    }
+    catch {
+        return "?";
+    }
+}
+function cliPackageVersion() {
+    return readJsonVersion(path.join(__dirname, "..", "package.json"));
+}
+const EMBEDDED_TRW = path.join(__dirname, "trw-embedded.js");
+const RESOLVE_TRW_HINT = "Run `pnpm run build` in @tcb-sandbox/cli (embeds TCB). " +
+    "Or set TCB_SANDBOX_TRW_ENTRY to a built TCB file (…/tcb-remote-workspace/dist/index.js).";
+export function resolveTcbEmbeddedMain() {
+    const tryPath = (p) => {
+        const abs = path.resolve(p);
+        try {
+            if (fs.existsSync(abs) && fs.statSync(abs).isFile())
+                return abs;
+        }
+        catch {
+        }
+        return null;
+    };
+    const env = process.env.TCB_SANDBOX_TRW_ENTRY?.trim();
+    if (env) {
+        const hit = tryPath(env);
+        if (hit)
+            return hit;
+        throw new Error(`TCB_SANDBOX_TRW_ENTRY points to missing file: ${path.resolve(env)}. ${RESOLVE_TRW_HINT}`);
+    }
+    const embedded = tryPath(EMBEDDED_TRW);
+    if (embedded)
+        return embedded;
+    throw new Error(`Embedded TCB not found at ${EMBEDDED_TRW}. ${RESOLVE_TRW_HINT}`);
+}
+function trwPackageVersion(trwMain) {
+    const dir = path.dirname(trwMain);
+    const versionJson = path.join(dir, "trw-version.json");
+    try {
+        if (fs.existsSync(versionJson)) {
+            const j = JSON.parse(fs.readFileSync(versionJson, "utf8"));
+            if (typeof j.version === "string")
+                return j.version;
+        }
+    }
+    catch {
+    }
+    return readJsonVersion(path.join(dir, "..", "package.json"));
+}
+function useColor() {
+    return Boolean(process.stdout.isTTY && !process.env.NO_COLOR && process.env.FORCE_COLOR !== "0");
+}
+function motdStyles() {
+    const on = useColor();
+    if (!on) {
+        return {
+            dim: (s) => s,
+            bold: (s) => s,
+            green: (s) => s,
+            yellow: (s) => s,
+            cyan: (s) => s,
+        };
+    }
+    const DIM = "\x1b[2m";
+    const BOLD = "\x1b[1m";
+    const GREEN = "\x1b[0;32m";
+    const YELLOW = "\x1b[0;33m";
+    const CYAN = "\x1b[0;36m";
+    const RESET = "\x1b[0m";
+    return {
+        dim: (s) => `${DIM}${s}${RESET}`,
+        bold: (s) => `${BOLD}${s}${RESET}`,
+        green: (s) => `${GREEN}${s}${RESET}`,
+        yellow: (s) => `${YELLOW}${s}${RESET}`,
+        cyan: (s) => `${CYAN}${s}${RESET}`,
+    };
+}
+function diskAvailableHuman(targetPath) {
+    if (process.platform === "win32") {
+        return "N/A";
+    }
+    try {
+        const out = execFileSync("df", ["-h", targetPath], { encoding: "utf8", timeout: 5000 }).trim();
+        const line = out.split("\n")[1];
+        if (!line)
+            return "N/A";
+        const parts = line.trim().split(/\s+/);
+        const avail = parts.length >= 4 ? parts[3] : "N/A";
+        return `${avail} available`;
+    }
+    catch {
+        return "N/A";
+    }
+}
+function tryExecVersion(file, args) {
+    try {
+        return execFileSync(file, args, { encoding: "utf8", timeout: 5000 }).trim();
+    }
+    catch {
+        return "?";
+    }
+}
+function bunVersion() {
+    const v = tryExecVersion("bun", ["-v"]);
+    return v === "?" ? "?" : v;
+}
+function pythonVersion() {
+    const line = tryExecVersion("python3", ["--version"]);
+    if (line === "?")
+        return "?";
+    const m = line.match(/(\d+\.\d+\.\d+)/);
+    return m ? m[1] : line.replace(/^Python\s+/i, "") || "?";
+}
+export function defaultWorkspaceRoot() {
+    return path.join(os.homedir(), ".tcb-sandbox", "workspaces");
+}
+const MOTD_ASCII = "\n    ____ _                 _ ____\n   / ___| | ___  _   _  __| | __ )  __ _ ___  ___\n  | |   | |/ _ \\| | | |/ _` |  _ \\ / _` / __|/ _ \\\n  | |___| | (_) | |_| | (_| | |_) | (_| \\__ \\  __/\n   \\____|_|\\___/ \\__,_|\\__,_|____/ \\__,_|___/\\___|\n     Remote Workspace\n";
+export function printServeBanner(opts, trwMain) {
+    const trwVer = trwPackageVersion(trwMain);
+    const cliVer = cliPackageVersion();
+    const displayHost = opts.host === "0.0.0.0" ? "127.0.0.1" : opts.host;
+    const base = `http://${displayHost}:${opts.port}`;
+    const wsRoot = path.resolve(opts.workspaceRoot);
+    const disk = diskAvailableHuman(wsRoot);
+    const nodeVer = process.version;
+    const S = motdStyles();
+    const lines = [];
+    lines.push(MOTD_ASCII.replace(/^\n/, "").replace(/\n$/, ""));
+    lines.push("");
+    lines.push(`  ${S.dim("Listen   :")} ${base}`);
+    lines.push(`  ${S.dim("Session  :")} ${S.bold("X-Cloudbase-Session-Id")} ${S.dim("（示例 test-03271546 → 子目录 test-03271546）")}`);
+    lines.push(`  ${S.dim("Workspace:")} ${wsRoot}${path.sep}${S.dim("<session-id>")}`);
+    lines.push(`  ${S.dim("Disk     :")} ${disk}`);
+    lines.push(`  ${S.dim("Runtime  :")} Node ${nodeVer} · Bun ${bunVersion()} · Python ${pythonVersion()}`);
+    lines.push(`  ${S.dim("Versions :")} TCB ${trwVer} · CLI ${cliVer}`);
+    lines.push("");
+    lines.push(`  ${S.green("▸")} ${S.bold("快速开始")}`);
+    lines.push(`    打开 ${S.cyan(`${base}/reference`)} 查看 HTTP/MCP 说明；容器内还可读 ${S.bold(".workspace-info.md")}`);
+    lines.push("");
+    lines.push(`  ${S.green("▸")} ${S.bold("功能")}`);
+    lines.push(`    ${S.cyan(`${base}/preview/<port>/`)}     dev server 预览${S.dim("（端口 1024–29999）")}`);
+    lines.push(`    ${S.cyan("mcporter")}             MCP 工具调用${S.dim("（list / call）")}`);
+    lines.push(`    ${S.cyan("tcb-sandbox")}          CLI 客户端${S.dim("（health / docs / snapshot / bash ...）")}`);
+    lines.push(`    ${S.cyan("skills")}               AI 技能管理${S.dim("（add / list / find）")}`);
+    lines.push(`    ${S.cyan("tmux")}                 多窗口${S.dim("（Ctrl-b c 新建 · Ctrl-b % 分屏）")}`);
+    lines.push("");
+    lines.push(`  ${S.yellow("▸")} ${S.bold("须知")} ${S.dim("（本机 serve，非 SCF 容器）")}`);
+    lines.push(`    ${S.dim("·")} 默认无鉴权；默认仅监听回环，${S.bold("--host 0.0.0.0")} 会暴露到网络，请自行评估风险`);
+    lines.push(`    ${S.dim("·")} ${S.bold("Ctrl+C")} 停止本进程；无容器冻结 / TTL / 唤醒策略`);
+    lines.push(`    ${S.dim("·")} 若系统 Python 受 PEP 668 限制，用 ${S.bold("uv")} ${S.dim("(推荐)")} 或 ${S.bold("python3 -m venv")}`);
+    lines.push(`    ${S.dim("·")} 各 session 工作区在 ${S.bold(wsRoot + path.sep + "<session-id>")} 下；工具侧路径策略与 tcb-remote-workspace 一致`);
+    lines.push(`    ${S.dim("·")} 长时间任务优先 ${S.bold("tmux")} 或 ${S.bold("tcb-sandbox pty")}；子进程分离 ${S.bold("(cmd > log 2>&1 &)")} 仍可能随会话结束被清理`);
+    lines.push("");
+    process.stdout.write(lines.join("\n"));
+}
+export function runServe(opts) {
+    const trwMain = resolveTcbEmbeddedMain();
+    fs.mkdirSync(opts.workspaceRoot, { recursive: true });
+    printServeBanner(opts, trwMain);
+    const child = spawn(process.execPath, [trwMain], {
+        stdio: "inherit",
+        env: {
+            ...process.env,
+            HOST: opts.host,
+            PORT: String(opts.port),
+            WORKSPACE_ROOT: opts.workspaceRoot,
+        },
+    });
+    const forward = (sig) => {
+        try {
+            child.kill(sig);
+        }
+        catch {
+        }
+    };
+    process.on("SIGINT", () => forward("SIGINT"));
+    process.on("SIGTERM", () => forward("SIGTERM"));
+    return new Promise((resolve, reject) => {
+        child.on("error", reject);
+        child.on("close", (code, signal) => {
+            if (signal)
+                resolve(code);
+            else
+                resolve(code);
+        });
+    });
+}