dsh-over-ssh 0.1.0 → 0.1.1

package/lib/types/src/client/session/session-remote-mark.d.ts

@@ -1,110 +0,0 @@
-/**
- * The sidebar's **remote-session mark**: the small globe in front of a session row whose cwd is one of this
- * plugin's anchor directories.
- *
- * Why this exists at all: the shell gives a remote workspace **no** way to look different. `dsh-client-ui-workspace`
- * renders workspace rows with the fixed `IconFolderOpenRegular`/`IconFolderCloseRegular` primitives and declares
- * no workspace-row slot, so a workspace opened on `<home>/.dsh/over-ssh/roots/<connection>/<digest>/<leaf>`
- * (a real, empty local directory that the router maps to the remote root) is visually identical to
- * `D:\project\anything`. The only seat the shell offers is the leading 16px cell of a **session** row,
- * `sidebar.session.row.leading`, and per the platform's own contract that cell is mounted **only while the
- * row's primary state is idle** — a running, unread or archived row shows its status dot (or nothing) there
- * instead. The mark is therefore a hint, not an identification: it can be absent for a remote session that is
- * busy. Documented rather than worked around; DOM surgery on the workspace row (what
- * `@zhangfengshun/dsh-remote-ssh` does for its own workspaces) is not worth the fragility here.
- *
- * No React state and no hooks: the occupant receives a synchronous predicate through its registration's
- * `inject` face, so this module stays a pure template that the offline renderer can serialize.
- *
- * @module dsh-over-ssh/client/session-remote-mark
- */
-import { type ReactNode } from 'react';
-/**
- * The owner share of the seat, quoted from the platform (`SessionRowScheduleOwnerProps` in
- * `@deepseek-ai/dsh-client-ui-workspace/client`, `packages/client/ui-workspace/src/client/contract/slots.ts`).
- *
- * Mirrored instead of imported, exactly like the directory-flow holes in
- * `flows/workspace-directory-flow.ts`: that package is not a dependency of this repository (its types live in
- * the DSH checkout), and the merge below has to compile here.
- */
-export interface SessionRowLeadingOwnerProps {
-    /** Session this row shows; the occupant addresses its own data by this id. */
-    sessionId: string;
-}
-declare module '@deepseek-ai/dsh-client-ui-slots' {
-    interface SlotMap {
-        /**
-         * Leading decoration of one Session row: the 16px cell before the title.
-         *
-         * Declared here because this repository does not depend on `@deepseek-ai/dsh-client-ui-workspace`, whose
-         * declaration would otherwise bring it in — the same reason the two directory-flow holes are declared by
-         * the flow module itself. The contract (list slot, root scope, idle-only, one owner prop) is the
-         * platform's; see the module doc for what that means for the mark's visibility.
-         */
-        'sidebar.session.row.leading': {
-            kind: 'list';
-            scope: 'root';
-            owner: SessionRowLeadingOwnerProps;
-        };
-    }
-}
-/** The seat this plugin occupies: one decoration cell in front of a session row's title. */
-export declare const REMOTE_MARK_SLOT = "sidebar.session.row.leading";
-/** Our own cell key. A fresh id is added **beside** the shipped entries; reusing one would replace it. */
-export declare const REMOTE_MARK_ID = "over-ssh-remote-mark";
-/**
- * Position among the occupants of that cell.
- *
- * The shipped occupant is the schedule plugin's mark at order 10 ("has scheduled tasks"). A remote workspace
- * is a property of where the session *lives*, not of what it is doing, so it goes first.
- */
-export declare const REMOTE_MARK_ORDER = 5;
-/** The minimal row shape the index reads: an id and the directory the session runs in. */
-export interface SessionCwdRow {
-    readonly id: string;
-    readonly cwd: string | undefined;
-}
-/**
- * Whether one session's cwd is inside the plugin's anchor root.
- *
- * Separators are folded (Windows serves both spellings, and the platform has been seen to normalize to `/`)
- * and the comparison is **case-insensitive**. On a case-sensitive filesystem that fold could in principle
- * accept a different directory that differs only by case; the anchor root is `<home>/.dsh/over-ssh/roots`,
- * where that cannot happen in practice, and the alternative (guessing the platform's spelling) is worse.
- *
- * The boundary is explicit: `.../roots` matches, `.../roots/x` matches, `.../roots-old` does **not**.
- *
- * @param cwd - the session's working directory, as the host reported it.
- * @param anchorRoot - the plugin's anchor root, from the roots snapshot; `undefined` means "unknown".
- * @returns `true` only when the cwd is at or under the anchor root.
- */
-export declare function isRemoteCwd(cwd: string | undefined, anchorRoot: string | undefined): boolean;
-/**
- * The set of session ids that live in a remote workspace.
- *
- * One pass over the inventory; the caller caches the result and re-registers the occupant when it changes.
- *
- * @param sessions - the session inventory rows (only `id` and `cwd` are read).
- * @param anchorRoot - the plugin's anchor root, or `undefined` when the host did not answer one.
- * @returns the ids to mark; empty when the anchor root is unknown.
- */
-export declare function remoteSessionIds(sessions: readonly SessionCwdRow[], anchorRoot: string | undefined): ReadonlySet<string>;
-/** What one occupancy of the seat is handed: the row's own prop plus this plugin's inject face. */
-export interface RemoteSessionMarkProps {
-    /** The session this row shows (owner prop). */
-    readonly sessionId?: string;
-    /** Whether that session is one of ours (inject face). */
-    readonly isRemoteSession?: (sessionId: string) => boolean;
-    /** Localized label, used as both the tooltip and the accessible name (inject face). */
-    readonly label?: string;
-}
-/**
- * The globe, or nothing.
- *
- * A function component with no hooks on purpose: the settings-section views in this repository are called
- * **directly** by their tests (outside a React render), and a hook would throw there.
- *
- * @param props - the row's session id plus the injected predicate and label.
- * @returns the mark, or `null` for a local session (and for a composition that injects nothing).
- */
-export declare function RemoteSessionMark(props: RemoteSessionMarkProps): ReactNode;

