@huanlin/dsh-plugin-ya-workspace-sidebar 0.6.1 → 0.7.0

package/lib/index.js

@@ -1,6 +1,222 @@
+import { readdir, stat } from "node:fs/promises";
 import { readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { dirname, isAbsolute, join, posix, resolve, win32 } from "node:path";
+import { spawn } from "node:child_process";
+//#region ../dsh/packages/util/home-paths/lib/index.js
+/**
+* Shared filesystem path helpers for DeepSeek Harness user data.
+*
+* @module @deepseek-ai/dsh-home-paths
+*/
+/** Directory name for the default DeepSeek Harness home under the OS home. */
+const DSH_HOME_DIR_NAME = ".dsh";
+/** Environment variable that overrides the default DeepSeek Harness home. */
+const DSH_HOME_ENV = "DSH_HOME";
+/**
+* Resolve the default DeepSeek Harness home using Node's platform path rules.
+* @returns the absolute default harness home path.
+*/
+function defaultDshHome() {
+	return join(homedir(), DSH_HOME_DIR_NAME);
+}
+/**
+* Expand supported tilde prefixes against the operating-system home.
+* @param path - configured path that may begin with `~`, `~/`, or `~\`.
+* @returns the expanded path, or the original value when no supported prefix is present.
+*/
+function expandHomePath(path) {
+	if (path === "~") return homedir();
+	if (path.startsWith("~/") || path.startsWith("~\\")) return join(homedir(), path.slice(2));
+	return path;
+}
+/**
+* Resolve the single-root DeepSeek Harness home.
+*
+* Precedence, highest first: an explicit configured path, `$DSH_HOME`, then
+* `~/.dsh`. The harness keeps all user data under one root. An empty or
+* whitespace-only `$DSH_HOME` is treated as unset, so a blank override never
+* resolves the home to the current working directory.
+* @param configured - explicit harness-home override, which has highest precedence.
+* @param env - environment mapping used to read `DSH_HOME`.
+* @returns the normalized absolute harness home path.
+*/
+function resolveDshHome(configured, env = process.env) {
+	const fromEnv = env[DSH_HOME_ENV];
+	return resolve(expandHomePath(configured ?? (fromEnv !== void 0 && fromEnv.trim().length > 0 ? fromEnv : defaultDshHome())));
+}
+/**
+* Join path segments onto the resolved DeepSeek Harness home.
+* @param segments - path segments appended to the Harness home; an empty list returns the home itself.
+* @returns the normalized absolute joined path.
+*/
+function dshHomePath(...segments) {
+	return join(resolveDshHome(), ...segments);
+}
+//#endregion
+//#region src/session-artifacts.ts
+/**
+* Encode an arbitrary string as one safe path segment, injectively over all
+* JS strings (parity with the official jsonl backend's segment encoder: safe
+* units literal, every other unit `~XXXX`, dot segments traversal-proofed).
+* @param raw - the string to encode; must be non-empty.
+* @returns the escaped single path segment.
+*/
+function encodeSegment(raw) {
+	if (raw.length === 0) throw new Error("cannot encode an empty path segment");
+	if (raw === ".") return "~002E";
+	if (raw === "..") return "~002E~002E";
+	let out = "";
+	for (let i = 0; i < raw.length; i++) {
+		const code = raw.charCodeAt(i);
+		const ch = String.fromCharCode(code);
+		if (ch !== "~" && /^[A-Za-z0-9._-]$/.test(ch)) out += ch;
+		else out += "~" + code.toString(16).toUpperCase().padStart(4, "0");
+	}
+	return out;
+}
+/**
+* Parse one committed generation filename into its format version.
+* @param filename - candidate entry from a session directory.
+* @returns the generation version (`vN.jsonl` / `vN.jsonl.zstd`; version-zero
+*   is the suffix-only `.jsonl`), or undefined for non-generation names.
+*/
+function logGeneration(filename) {
+	const match = /^v(\d+)\.jsonl(\.zstd)?$/.exec(filename);
+	if (match !== null) return Number(match[1]);
+	return filename === ".jsonl" ? 0 : void 0;
+}
+/**
+* Find the session's storage dir and newest log file under a sessions root.
+* @param root - sessions root directory (`$DSH_HOME/sessions`).
+* @param sessionId - raw session id (encoded here before any filesystem use).
+* @param io - fs surface; a stat miss under one project directory keeps the scan going.
+* @returns the newest owning directory and its highest-generation log file,
+*   either null when absent (sqlite deployments, unflushed sessions).
+*/
+async function findSessionArtifacts(root, sessionId, io) {
+	const segment = encodeSegment(sessionId);
+	let best;
+	for (const entry of await io.readdir(root, { withFileTypes: true })) {
+		if (!entry.isDirectory() || !entry.name.startsWith("--") || !entry.name.endsWith("--")) continue;
+		const candidate = join(root, entry.name, segment);
+		try {
+			const stats = await io.stat(candidate);
+			if (best === void 0 || stats.mtimeMs > best.mtimeMs) best = {
+				dir: candidate,
+				mtimeMs: stats.mtimeMs
+			};
+		} catch {}
+	}
+	if (best === void 0) return {
+		dir: null,
+		log: null
+	};
+	let log;
+	let logVersion = -1;
+	for (const entry of await io.readdir(best.dir, { withFileTypes: true })) {
+		if (!entry.isFile()) continue;
+		const version = logGeneration(entry.name);
+		if (version !== void 0 && version >= logVersion) {
+			logVersion = version;
+			log = join(best.dir, entry.name);
+		}
+	}
+	return {
+		dir: best.dir,
+		log: log ?? null
+	};
+}
+//#endregion
+//#region src/reveal.ts
+/** Platform opener commands for revealing a path in the OS file manager. */
+/**
+* Build the opener invocation that reveals/selects a path (pure, platform injectable).
+* @param path - absolute path to reveal.
+* @param platform - Node platform selector; win32 selects the entry, darwin
+*   reveals with `open -R`, everything else opens the parent directory.
+* @returns the argv invocation (never a shell string).
+*/
+function revealCommand(path, platform) {
+	switch (platform) {
+		case "darwin": return {
+			command: "open",
+			args: ["-R", path]
+		};
+		case "win32": return {
+			command: "explorer.exe",
+			args: [`/select,${path}`]
+		};
+		default: return {
+			command: "xdg-open",
+			args: [dirname(path)]
+		};
+	}
+}
+/**
+* Launch the reveal opener detached and return immediately.
+* @param path - absolute path to reveal in the OS file manager.
+* @returns started acknowledgement; opener failures after the spawn surface
+*   through the OS (the child's error event is swallowed on purpose).
+*/
+function launchReveal(path) {
+	const spec = revealCommand(path, process.platform);
+	const child = spawn(spec.command, spec.args, {
+		detached: true,
+		stdio: "ignore"
+	});
+	child.on("error", () => {});
+	child.unref();
+	return { started: true };
+}
+//#endregion
+//#region src/trust-fence.ts
+function header(headers, name) {
+	const value = headers[name];
+	return typeof value === "string" ? value : void 0;
+}
+/** Normalized URL of a Host-header authority, or undefined when unparsable. */
+function parseAuthority(authority) {
+	try {
+		return new URL(`http://${authority}`);
+	} catch {
+		return;
+	}
+}
+/** Whether a normalized URL hostname names the local loopback authority. */
+function isLoopbackHostname(hostname) {
+	if (hostname === "localhost" || hostname === "[::1]") return true;
+	const parts = hostname.split(".");
+	return parts.length === 4 && parts[0] === "127" && parts.every((part) => /^\d{1,3}$/.test(part) && Number(part) <= 255);
+}
+/**
+* Decide whether one plugin route request may proceed.
+* @param request - node HTTP request facts (headers).
+* @param trustedHosts - non-loopback authorities this deployment serves.
+* @returns true when the Host is ours (loopback or trusted) and browser
+*   markers are same-origin; absent Origin passes on the bound Host alone,
+*   the opaque "null" origin is refused.
+*/
+function isTrustedRouteRequest(request, trustedHosts = []) {
+	const host = header(request.headers, "host");
+	if (host === void 0) return false;
+	const hostUrl = parseAuthority(host);
+	if (hostUrl === void 0) return false;
+	if (!(isLoopbackHostname(hostUrl.hostname) || trustedHosts.some((entry) => {
+		const entryUrl = parseAuthority(entry);
+		return entryUrl !== void 0 && entryUrl.hostname === hostUrl.hostname;
+	}))) return false;
+	if (header(request.headers, "sec-fetch-site") === "cross-site") return false;
+	const origin = header(request.headers, "origin");
+	if (origin === void 0) return true;
+	if (origin === "null") return false;
+	try {
+		return new URL(origin).hostname === hostUrl.hostname;
+	} catch {
+		return false;
+	}
+}
+//#endregion
 //#region src/index.ts
 /**
 * Host half for the browser-only ya-workspace-sidebar plugin.
@@ -71,6 +287,102 @@ function apply(ctx) {
 		});
 		if (timer === void 0) timer = setTimeout(flush, 2e3);
 	});
+	ctx.inject(["webServer"], (wctx) => {
+		const webServer = wctx.webServer;
+		const disposeRoutes = [webServer.register({
+			kind: "exact",
+			path: "/ya-workspace-sidebar/paths",
+			handler: pathsRoute
+		}), webServer.register({
+			kind: "exact",
+			path: "/ya-workspace-sidebar/reveal",
+			handler: revealRoute
+		})];
+		return () => {
+			for (const dispose of disposeRoutes) dispose();
+		};
+	});
+}
+/** Body size bound of one JSON request (defense against unbounded reads). */
+const MAX_BODY_BYTES = 1 << 20;
+/** Read and parse one bounded JSON request body; malformed input throws. */
+async function readJsonBody(req) {
+	const chunks = [];
+	let total = 0;
+	for await (const chunk of req) {
+		const buffer = Buffer.from(chunk);
+		total += buffer.length;
+		if (total > MAX_BODY_BYTES) throw new Error("request body too large");
+		chunks.push(buffer);
+	}
+	const text = Buffer.concat(chunks).toString("utf8");
+	if (text.trim() === "") return {};
+	return JSON.parse(text);
+}
+/** Write one JSON response. */
+function writeJson(res, status, body) {
+	res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
+	res.end(JSON.stringify(body));
+}
+/** Reject untrusted/fenced requests with 403. */
+function refused(res) {
+	writeJson(res, 403, { error: "untrusted" });
+}
+/** POST /ya-workspace-sidebar/paths — probe the session's jsonl storage layout. */
+async function pathsRoute(req, res) {
+	if (!isTrustedRouteRequest(req)) {
+		refused(res);
+		return;
+	}
+	let payload;
+	try {
+		payload = await readJsonBody(req);
+	} catch (error) {
+		writeJson(res, 400, { error: error instanceof Error ? error.message : "bad json" });
+		return;
+	}
+	const sessionId = payload?.sessionId;
+	if (typeof sessionId !== "string" || sessionId.length === 0) {
+		writeJson(res, 400, { error: "sessionId required" });
+		return;
+	}
+	try {
+		writeJson(res, 200, await findSessionArtifacts(dshHomePath("sessions"), sessionId, {
+			readdir: (path, options) => readdir(path, options),
+			stat: (path) => stat(path)
+		}));
+	} catch (error) {
+		writeJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
+	}
+}
+/** POST /ya-workspace-sidebar/reveal — open one existing directory in the OS file manager. */
+async function revealRoute(req, res) {
+	if (!isTrustedRouteRequest(req)) {
+		refused(res);
+		return;
+	}
+	let payload;
+	try {
+		payload = await readJsonBody(req);
+	} catch (error) {
+		writeJson(res, 400, { error: error instanceof Error ? error.message : "bad json" });
+		return;
+	}
+	const path = payload?.path;
+	if (typeof path !== "string" || !(isAbsolute(path) || win32.isAbsolute(path) || posix.isAbsolute(path))) {
+		writeJson(res, 400, { error: "absolute path required" });
+		return;
+	}
+	try {
+		if (!(await stat(path)).isDirectory()) {
+			writeJson(res, 400, { error: "not a directory" });
+			return;
+		}
+	} catch {
+		writeJson(res, 400, { error: "path not found" });
+		return;
+	}
+	writeJson(res, 200, launchReveal(path));
 }
 //#endregion
 export { apply, name };

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

@@ -1,20 +1,20 @@
-/** Fixed-stride virtual scroller for the global recent-sessions block. */
-import { type ReactNode } from 'react';
-import { type SessionRow } from './model.ts';
-interface VirtualRecentListProps {
-    rows: readonly SessionRow[];
-    renderItem: (row: SessionRow) => ReactNode;
-    ariaLabel: string;
-    /** Receives the viewport element for external geometry (the drag resizer). */
-    viewportRef?: (node: HTMLDivElement | null) => void;
-    /** Overrides the stylesheet's default viewport cap, in px. */
-    maxHeight?: number;
-}
-/**
- * Renders `rows` inside a bounded, scrollable viewport while mounting only
- * the visible slice (plus overscan). The row stride is fixed
- * ({@link RECENT_ROW_STRIDE}), so windowing is pure arithmetic — no per-row
- * measurement — and the scroll position survives session-list updates.
- */
-export declare function VirtualRecentList({ rows, renderItem, ariaLabel, viewportRef, maxHeight }: VirtualRecentListProps): import("react").JSX.Element;
-export {};
+/** Fixed-stride virtual scroller for the global recent-sessions block. */
+import { type ReactNode } from 'react';
+import { type SessionRow } from './model.ts';
+interface VirtualRecentListProps {
+    rows: readonly SessionRow[];
+    renderItem: (row: SessionRow) => ReactNode;
+    ariaLabel: string;
+    /** Receives the viewport element for external geometry (the drag resizer). */
+    viewportRef?: (node: HTMLDivElement | null) => void;
+    /** Overrides the stylesheet's default viewport cap, in px. */
+    maxHeight?: number;
+}
+/**
+ * Renders `rows` inside a bounded, scrollable viewport while mounting only
+ * the visible slice (plus overscan). The row stride is fixed
+ * ({@link RECENT_ROW_STRIDE}), so windowing is pure arithmetic — no per-row
+ * measurement — and the scroll position survives session-list updates.
+ */
+export declare function VirtualRecentList({ rows, renderItem, ariaLabel, viewportRef, maxHeight }: VirtualRecentListProps): import("react").JSX.Element;
+export {};

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

@@ -1,26 +1,26 @@
-/** Existing-workspace menu plus composed directory-adoption flow. */
-import type { ReactNode, RefObject } from 'react';
-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, PickerProps } from './contract.ts';
-interface FlowProps {
-    t: PickerProps['t'];
-    open: boolean;
-    anchorRef?: RefObject<HTMLElement | null>;
-    useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>;
-    createWorkspace: (input: {
-        path: string;
-    }) => Promise<WorkspaceView>;
-    useDirectoryFlow: SnapshotSelectorHook<boolean>;
-    renderDirectoryFlow: (owner: DirectoryFlowOwnerProps) => ReactNode;
-    onPick: (workspaceId: WorkspaceId) => void;
-    onClose: () => void;
-    addOnly?: boolean;
-    side?: 'bottom' | 'top' | 'right';
-    selectedId?: WorkspaceId;
-}
-/** Render the workspace target menu and directory picking conversation. */
-export declare function WorkspacePickFlow({ t, open, anchorRef, useWorkspaces, createWorkspace, useDirectoryFlow, renderDirectoryFlow, onPick, onClose, addOnly, side, selectedId, }: FlowProps): import("react").JSX.Element;
-/** Fill the conversation hero's workspace picker seat. */
-export declare function WorkspacePicker({ open, anchorRef, useWorkspaces, selectedId, onPick, onClose, createWorkspace, useDirectoryFlow, renderSlot, t, }: PickerProps): import("react").JSX.Element;
-export {};
+/** Existing-workspace menu plus composed directory-adoption flow. */
+import type { ReactNode, RefObject } from 'react';
+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, PickerProps } from './contract.ts';
+interface FlowProps {
+    t: PickerProps['t'];
+    open: boolean;
+    anchorRef?: RefObject<HTMLElement | null>;
+    useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>;
+    createWorkspace: (input: {
+        path: string;
+    }) => Promise<WorkspaceView>;
+    useDirectoryFlow: SnapshotSelectorHook<boolean>;
+    renderDirectoryFlow: (owner: DirectoryFlowOwnerProps) => ReactNode;
+    onPick: (workspaceId: WorkspaceId) => void;
+    onClose: () => void;
+    addOnly?: boolean;
+    side?: 'bottom' | 'top' | 'right';
+    selectedId?: WorkspaceId;
+}
+/** Render the workspace target menu and directory picking conversation. */
+export declare function WorkspacePickFlow({ t, open, anchorRef, useWorkspaces, createWorkspace, useDirectoryFlow, renderDirectoryFlow, onPick, onClose, addOnly, side, selectedId, }: FlowProps): import("react").JSX.Element;
+/** Fill the conversation hero's workspace picker seat. */
+export declare function WorkspacePicker({ open, anchorRef, useWorkspaces, selectedId, onPick, onClose, createWorkspace, useDirectoryFlow, renderSlot, t, }: PickerProps): import("react").JSX.Element;
+export {};

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

