@qjp88995/agent-runtime 0.0.0-stage → 0.1.1

package/dist/subagent/output-scan.js

@@ -0,0 +1,41 @@
+/** 会被中和的控制标签名。 */
+const CONTROL_TAGS = [
+    'system-reminder',
+    'system',
+    'important_instructions',
+    'function_results',
+];
+/** 权限配置类措辞：只标记，不改文本。 */
+const PERMISSION_PATTERNS = [
+    /bypassPermissions/i,
+    /permissions?\.(allow|deny)/i,
+    /dangerously[-_]?skip/i,
+];
+/**
+ * 扫描子 agent 返回文本里的「指令形状」模式。
+ *
+ * 原则：**只中和不删改** —— 保留全部语义供人排查，只是让它无法被
+ * 父模型当成控制指令。命中项另外打标记，调用方可据此在 UI 上提示。
+ */
+export function scanSubagentOutput(text) {
+    const flagged = new Set();
+    let out = text;
+    // ① 伪造的控制标签：在 < 后插反斜杠。
+    const tagPattern = new RegExp(`<(/?)(?:${CONTROL_TAGS.join('|')})(\\s[^>]*)?>`, 'gi');
+    if (tagPattern.test(out)) {
+        flagged.add('control-tag');
+        out = out.replace(tagPattern, m => `<\\${m.slice(1)}`);
+    }
+    // ② 伪造的轮次标记：**必须行首**，避免误伤句中出现的同名词。
+    const turnPattern = /^(Human|Assistant|System)\s*:/gm;
+    if (turnPattern.test(out)) {
+        flagged.add('turn-marker');
+        out = out.replace(turnPattern, (_m, role) => `${role}\\:`);
+    }
+    // ③ 权限配置措辞：只标记，原样保留。
+    if (PERMISSION_PATTERNS.some(p => p.test(out))) {
+        flagged.add('permission-mention');
+    }
+    return { text: out, flagged: [...flagged] };
+}
+//# sourceMappingURL=output-scan.js.map

package/dist/subagent/output-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-scan.js","sourceRoot":"","sources":["../../src/subagent/output-scan.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,MAAM,YAAY,GAAG;IACnB,iBAAiB;IACjB,QAAQ;IACR,wBAAwB;IACxB,kBAAkB;CACnB,CAAC;AAEF,wBAAwB;AACxB,MAAM,mBAAmB,GAAG;IAC1B,oBAAoB;IACpB,6BAA6B;IAC7B,uBAAuB;CACxB,CAAC;AASF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,GAAG,GAAG,IAAI,CAAC;IAEf,uBAAuB;IACvB,MAAM,UAAU,GAAG,IAAI,MAAM,CAC3B,WAAW,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,EAChD,IAAI,CACL,CAAC;IACF,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,mCAAmC;IACnC,MAAM,WAAW,GAAG,iCAAiC,CAAC;IACtD,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,IAAY,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACrE,CAAC;IAED,qBAAqB;IACrB,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC;AAC9C,CAAC"}

package/dist/subagent/registry-spawn-policy.d.ts

@@ -0,0 +1,32 @@
+import type { SubagentAccess, SubagentMeta, SubagentRegistry } from './subagent-registry.js';
+import type { SpawnPolicy, SpawnRequest } from './subagent-sessions.js';
+export interface RegistrySpawnPolicyOptions<M extends SubagentMeta> {
+    /**
+     * 这次派生的判据输入（发起人的权限点、父允不允许派要权限点的、父点了哪些名）。缺省：
+     * 只有发起人的权限点，父不允许派要权限点的，不点名任何一个——fail-closed。
+     * **花名册必须用同一份**（`registry.roster(access, filter)`）。
+     */
+    access?(req: SpawnRequest): SubagentAccess;
+    /** 宿主的附加条件（同 `roster` 的 `filter`）。不过 = 当作没有这个子 Agent。 */
+    filter?(meta: M, req: SpawnRequest): boolean;
+    /**
+     * 宿主的额外拒绝（agent-base：调用方模型自己就能看图，还派识图员）。返回一句话 = 拒绝，
+     * 原样给模型；返回 null = 放行。
+     */
+    refuse?(meta: M, req: SpawnRequest): string | null;
+    /** 权限点的显示名（拒绝文案里用）。缺省原样写 key。 */
+    permissionLabel?(permission: string): string;
+    /** 派生成功时写进子会话行的宿主附加列。 */
+    attrs?(meta: M, req: SpawnRequest): Readonly<Record<string, unknown>>;
+    /** 同 `SpawnPolicy.onSubagentCreated`。 */
+    onSubagentCreated?: SpawnPolicy['onSubagentCreated'];
+}
+/**
+ * 以 `SubagentRegistry` 为准的派生策略：注册表里有（认旧名、看可用性）、过了权限点与点名
+ * 挂载、过了宿主的附加条件才派得出。与 `registry.roster(...)` 是同一个判据。
+ *
+ * 子会话钉住的是请求里的那个名字；之后每个 tick 宿主按它 `registry.get(name)` 取定义
+ * （旧名照样认得）。
+ */
+export declare function registrySpawnPolicy<M extends SubagentMeta>(registry: SubagentRegistry<M>, options?: RegistrySpawnPolicyOptions<M>): SpawnPolicy;
+//# sourceMappingURL=registry-spawn-policy.d.ts.map

