@apolloyh/apollo-agent 0.1.0

package/.apollo/config.example.json

@@ -0,0 +1,37 @@
+{
+  "workspaceRoot": ".",
+  "systemPrompt": "",
+  "maxTurns": 40,
+  "context": {
+    "maxChars": 262144,
+    "summaryChars": 12000
+  },
+  "permissions": {
+    "mode": "ask",
+    "autoApproveReadOnly": true
+  },
+  "skills": {
+    "directories": ["./skills"]
+  },
+  "mcpServers": {},
+  "agents": [
+    {
+      "name": "general-purpose",
+      "description": "Complex multi-step work when the path is unclear: research, investigation, or mixed read/write tasks that need isolation from the main conversation.",
+      "tools": ["*"],
+      "prompt": "You are a general-purpose subagent. Search broadly, investigate thoroughly, and return a concise report with key findings and evidence. Do not address the end user — report back to the main agent."
+    },
+    {
+      "name": "Explore",
+      "description": "Fast read-only exploration: find files, search code, answer where/how questions without making edits.",
+      "tools": ["list_files", "read_file", "git_status", "git_diff", "web_search", "web_fetch", "skill_search", "skill_read"],
+      "prompt": "You are an Explore subagent (read-only). Map the codebase quickly. Prefer list_files / read_file. Do not modify files. Return key paths and findings."
+    },
+    {
+      "name": "Plan",
+      "description": "Design an implementation plan without writing code: steps, critical files, risks, and trade-offs.",
+      "tools": ["list_files", "read_file", "git_status", "git_diff", "web_search", "web_fetch", "skill_search", "skill_read"],
+      "prompt": "You are a Plan subagent. Produce a clear implementation plan, not code changes. Return goal, steps, critical files, risks, and verification."
+    }
+  ]
+}

package/.env.example

@@ -0,0 +1,17 @@
+# Copy to .apollo/.env (preferred) or .env and fill in. Both are gitignored.
+
+ANTHROPIC_AUTH_TOKEN=replace_with_your_token
+ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
+EXA_API_KEY=replace_with_your_exa_key
+
+# Primary model (Apollo reads ANTHROPIC_MODEL first, then HAIKU fallbacks)
+ANTHROPIC_MODEL=glm-5.2
+ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-5.2
+ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME=glm-5.2
+ANTHROPIC_DEFAULT_SONNET_MODEL_NAME=glm-5.2
+
+# Optional
+# ANTHROPIC_MAX_TOKENS=4096
+# ANTHROPIC_TIMEOUT_MS=300000
+# ANTHROPIC_CACHE_TTL=5m
+# AGENT_SENDMAIL_PATH=/usr/sbin/sendmail

package/README.md

