dsh-over-ssh 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-over-ssh",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "SSH remote development for DeepSeek Harness: connections (key/password/ProxyJump/ssh config), remote files without sync, remote terminal, remote workspaces, remote @-completion, upload/download.",
   "type": "module",
   "main": "lib/index.js",
@@ -56,12 +56,14 @@
     "typecheck:client": "tsc -p tsconfig.client.json --pretty false",
     "build:client": "node tools/build-client.mjs --check",
     "build:host": "node tools/build-host.mjs",
-    "build": "npm run build:host && npm run build:terminal-wrapper && npm run build:client && npm run build:types:client",
+    "build": "npm run build:host && npm run build:types && npm run build:terminal-wrapper && npm run build:client",
     "agents": "node tools/agent-manifest.mjs generate --from ../dsh-over-ssh-agent/dist --out agents/agent-manifest.json --copy-to agents --platforms linux-amd64,linux-arm64 --require-provenance",
     "build:types:client": "node ./node_modules/typescript/bin/tsc -p tsconfig.client.types.json --pretty false",
     "prepack": "npm run build && node tools/prepack-agents.mjs && node tools/release-note.mjs --check",
     "build:terminal-wrapper": "node tools/build-terminal-wrapper.mjs",
-    "release:note": "node tools/release-note.mjs"
+    "release:note": "node tools/release-note.mjs",
+    "build:types:host": "node ./node_modules/typescript/bin/tsc -p tsconfig.host.types.json",
+    "build:types": "node tools/clean-types.mjs && npm run build:types:host && npm run build:types:client && node tools/prune-types.mjs"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",

package/lib/types/src/client/controls.d.ts

@@ -1,131 +0,0 @@
-/**
- * The controls the three surfaces share, as plain `createElement` templates.
- *
- * **No hooks, on purpose.** `:hover`, `:active`, `:focus-visible` and `:disabled` come from the stylesheet in
- * [`styles.ts`](./styles.ts) via class names, because a component holding `useState` cannot be rendered by
- * this repository's tests: they call the section functions **directly**, outside any React render, where a
- * hook throws `Invalid hook call`. Classes keep the templates pure element trees — a test walks the returned
- * tree and reads the same `type` / `name` / `disabled` / `role` it always did — while the browser still gets
- * real interaction states.
- *
- * These are deliberately **not** the platform's `dsh-client-ui-primitives` atoms: those factories import
- * per-component CSS modules, which a third-party bundle cannot supply (the loader materialises only
- * registered factories), and the package is not a dependency of this repository. `styles.ts` carries the
- * tokens those atoms are built from.
- *
- * @module dsh-remote-workspace/client/controls
- */
-import { type ChangeEvent, type ReactNode } from 'react';
-/** The sizes a control may have. */
-export type ControlSize = 'normal' | 'compact';
-/** The visual weight of a button. */
-export type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'row' | 'chip';
-/** Props every control shares: extra classes from the caller. */
-export interface ControlClassProps {
-    /** Extra classes from the caller; appended after the vocabulary's own. */
-    readonly className?: string;
-}
-/**
- * The part of a keyboard event a card's Esc handler reads.
- *
- * Structural, so the pure templates need no DOM types and a test drives the handler with a plain object. It is
- * assignable from React's `KeyboardEvent` (which carries both members), and it is the whole reason a dialog
- * closes on Esc: the shell focuses into the card when it opens, so the event reaches the card's own handler.
- */
-export interface KeyEventLike {
-    /** The key name, e.g. `'Escape'`. */
-    readonly key?: string;
-    /** Stop the platform's own Esc handling from also firing while the dialog is up. */
-    stopPropagation?(): void;
-}
-/** True when the event is the Esc key. */
-export declare function isEscape(event: KeyEventLike): boolean;
-/**
- * One button.
- *
- * @param props - the button's own props plus the variants this plugin uses.
- * @returns the button element.
- */
-export declare function Button(props: ControlClassProps & {
-    readonly variant: ButtonVariant;
-    readonly size?: ControlSize;
-    readonly type?: 'button' | 'submit';
-    readonly disabled?: boolean;
-    readonly name?: string;
-    readonly title?: string;
-    readonly onClick?: () => void;
-    readonly children?: ReactNode;
-}): ReactNode;
-/** Props of a text input, narrowed to what the templates pass. */
-export interface TextInputProps extends ControlClassProps {
-    readonly id: string;
-    readonly name: string;
-    readonly value: string;
-    readonly disabled?: boolean;
-    readonly placeholder?: string;
-    readonly inputMode?: 'numeric';
-    /** `password` for a secret field: the browser masks it and no autofill offers to save it. */
-    readonly type?: 'text' | 'password';
-    readonly autoComplete?: 'off' | 'new-password';
-    readonly size?: ControlSize;
-    readonly onChange: (event: ChangeEvent<HTMLInputElement>) => void;
-}
-/**
- * One text input, with the platform's border, inset surface and focus ring.
- *
- * @param props - the input's own props.
- * @returns the input element.
- */
-export declare function TextInput(props: TextInputProps): ReactNode;
-/** One option of a {@link Select}. */
-export interface SelectOption {
-    readonly value: string;
-    readonly label: string;
-}
-/**
- * A `<select>` over a fixed list of options.
- *
- * @param props - id, name, the current value, the options and the change handler.
- * @returns the select element.
- */
-export declare function Select(props: ControlClassProps & {
-    readonly id: string;
-    readonly name: string;
-    readonly value: string;
-    readonly options: readonly SelectOption[];
-    readonly disabled?: boolean;
-    readonly size?: ControlSize;
-    readonly onChange: (value: string) => void;
-}): ReactNode;
-/**
- * A labelled field: the caption above its control, so the column and its label move together.
- *
- * @param props - the label text, the control's id and the control itself.
- * @returns the labelled column.
- */
-export declare function Field(props: {
-    readonly label: string;
-    readonly htmlFor: string;
-    readonly children: ReactNode;
-}): ReactNode;
-/**
- * An inline notice block: the surface for a refusal, a host warning or "no host data".
- *
- * @param props - `warn` for something the operator may need to act on, `info` for a neutral status.
- * @returns the notice element carrying the role its caller needs (`alert` / `note` / `status`).
- */
-export declare function Notice(props: {
-    readonly role: 'alert' | 'note' | 'status';
-    readonly tone?: 'warn' | 'info';
-    readonly children: ReactNode;
-}): ReactNode;
-/**
- * The status dot of a connection row, so the row's state is not carried by colour alone.
- *
- * @param props - the dot's accessible description.
- * @returns the dot element.
- */
-export declare function StatusDot(props: {
-    readonly label: string;
-}): ReactNode;
-//# sourceMappingURL=controls.d.ts.map

