@shardflux/cli 0.19.0 → 0.19.1

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Changelog
 
-## 0.19.0 (not yet published)
+## 0.19.1 (not yet published)
+
+- A first prompt is never lost to a slow or unusual start. `--prompt` / `--prompt-file` types the prompt only into the
+  agent's input box, never into one of its dialogs ("❯ 1. Yes"). If the terminal never shows the input box and
+  nothing was typed, the prompt goes to the conversation's own inbox, which delivers it once the agent reads input.
+  `--json` then reports `"initial_prompt": {"submitted": false, "queued": true}` instead of failing with
+  `initial_prompt_failed`.
+- Brings the Shardflux app for Ubuntu 0.1.3: Try it once never waits silently. A demo agent still waiting with nothing
+  said 45 s after its start gets its task once more through its conversation, and one line says so; still nothing
+  45 s later, one line says it hasn't started. The optional dependency on `@shardflux/desktop-linux-x64` / `-arm64` is
+  exactly 0.1.3.
+
+## 0.19.0 (2026-10-11)
 
 - A new conversation on an account without a saved machine gets its first prompt in seconds, whatever is in
   `~/.claude` and `~/.codex`. The prompt is typed first, and this computer's Claude and Codex config is copied into

package/dist/agent-commands.js

@@ -28,6 +28,7 @@ import { openInFor } from "./t3-mode.js";
 import { openClaudeDesktopSession, openDesktopWorkspace, queueT3Prewarm } from "./agent-target-commands.js";
 import { submitInitialPrompt, prepareInitialCodexProject } from "./initial-prompt.js";
 import { conversationWorkspace, conversationsUnavailable, getConversation, listConversations, resumeConversation } from "./conversations.js";
+import { conversationClient } from "./conversation-commands.js";
 import { conversationTerminal, reopenConversation } from "./conversation-terminal.js";
 import { CHOICE_PENDING, choiceReport, hasChoice, launchChoice, modelChoice, runFlags } from "./agent-models.js";
 const active = (session) => session.state === 'running' || session.state === 'starting';
@@ -145,8 +146,12 @@ export async function terminal(ctx, ws, app, agent, project, values, setupHash,
                 throw new Error(`project setup could not be queued: ${queued.stderr.trim() || `exit ${queued.exitCode}`}`);
         });
         store.save(project, app);
+        let delivery;
         if (typeof values.initialPrompt === 'string') {
-            await submitInitialPrompt(signal => cellConnector(cell, session.session_id)(0, signal), values.initialPrompt, ws.key, ctx.signal, app, bytes => cell.pty.input(session.session_id, bytes));
+            const text = values.initialPrompt;
+            // A conversation's guest delivers the prompt itself when this terminal never showed its input box (0.19.1+).
+            const queue = conversation ? () => conversationClient(ctx).conversations.send(conversation.id, text, { signal: ctx.signal }) : undefined;
+            delivery = await submitInitialPrompt(signal => cellConnector(cell, session.session_id)(0, signal), text, ws.key, ctx.signal, app, bytes => cell.pty.input(session.session_id, bytes), queue);
         }
         // Work that must never delay the first prompt (the laptop's agent config, 0.19.0+) starts once the agent has it.
         const after = conversation?.afterStart?.();
