@huanlin/dsh-plugin-ya-workspace-sidebar 0.6.0 → 0.7.0

package/lib/types/client/locales.d.ts

@@ -1,113 +1,133 @@
-/** Product copy for the replacement workspace browser. */
-export declare const zh: {
-    workspaces: string;
-    sessions: string;
-    recent: string;
-    ungrouped: string;
-    newSession: string;
-    addWorkspace: string;
-    addWorkspaceMenu: string;
-    search: string;
-    searchPlaceholder: string;
-    clearSearch: string;
-    searching: string;
-    searchUnavailable: string;
-    noMatches: string;
-    noSessions: string;
-    noWorkspaces: string;
-    loading: string;
-    rename: string;
-    renameWorkspace: string;
-    renameSession: string;
-    deleteWorkspace: string;
-    deleteDescription: string;
-    fork: string;
-    archive: string;
-    archiveMode: string;
-    deleteMode: string;
-    deleteSession: string;
-    deleteSessionTitle: string;
-    deleteSessionConfirm: string;
-    toggleActionMode: string;
-    actionModeLabel: string;
-    cancel: string;
-    confirm: string;
-    retry: string;
-    folderError: string;
-    workspaceName: string;
-    sessionName: string;
-    count: string;
-    now: string;
-    minutes: string;
-    hours: string;
-    days: string;
-    months: string;
-    years: string;
-    running: string;
-    waiting: string;
-    completed: string;
-    collapse: string;
-    expand: string;
-    resizeRecent: string;
-    today: string;
-    yesterday: string;
-    date: string;
-    dateYear: string;
-};
-export type YaWorkspaceKey = keyof typeof zh;
-export declare const en: {
-    workspaces: string;
-    sessions: string;
-    recent: string;
-    ungrouped: string;
-    newSession: string;
-    addWorkspace: string;
-    addWorkspaceMenu: string;
-    search: string;
-    searchPlaceholder: string;
-    clearSearch: string;
-    searching: string;
-    searchUnavailable: string;
-    noMatches: string;
-    noSessions: string;
-    noWorkspaces: string;
-    loading: string;
-    rename: string;
-    renameWorkspace: string;
-    renameSession: string;
-    deleteWorkspace: string;
-    deleteDescription: string;
-    fork: string;
-    archive: string;
-    archiveMode: string;
-    deleteMode: string;
-    deleteSession: string;
-    deleteSessionTitle: string;
-    deleteSessionConfirm: string;
-    toggleActionMode: string;
-    actionModeLabel: string;
-    cancel: string;
-    confirm: string;
-    retry: string;
-    folderError: string;
-    workspaceName: string;
-    sessionName: string;
-    count: string;
-    now: string;
-    minutes: string;
-    hours: string;
-    days: string;
-    months: string;
-    years: string;
-    running: string;
-    waiting: string;
-    completed: string;
-    collapse: string;
-    expand: string;
-    resizeRecent: string;
-    today: string;
-    yesterday: string;
-    date: string;
-    dateYear: string;
-};
-export declare const NS = "ya-workspace-sidebar";
+/** Product copy for the replacement workspace browser. */
+export declare const zh: {
+    workspaces: string;
+    sessions: string;
+    recent: string;
+    ungrouped: string;
+    newSession: string;
+    addWorkspace: string;
+    addWorkspaceMenu: string;
+    search: string;
+    searchPlaceholder: string;
+    clearSearch: string;
+    searching: string;
+    searchUnavailable: string;
+    noMatches: string;
+    noSessions: string;
+    noWorkspaces: string;
+    loading: string;
+    rename: string;
+    renameWorkspace: string;
+    renameSession: string;
+    deleteWorkspace: string;
+    deleteDescription: string;
+    fork: string;
+    archive: string;
+    archiveMode: string;
+    deleteMode: string;
+    deleteSession: string;
+    deleteSessionTitle: string;
+    deleteSessionConfirm: string;
+    toggleActionMode: string;
+    actionModeLabel: string;
+    cancel: string;
+    confirm: string;
+    retry: string;
+    folderError: string;
+    workspaceName: string;
+    sessionName: string;
+    count: string;
+    now: string;
+    minutes: string;
+    hours: string;
+    days: string;
+    months: string;
+    years: string;
+    running: string;
+    waiting: string;
+    completed: string;
+    collapse: string;
+    expand: string;
+    resizeRecent: string;
+    today: string;
+    yesterday: string;
+    date: string;
+    dateYear: string;
+    pin: string;
+    unpin: string;
+    pinnedGroup: string;
+    markUnread: string;
+    markRead: string;
+    revealInExplorer: string;
+    copyPath: string;
+    copySessionDir: string;
+    copyLogPath: string;
+    copySessionId: string;
+};
+export type YaWorkspaceKey = keyof typeof zh;
+export declare const en: {
+    workspaces: string;
+    sessions: string;
+    recent: string;
+    ungrouped: string;
+    newSession: string;
+    addWorkspace: string;
+    addWorkspaceMenu: string;
+    search: string;
+    searchPlaceholder: string;
+    clearSearch: string;
+    searching: string;
+    searchUnavailable: string;
+    noMatches: string;
+    noSessions: string;
+    noWorkspaces: string;
+    loading: string;
+    rename: string;
+    renameWorkspace: string;
+    renameSession: string;
+    deleteWorkspace: string;
+    deleteDescription: string;
+    fork: string;
+    archive: string;
+    archiveMode: string;
+    deleteMode: string;
+    deleteSession: string;
+    deleteSessionTitle: string;
+    deleteSessionConfirm: string;
+    toggleActionMode: string;
+    actionModeLabel: string;
+    cancel: string;
+    confirm: string;
+    retry: string;
+    folderError: string;
+    workspaceName: string;
+    sessionName: string;
+    count: string;
+    now: string;
+    minutes: string;
+    hours: string;
+    days: string;
+    months: string;
+    years: string;
+    running: string;
+    waiting: string;
+    completed: string;
+    collapse: string;
+    expand: string;
+    resizeRecent: string;
+    today: string;
+    yesterday: string;
+    date: string;
+    dateYear: string;
+    pin: string;
+    unpin: string;
+    pinnedGroup: string;
+    markUnread: string;
+    markRead: string;
+    revealInExplorer: string;
+    copyPath: string;
+    copySessionDir: string;
+    copyLogPath: string;
+    copySessionId: string;
+};
+export declare const NS = "ya-workspace-sidebar";

