@zooique/memora 2.0.3 → 3.0.1

package/dist/role-pack/capabilityMap.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 能力声明（capability）→ memora 特权工具 映射表（SSOT）
+ *
+ * 角色包以**中立能力命名空间**声明（`web:search` / `code:execute` / `task:plan`），
+ * 不绑具体实现；各实现（memora 是 reference implementation）自行映射到自有工具。
+ *
+ * 语义（tool-exposure-model 探索草稿：默认常驻 vs 角色启动）：
+ * capabilities = 角色包声明的**超越默认边界的特权**，而非逐项打开本地能力——
+ * 本地只读/项目内/内核基建工具（read_file/search_memories/技能域等）默认常驻、
+ * 不受本表控制（见 toolExecutor.DEFAULT_EXPOSED_TOOLS）。
+ *
+ * 映射规则：
+ *   - 一个能力可映射到多个工具；一个工具可被多个能力映射；
+ *   - 未知能力（不在本表）：装载方跳过，不阻塞；
+ *   - 本表只控制**特权工具暴露面**（LLM 可见的工具列表），不改变 execute 路由——
+ *     工具暴露 = 可被调用；工具未暴露 = LLM 无从发起调用。
+ *     「换角色 → 特权工具集切换」是 mvp-scope 验收标准 7 的范式最小验证。
+ */
+/**
+ * 解析能力声明列表为 memora 特权工具白名单
+ *
+ * @param capabilities 角色包声明的能力列表（可空）
+ * @returns 工具名白名单（去重、保序）；空数组 = 无特权工具（常驻豁免集仍全部可用）
+ */
+export declare function resolveCapabilityTools(capabilities: readonly {
+    capability: string;
+}[] | undefined): string[];
+//# sourceMappingURL=capabilityMap.d.ts.map

package/dist/role-pack/capabilityMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilityMap.d.ts","sourceRoot":"","sources":["../../src/role-pack/capabilityMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAoBH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,SAAS;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS,GAC1D,MAAM,EAAE,CAWV"}

package/dist/role-pack/capabilityMap.js

@@ -0,0 +1,56 @@
+/**
+ * 能力声明（capability）→ memora 特权工具 映射表（SSOT）
+ *
+ * 角色包以**中立能力命名空间**声明（`web:search` / `code:execute` / `task:plan`），
+ * 不绑具体实现；各实现（memora 是 reference implementation）自行映射到自有工具。
+ *
+ * 语义（tool-exposure-model 探索草稿：默认常驻 vs 角色启动）：
+ * capabilities = 角色包声明的**超越默认边界的特权**，而非逐项打开本地能力——
+ * 本地只读/项目内/内核基建工具（read_file/search_memories/技能域等）默认常驻、
+ * 不受本表控制（见 toolExecutor.DEFAULT_EXPOSED_TOOLS）。
+ *
+ * 映射规则：
+ *   - 一个能力可映射到多个工具；一个工具可被多个能力映射；
+ *   - 未知能力（不在本表）：装载方跳过，不阻塞；
+ *   - 本表只控制**特权工具暴露面**（LLM 可见的工具列表），不改变 execute 路由——
+ *     工具暴露 = 可被调用；工具未暴露 = LLM 无从发起调用。
+ *     「换角色 → 特权工具集切换」是 mvp-scope 验收标准 7 的范式最小验证。
+ */
+/** 能力→工具映射表（只读，防外部篡改） */
+const CAPABILITY_TO_TOOLS = {
+    // 网络域（判据 A：外部网络副作用，越出项目边界）
+    'web:search': ['web_search'],
+    // 搜索→抓取闭环：web_fetch 读正文（与 web_search 成对声明，角色包按需声明）
+    'web:fetch': ['web_fetch'],
+    // 通用计算域：LLM 现写任意代码（判据 A+B：无轨迹）。宿主注入 ICodeExecutionProvider 才真正暴露
+    'code:execute': ['run_code'],
+    // 任务域：task_table_* 不在能力门控内（任务表是内核多步任务必要基建，
+    // 与 compress_context 同属默认常驻，见 toolExecutor.DEFAULT_EXPOSED_TOOLS）→ 不由 rolePack
+    // 声明解锁，故**不映射**到白名单（映射=假特权：声明与否行为全同，徒增困惑）。
+    // ⚠️ 本表**不保留** `task:plan` 条目（连空数组都不写）：在本函数内「键不存在」与「空数组」
+    // 行为完全等价（均不产出工具），故不为它占位。能力名合法性由 validator 的 CAPABILITY_PATTERN
+    // （开放正则 `域:动作`）单点校验——内核**没有**集中式「中立能力字典」表。
+    // 内核内部能力（无工具映射，仅声明存在；实现按自身能力实现）
+    'llm:summarize': [],
+};
+/**
+ * 解析能力声明列表为 memora 特权工具白名单
+ *
+ * @param capabilities 角色包声明的能力列表（可空）
+ * @returns 工具名白名单（去重、保序）；空数组 = 无特权工具（常驻豁免集仍全部可用）
+ */
+export function resolveCapabilityTools(capabilities) {
+    if (!capabilities || capabilities.length === 0)
+        return [];
+    const tools = new Set();
+    for (const { capability } of capabilities) {
+        const mapped = CAPABILITY_TO_TOOLS[capability];
+        if (mapped) {
+            for (const tool of mapped)
+                tools.add(tool);
+        }
+        // 未知能力：跳过，不报错不阻塞
+    }
+    return [...tools];
+}
+//# sourceMappingURL=capabilityMap.js.map

