c0de-agent 0.0.0 → 1.0.0

package/dist/core/agents/discovery.js

@@ -0,0 +1,96 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+/** 默认 agent markdown 目录（相对项目根）。 */
+const AGENTS_DIR = '.c0de/agents';
+/** 解析简单 YAML 行（key: value 或 key: [a, b]）。不处理嵌套。 */
+function parseFrontmatterLine(line) {
+    const idx = line.indexOf(':');
+    if (idx === -1)
+        return null;
+    const key = line.slice(0, idx).trim();
+    let value = line.slice(idx + 1).trim();
+    // 数组：[a, b, c]
+    if (typeof value === 'string' && value.startsWith('[') && value.endsWith(']')) {
+        value = value
+            .slice(1, -1)
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean);
+    }
+    else if (value === 'true') {
+        value = true;
+    }
+    else if (value === 'false') {
+        value = false;
+    }
+    else {
+        // 尝试数字
+        const num = Number(value);
+        if (!Number.isNaN(num) && value !== '')
+            value = num;
+    }
+    return [key, value];
+}
+/** 解析单个 markdown 文件为 AgentDefinition。无 frontmatter 返回 null。 */
+async function loadAgentFile(filePath, source) {
+    let content;
+    try {
+        content = await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    // frontmatter 必须以 --- 开头
+    if (!content.startsWith('---'))
+        return null;
+    const endIdx = content.indexOf('\n---', 3);
+    if (endIdx === -1)
+        return null;
+    const fmRaw = content.slice(3, endIdx);
+    const body = content.slice(endIdx + 4).trim(); // 跳过 \n---
+    const fm = {};
+    for (const line of fmRaw.split('\n')) {
+        const parsed = parseFrontmatterLine(line);
+        if (parsed)
+            fm[parsed[0]] = parsed[1];
+    }
+    const name = fm.name ?? basename(filePath, '.md');
+    const description = fm.description ?? '';
+    const mode = fm.mode ?? 'subagent';
+    return {
+        name,
+        description,
+        systemPrompt: body,
+        ...(fm.tools ? { tools: fm.tools } : {}),
+        ...(fm.model ? { model: fm.model } : {}),
+        mode,
+        ...(fm.isolated !== undefined ? { isolated: fm.isolated } : {}),
+        ...(fm.maxRecursion !== undefined ? { maxRecursion: fm.maxRecursion } : {}),
+        source,
+        filePath,
+    };
+}
+/** 加载项目 agents 目录下所有 .md 为 AgentDefinition（源: project）。 */
+async function loadAgents(projectDir) {
+    const agentsDir = join(projectDir, AGENTS_DIR);
+    let entries;
+    try {
+        const s = await stat(agentsDir);
+        if (!s.isDirectory())
+            return [];
+        entries = await readdir(agentsDir);
+    }
+    catch {
+        return [];
+    }
+    const defs = [];
+    for (const entry of entries) {
+        if (!entry.endsWith('.md'))
+            continue;
+        const def = await loadAgentFile(join(agentsDir, entry), 'project');
+        if (def)
+            defs.push(def);
+    }
+    return defs;
+}
+export { loadAgentFile, loadAgents };

package/dist/core/agents/index.d.ts

@@ -0,0 +1,6 @@
+export { BUILTIN_AGENTS, WORKER_BASE } from './builtin.js';
+export { loadAgentFile, loadAgents } from './discovery.js';
+export type { ParallelResult } from './parallel.js';
+export { mapWithConcurrencyLimit } from './parallel.js';
+export { createAgentRegistry } from './registry.js';
+export type { AgentDefinition, AgentMode, AgentRegistry, AgentSource } from './types.js';

package/dist/core/agents/index.js

@@ -0,0 +1,4 @@
+export { BUILTIN_AGENTS, WORKER_BASE } from './builtin.js';
+export { loadAgentFile, loadAgents } from './discovery.js';
+export { mapWithConcurrencyLimit } from './parallel.js';
+export { createAgentRegistry } from './registry.js';

package/dist/core/agents/parallel.d.ts

@@ -0,0 +1,13 @@
+/** 并行执行结果。 */
+interface ParallelResult<R> {
+    results: (R | undefined)[];
+    aborted: boolean;
+}
+/**
+ * 带 concurrency 上限的并行执行（worker 池）。
+ * 结果按输入顺序返回。abort 时取消未启动的、保留已完成的。
+ * 任一失败立即 reject（fail-fast）。
+ */
+declare function mapWithConcurrencyLimit<T, R>(items: T[], concurrency: number, fn: (item: T, index: number, signal: AbortSignal) => Promise<R>, signal?: AbortSignal): Promise<ParallelResult<R>>;
+export type { ParallelResult };
+export { mapWithConcurrencyLimit };

package/dist/core/agents/parallel.js

@@ -0,0 +1,37 @@
+/**
+ * 带 concurrency 上限的并行执行（worker 池）。
+ * 结果按输入顺序返回。abort 时取消未启动的、保留已完成的。
+ * 任一失败立即 reject（fail-fast）。
+ */
+async function mapWithConcurrencyLimit(items, concurrency, fn, signal) {
+    const limit = Math.max(1, Math.min(concurrency, items.length));
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    const abortController = new AbortController();
+    const workerSignal = signal
+        ? AbortSignal.any([signal, abortController.signal])
+        : abortController.signal;
+    async function worker() {
+        while (true) {
+            if (workerSignal.aborted)
+                return;
+            const idx = nextIndex++;
+            if (idx >= items.length)
+                return;
+            const item = items[idx];
+            if (item === undefined)
+                return;
+            results[idx] = await fn(item, idx, workerSignal);
+        }
+    }
+    const workers = Array.from({ length: limit }, () => worker());
+    try {
+        await Promise.all(workers);
+    }
+    catch (e) {
+        abortController.abort();
+        throw e;
+    }
+    return { results, aborted: signal?.aborted ?? false };
+}
+export { mapWithConcurrencyLimit };

package/dist/core/agents/registry.d.ts

@@ -0,0 +1,4 @@
+import type { AgentRegistry } from './types.js';
+/** 创建空的 agent 注册表（内存 Map，后注册覆盖同名）。 */
+declare function createAgentRegistry(): AgentRegistry;
+export { createAgentRegistry };

package/dist/core/agents/registry.js

@@ -0,0 +1,23 @@
+/** 创建空的 agent 注册表（内存 Map，后注册覆盖同名）。 */
+function createAgentRegistry() {
+    const defs = new Map();
+    return {
+        register(def) {
+            defs.set(def.name, def);
+        },
+        get(name) {
+            return defs.get(name);
+        },
+        list(mode) {
+            const all = Array.from(defs.values());
+            if (!mode)
+                return all;
+            // 'all' 模式的 agent 在任何过滤下都可见；subagent/primary 精确匹配。
+            return all.filter((d) => d.mode === 'all' || d.mode === mode);
+        },
+        has(name) {
+            return defs.has(name);
+        },
+    };
+}
+export { createAgentRegistry };

package/dist/core/agents/types.d.ts

@@ -0,0 +1,37 @@
+/** Agent 定义的来源层级（后加载覆盖先加载）。 */
+type AgentSource = 'builtin' | 'user' | 'project';
+/** Agent 可见性模式：subagent=仅子用，primary=仅主，all=皆可。 */
+type AgentMode = 'subagent' | 'primary' | 'all';
+/** 可配置的 agent 类型定义（由 markdown frontmatter 或代码构造）。 */
+interface AgentDefinition {
+    /** 唯一标识，如 'researcher'。 */
+    name: string;
+    /** 何时用此 agent（注入 task 工具描述供模型选择）。 */
+    description: string;
+    /** 专属 system prompt（frontmatter 正文）。 */
+    systemPrompt: string;
+    /** 允许的工具集（默认全部注册工具）。 */
+    tools?: string[];
+    /** 模型覆盖（默认继承父 agent）。 */
+    model?: string;
+    /** 可见性模式。 */
+    mode: AgentMode;
+    /** 是否用 git worktree 隔离（默认 false）。 */
+    isolated?: boolean;
+    /** 递归派生深度上限（默认 0=禁止递归 task）。 */
+    maxRecursion?: number;
+    /** yield 结果的 JSON Schema（验证子 agent 输出）。 */
+    outputSchema?: object;
+    /** 来源层级。 */
+    source: AgentSource;
+    /** markdown 路径（调试用）。 */
+    filePath?: string;
+}
+/** Agent 类型注册表：内存 Map<name, definition>。 */
+interface AgentRegistry {
+    register(def: AgentDefinition): void;
+    get(name: string): AgentDefinition | undefined;
+    list(mode?: AgentMode): AgentDefinition[];
+    has(name: string): boolean;
+}
+export type { AgentDefinition, AgentMode, AgentRegistry, AgentSource };

package/dist/core/agents/types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/compact.d.ts

@@ -0,0 +1,11 @@
+import type { DB } from '../db/client.js';
+import type { Registry } from '../llm/registry.js';
+import type { CompactionConfig, CompactionResult, Summarizer } from '../session/types.js';
+/** Create a Summarizer backed by an LLM streaming call. */
+declare function createSummarizer(registry: Registry, provider: string, model: string, opts?: {
+    maxTokens?: number;
+    signal?: AbortSignal;
+}): Summarizer;
+/** Run compaction on a session using the provided summarizer. */
+declare function runCompaction(db: DB, sessionId: string, summarizer: Summarizer, config?: Partial<CompactionConfig>): Promise<CompactionResult>;
+export { createSummarizer, runCompaction };

package/dist/core/compact.js

@@ -0,0 +1,31 @@
+import { chatStream } from '../llm/provider.js';
+import { compactSession } from '../session/compaction.js';
+/** Create a Summarizer backed by an LLM streaming call. */
+function createSummarizer(registry, provider, model, opts) {
+    return async (prompt) => {
+        const request = {
+            model,
+            messages: [{ role: 'user', content: prompt }],
+            stream: true,
+            ...(opts?.maxTokens !== undefined ? { maxTokens: opts.maxTokens } : {}),
+        };
+        const chunks = [];
+        for await (const chunk of chatStream({ registry, signal: opts?.signal }, request, {
+            provider,
+            model,
+        })) {
+            if (chunk._tag === 'text') {
+                chunks.push(chunk);
+            }
+            if (chunk._tag === 'error') {
+                throw new Error(chunk.error.message);
+            }
+        }
+        return chunks.map((c) => (c._tag === 'text' ? c.text : '')).join('');
+    };
+}
+/** Run compaction on a session using the provided summarizer. */
+async function runCompaction(db, sessionId, summarizer, config) {
+    return compactSession(db, sessionId, summarizer, config);
+}
+export { createSummarizer, runCompaction };

package/dist/core/config.d.ts

@@ -0,0 +1,7 @@
+import type { AgentsConfig, CompactionConfig, Config, MCPServerConfig, PermissionConfig, SecurityConfig, ToolMetricsConfig, UpdateConfig, WebSearchConfig } from '../shared/types/config.js';
+declare const DEFAULT_CONFIG: Config;
+declare function mergeConfig(...configs: (Partial<Config> | undefined)[]): Config;
+declare function loadConfig(projectDir?: string): Promise<Config>;
+declare function saveConfig(config: Config, scope: 'global' | 'project', projectDir?: string): Promise<void>;
+export type { AgentsConfig, CompactionConfig, Config, MCPServerConfig, PermissionConfig, SecurityConfig, ToolMetricsConfig, UpdateConfig, WebSearchConfig, };
+export { DEFAULT_CONFIG, loadConfig, mergeConfig, saveConfig };

package/dist/core/config.js

@@ -0,0 +1,84 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const GLOBAL_CONFIG_DIR = '.c0de';
+const CONFIG_FILENAME = 'config.json';
+const DEFAULT_CONFIG = {
+    providers: [],
+    defaultProvider: 'openai',
+    defaultModel: 'gpt-4o',
+    roleRouting: {},
+    fallback: { enabled: false, maxRetries: 3, retryDelay: 2000 },
+    compaction: {
+        enabled: true,
+        threshold: 0.8,
+        reserveTokens: 8000,
+        keepRecentTokens: 4000,
+    },
+    tools: { enabled: ['read', 'write', 'edit', 'glob', 'grep', 'bash', 'websearch'], disabled: [] },
+    plugins: { enabled: [] },
+    mcpServers: [],
+    slashCommands: { enabled: ['/compact', '/model', '/clear', '/help', '/fork', '/config'] },
+    toolMetrics: { enabled: true, threshold: 0.8, minSamples: 5 },
+    security: { authEnabled: false, allowedOrigins: [] },
+    websearch: { provider: 'auto' },
+    agents: { dir: '.c0de/agents', subagentConcurrency: 3 },
+    permission: { defaultMode: 'default' },
+    update: { enabled: true, intervalMs: 60 * 60 * 1000, initialDelayMs: 10_000, autoApply: false },
+    theme: 'system',
+    locale: 'en',
+};
+function mergeConfig(...configs) {
+    const result = structuredClone(DEFAULT_CONFIG);
+    for (const cfg of configs) {
+        if (!cfg)
+            continue;
+        for (const key of Object.keys(cfg)) {
+            const val = cfg[key];
+            if (val === undefined)
+                continue;
+            const current = result[key];
+            if (val !== null &&
+                typeof val === 'object' &&
+                !Array.isArray(val) &&
+                current !== null &&
+                typeof current === 'object' &&
+                !Array.isArray(current)) {
+                ;
+                result[key] = { ...current, ...val };
+            }
+            else {
+                ;
+                result[key] = val;
+            }
+        }
+    }
+    return result;
+}
+function readJsonIfExists(path) {
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function loadConfig(projectDir) {
+    const globalPath = join(homedir(), GLOBAL_CONFIG_DIR, CONFIG_FILENAME);
+    const projectPath = join(projectDir ?? process.cwd(), '.c0de', CONFIG_FILENAME);
+    const global = readJsonIfExists(globalPath);
+    const project = readJsonIfExists(projectPath);
+    return mergeConfig(global, project);
+}
+async function saveConfig(config, scope, projectDir) {
+    const dir = scope === 'global'
+        ? join(homedir(), GLOBAL_CONFIG_DIR)
+        : join(projectDir ?? process.cwd(), '.c0de');
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const path = join(dir, CONFIG_FILENAME);
+    writeFileSync(path, JSON.stringify(config, null, 2), 'utf-8');
+}
+export { DEFAULT_CONFIG, loadConfig, mergeConfig, saveConfig };

package/dist/core/context.d.ts

@@ -0,0 +1,23 @@
+import type { TokenBudget } from '../shared/types/agent.js';
+import type { Message } from '../shared/types/message.js';
+import type { CompactionConfig } from './config.js';
+declare function createTokenBudget(totalTokens: number, opts?: {
+    reserved?: number;
+    historyBudget?: number;
+    keepRecent?: number;
+}): TokenBudget;
+declare function estimateBudget(messages: Message[], factor?: number): number;
+declare function fitToBudget(messages: Message[], budget: TokenBudget, factor?: number): Message[];
+declare function shouldCompact(_messages: Message[], budget: TokenBudget, config: CompactionConfig): boolean;
+/**
+ * 按真实 LLM input token 校准估算系数（指数移动平均）。
+ *
+ * `estimated` 与 `actual` 必须是同一口径——即「system prompt + 工具描述 + 历史消息」
+ * 全部 input 的 token 总和。这样 observed = actual/estimated 收敛到 estimateTokens
+ * 的系统性系数，可反哺 estimateBudget/fitToBudget 的裁剪与压缩判断。
+ *
+ * 极端值（首轮流式 chunk 异常等）被 clamp 到 [CALIBRATION_MIN, CALIBRATION_MAX]，
+ * 避免单次噪声污染系数。
+ */
+declare function calibrateEstimate(prevFactor: number, estimated: number, actual: number): number;
+export { calibrateEstimate, createTokenBudget, estimateBudget, fitToBudget, shouldCompact };

package/dist/core/context.js

@@ -0,0 +1,93 @@
+import { estimateTokens } from '../session/token.js';
+// Token 预算分配（spec §3.6 策略1）：
+//   reserved       20% — system prompt + 工具描述
+//   historyBudget  60% — 历史消息上限
+//   当前轮次       20% — available - historyBudget，预留给本轮用户输入与模型输出
+const SYSTEM_PROMPT_RATIO = 0.2;
+const HISTORY_RATIO = 0.6;
+const KEEP_RECENT_RATIO = 0.1;
+// calibrateEstimate 的指数移动平均参数与边界。
+const CALIBRATION_ALPHA = 0.3;
+const CALIBRATION_MIN = 0.25;
+const CALIBRATION_MAX = 4;
+function createTokenBudget(totalTokens, opts) {
+    const reserved = opts?.reserved ?? Math.floor(totalTokens * SYSTEM_PROMPT_RATIO);
+    return {
+        total: totalTokens,
+        reserved,
+        available: totalTokens - reserved,
+        historyBudget: opts?.historyBudget ?? Math.floor(totalTokens * HISTORY_RATIO),
+        used: 0,
+        keepRecent: opts?.keepRecent ?? Math.floor(totalTokens * KEEP_RECENT_RATIO),
+    };
+}
+/** 单条消息的原始 token 估算（不应用校准系数）。 */
+function rawMessageTokens(m) {
+    if (m.tokenCount > 0)
+        return m.tokenCount;
+    return estimateTokens(m.content.map((p) => (p._tag === 'text' || p._tag === 'thinking' ? p.text : '')).join(''));
+}
+function estimateBudget(messages, factor = 1.0) {
+    const raw = messages.reduce((sum, m) => sum + rawMessageTokens(m), 0);
+    return factor === 1.0 ? raw : Math.round(raw * factor);
+}
+function fitToBudget(messages, budget, factor = 1.0) {
+    if (messages.length === 0)
+        return [];
+    let recentTokens = 0;
+    let recentStart = messages.length;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (!m)
+            continue;
+        const tc = rawMessageTokens(m) * factor;
+        if (recentTokens + tc > budget.keepRecent)
+            break;
+        recentTokens += tc;
+        recentStart = i;
+    }
+    // Always keep at least the last message
+    recentStart = Math.min(recentStart, messages.length - 1);
+    const result = [];
+    let used = 0;
+    // 历史消息最多占用 historyBudget，超出部分预留给当前轮次（spec §3.6 策略1）。
+    const historyCap = budget.historyBudget;
+    for (let i = 0; i < messages.length; i++) {
+        const m = messages[i];
+        if (!m)
+            continue;
+        const tc = rawMessageTokens(m) * factor;
+        const mustKeep = i >= recentStart;
+        if (mustKeep || used + tc <= historyCap) {
+            result.push(m);
+            used += tc;
+        }
+    }
+    return result;
+}
+function shouldCompact(_messages, budget, config) {
+    if (!config.enabled)
+        return false;
+    if (budget.available <= 0)
+        return false;
+    const ratio = budget.used / budget.available;
+    return ratio >= config.threshold;
+}
+/**
+ * 按真实 LLM input token 校准估算系数（指数移动平均）。
+ *
+ * `estimated` 与 `actual` 必须是同一口径——即「system prompt + 工具描述 + 历史消息」
+ * 全部 input 的 token 总和。这样 observed = actual/estimated 收敛到 estimateTokens
+ * 的系统性系数，可反哺 estimateBudget/fitToBudget 的裁剪与压缩判断。
+ *
+ * 极端值（首轮流式 chunk 异常等）被 clamp 到 [CALIBRATION_MIN, CALIBRATION_MAX]，
+ * 避免单次噪声污染系数。
+ */
+function calibrateEstimate(prevFactor, estimated, actual) {
+    if (estimated <= 0 || actual <= 0)
+        return prevFactor;
+    const observed = actual / estimated;
+    const clamped = Math.min(Math.max(observed, CALIBRATION_MIN), CALIBRATION_MAX);
+    return prevFactor * (1 - CALIBRATION_ALPHA) + clamped * CALIBRATION_ALPHA;
+}
+export { calibrateEstimate, createTokenBudget, estimateBudget, fitToBudget, shouldCompact };

package/dist/core/index.d.ts

@@ -0,0 +1,13 @@
+export { abortAgent, createAgent, getAgentStatus, isAgentPaused, pauseAgent, resumeAgent, runAgent, } from './agent.js';
+export { createSummarizer, runCompaction } from './compact.js';
+export type { CompactionConfig, Config, MCPServerConfig } from './config.js';
+export { DEFAULT_CONFIG, loadConfig, mergeConfig, saveConfig } from './config.js';
+export { calibrateEstimate, createTokenBudget, estimateBudget, fitToBudget, shouldCompact, } from './context.js';
+export { agentLoop } from './loop.js';
+export { buildSystemPrompt } from './prompt.js';
+export type { SlashRegistry } from './slash.js';
+export { builtinCommands, createSlashRegistry, parseSlashInput } from './slash.js';
+export { clearSteering, drainSteering, injectSteering } from './steering.js';
+export type { CollectedToolCall, ToolCallResult } from './tool-exec.js';
+export { executeToolCall, executeToolCalls, partitionByConflict } from './tool-exec.js';
+export type { AgentConfig, AgentDependencies, AgentError, AgentEvent, AgentState, AgentStatus, CommandContext, CommandResult, LLMSegment, PendingToolCall, ProjectInfo, PromptContext, SlashCommand, TokenBudget, } from './types.js';

package/dist/core/index.js

@@ -0,0 +1,11 @@
+// Core package: agent loop, prompt building, config, context management,
+// steering, slash commands, and compaction bridge.
+export { abortAgent, createAgent, getAgentStatus, isAgentPaused, pauseAgent, resumeAgent, runAgent, } from './agent.js';
+export { createSummarizer, runCompaction } from './compact.js';
+export { DEFAULT_CONFIG, loadConfig, mergeConfig, saveConfig } from './config.js';
+export { calibrateEstimate, createTokenBudget, estimateBudget, fitToBudget, shouldCompact, } from './context.js';
+export { agentLoop } from './loop.js';
+export { buildSystemPrompt } from './prompt.js';
+export { builtinCommands, createSlashRegistry, parseSlashInput } from './slash.js';
+export { clearSteering, drainSteering, injectSteering } from './steering.js';
+export { executeToolCall, executeToolCalls, partitionByConflict } from './tool-exec.js';

package/dist/core/loop.d.ts

@@ -0,0 +1,25 @@
+import { chatStream as llmChatStream } from '../llm/provider.js';
+import type { AgentEvent, AgentState } from '../shared/types/agent.js';
+import type { SubAgentRequest, SubAgentResult } from '../shared/types/tool.js';
+import type { AgentDependencies } from './types.js';
+type LoopDeps = AgentDependencies & {
+    chatStream?: typeof llmChatStream;
+    /** 子 agent 运行时注入：yield 工具的结果收集器（透传到 ToolContext.collectYield）。 */
+    readonly _subagentYieldCollector?: (data: unknown) => void;
+    /** 子 agent 运行时注入：事件回调，子 agent 的 subagent_start/end 事件推入此 sink，
+     *  由父 agentLoop 缓冲后在工具执行后 yield 出去（spec §4.5 step 7）。 */
+    readonly _subagentEventSink?: (event: AgentEvent) => void;
+    /** 当前递归深度（0=顶层主 agent）。用于 maxRecursion 控制（spec §4.5 step 4）。 */
+    readonly _subagentDepth?: number;
+};
+export type { LoopDeps };
+/** 运行一个按类型派发的子 agent（spec: multi-agent-design §4.5）。
+ *
+ *  Host 端实现：查 agentRegistry 获取 AgentDefinition → 创建隔离子 session（agentType 记录）
+ *  → 构建子 agent（专属 prompt + 受限工具集 + yield）→ 运行到 yield 或完成 → 返回结果。
+ *  发射 subagent_start/subagent_end 事件供父 agent 转发（spec §4.5 step 7）。
+ *  abort 链接父→子。maxRecursion 控制子 agent 能否再递归派生 task（spec §4.5 step 4）。
+ *  def.isolated 时在 git worktree 中运行，结束后把 delta 自动 apply 回父仓库（spec §4.6）。
+ *  request.background 时 fork 异步运行，立即返回 running（spec §4.7）。 */
+export declare function runSubAgent(deps: LoopDeps, parent: AgentState, request: SubAgentRequest): Promise<SubAgentResult>;
+export declare function agentLoop(state: AgentState, deps: LoopDeps): AsyncGenerator<AgentEvent>;