package/lib/types/src/client/core/card-focus-trap.d.ts

@@ -1,45 +0,0 @@
-/**
- * The **one** Tab trap every card in this plugin installs.
- *
- * Five surfaces are dialogs and every one of them has to keep Tab inside itself, for two different reasons:
- *
- *  - the settings-hosted cards sit **outside** the platform settings modal, whose own focus trap listens on
- *    `document` in the bubble phase and pulls focus back into its panel — a bubble-phase listener of ours would
- *    run after it (registration order) and could no longer tell which field Tab came from, so the trap has to
- *    be in the **capture** phase (audit 0090);
- *  - the overlay and composer cards are simply modals: Tab walking into the page behind them is a dialog the
- *    keyboard user leaves without dismissing.
- *
- * Both cases want the same mechanics, so they live here instead of being spelled out per surface (the two that
- * were first — the connection editor and the session-panel confirmation — each carried their own copy of the
- * same eight lines, and the two newer ones had none at all; audit 2026-10-31 `client.md` §2.3).
- *
- * The split is the same one the rest of `core/` uses: {@link installCardTabTrap} is pure and takes the document
- * as an argument (so an offline test drives it with a fake), and {@link useCardTabTrap} is the two-line React
- * binding.
- *
- * @module dsh-over-ssh/client/card-focus-trap
- */
-import { type PortalDocument } from './portal.ts';
-/**
- * Install the card's Tab trap on one document.
- *
- * Capture phase on purpose: see the module note. The listener is removed with the same `options` value, so a
- * runtime that keys listeners by phase cannot leak one.
- *
- * @param doc - the page's document, or `undefined` off-browser (where this is a no-op).
- * @param container - the card's body-level container; `undefined` while it is not attached.
- * @returns the remover; safe to call more than once.
- */
-export declare function installCardTabTrap(doc: PortalDocument | undefined, container: unknown): () => void;
-/**
- * Trap Tab while a card is open.
- *
- * `open` is the caller's own condition (`editingId !== undefined`, `pending !== undefined`, `request !==
- * undefined`); the container comes from that surface's portal. Nothing is installed while the card is closed, so
- * the settings panel keeps its own Tab behaviour the rest of the time.
- *
- * @param open - whether the card is up.
- * @param container - the card's container from its portal.
- */
-export declare function useCardTabTrap(open: boolean, container: unknown): void;

