@deepseek-ai/dsh-client-ui-workspace 0.1.1-rc.2 → 0.1.2-alpha.2

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

@@ -9,7 +9,7 @@
  * occupant's own create-folder affordance already covers creating one.
  */
 import type { ReactNode, RefObject } from 'react';
-import type { WorkspaceId, WorkspaceListState, WorkspaceView } from '@deepseek-ai/dsh-client-runtime/client';
+import type { WorkspaceId, WorkspaceSnapshot, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
 import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
 import type { DirectoryFlowOwnerProps, WorkspacePickerProps } from './contract/slots.ts';
 /** Core flow props: the owner supplies popover control and pick semantics. */
@@ -21,7 +21,7 @@ export interface WorkspacePickFlowProps {
     /** The anchor button element — the popover's placement anchor. */
     anchorRef?: RefObject<HTMLElement | null> | undefined;
     /** Selector hook over the workspace list (framework standard hook). */
-    useWorkspaces: <S>(selector: (state: WorkspaceListState) => S) => S;
+    useWorkspaces: <S>(selector: (state: WorkspaceSnapshot) => S) => S;
     /** Adopt a picked host directory as a real Workspace. */
     createWorkspace: (input: {
         path: string;

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

@@ -22,9 +22,11 @@
  * and a hole has exactly one declaring entry — they carry the same owner
  * contract and the same occupant.
  */
-import type { HostDescriptionSource } from '@deepseek-ai/dsh-client-connection/client';
 import type { HostObservable, PropsHooks, PropsLocale, PropsRenderSlots, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
-import type { SessionId, SessionSearchResultItem, WorkspaceId, WorkspaceView } from '@deepseek-ai/dsh-client-runtime/client';
+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 { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { createWorkspaceViewStore } from '../stores.ts';
 /**
  * Owner share of the directory-flow holes: the complete conversation between
@@ -83,8 +85,13 @@ export type DirectoryPickingHooks = PropsHooks<DirectoryPickingInjected['hooks']
  */
 export type WorkspaceBrowserInjected = {
     hooks: DirectoryPickingInjected['hooks'] & {
-        /** Current generation's Host description, bound by the slot renderer. */
-        hostDescription: HostDescriptionSource;
+        /**
+         * Fixed Host facts, reached through a hook rather than injected as values:
+         * the renderer memoizes an entry's inject result for the registration's
+         * lifetime, so facts read there would freeze at whatever the first render
+         * saw. Select the field the surface needs (`info => info.home`).
+         */
+        hostInfo: HostObservable<RemoteHostFacts>;
     };
     /**
      * Start a New Session in a Workspace: reuse-or-create its blank session and

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

@@ -1,8 +1,25 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+/**
+ * Workspace plugin, browser half. Two registrations: WorkspaceBrowser fills
+ * the sidebar shell's `sidebar.workspaces` hole (the whole browsing region),
+ * and WorkspacePicker fills the conversation hero's picker hole
+ * (`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:
+ * packages/client/AGENTS.md.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { WorkspaceSnapshot } from '@deepseek-ai/dsh-api-workspace-controller/client';
+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 { WorkspaceKey } from './locales.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface GlobalStandardProps {
+        /** Selector hook over the pure Workspace Controller snapshot. */
+        useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>;
+    }
     interface LocaleNamespaceMap {
         /** The workspace browsing region and pick/create flow copy. */
         workspace: WorkspaceKey;
@@ -23,5 +40,5 @@ export declare const inject: string[];
  * framework's global hooks.
  * @param ctx - client root context.
  */
-export declare function apply(ctx: ClientContext): void;
+export declare function apply(ctx: Context): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -57,6 +57,7 @@ export declare const zh: {
     'status.planReview': string;
     'status.waitingAnswer': string;
     'status.completed': string;
+    'schedule.active': string;
     'hover.created': string;
     'hover.copied': string;
     'date.ymd': string;
@@ -124,6 +125,7 @@ export declare const en: {
     'status.planReview': string;
     'status.waitingAnswer': string;
     'status.completed': string;
+    'schedule.active': string;
     'hover.created': string;
     'hover.copied': string;
     'date.ymd': string;

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

@@ -0,0 +1,82 @@
+/** 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 } 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';
+/** Workspace archive and directory operations consumed by Client UI domains. */
+export interface UiWorkspace {
+    /**
+     * 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>;
+    /**
+     * Start a New Session flow and navigate to its Session.
+     * @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.
+     */
+    archiveSession(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 connecting;
+    /**
+     * @param ctx - Client root Context.
+     * @param directoryPicker - the directory-picking Remote namespace.
+     * @param workspaces - pure Workspace Controller.
+     * @param sessions - pure Session Controller.
+     */
+    constructor(ctx: Context, directoryPicker: ClientRemote['directoryPicker'], workspaces: IWorkspaces, sessions: ISessions);
+    connectWorkspace(workspaceId: WorkspaceId): Promise<SessionId>;
+    startSession(workspaceId?: WorkspaceId): void;
+    archiveSession(sessionId: SessionId): Promise<void>;
+    pickDirectory(): Promise<string | null>;
+    listDirectory(path?: string, signal?: AbortSignal): Promise<DirectoryListing>;
+    createDirectory(path: string, name: string): Promise<string>;
+    private watchNavigation;
+    /** @returns true when an archived current selection was cleared. */
+    private clearArchivedCurrent;
+}
+export { UiWorkspaceService };
+//# sourceMappingURL=navigation.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, expandSidebar, useSessions, useSessionPendingInteraction, useWorkspaces, useStore, actions, startSession, open, renameSession, forkSession, renameWorkspace, deleteWorkspace, insertWorkspaceBefore, archiveSession, insertSessionBefore, createWorkspace, searchSessions, searchResultLimit, useDirectoryFlow, useHostInfo, renderSlot, t, }: WorkspaceBrowserProps): import("react").JSX.Element;
+//# sourceMappingURL=WorkspaceBrowser.d.ts.map

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

@@ -5,7 +5,7 @@
  * register() receives the factory and the browser derives its PropsStore
  * share from the return type.
  */
-import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-runtime/client';
+import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
 /** Browser-local order account for the hierarchy-free flat Session list. */
 export declare const FLAT_SESSION_ORDER_KEY = "__flat_session_order__";
 /** Session-list grouping mode: workspace sections or one flat recency list. */

package/lib/types/client/subagent-lineage.d.ts

@@ -0,0 +1,21 @@
+/** UI Workspace-owned projection of descendant counts from Session summaries. */
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+interface LineageEntry {
+    readonly id: SessionId;
+    readonly parentId?: SessionId;
+    readonly origin?: 'subagent';
+    readonly running: boolean;
+}
+/** Descendant counts for one possible parent Session. */
+export interface SubagentDescendantSummary {
+    readonly count: number;
+    readonly runningCount: number;
+}
+/**
+ * Index uninterrupted subagent descendants under each ancestor.
+ * @param summaries - Session summaries keyed by id.
+ * @returns descendant totals keyed by possible parent id.
+ */
+export declare function indexSubagentDescendants(summaries: Readonly<Record<SessionId, LineageEntry>>): ReadonlyMap<SessionId, SubagentDescendantSummary>;
+export {};
+//# sourceMappingURL=subagent-lineage.d.ts.map

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

@@ -3,11 +3,15 @@
  * Unassigned Sessions trail under Ungrouped; only the selected blank Session
  * remains visible.
  */
-import { type PendingInteractionStatus, type SessionId, type SessionListState, type SessionSearchResultItem, type WorkspaceId, type WorkspaceView } from '@deepseek-ai/dsh-client-runtime/client';
+import { type SessionListState, type SessionSearchResultItem } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { WorkspaceId, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { SessionPendingInteractionBase } from '@deepseek-ai/dsh-client-ui-session/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
 /** Group key for Sessions outside every Workspace. */
 export declare const UNGROUPED_KEY = "";
-/** Display label for the ungrouped bucket row. */
-export declare const UNGROUPED_LABEL = "Ungrouped";
+/** Pending interaction kinds with dedicated Workspace-row presentation. */
+export type SessionPendingInteractionStatus = 'approval' | 'plan-review' | 'question';
+type SessionPendingInteractions = ReadonlyMap<SessionId, SessionPendingInteractionBase>;
 /** One top-level session row in a group or the flat list. */
 export interface SessionNode {
     id: SessionId;
@@ -15,13 +19,15 @@ export interface SessionNode {
     title: string;
     /** The provisional blank session (renderer shows the localized New Session title). */
     blank: boolean;
-    /** The runtime Session list reports an interaction awaiting this user. */
-    pendingInteraction?: PendingInteractionStatus;
+    /** A Session-scoped UI consumer is awaiting this user. */
+    pendingInteraction?: SessionPendingInteractionStatus;
     running: boolean;
     /** Running descendants connected through uninterrupted subagent-origin lineage. */
     runningSubagentCount: number;
     /** Finished running while not selected and not yet opened (the green "done" reminder dot). */
     completed: boolean;
+    /** The current list projection contains at least one active Schedule record. */
+    hasActiveSchedule: boolean;
     updatedAt: number;
 }
 /** Session order selected by the Workspace browser. */
@@ -49,13 +55,15 @@ export interface SearchResultNode {
     id: SessionId;
     title: string;
     workspace: string;
-    /** The runtime Session list reports an interaction awaiting this user. */
-    pendingInteraction?: PendingInteractionStatus;
+    /** A Session-scoped UI consumer is awaiting this user. */
+    pendingInteraction?: SessionPendingInteractionStatus;
     running: boolean;
     /** Running descendants connected through uninterrupted subagent-origin lineage. */
     runningSubagentCount: number;
     /** Finished running while not selected and not yet opened (the green "done" reminder dot). */
     completed: boolean;
+    /** The current list projection contains at least one active Schedule record. */
+    hasActiveSchedule: boolean;
     snippet?: string;
 }
 /** Bounded merged search projection plus the refine-query hint bit. */
@@ -73,7 +81,7 @@ export interface TreeView {
  * Directory display label: basename of the path (both separators accepted).
  * Ungrouped-bucket fallback for surfaces without a workspace title.
  * @param cwd - directory path, or undefined for the ungrouped bucket.
- * @returns basename, the raw cwd when it has no basename, or the ungrouped label.
+ * @returns basename, the raw cwd when it has no basename, or an empty ungrouped marker.
  */
 export declare function workspaceLabel(cwd: string | undefined): string;
 /**
@@ -87,10 +95,11 @@ export declare function workspaceLabel(cwd: string | undefined): string;
  * @param list - sessions list snapshot (`current` feeds containsCurrent).
  * @param workspaces - real workspaces in stable Host order.
  * @param archivedSessionIds - registry-global archive set.
+ * @param pendingInteractions - pending UI interactions by Session.
  * @param view - local expansion arrays.
  * @returns group sections in render order.
  */
-export declare function deriveGroups(list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], view: TreeView): GroupNode[];
+export declare function deriveGroups(list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], pendingInteractions: SessionPendingInteractions, view: TreeView): GroupNode[];
 /**
  * Derive the flat session list ("In one list" mode): every session — fork
  * children included — as a top-level row, strictly newest-first. No grouping,
@@ -98,16 +107,10 @@ export declare function deriveGroups(list: SessionListState, workspaces: readonl
  * (see {@link deriveSearchResults}).
  * @param list - sessions list snapshot.
  * @param archivedSessionIds - registry-global archive set.
+ * @param pendingInteractions - pending UI interactions by Session.
  * @returns flat rows in render order.
  */
-export declare function deriveFlat(list: SessionListState, archivedSessionIds: readonly SessionId[]): SessionNode[];
-/** Relative-time bucket of a session row's trailing label. */
-export type RelativeTimeUnit = 'now' | 'minutes' | 'hours' | 'days' | 'months' | 'years';
-/** Structured relative time: the bucket plus its magnitude (0 for 'now'). */
-export interface RelativeTime {
-    unit: RelativeTimeUnit;
-    n: number;
-}
+export declare function deriveFlat(list: SessionListState, archivedSessionIds: readonly SessionId[], pendingInteractions: SessionPendingInteractions): SessionNode[];
 /**
  * Merge immediate title/Workspace substring matches with ranked Host content
  * matches. Local rows lead newest-first, content-only rows retain backend
@@ -116,20 +119,14 @@ export interface RelativeTime {
  * @param workspaces - Workspace membership and display labels.
  * @param query - caller text; surrounding whitespace is ignored.
  * @param archivedSessionIds - registry-global archive set (members never match).
+ * @param pendingInteractions - pending UI interactions by Session.
  * @param content - ranked Host content-search page.
  * @param limit - protocol-owned maximum merged row count.
  * @returns bounded deduplicated flat rows and a refine-query hint bit.
  */
-export declare function deriveSearchResults(list: SessionListState, workspaces: readonly WorkspaceView[], query: string, archivedSessionIds: readonly SessionId[], content: {
+export declare function deriveSearchResults(list: SessionListState, workspaces: readonly WorkspaceView[], query: string, archivedSessionIds: readonly SessionId[], pendingInteractions: SessionPendingInteractions, content: {
     items: readonly SessionSearchResultItem[];
     hasMore: boolean;
 }, limit: number): SearchResultSet;
-/**
- * Compact relative time for session rows, as a structured bucket the
- * renderer localizes ("now"/"5min"/"3h"/"2d"/"4mo"/"1y" in en).
- * @param updatedAt - epoch ms of the session's last activity.
- * @param now - current epoch ms (injected for pure rendering).
- * @returns the row's trailing time bucket and magnitude.
- */
-export declare function relativeTime(updatedAt: number, now: number): RelativeTime;
+export {};
 //# sourceMappingURL=tree.d.ts.map

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.1.1-rc.2",
+  "version": "0.1.2-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -32,10 +32,14 @@
   "dsh": {
     "client": {
       "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-api-workspace-controller",
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-session",
         "@deepseek-ai/dsh-client-ui-sidebar"
       ],
       "platform": "web"
@@ -46,27 +50,30 @@
     "clsx": "^2.0.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.1-rc.2"
+    "@deepseek-ai/cordis": "^4.0.2"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
-    "@deepseek-ai/cordis": "^4.0.1"
+    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-schedule": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.2-alpha.2",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.2"
   },
   "files": [
     "lib/index.js",

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

@@ -1,8 +0,0 @@
-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, expandSidebar, useSessions, useWorkspaces, useStore, actions, startSession, open, renameSession, forkSession, renameWorkspace, deleteWorkspace, insertWorkspaceBefore, archiveSession, insertSessionBefore, createWorkspace, searchSessions, searchResultLimit, useDirectoryFlow, useHostDescription, renderSlot, t, }: WorkspaceBrowserProps): import("react").JSX.Element;
-//# sourceMappingURL=WorkspaceBrowser.d.ts.map