@chatcode/cco-better-sidebar 0.18.0-alpha.1 → 0.18.0-alpha.3

package/src/context-types.ts

@@ -306,7 +306,8 @@ export interface SidebarSessionPersistenceService {
 
 /** The client session list snapshot the sidebar subscribes to. */
 export interface SidebarSessionList {
-  current: string | undefined
+  /** @deprecated Selection moved to `uiSession.adapter.current`; old hosts may still expose this field. */
+  current?: string
   byId: Record<string, SidebarSessionSummary>
   /** Direct durable catalogs keyed by their selected parent address. */
   subagentsByParent?: Readonly<Record<string, SidebarSubagentCatalog>>
@@ -324,11 +325,6 @@ export interface SidebarSessionsService {
     getSnapshot(): SidebarSessionList
     subscribe(fn: () => void): () => void
   }
-  /**
-   * Select a listed session as current (mirror of the runtime ISessions.open)
-   * — used to jump back to the main agent from the topology root node.
-   */
-  open?(id: string): void
   /**
    * Fork a session from a completed-turn prefix of the source and resolve
    * the child session id (mirror of the runtime ISessions.fork — throws on
@@ -371,6 +367,16 @@ export interface SidebarSessionsService {
   refreshSubagents?(parentSessionId: string): Promise<void>
 }
 
+/** The host's authoritative current Session scope binding. */
+export interface SidebarUiSessionService {
+  adapter: {
+    current: {
+      getSnapshot(): { readonly key: string | undefined }
+      subscribe(fn: () => void): () => void
+    }
+  }
+}
+
 /**
  * The client locale service face (mirror of @deepseek-ai/dsh-client-locale's
  * LocaleRuntime — only the slices the sidebar touches). The sidebar follows
@@ -416,6 +422,16 @@ export interface SidebarWorkspacesService {
   openPath(path: string): Promise<void>
 }
 
+/**
+ * The client Workspace navigation face. Session selection is a UI navigation
+ * operation in current DSH builds: it retains the target for the main view,
+ * updates the scoped Session adapter, and reveals the conversation panel.
+ */
+export interface SidebarUiWorkspaceService {
+  /** Select a Session and show its Conversation, including persisted history. */
+  openSession(sessionId: string): void
+}
+
 /**
  * The invariant service face (mirror of @deepseek-ai/dsh-invariants'
  * InvariantRegistry). The upstream augmentation does not reach this Context
@@ -494,12 +510,16 @@ export interface SidebarContextShape {
   webServer: SidebarWebServer
   /** The session store (host `.get`) and the client list feed (`.list`) faces. */
   sessions: SidebarSessionStore & SidebarSessionsService
+  /** Current UI Session scope; selection no longer belongs to the Session list catalog. */
+  uiSession: SidebarUiSessionService
   /** The web runtime trust list (bind-derived). */
   webRuntime: SidebarWebRuntime
   /** The client slot registry (register/inject). */
   slots: SidebarSlotsService
   /** The client workspaces service face (file-open funnel). */
   workspaces: SidebarWorkspacesService
+  /** The client Workspace navigation service (session-open funnel). */
+  uiWorkspace: SidebarUiWorkspaceService
   /** The settings service face (prefs persistence + namespace reads). */
   settings: SidebarSettingsService
   /** The invariant registry face. */