package/lib/types/src/client/core/controls.d.ts

@@ -1,164 +0,0 @@
-/**
- * The controls the three surfaces share, as plain `createElement` templates.
- *
- * **No hooks, on purpose.** `:hover`, `:active`, `:focus-visible` and `:disabled` come from the stylesheet in
- * [`styles.ts`](./styles.ts) via class names, because a component holding `useState` cannot be rendered by
- * this repository's tests: they call the section functions **directly**, outside any React render, where a
- * hook throws `Invalid hook call`. Classes keep the templates pure element trees — a test walks the returned
- * tree and reads the same `type` / `name` / `disabled` / `role` it always did — while the browser still gets
- * real interaction states.
- *
- * These are deliberately **not** the platform's `dsh-client-ui-primitives` atoms: those factories import
- * per-component CSS modules, which a third-party bundle cannot supply (the loader materialises only
- * registered factories), and the package is not a dependency of this repository. `styles.ts` carries the
- * tokens those atoms are built from.
- *
- * @module dsh-over-ssh/client/controls
- */
-import { type ChangeEvent, type ReactNode } from 'react';
-/** The sizes a control may have. */
-export type ControlSize = 'normal' | 'compact';
-/** The visual weight of a button. */
-export type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'row' | 'chip';
-/** Props every control shares: extra classes from the caller. */
-export interface ControlClassProps {
-    /** Extra classes from the caller; appended after the vocabulary's own. */
-    readonly className?: string;
-}
-/**
- * The part of a keyboard event a card's Esc handler reads.
- *
- * Structural, so the pure templates need no DOM types and a test drives the handler with a plain object. It is
- * assignable from React's `KeyboardEvent` (which carries both members), and it is the whole reason a dialog
- * closes on Esc: the shell focuses into the card when it opens, so the event reaches the card's own handler.
- */
-export interface KeyEventLike {
-    /** The key name, e.g. `'Escape'`. */
-    readonly key?: string;
-    /** Stop the platform's own Esc handling from also firing while the dialog is up. */
-    stopPropagation?(): void;
-}
-/** True when the event is the Esc key. */
-export declare function isEscape(event: KeyEventLike): boolean;
-/**
- * One button.
- *
- * @param props - the button's own props plus the variants this plugin uses.
- * @returns the button element.
- */
-export declare function Button(props: ControlClassProps & {
-    readonly variant: ButtonVariant;
-    readonly size?: ControlSize;
-    readonly type?: 'button' | 'submit';
-    readonly disabled?: boolean;
-    readonly name?: string;
-    readonly title?: string;
-    /** The name a screen reader reads instead of the visible text, when the text alone is not a name. */
-    readonly ariaLabel?: string;
-    /** For a control that opens something: whether it is open right now (`aria-expanded`). */
-    readonly ariaExpanded?: boolean;
-    /** What the control opens (`aria-haspopup`). */
-    readonly ariaHaspopup?: 'dialog' | 'menu';
-    readonly onClick?: () => void;
-    readonly children?: ReactNode;
-}): ReactNode;
-/** Props of a text input, narrowed to what the templates pass. */
-export interface TextInputProps extends ControlClassProps {
-    readonly id: string;
-    readonly name: string;
-    readonly value: string;
-    readonly disabled?: boolean;
-    readonly placeholder?: string;
-    readonly inputMode?: 'numeric';
-    /** `password` for a secret field: the browser masks it and no autofill offers to save it. */
-    readonly type?: 'text' | 'password';
-    readonly autoComplete?: 'off' | 'new-password';
-    readonly size?: ControlSize;
-    readonly onChange: (event: ChangeEvent<HTMLInputElement>) => void;
-}
-/**
- * One text input, with the platform's border, inset surface and focus ring.
- *
- * @param props - the input's own props.
- * @returns the input element.
- */
-export declare function TextInput(props: TextInputProps): ReactNode;
-/** One option of a {@link Select}. */
-export interface SelectOption {
-    readonly value: string;
-    readonly label: string;
-}
-/**
- * A `<select>` over a fixed list of options.
- *
- * @param props - id, name, the current value, the options and the change handler.
- * @returns the select element.
- */
-export declare function Select(props: ControlClassProps & {
-    readonly id: string;
-    readonly name: string;
-    readonly value: string;
-    readonly options: readonly SelectOption[];
-    readonly disabled?: boolean;
-    readonly size?: ControlSize;
-    readonly onChange: (value: string) => void;
-}): ReactNode;
-/**
- * A labelled field: the caption above its control, so the column and its label move together.
- *
- * @param props - the label text, the control's id and the control itself.
- * @returns the labelled column.
- */
-export declare function Field(props: {
-    readonly label: string;
-    readonly htmlFor: string;
-    readonly children: ReactNode;
-}): ReactNode;
-/**
- * An inline notice block: the surface for a refusal, a host warning or "no host data".
- *
- * Three tones, and the split is deliberate: **`warn` is the default** (something the operator may need to act
- * on), `info` is a neutral status, and `error` is a hard failure. Before this, a failed read and a soft
- * warning rendered identically — both `role: 'alert'` on the amber surface — so "the host refused" and
- * "the host is telling you something" looked the same. A failure is not a warning.
- *
- * @param props - the tone, the role, and the text.
- * @returns the notice element carrying the role its caller needs (`alert` / `note` / `status`).
- */
-export declare function Notice(props: {
-    readonly role: 'alert' | 'note' | 'status';
-    readonly tone?: 'warn' | 'info' | 'error';
-    readonly children: ReactNode;
-}): ReactNode;
-/**
- * A checkbox whose whole row is the hit target.
- *
- * The templates used to render a bare `<input type="checkbox">`: the stylesheet had **no rule for it at all**,
- * so it kept the browser's default size and accent colour, and — in the session inventory — it sat next to a
- * body that was not a `<label>`, so clicking the row's own text did nothing and the target was a 16px square.
- *
- * `id`/`name` are optional because the two call sites differ: the ssh-config list already pairs the box with a
- * separate `<label htmlFor>` naming the alias, while the session row wants the box and its body wrapped
- * together. Passing neither is allowed; passing `id` makes the input addressable by a sibling label.
- *
- * @param props - the box's identity, state and handler.
- * @returns the input element.
- */
-export declare function Checkbox(props: {
-    readonly checked: boolean;
-    readonly disabled?: boolean;
-    readonly id?: string;
-    readonly name?: string;
-    readonly onChange: () => void;
-    /** The accessible name, when no `<label>` wraps or names this box. */
-    readonly ariaLabel?: string;
-}): ReactNode;
-/**
- * The status dot of a connection row, so the row's state is not carried by colour alone.
- *
- * @param props - the dot's accessible description.
- * @returns the dot element.
- */
-export declare function StatusDot(props: {
-    readonly label: string;
-}): ReactNode;