package/dist/subagent/registry-spawn-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-spawn-policy.d.ts","sourceRoot":"","sources":["../../src/subagent/registry-spawn-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAEV,WAAW,EACX,YAAY,EACb,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,YAAY;IAChE;;;;OAIG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,YAAY,GAAG,cAAc,CAAC;IAC3C,yDAAyD;IACzD,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC;IAC7C;;;OAGG;IACH,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAAC;IACnD,iCAAiC;IACjC,eAAe,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,yBAAyB;IACzB,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtE,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,WAAW,CAAC,mBAAmB,CAAC,CAAC;CACtD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,YAAY,EACxD,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC7B,OAAO,GAAE,0BAA0B,CAAC,CAAC,CAAM,GAC1C,WAAW,CAyCb"}

package/dist/subagent/registry-spawn-policy.js

@@ -0,0 +1,48 @@
+/**
+ * 以 `SubagentRegistry` 为准的派生策略：注册表里有（认旧名、看可用性）、过了权限点与点名
+ * 挂载、过了宿主的附加条件才派得出。与 `registry.roster(...)` 是同一个判据。
+ *
+ * 子会话钉住的是请求里的那个名字；之后每个 tick 宿主按它 `registry.get(name)` 取定义
+ * （旧名照样认得）。
+ */
+export function registrySpawnPolicy(registry, options = {}) {
+    return {
+        checkSpawn(req) {
+            const meta = registry.get(req.agentName);
+            if (!meta || !(options.filter?.(meta, req) ?? true)) {
+                return Promise.resolve({ ok: false, reason: 'unknown' });
+            }
+            const access = options.access?.(req) ?? {
+                permissions: req.initiatorPermissions,
+            };
+            if (!registry.permits(meta, access)) {
+                // 点名挂载的没点名：对这个父它就不存在。
+                if (!meta.permission) {
+                    return Promise.resolve({ ok: false, reason: 'unknown' });
+                }
+                // 说清是「谁、在哪儿」不够格，而不是「没有这个子 Agent」——后者会让模型换个名字再试。
+                const label = options.permissionLabel?.(meta.permission) ?? meta.permission;
+                return Promise.resolve({
+                    ok: false,
+                    reason: 'refused',
+                    message: `${meta.name} 需要「${label}」权限，而且只能从允许派它的 Agent 里派出。` +
+                        '这一轮的发起人没有这个权限、或当前 Agent 不允许，无法派生；需要这类数据请告诉用户去找管理员开通。',
+                });
+            }
+            const refused = options.refuse?.(meta, req) ?? null;
+            if (refused !== null) {
+                return Promise.resolve({
+                    ok: false,
+                    reason: 'refused',
+                    message: refused,
+                });
+            }
+            const attrs = options.attrs?.(meta, req);
+            return Promise.resolve(attrs ? { ok: true, attrs } : { ok: true });
+        },
+        ...(options.onSubagentCreated
+            ? { onSubagentCreated: options.onSubagentCreated }
+            : {}),
+    };
+}
+//# sourceMappingURL=registry-spawn-policy.js.map

package/dist/subagent/registry-spawn-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-spawn-policy.js","sourceRoot":"","sources":["../../src/subagent/registry-spawn-policy.ts"],"names":[],"mappings":"AAiCA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA6B,EAC7B,UAAyC,EAAE;IAE3C,OAAO;QACL,UAAU,CAAC,GAAiB;YAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;gBACpD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI;gBACtC,WAAW,EAAE,GAAG,CAAC,oBAAoB;aACtC,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACpC,sBAAsB;gBACtB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;oBACrB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC3D,CAAC;gBACD,gDAAgD;gBAChD,MAAM,KAAK,GACT,OAAO,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC;gBAChE,OAAO,OAAO,CAAC,OAAO,CAAC;oBACrB,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE,SAAS;oBACjB,OAAO,EACL,GAAG,IAAI,CAAC,IAAI,OAAO,KAAK,2BAA2B;wBACnD,sDAAsD;iBACzD,CAAC,CAAC;YACL,CAAC;YACD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC;YACpD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,OAAO,CAAC,OAAO,CAAC;oBACrB,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE,SAAS;oBACjB,OAAO,EAAE,OAAO;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACzC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,GAAG,CAAC,OAAO,CAAC,iBAAiB;YAC3B,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC"}

