@deepseek-ai/dsh-client-ui-workspace 0.2.1-alpha.2 → 0.2.1-alpha.3

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

@@ -26,8 +26,8 @@
  * 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
+ * actions — pin, rename, fork, archive, copy ID — are ordinary entries
+ * registered 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.
@@ -137,8 +137,8 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
         /**
          * 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
+         * (300), `archive` (400), and `session-id` (450) — 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`),
@@ -150,14 +150,17 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
          * return {
          *   inject: ['slots'],
          *   apply(ctx) {
-         *     const copyLabel = 'Copy Session ID' // Localize in the contributing package.
+         *     const copyLabel = 'Copy session title' // 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 }) => {
+         *       { name: 'sidebar.workspaces.session.menu.item', id: 'copy-session-title', order: 500 },
+         *       ({ displayTitle, useMenuOpenState }) => {
          *         const [, setMenuOpen] = useMenuOpenState()
          *         return React.createElement(
          *           'button',
-         *           { type: 'button', role: 'menuitem', onClick: () => { setMenuOpen(false); void navigator.clipboard.writeText(sessionId) } },
+         *           {
+         *             type: 'button', role: 'menuitem',
+         *             onClick: () => { setMenuOpen(false); void navigator.clipboard.writeText(displayTitle) },
+         *           },
          *           copyLabel,
          *         )
          *       },
@@ -234,8 +237,6 @@ export type WorkspaceBrowserInjected = {
     closeAddWorkspace: () => void;
     /** Publish directory interaction occupancy for command availability. */
     setDirectoryBusy: (busy: boolean) => void;
-    /** Dismiss the shortcut's fork-failure notification. */
-    dismissForkError: () => void;
     /**
      * Create a fresh Session, or preserve a reusable blank with explicit draft options.
      * Without an explicit Workspace, inherit the current Session Workspace,
@@ -287,6 +288,10 @@ export type RowToast = {
 } | {
     kind: 'stoppedAndArchived';
     sessionId: SessionId;
+} | {
+    kind: 'sessionIdCopied';
+} | {
+    kind: 'sessionIdCopyFailed';
 } | {
     kind: 'pinFailed';
 } | {
@@ -298,6 +303,9 @@ export type RowToast = {
 } | {
     kind: 'forkRequiresOpen';
     sessionId: SessionId;
+} | {
+    kind: 'shortcutForkFailed';
+    reason: 'unavailable' | 'failed';
 }
 /**
  * An explicit New Session request that failed. `message` is untranslated:
@@ -392,6 +400,11 @@ export interface RenameSessionInjected {
     /** Ask for the rename dialog, seeded with the row's current title. */
     requestSessionRename: (sessionId: SessionId, currentTitle: string) => void;
 }