package/lib/types/src/client/core/latest.d.ts

@@ -1,48 +0,0 @@
-/**
- * The "only the newest answer may land" gate.
- *
- * Why a module instead of a `let token = 0` in each caller: this repository's client tests **cannot render a
- * React component** (no `react-dom`, see [`portal.ts`](./portal.ts)), so a generation counter written inside a
- * component's `useCallback` is a decision no test can reach. Extracting it makes "a late answer is dropped"
- * something a test can hold on to, which is the same reason `actionQueryKey` / `rootsQueryKey` /
- * long-poll re-arms exist.
- *
- * The three call sites share one failure mode: two requests are in flight, the **older** one answers last, and
- * its answer overwrites the newer state. That is not a theoretical race here — every one of these surfaces has
- * a button that starts a second request while the first is still open (a refresh during an action, a re-read
- * after a scope change, a poll racing a manual refresh).
- *
- * ```text
- * const gate = createLatestOnly();
- * const mine = gate.begin();
- * const answer = await call();
- * if (!gate.isCurrent(mine)) return;   // a newer request owns the surface now
- * ```
- *
- * @module dsh-over-ssh/client/latest
- */
-/** A monotonic gate that admits only the most recently issued request. */
-export interface LatestOnly {
-    /**
-     * Issue a new request id.
-     *
-     * @returns the id this request must present when it answers.
-     */
-    begin(): number;
-    /**
-     * Whether an issued id is still the newest.
-     *
-     * @param token - the id `begin` returned to the request that is answering.
-     * @returns `true` only for the newest id; every earlier one is stale.
-     */
-    isCurrent(token: number): boolean;
-}
-/**
- * Build a gate.
- *
- * Ids start at 1, so `0` (a value a caller can get from an uninitialised variable) is never "current" by
- * accident.
- *
- * @returns the gate.
- */
-export declare function createLatestOnly(): LatestOnly;