package/dist/subagent/roster-block.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 「可派生的子 Agent」索引块——常驻 system prompt，取代原来的 `ListAgents`
+ * 工具（2026-07-31 删除）。与技能索引是同一个形状、同一套理由：花名册对一次会话是固定的，做成工具意味着模型每次想派生前都要多一
+ * 次完整的 LLM round-trip（重发 system + 全部历史 + 全部工具定义）才能拿回这
+ * 几行字，而常驻的那份落在 provider 的自动前缀缓存里几乎不额外计费。
+ *
+ * **与技能索引的一处有意差异：没有末尾提醒行。** 技能那边有一条硬约束
+ * （「别凭印象写，先读规则」），值得花 30 token 买回 recency 位置；派生子
+ * Agent 是一个**可选的效率手段**，不是必须遵守的规则——为它再加一句常驻提醒
+ * 只会稀释真正的约束，还会诱导模型为了用而用。
+ *
+ * 零框架、零 IO，纯函数便于单测。
+ */
+/** 花名册的一行（`SubagentRegistry.roster` 的返回，宿主可以再拼上自己的）。 */
+export interface SubagentIndexEntry {
+    name: string;
+    description: string;
+    /**
+     * 分组：`own` = 宿主给这个会话自己的（组名缺省「你自己的：」）、`platform` = 平台内置的。
+     * **名单里没有一条 `own` 时渲染与不带分组逐字相同**。
+     */
+    group?: 'own' | 'platform';
+}
+/**
+ * 描述的硬上限（按 code point 计）。同技能索引：索引常驻
+ * system prompt，而描述在后台是不限长的自由文本，渲染侧必须兜底，否则运营
+ * 写一段长说明就会静默抬高每一轮的成本。
+ */
+export declare const DESC_LIMIT = 60;
+/** 有自己的一组时，那一组的组名缺省值。 */
+export declare const OWN_GROUP_HEADING = "\u4F60\u81EA\u5DF1\u7684\uFF1A";
+/**
+ * 子 Agent 花名册块。
+ *
+ * **空名单返回空串**——两种情况都会走到：这个 agent 没配任何私有子 Agent 且
+ * 内置注册表也是空的，或者**深度已经触顶**（调用方那时不该传名单进来，见
+ * `canDelegate`：同一个判据还会把 `Delegate` 从工具集里物理摘掉）。
+ * 后一种尤其要紧：名单还在、工具没了，模型会反复尝试一个它根本看不见的
+ * 工具——那正是 `excludeTools` 想省掉的 token。
+ */
+export declare function buildSubagentIndexBlock(agents: readonly SubagentIndexEntry[], options?: {
+    toolName?: string;
+    ownHeading?: string;
+}): string;
+//# sourceMappingURL=roster-block.d.ts.map

package/dist/subagent/roster-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster-block.d.ts","sourceRoot":"","sources":["../../src/subagent/roster-block.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC;CAC5B;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,yBAAyB;AACzB,eAAO,MAAM,iBAAiB,mCAAU,CAAC;AA+BzC;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,MAAM,CAwBR"}

package/dist/subagent/roster-block.js

@@ -0,0 +1,69 @@
+import { DELEGATE_TOOL_NAME } from '../tools/builtin-names.js';
+/**
+ * 描述的硬上限（按 code point 计）。同技能索引：索引常驻
+ * system prompt，而描述在后台是不限长的自由文本，渲染侧必须兜底，否则运营
+ * 写一段长说明就会静默抬高每一轮的成本。
+ */
+export const DESC_LIMIT = 60;
+/** 有自己的一组时，那一组的组名缺省值。 */
+export const OWN_GROUP_HEADING = '你自己的：';
+function truncate(text, limit) {
+    // Array.from 按 code point 切，避免把 emoji / 生僻字的代理对劈成半个。
+    const chars = Array.from(text);
+    return chars.length <= limit ? text : `${chars.slice(0, limit).join('')}...`;
+}
+function lineOf(a) {
+    const desc = truncate(a.description.trim(), DESC_LIMIT);
+    return desc ? `- ${a.name}：${desc}` : `- ${a.name}`;
+}
+/**
+ * 有主体自己的 Agent 时分两组（「你自己的：」「平台：」，空组不出）；没有时一行一条、
+ * 与分组出现之前逐字相同。
+ */
+function linesOf(agents, ownHeading) {
+    if (!agents.some(a => a.group === 'own'))
+        return agents.map(lineOf);
+    const own = agents.filter(a => a.group === 'own');
+    const platform = agents.filter(a => a.group !== 'own');
+    return [
+        ownHeading,
+        ...own.map(lineOf),
+        ...(platform.length > 0 ? ['平台：', ...platform.map(lineOf)] : []),
+    ];
+}
+/**
+ * 子 Agent 花名册块。
+ *
+ * **空名单返回空串**——两种情况都会走到：这个 agent 没配任何私有子 Agent 且
+ * 内置注册表也是空的，或者**深度已经触顶**（调用方那时不该传名单进来，见
+ * `canDelegate`：同一个判据还会把 `Delegate` 从工具集里物理摘掉）。
+ * 后一种尤其要紧：名单还在、工具没了，模型会反复尝试一个它根本看不见的
+ * 工具——那正是 `excludeTools` 想省掉的 token。
+ */
+export function buildSubagentIndexBlock(agents, options = {}) {
+    if (agents.length === 0)
+        return '';
+    const toolName = options.toolName ?? DELEGATE_TOOL_NAME;
+    const lines = linesOf(agents, options.ownHeading ?? OWN_GROUP_HEADING);
+    // **不要在这里描述「什么时候适合派」。** 曾经写着「适合可并行、可切分的工作」
+    // ——那是首批 fan-out 场景（按脚本分片分析）的遗留，而它与下面每一条子 Agent
+    // 自己的描述**直接打架**：`general-purpose` 的描述是「适合把一段自包含的任务
+    // 整个交出去」，一整篇文章正是它，却被上面那句「可并行、可切分」排除掉。真机
+    // 上撞到过后果——模型面对一件超出自身设定的整块工作，建议用户「另找一个通用
+    // 写作类的 Agent」，而那个 Agent 就在它这份名单里。
+    //
+    // 两句都是平台写的，模型只能在两个平台声明之间挑一个。适用场景归各条目自己的
+    // description（运营维护，才知道自己那个子 Agent 是干嘛的），这里只讲机制。
+    //
+    // 同理**不写「在后台」**：`Delegate` 默认是**同步等待**（等子跑完直接返回
+    // 产出），只有显式传 `run_in_background: true` 才是后台。那半句话是工具还只有
+    // 异步模式时留下的，与工具描述里「默认会等它跑完并直接把结论返回给你」冲突。
+    return [
+        '【可派生的子 Agent】',
+        `下面这些子 Agent 可以用 ${toolName} 派生，独立完成一段子任务。`,
+        '子 Agent 看不到你的对话历史，任务描述要自包含。',
+        '',
+        ...lines,
+    ].join('\n');
+}
+//# sourceMappingURL=roster-block.js.map

