@rynx-ai/cli 0.1.10

package/dist/legacy-adapter.js

@@ -0,0 +1,63 @@
+import { spawn } from "node:child_process";
+import { existsSync, realpathSync, statSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+const LEGACY_CLI_ENV = "RYNX_LEGACY_CLI_PATH";
+/**
+ * Temporary bridge for commands whose daemon-owned mutation has no management
+ * RPC yet. It crosses the package boundary as a subprocess, never by importing
+ * daemon implementation modules into the CLI process.
+ */
+export async function runLegacyDaemonCli(args) {
+    const cliPath = resolveLegacyDaemonCli();
+    if (!cliPath) {
+        throw new Error("This command still requires the legacy daemon CLI, but it is not installed. " +
+            `Set ${LEGACY_CLI_ENV} to its absolute cli.js path or use the bundled Rynx App.`);
+    }
+    return new Promise((resolve, reject) => {
+        const child = spawn(process.execPath, [cliPath, ...args], {
+            stdio: "inherit",
+            env: process.env,
+        });
+        child.once("error", (error) => {
+            reject(new Error(`failed to launch legacy daemon CLI: ${error.message}`));
+        });
+        child.once("exit", (code, signal) => {
+            if (signal) {
+                reject(new Error(`legacy daemon CLI exited with signal ${signal}`));
+                return;
+            }
+            resolve(code ?? 1);
+        });
+    });
+}
+export function resolveLegacyDaemonCli(env = process.env, moduleUrl = import.meta.url) {
+    const configured = env[LEGACY_CLI_ENV];
+    if (configured !== undefined) {
+        if (!path.isAbsolute(configured)) {
+            throw new Error(`${LEGACY_CLI_ENV} must be an absolute path`);
+        }
+        return validateCliFile(configured);
+    }
+    // Works both in the workspace and when @rynx-ai/cli and @rynx-ai/daemon are
+    // siblings under node_modules/@rynx-ai.
+    const sibling = fileURLToPath(new URL("../../daemon/dist/cli.js", moduleUrl));
+    return validateCliFile(sibling);
+}
+function validateCliFile(candidate) {
+    try {
+        if (!existsSync(candidate) || !statSync(candidate).isFile())
+            return null;
+        const resolved = realpathSync(candidate);
+        const current = process.argv[1];
+        if (current &&
+            existsSync(current) &&
+            realpathSync(current) === resolved) {
+            return null;
+        }
+        return resolved;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/run-cli.d.ts

@@ -0,0 +1 @@
+export declare function runCli(argv: readonly string[]): Promise<number>;

package/dist/run-cli.js

@@ -0,0 +1,62 @@
+import { runAgentCommand } from "./commands/agent.js";
+import { runAppDistributionCommand, shouldUseAppDistributionCommand, } from "./commands/app-distribution.js";
+import { runBrowserCommand } from "./commands/browser.js";
+import { runCleanupCommand } from "./commands/cleanup.js";
+import { runEmulatorCommand } from "./commands/emulator.js";
+import { fail } from "./commands/errors.js";
+import { runPluginCommand, runPluginManageCommand, } from "./commands/plugin.js";
+import { runRuntimeCommand } from "./commands/runtime.js";
+import { runSkillsCommand } from "./commands/skills.js";
+import { runLegacyDaemonCli } from "./legacy-adapter.js";
+import { USAGE } from "./usage.js";
+import { installedVersion } from "./version.js";
+const LEGACY_TOP_LEVEL_COMMANDS = new Set([
+    "setup",
+    "doctor",
+    "update",
+    "start",
+    "restart",
+    "stop",
+    "status",
+    "logs",
+]);
+export async function runCli(argv) {
+    const [command] = argv;
+    if (shouldUseAppDistributionCommand(command)) {
+        return runAppDistributionCommand(command, argv.slice(1));
+    }
+    if (command && LEGACY_TOP_LEVEL_COMMANDS.has(command)) {
+        return runLegacyDaemonCli(argv);
+    }
+    switch (command) {
+        case "version":
+        case "--version":
+            console.log(installedVersion());
+            return 0;
+        case "plugin":
+            if (argv[1] === "manage") {
+                return runPluginManageCommand(argv.slice(2));
+            }
+            return runPluginCommand(argv.slice(1));
+        case "agent":
+            return runAgentCommand(argv.slice(1));
+        case "emulator":
+            return runEmulatorCommand(argv.slice(1));
+        case "runtime":
+            return runRuntimeCommand(argv.slice(1));
+        case "skills":
+            return runSkillsCommand(argv.slice(1));
+        case "browser":
+            return runBrowserCommand(argv.slice(1));
+        case "cleanup":
+            return runCleanupCommand(argv.slice(1));
+        case undefined:
+        case "help":
+        case "-h":
+        case "--help":
+            console.log(USAGE);
+            return 0;
+        default:
+            fail(`Unknown command: ${command}\n\n${USAGE}`);
+    }
+}

package/dist/usage.d.ts

@@ -0,0 +1 @@
+export declare const USAGE = "Usage: rynx <command>\n\nGeneral:\n  version | --version  print the installed Rynx version\n\nSetup:\n  setup              interactive configuration wizard\n  doctor             read-only health check\n\nLifecycle:\n  start | restart | stop | status | logs\n  update [version] [--check] [--json]\n\nPlugins:\n  plugin manage list\n  plugin manage install <source> [--force] [--grant-all] [--expect-digest <sha256-...>] [...]\n  plugin manage update <id> [--grant-all] [--expect-digest <sha256-...>] [...]\n  plugin manage enable|disable|uninstall <id>\n  plugin <id> <command>       invoke a plugin command through daemon RPC\n\nAgents:\n  agent list\n  agent show <id>\n  agent add <id>\n  agent rm <id>\n\nBuiltin Skills:\n  skills list [--json]\n  skills get <name> [--json]\n\nMaintenance:\n  cleanup sessions [--dry-run]\n\nEmulator:\n  emulator <args...>\n\nRemote Runtime:\n  runtime share --address <host|ws-url> [--label <label>] [--json]\n  runtime add --pairing-code <rynx://...> [--name <name>]\n  runtime list [--json]\n  runtime test <local|daemon-id> [--json]\n  runtime forget <daemon-id>\n  runtime clients list [--json]\n  runtime clients revoke <grant-id>\n\nBrowser:\n  browser install|update|version|clean [...]\n  browser open [url] --session <id> [--runtime <local|daemon-id>] [--json]\n  browser status|pages|close --session <id> [--runtime <local|daemon-id>] [--json]\n  browser endpoint [--ensure] --session <local-id> [--json]\n  browser snapshot --session <local-id> [--json]\n  browser navigate <url> --session <local-id> [--json]\n  browser click (--ref <ref>|--selector <css>|--x <n> --y <n>) --session <local-id> [--json]\n  browser type (--ref <ref>|--selector <css>) --text <text> --session <local-id> [--json]\n  browser screenshot --output <absolute-path> --session <local-id> [--json]\n";

package/dist/usage.js

@@ -0,0 +1,56 @@
+export const USAGE = `Usage: rynx <command>
+
+General:
+  version | --version  print the installed Rynx version
+
+Setup:
+  setup              interactive configuration wizard
+  doctor             read-only health check
+
+Lifecycle:
+  start | restart | stop | status | logs
+  update [version] [--check] [--json]
+
+Plugins:
+  plugin manage list
+  plugin manage install <source> [--force] [--grant-all] [--expect-digest <sha256-...>] [...]
+  plugin manage update <id> [--grant-all] [--expect-digest <sha256-...>] [...]
+  plugin manage enable|disable|uninstall <id>
+  plugin <id> <command>       invoke a plugin command through daemon RPC
+
+Agents:
+  agent list
+  agent show <id>
+  agent add <id>
+  agent rm <id>
+
+Builtin Skills:
+  skills list [--json]
+  skills get <name> [--json]
+
+Maintenance:
+  cleanup sessions [--dry-run]
+
+Emulator:
+  emulator <args...>
+
+Remote Runtime:
+  runtime share --address <host|ws-url> [--label <label>] [--json]
+  runtime add --pairing-code <rynx://...> [--name <name>]
+  runtime list [--json]
+  runtime test <local|daemon-id> [--json]
+  runtime forget <daemon-id>
+  runtime clients list [--json]
+  runtime clients revoke <grant-id>
+
+Browser:
+  browser install|update|version|clean [...]
+  browser open [url] --session <id> [--runtime <local|daemon-id>] [--json]
+  browser status|pages|close --session <id> [--runtime <local|daemon-id>] [--json]
+  browser endpoint [--ensure] --session <local-id> [--json]
+  browser snapshot --session <local-id> [--json]
+  browser navigate <url> --session <local-id> [--json]
+  browser click (--ref <ref>|--selector <css>|--x <n> --y <n>) --session <local-id> [--json]
+  browser type (--ref <ref>|--selector <css>) --text <text> --session <local-id> [--json]
+  browser screenshot --output <absolute-path> --session <local-id> [--json]
+`;

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare function installedVersion(): string;

package/dist/version.js

@@ -0,0 +1,8 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+export function installedVersion() {
+    const version = require("../package.json").version;
+    return typeof version === "string" && version.trim() !== ""
+        ? version
+        : "0.0.0";
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@rynx-ai/cli",
+  "version": "0.1.10",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rynx-ai/rynx.git",
+    "directory": "packages/cli"
+  },
+  "description": "Rynx command-line client and local control-plane management surface.",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "bin": {
+    "rynx": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./commands": {
+      "types": "./dist/commands/index.d.ts",
+      "default": "./dist/commands/index.js"
+    }
+  },
+  "dependencies": {
+    "ws": "^8.21.0",
+    "@rynx-ai/core": "0.1.10",
+    "@rynx-ai/emulator": "0.1.10",
+    "@rynx-ai/protocol": "0.1.10",
+    "@rynx-ai/browser-cdp": "0.1.10"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1"
+  },
+  "scripts": {
+    "build": "rm -rf dist skills && tsc -p tsconfig.json && chmod +x dist/cli.js && mkdir -p skills && cp -R ../../skills/rynx-cli skills/"
+  }
+}

package/skills/rynx-cli/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: rynx-cli
+description: Operate Rynx-managed local and remote runtimes through the bundled `rynx` CLI, including Browser inspection and automation, Emulator control, runtime pairing, and plugin commands. Use when a task needs to inspect or act on a Rynx Session Browser or Emulator, manage a Rynx runtime target, or invoke a Rynx plugin. Prefer this bundled CLI over direct CDP calls, guessed ports, globally installed browser drivers, or ad-hoc device tools.
+---
+
+# Rynx CLI
+
+Use the bundled `rynx` command. Rynx supplies the correct executable and current
+Session context; do not locate another installation with `which`, `npx`, or npm.
+
+## Choose the target
+
+- Inside a Rynx Session, omit `--session`; the injected Session credential
+  restricts commands to that Session.
+- Outside a managed Session, pass `--session <id>`.
+- Add `--runtime <local|daemon-id>` only when the user explicitly selected a
+  different paired Runtime.
+- Prefer `--json` for inspection and automation output.
+
+If the CLI reports that the daemon is unavailable, ask the user to open Rynx or
+enable its resident daemon. Never start an unrelated service or guess a port.
+
+## Browser workflow
+
+Open the Session Browser when needed:
+
+```sh
+rynx browser open https://example.com --json
+```
+
+Inspect before acting:
+
+```sh
+rynx browser snapshot --json
+```
+
+Use a returned `ref` for the next action. Take a fresh snapshot after navigation
+or substantial DOM replacement because old references become stale.
+
+```sh
+rynx browser click --ref <ref> --json
+rynx browser type --ref <ref> --text "hello" --json
+rynx browser navigate https://example.com/next --json
+rynx browser screenshot --output /absolute/path/page.png --json
+```
+
+Use `--selector` only when no useful accessibility reference exists. Use
+coordinate clicks only as a final fallback after a screenshot.
+
+Useful inspection commands:
+
+```sh
+rynx browser status --json
+rynx browser pages --json
+```
+
+Do not request or connect to the raw CDP endpoint unless diagnosing Rynx itself.
+Do not close a Browser generation that the user still needs.
+
+## Emulator workflow
+
+Inspect available commands and devices before acting:
+
+```sh
+rynx emulator --help
+rynx emulator devices
+rynx emulator active
+```
+
+Use the Session's bound device by default. Select another device or Runtime only
+when the user asks. Re-inspect the screen after every navigation or state-changing
+input, and never call `kill` or `shutdown` as cleanup unless requested.
+
+## Runtime and plugin operations
+
+List and test Runtime targets before selecting a remote target:
+
+```sh
+rynx runtime list --json
+rynx runtime test <local|daemon-id> --json
+```
+
+Invoke plugin-declared commands through:
+
+```sh
+rynx plugin <plugin-id> <command> --json
+```
+
+Treat pairing, client revocation, plugin installation, Browser engine updates,
+and daemon lifecycle changes as administrative operations. Perform them only
+when the user explicitly requests them.
+
+## Failure handling
+
+- On `stale reference`, take a new Browser snapshot and retry once.
+- On `busy`, preserve the current Turn or Terminal and let the user resolve it.
+- On an unavailable capability, report the missing App integration or macOS
+  permission; do not install an unpinned replacement.
+- Preserve structured error codes and relevant stderr when reporting failure.

package/skills/rynx-cli/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Rynx CLI"
+  short_description: "Control Rynx Browser, Emulator, and local runtime"
+  default_prompt: "Use $rynx-cli to inspect and operate the current Rynx runtime."