@apolloyh/apollo-agent 0.1.1 → 0.1.3

package/.env.example

@@ -11,7 +11,8 @@ ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME=glm-5.2
 ANTHROPIC_DEFAULT_SONNET_MODEL_NAME=glm-5.2
 
 # Optional
-# ANTHROPIC_MAX_TOKENS=4096
+# GLM-5 supports up to 128K output tokens; lower this for providers with smaller output limits.
+# ANTHROPIC_MAX_TOKENS=131072
 # ANTHROPIC_TIMEOUT_MS=300000
 # ANTHROPIC_CACHE_TTL=5m
 # AGENT_SENDMAIL_PATH=/usr/sbin/sendmail

package/README.md

@@ -33,7 +33,7 @@ apollo -r      # pick a saved project session
 apollo -r <session-id>
 ```
 
-Apollo automatically loads `.apollo/.env`, then falls back to `.env`; use `--env-file <path>` to override discovery.
+Apollo loads project `.apollo/.env`, project `.env`, then user-level `~/.apollo/.env`; use `--env-file <path>` to override discovery.
 
 Optional project configuration lives at `.apollo/config.json`; Apollo also reads the legacy
 `agent.config.json` during migration. Copy `.apollo/config.example.json` to get started.

package/dist/brand.d.ts

@@ -1,9 +1,9 @@
 /** Product identity — single source of truth for display strings. */
 export declare const PRODUCT: {
     readonly name: "Apollo";
-    readonly version: "0.1.0";
+    readonly version: "0.1.3";
     readonly tagline: "Your personal agent — answer first, act when needed.";
-    readonly packageName: "apollo-agent";
+    readonly packageName: "@apolloyh/apollo-agent";
     readonly userAgent: "ApolloAgent/0.1";
     readonly prompt: "apollo";
 };

package/dist/brand.js

@@ -1,9 +1,9 @@
 /** Product identity — single source of truth for display strings. */
 export const PRODUCT = {
     name: "Apollo",
-    version: "0.1.0",
+    version: "0.1.3",
     tagline: "Your personal agent — answer first, act when needed.",
-    packageName: "apollo-agent",
+    packageName: "@apolloyh/apollo-agent",
     userAgent: "ApolloAgent/0.1",
     prompt: "apollo",
 };

package/dist/config.d.ts

@@ -1,13 +1,20 @@
 import type { AgentConfig, LlmConfig, SubagentConfig } from "./types.js";
 /** Default subagents — Claude Code–style Task roles. */
 export declare const DEFAULT_AGENTS: SubagentConfig[];
+export declare const MISSING_AUTH_TOKEN_MESSAGE = "Missing ANTHROPIC_AUTH_TOKEN. Add it to ~/.apollo/.env, .apollo/.env, .env, or your shell, then restart Apollo.";
+export declare function ensureUserEnvFile(): {
+    path: string;
+    created: boolean;
+};
 export declare function loadAgentConfig(configPath?: string): Promise<AgentConfig>;
 /**
- * Load an explicit env file, or discover .apollo/.env then .env.
+ * Load an explicit env file, or discover project env then ~/.apollo/.env.
  * By default **overrides** existing shell vars so local agent config wins.
  */
 export declare function loadEnvFile(envPath?: string, options?: {
     override?: boolean;
 }): boolean;
-export declare function loadLlmConfig(): LlmConfig;
+export declare function loadLlmConfig(options?: {
+    allowMissingAuth?: boolean;
+}): LlmConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzE,wDAAwD;AACxD,eAAO,MAAM,cAAc,EAAE,cAAc,EA4B1C,CAAC;AAuBF,wBAAsB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA0B/E;AAiBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAuB3F;AAYD,wBAAgB,aAAa,IAAI,SAAS,CAmCzC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzE,wDAAwD;AACxD,eAAO,MAAM,cAAc,EAAE,cAAc,EA4B1C,CAAC;AAsBF,eAAO,MAAM,0BAA0B,oHAC4E,CAAC;AAWpH,wBAAgB,iBAAiB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAatE;AAED,wBAAsB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA0B/E;AAiBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAwB3F;AAYD,wBAAgB,aAAa,CAAC,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,SAAS,CAkCrF"}

package/dist/config.js

@@ -1,5 +1,6 @@
 import fsSync from "node:fs";
 import fs from "node:fs/promises";
+import os from "node:os";
 import path from "node:path";
 /** Default subagents — Claude Code–style Task roles. */
 export const DEFAULT_AGENTS = [
@@ -47,6 +48,31 @@ const defaultConfig = {
 };
 const DEFAULT_CONFIG_PATH = ".apollo/config.json";
 const LEGACY_CONFIG_PATH = "agent.config.json";
+export const MISSING_AUTH_TOKEN_MESSAGE = "Missing ANTHROPIC_AUTH_TOKEN. Add it to ~/.apollo/.env, .apollo/.env, .env, or your shell, then restart Apollo.";
+const USER_ENV_TEMPLATE = `# Apollo uses Anthropic-compatible environment variable names.
+# Add your provider token below, then restart Apollo.
+ANTHROPIC_AUTH_TOKEN=
+
+# Optional provider settings:
+# ANTHROPIC_BASE_URL=https://api.anthropic.com
+# ANTHROPIC_MODEL=claude-haiku-4-5
+`;
+export function ensureUserEnvFile() {
+    const directory = path.join(os.homedir(), ".apollo");
+    const envPath = path.join(directory, ".env");
+    if (fsSync.existsSync(envPath))
+        return { path: envPath, created: false };
+    fsSync.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    try {
+        fsSync.writeFileSync(envPath, USER_ENV_TEMPLATE, { encoding: "utf8", flag: "wx", mode: 0o600 });
+        return { path: envPath, created: true };
+    }
+    catch (error) {
+        if (error.code === "EEXIST")
+            return { path: envPath, created: false };
+        throw error;
+    }
+}
 export async function loadAgentConfig(configPath) {
     const discoveredPath = configPath ?? [DEFAULT_CONFIG_PATH, LEGACY_CONFIG_PATH].find(fsSync.existsSync);
     if (!discoveredPath) {
@@ -84,17 +110,18 @@ function normalizeAgents(list) {
     }));
 }
 /**
- * Load an explicit env file, or discover .apollo/.env then .env.
+ * Load an explicit env file, or discover project env then ~/.apollo/.env.
  * By default **overrides** existing shell vars so local agent config wins.
  */
 export function loadEnvFile(envPath, options = {}) {
-    const selectedPath = envPath ?? [".apollo/.env", ".env"].find(fsSync.existsSync);
+    const userEnvPath = path.join(os.homedir(), ".apollo", ".env");
+    const selectedPath = envPath ?? [".apollo/.env", ".env", userEnvPath].find(fsSync.existsSync);
     if (!selectedPath)
         return false;
     const resolvedPath = path.resolve(selectedPath);
     if (!fsSync.existsSync(resolvedPath))
         return false;
-    const override = options.override ?? true;
+    const override = options.override ?? (envPath !== undefined || path.resolve(selectedPath) !== userEnvPath);
     const raw = fsSync.readFileSync(resolvedPath, "utf8");
     for (const line of raw.split(/\r?\n/)) {
         const trimmed = line.trim();
@@ -120,7 +147,7 @@ function unwrapEnvValue(value) {
     }
     return value;
 }
-export function loadLlmConfig() {
+export function loadLlmConfig(options = {}) {
     const authToken = process.env.ANTHROPIC_AUTH_TOKEN;
     const baseUrl = process.env.ANTHROPIC_BASE_URL ?? "https://api.anthropic.com";
     const model = process.env.ANTHROPIC_MODEL ||
@@ -128,14 +155,14 @@ export function loadLlmConfig() {
         process.env.ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME ||
         process.env.ANTHROPIC_DEFAULT_SONNET_MODEL_NAME ||
         "claude-haiku-4-5";
-    if (!authToken) {
-        throw new Error("Missing ANTHROPIC_AUTH_TOKEN. Set it in .apollo/.env, .env, or your shell before running.");
-    }
+    if (!authToken && !options.allowMissingAuth)
+        throw new Error(MISSING_AUTH_TOKEN_MESSAGE);
     const cacheTtl = process.env.ANTHROPIC_CACHE_TTL ?? "5m";
     if (cacheTtl !== "5m" && cacheTtl !== "1h") {
         throw new Error("ANTHROPIC_CACHE_TTL must be 5m or 1h.");
     }
-    const maxTokens = positiveNumberEnv("ANTHROPIC_MAX_TOKENS", 4096, true);
+    const providerDefaultMaxTokens = /(?:^glm-|bigmodel\.cn)/i.test(`${model} ${baseUrl}`) ? 128 * 1024 : 4096;
+    const maxTokens = positiveNumberEnv("ANTHROPIC_MAX_TOKENS", providerDefaultMaxTokens, true);
     const timeoutMs = positiveNumberEnv("ANTHROPIC_TIMEOUT_MS", 300000, true);
     let parsedBaseUrl;
     try {
@@ -148,7 +175,7 @@ export function loadLlmConfig() {
         throw new Error("ANTHROPIC_BASE_URL must be a valid HTTP or HTTPS URL.");
     }
     return {
-        authToken,
+        authToken: authToken ?? "",
         baseUrl,
         model,
         maxTokens,

package/dist/index.js

@@ -3,7 +3,7 @@ import { stdin, stdout } from "node:process";
 import readline from "node:readline/promises";
 import { ASCII_LOGO, PRODUCT } from "./brand.js";
 import { parseArgs } from "./cli-args.js";
-import { loadAgentConfig, loadEnvFile, loadLlmConfig } from "./config.js";
+import { ensureUserEnvFile, loadAgentConfig, loadEnvFile, loadLlmConfig, MISSING_AUTH_TOKEN_MESSAGE, } from "./config.js";
 import { pickSpinnerVerb } from "./constants/spinner-verbs.js";
 import { QueryEngine } from "./runtime/query-engine.js";
 import { createCliApprovalProvider } from "./runtime/permissions.js";
@@ -56,6 +56,7 @@ function filterSlashCommands(buffer) {
 }
 async function main() {
     const args = parseArgs(process.argv.slice(2));
+    const userEnv = ensureUserEnvFile();
     loadEnvFile(args.envPath);
     const task = args.task ?? (stdin.isTTY ? undefined : (await readStdin()).trim());
     if (!task && !stdin.isTTY) {
@@ -64,8 +65,8 @@ async function main() {
         return;
     }
     const agentConfig = await loadAgentConfig(args.configPath);
-    const llmConfig = loadLlmConfig();
     const interactiveMode = !task && stdin.isTTY;
+    const llmConfig = loadLlmConfig({ allowMissingAuth: interactiveMode });
     const yolo = args.yolo;
     const thoughtFold = new ThoughtFoldManager({
         color: args.color,
@@ -235,6 +236,9 @@ async function main() {
         quiet: !traceOptions.verbose,
         yolo: yolo || agentConfig.permissions.mode === "unrestricted",
     }));
+    if (userEnv.created) {
+        stdout.write(`\nCreated ${shortenHome(userEnv.path)}. Add ANTHROPIC_AUTH_TOKEN there, then restart Apollo.\n`);
+    }
     const approvalProvider = createCliApprovalProvider(agentConfig, traceSink, () => yolo, {
         beforePrompt: () => {
             stopLiveStatus("none");
@@ -310,6 +314,8 @@ async function main() {
                     `  ${PRODUCT.name} v${PRODUCT.version}`,
                     `  model     ${llmConfig.model}`,
                     `  base      ${llmConfig.baseUrl}`,
+                    `  output max ${llmConfig.maxTokens.toLocaleString()} tokens`,
+                    `  context   ${agentConfig.context.maxChars.toLocaleString()} chars`,
                     `  cwd       ${shortenHome(agentConfig.workspaceRoot)}`,
                     `  messages  ${runtime.conversationSize()}`,
                     `  tokens    ${usage.input_tokens.toLocaleString()} input / ${usage.output_tokens.toLocaleString()} output`,
@@ -530,6 +536,8 @@ async function main() {
             activeVerb = pickSpinnerVerb(text);
             startPinnedCliInput(traceOptions.color);
             try {
+                if (!llmConfig.authToken)
+                    throw new Error(MISSING_AUTH_TOKEN_MESSAGE);
                 const result = await runWithRenderer(renderer, () => runtime.submitMessage(text));
                 stopLiveStatus("success");
                 if (!traceOptions.stream)
@@ -828,11 +836,17 @@ function formatToolCallStatus(tool, input) {
         const lines = input.content ? input.content.split(/\r?\n/).length : 0;
         return `${label}${detail} · ${lines} ${lines === 1 ? "line" : "lines"}`;
     }
+    if (tool === "edit_file" && typeof input.new_string === "string") {
+        const lines = input.new_string ? input.new_string.split(/\r?\n/).length : 0;
+        return `${label}${detail} · ${lines} replacement ${lines === 1 ? "line" : "lines"}`;
+    }
     return `${label}${detail}`;
 }
 function formatToolStatusName(tool) {
     if (tool === "write_file")
         return "Write";
+    if (tool === "edit_file")
+        return "Edit";
     if (tool === "shell_exec")
         return "Bash";
     if (tool === "Task")
@@ -1686,6 +1700,8 @@ function formatRuntimeError(error, verbose) {
     if (isAbortError(error))
         return "Interrupted by user.";
     const message = error instanceof Error ? error.message : String(error);
+    if (message === MISSING_AUTH_TOKEN_MESSAGE)
+        return `Apollo is not configured yet. ${message}`;
     if (verbose && error instanceof Error)
         return error.stack ?? message;
     const bounded = message.length > 1200 ? `${message.slice(0, 1200)}...` : message;

package/dist/runtime/permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/runtime/permissions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7F,KAAK,kBAAkB,GAAG;IACxB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;CAC5C,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,EACpC,OAAO,GAAE,kBAAuB,GAC/B,gBAAgB,CA8BlB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,UAAQ,GAAG,MAAM,CAY7G"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/runtime/permissions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7F,KAAK,kBAAkB,GAAG;IACxB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;CAC5C,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,EACpC,OAAO,GAAE,kBAAuB,GAC/B,gBAAgB,CA8BlB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,UAAQ,GAAG,MAAM,CAa7G"}

package/dist/runtime/permissions.js

@@ -39,6 +39,8 @@ export function createCliApprovalProvider(config, emit, assumeYes, options = {})
 export function formatApprovalRequest(config, request, useColor = false) {
     if (request.toolName === "write_file")
         return formatWriteFileApproval(config, request, useColor);
+    if (request.toolName === "edit_file")
+        return formatEditFileApproval(config, request, useColor);
     const inputSummary = stringify(compactApprovalInput(request.toolName, request.input), 800)
         .split("\n")
         .map((line) => `${paint("│", "yellow", useColor)} ${paint(line, "dim", useColor)}`)
@@ -50,6 +52,21 @@ export function formatApprovalRequest(config, request, useColor = false) {
         paint("╰─", "yellow", useColor),
     ].join("\n");
 }
+function formatEditFileApproval(config, request, useColor) {
+    const targetPath = typeof request.input.path === "string" ? request.input.path : "(missing path)";
+    const resolvedPath = path.resolve(config.workspaceRoot, targetPath);
+    const relativePath = path.relative(config.workspaceRoot, resolvedPath);
+    const displayPath = relativePath && !relativePath.startsWith("..") ? relativePath : resolvedPath;
+    const oldString = typeof request.input.old_string === "string" ? request.input.old_string : "";
+    const newString = typeof request.input.new_string === "string" ? request.input.new_string : "";
+    return [
+        "",
+        `${paint("╭─", "yellow", useColor)} ${paint("Edit file", "yellowBold", useColor)} ${paint("· approval required", "dim", useColor)}`,
+        `${paint("│", "yellow", useColor)} ${paint(displayPath, "blueBold", useColor)}`,
+        `${paint("│", "yellow", useColor)} ${paint(`${oldString.split(/\r?\n/).length} → ${newString.split(/\r?\n/).length} lines`, "dim", useColor)}`,
+        paint("╰─", "yellow", useColor),
+    ].join("\n");
+}
 function formatWriteFileApproval(config, request, useColor) {
     const targetPath = typeof request.input.path === "string" ? request.input.path : "(missing path)";
     const content = typeof request.input.content === "string" ? request.input.content : "";

package/dist/runtime/prompt-builder.js

@@ -72,7 +72,7 @@ ${prompt}`;
 - For code or workspace tasks, read relevant files before proposing or making changes.
 - Keep changes scoped to what the user asked. Do not add speculative features, broad refactors, or unnecessary abstractions.
 - Prefer editing existing files over creating new files unless a new file is necessary.
