@deepseek-ai/dsh-client-ui-workspace 0.1.6-alpha.2 → 0.1.7-alpha.2

package/lib/types/client/contract/slots.d.ts

@@ -8,8 +8,8 @@
  * - WorkspacePicker fills the conversation empty-state hole (menu + error
  *   dialog shared with the browser).
  *
- * Each registration also declares one **directory-flow hole** (`single`
- * kind): the slot a composed picker package's client half fills with its
+ * Both registrations declare a **directory-flow hole** (`single` kind): the
+ * slot a composed picker package's client half fills with its
  * picking interaction — a renderless native-chooser driver or an in-app
  * browsing dialog. ui-workspace owns the trigger (the "Add workspace…"
  * entry, present only while the hole is occupied) and the adoption
@@ -21,11 +21,21 @@
  * Two holes exist because the two menu surfaces are independent slot entries
  * and a hole has exactly one declaring entry — they carry the same owner
  * contract and the same occupant.
+ *
+ * WorkspaceBrowser also declares the two **Session row action lists**: every
+ * row of a Session's "..." menu is an entry of
+ * `sidebar.workspaces.session.menu.item`, and every hover button at the row's
+ * end is an entry of `sidebar.workspaces.session.row.action`. The shipped
+ * actions — pin, rename, fork, archive — are ordinary entries this package
+ * registers from `apply`, each carrying its own behavior in its own inject
+ * face and reading its own Host state through hooks that face injects, so a
+ * client plugin's action lands beside them by `order` and needs nothing from
+ * the browser beyond the row identity.
  */
-import type { HostObservable, PropsHooks, PropsLocale, PropsRenderSlots, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { HostObservable, InjectFace, PropsHooks, PropsLocale, PropsRenderSlots, PropsRuntime, PropsStore, SlotHookFactory } from '@deepseek-ai/dsh-client-ui-slots';
 import type { SessionSearchResultItem } from '@deepseek-ai/dsh-api-session-controller/client';
 import type { RemoteHostFacts } from '@deepseek-ai/dsh-api-remotes/client';
-import type { WorkspaceId, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { SessionActivity, WorkspaceId, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { createWorkspaceViewStore } from '../stores.ts';
 /**
@@ -45,6 +55,30 @@ export interface DirectoryFlowOwnerProps {
     /** The interaction itself failed (chooser missing, listing denied); the owner shows its error surface. */
     onError: (message: string) => void;
 }
+/** Owner share of one Session row action occurrence: the row the action belongs to. */
+export interface SessionRowOwnerProps {
+    /** Session the row shows. */
+    sessionId: SessionId;
+    /** Row display title: persisted title, project basename, or Session id. */
+    displayTitle: string;
+}
+/** The row menu's open state as its owner holds it: the `useState` pair. */
+export type MenuOpenState = readonly [open: boolean, setOpen: (open: boolean) => void];
+/**
+ * Hook every row-menu entry receives. Rows only render while the menu is
+ * open, so an entry reads it for the setter: `setOpen(false)` dismisses the
+ * menu the entry sits in — the same state the owner's `onClose` sets.
+ */
+export type UseMenuOpenState = () => MenuOpenState;
+/**
+ * Bind the row's render occurrence into the entries' `useMenuOpenState` hook:
+ * the owner supplies its open-state pair as the occurrence's `hookContext`,
+ * and the hook hands that pair back.
+ * @param _standard - framework standard props (unused).
+ * @param state - the menu's open-state pair from the render occurrence.
+ * @returns the hook the entry calls.
+ */
+export declare const menuOpenStateFactory: SlotHookFactory<'sidebar.workspaces.session.menu.item', UseMenuOpenState>;
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface SlotMap {
         /** Directory-flow hole under the conversation empty-state picker (declared by the WorkspacePicker entry). */
@@ -59,6 +93,61 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
             scope: 'root';
             owner: DirectoryFlowOwnerProps;
         };
+        /**
+         * The rows of one Session's "..." menu, in ascending `order`. ui-workspace
+         * registers the shipped rows here — `pin` (100), `rename` (200), `fork`
+         * (300), `archive` (400) — so a plugin row is placed by its own `order`
+         * among them. Use a package-namespaced `id`; reusing a shipped id at
+         * another `priority` shadows that row. Each entry renders one
+         * `role="menuitem"` `<button>` (the shipped rows use ui-primitives'
+         * `MenuItemButton`, which adds the host styling and `separatorBefore`),
+         * decides its own visibility from its own state, and dismisses the menu
+         * through the injected `useMenuOpenState` hook after acting; the list's
+         * keyboard walk and focus return read the DOM, so any such button joins
+         * them. Labels come from the contributing package's locale namespace.
+         * @example
+         * return {
+         *   inject: ['slots'],
+         *   apply(ctx) {
+         *     const copyLabel = 'Copy Session ID' // Localize in the contributing package.
+         *     ctx.slots.inject('sidebar.workspaces.session.menu.item', () => ctx.slots.register(
+         *       { name: 'sidebar.workspaces.session.menu.item', id: 'copy-session-id', order: 500 },
+         *       ({ sessionId, useMenuOpenState }) => {
+         *         const [, setMenuOpen] = useMenuOpenState()
+         *         return React.createElement(
+         *           'button',
+         *           { type: 'button', role: 'menuitem', onClick: () => { setMenuOpen(false); void navigator.clipboard.writeText(sessionId) } },
+         *           copyLabel,
+         *         )
+         *       },
+         *     ))
+         *   },
+         * }
+         */
+        'sidebar.workspaces.session.menu.item': {
+            kind: 'list';
+            scope: 'root';
+            owner: SessionRowOwnerProps;
+            hookContext: MenuOpenState;
+            inject: {
+                hooks: {
+                    menuOpenState: SlotHookFactory<'sidebar.workspaces.session.menu.item', UseMenuOpenState>;
+                };
+            };
+        };
+        /**
+         * The hover buttons at the end of one Session row, in ascending `order`,
+         * after the "..." menu trigger. ui-workspace registers `archive` (100) and
+         * `pin` (200) here. An entry renders one icon button (or nothing, when its
+         * action does not apply to the row) and owns the action it performs. Clicks
+         * inside the strip stay in the strip, so the button needs no propagation
+         * handling to keep the row from opening.
+         */
+        'sidebar.workspaces.session.row.action': {
+            kind: 'list';
+            scope: 'root';
+            owner: SessionRowOwnerProps;
+        };
     }
 }
 /** The two directory-flow holes; a flow package's client half registers its one component into both. */