package/lib/types/client/model.d.ts

@@ -1,87 +1,96 @@
-/** Pure sidebar projections shared by the browser and unit tests. */
-import type { SessionListState } from '@deepseek-ai/dsh-api-session-controller/client';
-import type { WorkspaceId, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
-import type { SessionId } from '@deepseek-ai/dsh-session/types';
-/** Pending-interaction kinds surfaced as a row status dot. */
-export type PendingInteractionKind = 'approval' | 'plan-review' | 'question';
-/** Renderer-visible view of ui-session's pending-interaction snapshot entries. */
-export type PendingInteractionEntry = {
-    readonly kind: string;
-};
-/** Pending-interaction snapshot consumed by the derive functions. */
-export type PendingInteractionMap = ReadonlyMap<SessionId, PendingInteractionEntry>;
-/** Navigation key for sessions not accounted to a real workspace. */
-export declare const UNGROUPED: "__ya_ungrouped__";
-/** One sidebar session row. */
-export interface SessionRow {
-    id: SessionId;
-    title: string;
-    blank: boolean;
-    running: boolean;
-    pendingInteraction?: PendingInteractionKind;
-    completed: boolean;
-    updatedAt: number;
-    workspaceKey: WorkspaceId | typeof UNGROUPED;
-    workspaceTitle: string;
-}
-/** One date-bucketed group. Empty `dateKey` is the undated trailing bucket. */
-export interface DateGroup<T> {
-    /** Local calendar date `YYYY-MM-DD`, or `''` for rows with no timestamp. */
-    dateKey: string;
-    /** Days between today's local date and this group's local date (0=today, 1=yesterday, …). */
-    dayOffset: number;
-    rows: T[];
-}
-/** One date-bucketed group of session rows for the real-workspace level. */
-export type SessionDateGroup = DateGroup<SessionRow>;
-/** One date-bucketed group of first-level workspace rows. */
-export type WorkspaceDateGroup = DateGroup<WorkspaceRow>;
-/** One first-level workspace row. */
-export interface WorkspaceRow {
-    key: WorkspaceId | typeof UNGROUPED;
-    title: string;
-    path?: string;
-    createdAt?: string;
-    /** Newest visible session `updatedAt`; empty real workspaces fall back to `createdAt`. */
-    lastUsedAt?: number;
-    count: number;
-    real: boolean;
-}
-/** Resolve the first/second-level destination for one session. */
-export declare function workspaceKeyForSession(sessionId: SessionId | undefined, workspaces: readonly WorkspaceView[]): WorkspaceId | typeof UNGROUPED | null;
-/** Derive global recent sessions, newest first. */
-export declare function deriveRecent(list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], pending: PendingInteractionMap, limit?: number): SessionRow[];
-/** Fixed occupied height of one recent-sessions row: 33px two-line row + 2px vertical margins. */
-export declare const RECENT_ROW_STRIDE = 35;
-/** Half-open render window `[start, end)` of a fixed-stride virtual list. */
-export interface VirtualWindow {
-    start: number;
-    end: number;
-}
-/**
- * Windowing math for the recent-sessions virtual list (fixed row stride).
- *
- * Clamps `scrollTop` into the valid range, then pads the visible row range
- * with `overscan` rows on both edges. Before the viewport has been measured
- * (`viewportHeight <= 0`) it still returns a small head window so the first
- * paint is never blank.
- */
-export declare function virtualWindow(scrollTop: number, viewportHeight: number, count: number, stride?: number, overscan?: number): VirtualWindow;
-/** Derive first-level workspaces plus Ungrouped, newest session activity first. */
-export declare function deriveWorkspaces(list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[]): WorkspaceRow[];
-/** Derive the selected workspace's sessions in its canonical order. */
-export declare function deriveWorkspaceSessions(key: WorkspaceId | typeof UNGROUPED, list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], pending: PendingInteractionMap): SessionRow[];
-/**
- * Derive the selected real workspace's sessions grouped by local calendar date.
- *
- * - Only real workspaces: `Ungrouped` falls back to {@link deriveWorkspaceSessions}.
- * - Groups are ordered by date descending; rows within a group by `updatedAt` descending.
- * - {@link visible} filter is reused (archived / subagent / blank visibility).
- * - Future timestamps clamp to today's bucket (`dayOffset` 0).
- * - `now` is the reference timestamp for "today"; pass `Date.now()` in production.
- */
-export declare function deriveWorkspaceSessionGroups(key: WorkspaceId | typeof UNGROUPED, list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], pending: PendingInteractionMap, now: number): SessionDateGroup[];
-/** Group root workspace rows by local calendar date of `lastUsedAt`; undated rows trail with empty `dateKey`. */
-export declare function deriveWorkspaceGroups(rows: readonly WorkspaceRow[], now: number): WorkspaceDateGroup[];
-/** Case-insensitive local title/workspace matching used beside Host content search. */
-export declare function localMatches(rows: readonly SessionRow[], query: string): SessionRow[];
+/** Pure sidebar projections shared by the browser and unit tests. */
+import type { SessionListState } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { WorkspaceId, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+/** Pending-interaction kinds surfaced as a row status dot. */
+export type PendingInteractionKind = 'approval' | 'plan-review' | 'question';
+/** Renderer-visible view of ui-session's pending-interaction snapshot entries. */
+export type PendingInteractionEntry = {
+    readonly kind: string;
+};
+/** Pending-interaction snapshot consumed by the derive functions. */
+export type PendingInteractionMap = ReadonlyMap<SessionId, PendingInteractionEntry>;
+/** Navigation key for sessions not accounted to a real workspace. */
+export declare const UNGROUPED: "__ya_ungrouped__";
+/** One sidebar session row. */
+export interface SessionRow {
+    id: SessionId;
+    title: string;
+    blank: boolean;
+    running: boolean;
+    pendingInteraction?: PendingInteractionKind;
+    completed: boolean;
+    updatedAt: number;
+    workspaceKey: WorkspaceId | typeof UNGROUPED;
+    workspaceTitle: string;
+    /** Session working directory; feeds the context menu's path actions. */
+    cwd?: string;
+}
+/** One date-bucketed group. Empty `dateKey` is the undated trailing bucket. */
+export interface DateGroup<T> {
+    /** Local calendar date `YYYY-MM-DD`, or `''` for rows with no timestamp. */
+    dateKey: string;
+    /** Days between today's local date and this group's local date (0=today, 1=yesterday, …). */
+    dayOffset: number;
+    rows: T[];
+}
+/** One date-bucketed group of session rows for the real-workspace level. */
+export type SessionDateGroup = DateGroup<SessionRow>;
+/** One date-bucketed group of first-level workspace rows. */
+export type WorkspaceDateGroup = DateGroup<WorkspaceRow>;
+/** One first-level workspace row. */
+export interface WorkspaceRow {
+    key: WorkspaceId | typeof UNGROUPED;
+    title: string;
+    path?: string;
+    createdAt?: string;
+    /** Newest visible session `updatedAt`; empty real workspaces fall back to `createdAt`. */
+    lastUsedAt?: number;
+    count: number;
+    real: boolean;
+}
+/** Resolve the first/second-level destination for one session. */
+export declare function workspaceKeyForSession(sessionId: SessionId | undefined, workspaces: readonly WorkspaceView[]): WorkspaceId | typeof UNGROUPED | null;
+/** Derive global recent sessions, newest first. */
+export declare function deriveRecent(list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], pending: PendingInteractionMap, limit?: number): SessionRow[];
+/** Lift pinned rows (in pinned order) to the front; the rest keep their order. */
+export declare function applyPinned(rows: readonly SessionRow[], pinnedOrder: readonly SessionId[]): SessionRow[];
+/** Split date-grouped rows into a leading pinned list (pinned order) and the remaining groups (emptied groups dropped). */
+export declare function extractPinnedGroups(groups: readonly SessionDateGroup[], pinnedOrder: readonly SessionId[]): {
+    pinned: SessionRow[];
+    groups: SessionDateGroup[];
+};
+/** Fixed occupied height of one recent-sessions row: 33px two-line row + 2px vertical margins. */
+export declare const RECENT_ROW_STRIDE = 35;
+/** Half-open render window `[start, end)` of a fixed-stride virtual list. */
+export interface VirtualWindow {
+    start: number;
+    end: number;
+}
+/**
+ * Windowing math for the recent-sessions virtual list (fixed row stride).
+ *
+ * Clamps `scrollTop` into the valid range, then pads the visible row range
+ * with `overscan` rows on both edges. Before the viewport has been measured
+ * (`viewportHeight <= 0`) it still returns a small head window so the first
+ * paint is never blank.
+ */
+export declare function virtualWindow(scrollTop: number, viewportHeight: number, count: number, stride?: number, overscan?: number): VirtualWindow;
+/** Derive first-level workspaces plus Ungrouped, newest session activity first. */
+export declare function deriveWorkspaces(list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[]): WorkspaceRow[];
+/** Derive the selected workspace's sessions in its canonical order. */
+export declare function deriveWorkspaceSessions(key: WorkspaceId | typeof UNGROUPED, list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], pending: PendingInteractionMap): SessionRow[];
+/**
+ * Derive the selected real workspace's sessions grouped by local calendar date.
+ *
+ * - Only real workspaces: `Ungrouped` falls back to {@link deriveWorkspaceSessions}.
+ * - Groups are ordered by date descending; rows within a group by `updatedAt` descending.
+ * - {@link visible} filter is reused (archived / subagent / blank visibility).
+ * - Future timestamps clamp to today's bucket (`dayOffset` 0).
+ * - `now` is the reference timestamp for "today"; pass `Date.now()` in production.
+ */
+export declare function deriveWorkspaceSessionGroups(key: WorkspaceId | typeof UNGROUPED, list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], pending: PendingInteractionMap, now: number): SessionDateGroup[];
+/** Group root workspace rows by local calendar date of `lastUsedAt`; undated rows trail with empty `dateKey`. */
+export declare function deriveWorkspaceGroups(rows: readonly WorkspaceRow[], now: number): WorkspaceDateGroup[];
+/** Case-insensitive local title/workspace matching used beside Host content search. */
+export declare function localMatches(rows: readonly SessionRow[], query: string): SessionRow[];

