Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
date: 2026-11-17
title: "Open the dashboard from terminal onboarding"
---

# Open the dashboard from terminal onboarding

- **Context:** The terminal's final Skip setup action could open the download waiting screen or wait for manual setup to load the selected model and start the API.
- **Decision:** Label the final action Go to dashboard and use `setup.manual` with `restore_selected: false`. Keep any active model preparation attached to the dashboard and retire its terminal setup view when the download finishes.
- **Consequences:** The dashboard opens after the completion record is saved, even while model preparation runs. Loading a model remains an explicit action on the dashboard or in the connection guide.
- **Alternatives:** Automatically loading when the download finishes would still start inference or the API after choosing a navigation-only action.
- **Owner:** team.
- **Links:** [Save dashboard exit without starting a model](2026-11-17-save-dashboard-exit-without-starting-model.md).
10 changes: 10 additions & 0 deletions docs/decisions/2026-11-17-open-dashboard-from-web-onboarding.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
date: 2026-11-17
title: "Open the dashboard from the final web onboarding step"
---

# Open the dashboard from the final web onboarding step

- **Context:** The final step used the same Skip setup action as earlier steps. With a pending model, it showed the waiting screen even when the user wanted to leave setup.
- **Decision:** Offer Go to dashboard on the final step and finish manual setup through the existing operation. Downloads continue while the dashboard is open. The endpoint and agent choices still show the waiting screen when the chosen model is pending.
- **Owner:** team.
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
date: 2026-11-17
title: "Open web onboarding at the first action"
---

# Open web onboarding at the first action

- **Context:** The welcome page required a click after the startup check had already determined which setup step was needed.
- **Decision:** Open the model step when an engine is active and the engine chooser otherwise. Show a status while checking setup and keep the connection retry on failure.
- **Consequences:** The initial chooser has no Back action. The chooser opened from model selection still returns there. Existing setup and download records still determine where to resume.
- **Owner:** team.
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
date: 2026-11-17
title: "Pair terminal connection engines with models"
---

# Pair terminal connection engines with models

- **Context:** The terminal connection guide listed compatibility for one model in the engine field and every downloaded model in the model field. The two fields could describe different runtime choices.
- **Decision:** Offer engines reported active by the server that have a compatible downloaded model. Filter the model field by the chosen engine, clear a model that no longer fits, and recheck the engine before loading the chosen pair.
- **Consequences:** A downloaded FastFlowLM model appears under FastFlowLM when that engine is installed. Model downloads already selected in onboarding can still show their progress in the guide.
- **Alternatives:** Deriving both fields from a single model would hide installed engines for other formats. Treating compatibility as installation would expose engines that cannot load the model yet.
- **Owner:** team.
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
date: 2026-11-17
title: "Save dashboard exit without starting a model"
---

# Save dashboard exit without starting a model

- **Context:** Go to dashboard awaited the manual setup operation. When the selected model became available that operation could load the model and start the API before returning.
- **Decision:** Let manual setup callers pass `restore_selected: false` to record completion only. Use that option for the final web dashboard action. Callers that omit the option retain the existing restoration behavior.
- **Consequences:** Opening the dashboard waits for the setup record to be saved. Model downloads continue and the selected model is available for an explicit start from the dashboard.
- **Owner:** team.
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
date: 2026-11-17
title: "Give web onboarding one active engine or model step"
---

# 2026-11-17 — Give web onboarding one active engine or model step

- **Context:** Returning from first-model selection showed the engine chooser over a still-visible catalog. FastFlowLM and GenieX shared the Catalog's inline download view, so their review appeared below the wizard's forward action. Closing engine settings left the model review with the compatibility verdict it had read before setup.
- **Decision:** Show the engine chooser as a full-page step and retain the model view in memory so dismissing the chooser restores the selection. Open FastFlowLM and GenieX reviews with the same dialog frame as other variant engines. After engine settings close, re-read the selected model's compatibility and keep the chosen variant if still available.
- **Consequences:** The engine chooser reports an active FastFlowLM build as installed. The model review uses the core's variant verdict to decide whether to offer setup or download. Catalog rows keep their inline controls.
- **Alternatives:** Keeping the runtime model review inline would require integrating variant selection, setup and download into the first-model footer and displacing the catalog on short windows.
- **Owner:** team.
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
date: 2026-11-17
title: "Use the workspace UI for web onboarding"
---