package/lib/types/src/client/core/locale.d.ts

@@ -1,38 +0,0 @@
-/**
- * Client-half copy for the `over-ssh` namespace.
- *
- * Registration is the **typed** form of `ctx.locale.register`: the namespace is merged into
- * `LocaleNamespaceMap`, so a missing key in either shipped locale is a compile error, and the runtime
- * additionally requires both locales at registration (bilingual balance). Keeping the dictionaries in a
- * pure module is what makes them testable without a browser.
- *
- * @module dsh-over-ssh/client/locale
- */
-/** Namespace owned by this plugin's client half. */
-export declare const OVER_SSH_NS = "over-ssh";
-/**
- * Keys of this namespace.
- *
- * `LocaleNamespaceMap` maps a namespace to its **key union** (not to a value interface): the runtime then
- * derives `Record<Key, string>` per locale, which is exactly what makes a missing translation a compile
- * error.
- */
-export type OverSshKey = 'sectionTitle' | 'sectionDescription' | 'noHostData'
-/** The connection list's own heading / empty state / unknown-transport badge (audit ui P2-6, P2-7). */
- | 'connectionsHeading' | 'connectionsEmpty' | 'connectionsTransportUnknown' | 'close' | 'rootsTitle' | 'rootsDescription' | 'rootsAdvancedSummary' | 'rootsAdvancedNote' | 'rootsEmpty' | 'rootsPending' | 'rootsAuthPassword' | 'rootsPasswordLabel' | 'rootsTestConnection' | 'rootsTesting' | 'rootsTestOk' | 'sessionPanelTitle' | 'sessionPanelDescription' | 'sessionPanelUnavailable' | 'sessionPanelLoading' | 'sessionPanelLoadFailed' | 'sessionPanelSessionsEmpty' | 'sessionPanelSessions' | 'sessionPanelBin' | 'sessionPanelBinEmpty' | 'sessionPanelSelectAll' | 'sessionPanelClear' | 'sessionPanelDeleteRecycle' | 'sessionPanelDeletePermanent' | 'sessionPanelRestore' | 'sessionPanelPurge' | 'sessionPanelSweep' | 'sessionPanelRefresh' | 'sessionPanelClose' | 'sessionPanelLive' | 'sessionPanelSubsession' | 'sessionPanelUnreadable' | 'sessionPanelConfirmTitle' | 'sessionPanelConfirmBody' | 'sessionPanelConfirmPurgeBody' | 'sessionPanelConfirmCancel' | 'sessionPanelConfirmAccept' | 'sessionPanelDeleteWorkspace' | 'sessionPanelConfirmWorkspaceBody' | 'sessionPanelSubsessionsHidden' | 'sessionPanelTotals' | 'sessionPanelOpen' | 'sessionPanelLiveWarning' | 'sessionRowRecycle' | 'sessionRowDelete' | 'sessionRowRecycleBody' | 'sessionRowDeleteBody' | 'sessionRowConfirmRecycle' | 'sessionRowConfirmDelete' | 'sessionRowCancel' | 'sessionRowClose' | 'sessionRowLoading' | 'sessionRowBlockedRunning' | 'sessionRowBlockedSubsession' | 'sessionRowBlockedUnreadable' | 'sessionRowMissing' | 'sessionRowUnavailable' | 'rootsTestDegraded' | 'rootsTestFailed' | 'rootsAddConnection' | 'rootsRemove' | 'rootsSave' | 'rootsEdit' | 'rootsEditTitle' | 'rootsEditSave' | 'rootsEditCancel' | 'rootsEditPasswordHint' | 'rootsEditRenameHint' | 'rootsConfirmRemoveTitle' | 'rootsConfirmRemoveBody' | 'rootsConfirmRemoveAccept' | 'rootsConfirmRemoveCancel' | 'rootsConnection' | 'rootsConnectionPlaceholder' | 'rootsRemotePathLabel' | 'rootsIdLabel' | 'rootsHostLabel' | 'rootsUserLabel' | 'rootsAuthLabel' | 'rootsAuthKey' | 'rootsKeyPathLabel' | 'rootsPortLabel' | 'rootsBadgeLocal' | 'rootsBadgeRemote' | 'rootsErrorPathRequired' | 'rootsErrorRemotePath' | 'rootsErrorConnectionRequired' | 'rootsErrorLocalPath' | 'rootsErrorDuplicate' | 'rootsErrorIdRequired' | 'rootsErrorIdInvalid' | 'rootsErrorIdDuplicate' | 'rootsErrorHostRequired' | 'rootsErrorUserRequired' | 'rootsErrorPort' | 'rootsImportTitle' | 'rootsImportDescription' | 'rootsImportOpen' | 'rootsImportEmpty' | 'rootsImportRefresh' | 'rootsImportSelectAll' | 'rootsImportClear' | 'rootsImportAccept' | 'rootsImportCancel' | 'rootsImportBusy' | 'rootsImportDone' | 'rootsImportIdHint' | 'rootsImportSkippedTitle' | 'rootsImportSkipWildcard' | 'rootsImportSkipDuplicate' | 'rootsImportSkipTaken' | 'rootsImportSkipUnusableId' | 'rootsImportSkipNotImportable' | 'rootsImportSkipUnknown' | 'rootsImportHasKey' | 'rootsImportHasJump' | 'transferTitle' | 'transferDescription' | 'transferEmpty' | 'transferLoading' | 'transferRefresh' | 'transferClear' | 'transferFailedTitle' | 'transferDone' | 'transferCancelled' | 'transferUploadLabel' | 'transferDownloadLabel' | 'transferFailed' | 'transferFailedHttp' | 'transferFailedHost' | 'transferFailureLine' | 'transferErrorCodeUnknown' | 'remoteFilesHint' | 'rootsImportFailed' | 'rootsErrorKeyPathRequired' | 'rootsErrorPasswordRequired' | 'rootsNoticeUnavailable' | 'rootsNoticeWarnings' | 'rootsNoticeSavedConnection' | 'rootsNoticeSavedEdit' | 'flowTitle' | 'flowDescription' | 'flowLocalHeading' | 'flowLocalHint' | 'flowPickFailed' | 'flowRemoteHeading' | 'flowRemoteHint' | 'flowConfirmRemote' | 'flowCancel' | 'flowPending' | 'flowBusy' | 'flowNoConnections' | 'flowConnectionsLoading' | 'flowNoAnchor' | 'flowUnavailable' | 'browseHeading' | 'browseUp' | 'browseHome' | 'browseCurrent' | 'browseEmpty' | 'browseLoading' | 'browseRetry' | 'browseFailed' | 'browseUnavailable' | 'browseNeedConnection' | 'browseTruncated'
-/** The remote world's connection list: reading, and failed-with-reason (audit 2026-11-01b ui P2-4). */
- | 'browseConnectionsLoading' | 'browseConnectionsFailed' | 'browseKindFile' | 'browseKindSymlink' | 'browseKindOther' | 'browseLocalMode' | 'browsePickNative' | 'browseRemoteMode' | 'browseOpenLocal' | 'browseOpenRemote' | 'browseChoose' | 'sessionAddOpen' | 'sessionAddTitle' | 'sessionAddHint' | 'sessionAddWorkspace' | 'sessionAddWorkspaceUnknown' | 'sessionAddPick' | 'sessionBrowse' | 'sessionBrowseBack' | 'sessionRootsTitle' | 'sessionRootsEmpty'
-/** The session entry's card while it reads its directory list (the empty state must not be shown then). */
- | 'sessionRootsLoading' | 'sessionRootsHint' | 'sessionRootsFailed' | 'sessionAddDone' | 'sessionAddFailed' | 'sessionResultNoSelection' | 'sessionResultMissingCwd' | 'sessionResultMissingEntryId' | 'sessionResultHttpFailed' | 'sessionResultHostRefused' | 'sessionResultActionFailed' | 'sessionResultUnreachable' | 'sessionResultDeletedPermanent' | 'sessionResultDeleteNone' | 'sessionResultRecycled' | 'sessionResultWorkspaceEmpty' | 'sessionResultWorkspacePurged' | 'sessionResultWorkspacePurgedRefused' | 'sessionResultWorkspaceRecycled' | 'sessionResultWorkspaceRecycledRefused' | 'sessionResultRestored' | 'sessionResultPurged' | 'sessionResultSweepNone' | 'sessionResultSweepDone' | 'sessionWorkspaceUnknown' | 'connectionTestNoAnswer' | 'connectionTestFailed' | 'connectionTestRefused'
-/** The probe ran out of the client's own deadline (no host sentence exists for it). */
- | 'connectionTestTimeout' | 'transferSummaryRunning' | 'transferSummaryDone' | 'transferRemaining' | 'transferRemainingUnknown' | 'transferDurationUnknown' | 'rootsImportSummary' | 'rootsImportRefusedTitle' | 'rootsImportRefusedLine';
-/** Merge this plugin's namespace into the shared locale map, so `t('over-ssh.…')` is typed. */
-declare module '@deepseek-ai/dsh-client-ui-slots' {
-    interface LocaleNamespaceMap {
-        'over-ssh': OverSshKey;
-    }
-}
-/** Every shipped locale's dictionary. Both `zh` and `en` are required by the runtime. */
-export declare const OVER_SSH_DICTS: Record<'zh' | 'en', Record<OverSshKey, string>>;
-/** Dictionary keys, so a completeness test never has to restate them. */
-export declare function overSshKeys(): readonly OverSshKey[];

