@shardflux/cli 0.24.1 → 0.28.0

package/dist/account-pool.d.ts

@@ -6,7 +6,7 @@
  * With --json every write prints the updated `{accounts, pool}` block (the menu bar redraws from it), plus the account
  * it changed. Sign-ins run the provider's own login in a workspace, as `shard agents credentials login claude` does.
  */
-import type { AgentAccount, AgentAccountList, AgentAccountWindow } from '@shardflux/sdk';
+import type { AgentAccount, AgentAccountList, AgentAccountModels, AgentAccountWindow } from '@shardflux/sdk';
 import type { Ctx, Handler } from './commands.js';
 /**
  * Codex names its windows primary and secondary; their length says which is the 5-hour and which the weekly one (a
@@ -31,6 +31,16 @@ export declare function formatAccounts(list: AgentAccountList, now: number): str
 export declare function formatUsage(list: AgentAccountList, now: number): string;
 /** Codex's device sign-in page, as Codex 0.160.0 prints it (test/fixtures/cloud-agents/codex-login-device-auth-0.160.0.json). */
 export declare function codexLoginUrls(output: string): string[];
+/**
+ * `shard agents models` (0.27.0+): each account's models as its provider lists them for that account, the way Claude
+ * Code and Codex ask for their pickers. The default effort is starred; the harness's default model is marked.
+ */
+export declare function formatModels(entries: Array<AgentAccountModels & {
+    label?: string;
+    active?: boolean;
+}>, now: number): string;
+/** `shard agents models` (no `shard models` alias: that one is the model template). */
+export declare const AGENT_MODELS_HANDLERS: Record<string, Handler>;
 export declare const ACCOUNT_POOL_HANDLERS: Record<string, Handler>;
 /** The `accounts` block of `shard agents targets --json` (0.18.0+): the account list for the menu bar; null when it cannot be read. */
 export declare function targetsAccounts(ctx: Ctx): Promise<AgentAccountList | null>;

package/dist/account-pool.js

@@ -207,6 +207,54 @@ async function signIn(ctx, values, app) {
             await api.cancelSignIn(claim.sign_in_id).catch(() => undefined);
     }
 }