package/dist/role-pack/capabilityMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilityMap.js","sourceRoot":"","sources":["../../src/role-pack/capabilityMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,yBAAyB;AACzB,MAAM,mBAAmB,GAAgD;IACvE,2BAA2B;IAC3B,YAAY,EAAE,CAAC,YAAY,CAAC;IAC5B,mDAAmD;IACnD,WAAW,EAAE,CAAC,WAAW,CAAC;IAC1B,iEAAiE;IACjE,cAAc,EAAE,CAAC,UAAU,CAAC;IAC5B,2CAA2C;IAC3C,+EAA+E;IAC/E,2CAA2C;IAC3C,yDAAyD;IACzD,+DAA+D;IAC/D,2CAA2C;IAC3C,gCAAgC;IAChC,eAAe,EAAE,EAAE;CACpB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,YAA2D;IAE3D,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,YAAY,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,IAAI,IAAI,MAAM;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QACD,iBAAiB;IACnB,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC"}

package/dist/role-pack/constants.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 角色包内核常量
+ *
+ * BUILTIN_FALLBACK_PACK：内核兜底契约包名（名字即契约，改名须走 ADR）。
+ * 该包随内核分发（role-packs/<BUILTIN_FALLBACK_PACK>/），宿主构建期同步 + existsSync 硬校验
+ * （缺失即构建失败）；运行时缺失 → 无 persona 继续运行 + warning（降级优先 §7，不装配失败）。
+ * 覆盖：宿主可经 AgentOptions.builtinFallbackRole 覆盖（覆盖值须存在，否则回退本常量）。
+ */
+export declare const BUILTIN_FALLBACK_PACK = "memora\u52A9\u624B";
+/**
+ * 小组会议组员数量上限（组队规格）：组员 ≤ 4（5 人组 = 队长 1 + 组员 4）。
+ *
+ * SSOT 单一来源：内核校验 warning + 会议消费端截断共用；宿主（UI 勾选层 / 保存校验）经
+ * `@zooique/memora` import 本常量，webview 侧由宿主随 roles_loaded 下发（浏览器沙箱不可直连内核）。
+ * 严禁在宿主另写字面量——并列定义即腐化。
+ *
+ * 超限时：装载只 warning（不阻塞、不裁切存储），**会议消费端截断至前 4 名**
+ * （`RolePackManager.activeTeamMembers` 收口，超出部分不参与会议）。
+ */
+export declare const MAX_TEAM_MEMBERS = 4;
+//# sourceMappingURL=constants.d.ts.map

