@eminent337/aery 0.67.68 → 0.74.1

package/examples/extensions/mac-system-theme.ts

@@ -7,7 +7,7 @@
 
 import { exec } from "node:child_process";
 import { promisify } from "node:util";
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 
 const execAsync = promisify(exec);
 

package/examples/extensions/message-renderer.ts

@@ -7,8 +7,8 @@
  * Usage: /status [message] - sends a status message with custom rendering
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
-import { Box, Text } from "@aryee/aery-tui";
+import type { ExtensionAPI } from "@eminent337/aery";
+import { Box, Text } from "@eminent337/aery-tui";
 
 export default function (pi: ExtensionAPI) {
 	// Register custom renderer for "status-update" messages

package/examples/extensions/minimal-mode.ts

@@ -16,7 +16,7 @@
  * Then use ctrl+o to toggle between minimal (collapsed) and full (expanded) views.
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 import {
 	createBashTool,
 	createEditTool,
@@ -25,8 +25,8 @@ import {
 	createLsTool,
 	createReadTool,
 	createWriteTool,
-} from "@aryee/aery";
-import { Text } from "@aryee/aery-tui";
+} from "@eminent337/aery";
+import { Text } from "@eminent337/aery-tui";
 import { homedir } from "os";
 
 /**

package/examples/extensions/modal-editor.ts

@@ -9,8 +9,8 @@
  * - ctrl+c, ctrl+d, etc. work in both modes
  */
 
-import { CustomEditor, type ExtensionAPI } from "@aryee/aery";
-import { matchesKey, truncateToWidth, visibleWidth } from "@aryee/aery-tui";
+import { CustomEditor, type ExtensionAPI } from "@eminent337/aery";
+import { matchesKey, truncateToWidth, visibleWidth } from "@eminent337/aery-tui";
 
 // Normal mode key mappings: key -> escape sequence (or null for mode switch)
 const NORMAL_KEYS: Record<string, string | null> = {

package/examples/extensions/model-status.ts

@@ -7,7 +7,7 @@
  * Usage: pi -e ./model-status.ts
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 
 export default function (pi: ExtensionAPI) {
 	pi.on("model_select", async (event, ctx) => {

package/examples/extensions/notify.ts

@@ -8,7 +8,7 @@
  * - Windows toast: Windows Terminal (WSL)
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 
 function windowsToastScript(title: string, body: string): string {
 	const type = "Windows.UI.Notifications";

package/examples/extensions/overlay-qa-tests.ts

@@ -19,9 +19,9 @@
  *   /overlay-streaming  - Multiple input panels with simulated streaming (Tab to cycle focus)
  */
 
-import type { ExtensionAPI, ExtensionCommandContext, Theme } from "@aryee/aery";
-import type { Component, OverlayAnchor, OverlayHandle, OverlayOptions, TUI } from "@aryee/aery-tui";
-import { matchesKey, truncateToWidth, visibleWidth } from "@aryee/aery-tui";
+import type { ExtensionAPI, ExtensionCommandContext, Theme } from "@eminent337/aery";
+import type { Component, OverlayAnchor, OverlayHandle, OverlayOptions, TUI } from "@eminent337/aery-tui";
+import { matchesKey, truncateToWidth, visibleWidth } from "@eminent337/aery-tui";
 import { spawn } from "child_process";
 
 // Global handle for toggle demo (in real code, use a more elegant pattern)

package/examples/extensions/overlay-test.ts

@@ -8,8 +8,8 @@
  * - Edge case tests (wide chars, styled text, emoji)
  */
 
-import type { ExtensionAPI, ExtensionCommandContext, Theme } from "@aryee/aery";
-import { CURSOR_MARKER, type Focusable, matchesKey, visibleWidth } from "@aryee/aery-tui";
+import type { ExtensionAPI, ExtensionCommandContext, Theme } from "@eminent337/aery";
+import { CURSOR_MARKER, type Focusable, matchesKey, visibleWidth } from "@eminent337/aery-tui";
 
 export default function (pi: ExtensionAPI) {
 	pi.registerCommand("overlay-test", {

package/examples/extensions/permission-gate.ts

@@ -5,7 +5,7 @@
  * Patterns checked: rm -rf, sudo, chmod/chown 777
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 
 export default function (pi: ExtensionAPI) {
 	const dangerousPatterns = [/\brm\s+(-rf?|--recursive)/i, /\bsudo\b/i, /\b(chmod|chown)\b.*777/i];

package/examples/extensions/pirate.ts

@@ -5,12 +5,12 @@
  * change agent behavior based on extension state.
  *
  * Usage:
- * 1. Copy this file to ~/.pi/agent/extensions/ or your project's .pi/extensions/
+ * 1. Copy this file to ~/.aery/agent/extensions/ or your project's .aery/extensions/
  * 2. Use /pirate to toggle pirate mode
  * 3. When enabled, the agent will respond like a pirate
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 
 export default function pirateExtension(pi: ExtensionAPI) {
 	let pirateMode = false;

package/examples/extensions/plan-mode/index.ts

@@ -12,10 +12,10 @@
  * - Progress tracking widget during execution
  */
 
-import type { AgentMessage } from "@aryee/aery-core";
-import type { AssistantMessage, TextContent } from "@aryee/aery-ai";
-import type { ExtensionAPI, ExtensionContext } from "@aryee/aery";
-import { Key } from "@aryee/aery-tui";
+import type { ExtensionAPI, ExtensionContext } from "@eminent337/aery";
+import type { AssistantMessage, TextContent } from "@eminent337/aery-ai";
+import type { AgentMessage } from "@eminent337/aery-core";
+import { Key } from "@eminent337/aery-tui";
 import { extractTodoItems, isSafeCommand, markCompletedSteps, type TodoItem } from "./utils.js";
 
 // Tools

package/examples/extensions/preset.ts

@@ -6,8 +6,8 @@
  * and can be activated via CLI flag, /preset command, or Ctrl+Shift+U to cycle.
  *
  * Config files (merged, project takes precedence):
- * - ~/.pi/agent/presets.json (global)
- * - <cwd>/.pi/presets.json (project-local)
+ * - ~/.aery/agent/presets.json (global)
+ * - <cwd>/.aery/presets.json (project-local)
  *
  * Example presets.json:
  * ```json
@@ -40,10 +40,10 @@
 
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-import type { Api, Model } from "@aryee/aery-ai";
-import type { ExtensionAPI, ExtensionContext } from "@aryee/aery";
-import { DynamicBorder, getAgentDir } from "@aryee/aery";
-import { Container, Key, type SelectItem, SelectList, Text } from "@aryee/aery-tui";
+import type { ExtensionAPI, ExtensionContext } from "@eminent337/aery";
+import { DynamicBorder, getAgentDir } from "@eminent337/aery";
+import type { Api, Model } from "@eminent337/aery-ai";
+import { Container, Key, type SelectItem, SelectList, Text } from "@eminent337/aery-tui";
 
 // Preset configuration
 interface Preset {
@@ -69,7 +69,7 @@ interface PresetsConfig {
  */
 function loadPresets(cwd: string): PresetsConfig {
 	const globalPath = join(getAgentDir(), "presets.json");
-	const projectPath = join(cwd, ".pi", "presets.json");
+	const projectPath = join(cwd, ".aery", "presets.json");
 
 	let globalPresets: PresetsConfig = {};
 	let projectPresets: PresetsConfig = {};
@@ -200,7 +200,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 ~/.pi/agent/presets.json or .pi/presets.json", "warning");
+			ctx.ui.notify(
+				"No presets defined. Add presets to ~/.aery/agent/presets.json or .aery/presets.json",
+				"warning",
+			);
 			return;
 		}
 
@@ -308,7 +311,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 ~/.pi/agent/presets.json or .pi/presets.json", "warning");
+			ctx.ui.notify(
+				"No presets defined. Add presets to ~/.aery/agent/presets.json or .aery/presets.json",
+				"warning",
+			);
 			return;
 		}
 

package/examples/extensions/prompt-customizer.ts

@@ -0,0 +1,97 @@
+/**
+ * Prompt Customizer Extension
+ *
+ * Demonstrates using systemPromptOptions to make informed, context-aware
+ * modifications to the system prompt without re-discovering resources.
+ *
+ * This extension adds tool-specific guidance based on what tools and skills
+ * are currently active, respecting whatever the user has configured.
+ *
+ * Usage:
+ * 1. Copy this file to ~/.aery/agent/extensions/ or your project's .aery/extensions/
+ * 2. Use the extension — it automatically adapts to your active tools and skills
+ */
+
+import type { BuildSystemPromptOptions, ExtensionAPI } from "@eminent337/aery";
+
+/**
+ * Adds tool-specific guidance that adapts to the active tool set.
+ * Instead of appending one-size-fits-all instructions, this reads what's
+ * actually loaded and tailors the guidance accordingly.
+ */
+function addToolGuidance(options: BuildSystemPromptOptions, basePrompt: string): string {
+	const hasTool = (name: string) => options.selectedTools?.includes(name) ?? false;
+
+	const parts: string[] = [];
+
+	if (hasTool("read")) {
+		parts.push(
+			"• Use the `read` tool for file contents (supports text and images).",
+			"  - For large files, use `offset` and `limit` to read in chunks.",
+		);
+	}
+
+	if (hasTool("bash")) {
+		parts.push("• Execute commands with the `bash` tool. Use it for file operations like `ls`, `find`, `grep`.");
+	}
+
+	if (hasTool("edit")) {
+		parts.push(
+			"• Use the `edit` tool for precise text replacements in files. Match exact content including whitespace.",
+		);
+	}
+
+	if (hasTool("write")) {
+		parts.push("• Use the `write` tool to create new files or overwrite existing ones completely.");
+	}
+
+	if (options.skills && options.skills.length > 0) {
+		const skillNames = options.skills.map((s) => s.name).join(", ");
+		parts.push(`\nAvailable skills: ${skillNames}`, "Use skill documentation for best practices on specific tools.");
+	}
+
+	if (parts.length === 0) {
+		return basePrompt;
+	}
+
+	return `${basePrompt}
+
+## Tool Guidance
+
+${parts.join("\n")}
+`;
+}
+
+/**
+ * Merges extension instructions with user-provided append prompts.
+ * This respects whatever the user configured via --append-system-prompt
+ * flags or files, rather than duplicating that work.
+ */
+function mergeWithUserAppend(options: BuildSystemPromptOptions): string {
+	const userAppend = options.appendSystemPrompt;
+	const extensionSpecific = `
+## Extension-Added Context
+
+This prompt includes tool guidance and skill information loaded dynamically.
+If you have additional requirements, configure them via --append-system-prompt or project context files.
+`;
+
+	if (userAppend) {
+		return `${userAppend}\n\n${extensionSpecific}`;
+	}
+
+	return extensionSpecific;
+}
+
+export default function promptCustomizer(pi: ExtensionAPI) {
+	pi.on("before_agent_start", async (event) => {
+		const { systemPrompt, systemPromptOptions } = event;
+
+		const customPrompt = addToolGuidance(systemPromptOptions, systemPrompt);
+		const appendSection = mergeWithUserAppend(systemPromptOptions);
+
+		return {
+			systemPrompt: `${customPrompt}${appendSection}`,
+		};
+	});
+}

package/examples/extensions/protected-paths.ts

@@ -5,7 +5,7 @@
  * Useful for preventing accidental modifications to sensitive files.
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 
 export default function (pi: ExtensionAPI) {
 	const protectedPaths = [".env", ".git/", "node_modules/"];

package/examples/extensions/provider-payload.ts

@@ -1,9 +1,9 @@
 import { appendFileSync } from "node:fs";
 import { join } from "node:path";
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 
 export default function (pi: ExtensionAPI) {
-	const logFile = join(process.cwd(), ".pi", "provider-payload.log");
+	const logFile = join(process.cwd(), ".aery", "provider-payload.log");
 
 	pi.on("before_provider_request", (event) => {
 		appendFileSync(logFile, `${JSON.stringify(event.payload, null, 2)}\n\n`, "utf8");

package/examples/extensions/qna.ts

@@ -7,9 +7,9 @@
  * 3. Loads the result into the editor for user to fill in answers
  */
 
-import { complete, type UserMessage } from "@aryee/aery-ai";
-import type { ExtensionAPI } from "@aryee/aery";
-import { BorderedLoader } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
+import { BorderedLoader } from "@eminent337/aery";
+import { complete, type UserMessage } from "@eminent337/aery-ai";
 
 const SYSTEM_PROMPT = `You are a question extractor. Given text from a conversation, extract any questions that need answering and format them for the user to fill in.
 

package/examples/extensions/question.ts

@@ -4,9 +4,9 @@
  * Escape in editor returns to options, Escape in options cancels
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
-import { Editor, type EditorTheme, Key, matchesKey, Text, truncateToWidth } from "@aryee/aery-tui";
-import { Type } from "@sinclair/typebox";
+import type { ExtensionAPI } from "@eminent337/aery";
+import { Editor, type EditorTheme, Key, matchesKey, Text, truncateToWidth } from "@eminent337/aery-tui";
+import { Type } from "typebox";
 
 interface OptionWithDesc {
 	label: string;

package/examples/extensions/questionnaire.ts

@@ -5,9 +5,9 @@
  * Multiple questions: tab bar navigation between questions
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
-import { Editor, type EditorTheme, Key, matchesKey, Text, truncateToWidth } from "@aryee/aery-tui";
-import { Type } from "@sinclair/typebox";
+import type { ExtensionAPI } from "@eminent337/aery";
+import { Editor, type EditorTheme, Key, matchesKey, Text, truncateToWidth } from "@eminent337/aery-tui";
+import { Type } from "typebox";
 
 // Types
 interface QuestionOption {

package/examples/extensions/rainbow-editor.ts

@@ -4,7 +4,7 @@
  * Usage: pi --extension ./examples/extensions/rainbow-editor.ts
  */
 
-import { CustomEditor, type ExtensionAPI } from "@aryee/aery";
+import { CustomEditor, type ExtensionAPI } from "@eminent337/aery";
 
 // Base colors (coral → yellow → green → teal → blue → purple → pink)
 const COLORS: [number, number, number][] = [

package/examples/extensions/reload-runtime.ts

@@ -5,8 +5,8 @@
  * tool that queues a follow-up command to trigger reload.
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
-import { Type } from "@sinclair/typebox";
+import type { ExtensionAPI } from "@eminent337/aery";
+import { Type } from "typebox";
 
 export default function (pi: ExtensionAPI) {
 	// Command entrypoint for reload.

package/examples/extensions/rpc-demo.ts

@@ -17,7 +17,7 @@
  * - setEditorText() - via /rpc-prefill command
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 
 export default function (pi: ExtensionAPI) {
 	let turnCount = 0;

package/examples/extensions/sandbox/index.ts

@@ -10,10 +10,10 @@
  * via `tool_call` input mutation without replacing the tool.
  *
  * Config files (merged, project takes precedence):
- * - ~/.pi/agent/extensions/sandbox.json (global)
- * - <cwd>/.pi/sandbox.json (project-local)
+ * - ~/.aery/agent/extensions/sandbox.json (global)
+ * - <cwd>/.aery/sandbox.json (project-local)
  *
- * Example .pi/sandbox.json:
+ * Example .aery/sandbox.json:
  * ```json
  * {
  *   "enabled": true,
@@ -35,8 +35,8 @@
  * - `/sandbox` - show current sandbox configuration
  *
  * Setup:
- * 1. Copy sandbox/ directory to ~/.pi/agent/extensions/
- * 2. Run `npm install` in ~/.pi/agent/extensions/sandbox/
+ * 1. Copy sandbox/ directory to ~/.aery/agent/extensions/
+ * 2. Run `npm install` in ~/.aery/agent/extensions/sandbox/
  *
  * Linux also requires: bubblewrap, socat, ripgrep
  */
@@ -45,8 +45,8 @@ import { spawn } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { SandboxManager, type SandboxRuntimeConfig } from "@anthropic-ai/sandbox-runtime";
-import type { ExtensionAPI } from "@aryee/aery";
-import { type BashOperations, createBashTool, getAgentDir } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
+import { type BashOperations, createBashTool, getAgentDir } from "@eminent337/aery";
 
 interface SandboxConfig extends SandboxRuntimeConfig {
 	enabled?: boolean;
@@ -77,7 +77,7 @@ const DEFAULT_CONFIG: SandboxConfig = {
 };
 
 function loadConfig(cwd: string): SandboxConfig {
-	const projectConfigPath = join(cwd, ".pi", "sandbox.json");
+	const projectConfigPath = join(cwd, ".aery", "sandbox.json");
 	const globalConfigPath = join(getAgentDir(), "extensions", "sandbox.json");
 
 	let globalConfig: Partial<SandboxConfig> = {};

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

@@ -1,12 +1,12 @@
 {
-	"name": "pi-extension-sandbox",
-	"version": "1.0.0",
+	"name": "aery-extension-sandbox",
+	"version": "1.4.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
-			"name": "pi-extension-sandbox",
-			"version": "1.0.0",
+			"name": "aery-extension-sandbox",
+			"version": "1.4.0",
 			"dependencies": {
 				"@anthropic-ai/sandbox-runtime": "^0.0.26"
 			}
@@ -62,9 +62,9 @@
 			}
 		},
 		"node_modules/lodash-es": {
-			"version": "4.17.22",
-			"resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.17.22.tgz",
-			"integrity": "sha512-XEawp1t0gxSi9x01glktRZ5HDy0HXqrM0x5pXQM98EaI0NxO6jVM7omDOxsuEo5UIASAnm2bRp1Jt/e0a2XU8Q==",
+			"version": "4.18.1",
+			"resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.18.1.tgz",
+			"integrity": "sha512-J8xewKD/Gk22OZbhpOVSwcs60zhd95ESDwezOFuA3/099925PdHJ7OFHNTGtajL3AlZkykD32HykiMo+BIBI8A==",
 			"license": "MIT"
 		},
 		"node_modules/shell-quote": {

package/examples/extensions/sandbox/package.json

@@ -1,7 +1,7 @@
 {
-	"name": "pi-extension-sandbox",
+	"name": "aery-extension-sandbox",
 	"private": true,
-	"version": "1.0.0",
+	"version": "1.4.0",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/send-user-message.ts

@@ -11,7 +11,7 @@
  *   /followup And then?   - Sends while streaming with followUp delivery
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 
 export default function (pi: ExtensionAPI) {
 	// Simple command that sends a user message

package/examples/extensions/session-name.ts

@@ -7,7 +7,7 @@
  * Usage: /session-name [name] - set or show session name
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 
 export default function (pi: ExtensionAPI) {
 	pi.registerCommand("session-name", {

package/examples/extensions/shutdown-command.ts

@@ -5,8 +5,8 @@
  * Demonstrates how extensions can use ctx.shutdown() to exit pi cleanly.
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
-import { Type } from "@sinclair/typebox";
+import type { ExtensionAPI } from "@eminent337/aery";
+import { Type } from "typebox";
 
 export default function (pi: ExtensionAPI) {
 	// Register a /quit command that cleanly exits pi

package/examples/extensions/snake.ts

@@ -2,8 +2,8 @@
  * Snake game extension - play snake with /snake command
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
-import { matchesKey, visibleWidth } from "@aryee/aery-tui";
+import type { ExtensionAPI } from "@eminent337/aery";
+import { matchesKey, visibleWidth } from "@eminent337/aery-tui";
 
 const GAME_WIDTH = 40;
 const GAME_HEIGHT = 15;

package/examples/extensions/space-invaders.ts

@@ -3,8 +3,8 @@
  * Uses Kitty keyboard protocol for smooth movement (press/release detection)
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
-import { isKeyRelease, Key, matchesKey, visibleWidth } from "@aryee/aery-tui";
+import type { ExtensionAPI } from "@eminent337/aery";
+import { isKeyRelease, Key, matchesKey, visibleWidth } from "@eminent337/aery-tui";
 
 const GAME_WIDTH = 60;
 const GAME_HEIGHT = 24;

package/examples/extensions/ssh.ts

@@ -14,7 +14,7 @@
  */
 
 import { spawn } from "node:child_process";
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 import {
 	type BashOperations,
 	createBashTool,
@@ -24,7 +24,7 @@ import {
 	type EditOperations,
 	type ReadOperations,
 	type WriteOperations,
-} from "@aryee/aery";
+} from "@eminent337/aery";
 
 function sshExec(remote: string, command: string): Promise<Buffer> {
 	return new Promise((resolve, reject) => {

package/examples/extensions/status-line.ts

@@ -5,7 +5,7 @@
  * Shows turn progress with themed colors.
  */
 
-import type { ExtensionAPI } from "@aryee/aery";
+import type { ExtensionAPI } from "@eminent337/aery";
 
 export default function (pi: ExtensionAPI) {
 	let turnCount = 0;