package/lib/types/client/navigation.d.ts

@@ -1,45 +1,45 @@
-/**
- * Stand-in for the `uiWorkspace` navigation service owned by the official
- * ui-workspace client entry, which this bundle's patch disables.
- *
- * Since DSH v0.1.2-alpha.1 the ui-sidebar, ui-conversation, ui-agent-preset,
- * and the composed directory-picker client entries all inject `uiWorkspace`;
- * without a provider their fibers park forever and the whole WebUI boot
- * deadlocks. This port carries the semantics that moved here from the
- * pre-split client runtime: reuse-or-create Workspace connection, the
- * explicit/current/recent New Session fallback, archived-current clearing,
- * boot auto-selection, and the directory-picking wire calls.
- */
-import { Service, type Context } from '@deepseek-ai/cordis';
-import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client';
-import type { ClientRemote, DirectoryListing } from '@deepseek-ai/dsh-api-remotes/client';
-import type { IWorkspaces, WorkspaceId } from '@deepseek-ai/dsh-api-workspace-controller/client';
-import type { UiWorkspace } from '@deepseek-ai/dsh-client-ui-workspace/client';
-import type { SessionId } from '@deepseek-ai/dsh-session/types';
-/** Implements Workspace navigation and directory UI operations. */
-export declare class YaWorkspaceNavigation extends Service implements UiWorkspace {
-    private readonly directoryPicker;
-    private readonly workspaces;
-    private readonly sessions;
-    private readonly connecting;
-    private readonly lifetime;
-    /**
-     * @param ctx - Client root Context.
-     * @param directoryPicker - the directory-picking Remote namespace.
-     * @param workspaces - pure Workspace Controller.
-     * @param sessions - pure Session Controller.
-     */
-    constructor(ctx: Context, directoryPicker: ClientRemote['directoryPicker'], workspaces: IWorkspaces, sessions: ISessions);
-    connectWorkspace(workspaceId: WorkspaceId): Promise<SessionId>;
-    openSession(sessionId: SessionId): void;
-    openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void): Promise<void>;
-    forkSession(sessionId: SessionId): Promise<void>;
-    startSession(workspaceId?: WorkspaceId): void;
-    archiveSession(sessionId: SessionId): Promise<void>;
-    pickDirectory(): Promise<string | null>;
-    listDirectory(path?: string, signal?: AbortSignal): Promise<DirectoryListing>;
-    createDirectory(path: string, name: string): Promise<string>;
-    private watchNavigation;
-    /** @returns true when an archived current selection was cleared. */
-    private clearArchivedCurrent;
-}
+/**
+ * Stand-in for the `uiWorkspace` navigation service owned by the official
+ * ui-workspace client entry, which this bundle's patch disables.
+ *
+ * Since DSH v0.1.2-alpha.1 the ui-sidebar, ui-conversation, ui-agent-preset,
+ * and the composed directory-picker client entries all inject `uiWorkspace`;
+ * without a provider their fibers park forever and the whole WebUI boot
+ * deadlocks. This port carries the semantics that moved here from the
+ * pre-split client runtime: reuse-or-create Workspace connection, the
+ * explicit/current/recent New Session fallback, archived-current clearing,
+ * boot auto-selection, and the directory-picking wire calls.
+ */
+import { Service, type Context } from '@deepseek-ai/cordis';
+import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { ClientRemote, DirectoryListing } from '@deepseek-ai/dsh-api-remotes/client';
+import type { IWorkspaces, WorkspaceId } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { UiWorkspace } from '@deepseek-ai/dsh-client-ui-workspace/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+/** Implements Workspace navigation and directory UI operations. */
+export declare class YaWorkspaceNavigation extends Service implements UiWorkspace {
+    private readonly directoryPicker;
+    private readonly workspaces;
+    private readonly sessions;
+    private readonly connecting;
+    private readonly lifetime;
+    /**
+     * @param ctx - Client root Context.
+     * @param directoryPicker - the directory-picking Remote namespace.
+     * @param workspaces - pure Workspace Controller.
+     * @param sessions - pure Session Controller.
+     */
+    constructor(ctx: Context, directoryPicker: ClientRemote['directoryPicker'], workspaces: IWorkspaces, sessions: ISessions);
+    connectWorkspace(workspaceId: WorkspaceId): Promise<SessionId>;
+    openSession(sessionId: SessionId): void;
+    openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void): Promise<void>;
+    forkSession(sessionId: SessionId): Promise<void>;
+    startSession(workspaceId?: WorkspaceId): void;
+    archiveSession(sessionId: SessionId): Promise<void>;
+    pickDirectory(): Promise<string | null>;
+    listDirectory(path?: string, signal?: AbortSignal): Promise<DirectoryListing>;
+    createDirectory(path: string, name: string): Promise<string>;
+    private watchNavigation;
+    /** @returns true when an archived current selection was cleared. */
+    private clearArchivedCurrent;
+}

