@shardflux/cli 0.14.4 → 0.15.0

package/dist/codex-cloud.js

@@ -0,0 +1,157 @@
+import { spawn } from 'node:child_process';
+import { CodedError, UsageError } from "./errors.js";
+import { json } from "./format.js";
+import { syncAgentCredentials } from "./agent-credentials.js";
+import { createConversation, resumeConversation } from "./conversations.js";
+import { AgentStateStore } from "./agent-state.js";
+import { ensureProjectGit } from "./project-git.js";
+import { gitRunner } from "./agent-git.js";
+import { projectIdentity } from "./project-identity.js";
+import { uploadInitialImages } from "./initial-prompt.js";
+/** Only provider-returned task ids enter the registered Codex deep-link route. */
+export async function openCodexThread(task, env) {
+    const url = threadLink(task);
+    const program = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'rundll32' : 'xdg-open';
+    const args = process.platform === 'win32' ? ['url.dll,FileProtocolHandler', url] : [url];
+    const child = spawn(program, args, { env, stdio: 'ignore' });
+    await new Promise((resolve, reject) => { const timer = setTimeout(() => { child.kill('SIGKILL'); reject(new Error('Codex app did not open in time')); }, 10000); child.once('error', error => { clearTimeout(timer); reject(error); }); child.once('exit', code => { clearTimeout(timer); if (code === 0)
+        resolve();
+    else
+        reject(new Error(`Open this Cloud thread in Codex: ${task.desktop_url}`)); }); });
+}
+function threadLink(task) {
+    if (!task.thread_id || !/^[a-zA-Z0-9_-]{1,128}$/.test(task.thread_id) || task.desktop_url !== `codex://threads/${encodeURIComponent(task.thread_id)}?hostId=durable`)
+        throw new Error('Cloud returned an invalid Codex thread link');
+    return task.desktop_url;
+}
+export async function submitCloudInitialPrompt(ctx, c, prompt, workspaceKey) {
+    try {
+        await ctx.cloud().conversations.send(c.id, prompt, { idempotencyKey: `codex-initial-${c.id}`, signal: ctx.signal });
+    }
+    catch {
+        throw new CodedError('initial_prompt_failed', `Created ${workspaceKey}, but the initial prompt could not be confirmed. Open that conversation before starting another.`, undefined, { workspace_key: workspaceKey, conversation_id: c.id, submitted: null });
+    }
+}
+async function output(ctx, c, task, submitted = false) {
+    const url = threadLink(task);
+    if (ctx.json) {
+        ctx.io.stdout.write(json({ conversation: c, cloud: task, url, ...(submitted ? { initial_prompt: { submitted: true } } : {}) }));
+        return;
+    }
+    ctx.io.stdout.write(`${c.key}\n${task.desktop_url}\n`);
+    await openCodexThread(task, ctx.io.env);
+}
+/** How long the account's Codex remote device may take to come up before it counts as stuck. */
+export const CODEX_STARTING_LIMIT_MS = 5 * 60_000;
+/** When a connector generation started: its UUIDv7 time. */
+export function generationStarted(generation) {
+    const hex = generation?.replace(/-/g, '').slice(0, 12);
+    return hex && /^[0-9a-f]{12}$/i.test(hex) ? parseInt(hex, 16) : null;
+}
+export function codexHealth(c, workspaceState, now = Date.now()) {
+    if (!c)
+        return 'missing';
+    if (c.state === 'disabled' || c.state === 'disabling')
+        return 'disabled';
+    if (c.state === 'ready' && c.environment_id)
+        return 'ready';
+    const started = generationStarted(c.generation);
+    const late = started !== null && now - started > CODEX_STARTING_LIMIT_MS;
+    // A new device reports attention while its executor is still connecting, and the API tries again every 10 s on its
+    // own (staging: about 40 s after enable, ready 9 s later). Until the starting limit that is starting, not Retry.
+    if (c.state === 'attention')
+        return late || started === null ? 'attention' : 'starting';
+    if (workspaceState === 'failed' || workspaceState === 'deleted')
+        return 'failed';
+    if (late)
+        return 'stuck';
+    return 'starting';
+}
+/** The connector and the state of its workspace (failed, deleted when it is gone). Never wakes anything. */
+export async function readCodexConnector(ctx) {
+    const connector = await ctx.cloud().codex.connector().catch((error) => { if (error.status === 404)
+        return null; throw error; });
+    if (!connector?.workspace_id || connector.state !== 'starting')
+        return { connector, workspaceState: null };
+    const workspace = await ctx.cloud().workspaces.get(connector.workspace_id).then(w => w.data.deleted_at ? 'deleted' : w.data.observed_state, (error) => { if (error.status === 404)
+        return 'deleted'; throw error; });
+    return { connector, workspaceState: workspace };
+}
+/**
+ * Starts the remote device again, once: disable, wait until it is disabled (bounded), enable. One executor per account
+ * throughout. Used by Retry in setup and Settings; never called in a loop.
+ */
+export async function restartCodexConnector(ctx, timeoutMs = 60_000) {
+    const codex = ctx.cloud().codex;
+    await codex.disable();
+    const end = Date.now() + timeoutMs;
+    for (;;) {
+        const current = await codex.connector().catch((error) => { if (error.status === 404)
+            return null; throw error; });
+        if (!current || current.state === 'disabled')
+            break;
+        if (Date.now() >= end)
+            throw new UsageError('Codex is still switching off; try again in a minute.');
+        await new Promise(resolve => setTimeout(resolve, 1000));
+    }
+    return await codex.enable({ signal: ctx.signal });
+}
+export async function ensureCodexCloud(ctx) {
+    await syncAgentCredentials(ctx.cloud(), { home: ctx.io.env.HOME ?? ctx.io.env.USERPROFILE, redact: value => ctx.addSecret(value) });
+    // A remote device that failed or is stuck starting gets one new start; a starting or ready one is left alone.
+    const { connector, workspaceState } = await readCodexConnector(ctx);
+    const health = codexHealth(connector, workspaceState);
+    if (health === 'failed' || health === 'stuck' || health === 'attention')
+        await restartCodexConnector(ctx);
+    else
+        await ctx.cloud().codex.enable({ signal: ctx.signal });
+    return ctx.cloud().codex.waitConnector({ timeoutMs: ctx.wakeTimeoutMs, signal: ctx.signal });
+}
+export async function launchCodexCloud(ctx, values, path, images = []) {
+    if (values.in !== undefined && values.in !== 'codex-app')
+        throw new UsageError('New Codex conversations open in Codex Cloud. Omit --in or use --in codex-app.');
+    if (values.like !== undefined)
+        throw new UsageError('Choose the project directory with --path; new Codex conversations use its latest machine template.');
+    const project = projectIdentity(path);
+    await ensureProjectGit(ctx, project.folder);
+    await gitRunner(project.folder, { ...process.env, ...ctx.io.env }, ctx.signal)(['rev-parse', 'HEAD']);
+    await ensureCodexCloud(ctx);
+    const created = await createConversation(ctx, path, 'codex', 'codex-cloud', typeof values.name === 'string' ? values.name : undefined);
+    const c = created.conversation;
+    // --computer: the conversation VM's desktop is on before Codex starts, so the thread gets the computer tools.
+    if (values.computer === true)
+        await created.workspace.setComputerUse(true);
+    // The thread's tools run in this VM, so its first message can name the images by their VM paths.
+    await uploadInitialImages(created.workspace.cell(), images, ctx.signal);
+    // Idempotency follows the durable conversation, including a lost response.
+    await ctx.cloud().codex.admit(c.id, { idempotencyKey: `codex-${c.id}`, signal: ctx.signal });
+    const task = await ctx.cloud().codex.waitTask(c.id, { timeoutMs: ctx.wakeTimeoutMs, signal: ctx.signal });
+    new AgentStateStore(ctx.store.dir).save(project.remote ?? project.folder, 'codex');
+    const submitted = typeof values.initialPrompt === 'string';
+    if (submitted)
+        await submitCloudInitialPrompt(ctx, c, values.initialPrompt, created.workspace.key);
+    await output(ctx, c, task, submitted);
+    return 0;
+}
+export async function openCodexConversation(ctx, c) {
+    if (c.state === 'done' || c.state === 'archived' || c.ended_at) {
+        c = await resumeConversation(ctx, c);
+        await ctx.cloud().codex.admit(c.id, { idempotencyKey: `codex-resume-${c.id}-${c.workspace_id}`, signal: ctx.signal });
+        const task = await ctx.cloud().codex.waitTask(c.id, { timeoutMs: ctx.wakeTimeoutMs, signal: ctx.signal });
+        await output(ctx, c, task);
+        return 0;
+    }
+    const task = await ctx.cloud().codex.task(c.id);
+    if (task.state === 'canceled')
+        throw new UsageError('This conversation’s Codex executor was removed. Start a new Cloud conversation; its saved branch and history remain available.');
+    if (task.state !== 'active' || !task.thread_id)
+        throw new UsageError('This Cloud conversation is not ready; inspect it with shard agents codex status.');
+    // Opening provider history does not wake the conversation VM.
+    await output(ctx, c, task);
+    return 0;
+}
+export const CODEX_CLOUD_HANDLERS = {
+    'agents codex status': async (ctx) => { ctx.io.stdout.write(json(await ctx.cloud().codex.connector())); return 0; },
+    'agents codex enable': async (ctx) => { ctx.io.stdout.write(json(await ensureCodexCloud(ctx))); return 0; },
+    'agents codex disable': async (ctx) => { ctx.io.stdout.write(json(await ctx.cloud().codex.disable())); return 0; },
+};

