@umialpha/dsh-client-ui-workspace-groups 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,246 @@
+/**
+ * `workspace` namespace dictionaries: the browsing region (section header,
+ * search, tree rows, dialogs) and the pick/add flow. Runtime failure
+ * messages (wire error strings) pass through untranslated by policy.
+ */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'defaultWorkspace.failed': string;
+    'draft.workspaceRequired': string;
+    'draft.initializationFailed': string;
+    'group.ungrouped': string;
+    'session.new': string;
+    'session.untitled': string;
+    'shortcut.noSession': string;
+    'shortcut.noPicker': string;
+    'shortcut.directoryBusy': string;
+    'shortcut.noCompletedTurn': string;
+    'shortcut.forkFailed': string;
+    'section.workspaces': string;
+    'section.sessions': string;
+    'viewOptions.label': string;
+    'groupBy.label': string;
+    'groupBy.workspace': string;
+    'groupBy.workspaceTree': string;
+    'groupBy.flat': string;
+    'orderBy.label': string;
+    'orderBy.manual': string;
+    'orderBy.updated': string;
+    'filterBy.label': string;
+    'viewOptions.hideArchived': string;
+    'viewOptions.showArchived': string;
+    'viewOptions.onlyArchived': string;
+    'sessions.expand': string;
+    'sessions.collapse': string;
+    'empty.none': string;
+    'empty.noneArchived': string;
+    'empty.viewOthers': string;
+    'empty.noMatches': string;
+    'workspace.add': string;
+    'search.sessions.aria': string;
+    'search.placeholder': string;
+    'search.clear': string;
+    'search.results.aria': string;
+    'search.pending': string;
+    'search.noMatches': string;
+    'search.hasMore': string;
+    'menu.addWorkspace': string;
+    'picker.loading': string;
+    'conflict.named': string;
+    'folderError.title': string;
+    'folderError.retry': string;
+    rename: string;
+    'rename.workspace.title': string;
+    'rename.session.title': string;
+    'field.workspaceName': string;
+    'field.sessionName': string;
+    'delete.workspace': string;
+    'delete.desc': string;
+    'delete.pending': string;
+    'menu.fork': string;
+    'menu.archiveSession': string;
+    'menu.unarchiveSession': string;
+    'menu.pinSession': string;
+    'menu.unpinSession': string;
+    'row.archived': string;
+    'row.pinned': string;
+    'toast.archivedNotOpenable': string;
+    'toast.archived': string;
+    'toast.stoppedAndArchived': string;
+    'archive.confirm.title': string;
+    'archive.confirm.desc': string;
+    'archive.confirm.activity': string;
+    'archive.confirm.turn': string;
+    'archive.confirm.subagents.one': string;
+    'archive.confirm.subagents.other': string;
+    'archive.confirm.jobs.one': string;
+    'archive.confirm.jobs.other': string;
+    'archive.confirm.schedules.one': string;
+    'archive.confirm.schedules.other': string;
+    'archive.confirm.other.one': string;
+    'archive.confirm.other.other': string;
+    'archive.confirm.listSeparator': string;
+    'archive.confirm.action': string;
+    'archive.confirm.pending': string;
+    'toast.archivedUndo': string;
+    'toast.archivedOr': string;
+    'toast.archivedFilter': string;
+    'toast.pinFailed': string;
+    'toast.unpinFailed': string;
+    'toast.createFailed': string;
+    'toast.forkRequiresOpen': string;
+    'toast.openForkSource': string;
+    'sessions.count.one': string;
+    'sessions.count.other': string;
+    'actions.workspace.aria': string;
+    'actions.session.aria': string;
+    'actions.archive': string;
+    'actions.unarchive': string;
+    'actions.pin': string;
+    'actions.unpin': string;
+    'actions.newSession': string;
+    'actions.newSession.aria': string;
+    'status.running': string;
+    'status.subagentsRunning.one': string;
+    'status.subagentsRunning.other': string;
+    'status.idle': string;
+    'status.waitingApproval': string;
+    'status.planReview': string;
+    'status.waitingAnswer': string;
+    'status.compact.approval': string;
+    'status.compact.planReview': string;
+    'status.compact.answer': string;
+    'status.completed': string;
+    'hover.created': string;
+    'hover.copied': string;
+    'date.ymd': string;
+    'time.now': string;
+    'time.minutes': string;
+    'time.hours': string;
+    'time.days': string;
+    'time.months': string;
+    'time.years': string;
+    'time.ago': string;
+};
+/** The workspace namespace key union. */
+export type WorkspaceKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'defaultWorkspace.failed': string;
+    'draft.workspaceRequired': string;
+    'draft.initializationFailed': string;
+    'group.ungrouped': string;
+    'session.new': string;
+    'session.untitled': string;
+    'shortcut.noSession': string;
+    'shortcut.noPicker': string;
+    'shortcut.directoryBusy': string;
+    'shortcut.noCompletedTurn': string;
+    'shortcut.forkFailed': string;
+    'section.workspaces': string;
+    'section.sessions': string;
+    'viewOptions.label': string;
+    'groupBy.label': string;
+    'groupBy.workspace': string;
+    'groupBy.workspaceTree': string;
+    'groupBy.flat': string;
+    'orderBy.label': string;
+    'orderBy.manual': string;
+    'orderBy.updated': string;
+    'filterBy.label': string;
+    'viewOptions.hideArchived': string;
+    'viewOptions.showArchived': string;
+    'viewOptions.onlyArchived': string;
+    'sessions.expand': string;
+    'sessions.collapse': string;
+    'empty.none': string;
+    'empty.noneArchived': string;
+    'empty.viewOthers': string;
+    'empty.noMatches': string;
+    'workspace.add': string;
+    'search.sessions.aria': string;
+    'search.placeholder': string;
+    'search.clear': string;
+    'search.results.aria': string;
+    'search.pending': string;
+    'search.noMatches': string;
+    'search.hasMore': string;
+    'menu.addWorkspace': string;
+    'picker.loading': string;
+    'conflict.named': string;
+    'folderError.title': string;
+    'folderError.retry': string;
+    rename: string;
+    'rename.workspace.title': string;
+    'rename.session.title': string;
+    'field.workspaceName': string;
+    'field.sessionName': string;
+    'delete.workspace': string;
+    'delete.desc': string;
+    'delete.pending': string;
+    'menu.fork': string;
+    'menu.archiveSession': string;
+    'menu.unarchiveSession': string;
+    'menu.pinSession': string;
+    'menu.unpinSession': string;
+    'row.archived': string;
+    'row.pinned': string;
+    'toast.archivedNotOpenable': string;
+    'toast.archived': string;
+    'toast.stoppedAndArchived': string;
+    'archive.confirm.title': string;
+    'archive.confirm.desc': string;
+    'archive.confirm.activity': string;
+    'archive.confirm.turn': string;
+    'archive.confirm.subagents.one': string;
+    'archive.confirm.subagents.other': string;
+    'archive.confirm.jobs.one': string;
+    'archive.confirm.jobs.other': string;
+    'archive.confirm.schedules.one': string;
+    'archive.confirm.schedules.other': string;
+    'archive.confirm.other.one': string;
+    'archive.confirm.other.other': string;
+    'archive.confirm.listSeparator': string;
+    'archive.confirm.action': string;
+    'archive.confirm.pending': string;
+    'toast.archivedUndo': string;
+    'toast.archivedOr': string;
+    'toast.archivedFilter': string;
+    'toast.pinFailed': string;
+    'toast.unpinFailed': string;
+    'toast.createFailed': string;
+    'toast.forkRequiresOpen': string;
+    'toast.openForkSource': string;
+    'sessions.count.one': string;
+    'sessions.count.other': string;
+    'actions.workspace.aria': string;
+    'actions.session.aria': string;
+    'actions.archive': string;
+    'actions.unarchive': string;
+    'actions.pin': string;
+    'actions.unpin': string;
+    'actions.newSession': string;
+    'actions.newSession.aria': string;
+    'status.running': string;
+    'status.subagentsRunning.one': string;
+    'status.subagentsRunning.other': string;
+    'status.idle': string;
+    'status.waitingApproval': string;
+    'status.planReview': string;
+    'status.waitingAnswer': string;
+    'status.compact.approval': string;
+    'status.compact.planReview': string;
+    'status.compact.answer': string;
+    'status.completed': string;
+    'hover.created': string;
+    'hover.copied': string;
+    'date.ymd': string;
+    'time.now': string;
+    'time.minutes': string;
+    'time.hours': string;
+    'time.days': string;
+    'time.months': string;
+    'time.years': string;
+    'time.ago': string;
+};
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +1,157 @@
+/** Workspace archive and directory UI capability. */
+import { Service, type Context } from '@deepseek-ai/cordis';
+import type { ClientRemote, DirectoryListing, RemoteFailure } from '@deepseek-ai/dsh-api-remotes/client';
+import type { ISessions, SessionTarget } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { IWorkspaces, WorkspaceId } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { DraftInitializationOptions } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { RowToast } from './contract/slots.ts';
+import type { WorkspaceViewStoreActions } from './stores.ts';
+/** Optional content preparation for the resolved target Session. */
+export type StartSessionOptions = DraftInitializationOptions;
+/** Workspace archive and directory operations consumed by Client UI domains. */
+export interface UiWorkspace {
+    /**
+     * Select a Session and show its Conversation as one UI navigation action.
+     * @param target - known Session identity or durable direct-parent subagent address to display.
+     */
+    openSession(target: SessionTarget): void;
+    /**
+     * Connect a Workspace and open its Session unless a later navigation supersedes it.
+     * @param workspaceId - target Workspace.
+     * @param beforeOpen - optional synchronous preparation for the selected Session,
+     * skipped after supersession; a throw aborts the open and releases the retained reference.
+     * @returns completion; a superseded request may create a Session but does not open it.
+     * @throws on failure; a refused creation is also shown through the Workspace
+     * notice unless a later navigation or disposal superseded the request.
+     */
+    openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void): Promise<void>;
+    /**
+     * Fork a Session without changing the current selection.
+     * @param sessionId - source Session.
+     * @param onCreated - observer before the optional child-title update.
+     * @param options - optional permission to start source migration; omission preserves the Host default.
+     * @returns the child SessionId after creation and inherited-title increment.
+     */
+    forkSession(sessionId: SessionId, onCreated?: (childId: SessionId) => void, options?: Pick<Parameters<ISessions['fork']>[0], 'allowMigration'>): Promise<SessionId>;
+    /**
+     * Resolve the reusable or newly created blank Session for a Workspace.
+     * @param workspaceId - target Workspace.
+     * @returns a Session already addressable through the Session Controller.
+     */
+    connectWorkspace(workspaceId: WorkspaceId): Promise<SessionId>;
+    /**
+     * Create a fresh Session, or reuse a blank when preparing an explicit draft. A creation the Host
+     * refuses is shown through the Workspace notice and leaves the selection as it was.
+     * @param workspaceId - explicit target; absent inherits the current or most recent Workspace.
+     * @param options - initial content; existing text or attachments are preserved unless clearPreviousDraft is true.
+     */
+    startSession(workspaceId?: WorkspaceId, options?: StartSessionOptions): void;
+    /**
+     * Archive a Session and clear it when it is the current selection.
+     * @param sessionId - Session to archive.
+     * @param options - `stopActivity` asks the Host to stop the Session's running work instead of refusing.
+     */
+    archiveSession(sessionId: SessionId, options?: {
+        readonly stopActivity?: boolean;
+    }): Promise<void>;
+    /**
+     * Unarchive a Session, restoring it to its recorded Workspace position.
+     * @param sessionId - Session to unarchive.
+     */
+    unarchiveSession(sessionId: SessionId): Promise<void>;
+    /**
+     * Pin a Session on the Host, then lead it in its accounts' saved orders
+     * (its Workspace group or Ungrouped, and the flat list). The order write
+     * reads the memberships current at completion, so reorders that landed
+     * while the Host call was pending keep their positions.
+     * @param sessionId - Session to pin.
+     */
+    pinSession(sessionId: SessionId): Promise<void>;
+    /**
+     * Unpin a Session on the Host; saved positions stay as they are.
+     * @param sessionId - Session to unpin.
+     */
+    unpinSession(sessionId: SessionId): Promise<void>;
+    /**
+     * Open the Host-native directory picker.
+     * @returns the selected directory, or null when cancelled.
+     */
+    pickDirectory(): Promise<string | null>;
+    /**
+     * List one Host directory level.
+     * @param path - directory path; absent selects the Host home.
+     * @param signal - cancellation for a superseded scan.
+     * @returns directory entries and breadcrumb ancestry.
+     */
+    listDirectory(path?: string, signal?: AbortSignal): Promise<DirectoryListing>;
+    /**
+     * Create a child directory.
+     * @param path - existing parent directory.
+     * @param name - child directory name.
+     * @returns created absolute path.
+     */
+    createDirectory(path: string, name: string): Promise<string>;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** Cross-Controller Workspace navigation and directory UI capability. */
+        uiWorkspace: UiWorkspace;
+    }
+}
+/** Structured directory failure exposed to directory UI consumers. */
+export declare class DirectoryBrowseError extends Error {
+    readonly rpcError: RemoteFailure;
+    readonly name = "DirectoryBrowseError";
+    /** @param rpcError - Host directory business failure. */
+    constructor(rpcError: RemoteFailure);
+}
+/** Implements Workspace archive and directory UI operations. */
+declare class UiWorkspaceService extends Service implements UiWorkspace {
+    private readonly directoryPicker;
+    private readonly workspaces;
+    private readonly sessions;
+    private readonly view;
+    private readonly notify;
+    private readonly connecting;
+    private readonly lifetime;
+    private readonly selection;
+    private mainReference;
+    /**
+     * @param ctx - Client root Context.
+     * @param directoryPicker - the directory-picking Remote namespace.
+     * @param workspaces - pure Workspace Controller.
+     * @param sessions - pure Session Controller.
+     * @param view - the browser's viewing-store write set (one instance shared with its registration).
+     * @param notify - show one notice through the Workspace notice channel.
+     */
+    constructor(ctx: Context, directoryPicker: ClientRemote['directoryPicker'], workspaces: IWorkspaces, sessions: ISessions, view: Pick<WorkspaceViewStoreActions, 'pinSessionOrder'>, notify: (toast: RowToast) => void);
+    connectWorkspace(workspaceId: WorkspaceId): Promise<SessionId>;
+    private connectBlank;
+    private reuseOrCreateBlank;
+    private reuseBlank;
+    openSession(target: SessionTarget): void;
+    openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void): Promise<void>;
+    private openWorkspaceSession;
+    forkSession(sessionId: SessionId, onCreated?: (childId: SessionId) => void, options?: Pick<Parameters<ISessions['fork']>[0], 'allowMigration'>): Promise<SessionId>;
+    startSession(workspaceId?: WorkspaceId, options?: StartSessionOptions): void;
+    private prepareDraft;
+    private draftPreparationFailed;
+    archiveSession(sessionId: SessionId, options?: {
+        readonly stopActivity?: boolean;
+    }): Promise<void>;
+    unarchiveSession(sessionId: SessionId): Promise<void>;
+    pinSession(sessionId: SessionId): Promise<void>;
+    unpinSession(sessionId: SessionId): Promise<void>;
+    pickDirectory(): Promise<string | null>;
+    listDirectory(path?: string, signal?: AbortSignal): Promise<DirectoryListing>;
+    createDirectory(path: string, name: string): Promise<string>;
+    private watchNavigation;
+    private restoreSelection;
+    /** @returns true when an archived current selection was cleared. */
+    private clearArchivedCurrent;
+    private clearMain;
+    private replaceMain;
+}
+export { UiWorkspaceService };
+//# sourceMappingURL=navigation.d.ts.map

