@apolloyh/apollo-agent 0.1.4 → 0.1.6

package/README.md

@@ -35,9 +35,17 @@ apollo -r <session-id>
 
 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.
-Set `systemPrompt` there to append stable custom system instructions; restart Apollo to reload them.
+Apollo creates global defaults at `~/.apollo/config.json`. Project overrides live at
+`.apollo/config.json`; Apollo also reads the legacy `agent.config.json` during migration.
+Configuration layers as built-in defaults → user config → project config → `--config`.
+Set `systemPrompt` in either config to append stable custom system instructions; restart Apollo to reload them.
+
+Apollo also loads `~/.apollo/APOLLO.md` followed by the project `APOLLO.md` (lowercase
+`apollo.md` is accepted). If no project Apollo file exists, the standard `AGENTS.md` and
+`.apollo/instructions.md` paths remain supported. These instructions are frozen for the session.
+
+While Apollo is working, type and press Enter to queue another user message. Queued messages
+run in FIFO order after the current turn; press Esc to interrupt the current turn safely.
 
 Commands: `/help` · `/skills` · `/agents` · `/sessions` · `/resume` · `/verbose` · `/stream` · `/clear` · `/exit`
 

package/dist/brand.d.ts

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

package/dist/brand.js

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

package/dist/cli-input.d.ts

@@ -0,0 +1,16 @@
+export type PastedTextBlock = {
+    id: number;
+    label: string;
+    marker: string;
+    text: string;
+};
+export type InputView = {
+    cursorLine: number;
+    cursorWidth: number;
+    lines: string[];
+};
+export declare function createPastedTextBlock(text: string, id: number): PastedTextBlock | undefined;
+export declare function resolvePastedText(value: string, blocks: ReadonlyMap<string, PastedTextBlock>): string;
+export declare function pastedTextPreview(value: string, blocks: ReadonlyMap<string, PastedTextBlock>): string;
+export declare function renderInputView(value: string, cursor: number, width: number, blocks: ReadonlyMap<string, PastedTextBlock>): InputView;
+//# sourceMappingURL=cli-input.d.ts.map

package/dist/cli-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-input.d.ts","sourceRoot":"","sources":["../src/cli-input.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAMF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAQ3F;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,MAAM,CAErG;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,MAAM,CAErG;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAC3C,SAAS,CAyCX"}

package/dist/cli-input.js

@@ -0,0 +1,68 @@
+const MIN_FOLDED_PASTE_LINES = 6;
+const MIN_FOLDED_PASTE_CHARS = 1000;
+const FIRST_MARKER = 0xf0000;
+export function createPastedTextBlock(text, id) {
+    const lineCount = text.split("\n").length;
+    if (lineCount < MIN_FOLDED_PASTE_LINES && Array.from(text).length < MIN_FOLDED_PASTE_CHARS) {
+        return undefined;
+    }
+    const marker = String.fromCodePoint(FIRST_MARKER + id);
+    const size = lineCount > 1 ? `+${lineCount} lines` : `+${Array.from(text).length} chars`;
+    return { id, label: `[Pasted text #${id} ${size}]`, marker, text };
+}
+export function resolvePastedText(value, blocks) {
+    return Array.from(value, (character) => blocks.get(character)?.text ?? character).join("");
+}
+export function pastedTextPreview(value, blocks) {
+    return Array.from(value, (character) => blocks.get(character)?.label ?? character).join("");
+}
+export function renderInputView(value, cursor, width, blocks) {
+    const characters = Array.from(value);
+    const positions = [];
+    const lines = [""];
+    let line = 0;
+    let column = 0;
+    const newLine = () => {
+        lines.push("");
+        line += 1;
+        column = 0;
+    };
+    const appendCharacter = (character) => {
+        if (character === "\n") {
+            newLine();
+            return;
+        }
+        const rendered = character === "\t" ? "  " : character;
+        for (const outputCharacter of rendered) {
+            const characterWidth = displayWidth(outputCharacter);
+            if (column > 0 && column + characterWidth > width)
+                newLine();
+            lines[line] += outputCharacter;
+            column += characterWidth;
+        }
+    };
+    characters.forEach((character, index) => {
+        const block = blocks.get(character);
+        if (block && column > 0 && column + displayWidth(block.label) > width)
+            newLine();
+        positions[index] = { line, width: column };
+        for (const outputCharacter of block?.label ?? character)
+            appendCharacter(outputCharacter);
+    });
+    positions[characters.length] = { line, width: column };
+    const cursorPosition = positions[Math.max(0, Math.min(cursor, characters.length))] ?? { line: 0, width: 0 };
+    return {
+        cursorLine: cursorPosition.line,
+        cursorWidth: cursorPosition.width,
+        lines,
+    };
+}
+function displayWidth(text) {
+    let length = 0;
+    for (const character of text)
+        length += isWideCharacter(character) ? 2 : 1;
+    return length;
+}
+function isWideCharacter(character) {
+    return /[\u1100-\u115F\u2E80-\uA4CF\uAC00-\uD7A3\uF900-\uFAFF\uFE10-\uFE19\uFE30-\uFE6F\uFF00-\uFF60\uFFE0-\uFFE6]/u.test(character);
+}

