@ai-ecoverse/slicc-spectrum 1.41.0 → 1.43.0

package/README.md

@@ -134,7 +134,8 @@ Text is Adobe Clean Spectrum VF, falling back to Adobe Clean, and code is Spectr
 | `<slicc-app>` | The shell: header with the agent picker, status items, the update status, the network indicator, the tray, the View menu and the theme switch, rails, and a `<slicc-dock>`. Saves the dock layout per screen class to `storage` (default `localStorage`) under `layoutKey`. While connected it sets `overscroll-behavior` to `none !important` on the page's `html` and `body`, so only scroll areas inside panels rubber-band. When the last app on the page is removed, the page's own inline values come back. |
 | `<slicc-dock>` | Generic. [dockview-core](https://dockview.dev/) 8 with a theme mapped to Spectrum tokens, in its own shadow root. Panels come from `factories` (`name → (params) => HTMLElement`). `open`, `close`, `has`, `content`, `focusPanel`, `cycleGroup`, `cycleTab`, `toJSON`, `restore`, `clear`, and the full `api`. Tabs have a context menu (close, close others, float, maximize). Events: `layout-change`, `active-panel-change`, `panel-close`. |
 | `<slicc-agents>` | Cones with their scoops, status, context fill and unread count. A cone's row has a second line with its conversation title, as does its item in the header's cone picker: `Agent.title`, or else the first line of the first user message, or "No messages yet". When cones share a name, their accessible names and the Delete cone, Freezer and confirmation labels add the title, as in "Delete cone sliccy (Hello from Bedrock)". Selecting one makes it the active agent. |
-| `<slicc-chat>` | One thread's conversation (its `agent`, or the active agent if unset), by day: user messages (with attachments, tagged as steered or follow-up by `delivered`, or delegated from another cone), assistant messages (Markdown with tables, task lists, quotes, code and images; thinking; tool calls, grouped into a collapsible cluster from three in a row, each with its input (a shell command after `$`), an optional `meta` such as a timeout, an edit's `diff` shown as a diff view, and an `image`, such as a screenshot, shown as a thumbnail under the closed card and in full when open; media galleries with images, video and audio; action cards for tools, pull requests and status; plans and checklists; inline diffs; question prompts; delegations; link previews; errors with a fix-it action; a content-filter stop offers **Drop the last turn**, which rewinds that turn and puts its prompt back into the composer; when the turns right before it failed too, the button reads **Drop N failed turns** and rewinds to before the first of them, putting the latest prompt back), standalone tool results, system messages (compaction markers, error cards, notices) and licks, SLICC's events into a cone, on every channel; a lick's `severity` (`warn` or `error`) turns its channel badge into a notice or negative one with an alert icon. Permission requests are allowed or denied in place. The header shows the status, a model picker that names each model's provider and leaves out classifiers and models with `tools: false`, the thinking picker, the context meter and **New conversation**, which calls `clear` and puts focus back in the composer; on a cone, when the port can freeze, its tooltip says the old conversation stays in the Freezer. |
+| `<slicc-chat>` | One thread's conversation (its `agent`, or the active agent if unset), by day: user messages (with attachments, tagged as steered or follow-up by `delivered`, or delegated from another cone), assistant messages (Markdown with tables, task lists, quotes, code and images; thinking; tool calls, grouped into a collapsible cluster from three in a row, each with its input (a shell command after `$`), an optional `meta` such as a timeout, an edit's `diff` shown as a diff view, and an `image`, such as a screenshot, shown as a thumbnail under the closed card and in full when open; media galleries with images, video and audio; action cards for tools, pull requests and status; plans and checklists; inline diffs; question prompts; delegations; link previews; errors with a fix-it action; a content-filter stop offers **Drop the last turn**, which rewinds that turn and puts its prompt back into the composer; when the turns right before it failed too, the button reads **Drop N failed turns** and rewinds to before the first of them, putting the latest prompt back), standalone tool results, system messages (compaction markers, error cards, notices) and licks, SLICC's events into a cone, on every channel; a lick's `severity` (`warn` or `error`) turns its channel badge into a notice or negative one with an alert icon. Permission requests are allowed or denied in place. The header shows the status, a model picker that names each model's provider and leaves out classifiers and models with `tools: false`, the thinking picker, the context meter and **New conversation**, which calls `clear` and puts focus back in the composer; on a cone, when the port can freeze, its tooltip says the old conversation stays in the Freezer. Between the header and the transcript, a `<slicc-notices>` shows the model's notices. |
+| `<slicc-notices>` | The model's `notices` as in-line alerts with their actions and a close button; renders nothing without the port or notices. |
 | `<slicc-composer>` | The message box. <kbd>Enter</kbd> sends, or steers a running reply: the message joins after the current tool round, without interrupting; <kbd>Ctrl</kbd>/<kbd>⌘</kbd>+<kbd>Enter</kbd> queues a follow-up that runs after the reply and can be withdrawn; <kbd>Shift</kbd>+<kbd>Enter</kbd> adds a line; <kbd>Tab</kbd> takes the suggested follow-up; <kbd>↑</kbd>/<kbd>↓</kbd> at the start or end walk this agent's history; <kbd>Esc</kbd> stops. `/` completes commands (`/clear`, `/compact`, `/model`, `/thinking`, `/scoop`, `/stop`, `/freeze` when the port can freeze, `/theme`) and their arguments, `@` mentions agents and files. Attach from the computer, from SLICC's files, a browser screenshot or a shared secret, or paste and drop files (25 MB each). Queued messages wait above it, to send now or drop. Model and thinking pickers, and dictation where the browser has speech recognition. Drafts are kept per agent. |
 | `<slicc-files>` | The file system as a `<slicc-file-tree>`, with pending changes as git status. Opening a file opens it in a tab. With `files.mountFolder`, **Mount a folder…** (`data-action="mount-folder"`) mounts a local folder, then selects and expands it in the tree; with `files.mounts`, a **Mounted** strip lists the mount points, each with **Eject** (`data-action="eject"`, `data-path` the mount point) when the port has `eject`. With `files.needsFolder`, a **Needs a folder** section lists the mount points waiting for a folder, each with **Insert folder…** (`data-action="insert-folder"`, `data-id` the mount point), which calls `mountFolder(path)`. A failed mount, insert or eject shows its message under the bar. |
 | `<slicc-file-view>` | One file (`path`), highlighted, with its pending change and a link to the diff. |
