@selesai/code 0.13.8 → 0.13.10

package/dist/extensions/pi-subagents/src/workflows/workflow-receipt.ts

@@ -127,7 +127,7 @@ function parseExternalCliReceiptMetadata(value: unknown, key: string, source: st
 	const adapterRecord = adapter as Record<string, unknown>;
 	const unknownAdapter = Object.keys(adapterRecord).filter((field) => !["id", "version", "executionMode"].includes(field));
 	if (unknownAdapter.length > 0) throw new Error(`${label}.adapter has unsupported fields: ${unknownAdapter.join(", ")}.`);
-	if ((adapterRecord.id !== "external-cli" && adapterRecord.id !== "codex-exec" && adapterRecord.id !== "codex-exec-writer" && adapterRecord.id !== "claude-code" && adapterRecord.id !== "claude-code-writer" && adapterRecord.id !== "cursor-agent" && adapterRecord.id !== "cursor-agent-writer" && adapterRecord.id !== "grok-build") || adapterRecord.version !== 1 || adapterRecord.executionMode !== (adapterRecord.id === "cursor-agent" || adapterRecord.id === "cursor-agent-writer" || adapterRecord.id === "grok-build" ? "one-shot-prompt-file" : "one-shot-stdin")) throw new Error(`${label}.adapter is invalid.`);
+	if ((adapterRecord.id !== "external-cli" && adapterRecord.id !== "grok-build") || adapterRecord.version !== 1 || adapterRecord.executionMode !== (adapterRecord.id === "grok-build" ? "one-shot-prompt-file" : "one-shot-stdin")) throw new Error(`${label}.adapter is invalid.`);
 	const capabilities = metadata.capabilities;
 	if (!capabilities || typeof capabilities !== "object" || Array.isArray(capabilities)) throw new Error(`${label}.capabilities must be an object.`);
 	const capabilityRecord = capabilities as Record<string, unknown>;
@@ -137,43 +137,7 @@ function parseExternalCliReceiptMetadata(value: unknown, key: string, source: st
 		if (capabilityRecord[capability] !== expected) throw new Error(`${label}.capabilities.${capability} is invalid.`);
 	}
 	const safety = metadata.safety;
-	if (adapterRecord.id === "codex-exec") {
-		if (!safety || typeof safety !== "object" || Array.isArray(safety)) throw new Error(`${label}.safety is missing.`);
-		const safetyRecord = safety as Record<string, unknown>;
-		const unknownSafety = Object.keys(safetyRecord).filter((field) => !["sandbox", "approvalPolicy", "ephemeral"].includes(field));
-		if (unknownSafety.length > 0) throw new Error(`${label}.safety has unsupported fields: ${unknownSafety.join(", ")}.`);
-		if (safetyRecord.sandbox !== "read-only" || safetyRecord.approvalPolicy !== "never" || safetyRecord.ephemeral !== true) throw new Error(`${label}.safety is invalid.`);
-	} else if (adapterRecord.id === "codex-exec-writer") {
-		if (!safety || typeof safety !== "object" || Array.isArray(safety)) throw new Error(`${label}.safety is missing.`);
-		const safetyRecord = safety as Record<string, unknown>;
-		const unknownSafety = Object.keys(safetyRecord).filter((field) => !["access", "sandbox", "approvalPolicy", "ephemeral"].includes(field));
-		if (unknownSafety.length > 0) throw new Error(`${label}.safety has unsupported fields: ${unknownSafety.join(", ")}.`);
-		if (safetyRecord.access !== "workspace-write" || safetyRecord.sandbox !== "workspace-write" || safetyRecord.approvalPolicy !== "never" || safetyRecord.ephemeral !== true) throw new Error(`${label}.safety is invalid.`);
-	} else if (adapterRecord.id === "claude-code") {
-		if (!safety || typeof safety !== "object" || Array.isArray(safety)) throw new Error(`${label}.safety is missing.`);
-		const safetyRecord = safety as Record<string, unknown>;
-		const legacy = safetyRecord.authentication === undefined;
-		const unknownSafety = Object.keys(safetyRecord).filter((field) => !(legacy
-			? ["permissionMode", "tools", "mcp", "settingSources", "sessionPersistence"]
-			: ["access", "authentication", "permissionMode", "tools", "mcp", "settingSources", "userSettingsTrust", "sessionPersistence"]).includes(field));
-		if (unknownSafety.length > 0) throw new Error(`${label}.safety has unsupported fields: ${unknownSafety.join(", ")}.`);
-		if (legacy) {
-			if (safetyRecord.permissionMode !== "plan" || safetyRecord.tools !== "none" || safetyRecord.mcp !== "empty-strict" || safetyRecord.settingSources !== "none" || safetyRecord.sessionPersistence !== false) throw new Error(`${label}.safety is invalid.`);
-		} else if (safetyRecord.access !== "read-only" || safetyRecord.authentication !== "existing-cli-required" || safetyRecord.permissionMode !== "plan" || safetyRecord.tools !== "none" || safetyRecord.mcp !== "empty-strict" || safetyRecord.settingSources !== "user" || safetyRecord.userSettingsTrust !== "required" || safetyRecord.sessionPersistence !== false) throw new Error(`${label}.safety is invalid.`);
-	} else if (adapterRecord.id === "claude-code-writer") {
-		if (!safety || typeof safety !== "object" || Array.isArray(safety)) throw new Error(`${label}.safety is missing.`);
-		const safetyRecord = safety as Record<string, unknown>;
-		const unknownSafety = Object.keys(safetyRecord).filter((field) => !["access", "authentication", "permissionMode", "tools", "mcp", "settingSources", "userSettingsTrust", "sessionPersistence"].includes(field));
-		if (unknownSafety.length > 0) throw new Error(`${label}.safety has unsupported fields: ${unknownSafety.join(", ")}.`);
-		if (safetyRecord.access !== "workspace-write" || safetyRecord.authentication !== "existing-cli-required" || safetyRecord.permissionMode !== "acceptEdits" || safetyRecord.tools !== "Read,Write,Edit,Glob,Grep" || safetyRecord.mcp !== "empty-strict" || safetyRecord.settingSources !== "user" || safetyRecord.userSettingsTrust !== "required" || safetyRecord.sessionPersistence !== false) throw new Error(`${label}.safety is invalid.`);
-	} else if (adapterRecord.id === "cursor-agent" || adapterRecord.id === "cursor-agent-writer") {
-		if (!safety || typeof safety !== "object" || Array.isArray(safety)) throw new Error(`${label}.safety is missing.`);
-		const safetyRecord = safety as Record<string, unknown>;
-		const unknownSafety = Object.keys(safetyRecord).filter((field) => !["access", "authentication", "mode", "sandbox", "workspaceTrust", "sessionReuse"].includes(field));
-		if (unknownSafety.length > 0) throw new Error(`${label}.safety has unsupported fields: ${unknownSafety.join(", ")}.`);
-		const writer = adapterRecord.id === "cursor-agent-writer";
-		if (safetyRecord.access !== (writer ? "workspace-write" : "read-only") || safetyRecord.authentication !== "cursor-api-key-or-existing-login" || safetyRecord.mode !== (writer ? "print" : "ask") || safetyRecord.sandbox !== "enabled" || safetyRecord.workspaceTrust !== "existing-required" || safetyRecord.sessionReuse !== false) throw new Error(`${label}.safety is invalid.`);
-	} else if (adapterRecord.id === "grok-build") {
+	if (adapterRecord.id === "grok-build") {
 		if (!safety || typeof safety !== "object" || Array.isArray(safety)) throw new Error(`${label}.safety is missing.`);
 		const safetyRecord = safety as Record<string, unknown>;
 		const unknownSafety = Object.keys(safetyRecord).filter((field) => !["access", "authentication", "permissionMode", "tools", "deniedTools", "sandbox", "webSearch", "subagents", "config", "updates", "sessionPersistence"].includes(field));

package/dist/extensions/pi-subagents/test/unit/agent-management.test.ts

@@ -108,55 +108,6 @@ describe("agent management config parsing", () => {
 		assert.equal(JSON.stringify(capabilities).includes("SYSTEM_PROMPT_SENTINEL"), false);
 	});
 
-	it("rejects management attempts to widen the reserved read-only Claude profile", () => {
-		const ctx = { cwd: tempDir, modelRegistry: { getAvailable: () => [] } };
-		const writerRunner = { type: "external-cli", adapter: "claude-code-writer", command: "claude" };
-		const unsafeCreate = handleCreate({ config: { name: "claude-code", description: "Unsafe shadow", scope: "project", runner: writerRunner } }, ctx);
-		assert.equal(unsafeCreate.isError, true);
-		assert.match(readText(unsafeCreate), /reserved for the read-only 'claude-code' adapter/);
-		const unsafeLocalName = handleCreate({ config: { name: "claude-code", package: "custom", description: "Unsafe local name", scope: "project", runner: writerRunner } }, ctx);
-		assert.equal(unsafeLocalName.isError, true);
-		assert.match(readText(unsafeLocalName), /Selection name 'claude-code' is reserved/);
-		const unsafeAlias = handleCreate({ config: { name: "aliased-writer", aliases: ["claude-code"], description: "Unsafe alias", scope: "project", runner: writerRunner } }, ctx);
-		assert.equal(unsafeAlias.isError, true);
-		assert.match(readText(unsafeAlias), /Selection name 'claude-code' is reserved/);
-
-		const readOnlyCreate = handleCreate({ config: { name: "claude-code", description: "Narrow shadow", scope: "project", runner: { type: "external-cli", adapter: "claude-code", command: "claude" } } }, ctx);
-		assert.equal(readOnlyCreate.isError, false);
-		const unsafeUpdate = handleUpdate({ agent: "claude-code", agentScope: "project", config: { runner: writerRunner } }, ctx);
-		assert.equal(unsafeUpdate.isError, true);
-		assert.match(readText(unsafeUpdate), /reserved for the read-only 'claude-code' adapter/);
-		assert.match(fs.readFileSync(path.join(tempDir, ".selesai", "agents", "claude-code.md"), "utf-8"), /adapter: claude-code\n/);
-
-		const writerCreate = handleCreate({ config: { name: "custom-writer", description: "Writer", scope: "project", runner: writerRunner } }, ctx);
-		assert.equal(writerCreate.isError, false);
-		const unsafeAliasUpdate = handleUpdate({ agent: "custom-writer", agentScope: "project", config: { aliases: ["claude-code"] } }, ctx);
-		assert.equal(unsafeAliasUpdate.isError, true);
-		assert.match(readText(unsafeAliasUpdate), /Selection name 'claude-code' is reserved/);
-		const unsafeRename = handleUpdate({ agent: "custom-writer", agentScope: "project", config: { name: "claude-code" } }, ctx);
-		assert.equal(unsafeRename.isError, true);
-		assert.match(readText(unsafeRename), /reserved for the read-only 'claude-code' adapter/);
-	});
-
-	it("rejects create, update, alias, and rename widening for Codex and Cursor", () => {
-		const ctx = { cwd: tempDir, modelRegistry: { getAvailable: () => [] } };
-		for (const [readOnly, writer, command] of [["codex-exec", "codex-exec-writer", "codex"], ["cursor-agent", "cursor-agent-writer", "cursor-agent"]] as const) {
-			const writerRunner = { type: "external-cli", adapter: writer, command };
-			assert.equal(handleCreate({ config: { name: readOnly, description: "Unsafe shadow", scope: "project", runner: writerRunner } }, ctx).isError, true);
-			assert.equal(handleCreate({ config: { name: readOnly, package: `custom-${readOnly}`, description: "Unsafe local name", scope: "project", runner: writerRunner } }, ctx).isError, true);
-			assert.equal(handleCreate({ config: { name: `${readOnly}-alias`, aliases: [readOnly], description: "Unsafe alias", scope: "project", runner: writerRunner } }, ctx).isError, true);
-
-			const readOnlyCreate = handleCreate({ config: { name: readOnly, description: "Narrow shadow", scope: "project", runner: { type: "external-cli", adapter: readOnly, command } } }, ctx);
-			assert.equal(readOnlyCreate.isError, false);
-			assert.equal(handleUpdate({ agent: readOnly, agentScope: "project", config: { runner: writerRunner } }, ctx).isError, true);
-
-			const customName = `custom-${writer}`;
-			assert.equal(handleCreate({ config: { name: customName, description: "Writer", scope: "project", runner: writerRunner } }, ctx).isError, false);
-			assert.equal(handleUpdate({ agent: customName, agentScope: "project", config: { aliases: [readOnly] } }, ctx).isError, true);
-			assert.equal(handleUpdate({ agent: customName, agentScope: "project", config: { name: readOnly } }, ctx).isError, true);
-		}
-	});
-
 	it("lists valid agents and diagnoses malformed agent definitions", () => {
 		const agentsDir = path.join(tempDir, ".selesai", "agents");
 		fs.mkdirSync(agentsDir, { recursive: true });

package/dist/extensions/pi-subagents/test/unit/runtime-agent-registration.test.ts

@@ -255,24 +255,6 @@ describe("runtime agent registration", () => {
 	});
 
 	it("fails closed for builtin and duplicate runtime identities", () => {
-		assert.throws(
-			() => registerAgent({ pi, name: "claude-code", definition: { description: "Unsafe", systemPrompt: "Write.", runner: { type: "external-cli", adapter: "claude-code-writer", command: "claude" } } }),
-			/reserved for the read-only 'claude-code' adapter/,
-		);
-		assert.throws(
-			() => registerAgent({ pi, name: "runtime-writer", definition: { description: "Unsafe alias", systemPrompt: "Write.", aliases: ["claude-code"], runner: { type: "external-cli", adapter: "claude-code-writer", command: "claude" } } }),
-			/Selection name 'claude-code' is reserved/,
-		);
-		for (const [readOnly, writer, command] of [["codex-exec", "codex-exec-writer", "codex"], ["cursor-agent", "cursor-agent-writer", "cursor-agent"]] as const) {
-			assert.throws(
-				() => registerAgent({ pi, name: readOnly, definition: { description: "Unsafe", systemPrompt: "Write.", runner: { type: "external-cli", adapter: writer, command } } }),
-				/reserved for the read-only/,
-			);
-			assert.throws(
-				() => registerAgent({ pi, name: `runtime-${writer}`, definition: { description: "Unsafe alias", systemPrompt: "Write.", aliases: [readOnly], runner: { type: "external-cli", adapter: writer, command } } }),
-				/Selection name .* is reserved/,
-			);
-		}
 		assert.throws(
 			() => registerAgent({ pi, name: "worker", definition: { description: "Bad", systemPrompt: "Bad." } }),
 			/Worker|builtin agent 'worker'|collides with builtin agent 'worker'/i,

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

@@ -4,12 +4,15 @@
  * Spawns the agent in RPC mode and provides a typed API for all operations.
  */
 import type { AgentMessage, ThinkingLevel } from "@earendil-works/pi-agent-core";
-import type { ImageContent } from "@earendil-works/pi-ai";
+import type { ImageContent, Model } from "@earendil-works/pi-ai";
 import type { AgentSessionEvent, SessionStats } from "../../core/agent-session.ts";
+import type { KeybindingsConfig } from "../../core/keybindings.ts";
+import type { Settings } 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 { RpcSessionState, RpcSlashCommand } from "./rpc-types.ts";
+import type { ChangelogEntry } from "../../utils/changelog.ts";
+import type { RpcSessionInfo, RpcSessionState, RpcSlashCommand } from "./rpc-types.ts";
 export interface RpcClientOptions {
     /** Path to the CLI entry point (default: searches for dist/cli.js) */
     cliPath?: string;
@@ -61,8 +64,9 @@ export declare class RpcClient {
      * Send a prompt to the agent.
      * Returns immediately after sending; use onEvent() to receive streaming events.
      * Use waitForIdle() to wait for completion.
+     * @param queueWhileCompacting - Buffer the prompt during compaction and send after compaction_end.
      */
-    prompt(message: string, images?: ImageContent[]): Promise<void>;
+    prompt(message: string, images?: ImageContent[], queueWhileCompacting?: boolean): Promise<void>;
     /**
      * Queue a steering message to interrupt the agent mid-run.
      */
@@ -102,9 +106,9 @@ export declare class RpcClient {
         id: string;
     }>;
     /**
-     * Cycle to next model.
+     * Cycle to next (or previous) model.
      */
-    cycleModel(): Promise<{
+    cycleModel(direction?: "forward" | "backward"): Promise<{
         model: {
             provider: string;
             id: string;
@@ -114,8 +118,9 @@ export declare class RpcClient {
     } | null>;
     /**
      * Get list of available models.
+     * @param refresh - When true, refresh model catalogs before listing (TUI parity).
      */
-    getAvailableModels(): Promise<ModelInfo[]>;
+    getAvailableModels(refresh?: boolean): Promise<ModelInfo[]>;
     /**
      * Set thinking level.
      */
@@ -177,7 +182,7 @@ export declare class RpcClient {
     /**
      * Export session to HTML.
      */
-    exportHtml(outputPath?: string): Promise<{
+    exportHtml(outputPath?: string, themeName?: string): Promise<{
         path: string;
     }>;
     /**
@@ -217,9 +222,9 @@ export declare class RpcClient {
         leafId: string | null;
     }>;
     /**
-     * Get the session entry tree.
+     * Get the session entry tree, optionally filtered.
      */
-    getTree(): Promise<{
+    getTree(filter?: "default" | "no-tools" | "user-only" | "labeled-only" | "all"): Promise<{
         tree: SessionTreeNode[];
         leafId: string | null;
     }>;
@@ -231,14 +236,179 @@ export declare class RpcClient {
      * Set the session display name.
      */
     setSessionName(name: string): Promise<void>;
+    /**
+     * Navigate the session tree to a target entry, optionally summarizing the
+     * branch being left. Mirrors the TUI tree-selector flow.
+     */
+    navigateTree(options: {
+        targetId: string;
+        summarize?: boolean;
+        customInstructions?: string;
+        replaceInstructions?: boolean;
+        label?: string;
+    }): Promise<{
+        editorText?: string;
+        cancelled: boolean;
+        aborted?: boolean;
+        summaryEntry?: unknown | null;
+    }>;
+    /**
+     * List sessions. scope "current" = sessions in the active cwd; "all" = across all projects.
+     */
+    listSessions(scope?: "current" | "all"): Promise<RpcSessionInfo[]>;
+    /**
+     * Rename a session (by path). Does not switch the active runtime.
+     */
+    renameSession(path: string, name: string): Promise<void>;
+    /**
+     * Delete a session file (trash first, unlink fallback). Active session is rejected.
+     * @returns The method used: "trash" or "unlink".
+     */
+    deleteSession(path: string): Promise<{
+        method: "trash" | "unlink";
+    }>;
+    /**
+     * Set session-only (ephemeral) scoped models — resolved to concrete model ids,
+     * not persisted to settings. Clears scope with an empty array.
+     */
+    setSessionModels(options: {
+        enabled?: string[];
+        reorder?: string[];
+    }): Promise<{
+        enabled: string[];
+        models: ModelInfo[];
+    }>;
     /**
      * Get all messages in the session.
      */
     getMessages(): Promise<AgentMessage[]>;
     /**
-     * Get available commands (extension commands, prompt templates).
+     * Get available commands (extension commands, prompt templates, builtins).
      */
     getCommands(): Promise<RpcSlashCommand[]>;
+    /**
+     * Get settings for a scope ("global" | "project" | "effective", default "effective").
+     */
+    getSettings(scope?: "global" | "project" | "effective"): Promise<{
+        scope: string;
+        settings: Settings;
+    }>;
+    /**
+     * Bulk-update settings and persist.
+     */
+    setSettings(values: Partial<Settings>, scope?: "global" | "project"): Promise<void>;
+    /**
+     * Reset settings to bundled factory defaults (backup preserved).
+     */
+    factoryResetSettings(): Promise<void>;
+    /**
+     * List providers and the login methods they support.
+     */
+    getAuthProviders(): Promise<Array<{
+        providerId: string;
+        name: string;
+        authTypes: Array<"oauth" | "api_key">;
+    }>>;
+    /**
+     * Login to a provider. API-key flows emit `extension_ui_request: input` with
+     * `inputKind: "secret"`; OAuth flows open a browser and emit notify events.
+     */
+    login(providerId: string, authType: "oauth" | "api_key"): Promise<{
+        providerId: string;
+        authType: "oauth" | "api_key";
+        message: string;
+    }>;
+    /**
+     * Log out of a provider, removing stored credentials.
+     */
+    logout(providerId: string): Promise<void>;
+    /**
+     * Get providers with configured auth (stored credential or environment).
+     */
+    getAuthState(): Promise<Array<{
+        providerId: string;
+        authType: "oauth" | "api_key";
+        source: string;
+    }>>;
+    /**
+     * Get enabled model patterns (Ctrl+P cycling scope) and available models.
+     */
+    getScopedModels(): Promise<{
+        enabled: string[];
+        models: Model<any>[];
+    }>;
+    /**
+     * Set enabled model patterns and/or reorder them (Ctrl+P cycling order).
+     */
+    setScopedModels(options?: {
+        enabled?: string[];
+        reorder?: string[];
+    }): Promise<string[]>;
+    /**
+     * Import and resume a session from a JSONL file (replaces current session).
+     */
+    importJsonl(path: string): Promise<string>;
+    /**
+     * Run the git helper (worktrees/checkpoints/commits/push). Same behavior as
+     * the `prompt` command: success is reported on preflight, then the normal
+     * agent/message event stream follows.
+     */
+    git(command: string): Promise<void>;
+    /**
+     * Reload keybindings, extensions, skills, prompts, themes, and context files.
+     */
+    reload(): Promise<void>;
+    /**
+     * Set or clear a label on a session entry (undefined/empty clears).
+     */
+    setEntryLabel(entryId: string, label?: string): Promise<string>;
+    /**
+     * Get the current project trust decision and status.
+     */
+    getTrust(): Promise<{
+        cwd: string;
+        savedDecision: {
+            path: string;
+            decision: boolean;
+        } | null;
+        projectTrusted: boolean;
+        trustRequired: boolean;
+    }>;
+    /**
+     * Save a project trust decision. Decision takes full effect after restart.
+     */
+    setTrust(decision: boolean | null): Promise<{
+        decision: boolean | null;
+        restartRequired: boolean;
+    }>;
+    /**
+     * Get the effective keybinding map.
+     */
+    getHotkeys(): Promise<KeybindingsConfig>;
+    /**
+     * Get available themes (built-in + custom) and the current theme setting.
+     */
+    getAvailableThemes(): Promise<{
+        themes: Array<{
+            name: string;
+            path?: string;
+        }>;
+        current: string | undefined;
+    }>;
+    /**
+     * Get the current version and parsed changelog entries.
+     */
+    getVersionInfo(): Promise<{
+        version: string;
+        changelog: ChangelogEntry[];
+    }>;
+    /**
+     * Share the current session as a secret GitHub gist (requires `gh` CLI).
+     */
+    shareGist(themeName?: string): Promise<{
+        url: string;
+        gistUrl: string;
+    }>;
     /**
      * Wait for agent to become idle (no streaming).
      * Resolves when agent_settled event is received.

package/dist/modes/rpc/rpc-client.js

@@ -131,9 +131,10 @@ export class RpcClient {
      * Send a prompt to the agent.
      * Returns immediately after sending; use onEvent() to receive streaming events.
      * Use waitForIdle() to wait for completion.
+     * @param queueWhileCompacting - Buffer the prompt during compaction and send after compaction_end.
      */
-    async prompt(message, images) {
-        await this.send({ type: "prompt", message, images });
+    async prompt(message, images, queueWhileCompacting) {
+        await this.send({ type: "prompt", message, images, queueWhileCompacting });
     }
     /**
      * Queue a steering message to interrupt the agent mid-run.
@@ -184,17 +185,18 @@ export class RpcClient {
         return this.getData(response);
     }
     /**
-     * Cycle to next model.
+     * Cycle to next (or previous) model.
      */
-    async cycleModel() {
-        const response = await this.send({ type: "cycle_model" });
+    async cycleModel(direction) {
+        const response = await this.send({ type: "cycle_model", direction });
         return this.getData(response);
     }
     /**
      * Get list of available models.
+     * @param refresh - When true, refresh model catalogs before listing (TUI parity).
      */
-    async getAvailableModels() {
-        const response = await this.send({ type: "get_available_models" });
+    async getAvailableModels(refresh) {
+        const response = await this.send({ type: "get_available_models", refresh });
         return this.getData(response).models;
     }
     /**
@@ -289,8 +291,8 @@ export class RpcClient {
     /**
      * Export session to HTML.
      */
-    async exportHtml(outputPath) {
-        const response = await this.send({ type: "export_html", outputPath });
+    async exportHtml(outputPath, themeName) {
+        const response = await this.send({ type: "export_html", outputPath, themeName });
         return this.getData(response);
     }
     /**
@@ -332,10 +334,10 @@ export class RpcClient {
         return this.getData(response);
     }
     /**
-     * Get the session entry tree.
+     * Get the session entry tree, optionally filtered.
      */
-    async getTree() {
-        const response = await this.send({ type: "get_tree" });
+    async getTree(filter) {
+        const response = await this.send({ type: "get_tree", ...(filter ? { filter } : {}) });
         return this.getData(response);
     }
     /**
@@ -351,6 +353,50 @@ export class RpcClient {
     async setSessionName(name) {
         await this.send({ type: "set_session_name", name });
     }
+    // =========================================================================
+    // Tree navigation (rev 3)
+    // =========================================================================
+    /**
+     * Navigate the session tree to a target entry, optionally summarizing the
+     * branch being left. Mirrors the TUI tree-selector flow.
+     */
+    async navigateTree(options) {
+        const response = await this.send({ type: "navigate_tree", ...options });
+        return this.getData(response);
+    }
+    // =========================================================================
+    // Session discovery / management (rev 3)
+    // =========================================================================
+    /**
+     * List sessions. scope "current" = sessions in the active cwd; "all" = across all projects.
+     */
+    async listSessions(scope) {
+        const response = await this.send({ type: "list_sessions", scope });
+        return this.getData(response).sessions;
+    }
+    /**
+     * Rename a session (by path). Does not switch the active runtime.
+     */
+    async renameSession(path, name) {
+        const response = await this.send({ type: "rename_session", path, name });
+        this.getData(response);
+    }
+    /**
+     * Delete a session file (trash first, unlink fallback). Active session is rejected.
+     * @returns The method used: "trash" or "unlink".
+     */
+    async deleteSession(path) {
+        const response = await this.send({ type: "delete_session", path });
+        return this.getData(response);
+    }
+    /**
+     * Set session-only (ephemeral) scoped models — resolved to concrete model ids,
+     * not persisted to settings. Clears scope with an empty array.
+     */
+    async setSessionModels(options) {
+        const response = await this.send({ type: "set_session_models", ...options });
+        return this.getData(response);
+    }
     /**
      * Get all messages in the session.
      */
@@ -359,13 +405,165 @@ export class RpcClient {
         return this.getData(response).messages;
     }
     /**
-     * Get available commands (extension commands, prompt templates).
+     * Get available commands (extension commands, prompt templates, builtins).
      */
     async getCommands() {
         const response = await this.send({ type: "get_commands" });
         return this.getData(response).commands;
     }
     // =========================================================================
+    // Settings
+    // =========================================================================
+    /**
+     * Get settings for a scope ("global" | "project" | "effective", default "effective").
+     */
+    async getSettings(scope) {
+        const response = await this.send({ type: "get_settings", ...(scope ? { scope } : {}) });
+        return this.getData(response);
+    }
+    /**
+     * Bulk-update settings and persist.
+     */
+    async setSettings(values, scope = "global") {
+        await this.send({ type: "set_settings", scope, values });
+    }
+    /**
+     * Reset settings to bundled factory defaults (backup preserved).
+     */
+    async factoryResetSettings() {
+        await this.send({ type: "factory_reset_settings" });
+    }
+    // =========================================================================
+    // Auth
+    // =========================================================================
+    /**
+     * List providers and the login methods they support.
+     */
+    async getAuthProviders() {
+        const response = await this.send({ type: "get_auth_providers" });
+        return this.getData(response).providers;
+    }
+    /**
+     * Login to a provider. API-key flows emit `extension_ui_request: input` with
+     * `inputKind: "secret"`; OAuth flows open a browser and emit notify events.
+     */
+    async login(providerId, authType) {
+        const response = await this.send({ type: "login", providerId, authType });
+        return this.getData(response);
+    }
+    /**
+     * Log out of a provider, removing stored credentials.
+     */
+    async logout(providerId) {
+        await this.send({ type: "logout", providerId });
+    }
+    /**
+     * Get providers with configured auth (stored credential or environment).
+     */
+    async getAuthState() {
+        const response = await this.send({ type: "get_auth_state" });
+        return this.getData(response).providers;
+    }
+    // =========================================================================
+    // Scoped models
+    // =========================================================================
+    /**
+     * Get enabled model patterns (Ctrl+P cycling scope) and available models.
+     */
+    async getScopedModels() {
+        const response = await this.send({ type: "get_scoped_models" });
+        return this.getData(response);
+    }
+    /**
+     * Set enabled model patterns and/or reorder them (Ctrl+P cycling order).
+     */
+    async setScopedModels(options = {}) {
+        const response = await this.send({ type: "set_scoped_models", ...options });
+        return this.getData(response).enabled;
+    }
+    // =========================================================================
+    // Session import
+    // =========================================================================
+    /**
+     * Import and resume a session from a JSONL file (replaces current session).
+     */
+    async importJsonl(path) {
+        const response = await this.send({ type: "import_jsonl", path });
+        return this.getData(response).sessionPath;
+    }
+    // =========================================================================
+    // Git helper / reload / tree ops
+    // =========================================================================
+    /**
+     * Run the git helper (worktrees/checkpoints/commits/push). Same behavior as
+     * the `prompt` command: success is reported on preflight, then the normal
+     * agent/message event stream follows.
+     */
+    async git(command) {
+        await this.send({ type: "git", command });
+    }
+    /**
+     * Reload keybindings, extensions, skills, prompts, themes, and context files.
+     */
+    async reload() {
+        await this.send({ type: "reload" });
+    }
+    /**
+     * Set or clear a label on a session entry (undefined/empty clears).
+     */
+    async setEntryLabel(entryId, label) {
+        const response = await this.send({ type: "set_entry_label", entryId, label });
+        return this.getData(response).labelId;
+    }
+    // =========================================================================
+    // Trust
+    // =========================================================================
+    /**
+     * Get the current project trust decision and status.
+     */
+    async getTrust() {
+        const response = await this.send({ type: "get_trust" });
+        return this.getData(response);
+    }
+    /**
+     * Save a project trust decision. Decision takes full effect after restart.
+     */
+    async setTrust(decision) {
+        const response = await this.send({ type: "set_trust", decision });
+        return this.getData(response);
+    }
+    // =========================================================================
+    // Hotkeys / version / share
+    // =========================================================================
+    /**
+     * Get the effective keybinding map.
+     */
+    async getHotkeys() {
+        const response = await this.send({ type: "get_hotkeys" });
+        return this.getData(response).hotkeys;
+    }
+    /**
+     * Get available themes (built-in + custom) and the current theme setting.
+     */
+    async getAvailableThemes() {
+        const response = await this.send({ type: "get_available_themes" });
+        return this.getData(response);
+    }
+    /**
+     * Get the current version and parsed changelog entries.
+     */
+    async getVersionInfo() {
+        const response = await this.send({ type: "get_version_info" });
+        return this.getData(response);
+    }
+    /**
+     * Share the current session as a secret GitHub gist (requires `gh` CLI).
+     */
+    async shareGist(themeName) {
+        const response = await this.send({ type: "share_gist", public: false, themeName });
+        return this.getData(response);
+    }
+    // =========================================================================
     // Helpers
     // =========================================================================
     /**