package/lib/types/src/client/core/message.d.ts

@@ -1,37 +0,0 @@
-/**
- * Deferred copy: a dictionary key plus its parameters, and the one resolver for it.
- *
- * Why this is `core/` and not `roots/`: three modules need the same two lines — the roots panel model, the
- * transfer panel and (since the audit) the session panel's result sentences — and two of them are **pure
- * models** that must not import React. `roots/roots-panel-state.ts` used to own the resolver, which meant every
- * pure model either imported a React-bearing module or (what actually happened) duplicated the six lines with a
- * comment apologising for the duplication (`core/panel-model.ts`). One implementation, no React.
- *
- * The contract a dictionary keeps: a **missing** key renders as the key itself. That is deliberate — a missing
- * translation must be visible in the UI, never silently blank (see `roots-panel-state.ts`'s original note).
- *
- * @module dsh-over-ssh/client/message
- */
-/** A message is a key plus its parameters; a component resolves it against the active dictionary. */
-export interface MessageKey {
-    /** The dictionary key (an entry of `OverSshKey` for this plugin's own copy). */
-    readonly key: string;
-    /** Values for the template's `{name}` placeholders. */
-    readonly params?: Readonly<Record<string, string | number>>;
-}
-/**
- * Substitute `{name}` placeholders in one template.
- *
- * @param template - the dictionary string.
- * @param params - the values to substitute; an absent value leaves the placeholder in place.
- * @returns the rendered text.
- */
-export declare function resolveTemplate(template: string, params: Readonly<Record<string, string | number>> | undefined): string;
-/**
- * Resolve one message against a dictionary.
- *
- * @param copy - the active locale's dictionary (a plain string map).
- * @param message - the key plus optional parameters.
- * @returns the rendered text, or `message.key` itself when the dictionary has no such key.
- */
-export declare function resolveMessage(copy: Readonly<Record<string, string>>, message: MessageKey): string;