@@ -1,76 +1,88 @@
-/** Slot contracts and injected Host actions for ya-workspace-sidebar. */
-import type { HostObservable, PropsLocale, PropsRenderSlots, PropsRuntime, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
-import type { SessionSearchResultItem } from '@deepseek-ai/dsh-api-session-controller/client';
-import type { WorkspaceId, WorkspaceSnapshot, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
-import type { SessionId } from '@deepseek-ai/dsh-session/types';
-import type { YaWorkspaceKey } from './locales.ts';
-/** Directory-picker conversation owned by each trigger surface. */
-export interface DirectoryFlowOwnerProps {
-    open: boolean;
-    busy: boolean;
-    onPicked: (path: string) => void;
-    onCancel: () => void;
-    onError: (message: string) => void;
-}
-declare module '@deepseek-ai/dsh-client-ui-slots' {
-    /** The official ui-workspace provider is disabled by this bundle's patch,
-     * so this plugin owns the global workspaces selector hook (bound from the
-     * Workspace Controller snapshot this apply installs via slots.provideRoot). */
-    interface GlobalStandardProps {
-        useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>;
-    }
-    interface SlotMap {
-        'sidebar.workspaces.directoryFlow': {
-            kind: 'single';
-            scope: 'root';
-            owner: DirectoryFlowOwnerProps;
-        };
-        'conversation.hero.workspace.directoryFlow': {
-            kind: 'single';
-            scope: 'root';
-            owner: DirectoryFlowOwnerProps;
-        };
-    }
-    interface LocaleNamespaceMap {
-        'ya-workspace-sidebar': YaWorkspaceKey;
-    }
-}
-/** Shared directory-flow occupancy source. */
-export interface DirectoryInjected {
-    hooks: {
-        directoryFlow: HostObservable<boolean>;
-    };
-}
-/** Browser-private Host operations. */
-export type SidebarInjected = DirectoryInjected & {
-    startSession: (workspaceId?: WorkspaceId) => void;
-    open: (sessionId: SessionId) => void;
-    searchSessions: (query: string, signal: AbortSignal) => Promise<{
-        items: readonly SessionSearchResultItem[];
-        hasMore: boolean;
-    }>;
-    searchResultLimit: number;
-    renameSession: (sessionId: SessionId, title: string) => Promise<void>;
-    forkSession: (sessionId: SessionId) => void;
-    renameWorkspace: (workspaceId: WorkspaceId, title: string) => Promise<void>;
-    deleteWorkspace: (workspaceId: WorkspaceId) => Promise<void>;
-    archiveSession: (sessionId: SessionId) => Promise<void>;
-    insertSessionBefore: (workspaceId: WorkspaceId, sessionId: SessionId, beforeSessionId?: SessionId) => Promise<void>;
-    createWorkspace: (input: {
-        path: string;
-    }) => Promise<WorkspaceView>;
-};
-/** Full sidebar component props. */
-export type SidebarProps = PropsRuntime<'sidebar.workspaces'> & PropsRenderSlots<'sidebar.workspaces.directoryFlow'> & Omit<SidebarInjected, 'hooks'> & {
-    useDirectoryFlow: SnapshotSelectorHook<boolean>;
-} & PropsLocale<'ya-workspace-sidebar'>;
-/** Conversation hero picker operations. */
-export type PickerInjected = DirectoryInjected & {
-    createWorkspace: (input: {
-        path: string;
-    }) => Promise<WorkspaceView>;
-};
-/** Full conversation hero picker props. */
-export type PickerProps = PropsRuntime<'conversation.hero.workspace'> & PropsRenderSlots<'conversation.hero.workspace.directoryFlow'> & Omit<PickerInjected, 'hooks'> & {
-    useDirectoryFlow: SnapshotSelectorHook<boolean>;
-} & PropsLocale<'ya-workspace-sidebar'>;
+/** Slot contracts and injected Host actions for ya-workspace-sidebar. */
+import type { HostObservable, PropsLocale, PropsRenderSlots, PropsRuntime, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SessionSearchResultItem } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { WorkspaceId, WorkspaceSnapshot, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { YaWorkspaceKey } from './locales.ts';
+/** Directory-picker conversation owned by each trigger surface. */
+export interface DirectoryFlowOwnerProps {
+    open: boolean;
+    busy: boolean;
+    onPicked: (path: string) => void;
+    onCancel: () => void;
+    onError: (message: string) => void;
+}
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    /** The official ui-workspace provider is disabled by this bundle's patch,
+     * so this plugin owns the global workspaces selector hook (bound from the
+     * Workspace Controller snapshot this apply installs via slots.provideRoot). */
+    interface GlobalStandardProps {
+        useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>;
+    }
+    interface SlotMap {
+        'sidebar.workspaces.directoryFlow': {
+            kind: 'single';
+            scope: 'root';
+            owner: DirectoryFlowOwnerProps;
+        };
+        'conversation.hero.workspace.directoryFlow': {
+            kind: 'single';
+            scope: 'root';
+            owner: DirectoryFlowOwnerProps;
+        };
+    }
+    interface LocaleNamespaceMap {
+        'ya-workspace-sidebar': YaWorkspaceKey;
+    }
+}
+/** Shared directory-flow occupancy source. */
+export interface DirectoryInjected {
+    hooks: {
+        directoryFlow: HostObservable<boolean>;
+    };
+}
+/** Host-probed jsonl storage layout of one session (null = absent/unavailable). */
+export interface SessionPaths {
+    /** Session storage directory, or null on sqlite-backed/unflushed deployments. */
+    dir: string | null;
+    /** Highest-generation log file inside the directory, or null when none exists. */
+    log: string | null;
+}
+/** Browser-private Host operations. */
+export type SidebarInjected = DirectoryInjected & {
+    startSession: (workspaceId?: WorkspaceId) => void;
+    open: (sessionId: SessionId) => void;
+    searchSessions: (query: string, signal: AbortSignal) => Promise<{
+        items: readonly SessionSearchResultItem[];
+        hasMore: boolean;
+    }>;
+    searchResultLimit: number;
+    renameSession: (sessionId: SessionId, title: string) => Promise<void>;
+    forkSession: (sessionId: SessionId) => void;
+    renameWorkspace: (workspaceId: WorkspaceId, title: string) => Promise<void>;
+    deleteWorkspace: (workspaceId: WorkspaceId) => Promise<void>;
+    archiveSession: (sessionId: SessionId) => Promise<void>;
+    insertSessionBefore: (workspaceId: WorkspaceId, sessionId: SessionId, beforeSessionId?: SessionId) => Promise<void>;
+    createWorkspace: (input: {
+        path: string;
+    }) => Promise<WorkspaceView>;
+    resolveSessionPaths: (input: {
+        sessionId: SessionId;
+        cwd?: string;
+    }) => Promise<SessionPaths>;
+    revealInExplorer: (cwd: string) => Promise<void>;
+};
+/** Full sidebar component props. */
+export type SidebarProps = PropsRuntime<'sidebar.workspaces'> & PropsRenderSlots<'sidebar.workspaces.directoryFlow'> & Omit<SidebarInjected, 'hooks'> & {
+    useDirectoryFlow: SnapshotSelectorHook<boolean>;
+} & PropsLocale<'ya-workspace-sidebar'>;
+/** Conversation hero picker operations. */
+export type PickerInjected = DirectoryInjected & {
+    createWorkspace: (input: {
+        path: string;
+    }) => Promise<WorkspaceView>;
+};
+/** Full conversation hero picker props. */
+export type PickerProps = PropsRuntime<'conversation.hero.workspace'> & PropsRenderSlots<'conversation.hero.workspace.directoryFlow'> & Omit<PickerInjected, 'hooks'> & {
+    useDirectoryFlow: SnapshotSelectorHook<boolean>;
+} & PropsLocale<'ya-workspace-sidebar'>;

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

@@ -1,3 +1,8 @@
-/** 19-language override dictionaries for the better-locale store. */
+/** 19-language override dictionaries for the better-locale store.
+ *
+ * Partial on purpose: an override language covers the keys it translated and
+ * falls back to the primary dictionary (en) for the rest, so new keys ship
+ * without forcing translations of every language up front.
+ */
 import type { YaWorkspaceKey } from './locales.ts';
-export declare const dicts: Record<string, Record<YaWorkspaceKey, string>>;
+export declare const dicts: Record<string, Partial<Record<YaWorkspaceKey, string>>>;

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

@@ -1,9 +1,9 @@
-/** Client assembly for the replacement workspace sidebar and hero picker. */
-import type { Context } from '@deepseek-ai/cordis';
-/**
- * Services required by the replacement client entries. `remote` and
- * `remote.directoryPicker` feed the uiWorkspace stand-in's directory picking.
- */
-export declare const inject: string[];
-/** Register the sidebar browser and conversation hero picker. */
-export declare function apply(ctx: Context): void;
+/** Client assembly for the replacement workspace sidebar and hero picker. */
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * Services required by the replacement client entries. `remote` and
+ * `remote.directoryPicker` feed the uiWorkspace stand-in's directory picking.
+ */
+export declare const inject: string[];
+/** Register the sidebar browser and conversation hero picker. */
+export declare function apply(ctx: Context): void;