@rynx-ai/cli 0.1.11-beta.1 → 0.1.11-beta.3

package/dist/app-runtime.d.ts

@@ -0,0 +1,10 @@
+export interface CliDependencyVersions {
+    cliVersion: string;
+    daemonVersion: string;
+}
+/** Read the versions in the dependency closure owned by this CLI installation. */
+export declare function resolveCliDependencyVersions(): CliDependencyVersions;
+/** Resolve the CLI-owned process entry used exclusively by Rynx App. */
+export declare function resolveCliAppRuntimeEntry(moduleUrl?: string): string;
+/** Run the App-owned daemon in this dedicated CLI App Runtime process. */
+export declare function runAppRuntimeProcess(): Promise<void>;

package/dist/app-runtime.js

@@ -0,0 +1,34 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { installedDaemonVersion } from "@rynx-ai/daemon/entry-path";
+import { installedVersion } from "./version.js";
+/** Read the versions in the dependency closure owned by this CLI installation. */
+export function resolveCliDependencyVersions() {
+    return {
+        cliVersion: installedVersion(),
+        daemonVersion: installedDaemonVersion(),
+    };
+}
+/** Resolve the CLI-owned process entry used exclusively by Rynx App. */
+export function resolveCliAppRuntimeEntry(moduleUrl = import.meta.url) {
+    return fileURLToPath(moduleUrl);
+}
+/** Run the App-owned daemon in this dedicated CLI App Runtime process. */
+export async function runAppRuntimeProcess() {
+    if (process.env.RYNX_DISTRIBUTION !== "app") {
+        throw new Error("CLI App Runtime requires RYNX_DISTRIBUTION=app");
+    }
+    if (process.env.RYNX_DAEMON_LIFECYCLE !== "follow-app" &&
+        process.env.RYNX_DAEMON_LIFECYCLE !== "resident") {
+        throw new Error("CLI App Runtime requires an App daemon lifecycle");
+    }
+    const { runDaemonProcess } = await import("@rynx-ai/daemon/internal/process");
+    await runDaemonProcess();
+}
+if (process.argv[1] &&
+    path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url))) {
+    runAppRuntimeProcess().catch((error) => {
+        console.error(error instanceof Error ? error.stack ?? error.message : String(error));
+        process.exitCode = 1;
+    });
+}

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-export { callManagedRuntimeBrowser, callResidentRuntime, cancelResidentPluginInstallation, commitResidentPluginInstallation, cleanResidentBrowserArtifacts, cleanupResidentSessions, createResidentRemoteRuntimePairingOffer, ensureResidentDaemon, forgetResidentRuntimeTarget, getResidentChromeInspectionStatus, getResidentDaemonIdentity, getResidentDaemonRuntimeStatus, getResidentBrowserArtifactVersion, getResidentRuntimeLocalBrowserEndpoint, invokeResidentPluginCommand, installResidentBrowserArtifact, listResidentPlugins, listResidentRemoteRuntimeClients, listResidentRuntimeTargets, pairResidentRuntimeTarget, prepareResidentPluginInstallation, readManagedRuntimeBrowserCredential, readOptionalManagedRuntimeBrowserCredential, reloadResidentPluginRuntime, revokeResidentRemoteRuntimeClient, setResidentPluginEnabled, shutdownResidentDaemonIfIdle, configureResidentChromeInspection, testResidentRuntimeTarget, uninstallResidentPlugin, updateResidentBrowserArtifact, connectResidentDesktopBrowserHost, ResidentRuntimeCallError, type InvokeResidentPluginCommandOptions, type ResidentDaemon, type ResidentDaemonIdentity, type ResidentDesktopBrowserHostCommandRequest, type ResidentDesktopBrowserHostConnectOptions, type ResidentDesktopBrowserHostConnection, type ResidentDesktopBrowserHostFailure, type ResidentPluginCommandResult, type ResidentPluginManagementItem, type ResidentPluginManagementState, type ResidentRemoteRuntimeClientGrant, type ResidentRuntimeCallErrorCode, type ResidentRuntimeCallOutcome, type ResidentRuntimeTargetTestResult, type ResidentRuntimeTargetView, } from "./control-client.js";
+export { callManagedRuntimeBrowser, callResidentRuntime, cancelResidentPluginInstallation, commitResidentPluginInstallation, cleanupResidentSessions, createResidentRemoteRuntimePairingOffer, forgetResidentRuntimeTarget, getResidentChromeInspectionStatus, getResidentDaemonIdentity, getResidentDaemonRuntimeStatus, getResidentRuntimeLocalBrowserEndpoint, invokeResidentPluginCommand, listResidentPlugins, listResidentRemoteRuntimeClients, listResidentRuntimeTargets, pairResidentRuntimeTarget, prepareResidentPluginInstallation, readManagedRuntimeBrowserCredential, readOptionalManagedRuntimeBrowserCredential, revokeResidentRemoteRuntimeClient, setResidentPluginEnabled, shutdownResidentDaemonIfIdle, configureResidentChromeInspection, testResidentRuntimeTarget, uninstallResidentPlugin, connectResidentDesktopBrowserHost, ResidentRuntimeCallError, type InvokeResidentPluginCommandOptions, type ResidentDaemonIdentity, type ResidentDesktopBrowserHostCommandRequest, type ResidentDesktopBrowserHostConnectOptions, type ResidentDesktopBrowserHostConnection, type ResidentDesktopBrowserHostFailure, type ResidentPluginCommandResult, type ResidentPluginManagementItem, type ResidentPluginManagementState, type ResidentRemoteRuntimeClientGrant, type ResidentRuntimeCallErrorCode, type ResidentRuntimeCallOutcome, type ResidentRuntimeTargetTestResult, type ResidentRuntimeTargetView, } from "./control-client.js";
 export type { DaemonChromeInspectionConfigureInput, DaemonChromeInspectionStatus, } from "@rynx-ai/protocol/control";
 export type { PluginInstallCommitInput, PluginInstallCommitResult, PluginInstallPreparation, PluginInstallPrepareInput, } from "@rynx-ai/protocol/plugin-management";
 export { ensureDaemonControlEndpoint, resolveDaemonControlEndpoint, type DaemonControlEndpoint, type ResolveDaemonControlEndpointOptions, } from "./control-endpoint.js";