# 2026-11-17 — Use the workspace UI for web onboarding

- **Context:** The intro and wizard came from separate desktop previews. They used their own colors, competing scroll regions and a second provider editor. The optional browser notification step added confirmation dialogs to both choices.
- **Decision:** Build the wizard on the workspace theme, header, settings fields and action buttons. Share directory rows with the engine catalog and open credentials in the Catalog's provider dialog. Give each step one scrolling body and a fixed footer. A dedicated Continue action advances optional steps. The explicit notification action calls the browser directly and shows its result inline.
- **Consequences:** Desktop shows the current step in a rail. Narrow windows reserve the width for the active step. Provider credentials are entered only after selecting a provider. The download reminder, download controls, model compatibility, and server and agent handoffs keep their existing operations.
- **Alternatives:** Restyling the inline provider editor would preserve a second focus and credential flow with a toolbar inside a scrolling grid. Reusing the Catalog dialog makes cancellation and error handling the same in both places.
- **Owner:** team.
14 changes: 14 additions & 0 deletions docs/decisions/INDEX.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,20 @@ add a new one that says which record it supersedes.

## Records

- **2026-11-17** — [Pair terminal connection engines with models](2026-11-17-pair-terminal-connection-engines-with-models.md) — filter the connection guide by active engines and compatible downloads.

- **2026-11-17** — [Open the dashboard from terminal onboarding](2026-11-17-open-dashboard-from-terminal-onboarding.md) — save completion and let downloads continue without loading the selected model.

- **2026-11-17** — [Save dashboard exit without starting a model](2026-11-17-save-dashboard-exit-without-starting-model.md) — record completion before navigating without loading the selected model.

- **2026-11-17** — [Open the dashboard from the final web onboarding step](2026-11-17-open-dashboard-from-web-onboarding.md) — offer direct dashboard access while downloads continue.

- **2026-11-17** — [Open web onboarding at the first action](2026-11-17-open-web-onboarding-at-the-first-action.md) — start on model selection or engine selection based on the server's active builds.

- **2026-11-17** — [Use the workspace UI for web onboarding](2026-11-17-share-workspace-ui-with-web-onboarding.md) — shared theme, directory rows and provider dialogs with one scroll area and stable navigation.

- **2026-11-17** — [Give web onboarding one active engine or model step](2026-11-17-separate-web-onboarding-engine-and-model-actions.md) — full-page engine choice, dismissible FastFlowLM and GenieX review and refreshed model compatibility.

- **2026-11-12** — [Preserve Foundry Local tool markers](2026-11-12-preserve-foundry-tool-markers.md) — save the resolver's pair in new installations and use core 0.23.4 for the Foundry host and existing models.

