@qilin-agent/client-ui-workspace 0.0.0-stage → 3.1.3

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

@@ -0,0 +1,187 @@
+/**
+ * Derives the workspace browser tree from caller-projected Workspace and
+ * Session order. Unassigned Sessions trail under Ungrouped; only the selected
+ * blank Session remains visible.
+ */
+import { type SessionListState, type SessionSearchResultItem } from '@qilin-agent/api-session-controller/client';
+import type { WorkspaceId, WorkspaceView } from '@qilin-agent/api-workspace-controller/client';
+import type { SessionStatusSnapshot } from '@qilin-agent/client-ui-session/client';
+import type { SessionId } from '@qilin-agent/session/types';
+/** Group key for Sessions outside every Workspace. */
+export declare const UNGROUPED_KEY = "";
+/**
+ * Resolve the Workspace browser group that owns one Session.
+ * @param workspaces - authoritative Workspace membership.
+ * @param sessionId - Session whose browser group is required.
+ * @returns owning Workspace id, or {@link UNGROUPED_KEY} when no Workspace accounts for it.
+ */
+export declare function owningGroupKey(workspaces: readonly WorkspaceView[], sessionId: SessionId): string;
+/** Pending interaction kinds with dedicated Workspace-row presentation. */
+export type SessionPendingInteractionStatus = 'approval' | 'plan-review' | 'question';
+type SessionStatuses = SessionStatusSnapshot;
+/** 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;
+    /** In the registry-global pin set: leads its section, and the row marks itself pinned. */
+    pinned: boolean;
+}
+/** Session order selected by the Workspace browser. */
+export type SessionOrderBy = 'manual' | 'updated';
+/** Registry-global row membership every tree derivation reads. */
+export interface SessionRowState {
+    /** Registry-global pin ids; pinned rows lead their section without changing the caller's local order. */
+    pinnedSessionIds: readonly SessionId[];
+    /** Registry-global archive set. */
+    archivedSessionIds: readonly SessionId[];
+}
+/** 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;
+/**
+ * Project known account members by current Session recency.
+ * @param sessionIds - authoritative account membership.
+ * @param summaries - current Session summaries; members without a summary are omitted until it arrives.
+ * @returns known members newest first, with Session identity as the deterministic tie-break.
+ */
+export declare function orderByRecency(sessionIds: readonly SessionId[], summaries: SessionListState['byId']): SessionId[];
+/**
+ * Reconcile a browser-local manual order with current account membership.
+ * @param memberIds - authoritative account membership.
+ * @param savedOrder - previously saved browser-local order.
+ * @param summaries - current Session summaries used to append newly known members by recency.
+ * @returns retained saved slots followed by newly known members; departed members and unknown new members are omitted.
+ */
+export declare function reconcileManualOrder(memberIds: readonly SessionId[], savedOrder: readonly string[] | undefined, summaries: SessionListState['byId']): SessionId[];
+/**
+ * Keep the selected provisional New Session ahead of either base order.
+ * @param order - recency or reconciled manual order.
+ * @param currentBlank - selected blank Session in this account, when present.
+ * @returns a copy with the selected blank first and no duplicate slot.
+ */
+export declare function pinCurrentBlank(order: readonly SessionId[], currentBlank: SessionId | undefined): SessionId[];
+/**
+ * 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 (`mainView` retention feeds containsCurrent).
+ * @param workspaces - real Workspaces in Host group order with caller-projected Session order.
+ * @param rowState - registry-global pin and archive membership.
+ * @param statuses - unified UI status by Session.
+ * @param view - local expansion arrays.
+ * @returns group sections in render order.
+ */
+export declare function deriveGroups(list: SessionListState, workspaces: readonly WorkspaceView[], rowState: SessionRowState, statuses: SessionStatuses, view: TreeView): GroupNode[];
+/**
+ * Select flat-list members without deriving row presentation or ordering.
+ * @param list - sessions list snapshot.
+ * @param rowState - registry-global pin and archive membership.
+ * @returns known visible Session ids in list order, including ordinary forks and only the current blank.
+ */
+export declare function visibleSessionIds(list: SessionListState, rowState: Pick<SessionRowState, 'archivedSessionIds'>): SessionId[];
+/**
+ * Select complete flat-list membership, independently of archive visibility.
+ * The pin write-back reconciles this account, so an archived Session keeps its
+ * slot and no pin silently drops it.
+ * @param list - sessions list snapshot.
+ * @returns known ordinary Session ids, including archived ones.
+ */
+export declare function sessionMemberIds(list: SessionListState): SessionId[];
+/**
+ * Derive flat rows from the browser's ordered visible Session ids.
+ * @param list - sessions list snapshot used to select the ids.
+ * @param sessionIds - known visible members in caller order, including any pinned blank.
+ * @param pinnedSessionIds - registry-global pin set; pinned rows lead after the blank.
+ * @param statuses - unified UI status by Session.
+ * @returns flat rows with pinned rows fronted and current status indicators.
+ */
+export declare function deriveFlat(list: SessionListState, sessionIds: readonly SessionId[], pinnedSessionIds: readonly SessionId[], statuses: SessionStatuses): 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 rowState - registry-global archive membership (members never match).
+ * @param statuses - unified UI status 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, rowState: Pick<SessionRowState, 'archivedSessionIds'>, statuses: SessionStatuses, content: {
+    items: readonly SessionSearchResultItem[];
+    hasMore: boolean;
+}, limit: number): SearchResultSet;
+/**
+ * Find the nearest registered ancestor, excluding the Workspace directory itself.
+ * Paths use Host spelling; matching is case-sensitive, like Workspace identity.
+ * @param path - Workspace directory.
+ * @param parents - registered Workspace directory paths.
+ * @returns the owning parent path, or undefined when no parent contains the Workspace.
+ */
+export declare function owningParentFolder(path: string, parents: readonly string[]): string | undefined;
+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 qilin.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/package.json