package/dist/role-pack/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/role-pack/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,uBAAa,CAAC;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC"}

package/dist/role-pack/constants.js

@@ -0,0 +1,21 @@
+/**
+ * 角色包内核常量
+ *
+ * BUILTIN_FALLBACK_PACK：内核兜底契约包名（名字即契约，改名须走 ADR）。
+ * 该包随内核分发（role-packs/<BUILTIN_FALLBACK_PACK>/），宿主构建期同步 + existsSync 硬校验
+ * （缺失即构建失败）；运行时缺失 → 无 persona 继续运行 + warning（降级优先 §7，不装配失败）。
+ * 覆盖：宿主可经 AgentOptions.builtinFallbackRole 覆盖（覆盖值须存在，否则回退本常量）。
+ */
+export const BUILTIN_FALLBACK_PACK = 'memora助手';
+/**
+ * 小组会议组员数量上限（组队规格）：组员 ≤ 4（5 人组 = 队长 1 + 组员 4）。
+ *
+ * SSOT 单一来源：内核校验 warning + 会议消费端截断共用；宿主（UI 勾选层 / 保存校验）经
+ * `@zooique/memora` import 本常量，webview 侧由宿主随 roles_loaded 下发（浏览器沙箱不可直连内核）。
+ * 严禁在宿主另写字面量——并列定义即腐化。
+ *
+ * 超限时：装载只 warning（不阻塞、不裁切存储），**会议消费端截断至前 4 名**
+ * （`RolePackManager.activeTeamMembers` 收口，超出部分不参与会议）。
+ */
+export const MAX_TEAM_MEMBERS = 4;
+//# sourceMappingURL=constants.js.map

package/dist/role-pack/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/role-pack/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC"}

package/dist/role-pack/rolePackManager.d.ts

