apex-code 0.5.2 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Apex Code changelog
 
+## [0.6.1] - 2026-10-04
+
+### Changed
+
+- Overview renders each tool and user shell operation as one row with its label, lifecycle, and available-output count or failure diagnostic. Details and all retain previews, diffs, and full output. Click an operation or press configurable Alt+O to expand it individually; Ctrl+O cycles the whole transcript and resets individual expansion. The footer shows the current detail mode.
+
+## [0.6.0] - 2026-10-04
+
+### Added
+
+- `/tree` asks whether to keep current files, restore files to the selected checkpoint, or cancel when the workspace differs. Keeping files is the default. Navigation reports the workspace outcome, and a restore saves a pre-restore checkpoint.
+- Extensions can pass `workspacePolicy` to `navigateTree`. SDK callers can inspect checkpoint drift without changing files or the conversation through `AgentSession.previewTreeWorkspace()`.
+- Completed interactive runs show a dim `Worked for` duration. Aborted runs show `Interrupted after`, including cancellation during retry backoff. Runs under one second show no duration. The line is never saved to the session or sent to the model.
+- Interactive permission modes have an in-memory session override. It governs tool calls, configured commands, and delegated children above configured mode sources. Bypass is available only when it was in force at startup. Reload, resume, and a new session clear the override; `/settings` still writes the saved user default.
+
+- Plan mode activates `plan_present` when the tool registry admits it. Its selector offers approval with automatic edit acceptance, approval with edit prompts, or continued planning. Approval changes only the session mode and refreshes the footer. Explicitly selected tools remain active; tool allowlists and exclusions still apply.
+
+- Active task lists appear in a pinned panel above the composer. Alt+J and `/tasks` toggle a globally saved expansion preference. The panel follows branch navigation and resume, retains tasks through compaction, and hides a completed list when the run settles. On macOS, Alt+J needs Option configured as Meta.
+- The task-list tool remains opt-in. A `/settings` row adds or removes `todo_write` from saved defaults for new sessions while preserving other tools. Project defaults make the row read-only. Task results show a compact completion count with expandable details.
+
+### Changed
+
+- Shift+Tab now cycles permission modes for this session. Alt+T cycles thinking levels. The footer marks session overrides and shows the bound cycle key; the first cycle explains the new bindings. To restore the old thinking key, set `"app.thinking.cycle": "shift+tab"` and `"app.permissionMode.cycle": "alt+t"` in `~/.apex-code/agent/keybindings.json`, then run `/reload`. On macOS, Alt+T needs Option configured as Meta.
+
 ## [0.5.2] - 2026-09-30
 
 ### Changed

package/README.md