package/dist/subagent/roster-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster-block.js","sourceRoot":"","sources":["../../src/subagent/roster-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AA2B/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAE7B,yBAAyB;AACzB,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAEzC,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAa;IAC3C,qDAAqD;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC;AAC/E,CAAC;AAED,SAAS,MAAM,CAAC,CAAqB;IACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CACd,MAAqC,EACrC,UAAkB;IAElB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACvD,OAAO;QACL,UAAU;QACV,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;QAClB,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAqC,EACrC,UAAsD,EAAE;IAExD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,kBAAkB,CAAC;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC,CAAC;IACvE,2CAA2C;IAC3C,gDAAgD;IAChD,mDAAmD;IACnD,wCAAwC;IACxC,wCAAwC;IACxC,kCAAkC;IAClC,EAAE;IACF,wCAAwC;IACxC,gDAAgD;IAChD,EAAE;IACF,gDAAgD;IAChD,sDAAsD;IACtD,wCAAwC;IACxC,OAAO;QACL,eAAe;QACf,mBAAmB,QAAQ,gBAAgB;QAC3C,6BAA6B;QAC7B,EAAE;QACF,GAAG,KAAK;KACT,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/subagent/situation-block.d.ts

@@ -0,0 +1,16 @@
+/** 宿主 system prompt 里放 agent 自己那段提示词的块名缺省值。 */
+export declare const DEFAULT_AGENT_PROMPT_BLOCK = "\u3010Agent \u7CFB\u7EDF\u63D0\u793A\u8BCD\u3011";
+export interface SubagentSituationOptions {
+    /**
+     * 让位给哪一块：宿主 system prompt 里放这个子 Agent 自己那段提示词的块名。缺省
+     * `DEFAULT_AGENT_PROMPT_BLOCK`；`null` = 不写让位那一段（宿主的 system prompt 不分块时）。
+     * **按块名指路，不用「上面 / 下面」**——块序会动，靠位置表达的关系会静默失效。
+     */
+    agentPromptBlock?: string | null;
+}
+/**
+ * 子 Agent 处境说明。`isSubagent` 为假返回空串（根会话没有「调用方」，这段话
+ * 每一句都不成立）。
+ */
+export declare function buildSubagentSituationBlock(isSubagent: boolean, options?: SubagentSituationOptions): string;
+//# sourceMappingURL=situation-block.d.ts.map

package/dist/subagent/situation-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"situation-block.d.ts","sourceRoot":"","sources":["../../src/subagent/situation-block.ts"],"names":[],"mappings":"AAkDA,+CAA+C;AAC/C,eAAO,MAAM,0BAA0B,qDAAkB,CAAC;AAE1D,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,OAAO,EACnB,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAaR"}

package/dist/subagent/situation-block.js