package/dist/config.d.ts

@@ -6,6 +6,10 @@ export declare function ensureUserEnvFile(): {
     path: string;
     created: boolean;
 };
+export declare function ensureUserConfigFile(): {
+    path: string;
+    created: boolean;
+};
 export declare function loadAgentConfig(configPath?: string): Promise<AgentConfig>;
 /**
  * Load an explicit env file, or discover project env then ~/.apollo/.env.

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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;AAoBpH,wBAAgB,iBAAiB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAatE;AAED,wBAAgB,oBAAoB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAazE;AAED,wBAAsB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAkD/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

@@ -57,6 +57,14 @@ ANTHROPIC_AUTH_TOKEN=
 # ANTHROPIC_BASE_URL=https://api.anthropic.com
 # ANTHROPIC_MODEL=claude-haiku-4-5
 `;
+const USER_CONFIG_TEMPLATE = `${JSON.stringify({
+    systemPrompt: "",
+    maxTurns: defaultConfig.maxTurns,
+    context: defaultConfig.context,
+    permissions: defaultConfig.permissions,
+    skills: defaultConfig.skills,
+    mcpServers: defaultConfig.mcpServers,
+}, null, 2)}\n`;
 export function ensureUserEnvFile() {
     const directory = path.join(os.homedir(), ".apollo");
     const envPath = path.join(directory, ".env");
@@ -73,27 +81,69 @@ export function ensureUserEnvFile() {
         throw error;
     }
 }
+export function ensureUserConfigFile() {
+    const directory = path.join(os.homedir(), ".apollo");
+    const configPath = path.join(directory, "config.json");
+    if (fsSync.existsSync(configPath))
+        return { path: configPath, created: false };
+    fsSync.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    try {
+        fsSync.writeFileSync(configPath, USER_CONFIG_TEMPLATE, { encoding: "utf8", flag: "wx", mode: 0o600 });
+        return { path: configPath, created: true };
+    }
+    catch (error) {
+        if (error.code === "EEXIST")
+            return { path: configPath, created: false };
+        throw error;
+    }
+}
 export async function loadAgentConfig(configPath) {
-    const discoveredPath = configPath ?? [DEFAULT_CONFIG_PATH, LEGACY_CONFIG_PATH].find(fsSync.existsSync);
-    if (!discoveredPath) {
-        return { ...defaultConfig, workspaceRoot: path.resolve(defaultConfig.workspaceRoot) };
-    }
-    const raw = await fs.readFile(discoveredPath, "utf8");
-    const parsed = JSON.parse(raw);
-    const resolvedConfigPath = path.resolve(discoveredPath);
-    const configDir = path.dirname(resolvedConfigPath);
-    const baseDir = path.basename(configDir) === ".apollo" ? path.dirname(configDir) : configDir;
-    const agents = normalizeAgents(parsed.agents ?? parsed.workers) ?? defaultConfig.agents;
-    const config = {
+    const userConfigPath = path.join(os.homedir(), ".apollo", "config.json");
+    const projectConfigPath = [DEFAULT_CONFIG_PATH, LEGACY_CONFIG_PATH].find(fsSync.existsSync);
+    const layers = [
+        ...(fsSync.existsSync(userConfigPath) ? [{ file: userConfigPath, projectScoped: false }] : []),
+        ...(projectConfigPath ? [{ file: projectConfigPath, projectScoped: true }] : []),
+        ...(configPath ? [{ file: configPath, projectScoped: true }] : []),
+    ];
+    const seen = new Set();
+    let config = {
         ...defaultConfig,
-        ...parsed,
-        workspaceRoot: path.resolve(baseDir, parsed.workspaceRoot ?? defaultConfig.workspaceRoot),
-        context: { ...defaultConfig.context, ...parsed.context },
-        permissions: { ...defaultConfig.permissions, ...parsed.permissions },
-        skills: { ...defaultConfig.skills, ...parsed.skills },
-        mcpServers: parsed.mcpServers ?? defaultConfig.mcpServers,
-        agents,
+        workspaceRoot: path.resolve(defaultConfig.workspaceRoot),
+        context: { ...defaultConfig.context },
+        permissions: { ...defaultConfig.permissions },
+        skills: { ...defaultConfig.skills },
+        mcpServers: { ...defaultConfig.mcpServers },
+        agents: [...defaultConfig.agents],
     };
+    for (const layer of layers) {
+        const resolvedConfigPath = path.resolve(layer.file);
+        if (seen.has(resolvedConfigPath))
+            continue;
+        seen.add(resolvedConfigPath);
+        const raw = await fs.readFile(resolvedConfigPath, "utf8");
+        const parsed = JSON.parse(raw);
+        const { workers: _workers, ...overrides } = parsed;
+        if (typeof overrides.systemPrompt === "string" && !overrides.systemPrompt.trim())
+            delete overrides.systemPrompt;
+        if (typeof overrides.modeInstructions === "string" && !overrides.modeInstructions.trim())
+            delete overrides.modeInstructions;
+        const configDir = path.dirname(resolvedConfigPath);
+        const baseDir = path.basename(configDir) === ".apollo" ? path.dirname(configDir) : configDir;
+        const agents = normalizeAgents(parsed.agents ?? parsed.workers) ?? config.agents;
+        const workspaceRoot = layer.projectScoped && parsed.workspaceRoot !== undefined
+            ? path.resolve(baseDir, parsed.workspaceRoot)
+            : config.workspaceRoot;
+        config = {
+            ...config,
+            ...overrides,
+            workspaceRoot,
+            context: { ...config.context, ...parsed.context },
+            permissions: { ...config.permissions, ...parsed.permissions },
+            skills: { ...config.skills, ...parsed.skills },
+            mcpServers: { ...config.mcpServers, ...parsed.mcpServers },
+            agents,
+        };
+    }
     validateAgentConfig(config);
     return config;
 }

package/dist/index.js

@@ -3,7 +3,8 @@ 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 { ensureUserEnvFile, loadAgentConfig, loadEnvFile, loadLlmConfig, MISSING_AUTH_TOKEN_MESSAGE, } from "./config.js";
+import { createPastedTextBlock, pastedTextPreview, renderInputView, resolvePastedText, } from "./cli-input.js";
+import { ensureUserEnvFile, ensureUserConfigFile, 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";
@@ -13,7 +14,6 @@ import { ThoughtFoldManager } from "./thought-fold.js";
 import { workflowStatusBar } from "./coordinator/workflow.js";
 import { CliTraceRenderer, stripTerminalEscapes } from "./trace.js";
 let activeCliInput;
-let pinnedCliInput;
 let modalActive = false;
 let resolveModal;
 let modalDone;
@@ -23,6 +23,7 @@ let activeVerb = "Thinking";
 let assistantResponseStarted = false;
 /** Prevent double green/red outcome lines in one user turn */
 let outcomePrintedThisTurn = false;