@@ -111,10 +200,10 @@ export type WorkspaceBrowserInjected = {
     }>;
     /** Maximum number of merged rows rendered for one search. */
     searchResultLimit: number;
-    /** Rename a Session (explicit user title; resolves on host acceptance). */
-    renameSession: (sessionId: SessionId, title: string) => Promise<void>;
-    /** Fork a Session at its last completed turn and open the child. */
-    forkSession: (sessionId: SessionId) => void;
+    /** Open the Session rename dialog (a row title double-click); the rename action entry raises the same request. */
+    requestSessionRename: (sessionId: SessionId, currentTitle: string) => void;
+    /** Tell the user an archived row cannot be opened (a click on it). */
+    notifyArchivedNotOpenable: () => void;
     /** Rename a Host Workspace (rejects on name conflict; resolves on durability). */
     renameWorkspace: (workspaceId: WorkspaceId, title: string) => Promise<void>;
     /** Delete only a Host Workspace registration; directory and Session logs remain. */
@@ -124,19 +213,167 @@ export type WorkspaceBrowserInjected = {
      * Omitted anchor appends to the end.
      */
     insertWorkspaceBefore: (workspaceId: WorkspaceId, beforeWorkspaceId?: WorkspaceId) => Promise<void>;
-    /**
-     * Archive a Session into the registry-global set: hidden from grouping
-     * surfaces, log and accounting slot retained. Archiving the current
-     * session clears the selection into the New Session view state.
-     */
-    archiveSession: (sessionId: SessionId) => Promise<void>;
+    /** Remove a Session from the registry-global archived set (the search results' restore button). */
+    unarchiveSession: (sessionId: SessionId) => Promise<void>;
     /** Adopt a picked host directory as a real Workspace before targeting a Session. */
     createWorkspace: (input: {
         path: string;
     }) => Promise<WorkspaceView>;
 };
