@selesai/code 0.13.8 → 0.13.10

package/dist/modes/rpc/rpc-types.d.ts

@@ -7,16 +7,21 @@
 import type { AgentMessage, ThinkingLevel } from "@earendil-works/pi-agent-core";
 import type { ImageContent, Model } from "@earendil-works/pi-ai";
 import type { SessionStats } from "../../core/agent-session.ts";
+import type { KeybindingsConfig } from "../../core/keybindings.ts";
+import type { Settings, SettingsScope } from "../../core/settings-manager.ts";
 import type { BashResult } from "../../core/bash-executor.ts";
 import type { CompactionResult } from "../../core/compaction/index.ts";
-import type { SessionEntry, SessionTreeNode } from "../../core/session-manager.ts";
+import type { BranchSummaryEntry, SessionEntry, SessionTreeNode } from "../../core/session-manager.ts";
 import type { SourceInfo } from "../../core/source-info.ts";
+import type { ChangelogEntry } from "../../utils/changelog.ts";
 export type RpcCommand = {
     id?: string;
     type: "prompt";
     message: string;
     images?: ImageContent[];
     streamingBehavior?: "steer" | "followUp";
+    /** Buffer the prompt during compaction and auto-send it after compaction_end (mirrors TUI compaction queue). */
+    queueWhileCompacting?: boolean;
 } | {
     id?: string;
     type: "steer";
@@ -52,9 +57,11 @@ export type RpcCommand = {
 } | {
     id?: string;
     type: "cycle_model";
+    direction?: "forward" | "backward";
 } | {
     id?: string;
     type: "get_available_models";
+    refresh?: boolean;
 } | {
     id?: string;
     type: "set_thinking_level";
@@ -116,6 +123,7 @@ export type RpcCommand = {
     id?: string;
     type: "export_html";
     outputPath?: string;
+    themeName?: string;
 } | {
     id?: string;
     type: "switch_session";
@@ -137,6 +145,7 @@ export type RpcCommand = {
 } | {
     id?: string;
     type: "get_tree";
+    filter?: "default" | "no-tools" | "user-only" | "labeled-only" | "all";
 } | {
     id?: string;
     type: "get_last_assistant_text";
@@ -144,6 +153,104 @@ export type RpcCommand = {
     id?: string;
     type: "set_session_name";
     name: string;
+} | {
+    id?: string;
+    type: "get_settings";
+    scope?: "global" | "project" | "effective";
+} | {
+    id?: string;
+    type: "set_settings";
+    scope?: SettingsScope;
+    values: Partial<Settings>;
+} | {
+    id?: string;
+    type: "factory_reset_settings";
+} | {
+    id?: string;
+    type: "get_auth_providers";
+} | {
+    id?: string;
+    type: "login";
+    providerId: string;
+    authType: "oauth" | "api_key";
+} | {
+    id?: string;
+    type: "logout";
+    providerId: string;
+} | {
+    id?: string;
+    type: "get_auth_state";
+} | {
+    id?: string;
+    type: "get_scoped_models";
+} | {
+    id?: string;
+    type: "set_scoped_models";
+    enabled?: string[];
+    reorder?: string[];
+} | {
+    id?: string;
+    type: "import_jsonl";
+    path: string;
+} | {
+    id?: string;
+    type: "navigate_tree";
+    targetId: string;
+    summarize?: boolean;
+    customInstructions?: string;
+    replaceInstructions?: boolean;
+    label?: string;
+} | {
+    id?: string;
+    type: "list_sessions";
+    scope?: "current" | "all";
+} | {
+    id?: string;
+    type: "rename_session";
+    path: string;
+    name: string;
+} | {
+    id?: string;
+    type: "delete_session";
+    path: string;
+} | {
+    id?: string;
+    type: "set_session_models";
+    enabled?: string[];
+    reorder?: string[];
+} | {
+    id?: string;
+    type: "git";
+    command: string;
+} | {
+    id?: string;
+    type: "reload";
+} | {
+    id?: string;
+    type: "set_entry_label";
+    entryId: string;
+    label?: string;
+} | {
+    id?: string;
+    type: "get_trust";
+} | {
+    id?: string;
+    type: "set_trust";
+    decision: boolean | null;
+} | {
+    id?: string;
+    type: "get_hotkeys";
+} | {
+    id?: string;
+    type: "get_available_themes";
+} | {
+    id?: string;
+    type: "get_version_info";
+} | {
+    id?: string;
+    type: "share_gist";
+    public?: boolean;
+    themeName?: string;
 } | {
     id?: string;
     type: "get_messages";
@@ -158,9 +265,23 @@ export interface RpcSlashCommand {
     /** Human-readable description */
     description?: string;
     /** What kind of command this is */
-    source: "extension" | "prompt" | "skill";
+    source: "extension" | "prompt" | "skill" | "builtin";
     /** Source metadata for the owning resource */
     sourceInfo: SourceInfo;
+    /** True for interactive-TUI-only builtins that cannot be invoked via prompt */
+    interactiveOnly?: boolean;
+}
+/** Session listing entry (SessionInfo with transcript text stripped). */
+export interface RpcSessionInfo {
+    path: string;
+    id: string;
+    cwd: string;
+    name?: string;
+    parentSessionPath?: string;
+    created: string;
+    modified: string;
+    messageCount: number;
+    firstMessage: string;
 }
 export interface RpcSessionState {
     model?: Model<any>;
@@ -434,6 +555,221 @@ export type RpcResponse = {
     data: {
         commands: RpcSlashCommand[];
     };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_settings";
+    success: true;
+    data: {
+        scope: "global" | "project" | "effective";
+        settings: Settings;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "set_settings";
+    success: true;
+    data: {
+        scope: SettingsScope;
+        values: Partial<Settings>;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "factory_reset_settings";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "get_auth_providers";
+    success: true;
+    data: {
+        providers: Array<{
+            providerId: string;
+            name: string;
+            authTypes: Array<"oauth" | "api_key">;
+        }>;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "login";
+    success: true;
+    data: {
+        providerId: string;
+        authType: "oauth" | "api_key";
+        message: string;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "logout";
+    success: true;
+    data: {
+        providerId: string;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_auth_state";
+    success: true;
+    data: {
+        providers: Array<{
+            providerId: string;
+            authType: "oauth" | "api_key";
+            source: string;
+        }>;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_scoped_models";
+    success: true;
+    data: {
+        enabled: string[];
+        models: Model<any>[];
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "set_scoped_models";
+    success: true;
+    data: {
+        enabled: string[];
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "import_jsonl";
+    success: true;
+    data: {
+        sessionPath: string;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "navigate_tree";
+    success: true;
+    data: {
+        editorText?: string;
+        cancelled: boolean;
+        aborted?: boolean;
+        summaryEntry?: BranchSummaryEntry | null;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "list_sessions";
+    success: true;
+    data: {
+        sessions: RpcSessionInfo[];
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "rename_session";
+    success: true;
+    data: {
+        path: string;
+        name: string;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "delete_session";
+    success: true;
+    data: {
+        path: string;
+        method: "trash" | "unlink";
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "set_session_models";
+    success: true;
+    data: {
+        enabled: string[];
+        models: Model<any>[];
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "git";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "reload";
+    success: true;
+} | {
+    id?: string;
+    type: "response";
+    command: "set_entry_label";
+    success: true;
+    data: {
+        labelId: string;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_trust";
+    success: true;
+    data: {
+        cwd: string;
+        savedDecision: {
+            path: string;
+            decision: boolean;
+        } | null;
+        projectTrusted: boolean;
+        trustRequired: boolean;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "set_trust";
+    success: true;
+    data: {
+        decision: boolean | null;
+        restartRequired: boolean;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_hotkeys";
+    success: true;
+    data: {
+        hotkeys: KeybindingsConfig;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_available_themes";
+    success: true;
+    data: {
+        themes: Array<{
+            name: string;
+            path?: string;
+        }>;
+        current: string | undefined;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_version_info";
+    success: true;
+    data: {
+        version: string;
+        changelog: ChangelogEntry[];
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "share_gist";
+    success: true;
+    data: {
+        url: string;
+        gistUrl: string;
+    };
 } | {
     id?: string;
     type: "response";
@@ -469,6 +805,8 @@ export type RpcExtensionUIRequest = {
     method: "input";
     title: string;
     placeholder?: string;
+    /** "secret": render as single-line password (e.g. API key entry). Defaults to "text". */
+    inputKind?: "text" | "secret";
     timeout?: number;
 } | {
     type: "extension_ui_request";

package/dist/skills/improve-codebase/SKILL.md

@@ -29,7 +29,7 @@ Your goal:
 
 ### 1. Explore the context
 
-Call the subagent tool with `{ agent: "explorer", task: "..." }` (do not pass a model) when possible.
+Call the subagent tool with `{ agent: "scout", task: "..." }` (do not pass a model) when possible.
 
 If the context is partial:
 - Infer surrounding architecture cautiously

package/dist/skills/planger/SKILL.md

@@ -52,7 +52,7 @@ Choose the lowest-complexity solution that works.
 
 ## Reuse Before Build
 
-Before creating anything new (use explorer agent):
+Before creating anything new (use scout agent):
 
 - Search for existing implementations
 - Search for existing utilities

package/dist/skills/workflow/SKILL.md

@@ -22,12 +22,11 @@ Read `../pi-subagents/SKILL.md` and its references to pick builtin/custom agents
 
 | Subtask | Agent |
 | --- | --- |
-| Codebase recon / find seams | `scout` or `explorer` |
+| Codebase recon / find seams | `scout` |
 | External/uncertain research | `researcher` |
-| Implementation planning | `architect` |
-| Scoped implementation | `worker` or `builder` |
-| Independent review | `reviewer` or `commentator` |
-| Parent-synthesized fixes | `worker` |
+| Scoped implementation | `worker` or `delegate` |
+| Independent review | `reviewer` |
+| Material architecture/product tradeoffs | `oracle` or Council Mode |
 
 For material architecture/product tradeoffs, resolve them first with an `oracle` or Council Mode before implementation.
 
@@ -52,21 +51,16 @@ const scout = await runs.run("scout", {
   agent: "scout",
   task: "Find the code seams, existing helpers, and constraints involved. Do not edit."
 });
-const plan = await runs.run("plan", {
-  agent: "architect",
-  reads: [scout.outputReference],
-  task: "Plan the change from the scout findings. Return files, order, checks, non-goals."
-});
 const worker = await runs.run("implement", {
   agent: "worker",
-  reads: [plan.outputReference],
-  task: "Implement the approved plan. Return changed files, checks run, residual risks, decisions needing approval."
+  reads: [scout.outputReference],
+  task: "Implement the requested change from the scout findings. Return changed files, checks run, residual risks, decisions needing approval."
 });
 const reviews = await runs.all([
-  { key: "correctness", agent: "reviewer", reads: [plan.outputReference, worker.outputReference], task: "Inspect the current diff for correctness and regressions. Do not edit." },
-  { key: "simplicity", agent: "reviewer", reads: [plan.outputReference, worker.outputReference], task: "Inspect the current diff for unnecessary complexity. Do not edit." }
+  { key: "correctness", agent: "reviewer", reads: [scout.outputReference, worker.outputReference], task: "Inspect the current diff for correctness and regressions. Do not edit." },
+  { key: "simplicity", agent: "reviewer", reads: [scout.outputReference, worker.outputReference], task: "Inspect the current diff for unnecessary complexity. Do not edit." }
 ]);
-return { plan: plan.outputReference, worker: worker.outputReference, reviews: reviews.map((result) => result.outputReference) };
+return { worker: worker.outputReference, reviews: reviews.map((result) => result.outputReference) };
 ```
 
 ### Parallel independent subtasks

package/docs/rpc.md

@@ -64,6 +64,14 @@ With images:
 
 If the agent is streaming and no `streamingBehavior` is specified, the command returns an error.
 
+**During compaction**: If the agent is compacting, the command is rejected unless `queueWhileCompacting` is set:
+
+```json
+{"type": "prompt", "message": "Follow-up", "queueWhileCompacting": true}
+```
+
+With `queueWhileCompacting: true` the prompt is accepted into a buffer (`success: true` is returned immediately) and auto-replayed in order after `compaction_end`. If compaction aborts or errors, the buffer is discarded.
+
 **Extension commands**: If the message is an extension command (e.g., `/mycommand`), it executes immediately even during streaming. Extension commands manage their own LLM interaction via `pi.sendMessage()`.
 
 **Input expansion**: Skill commands (`/skill:name`) and prompt templates (`/template`) are expanded before sending/queueing.
@@ -240,6 +248,14 @@ Cycle to the next available model. Returns `null` data if only one model availab
 {"type": "cycle_model"}
 ```
 
+Optional `direction` (defaults to `"forward"`):
+
+```json
+{"type": "cycle_model", "direction": "backward"}
+```
+
+`direction` is `"forward"` or `"backward"`.
+
 Response:
 ```json
 {
@@ -264,6 +280,12 @@ List all configured models.
 {"type": "get_available_models"}
 ```
 
+Optional `refresh` flag (TUI parity) re-fetches model catalogs before listing; a small timeout applies and the current snapshot is used if the network refresh fails:
+
+```json
+{"type": "get_available_models", "refresh": true}
+```
+
 Response contains an array of full [Model](#model) objects:
 ```json
 {
@@ -556,6 +578,11 @@ With custom path:
 {"type": "export_html", "outputPath": "/tmp/session.html"}
 ```
 
+Optional `themeName` selects the export theme (otherwise the current theme is used):
+```json
+{"type": "export_html", "outputPath": "/tmp/session.html", "themeName": "dark"}
+```
+
 Response:
 ```json
 {
@@ -702,6 +729,134 @@ Response:
 
 The current session name is available via `get_state` in the `sessionName` field. To set the initial name when starting RPC mode, pass `--name <name>` or `-n <name>` to the `pi --mode rpc` process.
 
+#### navigate_tree
+
+Navigate the session tree to a different entry (the TUI tree selector equivalent). Rejects while the agent is streaming; emits a `session_tree` event on success.
+
+```json
+{"type": "navigate_tree", "targetId": "abc123"}
+```
+
+Optional fields:
+- `summarize`: summarize the branch between the old leaf and the target before navigating.
+- `customInstructions`: custom summary instructions (with `summarize`).
+- `replaceInstructions`: replace (rather than append to) the default summary instructions.
+- `label`: attach the given label to the target entry.
+
+Response:
+```json
+{
+  "type": "response",
+  "command": "navigate_tree",
+  "success": true,
+  "data": {
+    "editorText": "...",
+    "cancelled": false,
+    "aborted": false,
+    "summaryEntry": null
+  }
+}
+```
+
+`editorText` is present when the target is a user message (it becomes the editor prefill). `aborted` is set when a `session_before_navigate`-style extension handler cancels the navigation. Fails with `Entry <id> not found` for unknown targets and `No model available for summarization` when `summarize` is requested but no model is configured.
+
+#### list_sessions
+
+List sessions. `scope` defaults to `"current"` (sessions in the current cwd/session dir); `"all"` searches the full session store.
+
+```json
+{"type": "list_sessions"}
+{"type": "list_sessions", "scope": "all"}
+```
+
+Response:
+```json
+{
+  "type": "response",
+  "command": "list_sessions",
+  "success": true,
+  "data": {
+    "sessions": [
+      {
+        "path": "/path/to/session.jsonl",
+        "id": "abc123",
+        "cwd": "/path/to/project",
+        "name": "my-feature-work",
+        "parentSessionPath": null,
+        "created": "2026-09-01T00:00:00.000Z",
+        "modified": "2026-09-01T01:00:00.000Z",
+        "messageCount": 42,
+        "firstMessage": "First user prompt..."
+      }
+    ]
+  }
+}
+```
+
+`name` is omitted when unset. `created`/`modified` are ISO strings; sessions with invalid timestamps (e.g. hand-written JSONL) are reported as epoch (`1970-01-01T00:00:00.000Z`).
+
+#### rename_session
+
+Rename a session by writing the name into its JSONL header. The file must exist; an empty name is rejected.
+
+```json
+{"type": "rename_session", "path": "/path/to/session.jsonl", "name": "my-feature-work"}
+```
+
+Response: `{"command": "rename_session", "success": true, "data": {"path": "/path/to/session.jsonl", "name": "my-feature-work"}}`
+
+#### delete_session
+
+Delete a session. Moves it to the operating system trash when available, else unlinks the file directly. Refuses to delete the currently active session.
+
+```json
+{"type": "delete_session", "path": "/path/to/session.jsonl"}
+```
+
+Response: `{"command": "delete_session", "success": true, "data": {"path": "/path/to/session.jsonl", "method": "trash"}}`
+
+`method` is `"trash"` or `"unlink"`.
+
+#### set_session_models
+
+Scope the session to a subset of models (mirrors the TUI session-only model scoping). Ephemeral: never writes settings files and does not affect the persistent scoped-model configuration. Pass an empty array to clear the session scope.
+
+```json
+{"type": "set_session_models", "enabled": ["anthropic/claude-sonnet-4-20250514", "anthropic/*"]}
+```
+
+`enabled` entries are concrete `provider/id` identifiers or scope/wildcard patterns (e.g. `"anthropic/*"`). `reorder` (a reordered pattern list) rebuilds the scope without changing which models are enabled. At least one of the two must be present.
+
+Response:
+```json
+{
+  "type": "response",
+  "command": "set_session_models",
+  "success": true,
+  "data": {
+    "enabled": ["anthropic/claude-sonnet-4-20250514"],
+    "models": [{...}]
+  }
+}
+```
+
+`enabled` is the resolved list of `provider/id` strings; `models` is the matching array of [Model](#model) objects.
+
+#### share_gist
+
+Export the session to HTML and share it as a private GitHub gist (requires the GitHub CLI authenticated via `gh auth login`).
+
+```json
+{"type": "share_gist"}
+```
+
+Optional `themeName` selects the export theme:
+```json
+{"type": "share_gist", "themeName": "dark"}
+```
+
+Response: `{"command": "share_gist", "success": true, "data": {"url": "https://github.com/user/...", "gistUrl": "https://gist.github.com/..."}}`
+
 ### Commands
 
 #### get_commands
@@ -740,7 +895,7 @@ Each command has:
   - `"path"`: Explicit path via CLI or settings
 - `path`: Absolute file path to the command source (optional)
 
-**Note**: Built-in TUI commands (`/settings`, `/hotkeys`, etc.) are not included. They are handled only in interactive mode and would not execute if sent via `prompt`.
+**Note**: Built-in TUI commands (`/settings`, `/hotkeys`, etc.) are included with `source: "builtin"` and `interactiveOnly: true`. They are display-only: they are handled only in interactive mode and would not execute if sent via `prompt`.
 
 ## Events
 
@@ -766,6 +921,7 @@ Events are streamed to stdout as JSON lines during agent operation. Events do no
 | `compaction_end` | Compaction completes |
 | `auto_retry_start` | Auto-retry begins (after transient error) |
 | `auto_retry_end` | Auto-retry completes (success or final failure) |
+| `session_tree` | Session tree navigated (new leaf, old leaf, optional summary entry) |
 | `extension_error` | Extension threw an error |
 
 ### agent_start
@@ -957,6 +1113,20 @@ If compaction was aborted, `result` is `null` and `aborted` is `true`.
 
 If compaction failed (e.g., API quota exceeded), `result` is `null`, `aborted` is `false`, and `errorMessage` contains the error description.
 
+### session_tree
+
+Emitted after a `navigate_tree` (or an extension-initiated tree navigation) moves the session to a new leaf. `oldLeafId`/`newLeafId` are the session tree leaves before and after the navigation; `summaryEntry` is present when the navigation summarized the branch. `fromExtension` is true when the navigation was initiated by an extension.
+
+```json
+{
+  "type": "session_tree",
+  "oldLeafId": "def456",
+  "newLeafId": "abc123",
+  "summaryEntry": null,
+  "fromExtension": false
+}
+```
+
 ### auto_retry_start / auto_retry_end
 
 Emitted when automatic retry is triggered after a transient error (overloaded, rate limit, 5xx).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selesai/code",
-  "version": "0.13.8",
+  "version": "0.13.10",
   "description": "Maintained, extension-first Pi coding agent with built-in workflows, subagents, web research, questions, skills, and an enhanced terminal UI.",
   "type": "module",
   "repository": {