@@ -143,7 +144,7 @@ Text is Adobe Clean Spectrum VF, falling back to Adobe Clean, and code is Spectr
 | `<slicc-terminals>` | Terminal sessions in tabs, each a `<slicc-terminal>` on the session's `TerminalBackend`. Sessions stay alive while hidden; `exit` closes the tab. |
 | `<slicc-browser>` | Browser tabs with the agent driving each, an address bar, reload, and the active tab's screenshot. |
 | `<slicc-settings>` | Theme, the model and thinking level for new cones, composer and diff preferences, and accounts to connect, reconnect or disconnect. An account whose status is `signing-in` (or a non-API-key account while its `connect` is pending) reads “Signing in…”; when the port has `cancel(id)`, its row offers Cancel (`data-action="cancel-sign-in"`), and the rejected `connect` that follows shows no error. |
-| `<slicc-updates>` | Install / Update: component states, version changes, last checks, download and link counts, action buttons, failures with Retry, and collapsible install logs. Opens at boot until the agent is ready without failures. Background updates stay in the header's update status; new failures reopen the panel, and after a reload into a boot that isn't ready yet such a panel closes once the agent is ready. Every automatic close is saved to the layout. Also available through View and the rails. |
+| `<slicc-updates>` | Install / Update: component states, version changes, last checks, download and link counts, action buttons, failures with Retry, and collapsible install logs. Opens at boot until the agent is ready without failures. Background updates stay in the header's update status; new failures reopen the panel, and after a reload into a boot that isn't ready yet such a panel closes once the agent is ready. Every automatic close is saved to the layout. When the port offers packages, an Optional packages section lists them below as compact rows, each with its state, version, download size, requirements, commands, progress, errors and Install log; packages never count in the header or keep the panel open at boot. Also available through View and the rails. |
 | `<slicc-memory>` | What agents remember, per scope (everyone, a cone or a role), grouped by section: search, filter by tag, expand, edit, add and forget. Free text outside an entry shows “From MEMORY.md”. |
 | `<slicc-monitor>` | The live monitor: vitals with sparklines (active agents, spend, budget, fullest context), alerts, and the topology (cones and scoops, terminals, tabs, pending changes, sprinkles, tray followers). |
 | `<slicc-freezer>` | Every conversation in the session, from `frozen()`: cones, scoops and agent runs, each with a kind badge, live ones first with a Live light, then the newest first. A live row offers **Open**, which selects that agent; a stopped one offers **Thaw** and **Remove**, which deletes its working folders after a confirmation. A thawed scoop or agent run keeps its row, which says what it was thawed as. **Delete cone**, in the agents list (or <kbd>Delete</kbd> on a cone's row) and the header's cone picker, stops a cone after a confirmation; `/freeze` does it at once. Either way its conversation stays here, and a row without a `kind` counts as a cone. |
@@ -205,10 +206,11 @@ Paths are the agent's: `/shared/…` and `/home/…`, nothing else. A refusal or
 | `monitor` | all of them | A snapshot of vitals, alerts and sections, re-emitted as the system changes, and `resync`. |
 | `sprinkles` | `@ai-ecoverse/slicc-agent` | Sprinkles (`inline` ones show as dips in the chat, not in the rail) and `send`, which turns a sprinkle's lick into a lick on its cone. The optional `call(id, method, args)` serves the [sprinkle bridge](#sprinkle-bridge) for sprinkle `id`: `readFile` and `exists` (`[path]`) resolve with a string and a boolean, `getState` (`[]`) with the saved value or `null`, and `setState` (`[value]`) once it is saved. The adapter owns path policy and keeps state per sprinkle; `<slicc-sprinkle>` awaits `getState` before it builds a frame, mirrors what the frame saves, and forwards only these four methods from its own frame. The dummy keeps state in memory and maps `/shared/x` to `/home/x` in its files, refusing anything outside `/home`. |
 | `tray` | the tray protocol | Connection, role, float kind, followers, spend and budget; `reconnect` and `disconnect`. |
-| `updates` (optional) | BIOS installers | `list()` returns `UpdateItem` rows for BIOS, kernel, agent, grammars, global pnpm packages, skills and UI. `ready()` explicitly reports agent readiness, independently of agent activity. Emit `items` whenever rows or readiness change. Use `queued` for a row that waits for another component before it starts; it reads "Waiting" and doesn't count as updating. Use `starting` for an installed row that is only starting up: it reads "Starting" without a checked line, and the header shows a neutral "Starting" only when nothing is failed, updating or ready. A `failed` row with an installed `from` version reads "Update failed". `act(id, action)` resolves when dispatched or rejects with a displayed error; actions are `retry`, `update-now`, `restart-agent` and `reload`. Missing ports preserve existing adapters and report disconnected information in the panel. Real installer wiring belongs to ai-ecoverse/slicc-bios#70. |
+| `updates` (optional) | BIOS installers | `list()` returns `UpdateItem` rows for BIOS, kernel, agent, grammars, global pnpm packages, skills and UI. `ready()` explicitly reports agent readiness, independently of agent activity. Emit `items` whenever rows or readiness change. Use `queued` for a row that waits for another component before it starts; it reads "Waiting" and doesn't count as updating. Use `starting` for an installed row that is only starting up: it reads "Starting" without a checked line, and the header shows a neutral "Starting" only when nothing is failed, updating or ready. A `failed` row with an installed `from` version reads "Update failed". `act(id, action)` resolves when dispatched or rejects with a displayed error; actions are `retry`, `update-now`, `restart-agent` and `reload`. Missing ports preserve existing adapters and report disconnected information in the panel. Optional `packages()` returns `PackageItem` rows for optional tools, each with a short catalog `id`, its npm `package` (shown in the name's tooltip and at the top of its Install log), `label`, a one-sentence `description`, the `commands` it provides, `requires` (other package ids, read as "Needs Python", "Installs Python too", or "Needs Python (not installed)" on an installed row), `state` (`available`, `queued`, `installing`, `installed`, `outdated`, `updating`, `removing` or `failed`), the installed `version`, the `offered` version and its `size` in bytes, `progress` counted in packages (or `null` for an indeterminate bar), `error`, `actions` (`install`, `update`, `remove`, `retry`) and an optional `log`. Emit `packages` whenever they change. `actPackage(id, action)` keeps the row's button pending until it settles; it shows any confirm itself, resolves without a change when that confirm is cancelled, and rejects with a displayed error on a real failure. Hooks: `section[data-section="packages"]`, `li[data-id][data-state]`, buttons with `data-action` and `[data-error]`. Real installer wiring belongs to ai-ecoverse/slicc-bios#70. |
 | `network` (optional) | BIOS | `status()` returns the `NetworkStatus`: `route` (`proxy` for slicc-node, `extension` for the Chrome extension relay, `tailnet` while a Tailscale exit node carries the traffic, `page` for the page's own fetch, limited by CORS, or `null`), `health` (`ok`, `limited` or `failing`, decided by the port), a one-line `detail`, recent `failures` (`{ url, error, at }`, newest first), an optional `extensionUrl` and an optional `browser` (`{ via, detail?, declined? }`, `via` being `extension`, `proxy` or `null` when browser automation isn't available, and `declined: true` once the user declined browser control for the session). Emit `network` when it changes. The optional `check()` tests the route again. An optional `tailnet` (`TailnetStatus`) shows the Tailscale section: `state` (`off`, `loading`, `needs-login`, `starting`, `running` or `failed`, a status light), a plain-language `detail` (progress, or the failure reason in an error box with **Retry** through `check()`), a `loginUrl` (**Sign in to Tailscale**, a new tab), the `node` (`{ name, addresses }`; the name and the first 100.x address, each with a Copy button), `exitNode` (the name in use or `null`), `exitNodes` (`{ id, name, online }`), `autoExitNode`, `shieldsUp` (a muted line when `true`, a warning when `false`) and `peers` (a count). The optional `setTailnet(on)` adds the **Use Tailscale** switch (`data-action="tailnet"`); `submitAuthKey(key)` adds an auth-key field to `needs-login` (a password field without a `name`, cleared on submit, never kept in component state); `setExitNode(id | 'auto' | null)` adds the **Exit node** picker (None, Automatic, and each node, offline ones disabled) to `running`, with a line saying where traffic goes; `logoutTailnet()` adds **Sign out**, behind a confirm. A rejected call shows its message in the section. Peers are never named beyond the exit-node list. Without the port, the indicator and the Network panel don't show. |