+/** The browser's declared viewing store handle, shared with the row actions that write view state. */
+export type WorkspaceViewStoreHandle = ReturnType<typeof createWorkspaceViewStore>;
+/** Props of one shipped row-menu entry: owner share + locale seat + the entry's own injected share. */
+export type SessionMenuItemProps<Injected extends object = object> = PropsRuntime<'sidebar.workspaces.session.menu.item'> & PropsLocale<'workspace'> & InjectFace<Injected>;
+/** Props of one shipped row hover button: owner share + locale seat + the entry's own injected share. */
+export type SessionRowActionProps<Injected extends object = object> = PropsRuntime<'sidebar.workspaces.session.row.action'> & PropsLocale<'workspace'> & InjectFace<Injected>;
+/** One transient Workspace notice rendered by the overlay toast entry. */
+export type RowToast = {
+    kind: 'archived';
+    sessionId: SessionId;
+} | {
+    kind: 'stoppedAndArchived';
+    sessionId: SessionId;
+} | {
+    kind: 'pinFailed';
+} | {
+    kind: 'unpinFailed';
+} | {
+    kind: 'archivedNotOpenable';
+} | {
+    kind: 'defaultWorkspaceFailed';
+}
+/**
+ * An explicit New Session request that failed. `message` is untranslated:
+ * a Host refusal as `code: message` — the stable code stays in the copy so
+ * a report can be searched by it — and any other failure's own message.
+ */
+ | {
+    kind: 'createFailed';
+    message: string;
+};
+/** The notice on display; `seq` keys remounts so a repeated notice restarts its hold. */
+export type RowToastState = RowToast & {
+    seq: number;
+};
+/**
+ * Pin action share (menu row and hover button). The callbacks carry the whole
+ * behavior: the Host call, fronting the Session in its saved orders after a
+ * pin, and the failure notice. The hooks are the registry-global sets as
+ * Sets, so a row reads its own membership with one lookup.
+ */
+export interface PinSessionInjected {
+    hooks: {
+        /** Pinned Session ids. */
+        pinned: HostObservable<ReadonlySet<SessionId>>;
+        /** Archived Session ids (pin does not apply to an archived row). */
+        archived: HostObservable<ReadonlySet<SessionId>>;
+    };
+    /** Pin a Session; on success it leads its accounts' saved orders, on failure the notice says so. */
+    pinSession: (sessionId: SessionId) => void;
+    /** Unpin a Session; saved positions stay as they are. */
+    unpinSession: (sessionId: SessionId) => void;
+}
+/**
+ * Archive action share (menu row and hover button). The callbacks carry the
+ * whole behavior: the Host call, the notice a success raises, the
+ * stop-and-archive confirmation a Host refusal for running work raises, and
+ * the diagnostics for any other rejection.
+ */
+export interface ArchiveSessionInjected {
+    hooks: {
+        /** Archived Session ids. */
+        archived: HostObservable<ReadonlySet<SessionId>>;
+    };
+    /**
+     * Archive a Session into the registry-global set: the row keeps its
+     * account position and shows per the archived filter; archiving the
+     * current session clears the selection into the New Session view state.
+     * A Session with running work is not archived by this call: the Host's
+     * refusal opens the stop-and-archive confirmation instead.
+     */
+    archiveSession: (sessionId: SessionId) => void;
+    /** Remove a Session from the registry-global archived set. */
+    unarchiveSession: (sessionId: SessionId) => void;
+}
+/**
+ * A stop-and-archive confirmation the archive action asked for: the Host
+ * refused the plain archive because this work still runs.
+ */
+export interface SessionArchiveConfirmRequest {
+    /** Session to stop and archive. */
+    sessionId: SessionId;
+    /** The row's display title, named in the dialog. */
+    displayTitle: string;
+    /** What the Host reported running, in family order. */
+    activity: readonly SessionActivity[];
+}
+/**
+ * Stop-and-archive dialog share: the pending confirmation, its settlement,
+ * and the archive hop that asks the Host to stop the work first.
+ */
+export interface SessionArchiveConfirmInjected {
+    hooks: {
+        /** The confirmation asked for, until the dialog consumes or cancels it. */
+        archiveRequest: HostObservable<SessionArchiveConfirmRequest | null>;
+    };
+    /** Consume or cancel the pending confirmation. */
+    settleSessionArchive: () => void;
+    /**
+     * Archive a Session after the Host stops its running work; resolves once
+     * the archive set is durable (the stops settle in the background) and
+     * raises the stopped-and-archived notice.
+     */
+    stopAndArchiveSession: (sessionId: SessionId) => Promise<void>;
+}
+/** Fork action share. */
+export interface ForkSessionInjected {
+    /** Fork a Session at its last completed turn; the child arrives through the Host list. */
+    forkSession: (sessionId: SessionId) => void;
+}
+/** Rename action share: the row only raises the request; the dialog entry answers it. */
+export interface RenameSessionInjected {
+    /** Ask for the rename dialog, seeded with the row's current title. */
+    requestSessionRename: (sessionId: SessionId, currentTitle: string) => void;
+}
+/** A Session rename the rename action asked for; the dialog entry opens on it. */
+export interface SessionRenameTarget {
+    /** Session to rename. */
+    sessionId: SessionId;
+    /** Title the dialog seeds its draft from. */
+    currentTitle: string;
+}
+/** Rename dialog share: the pending request, its settlement, and the rename hop the dialog confirms with. */
+export interface SessionRenameDialogInjected {
+    hooks: {
+        /** The rename asked for, until the dialog consumes or cancels it. */
+        renameRequest: HostObservable<SessionRenameTarget | null>;
+    };
+    /** Consume or cancel the pending request. */
+    settleSessionRename: () => void;
+    /** Rename a Session (explicit user title; resolves on host acceptance). */
+    renameSession: (sessionId: SessionId, title: string) => Promise<void>;
+}
+/** Row toast share: the notice on display, its dismissal, and the two actions the archived notice offers. */
+export interface RowToastInjected {
+    hooks: {
+        /** The notice on display, or none. */
+        toast: HostObservable<RowToastState | null>;
+    };
+    /** Take the notice down. */
+    dismissToast: () => void;
+    /** Undo an archive from its notice. */
+    undoArchive: (sessionId: SessionId) => void;
+    /** Switch the archived filter to "show" so the archived row is back in view. */
+    showArchived: () => void;
+}
+/** Props of the rename dialog entry in `shell.overlay`. */
+export type SessionRenameDialogProps = PropsRuntime<'shell.overlay'> & PropsLocale<'workspace'> & Omit<SessionRenameDialogInjected, 'hooks'> & PropsHooks<SessionRenameDialogInjected['hooks']>;
+/** Props of the stop-and-archive dialog entry in `shell.overlay`. */
+export type SessionArchiveConfirmProps = PropsRuntime<'shell.overlay'> & PropsLocale<'workspace'> & Omit<SessionArchiveConfirmInjected, 'hooks'> & PropsHooks<SessionArchiveConfirmInjected['hooks']>;
+/** Props of the row toast entry in `shell.overlay`. */
+export type RowToastProps = PropsRuntime<'shell.overlay'> & PropsLocale<'workspace'> & Omit<RowToastInjected, 'hooks'> & PropsHooks<RowToastInjected['hooks']>;
 /** Full browser props: shell owner share + viewing store + injected actions + the locale seat. */