package/dist/client.js

@@ -1,2 +1,2 @@
-export { callManagedRuntimeBrowser, callResidentRuntime, cancelResidentPluginInstallation, commitResidentPluginInstallation, cleanResidentBrowserArtifacts, cleanupResidentSessions, createResidentRemoteRuntimePairingOffer, ensureResidentDaemon, forgetResidentRuntimeTarget, getResidentChromeInspectionStatus, getResidentDaemonIdentity, getResidentDaemonRuntimeStatus, getResidentBrowserArtifactVersion, getResidentRuntimeLocalBrowserEndpoint, invokeResidentPluginCommand, installResidentBrowserArtifact, listResidentPlugins, listResidentRemoteRuntimeClients, listResidentRuntimeTargets, pairResidentRuntimeTarget, prepareResidentPluginInstallation, readManagedRuntimeBrowserCredential, readOptionalManagedRuntimeBrowserCredential, reloadResidentPluginRuntime, revokeResidentRemoteRuntimeClient, setResidentPluginEnabled, shutdownResidentDaemonIfIdle, configureResidentChromeInspection, testResidentRuntimeTarget, uninstallResidentPlugin, updateResidentBrowserArtifact, connectResidentDesktopBrowserHost, ResidentRuntimeCallError, } from "./control-client.js";
+export { callManagedRuntimeBrowser, callResidentRuntime, cancelResidentPluginInstallation, commitResidentPluginInstallation, cleanupResidentSessions, createResidentRemoteRuntimePairingOffer, forgetResidentRuntimeTarget, getResidentChromeInspectionStatus, getResidentDaemonIdentity, getResidentDaemonRuntimeStatus, getResidentRuntimeLocalBrowserEndpoint, invokeResidentPluginCommand, listResidentPlugins, listResidentRemoteRuntimeClients, listResidentRuntimeTargets, pairResidentRuntimeTarget, prepareResidentPluginInstallation, readManagedRuntimeBrowserCredential, readOptionalManagedRuntimeBrowserCredential, revokeResidentRemoteRuntimeClient, setResidentPluginEnabled, shutdownResidentDaemonIfIdle, configureResidentChromeInspection, testResidentRuntimeTarget, uninstallResidentPlugin, connectResidentDesktopBrowserHost, ResidentRuntimeCallError, } from "./control-client.js";
 export { ensureDaemonControlEndpoint, resolveDaemonControlEndpoint, } from "./control-endpoint.js";