package/dist/command-center-actions.js

@@ -11,6 +11,7 @@ import { agentName as gitAgentName } from "./agent-git.js";
 import { randomUUID } from 'node:crypto';
 import { prepareAgentMachine } from "./agent-machine.js";
 import { OperationFailedError } from '@shardflux/sdk';
+import { launchConversationProject } from "./conversation-terminal.js";
 /** L9 can register target-specific handlers after detecting the installed applications. */
 export async function availableTargets(ctx) {
     const { HANDLERS } = await import("./handlers.js");
@@ -33,6 +34,12 @@ export async function agentAction(ctx, action, values, args) {
 }
 export const CENTER_HANDLERS = {
     async 'agents new'(ctx, values, [ref]) {
+        if ((values.prompt !== undefined || values['prompt-file'] !== undefined || values.image !== undefined) && (ref || values.name !== undefined || values.like !== undefined || values.in !== undefined)) {
+            throw new UsageError('An initial prompt needs a new conversation: use agents new --path <folder> --app claude|codex.');
+        }
+        if (!ref && values.name === undefined && values.like === undefined && values.in === undefined) {
+            return launchConversationProject(ctx, values, [str(values.path) ?? './', ...(str(values.app) ? [str(values.app)] : [])]);
+        }
         if (values.name !== undefined || !ref || values.path !== undefined) {
             return launchProject(ctx, { ...values, ...(ref && values.like === undefined ? { like: ref } : {}) }, [str(values.path) ?? './', ...(str(values.app) ? [str(values.app)] : [])]);
         }

package/dist/command-center-renderer.d.ts

@@ -15,6 +15,9 @@ export interface CenterView {
     };
     extraKeys: string[];
     menubarHint?: string;
+    doneCount?: number;
+    showDone?: boolean;
+    now?: number;
 }
 export declare function renderCenter(view: CenterView, columns: number, height: number, color?: boolean): string[];
 /** Cursor-address changed lines only; polling an unchanged view writes nothing. */

package/dist/command-center-renderer.js

@@ -1,6 +1,6 @@
-import { browserSessionNote, workspaceBrowserSessionNote } from "./browser-profile-copy.js";
 import { agentName } from "./command-center-model.js";
 import { setupLine } from "./assisted-setup.js";
+import { terminalBrand } from "./terminal-brand.js";
 /** API titles and local input never get to send terminal controls. */
 export function plain(value) { return [...value].map(ch => { const code = ch.codePointAt(0); return code < 32 || code >= 127 && code <= 159 ? ' ' : ch; }).join(''); }
 function width(ch) {
@@ -23,63 +23,67 @@ export function clip(value, columns) {
 export function renderCenter(view, columns, height, color = true) {
     columns = Math.max(1, Math.min(1000, columns));
     height = Math.max(1, Math.min(1000, height));
-    const lines = ['shardflux  /  Cloud agents', view.filter ? `Filter: ${view.filter}` : 'Projects / agents / sessions  ·  attention first', ''];
+    const prompt = view.prompt?.replace(/ {2}\(Enter accepts, Esc cancels\)$/, '');
+    const lines = [prompt ? `  ${prompt}` : '  + New conversation  n', view.filter && !prompt ? `  Search: ${view.filter}` : ''];
+    const selectedRow = view.rows.find(row => row.id === view.selected);
     const body = [];
-    const sites = (profiles) => [...new Set(profiles.flatMap(p => p.sites.map(s => s.site)))].join(', ');
-    // Project-scoped sessions reach every row, so they are named once; workspace-scoped ones sit under their agent.
-    const shared = [...new Map(view.rows.flatMap(r => r.browserProfiles ?? []).filter(p => p.scope === 'project').map(p => [p.name, p])).values()];
-    if (shared.length)
-        body.push({ text: `Browser sessions: ${sites(shared)}` }, { text: browserSessionNote }, { text: '' });
-    let project = '', key = '';
+    const age = (since) => {
+        if (!since || !Number.isFinite(Date.parse(since)))
+            return '';
+        const minutes = Math.max(0, Math.floor(((view.now ?? Date.now()) - Date.parse(since)) / 60000));
+        return minutes < 1 ? 'now' : minutes < 60 ? `${minutes}m` : minutes < 1440 ? `${Math.floor(minutes / 60)}h` : `${Math.floor(minutes / 1440)}d`;
+    };
     for (const row of view.rows) {
-        if (row.project !== project) {
-            project = row.project;
-            key = '';
-            body.push({ text: project });
-            const setup = view.rows.find(candidate => candidate.project === project && candidate.setup)?.setup;
-            const progress = setup && setupLine(project, setup);
-            if (progress)
-                body.push({ text: `  ${progress}` });
-        }
         if (row.start) {
-            body.push({ text: '  Start Claude here (or Codex)', id: row.id });
+            body.push({ text: `  Start a conversation in ${row.project}`, id: row.id });
             continue;
         }
-        if (row.key !== key) {
-            key = row.key;
-            body.push({ text: `  ${agentName(key, row.agent?.labels ?? row.workspace?.labels ?? {})}` });
-            const own = row.browserProfiles?.filter(p => p.scope !== 'project') ?? [];
-            if (own.length)
-                body.push({ text: `    Browser sessions: ${sites(own)}` }, { text: `    ${workspaceBrowserSessionNote}` });
-        }
-        const session = row.agent?.id.slice(row.agent.workspace_id.length + 1);
-        body.push({ text: `    [${row.badge}] ${row.agent ? `${row.agent.app}  ${clip(session, 12)}  ${row.agent.title || 'Untitled session'}` : 'Open a session'}`, id: row.id, badge: row.badge });
+        const title = row.agent?.title || (row.agent ? 'Untitled conversation' : 'Open a conversation');
+        const project = `${row.project}/${agentName(row.key, row.agent?.labels ?? row.workspace?.labels ?? {})}`;
+        const suffix = `  ${clip(project, Math.max(8, Math.floor(columns * 0.29)))}  ${age(row.agent?.since).padStart(3)}`;
+        const titleWidth = Math.max(1, columns - suffix.length - 7);
+        const name = clip(title, titleWidth);
+        body.push({ text: `  ${row.badge === 'done' ? '○' : '●'}  ${name}${' '.repeat(Math.max(0, titleWidth - [...name].reduce((n, c) => n + width(c), 0)))}${suffix}`, id: row.id, badge: row.badge });
     }
     if (!body.length)
-        body.push({ text: view.filter ? 'No matching sessions. Press / to change the filter.' : 'No cloud agents. Run shard <path> to start a project.' });
+        body.push({ text: view.message ? '' : view.filter ? '  No conversations match this search.' : '  Your conversations will appear here.' });
     const available = Math.max(0, height - 7);
     const selected = body.findIndex(r => r.id === view.selected);
     const start = Math.max(0, selected - available + 1);
     for (const row of body.slice(start, start + available)) {
-        let line = clip(`${row.id === view.selected ? '>' : ' '} ${row.text}`, columns);
+        let line = clip(row.text, columns);
+        if (row.id && row.id === view.selected)
+            line = '›' + line.slice(1);
         if (color) {
             if (row.badge === 'working')
-                line = `\x1b[38;5;208m${line}\x1b[0m`;
+                line = line.replace('●', `\x1b[38;2;${terminalBrand['sf-molten'].join(';')}m●\x1b[39m`);
             if (row.badge === 'done')
-                line = `\x1b[2m${line}\x1b[0m`;
-            if (row.id === view.selected)
-                line = `\x1b[7m${line}\x1b[0m`;
+                line = `\x1b[2m${line}\x1b[22m`;
+            if (row.id && row.id === view.selected)
+                line = `\x1b[48;2;${terminalBrand['sf-overlay'].join(';')}m\x1b[38;2;${terminalBrand['sf-ink'].join(';')}m${line}\x1b[0m`;
         }
         lines.push(line);
     }
-    while (lines.length < height - 4)
+    while (lines.length < height - 5)
         lines.push('');
-    lines.push(view.prompt ?? view.message, 'Enter open  o open in  n session  N agent  f fork  p park', `l logs  / filter  q quit${view.extraKeys.length ? `  ${view.extraKeys.join('  ')}` : ''}`, view.menubarHint ?? `${view.rows.length} session${view.rows.length === 1 ? '' : 's'}  ·  refresh every 2s`);
+    const profiles = selectedRow?.browserProfiles ?? [];
+    const sites = (rows) => [...new Set(rows.flatMap(p => p.sites.map(s => s.site)))].join(', ');
+    const sharedSites = sites(profiles.filter(p => p.scope === 'project'));
+    const ownSites = sites(profiles.filter(p => p.scope !== 'project'));
+    const browserContext = [sharedSites && `project · ${sharedSites}`, ownSites && `conversation · ${ownSites}`].filter(Boolean).join('  |  ');
+    const detail = selectedRow && !selectedRow.start ? `${selectedRow.agent?.app === 'codex' ? 'Codex' : 'Claude'} · ${selectedRow.badge}${selectedRow.agent?.last_message ? ` · ${selectedRow.agent.last_message}` : ''}` : '';
+    lines.push(view.message || (selectedRow?.setup && setupLine(selectedRow.project, selectedRow.setup)) || detail);
+    lines.push(browserContext ? `  Browser sign-ins: ${browserContext}` : '');
+    lines.push(view.doneCount ? `  ${view.doneCount} done  ·  D ${view.showDone ? 'hide' : 'show'}` : '');
+    lines.push(view.prompt ? '  Enter continue   Esc cancel' : '  Enter open   n new   / search   ? actions   q quit');
+    lines.push(view.menubarHint ?? '');
     if (view.menu) {
-        const menu = [view.menu.title, ...view.menu.items.map((item, i) => `${i === view.menu.selected ? '>' : ' '} ${item}`), 'Enter select  Esc cancel'];
-        const offset = Math.min(3, Math.max(0, height - menu.length));
+        const menu = [`  ${view.menu.title}`, '', ...view.menu.items.map((item, i) => `${i === view.menu.selected ? '›' : ' '} ${item}`), '', '  Enter select   Esc back'];
+        const offset = Math.min(2, Math.max(0, height - menu.length));
         for (let i = 0; i < menu.length && offset + i < height; i++)
-            lines[offset + i] = menu[i];
+            lines[offset + i] = clip(menu[i], columns);
+        for (let i = offset + menu.length; i < height - 1; i++)
+            lines[i] = '';
     }
     return lines.slice(0, height).map(line => line.includes('\x1b') ? line : clip(line, columns));
 }

package/dist/command-center.js

@@ -12,6 +12,7 @@ import { ensureMenubar } from "./menubar.js";
 import { MenubarManager } from "./menubar.js";
 import { homedir } from 'node:os';
 import { retrySetupStep } from "./assisted-setup.js";
+import { localConversations } from "./conversations.js";
 export async function showCenter(ctx, scope, options = {}) {
     const input = ctx.io.stdin;
     if (!input.isTTY || !input.setRawMode || !input.on || !input.off)
@@ -30,6 +31,7 @@ export async function showCenter(ctx, scope, options = {}) {
     let timer, escapeTimer;
     let refreshing;
     let edit;
+    let showDone = false, draftPrompt = '';
     let menuActions = [];
     let finish;
     const done = new Promise(resolve => { finish = resolve; });
@@ -41,7 +43,10 @@ export async function showCenter(ctx, scope, options = {}) {
         ctx.io.stdout.write(renderer.draw(renderCenter(view, size.columns, size.rows, ctx.io.env.NO_COLOR === undefined && ctx.io.env.TERM !== 'dumb')));
     };
     const updateRows = () => {
-        view.rows = centerRows(data, scope, view.filter);
+        const rows = centerRows(data, scope, view.filter);
+        view.doneCount = rows.filter(row => row.badge === 'done').length;
+        view.showDone = showDone;
+        view.rows = showDone || view.filter ? rows : rows.filter(row => row.badge !== 'done');
         if (!view.rows.some(r => r.id === view.selected))
             view.selected = view.rows[0]?.id;
     };
@@ -157,6 +162,43 @@ export async function showCenter(ctx, scope, options = {}) {
             return;
         }
         if (edit) {
+            if ((edit.kind === 'task' || edit.kind === 'project') && key === 'enter') {
+                if (!edit.text.trim()) {
+                    view.message = edit.kind === 'task' ? 'Describe what the agent should do.' : 'Choose a project folder.';
+                    draw();
+                    return;
+                }
+                if (edit.kind === 'task') {
+                    draftPrompt = edit.text;
+                    const row = view.rows.find(r => r.id === view.selected);
+                    const records = Object.values(localConversations(ctx));
+                    const folder = scope?.folder ?? records.find(r => r.conversation.workspace_id === row?.workspace?.id)?.folder ?? records[0]?.folder ?? process.cwd();
+                    edit = { kind: 'project', text: folder };
+                    view.message = '';
+                    view.prompt = `Project folder: ${folder}  (Enter accepts, Esc cancels)`;
+                }
+                else {
+                    let project;
+                    try {
+                        project = projectIdentity(edit.text);
+                    }
+                    catch {
+                        view.message = 'Choose an accessible project folder.';
+                        draw();
+                        return;
+                    }
+                    edit = undefined;
+                    view.prompt = undefined;
+                    view.message = '';
+                    const preferred = options.app ?? new AgentStateStore(ctx.store.dir).app(project.remote ?? project.folder);
+                    menu('Start conversation', [preferred, preferred === 'claude' ? 'codex' : 'claude'].map(app => ({
+                        label: `${app === 'claude' ? 'Claude' : 'Codex'} · ${project.slug}`,
+                        run: () => dispatch('new', { path: project.folder, app, prompt: draftPrompt }, [], true),
+                    })));
+                }
+                draw();
+                return;
+            }
             if (key === 'escape') {
                 if (edit.kind === 'filter') {
                     view.filter = edit.previous ?? '';
@@ -164,6 +206,7 @@ export async function showCenter(ctx, scope, options = {}) {
                 }
                 edit = undefined;
                 view.prompt = undefined;
+                view.message = '';
             }
             else if (key === 'enter') {
                 const current = edit;
@@ -193,14 +236,14 @@ export async function showCenter(ctx, scope, options = {}) {
             }
             else if (key === 'backspace')
                 edit.text = [...edit.text].slice(0, -1).join('');
-            else if ([...key].length === 1 && key >= ' ' && edit.text.length < (edit.kind === 'filter' ? 256 : 64))
+            else if ([...key].length === 1 && key >= ' ' && edit.text.length < (edit.kind === 'task' ? 4096 : edit.kind === 'project' ? 2048 : edit.kind === 'filter' ? 256 : 64))
                 edit.text += key;
             if (edit) {
                 if (edit.kind === 'filter') {
                     view.filter = edit.text;
                     updateRows();
                 }
-                view.prompt = `${edit.kind === 'filter' ? 'Filter' : 'New agent name'}: ${edit.text}  (Enter accepts, Esc cancels)`;
+                view.prompt = `${edit.kind === 'filter' ? 'Search' : edit.kind === 'task' ? 'What should the agent do?' : edit.kind === 'project' ? 'Project folder' : 'New agent name'}: ${edit.text}  (Enter accepts, Esc cancels)`;
             }
             draw();
             return;
@@ -230,10 +273,28 @@ export async function showCenter(ctx, scope, options = {}) {
         }
         if (key === '/') {
             edit = { kind: 'filter', text: view.filter, previous: view.filter };
-            view.prompt = `Filter: ${view.filter}`;
+            view.prompt = `Search: ${view.filter}`;
             draw();
             return;
         }
+        if (key === 'D') {
+            showDone = !showDone;
+            updateRows();
+            draw();
+            return;
+        }
+        if (key === 'n' || key === 'enter' && view.rows.find(r => r.id === view.selected)?.start) {
+            edit = { kind: 'task', text: '' };
+            view.message = '';
+            view.prompt = 'What should the agent do? ';
+            draw();
+            return;
+        }
+        if (key === '?') {
+            const choices = [['n', 'New conversation'], ['o', 'Open in…'], ['N', 'New agent workspace'], ['f', 'Fork workspace'], ['p', 'Park'], ['l', 'View logs'], ...(view.rows.find(row => row.id === view.selected)?.setup ? [['r', 'Retry setup']] : []), ...extra, ['D', showDone ? 'Hide done conversations' : 'Show done conversations']];
+            menu('Conversation actions', choices.map(([key, label]) => ({ label: `${key}  ${label}`, run: () => handle(key) })));
+            return;
+        }
         const row = view.rows.find(r => r.id === view.selected);
         if (!row)
             return;
@@ -257,10 +318,6 @@ export async function showCenter(ctx, scope, options = {}) {
         }
         const project = scope ? scope.remote ?? scope.folder : row.workspace?.labels.repo_remote || row.project;
         const app = row.agent?.app || options.app || new AgentStateStore(ctx.store.dir).app(project, row.workspace?.labels.app === 'codex' ? 'codex' : 'claude');
-        if (row.start && ['enter', 'n', 'N'].includes(key)) {
-            menu('Start here', [app, app === 'claude' ? 'codex' : 'claude'].map(app => ({ label: `Start ${app === 'claude' ? 'Claude' : 'Codex'} here`, run: () => dispatch('new', { path: scope.folder, app }, [], true) })));
-            return;
-        }
         if (key === 'enter') {
             const target = new AgentStateStore(ctx.store.dir).target(project, ['terminal', ...installedTargets(ctx.io.env).targets]);
             await dispatch('open', { app, project, in: target }, [row.key], true);
@@ -272,9 +329,6 @@ export async function showCenter(ctx, scope, options = {}) {
                     await dispatch('open', { app, project, in: target }, [row.key], true);
                 } })));
         }
-        else if (key === 'n') {
-            menu('New session', ['claude', 'codex'].map(app => ({ label: `${app === 'claude' ? 'Claude' : 'Codex'} (reattach if running)`, run: () => dispatch('new', { app, project }, [row.key], true) })));
-        }
         else if (key === 'N' || key === 'f') {
             edit = { kind: key === 'N' ? 'new' : 'fork', text: '' };
             view.prompt = 'New agent name: ';

package/dist/conversation-terminal.js

@@ -13,13 +13,22 @@ import { ensureMenubar, MenubarManager } from "./menubar.js";
 import { UsageError } from "./errors.js";
 import { localResumeTerminal } from "./conversation-local-resume.js";
 import { agentReachability } from "./agent-reachability.js";
+import { promptWithImages, readInitialImages, readInitialPrompt, uploadInitialImages } from "./initial-prompt.js";
+import { launchCodexCloud, openCodexConversation } from "./codex-cloud.js";
 /** Every terminal entry point uses the durable conversation's native harness, worktree and session. */
 export async function conversationTerminal(ctx, ws, c, project, values) {
+    if (c.route === 'codex-cloud')
+        return openCodexConversation(ctx, c);
     await restoreConversationBinding(ctx, c, ws);
     return terminal(ctx, ws, c.harness, conversationName(c), project, values, undefined, c.worktree_path, { id: c.id, session: c.harness_session_id });
 }
 /** Select a durable conversation, then use the harness's native terminal for all interaction. */
 export const launchConversationProject = async (ctx, values, [path = './', explicit]) => {
+    const text = await readInitialPrompt(ctx, values);
+    // Images are read and validated before allocation, held in memory, and written only into the new VM.
+    const images = await readInitialImages(ctx, values, text);
+    const initialPrompt = text === undefined ? undefined : promptWithImages(text, images);
+    values = { ...values, ...(initialPrompt === undefined ? {} : { initialPrompt }) };
     const project = projectIdentity(path), store = new AgentStateStore(ctx.store.dir);
     const app = explicit === 'claude' || explicit === 'codex' ? explicit : store.app(project.remote ?? project.folder);
     if (explicit && explicit !== app)
@@ -39,9 +48,13 @@ export const launchConversationProject = async (ctx, values, [path = './', expli
             return localResumeTerminal(ctx, c, project.folder);
         const next = await resumeConversation(ctx, c);
         rememberConversation(ctx, next, project.folder);
+        if (next.route === 'codex-cloud')
+            return openCodexConversation(ctx, next);
         const ws = await conversationWorkspace(ctx, next);
         return conversationTerminal(ctx, ws, next, project.remote ?? project.folder, values);
     }
+    if (app === 'codex')
+        return launchCodexCloud(ctx, values, path, images);
     await syncAgentCredentials(ctx.cloud(), { home: ctx.io.env.HOME, redact: value => ctx.addSecret(value) });
     const signedIn = app === 'claude' ? await cloudClaudeLogin(ctx) : true;
     if (!signedIn)
@@ -59,7 +72,10 @@ export const launchConversationProject = async (ctx, values, [path = './', expli
         const ws = await ctx.cloud().workspaces.open({ ...agentReachability(values), key: `${project.slug}/${name}`, template: prepared.template,
             labels: { ...projectLabels(project, name, app), ...prepared.labels, repo_path: projectWorkspacePath(project) },
             wait: { timeoutMs: ctx.wakeTimeoutMs, signal: ctx.signal } });
+        if (values.computer === true)
+            await ws.setComputerUse(true);
         await seedAgentRepository(ctx, ws, project.folder, { populate: true });
+        await uploadInitialImages(ws.cell(), images, ctx.signal);
         if (!signedIn)
             await loginClaudeInWorkspace(ctx, ws);
         if (!(await savedMachine(ctx))?.template)
@@ -67,6 +83,9 @@ export const launchConversationProject = async (ctx, values, [path = './', expli
         return terminal(ctx, ws, app, name, project.remote ?? project.folder, values, prepared.setupHash);
     }
     const { conversation: c, workspace: ws } = created;
+    if (values.computer === true)
+        await ws.setComputerUse(true);
+    await uploadInitialImages(ws.cell(), images, ctx.signal);
     if (values.reachable !== undefined)
         await ctx.cloud().workspaces.open({ key: ws.key, ...agentReachability(values), wait: false });
     if (!signedIn)

package/dist/conversations.d.ts

@@ -9,7 +9,7 @@ export interface Conversation {
     summary: string;
     harness: Harness;
     harness_session_id: string | null;
-    route: 'terminal' | 'acp' | 'codex-app' | 'claude-desktop' | 't3-ssh';
+    route: 'terminal' | 'acp' | 'codex-app' | 'codex-cloud' | 'claude-desktop' | 't3-ssh';
     workspace_id: string;
     worktree_path: string;
     branch: string;

package/dist/conversations.js

@@ -104,14 +104,27 @@ export async function createConversationRecord(ctx, folder, harness, route, name
 export async function createConversation(ctx, folder, harness, route, name) {
     const project = projectIdentity(folder);
     const c = await createConversationRecord(ctx, project.folder, harness, route, name);
-    const ws = await conversationWorkspace(ctx, c);
-    // This is a one-time seed. A conversation never watches or writes the owner's checkout.
-    await seedAgentRepository(ctx, ws, project.folder, { root: c.worktree_path, populate: true });
-    const cell = ws.cell();
-    const result = await cell.exec.run(['git', '-C', c.worktree_path, 'checkout', '-B', c.branch, c.base_commit], { timeoutMs: 30_000, signal: ctx.signal });
-    if (result.exitCode !== 0)
-        throw new Error(`Conversation branch could not be prepared: ${result.stderr.trim()}`);
-    return { conversation: c, workspace: ws };
+    try {
+        const ws = await conversationWorkspace(ctx, c);
+        // This is a one-time seed. A conversation never watches or writes the owner's checkout.
+        await seedAgentRepository(ctx, ws, project.folder, { root: c.worktree_path, populate: true });
+        const cell = ws.cell();
+        const result = await cell.exec.run(['git', '-C', c.worktree_path, 'checkout', '-B', c.branch, c.base_commit], { timeoutMs: 30_000, signal: ctx.signal });
+        if (result.exitCode !== 0)
+            throw new Error(`Conversation branch could not be prepared: ${result.stderr.trim()}`);
+        return { conversation: c, workspace: ws };
+    }
+    catch (error) {
+        if (route === 'codex-cloud') {
+            try {
+                await ctx.cloud().workspaces.delete(c.workspace_id);
+            }
+            catch (cleanup) {
+                throw new AggregateError([error, cleanup], `Cloud setup failed; remove owned workspace ${c.workspace_id} before retrying.`, { cause: cleanup });
+            }
+        }
+        throw error;
+    }
 }
 export async function resumeConversation(ctx, c) {
     if (c.state !== 'done' && c.state !== 'archived')

package/dist/credential-prompts.d.ts

@@ -5,6 +5,8 @@ type Selection = {
     vault: Vault;
     item: string;
     always: boolean;
+    scope?: 'ask' | 'project' | 'machine';
+    remember?: boolean;
     fields: CredentialRequest['fields'];
 };
 export declare class SiteVaultStore {
@@ -12,8 +14,8 @@ export declare class SiteVaultStore {
     constructor(directory: string);
     key(api: string, project: string, site: string): string;
     read(): Record<string, Selection>;
-    get(api: string, project: string, site: string): Selection | undefined;
-    save(api: string, project: string, site: string, selection: Selection): void;
+    get(api: string, project: string, site: string, profile?: string): Selection | undefined;
+    save(api: string, project: string, site: string, selection: Selection, profile?: string): void;
 }
 export declare function approveCredential(ctx: Ctx, request: CredentialRequest, selection: Selection, remember?: boolean): Promise<void>;
 export declare function configureCredentialFill(ctx: Ctx, ws: Workspace): Promise<boolean>;