Import src/client/contract.ts

This commit is contained in:
QQ 2026-11-11 22:31:31 +08:00
parent 7f5e47421a
commit 2e238c6cea
1 changed files with 143 additions and 0 deletions

143
src/client/contract.ts Normal file
View File

@ -0,0 +1,143 @@
/**
* Registrant-private injected share for the workspace-groups browser entry.
* Mirrors the official ui-workspace browser inject (same runtime calls), with
* two differences: the directory-flow hole is kept occupied (`hooks.directoryFlow`)
* because the official entry stays registered behind this one and gates its own
* "Add workspace…" affordance on that hole — Add Workspace itself is
* self-contained via `pickDirectory` — and no locale-keyed naming collision.
*/
import type { HostObservable, InjectFace, PropsLocale, PropsRuntime, PropsStore, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
// Type-only: merges the sidebar shell's SlotMap row (`sidebar.workspaces`, the
// slot this registrant shadows) and its runtime props. Erased from both the JS
// bundle and the emitted .d.ts, so it must stay a bare `import type {}`.
import type {} from '@deepseek-ai/dsh-client-ui-sidebar/client';
import type { ComponentType } from 'react';
import type { DirectoryFlowOwnerProps } from '@deepseek-ai/dsh-client-ui-workspace/client';
import type { SessionId } from '@deepseek-ai/dsh-session/types';
import type { SessionListState, SessionSearchResultItem } from '@deepseek-ai/dsh-api-session-controller/client';
import type { SessionStatus, SessionStatusSnapshot } from '@deepseek-ai/dsh-client-ui-session/client';
import type { WorkspaceId, WorkspaceSnapshot, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
import type { createGroupsViewStore } from './stores.ts';
import type { SessionTabsInstance, SessionTabsState } from './tab-store.ts';
/** Services/slots this registrant's props depend on (documentation alias). */
export type WorkspaceGroupsStoreHandle = ReturnType<typeof createGroupsViewStore>;
/** Injected share (arrives via the register inject factory). */
export type GroupsBrowserInjected = {
/**
* Reserved hooks compartment. `directoryFlow` reports the
* `sidebar.workspaces.directoryFlow` hole as occupied: the official
* ui-workspace entry stays registered behind this one and withdraws its
* "Add workspace…" affordance when the hole is empty, so this browser keeps
* it truthy (it drives the picker itself through `pickDirectory`).
*/
hooks: {
/** True while the sidebar browsing region's directory-flow hole is occupied. */
directoryFlow: HostObservable<boolean>;
};
/** Start a New Session in a Workspace (reuse-or-create its blank session and open it). */
startSession: (workspaceId?: WorkspaceId) => void;
/**
* Create a real Session in one folder of a Workspace and open it. `cwd` is
* omitted for the base folder (the Workspace's own canonical directory).
*/
createSessionIn: (workspaceId: WorkspaceId, cwd?: string) => Promise<SessionId>;
/** Open a real Session. */
open: (sessionId: SessionId) => void;
/** Search current visible conversation messages. */
searchSessions: (query: string, signal: AbortSignal) => Promise<{
items: readonly SessionSearchResultItem[];
hasMore: boolean;
}>;
/** Maximum number of merged rows rendered for one search. */
searchResultLimit: number;
/** Rename a Session (resolves on host acceptance). */
renameSession: (sessionId: SessionId, title: string) => Promise<void>;
/** Fork a Session at its last completed turn and open the child. */
forkSession: (sessionId: SessionId) => void;
/** Rename a Host Workspace (rejects on name conflict). */
renameWorkspace: (workspaceId: WorkspaceId, title: string) => Promise<void>;
/** Delete only a Host Workspace registration; directory and Session logs remain. */
deleteWorkspace: (workspaceId: WorkspaceId) => Promise<void>;
/** Reorder a Workspace in the durable registry display order (omitted anchor appends). */
insertWorkspaceBefore: (workspaceId: WorkspaceId, beforeWorkspaceId?: WorkspaceId) => Promise<void>;
/** Archive a Session into the registry-global set (hidden from grouping surfaces). */
archiveSession: (sessionId: SessionId) => Promise<void>;
/** Reorder a session inside its Workspace account. */
insertSessionBefore: (workspaceId: WorkspaceId, sessionId: SessionId, beforeSessionId?: SessionId) => Promise<void>;
/** Adopt a picked host directory as a real Workspace before targeting a Session. */
createWorkspace: (input: {
path: string;
}) => Promise<WorkspaceView>;
/** Ask the local Host to open its native single-directory chooser (self-contained Add Workspace). */
pickDirectory: () => Promise<string | null>;
/** Snapshot a self-contained standard picker without redeclaring its owned slot. */
getDirectoryFlow: () => {
component: ComponentType<DirectoryFlowOwnerProps>;
injected: Record<string, unknown>;
} | null;
/** DSH native local directory creation (SSH routing is owned by our adapter). */
createDirectory: (path: string, name: string) => Promise<string>;
/**
* Surface the session-tab strip for a session that is in play (called with the
* session the browser itself just opened, and again whenever its status
* changes). Tab visibility rules live in `shouldOpenTab`; the status is passed
* in because "it started working" is a live-status fact the store layer cannot
* read on its own.
* @param sessionId - the session to consider.
* @param status - its unified UI status, when one is published.
*/
openTab: (sessionId: SessionId, status: SessionStatus | undefined) => void;
/**
* Selector hook over the shared tab store, bound by this plugin (the strip is
* not a slot occupant, so the framework does not bind it). Built from the one
* live instance the browser writes through.
*/
useTabs: <S>(selector: (state: SessionTabsState) => S, eq?: (a: S, b: S) => boolean) => S;
/** The tab store's baked write set (the same one `apply` writes through). */
tabActions: SessionTabsInstance['actions'];
};
/** Full browser props: shell owner share + viewing store + injected actions + locale seat. */
export type GroupsBrowserProps = PropsRuntime<'sidebar.workspaces'> & PropsStore<ReturnType<typeof createGroupsViewStore>> & InjectFace<GroupsBrowserInjected> & PropsLocale<'workspaceGroups'>;
/**
* The two framework global seats the strip reads, declared structurally because
* `GlobalStandardProps`'s own members arrive from merge declarations this repo
* cannot resolve (its packages ship no `src`, so the merged hook types are only
* visible to the compiling package). Both are the shipped global selector hooks
* with the same names and shapes, and both are seated on the
* `sidebar.workspaces` occupant that renders this strip.
*/
export interface SessionsTabsStandardProps {
/** Session list and current selection (framework global seat). */
useSessions: SnapshotSelectorHook<SessionListState>;
/** Unified per-session UI status (framework global seat). */
useSessionStatus: SnapshotSelectorHook<SessionStatusSnapshot>;
/**
* Workspace registry (framework global seat). The strip reads it to label each
* tab with the project that owns its session — the one fact a bare strip of
* session titles cannot convey.
*/
useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>;
}
/**
* Full tab-strip props.
*
* The strip is NOT a slot occupant: the conversation column declares no child
* slot, so it renders through a DOM seat (`tab-seat.ts`) and receives plain
* React props instead of framework shares. Only the two global selector hooks
* below are framework-provided, and they arrive because the strip is rendered
* as a CHILD of this plugin's own `sidebar.workspaces` occupant — which seats
* both of them in the standard kit. Everything else is passed explicitly by
* that parent, which is what removes the strip from the slot registry entirely
* and with it the cross-scope store conflict the slot version hit.
*/
export type SessionsTabsProps = SessionsTabsStandardProps & {
/** Selector hook over the shared tab store's snapshot. */
useTabs: SnapshotSelectorHook<SessionTabsState>;
/** The tab store's baked write set (the same set `apply` writes through). */
actions: SessionTabsInstance['actions'];
/** Make a tab's session the open one (`ctx.uiWorkspace.openSession`). */
activate: (sessionId: SessionId) => void;
/** Ask the browser to open its rename dialog for a tab session. */
rename: (sessionId: SessionId, currentTitle: string) => void;
} & PropsLocale<'workspaceGroups'>;