+/** Session ID action share; copying does not open the Session. */
+export interface SessionIdInjected {
+    /** Copy the complete id and report acceptance or failure through the global toast. */
+    copySessionId: (sessionId: SessionId) => Promise<void>;
+}
 /** A Session rename the rename action asked for; the dialog entry opens on it. */
 export interface SessionRenameTarget {
     /** Session to rename. */
@@ -410,7 +423,7 @@ export interface SessionRenameDialogInjected {
     /** Rename a Session (explicit user title; resolves on host acceptance). */
     renameSession: (sessionId: SessionId, title: string) => Promise<void>;
 }
-/** Row toast share: the notice, dismissal, archive recovery, and explicit source-history opening. */
+/** Existing overlay share: the current notice and its dismissal. */
 export interface RowToastInjected {
     hooks: {
         /** The notice on display, or none. */
@@ -418,6 +431,9 @@ export interface RowToastInjected {
     };
     /** Take the notice down. */
     dismissToast: () => void;
+}
+/** Business callbacks injected into their keyed Toast presentations. */
+export interface RowToastActions {
     /** Undo an archive from its notice. */
     undoArchive: (sessionId: SessionId) => void;
     /** Switch the archived filter to "show" so the archived row is back in view. */
@@ -429,12 +445,8 @@ export interface RowToastInjected {
 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`. The declared viewing store
- * carries the archived filter; the archived notice omits its filter action
- * when archived rows are already visible.
- */
-export type RowToastProps = PropsRuntime<'shell.overlay'> & PropsLocale<'workspace'> & PropsStore<WorkspaceViewStoreHandle> & Omit<RowToastInjected, 'hooks'> & PropsHooks<RowToastInjected['hooks']>;
+/** Props of the existing overlay's keyed notice dispatcher. */
+export type RowToastProps = PropsRuntime<'shell.overlay'> & PropsRenderSlots<'workspace.toast'> & Pick<RowToastInjected, 'dismissToast'> & 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' | 'sidebar.workspaces.session.menu.item' | 'sidebar.workspaces.session.row.action' | 'sidebar.session.row.leading' | 'sidebar.session.row.hover'> & PropsStore<WorkspaceViewStoreHandle> & Omit<WorkspaceBrowserInjected, 'hooks'> & PropsHooks<WorkspaceBrowserInjected['hooks']> & PropsLocale<'workspace'>;
 /**

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

@@ -0,0 +1,67 @@
+/** Keyed Workspace notices and the shared Toast Factory's display data. */
+import type { FactoryComponentPropsOf, InjectFace, PropsLocale, PropsRenderFactories, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { RowToastState, WorkspaceViewStoreHandle } from './slots.ts';
+/** Business key of one existing Workspace notice. */
+export type ToastKind = RowToastState['kind'];
+/** Notice payload selected by the keyed registration. */
+export type ToastNotice<K extends ToastKind> = Extract<RowToastState, {
+    kind: K;
+}>;
+/** Plain display fields consumed by the shared Factory. */
+export interface ToastDisplay {
+    text: string;
+    tone: 'plain' | 'warning' | 'success';
+    holdMs?: number;
+    actions?: readonly {
+        label: string;
+        prefix?: string;
+        onClick: () => void;
+    }[];
+}
+/** Per-display identity and dismissal; neither changes when localized content updates. */
+export interface ToastOccurrence extends ToastDisplay {
+    seq: number;
+    onDone: () => void;
+}
+/** Pure localized display mapping owned by a keyed notice registration. */
+export interface ToastDisplayInjected<K extends ToastKind> {
+    display: (notice: ToastNotice<K>, t: PropsLocale<'workspace'>['t'], dismiss: () => void) => ToastDisplay;
+}
+/** Shared adapter props; each registration narrows its notice payload. */
+export type ToastEntryProps<P extends PropsRuntime<'workspace.toast'>> = P & PropsLocale<'workspace'> & PropsRenderFactories & InjectFace<{
+    display: (notice: P, t: PropsLocale<'workspace'>['t'], dismiss: () => void) => ToastDisplay;
+}>;
+/** Archive adapters additionally read the existing viewing store. */
+export interface ArchiveToastInjected extends ToastDisplayInjected<'archived' | 'stoppedAndArchived'> {
+    filterAction: (t: PropsLocale<'workspace'>['t'], dismiss: () => void) => NonNullable<ToastDisplay['actions']>[number];
+}
+/** Archive adapter props with its injected action and viewing-state seats. */
+export type ArchiveToastEntryProps = PropsRuntime<'workspace.toast', 'archived' | 'stoppedAndArchived'> & PropsLocale<'workspace'> & PropsRenderFactories & PropsStore<WorkspaceViewStoreHandle> & InjectFace<ArchiveToastInjected>;
+/** Complete props of the shared Workspace Toast Factory. */
+export type WorkspaceToastProps = FactoryComponentPropsOf<'workspace.toast.content'>;
+/** Owner operations available to every keyed Workspace notice. */
+export interface WorkspaceToastOwnerProps {
+    /** Dismiss the displayed notice. */
+    dismissToast: () => void;
+}
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotMap {
+        /** Workspace notices selected by their existing business discriminator. */
+        'workspace.toast': {
+            kind: 'keyed';
+            scope: 'root';
+            owner: WorkspaceToastOwnerProps;
+            keyProps: {
+                [K in ToastKind]: ToastNotice<K>;
+            };
+        };
+    }
+    interface SlotFactoryMap {
+        /** Shared Toast presentation; business registrations supply only display data and callbacks. */
+        'workspace.toast.content': {
+            scope: 'root';
+            props: ToastOccurrence;
+        };
+    }
+}
+//# sourceMappingURL=toast.d.ts.map

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

@@ -1,5 +1,6 @@
 import type { Context } from '@deepseek-ai/cordis';
-import type { WorkspaceSnapshot } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { WorkspaceId, WorkspaceSnapshot } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { RemoteEndpoint } from '@deepseek-ai/dsh-api-remote-access/client';
 import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
 import { type WorkspaceKey } from './locales.ts';
 export type { StartSessionOptions, UiWorkspace } from './navigation.ts';
@@ -9,6 +10,8 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface GlobalStandardProps {
         /** Selector hook over the pure Workspace Controller snapshot. */
         useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>;
+        /** Whether the current Peer may call `action` on one Workspace resource. */
+        useWorkspaceAccess: (workspaceId: WorkspaceId, action: RemoteEndpoint) => boolean;
     }
     interface LocaleNamespaceMap {
         /** The workspace browsing region and pick/create flow copy. */

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

@@ -62,6 +62,9 @@ export declare const zh: {
     'menu.unarchiveSession': string;
     'menu.pinSession': string;
     'menu.unpinSession': string;
+    'menu.sessionId': string;
+    'toast.sessionIdCopied': string;
+    'toast.sessionIdCopyFailed': string;
     'row.archived': string;
     'row.pinned': string;
     'toast.archivedNotOpenable': string;
@@ -183,6 +186,9 @@ export declare const en: {
     'menu.unarchiveSession': string;
     'menu.pinSession': string;
     'menu.unpinSession': string;
+    'menu.sessionId': string;
+    'toast.sessionIdCopied': string;
+    'toast.sessionIdCopyFailed': string;
     'row.archived': string;
     'row.pinned': string;
     'toast.archivedNotOpenable': string;

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

@@ -7,8 +7,11 @@ 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;
+/** Content preparation and Agent preset for the Session a Workspace flow opens. */
+export interface StartSessionOptions extends DraftInitializationOptions {
+    /** Agent preset the Session runs; the Host default when omitted. */
+    readonly agentPreset?: string;
+}
 /** Workspace archive and directory operations consumed by Client UI domains. */
 export interface UiWorkspace {
     /**
@@ -21,11 +24,12 @@ export interface UiWorkspace {
      * @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.
+     * @param options - choices for the Session the connection creates or reuses.
      * @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>;
+    openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void, options?: Pick<StartSessionOptions, 'agentPreset'>): Promise<void>;
     /**
      * Fork a Session without changing the current selection.
      * @param sessionId - source Session.
@@ -35,16 +39,20 @@ export interface UiWorkspace {
      */
     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.
+     * Resolve the Session for a new conversation in a Workspace: the Host reuses
+     * the first listed blank member while it is reusable and otherwise creates one,
+     * under the requested preset or the Host default.
      * @param workspaceId - target Workspace.
+     * @param options - choices for the created or reused Session.
      * @returns a Session already addressable through the Session Controller.
      */
-    connectWorkspace(workspaceId: WorkspaceId): Promise<SessionId>;
+    connectWorkspace(workspaceId: WorkspaceId, options?: Pick<StartSessionOptions, 'agentPreset'>): 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.
+     * @param options - initial content and the reused blank's preset; existing text or attachments
+     * are preserved unless clearPreviousDraft is true.
      */
     startSession(workspaceId?: WorkspaceId, options?: StartSessionOptions): void;
     /**
@@ -113,6 +121,7 @@ declare class UiWorkspaceService extends Service implements UiWorkspace {
     private readonly sessions;
     private readonly view;
     private readonly notify;
+    /** The latest in-flight connection per Workspace; a request joins it only when both name the same preset. */
     private readonly connecting;
     private readonly lifetime;
     private readonly selection;
@@ -126,12 +135,28 @@ declare class UiWorkspaceService extends Service implements UiWorkspace {
      * @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>;
+    connectWorkspace(workspaceId: WorkspaceId, options?: Pick<StartSessionOptions, 'agentPreset'>): Promise<SessionId>;
+    /**
+     * @param reuse - preset for the reused or created blank; absent creates a fresh Session.
+     */
     private connectBlank;
-    private reuseOrCreateBlank;
-    private reuseBlank;
+    private createInWorkspace;
+    /**
+     * Create through the Host. A named blank the Host declined may still read as
+     * blank from stale cached list metadata, which hides it from the Session tree;
+     * its projections are reloaded so the row reflects its log.
+     */
+    private createNamed;
+    /**
+     * Reopen a saved blank Session under the preset its log recorded, or under
+     * the Host default once that preset no longer activates. Listed values are
+     * cached hints that can lag the log after an unclean Host exit, so the
+     * Session's projections are reloaded before the preset is read; a Session
+     * that still awaits a format migration reloads only those cached hints.
+     */
+    private restoreBlank;
     openSession(target: SessionTarget): void;
-    openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void): Promise<void>;
+    openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void, options?: Pick<StartSessionOptions, 'agentPreset'>): 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;

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

@@ -4,5 +4,5 @@ import type { WorkspaceBrowserProps } from '../contract/slots.ts';
  * @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;
+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, renderSlot, t, }: WorkspaceBrowserProps): import("react").JSX.Element;
 //# sourceMappingURL=WorkspaceBrowser.d.ts.map

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

@@ -1,9 +1,10 @@
 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.
+ * arrives through the Host list beside its source. Absent when the access
+ * snapshot excludes `session/fork` for this Session.
+ * @param props - owner share, menu open state, access Hook, and the fork share.
+ * @returns the row, or nothing when the caller may not fork this Session.
  */
-export declare function ForkSessionMenuItem({ sessionId, useMenuOpenState, useShortcuts, forkSession, t, }: SessionMenuItemProps<ForkSessionInjected>): import("react").JSX.Element;
+export declare function ForkSessionMenuItem({ sessionId, useMenuOpenState, useShortcuts, useSessionAccess, forkSession, t, }: SessionMenuItemProps<ForkSessionInjected>): import("react").JSX.Element | null;
 //# sourceMappingURL=ForkSession.d.ts.map

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

@@ -1,8 +1,9 @@
+/** The existing overlay dispatches the latest Workspace notice to its keyed presentation. */
 import type { RowToastProps } from '../contract/slots.ts';
 /**
- * Render an operation notice, retaining recovery actions for six seconds.
- * @param props - notice and viewing sources, dismissal and recovery callbacks, and localized copy.
- * @returns the notice on display, or null.
+ * Dispatch the current notice without interpreting its business payload.
+ * @param props - Current notice, dismissal, and the declared keyed renderer.
+ * @returns The selected notice presentation, or nothing.
  */
-export declare function RowActionToast({ useToast, useStore, dismissToast, undoArchive, showArchived, openForkSource, t }: RowToastProps): import("react").JSX.Element | null;
+export declare function RowActionToast({ useToast, dismissToast, renderSlot }: RowToastProps): import("react").ReactNode;
 //# sourceMappingURL=RowActionToast.d.ts.map

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

@@ -0,0 +1,8 @@
+import type { SessionIdInjected, SessionMenuItemProps } from '../contract/slots.ts';
+/**
+ * Copy the complete ID after dismissing the row menu.
+ * @param props - Row identity, menu dismissal, clipboard action, and locale.
+ * @returns The final built-in menu item.
+ */
+export declare function SessionIdMenuItem({ sessionId, useMenuOpenState, copySessionId, t }: SessionMenuItemProps<SessionIdInjected>): import("react").JSX.Element;
+//# sourceMappingURL=SessionId.d.ts.map

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

@@ -12,10 +12,6 @@ export interface WorkspaceShortcutState {
         readonly sessionId: SessionId;
         readonly currentTitle: string;
     } | null;
-    readonly forkError: {
-        readonly reason: 'unavailable' | 'failed';
-        readonly seq: number;
-    } | null;
 }
 interface WorkspaceShortcutControls {
     state: SnapshotStore<WorkspaceShortcutState>;
@@ -25,8 +21,6 @@ interface WorkspaceShortcutControls {
     directoryBusy: (busy: boolean) => void;
     rename: (sessionId: SessionId, currentTitle: string) => void;
     closeRename: () => void;
-    forkFailed: (reason: 'unavailable' | 'failed') => void;
-    dismissForkError: () => void;
 }
 /**
  * Create the private browser request source shared by commands and controls.
@@ -40,7 +34,8 @@ export declare function createWorkspaceShortcutControls(): WorkspaceShortcutCont
  * @param navigation - session creation and forking from the pointer controls' navigation service.
  * @param controls - browser-owned opening requests.
  * @param archiveSession - shared archive action, including running-work confirmation and notices.
+ * @param reportForkFailure - publish a classified failure through the frame-wide notice channel.
  */
-export declare function installWorkspaceShortcuts(ctx: Context, navigation: Pick<UiWorkspace, 'startSession' | 'forkSession'>, controls: ReturnType<typeof createWorkspaceShortcutControls>, archiveSession: (sessionId: SessionId) => void): void;
+export declare function installWorkspaceShortcuts(ctx: Context, navigation: Pick<UiWorkspace, 'startSession' | 'forkSession'>, controls: ReturnType<typeof createWorkspaceShortcutControls>, archiveSession: (sessionId: SessionId) => void, reportForkFailure: (reason: 'unavailable' | 'failed') => void): void;
 export {};
 //# sourceMappingURL=shortcuts.d.ts.map

package/lib/types/client/toast/Toast.d.ts

@@ -0,0 +1,21 @@
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ArchiveToastEntryProps, ToastEntryProps, WorkspaceToastProps } from '../contract/toast.ts';
+/**
+ * Render one notice using the shared Factory.
+ * @param props - Keyed payload, injected display mapping, locale, and Factory renderer.
+ * @returns The shared Toast occurrence.
+ */
+export declare function ToastEntry<P extends PropsRuntime<'workspace.toast'>>(props: ToastEntryProps<P>): import("react").ReactNode;
+/**
+ * Keep the archive filter action reactive without subscribing unrelated notices.
+ * @param props - Archive notice, display mapping, and the existing viewing store.
+ * @returns The shared Toast occurrence with its current actions.
+ */
+export declare function ArchiveToastEntry(props: ArchiveToastEntryProps): import("react").ReactNode;
+/**
+ * Present plain display data with the shared primitive's timing and portal.
+ * @param props - Localized display fields, display identity, and dismissal.
+ * @returns One Toast, remounted only for a new display identity.
+ */
+export declare function WorkspaceToast({ seq, text, tone, holdMs, actions, onDone }: WorkspaceToastProps): import("react").JSX.Element;
+//# sourceMappingURL=Toast.d.ts.map

package/lib/types/client/toast/register.d.ts

@@ -0,0 +1,10 @@
+/** Business-owned mappings into the keyed Workspace Toast slot. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { RowToastActions, WorkspaceViewStoreHandle } from '../contract/slots.ts';
+/** Register notice presentations with their business-owned display fields and actions.
+ * @param ctx - Workspace plugin context.
+ * @param viewStore - Viewing store, read only by archive notices.
+ * @param actions - Archive and source-opening callbacks.
+ */
+export declare function registerToasts(ctx: Context, viewStore: WorkspaceViewStoreHandle, actions: Pick<RowToastActions, 'undoArchive' | 'showArchived' | 'openForkSource'>): void;
+//# sourceMappingURL=register.d.ts.map

package/locale/en.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "title": "ui-workspace"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "工作区选择界面",
+    "description": "在侧栏和新会话页面中选择工作区。"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-workspace",
   "description": "Workspace picker plugin: one WorkspacePicker registered into the sidebar and empty-state workspace slots",
-  "version": "0.2.1-alpha.2",
+  "version": "0.2.1-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -23,11 +23,13 @@
       "default": "./lib/client.js"
     },
     "./src/*": "./src/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "dsh": {
     "client": {
       "inject": [
+        "@deepseek-ai/dsh-api-remote-access",
         "@deepseek-ai/dsh-api-remotes",
         "@deepseek-ai/dsh-api-session-controller",
         "@deepseek-ai/dsh-api-workspace-controller",
@@ -45,39 +47,41 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-api-session-controller": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-jobs": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-schedule": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.2",
-    "@types/react": "~18.3.1",
+    "@deepseek-ai/dsh-api-remote-access": "0.2.1-alpha.3",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-jobs": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-schedule": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.3",
     "clsx": "^2.0.0",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-client-shortcuts": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-product-analytics": "0.2.1-alpha.2"
+    "@deepseek-ai/dsh-client-shortcuts": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-product-analytics": "0.2.1-alpha.3"
   },
   "files": [
+    "locale/*.json",
     "lib/index.js",
     "lib/client.js",
     "lib/types/**/*.d.ts"