@apolloyh/apollo-agent 0.1.0 → 0.1.2

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.2";
     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.2",
     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,CAiCrF"}

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,9 +155,8 @@ 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.");
@@ -148,7 +174,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");
@@ -530,6 +534,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)
@@ -1686,6 +1692,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/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.0.tgz
+npm install /Users/apollo/Code-YH/web-agent/agent/apolloyh-apollo-agent-0.1.2.tgz
 ```
 
 发布到 npm 后可改为：

package/package.json

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