- **2026-11-11** — [Check Foundry Local runtime requirements before transferring models](2026-11-11-check-foundry-runtime-before-transferring-models.md) — check the planned revision and preserve its minimum and partial bytes across retries.
Expand Down
14 changes: 7 additions & 7 deletions docs/desktop-flow-parity.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ Reference: the owner-selected `atomic-chat-ui` redesign at **5043013**, inspecte
| Reference | Atomic Server web | Atomic Server terminal |
| --- | --- | --- |
| `preview/onboarding/Onboarding.tsx`: model-first setup | Installed models and model choices; selection starts the checked download without a confirmation screen | Installed choices scroll with focus; model cards start the recommended download; Versions is a control on each card |
| Onboarding download strip above the heading/content | Live model/status/progress/ETA strip at the top | ASCII download frame above the heading/content on cloud and media steps; direct pause/resume and removal remain clickable |
| Onboarding fixed footer | Back and Skip setup; forward Skip/Continue above the footer | Bottom Back and Skip setup, with a larger inverted Skip/Continue action above them |
| Cloud step | Scrollable provider cards with marks; selected provider form; key-first connection check; muted Connected state | Scrollable ASCII provider cards; masked key editor; checking animation; muted Connected tag; optional Connection options |
| Onboarding download strip above the heading/content | Model and transfer status in the shared workspace header, with progress and controls in Downloads | ASCII download frame above the heading/content on cloud and media steps; direct pause/resume and removal remain clickable |
| Onboarding fixed footer | Back, Skip setup and Continue stay in the same footer. The waiting screen offers Open control panel. | Bottom Back and Skip setup, with a larger inverted Skip/Continue action above them |
| Cloud step | Catalog provider cards share the step's scroll area and open the Catalog credential dialog on selection | Scrollable ASCII provider cards; masked key editor; checking animation; muted Connected tag; optional Connection options |
| Optional image/video step | Image/video cards with model selection and Add to queue; confirmed queue removal | Two image/video cards with ASCII animation, model dropdowns and Add to queue; confirmed queue removal. Side by side when wide; stacked or scrollable when compact |
| Purpose/handoff | Configure an agent, configure an endpoint, or manual setup | Agent and endpoint ASCII choice cards, manual setup action, and agent marks |
| `containers/server-concept/Setup.tsx`: agent/model/endpoint configuration | Supported agent catalog, model and engine selection, port, configure/retry/success | Scrollable agent cards and model/engine dropdowns; download frame above the content; changing a model returns to the preserved connection step |
Expand All @@ -28,7 +28,7 @@ Reference: the owner-selected `atomic-chat-ui` redesign at **5043013**, inspecte

## Server-specific behavior

- First use starts with Choose engine. Installation shows real transfer progress; Press any key becomes available after installation. Returning or resumable profiles go directly to the saved workspace.
- Web first use opens the model catalog when an engine is active and the engine chooser otherwise. The terminal retains its keyboard intro. Returning or resumable profiles go directly to the saved workspace.
- The server owns downloads. Switching screens or closing a client does not cancel them. Pause retains partial files; Remove requests confirmation and discards that download's unshared partial assets. Delete is distinct and requires confirmation.
- Provider connection is checked before a Connected state appears. Model IDs can be discovered from the provider's compatible model-list endpoint; endpoint/model overrides are optional. Native-only provider APIs need a compatible gateway.
- Agent/endpoint preparation loads the model, prepares credentials, starts the API and tests inference. Failures remain on the same flow with a retry. A new model selection preserves the agent, endpoint and connection step.
Expand Down Expand Up @@ -62,9 +62,9 @@ The real macOS arm64 PTY test covers a fresh profile's engine gate, returning-pr

## Control parity follow-up

The current pass also uses the reference Inter/Studio fonts, rich model/engine
identity menus, paired connection fields and summary, inline onboarding provider
credentials, responsive tile grids, and desktop-width sidebar collapse. HTTPS
The web workspace and its first-run screens use the reference Inter/Studio fonts, shared provider forms,
rich model/engine identity menus, paired connection fields and summary, responsive tile grids, and
desktop-width sidebar collapse. HTTPS
proxy stays within the Server context and edits the supported outgoing-download
proxy settings. It does not imply that the server has the prototype's proxy-test
or separate password APIs.
Expand Down
4 changes: 2 additions & 2 deletions packages/admin-ui/LIFTED.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ The following flow adaptations use the owner's local `atomic-chat-ui` redesign (
| `src/workspace/WorkspaceNavigation.tsx` | `web-app/src/components/left-sidebar/NavigationRail.tsx`, `containers/ServerSidebar.tsx`, `SettingsMenu.tsx` | Server sections and a secondary Playground |
| `../../src/contract/desktop-flows.ts` | `Atomic-Chat/web-app/src/constants/integrations.ts` @ `5043013` | Agent names/order shared with TUI; existing Claude wire ID retained |

The intro logo `src/workspace/intro/atomic-logo.png` is copied from the selected desktop redesign's `web-app/public/images/transparent-logo.png` at `c9fa1e66` plus local preview changes. `IntroScreen.tsx` itself is local: its animation and layout are this package's CSS.
The intro logo `src/workspace/intro/atomic-logo.png` is copied from the selected desktop redesign's `web-app/public/images/transparent-logo.png` at `c9fa1e66` plus local preview changes.