package/lib/types/client/session-flags.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Browser-local pinned/unread session flags for the sidebar rows.
+ *
+ * Pinned order is an array (index 0 renders first); unread is a set. Both
+ * persist to localStorage like the action-mode preference: per-browser by
+ * design, never synced, never sent to the Host. Storage failures fall back
+ * to the in-memory value driving the current page.
+ */
+import { SessionId } from '@deepseek-ai/dsh-session/types';
+/** Current pinned order (newest pin first). */
+export declare function getPinnedOrder(): readonly SessionId[];
+/** Whether one session is pinned. */
+export declare function isPinned(id: SessionId): boolean;
+/** Pin one session to the front, or unpin it when already pinned. */
+export declare function togglePinned(id: SessionId): void;
+/** Subscribe to pinned changes; returns an unsubscribe disposer. */
+export declare function subscribePinned(listener: () => void): () => void;
+/** Current unread set snapshot. */
+export declare function getUnread(): ReadonlySet<SessionId>;
+/** Whether one session is marked unread. */
+export declare function isUnread(id: SessionId): boolean;
+/** Mark one session unread (idempotent). */
+export declare function markUnread(id: SessionId): void;
+/** Clear one session's unread mark (no-op, no notification, when already read). */
+export declare function markRead(id: SessionId): void;
+/** Subscribe to unread changes; returns an unsubscribe disposer. */
+export declare function subscribeUnread(listener: () => void): () => void;
+/** Test-only: drop in-memory state and reload from storage. */
+export declare function __resetSessionFlagsForTest(): void;