package/dist/commands/app-distribution.d.ts

@@ -1,6 +1,6 @@
 export declare function shouldUseAppDistributionCommand(command: string | undefined, env?: NodeJS.ProcessEnv): boolean;
 /**
- * Prevent the App launcher from falling through to the compatibility daemon
- * CLI and accidentally creating or inspecting a PM2-owned second lifecycle.
+ * Prevent the App launcher from falling through to standalone lifecycle
+ * commands and accidentally creating or inspecting a PM2-owned second owner.
  */
 export declare function runAppDistributionCommand(command: string, args: readonly string[]): Promise<number>;

package/dist/commands/app-distribution.js

@@ -4,7 +4,6 @@ import { rynxHome } from "@rynx-ai/core";
 import { resolveDaemonControlEndpoint } from "../control-endpoint.js";
 import { fail } from "./errors.js";
 const APP_ONLY_COMMANDS = new Set([
-    "setup",
     "update",
     "start",
     "restart",
@@ -19,8 +18,8 @@ export function shouldUseAppDistributionCommand(command, env = process.env) {
         && env.RYNX_DISTRIBUTION === "app";
 }
 /**
- * Prevent the App launcher from falling through to the compatibility daemon
- * CLI and accidentally creating or inspecting a PM2-owned second lifecycle.
+ * Prevent the App launcher from falling through to standalone lifecycle
+ * commands and accidentally creating or inspecting a PM2-owned second owner.
  */
 export async function runAppDistributionCommand(command, args) {
     const json = args.includes("--json");
@@ -44,9 +43,6 @@ export async function runAppDistributionCommand(command, args) {
         printRecentDaemonLogs();
         return 0;
     }
-    if (command === "setup") {
-        fail("Rynx App setup is completed in its onboarding and Desktop Settings.");
-    }
     if (command === "update") {
         fail("Rynx App updates are managed from Rynx > Check for Updates.");
     }

package/dist/commands/browser.js

@@ -3,7 +3,7 @@ import path from "node:path";
 import { connectBrowserAutomation, } from "@rynx-ai/browser-cdp";
 import WebSocket from "ws";
 import { parseBrowserCliArgs, resolveBrowserCliTarget, } from "../browser-cli-args.js";
-import { callManagedRuntimeBrowser, callResidentRuntime, cleanResidentBrowserArtifacts, getResidentBrowserArtifactVersion, getResidentRuntimeLocalBrowserAutomationAccess, getResidentRuntimeLocalBrowserEndpoint, installResidentBrowserArtifact, readOptionalManagedRuntimeBrowserCredential, updateResidentBrowserArtifact, } from "../control-client.js";
+import { callManagedRuntimeBrowser, callResidentRuntime, getResidentRuntimeLocalBrowserAutomationAccess, getResidentRuntimeLocalBrowserEndpoint, readOptionalManagedRuntimeBrowserCredential, } from "../control-client.js";
 import { fail } from "./errors.js";
 export async function runBrowserCommand(args) {
     let parsed;
@@ -18,9 +18,11 @@ export async function runBrowserCommand(args) {
             fail("browser install: choose either --version or --channel");
         }
         const channel = browserReleaseChannel(parsed.channel);
+        const { createBrowserArtifactManagementService } = await import("@rynx-ai/daemon/browser-artifacts");
+        const artifacts = createBrowserArtifactManagementService();
         const result = parsed.subcommand === "install"
-            ? await installResidentBrowserArtifact(parsed.version ? { version: parsed.version } : { channel })
-            : await updateResidentBrowserArtifact({ channel });
+            ? await artifacts.install(parsed.version ? { version: parsed.version } : { channel }, parsed.json ? {} : { onProgress: (message) => console.error(message) })
+            : await artifacts.update({ channel }, parsed.json ? {} : { onProgress: (message) => console.error(message) });
         if (parsed.json) {
             console.log(JSON.stringify({
                 resolved: result.resolved,
@@ -35,7 +37,8 @@ export async function runBrowserCommand(args) {
         return 0;
     }
     if (parsed.subcommand === "version") {
-        const { installed } = await getResidentBrowserArtifactVersion();
+        const { createBrowserArtifactManagementService } = await import("@rynx-ai/daemon/browser-artifacts");
+        const { installed } = createBrowserArtifactManagementService().version();
         if (parsed.json)
             console.log(JSON.stringify({ installed }, null, 2));
         else if (installed) {
@@ -47,7 +50,8 @@ export async function runBrowserCommand(args) {
         return 0;
     }
     if (parsed.subcommand === "clean") {
-        const result = await cleanResidentBrowserArtifacts();
+        const { createBrowserArtifactManagementService } = await import("@rynx-ai/daemon/browser-artifacts");
+        const result = createBrowserArtifactManagementService().clean();
         if (parsed.json)
             console.log(JSON.stringify(result, null, 2));
         else if (result.removedBuilds.length === 0) {

package/dist/commands/index.d.ts

@@ -5,5 +5,7 @@ export { runCleanupCommand } from "./cleanup.js";
 export { runEmulatorCommand } from "./emulator.js";
 export { CliUsageError } from "./errors.js";
 export { type PluginManageCommandOptions, runPluginCommand, runPluginManageCommand, } from "./plugin.js";
+export { runMarketCommand } from "./market.js";
 export { runRuntimeCommand } from "./runtime.js";
-export { builtinSkillsDirectory, listBuiltinSkills, readBuiltinSkill, runSkillsCommand, } from "./skills.js";
+export { runSessionCommand } from "./session.js";
+export { builtinSkillGuidesDirectory, listBuiltinSkills, readBuiltinSkill, runSkillsCommand, } from "./skills.js";

package/dist/commands/index.js

@@ -5,5 +5,7 @@ export { runCleanupCommand } from "./cleanup.js";
 export { runEmulatorCommand } from "./emulator.js";
 export { CliUsageError } from "./errors.js";
 export { runPluginCommand, runPluginManageCommand, } from "./plugin.js";
+export { runMarketCommand } from "./market.js";
 export { runRuntimeCommand } from "./runtime.js";
-export { builtinSkillsDirectory, listBuiltinSkills, readBuiltinSkill, runSkillsCommand, } from "./skills.js";
+export { runSessionCommand } from "./session.js";
+export { builtinSkillGuidesDirectory, listBuiltinSkills, readBuiltinSkill, runSkillsCommand, } from "./skills.js";

package/dist/commands/lifecycle.d.ts

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

package/dist/commands/lifecycle.js

@@ -0,0 +1,21 @@
+import { startStandaloneDaemon, statusStandaloneDaemon, stopStandaloneDaemon, streamStandaloneDaemonLogs, } from "../standalone.js";
+import { fail } from "./errors.js";
+export async function runLifecycleCommand(command, args) {
+    if (args.length > 0)
+        fail(`${command}: unexpected argument ${args[0]}`);
+    switch (command) {
+        case "start":
+            return startStandaloneDaemon();
+        case "restart":
+            return startStandaloneDaemon({ restart: true });
+        case "stop":
+            return stopStandaloneDaemon();
+        case "status":
+            return statusStandaloneDaemon();
+        case "logs":
+            await streamStandaloneDaemonLogs();
+            return 0;
+        default:
+            fail(`unknown lifecycle command: ${command}`);
+    }
+}

package/dist/commands/market.d.ts

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

package/dist/commands/market.js

@@ -0,0 +1,71 @@
+import { addResidentPluginMarketplace, listResidentPluginMarketplaces, refreshResidentPluginMarketplace, removeResidentPluginMarketplace, } from "../control-client.js";
+import { fail } from "./errors.js";
+export async function runMarketCommand(args) {
+    const [command, target, ...rest] = args;
+    switch (command) {
+        case "list": {
+            rejectExtra(rest, "market list");
+            const markets = await listResidentPluginMarketplaces();
+            console.log("Markets");
+            if (markets.length === 0) {
+                console.log("  (none)");
+                return 0;
+            }
+            for (const market of markets) {
+                const source = market.builtIn ? "built-in" : market.source;
+                const revision = market.builtIn ? "bundled with Rynx" : market.resolvedRevision;
+                console.log(`  ${market.id.padEnd(24)} ${source.padEnd(8)} ` +
+                    `${String(market.plugins.length).padStart(3)} plugins  ${revision}`);
+            }
+            return 0;
+        }
+        case "add": {
+            if (!target || target.startsWith("--"))
+                fail("market add: missing Git/local source");
+            let alias;
+            for (let index = 0; index < rest.length; index += 1) {
+                const arg = rest[index];
+                if (arg !== "--alias" || alias !== undefined)
+                    fail(`market add: unexpected option ${arg}`);
+                const value = rest[index + 1];
+                if (!value || value.startsWith("--"))
+                    fail("market add: --alias requires a value");
+                alias = value;
+                index += 1;
+            }
+            const market = await addResidentPluginMarketplace({
+                source: target,
+                ...(alias ? { alias } : {}),
+            });
+            console.log(`Market "${market.id}" added with ${market.plugins.length} plugin(s).`);
+            return 0;
+        }
+        case "refresh": {
+            rejectExtra(rest, "market refresh");
+            const ids = target
+                ? [target]
+                : (await listResidentPluginMarketplaces()).map((market) => market.id);
+            for (const id of ids) {
+                const market = await refreshResidentPluginMarketplace(id);
+                console.log(`Market "${market.id}" refreshed at ${market.resolvedRevision}.`);
+            }
+            if (ids.length === 0)
+                console.log("No Markets to refresh.");
+            return 0;
+        }
+        case "remove": {
+            if (!target)
+                fail("market remove: missing market id");
+            rejectExtra(rest, "market remove");
+            await removeResidentPluginMarketplace(target);
+            console.log(`Market "${target}" removed.`);
+            return 0;
+        }
+        default:
+            fail("market: expected list, add, refresh, or remove");
+    }
+}
+function rejectExtra(args, command) {
+    if (args.length > 0)
+        fail(`${command}: unexpected argument ${args[0]}`);
+}

package/dist/commands/plugin.js

@@ -1,8 +1,9 @@
 import { createInterface } from "node:readline/promises";
-import { cancelResidentPluginInstallation, commitResidentPluginInstallation, invokeResidentPluginCommand, listResidentPlugins, prepareResidentPluginInstallation, reloadResidentPluginRuntime, setResidentPluginEnabled, uninstallResidentPlugin, } from "../control-client.js";
+import { cancelResidentPluginInstallation, commitResidentPluginInstallation, invokeResidentPluginCommand, listResidentPlugins, prepareResidentPluginInstallation, setResidentPluginEnabled, uninstallResidentPlugin, } from "../control-client.js";
 import { fail } from "./errors.js";
 const PLUGIN_STDIN_MAX_BYTES = 256 * 1024;
 const PLUGIN_DIGEST_PATTERN = /^sha256-[A-Za-z0-9+/]{43}={0,2}$/;
+const CANONICAL_PLUGIN_ID_PATTERN = /^[a-z][a-z0-9-]{0,62}@[a-z0-9][a-z0-9-]{0,62}(?:\/[a-z0-9][a-z0-9._-]{0,99})?$/;
 export async function runPluginManageCommand(args, options = {}) {
     const [subcommand, pluginId] = args;
     switch (subcommand) {
@@ -22,16 +23,16 @@ export async function runPluginManageCommand(args, options = {}) {
         case "enable":
         case "disable": {
             if (!pluginId)
-                fail(`plugin manage ${subcommand}: missing plugin id`);
+                fail(`plugin ${subcommand}: missing canonical plugin id`);
             await setResidentPluginEnabled(pluginId, subcommand === "enable");
-            console.log(`Plugin "${pluginId}" ${subcommand}d. Run \`rynx restart\` to apply.`);
+            console.log(`Plugin "${pluginId}" ${subcommand}d.`);
             return 0;
         }
         case "uninstall": {
             if (!pluginId)
-                fail("plugin manage uninstall: missing plugin id");
+                fail("plugin uninstall: missing canonical plugin id");
             await uninstallResidentPlugin(pluginId);
-            console.log(`Plugin "${pluginId}" uninstalled. Run \`rynx restart\` to apply.`);
+            console.log(`Plugin "${pluginId}" uninstalled.`);
             return 0;
         }
         case "install":
@@ -40,9 +41,10 @@ export async function runPluginManageCommand(args, options = {}) {
             const preparation = await prepareResidentPluginInstallation({
                 operation: subcommand,
                 ...(subcommand === "install"
-                    ? { spec: parsed.target }
+                    ? CANONICAL_PLUGIN_ID_PATTERN.test(parsed.target)
+                        ? { marketplacePlugin: parsed.target }
+                        : { spec: parsed.target }
                     : { pluginId: parsed.target }),
-                allowScripts: parsed.allowScripts,
             });
             let committed = false;
             try {
@@ -56,26 +58,24 @@ export async function runPluginManageCommand(args, options = {}) {
                     fail(`prepared plugin digest ${preparation.artifact.digest} does not match ` +
                         `--expect-digest ${parsed.expectedDigest}`);
                 }
+                if (subcommand === "update" && preparation.unchanged) {
+                    if (parsed.json) {
+                        console.log(JSON.stringify({
+                            preparation: publicPreparation(preparation),
+                            unchanged: true,
+                        }, null, 2));
+                    }
+                    else {
+                        console.log(`Plugin "${preparation.artifact.id}" is already up to date.`);
+                    }
+                    return 0;
+                }
                 if ((!interactive || parsed.json) &&
-                    (parsed.force || parsed.grantAll || parsed.allowScripts) &&
+                    parsed.force &&
                     parsed.expectedDigest === undefined) {
-                    fail("non-interactive --force/--grant-all/--allow-scripts approval must be bound to the " +
+                    fail("non-interactive --force confirmation must be bound to the " +
                         `prepared artifact; re-run with --expect-digest ${preparation.artifact.digest}`);
                 }
-                if (preparation.artifact.requiresBuildScripts && !parsed.allowScripts) {
-                    fail(`plugin "${preparation.artifact.id}" requires package build scripts; ` +
-                        `review digest ${preparation.artifact.digest} and re-run with ` +
-                        `--allow-scripts --expect-digest ${preparation.artifact.digest}`);
-                }
-                if (preparation.artifact.requiresBuildScripts &&
-                    parsed.allowScripts &&
-                    parsed.expectedDigest === undefined) {
-                    const approved = await confirm(`Run declared build scripts from digest ${preparation.artifact.digest}?`);
-                    if (!approved) {
-                        console.log("Plugin installation cancelled; build scripts were not run.");
-                        return 0;
-                    }
-                }
                 let overwrite = subcommand === "update";
                 if (subcommand === "install" && preparation.existing) {
                     overwrite = parsed.force;
@@ -92,49 +92,15 @@ export async function runPluginManageCommand(args, options = {}) {
                         }
                     }
                 }
-                let grants = [...preparation.capabilityDiff.retained];
-                if (preparation.capabilityDiff.added.length > 0) {
-                    if (parsed.grantAll) {
-                        grants = [...preparation.artifact.requestedCapabilities];
-                    }
-                    else {
-                        if (!interactive || parsed.json) {
-                            fail(`plugin "${preparation.artifact.id}" requests new capabilities ` +
-                                `(${preparation.capabilityDiff.added.join(", ")}); inspect digest ` +
-                                `${preparation.artifact.digest} and re-run with ` +
-                                `--grant-all --expect-digest ${preparation.artifact.digest}`);
-                        }
-                        const approved = await confirm(`Grant ${preparation.capabilityDiff.added.length} new capability(s) ` +
-                            `to "${preparation.artifact.id}"?`);
-                        if (!approved) {
-                            console.log("Plugin installation cancelled; no changes were made.");
-                            return 0;
-                        }
-                        grants = [...preparation.artifact.requestedCapabilities];
-                    }
-                }
                 const result = await commitResidentPluginInstallation(preparation.token, {
-                    grants,
                     overwrite,
                     expectedDigest: preparation.artifact.digest,
                 });
                 committed = true;
-                let runtimeReloaded = false;
-                if (parsed.restart) {
-                    try {
-                        await reloadResidentPluginRuntime(result.plugin.id);
-                        runtimeReloaded = true;
-                    }
-                    catch (error) {
-                        throw new Error(`Plugin "${result.plugin.id}" was committed, but its runtime did not reload: ` +
-                            `${messageOf(error)}`, { cause: error });
-                    }
-                }
                 if (parsed.json) {
                     console.log(JSON.stringify({
                         preparation: publicPreparation(preparation),
                         plugin: result.plugin,
-                        runtimeReloaded,
                     }, null, 2));
                 }
                 else {
@@ -142,9 +108,7 @@ export async function runPluginManageCommand(args, options = {}) {
                     console.log(`Plugin "${result.plugin.id}"${result.plugin.version
                         ? ` @${result.plugin.version}`
                         : ""} ${action}.`);
-                    console.log(parsed.restart
-                        ? `Plugin "${result.plugin.id}" runtime is ready.`
-                        : "Use --restart to reload the plugin runtime now.");
+                    console.log(`Runtime state: ${result.plugin.runtimeState}.`);
                 }
                 return 0;
             }
@@ -155,15 +119,15 @@ export async function runPluginManageCommand(args, options = {}) {
             }
         }
         default:
-            fail("plugin manage: expected list, install, update, uninstall, enable, or disable");
+            fail("plugin: expected list, install, update, uninstall, enable, or disable");
     }
 }
 export async function runPluginCommand(args) {
     const [pluginId, command] = args;
     if (!pluginId)
         fail("plugin: missing plugin id");
-    if (pluginId === "manage") {
-        return runPluginManageCommand(args.slice(1));
+    if (["list", "install", "update", "uninstall", "enable", "disable"].includes(pluginId)) {
+        return runPluginManageCommand(args);
     }
     if (!command)
         fail(`plugin ${pluginId}: missing command`);
@@ -184,15 +148,12 @@ function parseInstallationArgs(operation, args) {
     const target = args[0];
     if (!target || target.startsWith("--")) {
         fail(operation === "install"
-            ? "plugin manage install: missing npm/path/git/url source"
-            : "plugin manage update: missing plugin id");
+            ? "plugin install: missing Git/local source or market plugin identity"
+            : "plugin update: missing canonical plugin id");
     }
     const flags = new Set();
     const allowedFlags = new Set([
         "--force",
-        "--grant-all",
-        "--allow-scripts",
-        "--restart",
         "--json",
     ]);
     let expectedDigest;
@@ -200,36 +161,33 @@ function parseInstallationArgs(operation, args) {
         const arg = args[index];
         if (arg === "--expect-digest" || arg === "--expected-digest") {
             if (expectedDigest !== undefined) {
-                fail(`plugin manage ${operation}: duplicate digest expectation`);
+                fail(`plugin ${operation}: duplicate digest expectation`);
             }
             const value = args[index + 1];
             if (!value || value.startsWith("--")) {
-                fail(`plugin manage ${operation}: ${arg} requires a value`);
+                fail(`plugin ${operation}: ${arg} requires a value`);
             }
             if (!PLUGIN_DIGEST_PATTERN.test(value)) {
-                fail(`plugin manage ${operation}: ${arg} must be a sha256 digest`);
+                fail(`plugin ${operation}: ${arg} must be a sha256 digest`);
             }
             expectedDigest = value;
             index += 1;
             continue;
         }
         if (!arg.startsWith("--")) {
-            fail(`plugin manage ${operation}: unexpected argument ${arg}`);
+            fail(`plugin ${operation}: unexpected argument ${arg}`);
         }
         if (!allowedFlags.has(arg)) {
-            fail(`plugin manage ${operation}: unknown option ${arg}`);
+            fail(`plugin ${operation}: unknown option ${arg}`);
         }
         if (flags.has(arg)) {
-            fail(`plugin manage ${operation}: duplicate option ${arg}`);
+            fail(`plugin ${operation}: duplicate option ${arg}`);
         }
         flags.add(arg);
     }
     return {
         target,
         force: flags.has("--force"),
-        grantAll: flags.has("--grant-all"),
-        allowScripts: flags.has("--allow-scripts"),
-        restart: flags.has("--restart"),
         json: flags.has("--json"),
         ...(expectedDigest ? { expectedDigest } : {}),
     };
@@ -240,19 +198,8 @@ function printPreparation(preparation) {
         : "";
     console.log(`Prepared plugin "${preparation.artifact.id}"${version}.`);
     console.log(`Artifact digest: ${preparation.artifact.digest}`);
-    if (preparation.artifact.requiresBuildScripts) {
-        console.log("Package build scripts: required and explicitly enabled.");
-    }
-    printCapabilities("New capabilities", preparation.capabilityDiff.added);
-    printCapabilities("Retained capabilities", preparation.capabilityDiff.retained);
-    printCapabilities("Removed capabilities", preparation.capabilityDiff.removed);
-}
-function printCapabilities(label, capabilities) {
-    if (capabilities.length === 0)
-        return;
-    console.log(`${label}:`);
-    for (const capability of capabilities)
-        console.log(`  - ${capability}`);
+    console.log(`Source: ${preparation.artifact.source}`);
+    console.log(`Runtime: ${preparation.artifact.hasRuntime ? "declared" : "none"}`);
 }
 function publicPreparation(preparation) {
     const { token: _token, ...publicFields } = preparation;
@@ -272,9 +219,6 @@ async function confirmInTerminal(message) {
         prompt.close();
     }
 }
-function messageOf(error) {
-    return error instanceof Error ? error.message : String(error);
-}
 async function readStdinBounded(maxBytes) {
     const chunks = [];
     let bytes = 0;

package/dist/commands/session.d.ts

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

package/dist/commands/session.js

@@ -0,0 +1,38 @@
+import { randomUUID } from "node:crypto";
+import { callResidentRuntime } from "../control-client.js";
+import { fail } from "./errors.js";
+export async function runSessionCommand(args) {
+    const [command, sourceSessionId, ...options] = args;
+    if (command !== "fork" || !sourceSessionId) {
+        fail("Usage: rynx session fork <session-id> [--title <title>] [--json]");
+    }
+    let title;
+    let json = false;
+    for (let index = 0; index < options.length; index += 1) {
+        const option = options[index];
+        if (option === "--json") {
+            if (json)
+                fail("session fork: duplicate option --json");
+            json = true;
+            continue;
+        }
+        if (option === "--title") {
+            if (title !== undefined)
+                fail("session fork: duplicate option --title");
+            title = options[++index];
+            if (!title?.trim())
+                fail("session fork: --title requires a value");
+            continue;
+        }
+        fail(`session fork: unknown option ${option}`);
+    }
+    const result = await callResidentRuntime("local", "session.fork", {
+        sourceSessionId,
+        operationId: `cli_${randomUUID()}`,
+        ...(title ? { title: title.trim() } : {}),
+    });
+    console.log(json
+        ? JSON.stringify(result)
+        : result.sessionId);
+    return 0;
+}

package/dist/commands/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function runSetupCommand(args: readonly string[]): Promise<number>;
+export declare function runDoctorCommand(args: readonly string[]): Promise<number>;