-export type WorkspaceBrowserProps = PropsRuntime<'sidebar.workspaces'> & PropsRenderSlots<'sidebar.workspaces.directoryFlow'> & PropsStore<ReturnType<typeof createWorkspaceViewStore>> & Omit<WorkspaceBrowserInjected, 'hooks'> & PropsHooks<WorkspaceBrowserInjected['hooks']> & PropsLocale<'workspace'>;
+export type WorkspaceBrowserProps = PropsRuntime<'sidebar.workspaces'> & PropsRenderSlots<'sidebar.workspaces.directoryFlow' | 'sidebar.workspaces.session.menu.item' | 'sidebar.workspaces.session.row.action'> & PropsStore<WorkspaceViewStoreHandle> & Omit<WorkspaceBrowserInjected, 'hooks'> & PropsHooks<WorkspaceBrowserInjected['hooks']> & PropsLocale<'workspace'>;
 /**
  * Picker-private injected share. Pick semantics remain in the owner's onPick
  * callback; this callback creates only the real Host Workspace. A type alias
@@ -153,5 +390,5 @@ export type WorkspacePickerInjected = DirectoryPickingInjected & {
  * locale seat. The two picker holes (blank-session hero / New-Session view)
  * share one owner currency, so one composed type serves both registrations.
  */
