@rynx-ai/daemon 0.1.0 → 0.1.10-beta.2

package/dist/setup.d.ts

@@ -1,4 +1,20 @@
+type ControlListenMode = "loopback" | "host";
+type ManagedBrowserSetupPlan = {
+    kind: "ready";
+} | {
+    kind: "unsupported";
+} | {
+    kind: "offer";
+    installByDefault: boolean;
+};
+export declare function controlListenModeFromHost(host: unknown): ControlListenMode;
+export declare function controlHostForListenMode(mode: ControlListenMode): "127.0.0.1" | "0.0.0.0";
+export declare function managedBrowserSetupPlan(listenMode: ControlListenMode, browser: {
+    supported: boolean;
+    installed: boolean;
+}): ManagedBrowserSetupPlan;
 /** Walk the user through config.json step by step. Returns a process exit code. */
 export declare function runSetup(): Promise<number>;
 /** Read-only diagnostics. Returns a process exit code (0 ok, 1 on any failure). */
 export declare function runDoctor(): Promise<number>;
+export {};

package/dist/setup.js

@@ -15,20 +15,45 @@ import { join } from "node:path";
 import * as p from "@clack/prompts";
 import { AGENT_RUNTIME_IDS, getRuntimeProfile, listAgentSpecs, loadConfig, resolveRuntimeHome, rynxAgentsDir, rynxConfigFile, rynxHome, } from "@rynx-ai/core";
 import { listChannels } from "./channel-store.js";
+import { resolveChromeForTestingRelease } from "./chrome-for-testing-release-resolver.js";
+import { createChromeForTestingArtifactStore, isChromeForTestingHostSupported, } from "./chrome-for-testing-store.js";
 import { dbPath } from "./db.js";
 import { listInstances } from "./instance-store.js";
-import { listPlugins } from "./plugin-store.js";
+import { isRunnablePluginRecord, listPlugins } from "./plugin-store.js";
 import { formatControlUrl } from "./pm2.js";
 const MIN_NODE_MAJOR = 20;
+export function controlListenModeFromHost(host) {
+    const normalized = typeof host === "string" ? host.trim().replace(/^\[|\]$/g, "") : "";
+    return normalized === "" ||
+        normalized === "127.0.0.1" ||
+        normalized === "::1" ||
+        normalized.toLowerCase() === "localhost"
+        ? "loopback"
+        : "host";
+}
+export function controlHostForListenMode(mode) {
+    return mode === "host" ? "0.0.0.0" : "127.0.0.1";
+}
+export function managedBrowserSetupPlan(listenMode, browser) {
+    if (!browser.supported)
+        return { kind: "unsupported" };
+    if (browser.installed)
+        return { kind: "ready" };
+    return { kind: "offer", installByDefault: listenMode === "host" };
+}
 // ── rynx setup — interactive wizard ─────────────────────────────────────────
 /** Walk the user through config.json step by step. Returns a process exit code. */
 export async function runSetup() {
     if (!process.stdin.isTTY || !process.stdout.isTTY) {
         // Non-interactive (CI / piped): never block on a prompt — just ensure defaults.
         if (!existsSync(rynxConfigFile()))
-            writeConfig({ HOST: "0.0.0.0", PORT: 3000, LOG_LEVEL: "info" });
+            writeConfig({ HOST: "127.0.0.1", PORT: 3000, LOG_LEVEL: "info" });
+        const browser = inspectManagedBrowser();
         console.log(`非交互环境:已确保 ${rynxConfigFile()} 存在(默认值)。` +
-            "在终端(TTY)下重跑 `rynx setup` 可分步配置,或直接编辑该文件。");
+            "在终端(TTY)下重跑 `rynx setup` 可分步配置,或直接编辑该文件。" +
+            (browser.supported && !browser.installed
+                ? "\nSession Browser 尚未安装；需要时运行 `rynx browser install`。"
+                : ""));
         return 0;
     }
     p.intro("rynx setup · 配置 ~/.rynx");
