jupyterlab_claude_code_extension 1.2.24 → 1.2.26

package/README.md

@@ -31,7 +31,8 @@ Chat-panel extensions re-implement the agent loop and trail the real tool. This
 - **Favorites** - star projects you keep coming back to via the right-click menu
 - **Remove** - drop a project's Claude history from the panel via the right-click menu; a confirmation dialog names the project and warns it removes the whole project and all its conversations before anything is touched, then the history folder is moved to the trash (it honours JupyterLab's "move files to trash" setting), not deleted permanently
 - **Clean up parallel sessions** - when a project has accumulated extra sessions beyond the main one, a right-click menu item (showing the count in brackets) removes them all, keeping only the main session; a confirmation dialog naming the project and the count appears first, and removed files honour the same trash setting
-- **Conversation switcher** - a right-click "Switch and Manage Sessions" submenu lists a project's other conversations by name and short session id, e.g. `home (3f2a1b9c)`, with last-activity time; pick one and it becomes the row's current conversation - the next click resumes exactly that one. The submenu shows the 5 most recent; "Manage Sessions..." opens a searchable popup over the full list where conversations can also be deleted - select one, many, or all via checkboxes, then confirm in a dialog that names the project and the count (removed files honour the trash setting). Rows with multiple conversations show a branch icon with the count after the name
+- **Conversation switcher** - a right-click "Switch and Manage Sessions" submenu lists a project's other conversations by name and short session id, e.g. `home (3f2a1b9c)`, with last-activity time; pick one and it becomes the row's current conversation - the next click resumes exactly that one. The submenu shows the 5 most recent; "Manage Sessions..." opens a searchable popup - a scrollable table over the full list with the current conversation pinned at the top and accented. Conversations can also be deleted here - select one, many, or all via checkboxes, then click Delete; they move to trash immediately (no confirmation, with an "N moved to trash" message; removed files honour the trash setting). Rows with multiple conversations show a branch icon with the count after the name
+- **Open branched conversation** - a separate right-click "Open Branched Conversation" submenu (and an "Open" button on every row of the Manage Sessions popup) opens any conversation directly in its own terminal, so several branches of one project can run side by side; clicking a row reuses an open terminal only when it is already running that exact conversation, so switching a branch and clicking lands you in the right one rather than the original
 - **Branch session** - fork the current conversation into a new named session via the right-click menu (normal or skip-permissions mode); uses Claude's native `--fork-session`, opens in a new terminal, the chosen name is stamped automatically, and the fork becomes the row's current conversation
 - **Copy session id** - a right-click "Copy Session ID" item copies the row's current conversation id to the clipboard; the Manage Sessions popup adds a copy button on every row, so any parallel conversation's id is one click away
 - **Activity at a glance** - each row shows its last activity (`now`, `5m ago`, `2h ago`, `3d ago`) in an aligned column, with the favourite star in its own column beside it; rows active within the last minute light up in the theme's brand colour (including the `now` label), rows idle for over a week dim slightly

package/lib/widget.d.ts

@@ -47,6 +47,21 @@ export declare class ClaudeCodeSessionsWidget extends Widget {
     private _remove;
     private _cleanupParallel;
     private _resumeInTerminal;
+    /**
+     * Reuse an open terminal only when it is running the conversation the
+     * caller wants; otherwise launch a fresh ``claude --resume <id>``.
+     *
+     * ``strict`` selects how a cwd-matching claude terminal whose conversation
+     * is UNKNOWN (started fresh, no ``--resume`` in its argv) is treated:
+     * - lenient (row resume): reuse it. A fresh session's id is not in its
+     *   argv, so this is the only way to refocus a just-started session, and
+     *   it avoids ``claude --resume`` erroring with "already in use".
+     * - strict (Open Branched Conversation): never reuse an unknown terminal -
+     *   the user picked a specific branch and must land in THAT conversation,
+     *   so a fresh/foreign terminal is left alone and a new one is launched.
+     * A terminal whose resume id is KNOWN and differs is never reused in
+     * either mode - that is the switch-then-click bug this fixes.
+     */
     private _doResumeInTerminal;
     /** Absolute path of the file browser's current folder; falls back to the
      * server root when no file browser is available. */
@@ -143,6 +158,24 @@ export declare class ClaudeCodeSessionsWidget extends Widget {
      * The backend touches the branch JSONL's mtime; a refresh then shows
      * the selected conversation as the row's current one. */
     private _switchBranch;
+    /** Open a specific conversation branch in its own terminal.
+     *
+     * Strict reuse: only a terminal already running THIS conversation is
+     * refocused; otherwise a fresh ``claude --resume <id>`` is launched. So
+     * several branches of one project can be open independently and side by
+     * side - opening branch B never disturbs branch A's terminal. Honours the
+     * global skip-permissions toggle like a normal resume. */
+    private _openBranch;
+    /** Poll fast for a freshly forked branch to materialise, then refresh.
+     *
+     * claude writes a forked session's JSONL lazily (on its first turn), so a
+     * just-requested branch does not exist at launch and would otherwise only
+     * surface on the next 30s poll. This watches the project's branch list
+     * every ``BRANCH_WATCH_INTERVAL_MS`` until ``forkId`` appears (as current
+     * or in the list) - then does one full refresh and stops - or until a
+     * bounded number of attempts elapses. The panel is never updated before
+     * the branch genuinely exists. */
+    private _watchForBranch;
     private _startPolling;
     private _stopPolling;
     private readonly _app;
@@ -157,6 +190,7 @@ export declare class ClaudeCodeSessionsWidget extends Widget {
     private _commands;
     private _contextMenu;
     private _branchSubmenu;
+    private _openBranchSubmenu;
     private _branchSessionMenu;
     private _lastBranches;
     private _lastBranchesCurrent;