@crazx/dsh-api-session-controller 0.1.5-alpha.1.zw.3 → 0.1.5-rc.1.zw.2

package/lib/types/client/sessions/manager.js

@@ -8,7 +8,6 @@ import { flattenLineage } from "./lineage.js";
 import { Notifier } from "./notifier.js";
 import { ProjectionValueStore } from "./projection-store.js";
 import { Session } from "./session.js";
-import { SelectionHistory } from "./selection-history.js";
 function sessionSeqCursor(value) {
     return value === -1 ? -1 : SessionSeq(value);
 }
@@ -58,10 +57,6 @@ export class SessionManager {
      */
     jobsBySession = new Map();
     selected;
-    /** Toolbar back/forward history over selections (session, addressed child, or clear). */
-    selectionHistory = new SelectionHistory();
-    /** While replaying a history entry, the selections it makes must not re-record. */
-    navigatingHistory = false;
     listSnapshotCache;
     /** Entry-identity cache (reference stability): list rebuilds reuse the previous entry
      *  object when every field matches — wire refreshes mint all-new summary objects, so identity
@@ -80,11 +75,6 @@ export class SessionManager {
         this.selected = restoredSelection;
         if (restoredAddress !== undefined)
             this.addresses.set(restoredAddress.childSessionId, restoredAddress);
-        // The restored selection seeds the history so back/forward always has a
-        // home position; a cold start without one records the cleared state.
-        this.selectionHistory.record(restoredSelection === undefined
-            ? {}
-            : { sessionId: restoredSelection, ...(restoredAddress !== undefined ? { address: restoredAddress } : {}) });
         this.listSnapshotCache = this.buildListSnapshot();
     }
     // ---- Selection ----
@@ -105,8 +95,6 @@ export class SessionManager {
         this.selected = sessionId;
         // Looking at the session consumes its completion reminder (dot clears).
         this.completedNotifications.delete(sessionId);
-        if (!this.navigatingHistory)
-            this.selectionHistory.record(address === undefined ? { sessionId } : { sessionId, address });
         void this.refreshSubagents(sessionId);
         this.notifier.notifyNow();
     }
@@ -124,79 +112,14 @@ export class SessionManager {
         this.sessions.get(address.childSessionId)?.configureSubagent(address, catalog?.parentAvailable);
         this.selected = address.childSessionId;
         this.completedNotifications.delete(address.childSessionId);
-        if (!this.navigatingHistory)
-            this.selectionHistory.record({ sessionId: address.childSessionId, address });
         void this.refreshSubagents(address.childSessionId);
         this.notifier.notifyNow();
     }
     /** Clear the selection (the layout falls to the no-session view state). */
     clearSelection() {
         this.selected = undefined;
-        if (!this.navigatingHistory)
-            this.selectionHistory.record({});
         this.notifier.notifyNow();
     }
-    // ---- Selection history (toolbar back/forward) ----
-    /** Whether an older selection exists to go back to. */
-    canBack() {
-        return this.selectionHistory.canBack();
-    }
-    /** Whether a newer selection exists to go forward to. */
-    canForward() {
-        return this.selectionHistory.canForward();
-    }
-    /**
-     * Select the previous history entry. Unreachable entries (sessions removed
-     * before their prune landed) are pruned and the walk continues to older
-     * entries; the walk stops silently at the oldest bound.
-     */
-    back() {
-        while (this.selectionHistory.canBack()) {
-            const entry = this.selectionHistory.back();
-            if (entry === undefined)
-                return;
-            if (!this.canReplay(entry)) {
-                if (entry.sessionId !== undefined)
-                    this.selectionHistory.prune(entry.sessionId);
-                continue;
-            }
-            this.replaySelection(entry);
-            return;
-        }
-    }
-    /**
-     * Select the next history entry after a back navigation; silently a
-     * no-op at the newest bound.
-     */
-    forward() {
-        const entry = this.selectionHistory.forward();
-        if (entry === undefined)
-            return;
-        if (this.canReplay(entry))
-            this.replaySelection(entry);
-        else if (entry.sessionId !== undefined)
-            this.selectionHistory.prune(entry.sessionId);
-    }
-    /** Whether a history entry names a session that is still listed or addressed. */
-    canReplay(entry) {
-        if (entry.sessionId === undefined)
-            return true;
-        return this.summaries.some(summary => summary.sessionId === entry.sessionId)
-            || this.addresses.has(entry.sessionId);
-    }
-    /** Replay one entry without recording it back into the history. */
-    replaySelection(entry) {
-        this.navigatingHistory = true;
-        try {
-            if (entry.sessionId === undefined)
-                this.clearSelection();
-            else
-                this.select(entry.sessionId);
-        }
-        finally {
-            this.navigatingHistory = false;
-        }
-    }
     /**
      * Return the durable catalog address retained for one child.
      * @param sessionId - possible addressed child id.
@@ -456,8 +379,6 @@ export class SessionManager {
                     let summaries = baseline;
                     for (const mutation of mutations) {
                         summaries = applyMutation(summaries, mutation);
-                        if (mutation.kind === 'remove')
-                            this.selectionHistory.prune(mutation.sessionId);
                         this.summaries = summaries;
                         this.syncCompletedNotifications();
                     }
@@ -603,9 +524,6 @@ export class SessionManager {
     recordMutation(mutation) {
         this.listMutations?.push(mutation);
         this.summaries = applyMutation(this.summaries, mutation);
-        // A removal forgets the session's toolbar back/forward history entries.
-        if (mutation.kind === 'remove')
-            this.selectionHistory.prune(mutation.sessionId);
         // Eager edge reconciliation — a snapshot-build-time pass would miss consecutive status frames.
         this.syncCompletedNotifications();
         this.notifier.markDirty();

package/lib/types/client/sessions/service.d.ts

@@ -185,14 +185,6 @@ export declare class ClientSessions implements ISessions {
      * per the masked-gap contract until the next open() moves the stage.
      */
     clear(): void;
-    /** Whether the transient selection history has an older entry to go back to. */
-    canBack(): boolean;
-    /** Whether the transient selection history has a newer entry to go forward to. */
-    canForward(): boolean;
-    /** Select the previous history entry (prunes unreachable entries on the way). */
-    back(): void;
-    /** Select the next history entry after a back navigation. */
-    forward(): void;
     /**
      * Refresh the real Session baseline, reusing an in-flight pull.
      * @returns completion of the current or newly started baseline pull.

package/lib/types/client/sessions/service.js

@@ -193,22 +193,6 @@ export class ClientSessions {
     clear() {
         this.manager.clearSelection();
     }
-    /** Whether the transient selection history has an older entry to go back to. */
-    canBack() {
-        return this.manager.canBack();
-    }
-    /** Whether the transient selection history has a newer entry to go forward to. */
-    canForward() {
-        return this.manager.canForward();
-    }
-    /** Select the previous history entry (prunes unreachable entries on the way). */
-    back() {
-        this.manager.back();
-    }
-    /** Select the next history entry after a back navigation. */
-    forward() {
-        this.manager.forward();
-    }
     /**
      * Refresh the real Session baseline, reusing an in-flight pull.
      * @returns completion of the current or newly started baseline pull.

package/lib/types/index.d.ts

@@ -26,6 +26,8 @@ export interface Config {
 export interface SessionControllerInternals {
     /** Native default-application handoff. */
     readonly openPath?: (path: string, signal: AbortSignal) => Promise<void>;
+    /** Native file-manager handoff. */
+    readonly revealPath?: (path: string, signal: AbortSignal) => Promise<void>;
     /** Native handoff availability probe. */
     readonly canOpenPath?: () => boolean;
 }
