@bastani/atomic 0.8.4 → 0.8.5-0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [0.8.5-0] - 2026-05-18
+
+### Changed
+
+- Prepared the 0.8.5-0 prerelease.
+
 ## [0.8.4] - 2026-05-17
 
 ### Added

package/README.md

@@ -101,7 +101,7 @@ Then just talk to pi. By default, pi gives the model four tools: `read`, `write`
 
 ## Providers & Models
 
-For each built-in provider, pi maintains a list of tool-capable models, updated with every release. Authenticate via subscription (`/login`) or API key, then select any model from that provider via `/model` (or Ctrl+L).
+For each built-in provider, pi maintains a list of tool-capable models, updated with every release. Authenticate via subscription (`/login`) or API key, then select any model from that provider via `/model` (or CTRL+L).
 
 **Subscriptions:**
 - Anthropic Claude Pro/Max
@@ -162,8 +162,8 @@ The editor can be temporarily replaced by other UI, like built-in `/settings` or
 |---------|-----|
 | File reference | Type `@` to fuzzy-search project files |
 | Path completion | Tab to complete paths |
-| Multi-line | Shift+Enter (or Ctrl+Enter on Windows Terminal) |
-| Images | Ctrl+V to paste (Alt+V on Windows), or drag onto terminal |
+| Multi-line | SHIFT+Enter (or CTRL+Enter on Windows Terminal) |
+| Images | CTRL+V to paste (ALT+V on Windows), or drag onto terminal |
 | Bash commands | `!command` runs and sends output to LLM, `!!command` runs without sending |
 
 Standard editing keybindings for delete word, undo, etc. See [docs/keybindings.md](docs/keybindings.md).
