Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

Merge branch 'main' into feat/grid-on-demand

bitcoinbuilder4e2c5e1d1b12
diff --cc desktop/design/terminal-dialogs.md
index b246e0581,cdad4329e..03668cbc3
--- a/desktop/design/terminal-dialogs.md
+++ b/desktop/design/terminal-dialogs.md
@@@ -1,405 -1,100 +1,102 @@@
- # Terminal dialog design system
-
- Use the [product terminology](../../docs/terminology.md): a swarm groups harnesses;
- a harness is one running agent session.
-
- **Fixed cells. Plain text. One-line selection.**
-
- This is the dialog chapter of the [terminal workspace design system](terminal-workspace.md).
-
- Harness's terminal-workspace dialogs should feel like part of the terminal.
- This is the agreed design direction from the Cmd-N and Cmd-P review on
- 2026-09-24. Apply it to new and revised workspace pickers, forms, confirmations,
- and their previews. It is the current source of truth for their presentation,
- including where older design handoffs describe different visuals.
-
- Cmd-N (`NewHarnessForm`) and Cmd-O (`SwarmSearchResults` in its terminal setup
- layout) are the implementation references. Full Settings pages and embedded
- viewers keep their own component systems.
-
- ![Open Harness rendered with fixture data](images/terminal-open-harness.png)
-
- The fixture above shows the terminal grid, plain-text rows, and unselected
- opening state. Live surfaces use the user's selected terminal font and palette.
-
- ## Lay out a character grid
-
- Measure the selected terminal font through `terminalCellSizeOf(context)` in
- [`terminal_text.dart`](../lib/terminal/terminal_text.dart). Its width is one
- character column; its height is one text row. Use this shared measurement in
- both layout and scrolling calculations.
-
- - Express horizontal margins, gutters, column widths, and gaps in whole cells.
- - Express vertical spacing in whole text rows. A title is one row; its context
- or description is the next row; separation is a blank row.
- - Align the input text, result titles, and context lines to the same column.
- Align form labels and values in consistent columns.
- - Keep single-line choices to one row. Truncate long labels within their
- column; preserve the full value for accessibility or inspection.
- - On narrow windows, reduce columns or change the pane arrangement. Keep the
- measured font and row spacing rather than shrinking text to fit.
-
- Do not approximate a cell as `fontSize * .6`, copy pixel padding from a
- screenshot, or let Material control minimum heights determine the grid.
-
- ```dart
- final cell = terminalCellSizeOf(context);
- final gutter = cell.width * 2;
- final lineHeight = cell.height;
- ```
-
- ## Highlight one line
-
- The selection background spans the selected name/value line and is exactly one
- terminal row tall. Descriptions, metadata, previews, and blank spacing remain
- outside it. Only the list or field that owns keyboard navigation shows the
- active highlight. Moving selection must not shift any text or columns.
-
- Click targets may include a result's context line. Their size must not enlarge
- the visible selection. Keep semantic selection, focus, and enabled state even
- when using custom row widgets.
-
- ## Use text for the controls
-
- - No provider logos, avatars, decorative emoji, image assets, or icon-font
- glyphs in dialog chrome. Write `Codex`, `Claude`, or the harness name.
- - Keep Cmd-O and Cmd-P search prefixes editable: Cmd-P opens an empty field and
- Cmd-O inserts `#`. Deleting a prefix returns to harness search.
- Do not draw a separate prompt character beside these inputs.
- - All Cmd-P results occupy one row: title
- on the left and activity age, when available, on the right. Machine, project,
- model, API connection, and Store details live in the preview. For harnesses,
- the preview puts the compact
- Standard context `machine:project (branch)` directly below the harness title,
- followed by status and harness type. Omit missing fields and preserve
- important state such as Offline.
- - Boolean controls use `[x]` and `[ ]`; Enter and Space toggle them.
- - Menu actions use concise text, such as `New Harness`, with the same row
- highlight as other choices and no surrounding brackets. Shortcut hints,
- when needed, are text beside the action, resolved from the live keymap.
- - Omit redundant heading rows such as “New Swarm” or “New Pane.” Add a label or
- explanation only when it helps someone understand a choice or state.
- - Preserve user content, including Unicode. The restriction on decorative
- graphics applies to our controls, not to the text someone supplied.
-
- For example, Cmd-P session results are consecutive single lines:
-
- ```text
- Search harnesses
-
- Checkout retries 5m
- Search experience 1h
- ```
-
- The highlight covers the selected row. All result types, including resource
- creation entries, use consecutive single lines. Details remain searchable and
- available to screen readers. Machine and project previews retain their name
- and harness count even when they contain just one session.
-
- Unavailable harnesses keep their place in the list. Dim their names and replace
- the activity age with a short reason such as `Offline`, `Not connected`, or
- `Link required`. They remain selectable for their saved preview, but Enter and
- click cannot open them. Availability updates in place when the machine reconnects.
-
- ![An offline session remains readable in the preview](images/terminal-open-unavailable.png)
-
- ![A selected session with its context in the preview](images/terminal-open-harness-preview.png)
-
- ![Models use the same single-line list with details in the preview](images/terminal-open-models.png)
-
- ## Inherit the real terminal's appearance
-
- Use `terminalContentStyle()` for all dialog text: input, labels, values,
- metadata, timestamps, actions, and previews. This preserves the terminal's
- font family, fallback fonts, size, line height, and zero added letter/word
- spacing. Do not substitute the general app UI type scale or hardcode a font
- and size in an individual dialog.
-
- Resolve colors through `terminalThemeFor(AppTheme.palette.value,
- terminalThemeStore.value)` from
- [`terminal_theme.dart`](../lib/terminal/terminal_theme.dart). Use its background,
- foreground, cursor, selection, and semantic colors. Derive muted text from its
- foreground; hardcoded white fails on other terminal schemes.
-
- Use the same thin frame as an active pane:
- `terminalPaneBorder(focused: true)` and `kTerminalCornerRadius` from
- [`box_chrome.dart`](../lib/widgets/box_chrome.dart). Keep the surface flat, with
- no elevated cards, pill controls, or decorative shadows inside it.
-
- Cmd-O and Cmd-P use one unfilled, borderless text line with a thin, two-pixel caret.
- Align its editable text with the result titles. Previews use the same text
- metrics and blank-row spacing; warnings are readable text in semantic colors.
-
- Cmd-P opens with no selected row. The preview area shows the type hints as plain,
- muted text: `@ machines`, `# projects`, `: models`,
- `* store`, and `> commands`.
- Each hint is also a plain-text button: clicking it inserts the prefix into the
- same editor and keeps typing focus there. Selected harnesses open with Enter.
- Machines use Enter to **Manage**: focus moves to their controls without invoking
- one. Models use five sections: **Subscriptions**, **APIs**, **Your models**,
- the downloads, and **Shared with you**. Grid is an add-on: on a computer where
- it is not set up, local and shared models are one row under Your models,
- **[ Set up local & shared models ]**, and the downloads and Shared with you
- headings are not shown. Enter on it sets Grid up with the Harness account (no
- second sign-in); opening the picker never does. Headers are plain muted text and never
- take selection. Put **[ Add ]** within APIs. Your models puts downloaded models
- first, followed by models served on the user's machines. The downloads are
- headed with the machine they are for and its memory (`Get for this Mac · 64 GB`),
- and a machine with nothing to download has no such heading. Where a model
- shares memory with everything else (a Mac's unified memory, or system RAM with
- no GPU), only models that fit half of it with a coding agent's 64K context are
- offered, and the other half stays for everything else it runs; an NVIDIA
- card's free VRAM is the model's own, all of it. They are ordered for a
- coding agent on that machine: quants of 3 bits or more first, then the ones the
- catalog estimates at 20 tok/s or more, then bigger models first, then the
- catalog's own (popularity) order — with one version of each model before any
- second: its MTP, QAT or pruned variants, and fine-tunes sharing its MoE shape
- (`35B-A3B`) or its size and speed. Safety classifiers are never offered. The
- list shows the first five;
- the rest stay behind **[ More models (N) ]**, where Enter
- expands them in place and selects the first catalog row, and **[ Show fewer ]**
- collapses them. The catalog never offers another quantization of a model the
- machine already has. Explicit searches also include matching catalog models.
- A model row names its model alone; the quantization is in the preview, and on
- the row only when two versions of one model share a name. Ahead of its last
- word a model of yours lines up two columns, its size and its speed (measured
- while it runs, else the catalog's estimate, `~10 tok/s`); a list too narrow to
- keep the name readable drops them. Shared rows show only
- the model and sharing machine's label, separated by ` · `. An API heads its models:
- `▸`/`▾` before its name says whether they are listed, and the end of its row says
- how many (`378 models`) or `Tools` for one no harness can run on. Its models
- stay folded until Enter on its row, and explicit searches include matching ones,
- always under their own API and never interleaved with another's. Model rows are
- indented under the API's name, show only the model, and say **Use** for a
- harness on this computer. Filtering
- preserves the groups.
-
- A plain right-aligned **Use** identifies a model the current pane can use;
- **Get** identifies a model that can be downloaded. A model of yours says what
- Enter does unless something is happening to it (**Downloading**, **Starting**),
- and the one the pane is on says **● In use**. Only a live row's word is green —
- running, in use, or under way; an action is plain, a failure a warning. Get on
- a model the pane can run downloads it, starts it and moves the pane onto it in
- one step, with the hint following it (`Downloading 42%…`); closing the picker
- stops the switch, never the download. Other model rows are dimmed,
- remain selectable for inspection, and have no action badge. Enter does nothing
- on these rows; it must never silently become Manage. Show the reason in the
- preview when it helps. Subscription names include the account label; only an
- account compatible with the current harness and available on its machine can
- say Use. Include actionable labels in accessibility text.
-
- From a live harness, both Cmd-I and Cmd-P's model scope use Enter to **Use** a
- served model, installed local model, or compatible subscription. Starting
- installed weights happens once; progress stays in the picker, and the pane
- switches only when the model is served. Closing the picker cancels the pending
- switch while startup continues on its host. **Get** prepares an undownloaded
- model on its host and stays in the picker. Pin selection to the pane that
- opened it; changing focus must never switch another pane's model.
-
- Cmd-N, Cmd-P, and Cmd-I share pane navigation: **Tab/Shift-Tab switch between
- the left and right panes**, without selecting a value or running an action.
- **Up/Down move within the active pane**: fields or choices in Cmd-N, results or
- controls in Cmd-P. **Enter activates the highlighted item**. In Cmd-N, Enter
- on a field opens its choices; Enter on a choice applies it and selects New
- Harness. Tab returns to the same field without applying a choice. In Cmd-P, Enter on a usable model
- uses it, on a Get row gets it, on a machine enters management, and on a harness
- opens it. Arrow keys walk controls while the right pane owns focus; they must
- not change the resource behind them. Left/Right retain normal cursor movement
- in text fields, and move between adjacent buttons. Enter/Space activate focused
- buttons. An inline form with text fields (Cmd-P's API editor) is the one place
- Tab stays inside the pane: it walks the fields, then reaches the buttons, and
- the next Tab leaves for the list; Shift-Tab walks back and leaves from the
- first field. Escape backs out of an inline form, then returns to search while
- preserving the query and selection. Hints use the live keymap. Only the active
- pane shows a selection highlight.
- Typing selects the first match and replaces the hints with its preview. Arrows
- and pointer movement can also select a row. A pointer cannot change the resource
- while its management controls own keyboard focus. Clearing the root search returns
- to the hints; live inventory updates must not choose a row for the user. Enter
- does nothing until a row is selected. Keep the input and list in place throughout.
- Cmd-P has no New Harness row, including in machine and project harness lists.
- Cmd-N opens creation. Resource setup rows use general guidance rather than
- presumed defaults.
- Page Up/Down pages the result list; Shift-Up/Down scrolls the preview by one
- measured terminal row. These keys preserve the input's focus and query. Preview
- scrolling keeps the selected result and result-list scroll position unchanged.
-
- Cmd-Shift-P opens this same picker with editable `>` text. Commands and `?` help
- keep the same input, frame, terminal metrics, and two-pane arrangement as Cmd-P;
- changing a prefix must not replace the editor or move it. Command names occupy
- one row with their live shortcut aligned right. The preview shows the selected
- command's name, category, and shortcut, without session-text placeholders. Empty
- matches clear the preview. Omit the older title/count row and key-hint footer.
-
- ![Commands in the shared terminal picker](images/terminal-search-commands.png)
-
- Open dialogs must follow live terminal font and theme changes while preserving
- the input controller, query, selection, focus, and scroll state. Wire the font,
- palette, and terminal-theme dependencies as the reference dialogs do. Settings
- come from Harness's own Terminal preferences, not Apple Terminal or iTerm.
-
- ## Keep the terminal interaction
-
- Cmd-N opens a compact, centered key/value form with Agent, Project, collapsed
- Options, and `New Harness` selected. Enter launches with the displayed
- settings. Options expands Model, Approvals, applicable Profile, Branch, and Worktree
- as consecutive rows without internal blank rows. Machine is selected with Project. Keep a blank row between Agent and Project and before Options.
- Worktree uses `[x]` / `[ ]`. There is no duplicate summary pane.
- Project shows the committed machine and full path, such as
- `M2:~/code/autonomous-harness`. Browsing the chooser never changes this value
- until a choice is accepted.
-
- ![Compact New Harness form](images/terminal-new-harness-compact.png)
-
- Reserve nine columns for labels and two blank columns before values. The launch
- action follows the last visible field with exactly one blank row; never pin it
- to the bottom with a flexible spacer. The form and chooser use whole character
- columns and rows. The form fits its visible rows, stays centered, and keeps its
- geometry when choices appear beside it. The chooser starts directly with its search line;
- omit a redundant back/title row such as `< Agent`.
-
- Up/Down selects a field and automatically reveals its small chooser to the
- right. Navigation still belongs to the form. Right, typing, or Enter moves
- focus into the chooser; then Up/Down moves its choices. Enter accepts a value,
- closes the chooser, and selects New Harness, ready for the next Enter to launch.
- A held Enter must not accept and launch in one keypress. Escape discards the
- search and returns to the form in one step; Left also returns when the search
- is empty. Nested project and specialized-agent steps retrace their choices.
- On narrow windows, the active chooser replaces the form on the same column with
- enough rows for its list. Returning restores the compact form. Validation messages
- get whole rows of their own so neither the explanation nor the choices are clipped.
-
- Fresh Cmd-N uses the last successfully launched agent, the last used project
- on the local machine, the local machine, branch `main`, and Worktree Yes for a
- Git project. Model shows the selected model name, or OpenAI / Anthropic when
- the subscription agent has not reported a model. Approvals starts at Auto-approve.
- Focused panes and canceled edits do not change these defaults; unresolved
- launch receipts remain recoverable. An explicit split can inherit its source.
- If a required value is unavailable or uncertain, explain it and require a
- choice. Never substitute another branch, project, agent, or profile, or turn
- Worktree off after a worktree creation failure.
-
- Agent offers Codex, Claude Code, Terminal, and specialized harnesses together.
- Keep agent choices to one line. A direct agent completes the choice. A specialized harness such as Blender
- uses `Run Blender with` as the search hint, offering compatible coding agents
- with its remembered choice selected. The Agent value then reads
- `Blender · Codex`.
-
- ![Blender runner chooser](images/terminal-new-harness-runner.png)
-
- Project searches existing `machine:project` pairs across the inventory; names,
- machine names, and paths are searchable. Put local projects first before a
- search, and dim unavailable destinations with a short reason. Selecting a
- project commits both its machine and folder. New Folder, Open Folder, and Clone
- Repository first ask for a machine (local selected), then a name, path/browser,
- or repository URL. Escape retraces these steps. Searching or moving the
- highlight never creates a folder or starts a harness.
-
- Arrows navigate the active choices; Enter accepts the current choice; Escape
- goes back or dismisses according to the existing workflow. An editor still
- accepts ordinary text, including `j` and `k`. Preserve composition, paste,
- readline editing, remapped shortcuts, and mouse access.
-
- Opening, searching, previewing, and cancelling must not send input to an agent,
- start a process, or resize/recreate the underlying terminal. Return focus to the
- workspace on dismissal. Search navigation should keep typing focus in its
- editor, and a stationary pointer must not steal the keyboard highlight.
-
- Keep lists virtualized and retain cached row controls. Arrow movement updates
- the old and new highlights; it should not rebuild the editor or whole catalog.
- Calculate reveal and paging from the actual measured item extent.
-
- ## Share an agent
-
- Share follows the Cmd-N form: the agent name, aligned Access and People fields,
- collapsed Options, and Copy link selected. Access opens Private/Public choices
- beside the form. Browsing choices never changes access; accepting one applies it
- and returns to Copy link. People owns an email editor and the existing invitations.
- Options reveals invitation expiry, Comments, and Stop sharing. Expiry applies
- to new email invitations, not to the public link. Keep online guidance visible.
- Up/Down move within a pane, Tab switches panes, Enter accepts, and Escape backs
- out or dismisses. Narrow windows replace the form with the active chooser.
- Opening or cancelling the form alone never changes permissions or creates a link.
-
- ![Compact Share form, rendered with synthetic data](images/share-form-compact.png)
-
- ![Public and private choices beside the same form](images/share-form-access.png)
-
- ## Review a dialog change
-
- Check the result with the user's terminal font and colors, an alternate scheme,
- enlarged text, and a narrow window. Look for a one-line highlight, aligned
- columns, intact text, plain controls, and no layout jumps. Exercise typing,
- selection, acceptance, dismissal, scrolling, and focus restoration. Check live
- font/theme changes while the dialog is open.
-
- Reuse the relevant existing checks:
-
- - [`new_harness_grid_test.dart`](../test/new_harness_grid_test.dart): row and
- column alignment, selection ownership, and scaling.
- - [`open_picker_rendering_test.dart`](../test/open_picker_rendering_test.dart):
- pane/dialog appearance, one-line selection, no logos, and virtualized traversal.
- - [`swarm_search_render_test.dart`](../test/swarm_search_render_test.dart):
- cached rows, query updates, theme changes, and focus.
- - [`swarm_search_preview_test.dart`](../test/swarm_search_preview_test.dart):
- preview navigation and narrow layouts.
- - [`keymap_runtime_test.dart`](../test/keymap_runtime_test.dart): shortcut
- routing and focus ownership.
- - [`share_harness_test.dart`](../test/share_harness_test.dart) and
- [`share_toolbar_test.dart`](../test/share_toolbar_test.dart): sharing flows,
- cell layout, responsive draft preservation, shortcuts, and focused-agent scope.
-
- When checking a native build, restart into the rebuilt app before judging the
- result. An existing process does not pick up a new build automatically.
-
- ## Manage machines and models inside Cmd-P
-
- Place compact facts and controls together at the top of the preview. This
- computer has `[ Password ] [ Rename ]`; remote machines have `[ Connect ]
- [ Rename ] [ Delete ]`, with Connect only when linking is needed. Password opens
- the password form alone. Delete retains the account-removal confirmation. Show
- connection state, harness count, and real CPU/RAM readings; refresh resource
- readings while the machine picker is visible and the app is in the foreground.
- Do not add a View harnesses, Linked machines, Refresh, or Actions button to this
- management pane. Keep the controls on one row, wrapping only when needed.
-
- Connect, Rename, Password, and Delete edit or confirm **inside the right pane**;
- never cover Cmd-P with a second dialog. Keep the search and machine list in
- place. Cancel/Escape returns to the selected machine's controls. Pending
- operations survive closing their editor, and errors stay beside the fields.
- Deletion and password clearing start with Cancel focused.
-
- With no machine name typed, order machines by the next useful action: online
- machines needing a connection, this computer, other connected machines, then
- offline machines. Sort names naturally within each group. A live status change
- may reorder rows but must preserve the selected machine's identity. Typed
- queries retain match relevance. Put **Add machine** after the machine rows.
- It explains installation on the other computer, sign-in to the same account,
- and setting its password. App and CLI open their setup instructions in the
- same right pane; copying CLI commands never executes them on this computer.
-
- Local models show their name with quantization once, host and model-file size,
- and measured tokens/sec and request count with its period when available.
- Include inventory from every connected, linked machine in the account. Resolve
- Grid hostnames through the hostname on the Harness machine record, then use
- that machine's own model IDs and capabilities for controls. Display its Harness
- name (for example, M2), and keep its Grid hostname (mac.lan) searchable. Unlinked,
- offline, unknown, and shared hosts must not inherit another machine's controls.
- Reuse existing operation progress/failure labels; omit redundant normal-state
- labels such as Available. Show quantization once beside the name when known,
- including quantization explicitly present in an imported GGUF filename. Do not
- guess it from the model family or file size.
-
- Local models have one contextual button: **[ Get ]** before download,
- **[ Use ]** when installed and startable, or **[ Stop ]** when an owned process
- can be stopped. A running model's list action remains Use; Stop requires
- activating its button. Unavailable actions are dim and cannot receive focus.
- On hosts that support a separate download, Get only saves the files. Older
- hosts prepare models through their existing combined download/start action;
- explain `Downloads and starts on <machine>.` before Get. Use starts installed
- weights when necessary, then selects the model for the original harness.
-
- API provider selection, credential editing, validation, saving, and deletion
- stay in the picker's right pane. Keep keys masked by default; do not return
- stored secrets to the editor. Errors and progress appear in place. Leaving a
- pending form must not let its eventual reply reopen it or change the selection.
+ # Desktop dialog behavior
+
+ Use the [desktop design system](desktop-design-system.md) for presentation.
+ This file retains the interaction and data-integrity contracts from the former
+ terminal-dialog specification. Fixed cells, one-line-only selection, mandatory
+ monospace, bracket buttons, ASCII checkboxes, and terminal-colored modal frames
+ are retired for app UI. Older screenshots are historical evidence only.
+
+ ## Shared ownership
+
+ Reuse the existing controllers, launch paths, and draft stores. Cmd-N and the
+ full-page welcome use the same form. Cmd-P scopes use the same query editor,
+ result selection, and resource preview. Styling must not fork their behavior.
+ The detailed creation contract is [new-harness-entry-rules.md](new-harness-entry-rules.md).
+
+ Fresh creation uses saved successful choices on the local machine. Explicit
+ Store/split requests and restored drafts retain their own destination and
+ reviewed values. Never substitute another branch, folder, agent, or profile,
+ or disable Worktree after a failure. Browsing options does not commit them.
+ Searching and highlighting never creates a folder or launches a harness.
+ A held Return cannot accept a choice and launch in the same keypress.
+
+ The popup's main form closes through its explicit Close action. Child menus
+ may dismiss on outside click or Escape and return to the same draft. New Tab
+ has no Close button on its form. Successful creation uses its existing tab
+ placement. Preserve pending launch receipts and duplicate-start guards.
+
+ ## Keyboard and focus
+
+ Resolve shortcuts from the live keymap. Normal text, including j and k, stays
+ text. Preserve paste, readline editing, input composition, and remapping.
+ Enter/Space activate the focused control; Enter in the task submits according
+ to the existing form rule. Composition confirmation is never submission.
+
+ Search keeps focus in its editor while navigating results. Tab traverses
+ controls and existing list/preview regions. Inline editors keep traversal in
+ fields until the final action, then return to the surrounding view. Escape
+ backs out of nested editing before dismissing a surface. Page navigation uses
+ the rendered row extents. Focus returns to the trigger on dismissal.
+
+ A stationary pointer does not steal keyboard selection. Live inventory updates
+ do not pick a result or switch the resource being edited. Opening, previewing,
+ or cancelling UI cannot send input to an agent or recreate a terminal.
+
+ ## Search and resources
+
+ The empty query searches harnesses. Editable prefixes and clickable scopes
+ remain: machines, projects, models, Store, and commands. Keep one editor and
+ stable geometry across scopes. Cmd-N creates; Cmd-P has no duplicate New Harness
+ result. Empty matches clear the preview. No row selected means Enter does nothing.
+ Unavailable sessions retain their saved preview and show the actual reason;
+ click/Enter cannot open them until available.
+
+ Commands use their real names and current shortcuts. Results remain virtualized;
+ query changes and highlights do not rebuild the whole catalog. Selection is
+ identified by stable resource identity through inventory changes.
+
+ Machines keep Connect/Password, Rename, and Delete in their existing management
+ preview. Inline changes do not cover search with a second dialog. Cancelling
+ returns to that machine's controls. Pending requests survive editor dismissal;
+ late responses cannot change a replacement editor. Destructive confirmations
+ start with Cancel focused. Show real resource readings and availability.
+
+ Before a machine search, prioritize online machines needing connection, this
+ computer, other connected machines, and offline machines. Preserve selected
+ identity across reorder. Add machine remains available after the list and
+ explains setup on the other computer. Copying an installation command does
+ not execute it here.
+
+ Model groups retain Subscriptions, APIs, Your local AI models, and Shared with
+ you. API model disclosure, matching within groups, compatible subscriptions,
-and local catalogs retain their current behavior. Get downloads/prepares;
++and local catalogs retain their current behavior. Grid is an add-on: until it
++is set up here, local and shared models are one Set up row (Sign in, when
++signed out of Harness), and opening the picker never sets it up. Get downloads/prepares;
+ Use starts when necessary and selects for the original harness; Stop explicitly
+ stops an owned process. An unavailable row stays inspectable without activation.
+ Closing the picker cancels its pending model switch, not startup on the host.
+ Never transfer another machine's capabilities to an unknown/shared host.
+
+ Show real sizes, quantization, throughput, and request periods only when known.
+ Keys stay masked; provider credential editors never read stored secrets back
+ into a field. Resource errors and progress appear beside the affected controls.
+
+ ## Sharing
+
+ Keep the selected agent, committed access, people, invitation expiry, comments,
+ and stop-sharing controls in the same flow. Browsing access options does not
+ change permissions. Opening or cancelling alone does not create a link.
+ Expiry applies to new invitations, not public links. Pending requests and
+ errors retain their existing scope and protections against stale completion.
+
+ ## Verification
+
+ Review dark and light appearances, narrow windows, enlarged text, long labels,
+ loading/errors, missing resources, mouse and keyboard, composition, and live
+ updates. Use the relevant existing creation, placement, sharing, search,
+ resource, keymap, and lifecycle suites. Replace tests that enforce retired
+ presentation with checks of the new visible behavior while retaining safeguards.
+
+ After a native build, restart the app before judging it. Use synthetic data for
+ saved screenshots. Coverage gates measure executable lines, not every possible
+ interaction. Physical native IME and VoiceOver require their own verification.
diff --cc desktop/lib/widgets/swarm_resource_preview.dart
index 2f8541362,cf175a4d8..bdc6e7c3c
--- a/desktop/lib/widgets/swarm_resource_preview.dart
+++ b/desktop/lib/widgets/swarm_resource_preview.dart
@@@ -708,16 -780,7 +782,16 @@@ class _SwarmResourcePreviewState extend
),
];
}
+ if (search.isGridSetupRow(selected)) {
+ return [
+ _ResourceAction(
+ search.actionLabel(selected),
+ search.models!.manager.settingUpGrid || app.signingIn ? null : _open,
+ command: 'picker.accept',
+ ),
+ ];
+ }
- if (selected?.isCreate == true) {
+ if (selected.isCreate) {
if (search.isMachineMode) {
return [
_ResourceAction(
@@@ -1063,36 -1124,8 +1135,37 @@@
}
Widget _modelPreview() {
- final catalog = widget.search.models!;
+ final catalog = widget.search.models;
+ if (catalog == null) return _details(['No matching models']);
+ if (widget.search.isGridSetupRow(row)) {
+ final manager = catalog.manager;
+ final here = thisComputerName();
+ // Signed out of Harness: the set-up is done with the Harness account, so this starts there.
+ // What a person reads names Harness only; Grid is how it works, not what they chose.
+ final signedOut = app.isGuest;
+ return _details([
+ 'Local & shared models',
+ 'Download models to run on $here, and use the models other people share with you.',
+ '',
+ if (signedOut) ...[
+ "You're using Harness on this computer only. Local and shared models belong to your "
+ 'Harness account, so you need to sign in to use them.',
+ "Sign in opens in your browser. Setup finishes here on its own once you're signed in.",
+ ] else
+ "Set up gets $here ready for them with your Harness account. You won't be asked to "
+ 'sign in again.',
+ if (manager.settingUpGrid) ...[
+ '',
+ 'Setting up…',
+ ] else if (manager.setUpWaitsForSignIn) ...[
+ '',
+ 'Signing in… Finish in your browser, and setup continues here.',
+ ] else if (!signedOut && manager.gridSetupError != null) ...[
+ '',
+ 'Could not set up: ${manager.gridSetupError}',
+ ],
+ ], controls: true);
+ }
if (widget.search.isModelDownloadsRow(row)) {
return _details(
widget.search.modelDownloadsVisible