@@ -0,0 +1,269 @@
+import { ConfigResourceManager } from '../utils/configResourceManager.js';
+import { type ScriptRuntime, type ScannedMarkdownEntry } from '../utils/scanner.js';
+import type { RolePack, RolePackMeta, RolePackAssembly, RolePackTeam } from '../role-pack/types.js';
+/**
+ * 会议团队上下文块文案（纯函数；`buildTeamContextBlock` 委托本函数）。
+ *
+ * **how 单源纪律**：状态取值（done/blocked）与标注方法属「工具用法」，唯一真源 =
+ * `task_table_update` 工具描述（builtinTools.ts）；本函数只承载**会议场景编排**
+ * （何时增项 / 何时声明 rolePack / 何时回到组长视角），不复述工具用法——
+ * 与 PLAN_NUDGE_PROMPT 同构（when/what 在此，how 指向描述）。守卫见 builtinTools.test。
+ */
+export declare function buildTeamContextBlockText(leader: string, members: readonly string[]): string;
+/**
+ * 角色包管理器
+ */
+export declare class RolePackManager extends ConfigResourceManager<RolePack> {
+    /** 激活角色包变更回调（首次参数为变前，第二参数为变后；宿主据此同步 UI/记忆标题） */
+    private onActiveChanged;
+    /** 切换锁定触发回调（宿主据此展示「角色切换已锁定 2 分钟」提示） */
+    private onSwitchLocked;
+    /** 当前激活的角色包名 */
+    private activePackName;
+    /** 角色切换时间戳列表（用于时间窗口缓冲） */
+    private switchTimestamps;
+    /** 缓冲区开关（30s 内 5 次切换后锁定） */
+    private switchLocked;
+    /** 锁定恢复计时器 */
+    private unlockTimer;
+    /** 锁定自动恢复时间戳（ms epoch） */
+    private unlockAt;
+    /** 时间窗口：30 秒 */
+    private static readonly SWITCH_WINDOW_MS;
+    /** 窗口内最大切换次数：5 次 */
+    private static readonly MAX_SWITCHES_IN_WINDOW;
+    /** 锁定后自动恢复时间：2 分钟 */
+    private static readonly AUTO_UNLOCK_MS;
+    /** 宿主装配级兜底角色覆盖（§4.6：覆盖值须存在，否则回退内核常量 BUILTIN_FALLBACK_PACK） */
+    private builtinFallbackRole;
+    /** 组（宿主装配级）：组长角色包 + 组员名单（会议名单容器，非选择对象） */
+    private rolePackTeams;
+    /**
+     * 本轮表层装配视角（会议机制）：任务项级临时覆盖（persona/rules/skills 换、键不换）。
+     * 仅在本轮 prepare 生效，用完即回——非会议/越界时置 null 回落 activePack；不改 activePack。
+     */
+    private roundAssemblyRole;
+    /**
+     * @param configDir 配置目录（角色包在 <configDir>/role-packs/ 下）
+     */
+    constructor(configDir?: string);
+    /**
+     * 设置宿主装配级兜底角色覆盖（可选）：须指向存在的角色包，覆盖值不存在时回退内核常量。
+     * 由装配层在 load() 前调用（AgentOptions.builtinFallbackRole）。
+     */
+    setBuiltinFallbackRole(role: string | null): void;
+    /**
+     * 设置组数据（宿主装配级，会议名单容器）：组长角色包 + 组员名单。
+     * 数据归宿主（用户级持久化），内核仅装配时校验（validateTeams）；组员仅会议参与，不用于日常。
+     */
+    setRolePackTeams(teams: readonly RolePackTeam[]): void;
+    /**
+     * 获取当前 activePack 作为组长的队伍（供宿主 UI 消费的只读快照）。
+     * SSOT 出口：宿主拿 team 数据的唯一公共方法，不绕过内核直接读 globalState。
+     * 内部成员名单走 activeTeamMembers 截断（会议消费端约束超限部分不参与），
+     * 保证宿主看到的参与名单与内核会议实际消费一致。
+     *
+     * @returns 队伍快照（组长 + 截断后的组员）；activePack 非组长或无队伍时返回 null
+     */
+    getActiveTeam(): RolePackTeam | null;
+    /**
+     * 按组长名取队伍快照（run_team_meeting 等任意组解析入口，SSOT 与 getActiveTeam 同截断口径）。
+     *
+     * 与 getActiveTeam 的区别：不依赖当前激活角色，显式按组名称解析（组名 = 组长的角色包名）。
+     * 组员名单同样经 MAX_TEAM_MEMBERS 截断（队长 1 + 组员 ≤ 4 = 5 人组，超出部分不参与会议）。
+     *
+     * @param group 组名（= 组长的角色包名）
+     * @returns 队伍快照（组长 + 截断后的组员）；未找到该组时返回 null
+     */
+    getTeam(group: string): RolePackTeam | null;
+    /**
+     * 组数据校验（装载后执行）：组长身份唯一 / 成员名单非空 / 引用悬空 / 组长组员互斥 → warning（不阻塞装载）。
+     * 组员失效 → 会议时缺员跳过（resolveRoundAssemblyRole 内判定）；组长失效 → 该组失效（仅影响会议）。
+     */
+    private validateTeams;
+    /**
+     * 设置本轮表层装配视角（会议机制）：任务项级临时覆盖。
+     * 由 prepare 期按 active 任务项 rolePack 解析结果设置；非会议/越界 → null（回落 activePack）。
+     */
+    setRoundAssemblyRole(role: string | null): void;
+    /** 本轮表层装配视角（会议机制）：非会议返回 null（回落 activePack） */
+    get roundAssemblyPerspective(): string | null;
+    /**
+     * 会议组员的**唯一消费入口**（SSOT 收口）：当前激活角色作为组长时的会议组员名单，超限截断至
+     * `MAX_TEAM_MEMBERS` 名。
+     *
+     * 截断只发生在消费端——`rolePackTeams` 存储保持原样（超限数据不裁切，用户可自行修正），
+     * 因此「超限仅影响会议、不影响日常」的语义成立。所有会议消费点（装配角色解析 / 上下文块 /
+     * 会议任务项）必须走本 getter，禁止直连 `team.members`，否则「超出部分不参与会议」即成假契约。
+     */
+    private get activeTeamMembers();
+    /**
+     * 会议机制：解析本轮表层装配角色（范围校验前置，防 LLM 幻觉角色名）。
+     * rolePack 必须 ∈ {组长(activePack)} ∪ {组员}；越界 → 忽略该覆盖 + warning 返回 null；
+     * 组员角色包不存在（缺员）→ 跳过 + warning 返回 null。
+     *
+     * @param declared 任务项声明的 rolePack（无声明 = 非会议，返回 null）
+     * @returns 有效覆盖角色名；无覆盖/越界/缺员返回 null
+     */
+    resolveRoundAssemblyRole(declared: string | undefined): string | null;
+    /**
+     * 技能加载目标角色（会议机制）：packName 显式指定优先 → 本轮装配视角（会议）→ 激活角色包。
+     * 会议内 skills 加载跟随任务项角色（组员技能正文读得到），键/工具面仍恒为 activePack。
+     */
+    private resolveSkillTarget;
+    /**
+     * 构建「组长 + 组员名单」上下文块（会议机制实施前提②：组/成员清单暴露给 LLM，防编造角色名）。
+     * 仅当 activePack 是某个组的组长且名单非空时产出；非组长返回空串（不注入）。
+     *
+     * 文案正文在模块级 buildTeamContextBlockText（纯函数，供 how 单源守卫直测；本方法只做前置守卫）。
+     * 文案指挥 LLM 用 `task_table_write` 自主建表（确定性骨架预置见 tryBuildMeetingPlan，
+     * 二者互补：骨架补首轮确定性，文案约束 LLM 后续走 task_table 单通道）：
+     * 明确组员发言任务项需声明 `rolePack` 以触发表层装配切换，汇总任务项不声明回到组长视角；
+     * 并显式禁止用 write_file 模拟任务表（write_file 写 `.memora/task-table.md`
+     * 伪建表会绕过 PlanItem 通道，导致顶部任务板不渲染）。
+     */
+    buildTeamContextBlock(): string;
+    /**
+     * 会议机制：确定性骨架预置（SSOT 单一入口，「最小受控起点」半反转——
+     * 骨架确定性预置、内容与推进交 LLM，与 buildTeamContextBlock 文案互补）。
+     *
+     * 用户消息含「小组会议」**且** activePack 是某组组长 → 程序化预置占位骨架：
+     * 组长开场项（无 rolePack = 默认组长视角）+ 组员各一项（`rolePack=成员`，触发表层装配硬切换）
+     * + 汇总项尾（无 rolePack = 组长视角）。不固化发言内容与推进顺序，推进交 LLM；
+     * LLM 可经 task_table_write 追加额外任务项（骨架以 append 扩项，不锁死多轮交互）。
+     * 不引入会议引擎：任务项执行靠任务表每轮注入（assembler.getTaskTable）驱动 LLM 按项标记 done/blocked，
+     * 装配视角逐项切换（getTaskTable → applyActivePlanItemAssembly → applyActivePlanItemAssemblyIfChanged）。
+     *
+     * 主题取自「小组会议」后文（冒号/逗号/空格分隔均可），为空则任务项仅标「发言/汇总」由 LLM 见用户消息展开。
+     * 无 keyword / activePack 非组长 / 组名单空 → 返回 null（不触发，回落普通闭环）。
+     *
+     * @param input 用户输入
+     * @returns 预置骨架任务项（description + 可选 rolePack）；不触发返回 null
+     */
+    tryBuildMeetingPlan(input: string): Array<{
+        description: string;
+        rolePack?: string;
+    }> | null;
+    /**
+     * 启动加载：扫描含 manifest.json 的角色包文件夹（覆盖基类 loadItems——基类只支持单文件扫描，生命周期其余仍复用基类）。
+     * 默认激活路径 = §4.1 单链：activePack（宿主注入）→ 兜底包（builtinFallbackRole ?? BUILTIN_FALLBACK_PACK）。
+     */
+    load(activePack?: string): Promise<number>;
+    /** 重载角色包：重新扫描 + 保持激活态（覆盖基类 reload，基类扫描无法覆盖文件夹包形态）；激活包被删 → 落兜底包（§4.1 单链） */
+    reload(): Promise<number>;
+    /**
+     * §4.1 单链兜底：激活兜底包（builtinFallbackRole ?? BUILTIN_FALLBACK_PACK）。
+     * 兜底包运行时缺失（用户手动删文件）→ 无 persona 继续运行 + warning（§7 降级优先，不装配失败）。
+     */
+    private activateFallback;
+    /** 扫描角色包目录：每个子目录为一个角色包，须含 manifest.json；manifest.name 优先于文件夹名 */
+    private scanRolePacks;
+    /**
+     * 扫描角色包目录但只返回扫描结果（不改写 items）：供 reload 复用 retainRuntimeItems 合并逻辑。
+     * 与 scanRolePacks 的差异：scanRolePacks 直接替换 items（load 场景），本方法返回纯扫描数组
+     * （reload 场景还需与运行时注入项合并，不能整体覆盖）。
+     */
+    private scanRolePacksForReload;
+    /** 从角色包目录构建条目列表（仅文件夹形态） */
+    private buildFromDir;
+    /** 解析单个角色包（manifest.json + 独立内容文件），失败返回 null */
+    private parseManifestPack;
+    /** 当前激活的角色包名 */
+    get activeName(): string | null;
+    /**
+     * 注册激活角色包变更监听：每次激活状态实际变化（切换 / 默认激活 / 回退）时回调。
+     * @param handler 收到（from, to）；to 为 null 表示激活被清空；同名不变不触发
+     */
+    onRolePackActivated(handler: (from: string | null, to: string | null) => void): void;
+    /**
+     * 注册切换锁定触发监听：30s 内超过 5 次切换触发锁定时回调（2 分钟自动恢复）。
+     * @param handler 收到（reason, lockedSeconds）；reason 为锁定原因描述
+     */
+    onRolePackSwitchLocked(handler: (reason: string, lockedSeconds: number) => void): void;
+    /** 返回 parseManifestPack 时预缓存的 Assembly，避免重复 mergeStrategy + personaPrompt 构建；无激活返回 null */
+    getActive(): RolePackAssembly | null;
+    /** 当前激活角色包的规则列表（设定记忆归角色包后，规则以角色包为准）；无激活返回空数组 */
+    getActiveRules(): readonly string[];
+    /** 按名称获取预缓存的装配结果，不存在返回 null */
+    get(name: string): RolePackAssembly | null;
+    /** 激活指定角色包（30s 内超 5 次切换后锁定 2 分钟防抖，避免状态抖动）；锁定或不存在返回 false */
+    activate(name: string): boolean;
+    /** 统一激活态赋值：实际变化时触发 onActiveChanged 回调（宿主同步 UI/记忆标题） */
+    private setActivePackName;
+    /** 角色切换锁定状态；unlockAt 为自动恢复时间戳（ms epoch），未锁定 null */
+    getSwitchLockStatus(): {
+        locked: boolean;
+        unlockAt: number | null;
+    };
+    /** 当前激活角色包的 traits，无则 undefined */
+    getActiveTraits(): Record<string, number> | undefined;
+    /** 清理资源：清除切换防抖锁计时器，防止关闭后回调触发 */
+    close(): void;
+    /** 所有角色包元数据摘要列表 */
+    listMeta(): RolePackMeta[];
+    /**
+     * 基类抽象实现：本管理器用自建扫描（parseManifestPack/buildFromDir）覆盖了
+     * loadItems/reload，不用基类单文件扫描，恒返回 null 以满足抽象约束。
+     */
+    protected createEntry(_entry: ScannedMarkdownEntry): Promise<RolePack | null>;
+    /** 构建 system prompt 的角色包段：personaPrompt + L1 技能清单（渐进披露）；name 缺省用当前激活包 */
+    buildSystemPrompt(name?: string): string;
+    /**
+     * 枚举激活角色包的内嵌技能（渐进披露 L1 清单来源，供宿主技能三源聚合展示）。
+     * 技能加载跟随本轮装配视角（会议内 = 任务项角色；非会议 = activePack）。
+     * name 缺省时按文件名去扩展名推导；无装配角色返回空数组。SSOT：技能清单只由
+     * 角色包自身持有，宿主不重复扫描目录。
+     */
+    listSkills(): Array<{
+        name: string;
+        description?: string;
+    }>;
+    /**
+     * 读激活角色包内嵌技能正文（渐进披露 L2，read_skill 数据源）。优先返回 parseManifestPack
+     * 时缓存的正文；路径相对角色包目录天然受限，无需额外白名单校验。
+     */
+    readSkillContent(skillName: string, packName?: string): Promise<string | null>;
+    /** 从技能文件路径推导技能名（单文件 write.md → write；文件夹 my-skill/SKILL.md → my-skill） */
+    deriveSkillNameFromFile(file: string): string;
+    /** 按技能名在装配视角角色包中查找技能条目（跟随本轮装配视角）；frontmatter name 精确匹配优先，其次 file 路径推导；未找到返回 null */
+    private findSkillByName;
+    /**
+     * 按技能名定位其所在目录（角色包内），供 L3 资源/脚本访问
+     *
+     * 与 skillLayer3.resolveSkillDir 的分工：本方法负责「技能名 → 技能文件绝对路径」
+     * （需 packName 作用域，一个技能名可跨包重名）；目录形态解析（文件夹 SKILL.md /
+     * 单文件 .md / file 直指目录）委托给后者（SSOT，与全局技能共用同一份规则）。
+     */
+    private locateSkillDir;
+    /** 读取技能 L3 资源文件内容（渐进披露 L3），不存在或读取失败返回 null */
+    readSkillResource(skillName: string, resourcePath: string, packName?: string): Promise<string | null>;
+    /** 列出技能 L3 资源清单，无资源返回空数组 */
+    listSkillResources(skillName: string, packName?: string): ReadonlyArray<{
+        readonly path: string;
+        readonly size: number;
+    }>;
+    /** 获取技能 L3 脚本完整路径，不存在返回 null */
+    getSkillScriptPath(skillName: string, scriptPath: string, packName?: string): string | null;
+    /**
+     * 获取技能 L3 脚本元信息（runtime 来源：scanPackSkills 目录扫描按扩展名推断，SSOT 在
+     * utils/scanner；layer3 未命中时回退扩展名推断兜底——防御性分支，正常路径不可达）
+     */
+    getSkillScriptInfo(skillName: string, scriptPath: string, packName?: string): {
+        runtime: ScriptRuntime;
+    } | null;
+    /**
+     * 加载用户目录的角色包（宿主调用，用于扩展内置角色包池）
+     *
+     * 与 load() 的区别：
+     * - load() 从 configDir/role-packs/ 扫描内置角色包（有磁盘真理源）
+     * - loadExtraDir() 从额外目录扫描用户角色包（运行时注入，reload 时保留）
+     *
+     * 设计哲学：内核保持单一真理源（configDir/role-packs/），宿主负责扩展用户目录。
+     * 用户角色包通过 registerRuntimeItem 注入，reload() 时会保留（同名冲突以磁盘为准）。
+     *
+     * @param dir 用户角色包目录（每个子目录为一个角色包，须含 manifest.json）
+     * @returns 加载的角色包数量
+     */
+    loadExtraDir(dir: string): Promise<number>;
+}
+//# sourceMappingURL=rolePackManager.d.ts.map

package/dist/role-pack/rolePackManager.d.ts.map

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