@@ -176,7 +176,7 @@ Type `/` in the editor to trigger commands. [Extensions](#extensions) can regist
 |---------|-------------|
 | `/login`, `/logout` | OAuth authentication |
 | `/model` | Switch models |
-| `/scoped-models` | Enable/disable models for Ctrl+P cycling |
+| `/scoped-models` | Enable/disable models for CTRL+P cycling |
 | `/settings` | Thinking level, theme, message delivery, transport |
 | `/resume` | Pick from previous sessions |
 | `/new` | Start a new session |
@@ -202,26 +202,26 @@ See `/hotkeys` for the full list. Customize via `~/.pi/agent/keybindings.json`.
 
 | Key | Action |
 |-----|--------|
-| Ctrl+C | Clear editor |
-| Ctrl+C twice | Quit |
+| CTRL+C | Clear editor |
+| CTRL+C twice | Quit |
 | Escape | Cancel/abort |
 | Escape twice | Open `/tree` |
-| Ctrl+L | Open model selector |
-| Ctrl+P / Shift+Ctrl+P | Cycle scoped models forward/backward |
-| Shift+Tab | Cycle thinking level |
-| Ctrl+O | Collapse/expand tool output |
-| Ctrl+T | Collapse/expand thinking blocks |
+| CTRL+L | Open model selector |
+| CTRL+P / SHIFT+CTRL+P | Cycle scoped models forward/backward |
+| SHIFT+Tab | Cycle thinking level |
+| CTRL+O | Collapse/expand tool output |
+| CTRL+T | Collapse/expand thinking blocks |
 
 ### Message Queue
 
 Submit messages while the agent is working:
 
 - **Enter** queues a *steering* message, delivered after the current assistant turn finishes executing its tool calls
-- **Alt+Enter** queues a *follow-up* message, delivered only after the agent finishes all work
+- **ALT+Enter** queues a *follow-up* message, delivered only after the agent finishes all work
 - **Escape** aborts and restores queued messages to editor
-- **Alt+Up** retrieves queued messages back to editor
+- **ALT+Up** retrieves queued messages back to editor
 
-On Windows Terminal, `Alt+Enter` is fullscreen by default. Remap it in [docs/terminal-setup.md](docs/terminal-setup.md) so pi can receive the follow-up shortcut.
+On Windows Terminal, `ALT+Enter` is fullscreen by default. Remap it in [docs/terminal-setup.md](docs/terminal-setup.md) so pi can receive the follow-up shortcut.
 
 Configure delivery in [settings](docs/settings.md): `steeringMode` and `followUpMode` can be `"one-at-a-time"` (default, waits for response) or `"all"` (delivers all queued at once). `transport` selects provider transport preference (`"sse"`, `"websocket"`, or `"auto"`) for providers that support multiple transports.
 
@@ -251,9 +251,9 @@ Use `/session` in interactive mode to see the current session ID before reusing
 
 <p align="center"><img src="docs/images/tree-view.png" alt="Tree View" width="600"></p>
 
-- Search by typing, fold/unfold and jump between branches with Ctrl+←/Ctrl+→ or Alt+←/Alt+→, page with ←/→
-- Filter modes (Ctrl+O): default → no-tools → user-only → labeled-only → all
-- Press Shift+L to label entries as bookmarks and Shift+T to toggle label timestamps
+- Search by typing, fold/unfold and jump between branches with CTRL+←/CTRL+→ or ALT+←/ALT+→, page with ←/→
+- Filter modes (CTRL+O): default → no-tools → user-only → labeled-only → all
+- Press SHIFT+L to label entries as bookmarks and SHIFT+T to toggle label timestamps
 
 **`/fork`** - Create a new session file from a previous user message on the active branch. Opens a selector, copies the active path up to that point, and places the selected prompt in the editor for modification.
 
@@ -410,22 +410,23 @@ pi config                               # enable/disable extensions, skills, pro
 
 Packages install to `~/.pi/agent/git/` (git) or global npm. Use `-l` for project-local installs (`.pi/git/`, `.pi/npm/`). Git packages install dependencies with `npm install --omit=dev` by default, so runtime deps must be listed under `dependencies`; when `npmCommand` is configured, git packages use plain `install` for compatibility with wrappers. If you use a Node version manager and want package installs to reuse a stable npm context, set `npmCommand` in `settings.json`, for example `["mise", "exec", "node@20", "--", "npm"]`.
 
-Create a package by adding a `pi` key to `package.json`:
+Create a package by adding an app-name manifest key to `package.json` (`atomic` for this package). The legacy `pi` key is still accepted as a backwards-compatible shim:
 
 ```json
 {
   "name": "my-pi-package",
   "keywords": ["pi-package"],
-  "pi": {
+  "atomic": {
     "extensions": ["./extensions"],
     "skills": ["./skills"],
     "prompts": ["./prompts"],
-    "themes": ["./themes"]
+    "themes": ["./themes"],
+    "workflows": ["./workflows"]
   }
 }
 ```
 
-Without a `pi` manifest, pi auto-discovers from conventional directories (`extensions/`, `skills/`, `prompts/`, `themes/`).
+Without a manifest, Atomic auto-discovers from conventional directories (`extensions/`, `skills/`, `prompts/`, `themes/`, `workflows/`). Workflow packages may also use a singular `workflow/` directory.
 
 See [docs/packages.md](docs/packages.md).
 
@@ -532,7 +533,7 @@ cat README.md | pi -p "Summarize this text"
 | `--model <pattern>` | Model pattern or ID (supports `provider/id` and optional `:<thinking>`) |
 | `--api-key <key>` | API key (overrides env vars) |
 | `--thinking <level>` | `off`, `minimal`, `low`, `medium`, `high`, `xhigh` |
-| `--models <patterns>` | Comma-separated patterns for Ctrl+P cycling |
+| `--models <patterns>` | Comma-separated patterns for CTRL+P cycling |
 | `--list-models [search]` | List available models |
 
 ### Session Options
@@ -634,7 +635,7 @@ pi --thinking high "Solve this complex problem"
 | `PI_SKIP_VERSION_CHECK` | Skip the Pi version update check at startup. This prevents the `pi.dev` latest-version request |
 | `PI_TELEMETRY` | Override install/update telemetry. Use `1`/`true`/`yes` to enable or `0`/`false`/`no` to disable. This does not disable update checks |
 | `PI_CACHE_RETENTION` | Set to `long` for extended prompt cache (Anthropic: 1h, OpenAI: 24h) |
-| `VISUAL`, `EDITOR` | External editor for Ctrl+G |
+| `VISUAL`, `EDITOR` | External editor for CTRL+G |
 
 ---
 

package/dist/builtin/intercom/README.md

@@ -7,7 +7,7 @@
 Direct 1:1 messaging between pi sessions on the same machine. Send context, findings, or requests from one session to another — whether you're driving the conversation or letting agents coordinate.
 
 ```text
-User flow: press Alt+M or run /intercom to pick a session and send a message
+User flow: ALT+M or run /intercom to pick a session and send a message
 ```
 
 ## Why
@@ -24,7 +24,7 @@ Pi-intercom also integrates well with [pi-subagents](https://github.com/nicobail
 
 ## In One Minute
 
-Each pi session that has `pi-intercom` loaded and enabled connects to a tiny local broker over a local IPC transport. The broker keeps track of connected sessions and routes direct messages to the one you target by name or session ID. The extension gives you both a tool (`intercom`) and a small overlay UI (`/intercom` or `Alt+M`). Incoming messages are rendered inline inside the recipient session, can trigger a turn immediately, and are also stored in Pi session history as extension entries.
+Each pi session that has `pi-intercom` loaded and enabled connects to a tiny local broker over a local IPC transport. The broker keeps track of connected sessions and routes direct messages to the one you target by name or session ID. The extension gives you both a tool (`intercom`) and a small overlay UI (`/intercom` or `ALT+M`). Incoming messages are rendered inline inside the recipient session, can trigger a turn immediately, and are also stored in Pi session history as extension entries.
 
 ## Install
 
@@ -62,11 +62,11 @@ If a session is unnamed, pi-intercom now exposes a runtime-only fallback alias l
 
 ### From the Keyboard
 
-Press **Alt+M** or type `/intercom` to open the session list overlay:
+**ALT+M** Open or type `/intercom` to open the session list overlay:
 
 1. **Select a session** — Use arrow keys to pick a target session
 2. **Compose message** — Write your message in the compose overlay
-3. **Send** — Press Enter to send, Escape to cancel
+3. **Send** — Enter Send · Escape Cancel
 
 ### From the Agent
 
@@ -352,7 +352,7 @@ Only registered in sessions where `pi-subagents` supplied the required child bri
 
 | Key | Action |
 |-----|--------|
-| Alt+M | Open session list overlay |
+| ALT+M | Open session list overlay |
 | ↑/↓ | Navigate session list |
 | Enter | Select session / Send message |
 | Escape | Cancel / Close overlay |

package/dist/builtin/intercom/index.ts

@@ -1056,7 +1056,7 @@ export default function piIntercomExtension(pi: ExtensionAPI) {
             id: Type.String(),
             type: Type.String({ description: "Question type: single, multi, text, image, or info" }),
             question: Type.String(),
-            options: Type.Optional(Type.Array(Type.Any())),
+            options: Type.Optional(Type.Array(Type.Unknown())),
             context: Type.Optional(Type.String()),
           })),
         }, { description: "Structured interview request for reason='interview_request'" })),