-export type WorkspacePickerProps = PropsRuntime<'conversation.hero.workspace'> & PropsRenderSlots<'conversation.hero.workspace.directoryFlow'> & Omit<WorkspacePickerInjected, 'hooks'> & DirectoryPickingHooks & PropsLocale<'workspace'>;
+export type WorkspacePickerProps = PropsRuntime<'conversation.hero.workspace'> & PropsRenderSlots<'conversation.hero.workspace.directoryFlow'> & Omit<WorkspacePickerInjected, 'hooks'> & PropsHooks<WorkspacePickerInjected['hooks']> & PropsLocale<'workspace'>;
 //# sourceMappingURL=slots.d.ts.map

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

@@ -5,7 +5,11 @@
  * (`conversation.hero.workspace` — both hero forms). Both read real Host
  * Workspaces through the global useWorkspaces hook, and each declares its
  * own `single` directory-flow child hole for the composed picker package's
- * client half (see the contract module doc). Export discipline:
+ * client half. WorkspaceBrowser additionally declares the two Session row
+ * action lists, and this apply registers the shipped actions — pin, rename,
+ * fork, archive — into them the way any client plugin would, each with its
+ * own behavior, plus the rename dialog and the row-action notice into
+ * `shell.overlay` (see the contract module doc). Export discipline:
  * packages/client/AGENTS.md.
  */
 import type { Context } from '@deepseek-ai/cordis';
@@ -13,7 +17,7 @@ import type { WorkspaceSnapshot } from '@deepseek-ai/dsh-api-workspace-controlle
 import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
 import { type WorkspaceKey } from './locales.ts';
 export type { UiWorkspace } from './navigation.ts';
-export type { DirectoryFlowOwnerProps, DirectoryFlowSlotName, DirectoryPickingHooks, DirectoryPickingInjected, WorkspaceBrowserInjected, WorkspaceBrowserProps, WorkspacePickerInjected, WorkspacePickerProps, } from './contract/slots.ts';
+export type { DirectoryFlowOwnerProps, DirectoryFlowSlotName, DirectoryPickingHooks, DirectoryPickingInjected, MenuOpenState, RowToast, SessionRenameTarget, SessionRowOwnerProps, UseMenuOpenState, WorkspaceBrowserInjected, WorkspaceBrowserProps, WorkspacePickerInjected, WorkspacePickerProps, } from './contract/slots.ts';
 export type { WorkspaceKey } from './locales.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface GlobalStandardProps {

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