+| `notices` (optional) | BIOS | `list()` returns `Notice`s for quiet, dismissible in-line notices at the top of every chat panel, above the transcript, in list order: `id`, `tone` (`info` reads as informative, `warning` as a notice), `title`, a plain-text `body` and `actions` (`{ id, label }`). Title, body and labels are text only. Notices use `role="status"` and never take focus. An action is a secondary button that stays pending until `act(id, action)` settles; a rejection shows its message under the body. The close button, labelled "Dismiss: <title>", hides the notice at once and calls `dismiss(id)` synchronously; it shows again only if the port drops the notice from `list()` and brings it back later. Emit `notices` whenever they change. Hooks: `[data-notice="<id>"]`, buttons with `data-action`, `[data-dismiss]` and `[data-error]`. |
 
-The dummy supports `createDummyModel({ updates: 'boot' | 'starting' | 'current' | 'available' | 'restart' | 'failure' })`, also selectable with `?updates=` on `/ui/`. Fixtures stay stable for inspection; `model.updates.setScenario('current')` completes boot. Dummy Update now and Retry simulate download and link progress; Restart agent and Reload only change fixture state, never restart a real process or reload the browser. `updateFixtures` and `DummyUpdates` are exported from `/dummy`. `createDummyModel({ mounts: 'mount' | 'cancel' | 'fail' | 'needs' })` (or `?mounts=` on `/ui/`) turns on the optional mount members, which are off by default: `mountFolder` mounts invented files at `/mnt/photos`, resolves with `null`, or rejects, as `model.files.mount.scenario` says; `needs` also lists `/mnt/photos` in `needsFolder()` until a folder is inserted there. `createDummyModel({ network: 'ok' | 'limited' | 'failing' | 'off' })` (or `?network=` on `/ui/`, default `limited`) sets the dummy network: slicc-node (with browser automation through it), the page fetch with CORS failures, or no route, all invented; `off` leaves out the port. `model.network.setScenario()` switches it and Check again re-emits after a short wait. `createDummyModel({ tailnet: 'off' | 'needs-login' | 'running' | 'failed' })` (or `?tailnet=` on `/ui/`, off by default) adds an invented tailnet: an auth key starting with `tskey-` signs in, `mast-pi` and `keel-router` are online exit nodes and `buoy-laptop` is offline, and Retry on `failed` connects. While the dummy tailnet runs with an exit node, the route is `tailnet` and the health `ok`. `networkFixtures`, `tailnetFixtures` and `DummyNetwork` are exported from `/dummy`. `createDummyModel({ changes: 'files' | 'git' | 'nogit' })` (or `?changes=` on `/ui/`, default `files`) adds a git `changes` port: `git` lists the pending changes under `/workspace/harbor` and `/workspace/skills` with their `repo` and no author, and `nogit` reports git as unavailable. `DummyChanges` is exported from `/dummy`.
+The dummy supports `createDummyModel({ updates: 'boot' | 'starting' | 'current' | 'available' | 'restart' | 'failure' })`, also selectable with `?updates=` on `/ui/`. Fixtures stay stable for inspection; `model.updates.setScenario('current')` completes boot. Dummy Update now and Retry simulate download and link progress; Restart agent and Reload only change fixture state, never restart a real process or reload the browser. `createDummyModel({ packages: 'mixed' | 'empty' | 'fail' | 'off' })` (or `?packages=` on `/ui/`, off by default) adds invented optional packages in every state: Install and Retry finish after a short wait and install missing requirements too, `fail` makes them fail, and removing Python while uv is installed asks through the `confirm` option (the `/ui/` page passes spectrum's `confirm`). `updateFixtures`, `packageFixtures` and `DummyUpdates` are exported from `/dummy`. `createDummyModel({ mounts: 'mount' | 'cancel' | 'fail' | 'needs' })` (or `?mounts=` on `/ui/`) turns on the optional mount members, which are off by default: `mountFolder` mounts invented files at `/mnt/photos`, resolves with `null`, or rejects, as `model.files.mount.scenario` says; `needs` also lists `/mnt/photos` in `needsFolder()` until a folder is inserted there. `createDummyModel({ network: 'ok' | 'limited' | 'failing' | 'off' })` (or `?network=` on `/ui/`, default `limited`) sets the dummy network: slicc-node (with browser automation through it), the page fetch with CORS failures, or no route, all invented; `off` leaves out the port. `model.network.setScenario()` switches it and Check again re-emits after a short wait. `createDummyModel({ tailnet: 'off' | 'needs-login' | 'running' | 'failed' })` (or `?tailnet=` on `/ui/`, off by default) adds an invented tailnet: an auth key starting with `tskey-` signs in, `mast-pi` and `keel-router` are online exit nodes and `buoy-laptop` is offline, and Retry on `failed` connects. While the dummy tailnet runs with an exit node, the route is `tailnet` and the health `ok`. `networkFixtures`, `tailnetFixtures` and `DummyNetwork` are exported from `/dummy`. `createDummyModel({ changes: 'files' | 'git' | 'nogit' })` (or `?changes=` on `/ui/`, default `files`) adds a git `changes` port: `git` lists the pending changes under `/workspace/harbor` and `/workspace/skills` with their `repo` and no author, and `nogit` reports git as unavailable. `DummyChanges` is exported from `/dummy`. `createDummyModel({ notices: 'storage' | 'mixed' | 'fail' | 'off' })` (or `?notices=` on `/ui/`, off by default) adds an invented storage warning with Try again, which clears it after a short wait (`mixed` adds an informative notice without actions, and `fail` makes Try again fail). `noticeFixtures` and `DummyNotices` are exported from `/dummy`.
 
 On phones the update status and the tray show only their status light and the network indicator a cloud icon, with the text in their labels and tooltips; the agent picker keeps room for the cone's name, cut with an ellipsis when long, and the bottom rail scrolls when needed. The update status comes first so progress and failures remain reachable on narrow screens.
 

package/dist/slicc-dummy.js

@@ -3951,6 +3951,52 @@ var DummyNetwork = class extends Emitter {
   }
 };
 