-- When calling tools, include every required input field every time. For write_file, always include both path and content even when rewriting the same file.
+- When calling tools, include every required input field every time. Prefer edit_file with path, old_string, and new_string for localized changes. Use write_file with both path and content only for new files or intentional full-file replacement.
 - Verify meaningful changes when practical by running targeted tests, builds, or checks. If you cannot verify, say so.
 - Report outcomes faithfully. If a check fails, include the relevant failure. Never claim success for checks you did not run.`;
     }

package/dist/runtime/tool-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-policy.d.ts","sourceRoot":"","sources":["../../src/runtime/tool-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,aAAa,EAAE;IAEnD,kBAAkB,IAAI,MAAM;IAoC5B,mBAAmB,IAAI,MAAM;IAU7B;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM;IA2ClD,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM;CAU1D"}
+{"version":3,"file":"tool-policy.d.ts","sourceRoot":"","sources":["../../src/runtime/tool-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,aAAa,EAAE;IAEnD,kBAAkB,IAAI,MAAM;IAqC5B,mBAAmB,IAAI,MAAM;IAU7B;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM;IA2ClD,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM;CAU1D"}

package/dist/runtime/tool-policy.js

@@ -11,9 +11,10 @@ export class ToolPolicy {
             "Do not call tools just to make ordinary conversation, and do not claim a tool was used unless it was actually called.",
             "If a tool call is denied, do not repeat the exact same call. Adjust your approach or ask the user for clarification.",
             names.has("read_file") ? "Use read_file to inspect files instead of shell commands like cat, head, tail, or sed." : null,
-            names.has("read_file") || names.has("write_file") || names.has("list_files")
+            names.has("read_file") || names.has("write_file") || names.has("edit_file") || names.has("list_files")
                 ? "If the user asks for a file or directory outside the workspace, still use the dedicated file tool. The runtime will request human approval for crossing the workspace boundary; do not refuse solely because the path is outside the workspace."
                 : null,
+            names.has("edit_file") ? "Prefer edit_file for localized changes to existing files so tool inputs stay small and the user receives a focused diff." : null,
             names.has("write_file") ? "Use write_file for file creation or full-file replacement instead of shell redirection." : null,
             names.has("shell_exec")
                 ? "Reserve shell_exec for local system commands, tests, package scripts, or operations that do not have a dedicated tool. Do not use shell_exec with curl, wget, python, node, or other scripts to make HTTP requests."

package/dist/tools/builtin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtin.d.ts","sourceRoot":"","sources":["../../src/tools/builtin.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAc,cAAc,EAAwB,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5G,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAY7C,KAAK,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC;AAGjG,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,KACZ,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,gEAAgE;IAChE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CA0hB3E;AAsKD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,eAA2E,GACnF,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAA;CAAE,CAAC,CAkB7C"}
+{"version":3,"file":"builtin.d.ts","sourceRoot":"","sources":["../../src/tools/builtin.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAc,cAAc,EAAwB,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5G,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAY7C,KAAK,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC;AAGjG,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,KACZ,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,gEAAgE;IAChE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAqkB3E;AAgLD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,eAA2E,GACnF,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAA;CAAE,CAAC,CAkB7C"}

package/dist/tools/builtin.js

@@ -101,6 +101,49 @@ export function createBuiltinRegistry(options) {
             };
         },
     });
+    registry.register({
+        name: "edit_file",
+        description: "Replace an exact text block in an existing UTF-8 file. Prefer this for localized code changes because it sends less content and produces a focused diff.",
+        risk: "high",
+        input_schema: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                old_string: { type: "string", description: "Exact text currently present in the file." },
+                new_string: { type: "string", description: "Replacement text." },
+                replace_all: { type: "boolean", description: "Replace every exact occurrence. Defaults to false." },
+            },
+            required: ["path", "old_string", "new_string"],
+        },
+        execute: async (input, context) => {
+            const targetPath = requiredString(input, "path");
+            const oldString = requiredString(input, "old_string");
+            const newString = input.new_string;
+            if (typeof newString !== "string")
+                throw new Error("Missing string input: new_string");
+            if (!oldString)
+                throw new Error("edit_file old_string must not be empty.");
+            const fullPath = await resolvePathWithBoundaryApproval(config, context, targetPath, "edit file");
+            const previous = await fs.readFile(fullPath, "utf8");
+            const occurrences = countOccurrences(previous, oldString);
+            if (occurrences === 0)
+                throw new Error(`edit_file could not find old_string in ${targetPath}. Read the file again and copy the exact current text.`);
+            const replaceAll = input.replace_all === true;
+            if (occurrences > 1 && !replaceAll) {
+                throw new Error(`edit_file found ${occurrences} matches in ${targetPath}. Include more surrounding text for a unique match or set replace_all=true.`);
+            }
+            const content = replaceAll
+                ? previous.split(oldString).join(newString)
+                : previous.replace(oldString, newString);
+            await fs.writeFile(fullPath, content, "utf8");
+            const displayPath = path.relative(config.workspaceRoot, fullPath);
+            const diffable = previous.length <= FILE_DIFF_MAX_BYTES && content.length <= FILE_DIFF_MAX_BYTES;
+            return {
+                content: `Edited ${displayPath}`,
+                fileChange: diffable ? fileChangeDisplay(displayPath, previous, content) : undefined,
+            };
+        },
+    });
     registry.register({
         name: "shell_exec",
         description: "Run a local shell command in the workspace for builds, tests, package scripts, or system inspection. Do not use for HTTP requests; use web_search or web_fetch instead.",
@@ -569,6 +612,15 @@ function visibleLines(content) {
         lines.pop();
     return lines;
 }
+function countOccurrences(content, search) {
+    let count = 0;
+    let offset = 0;
+    while ((offset = content.indexOf(search, offset)) >= 0) {
+        count += 1;
+        offset += search.length;
+    }
+    return count;
+}
 async function resolvePathWithBoundaryApproval(config, context, targetPath, operation) {
     let boundaryDetail = "";
     try {

package/dist/trace.js

@@ -565,7 +565,7 @@ function thoughtDetail(stopReason) {
     return stopReason ? `stopped by ${stopReason}` : "model response received";
 }
 function formatInteractiveToolResult(tool, content, isError, input) {
-    const name = tool === "write_file" ? "Write" : tool === "shell_exec" ? "Bash" : toolLabel(tool);
+    const name = tool === "write_file" ? "Write" : tool === "edit_file" ? "Edit" : tool === "shell_exec" ? "Bash" : toolLabel(tool);
     const key = tool === "list_files" ? "directory" : tool === "web_search" ? "query" : tool === "web_fetch" ? "url" : tool === "shell_exec" ? "command" : "path";
     const rawDetail = input?.[key];
     const detail = typeof rawDetail === "string" && rawDetail.trim()
@@ -578,6 +578,8 @@ function formatInteractiveToolResult(tool, content, isError, input) {
         return `${label} failed · ${compactValue(content, 160)}`;
     if (tool === "write_file" && content.startsWith("Wrote "))
         return content;
+    if (tool === "edit_file" && content.startsWith("Edited "))
+        return content;
     if (tool === "list_files")
         return `${label} · ${content ? content.split(/\r?\n/).length : 0} entries`;
     if (tool === "web_search") {

package/docs/sdk.md

@@ -13,7 +13,7 @@ Apollo SDK 用于把 Agent 能力嵌入 Node.js / TypeScript 系统。CLI 只是
 当前使用本地 tarball：
 
 ```bash
-npm install /Users/apollo/Code-YH/web-agent/agent/apolloyh-apollo-agent-0.1.1.tgz
+npm install /Users/apollo/Code-YH/web-agent/agent/apolloyh-apollo-agent-0.1.3.tgz
 ```
 
 发布到 npm 后可改为：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apolloyh/apollo-agent",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "description": "Apollo — your personal agent. Answer first, act when needed. Claude Code–style Task subagents.",
   "bin": {