package/lib/types/client/pin-order.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The complete account memberships a Pin order write reconciles against,
+ * derived from the same Host snapshots the browser orders by, so the
+ * UiWorkspace service can complete the write without the browser in the loop.
+ */
+import type { SessionListState } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import { type SessionRowState } from './tree.ts';
+/** What `pinSessionOrder` reconciles a pinned Session's accounts against. */
+export interface PinOrderSource {
+    members: Readonly<Record<string, readonly SessionId[]>>;
+    summaries: SessionListState['byId'];
+    rowState: Pick<SessionRowState, 'pinnedSessionIds' | 'archivedSessionIds'>;
+}
+/**
+ * Every account's complete membership: each Workspace, Ungrouped, and the flat list.
+ * @param workspaces - current Host Workspaces.
+ * @param list - current Session list snapshot.
+ * @param rowState - registry-global pin and archive sets.
+ * @returns the order source for one pin write.
+ */
+export declare function pinOrderSource(workspaces: readonly WorkspaceView[], list: SessionListState, rowState: PinOrderSource['rowState']): PinOrderSource;
+/**
+ * The accounts a pinned Session leads: its group (or Ungrouped) and the flat list.
+ * @param workspaces - current Host Workspaces.
+ * @param sessionId - the Session being pinned.
+ * @returns the account keys `pinSessionOrder` fronts.
+ */
+export declare function pinOrderAccounts(workspaces: readonly WorkspaceView[], sessionId: SessionId): readonly string[];
+//# sourceMappingURL=pin-order.d.ts.map