+// src/dummy/notices.ts
+var noticeFixtures = {
+  storage: {
+    id: "storage",
+    tone: "warning",
+    title: "Your files may be cleared",
+    body: "This browser may clear seven\u2019s files and chats when the disk runs low on space. Bookmarking this page makes that less likely.",
+    actions: [{ id: "retry", label: "Try again" }]
+  },
+  welcome: {
+    id: "welcome",
+    tone: "info",
+    title: "Everything stays in this browser",
+    body: "Seven keeps your files and chats on this computer. Nothing is uploaded unless you send it.",
+    actions: []
+  }
+};
+var DummyNotices = class extends Emitter {
+  #scenario;
+  #time;
+  #notices;
+  constructor(scenario, time) {
+    super();
+    this.#scenario = scenario;
+    this.#time = time;
+    this.#notices = scenario === "mixed" ? [noticeFixtures.storage, noticeFixtures.welcome] : [noticeFixtures.storage];
+  }
+  list() {
+    return this.#notices;
+  }
+  async act(id, action) {
+    await this.#time.sleep(10);
+    if (this.#scenario === "fail") {
+      throw new Error("The browser declined again. Bookmark this page, then try again.");
+    }
+    if (id === "storage" && action === "retry") this.#remove(id);
+  }
+  dismiss(id) {
+    this.#remove(id);
+  }
+  #remove(id) {
+    this.#notices = this.#notices.filter((notice) => notice.id !== id);
+    this.emit("notices", this.#notices);
+  }
+};
+
 // src/dummy/sprinkles.ts
 function homePath(path) {
   const text = String(path);
@@ -4336,15 +4382,188 @@ function updateFixtures(scenario) {
   }
   return items;
 }