@@ -39,6 +41,7 @@ export declare class SessionController extends TypertRemoteService {
     private readonly history;
     private readonly listState;
     private readonly openPath;
+    private readonly revealPath;
     private readonly canOpenPath;
     private readonly promotions;
     /**
@@ -97,6 +100,15 @@ export declare class SessionController extends TypertRemoteService {
      * @returns true when the matching open operation is available.
      */
     canOpenWorkspacePath(): boolean;
+    /**
+     * Describe the serving desktop for authenticated file-action routes.
+     * @returns Host name, configured availability, and platform-specific file-manager behavior.
+     */
+    workspaceDesktop(): {
+        name: string;
+        available: boolean;
+        fileManager: 'finder' | 'explorer' | 'directory' | null;
+    };
     /**
      * Open one path prepared by a Session-aware caller on the Host desktop.
      * @param request - path after best-effort Session workspace resolution.

package/lib/types/index.js

@@ -85,9 +85,10 @@ var __disposeResources = (this && this.__disposeResources) || (function (Suppres
     var e = new Error(message);
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 });
+import { hostname } from 'node:os';
 import z from '@deepseek-ai/schemastery';
 import { errorChain } from '@deepseek-ai/dsh-llm';
-import { canOpenNativePath, openNativePath } from '@deepseek-ai/dsh-native-command';
+import { canOpenNativePath, nativeFileManager, openNativePath, revealNativePath } from '@deepseek-ai/dsh-native-command';
 import { Remote, RemoteError, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import { ApiSessionAgentController, inspectApiSession, } from "./agent.js";
 import { SessionCommandController } from "./commands.js";
@@ -180,6 +181,7 @@ let SessionController = (() => {
         history;
         listState;
         openPath;
+        revealPath;
         canOpenPath;
         promotions = new Set();
         /**
@@ -207,6 +209,7 @@ let SessionController = (() => {
             this.history = new SessionHistoryController(ctx, (observation) => { this.promote(observation); });
             this.listState = new ApiSessionList(ctx);
             this.openPath = internals.openPath ?? openNativePath;
+            this.revealPath = internals.revealPath ?? revealNativePath;
             this.canOpenPath = internals.canOpenPath
                 ?? (() => config.nativeOpen ?? (internals.openPath !== undefined || canOpenNativePath()));
             ctx.plugin(SessionFileReferences);
@@ -331,6 +334,14 @@ let SessionController = (() => {
         canOpenWorkspacePath() {
             return this.canOpenPath();
         }
+        /**
+         * Describe the serving desktop for authenticated file-action routes.
+         * @returns Host name, configured availability, and platform-specific file-manager behavior.
+         */
+        workspaceDesktop() {
+            const fileManager = nativeFileManager();
+            return { name: hostname(), available: fileManager !== null && this.canOpenPath(), fileManager };
+        }
         /**
          * Open one path prepared by a Session-aware caller on the Host desktop.
          * @param request - path after best-effort Session workspace resolution.
@@ -344,7 +355,10 @@ let SessionController = (() => {
             }
             signal.throwIfAborted();
             try {
-                await this.openPath(request.path, signal);
+                if (request.action === 'reveal')
+                    await this.revealPath(request.path, signal);
+                else
+                    await this.openPath(request.path, signal);
                 return { opened: true };
             }
             catch (error) {

package/lib/types/types.d.ts

@@ -332,6 +332,8 @@ export interface SessionCancelValue {
 }
 /** Request to open one path prepared by a Session-aware caller on the Host desktop. */
 export interface SessionOpenWorkspacePathRequest {
+    /** File-manager navigation when requested; omission uses the default application. */
+    readonly action?: 'reveal';
     /** Path after best-effort Session workspace resolution, in Host filesystem syntax. */
     readonly path: string;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@crazx/dsh-api-session-controller",
   "description": "Session Remote commands, cold reads, and live control transport",
-  "version": "0.1.5-alpha.1.zw.3",
+  "version": "0.1.5-rc.1.zw.2",
   "publishConfig": {
     "access": "public"
   },
@@ -64,42 +64,42 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh-brand": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-deque": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-brand": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-deque": "^0.1.5-rc.1",
     "@deepseek-ai/schemastery": "^3.18.2",
     "mime-types": "^3.0.2",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-agent-default-model": "npm:@crazx/dsh-agent-default-model@0.1.5-alpha.1.zw.3",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-attachment": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-file-upload": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-commands": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-file-reference": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-fs": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-jobs": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-native-command": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-scope": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-query": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-title": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-skill": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-subagent": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-typert-registry": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-util-time": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-util-values": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-workspace": "^0.1.5-alpha.1"
+    "@deepseek-ai/dsh-agent": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-agent-default-model": "0.1.5-rc.1.zw.2",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-file-upload": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-file-reference": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-jobs": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-native-command": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-scope": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-query": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-skill": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-typert-registry": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-util-time": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-util-values": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-workspace": "^0.1.5-rc.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-jobs": {
@@ -114,43 +114,43 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-agent-default-model": "npm:@crazx/dsh-agent-default-model@0.1.5-alpha.1.zw.3",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-attachment": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-file-upload": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-commands": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-file-reference": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-fs": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-fs-local": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-jobs": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-native-command": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-permission-presets": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-scope": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-query": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-title": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-skill": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-storage": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-storage-domain": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-storage-json": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-subagent": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-typert-registry": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-util-crypto": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-util-time": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-util-values": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-workspace": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-agent": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-agent-default-model": "npm:@crazx/dsh-agent-default-model@0.1.5-rc.1.zw.2",
+    "@deepseek-ai/dsh-agent-loop": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-file-upload": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-file-reference": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-fs-local": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-jobs": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-native-command": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-scope": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-query": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-skill": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-storage": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-storage-json": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-typert-registry": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-util-crypto": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-util-time": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-util-values": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-workspace": "^0.1.5-rc.1",
     "@types/mime-types": "^3.0.1"
   },
   "scripts": {

package/lib/types/client/sessions/selection-history.d.ts

@@ -1,55 +0,0 @@
-/**
- * Bounded transient selection history behind the desktop toolbar's
- * back/forward navigation. Entries record WHICH selection was made — a
- * listed session, an addressed subagent, or the cleared no-session state —
- * never when, and never any session content. Browser-local and transient by
- * design: nothing here is persisted, so a reload starts empty.
- */
-import type { SessionId } from '@deepseek-ai/dsh-session/types';
-import type { SubagentAddress } from '@deepseek-ai/dsh-subagent/client';
-/** One selection-history entry; `sessionId: undefined` is the cleared state. */
-export interface SelectionEntry {
-    readonly sessionId?: SessionId;
-    /** Retained direct-parent address for an addressed subagent selection. */
-    readonly address?: SubagentAddress;
-}
-/**
- * Bounded LIFO-with-cursor history. Recording a selection made outside
- * navigation collapses consecutive repeats, truncates the forward tail after
- * a backtrack, and drops the oldest entry past the bound. Pruning removes
- * deleted sessions wherever they sit and re-points the cursor onto the same
- * logical position.
- */
-export declare class SelectionHistory {
-    #private;
-    private readonly limit;
-    constructor(limit?: number);
-    get entries(): readonly SelectionEntry[];
-    get cursor(): number;
-    /** Whether an older entry exists to go back to. */
-    canBack(): boolean;
-    /** Whether a newer entry exists to go forward to. */
-    canForward(): boolean;
-    /**
-     * Record one selection made outside history navigation.
-     * @param entry - the selection (session, addressed subagent, or clear).
-     */
-    record(entry: SelectionEntry): void;
-    /**
-     * Step one entry back.
-     * @returns the entry to replay, or undefined at the oldest bound.
-     */
-    back(): SelectionEntry | undefined;
-    /**
-     * Step one entry forward.
-     * @returns the entry to replay, or undefined at the newest bound.
-     */
-    forward(): SelectionEntry | undefined;
-    /**
-     * Drop every entry referencing the removed session wherever it sits,
-     * keeping the cursor on the same logical position.
-     * @param sessionId - the removed session.
-     */
-    prune(sessionId: SessionId): void;
-}
-//# sourceMappingURL=selection-history.d.ts.map

package/lib/types/client/sessions/selection-history.js

@@ -1,91 +0,0 @@
-function sameSelection(left, right) {
-    return left.sessionId === right.sessionId
-        && left.address?.parentSessionId === right.address?.parentSessionId
-        && left.address?.childSessionId === right.address?.childSessionId;
-}
-/**
- * Bounded LIFO-with-cursor history. Recording a selection made outside
- * navigation collapses consecutive repeats, truncates the forward tail after
- * a backtrack, and drops the oldest entry past the bound. Pruning removes
- * deleted sessions wherever they sit and re-points the cursor onto the same
- * logical position.
- */
-export class SelectionHistory {
-    limit;
-    /** Oldest-first; the cursor sits ON the current entry (-1 while empty). */
-    #entries = [];
-    #cursor = -1;
-    constructor(limit = 50) {
-        this.limit = limit;
-    }
-    get entries() {
-        return this.#entries;
-    }
-    get cursor() {
-        return this.#cursor;
-    }
-    /** Whether an older entry exists to go back to. */
-    canBack() {
-        return this.#cursor > 0;
-    }
-    /** Whether a newer entry exists to go forward to. */
-    canForward() {
-        return this.#cursor < this.#entries.length - 1;
-    }
-    /**
-     * Record one selection made outside history navigation.
-     * @param entry - the selection (session, addressed subagent, or clear).
-     */
-    record(entry) {
-        const current = this.#entries[this.#cursor];
-        if (current !== undefined && sameSelection(current, entry))
-            return;
-        this.#entries.length = this.#cursor + 1;
-        this.#entries.push(entry);
-        if (this.#entries.length > this.limit)
-            this.#entries.shift();
-        this.#cursor = this.#entries.length - 1;
-    }
-    /**
-     * Step one entry back.
-     * @returns the entry to replay, or undefined at the oldest bound.
-     */
-    back() {
-        if (!this.canBack())
-            return undefined;
-        this.#cursor -= 1;
-        const entry = this.#entries[this.#cursor];
-        return entry;
-    }
-    /**
-     * Step one entry forward.
-     * @returns the entry to replay, or undefined at the newest bound.
-     */
-    forward() {
-        if (!this.canForward())
-            return undefined;
-        this.#cursor += 1;
-        const entry = this.#entries[this.#cursor];
-        return entry;
-    }
-    /**
-     * Drop every entry referencing the removed session wherever it sits,
-     * keeping the cursor on the same logical position.
-     * @param sessionId - the removed session.
-     */
-    prune(sessionId) {
-        let removedBeforeCursor = 0;
-        for (let index = this.#entries.length - 1; index >= 0; index -= 1) {
-            const entry = this.#entries[index];
-            if (entry === undefined || entry.sessionId !== sessionId)
-                continue;
-            this.#entries.splice(index, 1);
-            if (index <= this.#cursor)
-                removedBeforeCursor += 1;
-        }
-        this.#cursor -= removedBeforeCursor;
-        if (this.#cursor > this.#entries.length - 1)
-            this.#cursor = this.#entries.length - 1;
-    }
-}
-//# sourceMappingURL=selection-history.js.map