berry-agent 0.1.0-alpha.1

package/dist/host/boot-failures.js

@@ -0,0 +1,104 @@
+/**
+ * host/boot-failures — 启动失败点名账本（03 §5.7 失败三档②的记账面）。
+ *
+ * 行级装载失败的用户插件记入 `<dataDir>/boot-failures.json`：`{id, version,
+ * count}` 点名——count 随每次启动失败累加（启动横幅聚合 warn 的数据源）；
+ * 装载成功即清名（横幅只报当下仍坏的行）。core: 行不适用（fail-loud 拒启
+ * 狗粮纪律，§5.7）；清单校验失败属档①拒换、不进本账本。
+ *
+ * fs 动作全注入（内存 Map 可测）；文件形 = 单 JSON 对象 `{ failures:
+ * Record<id, {version, count}> }`（人读可改——诊断面友好）。
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+/**
+ * `[码] 报文` 形单源铸造（2026-09-13 复盘发现 ⑪——修前六处手抄：warn 横幅
+ * ×2 / CLI·TUI plugins list 失败行 / reload 行级失败清单 / plugin_boot 工具
+ * 面失败行 / 本件 lastError 账本）。回执、账本、横幅同一形——变格式只改此
+ * 处；结构满足 BootFailureDetail 即可喂入（id 徽记位由各消费面自拼）。
+ */
+export function formatPluginFailureText(failure) {
+    return `[${failure.code}] ${failure.message}`;
+}
+/** 缺省真盘实现（读失败一律 null——账本残缺不拦启动序，视同空账本） */
+function defaultFs() {
+    return {
+        read: (path) => {
+            try {
+                return readFileSync(path, 'utf8');
+            }
+            catch {
+                return null; // ENOENT / 坏权限——空账本语义（宁空勿炸：账本是诊断面非真相源）
+            }
+        },
+        write: (path, text) => writeFileSync(path, text),
+    };
+}
+/**
+ * 读账本（坏 JSON 视同空——账本非真相源，残缺不拦启动）。
+ */
+export function readBootFailures(path, fs = defaultFs()) {
+    const text = fs.read(path);
+    if (text === null)
+        return { failures: {} };
+    try {
+        const doc = JSON.parse(text);
+        if (doc === null || typeof doc !== 'object' || typeof doc.failures !== 'object' || doc.failures === null) {
+            return { failures: {} };
+        }
+        const failures = {};
+        for (const [id, entry] of Object.entries(doc.failures)) {
+            if (typeof entry === 'object' &&
+                entry !== null &&
+                typeof entry.version === 'string' &&
+                typeof entry.count === 'number') {
+                // obs-a 扩形字段容错携带：字符串在场即带出，非字符串/缺席静默剥除
+                // （旧形条目照常解析——缺席容错读，不迁移）
+                failures[id] = {
+                    version: entry.version,
+                    count: entry.count,
+                    ...(typeof entry.lastError === 'string'
+                        ? { lastError: entry.lastError }
+                        : {}),
+                    ...(typeof entry.lastFailedAt === 'string'
+                        ? { lastFailedAt: entry.lastFailedAt }
+                        : {}),
+                };
+            }
+        }
+        return { failures };
+    }
+    catch {
+        return { failures: {} }; // 坏 JSON——空账本语义
+    }
+}
+/**
+ * 记一次启动失败（count 累加；version 就地刷新为本次版本；lastError/lastFailedAt
+ * 刷新为最近一次——03 §5.7② obs-a）——读改写整账本。
+ */
+export function recordBootFailure(path, id, version, failure, fs = defaultFs()) {
+    const doc = readBootFailures(path, fs);
+    const prev = doc.failures[id];
+    const next = { ...doc.failures };
+    // lastError = `[码] 报文` 形帽 500 字符（obs-a 定形注——防账本膨胀；超长截断；
+    // 格式单源 = formatPluginFailureText——发现 ⑪）
+    const text = formatPluginFailureText(failure);
+    next[id] = {
+        version,
+        count: (prev?.count ?? 0) + 1,
+        lastError: text.length > 500 ? text.slice(0, 500) : text,
+        lastFailedAt: new Date().toISOString(),
+    };
+    const written = { failures: next };
+    fs.write(path, `${JSON.stringify(written, null, 2)}\n`);
+    return written;
+}
+/**
+ * 清名（装载成功即报捷——横幅只报仍坏行）。
+ */
+export function clearBootFailure(path, id, fs = defaultFs()) {
+    const doc = readBootFailures(path, fs);
+    const { [id]: _removed, ...rest } = doc.failures;
+    const written = { failures: rest };
+    fs.write(path, `${JSON.stringify(written, null, 2)}\n`);
+    return written;
+}