+let pastedTextSequence = 0;
 const slashCommands = [
     { command: "/help", usage: "/help", description: "Show slash commands" },
     { command: "/skill", usage: "/skill", description: "List installed skills" },
@@ -57,6 +58,7 @@ function filterSlashCommands(buffer) {
 async function main() {
     const args = parseArgs(process.argv.slice(2));
     const userEnv = ensureUserEnvFile();
+    const userConfig = ensureUserConfigFile();
     loadEnvFile(args.envPath);
     const task = args.task ?? (stdin.isTTY ? undefined : (await readStdin()).trim());
     if (!task && !stdin.isTTY) {
@@ -97,6 +99,7 @@ async function main() {
     const rendererSink = renderer.sink();
     const taskActivity = new TaskActivityLog();
     const inputHistory = [];
+    const pendingUserMessages = [];
     // traceSink closes over the runtime, but the runtime is created after this. Hold it in a
     // mutable ref that createRuntime populates, so goal_status events don't hit a TDZ (task mode
     // never reaches the interactive `runtime` binding). Also lets SIGINT close whichever is active.
@@ -239,6 +242,9 @@ async function main() {
     if (userEnv.created) {
         stdout.write(`\nCreated ${shortenHome(userEnv.path)}. Add ANTHROPIC_AUTH_TOKEN there, then restart Apollo.\n`);
     }
+    if (userConfig.created) {
+        stdout.write(`Created ${shortenHome(userConfig.path)} with default settings.\n`);
+    }
     const approvalProvider = createCliApprovalProvider(agentConfig, traceSink, () => yolo, {
         beforePrompt: () => {
             stopLiveStatus("none");
@@ -272,7 +278,7 @@ async function main() {
                 await modalDone;
                 continue;
             }
-            const text = (await readCliLine({ color: traceOptions.color, history: inputHistory })).trim();
+            const text = (pendingUserMessages.shift() ?? await readCliLine({ color: traceOptions.color, history: inputHistory })).trim();
             if (!text)
                 continue;
             if (text === "/exit" || text === "/quit") {
@@ -404,12 +410,12 @@ async function main() {
                 outcomePrintedThisTurn = false;
                 activeVerb = pickSpinnerVerb(goalBody);
                 const firstPrompt = `Start Goal mode.\nGoal: ${goalBody}\nMake the first concrete step. Use tools as needed.\nEnd with GOAL_PROGRESS / GOAL_DONE / GOAL_BLOCKED / GOAL_FAILED.`;
-                startPinnedCliInput(traceOptions.color);
+                const turnInput = startTurnInput(runtime, traceOptions.color, inputHistory, pendingUserMessages);
                 try {
                     await runGoalLoop(runtime, renderer, thoughtFold, traceOptions, firstPrompt);
                 }
                 finally {
-                    stopPinnedCliInput();
+                    await turnInput.stop();
                 }
                 continue;
             }
@@ -529,12 +535,12 @@ async function main() {
                 continue;
             }
             // ── user turn ──────────────────────────────────────────────
-            // Keep an empty input chrome pinned below streaming output while this turn runs.
+            // Keep a live queue input below streaming output while this turn runs.
             runningTaskCount = 0;
             assistantResponseStarted = false;
             outcomePrintedThisTurn = false;
             activeVerb = pickSpinnerVerb(text);
-            startPinnedCliInput(traceOptions.color);
+            const turnInput = startTurnInput(runtime, traceOptions.color, inputHistory, pendingUserMessages);
             try {
                 if (!llmConfig.authToken)
                     throw new Error(MISSING_AUTH_TOKEN_MESSAGE);
@@ -556,7 +562,7 @@ async function main() {
                     writeAboveActiveInput(runtime.renderWorkflowBar(traceOptions.color));
                 }
                 void runtime.saveCurrentSession().catch(() => null);
-                stopPinnedCliInput();
+                await turnInput.stop();
             }
         }
         const sessionId = runtime.getSessionId();
@@ -950,67 +956,42 @@ function writeAboveActiveInput(text) {
         input?.renderAfterExternalOutput();
     }
 }
-function startPinnedCliInput(color) {
-    if (!stdin.isTTY || !stdout.isTTY || modalActive)
-        return;
-    stopPinnedCliInput();
-    let renderedLines = 0;
-    let renderedCursorLine = 0;
-    const clear = () => {
-        if (renderedLines === 0)
-            return;
-        if (renderedCursorLine > 0)
-            stdout.write(`\x1b[${renderedCursorLine}A\r`);
-        else
-            stdout.write("\r");
-        for (let index = 0; index < renderedLines; index += 1) {
-            stdout.write("\x1b[2K");
-            if (index < renderedLines - 1)
-                stdout.write("\x1b[1B\r");
+function startTurnInput(runtime, color, history, pendingMessages) {
+    if (!stdin.isTTY || !stdout.isTTY)
+        return { stop: async () => undefined };
+    let accepting = true;
+    const done = (async () => {
+        while (accepting) {
+            if (modalActive && modalDone) {
+                await modalDone;
+                continue;
+            }
+            const value = await readCliLine({
+                color,
+                history,
+                queueMode: true,
+                onEscape: () => {
+                    const cancelled = runtime.cancelCurrentTurn();
+                    if (cancelled)
+                        accepting = false;
+                    return cancelled;
+                },
+            });
+            const queued = value.trim();
+            if (queued)
+                pendingMessages.push(queued);
+            if (!accepting)
+                break;
         }
-        if (renderedLines > 1)
-            stdout.write(`\x1b[${renderedLines - 1}A\r`);
-        renderedLines = 0;
-        renderedCursorLine = 0;
-    };
-    const render = () => {
-        if (modalActive || activeCliInput !== pinnedCliInput)
-            return;
-        clear();
-        const statusLine = renderLiveStatusLine(color);
-        const lines = [
-            ...(statusLine ? [statusLine] : []),
-            renderInputBorder("top", color),
-            renderInputPrompt(color),
-            renderInputBorder("bottom", color),
-        ];
-        stdout.write(lines.join("\n"));
-        renderedLines = lines.length;
-        renderedCursorLine = statusLine ? 2 : 1;
-        const rowsBelowInput = lines.length - 1 - renderedCursorLine;
-        stdout.write(`\x1b[${rowsBelowInput}A\r\x1b[3G`);
-    };
-    const pinned = {
-        clearForExternalOutput: clear,
-        renderAfterExternalOutput: render,
-        cancelForModal: () => {
-            clear();
-            if (activeCliInput === pinned)
-                activeCliInput = undefined;
+    })();
+    return {
+        stop: async () => {
+            accepting = false;
+            activeCliInput?.cancelForModal();
+            await done;
+            stdout.write("\x1b[?25h");
         },
     };
-    pinnedCliInput = pinned;
-    activeCliInput = pinned;
-    render();
-}
-function stopPinnedCliInput() {
-    const pinned = pinnedCliInput;
-    if (!pinned)
-        return;
-    pinned.clearForExternalOutput();
-    if (activeCliInput === pinned)
-        activeCliInput = undefined;
-    pinnedCliInput = undefined;
 }
 async function readCliLine(options) {
     if (!stdin.isTTY || !stdout.isTTY) {
@@ -1032,6 +1013,7 @@ async function readCliLine(options) {
     let previousRawMode = false;
     let renderedCursorLine = 0;
     let pasteBuffer;
+    const pastedTextBlocks = new Map();
     const pasteStart = "\x1b[200~";
     const pasteEnd = "\x1b[201~";
     const complete = (value) => {
@@ -1041,6 +1023,8 @@ async function readCliLine(options) {
         done = true;
         if (onData)
             stdin.off("data", onData);
+        if (stdin.isTTY)
+            stdout.write("\x1b[?25h");
         if (stdin.isTTY)
             stdout.write("\x1b[?2004l");
         if (stdin.isTTY)
@@ -1055,8 +1039,11 @@ async function readCliLine(options) {
         if (liveStatusLine)
             lines.push(liveStatusLine);
         lines.push(renderInputBorder("top", options.color));
-        const view = inputView(buffer, cursor, Math.max(20, (stdout.columns ?? 100) - 4));
-        lines.push(`${renderInputPrompt(options.color)}${view.text}`);
+        const view = renderInputView(buffer, cursor, inputContentWidth(), pastedTextBlocks);
+        const idleQueue = options.queueMode && !buffer;
+        lines.push(`${renderInputPrompt(options.color)}${idleQueue ? renderTurnInputHint(options.color) : (view.lines[0] ?? "")}`);
+        if (!idleQueue)
+            lines.push(...view.lines.slice(1).map((line) => `  ${line}`));
         if (paletteOpen) {
             const filtered = filterSlashCommands(buffer);
             lines.push(...renderSlashPaletteLines(selected, options.color, filtered, buffer));
@@ -1088,21 +1075,31 @@ async function readCliLine(options) {
         const lines = linesForState();
         stdout.write(lines.join("\n"));
         renderedLines = lines.length;
-        renderedCursorLine = renderLiveStatusLine(options.color) ? 2 : 1;
+        const view = renderInputView(buffer, cursor, inputContentWidth(), pastedTextBlocks);
+        renderedCursorLine = (renderLiveStatusLine(options.color) ? 2 : 1) + view.cursorLine;
         const rowsBelowInput = lines.length - 1 - renderedCursorLine;
-        const view = inputView(buffer, cursor, Math.max(20, (stdout.columns ?? 100) - 4));
         stdout.write(`\x1b[${rowsBelowInput}A\r\x1b[${3 + view.cursorWidth}G`);
+        stdout.write(options.queueMode && !buffer ? "\x1b[?25l" : "\x1b[?25h");
     };
     const finish = (value) => {
         clearRendered();
-        if (value) {
-            if (options.history.at(-1) !== value)
-                options.history.push(value);
+        const resolvedValue = resolvePastedText(value, pastedTextBlocks);
+        if (resolvedValue) {
+            if (options.history.at(-1) !== resolvedValue)
+                options.history.push(resolvedValue);
             if (options.history.length > 100)
                 options.history.splice(0, options.history.length - 100);
-            stdout.write(`${renderInputBorder("top", options.color)}\n${renderInputPrompt(options.color)}${submittedInputLabel(value)}\n${renderInputBorder("bottom", options.color)}\n`);
+            const preview = pastedTextPreview(value, pastedTextBlocks).replace(/\n/g, " ↵ ").replace(/\t/g, "  ");
+            const submitted = preview === value ? submittedInputLabel(resolvedValue) : preview;
+            if (options.queueMode) {
+                const label = options.color ? "\x1b[90m• Queued\x1b[0m" : "• Queued";
+                stdout.write(`${label} ${submitted}\n`);
+            }
+            else {
+                stdout.write(`${renderInputBorder("top", options.color)}\n${renderInputPrompt(options.color)}${submitted}\n${renderInputBorder("bottom", options.color)}\n`);
+            }
         }
-        complete(value);
+        complete(resolvedValue);
     };
     const cancelForModal = () => {
         clearRendered();
@@ -1168,7 +1165,13 @@ async function readCliLine(options) {
                 finish("/exit");
             return;
         }
+        if (chunk === "\x1b" && options.onEscape?.()) {
+            finish("");
+            return;
+        }
         if (chunk === "\r" || chunk === "\n") {
+            if (options.queueMode && !buffer)
+                return;
             finish(buffer);
             return;
         }
@@ -1240,11 +1243,11 @@ async function readCliLine(options) {
                 if (historyIndex === options.history.length)
                     historyDraft = buffer;
                 historyIndex -= 1;
-                buffer = options.history[historyIndex] ?? "";
+                setBuffer(options.history[historyIndex] ?? "");
             }
             else if (chunk === "\x1b[B" && historyIndex < options.history.length) {
                 historyIndex += 1;
-                buffer = historyIndex === options.history.length ? historyDraft : options.history[historyIndex] ?? "";
+                setBuffer(historyIndex === options.history.length ? historyDraft : options.history[historyIndex] ?? "");
             }
             cursor = Array.from(buffer).length;
             closePalette();
@@ -1271,13 +1274,31 @@ async function readCliLine(options) {
         render();
     };
     const insertText = (text) => {
-        const safeText = stripTerminalEscapes(text).replace(/\r\n?/g, "\n");
+        const safeText = stripTerminalEscapes(text)
+            .replace(/\r\n?/g, "\n")
+            .replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/g, "");
         const characters = Array.from(buffer);
-        const inserted = Array.from(safeText);
+        const block = createPastedTextBlock(safeText, pastedTextSequence + 1);
+        if (block) {
+            pastedTextSequence += 1;
+            pastedTextBlocks.set(block.marker, block);
+        }
+        const inserted = block ? [block.marker] : Array.from(safeText);
         characters.splice(cursor, 0, ...inserted);
         buffer = characters.join("");
         cursor += inserted.length;
     };
+    function setBuffer(value) {
+        const block = createPastedTextBlock(value, pastedTextSequence + 1);
+        if (block) {
+            pastedTextSequence += 1;
+            pastedTextBlocks.set(block.marker, block);
+            buffer = block.marker;
+        }
+        else {
+            buffer = value;
+        }
+    }
     const handleData = (chunk) => {
         let rest = chunk;
         while (rest) {
@@ -1340,10 +1361,6 @@ function endModalInput() {
     resolveModal?.();
     resolveModal = undefined;
     modalDone = undefined;
-    if (pinnedCliInput && !activeCliInput) {
-        activeCliInput = pinnedCliInput;
-        pinnedCliInput.renderAfterExternalOutput();
-    }
 }
 async function askPlainQuestion(prompt) {
     const wasRaw = stdin.isTTY ? stdin.isRaw : false;
@@ -1586,6 +1603,10 @@ function compactLine(text, max) {
 function renderInputPrompt(useColor) {
     return useColor ? "\x1b[38;2;96;165;250m›\x1b[0m " : "› ";
 }
+function renderTurnInputHint(useColor) {
+    const hint = "Type to queue a message · Esc to interrupt";
+    return useColor ? `\x1b[90m${hint}\x1b[0m` : hint;
+}
 function renderLiveStatusLine(useColor) {
     if (!liveStatus)
         return undefined;
@@ -1644,30 +1665,8 @@ function truncateDisplay(text, width) {
     }
     return `${result}…`;
 }
-function inputView(value, cursor, width) {
-    const characters = Array.from(value);
-    const normalize = (text) => text.replace(/\n/g, " ↵ ").replace(/\t/g, "  ");
-    const before = normalize(characters.slice(0, cursor).join(""));
-    const after = normalize(characters.slice(cursor).join(""));
-    if (displayLength(before) >= width) {
-        const visible = takeDisplayEnd(before, width - 1);
-        return { text: `…${visible}`, cursorWidth: 1 + displayLength(visible) };
-    }
-    const remaining = Math.max(0, width - displayLength(before));
-    const visibleAfter = remaining > 0 ? truncateDisplay(after, remaining) : "";
-    return { text: `${before}${visibleAfter}`, cursorWidth: displayLength(before) };
-}
-function takeDisplayEnd(text, width) {
-    const result = [];
-    let length = 0;
-    for (const char of Array.from(text).reverse()) {
-        const charWidth = displayLength(char);
-        if (length + charWidth > width)
-            break;
-        result.push(char);
-        length += charWidth;
-    }
-    return result.reverse().join("");
+function inputContentWidth() {
+    return Math.max(20, Math.min(stdout.columns ?? 100, 100) - 4);
 }
 function submittedInputLabel(value) {
     if (!value.includes("\n"))

package/dist/project-instructions.d.ts

@@ -1,8 +1,7 @@
-/** Same spirit as CLAUDE.md / AGENTS.md discovery. */
-export declare const PROJECT_INSTRUCTION_FILES: readonly ["APOLLO.md", "CLAUDE.md", "AGENTS.md", ".apollo/instructions.md", ".claude/CLAUDE.md"];
+export declare const PROJECT_INSTRUCTION_FILES: readonly ["APOLLO.md", "apollo.md", "AGENTS.md", ".apollo/instructions.md"];
 export type ProjectInstructions = {
     path: string;
     content: string;
 };
-export declare function loadProjectInstructions(workspaceRoot: string, maxChars?: number): Promise<ProjectInstructions | null>;
+export declare function loadProjectInstructions(workspaceRoot: string, maxChars?: number, userHome?: string): Promise<ProjectInstructions | null>;
 //# sourceMappingURL=project-instructions.d.ts.map

package/dist/project-instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-instructions.d.ts","sourceRoot":"","sources":["../src/project-instructions.ts"],"names":[],"mappings":"AAOA,sDAAsD;AACtD,eAAO,MAAM,yBAAyB,kGAM5B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,QAAQ,SAAQ,GACf,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAgBrC"}
+{"version":3,"file":"project-instructions.d.ts","sourceRoot":"","sources":["../src/project-instructions.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,yBAAyB,6EAK5B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,QAAQ,SAAQ,EAChB,QAAQ,SAAe,GACtB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAgCrC"}

package/dist/project-instructions.js

@@ -1,18 +1,27 @@
-/**
- * Claude Code–style project instructions.
- * Loads the first matching file from the workspace root (in order).
- */
+/** Apollo project instructions. Loads the first matching workspace file in order. */
 import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
 import { safeRealResolve } from "./utils.js";
-/** Same spirit as CLAUDE.md / AGENTS.md discovery. */
 export const PROJECT_INSTRUCTION_FILES = [
     "APOLLO.md",
-    "CLAUDE.md",
+    "apollo.md",
     "AGENTS.md",
     ".apollo/instructions.md",
-    ".claude/CLAUDE.md",
 ];
-export async function loadProjectInstructions(workspaceRoot, maxChars = 24000) {
+export async function loadProjectInstructions(workspaceRoot, maxChars = 24000, userHome = os.homedir()) {
+    const loaded = [];
+    for (const fileName of ["APOLLO.md", "apollo.md"]) {
+        try {
+            const content = (await fs.readFile(path.join(userHome, ".apollo", fileName), "utf8")).trim();
+            if (content)
+                loaded.push({ path: `~/.apollo/${fileName}`, content });
+            break;
+        }
+        catch {
+            // User-level instructions are optional.
+        }
+    }
     for (const rel of PROJECT_INSTRUCTION_FILES) {
         try {
             const full = await safeRealResolve(workspaceRoot, rel);
@@ -20,14 +29,20 @@ export async function loadProjectInstructions(workspaceRoot, maxChars = 24000) {
             const content = raw.trim();
             if (!content)
                 continue;
-            return {
-                path: rel,
-                content: content.length > maxChars ? `${content.slice(0, maxChars)}\n\n…(truncated)` : content,
-            };
+            loaded.push({ path: rel, content });
+            break;
         }
         catch {
             // try next
         }
     }
-    return null;
+    if (!loaded.length)
+        return null;
+    const combined = loaded
+        .map((instruction) => `## ${instruction.path}\n${instruction.content}`)
+        .join("\n\n");
+    return {
+        path: loaded.map((instruction) => instruction.path).join(" + "),
+        content: combined.length > maxChars ? `${combined.slice(0, maxChars)}\n\n…(truncated)` : combined,
+    };
 }

package/dist/runtime/prompt-builder.d.ts

@@ -3,7 +3,7 @@ type PromptBuilderOptions = {
     agentConfig: AgentConfig;
     tools: AnthropicTool[];
     subagent?: SubagentConfig;
-    /** Claude Code–style project instructions (APOLLO.md / CLAUDE.md / AGENTS.md) */
+    /** Apollo project instructions (APOLLO.md / AGENTS.md). */
     projectInstructions?: {
         path: string;
         content: string;

package/dist/runtime/prompt-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../src/runtime/prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI9E,KAAK,oBAAoB,GAAG;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,iFAAiF;IACjF,mBAAmB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAChE,CAAC;AAEF,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,oBAAoB;IAE1D,KAAK,IAAI,MAAM;IAqBf,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,0BAA0B;IASlC,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,WAAW;CAQpB"}
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../src/runtime/prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI9E,KAAK,oBAAoB,GAAG;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAChE,CAAC;AAEF,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,oBAAoB;IAE1D,KAAK,IAAI,MAAM;IAqBf,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,0BAA0B;IASlC,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,WAAW;CAQpB"}

package/dist/runtime/prompt-builder.js

@@ -55,7 +55,7 @@ ${PRODUCT.tagline}`;
         if (!proj?.content)
             return "";
         return `# Project Instructions
-These instructions come from \`${proj.path}\` in the workspace. Follow them for this project.
+These instructions were loaded from \`${proj.path}\`. Follow them for this project; project-level instructions take precedence over user-level instructions when they conflict.
 
 ${proj.content}`;
     }

package/dist/skills/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/skills/skills.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;gBAE7B,MAAM,EAAE,WAAW;IAEhD,OAAO,CAAC,SAAS;IAMX,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAoBtF,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAY/E,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAaxC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAuCvG,OAAO,CAAC,OAAO;YAKD,WAAW;CAuB1B"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/skills/skills.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;gBAE7B,MAAM,EAAE,WAAW;IAEhD,OAAO,CAAC,SAAS;IAMX,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAoBtF,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAY/E,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAaxC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IA2CvG,OAAO,CAAC,OAAO;YAKD,WAAW;CAuB1B"}

package/dist/skills/skills.js

@@ -1,6 +1,6 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { safeRealResolve, truncate } from "../utils.js";
+import { truncate } from "../utils.js";
 export class SkillManager {
     config;
     catalogCache;
@@ -55,9 +55,13 @@ export class SkillManager {
         return truncate(body, 20000);
     }
     async installLocal(sourcePath, requestedName) {
-        // Confine the source to the workspace (rejects ../ and symlink escapes) so the
-        // install can't copy arbitrary files (e.g. /etc/passwd) into a skill dir that skill_read exposes.
-        const source = await safeRealResolve(this.config.workspaceRoot, sourcePath);
+        // Local skill sources may live outside the active workspace (for example in a
+        // package cache or /tmp). Resolve the selected source canonically, while the
+        // installation target remains confined to the configured skills directory.
+        const requestedSource = path.isAbsolute(sourcePath)
+            ? sourcePath
+            : path.resolve(this.config.workspaceRoot, sourcePath);
+        const source = await fs.realpath(requestedSource);
         const stat = await fs.stat(source);
         const skillFile = stat.isDirectory() ? path.join(source, "SKILL.md") : source;
         if (path.basename(skillFile) !== "SKILL.md") {

package/dist/tools/builtin.js

@@ -331,12 +331,12 @@ export function createBuiltinRegistry(options) {
     });
     registry.register({
         name: "skill_install",
-        description: "Install a local skill into the first configured skills directory. Source must be a SKILL.md file or a directory containing SKILL.md.",
+        description: "Install a local skill into the first configured skills directory. The source may be outside the workspace and must be a SKILL.md file or a directory containing SKILL.md.",
         risk: "high",
         input_schema: {
             type: "object",
             properties: {
-                sourcePath: { type: "string", description: "Path to SKILL.md or a directory containing SKILL.md." },
+                sourcePath: { type: "string", description: "Local path, including outside the workspace, to SKILL.md or a directory containing SKILL.md." },
                 name: { type: "string", description: "Optional installed skill name." },
             },
             required: ["sourcePath"],

package/docs/sdk.md

@@ -89,7 +89,7 @@ const engine = await createQueryEngine({
 
 | 参数 | 类型 | 说明 |
 |---|---|---|
-| `configPath` | `string` | Agent 配置路径；默认发现 `.apollo/config.json`，兼容旧 `agent.config.json` |
+| `configPath` | `string` | Agent 显式配置路径；在用户配置和项目配置之后覆盖，默认还会发现 `~/.apollo/config.json`、`.apollo/config.json`，并兼容旧 `agent.config.json` |
 | `envPath` | `string` | 可选环境变量文件；未提供模型配置时默认发现 `.apollo/.env`，然后 `.env` |
 | `agentConfig` | `AgentConfig` | 直接传入完整 Agent 配置；优先于 `configPath` |
 | `llmConfig` | `LlmConfig` | 直接传入模型配置；优先于环境变量 |
@@ -104,7 +104,7 @@ const engine = await createQueryEngine({
 
 ## 系统提示词与缓存
 
-`.apollo/config.json` 可以配置：
+`~/.apollo/config.json` 和项目的 `.apollo/config.json` 都可以配置：
 
 ```json
 {
@@ -114,6 +114,10 @@ const engine = await createQueryEngine({
 
 Engine 创建时读取配置，首次请求时拼接 System Prompt 和工具定义，随后在该 Engine 生命周期内冻结。修改配置文件不会影响已经存在的 Engine，必须关闭并创建新 Engine。
 
+配置合并顺序为：内置默认值 → 用户配置 → 项目配置 → `configPath`。用户配置中的 `workspaceRoot` 会被忽略，避免全局配置把所有项目锁定到用户目录；工作区路径由项目配置或显式配置决定。
+
+系统提示词还会依次拼接用户级 `~/.apollo/APOLLO.md` 和项目级 `APOLLO.md`（兼容小写 `apollo.md`）。如果项目中没有 Apollo 指令文件，则继续读取通用的 `AGENTS.md` 或 `.apollo/instructions.md`。指令在 Engine 首次请求时冻结。
+
 运行中主要变化的是 `messages`，接近上下文上限时会执行语义压缩；稳定的 `system` 和 `tools` 有利于命中模型厂商的 Prompt Cache。
 
 ## 流式事件

package/package.json

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