package/lib/types/client/rows/AnimatedRows.d.ts

@@ -0,0 +1,44 @@
+/** React-commit-driven movement and entry/exit fades for the sidebar's keyed rows. */
+import { Component, type ReactNode } from 'react';
+interface AnimatedRowsProps {
+    children: ReactNode;
+    className: string;
+    label: string;
+    /** Unique DOM-order keys matching the rendered data-row-key attributes. */
+    rowKeys: readonly string[];
+    ready: boolean;
+    /** Changes that replace the view or reveal hidden rows settle immediately. */
+    resetKey: string;
+}
+interface RowPosition {
+    element: HTMLElement;
+    rect: DOMRect;
+    opacity: number;
+}
+interface RowSnapshot {
+    positions: Map<string, RowPosition>;
+    removed: Map<string, RowPosition>;
+}
+/**
+ * Animates keyed sidebar rows only when their rendered membership or order changes.
+ * Motion starts after the first pointer or keyboard input inside the mounted list.
+ * The parent supplies a positioned container for the inert exit overlay.
+ */
+export declare class AnimatedRows extends Component<AnimatedRowsProps> {
+    private armed;
+    private readonly list;
+    private readonly overlay;
+    private readonly movements;
+    private readonly exits;
+    getSnapshotBeforeUpdate(previous: AnimatedRowsProps): RowSnapshot | null;
+    componentDidUpdate(previous: AnimatedRowsProps, _state: unknown, snapshot: RowSnapshot | null): void;
+    componentWillUnmount(): void;
+    private readPositions;
+    private move;
+    private cancelMovements;
+    private removeExit;
+    private clear;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=AnimatedRows.d.ts.map

package/lib/types/client/rows/Rows.d.ts

@@ -0,0 +1,112 @@
+import type { PropsRenderSlots } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ShortcutCatalogEntry } from '@deepseek-ai/dsh-client-shortcuts/client';
+import type { WorkspaceBrowserProps } from '../contract/slots.ts';
+import type { GroupNode, SearchResultNode, SessionNode } from '../tree.ts';
+/** The standard locale seat, prop-passed from the browser root. */
+type RowTranslate = WorkspaceBrowserProps['t'];
+/**
+ * Row drag wiring supplied by the tree owner. `drop` reports the half of the
+ * row where the pointer released so the owner can resolve an insert anchor.
+ */
+export interface RowDragProps {
+    /** Start dragging this row. */
+    start: () => void;
+    /** A compatible row drag is in flight. */
+    active: boolean;
+    /** Current marker on this row: insert line above, below, or none. */
+    marker: 'before' | 'after' | null;
+    /** Report the hovered half while a compatible drag passes over this row. */
+    hover: (half: 'before' | 'after') => void;
+    drop: (half: 'before' | 'after') => void;
+    end: () => void;
+}
+/** Drag lifecycle owned by a workspace row; its enclosing group owns hit testing. */
+interface WorkspaceRowDragProps {
+    start: () => void;
+    end: () => void;
+}
+/**
+ * Project (workspace) header row: folder + title;
+ * hover reveals the chevron and create button, and dwelling on a real
+ * Workspace shows its hover card (the ungrouped bucket has none).
+ * `containsCurrent` arrives on the node (derivation fact, no renderer scan).
+ * @param props.group - derived group node.
+ * @param props.containsCurrentDescendant - highlight an ancestor even when its subtree is collapsed.
+ * @param props.onToggle - expand/collapse the group.
+ * @param props.onCreate - start a frontend Session inside this Workspace.
+ * @param props.drag - optional workspace-row drag wiring.
+ * @param props.home - host account home for POSIX hover-path abbreviation.
+ * @param props.t - the browser root's locale seat.
+ * @returns the row element.
+ */
+export declare function ProjectRowItem({ group, containsCurrentDescendant, onToggle, onCreate, actions, drag, home, newShortcut, t }: {
+    group: GroupNode;
+    newShortcut?: ShortcutCatalogEntry | undefined;
+    containsCurrentDescendant?: boolean;
+    onToggle: () => void;
+    onCreate: () => void;
+    /** Real-Workspace actions; absent for the ungrouped bucket (no menu shown). */
+    actions?: {
+        rename: () => void;
+        delete: () => void;
+    } | undefined;
+    /** Present only for real Workspace rows in the grouped view. */
+    drag?: WorkspaceRowDragProps | undefined;
+    /** Host account home; POSIX home-rooted hover paths display as `~`. */
+    home?: string | undefined;
+    t: RowTranslate;
+}): import("react").JSX.Element;
+/**
+ * One flat search result: title, Workspace context, and optional content
+ * excerpt. Search navigation opens the session only; it does not address an
+ * event inside the conversation. Archived rows carry a hover unarchive
+ * button, because search is where the filter surfaces them for recovery.
+ * @param props.result - merged local/content search row.
+ * @param props.currentId - selected session id.
+ * @param props.onOpen - open the selected session.
+ * @param props.onUnarchive - unarchive an archived result row.
+ * @param props.t - Workspace-browser translation seat.
+ * @returns the result row.
+ */
+export declare function SearchResultItem({ result, currentId, onOpen, onUnarchive, t }: {
+    result: SearchResultNode;
+    currentId: string | undefined;
+    onOpen: (id: SearchResultNode['id']) => void;
+    onUnarchive: (id: SearchResultNode['id']) => void;
+    t: RowTranslate;
+}): import("react").JSX.Element;
+/**
+ * One top-level 32px session row: leading 16px cell (status dot, or the
+ * leading seat while the row's primary state is idle), title, relative time or
+ * compact pending label, and the row actions menu. A row that owns a state dot
+ * keeps that cell and renders no seat, so an ambient automation mark never
+ * appears beside the row's own state dot. An archived row keeps the cell blank:
+ * neither marker renders there, and its live status stays on the hover card.
+ * @param props.node - derived session node.
+ * @param props.currentId - selected session id (row highlight).
+ * @param props.now - epoch ms for relative-time formatting.
+ * @param props.onOpen - open a session by id.
+ * @param props.onRenameRequest - open the rename dialog from a title double-click (id + current title).
+ * @param props.renderSlot - child-seat renderer for the row's action lists
+ * (`sidebar.workspaces.session.menu.item` / `sidebar.workspaces.session.row.action`),
+ * its leading decoration, and its hover-card section.
+ * @param props.onReveal - scroll this row into view after search navigation, then acknowledge it.
+ * @param props.drag - optional row-drag target wiring; blank rows cannot start a drag.
+ * @param props.t - the browser root's locale seat.
+ * @returns the session row.
+ */
+export declare function SessionNodeItem({ node, currentId, now, onOpen, onRenameRequest, renderSlot, onReveal, drag, t, }: {
+    node: SessionNode;
+    currentId: string | undefined;
+    now: number;
+    onOpen: (id: SessionNode['id']) => void;
+    /** Open the rename dialog from a title double-click (id + current title). */
+    onRenameRequest: (id: SessionNode['id'], currentTitle: string) => void;
+    /** Scroll this row into view after search navigation, then acknowledge it. */
+    onReveal?: (() => void) | undefined;
+    /** Present on reorderable-list rows so every row can remain a drop target. */
+    drag?: RowDragProps | undefined;
+    t: RowTranslate;
+} & PropsRenderSlots<'sidebar.workspaces.session.menu.item' | 'sidebar.workspaces.session.row.action' | 'sidebar.session.row.leading' | 'sidebar.session.row.hover'>): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=Rows.d.ts.map

