@prettier-ai/dsh-client-ui-workspace 0.1.2-alpha.1

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

@@ -0,0 +1,44 @@
+/**
+ * The workspace browser's viewing store: the session-list grouping mode,
+ * persisted across reloads. Module level exports the factory only (a
+ * module-level handle would pin the store identity across plugin reloads);
+ * register() receives the factory and the browser derives its PropsStore
+ * share from the return type.
+ */
+import { type EngineStoreHandle } from '@prettier-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. */
+export type SessionGroupBy = 'workspace' | 'flat';
+/** Session order: user-arranged only, or user-arranged plus activity promotion. */
+export type SessionOrderBy = 'manual' | 'updated';
+/** Workspace browser viewing state persisted across surface remounts and reloads. */
+type WorkspaceViewState = {
+    groupBy: SessionGroupBy;
+    orderBy: SessionOrderBy;
+    /** Explicit zero-or-five-session state keyed by Workspace group identity. */
+    groupExpansion: Record<string, boolean>;
+    /** Shared editable order per Workspace group plus the browser-local flat-list account. */
+    sessionOrderByAccount: Record<string, string[]>;
+    /** Last observed update timestamps per order account for one-time promotion events. */
+    sessionUpdatedAtByAccount: Record<string, Record<string, number>>;
+};
+/**
+ * Annotation twin of the actions literal below (the export needs a declared
+ * return type); drift fails assignability at the defineStore call.
+ */
+type WorkspaceViewActions = {
+    setGroupBy: (draft: WorkspaceViewState, mode: SessionGroupBy) => void;
+    setOrderBy: (draft: WorkspaceViewState, mode: SessionOrderBy) => void;
+    setGroupExpanded: (draft: WorkspaceViewState, key: string, expanded: boolean) => void;
+    retainAccountKeys: (draft: WorkspaceViewState, workspaceKeys: readonly string[]) => void;
+    syncSessionOrderAccount: (draft: WorkspaceViewState, accountKey: string, order: string[], updatedAt: Record<string, number>) => void;
+    setSessionOrder: (draft: WorkspaceViewState, accountKey: string, order: string[]) => void;
+};
+/**
+ * Create the workspace browser viewing store handle.
+ * @returns the store handle (spec + type + identity + factory in one).
+ */
+export declare function createWorkspaceViewStore(): EngineStoreHandle<WorkspaceViewState, WorkspaceViewActions>;
+export {};
+//# sourceMappingURL=stores.d.ts.map

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 '@prettier-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