@@ -5,6 +5,8 @@
  */
 /** Simplified Chinese dictionary (the key-set source of truth). */
 export declare const zh: {
+    'defaultWorkspace.failed': string;
+    'defaultWorkspace.title': string;
     'group.ungrouped': string;
     'session.new': string;
     'section.workspaces': string;
@@ -17,6 +19,9 @@ export declare const zh: {
     'orderBy.label': string;
     'orderBy.manual': string;
     'orderBy.updated': string;
+    'filterBy.label': string;
+    'viewOptions.showArchived': string;
+    'viewOptions.onlyArchived': string;
     'sessions.expand': string;
     'sessions.collapse': string;
     'empty.none': string;
@@ -27,7 +32,6 @@ export declare const zh: {
     'search.clear': string;
     'search.results.aria': string;
     'search.pending': string;
-    'search.unavailable': string;
     'search.noMatches': string;
     'search.hasMore': string;
     'menu.addWorkspace': string;
@@ -45,10 +49,44 @@ export declare const zh: {
     '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;
     '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;
@@ -57,6 +95,9 @@ export declare const zh: {
     'status.waitingApproval': string;
     'status.planReview': string;
     'status.waitingAnswer': string;
+    'status.compact.approval': string;
+    'status.compact.planReview': string;
+    'status.compact.answer': string;
     'status.completed': string;
     'schedule.active': string;
     'hover.created': string;
@@ -74,6 +115,8 @@ export declare const zh: {
 export type WorkspaceKey = keyof typeof zh;
 /** English dictionary, checked complete against the zh key set. */
 export declare const en: {
+    'defaultWorkspace.failed': string;
+    'defaultWorkspace.title': string;
     'group.ungrouped': string;
     'session.new': string;
     'section.workspaces': string;
@@ -86,6 +129,9 @@ export declare const en: {
     'orderBy.label': string;
     'orderBy.manual': string;
     'orderBy.updated': string;
+    'filterBy.label': string;
+    'viewOptions.showArchived': string;
+    'viewOptions.onlyArchived': string;
     'sessions.expand': string;
     'sessions.collapse': string;
     'empty.none': string;
@@ -96,7 +142,6 @@ export declare const en: {
     'search.clear': string;
     'search.results.aria': string;
     'search.pending': string;
-    'search.unavailable': string;
     'search.noMatches': string;
     'search.hasMore': string;
     'menu.addWorkspace': string;
@@ -114,10 +159,44 @@ export declare const en: {
     '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;
     '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;
@@ -126,6 +205,9 @@ export declare const en: {
     'status.waitingApproval': string;
     'status.planReview': string;
     'status.waitingAnswer': string;
+    'status.compact.approval': string;
+    'status.compact.planReview': string;
+    'status.compact.answer': string;
     'status.completed': string;
     'schedule.active': string;
     'hover.created': string;

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

@@ -4,6 +4,8 @@ import type { ClientRemote, DirectoryListing, RemoteFailure } from '@deepseek-ai
 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 { RowToast } from './contract/slots.ts';
+import type { WorkspaceViewStoreActions } from './stores.ts';
 /** Workspace archive and directory operations consumed by Client UI domains. */
 export interface UiWorkspace {
     /**
@@ -16,12 +18,14 @@ export interface UiWorkspace {
      * @param workspaceId - target Workspace.
      * @param beforeOpen - optional synchronous preparation for the selected Session, skipped after supersession.
      * @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 and open the child unless a later navigation supersedes it.
+     * Fork a Session without changing the current selection.
      * @param sessionId - source Session.
-     * @returns completion; a superseded request leaves its child available without selecting it.
+     * @returns completion after child creation and inherited-title increment.
      */
     forkSession(sessionId: SessionId): Promise<void>;
     /**
@@ -31,20 +35,37 @@ export interface UiWorkspace {
      */
     connectWorkspace(workspaceId: WorkspaceId): Promise<SessionId>;
     /**
-     * Start a New Session flow and navigate to its Session.
+     * Start a New Session flow and navigate to its Session; 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.
      */
     startSession(workspaceId?: WorkspaceId): 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): Promise<void>;
+    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.
@@ -83,6 +104,8 @@ 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;
@@ -92,19 +115,29 @@ declare class UiWorkspaceService extends Service implements UiWorkspace {
      * @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);
+    constructor(ctx: Context, directoryPicker: ClientRemote['directoryPicker'], workspaces: IWorkspaces, sessions: ISessions, view: Pick<WorkspaceViewStoreActions, 'pinSessionOrder'>, notify: (toast: RowToast) => void);
     connectWorkspace(workspaceId: WorkspaceId): Promise<SessionId>;
+    private reuseOrCreateBlank;
+    private reuseBlank;
     openSession(target: SessionTarget): void;
     openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void): Promise<void>;
     forkSession(sessionId: SessionId): Promise<void>;
     startSession(workspaceId?: WorkspaceId): void;
-    archiveSession(sessionId: SessionId): Promise<void>;
+    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;
+    private initializeDefaultWorkspace;
     /** @returns true when an archived current selection was cleared. */
     private clearArchivedCurrent;
     private clearMain;

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