@@ -81,15 +106,89 @@ export async function runSetup() {
     if (p.isCancel(port))
         return bail();
     cfg.PORT = Number(port);
-    cfg.HOST = cfg.HOST ?? "0.0.0.0";
+    const listenMode = await p.select({
+        message: "控制台访问范围 HOST",
+        initialValue: controlListenModeFromHost(cfg.HOST),
+        options: [
+            {
+                value: "loopback",
+                label: "仅本机（Loopback，推荐）",
+                hint: "绑定 127.0.0.1",
+            },
+            {
+                value: "host",
+                label: "网络访问（Host）",
+                hint: "绑定 0.0.0.0，可信网络可通过机器 IP 访问",
+            },
+        ],
+    });
+    if (p.isCancel(listenMode))
+        return bail();
+    cfg.HOST = controlHostForListenMode(listenMode);
     cfg.LOG_LEVEL = cfg.LOG_LEVEL ?? "info";
+    const browserBeforeSetup = inspectManagedBrowser();
+    const browserPlan = managedBrowserSetupPlan(listenMode, {
+        supported: browserBeforeSetup.supported,
+        installed: Boolean(browserBeforeSetup.installed),
+    });
+    let installBrowser = false;
+    if (browserPlan.kind === "ready") {
+        p.log.success(`Session Browser 已就绪 · Chrome for Testing ${browserBeforeSetup.installed.version}`);
+    }
+    else if (browserPlan.kind === "unsupported") {
+        p.log.info(`当前平台 ${process.platform}-${process.arch} 不支持 managed Chrome for Testing；跳过 Browser 安装。`);
+    }
+    else {
+        p.note([
+            "Session Browser 让 agent 在当前 Runtime 上打开和操作网页。",
+            listenMode === "host"
+                ? "网络访问模式下，外部浏览器不能提供 Desktop Browser Host，因此推荐安装无头 Browser。"
+                : "桌面 App 可使用内置 Browser；独立 daemon 或远端 Runtime 仍需要无头 Browser。",
+            "安装会从 Chrome for Testing 官方源下载浏览器，不会改动系统浏览器。",
+            ...(process.platform === "linux"
+                ? ["Linux 的动态库和字体依赖仍需由系统或主机镜像提供。"]
+                : []),
+        ].join("\n"), "Session Browser（可选）");
+        const choice = await p.confirm({
+            message: "现在安装 managed Chrome for Testing？",
+            initialValue: browserPlan.installByDefault,
+        });
+        if (p.isCancel(choice))
+            return bail();
+        installBrowser = choice;
+    }
     writeConfig(cfg);
     p.log.success(`已写入 ${rynxConfigFile()}(chmod 600)`);
     p.log.message(`HOST=${cfg.HOST}  PORT=${cfg.PORT}  AGENT_RUNTIME=${cfg.AGENT_RUNTIME ?? "(默认)"}`);
-    const url = formatControlUrl(String(cfg.HOST ?? "0.0.0.0"), Number(cfg.PORT ?? 3000));
+    let browserReady = browserPlan.kind === "ready";
+    if (installBrowser) {
+        const spinner = p.spinner();
+        spinner.start("准备安装 Stable Chrome for Testing");
+        try {
+            const release = await resolveChromeForTestingRelease({
+                kind: "channel",
+                channel: "Stable",
+            });
+            const installedBrowser = await createChromeForTestingArtifactStore().installResolved(release, { onProgress: (message) => spinner.message(message) });
+            browserReady = true;
+            spinner.stop(`Session Browser 已就绪 · Chrome for Testing ${installedBrowser.version}`);
+        }
+        catch (error) {
+            spinner.error("Session Browser 安装失败");
+            p.log.warn(`${error instanceof Error ? error.message : String(error)}\n` +
+                "配置已保存；修复网络或系统依赖后运行 `rynx browser install` 重试。");
+        }
+    }
+    else if (browserPlan.kind === "offer") {
+        p.log.info("已跳过 Browser 安装；需要时运行 `rynx browser install`。");
+    }
+    const url = formatControlUrl(String(cfg.HOST ?? "127.0.0.1"), Number(cfg.PORT ?? 3000));
     p.note([
         `启动常驻服务   rynx start`,
         `打开控制台     ${url}`,
+        browserReady
+            ? "Session Browser  已就绪"
+            : "启用 Browser    rynx browser install",
         `新建 agent     rynx agent add <id>`,
         `随时体检       rynx doctor`,
     ].join("\n"), "下一步");
@@ -146,6 +245,11 @@ export async function runDoctor() {
     else {
         const plugins = listPlugins();
         p.log.info(`插件:${plugins.length} 个${plugins.length ? `(${plugins.map((pl) => pl.name).join(", ")})` : ""}`);
+        const legacyPlugins = plugins.filter((plugin) => !isRunnablePluginRecord(plugin));
+        if (legacyPlugins.length > 0) {
+            p.log.warn(`需重新安装的旧插件:${legacyPlugins.map((plugin) => plugin.name).join(", ")}`);
+            warn++;
+        }
         const channels = listChannels();
         const configured = channels.filter((c) => c.options && Object.keys(c.options).length > 0).length;
         p.log.info(`channel:${channels.length} 个(${configured} 已配置凭据)  ·  instance:${listInstances().length} 个`);
@@ -153,6 +257,24 @@ export async function runDoctor() {
             (p.log.warn("还没有 channel —— 在 Web 控制台新建并授权"), warn++);
     }
     p.log.info(`agent:${(await listAgentSpecs()).length} 个(${rynxAgentsDir()})`);
+    const browser = inspectManagedBrowser();
+    if (!browser.supported) {
+        p.log.info(`Session Browser:当前平台 ${process.platform}-${process.arch} 不受支持`);
+    }
+    else if (browser.installed) {
+        p.log.success(`Session Browser:Chrome for Testing ${browser.installed.version} 已安装`);
+        if (process.platform === "linux") {
+            p.log.info("Linux Browser 动态库和字体依赖由系统或主机镜像提供");
+        }
+    }
+    else if (browser.error) {
+        p.log.warn(`Session Browser 安装无效:${browser.error} —— 运行 \`rynx browser install\` 修复`);
+        warn++;
+    }
+    else {
+        p.log.warn("Session Browser 未安装 —— 运行 `rynx browser install`");
+        warn++;
+    }
     if (fail > 0) {
         p.outro(`体检发现 ${fail} 个失败项(警告 ${warn})—— 处理后重跑 rynx doctor`);
         return 1;
@@ -160,6 +282,23 @@ export async function runDoctor() {
     p.outro(warn > 0 ? `基本就绪,有 ${warn} 个警告` : "全部通过 ✓");
     return 0;
 }
+function inspectManagedBrowser() {
+    if (!isChromeForTestingHostSupported())
+        return { supported: false };
+    try {
+        return {
+            supported: true,
+            installed: createChromeForTestingArtifactStore().readActive(),
+        };
+    }
+    catch (error) {
+        return {
+            supported: true,
+            installed: undefined,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
 function runtimeState(id) {
     const profile = getRuntimeProfile(id);
     const installed = onPath(profile.defaultBinary);

package/dist/skills-catalog.js

@@ -12,7 +12,7 @@ const SKILL_NAME_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/;
 /** A single file's contents are capped to keep responses small. */
 const MAX_SKILL_FILE_BYTES = 256 * 1024;
 export function listCatalogSkills() {
-    return scanSkillsDir(rynxSkillsDir());
+    return listMergedSkills();
 }
 /** Install a skill (or a repo's skills) into the catalog per a full install
  *  recipe; delegates to the core catalog layer (which also writes each skill's
@@ -20,7 +20,7 @@ export function listCatalogSkills() {
  *  the refreshed catalog. */
 export async function installCatalogSkill(recipe) {
     await installIntoCatalog(recipe, rynxSkillsDir());
-    return scanSkillsDir(rynxSkillsDir());
+    return listMergedSkills();
 }
 /** Detail for one catalog skill: its metadata + the file tree under its dir. */
 export async function getCatalogSkill(name) {
@@ -30,6 +30,7 @@ export async function getCatalogSkill(name) {
     const meta = await readSkillMeta(dir);
     if (!meta)
         return null;
+    const ref = meta.ref;
     const files = await walkSkillFiles(dir, dir);
     let frontmatter;
     try {
@@ -41,7 +42,7 @@ export async function getCatalogSkill(name) {
     return {
         name: meta.name,
         description: meta.description,
-        ...(meta.ref ? { ref: meta.ref } : {}),
+        ...(ref ? { ref } : {}),
         frontmatter,
         totalSize: files.reduce((sum, f) => sum + f.size, 0),
         files,
@@ -63,7 +64,7 @@ async function walkSkillFiles(root, dir) {
 export async function readCatalogSkillFile(name, relPath) {
     if (!SKILL_NAME_PATTERN.test(name))
         throw new Error(`invalid skill name: ${name}`);
-    const dir = path.resolve(rynxSkillsDir(), name);
+    const dir = path.resolve(path.join(rynxSkillsDir(), name));
     const target = path.resolve(dir, relPath);
     if (target !== dir && !target.startsWith(dir + path.sep)) {
         throw new Error("path escapes the skill directory");
@@ -78,6 +79,9 @@ export async function readCatalogSkillFile(name, relPath) {
         throw new Error("binary file — not viewable");
     return { path: relPath, content: buf.toString("utf8") };
 }
+async function listMergedSkills() {
+    return (await scanSkillsDir(rynxSkillsDir())).sort((a, b) => a.name.localeCompare(b.name));
+}
 /** Remove a catalog skill by name. Returns false if it wasn't present. */
 export async function removeCatalogSkill(name) {
     if (!SKILL_NAME_PATTERN.test(name))

package/dist/update.d.ts

@@ -1,11 +1,20 @@
-import { type UpdateCheck } from "@rynx-ai/core";
 export interface UpdateOptions {
     check?: boolean;
     /** With `check`, emit a typed {@link UpdateCheck} as JSON instead of a human line. */
     json?: boolean;
     version?: string;
-    resultFile?: string;
 }
+export type UpdateCheck = {
+    status: "up_to_date";
+    current: string;
+} | {
+    status: "behind";
+    current: string;
+    latest: string;
+} | {
+    status: "error";
+    detail: string;
+};
 /** Is `latest` a newer release than `current`? Numeric major.minor.patch (prerelease ignored). */
 export declare function isNewer(latest: string, current: string): boolean;
 /** Typed `--check` result a channel consumes via `--check --json`. */

package/dist/update.js

@@ -7,12 +7,8 @@
  *   rynx update [version]                 upgrade (to a version, or latest) + restart
  *   rynx update --check                   report status only (human one-liner)
  *   rynx update --check --json            report status only (typed UpdateCheck JSON)
- *   rynx update --result-file <path>      after finishing, write the outcome JSON to
- *                                         <path> (channel-agnostic UpdateOutcome; a
- *                                         plugin reads it post-restart to notify a chat)
  */
 import { spawnSync } from "node:child_process";
-import { mkdirSync, writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, sep } from "node:path";
 import { loadConfig } from "@rynx-ai/core";
@@ -98,19 +94,6 @@ async function verifyHealthy() {
     }
     return false;
 }
-/** Write the post-restart outcome to `--result-file` (best-effort; stamps `at`). */
-function writeOutcome(file, outcome) {
-    if (!file)
-        return;
-    try {
-        mkdirSync(dirname(file), { recursive: true });
-        const full = { ...outcome, at: new Date().toISOString() };
-        writeFileSync(file, `${JSON.stringify(full, null, 2)}\n`);
-    }
-    catch {
-        /* best-effort */
-    }
-}
 /** Run `rynx update`. Returns a process exit code. */
 export async function runUpdate(opts) {
     const { name, version: current } = selfPackage();
@@ -122,13 +105,11 @@ export async function runUpdate(opts) {
     // Never `npm install -g` over a working checkout / linked dev build.
     if (isLocalDevInstall()) {
         console.error(`update: ${name} is a local dev install — update your checkout (e.g. pnpm build), not npm`);
-        writeOutcome(opts.resultFile, { status: "fail", from: current, to: current, error: "local dev install" });
         return 1;
     }
     const target = opts.version ?? latest;
     if (!target) {
         console.error(`update: could not resolve a target version for ${name} (registry unreachable?)`);
-        writeOutcome(opts.resultFile, { status: "fail", from: current, to: current, error: "could not resolve target version" });
         return 1;
     }
     if (!opts.version && latest && !isNewer(latest, current)) {
@@ -138,12 +119,6 @@ export async function runUpdate(opts) {
     console.log(`Updating ${name}: ${current} → ${target} …`);
     if (!npmInstallGlobal(name, target)) {
         console.error("update: npm install failed");
-        writeOutcome(opts.resultFile, { status: "fail", from: current, to: target, error: "npm install failed" });
-        // The install failed before any restart, so the channel that spawned us never
-        // reboots to drain the outcome. Bounce the daemon (still on the old, healthy
-        // version) so its boot-time drain delivers the failure to chat.
-        if (opts.resultFile)
-            startDaemon({ force: true });
         return 1;
     }
     startDaemon({ force: true });
@@ -151,10 +126,8 @@ export async function runUpdate(opts) {
         console.error(`update: ${name}@${target} did not come back up — rolling back to ${current}`);
         npmInstallGlobal(name, current);
         startDaemon({ force: true });
-        writeOutcome(opts.resultFile, { status: "fail", from: current, to: target, error: "did not come up; rolled back" });
         return 1;
     }
     console.log(`Updated ${name} → ${target} and restarted.`);
-    writeOutcome(opts.resultFile, { status: "ok", from: current, to: target });
     return 0;
 }

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@rynx-ai/daemon",
-  "version": "0.1.0",
-  "description": "rynx daemon CLI: supervises the resident @rynx-ai/server via pm2 and loads channel plugins recorded in ~/.rynx/rynx.db.",
+  "version": "0.1.10-beta.2",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rynx-ai/rynx.git",
+    "directory": "packages/daemon"
+  },
+  "description": "Rynx daemon CLI: supervises the local agent control plane and isolated optional plugin runtimes.",
   "type": "module",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -15,20 +20,28 @@
   },
   "main": "./dist/index-daemon.js",
   "exports": {
-    "./server": {
-      "types": "./dist/daemon-server.d.ts",
-      "default": "./dist/daemon-server.js"
+    "./client": {
+      "types": "./dist/control-client.d.ts",
+      "default": "./dist/control-client.js"
     }
   },
   "dependencies": {
     "@clack/prompts": "^1.6.0",
     "better-sqlite3": "^12.11.1",
+    "extract-zip": "2.0.1",
     "pm2": "^6.0.0",
-    "zod": "^4.3.6",
-    "@rynx-ai/core": "0.1.0",
-    "@rynx-ai/protocol": "0.1.0",
-    "@rynx-ai/server": "0.1.0",
-    "@rynx-ai/emulator": "0.1.7"
+    "tar": "^7.5.19",
+    "ws": "^8.21.0",
+    "@rynx-ai/core": "0.1.10-beta.2",
+    "@rynx-ai/emulator": "0.1.10-beta.2",
+    "@rynx-ai/plugin-runner": "0.1.10-beta.2",
+    "@rynx-ai/plugin-sdk": "0.1.10-beta.2",
+    "@rynx-ai/protocol": "0.1.10-beta.2",
+    "@rynx-ai/remote-runtime-client": "0.1.10-beta.2",
+    "@rynx-ai/server": "0.1.10-beta.2"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1"
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.json && chmod +x dist/cli.js dist/index-daemon.js",