@ai-ecoverse/slicc-spectrum 1.26.0 → 1.27.0

package/README.md

@@ -136,7 +136,7 @@ Text is Adobe Clean Spectrum VF, falling back to Adobe Clean, and code is Spectr
 | `<slicc-agents>` | Cones with their scoops, status, context fill and unread count. 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, and an edit's `diff` shown as a diff view; 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), 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. |
 | `<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`, `/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. |
+| `<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`. A failed mount 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. |
 | `<slicc-changes>` | Pending changes with their author. Opens the diff, accepts or reverts one change or all of them. |
 | `<slicc-diff-panel>` | The diff of one pending change (`path`), unified or split, with accept and revert. |
@@ -195,7 +195,7 @@ Paths are the agent's: `/shared/…` and `/home/…`, nothing else. A refusal or
 | Port | Later backed by | |
 | :--- | :--- | :--- |
 | `agent` | `@ai-ecoverse/slicc-agent` | Cones and scoops, the active agent, conversations, `send` (with attachments, as a send, a steer or a queued follow-up) and `stop`, the queue, suggestions, answers to questions, permission decisions, compaction, clearing, the model per agent and new scoops. The optional `rewind(agentId, messageId)` drops the user turn before that message and everything after it, and resolves with the turn's prompt (text and attachments) for the composer, or `null`. The optional `drop(agentId)` removes a scoop (its files stay), and `createCone(name)` resolves with a new cone; the dummy rejects a cone name that is taken. Assistant messages stream: the same message is re-emitted as its parts grow and its tool calls go from `running` to `done`. |
-| `files` | slicc-kernel's OPFS | `list`, `read`, `write`, `remove`, and pending changes with their before and after text (`accept`, `revert`). |
+| `files` | slicc-kernel's OPFS | `list`, `read`, `write`, `remove`, and pending changes with their before and after text (`accept`, `revert`). The optional `mountFolder()` asks for a local folder and resolves with its mount point (for example `/mnt/photos`), or `null` when the user cancels; the panel calls it synchronously in the click, so the port can call `showDirectoryPicker()`. The optional `mounts()` lists the mount points, and `eject(path)` unmounts one (the folder stays on disk). The port emits `mounts` and then `files` after every mount and eject, including those made from the shell. |
 | `terminals` | slicc-kernel's terminal API | Terminal sessions; `backend(id)` returns a `TerminalBackend` for `<slicc-terminal>`. |
 | `browser` | `@ai-ecoverse/slicc-cdp` | Tabs, the active tab, `open`, `navigate`, `close`, `screenshot`. |
 | `settings` | local storage | Theme, model, thinking level, composer and diff preferences, the models on offer, and accounts. |
@@ -205,7 +205,7 @@ Paths are the agent's: `/shared/…` and `/home/…`, nothing else. A refusal or
 | `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. `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. |
 
-The dummy supports `createDummyModel({ updates: 'boot' | '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`.
+The dummy supports `createDummyModel({ updates: 'boot' | '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' })` (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.
 
 On phones the tray uses a compact indicator (its full status remains available on activation), the agent picker shrinks to fit, 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

@@ -1912,14 +1912,25 @@ function parents(path) {
   return parts.map((_, i) => `/${parts.slice(0, i + 1).join("/")}`);
 }
 var DummyFiles = class extends Emitter {
+  mount;
+  mountFolder;
+  mounts;
+  eject;
+  #mounted = /* @__PURE__ */ new Set();
   #contents = /* @__PURE__ */ new Map();
   #directories = /* @__PURE__ */ new Set();
   #modified = /* @__PURE__ */ new Map();
   #changes = /* @__PURE__ */ new Map();
   #clock;
-  constructor(contents, directories2, changes, clock2) {
+  constructor(contents, directories2, changes, clock2, mount = null) {
     super();
     this.#clock = clock2;
+    this.mount = mount;
+    if (mount) {
+      this.mountFolder = () => this.#mountFolder(mount);
+      this.mounts = () => [...this.#mounted];
+      this.eject = (path) => this.#eject(path);
+    }
     for (const directory of directories2) this.#mkdirs(`${directory}/`);
     for (const [path, text] of Object.entries(contents)) this.#put(path, text, 0);
     for (const change of changes) this.#changes.set(change.path, { ...change });
@@ -2004,6 +2015,38 @@ var DummyFiles = class extends Emitter {
     else this.#put(path, change.before, Date.now());
     this.#announce(path);
   }
+  async #mountFolder(mount) {
+    await this.#clock.sleep();
+    if (mount.scenario === "cancel") return null;
+    if (mount.scenario === "fail") throw new Error("The folder couldn\u2019t be mounted.");
+    const files3 = [];
+    for (const [path, text] of Object.entries(mount.files)) {
+      const file = `${mount.point}/${path}`;
+      this.#put(file, text, Date.now());
+      files3.push(file);
+    }
+    this.#mounted.add(mount.point);
+    this.#remount(files3);
+    return mount.point;
+  }
+  async #eject(path) {
+    await this.#clock.sleep();
+    if (!this.#mounted.delete(path)) throw new Error(`Nothing is mounted at ${path}.`);
+    const inside = (candidate) => candidate === path || candidate.startsWith(`${path}/`);
+    const files3 = [...this.#contents.keys()].filter(inside);
+    for (const file of files3) {
+      this.#contents.delete(file);
+      this.#modified.delete(file);
+    }
+    for (const directory of [...this.#directories].filter(inside))
+      this.#directories.delete(directory);
+    this.#remount(files3);
+  }
+  #remount(files3) {
+    this.emit("mounts", [...this.#mounted]);
+    this.emit("files", this.#entries());
+    for (const file of files3) this.emit("file", file);
+  }
 };
 
 // src/dummy/showcase.ts
@@ -2919,6 +2962,13 @@ var files2 = {
   "/tmp/forecast-sample.json": sample
 };
 var directories = ["/sessions", "/home/user/downloads"];
+var mountPoint = "/mnt/photos";
+var mounted = {
+  "README.md": "# Photos\n\nHarbor shots for the forecast pages, one album per season.\n",
+  "albums/autumn.json": '{ "title": "Autumn", "shots": ["breakwater-fog", "pier-at-dusk"] }\n',
+  "albums/winter.json": '{ "title": "Winter", "shots": ["ice-on-the-buoys"] }\n',
+  "captions.txt": "breakwater-fog: low cloud over the outer wall\npier-at-dusk: lamps on, tide out\n"
+};
 var pending = [
   {
     path: "/workspace/harbor/src/lib/cache.ts",
@@ -3999,10 +4049,12 @@ var DummyUpdates = class extends Emitter {
 function createDummyModel({
   delay = 30,
   storage = null,
-  updates = "current"
+  updates = "current",
+  mounts = "off"
 } = {}) {
   const time = clock(delay);
-  const files3 = new DummyFiles(files2, directories, pending, time);
+  const mount = mounts === "off" ? null : { scenario: mounts, point: mountPoint, files: mounted };
+  const files3 = new DummyFiles(files2, directories, pending, time, mount);
   const browser = new DummyBrowser(tabs, time);
   const agent = new DummyAgent(
     agents,