@@ -0,0 +1,71 @@
+/**
+ * 「你是一个子 Agent」处境说明块 —— **只对子会话渲染**，常驻 system prompt。
+ *
+ * ## 为什么这段必须由平台给，而不是让每个子 Agent 的提示词自己写
+ *
+ * 子 Agent 的系统提示词**完全**是运营写的那段（宿主合成子 Agent 定义时就是那段提示词，平台一个字都不掺）。这段文字
+ * 原先住在内置 `general-purpose` 的人格里，于是只有用它派生出来的子 Agent 知道
+ * 自己的处境；运营在后台自建的私有子 Agent 一概不知道 —— 而它们并不因此少受
+ * 这些机制的约束，只是**不知道**而已。最贵的一条是「信息不足可以交回去问」：
+ * 不知道这条路存在的子 Agent，缺参数时会挑一个看起来合理的值继续做完，而它编
+ * 出来的产出在调用方眼里**完全正常**。
+ *
+ * 三段讲的都是**运行时事实**，不是行为规范：
+ * - 看不到调用方历史 → 子会话是独立的 `chat_session`，硬隔离。
+ * - 产出原样回投 → `finalizeIfIdle` 取本轮全部 assistant text part 拼接、经
+ *   `scanSubagentOutput` 中和后交给调用方（同步等待时由 `Delegate` 直接取走）。
+ * - 交回去还能接着跑 → 调用方 `Delegate(handle)` 往子会话投一条消息即可，
+ *   历史原样都在（这半条能力 2026-08-02 才补上；在那之前只有人能软插话进来，
+ *   而这段话已经在 `general-purpose` 里承诺了很久）。
+ *
+ * ## 它不与运营的提示词竞争
+ *
+ * 末尾显式让位给【Agent 系统提示词】那一块。这不是客套：真有运营写「无论如何
+ * 都要给出结论、不许空手回来」，那是它对这个子 Agent 的定位，该赢。平台这段只
+ * 负责把「有哪些路可走」说清楚，不替运营决定该走哪条。
+ *
+ * **用块名指路，不用「上面/下面」** —— 块序还会再动，靠位置表达的关系会在下一
+ * 次调整时静默失效（同 `AGENT_PROMPT_AUTHORITY` 的规矩）。
+ *
+ * 零框架、零 IO，纯函数便于单测。
+ */
+const SITUATION_BODY = [
+    '【你的处境】',
+    '你是一个**子 Agent**：由另一个 Agent 派生出来，独立完成它交给你的一段任务。',
+    '这三件事是这套运行时的机制，不是措辞——',
+    '',
+    '**你看不到调用方的对话历史。** 交给你的任务描述就是你能拿到的全部背景；其中没有',
+    '写明的东西，要么用工具查证，要么当作未知，不要凭印象假设。',
+    '',
+    '**你这一轮说的话会原样回到调用方那里。** 它读到的就是你的全部输出，没有旁白，也',
+    '看不到你的中间步骤。所以结论要自包含，不要用「如上所述」「刚才那个文件」这类指向',
+    '它看不到的东西的说法；不必复述做过的每一步，但支撑结论的关键依据——查到的事实、',
+    '文件位置、具体数据——要一并带上，让它不用重跑一遍就能采信。',
+    '',
+    '**信息不够时可以交回去问，不必硬撑。** 缺的东西自己查不到、也无从推断时，不要空手',
+    '返回，更不要编一个答案：把已经确定的部分、卡在哪里、还需要什么，一起交回去。调用方',
+    '补充之后可以让你接着跑——届时你们之前的全部往来都还在，你不必重头再来，它也不用把',
+    '背景重讲一遍。',
+].join('\n');
+/** 宿主 system prompt 里放 agent 自己那段提示词的块名缺省值。 */
+export const DEFAULT_AGENT_PROMPT_BLOCK = '【Agent 系统提示词】';
+/**
+ * 子 Agent 处境说明。`isSubagent` 为假返回空串（根会话没有「调用方」，这段话
+ * 每一句都不成立）。
+ */
+export function buildSubagentSituationBlock(isSubagent, options = {}) {
+    if (!isSubagent)
+        return '';
+    const block = options.agentPromptBlock === undefined
+        ? DEFAULT_AGENT_PROMPT_BLOCK
+        : options.agentPromptBlock;
+    if (block === null)
+        return SITUATION_BODY;
+    return [
+        SITUATION_BODY,
+        '',
+        `以上是平台对运行方式的说明。具体做什么、按什么标准做，以${block}那一段`,
+        '为准；两者冲突时听那一段的。',
+    ].join('\n');
+}
+//# sourceMappingURL=situation-block.js.map