package/dist/host/budget-advisory.js

@@ -0,0 +1,74 @@
+/**
+ * host/budget-advisory — 预算预警文案铸造（04 §5 软着陆层——遗漏审计批 H）。
+ *
+ * 04 §5 预算预警条款的文案本体位：档位判定与投影读面在 llm 件单源
+ * （budgetAdvisoryLevel / backgroundUsage），本件只做两件事——
+ *  1. 预算帽下活判据（run 级后台性——2026-09-13 全面复盘修复批）：本层
+ *     只对预算帽下的活生效（headless root run、后台道无头 run〔tick 用户行
+ *     /goal 挂钟行/run --background〕、子代理）；前台 run 恒放行无池可警
+ *     （origin 会话级两判 + backgroundLane run 级声明位——见总入口注）；
+ *  2. root 与 subagent 各配分级 wrap-up 文案（三档 × 两族）：CRITICAL 档指令
+ *     「收尾：陈述当前结论与未竟项」而非续开新腿——预算尽头的最后 token
+ *     花在收口上。
+ *
+ * 产物 = 纯文本（经 driver 的 budgetAdvisory 注入位以瞬态 UserMessage 进请求
+ * 组装尾——不落 durable 不进快照，与披露段/todo 回看同律）。本件零状态零 IO
+ * （纯函数族），装配根闭包消费（assembly）。
+ */
+import { budgetAdvisoryLevel } from '../llm/index.js';
+/** 百分比渲染（四舍五入取整——文案显示位非账面值） */
+function pctOf(ratio) {
+    return Math.round(ratio * 100);
+}
+/**
+ * root 档文案族（headless 主循环——issue 道 / 触发器道 / goal 续跑道）：
+ * 面向「任务的所有者」——三档递进收敛（收敛探索面 → 停开新腿 → 立即收尾）。
+ */
+function rootMessage(level, usage) {
+    const pct = pctOf(usage.ratio);
+    const scale = `当日后台预算已用约 ${pct}%（${usage.spent}/${usage.limit} tokens）`;
+    if (level === 'notice') {
+        return `[预算提示 NOTICE] ${scale}。请收敛探索面，优先主线任务。`;
+    }
+    if (level === 'urgent') {
+        return `[预算预警 URGENT] ${scale}。请停止开启新的工作腿，专注完成当前任务。`;
+    }
+    return `[预算临界 CRITICAL] ${scale}。请立即收尾：陈述当前结论与未竟项，不要再开启新的工作腿。`;
+}
+/**
+ * subagent 档文案族（委派子代理——任务黑盒）：面向「单任务的执行者」——
+ * 收敛本任务范围；CRITICAL 档汇报归路（父会话将据此结算）。子代理另有 90%
+ * reserve 线强停（subagent-factory 执法），本层是强停之前的软着陆带。
+ */
+function subagentMessage(level, usage) {
+    const pct = pctOf(usage.ratio);
+    const scale = `当日后台预算池已用约 ${pct}%`;
+    if (level === 'notice') {
+        return `[预算提示 NOTICE] ${scale}。请收敛本任务范围，避免不必要的大范围探索。`;
+    }
+    if (level === 'urgent') {
+        return `[预算预警 URGENT] ${scale}。请停止扩展任务面，专注完成当前子任务。`;
+    }
+    return `[预算临界 CRITICAL] ${scale}。请立即收尾：汇报当前结论与未竟项（父会话将据此结算），不要再开启新的工作腿。`;
+}
+/**
+ * 预算预警文案总入口（04 §5——root/subagent 分族 + run 级后台性判据）：
+ *  - 未达 notice 线（< 70%）→ null 零注入；
+ *  - origin 'trigger'（headless root 两道：issue-session / triggers）→ root 族；
+ *  - origin 'delegation'（in-process 子代理）→ subagent 族；
+ *  - origin 余三（conversation/import/fork）按 run 级后台道声明位：
+ *    backgroundRun true（tick 用户行/goal 挂钟行共用 runSession 声明、
+ *    `run --background` 入口声明）→ root 族；缺省 false = 前台恒 null
+ *    （无池可警——goal 前台轮记 goal 件内预算非后台日池，同 null）；
+ *  - 不在册会话（origin undefined，如 retire 后）同 null。
+ */
+export function budgetAdvisoryMessage(usage, origin, backgroundRun) {
+    const level = budgetAdvisoryLevel(usage.ratio);
+    if (level === null)
+        return null;
+    if (origin === 'delegation')
+        return subagentMessage(level, usage);
+    if (origin === 'trigger' || backgroundRun)
+        return rootMessage(level, usage);
+    return null;
+}