package/lib/types/src/client/session/session-row-actions.d.ts

@@ -1,398 +0,0 @@
-/**
- * The **sidebar session 「…」 menu**: the two actions this plugin adds to it, and the confirmation dialog they
- * share.
- *
- * Why the menu at all: the platform's own menu offers pin / rename / fork / archive, and none of them removes a
- * session from the store. The only way to reclaim the bytes a finished session keeps was the settings page
- * (`session-panel-view.ts`), which means opening a modal and scrolling a list of 88 rows to act on the row the
- * user is looking at. `sidebar.workspaces.session.menu.item` is the seat for "act on *this* session", so the
- * same two actions live there.
- *
- * ## How the two seats fit together
- *
- * A menu item cannot render a dialog: the menu is a popover that closes as soon as an item is clicked, and
- * anything it renders goes away with it. The platform's own `ArchiveSession` is built the same way, and this
- * module copies that structure:
- *
- *  1. **The item only delivers a request.** {@link createRowActionHandler} closes the menu
- *     (`setMenuOpen(false)`) and writes a {@link SessionRowActionRequest} into a per-plugin store. No I/O, no
- *     dialog, no state of its own.
- *  2. **A second registration renders the dialog** into `shell.overlay`, the global overlay layer. It subscribes
- *     to the same store, so "which action is pending" is one value rather than two components agreeing.
- *  3. **A success closes itself.** The card keeps the answer for {@link SESSION_ROW_ACTION_AUTO_CLOSE_MS} and then
- *     drops the request: the user asked for the deletion, not for a dialog whose only content is "it worked". A
- *     failure never auto-closes — that sentence is the reason the card exists.
- *
- * ## Why the store is a factory, not a module singleton
- *
- * A module-level singleton would survive a plugin unload and would be shared by two plugin instances (the same
- * reason `createRootsPanelController` is built per load). {@link createSessionRowActionStore} is created once by
- * `apply` and disposed with it; the pending request therefore cannot leak across loads.
- *
- * ## The decision is the row's own
- *
- * Nothing here re-derives whether a session may be deleted: {@link SessionRowView.deletable} and
- * {@link SessionRowView.blockedReason} come from the host through `session-panel.ts`, and the dialog only
- * translates them into a sentence and a disabled button. A running session cannot be deleted (the host has an
- * active turn), a sub-session cannot be deleted on its own (it follows its parent), an unreadable one cannot be
- * judged. A session the host merely **has loaded** is deletable — that is the running/live split the settings
- * panel also renders — and the dialog adds the warning that a later write recreates its log directory.
- *
- * ## Testability
- *
- * Every component here that holds a hook is a **thin shell**: the state machine is
- * {@link createSessionRowActionStore}, the decision is {@link describeSessionRowAction}, and the markup is
- * {@link SessionRowMenuItem} / {@link SessionRowActionDialog}. This repository's client tests call components
- * directly, outside any React render (where a hook throws), so the parts a test needs are the hook-free ones.
- *
- * @module dsh-over-ssh/client/session/session-row-actions
- */
-import { type ReactNode } from 'react';
-import type { MessageKey } from '../core/message.ts';
-import type { OverSshKey } from '../core/locale.ts';
-import { type PanelActionResult, type SessionPanelIo, type SessionRowView } from './session-panel.ts';
-/**
- * The platform's menu-item seat: one `list` slot, root scope.
- *
- * Mirrored instead of imported, exactly like `session-remote-mark.ts` does for the row-leading cell: the slot is
- * declared by `@deepseek-ai/dsh-client-ui-workspace`, which is **not** a dependency of this repository (its types
- * live in the DSH checkout), and the registration below has to compile here.
- */
-export interface SessionMenuOwnerProps {
-    /** The session this menu row is about; every action addresses its own data by this id. */
-    readonly sessionId: string;
-    /** The title the sidebar shows for that session, when it has one. */
-    readonly displayTitle?: string | undefined;
-}
-declare module '@deepseek-ai/dsh-client-ui-slots' {
-    interface SlotMap {
-        /**
-         * One extra entry of a session row's 「…」 menu.
-         *
-         * The platform already occupies `pin` (100), `rename` (200), `fork` (300) and `archive` (400); `order`
-         * decides where a new entry lands, and the occupant receives `{ sessionId, displayTitle }` plus the
-         * platform's `useMenuOpenState` hook. This repository declares the key itself because the owning package is
-         * not a dependency here (see the module doc of `session-remote-mark.ts` for the same trade-off).
-         */
-        'sidebar.workspaces.session.menu.item': {
-            kind: 'list';
-            scope: 'root';
-            owner: SessionMenuOwnerProps;
-        };
-        /**
-         * The global overlay layer: where a dialog opened **from a popover** has to live.
-         *
-         * The menu unmounts as soon as it closes, so a card rendered inside it would disappear with the click that
-         * opened it. Root scope and `list`, like the platform's own archive confirmation.
-         */
-        'shell.overlay': {
-            kind: 'list';
-            scope: 'root';
-        };
-    }
-}
-/** The menu-item seat. */
-export declare const SESSION_MENU_SLOT = "sidebar.workspaces.session.menu.item";
-/** 「移动到回收站」. A fresh id sits **beside** the shipped entries; reusing one would replace it. */
-export declare const SESSION_ROW_RECYCLE_ID = "over-ssh-session-recycle";
-/**
- * Position of 「移动到回收站」 among the menu entries.
- *
- * The platform's own entries are 100/200/300/400 (pin, rename, fork, archive). Both of ours go after them: they
- * are destructive and must not sit between the user and the actions they use every day.
- */
-export declare const SESSION_ROW_RECYCLE_ORDER = 500;
-/** 「删除会话」 — the irreversible twin of {@link SESSION_ROW_RECYCLE_ID}. */
-export declare const SESSION_ROW_DELETE_ID = "over-ssh-session-delete";
-/** Position of 「删除会话」: right below the recycle action, and after every shipped entry. */
-export declare const SESSION_ROW_DELETE_ORDER = 510;
-/** The overlay seat the confirmation dialog is rendered into. */
-export declare const SESSION_ROW_ACTIONS_OVERLAY_SLOT = "shell.overlay";
-/** Stable overlay entry id, so a locale-driven re-registration replaces the same entry. */
-export declare const SESSION_ROW_ACTIONS_OVERLAY_ID = "over-ssh-session-actions-overlay";
-/** Order of the dialog among the overlay's occupants (it is modal, so it does not matter much; stable is what does). */
-export declare const SESSION_ROW_ACTIONS_OVERLAY_ORDER = 500;
-/** The heading's `id` when the shell did not pass a per-mount one (direct template calls, tests). */
-export declare const SESSION_ROW_ACTIONS_TITLE_ID = "dsh-rw-session-action-title";
-/** Which of the two actions a request is about. */
-export type SessionRowActionKind = 'recycle' | 'delete';
-/** What a menu item hands to the store. */
-export interface SessionRowActionRequest {
-    readonly kind: SessionRowActionKind;
-    readonly sessionId: string;
-    /** The title the sidebar showed; the dialog's sentence names the session by it. */
-    readonly displayTitle: string | undefined;
-}
-/** Why the dialog cannot answer yet, and what it decided once it could. */
-export type SessionRowActionPhase = 'idle' | 'loading' | 'ready' | 'unavailable';
-/** The whole dialog state. */
-export interface SessionRowActionState {
-    /** The pending request; `undefined` means the dialog is closed. */
-    readonly request: SessionRowActionRequest | undefined;
-    readonly phase: SessionRowActionPhase;
-    /** The row the request named, once the inventory answered; `undefined` also means "not found". */
-    readonly row: SessionRowView | undefined;
-    /** True while the confirmed action is in flight. */
-    readonly busy: boolean;
-    /** The last answer: the success sentence or the host's error text. */
-    readonly outcome: PanelActionResult | undefined;
-}
-/** Text the menu items and the dialog show; the caller supplies the active locale's dictionary. */
-export interface SessionRowActionsCopy {
-    /** Menu label of 「移动到回收站」, also the dialog's title. */
-    readonly recycle: string;
-    /** Menu label of 「删除会话」, also the dialog's title. */
-    readonly delete: string;
-    /** The sentence naming what the recycle action will do. */
-    readonly recycleBody: (title: string, id: string) => string;
-    /** The sentence naming what the permanent delete will do. */
-    readonly deleteBody: (title: string, id: string) => string;
-    readonly confirmRecycle: string;
-    readonly confirmDelete: string;
-    readonly cancel: string;
-    readonly close: string;
-    readonly loading: string;
-    readonly blockedRunning: string;
-    readonly blockedSubsession: string;
-    readonly blockedUnreadable: string;
-    /** The row is not in the inventory any more (it was deleted elsewhere). */
-    readonly missing: string;
-    /** The inventory itself could not be read, so nothing can be decided. */
-    readonly unavailable: string;
-    /**
-     * The "still loaded by the host" warning, shared with the settings panel's permanent-delete confirmation:
-     * one sentence for one fact, wherever it is shown.
-     */
-    readonly loadedWarning: (count: number) => string;
-    /** The label of the platform's no-workspace bucket (`sessionLabel` returns `''` there). */
-    readonly workspaceUnknown: string;
-    /**
-     * Resolve one deferred message.
-     *
-     * The action result comes out of `session-panel.ts` as a `MessageKey`, because that module has no dictionary —
-     * the sentences it used to spell were Chinese in both locales (audit 2026-10-31 client.md §2.3).
-     */
-    readonly resolve: (message: MessageKey) => string;
-}
-/** What a menu item is handed: our inject face plus the platform's owner props and hook. */
-export interface SessionRowActionsInject {
-    /** The active locale's dictionary. */
-    readonly copy: SessionRowActionsCopy;
-    /** The per-plugin store (created once by `apply`). */
-    readonly store: SessionRowActionStore;
-}
-/** The platform's menu-state hook: `const [, setMenuOpen] = useMenuOpenState()`. */
-export type SessionMenuOpenStateHook = () => readonly [boolean, (open: boolean) => void];
-/** Props of the menu-item shell. */
-export interface SessionRowActionsContainerProps extends SessionRowActionsInject {
-    /** Which of the two items this occurrence is (from its own registration). */
-    readonly kind: SessionRowActionKind;
-    /** The session this row is about (owner prop of the seat). */
-    readonly sessionId?: string | undefined;
-    /** The title the sidebar shows (owner prop of the seat). */
-    readonly displayTitle?: string | undefined;
-    /** The platform's hook; `undefined` in a composition that does not hand it out. */
-    readonly useMenuOpenState?: SessionMenuOpenStateHook | undefined;
-}
-/** Props of the hook-free menu item. */
-export interface SessionRowMenuItemProps {
-    readonly label: string;
-    /** Stable DOM id (the item's own registration id). */
-    readonly itemId: string;
-    readonly onClick: () => void;
-    /**
-     * Render as destructive (red label).
-     *
-     * The platform's own menu rows are neutral, so a red one has to earn it: this is only for an action that cannot
-     * be undone from the UI. 「移动到回收站」 is reversible (the recycle bin restores it), 「删除会话」 is not.
-     */
-    readonly danger?: boolean;
-}
-/** Props of the dialog shell: the inject face only. */
-export type SessionRowActionsOverlayProps = SessionRowActionsInject;
-/** What the menu items call. */
-export interface RowActionHandlerOptions {
-    readonly kind: SessionRowActionKind;
-    readonly sessionId: string;
-    readonly displayTitle?: string | undefined;
-    /** The platform's menu setter, when the composition hands one out. */
-    readonly setMenuOpen?: ((open: boolean) => void) | undefined;
-    readonly request: (request: SessionRowActionRequest) => void;
-}
-/** What the dialog renders. Every string is already resolved; the template composes no text of its own. */
-export interface SessionRowActionView {
-    readonly kind: SessionRowActionKind;
-    readonly title: string;
-    readonly body: string;
-    /** The "still loaded by the host" warning, or `''` when it does not apply. */
-    readonly warning: string;
-    /** Why the action may not run, or `''` when it may. */
-    readonly blocked: string;
-    /** Whether the target allows the action at all (the policy decision, independent of `busy`). */
-    readonly confirmable: boolean;
-    /** Which buttons the card offers: the confirm/cancel pair, or close only. */
-    readonly buttons: 'confirm' | 'close';
-    readonly busy: boolean;
-    readonly loading: boolean;
-    readonly outcome: string;
-    readonly outcomeTone: 'info' | 'error';
-    readonly confirmLabel: string;
-    readonly cancelLabel: string;
-    readonly closeLabel: string;
-}
-/** What the store needs: the injected calls (the same `io` the settings panel uses). */
-export interface SessionRowActionStoreDeps {
-    readonly io: SessionPanelIo;
-    /**
-     * Schedule one delayed close and return its cancel.
-     *
-     * Injected so a test drives the delay instead of waiting on a timer, and so the dialog's lifetime is a value
-     * rather than a `setTimeout` buried in a component.
-     */
-    readonly schedule?: (run: () => void, delayMs: number) => () => void;
-}
-/**
- * How long a successful answer stays on screen before the dialog closes itself.
- *
- * Long enough to read one short sentence ("已永久删除 43.6 KiB（不可恢复）"), short enough that dismissing the card
- * is not a second click the user has to make. **Failures never auto-close** — an error is the one thing worth
- * reading, and it must not disappear while the user is still parsing it.
- */
-export declare const SESSION_ROW_ACTION_AUTO_CLOSE_MS = 1500;
-/** The per-plugin store the menu items write to and the overlay subscribes to. */
-export interface SessionRowActionStore {
-    readonly getState: () => SessionRowActionState;
-    readonly subscribe: (listener: () => void) => () => void;
-    /** Hand a request over; the dialog opens on the next read. */
-    readonly request: (request: SessionRowActionRequest) => void;
-    /** Read the inventory row the pending request names. */
-    readonly load: () => Promise<void>;
-    /** Run the confirmed action and record its answer. */
-    readonly confirm: () => Promise<void>;
-    /** Drop the request (the dialog closes). */
-    readonly close: () => void;
-    /** Re-arm after a mount (React's development replay runs the cleanup once before the real lifetime). */
-    readonly activate: () => void;
-    readonly dispose: () => void;
-}
-/** The state of a store that has never been written to. */
-export declare function initialSessionRowActionState(): SessionRowActionState;
-/**
- * The identity of one dialog occupancy: which action, on which session, or that the dialog is closed.
- *
- * A named pure function rather than a bare dependency array, because this repository's tests do not render
- * hooks: an effect's dependency list cannot be executed by a test, so the *decision* ("a new request owes a
- * fresh read") is extracted here where it can be. It is the same reasoning as `rootsQueryKey` in the session
- * entry.
- *
- * @param state - the store's state.
- * @returns `closed` with no pending request, otherwise a key that changes with the request.
- */
-export declare function actionQueryKey(state: SessionRowActionState): string;
-/**
- * Build the stateful half: pending request, inventory read, the confirmed call and its answer.
- *
- * `confirm` deliberately re-checks the row instead of trusting the click: the menu and the dialog are two
- * different surfaces, and between the two the session may have started running. The host refuses such a delete
- * anyway; refusing it here is what keeps the dialog from promising something the route would reject.
- *
- * @param deps - the injected calls.
- * @returns the store; every method is safe after {@link SessionRowActionStore.dispose}.
- */
-export declare function createSessionRowActionStore(deps: SessionRowActionStoreDeps): SessionRowActionStore;
-/**
- * The click handler a menu item uses: close the menu, then hand the request over.
- *
- * The order is the whole point. The dialog lives in `shell.overlay`, but the menu is a popover **above** the
- * page; leaving it open would put it on top of the card and swallow the card's own clicks. Extracted as a pure
- * factory so the ordering is a fact a test can hold on to — inline in a component, no test could reach it.
- *
- * @param options - the action, its target, the platform's menu setter and the store's writer.
- * @returns the click handler.
- */
-export declare function createRowActionHandler(options: RowActionHandlerOptions): () => void;
-/**
- * The menu entry one action kind renders: its stable DOM id and whether it is destructive.
- *
- * Extracted from {@link SessionRowActionsContainer} because that container calls the platform's hook, and this
- * repository's client tests cannot render a hook-using component — "which id, and is it red" is a decision, and a
- * decision left in the shell is a decision no test can reach.
- */
-export interface SessionRowMenuEntry {
-    readonly itemId: string;
-    readonly danger: boolean;
-}
-/**
- * The menu entry for one action kind.
- *
- * Only 「删除会话」 is destructive: it is permanent. 「移动到回收站」 can be undone from the recycle bin, so making
- * it red would teach the user to ignore red.
- *
- * @param kind - which action this row offers.
- * @returns the item id and the destructive flag.
- */
-export declare function sessionRowMenuEntry(kind: SessionRowActionKind): SessionRowMenuEntry;
-/**
- * The badge-free menu entry: one `role="menuitem"` button.
- *
- * Hook-free on purpose (the tests call it directly), and it renders no icon: the platform's own menu rows are
- * text, and a glyph would need a theme token this plugin does not have.
- *
- * @param props - the label, the stable DOM id, the click handler and the destructive flag.
- * @returns the menu item button.
- */
-export declare function SessionRowMenuItem(props: SessionRowMenuItemProps): ReactNode;
-/**
- * The menu item as the platform renders it: the owner props, the injected face and the menu hook.
- *
- * The hook is called only when the composition hands it out. That is the same trade-off the session entry
- * documents for its framework seats (`readWorkspacePath`): the *presence* of a seat is fixed per composition,
- * so the call cannot appear and disappear between two renders of one mount.
- *
- * @param props - the seat's props plus this plugin's inject face.
- * @returns the menu item, or `null` when the seat handed no session id (nothing to act on).
- */
-export declare function SessionRowActionsContainer(props: SessionRowActionsContainerProps): ReactNode;
-/**
- * Turn the store's state into the strings and the button set the dialog renders.
- *
- * One function for the whole decision, so the wording, the refusal reason and the button set can never
- * disagree: the branches are the four states of {@link SessionRowActionPhase} plus the row's own
- * {@link SessionRowView.blockedReason}.
- *
- * @param state - the store's state.
- * @param copy - the active locale's dictionary.
- * @returns the view, or `undefined` while no request is pending (the dialog renders nothing).
- */
-export declare function describeSessionRowAction(state: SessionRowActionState, copy: SessionRowActionsCopy): SessionRowActionView | undefined;
-/** Props of the hook-free dialog template. */
-export interface SessionRowActionDialogProps {
-    readonly view: SessionRowActionView;
-    readonly onConfirm: () => void;
-    readonly onClose: () => void;
-    /** `id` of the heading, referenced by `aria-labelledby`; the shell passes a per-mount id. */
-    readonly titleId?: string | undefined;
-}
-/**
- * The confirmation card: title, the sentence naming the target, the refusal or the warning, and its buttons.
- *
- * Rendered **in the overlay**, not in the menu: see the module doc. Esc closes it wherever the focus is inside
- * the card (the shell puts it there when the card opens).
- *
- * @param props - the view, what the two buttons call, and the heading's id.
- * @returns the dialog card.
- */
-export declare function SessionRowActionDialog({ view, onConfirm, onClose, titleId, }: SessionRowActionDialogProps): ReactNode;
-/**
- * The overlay occupant: subscribe to the store and render the dialog (portalled to `document.body`).
- *
- * Portalled rather than rendered in place, for the reason `portal.ts` documents at length: the sidebar clips its
- * overflow, and a `position: fixed` card inside a clipped flex column is squeezed. Opening also moves focus into
- * the card and remembers what held it, so Esc works and closing hands focus back to the menu that opened it.
- *
- * @param props - the injected dictionary and store.
- * @returns the dialog inside its portal, or `null` while nothing is pending.
- */
-export declare function SessionRowActionsOverlay(props: SessionRowActionsOverlayProps): ReactNode;
-/** The dictionary keys this module renders, so a test can assert the two locales carry them. */
-export type SessionRowActionsKey = Extract<OverSshKey, 'sessionRowRecycle' | 'sessionRowDelete' | 'sessionRowRecycleBody' | 'sessionRowDeleteBody' | 'sessionRowConfirmRecycle' | 'sessionRowConfirmDelete' | 'sessionRowCancel' | 'sessionRowClose' | 'sessionRowLoading' | 'sessionRowBlockedRunning' | 'sessionRowBlockedSubsession' | 'sessionRowBlockedUnreadable' | 'sessionRowMissing' | 'sessionRowUnavailable' | 'sessionPanelLiveWarning'>;