package/dist/subagent/situation-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"situation-block.js","sourceRoot":"","sources":["../../src/subagent/situation-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,cAAc,GAAG;IACrB,QAAQ;IACR,gDAAgD;IAChD,sBAAsB;IACtB,EAAE;IACF,4CAA4C;IAC5C,+BAA+B;IAC/B,EAAE;IACF,4CAA4C;IAC5C,0CAA0C;IAC1C,0CAA0C;IAC1C,gCAAgC;IAChC,EAAE;IACF,6CAA6C;IAC7C,2CAA2C;IAC3C,2CAA2C;IAC3C,SAAS;CACV,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,+CAA+C;AAC/C,MAAM,CAAC,MAAM,0BAA0B,GAAG,eAAe,CAAC;AAW1D;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAmB,EACnB,UAAoC,EAAE;IAEtC,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,KAAK,GACT,OAAO,CAAC,gBAAgB,KAAK,SAAS;QACpC,CAAC,CAAC,0BAA0B;QAC5B,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IAC/B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,cAAc,CAAC;IAC1C,OAAO;QACL,cAAc;QACd,EAAE;QACF,+BAA+B,KAAK,KAAK;QACzC,gBAAgB;KACjB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/subagent/spawn-guards.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 子 Agent 深度上限。Claude Code 是 5；首批场景是单层 fan-out，3 足够且更安全。
+ * 深度 3 的树最深 4 层。宿主可经 `SubagentSessions` / `canDelegate` 的入参改。
+ */
+export declare const MAX_SUBAGENT_DEPTH = 3;
+/** 每棵树（根会话）同时存活的子 Agent 数缺省上限（`TreeBudget` 计数）。 */
+export declare const MAX_LIVE_SUBS_PER_TREE = 20;
+/**
+ * 能否再往下派生。
+ *
+ * **调用点在构造本轮工具集时**，命中即从工具集里物理摘掉 `Delegate`——模型看不见
+ * 就不会试，比事后报错干净，也不浪费 token 产生错误路径。工具里那道判断是后备。
+ */
+export declare function canSpawnDeeper(currentDepth: number, maxDepth?: number): boolean;
+/**
+ * 这一轮该不该把 `Delegate` 与花名册端上桌：深度没触顶、且这个子 Agent 不是叶子
+ * （`SubagentRegistry.isLeaf`）。**两处消费必须同进同退**——只摘工具会留下一份广告着
+ * 不存在工具的名单，只去名单则模型仍会凭工具定义去试。所以只算这一次。
+ */
+export declare function canDelegate(depth: number, leaf: boolean, maxDepth?: number): boolean;
+/**
+ * 触顶时返回给模型的文案。**写成引导语而非错误**——让模型改用自己的工具干完剩余
+ * 工作，而不是让整个 run 失败。
+ *
+ * 深度与树配额是两种不同的限制（层级 vs 同时存活数），正确的下一步也不同（深度是
+ * 本层永久的；树配额随子 Agent 结束而释放），必须分开措辞——曾共用一句「派生次数
+ * 已达本轮上限」，对两者各说错一半。
+ */
+export declare const DEPTH_EXHAUSTED_HINT = "\u5B50 Agent \u7684\u6D3E\u751F\u5C42\u7EA7\u5DF2\u8FBE\u4E0A\u9650\uFF0C\u8FD9\u4E00\u5C42\u4E0D\u80FD\u518D\u5F80\u4E0B\u6D3E\u751F\u3002\u8BF7\u7528\u4F60\u81EA\u5DF1\u7684\u5DE5\u5177\u5B8C\u6210\u5269\u4F59\u5DE5\u4F5C\u3002";
+export declare function treeFullHint(limit: number): string;
+export declare const TREE_FULL_HINT: string;
+//# sourceMappingURL=spawn-guards.d.ts.map

package/dist/subagent/spawn-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-guards.d.ts","sourceRoot":"","sources":["../../src/subagent/spawn-guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,mDAAmD;AACnD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,MAA2B,GACpC,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,MAA2B,GACpC,OAAO,CAET;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,0OACe,CAAC;AAEjD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED,eAAO,MAAM,cAAc,QAAuC,CAAC"}

package/dist/subagent/spawn-guards.js

@@ -0,0 +1,39 @@
+/**
+ * 子 Agent 深度上限。Claude Code 是 5；首批场景是单层 fan-out，3 足够且更安全。
+ * 深度 3 的树最深 4 层。宿主可经 `SubagentSessions` / `canDelegate` 的入参改。
+ */
+export const MAX_SUBAGENT_DEPTH = 3;
+/** 每棵树（根会话）同时存活的子 Agent 数缺省上限（`TreeBudget` 计数）。 */
+export const MAX_LIVE_SUBS_PER_TREE = 20;
+/**
+ * 能否再往下派生。
+ *
+ * **调用点在构造本轮工具集时**，命中即从工具集里物理摘掉 `Delegate`——模型看不见
+ * 就不会试，比事后报错干净，也不浪费 token 产生错误路径。工具里那道判断是后备。
+ */
+export function canSpawnDeeper(currentDepth, maxDepth = MAX_SUBAGENT_DEPTH) {
+    return currentDepth < maxDepth;
+}
+/**
+ * 这一轮该不该把 `Delegate` 与花名册端上桌：深度没触顶、且这个子 Agent 不是叶子
+ * （`SubagentRegistry.isLeaf`）。**两处消费必须同进同退**——只摘工具会留下一份广告着
+ * 不存在工具的名单，只去名单则模型仍会凭工具定义去试。所以只算这一次。
+ */
+export function canDelegate(depth, leaf, maxDepth = MAX_SUBAGENT_DEPTH) {
+    return canSpawnDeeper(depth, maxDepth) && !leaf;
+}
+/**
+ * 触顶时返回给模型的文案。**写成引导语而非错误**——让模型改用自己的工具干完剩余
+ * 工作，而不是让整个 run 失败。
+ *
+ * 深度与树配额是两种不同的限制（层级 vs 同时存活数），正确的下一步也不同（深度是
+ * 本层永久的；树配额随子 Agent 结束而释放），必须分开措辞——曾共用一句「派生次数
+ * 已达本轮上限」，对两者各说错一半。
+ */
+export const DEPTH_EXHAUSTED_HINT = '子 Agent 的派生层级已达上限，这一层不能再往下派生。请用你自己的工具完成剩余工作。';
+export function treeFullHint(limit) {
+    return (`当前会话树同时存活的子 Agent 已达上限（${limit} 个），` +
+        '已有子 Agent 结束后名额会释放。眼下请用你自己的工具推进剩余工作。');
+}
+export const TREE_FULL_HINT = treeFullHint(MAX_LIVE_SUBS_PER_TREE);
+//# sourceMappingURL=spawn-guards.js.map

package/dist/subagent/spawn-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-guards.js","sourceRoot":"","sources":["../../src/subagent/spawn-guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,mDAAmD;AACnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,YAAoB,EACpB,WAAmB,kBAAkB;IAErC,OAAO,YAAY,GAAG,QAAQ,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,IAAa,EACb,WAAmB,kBAAkB;IAErC,OAAO,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;AAClD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B,8CAA8C,CAAC;AAEjD,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,CACL,0BAA0B,KAAK,MAAM;QACrC,sCAAsC,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/subagent/subagent-registry.d.ts

@@ -0,0 +1,150 @@
+import type { ToolRegistry } from '../tools/tool-registry.js';
+import { type SubagentIndexEntry } from './roster-block.js';
+/**
+ * 一个内置子 Agent 的登记信息。搬自 agent-base `BuiltinSubagentMeta`，只留与运行时机制
+ * 有关的字段；模型从哪来（档位、顶替能力的模型、媒体服务商）是宿主的配置语义，宿主
+ * 扩展这个接口自己加（`SubagentRegistry<MyMeta>`），在 `SpawnPolicy` 与 tick 设置里读。
+ *
+ * **optional 字段留空 = 由父决定**：通用子 Agent 正是靠全部留空，把工具 / 步数交还给
+ * 派生它的那个父（宿主合成子定义时 `meta.tools ?? parent.enabledTools`）。
+ */
+export interface SubagentMeta {
+    /** 模型看到、派生时填的名字。全局唯一。 */
+    name: string;
+    /**
+     * 界面上的默认叫法（「识图员」）：派它那一行、过程弹窗、回执标题都写它。**只管显示，
+     * 模型看到的永远是 `name`**。1..`labelMax` 个码点，注册期校验。
+     */
+    label: string;
+    /** 花名册那一行。超过 `DESC_LIMIT` 个码点注册期拒绝（花名册会截掉，模型看不见）。 */
+    description: string;
+    /** 子会话的人格提示词。 */
+    prompt: string;
+    /** 工具白名单；不给 = 用父的。 */
+    tools?: readonly string[];
+    /** 步数上限；不给 = 用父的。 */
+    maxSteps?: number;
+    /** **叶子**：不给 `Delegate`、花名册清空（它只做一件事，再分包只会绕回来）。 */
+    leaf?: boolean;
+    /**
+     * **功能型**：做一件具体的事、自带一套工具；谁派都按它自己的定义跑，且**必须是叶子**
+     * （隐含 `leaf`）。标不标是一次显式决定，别因为收窄了 `tools` 就顺手标上。
+     */
+    functional?: true;
+    /**
+     * **要权限点才派得出**：本轮发起人有这个点，**且**父允许派这类子 Agent
+     * （`SubagentAccess.allowPermissioned`）时才进花名册、才派得出。填它自带工具要的那个点，
+     * 花名册与工具门禁认同一件事。**这不是工具的门**：它用到的工具自己仍要现查权限。
+     */
+    permission?: string;
+    /**
+     * **点名挂载**：默认不进任何花名册、谁都派不出，只有点名要它的父
+     * （`SubagentAccess.optIn`）才列、才派得出。与 `permission` 不能同标（注册期拒绝）。
+     */
+    optIn?: true;
+    /**
+     * 系统类工具（`ToolRegistry` 里 `alwaysOnCategories` 那几组）的白名单。不给 = 不限。
+     * `tools` 管不到恒上桌的工具，要让它只做一件事就得在这里点名；名单外的由
+     * `excludedSystemTools` 算出、宿主放进本轮摘除清单。
+     */
+    systemTools?: readonly string[];
+    /**
+     * 改名前用过的名字。旧子会话钉着旧名（`SessionRecord.subagentName`），追问它时每个 tick
+     * 都按它查定义——查不到就再也续不上。`get` 认它，花名册只出现名。
+     */
+    formerNames?: readonly string[];
+}
+/** 注册时可附的运行期问答。 */
+export interface SubagentProvider {
+    /**
+     * 此刻能不能用（服务端没配取数账号时取数员不可用）。不可用时 `get` / `list` 都当它
+     * 不存在。**每次调用现问**，不在注册时快照。
+     */
+    isAvailable?(): boolean;
+}
+/** 花名册 / 派生对「要权限点」与「点名挂载」的判据输入。缺省即 fail-closed。 */
+export interface SubagentAccess {
+    /** 本轮发起人此刻的权限点（`Initiator.permissions`；没有发起人 = 空）。 */
+    permissions: ReadonlySet<string>;
+    /** 父允许派要权限点的子 Agent（agent-base：系统管理分身）。缺省 false。 */
+    allowPermissioned?: boolean;
+    /** 这个父点名要的「点名挂载」子 Agent。缺省空。 */
+    optIn?: readonly string[];
+}
+export interface SubagentRegistryOptions<M extends SubagentMeta> {
+    /** `label` 的码点上限，缺省 20。 */
+    labelMax?: number;
+    /** 宿主字段的注册期校验（抛错即拒绝）。 */
+    validate?(meta: M): void;
+    /** 宿主字段隐含的叶子（agent-base：按能力顶替的子 Agent）。 */
+    impliesLeaf?(meta: M): boolean;
+}
+/**
+ * 内置子 Agent 注册表：宿主显式 `register`（以前靠 Nest 装饰器 + DiscoveryService 扫）。
+ * 名字重复、旧名冲突、说明过长、两个互斥标记同标都在注册期抛。
+ *
+ * 花名册顺序 = 注册顺序。
+ */
+export declare class SubagentRegistry<M extends SubagentMeta = SubagentMeta> {
+    private readonly options;
+    private readonly byName;
+    /** 旧名 → 现名。 */
+    private readonly aliases;
+    private readonly labelMax;
+    constructor(options?: SubagentRegistryOptions<M>);
+    register(meta: M, provider?: SubagentProvider): void;
+    /** 现名（认旧名）；没登记过返回 null。不看可用性。 */
+    currentName(name: string): string | null;
+    /** 这个名字（含旧名）的定义；没有或此刻不可用返回 null。 */
+    get(name: string): M | null;
+    /** 此刻可用的全部定义（注册顺序）。 */
+    list(): M[];
+    /** 注册过的全部定义（含此刻不可用的），带可用性。后台页用。 */
+    listAll(): {
+        meta: M;
+        available: boolean;
+    }[];
+    /**
+     * 注册过的全部现名，**不看可用性**。给「名字不许与内置子 Agent 撞」这类静态判断用：
+     * 按 `list()` 判的话，取数员不可用时别人就能占走它的名字，可用之后两者同名。
+     */
+    allNames(): string[];
+    /** 名字 → 界面默认叫法，**含旧名**；不看可用性（历史里派过的照样要叫得出来）。 */
+    defaultLabels(): Record<string, string>;
+    /**
+     * 这个名字是不是叶子（不给 `Delegate`、花名册清空）：`leaf` / `functional` /
+     * 宿主的 `impliesLeaf`。没登记过的名字（宿主自己的子 Agent）返回 false。
+     */
+    isLeaf(name: string): boolean;
+    /** 这个名字要的权限点；不要或没登记过返回 null。 */
+    requiredPermission(name: string): string | null;
+    /**
+     * 判据输入下这个定义派不派得出（花名册与派生同一句）：要权限点的要发起人有且父允许；
+     * 点名挂载的要父点了名。
+     */
+    permits(meta: M, access: SubagentAccess): boolean;
+    /**
+     * 花名册：此刻可用、对这份判据输入派得出的定义。`filter` 是宿主的附加条件
+     * （agent-base：顶替型只在当前模型缺那项能力且父配了顶替模型时列）——**不广告一个
+     * 派不出来的东西**，派生那一侧（`SpawnPolicy.checkSpawn`）要用同一个判据。
+     */
+    roster(access: SubagentAccess, filter?: (meta: M) => boolean): SubagentIndexEntry[];
+    /**
+     * 这个子 Agent 本轮要摘掉的恒上桌工具：声明了 `systemTools` 时，`alwaysOn` 那几组里
+     * 名单外的全部。没声明返回空数组（与父一样）。
+     */
+    excludedSystemTools(name: string, tools: ToolRegistry, alwaysOnCategories?: readonly string[]): string[];
+    private available;
+}
+/**
+ * 通用子 Agent 的固定人格提示词。**短得几乎没有内容，这是对的**：处境说明（看不到
+ * 调用方历史、产出原样回投、卡住可以交回去问）归平台，由 `buildSubagentSituationBlock`
+ * 对每个子会话注入；剩下这一句才是「通用款」独有的——它没有领域设定。
+ */
+export declare const GENERAL_PURPOSE_PROMPT = "\u4F60\u6CA1\u6709\u7279\u5B9A\u7684\u9886\u57DF\u8BBE\u5B9A\uFF0C\u4E5F\u6CA1\u6709\u9884\u8BBE\u7684\u5DE5\u4F5C\u5957\u8DEF\u3002\u6309\u4EFB\u52A1\u63CF\u8FF0\u672C\u8EAB\u7684\u8981\u6C42\u6765\u505A\uFF1A\u5B83\u8981\u4EC0\u4E48\u5C31\u4EA7\u51FA\u4EC0\u4E48\uFF0C\u9700\u8981\u4EC0\u4E48\u624B\u6BB5\u5C31\u7528\u4EC0\u4E48\u624B\u6BB5\u3002";
+/**
+ * 内置「通用子 Agent」。**除人格外一个字段都不设，是它的全部要点**：工具、步数（以及
+ * 宿主的档位、推理等级）统统由派生它的那个父决定。宿主要用就 `registry.register(GENERAL_PURPOSE_SUBAGENT)`。
+ */
+export declare const GENERAL_PURPOSE_SUBAGENT: SubagentMeta;
+//# sourceMappingURL=subagent-registry.d.ts.map

package/dist/subagent/subagent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-registry.d.ts","sourceRoot":"","sources":["../../src/subagent/subagent-registry.ts"],"names":[],"mappings":"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"}