@@ -170,6 +170,7 @@ Type `/` in the editor to trigger commands. [Extensions](#extensions) can regist
 | `/thinking` | Switch thinking level; Ctrl+S in the picker saves the startup default |
 | `/scoped-models` | Enable/disable models for Ctrl+P cycling |
 | `/settings` | Theme, message delivery, transport, and other preferences |
+| `/tasks` | Expand or collapse the pinned task panel |
 | `/resume` | Pick from previous sessions |
 | `/new` | Start a new session |
 | `/name <name>` | Set session display name |
@@ -203,11 +204,49 @@ See `/hotkeys` for the full list. Customize via `~/.apex-code/agent/keybindings.
 | Escape twice | Open `/tree` |
 | Ctrl+L | Open model selector |
 | Ctrl+P / Shift+Ctrl+P | Cycle scoped models forward/backward |
-| Shift+Tab | Cycle thinking level |
+| Shift+Tab | Cycle permission mode for this session |
+| Alt+T | Cycle thinking level |
 | Ctrl+O | Collapse/expand tool output |
 | Ctrl+T | Collapse/expand thinking blocks |
+| Alt+J | Expand or collapse the task panel |
 | Ctrl+X | Copy the last assistant message; with fullscreen copy-on-select disabled, copy the active text selection |
 
+The permission cycle affects only the running session. The footer marks a session
+override, and `/settings` still changes the saved default. The cycle includes bypass
+only when bypass was in force at startup. On macOS, Alt+T needs Option configured as
+Meta. See [keybinding configuration](docs/keybindings.md#custom-configuration) to
+restore Shift+Tab for thinking levels.
+
+### Plan approval
+
+Plan mode activates `plan_present` when your tool selection admits it. When the agent
+presents a plan, choose **Yes, and accept edits**, **Yes, and ask before each edit**,
+or **No, keep planning**. Approval changes the permission mode for this session
+and updates the footer. Keeping planning or dismissing the selector leaves plan
+mode unchanged. Reload clears the session override.
+
+If you use `--tools`, include `plan_present` to allow the approval flow. A tool
+listed explicitly stays active after approval. `--no-tools` and tool exclusions
+remain authoritative.
+
+### Task list
+
+When `todo_write` is active and the agent records tasks, a panel above the
+composer shows completed and total counts plus the task in progress. Press Alt+J
+or run `/tasks` to expand up to five items and an overflow count. Your expansion
+choice is saved globally. On macOS, configure Option as Meta for Alt+J.
+
+The panel follows the current branch through `/tree` and resume, and retains
+tasks through compaction. A newly completed list hides when the run settles.
+The transcript keeps a compact `Task list updated · N/M complete` result;
+expand that result to inspect the recorded list.
+
+Enable the task-list tool in `/settings` for new sessions. This preserves your
+other default tools and does not change the current session. A project
+`defaultTools` selection makes the row read-only. CLI tool selection and
+exclusions take precedence. To enable it for one invocation, include
+`todo_write` in `--tools` alongside the other tools you want.
+
 ### Message Queue
 
 Submit messages while the agent is working:
@@ -525,7 +564,7 @@ Pi is aggressively extensible so it doesn't have to dictate your workflow. Featu
 
 **No permission popups.** Run in a container, or build your own confirmation flow with [extensions](#extensions) inline with your environment and security requirements.
 
-**No plan mode.** Write plans to files, or build it with [extensions](#extensions), or install a package.
+**Plan mode.** Apex Code supports a session permission mode for planning and an interactive [plan approval flow](#plan-approval). Approval selects the edit policy for the running session.
 
 **No built-in to-dos.** They confuse models. Use a TODO.md file, or build your own with [extensions](#extensions).
 

package/dist/core/agent-session.d.ts

@@ -102,6 +102,7 @@ export type AgentSessionEvent = Exclude<AgentEvent, {
     success: boolean;
     attempt: number;
     finalError?: string;
+    aborted?: boolean;
 } | {
     type: "summarization_retry_scheduled";
     attempt: number;
@@ -137,6 +138,7 @@ export interface AggregateBudgetUsageSnapshot {
     startedAtMs: number;
 }
 export interface AgentSessionConfig {
+    implicitDefaultToolNames?: readonly string[];
     childRunRegistry?: ChildRunRegistry;
     /**
      * The session's delegation runtime options when delegation is configured.
@@ -302,6 +304,16 @@ export interface SessionStats {
 }
 /** Explicit workspace policy for `/tree` and `/fork`-family navigation (spec § 4). */
 export type TreeWorkspacePolicy = "keep" | "restore" | "fail-if-drifted" | "cancel";
+export type TreeWorkspacePreview = {
+    state: "no-checkpoint";
+} | {
+    state: "unavailable";
+    reason: string;
+} | {
+    state: "matches";
+} | {
+    state: "differs";
+};
 /** What the navigation did to the workspace, reported separately from the conversation move. */
 export interface TreeWorkspaceOutcome {
     policy: TreeWorkspacePolicy;
@@ -386,9 +398,13 @@ export declare class AgentSession {
     private _initialActiveToolNames?;
     private _allowedToolNames?;
     private _excludedToolNames?;
+    private readonly _implicitDefaultToolNames?;
     private _baseToolsOverride?;
     private _sessionStartEvent;
     private _permissionGate?;
+    private _interactivePermissionMode?;
+    private _interactivePermissionModeGeneration;
+    private readonly _startupPermissionMode?;
     private _evidenceSink?;
     private _diagnosticsOperations?;
     private _lspOperations?;
@@ -422,6 +438,13 @@ export declare class AgentSession {
     private _baseSystemPromptOptions;
     /** Prompt options after before_agent_start mutations for the active run. */
     private _runSystemPromptOptions?;
+    private _requestedToolNames;
+    private _runRequestedToolNames?;
+    private _planToolMode?;
+    private _planToolSyncGeneration;
+    private _pendingPlanToolSync?;
+    private _planToolSyncChange;
+    private _planPresentationGeneration;
     constructor(config: AgentSessionConfig);
     get modelRuntime(): ModelRuntime;
     private _getRequiredRequestAuth;
@@ -638,6 +661,7 @@ export declare class AgentSession {
     get systemPrompt(): string;
     /** Current retry attempt (0 if not retrying) */
     get retryAttempt(): number;
+    getImplicitDefaultToolNames(): string[];
     /**
      * Get the names of currently active tools.
      * Returns the names of tools currently set on the agent.
@@ -660,6 +684,12 @@ export declare class AgentSession {
      * Changes take effect on the next agent turn.
      */
     setActiveToolsByName(toolNames: string[]): void;
+    private _projectToolNames;
+    private _applyRequestedTools;
+    private _setPendingPlanToolSync;
+    private _syncPlanToolMode;
+    private _schedulePlanToolSync;
+    private _presentPlan;
     /** Whether compaction or branch summarization is currently running */
     get isCompacting(): boolean;
     /** All messages including custom types like BashExecutionMessage */
@@ -831,6 +861,11 @@ export declare class AgentSession {
      * to the next tool call with no restart.
      */
     getPermissionMode(): Promise<EffectiveModeResolution | undefined>;
+    getInteractivePermissionMode(): PermissionMode | undefined;
+    getInteractivePermissionModeCycle(): Promise<readonly PermissionMode[]>;
+    setInteractivePermissionMode(mode: PermissionMode): Promise<EffectiveModeResolution | undefined>;
+    private _setInteractivePermissionMode;
+    clearInteractivePermissionMode(): void;
     /**
      * Persist a permission mode to user scope (`~/.apex-code/agent/permissions.json`).
      * Returns the resolution that is actually in force afterwards, which is *not*
@@ -1077,6 +1112,8 @@ export declare class AgentSession {
         label?: string;
         workspacePolicy?: TreeWorkspacePolicy;
     }): Promise<TreeNavigationResult>;
+    previewTreeWorkspace(targetId: string): Promise<TreeWorkspacePreview>;
+    private _inspectTreeWorkspace;
     private _resolveTreeWorkspaceStep;
     /**
      * Get all user messages from session for fork selector.