+const REASONS = { disabled: 'turned off for this account', not_entitled: 'not included for this account', not_in_plan: 'not in this plan' };
+/** "3m ago", "2h ago". */
+const ago = (at, now) => { const m = Math.max(0, Math.round((now - Date.parse(at)) / 60_000)); return m < 60 ? `${m}m ago` : `${Math.round(m / 60)}h ago`; };
+/**
+ * `shard agents models` (0.27.0+): each account's models as its provider lists them for that account, the way Claude
+ * Code and Codex ask for their pickers. The default effort is starred; the harness's default model is marked.
+ */
+export function formatModels(entries, now) {
+    if (!entries.length)
+        return 'No Claude or ChatGPT/Codex account is signed in. Add one with shard agents accounts add claude|codex.\n';
+    const lines = [];
+    for (const e of entries) {
+        const freshness = e.source === 'builtin' ? 'the harness’s own list until the provider answers' : e.stale && e.fetched_at ? `as of ${ago(e.fetched_at, now)}` : '';
+        lines.push(`${PROVIDERS[e.provider]}${e.label ? ` · ${e.label}` : ''}${e.active ? ' (active)' : ''}${freshness ? ` · ${freshness}` : ''}`);
+        const width = Math.max(...e.models.map(m => m.id.length), 8) + 2, nameWidth = Math.max(...e.models.map(m => m.name.length), 4) + 2;
+        const row = (m) => `  ${m.id.padEnd(width)}${m.name.padEnd(nameWidth)}${m.available
+            ? `${m.efforts.map(x => x === m.default_effort ? `${x}*` : x).join(' ') || 'no effort levels'}${m.id === e.default_model ? '  (default)' : ''}`
+            : `unavailable: ${m.reason_text ?? (m.reason ? REASONS[m.reason] : 'not offered')}`}`;
+        const main = e.models.filter(m => m.section === 'main'), more = e.models.filter(m => m.section === 'more');
+        lines.push(...main.map(row));
+        if (more.length)
+            lines.push('  More models', ...more.map(row));
+        lines.push('');
+    }
+    lines.push('Start with one: shard agents new <claude|codex> --model <id> --effort <level> (* the model’s default effort).');
+    return `${lines.join('\n')}\n`;
+}
+/** `shard agents models` (no `shard models` alias: that one is the model template). */
+export const AGENT_MODELS_HANDLERS = {
+    async 'agents models'(ctx, values) {
+        const api = ctx.cloud().agentAccounts;
+        const refresh = values.refresh === true;
+        if (values.account !== undefined) {
+            if (typeof values.account !== 'string' || !values.account.trim())
+                throw new UsageError('--account needs an account: its id, claude:<n>, codex:<n>, email or label.');
+            const account = findAccount(await api.list(), values.account.trim());
+            if (account.kind !== 'oauth')
+                throw new UsageError(`${name(account)} is an API key: it has no model list. Sign in with shard agents accounts add ${account.provider}.`);
+            const models = await api.models(account.id, { refresh });
+            out(ctx, formatModels([{ ...models, label: name(account), active: isActive(account) }], Date.now()), models);
+            return 0;
+        }
+        const all = await api.allModels({ provider: optionalProvider(values.provider), refresh });
+        const shown = values.all === true ? all.accounts : all.accounts.filter(a => a.active);
+        out(ctx, formatModels(shown, Date.now()), { accounts: shown });
+        return 0;
+    },
+};
 export const ACCOUNT_POOL_HANDLERS = {
     async 'agents accounts'(ctx, values) {
         const list = await ctx.cloud().agentAccounts.list({ provider: optionalProvider(values.provider) });

package/dist/acp-journal.js

@@ -90,6 +90,28 @@ export class AcpJournal {
     }
     #wanted() { return !this.#signal.aborted && !this.rpc.closed && this.#paused === 0 && (this.rpc.busy || this.#cursor.prompt_id !== undefined); }
     async #deliver(inputId, message) {
+        let failures = 0;
+        const started = performance.now();
+        while (true) {
+            this.#signal.throwIfAborted();
+            try {
+                return await this.#deliverOnce(inputId, message);
+            }
+            catch (error) {
+                // Guest restarts can refuse a new input command while its native
+                // supervisor keeps running. Its persisted receipt deduplicates this
+                // exact input id, including a command accepted before the refusal.
+                // An unverified receipt or a permanent error still stops delivery.
+                if (!(error instanceof ShardfluxApiError) || !error.retryable)
+                    throw error;
+                const remaining = RECONNECT_BUDGET_MS - (performance.now() - started);
+                if (remaining <= 0)
+                    throw new Error('ACP input reconnect timed out; load this session to continue.', { cause: error });
+                await delay(Math.min(reattachDelayMs(error, ++failures), remaining), undefined, { signal: this.#signal });
+            }
+        }
+    }
+    async #deliverOnce(inputId, message) {
         const dir = `/home/user/.local/share/shardflux/acp/${this.#conversation}`;
         const payload = Buffer.from(`{"mode":"input","input_id":${JSON.stringify(inputId)},"message":${message}}\n`);
         if (payload.length <= ONE_SHOT_INPUT) {
@@ -133,7 +155,7 @@ export class AcpJournal {
         finally {
             await this.#cell.exec.cancel(session.session_id, 0).catch(() => undefined);
         }
-        // Never resend an uncertain mutation. Its stable input identity is fenced by CVB before provider stdin.
+        // Retries retain inputId: CVB persists its receipt before provider stdin.
     }
     start() {
         this.#initial ??= this.#replay().then(() => { this.#ready = true; this.#follow(); }).catch(error => { this.rpc.close(error instanceof Error ? error : new Error(String(error))); throw error; });

package/dist/agent-commands.js

@@ -33,7 +33,7 @@ import { guestFirstPrompt, INBOX_MAX_CHARS, submitInitialPrompt, prepareInitialC
 import { conversationForOpen, 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";
+import { CHOICE_PENDING, choiceReport, hasChoice, launchChoice, liveModels, modelChoice, runFlags } from "./agent-models.js";
 const active = (session) => session.state === 'running' || session.state === 'starting';
 /** `<slug>-<6 hex of sha256(identity)>`: the same repository gets the same key on every machine. */
 export function disambiguatedSlug(slug, identity) {
@@ -135,7 +135,7 @@ export async function terminal(ctx, ws, app, agent, project, values, setupHash,
         });
         // This command's --model/--effort, else the conversation's own (a relaunch keeps its model). A computer whose guest
         // predates the choice starts the agent with its defaults, and this command says so once.
-        const help = runHelp(cell, app, ctx.signal), explicit = modelChoice(values, app);
+        const help = runHelp(cell, app, ctx.signal), explicit = modelChoice(values, app, await liveModels(ctx, values, app));
         const { choice, applied } = await launchChoice(explicit, conversation?.choice, !!conversation, help);
         if (hasChoice(explicit) && !applied && !ctx.json)
             ctx.io.stderr.write(`${CHOICE_PENDING}\n`);
@@ -242,7 +242,8 @@ export async function launchProjectWith(ctx, values, [path = './', explicitApp],
         throw new UsageError(`${target} is not an installed desktop target`);
     const app = explicitApp ?? store.app(projectKey, like?.labels.app === 'codex' ? 'codex' : 'claude');
     // A typo in --model or --effort is refused before anything starts; T3 Code reads the same values (0.17.0+).
-    const choice = modelChoice(values, target === 'codex-app' ? 'codex' : app);
+    const choiceApp = target === 'codex-app' ? 'codex' : app;
+    const choice = modelChoice(values, choiceApp, await liveModels(ctx, values, choiceApp));
     if (target === 'codex-app' || (app === 'codex' && !like && values.in === undefined && !linuxTerminalSession(ctx, values)))
         return launchCodexCloud(ctx, values, path);
     if (target === 'claude-desktop' && hasChoice(choice))

package/dist/agent-models.d.ts

@@ -30,13 +30,42 @@ export interface AppModels {
 export declare const DEFAULT_CHOICE = "default";
 /** Claude Code `--model <alias>` and `--effort <level>`; Codex `-m <model>` and `-c model_reasoning_effort=<level>`. */
 export declare const MODEL_CHOICES: Readonly<Record<ModelApp, AppModels>>;
+/** A model of the active account's live list (`shard agents models`, 0.27.0+): its id and the efforts it takes. */
+export interface LiveModel {
+    id: string;
+    efforts: string[];
+}
+interface ModelsSource {
+    cloud(): {
+        agentAccounts: {
+            allModels(opts: {
+                provider?: ModelApp;
+            }): Promise<{
+                accounts: Array<{
+                    active: boolean;
+                    models: Array<{
+                        id: string;
+                        efforts: string[];
+                        available: boolean;
+                    }>;
+                }>;
+            }>;
+        };
+    };
+}
+/**
+ * The active account's available models (0.27.0+), asked only when `--model` is not one of the aliases above: a full
+ * model id is accepted when the account's provider lists it (GET /v1/agent-accounts/models). Null when the API cannot
+ * say (an API before the route, or a failure): then only the aliases are accepted.
+ */
+export declare function liveModels(ctx: ModelsSource, values: Values, app: ModelApp): Promise<LiveModel[] | null>;
 /** What a thread starts with: absent fields are the agent's own default (no flag). */
 export interface ModelChoice {
     model?: string;
     effort?: string;
 }
 /** `--model` and `--effort` for this app, checked against its list. Throws a usage error for anything else. */
-export declare function modelChoice(values: Values, app: ModelApp): ModelChoice;
+export declare function modelChoice(values: Values, app: ModelApp, live?: readonly LiveModel[] | null): ModelChoice;
 export declare const hasChoice: (c: ModelChoice | undefined) => c is ModelChoice;
 /** The guest's `sf-agent run` flags for a choice (sf-agent maps them to the agent's own flags). */
 export declare function runFlags(c: ModelChoice | undefined): string[];
@@ -59,3 +88,4 @@ export declare function choiceReport(c: ModelChoice, applied: boolean): {
     effort: string;
     applied: boolean;
 };
+export {};

package/dist/agent-models.js

@@ -25,10 +25,31 @@ export const MODEL_CHOICES = {
         default: { model: 'gpt-6.1-sol', effort: null },
     },
 };
+/**
+ * The active account's available models (0.27.0+), asked only when `--model` is not one of the aliases above: a full
+ * model id is accepted when the account's provider lists it (GET /v1/agent-accounts/models). Null when the API cannot
+ * say (an API before the route, or a failure): then only the aliases are accepted.
+ */
+export async function liveModels(ctx, values, app) {
+    const model = typeof values.model === 'string' ? values.model.trim().toLowerCase() : '';
+    if (!model || MODEL_CHOICES[app].models.some(m => m.id === model))
+        return null;
+    // Another provider's model is refused without a request: Claude ids are claude-…; a Codex id is anything else.
+    const claudeId = model.startsWith('claude-') || MODEL_CHOICES.claude.models.some(m => m.id === model);
+    if (claudeId !== (app === 'claude'))
+        return null;
+    try {
+        const active = (await ctx.cloud().agentAccounts.allModels({ provider: app })).accounts.find(a => a.active);
+        return active ? active.models.filter(m => m.available).map(m => ({ id: m.id, efforts: m.efforts })) : null;
+    }
+    catch {
+        return null;
+    }
+}
 const list = (ids) => ids.length > 1 ? `${ids.slice(0, -1).join(', ')} or ${ids.at(-1)}` : ids[0];
 const label = (app) => app === 'claude' ? 'Claude' : 'Codex';
 /** `--model` and `--effort` for this app, checked against its list. Throws a usage error for anything else. */
-export function modelChoice(values, app) {
+export function modelChoice(values, app, live = null) {
     const raw = (name) => {
         const value = values[name];
         if (value === undefined)
@@ -39,9 +60,11 @@ export function modelChoice(values, app) {
     };
     const model = raw('model'), effort = raw('effort'), choices = MODEL_CHOICES[app];
     const option = model === undefined ? undefined : choices.models.find(m => m.id === model);
-    if (model !== undefined && !option)
-        throw new UsageError(`${label(app)} models: ${list(choices.models.map(m => m.id))}.`);
-    const allowed = option?.efforts ?? choices.efforts.map(e => e.id);
+    const listed = model === undefined || option ? undefined : live?.find(m => m.id === model);
+    if (model !== undefined && !option && !listed) {
+        throw new UsageError(`${label(app)} models: ${list(choices.models.map(m => m.id))}${live?.length ? `, or one this account has: ${live.map(m => m.id).join(', ')}` : ', or a model id from shard agents models'}.`);
+    }
+    const allowed = option?.efforts ?? (listed ? [DEFAULT_CHOICE, ...listed.efforts] : choices.efforts.map(e => e.id));
     if (effort !== undefined && !allowed.includes(effort)) {
         throw new UsageError(`${option?.efforts ? option.label : label(app)} effort levels: ${list(allowed)}.`);
     }

package/dist/args.d.ts

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

package/dist/args.js

@@ -12,9 +12,10 @@
 import { parseArgs } from 'node:util';
 import { ACCOUNT_COMMANDS } from "./account-args.js";
 import { BOARD_COMMANDS } from "./board-args.js";
+import { ORCHESTRATOR_COMMANDS } from "./orchestrator-args.js";
 import { UsageError } from "./errors.js";
 import { DEFAULT_CHOICE, MODEL_CHOICES } from "./agent-models.js";
-export const CLI_VERSION = '0.24.1';
+export const CLI_VERSION = '0.28.0';
 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).' },
@@ -156,7 +157,7 @@ const KEY_COMMANDS = [
     { path: ['conversations', 'feed'], summary: 'Print project conversations as they change', positionals: [], options: {
             project: { type: 'string', value: '<id>', description: 'Project ID for a user session.' }, org: { type: 'string', value: '<id|slug>', description: 'Signed in: every project of this organization you work in (0.25.0+).' }, cursor: { type: 'string', value: '<cursor>', description: 'Continue after this feed cursor (--json prints it with each change).' }
         },
-        description: 'Prints each conversation the moment it changes, until interrupted: "<id>  <title>  <state>", and why it needs you when it does; --json prints one {conversation, cursor} object per line. With an API key: its project. Signed in without a key: every project you work in, on one cursor (0.25.0+); --org follows one organization’s projects and uses your sign-in when you have one.',
+        description: 'Prints each conversation the moment it changes, until interrupted: "<id>  <title>  <state>", and why it needs you when it does; a deleted conversation shows once as "<id>  Deleted conversation  deleted" (0.25.0+); --json prints one {conversation, cursor} object per line. With an API key: its project. Signed in without a key: every project you work in, on one cursor (0.25.0+); --org follows one organization’s projects and uses your sign-in when you have one.',
         examples: ['shard c feed', 'shard c feed --org acme --json'] },
     { path: ['conversations', 'resume'], summary: 'Resume a saved conversation in a fresh VM', positionals: [{ name: 'id', required: true }], options: {} },
     { path: ['conversations', 'reader'], summary: 'Open a read-only project space reader', positionals: [{ name: 'project_id', required: true }], options: {} },
@@ -165,11 +166,12 @@ const KEY_COMMANDS = [
     { path: ['conversations', 'watch'], summary: 'Watch a conversation’s terminal live, read-only', positionals: [{ name: 'id', required: true }], options: {},
         description: 'Shows the terminal the conversation’s agent runs in (its pty_id, terminal conversations) as the agent works: its last 256 KiB, then live output, until the agent’s session exits or you press Ctrl-C. Nothing you type reaches it. Watching never keeps the computer awake while the agent is idle, and ends when the computer sleeps. The output is the terminal’s own bytes, so there is no --json form; shard agents logs <id> --json returns recent output as JSON.',
         examples: ['shard conversations watch conv_a7k2m4q6s3t5v7x2z4b6d3f5h7'] },
-    { path: ['conversations', 'send'], summary: 'Send the next user turn', positionals: [{ name: 'id', required: true }, { name: 'text', variadic: true, words: true }], options: {
-            file: { type: 'string', multiple: true, value: '<path>', description: 'Attach a file (repeatable, up to 20 of 64 MiB each): it lands in the conversation’s computer before the message, which lists its path there (0.25.0+).' }
+    { path: ['conversations', 'send'], summary: 'Send a message to a conversation’s agent', positionals: [{ name: 'id', required: true }, { name: 'text', variadic: true, words: true }], options: {
+            file: { type: 'string', multiple: true, value: '<path>', description: 'Attach a file (repeatable, up to 20 of 64 MiB each): it lands in the conversation’s computer before the message, which lists its path there (0.25.0+).' },
+            wait: { type: 'boolean', description: 'Wait up to 60 s for the agent to have the message and print what happened to it (0.27.0+).' }
         },
-        description: 'Text and files reach the conversation’s agent as its next turn. A conversation that ended is restored into a fresh computer first. Attached files keep their names under /home/user/.shardflux/attachments/<conversation id>/; each stored path is printed.',
-        examples: ['shard conversations send conv_6qz2dmu4kd3xa7v5l2hgmfnpjy "Fix the failing export test"', 'shard conversations send conv_6qz2dmu4kd3xa7v5l2hgmfnpjy "Why does this page break?" --file screenshot.png --file console.log'] },
+        description: 'A working agent takes the message into its running turn; an idle one starts its next turn with it. --wait (0.27.0+) waits up to 60 s and prints which: "Steered into the running turn.", "Started the next turn." or "Not delivered yet."; --json adds the delivery (state, delivered_at, steered). A conversation that ended is restored into a fresh computer first. Attached files keep their names under /home/user/.shardflux/attachments/<conversation id>/; each stored path is printed.',
+        examples: ['shard conversations send conv_6qz2dmu4kd3xa7v5l2hgmfnpjy "Fix the failing export test"', 'shard conversations send conv_6qz2dmu4kd3xa7v5l2hgmfnpjy "Use the staging database instead" --wait', 'shard conversations send conv_6qz2dmu4kd3xa7v5l2hgmfnpjy "Why does this page break?" --file screenshot.png --file console.log'] },
     { path: ['conversations', 'wait'], summary: 'Wait for a result or question', positionals: [{ name: 'id', required: true }], options: {
             until: { type: 'string', value: '<states>', description: 'Comma-separated conversation states.' }, timeout: { type: 'string', value: '<seconds>', description: 'Wait for 0..900 seconds (default 900).' }
         } },
@@ -194,8 +196,27 @@ const KEY_COMMANDS = [
     { path: ['conversations', 'events'], summary: 'Follow a conversation live: state, transcript, reply text and tool calls (0.25.0+)', positionals: [{ name: 'id', required: true }], options: {},
         description: 'Streams the conversation until Ctrl-C, one line per event: state changes, new transcript lines and tool calls, with the reply written as the agent streams it. With --json: one event per line, {"type":"conversation"|"transcript"|"delta","id":…} with the conversation, the transcript lines or the ACP session updates.',
         examples: ['shard c events conv_k3m5q7s2u4w6y3b5d7f2h4j6ln', 'shard c events conv_k3m5q7s2u4w6y3b5d7f2h4j6ln --json | jq -c \'select(.type=="delta")\''] },
-    { path: ['conversations', 'land'], summary: 'Record the landing action performed by the agent', positionals: [{ name: 'id', required: true }, { name: 'action', required: true }], options: { into: { type: 'string', value: '<ref>', description: 'Destination branch or PR URL.' } } },
+    { path: ['conversations', 'land'], summary: 'Land a conversation’s work: merge lands it for real; pr, keep and discard record the decision', positionals: [{ name: 'id', required: true }, { name: 'action', required: true }], options: {
+            into: { type: 'string', value: '<ref>', description: 'pr: the PR URL; keep: the branch (merge always lands in the project’s default branch).' },
+            path: { type: 'string', value: '<folder>', description: 'merge: the folder to land in (default: where the conversation started on this computer).' }
+        },
+        description: 'merge (0.25.0+) merges the conversation’s branch into the project’s default branch on the project hub (a fast-forward, or a merge commit when it is clean), brings it into your folder on this computer the way finished conversations land (your uncommitted edits stay), checks the commit is in the branch, and only then records it. pr, keep and discard record what was decided.',
+        examples: ['shard conversations land conv_k3m5q7s2u4w6y3b5d7f2h4j6ln merge', 'shard conversations land conv_k3m5q7s2u4w6y3b5d7f2h4j6ln discard'] },
     { path: ['conversations', 'move'], summary: 'Move at the end of the turn', positionals: [{ name: 'id', required: true }, { name: 'to', required: true }], options: {} },
+    { path: ['conversations', 'archive'], summary: 'Archive conversations from your inbox, on every device (0.28.0+)', positionals: [{ name: 'id', required: true, variadic: true, words: true }], options: {},
+        description: 'Archives them from your own inbox, the same in the Shardflux app, the CLI and every client you use: each one carries your dismissed_at until you unarchive it. The conversations, their agents and computers carry on, and everyone else keeps their own inbox. Name up to 200 ids at once. Prints "Archived <id>  <title>" for each, and "Not found: <id>" on stderr for an id you cannot read (exit 3 when none was found). --json prints {data, skipped}: the conversations with your seen_at and dismissed_at, and the ids not found.',
+        examples: ['shard c archive conv_k3m5q7s2u4w6y3b5d7f2h4j6ln', 'shard conversations archive conv_k3m5q7s2u4w6y3b5d7f2h4j6ln conv_a7k2m4q6s3t5v7x2z4b6d3f5h7 --json'] },
+    { path: ['conversations', 'unarchive'], summary: 'Bring archived conversations back to your inbox, on every device (0.28.0+)', positionals: [{ name: 'id', required: true, variadic: true, words: true }], options: {},
+        description: 'Brings them back to your own inbox everywhere: their dismissed_at reads null again. Name up to 200 ids at once. Prints "Unarchived <id>  <title>" for each, and "Not found: <id>" on stderr for an id you cannot read (exit 3 when none was found). --json prints {data, skipped}.',
+        examples: ['shard c unarchive conv_k3m5q7s2u4w6y3b5d7f2h4j6ln'] },
+    { path: ['conversations', 'seen'], summary: 'Mark conversations seen: you opened them now, on every device (0.28.0+)', positionals: [{ name: 'id', required: true, variadic: true, words: true }], options: {},
+        description: 'Records that you opened them now, the same on every device: their seen_at becomes now, so a result that finished before then is no longer new to you anywhere. Name up to 200 ids at once. Prints "Marked seen <id>  <title>" for each, and "Not found: <id>" on stderr for an id you cannot read (exit 3 when none was found). --json prints {data, skipped}.',
+        examples: ['shard c seen conv_k3m5q7s2u4w6y3b5d7f2h4j6ln conv_a7k2m4q6s3t5v7x2z4b6d3f5h7'] },
+    { path: ['conversations', 'delete'], summary: 'Delete a conversation everywhere: its computer, messages, transcript and branch (0.25.0+)', positionals: [{ name: 'id', required: true }], options: {
+            yes: { type: 'boolean', description: 'Required: confirm the deletion.' }
+        },
+        description: 'Deletes the conversation on every device at once: its agent stops and its computer is deleted (a computer other conversations share stays for them), its messages, transcript and permission requests go with it, and its branch and transcript copy leave the project space. From then on it leaves every list and reads not found. The person who started it (or created the API key that did) or an organization owner or admin deletes it; deleting it again answers the same. --json prints {id, deleted, deleted_at, operation}: operation is the deletion of its computer, null when other conversations share it.',
+        examples: ['shard c delete conv_k3m5q7s2u4w6y3b5d7f2h4j6ln --yes', 'shard conversations delete conv_k3m5q7s2u4w6y3b5d7f2h4j6ln --yes --json'] },
     { path: ['conversations', 'landing'], summary: 'Show or set how finished conversations reach this checkout', positionals: [{ name: 'mode' }, { name: 'backup' }], options: {
             path: { type: 'string', value: '<path>', description: 'Local project checkout (default the current directory).' }
         },
@@ -867,6 +888,12 @@ const KEY_COMMANDS = [
         description: `--ask (0.20.1+) asks your user for a secret file’s contents on a page on this computer; the page says Saved once the file is written. ${ASK_EVENTS}`,
         examples: ['shard files write acme/demo /home/user/notes.txt --from notes.txt', 'printf "x = 1\\n" | shard files write acme/agent-7 /home/user/app/config.py --if-revision 4', 'shard files write "$(shard machine open)" /home/user/.npmrc --ask --json'],
     },
+    {
+        path: ['files', 'delete'],
+        summary: 'Delete a file or empty directory in a workspace',
+        positionals: [REF, { name: 'path', required: true }],
+        options: { recursive: { type: 'boolean', description: 'Delete a directory and its contents (default false).' }, ...IF_REVISION, ...WAKE_TIMING },
+    },
     {
         path: ['files', 'ls'],
         summary: 'List a directory in a workspace',
@@ -1268,6 +1295,17 @@ const AGENT_ACCOUNT_COMMANDS = [
         examples: ['shard agents accounts use claude:2', 'shard agents accounts use marc@example.com --json'] },
     { path: ['agents', 'accounts', 'remove'], summary: 'Remove an account and its login (0.18.0+)', positionals: [{ name: 'account', required: true }], options: {} },
 ];
+/** The models each account can use (0.27.0+); not aliased under `shard models` (the model template). */
+const AGENT_MODELS_COMMANDS = [
+    { path: ['agents', 'models'], summary: 'The models each account can use, as Claude and ChatGPT list them for it: efforts, default, what the plan does not include (0.27.0+)', positionals: [], options: {
+            account: { type: 'string', value: '<account>', description: 'This account’s models (its id, claude:<n>, codex:<n>, email or label) instead of the active accounts’.' },
+            provider: ACCOUNT_PROVIDER,
+            all: { type: 'boolean', description: 'Every account, not only the active one of each provider.' },
+            refresh: { type: 'boolean', description: 'Ask the provider again (lists are kept for an hour).' },
+        },
+        description: 'Asked server side with each account’s own sign-in, the way Claude Code and Codex fill their model pickers; never starts a computer. Pass an id to shard agents new --model. --json prints {accounts: [...]} (one account with --account).',
+        examples: ['shard agents models', 'shard agents models --account claude:2', 'shard agents models --provider codex --json'] },
+];
 /** `shard accounts …`: the same commands, as the menu bar and the design name them. */
 const ACCOUNT_ALIASES = AGENT_ACCOUNT_COMMANDS.map(c => ({ ...c, path: c.path.slice(1), hidden: true }));
 const COMPUTER_OPTION = { type: 'boolean', description: 'Give the new conversation a desktop with a browser its agent drives (computer use).' };
@@ -1334,11 +1372,14 @@ const AGENT_COMMANDS = [
             detach: { type: 'boolean', description: 'Start it in the cloud without opening it here.' },
         }, examples: ['shard move --last', 'shard move --list', 'shard move --session 3d085e35-aa66-4866-9a53-f09719d6767c --detach --json'] },
     { path: ['device', 'requests'], summary: 'Review local device requests waiting for approval', positionals: [], options: {} },
+    { path: ['device', 'approvals'], summary: 'How this computer answers your agents: auto (allow everything), read (allow reading, ask before changes) or ask (0.27.0+)',
+        description: 'Without a mode: the current one and what ran without asking. Only your own agents run without asking; a teammate\'s request always asks.',
+        positionals: [{ name: 'mode', required: false }], options: {}, examples: ['shard device approvals auto', 'shard device approvals ask'] },
     ...['approve', 'deny'].map((action) => ({ path: ['device', action], summary: `${action} a local device request`, positionals: [{ name: 'id', required: true }], options: action === 'approve' ? { always: { type: 'boolean', description: 'Allow matching requests for this project, or for a folder request (0.25.0+) that folder and what is inside it; never for other access outside the conversation folder.' } } : {} })),
     { path: ['conversations', 'start'], summary: 'Start a conversation from the project or on your machine, no folder needed (0.25.0+)', positionals: [], options: {
             project: { type: 'string', value: '<id>', description: 'The project (default: the API key’s, or this computer’s selected project).' },
             home: { type: 'boolean', description: 'Start on your machine’s home, without a repository: the agent runs in /home/user and starts threads in the project’s repositories.' },
-            repo: { type: 'string', value: '<remote>', description: 'The repository (default: the project’s most recently active one).' },
+            repo: { type: 'string', value: '<remote>', description: 'The repository (default: the project’s only one; a project with several asks you to name it).' },
             branch: { type: 'string', value: '<name>', description: 'Start from this branch’s newest saved point in the project (default main, then master).' },
             app: { type: 'string', value: '<claude|codex>', description: 'Agent app (default claude).' },
             title: { type: 'string', value: '<text>', description: 'The conversation’s title (default: named by its first message).' },
@@ -1420,9 +1461,10 @@ const MENUBAR_COMMANDS = [{ path: ['menubar', 'account'], hidden: true, summary:
 const SETTINGS_COMMANDS = [{
         path: ['settings'], summary: 'Show or change this computer’s settings for cloud conversations (0.20.1+)', positionals: [], options: {
             'title-prefix': { type: 'string', value: '<text|none|default>', description: 'The marker your cloud conversations’ Claude session titles start with in claude.ai and the Claude app ("☁ Fix login bug · todo-app"): up to 16 characters on one line; none for no marker, default for ☁. New conversations use it.' },
+            'auto-land': { type: 'string', value: '<on|off>', description: 'Bring finished cloud work (conversations and board tasks) into your folders on this computer automatically (0.27.0+, default on).' },
         },
-        description: 'Shows the title marker, where new conversations open and the terminal app (change those two with "shard agents targets --open-in" and "--terminal"). The menu bar and desktop apps change the same settings.',
-        examples: ['shard settings', 'shard settings --title-prefix SF', 'shard settings --title-prefix none', 'shard settings --title-prefix default --json'],
+        description: 'Shows the title marker, where new conversations open, the terminal app (change those two with "shard agents targets --open-in" and "--terminal") and auto land. The menu bar and desktop apps change the same settings.',
+        examples: ['shard settings', 'shard settings --title-prefix SF', 'shard settings --title-prefix none', 'shard settings --title-prefix default --json', 'shard settings --auto-land off'],
     }];
 /** The board's input bar from a terminal (0.25.0+): route a line of input, ask a quick question about the work. */
 const BOARD_SCOPE = {
@@ -1433,8 +1475,9 @@ const BOARD_SCOPE_HELP = 'Reads your organization’s projects and open tasks wi
 const ROUTER_COMMANDS = [
     {
         path: ['route'],
-        summary: 'Route input like the board’s input bar: its project, task, question or steer, split per task (0.25.0+)',
+        summary: 'Deprecated: route input like the board’s input bar (use shard orchestrator say) (0.25.0+)',
         description: [
+            'Deprecated: shard orchestrator say <words> sends your input to your orchestrator, which routes it, answers it or files its tasks.',
             'Decides which project the input belongs to (or your home, for personal work), whether it is a new task, a question or a steer for an open task, and splits input that asks for several tasks into your own words per task, each with a title. "?" or "quick question" at the start makes it a question.',
             BOARD_SCOPE_HELP,
             'Prints the kind and where it goes, then each part. With --json: the RouterResult (kind, parts with text, title, project_id and home, task_ref, confidence, uncertain, forced, routed_by, latency_ms).',
@@ -1448,8 +1491,9 @@ const ROUTER_COMMANDS = [
     },
     {
         path: ['ask'],
-        summary: 'Ask a quick question about your work, answered from the board as it is written (0.25.0+)',
+        summary: 'Deprecated: ask a quick question about your work (use shard orchestrator say) (0.25.0+)',
         description: [
+            'Deprecated: shard orchestrator say --wait <question> asks your orchestrator and prints its answer.',
             'Answers from your tasks, their plans and states, sealed reports, the conversations behind them and what their agents last wrote. The answer streams to standard output as it is written; one that needs work ends with "Make it a task?".',
             BOARD_SCOPE_HELP,
             'With --json: the whole answer as one object (text, needs_work, sources, answered_by, first_token_ms, total_ms).',
@@ -1461,6 +1505,24 @@ const ROUTER_COMMANDS = [
         },
         examples: ['shard ask what is the healthz work doing right now', 'shard ask --task task_healthzhealthzhealthzhealt "is it done?"', 'shard ask "what is blocking the pricing page?" --json'],
     },
+    {
+        path: ['transcribe'],
+        summary: 'Turn a recording into text, with each word’s start and end (0.25.0+)',
+        description: [
+            'Sends the audio to Shardflux speech to text and prints what it says. WebM/Opus (a browser recording) and PCM WAV are recognized from the file; raw 16-bit mono PCM needs --format pcm16 and --sample-rate. Up to 120 s of audio.',
+            'Uses your signed-in session, or SHARDFLUX_API_KEY when it is set. The audio is not kept.',
+            'Prints the text; --words adds one line per word with its start and end. With --json: the transcript (text, words with w, start and end in seconds, language, duration, truncated).',
+        ].join('\n\n'),
+        positionals: [{ name: 'file', required: true }],
+        options: {
+            format: { type: 'string', value: '<webm|wav|pcm16>', description: 'The audio format (default: from the file).' },
+            'sample-rate': { type: 'string', value: '<hz>', description: 'Samples per second of raw pcm16 audio (8000 to 48000).' },
+            language: { type: 'string', value: '<code>', description: 'ISO 639-1 code of the language spoken (default: detected).' },
+            words: { type: 'boolean', description: 'Print each word with its start and end.' },
+            org: { type: 'string', value: '<id|slug>', description: 'Organization to transcribe in when you are in several (default: the saved one, shard orgs use, else your only organization).' },
+        },
+        examples: ['shard transcribe note.webm', 'shard transcribe meeting.wav --words', 'shard transcribe mic.pcm --format pcm16 --sample-rate 16000 --json'],
+    },
 ];
 /** The project a drive or models command acts in (0.25.0+). */
 const PROJECT_SCOPE = {
@@ -1490,6 +1552,26 @@ const DRIVE_COMMANDS = [
         description: `${DRIVE_HELP} After rm the path no longer lists or reads; shard drive get <path> --sha256 <hex> still reads each of its versions.`,
         examples: ['shard drive rm tasks/t_ab12/notes/draft.md'] },
 ];
+/** Whose brain a brain command reads (0.27.0+): the person's in this organization. */
+const BRAIN_SCOPE = {
+    org: { type: 'string', value: '<id|slug>', description: 'Organization whose brain it is (default: the saved one, shard orgs use, else your only organization). Slugs need your signed-in session.' },
+};
+const BRAIN_HELP = 'Your brain is your archive in an organization, kept by your orchestrator: every answer it publishes is filed as reports/<YYYY-MM-DD>/<folder>/report.md with the answer’s media next to it (image thumbnails under .thumbs/), with its own notes and files and an index.md of everything, newest first. Your orchestrator writes it; you read it from any device, with every computer asleep. Paths are relative to the brain’s root, the names ~/brain shows on your orchestrator’s computer. Uses your signed-in session, or SHARDFLUX_API_KEY when it is set (a key reads the brain of the member who created it).';
+const BRAIN_COMMANDS = [
+    { path: ['brain', 'ls'], summary: 'List your brain’s files: size, saved time, type and path (0.27.0+)', positionals: [{ name: 'prefix' }], options: {
+            ...BRAIN_SCOPE,
+            all: { type: 'boolean', description: 'Fetch every page.' },
+            limit: { type: 'string', value: '<n>', description: 'Page size (1 to 1000, default 200).' },
+            cursor: { type: 'string', value: '<cursor>', description: 'Continue from a previous page.' },
+        }, description: `${BRAIN_HELP} Lists the current version of each file, by path; a prefix such as reports/2026-10-17/ lists only that folder. --json returns data (each file with its sha256), next_cursor and the brain’s version, which moves whenever anything in it changes.`,
+        examples: ['shard brain ls', 'shard brain ls reports/2026-10-17/', 'shard brain ls --all --json'] },
+    { path: ['brain', 'get'], summary: 'Read a file from your brain: its bytes to standard output, or to a file with -o (0.27.0+)', positionals: [{ name: 'path', required: true }], options: {
+            ...BRAIN_SCOPE,
+            sha256: { type: 'string', value: '<hex>', description: 'Read exactly this version (the current one or an earlier one).' },
+            out: { type: 'string', short: 'o', value: '<file>', description: 'Write the bytes to this file.' },
+        }, description: `${BRAIN_HELP} The bytes are checked against their SHA-256 before they are written. --json without -o returns the file as content_base64 with its sha256, size and content_type.`,
+        examples: ['shard brain get index.md', 'shard brain get reports/2026-10-17/training-progress-ab12cd34/report.md', 'shard brain get reports/2026-10-17/training-progress-ab12cd34/loss.png -o loss.png'] },
+];
 const MODELS_HELP = 'The model template: which agent app (harness), model and effort each role of a task runs with, from the Claude and Codex accounts your organization connected. master plans and coordinates, builder does the work, hard takes the hardest parts, light the small ones, and reviewer reviews with a fresh context. The primary provider runs master, builder and hard; the other one, light and reviewer. A role whose account waits for its next usage window shows until when, and what the other provider would run now.';
 const MODEL_COMMANDS = [
     { path: ['models'], summary: 'Show which harness, model and effort each role of a task runs with (0.25.0+)', positionals: [], options: {
@@ -1504,7 +1586,7 @@ const MODEL_COMMANDS = [
         }, description: `${MODELS_HELP} The primary is this project’s choice when it has one, else the organization’s, else the provider connected first; clear removes the choice. Prints the template with the new primary.`,
         examples: ['shard models primary codex', 'shard models primary claude --org acme', 'shard models primary clear --project web'] },
 ];
-export const COMMANDS = [...ACCOUNT_COMMANDS.filter((c) => c.path[0] !== 'templates'), ...AGENT_COMMANDS, ...ROUTER_COMMANDS, ...AGENT_CREDENTIAL_COMMANDS, ...AGENT_ACCOUNT_COMMANDS, ...ACCOUNT_ALIASES, ...CLI_PROXY_COMMANDS, ...MENUBAR_COMMANDS, ...SETTINGS_COMMANDS, ...KEY_COMMANDS, ...BOARD_COMMANDS, ...DRIVE_COMMANDS, ...MODEL_COMMANDS, ...ACCOUNT_COMMANDS.filter((c) => c.path[0] === 'templates')];
+export const COMMANDS = [...ACCOUNT_COMMANDS.filter((c) => c.path[0] !== 'templates'), ...AGENT_COMMANDS, ...ROUTER_COMMANDS, ...AGENT_CREDENTIAL_COMMANDS, ...AGENT_ACCOUNT_COMMANDS, ...AGENT_MODELS_COMMANDS, ...ACCOUNT_ALIASES, ...CLI_PROXY_COMMANDS, ...MENUBAR_COMMANDS, ...SETTINGS_COMMANDS, ...KEY_COMMANDS, ...ORCHESTRATOR_COMMANDS, ...BOARD_COMMANDS, ...DRIVE_COMMANDS, ...BRAIN_COMMANDS, ...MODEL_COMMANDS, ...ACCOUNT_COMMANDS.filter((c) => c.path[0] === 'templates')];
 const GROUPS = {
     device: 'Local device approvals',
     'cli-proxy': 'Your hosted CLIProxyAPI, reachable at http://127.0.0.1:8317 on this computer and in every VM',
@@ -1514,6 +1596,7 @@ const GROUPS = {
     'needs-you': 'Everything your agents wait on, oldest first, and one answer command for each (0.25.0+)',
     approvals: 'The approval mode and always-allow rules your agents work under (0.25.0+)',
     drive: 'The project drive: files every agent, phone and person of the project reads and writes, each version kept by its SHA-256 (0.25.0+)',
+    brain: 'Your brain: your orchestrator’s answers, reports and notes, read from any device (0.27.0+)',
     models: 'The model template: which harness, model and effort each role of a task runs with, and the primary provider (0.25.0+)',
     agents: 'Cloud agent sessions and copied credentials',
     auth: 'Create an account and sign in (the session is saved in the credentials file); passwords, email, two-factor authentication and sessions',
@@ -1927,7 +2010,7 @@ export const EXIT_CODE_HELP = [
 /** The top help's sections: every command's group (first word) is in exactly one (args.test.ts checks). */
 export const HELP_SECTIONS = [
     { title: 'Account (a user session: shard signup or shard auth login)', groups: ['signup', 'verify', 'auth', 'setup', 'env', 'orgs', 'projects', 'api-keys', 'members', 'invitations', 'billing', 'audit', 'account'] },
-    { title: 'Cloud agents (shard ./ starts one; a project API key)', groups: ['conversations', 'board', 'task', 'needs-you', 'approvals', 'route', 'ask', 'drive', 'models', 'move', 'machine', 'template', 'agents', 'settings', 'accounts', 'device', 'cli-proxy', 'ssh-proxy'] },
+    { title: 'Cloud agents (shard ./ starts one; a project API key)', groups: ['conversations', 'orchestrator', 'brain', 'board', 'task', 'needs-you', 'approvals', 'route', 'ask', 'transcribe', 'drive', 'models', 'move', 'machine', 'template', 'agents', 'settings', 'accounts', 'device', 'cli-proxy', 'ssh-proxy'] },
     { title: 'Workspaces for your app (a project API key: SHARDFLUX_API_KEY, else the one shard setup saved)', groups: ['login', 'whoami', 'status', 'usage', 'workspaces', 'files', 'operations', 'executions', 'secrets', 'credentials', 'volumes', 'egress'] },
     { title: 'Templates for your app’s workspaces (not for cloud agents; publish and archive use the session, the rest the API key)', groups: ['templates'] },
     { title: 'Other', groups: ['menubar', 'update', 'feedback', 'version'] },

package/dist/board-args.js

@@ -80,6 +80,22 @@ export const BOARD_COMMANDS = [
         description: 'Your words go to the agent that runs the task, which adjusts its plan. The task keeps its own words.',
         examples: ['shard task steer task_h7g4d7tqyv2pz3a2npyo4rpgzq use postgres instead'],
     },
+    {
+        path: ['task', 'land'],
+        summary: 'Land a finished task: its result into your folder and the project’s default branch (0.25.0+)',
+        positionals: [{ name: 'id', required: true }],
+        options: { path: { type: 'string', value: '<folder>', description: 'The folder to land in (default: the project’s folder on this computer, if any).' } },
+        description: [
+            'A task has one result: the branch shard/<task id>, where its master merged its workers’ branches. Landing merges it',
+            'into the project’s default branch on the project hub (a fast-forward, or a merge commit when the merge is clean),',
+            'then brings it into your folder on this computer the way finished conversations land there: your branch moves to the',
+            'new commits, your uncommitted edits stay, and every file it rewrites is backed up first (shard conversations landing',
+            'backups). Only after the commit is checked to be in the branch is the landing recorded on the board, so the task',
+            'reads shipped. A conflict changes nothing: the task’s master is asked to merge and the task asks to land again.',
+            '--json returns {landed, result, hub, folder, recorded, message}.',
+        ].join('\n'),
+        examples: ['shard task land task_h7g4d7tqyv2pz3a2npyo4rpgzq', 'shard task land task_h7g4d7tqyv2pz3a2npyo4rpgzq --path ~/code/best-todo --json'],
+    },
     {
         path: ['task', 'clear-done'],
         summary: 'Clear every finished task from the board (0.25.0+)',
@@ -93,9 +109,11 @@ export const BOARD_COMMANDS = [
         positionals: [],
         options: PROJECT_FILTER,
         description: [
-            'Everything your agents wait on, across the board: permission requests (perm_…), questions (cq_…, ask_…),',
-            'credential requests (cred_…), finished work to land (land_…) and Later tasks to keep or clear (prune_…). Each line is',
-            'the id, what is asked, and the command, options or branch behind it. Answer with shard needs-you answer <id>.',
+            'Everything your agents wait on, across the board: permission requests (perm_…), questions (cq_…, ask_…, and your',
+            'orchestrator’s oq_…), credential requests (cred_…), finished work to land (land_…), Later tasks to keep or clear',
+            '(prune_…) and what your orchestrator asked your computer while it was offline (dev_…, "Waiting for your computer:',
+            'list ~/code"). Each line is the id, what is asked, and the command, options or branch behind it. Answer with shard',
+            'needs-you answer <id>.',
             '--json returns {data}.',
         ].join('\n'),
         examples: ['shard needs-you', 'shard needs-you --json'],
@@ -116,9 +134,13 @@ export const BOARD_COMMANDS = [
             '            project) or deny; an agent’s question takes --pick',
             '  cq_…      --text <answer>: the agent gets it as its next message',
             '  ask_…     --text <answer>: the task’s master gets it',
+            '  oq_…      --text <answer>: the orchestrator thread that asked gets it (0.27.0+)',
             '  cred_…    deny (the value goes through the credential request, sealed for its computer)',
-            '  land_…    land (the worker merges its branch and pushes it), keep (the branch stays) or discard',
+            '  land_…    land (as shard task land: the result into your folder and the default branch), keep (the',
+            '            branch stays) or discard',
             '  prune_…   --keep <task-id> for each task to keep, keep for all of them, or discard to clear them',
+            '  dev_…     cancel: drops what your orchestrator asked your computer (it runs by itself when your computer is',
+            '            back) (0.27.0+)',
             'The agent goes on as soon as you answer.',
         ].join('\n'),
         examples: ['shard needs-you answer perm_01a1300c-0000-7000-8000-000000000001 always', 'shard needs-you answer ask_rep_66cbevz65m72ij7mbiyrw4xvdy --text "eu-north-1"', 'shard needs-you answer land_conv_id4zts6jxsqraju2pggr55n3tq land'],

package/dist/board-commands.d.ts

@@ -10,11 +10,14 @@ import type { Handler } from './commands.js';
 /** A task as people read it: its title once it has one, else your words, on one line of at most `max` characters. */
 export declare function taskLabel(t: Pick<Task, 'title' | 'text'>, max?: number): string;
 /**
- * One task as `shard board` lists it: id, state (with why it waits to start: "queued (Claude usage resets 15:00)"),
- * title or words (a follow-up ↳, a suggestion marked), project.
+ * One task as `shard board` lists it: id, state (with why it waits to start, "queued (Getting its computer ready)", or
+ * what it does now, "working (Fixing the login cookie)"), title or words (a follow-up ↳, a suggestion marked), project.
  */
 export declare function taskLine(t: Task): string;
-/** One item that waits on you: its id, what is asked, then the command, the suggested answers or the branch behind it. */
+/**
+ * One item that waits on you: its id, what is asked, then the command, the suggested answers or the branch behind it. A
+ * request your orchestrator made to your computer while it was offline reads "Waiting for your computer: list ~/code".
+ */
 export declare function needsLine(n: NeedsYouItem): string;
 /** A sealed report as --follow prints it: id, milestone, title, then its evidence labels. */
 export declare function reportLine(r: TaskReport): string;
@@ -38,9 +41,10 @@ export declare class BoardFollower {
 }
 /** A feed answer as `board --follow --json` prints it: the API's fields (with `board` after a reset). */
 export declare function feedJson(u: BoardUpdate): Record<string, unknown>;
-/** `shard task show`: the task, its plan and conversations, then every report oldest first with its evidence. */
+/** `shard task show`: the task, its plan and conversations, then every report oldest first with its evidence. Every
+ *  title, step and outcome prints whole (0.27.0+), however long the agent wrote it; the terminal wraps it. */
 export declare function taskDetailText(d: TaskDetail): string;
-/** An item's kind from its id (perm_, cq_, ask_, cred_, land_, prune_); undefined for another id. */
+/** An item's kind from its id (perm_, cq_, ask_, oq_, cred_, land_, prune_, dev_); undefined for another id. */
 export declare function itemKind(id: string): NeedsYouItem['kind'] | undefined;
 export interface AnswerInput {
     word?: string | undefined;