@apolloyh/apollo-agent 0.1.11 → 0.2.1

package/dist/tools/builtin.js

@@ -160,7 +160,7 @@ export function createBuiltinRegistry(options) {
             const command = requiredString(input, "command");
             const timeout = numberInput(input, "timeoutMs", 30000);
             try {
-                const { stdout, stderr } = await execFileAsync("zsh", ["-lc", command], {
+                const { stdout, stderr } = await execFileAsync(process.env.SHELL || "/bin/sh", ["-lc", command], {
                     cwd: config.workspaceRoot,
                     timeout,
                     maxBuffer: 1024 * 1024 * 4,

package/dist/tools/registry.d.ts

@@ -9,6 +9,7 @@ export declare class ToolRegistry {
     setPlanMode(active: boolean): void;
     register(tool: ToolDefinition): void;
     has(name: string): boolean;
+    remove(name: string): void;
     pick(names: string[]): ToolRegistry;
     definitions(): AnthropicTool[];
     riskOf(name: string): import("../types.js").ToolRisk | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAS;IAEzB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI;IAI7C,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIlC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAKpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY;IAWnC,WAAW,IAAI,aAAa,EAAE;IAQ9B,MAAM,CAAC,IAAI,EAAE,MAAM;IAIb,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CA+CnG"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAS;IAEzB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI;IAI7C,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIlC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAKpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY;IAWnC,WAAW,IAAI,aAAa,EAAE;IAQ9B,MAAM,CAAC,IAAI,EAAE,MAAM;IAIb,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CA+CnG"}

package/dist/tools/registry.js

@@ -18,6 +18,9 @@ export class ToolRegistry {
     has(name) {
         return this.tools.has(name);
     }
+    remove(name) {
+        this.tools.delete(name);
+    }
     pick(names) {
         const next = new ToolRegistry();
         next.hooks = this.hooks;

package/dist/trace.d.ts

@@ -1,4 +1,6 @@
 import type { TraceEvent, TraceSink } from "./types.js";
+import { APOLLO_BRAND_PALETTE } from "./terminal-theme.js";
+export { APOLLO_BRAND_PALETTE as APOLLO_STANDARD_PALETTE };
 export type CliTraceOptions = {
     verbose: boolean;
     stream: boolean;

package/dist/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAiBxD,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,qBAAa,gBAAgB;IAiBf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhBpC,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,mBAAmB,CAAM;IACjC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAoE;gBAE1D,OAAO,EAAE,eAAe;IAErD,IAAI,IAAI,SAAS;IAIjB,SAAS,IAAI,IAAI;IAajB,UAAU,IAAI,IAAI;IAelB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IA6H/B,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,UAAU;IAUlB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAsBtB,yEAAyE;IACzE,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,gBAAgB;IAwCxB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,GAAG;CAKZ;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAOxD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAO9D;AA4ED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAY1D"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EACL,oBAAoB,EAKrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,oBAAoB,IAAI,uBAAuB,EAAE,CAAC;AAiB3D,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,qBAAa,gBAAgB;IAiBf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhBpC,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,mBAAmB,CAAM;IACjC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAoE;gBAE1D,OAAO,EAAE,eAAe;IAErD,IAAI,IAAI,SAAS;IAIjB,SAAS,IAAI,IAAI;IAajB,UAAU,IAAI,IAAI;IAelB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IA6H/B,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,UAAU;IAUlB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAsBtB,yEAAyE;IACzE,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,gBAAgB;IAyCxB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,GAAG;CAKZ;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAOxD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAO9D;AAgGD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAY1D"}

package/dist/trace.js

@@ -1,17 +1,22 @@
 import { stderr } from "node:process";
+import { extname } from "node:path";
+import { highlight, supportsLanguage } from "cli-highlight";
 import { formatWaitLine } from "./status-ui.js";
+import { APOLLO_BRAND_PALETTE, TERMINAL_ANSI, TERMINAL_DARK_RGB, terminalBackground, terminalForeground, } from "./terminal-theme.js";
+export { APOLLO_BRAND_PALETTE as APOLLO_STANDARD_PALETTE };
 const color = {
     reset: "\x1b[0m",
     normal: "",
     dim: "\x1b[2m",
     bold: "\x1b[1m",
-    cyan: "\x1b[36m",
-    blue: "\x1b[38;2;96;165;250m",
-    green: "\x1b[32m",
-    yellow: "\x1b[33m",
-    red: "\x1b[31m",
+    cyan: terminalForeground(TERMINAL_DARK_RGB.storage),
+    blue: TERMINAL_ANSI.permission,
+    green: TERMINAL_ANSI.success,
+    yellow: TERMINAL_ANSI.warning,
+    red: TERMINAL_ANSI.error,
     magenta: "\x1b[35m",
     gray: "\x1b[90m",
+    output: TERMINAL_ANSI.inactive,
 };
 export class CliTraceRenderer {
     options;
@@ -224,7 +229,7 @@ export class CliTraceRenderer {
         const elapsed = startedAt ? ` ${this.elapsedSince(startedAt)}` : "";
         this.bullet(`${formatCompletedStatusText(label)}${elapsed}`, colorName);
         if (detail)
-            this.subBullet(detail, "gray");
+            this.subBullet(detail, "output");
     }
     /** Non-interactive: Claude Code–style morphing glyph + shimmer label. */
     renderStatus() {
@@ -272,10 +277,10 @@ export class CliTraceRenderer {
         const removed = `${change.removed} ${change.removed === 1 ? "line" : "lines"}`;
         const summary = change.kind === "create" ? `Added ${added}` : `Added ${added}, removed ${removed}`;
         this.out(`${this.paint("●", "green")} ${this.paint(`${action}(${path})`, "bold")}\n`);
-        this.out(`  ${this.paint("└", "gray")} ${this.paint(summary, "gray")}\n`);
+        this.out(`  ${this.paint("└", "blue")} ${this.paint(summary, "output")}\n`);
         this.renderCodeChange(change);
         if (change.omitted > 0) {
-            this.out(`  ${this.paint("└", "gray")} ${this.paint(`… +${change.omitted} lines`, "gray")}\n`);
+            this.out(`  ${this.paint("└", "blue")} ${this.paint(`… +${change.omitted} lines`, "output")}\n`);
         }
     }
     renderInteractiveToolResult(event, denied) {
@@ -284,11 +289,12 @@ export class CliTraceRenderer {
             return;
         const lines = toolOutputLines(event.tool, event.content);
         for (const [index, line] of lines.entries()) {
-            this.out(`  ${this.paint(index === 0 ? "└" : " ", "gray")} ${this.paint(truncateDisplayLine(line, 140), "gray")}\n`);
+            this.out(`  ${this.paint(index === 0 ? "└" : " ", "blue")} ${this.paint(truncateDisplayLine(line, 140), "output")}\n`);
         }
     }
     renderCodeChange(change) {
         const width = Math.max(40, Math.min(this.options.stdout?.columns ?? 120, 160));
+        const language = extname(change.path).slice(1);
         let oldLine = 1;
         let newLine = 1;
         for (const rawLine of change.lines) {
@@ -326,7 +332,7 @@ export class CliTraceRenderer {
                 oldLine += 1;
                 newLine += 1;
             }
-            this.out(`${renderCodeLine(number, marker, content, style, width, this.options.color)}\n`);
+            this.out(`${renderCodeLine(number, marker, content, style, width, this.options.color, language)}\n`);
         }
     }
     paint(text, colorName) {
@@ -450,35 +456,55 @@ function truncateDisplayLine(value, max) {
     const characters = Array.from(value.replace(/\t/g, "  "));
     return characters.length <= max ? characters.join("") : `${characters.slice(0, max - 1).join("")}…`;
 }
-function renderCodeLine(lineNumber, marker, value, style, width, useColor) {
+function renderCodeLine(lineNumber, marker, value, style, width, useColor, language) {
     const prefix = `  ${String(lineNumber).padStart(5)} ${marker}  `;
     const content = truncateDisplayLine(value, Math.max(10, width - displayCells(prefix)));
     const padding = " ".repeat(Math.max(0, width - displayCells(prefix) - displayCells(content)));
     if (!useColor)
         return `${prefix}${content}${padding}`;
     const background = style === "add"
-        ? "\x1b[48;2;0;55;18m"
+        ? terminalBackground(TERMINAL_DARK_RGB.diffAdded)
         : style === "remove"
-            ? "\x1b[48;2;75;8;14m"
+            ? terminalBackground(TERMINAL_DARK_RGB.diffRemoved)
             : "";
     const gutter = style === "add"
-        ? "\x1b[38;2;74;222;128m"
+        ? TERMINAL_ANSI.success
         : style === "remove"
-            ? "\x1b[38;2;248;113;113m"
-            : "\x1b[38;2;115;115;125m";
-    return `${background}${gutter}${prefix}${highlightCode(content)}${padding}\x1b[0m`;
+            ? TERMINAL_ANSI.error
+            : TERMINAL_ANSI.inactive;
+    return `${background}${gutter}${prefix}${highlightCode(content, language)}${padding}\x1b[0m`;
 }
-function highlightCode(value) {
-    const normal = "\x1b[38;2;235;235;240m";
-    return `${normal}${value.replace(/(\/\/.*$|\/\*.*?\*\/|"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|`(?:\\.|[^`\\])*`|\b(?:const|let|var|new|if|else|for|while|return|async|await|function|class|interface|type|import|export|from|extends|throw|try|catch|finally)\b|\b(?:true|false|null|undefined)\b|\b\d+(?:\.\d+)?\b)/g, (token) => {
-        if (token.startsWith("//") || token.startsWith("/*"))
-            return `\x1b[38;2;130;130;120m${token}${normal}`;
-        if (/^["'`]/.test(token))
-            return `\x1b[38;2;250;204;92m${token}${normal}`;
-        if (/^(?:true|false|null|undefined|\d)/.test(token))
-            return `\x1b[38;2;189;147;249m${token}${normal}`;
-        return `\x1b[38;2;255;80;155m${token}${normal}`;
-    })}`;
+const STORAGE_KEYWORDS = new Set(["const", "let", "var", "function", "class", "type", "interface", "enum", "namespace", "module", "def"]);
+const syntax = (rgb) => (value) => `${terminalForeground(rgb)}${value}\x1b[39m`;
+const syntaxTheme = {
+    default: syntax(TERMINAL_DARK_RGB.text),
+    keyword: (value) => syntax(STORAGE_KEYWORDS.has(value.trim()) ? TERMINAL_DARK_RGB.storage : TERMINAL_DARK_RGB.keyword)(value),
+    built_in: syntax(TERMINAL_DARK_RGB.syntaxGreen),
+    type: syntax(TERMINAL_DARK_RGB.syntaxGreen),
+    literal: syntax(TERMINAL_DARK_RGB.literal),
+    number: syntax(TERMINAL_DARK_RGB.literal),
+    string: syntax(TERMINAL_DARK_RGB.string),
+    regexp: syntax(TERMINAL_DARK_RGB.string),
+    title: syntax(TERMINAL_DARK_RGB.syntaxGreen),
+    function: syntax(TERMINAL_DARK_RGB.syntaxGreen),
+    params: syntax(TERMINAL_DARK_RGB.params),
+    comment: syntax(TERMINAL_DARK_RGB.comment),
+    doctag: syntax(TERMINAL_DARK_RGB.comment),
+    meta: syntax(TERMINAL_DARK_RGB.comment),
+    name: syntax(TERMINAL_DARK_RGB.syntaxGreen),
+    attr: syntax(TERMINAL_DARK_RGB.syntaxGreen),
+    attribute: syntax(TERMINAL_DARK_RGB.syntaxGreen),
+    symbol: syntax(TERMINAL_DARK_RGB.literal),
+};
+function highlightCode(value, language) {
+    if (!language || !supportsLanguage(language))
+        return `${TERMINAL_ANSI.text}${value}`;
+    try {
+        return highlight(value, { language, ignoreIllegals: true, theme: syntaxTheme });
+    }
+    catch {
+        return `${TERMINAL_ANSI.text}${value}`;
+    }
 }
 function displayCells(value) {
     let width = 0;
@@ -512,8 +538,8 @@ export function stripTerminalEscapes(value) {
 }
 function renderInlineMarkdown(value, useColor) {
     let rendered = stripTerminalEscapes(value);
-    rendered = rendered.replace(/\[([^\]]+)]\((https?:\/\/[^)]+)\)/g, (_match, label, url) => useColor ? `\x1b[4;38;2;96;165;250m${label}\x1b[0m \x1b[90m(${url})\x1b[0m` : `${label} (${url})`);
-    rendered = rendered.replace(/`([^`]+)`/g, (_match, codeText) => useColor ? `\x1b[48;5;236m\x1b[38;2;125;211;252m ${codeText} \x1b[0m` : codeText);
+    rendered = rendered.replace(/\[([^\]]+)]\((https?:\/\/[^)]+)\)/g, (_match, label, url) => useColor ? `\x1b[4m${TERMINAL_ANSI.permission}${label}\x1b[0m ${TERMINAL_ANSI.inactive}(${url})\x1b[0m` : `${label} (${url})`);
+    rendered = rendered.replace(/`([^`]+)`/g, (_match, codeText) => useColor ? `\x1b[48;5;236m${TERMINAL_ANSI.permission} ${codeText} \x1b[0m` : codeText);
     rendered = rendered.replace(/\*\*([^*]+)\*\*/g, (_match, boldText) => useColor ? `\x1b[1m${boldText}\x1b[0m` : boldText);
     rendered = rendered.replace(/__([^_]+)__/g, (_match, boldText) => useColor ? `\x1b[1m${boldText}\x1b[0m` : boldText);
     rendered = rendered.replace(/(^|[^*])\*([^*\n]+)\*(?!\*)/g, (_match, prefix, italicText) => useColor ? `${prefix}\x1b[3m${italicText}\x1b[0m` : `${prefix}${italicText}`);

package/dist/types.d.ts

@@ -35,6 +35,12 @@ export type ToolResult = {
     content: string;
     isError?: boolean;
     fileChange?: FileChangeDisplay;
+    artifacts?: ToolArtifact[];
+};
+export type ToolArtifact = {
+    path: string;
+    title?: string;
+    size?: number;
 };
 export type FileChangeDisplay = {
     path: string;
@@ -83,6 +89,7 @@ export type TraceEvent = {
     isError?: boolean;
     content: string;
     fileChange?: FileChangeDisplay;
+    artifacts?: ToolArtifact[];
 } | {
     type: "approval_required";
     tool: string;
@@ -168,12 +175,14 @@ export type ToolExecutionContext = {
     planMode?: boolean;
 };
 export type LlmConfig = {
+    protocol?: "anthropic" | "openai";
     authToken: string;
     baseUrl: string;
     model: string;
     maxTokens: number;
     timeoutMs?: number;
     cacheTtl?: "5m" | "1h";
+    openaiMaxTokensParam?: "max_tokens" | "max_completion_tokens";
 };
 export type McpServerConfig = {
     command: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtF,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,UAAU,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAChF,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,GAAG,YAAY,GAAG,kBAAkB,GAAG,UAAU,CAAC;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,iBAAiB,CAAA;CAAE,GAC7H;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClF,GACD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEN,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE9E,MAAM,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAElF,MAAM,MAAM,oBAAoB,GAAG;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,WAAW,EAAE;QACX,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,cAAc,CAAC;QAC1C,mBAAmB,EAAE,OAAO,CAAC;KAC9B,CAAC;IACF,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/docs/guide.md

@@ -43,7 +43,18 @@ EXA_API_KEY=your_exa_key
 # ANTHROPIC_CACHE_TTL=5m
 ```
 
-Apollo 使用 Anthropic Messages API 兼容接口。GLM/BigModel 在未显式配置时默认使用 131072 的输出上限；其他提供商默认 4096。显式设置 `ANTHROPIC_MAX_TOKENS` 始终优先。
+Apollo 默认使用 Anthropic Messages API，也支持 OpenAI-compatible Chat Completions。切换为 OpenAI 协议：
+
+```dotenv
+APOLLO_LLM_PROTOCOL=openai
+OPENAI_API_KEY=your_openai_token
+OPENAI_BASE_URL=https://api.openai.com/v1
+OPENAI_MODEL=gpt-4o-mini
+# OPENAI_MAX_TOKENS=4096
+# OPENAI_MAX_TOKENS_PARAM=max_tokens
+```
+
+OpenAI 兼容层支持流式文本、公开的 reasoning/thinking 字段、并行工具调用、工具结果回传、usage/cache token 和标准重试错误。模型供应商不返回 reasoning 正文时，Apollo 无法展示该内容。
 
 环境文件发现顺序：
 
@@ -243,7 +254,7 @@ Apollo 不伪造本地 Prompt Cache 命中；`/status` 只使用模型厂商响
 
 ## 故障排查
 
-- `Missing ANTHROPIC_AUTH_TOKEN`：编辑 `~/.apollo/.env` 后重启。
+- `Missing model API token`：配置 `ANTHROPIC_AUTH_TOKEN` 或 `OPENAI_API_KEY` 后重启。
 - `EEXIST .../bin/apollo`：先确认 `which apollo`；移除旧的手动软链接或旧全局包后重装。
 - 搜索不可用：检查 `EXA_API_KEY`，普通文件和代码搜索不依赖 Exa。
 - 修改配置没有生效：重启 Apollo；配置和提示词在当前 Engine 中冻结。

package/docs/sdk.md

@@ -82,6 +82,8 @@ const engine = await createQueryEngine({
 | 参数 | 类型 | 说明 |
 |---|---|---|
 | `configPath` | `string` | Agent 显式配置路径；在用户配置和项目配置之后覆盖，默认还会发现 `~/.apollo/config.json`、`.apollo/config.json`，并兼容旧 `agent.config.json` |
+| `configMode` | `"layered" \| "isolated"` | `isolated` 只读取显式 `configPath`，适合 Web 服务；默认保持 CLI 分层发现 |
+| `workspaceRoot` | `string` | 覆盖会话、记忆和工具使用的工作目录，不改变配置文件来源 |
 | `envPath` | `string` | 可选环境变量文件；未提供模型配置时默认发现 `.apollo/.env`，然后 `.env` |
 | `agentConfig` | `AgentConfig` | 直接传入完整 Agent 配置；优先于 `configPath` |
 | `llmConfig` | `LlmConfig` | 直接传入模型配置；优先于环境变量 |
@@ -91,9 +93,13 @@ const engine = await createQueryEngine({
 | `assumeYes` | `boolean \| (() => boolean)` | 使用默认审批器时自动批准；服务端不建议启用 |
 | `stream` | `boolean \| (() => boolean)` | 是否使用模型流式响应，默认开启 |
 | `sessionId` | `string` | 创建后立即恢复指定会话 |
+| `extraTools` | `ToolDefinition[]` | 向当前 Engine 注册宿主应用专用工具；工具名不能与已有工具重复 |
+| `memoryEnabled` | `boolean` | 设为 `false` 时禁用记忆检索、保存、列表工具和自动记忆注入；默认开启 |
 
 如果同时传入 `agentConfig` 和 `configPath`，使用 `agentConfig`；如果同时传入 `llmConfig` 和环境变量，使用 `llmConfig`。
 
+`LlmConfig.protocol` 可设为 `anthropic` 或 `openai`。OpenAI 协议使用 `/v1/chat/completions`，并将响应归一为 Apollo 内部的 text、thinking、tool_use 和 usage 事件。
+
 ## 系统提示词与缓存
 
 `~/.apollo/config.json` 和项目的 `.apollo/config.json` 都可以配置：
@@ -150,6 +156,48 @@ const engine = await createQueryEngine({
 `onEvent` 可能包含工具参数或结果。转发到日志和前端前，应按宿主系统的数据策略脱敏。
 成功的 `write_file` 事件还会携带 `fileChange`，用于渲染新文件预览或彩色 diff；该字段不会发送给模型。
 
+## 宿主工具与文件产物
+
+Web 服务可以使用 `extraTools` 注册只属于当前入口的业务工具。工具返回的 `content` 会交给模型继续处理；`artifacts` 只随 `tool_result` 事件上报给宿主 UI，用于可靠展示和下载文件。
+
+```ts
+import { createQueryEngine, type ToolDefinition } from "@apolloyh/apollo-agent";
+
+const generateReport: ToolDefinition = {
+  name: "generate_report",
+  description: "生成业务报告并保存到当前工作区。",
+  risk: "high",
+  input_schema: {
+    type: "object",
+    properties: { topic: { type: "string" } },
+    required: ["topic"],
+  },
+  async execute(input, context) {
+    const relativePath = "artifacts/report.docx";
+    await generateDocx(context.workspaceRoot, relativePath, String(input.topic));
+    return {
+      content: `报告已生成：${relativePath}`,
+      artifacts: [{ path: relativePath, title: "业务报告.docx" }],
+    };
+  },
+};
+
+const engine = await createQueryEngine({
+  configPath: ".apollo/web-entry.json",
+  configMode: "isolated",
+  workspaceRoot: tenant.workspaceRoot,
+  extraTools: [generateReport],
+  memoryEnabled: false,
+  onEvent(event) {
+    if (event.type === "tool_result" && event.artifacts?.length) {
+      ui.showFiles(event.artifacts);
+    }
+  },
+});
+```
+
+`ToolArtifact.path` 应指向 `workspaceRoot` 内的真实文件。SDK 只传递元数据，不负责提供 HTTP 下载地址；宿主服务必须自行验证真实路径、文件类型、大小和用户权限，禁止直接信任模型给出的路径。
+
 ## 权限审批
 
 自定义 `approvalProvider` 会接收每次工具调用。宿主系统应根据用户、工作区、工具和风险等级决定是否允许。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apolloyh/apollo-agent",
-  "version": "0.1.11",
+  "version": "0.2.1",
   "type": "module",
   "description": "Apollo — your personal agent. Answer first, act when needed, with tools, skills, and isolated Task subagents.",
   "bin": {
@@ -44,6 +44,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "cli-highlight": "^2.1.11",
     "diff": "^9.0.0"
   },
   "devDependencies": {