@bastani/atomic 0.8.30 → 0.8.31-alpha.2

package/examples/extensions/preset.ts

@@ -42,7 +42,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import type { Api, Model } from "@earendil-works/pi-ai";
 import type { ExtensionAPI, ExtensionContext } from "@bastani/atomic";
-import { DynamicBorder, getAgentDir } from "@bastani/atomic";
+import { CONFIG_DIR_NAME, DynamicBorder, getAgentDir } from "@bastani/atomic";
 import { Container, Key, type SelectItem, SelectList, Text } from "@earendil-works/pi-tui";
 
 // Preset configuration
@@ -69,7 +69,7 @@ interface PresetsConfig {
  */
 function loadPresets(cwd: string, includeProjectPresets: boolean): PresetsConfig {
 	const globalPath = join(getAgentDir(), "presets.json");
-	const projectPath = join(cwd, ".atomic", "presets.json");
+	const projectPath = join(cwd, CONFIG_DIR_NAME, "presets.json");
 	const legacyProjectPath = join(cwd, ".pi", "presets.json");
 
 	let globalPresets: PresetsConfig = {};
@@ -202,7 +202,10 @@ export default function presetExtension(pi: ExtensionAPI) {
 		const presetNames = Object.keys(presets);
 
 		if (presetNames.length === 0) {
-			ctx.ui.notify("No presets defined. Add presets to ~/.atomic/agent/presets.json or .atomic/presets.json (legacy .pi/presets.json also works)", "warning");
+			ctx.ui.notify(
+				`No presets defined. Add presets to ${join(getAgentDir(), "presets.json")} or ${join(ctx.cwd, CONFIG_DIR_NAME, "presets.json")} (legacy ${join(ctx.cwd, ".pi", "presets.json")} also works)`,
+				"warning",
+			);
 			return;
 		}
 
@@ -310,7 +313,10 @@ export default function presetExtension(pi: ExtensionAPI) {
 	async function cyclePreset(ctx: ExtensionContext): Promise<void> {
 		const presetNames = getPresetOrder();
 		if (presetNames.length === 0) {
-			ctx.ui.notify("No presets defined. Add presets to ~/.atomic/agent/presets.json or .atomic/presets.json (legacy .pi/presets.json also works)", "warning");
+			ctx.ui.notify(
+				`No presets defined. Add presets to ${join(getAgentDir(), "presets.json")} or ${join(ctx.cwd, CONFIG_DIR_NAME, "presets.json")} (legacy ${join(ctx.cwd, ".pi", "presets.json")} also works)`,
+				"warning",
+			);
 			return;
 		}
 

package/examples/extensions/provider-payload.ts

@@ -1,18 +1,18 @@
 import { appendFileSync } from "node:fs";
 import { join } from "node:path";
-import type { ExtensionAPI } from "@bastani/atomic";
+import { CONFIG_DIR_NAME, type ExtensionAPI } from "@bastani/atomic";
 
 export default function (pi: ExtensionAPI) {
-	const logFile = join(process.cwd(), ".pi", "provider-payload.log");
-
-	pi.on("before_provider_request", (event) => {
+	pi.on("before_provider_request", (event, ctx) => {
+		const logFile = join(ctx.cwd, CONFIG_DIR_NAME, "provider-payload.log");
 		appendFileSync(logFile, `${JSON.stringify(event.payload, null, 2)}\n\n`, "utf8");
 
 		// Optional: replace the payload instead of only logging it.
 		// return { ...event.payload, temperature: 0 };
 	});
 
-	pi.on("after_provider_response", (event) => {
+	pi.on("after_provider_response", (event, ctx) => {
+		const logFile = join(ctx.cwd, CONFIG_DIR_NAME, "provider-payload.log");
 		appendFileSync(logFile, `[${event.status}] ${JSON.stringify(event.headers)}\n\n`, "utf8");
 	});
 }

package/examples/extensions/sandbox/index.ts

@@ -46,7 +46,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { SandboxManager, type SandboxRuntimeConfig } from "@anthropic-ai/sandbox-runtime";
 import type { ExtensionAPI } from "@bastani/atomic";
-import { type BashOperations, createBashTool, getAgentDir } from "@bastani/atomic";
+import { type BashOperations, CONFIG_DIR_NAME, createBashTool, getAgentDir } from "@bastani/atomic";
 
 interface SandboxConfig extends SandboxRuntimeConfig {
 	enabled?: boolean;
@@ -77,7 +77,7 @@ const DEFAULT_CONFIG: SandboxConfig = {
 };
 
 function loadConfig(cwd: string, includeProjectConfig: boolean): SandboxConfig {
-	const projectConfigPath = join(cwd, ".atomic", "sandbox.json");
+	const projectConfigPath = join(cwd, CONFIG_DIR_NAME, "sandbox.json");
 	const legacyProjectConfigPath = join(cwd, ".pi", "sandbox.json");
 	const globalConfigPath = join(getAgentDir(), "extensions", "sandbox.json");
 

package/examples/extensions/sandbox/package-lock.json

@@ -1,14 +1,14 @@
 {
   "name": "atomic-extension-sandbox",
-  "version": "1.9.4",
+  "version": "1.9.7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "atomic-extension-sandbox",
-      "version": "1.9.4",
+      "version": "1.9.7",
       "dependencies": {
-        "@anthropic-ai/sandbox-runtime": "^0.0.26"
+        "@anthropic-ai/sandbox-runtime": "0.0.26"
       }
     },
     "node_modules/@anthropic-ai/sandbox-runtime": {

package/examples/extensions/sandbox/package.json

@@ -1,7 +1,7 @@
 {
   "name": "atomic-extension-sandbox",
   "private": true,
-  "version": "1.9.4",
+  "version": "1.9.7",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",
@@ -9,7 +9,7 @@
     "check": "echo 'nothing to check'"
   },
   "dependencies": {
-    "@anthropic-ai/sandbox-runtime": "^0.0.26"
+    "@anthropic-ai/sandbox-runtime": "0.0.26"
   },
   "atomic": {
     "extensions": [

package/examples/extensions/subagent/agents.ts

@@ -4,7 +4,7 @@
 
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { getAgentDir, parseFrontmatter } from "@bastani/atomic";
+import { CONFIG_DIR_NAME, getAgentDir, parseFrontmatter } from "@bastani/atomic";
 
 export type AgentScope = "user" | "project" | "both";
 
@@ -85,7 +85,7 @@ function isDirectory(p: string): boolean {
 function findNearestProjectAgentsDir(cwd: string): string | null {
 	let currentDir = cwd;
 	while (true) {
-		const atomicCandidate = path.join(currentDir, ".atomic", "agents");
+		const atomicCandidate = path.join(currentDir, CONFIG_DIR_NAME, "agents");
 		if (isDirectory(atomicCandidate)) return atomicCandidate;
 		const legacyCandidate = path.join(currentDir, ".pi", "agents");
 		if (isDirectory(legacyCandidate)) return legacyCandidate;

package/examples/extensions/subagent/index.ts

@@ -21,7 +21,9 @@ import type { Message } from "@earendil-works/pi-ai";
 import { StringEnum } from "@earendil-works/pi-ai";
 import {
   APP_NAME,
+  CONFIG_DIR_NAME,
   type ExtensionAPI,
+  getAgentDir,
   getMarkdownTheme,
   withFileMutationQueue,
 } from "@bastani/atomic";
@@ -518,8 +520,8 @@ export default function (pi: ExtensionAPI) {
     description: [
       "Delegate tasks to specialized subagents with isolated context.",
       "Modes: single (agent + task), parallel (tasks array), chain (sequential with {previous} placeholder).",
-      'Default agent scope is "user" (from ~/.atomic/agent/agents).',
-      'To enable project-local agents in .atomic/agents (legacy .pi/agents also works), set agentScope: "both" (or "project").',
+      `Default agent scope is "user" (from ${path.join(getAgentDir(), "agents")}).`,
+      `To enable project-local agents in ${CONFIG_DIR_NAME}/agents (legacy .pi/agents also works), set agentScope: "both" (or "project").`,
     ].join(" "),
     parameters: SubagentParams,
 

package/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "atomic-extension-with-deps",
-  "version": "0.79.4",
+  "version": "0.79.7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "atomic-extension-with-deps",
-      "version": "0.79.4",
+      "version": "0.79.7",
       "dependencies": {
         "ms": "^2.1.3"
       },

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
   "name": "atomic-extension-with-deps",
   "private": true,
-  "version": "0.79.4",
+  "version": "0.79.7",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic",
-  "version": "0.8.30",
+  "version": "0.8.31-alpha.2",
   "description": "Atomic coding agent CLI with read, bash, edit, write tools and session management",
   "type": "module",
   "atomicConfig": {
@@ -68,11 +68,11 @@
     "prepublishOnly": "bun run clean && bun run build"
   },
   "dependencies": {
-    "@bastani/atomic-natives": "0.8.30",
+    "@bastani/atomic-natives": "0.8.31-alpha.2",
     "@bufbuild/protobuf": "^2.0.0",
-    "@earendil-works/pi-agent-core": "^0.79.4",
-    "@earendil-works/pi-ai": "^0.79.4",
-    "@earendil-works/pi-tui": "^0.79.4",
+    "@earendil-works/pi-agent-core": "^0.79.7",
+    "@earendil-works/pi-ai": "^0.79.7",
+    "@earendil-works/pi-tui": "^0.79.7",
     "@modelcontextprotocol/ext-apps": "^1.7.2",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "@mozilla/readability": "^0.6.0",

package/dist/builtin/subagents/skills/browser/EXAMPLES.md

@@ -1,151 +0,0 @@
-# Browser Automation Examples
-
-Common browser automation workflows using the `browse` CLI. Each example demonstrates a distinct pattern using real commands.
-
-For localhost and other local dev flows, start with `browse open <url> --local` for a clean isolated browser. Use `browse open <url> --auto-connect` only when the agent should attach to an existing debuggable Chrome session for cookies or login state.
-
-## Example 1: Extract Data from a Page
-
-**User request**: "Get the product details from example.com/product/123"
-
-```bash
-browse open https://example.com/product/123
-browse snapshot                          # read page structure + element refs
-browse get text "body"                   # extract all visible text content
-browse stop
-```
-
-Parse the text output to extract structured data (name, price, description, etc.).
-
-For a specific section, use a CSS selector:
-
-```bash
-browse get text ".product-details"       # text from a specific container
-```
-
-**Note**: `browse get text` requires a CSS selector — use `"body"` for all page text.
-
-## Example 2: Fill and Submit a Form
-
-**User request**: "Fill out the contact form on example.com with my information"
-
-```bash
-browse open https://example.com/contact
-browse snapshot                          # find form fields and their refs
-browse click @0-3                        # click the Name input (ref from snapshot)
-browse type "John Doe"
-browse press Tab                         # move to next field
-browse type "john@example.com"
-browse fill "#message" "I would like to inquire about your services"
-browse snapshot                          # verify fields are filled
-browse click @0-8                        # click Submit button (ref from snapshot)
-browse snapshot                          # confirm submission result
-browse stop
-```
-
-**Key pattern**: Use `browse snapshot` before interacting to discover element refs, then `browse click <ref>` and `browse type` to interact.
-
-## Example 3: Multi-Step Navigation
-
-**User request**: "Get headlines from the first 3 pages of results on example.com/news"
-
-```bash
-browse open https://example.com/news
-browse snapshot                          # read page 1 content
-browse get text ".headline"              # extract headlines
-
-browse snapshot                          # find "Next" button ref
-browse click @0-12                       # click Next (ref from snapshot)
-browse wait load                         # wait for page 2 to load
-browse get text ".headline"              # extract page 2 headlines
-
-browse snapshot                          # find Next again (ref may change)
-browse click @0-15                       # click Next
-browse wait load
-browse get text ".headline"              # extract page 3 headlines
-
-browse stop
-```
-
-**Key pattern**: Re-run `browse snapshot` after each navigation because element refs change when the page updates.
-
-## Example 4: Escalate to Remote Mode
-
-**User request**: "Scrape pricing from competitor.com" (a site with Cloudflare protection)
-
-```bash
-# Attempt 1: local mode
-browse open https://competitor.com/pricing --local
-browse snapshot
-# Output shows: "Checking your browser..." (Cloudflare interstitial)
-# or: page content is empty / access denied
-browse stop
-```
-
-The agent detects bot protection and tells the user:
-
-> This site has Cloudflare bot detection. Browserbase remote mode can use Browserbase Identity with a Verified browser and residential proxies. Want me to set it up?
-
-If the user agrees:
-
-```bash
-# Set Browserbase credentials
-export BROWSERBASE_API_KEY="bb_live_..."
-
-# Retry in remote mode
-browse open https://competitor.com/pricing --remote
-browse snapshot                          # full page content now accessible
-browse get text ".pricing-table"
-browse stop
-```
-
-## Example 5: Persist Login with Context ID
-
-**User request**: "Log into my dashboard and save the session so I don't have to log in again next time"
-
-This uses Browserbase contexts to persist cookies and storage across sessions. Requires remote mode.
-
-```bash
-# Session 1: Log in and persist state
-SESSION_JSON="$(browse cloud sessions create --context-id ctx_abc123 --persist --keep-alive)"
-SESSION_ID="$(echo "$SESSION_JSON" | jq -r .id)"
-CONNECT_URL="$(echo "$SESSION_JSON" | jq -r .connectUrl)"
-
-browse open https://app.example.com/login --cdp "$CONNECT_URL"
-browse snapshot                          # find login form fields
-browse click @0-3                        # click email input
-browse type "user@example.com"
-browse press Tab
-browse type "my-password"
-browse click @0-7                        # click Sign In button
-browse wait load
-browse snapshot                          # confirm logged-in dashboard
-browse stop
-browse cloud sessions update "$SESSION_ID" --status REQUEST_RELEASE  # state is saved back to ctx_abc123
-```
-
-In a later session, reuse the same context — already authenticated:
-
-```bash
-# Session 2: Resume with saved state (already logged in)
-SESSION_JSON="$(browse cloud sessions create --context-id ctx_abc123 --keep-alive)"
-SESSION_ID="$(echo "$SESSION_JSON" | jq -r .id)"
-CONNECT_URL="$(echo "$SESSION_JSON" | jq -r .connectUrl)"
-
-browse open https://app.example.com/dashboard --cdp "$CONNECT_URL"
-browse snapshot                          # dashboard loads — no login needed
-browse get text ".welcome-message"
-browse stop
-browse cloud sessions update "$SESSION_ID" --status REQUEST_RELEASE
-```
-
-**Key pattern**: Use `browse cloud sessions create --context-id <id> --persist` for the first Browserbase session to save auth state, then attach with `browse open ... --cdp "$CONNECT_URL"`. On subsequent sessions, create with the same `--context-id` and omit `--persist` if you don't want changes saved back.
-
-## Tips
-
-- **Snapshot first**: Always run `browse snapshot` before interacting — it gives you the accessibility tree with element refs
-- **Use refs to click**: `browse click @0-5` is more reliable than trying to describe elements
-- **Re-snapshot after actions**: Element refs change when the page updates
-- **`get text` for data extraction**: Use `browse get text [selector]` to pull text content from specific elements
-- **`stop` when done**: Always `browse stop` to clean up the browser session
-- **Prefer snapshot over screenshot**: Snapshot is fast and structured; screenshot is slow and uses vision tokens. Only screenshot when you need visual context (layout, images, debugging)

package/dist/builtin/subagents/skills/browser/LICENSE.txt

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Browserbase, Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.