package/lib/types/src/client/core/panel-model.d.ts

@@ -1,134 +0,0 @@
-/**
- * The settings panel's pure logic and copy wiring.
- *
- * Two rules that keep a client component testable without a browser:
- *
- *  - **no `ctx` in components** (the platform contract): everything a component shows arrives through props;
- *  - consequently all decision-making lives here, where Node can run it. The component is a template.
- *
- * The host data channel arrives as **untrusted wire data** (`unknown`), so the conversion below whitelists
- * fields one by one: a leaked `keyPath` / `password` / `credentialKey` cannot reach the panel even if the host
- * ever started sending one. That is the client half's half of the "no credentials over the channel" rule the
- * host face also enforces.
- *
- * @module dsh-over-ssh/client/panel-model
- */
-import type { OverSshKey } from './locale.ts';
-/**
- * Transports a connection row can name; `unknown` means "the host did not say".
- *
- * Declared once, in the roots model the wire parser lives in, and re-exported here so both halves of the panel
- * vocabulary agree (a second identical union is how `unknown` ended up rendered as a raw English word).
- */
-/**
- * How a connection reaches the host: `alias`/`ssh2` are Tier 1 (no agent), `agent` is Tier 2, `unknown` is
- * "the host did not say".
- *
- * Defined **here**, in `core`, and re-exported by `roots/roots-panel.ts`, not the other way round: the
- * dependency rule for this half is `core → roots → session → flows → entry`, and importing it from `roots`
- * was a reverse edge that `tests/architecture.test.ts` caught (the panel model is what a caller without the
- * editor imports, so it must not reach into a feature folder for a type it owns).
- */
-export type ConnectionTransport = 'alias' | 'ssh2' | 'agent' | 'unknown';
-/** One connection line: what the user needs to know about a single saved connection. */
-export interface ConnectionRow {
-    /** Connection id (the profile key the user sees in `ssh://` paths). */
-    readonly id: string;
-    /** Host name as configured. */
-    readonly host: string;
-    /** Transport currently in force, or `unknown` before the first connection. */
-    readonly transport: ConnectionTransport;
-    /** Whether the current transport is a degraded substitute. */
-    readonly degraded: boolean;
-    /** Why: the degradation reason, else the decision's explanation, else "not connected yet". */
-    readonly note: string;
-    /**
-     * The row's badge text, already localized by whoever built the row.
-     *
-     * The template used to render {@link ConnectionRow.transport} raw, so every row carried a badge reading the
-     * English wire word `unknown` in the Chinese UI as well. `alias`/`ssh2`/`agent` are protocol names and stay as
-     * they are; only the "the host did not say" case needs a word, and it now arrives from the dictionary
-     * (audit 2026-11-01b ui P2-6).
-     */
-    readonly transportLabel?: string;
-    /**
-     * The 「测试」 button's state for this row, already localized; absent when the panel has no tester.
-     *
-     * The template stays copy-free (`panel.ts` renders text it is handed), and the strings are rebuilt on every
-     * re-registration, so a locale change re-renders them without any subscription here.
-     */
-    readonly test?: {
-        readonly status: 'idle' | 'running' | 'ok' | 'failed';
-        /** Button label: 「测试」, or 「测试中…」 while the probe runs. */
-        readonly label: string;
-        /** Result line; empty while running. */
-        readonly detail: string;
-    };
-    /**
-     * The row's own edit/delete labels, already localized; absent when the panel has no editor.
-     *
-     * Localized here rather than in the component for the same reason as {@link ConnectionRow.test}: the
-     * template renders strings it is handed and never looks up copy itself.
-     */
-    readonly actions?: {
-        readonly editLabel: string;
-        readonly removeLabel: string;
-    };
-}
-/** What the panel renders. */
-export interface PanelModel {
-    readonly title: string;
-    readonly description: string;
-    /** One line per connection; empty either before the host answered or when no connection is configured. */
-    readonly connections: readonly ConnectionRow[];
-    /** Heading of the connection list (it had none: the rows started right under the description). */
-    readonly connectionsHeading: string;
-    /** What an answered-but-empty list says (it used to render nothing at all). */
-    readonly connectionsEmpty: string;
-    /**
-     * Notice about the missing host data channel; empty once the host answered. An answered-but-empty list
-     * clears it too — "you configured no connection" and "the channel is not wired" are different facts, and
-     * the panel must not claim the second one when the first is true.
-     */
-    readonly notice: string;
-    readonly closeLabel: string;
-    /**
-     * The confirmation card's text for deleting one connection, or absent when the panel cannot delete.
-     *
-     * A function of the row because the sentence names the connection **and** how many remote roots go with it
-     * -  the fact that makes the confirmation necessary at all.
-     */
-    readonly confirmRemove?: {
-        readonly title: string;
-        readonly cancelLabel: string;
-        readonly acceptLabel: string;
-        readonly body: (row: ConnectionRow, remoteRoots: number) => string;
-    };
-}
-/**
- * Convert the host's connection status payload into panel rows.
- *
- * Every field is read individually and type-checked; unknown fields (including any credential the host might
- * ever add) are dropped rather than forwarded. A row without a usable `id` and `host` is skipped: an
- * unidentifiable line is worse than a missing one.
- *
- * @param value - the remote call's value, exactly as it arrived over the wire.
- * @returns the rows the panel may render, in the host's order.
- */
-export declare function toConnectionRows(value: unknown): readonly ConnectionRow[];
-/**
- * Build the panel model from one locale's dictionary.
- *
- * @param copy - the dictionary the caller resolved (`zh` or `en`, chosen by the locale runtime).
- * @param options - `rows` are the connection lines the host channel produced; **omitted** means the channel
- *   never answered, which is the only case that shows the notice.
- * @returns everything the component needs, with no further lookups.
- */
-export declare function buildPanelModel(copy: Record<OverSshKey, string>, options?: {
-    readonly rows?: readonly ConnectionRow[];
-    /**
-     * Whether the panel has an editor behind it. When true, rows carry their edit/delete labels and the model
-     * carries the removal confirmation; when false (the default) the page is read-only.
-     */
-    readonly editable?: boolean;
-}): PanelModel;