@bolloon/bolloon-agent 0.1.34 → 0.1.36

package/dist/llm/pi-ai.js

@@ -1,5 +1,22 @@
 import * as path from 'path';
 import * as fs from 'fs';
+/**
+ * 外部 system 注入钩子.
+ * 调用方 (e.g. auto-evolve-loop) 用 setSystemPrependProvider() 注册一个返回字符串的函数,
+ * generateText 在拼 finalMessages 时, 把返回的字符串作为最前一个 system message.
+ *
+ * 用途: P2P 协作时把"行级 reserve 状态"实时塞给 LLM,
+ *       让 LLM 主动避开对方正在改的代码行.
+ *
+ * 返回 '' / null / undefined → 不注入.
+ */
+let _prependProvider = null;
+export function setSystemPrependProvider(p) {
+    _prependProvider = p;
+}
+export function getSystemPrependProvider() {
+    return _prependProvider;
+}
 export class PiAIModel {
     config;
     provider;
@@ -7,8 +24,8 @@ export class PiAIModel {
         this.config = config;
         this.provider = config.provider;
     }
-    async chat(message, context) {
-        const systemPrompt = this.buildSystemPrompt(context);
+    async chat(message, context, signal) {
+        const systemPrompt = await this.buildSystemPromptAsync(context);
         const messages = [
             { role: 'system', content: systemPrompt },
             { role: 'user', content: message }
@@ -16,13 +33,26 @@ export class PiAIModel {
         try {
             const response = await this.generateText({
                 messages,
-                temperature: 0.8
+                temperature: 0.8,
+                maxTokens: 8192, // 2026-06-15: 提到 8192, 避免长回答 (含表格/代码块) 被截断
+                signal,
             });
             return { reply: response };
         }
         catch (error) {
+            // abort 不当作错误, 透传一个 sentinel 让上层能识别
+            if (signal?.aborted || error?.name === 'AbortError') {
+                throw error; // 上层 try/catch 处理
+            }
             console.error('PiAI chat error:', error);
-            return { reply: '抱歉，AI服务暂时不可用。' };
+            // 2026-06-15: 真实 error 信息 + 明确告诉 LLM "这是 API 错, 不要 retry"
+            // 旧版: "抱歉，AI服务暂时不可用。" → LLM 看到 isTooShort=false(< 50 但 > 0),
+            //       needsMoreWork 不会触发, 但 hasError 模式 (含 "error" / "失败") 会判定要继续修
+            // 新版: 让 LLM 立即停止循环, 直接展示给用户
+            const errMsg = (error?.message || '').slice(0, 300);
+            return {
+                reply: `[AI 服务调用失败] ${errMsg}\n\n这是一个**底层 API 错误**（401 / 鉴权失败 / 网络中断 / 配额耗尽等），不是你的任务有问题。**请直接把这个错误消息回复给用户，不要再循环尝试。**`,
+            };
         }
     }
     async summarize(text, context) {
@@ -64,7 +94,39 @@ export class PiAIModel {
         }
     }
     async generateText(options) {
-        const { messages, temperature = 0.7, maxTokens = 4096 } = options;
+        const { messages, temperature = 0.7, maxTokens = 4096, signal, tools } = options;
+        // 工具清单: 代码侧 schema → 进 system prompt (作为额外 system message)
+        let finalMessages = messages;
+        // 1) 外部 prepend (e.g. P2P 行级 reserve 状态), 拼到最前
+        if (_prependProvider) {
+            try {
+                const pre = await _prependProvider();
+                if (pre && typeof pre === 'string' && pre.trim()) {
+                    finalMessages = [{ role: 'system', content: pre }, ...finalMessages];
+                }
+            }
+            catch (err) {
+                console.warn('[pi-ai] systemPrepend 失败:', err?.message?.slice(0, 100));
+            }
+        }
+        if (tools && tools.length > 0) {
+            try {
+                const { getToolManifest, formatForPrompt } = await import('./tool-manifest/index.js');
+                const manifests = tools
+                    .map((id) => getToolManifest(id))
+                    .filter((m) => m !== undefined);
+                if (manifests.length > 0) {
+                    const toolPrompt = formatForPrompt(manifests);
+                    finalMessages = [
+                        { role: 'system', content: toolPrompt },
+                        ...messages,
+                    ];
+                }
+            }
+            catch (err) {
+                console.warn('[pi-ai] tool-manifest 加载失败:', err.message?.slice(0, 100));
+            }
+        }
         switch (this.provider) {
             case 'openai':
             case 'minimax':
@@ -72,17 +134,17 @@ export class PiAIModel {
             case 'kimi':
             case 'glm':
             case 'qwen':
-                return this.callOpenAI(messages, temperature, maxTokens);
+                return this.callOpenAI(finalMessages, temperature, maxTokens, signal);
             case 'anthropic':
-                return this.callAnthropic(messages, temperature, maxTokens);
+                return this.callAnthropic(finalMessages, temperature, maxTokens, signal);
             case 'ollama':
-                return this.callOllama(messages, temperature);
+                return this.callOllama(finalMessages, temperature, signal);
             case 'openrouter':
-                return this.callOpenRouter(messages, temperature, maxTokens);
+                return this.callOpenRouter(finalMessages, temperature, maxTokens, signal);
             case 'gemini':
-                return this.callGemini(messages, temperature, maxTokens);
+                return this.callGemini(finalMessages, temperature, maxTokens, signal);
             case 'local':
-                return this.callLocal(messages, temperature);
+                return this.callLocal(finalMessages, temperature, signal);
             default:
                 throw new Error(`Unsupported provider: ${this.provider}`);
         }
@@ -142,23 +204,28 @@ export class PiAIModel {
         };
         return modelMap[this.provider];
     }
-    async callOpenAI(messages, temperature, maxTokens) {
+    async callOpenAI(messages, temperature, maxTokens, signal) {
         const apiKey = this.getApiKey();
         if (!apiKey) {
             throw new Error('OPENAI_API_KEY not set');
         }
+        const requestBody = {
+            model: this.mapModel(),
+            messages,
+            temperature,
+            max_tokens: maxTokens
+        };
         const response = await fetch(`${this.getBaseUrl()}/chat/completions`, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
                 'Authorization': `Bearer ${apiKey}`
             },
-            body: JSON.stringify({
-                model: this.mapModel(),
-                messages,
-                temperature,
-                max_tokens: maxTokens
-            })
+            body: JSON.stringify(requestBody),
+            // 2026-06-15: signal 字段防御 — Node 22+ undici 强类型 AbortSignal, 非 AbortSignal 实例
+            //   (e.g. 误传的 { maxTokens: 1 } 对象) 会 throw "Expected signal to be AbortSignal".
+            //   若不是 AbortSignal, 退到无 signal 调用, fetch 自然支持 timeout 由外层控制.
+            signal: signal instanceof AbortSignal ? signal : undefined,
         });
         if (!response.ok) {
             throw new Error(`OpenAI API error: ${response.status}`);
@@ -166,7 +233,7 @@ export class PiAIModel {
         const data = await response.json();
         return data.choices?.[0]?.message?.content || '';
     }
-    async callAnthropic(messages, temperature, maxTokens) {
+    async callAnthropic(messages, temperature, maxTokens, signal) {
         const apiKey = this.getApiKey();
         if (!apiKey) {
             throw new Error('ANTHROPIC_API_KEY not set');
@@ -187,7 +254,8 @@ export class PiAIModel {
                 system: systemMessage,
                 temperature,
                 max_tokens: maxTokens
-            })
+            }),
+            signal,
         });
         if (!response.ok) {
             throw new Error(`Anthropic API error: ${response.status}`);
@@ -195,7 +263,7 @@ export class PiAIModel {
         const data = await response.json();
         return data.content?.[0]?.text || '';
     }
-    async callOllama(messages, temperature) {
+    async callOllama(messages, temperature, signal) {
         const response = await fetch(`${this.getBaseUrl()}/api/chat`, {
             method: 'POST',
             headers: {
@@ -206,7 +274,8 @@ export class PiAIModel {
                 messages,
                 temperature,
                 stream: false
-            })
+            }),
+            signal,
         });
         if (!response.ok) {
             throw new Error(`Ollama API error: ${response.status}`);
@@ -214,7 +283,7 @@ export class PiAIModel {
         const data = await response.json();
         return data.message?.content || '';
     }
-    async callOpenRouter(messages, temperature, maxTokens) {
+    async callOpenRouter(messages, temperature, maxTokens, signal) {
         const apiKey = this.getApiKey();
         if (!apiKey) {
             throw new Error('OPENROUTER_API_KEY not set');
@@ -232,7 +301,8 @@ export class PiAIModel {
                 messages,
                 temperature,
                 max_tokens: maxTokens
-            })
+            }),
+            signal,
         });
         if (!response.ok) {
             throw new Error(`OpenRouter API error: ${response.status}`);
@@ -240,7 +310,7 @@ export class PiAIModel {
         const data = await response.json();
         return data.choices?.[0]?.message?.content || '';
     }
-    async callGemini(messages, temperature, maxTokens) {
+    async callGemini(messages, temperature, maxTokens, signal) {
         const apiKey = this.getApiKey();
         if (!apiKey) {
             throw new Error('GEMINI_API_KEY not set');
@@ -264,7 +334,8 @@ export class PiAIModel {
                     temperature,
                     maxOutputTokens: maxTokens
                 }
-            })
+            }),
+            signal,
         });
         if (!response.ok) {
             throw new Error(`Gemini API error: ${response.status}`);
@@ -272,9 +343,35 @@ export class PiAIModel {
         const data = await response.json();
         return data.candidates?.[0]?.content?.parts?.[0]?.text || '';
     }
-    async callLocal(messages, temperature) {
-        return this.callOllama(messages, temperature);
+    async callLocal(messages, temperature, signal) {
+        return this.callOllama(messages, temperature, signal);
+    }
+    // 注: callLocal 直接代理 ollama. 工具清单由 generateText 在外层拼到 messages, 这里 messages 已是 finalMessages.
+    async buildSystemPromptAsync(context) {
+        // 走 layer registry: 装配所有相关 layer (身份/行为/工具/角色/渠道)
+        try {
+            const { assembleSystemPrompt, SYSTEM_PROMPT_VERSION } = await import('./system-prompt/registry.js').catch(() => import('./system-prompt/registry.js'));
+            // channel = 本机 (PI SDK 直接调就是 local)
+            // role = 由 prompt context 决定 (默认 expert)
+            const ctx = context ? { channel: 'local', role: 'expert' } : { channel: 'local', role: 'expert' };
+            const result = await assembleSystemPrompt(ctx);
+            return `${result.text}\n\n## User Working Directory\n${context || process.cwd()}\n\n## bolloon-runtime\n${SYSTEM_PROMPT_VERSION} · layers: ${result.layerIds.join(',')}`;
+        }
+        catch (err) {
+            // 降级: 旧硬编码 (layer registry 不可用时不挂)
+            console.warn('[pi-ai] layer registry 不可用, 降级:', err.message?.slice(0, 100));
+            const envDetails = this.getEnvironmentDetails();
+            return `You are a friendly AI assistant in a P2P document collaboration network.
+
+## User Working Directory
+${context || process.cwd()}
+
+## Environment
+${envDetails}`;
+        }
     }
+    // 同步版: 旧调用点 (buildSystemPrompt 是同步)
+    // 保留但内部用 sync fallback; 后续可改成 async
     buildSystemPrompt(context) {
         const envDetails = this.getEnvironmentDetails();
         return `You are a friendly AI assistant in a P2P document collaboration network.

package/dist/llm/system-prompt/health.js

@@ -0,0 +1,129 @@
+/**
+ * system-prompt health — 每层 lifecycle 状态扫描
+ *
+ * 严格对齐 deusyu 论文 "Harness Gardening 3-6 月" + walkinglabs Lifecycle 4-stage
+ * + 马书 ch05+ch13 systemPromptSection + 89 FF 的版本/owner 治理思想.
+ *
+ * 设计:
+ *   - 输入: 完整 layer list (assembleSystemPrompt 返回的 layers[])
+ *   - 输出: 每层 health 状态 (ok | stale | overdue-review | missing-frontmatter)
+ *   - 失败静默: 任何 layer 读失败 → 标 'missing-frontmatter' 而非抛错
+ *
+ * 决策 (cross-repo_caveats 选边):
+ *   - dynamic layers (function source) → 标 'ok' (last_reviewed_at = now), 视作 runtime-managed
+ *   - frontmatter author 拒绝 'llm-judge' 之外的不合法值 → 标 'missing-frontmatter'
+ */
+const DAY_MS = 24 * 60 * 60 * 1000;
+/** 兼容运行时: dynamic layer 没有 meta, 视作 'dynamic' (last_reviewed = now) */
+function isDynamic(l) {
+    return l.source === 'function';
+}
+/** 评估单层 health */
+export function evaluateLayer(l, now = new Date()) {
+    if (isDynamic(l)) {
+        return {
+            id: l.id,
+            health: 'dynamic',
+            ageDays: 0,
+            ttlDays: -1,
+            remainingDays: -1,
+            author: l.meta?.author ?? 'runtime',
+            lastReviewedAt: now.toISOString(),
+            active: false, // 由 caller (assembleSystemPrompt) 决定
+        };
+    }
+    if (!l.meta) {
+        // frontmatter 解析失败或缺失
+        return {
+            id: l.id,
+            health: 'missing-frontmatter',
+            ageDays: -1,
+            ttlDays: -1,
+            remainingDays: -1,
+            author: null,
+            lastReviewedAt: null,
+            active: false,
+        };
+    }
+    const reviewedAt = new Date(l.meta.lastReviewedAt).getTime();
+    if (isNaN(reviewedAt)) {
+        return {
+            id: l.id,
+            health: 'missing-frontmatter',
+            ageDays: -1,
+            ttlDays: l.meta.ttlDays,
+            remainingDays: -1,
+            author: l.meta.author,
+            lastReviewedAt: l.meta.lastReviewedAt,
+            active: false,
+        };
+    }
+    const ageMs = now.getTime() - reviewedAt;
+    const ageDays = Math.floor(ageMs / DAY_MS);
+    const remainingDays = l.meta.ttlDays - ageDays;
+    let health;
+    if (remainingDays < 0) {
+        health = 'overdue-review';
+    }
+    else if (remainingDays < l.meta.ttlDays * 0.2) {
+        health = 'stale'; // 剩余 < 20% ttl 触发告警
+    }
+    else {
+        health = 'ok';
+    }
+    return {
+        id: l.id,
+        health,
+        ageDays,
+        ttlDays: l.meta.ttlDays,
+        remainingDays,
+        author: l.meta.author,
+        lastReviewedAt: l.meta.lastReviewedAt,
+        notes: l.meta.notes,
+        active: false, // caller 决定
+    };
+}
+/** 评估整组 layer (输入: assembleSystemPrompt 返回的 layers[]) */
+export function evaluateLayers(layers, now = new Date()) {
+    const entries = layers.map((l) => evaluateLayer(l, now));
+    return summarize(entries, now);
+}
+/** 汇总: 给一批 entries 算 counts */
+function summarize(entries, now) {
+    const counts = { ok: 0, stale: 0, overdue: 0, missing: 0, dynamic: 0 };
+    for (const e of entries) {
+        if (e.health === 'ok')
+            counts.ok++;
+        else if (e.health === 'stale')
+            counts.stale++;
+        else if (e.health === 'overdue-review')
+            counts.overdue++;
+        else if (e.health === 'missing-frontmatter')
+            counts.missing++;
+        else if (e.health === 'dynamic')
+            counts.dynamic++;
+    }
+    return {
+        scannedAt: now.toISOString(),
+        total: entries.length,
+        okCount: counts.ok,
+        staleCount: counts.stale,
+        overdueCount: counts.overdue,
+        missingCount: counts.missing,
+        dynamicCount: counts.dynamic,
+        entries,
+    };
+}
+/** 标记当前 context 下激活的 layer (在 assembleSystemPrompt 调用后用) */
+export function markActive(report, activeIds) {
+    return {
+        ...report,
+        entries: report.entries.map((e) => ({ ...e, active: activeIds.has(e.id) })),
+    };
+}
+// ============================================================
+// 测试钩子
+// ============================================================
+export function _resetHealthForTest() {
+    // 无内部状态, 保留 API 一致
+}

package/dist/llm/system-prompt/registry.js

@@ -0,0 +1,246 @@
+/**
+ * registry.ts — system prompt 层注册 + 装配器
+ *
+ * 设计原则:
+ * - 每个 layer 独立文件, 可单独更新/审查/回滚
+ * - 装配器按 channel + role + tool 过滤, 输出最终 system prompt
+ * - 字符预算按"层级"硬限, 避免腐烂
+ * - 远程 P2P layer (function source) 可被远程智能体覆盖本地 layer
+ *
+ * 装配顺序 (低 priority 先, 高 priority 后):
+ *   core/identity < core/knowledge < core/tools < channel/* < role/* < tool/* < dynamic/*
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { stripHibsml } from './strip-hibsml.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const LAYERS_DIR = path.join(__dirname, 'layers');
+/** 解析 .md frontmatter (手写 3 行 regex, 不引 yaml 依赖) */
+function parseFrontmatter(raw) {
+    const m = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!m)
+        return { meta: null, body: raw };
+    const block = m[1];
+    const body = m[2];
+    const get = (key) => {
+        const re = new RegExp(`^${key}:\\s*(.+)$`, 'm');
+        const found = block.match(re);
+        return found ? found[1].trim() : undefined;
+    };
+    const addedAt = get('added_at');
+    const lastReviewedAt = get('last_reviewed_at');
+    const ttlDaysStr = get('ttl_days');
+    const author = get('author');
+    const notes = get('notes');
+    if (!addedAt || !lastReviewedAt || !ttlDaysStr || !author) {
+        // frontmatter 不完整 → 视为无 metadata (health 会标 missing-frontmatter)
+        return { meta: null, body: raw };
+    }
+    const ttlDays = parseInt(ttlDaysStr, 10);
+    if (isNaN(ttlDays) || ttlDays <= 0) {
+        return { meta: null, body: raw };
+    }
+    return {
+        meta: { addedAt, lastReviewedAt, ttlDays, author, notes },
+        body,
+    };
+}
+/**
+ * 静态 layer 注册表 — 一个 layer 一个文件
+ * 这里只声明 metadata, 内容从 .md 读
+ *
+ * P-Action 2: meta 默认值, 跟分层 TTL 决策一致
+ *   safety  (refusal / hibs_reminders / tools.thin)        = 90
+ *   channel (local / p2p-* persona)                         = 180
+ *   role    (expert / architect / implementer / security)  = 180
+ *   tool    (bash / search / artifacts / etc)               = 270
+ *   knowledge (knowledge / tone / wellbeing / etc)         = 365
+ * author = yuanjie (可被 .md frontmatter 覆盖)
+ */
+const DEFAULT_META_AUTHOR = 'yuanjie';
+const DEFAULT_ADDED_AT = '2026-06-15';
+const DEFAULT_REVIEWED_AT = '2026-06-15';
+const TTL_SAFETY = 90;
+const TTL_CHANNEL = 180;
+const TTL_ROLE = 180;
+const TTL_TOOL = 270;
+const TTL_KNOWLEDGE = 365;
+const DEFAULT_META = (ttlDays) => ({
+    addedAt: DEFAULT_ADDED_AT,
+    lastReviewedAt: DEFAULT_REVIEWED_AT,
+    ttlDays,
+    author: DEFAULT_META_AUTHOR,
+});
+/**
+ * P-Action 4 (2026-06-15): 单 layer maxChars 全面收紧, 6 个 layer 停用.
+ * 阶段 0 不再对齐 Claude.ai 完整版 (hibs_api / artifacts / mcp_apps / image_search /
+ *   hibs_reminders / network_filesystem 全是 Claude.ai 平台 runtime, 本地 bolloon 用不到).
+ * 停用方法: appliesTo 加 'never' (matchesContext 永远 false), 文件保留可回滚.
+ */
+const STATIC_LAYERS = [
+    // ── core/ ──
+    { id: 'core.identity', version: '1.0.0', priority: 50, appliesTo: ['all'], source: 'static-md', maxChars: 800, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    { id: 'core.knowledge', version: '1.0.0', priority: 60, appliesTo: ['all'], source: 'static-md', maxChars: 600, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    { id: 'core.tools.thin', version: '1.0.0', priority: 70, appliesTo: ['all'], source: 'static-md', maxChars: 400, meta: DEFAULT_META(TTL_SAFETY) },
+    { id: 'core.hibs_reminders', version: '1.0.0', priority: 80, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_SAFETY) },
+    { id: 'core.refusal', version: '1.0.0', priority: 100, appliesTo: ['all'], source: 'static-md', maxChars: 800, meta: DEFAULT_META(TTL_SAFETY) },
+    { id: 'core.tone', version: '1.0.0', priority: 110, appliesTo: ['all'], source: 'static-md', maxChars: 500, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    { id: 'core.wellbeing', version: '1.0.0', priority: 120, appliesTo: ['all'], source: 'static-md', maxChars: 600, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    { id: 'core.evenhandedness', version: '1.0.0', priority: 130, appliesTo: ['all'], source: 'static-md', maxChars: 300, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    { id: 'core.memory_system', version: '1.0.0', priority: 140, appliesTo: ['all'], source: 'static-md', maxChars: 200, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    { id: 'core.artifacts_storage', version: '1.0.0', priority: 145, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    { id: 'core.network_filesystem', version: '1.0.0', priority: 148, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    // ── role/ ── 阶段 0 只用 expert, 其他 3 个停用 (节省 + 阶段 0 不分 role)
+    { id: 'role.expert', version: '1.0.0', priority: 200, appliesTo: ['all', 'role:expert'], source: 'static-md', maxChars: 500, meta: DEFAULT_META(TTL_ROLE) },
+    { id: 'role.architect', version: '1.0.0', priority: 200, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_ROLE) },
+    { id: 'role.implementer', version: '1.0.0', priority: 200, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_ROLE) },
+    { id: 'role.security', version: '1.0.0', priority: 200, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_ROLE) },
+    // ── channel/ ──
+    { id: 'channel.local', version: '1.0.0', priority: 150, appliesTo: ['local'], source: 'static-md', maxChars: 500, meta: DEFAULT_META(TTL_CHANNEL) },
+    { id: 'channel.p2p-visitor', version: '1.0.0', priority: 150, appliesTo: ['p2p-visitor'], source: 'static-md', maxChars: 700 },
+    { id: 'channel.p2p-agent', version: '1.0.0', priority: 150, appliesTo: ['p2p-agent'], source: 'static-md', maxChars: 700 },
+    // ── tool/ (按工具调用嵌对应 layer) ──
+    { id: 'tool.bash', version: '1.0.0', priority: 250, appliesTo: ['tool:bash'], source: 'static-md', maxChars: 600, meta: DEFAULT_META(TTL_TOOL) },
+    { id: 'tool.web_search', version: '1.0.0', priority: 250, appliesTo: ['tool:web_search'], source: 'static-md', maxChars: 600, meta: DEFAULT_META(TTL_TOOL) },
+    { id: 'tool.mcp_apps', version: '1.0.0', priority: 250, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_TOOL) },
+    { id: 'tool.hibs_api', version: '1.0.0', priority: 250, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_TOOL) },
+    { id: 'tool.image_search', version: '1.0.0', priority: 250, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_TOOL) },
+    { id: 'tool.artifacts', version: '1.0.0', priority: 250, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_TOOL) },
+    { id: 'tool.manifest', version: '1.0.0', priority: 250, appliesTo: ['tool:manifest'], source: 'static-md', maxChars: 500, meta: DEFAULT_META(TTL_TOOL) },
+];
+/**
+ * 动态 layer (运行时计算, 例如 project context, judgment 注入)
+ * 接入现有 project-context.ts + value-injection.ts, 不重复实现
+ */
+const DYNAMIC_LAYERS = [
+    {
+        id: 'dynamic.project-context',
+        version: '1.0.0',
+        priority: 300,
+        appliesTo: ['all'],
+        source: 'function',
+        maxChars: 2000, // 4000 → 2000 (P-Action 4), 跟 4 级层次合并上限对齐
+        resolver: async () => {
+            try {
+                const { getCachedBolloonContext } = await import('../../pi-ecosystem-judgment/human-value-pipeline.js');
+                const { formatContextForSystemPrompt } = await import('../../bootstrap/project-context.js');
+                const ctx = await getCachedBolloonContext({ cwd: process.cwd() });
+                return formatContextForSystemPrompt(ctx, { maxChars: 4000 });
+            }
+            catch {
+                return '';
+            }
+        },
+    },
+];
+/**
+ * P-Action 4 (2026-06-15): 总字符上限 15000 → 4500.
+ * 阶段 0 单次 system prompt 控制在 ≤ 4.5KB (≈ 1125 tokens).
+ * 配合单 layer maxChars 收紧 + 6 layer 停用, 每轮 chat 节省 ≈ 2625 tokens.
+ */
+const TOTAL_BUDGET = 4500;
+export async function assembleSystemPrompt(ctx) {
+    // 1. 收集所有 layer
+    const allLayers = [];
+    for (const meta of STATIC_LAYERS) {
+        const { content, meta: sectionMeta } = await loadStaticLayer(meta.id);
+        allLayers.push({ ...meta, content, meta: sectionMeta ?? meta.meta });
+    }
+    for (const dyn of DYNAMIC_LAYERS) {
+        allLayers.push({ ...dyn, meta: dyn.meta });
+    }
+    // 2. 过滤
+    const matched = allLayers.filter((l) => matchesContext(l, ctx));
+    // 3. 排序 (priority 低 → 高, 同 priority 按 id 字母)
+    matched.sort((a, b) => a.priority - b.priority || a.id.localeCompare(b.id));
+    // 4. 装配 + 截断
+    const parts = [];
+    const used = [];
+    const truncated = [];
+    let usedChars = 0;
+    for (const layer of matched) {
+        if (usedChars >= TOTAL_BUDGET) {
+            truncated.push(layer.id);
+            continue;
+        }
+        let content = '';
+        if (layer.source === 'function' && layer.resolver) {
+            try {
+                content = await layer.resolver();
+            }
+            catch {
+                content = '';
+            }
+        }
+        else {
+            content = layer.content || '';
+        }
+        if (content.length > layer.maxChars) {
+            content = content.slice(0, layer.maxChars) + '\n[… 已截断]';
+            truncated.push(layer.id);
+        }
+        if (usedChars + content.length > TOTAL_BUDGET) {
+            const remain = TOTAL_BUDGET - usedChars;
+            if (remain > 100) {
+                content = content.slice(0, remain) + '\n[… 预算截断]';
+            }
+            else {
+                truncated.push(layer.id);
+                continue;
+            }
+        }
+        parts.push(`<!-- ${layer.id}@${layer.version} -->\n${content}`);
+        used.push(layer.id);
+        usedChars += content.length;
+    }
+    return {
+        text: stripHibsml(parts.join('\n\n')),
+        layerIds: used,
+        totalChars: usedChars,
+        truncated,
+        layers: matched, // P-Action 2: 把 meta 也带回, 供 health 端点
+    };
+}
+function matchesContext(layer, ctx) {
+    if (layer.appliesTo.includes('all'))
+        return true;
+    for (const a of layer.appliesTo) {
+        if (a === ctx.channel)
+            return true;
+        if (a.startsWith('role:') && a.slice(5) === ctx.role)
+            return true;
+        if (a.startsWith('tool:') && a.slice(5) === ctx.tool)
+            return true;
+    }
+    return false;
+}
+async function loadStaticLayer(id) {
+    const path2md = idToPath(id);
+    try {
+        const raw = await fs.readFile(path2md, 'utf-8');
+        const { meta, body } = parseFrontmatter(raw);
+        return { content: body, meta };
+    }
+    catch (err) {
+        console.warn(`[system-prompt] layer ${id} 读失败: ${err.message?.slice(0, 100)}`);
+        return { content: `<!-- ${id}: 文件丢失 -->`, meta: null };
+    }
+}
+function idToPath(id) {
+    // core.refusal → layers/core/refusal.md
+    // tool.bash → layers/tool/bash.md
+    // channel.p2p-visitor → layers/channel/p2p-visitor.md
+    // core.tools.thin → layers/core/tools.thin.md (注意: 第一段是 group, 后面整段是文件名)
+    const [group, ...rest] = id.split('.');
+    return path.join(LAYERS_DIR, group, `${rest.join('.')}.md`);
+}
+/** 列所有 layer, 供调试 / reviewer 看 */
+export function listLayers() {
+    return [...STATIC_LAYERS, ...DYNAMIC_LAYERS.map((l) => {
+            const { resolver, ...rest } = l;
+            return rest;
+        })];
+}
+/** 整体版本号 — 跟 hibs 1 对齐 */
+export const SYSTEM_PROMPT_VERSION = 'hibs-1.v1.0.0';