From bcc3cecf5a091117c5241ce60c70c5988be3e05a Mon Sep 17 00:00:00 2001
From: Biogenic Ooze
Date: Wed, 18 Nov 2026 11:07:42 +0300
Subject: [PATCH 1/4] Pin core 0.24.2 and remove the integrations patch
---
THIRD_PARTY_NOTICES.md | 4 +-
bun.lock | 7 +---
...6-11-18-use-published-core-integrations.md | 12 ++++++
docs/decisions/INDEX.md | 2 +
docs/release.md | 5 ++-
package.json | 5 +--
patches/@atomic-chat%2Fcore@0.23.4.patch | 40 -------------------
7 files changed, 22 insertions(+), 53 deletions(-)
create mode 100644 docs/decisions/2026-11-18-use-published-core-integrations.md
delete mode 100644 patches/@atomic-chat%2Fcore@0.23.4.patch
diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md
index dec21ac..b11f3a6 100644
--- a/THIRD_PARTY_NOTICES.md
+++ b/THIRD_PARTY_NOTICES.md
@@ -10,7 +10,7 @@ do not edit by hand.
| @ai-sdk/provider | 2.0.5 | Apache-2.0 |
| @ai-sdk/provider-utils | 3.0.39 | Apache-2.0 |
| @alcalzone/ansi-tokenize | 0.3.1 | MIT |
-| @atomic-chat/core | 0.23.4 | MIT |
+| @atomic-chat/core | 0.24.2 | MIT |
| @fastify/busboy | 2.1.1 | MIT |
| @isaacs/fs-minipass | 4.0.1 | ISC |
| @nodable/entities | 3.1.0 | MIT |
@@ -245,7 +245,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
````
-## @atomic-chat/core 0.23.4
+## @atomic-chat/core 0.24.2
License: MIT
diff --git a/bun.lock b/bun.lock
index 0ba89b5..41504b9 100644
--- a/bun.lock
+++ b/bun.lock
@@ -5,7 +5,7 @@
"": {
"name": "@atomicbot-ai/atc",
"dependencies": {
- "@atomic-chat/core": "0.23.4",
+ "@atomic-chat/core": "0.24.2",
"fast-xml-parser": "5.11.2",
"fflate": "0.8.3",
"ink": "^7.1.1",
@@ -63,9 +63,6 @@
},
},
},
- "patchedDependencies": {
- "@atomic-chat/core@0.23.4": "patches/@atomic-chat%2Fcore@0.23.4.patch",
- },
"packages": {
"@adobe/css-tools": ["@adobe/css-tools@4.5.0", "", {}, "sha512-6OzddxPio9UiWTCemp4N8cYLV2ZN1ncRnV1cVGtve7dhPOtRkleRyx32GQCYSwDYgaHU3USMm84tNsvKzRCa1Q=="],
@@ -83,7 +80,7 @@
"@asamuzakjp/css-color": ["@asamuzakjp/css-color@3.2.0", "", { "dependencies": { "@csstools/css-calc": "^2.1.3", "@csstools/css-color-parser": "^3.0.9", "@csstools/css-parser-algorithms": "^3.0.4", "@csstools/css-tokenizer": "^3.0.3", "lru-cache": "^10.4.3" } }, "sha512-K1A6z8tS3XsmCMM86xoWdn7Fkdn9m6RSVtocUrJYIwZnFVkng/PvkEoWtOWmP+Scc6saYWHWZYbndEEXxl24jw=="],
- "@atomic-chat/core": ["@atomic-chat/core@0.23.4", "", { "dependencies": { "@ai-sdk/openai-compatible": "^1.0.28", "ai": "^5.0.121", "smol-toml": "^1.9.1", "tar": "^7.4.3", "yaml": "^2.8.1", "yauzl": "^3.2.0" }, "bin": { "atomic-chat-core": "dist/cli/bin.js" } }, "sha512-G7Pe9h+FMxN7p5xYl3REYktG737E83XkG4PWSFKjtasY6c7shvxVdhquMD/Zbf+T99MxrkoIzYoYpQ+bNIJlGQ=="],
+ "@atomic-chat/core": ["@atomic-chat/core@0.24.2", "", { "dependencies": { "@ai-sdk/openai-compatible": "^1.0.28", "ai": "^5.0.121", "smol-toml": "^1.9.1", "tar": "^7.4.3", "yaml": "^2.8.1", "yauzl": "^3.2.0" }, "bin": { "atomic-chat-core": "dist/cli/bin.js" } }, "sha512-A6+qgn1aCIDUxmQ3ccgx/Oa2Gp3heo9iVhb6/9H2pU7js4YjhgOI/2+i1lXtI8tjoECWU8Iofs+YgC4WUsPeEA=="],
"@atomicbot-ai/atc-admin-ui": ["@atomicbot-ai/atc-admin-ui@workspace:packages/admin-ui"],
diff --git a/docs/decisions/2026-11-18-use-published-core-integrations.md b/docs/decisions/2026-11-18-use-published-core-integrations.md
new file mode 100644
index 0000000..a6c334c
--- /dev/null
+++ b/docs/decisions/2026-11-18-use-published-core-integrations.md
@@ -0,0 +1,12 @@
+---
+date: 2026-11-18
+title: "Use the published core integrations API"
+---
+
+# Use the published core integrations API
+
+- **Context:** Atomic Server initially exposed core's integrations and Muse launch arguments through a patch to the npm package.
+- **Decision:** Pin the published core 0.24.2, which exports the integrations module and accepts the embedding endpoint in the Muse launch planner.
+- **Consequences:** Bun installs the upstream package directly. Agent setup and launch keep using that package's integration logic.
+- **Links:** [Configure agents through core](2026-11-17-configure-agents-through-core.md).
+- **Owner:** team.
diff --git a/docs/decisions/INDEX.md b/docs/decisions/INDEX.md
index 403513d..67720e7 100644
--- a/docs/decisions/INDEX.md
+++ b/docs/decisions/INDEX.md
@@ -11,6 +11,8 @@ add a new one that says which record it supersedes.
## Records
+- **2026-11-18** — [Use the published core integrations API](2026-11-18-use-published-core-integrations.md) — pin core 0.24.2 and remove the dependency patch.
+
- **2026-11-17** — [Configure agents through core](2026-11-17-configure-agents-through-core.md) — use the shared registry for host configuration and launches.
- **2026-11-17** — [Show progress when opening terminal agent setup](2026-11-17-show-terminal-agent-setup-progress.md) — make the full agent card clickable and show the options check.
diff --git a/docs/release.md b/docs/release.md
index 84b5f40..edf0654 100644
--- a/docs/release.md
+++ b/docs/release.md
@@ -265,8 +265,9 @@ pwsh scripts/sign-windows-binary.ps1 dist\bin\atc-x86_64-pc-windows-msvc.exe dis
`atc` embeds the core as the npm package `@atomic-chat/core` (repo `atomic-chat-core`, published by its
release workflow) at an **exact** version, never a caret: the protocol and version checks make a silently
-newer core unsafe. 0.23.4 is the pin. The Foundry Local and LiteRT-LM host entries (`./foundry-host`
+newer core unsafe. 0.24.2 is the pin. The Foundry Local and LiteRT-LM host entries (`./foundry-host`
and `./litert-host`) run before command parsing in `src/bin.ts`, including in the compiled binary.
+Core 0.24.2 exports `./integrations`, including the Muse launch arguments for an embedding server.
The core also exports the provider setting schemas
(`./settings`), `readWindowsAcl` in `./host`, and a PrismML catalog that picks the build for a file's
`requires`/`min_build`. Since 0.17.0 the core downloads no model files and exports no downloader (ADR
@@ -277,7 +278,7 @@ limit on remote GGUF reads (`remoteGgufTimeoutMs`); `startDaemon` passes both op
```jsonc
// package.json
-"dependencies": { "@atomic-chat/core": "0.23.4" }
+"dependencies": { "@atomic-chat/core": "0.24.2" }
```
To bump the core: `bun add --exact @atomic-chat/core@`, run `npm run verify`, and commit the bump
diff --git a/package.json b/package.json
index 8068701..c723aa6 100644
--- a/package.json
+++ b/package.json
@@ -46,16 +46,13 @@
"verify": "npm run lint && npm run typecheck && npm run format:check && node scripts/gen-third-party-notices.mjs --check && npm test && npm run test:ui && npm run build && npm run build:ui && npm run build:bin && npm run test:e2e && npm run test:e2e:web && npm run test:runtime-compat && npm run test:installers"
},
"dependencies": {
- "@atomic-chat/core": "0.23.4",
+ "@atomic-chat/core": "0.24.2",
"fast-xml-parser": "5.11.2",
"fflate": "0.8.3",
"ink": "^7.1.1",
"pdfjs-dist": "4.8.69",
"react": "^19.2.0"
},
- "patchedDependencies": {
- "@atomic-chat/core@0.23.4": "patches/@atomic-chat%2Fcore@0.23.4.patch"
- },
"devDependencies": {
"@eslint/js": "^9.36.0",
"@types/node": "^22.18.0",
diff --git a/patches/@atomic-chat%2Fcore@0.23.4.patch b/patches/@atomic-chat%2Fcore@0.23.4.patch
deleted file mode 100644
index 4b0e5d2..0000000
--- a/patches/@atomic-chat%2Fcore@0.23.4.patch
+++ /dev/null
@@ -1,40 +0,0 @@
-diff --git a/package.json b/package.json
---- a/package.json
-+++ b/package.json
-@@ -31,6 +31,10 @@
- "types": "./dist/host/index.d.ts",
- "import": "./dist/host/index.js"
- },
-+ "./integrations": {
-+ "types": "./dist/integrations/index.d.ts",
-+ "import": "./dist/integrations/index.js"
-+ },
- "./models": {
- "types": "./dist/models/index.d.ts",
- "import": "./dist/models/index.js"
-diff --git a/dist/integrations/catalog.js b/dist/integrations/catalog.js
---- a/dist/integrations/catalog.js
-+++ b/dist/integrations/catalog.js
-@@ -331,7 +331,9 @@
- * The arguments that start `agent` on `model`: its fixed `runArgs`, plus `--model atomic/` for
- * Kilo, which otherwise opens on the model it last used before the one its config selects.
- */
--export function runArgsFor(agent, model) {
-+export function runArgsFor(agent, model, apiUrl) {
-+ if (agent.id === 'muse' && apiUrl)
-+ return ['--provider', 'meta', '--base-url', apiUrl, ...(model ? ['--model', model] : [])];
- return agent.id === 'kilo' && model ? ['--model', `atomic/${model}`, ...agent.runArgs] : [...agent.runArgs];
- }
- /**
-diff --git a/dist/integrations/catalog.d.ts b/dist/integrations/catalog.d.ts
---- a/dist/integrations/catalog.d.ts
-+++ b/dist/integrations/catalog.d.ts
-@@ -63,7 +63,7 @@
- * The arguments that start `agent` on `model`: its fixed `runArgs`, plus `--model atomic/` for
- * Kilo, which otherwise opens on the model it last used before the one its config selects.
- */
--export declare function runArgsFor(agent: Agent, model: string): string[];
-+export declare function runArgsFor(agent: Agent, model: string, apiUrl?: string): string[];
- /**
- * Poolside's docs give the standalone base URL with its API prefix (`/v1`), so it is kept; only
- * surrounding whitespace and trailing slashes go.
From c566438377f31a8eaea5723c76092ad1019a2fca Mon Sep 17 00:00:00 2001
From: Biogenic Ooze
Date: Wed, 18 Nov 2026 13:30:11 +0300
Subject: [PATCH 2/4] Add Strata runtime support to Atomic Server
---
README.md | 2 +
docs/commands.md | 14 +-
.../2026-11-17-credit-strata-resume-bytes.md | 11 +
...2026-11-17-journal-strata-model-install.md | 11 +
.../2026-11-17-use-core-strata-sources.md | 11 +
...6-11-18-align-web-engine-model-feedback.md | 13 +
.../2026-11-18-theme-web-chat-composer.md | 13 +
docs/decisions/INDEX.md | 10 +
docs/strata.md | 40 +++
packages/admin-ui/LIFTED.md | 2 +
.../public/engine-brands/fastflowlm.svg | 8 +
.../public/engine-brands/foundry-local.svg | 1 +
.../admin-ui/public/engine-brands/geniex.svg | 1 +
.../public/engine-brands/litert-lm.svg | 1 +
.../admin-ui/public/engine-brands/sglang.svg | 1 +
.../admin-ui/public/engine-brands/vllm.svg | 1 +
.../admin-ui/src/workspace/EngineMark.tsx | 32 +++
.../src/workspace/chat/InstalledLoad.test.tsx | 14 +
.../src/workspace/chat/InstalledLoad.tsx | 5 +-
.../src/workspace/chat/chat-composition.css | 40 +--
.../src/workspace/intro/EngineChooser.tsx | 8 +-
.../library/catalog/CatalogBrowse.tsx | 4 +-
.../library/catalog/CatalogRuntimeOptions.tsx | 14 +-
.../library/catalog/InstalledModels.tsx | 14 +-
.../workspace/library/catalog/catalog-data.ts | 8 +-
.../library/catalog/catalog-models.ts | 3 +
.../library/catalog/strata-catalog.test.tsx | 41 +++
.../library/downloads/download-data.ts | 2 +
.../downloads/strata-preparation.test.tsx | 27 ++
.../library/install/GenieModelInstall.tsx | 24 +-
.../library/install/runtime-model.css | 6 +
.../src/workspace/server/ServerModel.test.tsx | 31 ++
.../src/workspace/server/ServerModel.tsx | 29 +-
.../src/workspace/server/detail-picker.css | 15 -
.../src/workspace/server/model-choices.tsx | 33 +--
.../server/settings/server-settings.css | 10 +
.../src/workspace/setup/FirstModel.tsx | 4 +-
.../src/workspace/setup/SetupReview.tsx | 2 +-
.../src/workspace/setup/setup-data.ts | 15 +-
.../setup/variant-onboarding.test.tsx | 38 +++
.../src/workspace/styles/engine-mark.css | 28 ++
src/commands/models/engine-listing.ts | 6 +-
src/commands/models/installed-models.ts | 4 +-
src/commands/models/managed-model-commands.ts | 23 +-
src/commands/models/managed-run.ts | 4 +-
src/commands/models/model-commands.ts | 16 +-
src/commands/models/strata-commands.ts | 65 +++++
src/commands/server/human-output.ts | 4 +
src/contract/operations/models.ts | 9 +-
src/contract/operations/strata.ts | 41 +++
src/contract/workspace-operations.ts | 2 +
src/daemon/daemon.ts | 1 +
src/downloads/downloader.ts | 13 +-
src/downloads/index.ts | 12 +-
src/downloads/on-disk.test.ts | 24 +-
src/downloads/on-disk.ts | 58 +++-
src/terminal-setup/types.ts | 5 +-
src/tui/workspace/chat/model-selection.ts | 4 +
src/tui/workspace/chat/picker.test.ts | 14 +
src/tui/workspace/chat/picker.ts | 1 +
src/tui/workspace/library/catalog-actions.ts | 40 +--
src/tui/workspace/library/catalog-browse.ts | 4 +-
src/tui/workspace/library/catalog-browser.ts | 8 +-
.../workspace/library/catalog-installed.ts | 27 +-
.../library/catalog-variants.test.ts | 12 +
src/tui/workspace/library/catalog-variants.ts | 6 +-
.../workspace/library/engine-panel-model.ts | 2 +-
.../workspace/library/installed-model-rows.ts | 31 +-
src/tui/workspace/library/model-job.ts | 7 +-
src/tui/workspace/setup/engine-setup-rows.ts | 3 +-
src/tui/workspace/setup/engine-setup-view.ts | 36 ++-
src/tui/workspace/setup/engine-setup.ts | 21 +-
src/tui/workspace/setup/setup-browser.ts | 2 +-
src/tui/workspace/state.ts | 3 +-
.../models/download-removal.ts | 1 +
.../models/model-downloads.ts | 6 +
.../models/model-operations.ts | 7 +
src/workspace-service/service.ts | 14 +-
src/workspace-service/setup-journal.ts | 4 +-
src/workspace-service/strata/catalog.ts | 59 ++++
src/workspace-service/strata/installed.ts | 33 +++
src/workspace-service/strata/maintenance.ts | 157 ++++++++++
src/workspace-service/strata/operations.ts | 23 ++
src/workspace-service/strata/plan.ts | 61 ++++
src/workspace-service/strata/preparation.ts | 45 +++
src/workspace-service/strata/setups.ts | 268 ++++++++++++++++++
src/workspace-service/strata/sources.ts | 107 +++++++
.../strata/strata-downloads.test.ts | 106 +++++++
.../strata/strata-import.test.ts | 37 +++
.../strata/strata-maintenance.test.ts | 78 +++++
.../strata/strata-preparation.test.ts | 33 +++
.../strata/strata-recovery.test.ts | 99 +++++++
.../catalog/catalog-formats.test.ts | 3 +
src/workspace-view/catalog/catalog-formats.ts | 5 +-
.../downloads/download-controls.ts | 5 +-
src/workspace-view/downloads/downloads.ts | 6 +-
src/workspace-view/engines/engine-order.ts | 5 +-
src/workspace-view/setup/connection-model.ts | 1 +
test/contract/strata-commands.test.ts | 75 +++++
test/contract/strata-server.test.ts | 65 +++++
test/contract/strata-sources.test.ts | 79 ++++++
test/fixtures/strata/README.md | 4 +
test/fixtures/strata/catalog.json | 197 +++++++++++++
test/fixtures/strata/manifest.json | 146 ++++++++++
104 files changed, 2599 insertions(+), 225 deletions(-)
create mode 100644 docs/decisions/2026-11-17-credit-strata-resume-bytes.md
create mode 100644 docs/decisions/2026-11-17-journal-strata-model-install.md
create mode 100644 docs/decisions/2026-11-17-use-core-strata-sources.md
create mode 100644 docs/decisions/2026-11-18-align-web-engine-model-feedback.md
create mode 100644 docs/decisions/2026-11-18-theme-web-chat-composer.md
create mode 100644 docs/strata.md
create mode 100644 packages/admin-ui/public/engine-brands/fastflowlm.svg
create mode 100644 packages/admin-ui/public/engine-brands/foundry-local.svg
create mode 100644 packages/admin-ui/public/engine-brands/geniex.svg
create mode 100644 packages/admin-ui/public/engine-brands/litert-lm.svg
create mode 100644 packages/admin-ui/public/engine-brands/sglang.svg
create mode 100644 packages/admin-ui/public/engine-brands/vllm.svg
create mode 100644 packages/admin-ui/src/workspace/EngineMark.tsx
create mode 100644 packages/admin-ui/src/workspace/library/catalog/strata-catalog.test.tsx
create mode 100644 packages/admin-ui/src/workspace/library/downloads/strata-preparation.test.tsx
create mode 100644 packages/admin-ui/src/workspace/styles/engine-mark.css
create mode 100644 src/commands/models/strata-commands.ts
create mode 100644 src/contract/operations/strata.ts
create mode 100644 src/workspace-service/strata/catalog.ts
create mode 100644 src/workspace-service/strata/installed.ts
create mode 100644 src/workspace-service/strata/maintenance.ts
create mode 100644 src/workspace-service/strata/operations.ts
create mode 100644 src/workspace-service/strata/plan.ts
create mode 100644 src/workspace-service/strata/preparation.ts
create mode 100644 src/workspace-service/strata/setups.ts
create mode 100644 src/workspace-service/strata/sources.ts
create mode 100644 src/workspace-service/strata/strata-downloads.test.ts
create mode 100644 src/workspace-service/strata/strata-import.test.ts
create mode 100644 src/workspace-service/strata/strata-maintenance.test.ts
create mode 100644 src/workspace-service/strata/strata-preparation.test.ts
create mode 100644 src/workspace-service/strata/strata-recovery.test.ts
create mode 100644 test/contract/strata-commands.test.ts
create mode 100644 test/contract/strata-server.test.ts
create mode 100644 test/contract/strata-sources.test.ts
create mode 100644 test/fixtures/strata/README.md
create mode 100644 test/fixtures/strata/catalog.json
create mode 100644 test/fixtures/strata/manifest.json
diff --git a/README.md b/README.md
index 19f9f90..b7fd06a 100644
--- a/README.md
+++ b/README.md
@@ -61,6 +61,8 @@ system, hardware and compatible builds; `atc engines list` shows what is availab
see [Foundry Local](#foundry-local) for platforms and setup.
- **LiteRT-LM** (`litert-lm`) — Google's `.litertlm` models on supported CPU, GPU or Intel NPU
accelerators; see [LiteRT-LM](#litert-lm) for platforms and setup.
+- **Strata** (`strata`) runs pinned Qwen and DeepSeek variants on compatible GPU bundles. See
+ [Strata on Atomic Server](docs/strata.md) for installation and recovery.
- **stable-diffusion.cpp** (`sd-cpp`) — image generation.
- **audio.cpp** (`audio-cpp`) — speech, music and sound effects; see
[Audio generation](#audio-generation).
diff --git a/docs/commands.md b/docs/commands.md
index 3184222..81f37cb 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -31,7 +31,7 @@ Generated by `npm run docs:commands` from the command specs. Do not edit by hand
| `atc models check` | Each managed engine's verdict on a Hugging Face model, before downloading it | works |
| `atc models files` | List downloadable GGUF files | works |
| `atc models list` | Installed models | works |
-| `atc models pull` | Plan and start a durable download: GGUF, or with --engine an MLX or managed checkpoint | works |
+| `atc models pull` | Plan and start a durable model installation | works |
| `atc models import` | Validate and register a local GGUF | works |
| `atc models logs` | The log of a loaded managed model, or of its last failed load | works |
| `atc models info` | Model capabilities on its engine | works |
@@ -586,7 +586,7 @@ Commands:
check Each managed engine's verdict on a Hugging Face model, before downloading it
files List downloadable GGUF files
list Installed models
- pull Plan and start a durable download: GGUF, or with --engine an MLX or managed checkpoint
+ pull Plan and start a durable model installation
import Validate and register a local GGUF
logs The log of a loaded managed model, or of its last failed load
info Model capabilities on its engine
@@ -635,7 +635,7 @@ Usage: atc models search [query] [options]
Search model repositories
Arguments:
- [query] Search words or owner/repo (optional for foundry-local, litert-lm and geniex)
+ [query] Search words or owner/repo (optional for engine catalogs)
Options:
--engine Engine provider ID
@@ -730,7 +730,7 @@ Global options:
```
Usage: atc models pull [model] [options]
-Plan and start a durable download: GGUF, or with --engine an MLX or managed checkpoint
+Plan and start a durable model installation
Arguments:
[model] owner/repo[:file.gguf], or owner/repo[@revision] with --engine
@@ -738,11 +738,11 @@ Arguments:
Options:
--engine Engine provider ID for an engine-specific model download
--detach Start a managed download without following it
- --refresh FastFlowLM: review the latest catalog for a model update
+ --refresh FastFlowLM or Strata: review the latest catalog for a model update
+ --import-dir Strata: import a complete local source directory on the server
--device Foundry Local: the variant for npu, gpu or cpu
--backend Device for LiteRT-LM or GenieX, or an exact GenieX variant ID
- --cancel Cancel a managed, Foundry Local, LiteRT-LM or GenieX download (with its
- --engine)
+ --cancel Cancel an engine-specific download (with its --engine)
--file Exact filename in the repository
--quant Select an unambiguous quantization
--mmproj Include required vision projector (default: true)
diff --git a/docs/decisions/2026-11-17-credit-strata-resume-bytes.md b/docs/decisions/2026-11-17-credit-strata-resume-bytes.md
new file mode 100644
index 0000000..0dc7d38
--- /dev/null
+++ b/docs/decisions/2026-11-17-credit-strata-resume-bytes.md
@@ -0,0 +1,11 @@
+---
+date: 2026-11-17
+title: "Pass reusable Strata staging bytes to the core"
+---
+
+# 2026-11-17 — Pass reusable Strata staging bytes to the core
+
+- **Context.** The normal compatibility check can refuse a resumed transfer when only the remaining sources fit on disk.
+- **Decision.** After a disk refusal, count reusable staged bytes for the same pinned job and request a fresh compatibility check with `staged_bytes`. Count only durable ranges, matching single-stream partials, and hash-verified complete files.
+- **Consequences.** The core keeps responsibility for preparation space and memory decisions. The pinned core 0.24.2 retains its original refusal until a release supports this field.
+- **Alternative.** Counting the length of a sparse file could credit bytes that the downloader would still have to write.
diff --git a/docs/decisions/2026-11-17-journal-strata-model-install.md b/docs/decisions/2026-11-17-journal-strata-model-install.md
new file mode 100644
index 0000000..500b519
--- /dev/null
+++ b/docs/decisions/2026-11-17-journal-strata-model-install.md
@@ -0,0 +1,11 @@
+---
+date: 2026-11-17
+title: "Journal Strata acquisition and guard model replacement"
+---
+
+# 2026-11-17 — Journal Strata acquisition and guard model replacement
+
+- **Context.** A Strata model needs a pinned input set and a separate runtime preparation that can outlive an admin or CLI connection.
+- **Decision.** Keep the reviewed descriptor and request ID in the server's setup journal. Publish only verified source files. Reuse the core's preparation operation and its revision across client reconnects. When replacing sources, hold the core maintenance guard and keep a backup until the new preparation succeeds or the previous installation is restored.
+- **Consequences.** An interrupted transfer resumes with the original hashes. If the core cannot confirm that preparation stopped, the server keeps the guard and both sets of files for recovery. A local import is copied, so deleting an installation never removes its source directory.
+- **Alternative.** Writing downloads into an installed model directory would let a concurrent load observe mixed source sets and would leave nothing to restore on a failed update.
diff --git a/docs/decisions/2026-11-17-use-core-strata-sources.md b/docs/decisions/2026-11-17-use-core-strata-sources.md
new file mode 100644
index 0000000..0058f07
--- /dev/null
+++ b/docs/decisions/2026-11-17-use-core-strata-sources.md
@@ -0,0 +1,11 @@
+---
+date: 2026-11-17
+title: "Read Strata sources through the embedded core and workspace"
+---
+
+# 2026-11-17 — Read Strata sources through the embedded core and workspace
+
+- **Context.** Atomic Server embeds the core. The engine manifest belongs to the core, and the server reads the model catalog to plan model downloads.
+- **Decision.** Pin the released core 0.24.0. Pass the server environment through to the core, including `ATOMIC_STRATA_MANIFEST_URL`. Use `ATOMIC_MODEL_CATALOG_URL` as the workspace fallback when `ATC_MODEL_CATALOG_URL` is unset, so a single setting can point both readers at a local catalog.
+- **Consequences.** Existing workspace overrides keep their precedence. Both overrides accept absolute file URLs at server startup.
+- **Alternative.** Making the core's catalog variable override the workspace variable would silently redirect servers with an explicit workspace catalog.
diff --git a/docs/decisions/2026-11-18-align-web-engine-model-feedback.md b/docs/decisions/2026-11-18-align-web-engine-model-feedback.md
new file mode 100644
index 0000000..9627eeb
--- /dev/null
+++ b/docs/decisions/2026-11-18-align-web-engine-model-feedback.md
@@ -0,0 +1,13 @@
+---
+date: 2026-11-18
+title: "Share desktop engine marks and align model feedback"
+---
+
+# 2026-11-18 — Share desktop engine marks and align model feedback
+
+- **Context:** The Web engine picker used one generic icon for several engines. A catalog verdict sat against the variant card, and the loaded label aligned with the top of its neighboring button.
+- **Decision:** Use Atomic Chat's engine marks and initial-letter fallback in the picker and onboarding. Add breathing room below the variant controls and show model load progress and success in the same inline status slot.
+- **Consequences:** Engine identities match across the two Web entry points. Compatibility reasons still come from the server and the loaded label still follows its service snapshot.
+- **Alternatives:** Drawing new engine marks would diverge from Atomic Chat. Moving the loaded label to a separate line would move the content as model state changes.
+- **Owner:** team.
+- **Links:** `packages/admin-ui/LIFTED.md`, `packages/admin-ui/src/workspace/server/ServerModel.tsx`.
diff --git a/docs/decisions/2026-11-18-theme-web-chat-composer.md b/docs/decisions/2026-11-18-theme-web-chat-composer.md
new file mode 100644
index 0000000..35fb4a6
--- /dev/null
+++ b/docs/decisions/2026-11-18-theme-web-chat-composer.md
@@ -0,0 +1,13 @@
+---
+date: 2026-11-18
+title: "Use the active Web theme for the chat composer"
+---
+
+# 2026-11-18 — Use the active Web theme for the chat composer
+
+- **Context:** The Web composer used fixed mint surfaces in both themes. The default textarea focus outline extended into the toolbar.
+- **Decision:** Use the workspace's themed surface, text and action colors. Draw the textarea focus indicator on the composer perimeter and keep each toolbar button's own focus indicator.
+- **Consequences:** The Web composer follows theme changes alongside the rest of the workspace. Terminal colors keep their existing values.
+- **Alternatives:** Adding separate composer colors for each browser theme would duplicate the existing workspace palette. Keeping the inner outline would require extra spacing between the field and the toolbar.
+- **Owner:** team.
+- **Links:** `packages/admin-ui/src/workspace/chat/chat-composition.css`, [Share semantic colors between Web and the terminal](2026-10-24-share-interface-colors.md).
diff --git a/docs/decisions/INDEX.md b/docs/decisions/INDEX.md
index 67720e7..7aa70ff 100644
--- a/docs/decisions/INDEX.md
+++ b/docs/decisions/INDEX.md
@@ -243,3 +243,13 @@ add a new one that says which record it supersedes.
- [2026-11-07 — Reuse the API listener when connecting an agent](2026-11-07-reuse-api-for-connections.md)
- [2026-11-07 — Package a runtime that does not inherit Windows sockets](2026-11-07-prevent-windows-socket-inheritance.md)
+
+- [2026-11-17 — Read Strata sources through the embedded core and workspace](2026-11-17-use-core-strata-sources.md)
+
+- [2026-11-17 — Journal Strata acquisition and guard model replacement](2026-11-17-journal-strata-model-install.md)
+
+- [2026-11-17 — Pass reusable Strata staging bytes to the core](2026-11-17-credit-strata-resume-bytes.md)
+
+- [2026-11-18 — Use the active Web theme for the chat composer](2026-11-18-theme-web-chat-composer.md)
+
+- [2026-11-18 — Share desktop engine marks and align model feedback](2026-11-18-align-web-engine-model-feedback.md)
diff --git a/docs/strata.md b/docs/strata.md
new file mode 100644
index 0000000..8119b78
--- /dev/null
+++ b/docs/strata.md
@@ -0,0 +1,40 @@
+# Strata on Atomic Server
+
+Install the engine on the server and browse the pinned model variants before choosing one.
+
+```sh
+atc engines install strata
+atc models catalog --engine strata
+atc models search qwen --engine strata
+atc models pull iq3-xxs-dflash2 --engine strata --dry-run
+atc models pull iq3-xxs-dflash2 --engine strata --request-id qwen-metal
+atc run iq3-xxs-dflash2 --engine strata
+atc config get engine.strata.memory_mode
+```
+
+The same catalog and server-side jobs are available in the terminal and web admin. The server
+checks the selected bundle, GPU and disk on its own host. The engine bundle includes Python.
+Set `HF_TOKEN` in the server environment for gated Hugging Face inputs after accepting their terms.
+
+For a local import, use `--import-dir /absolute/server/path` with `models pull --engine strata`.
+The directory must have all the selected variant's files at the relative paths shown by
+`--dry-run`. The server copies and hashes the inputs before registration. The original
+directory stays under the operator's control.
+
+After acquisition, the same job shows **Preparing model** while the core builds and verifies
+the runtime data. If the server restarts, repeat the original `models pull` with the same
+`--request-id` or choose **Resume** in Downloads. The saved plan supplies the source revisions and
+hashes even if the catalog has changed. Cancel with `atc models pull --engine strata --cancel qwen-metal`.
+A replacement keeps the previous files while the core holds the model for maintenance.
+Use Installed models or `atc models rm ` to delete an installed model.
+
+For local conf testing, set the following variables in the environment of the process that
+owns the server. Use absolute file URLs from a checkout with qualified bundles.
+
+```sh
+ATOMIC_STRATA_MANIFEST_URL=file:///absolute/conf/backends/strata-manifest.json
+ATOMIC_MODEL_CATALOG_URL=file:///absolute/conf/models/catalog.json
+```
+
+The engine uses the first override. The workspace uses the second unless
+`ATC_MODEL_CATALOG_URL` is set. Chat uses the existing authenticated OpenAI-compatible listener.
diff --git a/packages/admin-ui/LIFTED.md b/packages/admin-ui/LIFTED.md
index 3d3ae5f..120c551 100644
--- a/packages/admin-ui/LIFTED.md
+++ b/packages/admin-ui/LIFTED.md
@@ -136,6 +136,8 @@ The 2026-11-06 onboarding adaptation scopes `setup/FirstModel.tsx` to the select
The onboarding wizard now shares `intro/EngineChooser.tsx` with the intro: managed runtime consent and readiness precede model selection, Back/Escape retain wizard state, and returning from an engine panel rechecks the selected model's compatibility (`setup/SetupEngineDialog.tsx`).
+- `workspace/EngineMark.tsx` and `public/engine-brands/{vllm,sglang,foundry-local,litert-lm,geniex,fastflowlm}.svg` follow Atomic-Chat `web-app/src/{lib/utils.ts,containers/server/ServerPageParts.tsx}` and `web-app/public/images/model-provider/` @ `07e4b8737`. The picker and onboarding use the same engine logos and initial-letter fallback, including Strata's `S`.
+
The 2026-11-07 adaptation replaces the Foundry native variant menu in `workspace/library/install/FoundryModelInstall.tsx` (original `LocalModelTable.tsx` @ `5043013`) with `VariantChoices.tsx`, shared with LiteRT-LM. Short device/readiness labels and a separate reason keep expanded catalog rows within the viewport. `use-variant-model.ts` refreshes core verdicts when setup returns from engine preparation. Engine dialogs now separate Overview from Settings while retaining staged edits.
The provider summaries, connector cards and workspace settings above now use shared non-interactive status indicators; skill upload uses the shared English file-picker control. Onboarding provider rows grow to accommodate connection status. Original provenance headers are retained.
diff --git a/packages/admin-ui/public/engine-brands/fastflowlm.svg b/packages/admin-ui/public/engine-brands/fastflowlm.svg
new file mode 100644
index 0000000..d99ce6a
--- /dev/null
+++ b/packages/admin-ui/public/engine-brands/fastflowlm.svg
@@ -0,0 +1,8 @@
+
diff --git a/packages/admin-ui/public/engine-brands/foundry-local.svg b/packages/admin-ui/public/engine-brands/foundry-local.svg
new file mode 100644
index 0000000..28ee5fe
--- /dev/null
+++ b/packages/admin-ui/public/engine-brands/foundry-local.svg
@@ -0,0 +1 @@
+
diff --git a/packages/admin-ui/public/engine-brands/geniex.svg b/packages/admin-ui/public/engine-brands/geniex.svg
new file mode 100644
index 0000000..03d1c05
--- /dev/null
+++ b/packages/admin-ui/public/engine-brands/geniex.svg
@@ -0,0 +1 @@
+
diff --git a/packages/admin-ui/public/engine-brands/litert-lm.svg b/packages/admin-ui/public/engine-brands/litert-lm.svg
new file mode 100644
index 0000000..df4e7ef
--- /dev/null
+++ b/packages/admin-ui/public/engine-brands/litert-lm.svg
@@ -0,0 +1 @@
+
diff --git a/packages/admin-ui/public/engine-brands/sglang.svg b/packages/admin-ui/public/engine-brands/sglang.svg
new file mode 100644
index 0000000..09a2af1
--- /dev/null
+++ b/packages/admin-ui/public/engine-brands/sglang.svg
@@ -0,0 +1 @@
+
diff --git a/packages/admin-ui/public/engine-brands/vllm.svg b/packages/admin-ui/public/engine-brands/vllm.svg
new file mode 100644
index 0000000..00b729c
--- /dev/null
+++ b/packages/admin-ui/public/engine-brands/vllm.svg
@@ -0,0 +1 @@
+
diff --git a/packages/admin-ui/src/workspace/EngineMark.tsx b/packages/admin-ui/src/workspace/EngineMark.tsx
new file mode 100644
index 0000000..f02cec6
--- /dev/null
+++ b/packages/admin-ui/src/workspace/EngineMark.tsx
@@ -0,0 +1,32 @@
+// Lifted from Atomic-Chat/web-app/src/lib/utils.ts and containers/server/ServerPageParts.tsx @ 07e4b8737; adapted: server assets and theme.
+import { engineName } from '@view'
+import './styles/engine-mark.css'
+
+const engineLogos: Record = {
+ 'llamacpp-upstream': '/engine-brands/llamacpp.svg',
+ 'llamacpp-server': '/engine-brands/llamacpp.svg',
+ 'llamacpp': '/engine-brands/llamacpp.svg',
+ 'mlx': '/engine-brands/mlx.png',
+ 'atomic-prism': '/model-brands/images/model-provider/prism-ml.webp',
+ 'tensorrt-llm': '/model-brands/images/model-provider/nvidia.svg',
+ 'vllm': '/engine-brands/vllm.svg',
+ 'sglang': '/engine-brands/sglang.svg',
+ 'foundry-local': '/engine-brands/foundry-local.svg',
+ 'litert-lm': '/engine-brands/litert-lm.svg',
+ 'geniex': '/engine-brands/geniex.svg',
+ 'fastflowlm': '/engine-brands/fastflowlm.svg',
+}
+
+export function EngineMark({ engine }: { engine: string }) {
+ const src = engineLogos[engine]
+ const monochrome = engine === 'atomic-prism' || src === '/engine-brands/llamacpp.svg'
+ return (
+
+ {src ? (
+
+ ) : (
+ {engineName(engine).charAt(0).toUpperCase()}
+ )}
+
+ )
+}
diff --git a/packages/admin-ui/src/workspace/chat/InstalledLoad.test.tsx b/packages/admin-ui/src/workspace/chat/InstalledLoad.test.tsx
index 1f2af6a..ee25e31 100644
--- a/packages/admin-ui/src/workspace/chat/InstalledLoad.test.tsx
+++ b/packages/admin-ui/src/workspace/chat/InstalledLoad.test.tsx
@@ -55,3 +55,17 @@ it('exposes a failed downloaded-model read and retries without showing loaded du
expect(await screen.findByRole('button', { name: 'Load Qwen with vLLM' })).toBeEnabled()
expect(screen.queryByRole('button', { name: 'Load Qwen with MLX' })).not.toBeInTheDocument()
})
+
+it('shows the server reason and prevents loading Strata while preparing', async () => {
+ const execute = vi
+ .spyOn(workspaceApi, 'execute')
+ .mockResolvedValue([
+ { id: 'qwen', name: 'Qwen', provider: 'strata', disabled_reason: 'Preparing model' },
+ ] as never)
+ render()
+ const button = await screen.findByRole('button', { name: 'Load Qwen with Strata' })
+ expect(button).toBeDisabled()
+ expect(button).toHaveTextContent('Preparing model')
+ await userEvent.click(button)
+ expect(execute).not.toHaveBeenCalledWith('models.load', expect.anything())
+})
diff --git a/packages/admin-ui/src/workspace/chat/InstalledLoad.tsx b/packages/admin-ui/src/workspace/chat/InstalledLoad.tsx
index 87ef061..9bf32e7 100644
--- a/packages/admin-ui/src/workspace/chat/InstalledLoad.tsx
+++ b/packages/admin-ui/src/workspace/chat/InstalledLoad.tsx
@@ -54,6 +54,7 @@ export function InstalledLoad({
provider,
id: text(m.id),
name: text(m.name ?? m.id),
+ disabledReason: text(m.disabled_reason, ''),
key: `${provider}|${text(m.id)}`,
}))
)
@@ -100,7 +101,7 @@ export function InstalledLoad({
type="button"
className="downloaded-model-row"
aria-label={`Load ${m.name} with ${engineName(m.provider)}`}
- disabled={disabled || Boolean(loading)}
+ disabled={disabled || Boolean(loading) || Boolean(m.disabledReason)}
onClick={async () => {
if (pending.current) return
pending.current = true
@@ -120,7 +121,7 @@ export function InstalledLoad({
>
{m.name}
- {engineName(m.provider)}
+ {m.disabledReason || engineName(m.provider)}
{loading === m.key ? 'Loading…' : 'Load'}
diff --git a/packages/admin-ui/src/workspace/chat/chat-composition.css b/packages/admin-ui/src/workspace/chat/chat-composition.css
index f19c2de..c8d0573 100644
--- a/packages/admin-ui/src/workspace/chat/chat-composition.css
+++ b/packages/admin-ui/src/workspace/chat/chat-composition.css
@@ -1,4 +1,4 @@
-/* Desktop chat composition; colors are shared with the terminal composer. */
+/* Desktop chat composition. */
.chat-enhanced .chat-toolbar {
display: flex;
align-items: center;
@@ -27,20 +27,24 @@
letter-spacing: -0.025em;
}
.desktop-main .chat-enhanced .composer {
- border: 1px solid var(--atomic-composer-frame, #b7d4cd);
- background: var(--atomic-composer, #effaf7);
- color: var(--atomic-composer-ink, #102d28);
border-radius: 24px;
padding: 18px 14px 12px;
}
-.desktop-main .chat-enhanced .composer textarea {
- color: var(--atomic-composer-ink, #102d28);
+.desktop-main .chat-enhanced .composer:has(> .composer-input > textarea:focus-visible) {
+ outline: 2px solid var(--atomic-focus-ring);
+ outline-offset: 2px;
+}
+.desktop-main .chat-enhanced .composer > .composer-input > textarea {
+ background: transparent;
min-height: 68px;
resize: none;
}
+.desktop-main .chat-enhanced .composer textarea:focus-visible {
+ outline: none;
+}
.desktop-main .chat-enhanced .composer textarea::placeholder {
- color: var(--atomic-composer-ink, #102d28);
- opacity: 0.55;
+ color: var(--ew-muted);
+ opacity: 1;
}
.chat-enhanced .composer-toolbar {
gap: 6px;
@@ -55,19 +59,19 @@
padding: 8px 10px;
font-size: 12px;
background: transparent;
- color: var(--atomic-composer-ink, #102d28);
+ color: var(--ew-text);
border-radius: 18px;
}
.chat-enhanced .chat-attach-button {
border: 0;
border-radius: 50%;
- background: var(--atomic-model-button, #c0e6de);
- color: var(--atomic-composer-ink, #102d28);
+ background: var(--ew-raised);
+ color: var(--ew-text);
}
.desktop-main .chat-enhanced .chat-model-trigger {
border-radius: 18px;
- background: var(--atomic-model-button, #c0e6de);
- color: var(--atomic-composer-ink, #102d28);
+ background: var(--ew-raised);
+ color: var(--ew-text);
padding: 8px 12px;
width: 100%;
min-width: 0;
@@ -89,16 +93,16 @@
}
.desktop-main .chat-enhanced .send-button,
.desktop-main .chat-enhanced .composer-send .ew-button {
- background: var(--atomic-send-button, #50d5bf);
- color: var(--atomic-composer-ink, #102d28);
+ background: var(--atomic-accent);
+ color: var(--atomic-on-accent);
}
.chat-enhanced .composer-readiness {
- color: var(--atomic-composer-ink, #102d28);
+ color: var(--ew-text);
padding: 0 6px 12px;
}
.chat-enhanced .composer-readiness button {
- background: var(--atomic-model-button, #c0e6de);
- color: var(--atomic-composer-ink, #102d28);
+ background: var(--ew-raised);
+ color: var(--ew-text);
}
@media (max-width: 650px) {
.chat-layout {
diff --git a/packages/admin-ui/src/workspace/intro/EngineChooser.tsx b/packages/admin-ui/src/workspace/intro/EngineChooser.tsx
index f6391f4..3c41ed4 100644
--- a/packages/admin-ui/src/workspace/intro/EngineChooser.tsx
+++ b/packages/admin-ui/src/workspace/intro/EngineChooser.tsx
@@ -9,6 +9,7 @@ import { EngineSetup } from '../library/engines/EngineSetup'
import { ChevronRight } from 'lucide-react'
import { Action, Empty } from '../Controls'
import { DirectoryRow } from '../DirectoryRow'
+import { EngineMark } from '../EngineMark'
import { WorkspaceBrand } from '../WorkspaceBrand'
import { FloatingDownloads } from '../library/downloads/FloatingDownloads'
import '../setup/onboarding.css'
@@ -16,11 +17,13 @@ import '../setup/onboarding.css'
/** Managed engines explain prerequisites in their plan, even before a runtime is installed. */
const offered = (e: RecordValue) =>
engineFamily(text(e.engine)) === 'managed' ||
- ((e.engine === 'mlx' || ['llamacpp', 'fastflowlm'].includes(engineFamily(text(e.engine)))) &&
+ ((e.engine === 'mlx' || ['llamacpp', 'fastflowlm', 'strata'].includes(engineFamily(text(e.engine)))) &&
Boolean(e.latest)) ||
(Boolean(e.active) &&
(e.engine === 'mlx' ||
- ['llamacpp', 'foundry', 'litert', 'geniex', 'fastflowlm'].includes(engineFamily(text(e.engine)))))
+ ['llamacpp', 'foundry', 'litert', 'geniex', 'fastflowlm', 'strata'].includes(
+ engineFamily(text(e.engine))
+ )))
/** Shared onboarding chooser; closing a runtime panel returns here without cancelling its operation. */
export function EngineChooser({
@@ -138,6 +141,7 @@ export function EngineChooser({
aria-label={e.active ? `${engineName(engine)} · ${status}` : engineName(engine)}
aria-describedby={e.active ? undefined : `choose-engine-${engine}-status`}
detail={{status}}
+ leading={}
disabled={busy || loading}
onClick={() => choose(e)}
trailing={}
diff --git a/packages/admin-ui/src/workspace/library/catalog/CatalogBrowse.tsx b/packages/admin-ui/src/workspace/library/catalog/CatalogBrowse.tsx
index b4c17fb..0d82110 100644
--- a/packages/admin-ui/src/workspace/library/catalog/CatalogBrowse.tsx
+++ b/packages/admin-ui/src/workspace/library/catalog/CatalogBrowse.tsx
@@ -164,7 +164,9 @@ export function CatalogBrowse({
) : isInstalled(idOf(model)) ? (
Downloaded
) : workspace &&
- (['safetensors', 'foundry', 'litert', 'geniex', 'fastflowlm'].includes(modelFormat(model)) ||
+ (['safetensors', 'foundry', 'litert', 'geniex', 'fastflowlm', 'strata'].includes(
+ modelFormat(model)
+ ) ||
managedRepository === idOf(model)) ? (
) : (
diff --git a/packages/admin-ui/src/workspace/library/catalog/CatalogRuntimeOptions.tsx b/packages/admin-ui/src/workspace/library/catalog/CatalogRuntimeOptions.tsx
index 8ef45b3..b3428ac 100644
--- a/packages/admin-ui/src/workspace/library/catalog/CatalogRuntimeOptions.tsx
+++ b/packages/admin-ui/src/workspace/library/catalog/CatalogRuntimeOptions.tsx
@@ -19,6 +19,7 @@ import { modelId } from './catalog-models'
const VARIANT_ENGINES = [
{ key: 'foundry', engine: 'foundry-local', catalog: 'Foundry' },
{ key: 'fastflowlm', engine: 'fastflowlm', catalog: 'FastFlowLM' },
+ { key: 'strata', engine: 'strata', catalog: 'Strata' },
{ key: 'geniex', engine: 'geniex', catalog: 'GenieX' },
{ key: 'litert', engine: 'litert-lm', catalog: 'LiteRT-LM' },
] as const
@@ -48,7 +49,9 @@ export function CatalogRuntimeOptions({
engine: variants.engine,
query: modelId(model),
})
- const next = rows(result).find((candidate) => candidate.model_id === modelId(model))
+ const next = rows(variants.key === 'strata' ? record(result).models : result).find(
+ (candidate) => candidate.model_id === modelId(model)
+ )
if (!next) throw new Error(`This model is no longer in the ${variants.catalog} catalog.`)
setCurrent(next)
} catch (e) {
@@ -71,7 +74,7 @@ export function CatalogRuntimeOptions({
{error} Retry