package/lib/types/client/settings.d.ts

@@ -1,37 +1,37 @@
-/**
- * Browser-local preference controlling whether the session row's destructive
- * action presents as Archive (default) or Delete. Delete mode renders the
- * row action red with a trash icon and gates the call behind a confirmation
- * modal; the underlying Host verb remains `archiveSession` (the only
- * session-level destructive API exposed by `ctx.workspaces`), which hides
- * the session from grouping surfaces while preserving its log.
- *
- * The preference is persisted to `localStorage` so it survives reloads and
- * remounts without host-side plumbing. Cross-device sync is intentionally
- * out of scope: this is a per-browser UX preference, not a deployment knob.
- */
-/** How the session row's destructive action presents and behaves. */
-export type SessionActionMode = 'archive' | 'delete';
-/** Current action mode snapshot. */
-export declare function getActionMode(): SessionActionMode;
-/** Switch the action mode and notify subscribers. */
-export declare function setActionMode(mode: SessionActionMode): void;
-/** Subscribe to action mode changes; returns an unsubscribe disposer. */
-export declare function subscribeActionMode(listener: () => void): () => void;
-/**
- * Browser-local height (px) of the recent-sessions virtual viewport, set by
- * dragging the separator between the recent block and the workspace browser
- * (or nudging it with arrow keys). `undefined` means "never adjusted" and the
- * stylesheet default (`min(280px, 40vh)`) applies. Persisted to
- * `localStorage` like the action mode; per-browser by design.
- */
-/** Lower bound of the recent-sessions viewport (about two rows). */
-export declare const RECENT_MIN_HEIGHT = 70;
-/** Absolute cap as a sanity net; the live drag clamps against free space. */
-export declare const RECENT_MAX_HEIGHT = 640;
-/** Current recent-sessions viewport height preference, if the user set one. */
-export declare function getRecentViewportHeight(): number | undefined;
-/** Store (or clear with `undefined`) the height preference and notify subscribers. */
-export declare function setRecentViewportHeight(height: number | undefined): void;
-/** Subscribe to recent height changes; returns an unsubscribe disposer. */
-export declare function subscribeRecentViewportHeight(listener: () => void): () => void;
+/**
+ * Browser-local preference controlling whether the session row's destructive
+ * action presents as Archive (default) or Delete. Delete mode renders the
+ * row action red with a trash icon and gates the call behind a confirmation
+ * modal; the underlying Host verb remains `archiveSession` (the only
+ * session-level destructive API exposed by `ctx.workspaces`), which hides
+ * the session from grouping surfaces while preserving its log.
+ *
+ * The preference is persisted to `localStorage` so it survives reloads and
+ * remounts without host-side plumbing. Cross-device sync is intentionally
+ * out of scope: this is a per-browser UX preference, not a deployment knob.
+ */
+/** How the session row's destructive action presents and behaves. */
+export type SessionActionMode = 'archive' | 'delete';
+/** Current action mode snapshot. */
+export declare function getActionMode(): SessionActionMode;
+/** Switch the action mode and notify subscribers. */
+export declare function setActionMode(mode: SessionActionMode): void;
+/** Subscribe to action mode changes; returns an unsubscribe disposer. */
+export declare function subscribeActionMode(listener: () => void): () => void;
+/**
+ * Browser-local height (px) of the recent-sessions virtual viewport, set by
+ * dragging the separator between the recent block and the workspace browser
+ * (or nudging it with arrow keys). `undefined` means "never adjusted" and the
+ * stylesheet default (`min(280px, 40vh)`) applies. Persisted to
+ * `localStorage` like the action mode; per-browser by design.
+ */
+/** Lower bound of the recent-sessions viewport (about two rows). */
+export declare const RECENT_MIN_HEIGHT = 70;
+/** Absolute cap as a sanity net; the live drag clamps against free space. */
+export declare const RECENT_MAX_HEIGHT = 640;
+/** Current recent-sessions viewport height preference, if the user set one. */
+export declare function getRecentViewportHeight(): number | undefined;
+/** Store (or clear with `undefined`) the height preference and notify subscribers. */
+export declare function setRecentViewportHeight(height: number | undefined): void;
+/** Subscribe to recent height changes; returns an unsubscribe disposer. */
+export declare function subscribeRecentViewportHeight(listener: () => void): () => void;