@4fu/dsh-arbor-ui 0.0.0-stage → 2026.1110.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 4fuu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,250 @@
-# Temporary Holding Version
+# dsh-arbor
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Run [arbor](https://github.com/4fuu/arbor) as the agent driver inside
+[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH).
+
+DSH gives a user a session, a transcript, approvals, plugins, skills and a model
+picker. arbor gives an agent disposable context windows over one shared journal,
+note store and workspace, instead of one long conversation. dsh-arbor connects
+them: one arbor host runs inside the DSH process, each DSH session that selects
+**Arbor** is served by that host, and the window's reply is written back to the
+DSH session as an ordinary assistant message. A DSH session that does not select
+Arbor keeps running on DSH's own embedded AgentLoop, in the same process.
+
+> **Status.** This is a research-grade integration, not a DSH release. It is
+> pinned to one DSH version and relies on DSH internals. Read
+> [Versions and compatibility](docs/versions.md) before installing it on
+> anything you care about. The packages are published under `@4fu` at
+> `2026.1110.1`; the bundle and the font plugin install independently from npm.
+
+## What an arbor session changes
+
+Choosing **Arbor** in a DSH composer creates the session under the `arbor` agent
+preset. That session then runs on arbor, and the following are true for it:
+
+- **One window per turn, one chain per session.** A DSH session is one arbor
+  conversation: its first turn opens a window, a window that ends hands off to a
+  continuation, and the next turn drives the chain. The journal and note store
+  live under `$DSH_HOME/arbor/` and survive a restart.
+- **arbor's workspace, not DSH's sandbox.** A window works in arbor's shared
+  folder (`$DSH_HOME/arbor/shared`). When the `ovnfs` binary is available a
+  window opens a copy-on-write checkout and merges back with `apply`; otherwise
+  arbor uses a plain directory. **There is no DSH sandbox for an arbor session:**
+  arbor's file tools and commands run on the host, and arbor's own secret scrub
+  is the only protection on what reaches the model.
+- **arbor's projects.** The shared folder's project folders are the DSH project
+  list for arbor composers. A directory the user adds outside the shared folder
+  is recorded as an external pointer for that session and used in place.
+- **arbor's prompt and tools.** DSH's official prompt sections are decided one by
+  one; the ones arbor replaces are absent, third-party sections go into a
+  `<dsh>` data block, and a trusted `<harness>` section says what remains true of
+  DSH. DSH tools are offered to the model as arbor external tools, and arbor's
+  own tools replace DSH tools with the same capability.
+- **The Arbor page.** A permanent **Arbor** entry in DSH's left navigation opens
+  the whole-host overview and one tab per arbor session: windows, chains,
+  handoffs, projects, the board, notes, `/env`, schedules and arbor's search.
+  An arbor composer hides DSH's sandbox access-mode switch, because that switch
+  does not apply to it.
+
+## What stays untouched in ordinary DSH sessions
+
+A session that does not select Arbor is an ordinary DSH session. It keeps:
+
+- DSH's embedded AgentLoop, session format, turn boundaries and streaming path;
+- DSH's sandbox policy and its `ctx.fs` / `ctx.shell` file and command tools;
+- DSH's project management, working directory and prompt assembly;
+- its composer, sandbox access-mode switch, header and sidebar behavior.
+
+It gets **no Arbor tab** and no arbor windows. The only shared surface is the
+permanent Arbor entry in the left navigation, which simply does not list that
+session. The routing registry replaces DSH's base `agent` row so it can send
+`agentPreset: 'arbor'` sessions to arbor; every other session goes to the
+official loop. Approvals still use DSH's approval path for both kinds of
+session, and arbor's windows are registered so DSH's sidebar leaves them out.
+
+## Screenshots
+
+| Overview, light | Overview, dark |
+| --- | --- |
+| ![Arbor overview in light mode](docs/screenshots/overview-light.png) | ![Arbor overview in dark mode](docs/screenshots/overview-dark.png) |
+| **Session tab, light** | **Session tab, dark** |
+| ![An arbor session tab in light mode](docs/screenshots/session-light.png) | ![An arbor session tab in dark mode](docs/screenshots/session-dark.png) |
+
+These are the web profile at 1440 px wide with the optional
+[font plugin](https://github.com/4fuu/dsh-arbor-fonts) installed: ChillDIN
+Gothic for labels and ChillDIN for numerals, while body text and code keep
+DSH's fonts. The same overview without the plugin is
+[here](docs/screenshots/overview-without-fonts.png).
+
+## Install
+
+Requirements: Node.js 24.9 or newer and DeepSeek Harness `dsh-v0.2.2-rc.1`.
+The bundle is published with all packages it depends on; nothing has to be
+built or linked.
+
+```bash
+npm install -g @deepseek-ai/dsh@0.2.2-rc.1
+dsh plugin --profile web add @4fu/dsh-arbor-bundle@2026.1110.1
+dsh web
+```
+
+`dsh plugin` adds the bundle to the profile's `dsh.profile.bundles` and installs
+its packages into the profile. The packages declare DSH's runtime packages as
+peer dependencies, so the profile keeps DSH's own copies rather than installing
+a second set. Pick **Arbor** in a composer and send a message.
+The optional [font plugin](https://github.com/4fuu/dsh-arbor-fonts) installs the
+same way, but it is a Host row rather than a bundle. Add the row to the
+profile's `cordis.patch.yml` after installing it:
+
+```bash
+dsh plugin --profile web add @4fu/dsh-arbor-fonts@2026.1110.0
+```
+
+```yaml
+- insert:
+    - id: arbor-fonts
+      name: '@4fu/dsh-arbor-fonts'
+```
+
+Replace the default `[]` in that file with the entry, then restart the profile.
+
+### From a checkout
+
+The proofs and development use the TypeScript sources directly; that checkout is
+what the scripts and the pin check run against.
+
+```bash
+git clone https://github.com/4fuu/dsh-arbor
+cd dsh-arbor
+pnpm install --frozen-lockfile
+pnpm check                 # tsc --noEmit over every package and proof
+pnpm proofs                # 29 proofs against the scripted model
+```
+
+The first install may ask pnpm to approve dependency build scripts. Do not
+approve them by hand: the repository's `pnpm-workspace.yaml` already denies the
+six scripts it pulls in, each with the reason, and `pnpm install` finishes
+cleanly with that policy.
+
+### Hand the install to a model
+
+[docs/install-for-agents.md](docs/install-for-agents.md) is a step-by-step guide
+written for an AI agent: install from npm or a checkout, run the proofs, drive a
+live turn with a restart, boot the web profile, and inspect what ran. Give a
+model this prompt, editing the bracketed parts or dropping them:
+
+```text copy Copy Install Prompt
+Install dsh-arbor (https://github.com/4fuu/dsh-arbor) in this environment [in a
+scratch DSH home under /tmp] and show me that it works: follow
+docs/install-for-agents.md, install @4fu/dsh-arbor-bundle@2026.1110.1 into a DSH
+web profile, pick Arbor for one session, and [also run the proof suite from a
+checkout with pnpm install --frozen-lockfile, pnpm check and pnpm proofs]. Report
+which checks passed, what the live session answered, and anything that did not
+work. Fix only what is yours to fix and tell me what you changed.
+```
+
+## Use it in DSH
+
+The npm install above adds the bundle to a DSH web profile. Pick **Arbor** in a
+composer and send a message: the session is created under the preset, its window
+and chain appear under the **Arbor** entry, and an ordinary session started
+beside it keeps DSH's own composer and sandbox behavior. A checkout can also be
+wired by hand; [section 7 of the install guide](docs/install-for-agents.md#7-wiring-the-bundle-into-a-real-dsh-installation)
+shows the profile layout.
+
+The one-shot `dsh <task>` runner cannot drive an arbor-preset session: DSH's
+runner refuses to adopt a session that runs under a preset. Use the web client,
+the SDK path the proofs use, or a remote `agent-preset/select` on a blank.
+
+## Pinned DSH version
+
+DSH is pinned to **`dsh-v0.2.2-rc.1`** (npm
+`@deepseek-ai/dsh@0.2.2-rc.1`, commit `66491b05e3` of
+`deepseek-ai/deepseek-harness`). Every `@deepseek-ai/dsh*` dependency is an
+exact version, every package under `packages/` declares
+`engines.dsh: 0.2.2-rc.1`, and `pnpm check:pin` checks both plus the prompt
+bridge's `DSH_PINNED_VERSION`. DSH's runtime packages are peer dependencies, and
+`pnpm check:profile` installs the packed packages into a fresh DSH web profile to
+prove the profile keeps one copy and can create both kinds of session.
+
+A different DSH version is unsupported. The bundle depends on DSH's row names,
+its one-`AgentFactory` rule, its prompt-section registry, its client slot
+registration and its exact Fetch registry; a move in any of them can fail the
+boot, leave an official prompt section undecided, or stop the Arbor page from
+registering. `proofs/12-official-sections.ts` and `proofs/18-picker-pin.ts`
+are the behavioral checks. The canonical pin and the upgrade procedure are in
+[Versions and compatibility](docs/versions.md).
+
+## Optional: the font plugin
+
+[dsh-arbor-fonts](https://github.com/4fuu/dsh-arbor-fonts) is a separate DSH
+client plugin that changes only the typography of the Arbor page. It sets
+ChillDIN Gothic for display labels and ChillDIN for numerals, leaves body text
+and code on DSH's fonts, and does nothing on ordinary pages. It is optional and
+installs into the same DSH profile:
+
+```bash
+dsh plugin --profile web add @4fu/dsh-arbor-fonts@2026.1110.0
+```
+
+The fonts are licensed under the SIL Open Font License 1.1; the plugin ships the
+license text, per-file hashes and attribution. The plugin is a Host row rather
+than a bundle: after installing it, add the `arbor-fonts` entry described under
+[Install](#install) to `cordis.patch.yml` and restart the profile.
+
+## Limits worth knowing
+
+- The judge is off: a model-based judge cannot run through the DSH backend yet.
+- The 12 bundle packages are published together at one version; install and
+  upgrade the bundle as a unit, because its packages name each other exactly.
+- `ovnfs` is optional. Without it arbor uses the plain-directory workspace, and a
+  window no longer gets a copy-on-write checkout.
+- The web page's numbers and layout are read from arbor's journal and API; it is
+  not a generic DSH dashboard, and it deliberately shows only arbor sessions.
+- The prompt bridge, the UI and the picker filter are pinned to DSH's internals,
+  not to a stable public API. See [Versions and compatibility](docs/versions.md).
+
+## Documentation
+
+- [Installing and inspecting dsh-arbor](docs/install-for-agents.md) — the
+  agent-facing install, proof, live-turn, web-profile and wiring guide.
+- [Versions and compatibility](docs/versions.md) — the DSH and arbor pins, and
+  what breaks on another DSH version.
+- [B0 findings](docs/b0-findings.md), [B3 findings](docs/b3-findings.md) and
+  [B3b projects and sandbox](docs/b3b-projects-and-sandbox.md) — historical
+  records of the integration's decisions, with the DSH source locations each
+  one rests on. They describe earlier stages; the install guide is the current
+  status.
+- [Layout and proofs](#layout) below for a quick map of the packages.
+
+## Layout
+
+```text
+packages/
+  arbor-host/       one Arbor host per process: SQLite journal and notes,
+                    settings, window lifecycle, workspace and environment
+  arbor-driver/     the routing AgentRegistry, AgentFactory, session agent,
+                    inbox and stream mirrors, and the journal relay
+  arbor-llm/        the arbor AgentBackend over DSH's ctx.llm and ctx.tools
+  arbor-prompt/     <harness>, the <dsh> data block, and the section table
+  arbor-tools/      DSH tools as arbor external tools, same-name replacement
+  arbor-workspace/  arbor's workspace over the shared folder (ovnfs or dir)
+  arbor-env/        /env, with DSH's skills and MCP servers mounted read-only
+  arbor-bundle/     the installable patch that mounts the rows and UI
+  arbor-facts/      the read face behind the Arbor page and its Fetch routes
+  arbor-ui/         the Arbor page, session tabs, copy and composer gate
+  arbor-ui-workspace/
+                    the per-preset hero project picker
+  arbor-preset/     the agent-preset row that puts Arbor in the roster
+  arbor-testkit/    the boot harness, memory journal and scripted model
+patches/            overlay layers a proof applies above the shipped profile
+proofs/             one runnable proof per integration point
+docs/               install, versions, screenshots and historical findings
+scripts/            the pin and profile checks, the release build and packing
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE). The optional font plugin vendors fonts under the
+SIL Open Font License 1.1; its repository carries the license text and
+attribution.

package/channel.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The browser half of arbor's facts channels.
+ *
+ * The host serves NDJSON streams on DSH's exact Fetch routes: one per session
+ * (`/api/arbor/facts?sessionId=…`) and one for the whole host
+ * (`/api/arbor/host`), both registered by `@4fu/dsh-arbor-facts`. This module
+ * owns one stream per scope for as long as a component holds it, folds the
+ * frames into the snapshot React reads, and reconnects with a bounded backoff
+ * when the page's carrier drops one.
+ *
+ * A frame is either the facts (the initial read and every rebuild) or one live
+ * delta from `Arbor.stream(window, …)`. The deltas are folded per window into
+ * a short buffer; the facts are kept as they arrived, because they are arbor's
+ * own values and nothing here recomputes them.
+ */
+import type { ArborFacts, ArborHostFacts } from '@4fu/dsh-arbor-facts/types';
+/** Where one channel stands right now. */
+export type ArborChannelStatus = 'connecting' | 'live' | 'error';
+/** What one live window has written recently. */
+export interface ArborWindowStream {
+    /** The model's assistant text, newest at the end. */
+    readonly text: string;
+    /** The `send` call's arguments while it is being written, when parsable. */
+    readonly send: string;
+    /** A live delta arrived in the last moment. */
+    readonly streaming: boolean;
+}
+/** The immutable snapshot a component subscribes to. */
+export interface FactsSnapshot<F> {
+    readonly status: ArborChannelStatus;
+    readonly facts?: F;
+    readonly error?: string;
+    /** The live buffers, keyed by arbor window ref. */
+    readonly streams: Readonly<Record<string, ArborWindowStream>>;
+    /** A live window wrote something within the activity window. */
+    readonly streaming: boolean;
+}
+/** One scope's live stream, usable by any number of components. */
+export declare class FactsChannel<F extends ArborFacts | ArborHostFacts> {
+    private readonly url;
+    private readonly listeners;
+    private snapshot;
+    private controller;
+    private retry;
+    private retryDelay;
+    private activity;
+    private holds;
+    private stopped;
+    constructor(url: string);
+    /** The current snapshot; the same reference until something changed. */
+    readonly getSnapshot: () => FactsSnapshot<F>;
+    /** Subscribe one React store listener. */
+    readonly subscribe: (listener: () => void) => (() => void);
+    /** Take one hold on the stream; the first starts it. */
+    retain(): void;
+    /** Release one hold; the last stops the stream. */
+    release(): void;
+    /** Stop this channel for good, whoever still holds it. */
+    close(): void;
+    /** Open the stream and read it until the page's carrier drops it. */
+    private connect;
+    /** Read one response's NDJSON body, one frame at a time. */
+    private read;
+    /** Fold one frame into the snapshot. */
+    private handle;
+    /** Fold one live window delta into its own buffer. */
+    private stream;
+    /** Publish one snapshot and wake React. */
+    private set;
+}
+/** The channel for one session, created on first use. */
+export declare function channelFor(sessionId: string): FactsChannel<ArborFacts>;
+/** The whole-host channel, created on first use. */
+export declare function hostChannel(): FactsChannel<ArborHostFacts>;
+/** Stop every channel this page holds; called when the plugin unloads. */
+export declare function closeChannels(): void;

package/channel.js

@@ -0,0 +1,230 @@
+/// <reference lib="dom" />
+/**
+ * The browser half of arbor's facts channels.
+ *
+ * The host serves NDJSON streams on DSH's exact Fetch routes: one per session
+ * (`/api/arbor/facts?sessionId=…`) and one for the whole host
+ * (`/api/arbor/host`), both registered by `@4fu/dsh-arbor-facts`. This module
+ * owns one stream per scope for as long as a component holds it, folds the
+ * frames into the snapshot React reads, and reconnects with a bounded backoff
+ * when the page's carrier drops one.
+ *
+ * A frame is either the facts (the initial read and every rebuild) or one live
+ * delta from `Arbor.stream(window, …)`. The deltas are folded per window into
+ * a short buffer; the facts are kept as they arrived, because they are arbor's
+ * own values and nothing here recomputes them.
+ */
+/** How much assistant text one window's buffer keeps. */
+const TEXT_LIMIT = 6_000;
+/** How much of a `send` draft one window's buffer keeps. */
+const SEND_LIMIT = 1_500;
+/** How long a frame keeps the "streaming" mark after it arrives. */
+const ACTIVITY_MS = 1_600;
+/** The first reconnect delay, doubled to the cap. */
+const RETRY_BASE_MS = 800;
+/** The longest a reconnect waits. */
+const RETRY_MAX_MS = 5_000;
+/** Read the `content` a `send` call is composing out of its partial JSON. */
+function sendContentOf(raw) {
+    // The arguments arrive as the characters the model has written so far, so
+    // they are not valid JSON until the call closes. The text field is quoted,
+    // so its opening quote is the one thing that is there early enough to read.
+    const match = /"content"\s*:\s*"((?:[^"\\]|\\.)*)/.exec(raw);
+    if (match === null)
+        return undefined;
+    const body = match[1] ?? '';
+    return body
+        .replace(/\\n/g, '\n')
+        .replace(/\\t/g, '\t')
+        .replace(/\\"/g, '"')
+        .replace(/\\\\/g, '\\');
+}
+/** Keep the last `limit` characters of a buffer. */
+function tail(text, limit) {
+    return text.length <= limit ? text : text.slice(text.length - limit);
+}
+/** One scope's live stream, usable by any number of components. */
+export class FactsChannel {
+    url;
+    listeners = new Set();
+    snapshot = { status: 'connecting', streams: {}, streaming: false };
+    controller;
+    retry;
+    retryDelay = RETRY_BASE_MS;
+    activity;
+    holds = 0;
+    stopped = true;
+    constructor(url) {
+        this.url = url;
+    }
+    /** The current snapshot; the same reference until something changed. */
+    getSnapshot = () => this.snapshot;
+    /** Subscribe one React store listener. */
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    };
+    /** Take one hold on the stream; the first starts it. */
+    retain() {
+        this.holds += 1;
+        if (this.holds !== 1)
+            return;
+        this.stopped = false;
+        void this.connect();
+    }
+    /** Release one hold; the last stops the stream. */
+    release() {
+        this.holds -= 1;
+        if (this.holds > 0)
+            return;
+        this.close();
+    }
+    /** Stop this channel for good, whoever still holds it. */
+    close() {
+        this.stopped = true;
+        this.holds = 0;
+        this.controller?.abort();
+        this.controller = undefined;
+        if (this.retry !== undefined)
+            clearTimeout(this.retry);
+        this.retry = undefined;
+        if (this.activity !== undefined)
+            clearTimeout(this.activity);
+        this.activity = undefined;
+    }
+    /** Open the stream and read it until the page's carrier drops it. */
+    async connect() {
+        if (this.stopped)
+            return;
+        this.set({ ...this.snapshot, status: this.snapshot.facts === undefined ? 'connecting' : 'live' });
+        const controller = new AbortController();
+        this.controller = controller;
+        try {
+            const response = await fetch(this.url, {
+                signal: controller.signal,
+                headers: { accept: 'application/x-ndjson' },
+                cache: 'no-store',
+            });
+            if (!response.ok)
+                throw new Error(`facts stream answered ${response.status}`);
+            if (response.body === null)
+                throw new Error('facts stream has no body');
+            this.retryDelay = RETRY_BASE_MS;
+            this.set({ ...this.snapshot, status: 'live', error: undefined });
+            await this.read(response.body, controller.signal);
+            if (controller.signal.aborted)
+                return;
+            throw new Error('facts stream ended');
+        }
+        catch (error) {
+            if (controller.signal.aborted || this.stopped)
+                return;
+            this.set({
+                ...this.snapshot,
+                status: this.snapshot.facts === undefined ? 'error' : 'live',
+                error: error instanceof Error ? error.message : String(error),
+            });
+            this.retry = setTimeout(() => {
+                this.retry = undefined;
+                void this.connect();
+            }, this.retryDelay);
+            this.retryDelay = Math.min(this.retryDelay * 2, RETRY_MAX_MS);
+        }
+    }
+    /** Read one response's NDJSON body, one frame at a time. */
+    async read(body, signal) {
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        for (;;) {
+            const { value, done } = await reader.read();
+            if (signal.aborted) {
+                await reader.cancel().catch(() => undefined);
+                return;
+            }
+            if (done)
+                return;
+            buffer += decoder.decode(value, { stream: true });
+            for (;;) {
+                const newline = buffer.indexOf('\n');
+                if (newline < 0)
+                    break;
+                const line = buffer.slice(0, newline).trim();
+                buffer = buffer.slice(newline + 1);
+                if (line !== '')
+                    this.handle(JSON.parse(line));
+            }
+        }
+    }
+    /** Fold one frame into the snapshot. */
+    handle(frame) {
+        if (frame.type === 'facts') {
+            this.set({ ...this.snapshot, status: 'live', facts: frame.facts, error: undefined });
+            return;
+        }
+        if (frame.type === 'error') {
+            this.set({ ...this.snapshot, error: frame.message });
+            return;
+        }
+        this.stream(frame.window, frame.event);
+    }
+    /** Fold one live window delta into its own buffer. */
+    stream(window, event) {
+        const before = this.snapshot.streams[window] ?? { text: '', send: '', streaming: false };
+        let next = before;
+        if (event.kind === 'text_delta') {
+            next = { ...before, text: tail(before.text + event.delta, TEXT_LIMIT) };
+        }
+        else {
+            const content = sendContentOf(event.args);
+            if (event.name === 'send' && content !== undefined) {
+                next = { ...before, send: tail(content, SEND_LIMIT) };
+            }
+        }
+        const streams = { ...this.snapshot.streams, [window]: { ...next, streaming: true } };
+        this.set({ ...this.snapshot, streams, streaming: true });
+        if (this.activity !== undefined)
+            clearTimeout(this.activity);
+        this.activity = setTimeout(() => {
+            this.activity = undefined;
+            const cleared = {};
+            for (const [ref, view] of Object.entries(this.snapshot.streams))
+                cleared[ref] = { ...view, streaming: false };
+            this.set({ ...this.snapshot, streams: cleared, streaming: false });
+        }, ACTIVITY_MS);
+    }
+    /** Publish one snapshot and wake React. */
+    set(snapshot) {
+        this.snapshot = snapshot;
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+/** The channels one page holds, by scope, while a component holds them. */
+const channels = new Map();
+/** The channel for one session, created on first use. */
+export function channelFor(sessionId) {
+    const key = `session:${sessionId}`;
+    let channel = channels.get(key);
+    if (channel === undefined) {
+        channel = new FactsChannel(`/api/arbor/facts?sessionId=${encodeURIComponent(sessionId)}`);
+        channels.set(key, channel);
+    }
+    return channel;
+}
+/** The whole-host channel, created on first use. */
+export function hostChannel() {
+    const key = 'host';
+    let channel = channels.get(key);
+    if (channel === undefined) {
+        channel = new FactsChannel('/api/arbor/host');
+        channels.set(key, channel);
+    }
+    return channel;
+}
+/** Stop every channel this page holds; called when the plugin unloads. */
+export function closeChannels() {
+    for (const channel of channels.values())
+        channel.close();
+    channels.clear();
+}