@@ -0,0 +1,62 @@
+# Apollo
+
+Your **personal** agent runtime: answer first, act when needed.
+
+Terminal text wordmark (no icon / no triangle):
+
+```
+  █████╗ ██████╗  ██████╗ ██╗     ██╗      ██████╗
+ ██╔══██╗██╔══██╗██╔═══██╗██║     ██║     ██╔═══██╗
+ ███████║██████╔╝██║   ██║██║     ██║     ██║   ██║
+ ██╔══██║██╔═══╝ ██║   ██║██║     ██║     ██║   ██║
+ ██║  ██║██║     ╚██████╔╝███████╗███████╗╚██████╔╝
+ ╚═╝  ╚═╝╚═╝      ╚═════╝ ╚══════╝╚══════╝ ╚═════╝
+```
+
+→ reads as **A P O L L O**. Defined in `src/brand.ts`.
+
+## Features
+
+- Ordinary questions → answer directly, no tools  
+- Complex work → **Task** subagents (`Explore` / `Plan` / `general-purpose`)  
+- Skills / MCP / files / shell / web on demand  
+- Waiting UI: blinking `◆`  
+
+## Run
+
+```bash
+npm install -g @apolloyh/apollo-agent
+apollo
+apollo --yolo  # auto-approve tools
+apollo -c      # continue the latest project session
+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.
+
+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.
+
+Commands: `/help` · `/skills` · `/agents` · `/sessions` · `/resume` · `/verbose` · `/stream` · `/clear` · `/exit`
+
+## SDK
+
+```ts
+import { createQueryEngine } from "@apolloyh/apollo-agent";
+
+const engine = await createQueryEngine({
+  configPath: ".apollo/config.json",
+  assumeYes: true,
+  onEvent(event) { /* stream / task events */ },
+});
+
+try {
+  await engine.submitMessage("your task");
+} finally {
+  await engine.close();
+}
+```
+
+See the [SDK integration guide](docs/sdk.md) and [requirements](docs/requirements.md).

package/dist/brand.d.ts

@@ -0,0 +1,17 @@
+/** Product identity — single source of truth for display strings. */
+export declare const PRODUCT: {
+    readonly name: "Apollo";
+    readonly version: "0.1.0";
+    readonly tagline: "Your personal agent — answer first, act when needed.";
+    readonly packageName: "apollo-agent";
+    readonly userAgent: "ApolloAgent/0.1";
+    readonly prompt: "apollo";
+};
+/**
+ * Terminal text wordmark only.
+ * No triangle / icon mark — just clear block letters: A P O L L O
+ * (ANSI Shadow style, easy to read at a glance)
+ */
+export declare const ASCII_LOGO: readonly string[];
+export declare const ASCII_WORDMARK: readonly string[];
+//# sourceMappingURL=brand.d.ts.map

package/dist/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,eAAO,MAAM,OAAO;;;;;;;CAOV,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAOvC,CAAC;AAEF,eAAO,MAAM,cAAc,mBAAa,CAAC"}

package/dist/brand.js

@@ -0,0 +1,23 @@
+/** Product identity — single source of truth for display strings. */
+export const PRODUCT = {
+    name: "Apollo",
+    version: "0.1.0",
+    tagline: "Your personal agent — answer first, act when needed.",
+    packageName: "apollo-agent",
+    userAgent: "ApolloAgent/0.1",
+    prompt: "apollo",
+};
+/**
+ * Terminal text wordmark only.
+ * No triangle / icon mark — just clear block letters: A P O L L O
+ * (ANSI Shadow style, easy to read at a glance)
+ */
+export const ASCII_LOGO = [
+    "  █████╗ ██████╗  ██████╗ ██╗     ██╗      ██████╗ ",
+    " ██╔══██╗██╔══██╗██╔═══██╗██║     ██║     ██╔═══██╗",
+    " ███████║██████╔╝██║   ██║██║     ██║     ██║   ██║",
+    " ██╔══██║██╔═══╝ ██║   ██║██║     ██║     ██║   ██║",
+    " ██║  ██║██║     ╚██████╔╝███████╗███████╗╚██████╔╝",
+    " ╚═╝  ╚═╝╚═╝      ╚═════╝ ╚══════╝╚══════╝ ╚═════╝ ",
+];
+export const ASCII_WORDMARK = ASCII_LOGO;

package/dist/cli-args.d.ts

@@ -0,0 +1,13 @@
+export type CliArgs = {
+    configPath?: string;
+    envPath?: string;
+    task?: string;
+    continueSession: boolean;
+    resumeSession?: true | string;
+    verbose: boolean;
+    yolo: boolean;
+    stream: boolean;
+    color: boolean;
+};
+export declare function parseArgs(argv: string[], isColorTerminal?: boolean): CliArgs;
+//# sourceMappingURL=cli-args.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,eAAe,UAAwD,GAAG,OAAO,CAgC1H"}

package/dist/cli-args.js

@@ -0,0 +1,50 @@
+export function parseArgs(argv, isColorTerminal = Boolean(process.stdout.isTTY && process.stderr.isTTY)) {
+    const result = {
+        continueSession: false,
+        verbose: false,
+        yolo: false,
+        stream: true,
+        color: isColorTerminal,
+    };
+    const taskParts = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === "--config")
+            result.configPath = requiredValue(argv, ++index, "--config");
+        else if (arg === "--env-file")
+            result.envPath = requiredValue(argv, ++index, "--env-file");
+        else if (arg === "--continue" || arg === "-c")
+            result.continueSession = true;
+        else if (arg === "--resume" || arg === "-r") {
+            const candidate = argv[index + 1];
+            // Session IDs are `s-<base36>-<base36>`; anything else is the task, not an ID.
+            result.resumeSession = /^s-[a-z0-9]+-[a-z0-9]+$/.test(candidate ?? "") ? argv[++index] : true;
+        }
+        else if (arg === "--verbose")
+            result.verbose = true;
+        else if (arg === "--quiet")
+            result.verbose = false;
+        else if (arg === "--yolo")
+            result.yolo = true;
+        else if (arg === "--yes")
+            throw new Error("--yes has been replaced by --yolo");
+        else if (arg === "--no-stream")
+            result.stream = false;
+        else if (arg === "--no-color")
+            result.color = false;
+        else
+            taskParts.push(arg);
+    }
+    if (result.continueSession && result.resumeSession) {
+        throw new Error("--continue and --resume cannot be used together");
+    }
+    if (taskParts.length > 0)
+        result.task = taskParts.join(" ");
+    return result;
+}
+function requiredValue(argv, index, flag) {
+    const value = argv[index];
+    if (!value || value.startsWith("--"))
+        throw new Error(`${flag} requires a value`);
+    return value;
+}

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+import type { AgentConfig, LlmConfig, SubagentConfig } from "./types.js";
+/** Default subagents — Claude Code–style Task roles. */
+export declare const DEFAULT_AGENTS: SubagentConfig[];
+export declare function loadAgentConfig(configPath?: string): Promise<AgentConfig>;
+/**
+ * Load an explicit env file, or discover .apollo/.env then .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;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +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"}

package/dist/config.js

@@ -0,0 +1,190 @@
+import fsSync from "node:fs";
+import fs from "node:fs/promises";
+import path from "node:path";
+/** Default subagents — Claude Code–style Task roles. */
+export const DEFAULT_AGENTS = [
+    {
+        name: "general-purpose",
+        description: "Complex multi-step work when the path is unclear: research, investigation, or mixed read/write tasks that need isolation from the main conversation.",
+        tools: ["*"],
+        prompt: `You are a general-purpose subagent. You receive a self-contained task brief and no prior chat history.
+
+Work thoroughly but stay scoped. Use tools as needed. Return one concise final report with findings, evidence (paths, quotes), and any changes you made. Do not address the end user directly — your output goes back to the main agent.`,
+    },
+    {
+        name: "Explore",
+        description: "Fast read-only exploration: find files, search code, answer “where/how does X work?” without making edits.",
+        tools: ["list_files", "read_file", "git_status", "git_diff", "web_search", "web_fetch", "skill_search", "skill_read"],
+        prompt: `You are an Explore subagent (read-only). Map the codebase or research a question quickly.
+
+Prefer list_files / read_file over shell. Do not modify files, run destructive commands, or commit. Return a short structured report: key paths, what you found, and open questions.`,
+    },
+    {
+        name: "Plan",
+        description: "Design an implementation plan without writing code: steps, critical files, risks, and trade-offs.",
+        tools: ["list_files", "read_file", "git_status", "git_diff", "web_search", "web_fetch", "skill_search", "skill_read"],
+        prompt: `You are a Plan subagent. Produce a clear implementation plan, not code changes.
+
+Read only what you need. Return: goal, approach, ordered steps, critical files, risks, and what to verify. Do not edit files or run write/shell tools.`,
+    },
+];
+const defaultConfig = {
+    workspaceRoot: ".",
+    maxTurns: 20,
+    context: {
+        maxChars: 256 * 1024,
+        summaryChars: 12000,
+    },
+    permissions: {
+        mode: "ask",
+        autoApproveReadOnly: true,
+    },
+    skills: {
+        directories: ["./skills"],
+    },
+    mcpServers: {},
+    agents: DEFAULT_AGENTS,
+};
+const DEFAULT_CONFIG_PATH = ".apollo/config.json";
+const LEGACY_CONFIG_PATH = "agent.config.json";
+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 = {
+        ...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,
+    };
+    validateAgentConfig(config);
+    return config;
+}
+function normalizeAgents(list) {
+    if (!list?.length)
+        return undefined;
+    return list.map((item) => ({
+        name: item.name,
+        description: item.description || item.whenToUse || item.prompt || item.instructions || "",
+        tools: item.tools,
+        prompt: item.prompt ||
+            item.instructions ||
+            `You are the ${item.name} subagent. Complete the assigned task and report back.`,
+    }));
+}
+/**
+ * Load an explicit env file, or discover .apollo/.env then .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);
+    if (!selectedPath)
+        return false;
+    const resolvedPath = path.resolve(selectedPath);
+    if (!fsSync.existsSync(resolvedPath))
+        return false;
+    const override = options.override ?? true;
+    const raw = fsSync.readFileSync(resolvedPath, "utf8");
+    for (const line of raw.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const separatorIndex = trimmed.indexOf("=");
+        if (separatorIndex <= 0)
+            continue;
+        const key = trimmed.slice(0, separatorIndex).trim();
+        const rawValue = trimmed.slice(separatorIndex + 1).trim();
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key))
+            continue;
+        if (!override && process.env[key] !== undefined)
+            continue;
+        process.env[key] = unwrapEnvValue(rawValue);
+    }
+    return true;
+}
+function unwrapEnvValue(value) {
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+export function loadLlmConfig() {
+    const authToken = process.env.ANTHROPIC_AUTH_TOKEN;
+    const baseUrl = process.env.ANTHROPIC_BASE_URL ?? "https://api.anthropic.com";
+    const model = process.env.ANTHROPIC_MODEL ||
+        process.env.ANTHROPIC_DEFAULT_HAIKU_MODEL ||
+        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.");
+    }
+    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 timeoutMs = positiveNumberEnv("ANTHROPIC_TIMEOUT_MS", 300000, true);
+    let parsedBaseUrl;
+    try {
+        parsedBaseUrl = new URL(baseUrl);
+    }
+    catch {
+        throw new Error("ANTHROPIC_BASE_URL must be a valid HTTP or HTTPS URL.");
+    }
+    if (parsedBaseUrl.protocol !== "http:" && parsedBaseUrl.protocol !== "https:") {
+        throw new Error("ANTHROPIC_BASE_URL must be a valid HTTP or HTTPS URL.");
+    }
+    return {
+        authToken,
+        baseUrl,
+        model,
+        maxTokens,
+        timeoutMs,
+        cacheTtl,
+    };
+}
+function positiveNumberEnv(name, fallback, integer) {
+    const raw = process.env[name];
+    // Treat unset or empty ("FOO=" blank line in .env) as "use the default".
+    const value = raw === undefined || raw.trim() === "" ? fallback : Number(raw);
+    if (!Number.isFinite(value) || value <= 0 || (integer && !Number.isInteger(value))) {
+        throw new Error(`${name} must be a positive${integer ? " integer" : " number"}.`);
+    }
+    return value;
+}
+function validateAgentConfig(config) {
+    if (config.systemPrompt !== undefined && typeof config.systemPrompt !== "string") {
+        throw new Error("systemPrompt must be a string.");
+    }
+    if (!Number.isInteger(config.maxTurns) || config.maxTurns <= 0) {
+        throw new Error("maxTurns must be a positive integer.");
+    }
+    if (!Number.isFinite(config.context.maxChars) || config.context.maxChars <= 0) {
+        throw new Error("context.maxChars must be a positive number.");
+    }
+    if (!Number.isFinite(config.context.summaryChars) || config.context.summaryChars <= 0) {
+        throw new Error("context.summaryChars must be a positive number.");
+    }
+    if (!["ask", "readonly", "unrestricted"].includes(config.permissions.mode)) {
+        throw new Error("permissions.mode must be ask, readonly, or unrestricted.");
+    }
+    if (typeof config.permissions.autoApproveReadOnly !== "boolean") {
+        throw new Error("permissions.autoApproveReadOnly must be a boolean.");
+    }
+    if (!Array.isArray(config.skills.directories) || config.skills.directories.some((dir) => typeof dir !== "string" || !dir)) {
+        throw new Error("skills.directories must contain non-empty strings.");
+    }
+}

package/dist/constants/spinner-verbs.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Wait-line verbs — keep them clear. Default is almost always "Thinking".
+ */
+export declare const SPINNER_VERBS: readonly string[];
+/** Short chat / greetings always show Thinking (not random Hashing). */
+export declare function pickSpinnerVerb(userText?: string): string;
+//# sourceMappingURL=spinner-verbs.d.ts.map

package/dist/constants/spinner-verbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-verbs.d.ts","sourceRoot":"","sources":["../../src/constants/spinner-verbs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAQ1C,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAOzD"}

package/dist/constants/spinner-verbs.js

@@ -0,0 +1,21 @@
+/**
+ * Wait-line verbs — keep them clear. Default is almost always "Thinking".
+ */
+export const SPINNER_VERBS = [
+    "Thinking",
+    "Thinking",
+    "Thinking",
+    "Processing",
+    "Working",
+    "Considering",
+    "Composing",
+];
+/** Short chat / greetings always show Thinking (not random Hashing). */
+export function pickSpinnerVerb(userText) {
+    const t = (userText ?? "").trim();
+    if (t.length <= 20 || /^(你好|您好|hello|hi|hey|哈喽|在吗|早上好|晚上好)/i.test(t)) {
+        return "Thinking";
+    }
+    const i = Math.floor(Math.random() * SPINNER_VERBS.length);
+    return SPINNER_VERBS[i] ?? "Thinking";
+}

package/dist/coordinator/workflow.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Lightweight coordinator workflow — research → implement → verify → deliver.
+ * Phases can run serial; research can fan-out parallel Tasks via the main agent.
+ */
+import type { WorkflowPhaseSnapshot } from "../session/store.js";
+export type PhaseName = WorkflowPhaseSnapshot["name"];
+export type WorkflowState = {
+    goal: string;
+    phases: WorkflowPhaseSnapshot[];
+    startedAt: string;
+    maxRetries: number;
+};
+export declare function createWorkflow(goal: string, maxRetries?: number): WorkflowState;
+export declare function workflowStatusBar(wf: WorkflowState, color: boolean): string;
+export declare function setPhaseStatus(wf: WorkflowState, name: PhaseName, status: WorkflowPhaseSnapshot["status"], summary?: string): WorkflowState;
+export declare function currentPhase(wf: WorkflowState): WorkflowPhaseSnapshot | undefined;
+export declare function workflowSystemExtra(wf: WorkflowState): string;
+/** Parse model markers to advance workflow. */
+export declare function applyWorkflowMarkers(wf: WorkflowState, text: string): WorkflowState;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/coordinator/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/coordinator/workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAEtD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG,aAAa,CAY1E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAgC3E;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,EACvC,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,CAcf;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,aAAa,GAAG,qBAAqB,GAAG,SAAS,CAEjF;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,CAqB7D;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAgCnF"}

package/dist/coordinator/workflow.js

@@ -0,0 +1,120 @@
+export function createWorkflow(goal, maxRetries = 2) {
+    return {
+        goal,
+        maxRetries,
+        startedAt: new Date().toISOString(),
+        phases: [
+            { id: "research", name: "research", label: "研究中", status: "pending", retries: 0 },
+            { id: "implement", name: "implement", label: "实现中", status: "pending", retries: 0 },
+            { id: "verify", name: "verify", label: "验证中", status: "pending", retries: 0 },
+            { id: "deliver", name: "deliver", label: "交付中", status: "pending", retries: 0 },
+        ],
+    };
+}
+export function workflowStatusBar(wf, color) {
+    const dim = color ? "\x1b[90m" : "";
+    const reset = color ? "\x1b[0m" : "";
+    const green = color ? "\x1b[32m" : "";
+    const red = color ? "\x1b[31m" : "";
+    const blue = color ? "\x1b[38;2;96;165;250m" : "";
+    const yellow = color ? "\x1b[33m" : "";
+    const parts = wf.phases.map((p) => {
+        let mark = "○";
+        let c = dim;
+        if (p.status === "running") {
+            mark = "◉";
+            c = yellow;
+        }
+        else if (p.status === "completed") {
+            mark = "●";
+            c = green;
+        }
+        else if (p.status === "failed") {
+            mark = "●";
+            c = red;
+        }
+        else if (p.status === "skipped") {
+            mark = "○";
+            c = dim;
+        }
+        else {
+            mark = "○";
+            c = dim;
+        }
+        return `${c}${mark} ${p.label}${reset}`;
+    });
+    const head = color ? `${blue}Workflow${reset}` : "Workflow";
+    return `\n${head}  ${parts.join("  →  ")}\n${dim}goal: ${wf.goal.slice(0, 100)}${reset}\n`;
+}
+export function setPhaseStatus(wf, name, status, summary) {
+    return {
+        ...wf,
+        phases: wf.phases.map((p) => p.name === name
+            ? {
+                ...p,
+                status,
+                summary: summary ?? p.summary,
+                retries: status === "failed" ? p.retries + 1 : p.retries,
+            }
+            : p),
+    };
+}
+export function currentPhase(wf) {
+    return wf.phases.find((p) => p.status === "running") ?? wf.phases.find((p) => p.status === "pending");
+}
+export function workflowSystemExtra(wf) {
+    const lines = wf.phases
+        .map((p) => `- ${p.name} (${p.label}): ${p.status}${p.summary ? ` — ${p.summary}` : ""}`)
+        .join("\n");
+    return `# Coordinator Workflow (ACTIVE)
+You are orchestrating a multi-phase task. Goal: ${wf.goal}
+
+## Phases
+${lines}
+
+## Rules
+1. Work phase-by-phase. Prefer Explore for research, general-purpose for implement, Plan only for planning.
+2. For research: fan out parallel Task(Explore) when independent angles help.
+3. For implement: one focused Task at a time per file area; include file paths and exact changes in briefs.
+4. For verify: spawn a fresh Task — do not rubber-stamp. Run tests/typecheck when possible.
+5. For deliver: summarize results and list artifacts/paths for the user.
+6. On phase failure: retry up to ${wf.maxRetries} times with a corrected brief, then report to the user.
+7. After finishing a phase, say clearly: PHASE_DONE:<name>:<one-line summary>
+8. When all phases complete, say: WORKFLOW_DONE
+
+You may use Task, tools, memory_*, and ask_user_question when blocked.`;
+}
+/** Parse model markers to advance workflow. */
+export function applyWorkflowMarkers(wf, text) {
+    let next = wf;
+    const doneRe = /PHASE_DONE:(\w+):([^\n]+)/g;
+    for (const m of text.matchAll(doneRe)) {
+        const name = m[1];
+        const summary = (m[2] ?? "").trim();
+        if (["research", "implement", "verify", "deliver"].includes(name)) {
+            next = setPhaseStatus(next, name, "completed", summary);
+            // auto-start next pending
+            const order = ["research", "implement", "verify", "deliver"];
+            const idx = order.indexOf(name);
+            const following = order[idx + 1];
+            if (following) {
+                const ph = next.phases.find((p) => p.name === following);
+                if (ph && ph.status === "pending")
+                    next = setPhaseStatus(next, following, "running");
+            }
+        }
+    }
+    if (/WORKFLOW_DONE/.test(text)) {
+        next = {
+            ...next,
+            phases: next.phases.map((p) => p.status === "pending" || p.status === "running" ? { ...p, status: "completed" } : p),
+        };
+    }
+    // ensure first pending becomes running if none running
+    if (!next.phases.some((p) => p.status === "running")) {
+        const first = next.phases.find((p) => p.status === "pending");
+        if (first)
+            next = setPhaseStatus(next, first.name, "running");
+    }
+    return next;
+}

package/dist/goal/goal-mode.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Goal mode — pursue a user goal until done (open-ended autonomous loop).
+ * Differs from fixed 4-phase workflow: steps are free-form; exit via markers or /goal stop.
+ */
+export type GoalStatus = "active" | "completed" | "failed" | "blocked" | "paused";
+export type GoalState = {
+    goal: string;
+    status: GoalStatus;
+    /** Optional success criteria lines */
+    criteria: string[];
+    /** Rolling progress notes */
+    progress: string[];
+    iteration: number;
+    maxIterations: number;
+    startedAt: string;
+    completedAt?: string;
+    lastBlockedReason?: string;
+};
+export declare function createGoal(goal: string, maxIterations?: number, criteria?: string[]): GoalState;
+export declare function goalStatusBar(g: GoalState, color: boolean): string;
+export declare function goalSystemExtra(g: GoalState): string;
+/** Parse model markers and update goal state. */
+export declare function applyGoalMarkers(g: GoalState, text: string): GoalState;
+export declare function shouldAutoContinue(g: GoalState): boolean;
+export declare function nextGoalContinuePrompt(g: GoalState): string;
+//# sourceMappingURL=goal-mode.d.ts.map

package/dist/goal/goal-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-mode.d.ts","sourceRoot":"","sources":["../../src/goal/goal-mode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,SAAK,EAAE,QAAQ,GAAE,MAAM,EAAO,GAAG,SAAS,CAU/F;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAsClE;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CA2CpD;AAED,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAiCtE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAExD;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAO3D"}