package/lib/types/client/rows/WorkspaceBrowser.d.ts

@@ -0,0 +1,8 @@
+import type { WorkspaceBrowserProps } from '../contract/slots.ts';
+/**
+ * Render the browsing region.
+ * @param props - composed slot props (shell owner share + store + injected actions).
+ * @returns the region element tree.
+ */
+export declare function WorkspaceBrowser({ wide, usePanelInfo, expandSidebar, useSessions, useSessionStatus, useWorkspaces, useStore, actions, startSession, open, requestSessionRename, notifyArchivedNotOpenable, renameWorkspace, deleteWorkspace, insertWorkspaceBefore, unarchiveSession, createWorkspace, searchSessions, searchResultLimit, useDirectoryFlow, useHostInfo, useShortcuts, useWorkspaceShortcuts, requestSearch, requestAddWorkspace, closeAddWorkspace, setDirectoryBusy, dismissForkError, renderSlot, t, }: WorkspaceBrowserProps): import("react").JSX.Element;
+//# sourceMappingURL=WorkspaceBrowser.d.ts.map

package/lib/types/client/session-actions/ArchiveSession.d.ts

@@ -0,0 +1,23 @@
+import type { ArchiveSessionInjected, SessionArchiveConfirmProps, SessionMenuItemProps, SessionRowActionProps } from '../contract/slots.ts';
+/**
+ * Menu row (order 400): archive, or restore an archived row.
+ * @param props - owner share, the archive share, and the menu open state.
+ * @returns the row.
+ */
+export declare function ArchiveSessionMenuItem({ sessionId, useArchived, useMenuOpenState, useShortcuts, archiveSession, unarchiveSession, t, }: SessionMenuItemProps<ArchiveSessionInjected>): import("react").JSX.Element;
+/**
+ * Hover button (order 100): archive, or restore an archived row.
+ * @param props - owner share and the archive share.
+ * @returns the button.
+ */
+export declare function ArchiveSessionRowButton({ sessionId, useArchived, archiveSession, unarchiveSession, t, }: SessionRowActionProps<ArchiveSessionInjected>): import("react").JSX.Element;
+/**
+ * The `shell.overlay` entry: nothing while no confirmation is pending,
+ * otherwise one dialog per request (keyed by the Session). Confirming asks
+ * the Host to stop the listed work and archive; cancelling leaves the
+ * Session running and visible.
+ * @param props - the request hook, its settlement, the stop-and-archive hop, and the locale seat.
+ * @returns the open dialog, or null.
+ */
+export declare function SessionArchiveConfirmDialog({ useArchiveRequest, settleSessionArchive, stopAndArchiveSession, t, }: SessionArchiveConfirmProps): import("react").JSX.Element | null;
+//# sourceMappingURL=ArchiveSession.d.ts.map