package/dist/builtin/intercom/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/intercom",
-  "version": "0.8.4",
+  "version": "0.8.5-0",
   "private": true,
   "description": "Atomic extension providing a private coordination channel between parent and child agent sessions.",
   "contributors": [

package/dist/builtin/intercom/ui/compose.ts

@@ -4,6 +4,24 @@ import type { KeybindingsManager, Theme } from "@bastani/atomic";
 import type { IntercomClient } from "../broker/client.js";
 import type { SessionInfo } from "../types.js";
 
+function formatKeyLabel(key: string): string {
+  return key
+    .split("+")
+    .map((part) => {
+      const lower = part.toLowerCase();
+      if (["ctrl", "cmd", "alt", "shift"].includes(lower)) return lower.toUpperCase();
+      if (lower === "esc" || lower === "escape") return "Escape";
+      if (lower === "enter") return "Enter";
+      if (/^[a-z]$/.test(lower)) return lower.toUpperCase();
+      return part;
+    })
+    .join("+");
+}
+
+function formatKeys(keys: readonly string[]): string {
+  return keys.map(formatKeyLabel).join("/");
+}
+
 export interface ComposeResult {
   sent: boolean;
   messageId?: string;
@@ -105,7 +123,7 @@ export class ComposeOverlay implements Component {
   render(width: number): string[] {
     const innerWidth = Math.max(24, Math.min(width - 2, 72));
     const contentWidth = Math.max(1, innerWidth - 2);
-    const footer = `${this.keybindings.getKeys("tui.select.confirm").join("/")}: Send • ${this.keybindings.getKeys("tui.select.cancel").join("/")}: Close`;
+    const footer = `${formatKeys(this.keybindings.getKeys("tui.select.confirm"))}: Send • ${formatKeys(this.keybindings.getKeys("tui.select.cancel"))}: Close`;
     const border = (text: string) => this.theme.fg("accent", text);
     const row = (text = "") => {
       const clipped = truncateToWidth(text, contentWidth, "", true);

package/dist/builtin/intercom/ui/session-list.ts

@@ -3,6 +3,24 @@ import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
 import type { KeybindingsManager, Theme } from "@bastani/atomic";
 import type { SessionInfo } from "../types.js";
 
+function formatKeyLabel(key: string): string {
+  return key
+    .split("+")
+    .map((part) => {
+      const lower = part.toLowerCase();
+      if (["ctrl", "cmd", "alt", "shift"].includes(lower)) return lower.toUpperCase();
+      if (lower === "esc" || lower === "escape") return "Escape";
+      if (lower === "enter") return "Enter";
+      if (/^[a-z]$/.test(lower)) return lower.toUpperCase();
+      return part;
+    })
+    .join("+");
+}
+
+function formatKeys(keys: readonly string[]): string {
+  return keys.map(formatKeyLabel).join("/");
+}
+
 function middleTruncate(text: string, maxWidth: number): string {
   if (visibleWidth(text) <= maxWidth) {
     return text;
@@ -103,7 +121,7 @@ export class SessionListOverlay implements Component {
   render(width: number): string[] {
     const innerWidth = Math.max(36, Math.min(width - 2, 88));
     const contentWidth = Math.max(1, innerWidth - 2);
-    const footer = `${this.keybindings.getKeys("tui.select.confirm").join("/")}: Message • ${this.keybindings.getKeys("tui.select.cancel").join("/")}: Close`;
+    const footer = `${formatKeys(this.keybindings.getKeys("tui.select.confirm"))}: Message • ${formatKeys(this.keybindings.getKeys("tui.select.cancel"))}: Close`;
     const border = (text: string) => this.theme.fg("accent", text);
     const row = (text = "") => {
       const clipped = truncateToWidth(text, contentWidth, "", true);

package/dist/builtin/mcp/README.md

@@ -279,7 +279,7 @@ Returns accumulated messages from UI sessions. Each message includes `type`, `se
 
 **Browser controls:**
 
-- **Cmd/Ctrl+Enter** — Complete and close
+- **CMD/CTRL+Enter** — Complete and close
 - **Escape** — Cancel and close
 - **Done/Cancel buttons** — Same as keyboard shortcuts
 
@@ -332,7 +332,7 @@ Prefer `.mcp.json` for project-local shared MCP config. Use `.pi/mcp.json` only
 | Connect | `mcp({ connect: "server-name" })` |
 | UI messages | `mcp({ action: "ui-messages" })` |
 
-MCP proxy and direct-tool results render compactly by default: long text shows the first three lines plus a `Ctrl+O to expand` hint, while the full result remains available when expanded and is still returned unchanged to the model.
+MCP proxy and direct-tool results render compactly by default: long text shows the first three lines plus a `CTRL+O Expand` hint, while the full result remains available when expanded and is still returned unchanged to the model.
 
 Search includes both MCP tools and Pi tools (from extensions). Pi tools appear first with `[pi tool]` prefix. Space-separated words are OR'd.
 
@@ -353,7 +353,7 @@ Tool names are fuzzy-matched on hyphens and underscores — `context7_resolve_li
 
 If `settings.autoAuth` is `true`, `mcp({ connect: ... })`, `mcp({ tool: ... })`, and direct tool calls automatically run OAuth when needed and retry once.
 
-In interactive sessions, you can also authenticate from `/mcp` with `ctrl+a` or Enter on a server that needs auth. In non-interactive sessions, browser-based OAuth still requires `/mcp-auth <server>`. `/mcp-auth` without a server only opens a picker in the interactive UI.
+In interactive sessions, you can also authenticate from `/mcp` with `CTRL+A` or Enter on a server that needs auth. In non-interactive sessions, browser-based OAuth still requires `/mcp-auth <server>`. `/mcp-auth` without a server only opens a picker in the interactive UI.
 
 ## How It Works
 

package/dist/builtin/mcp/commands.ts

@@ -409,7 +409,7 @@ export async function openMcpAuthPanel(
           resolve();
         }, {
           authOnly: true,
-          noticeLines: ["Select an OAuth MCP server and press Enter or ctrl+a to authenticate."],
+          noticeLines: ["Select OAuth MCP Server. Enter/CTRL+A Authenticate."],
         });
       },
       { overlay: true, overlayOptions: { anchor: "center", width: 82 } },

package/dist/builtin/mcp/host-html-template.ts

@@ -96,7 +96,7 @@ export function buildHostHtmlTemplate(input: HostHtmlTemplateInput): string {
     </div>
     <div class="controls">
       <span class="status" id="status">Loading UI...</span>
-      <button class="primary" id="done-btn" title="Cmd/Ctrl+Enter">Done</button>
+      <button class="primary" id="done-btn" title="CMD/CTRL+Enter">Done</button>
       <button class="danger" id="cancel-btn" title="Escape">Cancel</button>
     </div>
   </header>

package/dist/builtin/mcp/mcp-panel.ts

@@ -699,22 +699,22 @@ class McpPanel {
     lines.push(emptyRow());
     const hints = this.authOnly
       ? [
-          italic("↑↓") + " navigate",
-          italic("⏎") + " auth",
-          italic("ctrl+a") + " auth",
-          italic("esc") + " clear/close",
-          italic("ctrl+c") + " quit",
+          italic("↑↓") + " Navigate",
+          italic("⏎") + " Auth",
+          italic("CTRL+A") + " Auth",
+          italic("Escape") + " Clear/Close",
+          italic("CTRL+C") + " Quit",
         ]
       : [
-          italic("↑↓") + " navigate",
-          italic("space") + " toggle",
-          italic("⏎") + " expand/auth",
-          italic("ctrl+a") + " auth",
-          italic("ctrl+r") + " reconnect",
-          italic("?") + " desc search",
-          italic("ctrl+s") + " save",
-          italic("esc") + " clear/close",
-          italic("ctrl+c") + " quit",
+          italic("↑↓") + " Navigate",
+          italic("Space") + " Toggle",
+          italic("⏎") + " Expand/Auth",
+          italic("CTRL+A") + " Auth",
+          italic("CTRL+R") + " Reconnect",
+          italic("?") + " Desc Search",
+          italic("CTRL+S") + " Save",
+          italic("Escape") + " Clear/Close",
+          italic("CTRL+C") + " Quit",
         ];
     const gap = "  ";
     const gapW = 2;

package/dist/builtin/mcp/mcp-setup-panel.ts

@@ -299,7 +299,7 @@ export class McpSetupPanel {
       return;
     }
 
-    this.notice = { text: "Review the details below. Press Enter on an action with a side effect to apply it.", tone: "muted" };
+    this.notice = { text: "Review Details Below. Enter Apply Action With Side Effect.", tone: "muted" };
     this.tui.requestRender();
   }
 
@@ -387,13 +387,13 @@ export class McpSetupPanel {
       lines.push(this.padLine(line, innerW));
     }
     lines.push(this.padLine("", innerW));
-    lines.push(this.padLine(fg(this.t.muted, "Enter selects, Esc goes back, Ctrl+C closes."), innerW));
+    lines.push(this.padLine(fg(this.t.muted, "Enter Select · Escape Back · CTRL+C Close"), innerW));
     return lines;
   }
 
   private renderImports(innerW: number): string[] {
     const lines: string[] = [];
-    lines.push(this.padLine("Select compatibility imports. Space toggles, Enter saves, Esc goes back.", innerW));
+    lines.push(this.padLine("Select Compatibility Imports. Space Toggle · Enter Save · Escape Back.", innerW));
     lines.push(this.padLine("", innerW));
     for (let index = 0; index < this.discovery.imports.length; index++) {
       const entry = this.discovery.imports[index];
@@ -412,7 +412,7 @@ export class McpSetupPanel {
 
   private renderPaths(innerW: number): string[] {
     const lines: string[] = [];
-    lines.push(this.padLine("Select a detected config path to open. Enter opens it, Esc goes back.", innerW));
+    lines.push(this.padLine("Select Detected Config Path. Enter Open · Escape Back.", innerW));
     lines.push(this.padLine("", innerW));
     const paths = this.getDetectedPaths();
     for (let index = 0; index < paths.length; index++) {

package/dist/builtin/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/mcp",
-  "version": "0.8.4",
+  "version": "0.8.5-0",
   "private": true,
   "description": "Atomic extension that adapts MCP (Model Context Protocol) servers into the coding agent.",
   "contributors": [

package/dist/builtin/mcp/tool-result-renderer.ts

@@ -58,7 +58,7 @@ export function renderMcpToolResult(
     .map((line) => line === "…" ? theme.fg("muted", line) : theme.fg("toolOutput", line))
     .join("\n");
   const hint = display.truncated && !options.expanded
-    ? `\n${theme.fg("muted", "(Ctrl+O to expand)")}`
+    ? `\n${theme.fg("muted", "(CTRL+O Expand)")}`
     : "";
 
   return new Text(`${output}${hint}`, 0, 0);

package/dist/builtin/subagents/README.md

@@ -337,7 +337,7 @@ Chains open a clarify UI by default so you can preview and edit the workflow bef
 Common clarify keys:
 
 - `Enter` runs in the foreground, or in the background if background is toggled on
-- `Esc` cancels or backs out
+- `Escape` Cancel/Back
 - `↑↓` moves between steps or tasks
 - `e` edits the task/template
 - `m` selects a model
@@ -347,7 +347,7 @@ Common clarify keys:
 - `w` edits output/write behavior where supported
 - `r` edits reads where supported
 - `p` toggles progress tracking where supported
-Picker screens use `↑↓`, `Enter`, `Esc`, and type-to-filter. The full-screen editor supports word wrapping, paste, `Esc` to save, and `Ctrl+C` to discard.
+Picker screens use `↑↓`, `Enter`, `Escape`, and type-to-filter. The full-screen editor supports word wrapping, paste, `Escape` Save, and `CTRL+C` Discard.
 
 ## Agents and chains
 
@@ -902,7 +902,7 @@ Async runs write:
 
 Foreground runs show compact live progress for single, chain, and parallel modes: current tool, recent output, token counts, duration, activity freshness, and current-tool duration.
 
-Press `Ctrl+O` to expand the full streaming view with complete output per step.
+Press `CTRL+O` to expand the full streaming view with complete output per step.
 
 Sequential chains show a flow line like `done scout → running planner`. Chains with parallel steps show per-step cards instead.
 

package/dist/builtin/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/subagents",
-  "version": "0.8.4",
+  "version": "0.8.5-0",
   "private": true,
   "description": "Atomic extension for delegating tasks to subagents with chains, parallel execution, and TUI clarification.",
   "contributors": [