@@ -1,6 +1,90 @@
 {
   "name": "@qilin-agent/client-ui-workspace",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Workspace picker plugin: one WorkspacePicker registered into the sidebar and empty-state workspace slots",
+  "version": "3.1.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkutysllb/QiLin.git",
+    "directory": "packages/client/ui-workspace"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "qilin": {
+    "client": {
+      "inject": [
+        "@qilin-agent/api-remotes",
+        "@qilin-agent/api-session-controller",
+        "@qilin-agent/api-workspace-controller",
+        "@qilin-agent/client-connection",
+        "@qilin-agent/client-locale",
+        "@qilin-agent/client-shortcuts",
+        "@qilin-agent/client-ui-conversation",
+        "@qilin-agent/client-ui-layout",
+        "@qilin-agent/client-ui-renderer",
+        "@qilin-agent/client-ui-session",
+        "@qilin-agent/client-ui-sidebar",
+        "@qilin-agent/client-ui-workbench"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@qilin-agent/kylin": "~4.0.3"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "clsx": "^2.0.0",
+    "react": "^18.2.0",
+    "@qilin-agent/api-remotes": "3.1.3",
+    "@qilin-agent/api-session-controller": "3.1.3",
+    "@qilin-agent/api-workspace-controller": "3.1.3",
+    "@qilin-agent/client-connection": "3.1.3",
+    "@qilin-agent/client-shortcuts": "3.1.3",
+    "@qilin-agent/client-store": "3.1.3",
+    "@qilin-agent/client-test-runtime": "3.1.3",
+    "@qilin-agent/client-locale": "3.1.3",
+    "@qilin-agent/client-ui-conversation": "3.1.3",
+    "@qilin-agent/client-ui-layout": "3.1.3",
+    "@qilin-agent/client-ui-primitives": "3.1.3",
+    "@qilin-agent/client-ui-session": "3.1.3",
+    "@qilin-agent/client-ui-sidebar": "3.1.3",
+    "@qilin-agent/client-ui-renderer": "3.1.3",
+    "@qilin-agent/client-ui-slots": "3.1.3",
+    "@qilin-agent/schedule": "3.1.3",
+    "@qilin-agent/session": "3.1.3",
+    "@qilin-agent/client-ui-workbench": "3.1.3",
+    "@qilin-agent/typert-protocol": "3.1.3",
+    "@qilin-agent/subagent": "3.1.3",
+    "@qilin-agent/kylin": "~4.0.3",
+    "@qilin-agent/util-workspace-path": "3.1.3"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
 }