@eminent337/aery 0.67.68 → 0.74.2

package/examples/sdk/README.md

@@ -12,7 +12,7 @@ The runtime example shows how to build a recreate function that closes over proc
 | `02-custom-model.ts` | Select model and thinking level |
 | `03-custom-prompt.ts` | Replace or modify system prompt |
 | `04-skills.ts` | Discover, filter, or replace skills |
-| `05-tools.ts` | Built-in tools, custom tools |
+| `05-tools.ts` | Built-in tool allowlists |
 | `06-extensions.ts` | Logging, blocking, result modification |
 | `07-context-files.ts` | AGENTS.md context files |
 | `08-slash-commands.ts` | File-based slash commands |
@@ -32,7 +32,7 @@ npx tsx examples/sdk/01-minimal.ts
 ## Quick Reference
 
 ```typescript
-import { getModel } from "@mariozechner/pi-ai";
+import { getModel } from "@eminent337/aery-ai";
 import {
   AuthStorage,
   createAgentSession,
@@ -40,10 +40,7 @@ import {
   ModelRegistry,
   SessionManager,
   SettingsManager,
-  codingTools,
-  readOnlyTools,
-  readTool, bashTool, editTool, writeTool,
-} from "@mariozechner/pi-coding-agent";
+} from "@eminent337/aery";
 
 // Auth and models setup
 const authStorage = AuthStorage.create();
@@ -64,7 +61,7 @@ await loader.reload();
 const { session } = await createAgentSession({ resourceLoader: loader, authStorage, modelRegistry });
 
 // Read-only
-const { session } = await createAgentSession({ tools: readOnlyTools, authStorage, modelRegistry });
+const { session } = await createAgentSession({ tools: ["read", "grep", "find", "ls"], authStorage, modelRegistry });
 
 // In-memory
 const { session } = await createAgentSession({
@@ -92,8 +89,8 @@ const { session } = await createAgentSession({
   authStorage: customAuth,
   modelRegistry: customRegistry,
   resourceLoader,
-  tools: [readTool, bashTool],
-  customTools: [{ tool: myTool }],
+  tools: ["read", "bash", "my_tool"],
+  customTools: [myTool],
   sessionManager: SessionManager.inMemory(),
   settingsManager: SettingsManager.inMemory(),
 });
@@ -114,10 +111,10 @@ await session.prompt("Hello");
 | `authStorage` | `AuthStorage.create()` | Credential storage |
 | `modelRegistry` | `ModelRegistry.create(authStorage)` | Model registry |
 | `cwd` | `process.cwd()` | Working directory |
-| `agentDir` | `~/.pi/agent` | Config directory |
+| `agentDir` | `~/.aery/agent` | Config directory |
 | `model` | From settings/first available | Model to use |
 | `thinkingLevel` | From settings/"off" | off, low, medium, high |
-| `tools` | `codingTools` | Built-in tools |
+| `tools` | `["read", "bash", "edit", "write"]` built-ins | Allowlist tool names across built-in, extension, and custom tools |
 | `customTools` | `[]` | Additional tool definitions |
 | `resourceLoader` | DefaultResourceLoader | Resource loader for extensions, skills, prompts, themes |
 | `sessionManager` | `SessionManager.create(cwd)` | Persistence |

package/package.json

@@ -1,102 +1,95 @@
 {
-	"name": "@eminent337/aery",
-	"version": "0.67.68",
-	"description": "Aery \u2014 AI coding agent by Aryee",
-	"type": "module",
-	"piConfig": {
-		"name": "aery",
-		"configDir": ".aery"
-	},
-	"bin": {
-		"aery": "dist/cli.js"
-	},
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js"
-		},
-		"./hooks": {
-			"types": "./dist/core/hooks/index.d.ts",
-			"import": "./dist/core/hooks/index.js"
-		}
-	},
-	"files": [
-		"dist",
-		"docs",
-		"examples",
-		"CHANGELOG.md"
-	],
-	"scripts": {
-		"clean": "shx rm -rf dist",
-		"dev": "tsgo -p tsconfig.build.json --watch --preserveWatchOutput",
-		"build": "npx tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js && npm run copy-assets",
-		"build:binary": "npm --prefix ../tui run build && npm --prefix ../ai run build && npm --prefix ../agent run build && npm run build && bun build --compile ./dist/bun/cli.js --outfile dist/pi && npm run copy-binary-assets",
-		"copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/",
-		"copy-binary-assets": "shx cp package.json dist/ && shx cp README.md dist/ && shx cp CHANGELOG.md dist/ && shx mkdir -p dist/theme && shx cp src/modes/interactive/theme/*.json dist/theme/ && shx mkdir -p dist/assets && shx cp src/modes/interactive/assets/*.png dist/assets/ && shx mkdir -p dist/export-html/vendor && shx cp src/core/export-html/template.html dist/export-html/ && shx cp src/core/export-html/vendor/*.js dist/export-html/vendor/ && shx cp -r docs dist/ && shx cp -r examples dist/ && shx cp ../../node_modules/@silvia-odwyer/photon-node/photon_rs_bg.wasm dist/",
-		"test": "vitest --run",
-		"prepublishOnly": "npm run clean && ../../node_modules/.bin/tsgo -p tsconfig.build.json && ../../node_modules/.bin/shx chmod +x dist/cli.js && npm run copy-assets"
-	},
-	"dependencies": {
-		"@mariozechner/jiti": "2.6.2",
-		"@aryee/aery-core": "0.67.68",
-		"@aryee/aery-ai": "0.67.68",
-		"@aryee/aery-tui": "0.67.68",
-		"@silvia-odwyer/photon-node": "^0.3.4",
-		"@sinclair/typebox": "^0.34.41",
-		"ajv": "^8.17.1",
-		"chalk": "^5.5.0",
-		"cli-highlight": "^2.1.11",
-		"diff": "^8.0.2",
-		"extract-zip": "^2.0.1",
-		"file-type": "^21.1.1",
-		"glob": "^13.0.1",
-		"hosted-git-info": "^9.0.2",
-		"ignore": "^7.0.5",
-		"marked": "^15.0.12",
-		"minimatch": "^10.2.3",
-		"proper-lockfile": "^4.1.2",
-		"strip-ansi": "^7.1.0",
-		"undici": "^7.19.1",
-		"uuid": "^11.1.0",
-		"yaml": "^2.8.2"
-	},
-	"overrides": {
-		"rimraf": "6.1.2",
-		"gaxios": {
-			"rimraf": "6.1.2"
-		}
-	},
-	"optionalDependencies": {
-		"@mariozechner/clipboard": "0.3.2"
-	},
-	"devDependencies": {
-		"@types/diff": "^7.0.2",
-		"@types/hosted-git-info": "^3.0.5",
-		"@types/ms": "^2.1.0",
-		"@types/node": "^24.3.0",
-		"@types/proper-lockfile": "^4.1.4",
-		"shx": "^0.4.0",
-		"typescript": "^5.7.3",
-		"vitest": "^3.2.4"
-	},
-	"keywords": [
-		"coding-agent",
-		"ai",
-		"llm",
-		"cli",
-		"tui",
-		"agent"
-	],
-	"author": "Aryee",
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/eminent337/aery.git",
-		"directory": "packages/coding-agent"
-	},
-	"engines": {
-		"node": ">=20.6.0"
-	}
-}
+  "name": "@eminent337/aery",
+  "version": "0.74.2",
+  "description": "Coding agent CLI with read, bash, edit, write tools and session management",
+  "type": "module",
+  "aeryConfig": {
+    "configDir": ".aery"
+  },
+  "bin": {
+    "pi": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/core/hooks/index.d.ts",
+      "import": "./dist/core/hooks/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "examples",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "clean": "shx rm -rf dist",
+    "dev": "tsgo -p tsconfig.build.json --watch --preserveWatchOutput",
+    "build": "tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js && npm run copy-assets",
+    "build:binary": "npm --prefix ../tui run build && npm --prefix ../ai run build && npm --prefix ../agent run build && npm run build && bun build --compile ./dist/bun/cli.js --outfile dist/pi && npm run copy-binary-assets",
+    "copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/",
+    "copy-binary-assets": "shx cp package.json dist/ && shx cp README.md dist/ && shx cp CHANGELOG.md dist/ && shx mkdir -p dist/theme && shx cp src/modes/interactive/theme/*.json dist/theme/ && shx mkdir -p dist/assets && shx cp src/modes/interactive/assets/*.png dist/assets/ && shx mkdir -p dist/export-html/vendor && shx cp src/core/export-html/template.html dist/export-html/ && shx cp src/core/export-html/vendor/*.js dist/export-html/vendor/ && shx cp -r docs dist/ && shx cp -r examples dist/ && shx cp ../../node_modules/@silvia-odwyer/photon-node/photon_rs_bg.wasm dist/",
+    "test": "vitest --run",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@eminent337/aery-core": "0.74.2",
+    "@eminent337/aery-ai": "0.74.2",
+    "@eminent337/aery-tui": "^0.74.0",
+    "@silvia-odwyer/photon-node": "^0.3.4",
+    "chalk": "^5.5.0",
+    "diff": "^8.0.2",
+    "glob": "^13.0.1",
+    "highlight.js": "^10.7.3",
+    "hosted-git-info": "^9.0.2",
+    "ignore": "^7.0.5",
+    "jiti": "^2.7.0",
+    "minimatch": "^10.2.3",
+    "proper-lockfile": "^4.1.2",
+    "typebox": "^1.1.24",
+    "undici": "^7.19.1",
+    "yaml": "^2.8.2"
+  },
+  "overrides": {
+    "rimraf": "6.1.2",
+    "gaxios": {
+      "rimraf": "6.1.2"
+    }
+  },
+  "optionalDependencies": {
+    "@mariozechner/clipboard": "^0.3.5"
+  },
+  "devDependencies": {
+    "@types/diff": "^7.0.2",
+    "@types/hosted-git-info": "^3.0.5",
+    "@types/ms": "^2.1.0",
+    "@types/node": "^24.3.0",
+    "@types/proper-lockfile": "^4.1.4",
+    "shx": "^0.4.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "coding-agent",
+    "ai",
+    "llm",
+    "cli",
+    "tui",
+    "agent"
+  ],
+  "author": "Mario Zechner",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eminent337/aery.git",
+    "directory": "packages/coding-agent"
+  },
+  "engines": {
+    "node": ">=20.6.0"
+  }
+}

package/docs/tree.md

@@ -1,233 +0,0 @@
-# Session Tree Navigation
-
-The `/tree` command provides tree-based navigation of the session history.
-
-## Overview
-
-Sessions are stored as trees where each entry has an `id` and `parentId`. The "leaf" pointer tracks the current position. `/tree` lets you navigate to any point and optionally summarize the branch you're leaving.
-
-### Comparison with `/fork`
-
-| Feature | `/fork` | `/tree` |
-|---------|---------|---------|
-| View | Flat list of user messages | Full tree structure |
-| Action | Extracts path to **new session file** | Changes leaf in **same session** |
-| Summary | Never | Optional (user prompted) |
-| Events | `session_before_fork` / `session_start` (`reason: "fork"`) | `session_before_tree` / `session_tree` |
-
-Use `/clone` when you want a new session file containing the full current active branch without rewinding to an earlier user message.
-
-## Tree UI
-
-```
-├─ user: "Hello, can you help..."
-│  └─ assistant: "Of course! I can..."
-│     ├─ user: "Let's try approach A..."
-│     │  └─ assistant: "For approach A..."
-│     │     └─ [compaction: 12k tokens]
-│     │        └─ user: "That worked..."  ← active
-│     └─ user: "Actually, approach B..."
-│        └─ assistant: "For approach B..."
-```
-
-### Controls
-
-| Key | Action |
-|-----|--------|
-| ↑/↓ | Navigate (depth-first order) |
-| ←/→ | Page up/down |
-| Ctrl+←/Ctrl+→ or Alt+←/Alt+→ | Fold/unfold and jump between branch segments |
-| Shift+L | Set or clear a label on the selected node |
-| Shift+T | Toggle label timestamps |
-| Enter | Select node |
-| Escape/Ctrl+C | Cancel |
-| Ctrl+U | Toggle: user messages only |
-| Ctrl+O | Toggle: show all (including custom/label entries) |
-
-`Ctrl+←` or `Alt+←` folds the current node if it is foldable. Foldable nodes are roots and branch segment starts that have visible children. If the current node is not foldable, or is already folded, the selection jumps up to the previous visible branch segment start.
-
-`Ctrl+→` or `Alt+→` unfolds the current node if it is folded. Otherwise, the selection jumps down to the next visible branch segment start, or to the branch end when there is no further branch point.
-
-### Display
-
-- Height: half terminal height
-- Current leaf marked with `← active`
-- Labels shown inline: `[label-name]`
-- `Shift+T` shows the latest label-change timestamp next to labeled nodes
-- Foldable branch starts show `⊟` in the connector. Folded branches show `⊞`
-- Active path marker `•` appears after the fold indicator when applicable
-- Search and filter changes reset all folds
-- Default filter hides `label` and `custom` entries (shown in Ctrl+O mode)
-- At each branch point, the active subtree is shown first; other sibling branches are sorted by timestamp (oldest first)
-
-## Selection Behavior
-
-### User Message or Custom Message
-1. Leaf set to **parent** of selected node (or `null` if root)
-2. Message text placed in **editor** for re-submission
-3. User edits and submits, creating a new branch
-
-### Non-User Message (assistant, compaction, etc.)
-1. Leaf set to **selected node**
-2. Editor stays empty
-3. User continues from that point
-
-### Selecting Root User Message
-If user selects the very first message (has no parent):
-1. Leaf reset to `null` (empty conversation)
-2. Message text placed in editor
-3. User effectively restarts from scratch
-
-## Branch Summarization
-
-When switching branches, user is presented with three options:
-
-1. **No summary** - Switch immediately without summarizing
-2. **Summarize** - Generate a summary using the default prompt
-3. **Summarize with custom prompt** - Opens an editor to enter additional focus instructions that are appended to the default summarization prompt
-
-### What Gets Summarized
-
-Path from old leaf back to common ancestor with target:
-
-```
-A → B → C → D → E → F  ← old leaf
-        ↘ G → H        ← target
-```
-
-Abandoned path: D → E → F (summarized)
-
-Summarization stops at:
-1. Common ancestor (always)
-2. Compaction node (if encountered first)
-
-### Summary Storage
-
-Stored as `BranchSummaryEntry`:
-
-```typescript
-interface BranchSummaryEntry {
-  type: "branch_summary";
-  id: string;
-  parentId: string;      // New leaf position
-  timestamp: string;
-  fromId: string;        // Old leaf we abandoned
-  summary: string;       // LLM-generated summary
-  details?: unknown;     // Optional hook data
-}
-```
-
-## Implementation
-
-### AgentSession.navigateTree()
-
-```typescript
-async navigateTree(
-  targetId: string,
-  options?: {
-    summarize?: boolean;
-    customInstructions?: string;
-    replaceInstructions?: boolean;
-    label?: string;
-  }
-): Promise<{ editorText?: string; cancelled: boolean }>
-```
-
-Options:
-- `summarize`: Whether to generate a summary of the abandoned branch
-- `customInstructions`: Custom instructions for the summarizer
-- `replaceInstructions`: If true, `customInstructions` replaces the default prompt instead of being appended
-- `label`: Label to attach to the branch summary entry (or target entry if not summarizing)
-
-Flow:
-1. Validate target, check no-op (target === current leaf)
-2. Find common ancestor between old leaf and target
-3. Collect entries to summarize (if requested)
-4. Fire `session_before_tree` event (hook can cancel or provide summary)
-5. Run default summarizer if needed
-6. Switch leaf via `branch()` or `branchWithSummary()`
-7. Update agent: `agent.state.messages = sessionManager.buildSessionContext().messages`
-8. Fire `session_tree` event
-9. Notify custom tools via session event
-10. Return result with `editorText` if user message was selected
-
-### SessionManager
-
-- `getLeafUuid(): string | null` - Current leaf (null if empty)
-- `resetLeaf(): void` - Set leaf to null (for root user message navigation)
-- `getTree(): SessionTreeNode[]` - Full tree with children sorted by timestamp
-- `branch(id)` - Change leaf pointer
-- `branchWithSummary(id, summary)` - Change leaf and create summary entry
-
-### InteractiveMode
-
-`/tree` command shows `TreeSelectorComponent`, then:
-1. Prompt for summarization
-2. Call `session.navigateTree()`
-3. Clear and re-render chat
-4. Set editor text if applicable
-
-## Hook Events
-
-### `session_before_tree`
-
-```typescript
-interface TreePreparation {
-  targetId: string;
-  oldLeafId: string | null;
-  commonAncestorId: string | null;
-  entriesToSummarize: SessionEntry[];
-  userWantsSummary: boolean;
-  customInstructions?: string;
-  replaceInstructions?: boolean;
-  label?: string;
-}
-
-interface SessionBeforeTreeEvent {
-  type: "session_before_tree";
-  preparation: TreePreparation;
-  signal: AbortSignal;
-}
-
-interface SessionBeforeTreeResult {
-  cancel?: boolean;
-  summary?: { summary: string; details?: unknown };
-  customInstructions?: string;    // Override custom instructions
-  replaceInstructions?: boolean;  // Override replace mode
-  label?: string;                 // Override label
-}
-```
-
-Extensions can override `customInstructions`, `replaceInstructions`, and `label` by returning them from the `session_before_tree` handler.
-
-### `session_tree`
-
-```typescript
-interface SessionTreeEvent {
-  type: "session_tree";
-  newLeafId: string | null;
-  oldLeafId: string | null;
-  summaryEntry?: BranchSummaryEntry;
-  fromHook?: boolean;
-}
-```
-
-### Example: Custom Summarizer
-
-```typescript
-export default function(pi: HookAPI) {
-  pi.on("session_before_tree", async (event, ctx) => {
-    if (!event.preparation.userWantsSummary) return;
-    if (event.preparation.entriesToSummarize.length === 0) return;
-    
-    const summary = await myCustomSummarizer(event.preparation.entriesToSummarize);
-    return { summary: { summary, details: { custom: true } } };
-  });
-}
-```
-
-## Error Handling
-
-- Summarization failure: cancels navigation, shows error
-- User abort (Escape): cancels navigation
-- Hook returns `cancel: true`: cancels navigation silently