@@ -154,7 +159,7 @@ export async function terminal(ctx, ws, app, agent, project, values, setupHash,
             await preparation;
             // conversation (0.16.0+): which conversation this session is, also when its computer hosts several threads.
             // model_choice (0.17.0+): the requested model and effort, and whether this thread started with them.
-            ctx.io.stdout.write(json({ workspace: ws.data, session, ...(conversation ? { conversation: { id: conversation.id } } : {}), ...(typeof values.initialPrompt === 'string' ? { initial_prompt: { submitted: true } } : {}),
+            ctx.io.stdout.write(json({ workspace: ws.data, session, ...(conversation ? { conversation: { id: conversation.id } } : {}), ...(delivery ? { initial_prompt: delivery === 'submitted' ? { submitted: true } : { submitted: false, queued: true } } : {}),
                 ...(hasChoice(explicit) ? { model_choice: choiceReport(explicit, applied) } : {}) }));
             await after;
             return 0;

package/dist/args.d.ts

@@ -1,4 +1,4 @@
-export declare const CLI_VERSION = "0.19.0";
+export declare const CLI_VERSION = "0.19.1";
 export interface OptionSpec {
     type: 'string' | 'boolean';
     short?: string;

package/dist/args.js

@@ -13,7 +13,7 @@ import { parseArgs } from 'node:util';
 import { ACCOUNT_COMMANDS } from "./account-args.js";
 import { UsageError } from "./errors.js";
 import { DEFAULT_CHOICE, MODEL_CHOICES } from "./agent-models.js";
-export const CLI_VERSION = '0.19.0';
+export const CLI_VERSION = '0.19.1';
 export const GLOBAL_OPTIONS = {
     'api-url': { type: 'string', value: '<url>', description: 'API base URL (default $SHARDFLUX_API_URL, else https://api.shardflux.dev).' },
     json: { type: 'boolean', description: 'Print machine-readable JSON on stdout (errors as JSON on stderr).' },

package/dist/initial-prompt.d.ts

@@ -22,5 +22,18 @@ export declare function readInitialImages(ctx: Ctx, values: Values, prompt: stri
 export declare function promptWithImages(prompt: string, images: readonly InitialImage[]): string;
 /** Writes the images into the conversation VM before the first message refers to them. */
 export declare function uploadInitialImages(cell: Pick<CellClient, 'files'>, images: readonly InitialImage[], signal?: AbortSignal): Promise<void>;
-/** Wait for the native terminal to enable paste before submitting one first turn. No blind timing or input replay. */
-export declare function submitInitialPrompt(connect: (signal: AbortSignal) => Promise<TerminalConnection>, prompt: string, workspaceKey: string, signal: AbortSignal, app?: 'claude' | 'codex', write?: (bytes: Uint8Array) => Promise<unknown>): Promise<void>;
+/** The conversation inbox takes a message of at most this many characters (the API's text limit). */
+export declare const INBOX_MAX_CHARS = 65536;
+/**
+ * The harness's input box is the last thing that drew its prompt glyph (0.19.1+). Claude Code and Codex draw the same
+ * glyph as the selection cursor of their dialogs ("❯ 1. Yes, I trust this folder"); a prompt pasted there would pick
+ * options. The guest's own first-message delivery reads the screen the same way (coding 39+).
+ */
+export declare function inputBoxReady(tail: string, glyph: string): boolean;
+/**
+ * Wait for the native terminal to enable paste before submitting one first turn. No blind timing or input replay.
+ * When nothing was typed yet and the terminal never became ready, `queue` hands the prompt to the conversation's guest
+ * (its inbox, which waits for the harness and retries Enter) and the result is `queued` (0.19.1+): a first prompt is
+ * never lost to a slow start.
+ */
+export declare function submitInitialPrompt(connect: (signal: AbortSignal) => Promise<TerminalConnection>, prompt: string, workspaceKey: string, signal: AbortSignal, app?: 'claude' | 'codex', write?: (bytes: Uint8Array) => Promise<unknown>, queue?: () => Promise<unknown>): Promise<'submitted' | 'queued'>;

package/dist/initial-prompt.js

@@ -137,8 +137,26 @@ export async function uploadInitialImages(cell, images, signal) {
         await cell.files.write(image.path, image.data, { mode: '0600', createParents: true });
     }
 }
-/** Wait for the native terminal to enable paste before submitting one first turn. No blind timing or input replay. */
-export async function submitInitialPrompt(connect, prompt, workspaceKey, signal, app = 'claude', write) {
+/** The conversation inbox takes a message of at most this many characters (the API's text limit). */
+export const INBOX_MAX_CHARS = 65536;
+/**
+ * The harness's input box is the last thing that drew its prompt glyph (0.19.1+). Claude Code and Codex draw the same
+ * glyph as the selection cursor of their dialogs ("❯ 1. Yes, I trust this folder"); a prompt pasted there would pick
+ * options. The guest's own first-message delivery reads the screen the same way (coding 39+).
+ */
+export function inputBoxReady(tail, glyph) {
+    // eslint-disable-next-line no-control-regex -- Native terminal escapes are removed before reading the screen text.
+    const plain = tail.replace(/\x1b\[[0-?]*[ -/]*[@-~]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, ' ');
+    const at = plain.lastIndexOf(glyph);
+    return at >= 0 && !/^[\s\u00a0]*\d+\./.test(plain.slice(at + glyph.length));
+}
+/**
+ * Wait for the native terminal to enable paste before submitting one first turn. No blind timing or input replay.
+ * When nothing was typed yet and the terminal never became ready, `queue` hands the prompt to the conversation's guest
+ * (its inbox, which waits for the harness and retries Enter) and the result is `queued` (0.19.1+): a first prompt is
+ * never lost to a slow start.
+ */
+export async function submitInitialPrompt(connect, prompt, workspaceKey, signal, app = 'claude', write, queue) {
     const bounded = AbortSignal.any([signal, AbortSignal.timeout(20000)]);
     let connection;
     let sent = false, pasted = false;
@@ -159,7 +177,7 @@ export async function submitInitialPrompt(connect, prompt, workspaceKey, signal,
             // eslint-disable-next-line no-control-regex -- Strip native terminal ANSI before matching prompt echo.
             const plain = tail.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, '').replace(/\s/g, '');
             if (sent && bytes.length)
-                return;
+                return 'submitted';
             if (pasted) {
                 // A long prompt overflows the input box: a 24-row terminal shows only its end, so either end confirms the paste.
                 const compact = prompt.replace(/\s/g, '');
@@ -174,7 +192,7 @@ export async function submitInitialPrompt(connect, prompt, workspaceKey, signal,
                 tail = '';
                 continue;
             }
-            const ready = app === 'claude' ? tail.includes('❯') : tail.includes('›');
+            const ready = inputBoxReady(tail, app === 'claude' ? '❯' : '›');
             if (!ready || !pasteEnabled)
                 continue;
             const paste = Buffer.from(`\x1b[200~${prompt}\x1b[201~`);
@@ -188,6 +206,13 @@ export async function submitInitialPrompt(connect, prompt, workspaceKey, signal,
         throw new Error('The agent terminal closed before accepting a prompt.');
     }
     catch {
+        if (!pasted && queue && !signal.aborted && prompt.length <= INBOX_MAX_CHARS) {
+            try {
+                await queue();
+                return 'queued';
+            }
+            catch { /* reported as not submitted below */ }
+        }
         throw new CodedError('initial_prompt_failed', `Created ${workspaceKey}, but the initial prompt ${sent ? 'could not be confirmed' : 'was not submitted'}. Open that conversation before starting another.`, undefined, { workspace_key: workspaceKey, submitted: sent });
     }
     finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardflux/cli",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "type": "module",
   "description": "shard: the Shardflux command line. Create an account, sign in, set up keys and billing, then open, run commands in, move files to, suspend, resume and fork serverless agent workspaces.",
   "license": "Apache-2.0",
@@ -58,9 +58,9 @@
     "typescript-eslint": "8.70.1"
   },
   "optionalDependencies": {
-    "@shardflux/desktop-linux-x64": "0.1.2",
-    "@shardflux/desktop-linux-arm64": "0.1.2",
-    "@shardflux/menubar-darwin": "^0.7.0"
+    "@shardflux/desktop-linux-x64": "0.1.3",
+    "@shardflux/desktop-linux-arm64": "0.1.3",
+    "@shardflux/menubar-darwin": "^0.7.1"
   },
   "scripts": {
     "build": "node scripts/build.mjs",