@@ -0,0 +1,128 @@
+/**
+ * Derives the workspace browser tree from Host Workspace order and membership.
+ * Unassigned Sessions trail under Ungrouped; only the selected blank Session
+ * remains visible.
+ */
+import { type SessionListState, type SessionSearchResultItem } from '@prettier-ai/dsh-api-session-controller/client';
+import type { WorkspaceId, WorkspaceView } from '@prettier-ai/dsh-api-workspace-controller/client';
+import type { SessionPendingInteractionBase } from '@prettier-ai/dsh-client-ui-session/client';
+import type { SessionId } from '@prettier-ai/dsh-session/types';
+/** Group key for Sessions outside every Workspace. */
+export declare const UNGROUPED_KEY = "";
+/** 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;
+    /** Stored display title; the renderer substitutes the localized New Session label for blank rows. */
+    title: string;
+    /** The provisional blank session (renderer shows the localized New Session title). */
+    blank: boolean;
+    /** 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;
+    updatedAt: number;
+}
+/** Session order selected by the Workspace browser. */
+export type SessionOrderBy = 'manual' | 'updated';
+/** One workspace group section: header row facts + visible top-level session rows. */
+export interface GroupNode {
+    /** Group key: the workspace id or {@link UNGROUPED_KEY}. */
+    key: string;
+    /** Backing Workspace id; absent only for the ungrouped bucket. */
+    workspaceId: WorkspaceId | undefined;
+    cwd: string | undefined;
+    /** Workspace creation time (epoch ms); absent only for the ungrouped bucket. */
+    createdAt: number | undefined;
+    label: string;
+    /** Total visible sessions in the group. */
+    sessionCount: number;
+    expanded: boolean;
+    /** The group contains the selected session (active folder tint; supplied here so the renderer never scans). */
+    containsCurrent: boolean;
+    /** Visible session rows (empty while the group is folded). */
+    sessions: readonly SessionNode[];
+}
+/** One flat search row combining list metadata with an optional content match. */
+export interface SearchResultNode {
+    id: SessionId;
+    title: string;
+    workspace: string;
+    /** 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;
+    snippet?: string;
+}
+/** Bounded merged search projection plus the refine-query hint bit. */
+export interface SearchResultSet {
+    items: readonly SearchResultNode[];
+    hasMore: boolean;
+}
+/** Viewing state consumed by the derivation. */
+export interface TreeView {
+    expandedGroups: readonly string[];
+    /** Browser-local order for Sessions without a backing Workspace account. */
+    ungroupedOrder?: readonly string[];
+}
+/**
+ * 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 an empty ungrouped marker.
+ */
+export declare function workspaceLabel(cwd: string | undefined): string;
+/**
+ * Derive the workspace browser groups with every session as a top-level row.
+ *
+ * Every group shows; sessions populate under expanded groups in the selected
+ * local order. Blank sessions are excluded except for the selected
+ * provisional New Session row; archived sessions are excluded everywhere.
+ * Content search lives outside this derivation
+ * (see {@link deriveSearchResults}).
+ * @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[], 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,
+ * no parent/child adjacency. Content search lives outside this derivation
+ * (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[], pendingInteractions: SessionPendingInteractions): SessionNode[];
+/**
+ * Merge immediate title/Workspace substring matches with ranked Host content
+ * matches. Local rows lead newest-first, content-only rows retain backend
+ * order, and duplicate sessions receive the backend snippet in place.
+ * @param list - session metadata authority.
+ * @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[], pendingInteractions: SessionPendingInteractions, content: {
+    items: readonly SessionSearchResultItem[];
+    hasMore: boolean;
+}, limit: number): SearchResultSet;
+export {};
+//# sourceMappingURL=tree.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Workspace picker plugin, node half. Pure UI plugin: the empty apply exists
+ * so the plugin appears in the host cordis.yml / Loader (load and lifecycle
+ * follow the host; the browser half ships via exports["./client"], discovered
+ * through the package.json dsh.client declaration).
+ */
+/** Host plugin body — no host-side behavior for the workspace picker plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@prettier-ai/dsh-client-ui-workspace`.
+ * @module @prettier-ai/dsh-client-ui-workspace/invariant
+ */
+import type { Context } from '@prettier-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-workspace-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@prettier-ai/dsh-client-ui-workspace",
+  "description": "Workspace picker plugin: one WorkspacePicker registered into the sidebar and empty-state workspace slots",
+  "version": "0.1.2-alpha.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-workspace"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@prettier-ai/dsh-api-remotes",
+        "@prettier-ai/dsh-api-session-controller",
+        "@prettier-ai/dsh-api-workspace-controller",
+        "@prettier-ai/dsh-client-connection",
+        "@prettier-ai/dsh-client-locale",
+        "@prettier-ai/dsh-client-ui-conversation",
+        "@prettier-ai/dsh-client-ui-renderer",
+        "@prettier-ai/dsh-client-ui-session",
+        "@prettier-ai/dsh-client-ui-sidebar"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "dependencies": {
+    "clsx": "^2.0.0"
+  },
+  "peerDependencies": {
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-workspace-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-sidebar": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-util-workspace-path": "^0.1.2-alpha.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-workspace-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-store": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-test-runtime": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-sidebar": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-util-workspace-path": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}