Cloud connection cards and their editor in `src/workspace/library/cloud/CloudProviders.tsx` follow
`web-app/src/preview/onboarding/Onboarding.tsx` at `1c01e2a`, with real server validation replacing the
Expand Down Expand Up @@ -98,7 +98,7 @@ at `5043013`. They are bundled locally and declared in `desktop-parity.css` so t
Server control-panel tint, running-border animation, agent-card rhythm and settings/connection composition
follow `containers/server-control-panel.css` and `containers/server-concept/{desktop,setup-details}.css` at the same revision.

- `workspace/library/cloud/CloudProviderEditor.tsx`, `CloudProviderDialog.tsx`, `onboarding-providers.css`, `workspace/setup/OptionalMediaDownload.tsx`: desktop `preview/onboarding/Onboarding.tsx` and `onboarding.css` @ `5043013`; inline onboarding credentials, scrollable provider tiles, live validation and separate media pause/remove actions. `workspace/library/catalog/catalog-table.css` follows `containers/hub/LocalModelTable.tsx` at the same revision; native responsive table styling split from `catalog-desktop.css`.
- `workspace/library/cloud/CloudProviderEditor.tsx`, `CloudProviderDialog.tsx`, `workspace/setup/OptionalMediaDownload.tsx`: desktop `preview/onboarding/Onboarding.tsx` and `onboarding.css` @ `5043013`; shared provider dialogs, live validation and separate media pause/remove actions. `workspace/library/catalog/catalog-table.css` follows `containers/hub/LocalModelTable.tsx` at the same revision; native responsive table styling split from `catalog-desktop.css`.

`workspace/styles/desktop-controls.css` adapts the native control geometry in
`web-app/src/containers/server-concept/desktop.css` @ `5043013`: pill actions,
Expand Down
27 changes: 27 additions & 0 deletions packages/admin-ui/src/workspace/DirectoryRow.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
import type { ComponentProps, ReactNode } from 'react'
import './styles/directory.css'

export function DirectoryRow({
title,
detail,
leading,
trailing,
className = '',
...button
}: Omit<ComponentProps<'button'>, 'title' | 'children'> & {
title: ReactNode
detail?: ReactNode
leading?: ReactNode
trailing?: ReactNode
}) {
return (
<button type="button" className={`directory-row ${className}`} {...button}>
{leading}
<span className="directory-copy">
<strong>{title}</strong>
{detail && <small>{detail}</small>}
</span>
{trailing}
</button>
)
}
9 changes: 8 additions & 1 deletion packages/admin-ui/src/workspace/WorkspaceApp.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,14 @@ import './styles/secondary-forms.css'

export function WorkspaceApp() {
const [intro, setIntro] = useState(true)
return intro ? <EngineIntro onContinue={() => setIntro(false)} /> : <WorkspaceContent />
const theme = useThemeStore((state) => state.theme)
return intro ? (
<div style={workspaceTheme(theme)} className="eye-workspace desktop-workspace">
<EngineIntro onContinue={() => setIntro(false)} />
</div>
) : (
<WorkspaceContent />
)
}
function WorkspaceContent() {
const theme = useThemeStore((state) => state.theme)
Expand Down
7 changes: 3 additions & 4 deletions packages/admin-ui/src/workspace/bug-hunt.test.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -142,10 +142,9 @@ it('keeps the server on the network the person chose when an agent connection is
}
render(<Handoff />)
await userEvent.click(await screen.findByRole('button', { name: 'Continue' }))
await userEvent.click(screen.getByRole('button', { name: 'Skip', exact: true }))
await userEvent.click(screen.getByRole('button', { name: 'Continue without permissions' }))
await userEvent.click(screen.getByRole('button', { name: 'Skip', exact: true }))
await userEvent.click(screen.getByRole('button', { name: 'Skip', exact: true }))
await userEvent.click(screen.getByRole('button', { name: 'Continue', exact: true }))
await userEvent.click(screen.getByRole('button', { name: 'Continue', exact: true }))
await userEvent.click(screen.getByRole('button', { name: 'Continue', exact: true }))
await userEvent.click(screen.getByRole('button', { name: /Connect an agent/ }))
await userEvent.click(
within(screen.getByRole('heading', { name: 'Codex CLI' }).closest('article')!).getByRole('button', {
Expand Down
Loading
Loading