package/lib/types/src/client/session-panel.d.ts

@@ -1,152 +0,0 @@
-/**
- * The session panel's whole decision surface: wire parsing, HTTP calls, validation and the view model.
- * **No React, no DOM, no `@deepseek-ai/*`** — the component renders what this module returns (红线 2).
- *
- * ## Three rules this module owns
- *
- *  1. **`GET` is the only read.** The panel never mutates on render; every destructive action is an explicit
- *     user click that becomes a `POST`.
- *  2. **Irreversible actions carry `confirm: true`.** The host route refuses `purge` and
- *     `mode: 'permanent'` without it, so the panel must send it — and it only does so after the user
- *     confirms. Two locks, not one.
- *  3. **A sub-session is not an orphan.** The model keeps `subsession` rows visibly distinct and refuses to
- *     offer them a delete button, because deleting one alone is what the requirement warns against.
- *
- * @module dsh-remote-workspace/client/session-panel
- */
-/**
- * Where the host route lives, as the browser must request it.
- *
- * **Duplicated from the host module on purpose**, exactly like `ROOTS_API_PATH` in `roots-panel.ts`: the
- * client bundle must not pull host code in (it would drag `node:fs`/`node:child_process` into the browser
- * build), and the two halves are separate bundles. The value is the contract; both sides assert it in their
- * own tests, so a divergence is a red test rather than a silent 404.
- *
- * Relative on purpose: `dsh web` serves the page from the host origin, and the Desktop shell forwards
- * `/api/...` from `dsh-app://app/` to the owned host with its session cookie (see `roots-panel.ts` for the
- * full reasoning).
- */
-export declare const SESSION_API_PATH = "/api/remote-workspace/sessions";
-/** One inventory row as the panel uses it. */
-export interface SessionRowView {
-    readonly id: string;
-    readonly classification: 'normal' | 'subsession' | 'unreadable';
-    readonly parentSessionId: string | undefined;
-    readonly title: string | undefined;
-    readonly cwd: string | undefined;
-    readonly bytes: number;
-    readonly updatedAtMs: number;
-    readonly live: boolean;
-    /** Whether this row may be deleted on its own (a live or unreadable row may not). */
-    readonly deletable: boolean;
-    /** Why it may not be deleted, when it may not. */
-    readonly blockedReason: 'live' | 'subsession' | 'unreadable' | undefined;
-}
-/** One bin row as the panel uses it. */
-export interface BinRowView {
-    readonly entryId: string;
-    readonly sessionId: string;
-    readonly title: string | undefined;
-    readonly bytes: number;
-    readonly deletedAtMs: number;
-    readonly movedBy: 'rename' | 'copy';
-}
-/** The whole panel state. */
-export interface SessionPanelSnapshot {
-    readonly available: boolean;
-    readonly sessions: readonly SessionRowView[];
-    readonly bin: readonly BinRowView[];
-    readonly policy: {
-        readonly maxEntries: number;
-        readonly maxBytes: number;
-        readonly maxAgeMs: number;
-    };
-    /** Totals the header shows without recomputing in the component. */
-    readonly totals: {
-        readonly sessions: number;
-        readonly bytes: number;
-        readonly subsessions: number;
-        readonly live: number;
-    };
-}
-/** What the panel needs from the browser, injected so a test needs no `fetch`. */
-export interface SessionPanelIo {
-    readonly fetch: (path: string, init?: {
-        readonly method?: string;
-        readonly body?: string;
-        readonly headers?: Record<string, string>;
-    }) => Promise<{
-        readonly ok: boolean;
-        readonly status: number;
-        json: () => Promise<unknown>;
-    }>;
-}
-/** A panel action's outcome, as the view renders it. */
-export type PanelActionResult = {
-    readonly kind: 'ok';
-    readonly message: string;
-} | {
-    readonly kind: 'error';
-    readonly message: string;
-    readonly status?: number;
-} | {
-    readonly kind: 'needs-confirmation';
-    readonly message: string;
-};
-/** Human byte formatting (binary units, one decimal). */
-export declare function formatBytes(bytes: number): string;
-/** Classify one raw row and decide whether it is deletable on its own. */
-export declare function toSessionRowView(raw: Record<string, unknown>): SessionRowView | undefined;
-/** Project one raw bin row. */
-export declare function toBinRowView(raw: Record<string, unknown>): BinRowView | undefined;
-/** An empty snapshot, used before the first answer and when the route is unavailable. */
-export declare function emptySnapshot(): SessionPanelSnapshot;
-/**
- * Parse one `GET` answer.
- *
- * Field by field, like `parseRootsSnapshot`: a host answer carrying extra keys cannot reach the DOM.
- *
- * @param value - the decoded JSON body.
- * @returns the snapshot; an unusable body yields {@link emptySnapshot}.
- */
-export declare function parseSessionSnapshot(value: unknown): SessionPanelSnapshot;
-/**
- * Load the panel's data.
- *
- * @param io - injected fetch.
- * @returns the snapshot; an HTTP failure is reported as `available: false` rather than thrown, because a
- *   panel that cannot reach the host must still render (and say so).
- */
-export declare function loadSessionPanel(io: SessionPanelIo): Promise<SessionPanelSnapshot>;
-/**
- * Delete sessions.
- *
- * @param io - injected fetch.
- * @param ids - session ids to delete.
- * @param options - `permanent` requires `confirm: true`, which the caller only passes after the user agreed.
- * @returns the outcome as the view renders it.
- */
-export declare function deleteSessions(io: SessionPanelIo, ids: readonly string[], options?: {
-    readonly permanent?: boolean;
-    readonly includeSubsessions?: boolean;
-}): Promise<PanelActionResult>;
-/** Restore one bin entry. */
-export declare function restoreSession(io: SessionPanelIo, entryId: string): Promise<PanelActionResult>;
-/** Permanently remove one bin entry. Requires the caller to have confirmed. */
-export declare function purgeSession(io: SessionPanelIo, entryId: string): Promise<PanelActionResult>;
-/** Apply the retention policy. */
-export declare function sweepSessions(io: SessionPanelIo): Promise<PanelActionResult>;
-/** Preview a deletion without performing it. */
-export declare function previewDelete(io: SessionPanelIo, ids: readonly string[], options?: {
-    readonly includeSubsessions?: boolean;
-}): Promise<{
-    readonly delete: readonly string[];
-    readonly refusals: readonly {
-        readonly id: string;
-        readonly reason: string;
-    }[];
-    readonly bytes: number;
-}>;
-/** Whether an action needs the user to confirm before it may run. */
-export declare function needsConfirmation(action: 'delete-permanent' | 'purge'): boolean;
-//# sourceMappingURL=session-panel.d.ts.map