@rho-workspace/rho 0.5.4 → 0.5.5

package/dist/browser-access.js

@@ -1,3 +1,4 @@
+import { extensionMethods } from './extension-contract.js';
 import * as fs from 'node:fs/promises';
 import path from 'node:path';
 import { randomBytes } from 'node:crypto';
@@ -36,7 +37,7 @@ export const browserMethods = ['protocol.describe', 'protocol.validate', 'projec
 // Only the person at this machine talks to a conversation Rho starts: it runs their own Claude
 // Code with their model credentials. Only they add Rho to their own Agent's configuration. A
 // narrower, expiring link never receives these.
-export const conversationMethods = ['session.connect', 'conversation.start', 'conversation.send', 'conversation.stop', 'conversation.decide', 'conversation.read', 'conversation.list', 'conversation.trash', 'conversation.restore', 'conversation.delete', 'conversation.permission', 'conversation.configure', 'conversation.settings.read', 'conversation.settings.update', 'conversation.settings.check', 'project.work.read', 'evidence.preview', 'evidence.export'];
+export const conversationMethods = ['agent.sessions.list', 'agent.sessions.read', 'session.connect', 'conversation.start', 'conversation.send', 'conversation.stop', 'conversation.decide', 'conversation.read', 'conversation.list', 'conversation.trash', 'conversation.restore', 'conversation.delete', 'conversation.permission', 'conversation.configure', 'conversation.settings.read', 'conversation.settings.update', 'conversation.settings.check', 'project.work.read', 'evidence.preview', 'evidence.export'];
 // The person at this machine. A tab this service served is authorized by the request itself:
 // same origin, loopback only, no link, no code and no expiry. `--pair` stays an explicit,
 // narrower grant for a shared or subfolder-scoped tab.
@@ -49,7 +50,7 @@ export const skillsMethods = ['skills.list', 'skills.read', 'skills.change', 'sk
 export function localBrowserPrincipal(root) {
     // The empty token hash can never match a request digest, so no header impersonates this
     // identity: it is chosen because the request carried no credential at all.
-    return { id: localBrowserId, kind: 'browser', tokenHash: '', projectRoot: root, methods: [...browserMethods, ...conversationMethods, ...consoleMethods, ...kernelMethods, ...skillsMethods] };
+    return { id: localBrowserId, kind: 'browser', tokenHash: '', projectRoot: root, methods: [...extensionMethods, ...browserMethods, ...conversationMethods, ...consoleMethods, ...kernelMethods, ...skillsMethods] };
 }
 export class BrowserAccess {
     state;

package/dist/capabilities.d.ts

@@ -157,7 +157,7 @@ export declare class Capabilities {
         enabled: string[];
     }, author: string): Promise<{
         version: number;
-        enabled: ("media" | "r" | "agent" | "files" | "documents" | "requirements" | "tables" | "charts" | "annotations" | "console" | "kernel" | "skills")[];
+        enabled: ("media" | "r" | "agent" | "files" | "skills" | "documents" | "requirements" | "tables" | "charts" | "annotations" | "console" | "kernel")[];
         receipt: CapabilityReceipt;
     }>;
     private pluginStatus;
@@ -192,7 +192,7 @@ export declare class Capabilities {
         }[];
         configuration: {
             version: number;
-            enabled: ("media" | "r" | "agent" | "files" | "documents" | "requirements" | "tables" | "charts" | "annotations" | "console" | "kernel" | "skills")[];
+            enabled: ("media" | "r" | "agent" | "files" | "skills" | "documents" | "requirements" | "tables" | "charts" | "annotations" | "console" | "kernel")[];
             retainedReceipts: number;
             retainedFromVersion: number;
             maxReceipts: number;

package/dist/capabilities.js

@@ -10,6 +10,11 @@ const applicationContent = [
     'Start with rho_index: select an owner or search, then rho_resolve only the operations',
     'needed now. Use rho_call with the complete contractRef. The private connection supplies',
     'the project; discovery never grants additional authority or starts a runtime.',
+    'Independent third-party plugins: extension.list shows installed packages, extension.describe',
+    'gives their digest, operations and Skill entries. Read extension.content (kind skill)',
+    'before extension.call. Keep expectedDigest and the original changeId for a native call;',
+    'extension.read observes pending or unknown outcomes without rerunning. Installation and',
+    'management belong to the local person; plugin code never expands this connection grant.',
     'Large replies carry a result reference. Use rho_read to inspect its fields and fetch',
     'only selected text ranges or array pages. Retain useful references; release finished',
     'results explicitly. Never repeat an action just to retrieve a large reply.',
@@ -30,7 +35,7 @@ const applicationContent = [
     'run or export it as files; a stopped run is not resubmitted under its own operationId.'
 ].join('\n');
 const applicationSkill = {
-    id: 'rho.workspace', version: '1.5', content: applicationContent,
+    id: 'rho.workspace', version: '1.6', content: applicationContent,
     intent: 'Work in this project through versioned operations, in a safe order.',
     requires: ['capability.list', 'observation.snapshot', 'action.submit', 'composition.apply', 'context.read'],
     example: { method: 'observation.snapshot', input: { projectId: 'the-open-project' } },

package/dist/cli.js

@@ -33,7 +33,9 @@ function parseAcpCommand(spec) {
         throw new Error('--acp-command is empty.');
     return { file: parts[0], args: parts.slice(1) };
 }
-const usage = `Verify a read-only evidence package:
+const usage = `Develop, install and manage independent plugins:
+  rho plugin --help
+Verify a read-only evidence package:
   rho --verify-evidence PATH
 Start Rho on ~/Rho/projects and ~/Rho/state, and say where it is and what is missing:
   rho
@@ -72,197 +74,208 @@ function refuse(error, url) {
         throw error;
     process.exit(1);
 }
-let parsed;
-try {
-    parsed = parseArgs({ options });
-}
-catch (error) {
-    process.stderr.write((error instanceof Error ? error.message : String(error)) + '\n\n' + usage);
-    process.exit(2);
-}
-const { values } = parsed;
-if (values['verify-evidence']) {
+if (process.argv[2] === 'plugin') {
     try {
-        const { verifyEvidence } = await import('./evidence-export.js');
-        process.stdout.write(JSON.stringify(await verifyEvidence(path.resolve(values['verify-evidence']))) + '\n');
+        await (await import('./plugin-cli.js')).pluginCli(process.argv.slice(3));
     }
-    catch (e) {
-        process.stderr.write((e instanceof Error ? e.message : String(e)) + '\n');
+    catch (error) {
+        process.stderr.write((error instanceof Error ? error.message : String(error)) + '\n');
         process.exitCode = 1;
     }
-    process.exit(process.exitCode ?? 0);
-}
-if (values.help) {
-    process.stdout.write(usage);
-    process.exit(0);
 }
-// The Agent's side of a grant: its MCP server reads the connection file and speaks on stdio,
-// so nothing else may write to stdout in this mode.
-if (values.acp) {
-    if (!['claude', 'codex'].includes(values['acp-agent'] ?? '')) {
-        process.stderr.write('Select --acp-agent claude or codex.\n');
+else {
+    let parsed;
+    try {
+        parsed = parseArgs({ options });
+    }
+    catch (error) {
+        process.stderr.write((error instanceof Error ? error.message : String(error)) + '\n\n' + usage);
         process.exit(2);
     }
-    const { runExternalAcp } = await import('@rho-workspace/plugin-agent/acp-cli');
-    runExternalAcp(path.resolve(values.acp), values['acp-agent']);
-}
-else if (values.mcp) {
-    process.env.RHO_AGENT_CONNECTION = path.resolve(values.mcp);
-    await import('@rho-workspace/plugin-agent/mcp');
-}
-else {
-    // Access comes from whoever runs Rho: the operator's connection grants one project to one
-    // Agent session, and the reply says how Claude Code starts that session's MCP server.
-    if (values.grant) {
-        if (!values.project) {
-            process.stderr.write('--grant needs --project, the project folder relative to the service root.\n\n' + usage);
-            process.exit(2);
+    const { values } = parsed;
+    if (values['verify-evidence']) {
+        try {
+            const { verifyEvidence } = await import('./evidence-export.js');
+            process.stdout.write(JSON.stringify(await verifyEvidence(path.resolve(values['verify-evidence']))) + '\n');
         }
-        if (values.agent !== undefined && !['claude-code', 'codex'].includes(values.agent)) {
-            process.stderr.write('Choose --agent claude-code or codex.\n');
-            process.exit(2);
+        catch (e) {
+            process.stderr.write((e instanceof Error ? e.message : String(e)) + '\n');
+            process.exitCode = 1;
         }
-        if (values.agent !== undefined && values.session !== undefined) {
-            process.stderr.write('--agent names the session itself; leave out --session.\n');
+        process.exit(process.exitCode ?? 0);
+    }
+    if (values.help) {
+        process.stdout.write(usage);
+        process.exit(0);
+    }
+    // The Agent's side of a grant: its MCP server reads the connection file and speaks on stdio,
+    // so nothing else may write to stdout in this mode.
+    if (values.acp) {
+        if (!['claude', 'codex'].includes(values['acp-agent'] ?? '')) {
+            process.stderr.write('Select --acp-agent claude or codex.\n');
             process.exit(2);
         }
-        const { RhoClient } = await import('./client.js');
-        const client = await RhoClient.fromFile(path.resolve(values.grant)).catch(error => refuse(error));
-        try {
-            const project = await client.call('project.open', { path: values.project });
-            // The same as the project page's button: the grant that Agent keeps, then its own
-            // `mcp add`, recorded so the page shows it under that Agent.
-            if (values.agent) {
-                const connected = await client.call('session.connect', { projectId: project.id, agent: values.agent });
-                process.stdout.write(JSON.stringify({ projectId: project.id, root: project.root, agent: values.agent, methods: connected.methods, granted: connected.granted, added: connected.added }) + '\n');
+        const { runExternalAcp } = await import('@rho-workspace/plugin-agent/acp-cli');
+        runExternalAcp(path.resolve(values.acp), values['acp-agent']);
+    }
+    else if (values.mcp) {
+        process.env.RHO_AGENT_CONNECTION = path.resolve(values.mcp);
+        await import('@rho-workspace/plugin-agent/mcp');
+    }
+    else {
+        // Access comes from whoever runs Rho: the operator's connection grants one project to one
+        // Agent session, and the reply says how Claude Code starts that session's MCP server.
+        if (values.grant) {
+            if (!values.project) {
+                process.stderr.write('--grant needs --project, the project folder relative to the service root.\n\n' + usage);
+                process.exit(2);
+            }
+            if (values.agent !== undefined && !['claude-code', 'codex'].includes(values.agent)) {
+                process.stderr.write('Choose --agent claude-code or codex.\n');
+                process.exit(2);
+            }
+            if (values.agent !== undefined && values.session !== undefined) {
+                process.stderr.write('--agent names the session itself; leave out --session.\n');
+                process.exit(2);
+            }
+            const { RhoClient } = await import('./client.js');
+            const client = await RhoClient.fromFile(path.resolve(values.grant)).catch(error => refuse(error));
+            try {
+                const project = await client.call('project.open', { path: values.project });
+                // The same as the project page's button: the grant that Agent keeps, then its own
+                // `mcp add`, recorded so the page shows it under that Agent.
+                if (values.agent) {
+                    const connected = await client.call('session.connect', { projectId: project.id, agent: values.agent });
+                    process.stdout.write(JSON.stringify({ projectId: project.id, root: project.root, agent: values.agent, methods: connected.methods, granted: connected.granted, added: connected.added }) + '\n');
+                    process.exit(0);
+                }
+                const session = values.session ?? 'claude-code';
+                const granted = await client.call('session.grant', { projectId: project.id, externalSessionId: session });
+                const { mcpCommand, mcpName } = await import('./agent-connect.js');
+                const command = mcpCommand(granted.connectionFile), name = mcpName(project.root);
+                const quote = (value) => /^[A-Za-z0-9_./:@=-]+$/.test(value) ? value : `'${value.replace(/'/g, `'\\''`)}'`;
+                process.stdout.write(JSON.stringify({ projectId: project.id, session, connectionFile: granted.connectionFile, methods: granted.methods.length,
+                    mcp: { name, command: command[0], args: command.slice(1) }, claude: ['claude', 'mcp', 'add', name, '--', ...command].map(quote).join(' ') }) + '\n');
                 process.exit(0);
             }
-            const session = values.session ?? 'claude-code';
-            const granted = await client.call('session.grant', { projectId: project.id, externalSessionId: session });
-            const { mcpCommand, mcpName } = await import('./agent-connect.js');
-            const command = mcpCommand(granted.connectionFile), name = mcpName(project.root);
-            const quote = (value) => /^[A-Za-z0-9_./:@=-]+$/.test(value) ? value : `'${value.replace(/'/g, `'\\''`)}'`;
-            process.stdout.write(JSON.stringify({ projectId: project.id, session, connectionFile: granted.connectionFile, methods: granted.methods.length,
-                mcp: { name, command: command[0], args: command.slice(1) }, claude: ['claude', 'mcp', 'add', name, '--', ...command].map(quote).join(' ') }) + '\n');
-            process.exit(0);
+            catch (error) {
+                refuse(error, client.connection.url);
+            }
         }
-        catch (error) {
-            refuse(error, client.connection.url);
+        if (values.pair) {
+            const { RhoClient } = await import('./client.js');
+            const client = await RhoClient.fromFile(path.resolve(values.pair)).catch(error => refuse(error));
+            try {
+                const pairing = await client.call('session.browser.pair', values.root ? { path: values.root } : {});
+                const openUrl = link(client.connection.url, pairing.code);
+                process.stdout.write(JSON.stringify({ url: client.connection.url, openUrl, pairingCode: pairing.code, pairingExpiresAt: pairing.expiresAt }) + '\n');
+                if (values.open)
+                    openBrowser(openUrl);
+                process.exit(0);
+            }
+            catch (error) {
+                refuse(error, client.connection.url);
+            }
         }
-    }
-    if (values.pair) {
-        const { RhoClient } = await import('./client.js');
-        const client = await RhoClient.fromFile(path.resolve(values.pair)).catch(error => refuse(error));
-        try {
-            const pairing = await client.call('session.browser.pair', values.root ? { path: values.root } : {});
-            const openUrl = link(client.connection.url, pairing.code);
-            process.stdout.write(JSON.stringify({ url: client.connection.url, openUrl, pairingCode: pairing.code, pairingExpiresAt: pairing.expiresAt }) + '\n');
-            if (values.open)
-                openBrowser(openUrl);
-            process.exit(0);
+        // A person who runs `npx @rho-workspace/rho` with no arguments wants the application, not a
+        // usage page: start it on their own folders, say in plain words where it is, and open it when
+        // this is an interactive terminal. Every flagged start is unchanged, so scripts and
+        // acceptance runs keep the output they read.
+        const quickStart = !values.root && !values['state-dir'];
+        if (!quickStart && (!values.root || !values['state-dir'])) {
+            process.stderr.write(usage);
+            process.exit(2);
         }
-        catch (error) {
-            refuse(error, client.connection.url);
+        let quickRoot = '', quickState = '';
+        if (quickStart) {
+            const { homedir } = await import('node:os');
+            quickRoot = path.join(homedir(), 'Rho', 'projects');
+            quickState = path.join(homedir(), 'Rho', 'state');
+            await fs.mkdir(quickRoot, { recursive: true });
+            await fs.mkdir(quickState, { recursive: true });
         }
-    }
-    // A person who runs `npx @rho-workspace/rho` with no arguments wants the application, not a
-    // usage page: start it on their own folders, say in plain words where it is, and open it when
-    // this is an interactive terminal. Every flagged start is unchanged, so scripts and
-    // acceptance runs keep the output they read.
-    const quickStart = !values.root && !values['state-dir'];
-    if (!quickStart && (!values.root || !values['state-dir'])) {
-        process.stderr.write(usage);
-        process.exit(2);
-    }
-    let quickRoot = '', quickState = '';
-    if (quickStart) {
-        const { homedir } = await import('node:os');
-        quickRoot = path.join(homedir(), 'Rho', 'projects');
-        quickState = path.join(homedir(), 'Rho', 'state');
-        await fs.mkdir(quickRoot, { recursive: true });
-        await fs.mkdir(quickState, { recursive: true });
-    }
-    const projectsRoot = values.root ?? quickRoot, stateDirectory = values['state-dir'] ?? quickState;
-    const limits = values.limits ? JSON.parse(await fs.readFile(values.limits, 'utf8')) : {};
-    const allowed = new Set(['maxRequestBytes', 'maxEventBytes', 'eventRetention', 'maxSubscriptions', 'maxQueue', 'maxContexts', 'maxBindings', 'maxActivities', 'maxContextBytes', 'maxRetainedMetadataBytes', 'maxConcurrentActions', 'maxOperations', 'maxLogPageBytes', 'maxCodeBytes', 'maxReconciled', 'documents', 'resources', 'workspace', 'r', 'annotations', 'interactions', 'capabilityLimits', 'browser', 'nativeFolders', 'conversations', 'evidence', 'console']);
-    if (Object.keys(limits).some(k => !allowed.has(k)))
-        throw new Error('Unknown service budget in --limits file.');
-    const { RhoService } = await import('./server.js'), { runtime } = await import('./runtime.js');
-    const agentBackend = values['agent-backend'] ?? process.env.RHO_AGENT_BACKEND ?? 'claude-acp';
-    if (!['claude-acp', 'codex-acp', 'claude-cli', 'acp'].includes(agentBackend))
-        throw new Error('Choose --agent-backend claude-acp, codex-acp, claude-cli or acp.');
-    const acpCommand = agentBackend === 'acp' ? parseAcpCommand(values['acp-command'] ?? process.env.RHO_ACP_COMMAND) : undefined;
-    if (values.port !== undefined && !(/^\d+$/.test(values.port) && Number(values.port) <= 65535)) {
-        process.stderr.write('Choose --port 0 to 65535, or leave it out.\n');
-        process.exit(2);
-    }
-    // A Core that cannot be used (none for this platform, a changed digest) is read by a person.
-    const native = await runtime(values.core, values.rscript).catch(e => { process.stderr.write((e instanceof Error ? e.message : String(e)) + '\n'); process.exit(1); });
-    // A person starting Rho sees the project it ships with; a composition that starts a service
-    // for its own work says so itself and is left alone.
-    if (values.example !== undefined && !['on', 'off'].includes(values.example))
-        throw new Error('Choose --example on or off.');
-    const example = values.example !== 'off';
-    const service = await new RhoService({ example, ...limits, root: path.resolve(projectsRoot), stateDir: path.resolve(stateDirectory), ...native, agentBackend: agentBackend, acpCommand, codex: values.codex ?? process.env.RHO_CODEX ?? 'codex', claude: values.claude ?? process.env.RHO_CLAUDE ?? 'claude', python: values.python ?? process.env.RHO_PYTHON, ssh: values.ssh ?? process.env.RHO_SSH, serverctl: values.serverctl ?? process.env.RHO_SERVERCTL, port: values.port === undefined ? undefined : Number(values.port), ...(values.plugins !== undefined ? { plugins: values.plugins ? values.plugins.split(',') : [] } : {}) }).start().catch(async (error) => {
-        // Starting Rho again on a state it already runs on is the common refusal: say where it runs.
-        const held = error?.details?.stateDirectory;
-        const running = typeof held === 'string' ? await fs.readFile(path.join(held, 'connection.json'), 'utf8').then(text => String(JSON.parse(text).url), () => '') : '';
-        return refuse(running ? Object.assign(error, { message: `Rho is already running for ${held} at ${running}. Open that url, or stop that service before starting it again.` }) : error);
-    });
-    // The narrow conclusion a person needs on one line: what was selected, where state
-    // lives, and how to open it. It stays inside `ready` so a parser reading line one is
-    // unaffected. Opening this url on this machine is the access; no link is minted.
-    const rscript = values.rscript ?? process.env.RHO_RSCRIPT ?? 'Rscript';
-    process.stdout.write(JSON.stringify({ ready: {
-            url: service.url, connectionFile: path.join(service.state.directory, 'connection.json'), apiVersion: '2.0',
-            openUrl: service.url,
-            startup: {
-                projects: path.resolve(projectsRoot), state: path.resolve(stateDirectory),
-                core: service.bridge.binary, rscript: service.bridge.rscript,
-                note: 'Open this url in a browser on this machine. Execution stays off until an Agent submits a run; project.doctor answers what is missing.'
+        const projectsRoot = values.root ?? quickRoot, stateDirectory = values['state-dir'] ?? quickState;
+        const limits = values.limits ? JSON.parse(await fs.readFile(values.limits, 'utf8')) : {};
+        const allowed = new Set(['maxRequestBytes', 'maxEventBytes', 'eventRetention', 'maxSubscriptions', 'maxQueue', 'maxContexts', 'maxBindings', 'maxActivities', 'maxContextBytes', 'maxRetainedMetadataBytes', 'maxConcurrentActions', 'maxOperations', 'maxLogPageBytes', 'maxCodeBytes', 'maxReconciled', 'documents', 'resources', 'workspace', 'r', 'annotations', 'interactions', 'capabilityLimits', 'browser', 'nativeFolders', 'conversations', 'evidence', 'console']);
+        if (Object.keys(limits).some(k => !allowed.has(k)))
+            throw new Error('Unknown service budget in --limits file.');
+        const { RhoService } = await import('./server.js'), { runtime } = await import('./runtime.js');
+        const agentBackend = values['agent-backend'] ?? process.env.RHO_AGENT_BACKEND ?? 'claude-acp';
+        if (!['claude-acp', 'codex-acp', 'claude-cli', 'acp'].includes(agentBackend))
+            throw new Error('Choose --agent-backend claude-acp, codex-acp, claude-cli or acp.');
+        const acpCommand = agentBackend === 'acp' ? parseAcpCommand(values['acp-command'] ?? process.env.RHO_ACP_COMMAND) : undefined;
+        if (values.port !== undefined && !(/^\d+$/.test(values.port) && Number(values.port) <= 65535)) {
+            process.stderr.write('Choose --port 0 to 65535, or leave it out.\n');
+            process.exit(2);
+        }
+        // A Core that cannot be used (none for this platform, a changed digest) is read by a person.
+        const native = await runtime(values.core, values.rscript).catch(e => { process.stderr.write((e instanceof Error ? e.message : String(e)) + '\n'); process.exit(1); });
+        // A person starting Rho sees the project it ships with; a composition that starts a service
+        // for its own work says so itself and is left alone.
+        if (values.example !== undefined && !['on', 'off'].includes(values.example))
+            throw new Error('Choose --example on or off.');
+        const example = values.example !== 'off';
+        const service = await new RhoService({ example, ...limits, root: path.resolve(projectsRoot), stateDir: path.resolve(stateDirectory), ...native, agentBackend: agentBackend, acpCommand, codex: values.codex ?? process.env.RHO_CODEX ?? 'codex', claude: values.claude ?? process.env.RHO_CLAUDE ?? 'claude', python: values.python ?? process.env.RHO_PYTHON, ssh: values.ssh ?? process.env.RHO_SSH, serverctl: values.serverctl ?? process.env.RHO_SERVERCTL, port: values.port === undefined ? undefined : Number(values.port), ...(values.plugins !== undefined ? { plugins: values.plugins ? values.plugins.split(',') : [] } : {}) }).start().catch(async (error) => {
+            // Starting Rho again on a state it already runs on is the common refusal: say where it runs.
+            const held = error?.details?.stateDirectory;
+            const running = typeof held === 'string' ? await fs.readFile(path.join(held, 'connection.json'), 'utf8').then(text => String(JSON.parse(text).url), () => '') : '';
+            return refuse(running ? Object.assign(error, { message: `Rho is already running for ${held} at ${running}. Open that url, or stop that service before starting it again.` }) : error);
+        });
+        // The narrow conclusion a person needs on one line: what was selected, where state
+        // lives, and how to open it. It stays inside `ready` so a parser reading line one is
+        // unaffected. Opening this url on this machine is the access; no link is minted.
+        const rscript = values.rscript ?? process.env.RHO_RSCRIPT ?? 'Rscript';
+        process.stdout.write(JSON.stringify({ ready: {
+                url: service.url, connectionFile: path.join(service.state.directory, 'connection.json'), apiVersion: '2.0',
+                openUrl: service.url,
+                startup: {
+                    projects: path.resolve(projectsRoot), state: path.resolve(stateDirectory),
+                    core: service.bridge.binary, rscript: service.bridge.rscript,
+                    note: 'Open this url in a browser on this machine. Execution stays off until an Agent submits a run; project.doctor answers what is missing.'
+                }
+            } }) + '\n');
+        // What a person needs, after the machine line: where it is, and what is missing to work in it.
+        // A missing Agent or R does not stop the workspace; it decides what the person can do next.
+        if (quickStart) {
+            const say = (text) => process.stdout.write(text + '\n');
+            say('');
+            say('Rho is running. Open this address in a browser on this machine:');
+            say('  ' + service.url);
+            say('');
+            say('Projects folder: ' + quickRoot);
+            say('Service state:   ' + quickState);
+            say('');
+            const agentCommand = await import('@rho-workspace/plugin-agent/acp-command').catch(() => null);
+            // The selection the service itself got: an explicit flag, then the environment, then the name
+            // on PATH. Reporting "installed" for a client the person pointed at a missing path is worse
+            // than saying nothing.
+            const claudePath = values.claude ?? process.env.RHO_CLAUDE, codexPath = values.codex ?? process.env.RHO_CODEX;
+            const env = { ...process.env, ...(claudePath ? { CLAUDE_CODE_EXECUTABLE: claudePath } : {}), ...(codexPath ? { CODEX_PATH: codexPath } : {}) };
+            // An ACP agent named with --acp-command is the operator's own command; it is named, not checked.
+            if (acpCommand)
+                say('Agent: ' + acpCommand.file + ', named with --acp-command.');
+            else {
+                const missing = agentCommand ? agentCommand.missingClient(agentBackend === 'codex-acp' ? 'codex' : 'claude', env) : null;
+                say(missing
+                    ? 'Agent: ' + missing + ' Until then folders can be opened and files read here; the Agent cannot run in them.'
+                    : 'Agent: ' + (agentBackend === 'codex-acp' ? 'Codex' : 'Claude Code') + ' is installed; a conversation can start in any project.');
             }
-        } }) + '\n');
-    // What a person needs, after the machine line: where it is, and what is missing to work in it.
-    // A missing Agent or R does not stop the workspace; it decides what the person can do next.
-    if (quickStart) {
-        const say = (text) => process.stdout.write(text + '\n');
-        say('');
-        say('Rho is running. Open this address in a browser on this machine:');
-        say('  ' + service.url);
-        say('');
-        say('Projects folder: ' + quickRoot);
-        say('Service state:   ' + quickState);
-        say('');
-        const agentCommand = await import('@rho-workspace/plugin-agent/acp-command').catch(() => null);
-        // The selection the service itself got: an explicit flag, then the environment, then the name
-        // on PATH. Reporting "installed" for a client the person pointed at a missing path is worse
-        // than saying nothing.
-        const claudePath = values.claude ?? process.env.RHO_CLAUDE, codexPath = values.codex ?? process.env.RHO_CODEX;
-        const env = { ...process.env, ...(claudePath ? { CLAUDE_CODE_EXECUTABLE: claudePath } : {}), ...(codexPath ? { CODEX_PATH: codexPath } : {}) };
-        // An ACP agent named with --acp-command is the operator's own command; it is named, not checked.
-        if (acpCommand)
-            say('Agent: ' + acpCommand.file + ', named with --acp-command.');
-        else {
-            const missing = agentCommand ? agentCommand.missingClient(agentBackend === 'codex-acp' ? 'codex' : 'claude', env) : null;
-            say(missing
-                ? 'Agent: ' + missing + ' Until then folders can be opened and files read here; the Agent cannot run in them.'
-                : 'Agent: ' + (agentBackend === 'codex-acp' ? 'Codex' : 'Claude Code') + ' is installed; a conversation can start in any project.');
+            const hasR = await fs.access(service.bridge.rscript).then(() => true, () => false);
+            say(hasR
+                ? 'R: ' + service.bridge.rscript
+                : 'R: Rscript was not found. Reading, editing and viewing work; running R needs R installed (or --rscript).');
+            say('');
+            say('Stop it with Ctrl+C. Start it again with: npx @rho-workspace/rho');
+            if (process.stdout.isTTY)
+                openBrowser(service.url);
         }
-        const hasR = await fs.access(service.bridge.rscript).then(() => true, () => false);
-        say(hasR
-            ? 'R: ' + service.bridge.rscript
-            : 'R: Rscript was not found. Reading, editing and viewing work; running R needs R installed (or --rscript).');
-        say('');
-        say('Stop it with Ctrl+C. Start it again with: npx @rho-workspace/rho');
-        if (process.stdout.isTTY)
+        if (values.open)
             openBrowser(service.url);
+        let closing = false;
+        // Windows has no SIGTERM another process can send, and a console may pass on Ctrl+C turned off;
+        // there Ctrl+Break on Rho's console (SIGBREAK) stops it in order too.
+        for (const signal of ['SIGTERM', 'SIGINT', ...(process.platform === 'win32' ? ['SIGBREAK'] : [])])
+            process.on(signal, async () => { if (closing)
+                return; closing = true; const reports = await service.close(); process.stdout.write(JSON.stringify({ shutdown: reports }) + '\n'); });
     }
-    if (values.open)
-        openBrowser(service.url);
-    let closing = false;
-    // Windows has no SIGTERM another process can send, and a console may pass on Ctrl+C turned off;
-    // there Ctrl+Break on Rho's console (SIGBREAK) stops it in order too.
-    for (const signal of ['SIGTERM', 'SIGINT', ...(process.platform === 'win32' ? ['SIGBREAK'] : [])])
-        process.on(signal, async () => { if (closing)
-            return; closing = true; const reports = await service.close(); process.stdout.write(JSON.stringify({ shutdown: reports }) + '\n'); });
 }