package/lib/types/client/session-actions/ForkSession.d.ts

@@ -0,0 +1,9 @@
+import type { ForkSessionInjected, SessionMenuItemProps } from '../contract/slots.ts';
+/**
+ * Menu row (order 300): fork at the Session's last completed turn; the child
+ * arrives through the Host list beside its source.
+ * @param props - owner share, menu open state, and the fork share.
+ * @returns the row.
+ */
+export declare function ForkSessionMenuItem({ sessionId, useMenuOpenState, useShortcuts, forkSession, t, }: SessionMenuItemProps<ForkSessionInjected>): import("react").JSX.Element;
+//# sourceMappingURL=ForkSession.d.ts.map

package/lib/types/client/session-actions/PinSession.d.ts

@@ -0,0 +1,14 @@
+import type { PinSessionInjected, SessionMenuItemProps, SessionRowActionProps } from '../contract/slots.ts';
+/**
+ * Menu row (order 100): pin or unpin by the row's current state; absent on archived rows.
+ * @param props - owner share, the pin share, and the menu open state.
+ * @returns the row, or null for an archived Session.
+ */
+export declare function PinSessionMenuItem(props: SessionMenuItemProps<PinSessionInjected>): import("react").JSX.Element | null;
+/**
+ * Hover button (order 200, rightmost: it lands where the rest-state pin marker sits); absent on archived rows.
+ * @param props - owner share and the pin share.
+ * @returns the button, or null for an archived Session.
+ */
+export declare function PinSessionRowButton(props: SessionRowActionProps<PinSessionInjected>): import("react").JSX.Element | null;
+//# sourceMappingURL=PinSession.d.ts.map