@apolloyh/apollo-agent 0.1.6 → 0.1.7

package/.apollo/config.example.json

@@ -1,6 +1,7 @@
 {
   "workspaceRoot": ".",
   "systemPrompt": "",
+  "modeInstructions": "",
   "maxTurns": 40,
   "context": {
     "maxChars": 262144,

package/README.md

@@ -35,7 +35,8 @@ apollo -r <session-id>
 
 Apollo loads project `.apollo/.env`, project `.env`, then user-level `~/.apollo/.env`; use `--env-file <path>` to override discovery.
 
-Apollo creates global defaults at `~/.apollo/config.json`. Project overrides live at
+Apollo creates global defaults at `~/.apollo/config.json` and copies the complete option
+reference to `~/.apollo/config.example.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.

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.6";
+    readonly version: "0.1.7";
     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.6",
+    version: "0.1.7",
     tagline: "Your personal agent — answer first, act when needed.",
     packageName: "@apolloyh/apollo-agent",
     userAgent: "ApolloAgent/0.1",

package/dist/config.d.ts

@@ -10,6 +10,10 @@ export declare function ensureUserConfigFile(): {
     path: string;
     created: boolean;
 };
+export declare function ensureUserConfigExampleFile(): {
+    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;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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,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;AAwBpH,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,wBAAgB,2BAA2B,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAchF;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

@@ -2,6 +2,7 @@ import fsSync from "node:fs";
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 /** Default subagents — Claude Code–style Task roles. */
 export const DEFAULT_AGENTS = [
     {
@@ -65,6 +66,7 @@ const USER_CONFIG_TEMPLATE = `${JSON.stringify({
     skills: defaultConfig.skills,
     mcpServers: defaultConfig.mcpServers,
 }, null, 2)}\n`;
+const BUNDLED_CONFIG_EXAMPLE_PATH = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.apollo/config.example.json");
 export function ensureUserEnvFile() {
     const directory = path.join(os.homedir(), ".apollo");
     const envPath = path.join(directory, ".env");
@@ -97,6 +99,23 @@ export function ensureUserConfigFile() {
         throw error;
     }
 }
+export function ensureUserConfigExampleFile() {
+    const directory = path.join(os.homedir(), ".apollo");
+    const examplePath = path.join(directory, "config.example.json");
+    if (fsSync.existsSync(examplePath))
+        return { path: examplePath, created: false };
+    const template = fsSync.readFileSync(BUNDLED_CONFIG_EXAMPLE_PATH, "utf8");
+    fsSync.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    try {
+        fsSync.writeFileSync(examplePath, template, { encoding: "utf8", flag: "wx", mode: 0o600 });
+        return { path: examplePath, created: true };
+    }
+    catch (error) {
+        if (error.code === "EEXIST")
+            return { path: examplePath, created: false };
+        throw error;
+    }
+}
 export async function loadAgentConfig(configPath) {
     const userConfigPath = path.join(os.homedir(), ".apollo", "config.json");
     const projectConfigPath = [DEFAULT_CONFIG_PATH, LEGACY_CONFIG_PATH].find(fsSync.existsSync);

package/dist/index.js

@@ -4,7 +4,7 @@ import readline from "node:readline/promises";
 import { ASCII_LOGO, PRODUCT } from "./brand.js";
 import { parseArgs } from "./cli-args.js";
 import { createPastedTextBlock, pastedTextPreview, renderInputView, resolvePastedText, } from "./cli-input.js";
-import { ensureUserEnvFile, ensureUserConfigFile, loadAgentConfig, loadEnvFile, loadLlmConfig, MISSING_AUTH_TOKEN_MESSAGE, } from "./config.js";
+import { ensureUserEnvFile, ensureUserConfigExampleFile, 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";
@@ -59,6 +59,7 @@ async function main() {
     const args = parseArgs(process.argv.slice(2));
     const userEnv = ensureUserEnvFile();
     const userConfig = ensureUserConfigFile();
+    const userConfigExample = ensureUserConfigExampleFile();
     loadEnvFile(args.envPath);
     const task = args.task ?? (stdin.isTTY ? undefined : (await readStdin()).trim());
     if (!task && !stdin.isTTY) {
@@ -245,6 +246,9 @@ async function main() {
     if (userConfig.created) {
         stdout.write(`Created ${shortenHome(userConfig.path)} with default settings.\n`);
     }
+    if (userConfigExample.created) {
+        stdout.write(`Created ${shortenHome(userConfigExample.path)} with all configuration options.\n`);
+    }
     const approvalProvider = createCliApprovalProvider(agentConfig, traceSink, () => yolo, {
         beforePrompt: () => {
             stopLiveStatus("none");

package/package.json

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