package/dist/host/budget-broadcast.js

@@ -0,0 +1,50 @@
+/** 广播轮询间隔缺省（1s——issue watcher 原值平移；测试注窄值驱动时序） */
+const DEFAULT_POLL_MS = 1000;
+/**
+ * 宿主级 budget-extended 广播件真身（装配根单真身——issue 工厂/goal 件/
+ * 未来会话级编排位共用；issue 工厂注入位缺席时工厂自建私有实例走同一
+ * 实现，单源零重复）。
+ */
+export function createBudgetBroadcast(options) {
+    const canAfford = options.canAfford;
+    const pollMs = options.pollMs ?? DEFAULT_POLL_MS;
+    /** 停靠登记表（三面共享——电平判扫描面，进程生命周期） */
+    const entries = new Set();
+    /** 停机已收口旗（dispose 后 register 诚实拒——不静默吞登记） */
+    let disposed = false;
+    // 电平判 watcher（原 issue 工厂私有 watcher 逐字升格）：有停靠项且
+    // canAfford 恢复即逐项唤醒（snapshot 遍历——wake 内自摘登记不扰迭代）
+    const watcher = setInterval(() => {
+        if (entries.size === 0)
+            return;
+        if (!canAfford())
+            return;
+        for (const entry of [...entries])
+            entry.wake();
+    }, pollMs);
+    watcher.unref();
+    return {
+        register(entry) {
+            if (disposed)
+                throw new Error('budget-broadcast 已 dispose——停靠项登记不可达（装配序错位防御）');
+            entries.add(entry);
+        },
+        unregister(entry) {
+            entries.delete(entry);
+        },
+        size() {
+            return entries.size;
+        },
+        dispose() {
+            if (disposed)
+                return; // 幂等（宿主 closer 双跑无害）
+            disposed = true;
+            clearInterval(watcher);
+            // 逐项停机收口（issue 面的 resolve paused 语义住 entry 自身；goal 面
+            // 停靠事实本 durable——goals 表/挂钟行/会话词全在，dispose 可无操作）
+            for (const entry of [...entries])
+                entry.dispose?.();
+            entries.clear();
+        },
+    };
+}

package/dist/host/builtins.js

@@ -0,0 +1,54 @@
+/**
+ * host/builtins — Node 内建模块裸名闭集（import 门禁裁决核的裸名分类面）。
+ *
+ * 名单 = Node LTS 内建集（node: 协议合法名）。白名单道②只收 `node:` 前缀
+ * 形（03 §3.3 字面）——本清单用于裁决核把裸名分类为「裸内建被拒——用
+ * node: 前缀」（报文指路），与裸第三方说明符的「树内不可解析」报文分流。
+ * 随 Node 版本演进的名单差异：门禁语义按「可被 node: 前缀合法访问的内建」
+ * 对账，新增内建随真实需求补列（fail-closed：不在清单的裸名走裸说明符道，
+ * 树内不可解析同拒）。
+ */
+export const BARE_BUILTINS = new Set([
+    'assert',
+    'async_hooks',
+    'buffer',
+    'child_process',
+    'cluster',
+    'console',
+    'constants',
+    'crypto',
+    'dgram',
+    'diagnostics_channel',
+    'dns',
+    'domain',
+    'events',
+    'fs',
+    'http',
+    'http2',
+    'https',
+    'inspector',
+    'module',
+    'net',
+    'os',
+    'path',
+    'perf_hooks',
+    'process',
+    'punycode',
+    'querystring',
+    'readline',
+    'repl',
+    'stream',
+    'string_decoder',
+    'sys',
+    'timers',
+    'tls',
+    'trace_events',
+    'tty',
+    'url',
+    'util',
+    'v8',
+    'vm',
+    'wasi',
+    'worker_threads',
+    'zlib',
+]);