+var offer = (id, label, description, commands, offered, size, requires) => ({
+  id,
+  package: `@harbor/${id}-wasm`,
+  label,
+  description,
+  commands,
+  ...requires ? { requires } : {},
+  state: "available",
+  version: null,
+  offered,
+  size,
+  progress: null,
+  error: null,
+  actions: ["install"]
+});
+var fetchFailed = "The download stopped. Check the connection and try again.";
+function packageFixtures(scenario) {
+  if (scenario === "empty") return [];
+  const items = [
+    offer("git", "git", "Version control for your projects.", ["git"], "2.47.1", 43e5),
+    offer(
+      "python",
+      "Python",
+      "Python with pip, for scripts and data work.",
+      ["python3", "pip"],
+      "3.13.1",
+      284e5
+    ),
+    offer(
+      "uv",
+      "uv",
+      "Fast Python package and project manager.",
+      ["uv", "uvx"],
+      "0.9.2",
+      61e5,
+      ["python"]
+    ),
+    offer("ruff", "Ruff", "Python linter and formatter.", ["ruff"], "0.14.0", 98e5, [
+      "python"
+    ]),
+    offer(
+      "esbuild",
+      "esbuild",
+      "Bundles and minifies JavaScript and TypeScript.",
+      ["esbuild"],
+      "0.25.10",
+      101e5
+    ),
+    offer(
+      "tsc",
+      "TypeScript",
+      "Type-checks and compiles TypeScript.",
+      ["tsc"],
+      "5.9.3",
+      236e5
+    ),
+    offer(
+      "biome",
+      "Biome",
+      "Formats and lints JavaScript, TypeScript and JSON.",
+      ["biome"],
+      "2.2.4",
+      192e5
+    ),
+    offer(
+      "pdf",
+      "PDF tools",
+      "Extract text, pages and details from PDF files.",
+      ["pdftotext", "pdfinfo", "pdfseparate"],
+      "24.8.0",
+      79e5
+    )
+  ];
+  const at3 = (id) => items.findIndex((item) => item.id === id);
+  const patch = (id, change) => {
+    items[at3(id)] = { ...items[at3(id)], ...change };
+  };
+  patch("python", { state: "installed", version: "3.13.1", actions: ["remove"] });
+  patch("uv", { state: "outdated", version: "0.8.1", actions: ["update", "remove"] });
+  patch("esbuild", {
+    state: "installing",
+    actions: [],
+    log: "Packages: +1\nProgress: resolved 1, downloaded 0, added 0"
+  });
+  patch("biome", { state: "installed", version: "2.2.4", actions: ["remove"] });
+  patch("pdf", {
+    state: "failed",
+    error: fetchFailed,
+    actions: ["retry"],
+    log: "Packages: +1\nERR_PNPM_FETCH_TIMEOUT Request timed out after 30000ms"
+  });
+  return items;
+}
 var DummyUpdates = class extends Emitter {
   #items;
   #ready;
   #clock;
-  constructor(scenario, clock2) {
+  #packages = [];
+  #fail = false;
+  #confirm;
+  constructor(scenario, clock2, options = {}) {
     super();
     this.#items = updateFixtures(scenario);
     this.#ready = scenario !== "boot" && scenario !== "starting";
     this.#clock = clock2;
+    this.#confirm = options.confirm;
+    if (options.packages) {
+      this.#packages = packageFixtures(options.packages);
+      this.#fail = options.packages === "fail";
+      this.packages = () => this.#packages;
+      this.actPackage = (id, action) => this.#actPackage(id, action);
+    }
+  }
+  #patchPackage(id, patch) {
+    this.#packages = this.#packages.map((item) => item.id === id ? { ...item, ...patch } : item);
+    this.emit("packages", this.#packages);
+  }
+  async #actPackage(id, action) {
+    const item = this.#packages.find((candidate) => candidate.id === id);
+    if (!item?.actions.includes(action)) throw new Error(`Package action unavailable: ${id}`);
+    if (action === "remove") {
+      const users = this.#packages.filter((other) => other.version !== null && other.requires?.includes(id)).map((other) => other.label);
+      if (users.length && this.#confirm) {
+        const names = new Intl.ListFormat("en", { type: "conjunction" }).format(users);
+        const verb = users.length === 1 ? "needs it and stops" : "need it and stop";
+        const ok = await this.#confirm({
+          title: `Remove ${item.label}?`,
+          body: `${names} ${verb} working until ${item.label} is back.`,
+          action: "Remove",
+          variant: "confirmation"
+        });
+        if (!ok) return;
+      }
+      this.#patchPackage(id, { state: "removing", error: null, actions: [] });
+      await this.#clock.sleep(2);
+      this.#patchPackage(id, {
+        state: "available",
+        version: null,
+        actions: ["install"],
+        log: void 0
+      });
+      return;
+    }
+    const log = "Packages: +1";
+    this.#patchPackage(id, {
+      state: action === "update" ? "updating" : "installing",
+      error: null,
+      actions: [],
+      log: `${log}
+Progress: resolved 1, downloaded 0, added 0`
+    });
+    await this.#clock.sleep(4);
+    if (this.#fail) {
+      this.#patchPackage(id, {
+        state: "failed",
+        error: fetchFailed,
+        actions: ["retry"],
+        log: `${log}
+ERR_PNPM_FETCH_TIMEOUT Request timed out after 30000ms`
+      });
+      throw new Error(fetchFailed);
+    }
+    for (const need of item.requires ?? []) {
+      const required = this.#packages.find((candidate) => candidate.id === need);
+      if (required && required.version === null) {
+        this.#patchPackage(need, {
+          state: "installed",
+          version: required.offered,
+          error: null,
+          actions: ["remove"]
+        });
+      }
+    }
+    this.#patchPackage(id, {
+      state: "installed",
+      version: item.offered,
+      progress: null,
+      actions: ["remove"],
+      log: `${log}
+Progress: resolved 1, downloaded 1, added 1
+Done in 3.8s`
+    });
   }
   list() {
     return this.#items;
@@ -4396,10 +4615,13 @@ function createDummyModel({
   delay = 30,
   storage = null,
   updates = "current",
+  packages = "off",
+  confirm,
   mounts = "off",
   network = "limited",
   tailnet,
-  changes = "files"
+  changes = "files",
+  notices = "off"
 } = {}) {
   const time = clock(delay);
   const mount = mounts === "off" ? null : { scenario: mounts, point: mountPoint, files: mounted };
@@ -4433,18 +4655,25 @@ function createDummyModel({
     ]),
     sprinkles: new DummySprinkles(sprinkles, agent, files3),
     tray: new DummyTray(tray, time),
-    updates: new DummyUpdates(updates, time),
+    updates: new DummyUpdates(updates, time, {
+      ...packages === "off" ? {} : { packages },
+      confirm
+    }),
     ...network === "off" ? {} : { network: new DummyNetwork(network, time, tailnet) },
-    ...changes === "files" ? {} : { changes: new DummyChanges(files3, changes === "git") }
+    ...changes === "files" ? {} : { changes: new DummyChanges(files3, changes === "git") },
+    ...notices === "off" ? {} : { notices: new DummyNotices(notices, time) }
   };
   return { ...base, monitor: new DummyMonitor(base) };
 }
 export {
   DummyChanges,
   DummyNetwork,
+  DummyNotices,
   DummyUpdates,
   createDummyModel,
   networkFixtures,
+  noticeFixtures,
+  packageFixtures,
   tailnetFixtures,
   updateFixtures
 };