@zooique/memora 2.0.3 → 3.0.0

package/dist/role-pack/strategyResolver.js

@@ -0,0 +1,304 @@
+/**
+ * 角色包行为策略解析器：集中管理行为策略的默认值、解析（resolve*）、合并与装配逻辑。
+ */
+//  role-pack 与 memory 层均不持有召回保底（记忆纯工具化召回，无自动注入通道）。
+// 数值键上下限常量（SSOT）：validator 与 resolver 共用同一区间来源，越界值回退内核默认
+import { DEFAULT_MAX_ITERATIONS, ERROR_HANDLINGS, MAX_ASK_LIMIT, MAX_SELF_REVIEW_ROUNDS, MAX_STEP_BUDGET, MAX_SUMMARY_FOCUS_LENGTH, MAX_CONTEXT_LIMIT, MIN_CONTEXT_LIMIT, MIN_STEP_BUDGET, MAX_TOOL_STEP_LIMIT, MULTI_STEP_REASONINGS, PROVIDER_ROUTINGS, SUMMARY_MODES, TOOL_MODES, TOOL_READONLY_MODES, } from './strategyKeys.js';
+// ════════════════════════════════════════════════════════════
+// 默认值常量
+// ════════════════════════════════════════════════════════════
+// ════════════════════════════════════════════════════════════
+// 默认值常量（角色包层的兜底默认——角色包不声明时走这里，
+// loop 构造时 opts.maxIterations 也用同一个 DEFAULT_MAX_ITERATIONS 源头对齐）
+// ════════════════════════════════════════════════════════════
+// 无记忆召回相关默认常量（memoryRecallPercent/recallConfidence 等）——记忆纯工具化召回，
+// prepare 无自动注入消费端，策略层不解析召回参数。
+/**
+ * 行为策略全局默认值——未配置的维度使用全局默认值，角色包只声明它想改变的部分。
+ * const 断言确保类型推导为字面量值。
+ */
+export const DEFAULT_BEHAVIOR_STRATEGY = {
+    prepare: {
+        summaryFocus: undefined, // undefined = 通用浓缩（角色包未声明时使用默认摘要策略）
+    },
+    act: {
+        toolMode: 'allow',
+        toolReadonly: 'full',
+        toolStepLimit: 20,
+        temperature: 0.7,
+        /**
+         * 输出上限：0 = **不干预**（→ 回服务端默认 / 听 per-LLM 配置），正数 = 显式上限。
+         * 与 `global.contextLimit: 0` / `global.stepBudget: 0` **同构**：三个「上限类」键统一表示法
+         * ——0 承载"未声明"语义、正数走声明区间 [1, MAX_OUTPUT_LIMIT]、消费点以 `> 0` 判让位。
+         * 消费点（agent.buildChatOptionsFromStrategy）已有 `> 0` 守卫 ⇒ 写 0 ≡ 不写。
+         * 旧默认 4096 会把**未声明**的角色包也硬限到 4096——那是隐形天花板（用户面板配 64K 也无效，
+         * 且取证面看不出来）。未声明 = 作者无意限制，不该由内核替他限制。
+         */
+        outputLimit: 0,
+        providerRouting: 'auto',
+        multiStepReasoning: 'auto',
+    },
+    reflect: {
+        selfReview: 0,
+        summary: 'on',
+        userFollowup: 'silent',
+    },
+    global: {
+        contextLimit: 0, // 0 = 不设额外上限（有效窗口 = provider 窗口）；非法/越界值同样回退 0
+        // 0 或未声明 → 内核兜底 DEFAULT_MAX_ITERATIONS（无「不限步数」路径，符合防死循环设计）
+        stepBudget: 0,
+        errorHandling: 'retry',
+        askOn: ['ambiguity', 'decision', 'missing_info'],
+        askLimit: 10,
+    },
+};
+// ════════════════════════════════════════════════════════════
+// 辅助函数
+// ════════════════════════════════════════════════════════════
+/**
+ * 从角色包管理器推导当前激活的 L2 行为策略（SSOT 单一真理源）。
+ *
+ * 激活角色包策略优先，未激活/无管理器回退全局默认。本函数是「激活策略」推导的
+ * 唯一实现，contextPreparer 与 seed 编排器经此统一取策略，杜绝跨模块镜像重复。
+ *
+ * @param rolePackManager 角色包管理器（可为 null）
+ * @param override 宿主装配级策略覆盖（可选）：**压过角色包声明**，表达宿主产品能力边界。
+ *  只影响 override 声明过的键（无内置示例键；无自动匹配链，机制保留）。
+ * @returns 当前激活行为策略（含装配级覆盖）
+ */
+export function resolveActiveStrategy(rolePackManager, override) {
+    const base = rolePackManager?.getActive()?.strategy ?? DEFAULT_BEHAVIOR_STRATEGY;
+    // 合并逻辑复用 mergeStrategy（单一 SSOT）——消解与通用合并的两处手写同形实现（双轨漂移隐患）
+    return mergeStrategy(base, override);
+}
+/**
+ * 枚举值合法性收窄（SSOT 兜底）：角色包 L2 键是枚举开关，非法拼写不应静默透传
+ * （非法枚举会污染行为分支或注入 persona prompt），统一归位到内核默认。
+ */
+function normalizeEnum(value, allowed, fallback) {
+    return typeof value === 'string' && allowed.includes(value)
+        ? value
+        : fallback;
+}
+// ════════════════════════════════════════════════════════════
+// 策略解析函数 (resolve*)
+// ════════════════════════════════════════════════════════════
+// 无自动注入召回解析函数（键族不存在，见 types.ts 文件头注）。
+/**
+ * 解析角色包提炼视角（SSOT）：非空字符串且 ≤ MAX_SUMMARY_FOCUS_LENGTH 字符才采用，
+ * 缺失/空白/超长回退 undefined（通用浓缩）。
+ * 领域无关机制：内核只提供注入能力，视角全文由角色包提供；未声明时 round-summary 行为与现状一致（JSON 与 SummaryType 硬契约保留）。
+ */
+export function resolveSummaryFocus(strategy) {
+    const candidate = strategy?.prepare?.summaryFocus;
+    return typeof candidate === 'string' &&
+        candidate.trim().length > 0 &&
+        candidate.length <= MAX_SUMMARY_FOCUS_LENGTH
+        ? candidate.trim()
+        : undefined;
+}
+/** 解析工具调用模式（SSOT）：非法值归位 'allow'（白名单引用 strategyKeys.TOOL_MODES，防漂移） */
+export function resolveToolMode(strategy) {
+    return normalizeEnum(strategy?.act?.toolMode, TOOL_MODES, 'allow');
+}
+/** 解析摘要生成开关（内核已消费）：非法值归位 'on'（白名单引用 strategyKeys.SUMMARY_MODES） */
+export function resolveSummary(strategy) {
+    return normalizeEnum(strategy?.reflect?.summary, SUMMARY_MODES, 'on');
+}
+/**
+ * 解析工具调用步数上限（内核已消费）：整数且 ∈ [0, MAX_TOOL_STEP_LIMIT] 才采用，非法/越界回退 0（不限制）。
+ * 「未声明」不走本回退——mergeStrategy 已注入默认 act.toolStepLimit=20（DEFAULT_BEHAVIOR_STRATEGY），
+ * 激活包未声明时生效 20 而非 0；本回退仅承接显式非法值与 resolveL2Strategy(undefined) 构造期初值。
+ */
+export function resolveToolStepLimit(strategy) {
+    const candidate = strategy?.act?.toolStepLimit;
+    // 合法值：0=无限制，1~MAX_TOOL_STEP_LIMIT=限制步数
+    const valid = typeof candidate === 'number' &&
+        Number.isInteger(candidate) &&
+        candidate >= 0 &&
+        candidate <= MAX_TOOL_STEP_LIMIT;
+    return valid ? candidate : 0;
+}
+/** 解析错误处理策略（内核已消费）：非法值归位 'retry'（白名单引用 strategyKeys.ERROR_HANDLINGS）——retry=自动重试 / degrade=降级文本 / stop=终止抛出错误 */
+export function resolveErrorHandling(strategy) {
+    return normalizeEnum(strategy?.global?.errorHandling, ERROR_HANDLINGS, 'retry');
+}
+/**
+ * 解析 Provider 路由策略（内核已消费）：非法值归位 'auto'（白名单引用 strategyKeys.PROVIDER_ROUTINGS）——auto=按任务类型路由 / fixed=固定当前 Provider
+ */
+export function resolveProviderRouting(strategy) {
+    return normalizeEnum(strategy?.act?.providerRouting, PROVIDER_ROUTINGS, 'auto');
+}
+/**
+ * 解析主动提问次数上限（内核已消费）：整数且 ∈ [1, MAX_ASK_LIMIT] 才采用，缺失/越界回退默认 10。
+ * ask_user 工具的 turn 粒度硬护栏取值（SSOT：assembleRolePack 的 prompt 引导与 loop 拦截共用）。
+ */
+export function resolveAskLimit(strategy) {
+    const candidate = strategy?.global?.askLimit;
+    const valid = typeof candidate === 'number' &&
+        Number.isInteger(candidate) &&
+        candidate >= 1 &&
+        candidate <= MAX_ASK_LIMIT;
+    // 非法/缺失回退到 DEFAULT_BEHAVIOR_STRATEGY 的 askLimit（SSOT 单点：不再硬编码 3）
+    return valid ? candidate : DEFAULT_BEHAVIOR_STRATEGY.global.askLimit;
+}
+/**
+ * 解析角色包上下文上限。合法 = `0`（不设额外上限）或整数 ∈ [MIN_CONTEXT_LIMIT, MAX_CONTEXT_LIMIT]；
+ * 其余（未声明 / 越界 / 小数 / 非数）→ 0（不设额外上限，有效窗口 = provider 窗口）。
+ */
+export function resolveContextLimit(strategy) {
+    const candidate = strategy?.global?.contextLimit;
+    const valid = typeof candidate === 'number' &&
+        Number.isInteger(candidate) &&
+        (candidate === 0 || (candidate >= MIN_CONTEXT_LIMIT && candidate <= MAX_CONTEXT_LIMIT));
+    return valid ? candidate : 0;
+}
+/** 解析步数预算：0 或未声明 → DEFAULT_MAX_ITERATIONS 兜底；stepBudget ∈ {0} ∪ [MIN_STEP_BUDGET, MAX_STEP_BUDGET]
+ * 按声明采用（与 validator 区间同一来源，防双轨镜像）。不存在「不限步数」路径——0 在 loop 侧等同未声明（effectiveMax 取 maxIterations 兜底）。 */
+export function resolveStepBudget(strategy) {
+    const candidate = strategy?.global?.stepBudget;
+    const valid = typeof candidate === 'number' &&
+        Number.isInteger(candidate) &&
+        (candidate === 0 || (candidate >= MIN_STEP_BUDGET && candidate <= MAX_STEP_BUDGET));
+    return valid ? candidate : DEFAULT_MAX_ITERATIONS;
+}
+/** 解析多步推理模式（内核已消费）：非法值归位 'auto'（白名单引用 strategyKeys.MULTI_STEP_REASONINGS）——auto=Provider 决定 / manual=强制快速回答 */
+export function resolveMultiStepReasoning(strategy) {
+    return normalizeEnum(strategy?.act?.multiStepReasoning, MULTI_STEP_REASONINGS, 'auto');
+}
+/**
+ * 解析工具只读模式：非法值归位 'full'
+ *
+ * 控制工具操作权限范围：
+ * - 'full' → 完整权限（默认）
+ * - 'readonly' → 仅允许只读工具
+ *
+ * @param strategy 合并后的行为策略
+ * @returns 合法的工具模式
+ */
+export function resolveToolReadonly(strategy) {
+    return normalizeEnum(strategy?.act?.toolReadonly, TOOL_READONLY_MODES, 'full');
+}
+// ════════════════════════════════════════════════════════════
+// L2 运行时策略（loop 运行态）装配
+// ════════════════════════════════════════════════════════════
+/**
+ * L2 运行时策略默认值（loop 构造初始态）
+ *
+ * 由 `resolveL2Strategy(undefined)` 单一推导（SSOT）：不再手动复述各 resolve* 的回退默认值，
+ * 避免"回退规则改了、此处疏漏不同步"的二次写入点。真正每轮生效值来自 resolveL2Strategy，
+ * 本常量仅作 loop 构造期的惰性初始值（单一初值入口，免逐字段初始化魔数）。
+ */
+export const DEFAULT_L2_STRATEGY = resolveL2Strategy(undefined);
+/**
+ * 解析 L2 运行时策略（Agent 层单一装配入口，免逐项 setXxx）
+ *
+ * 聚合现有各 resolveXxx（工具模式→toolCallsBlocked、工具步数、错误处理、Provider 路由、
+ * Token/步数预算、多步推理、主动提问上限、工具只读）+ reflect.selfReview；
+ * 非法值经各 resolve* 归位内核默认；selfReview 归一为布尔数字「0=关闭 / 正整数 >0 归一为 1」。
+ *
+ * @param strategy 合并后的行为策略（角色包声明，可为空）
+ * @returns 注入 AgentLoop 的单一运行时策略对象
+ */
+export function resolveL2Strategy(strategy) {
+    // selfReview → 布尔数字语义：0=关闭；正整数>0 一律归一为 1=自审查一次，
+    // 大于 1 的数同样算作 1（类似布尔开关）。越界（负/小数/非 number/>MAX）归 0=关闭。
+    const rawSelfReview = strategy?.reflect?.selfReview;
+    const selfReviewEnabled = typeof rawSelfReview === 'number' &&
+        Number.isInteger(rawSelfReview) &&
+        rawSelfReview > 0 &&
+        rawSelfReview <= MAX_SELF_REVIEW_ROUNDS;
+    return {
+        toolCallsBlocked: resolveToolMode(strategy) === 'block',
+        selfReviewEnabled,
+        toolStepLimit: resolveToolStepLimit(strategy),
+        errorHandling: resolveErrorHandling(strategy),
+        providerRouting: resolveProviderRouting(strategy),
+        contextLimit: resolveContextLimit(strategy),
+        stepBudget: resolveStepBudget(strategy),
+        multiStepReasoning: resolveMultiStepReasoning(strategy),
+        askLimit: resolveAskLimit(strategy),
+        toolReadonly: resolveToolReadonly(strategy),
+    };
+}
+// ════════════════════════════════════════════════════════════
+// 策略合并与装配
+// ════════════════════════════════════════════════════════════
+/**
+ * 合并行为策略：角色包声明值覆盖默认值
+ *
+ * @param base 基础策略（通常传入 DEFAULT_BEHAVIOR_STRATEGY）
+ * @param override 角色包声明的覆盖值，未配置的维度保持默认值不变
+ * @returns 合并后的完整策略
+ */
+export function mergeStrategy(base, override) {
+    if (!override)
+        return base;
+    return {
+        prepare: { ...base.prepare, ...override.prepare },
+        act: { ...base.act, ...override.act },
+        reflect: { ...base.reflect, ...override.reflect },
+        global: { ...base.global, ...override.global },
+    };
+}
+/**
+ * 将 RolePack 解析为 RolePackAssembly
+ *
+ * 将原始角色包解析为含完整策略的装载结果，供装配层直接使用。
+ * 同时根据策略中的 userFollowup/askOn/askLimit 注入主动提问指令到 persona prompt，
+ * 引导 LLM 使用 ask_user 内置工具提问（答案以 tool result 回填）。
+ *
+ * @param pack 原始角色包
+ * @returns 含完整策略的装载结果
+ */
+export function assembleRolePack(pack) {
+    // 先合并策略，后续构建 persona prompt 时需读取策略值
+    const strategy = mergeStrategy(DEFAULT_BEHAVIOR_STRATEGY, pack.strategy);
+    // 构建 persona prompt：身份设定 + 规则注入
+    const promptParts = [pack.personaContent];
+    if (pack.rules.length > 0) {
+        promptParts.push(`## 规则\n${pack.rules.map((r) => `- ${r}`).join('\n')}`);
+    }
+    // 主动提问指令注入：userFollowup=ask 时，将 askOn/askLimit 转为 LLM 指令。
+    // 提问通道 = ask_user 内置工具（对齐 Claude Code AskUserQuestion 机制）：
+    // 提问 = 一次普通工具调用，用户答案以 tool result 回填。
+    if (strategy.reflect?.userFollowup === 'ask') {
+        const askOn = strategy.global?.askOn;
+        // askLimit 取值收敛到 resolveAskLimit（SSOT：prompt 引导与 loop 拦截共用同一解析）
+        const askLimit = resolveAskLimit(strategy);
+        const triggerLabels = [];
+        const triggers = Array.isArray(askOn) ? askOn : askOn ? [askOn] : [];
+        for (const t of triggers) {
+            switch (t) {
+                case 'ambiguity':
+                    triggerLabels.push('遇到模糊不清的情况');
+                    break;
+                case 'decision':
+                    triggerLabels.push('需要用户做决策');
+                    break;
+                case 'missing_info':
+                    triggerLabels.push('缺少关键信息');
+                    break;
+                case 'confirm':
+                    triggerLabels.push('需要用户确认');
+                    break;
+            }
+        }
+        if (triggerLabels.length > 0) {
+            promptParts.push(`## 主动提问规则\n${triggerLabels.map((l) => `- 当${l}时，主动向用户提问`).join('\n')}\n- 每次回答中最多提问 ${askLimit} 次（按一次用户输入计，turn 粒度防打扰）\n- 提问必须调用 ask_user 工具（参数：question 问题文本 + 可选 options 选项数组/allowCustom 是否允许自定义回答）——系统据此在 step 边界暂停等你的回答，用户答案会作为工具结果返回给你`);
+        }
+    }
+    const personaPrompt = promptParts.join('\n\n');
+    // 能力声明：manifest 顶层 capabilities 直接派生
+    const capabilities = pack.capabilities ?? [];
+    return {
+        meta: pack.meta,
+        filePath: pack.filePath,
+        personaPrompt,
+        skills: pack.skills,
+        capabilities,
+        strategy,
+        traits: pack.traits,
+    };
+}
+//# sourceMappingURL=strategyResolver.js.map

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

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

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

@@ -0,0 +1,237 @@
+/**
+ * 角色包（Role Pack）类型定义——以"角色"为单位，把身份/技能/规则组织成可装载的整体。
+ *
+ * 三层结构：L1 内容层（persona/rule/skill）、L2 策略层（枚举开关，角色只"选择"不"定义"）、
+ * L3 代码层（远期预留）。装配层经"角色包清单"抽象，只认清单不认来源。
+ */
+import type { ResourceSubdir, ScriptRuntime } from '../utils/scanner.js';
+import type { ASK_TRIGGERS, ERROR_HANDLINGS, MULTI_STEP_REASONINGS, PROVIDER_ROUTINGS, SUMMARY_MODES, TOOL_MODES, TOOL_READONLY_MODES, USER_FOLLOWUPS } from './strategyKeys.js';
+import type { RolePackValidationIssue } from './validator.js';
+/** 工具调用模式：allow=允许 / block=只回答不执行（标准键 act.toolMode；值域 SSOT = strategyKeys.TOOL_MODES） */
+export type ToolMode = (typeof TOOL_MODES)[number];
+/** 工具操作范围：readonly=仅允许只读操作 / full=完整权限（值域 SSOT = strategyKeys.TOOL_READONLY_MODES） */
+export type ToolReadonly = (typeof TOOL_READONLY_MODES)[number];
+/** Provider 路由策略：auto=按任务类型换模型 / fixed=固定模型（值域 SSOT = strategyKeys.PROVIDER_ROUTINGS） */
+export type ProviderRouting = (typeof PROVIDER_ROUTINGS)[number];
+/** 多步推理模式：auto=自动深度思考 / manual=快速回答（值域 SSOT = strategyKeys.MULTI_STEP_REASONINGS） */
+export type MultiStepReasoning = (typeof MULTI_STEP_REASONINGS)[number];
+/** 自审查开关（布尔数字语义）：0=关闭 / 任意正整数 >0 = 自审查一次（单次终审，>1 归一为 1） */
+export type SelfReviewRounds = number;
+/** 摘要生成开关（on=生成摘要 / off=不生成；值域 SSOT = strategyKeys.SUMMARY_MODES） */
+export type Summary = (typeof SUMMARY_MODES)[number];
+/** 用户追问策略：ask=主动引导对话 / silent=只等输入（值域 SSOT = strategyKeys.USER_FOLLOWUPS） */
+export type UserFollowup = (typeof USER_FOLLOWUPS)[number];
+/** 错误处理策略：retry=重试 / degrade=降级 / stop=终止（值域 SSOT = strategyKeys.ERROR_HANDLINGS） */
+export type ErrorHandling = (typeof ERROR_HANDLINGS)[number];
+/** 主动提问触发场景（SSOT 推导自 strategyKeys.ASK_TRIGGERS，增删触发词只改一处） */
+export type AskOnTrigger = (typeof ASK_TRIGGERS)[number];
+/**
+ * 回答前（Prepare）认知策略集合
+ * 所有字段可选，未配置的维度使用全局默认值；角色只"选择"不"定义"。
+ */
+export interface PrepareStrategy {
+    /** 角色包提炼视角（默认 undefined=通用浓缩；供 round-summary 生成判断「值得记什么」，内核已消费） */
+    readonly summaryFocus?: string;
+}
+/** 回答中（Act）行动策略集合 */
+export interface ActStrategy {
+    /** 工具调用模式（默认 allow；标准键 act.toolMode） */
+    readonly toolMode?: ToolMode;
+    /** 工具操作范围（默认 full；内核已消费） */
+    readonly toolReadonly?: ToolReadonly;
+    /** 单轮工具调用步数上限（默认 20） */
+    readonly toolStepLimit?: number;
+    /** 生成温度 0.0~2.0（默认 0.7） */
+    readonly temperature?: number;
+    /** 单轮回答长度上限 token 数（默认 4096） */
+    readonly outputLimit?: number;
+    /** Provider 路由策略（默认 auto；内核已消费） */
+    readonly providerRouting?: ProviderRouting;
+    /** 多步推理模式（默认 auto；内核已消费） */
+    readonly multiStepReasoning?: MultiStepReasoning;
+}
+/** 回答后（Reflect）沉淀策略集合 */
+export interface ReflectStrategy {
+    /** 自审查开关（布尔数字，默认 0=关闭）：0=不自审查；正整数 >0 一律在解析层归一为 1=自审查一次（大于 1 算 1）。仅本 turn 执行过工具步后做一次终审 */
+    readonly selfReview?: SelfReviewRounds;
+    /** 摘要生成开关（默认 on；标准键 reflect.summary） */
+    readonly summary?: Summary;
+    /** 用户追问策略（默认 silent） */
+    readonly userFollowup?: UserFollowup;
+}
+/** 跨阶段全局策略集合 */
+export interface GlobalStrategy {
+    /** 角色包上下文上限（0=不设额外上限，跟随 provider 窗口；与 provider 窗口取小值后成为有效窗口） */
+    readonly contextLimit?: number;
+    /** 每轮工具步数上限（默认 50；内核已消费） */
+    readonly stepBudget?: number;
+    /** 异常时的处理策略（默认 retry） */
+    readonly errorHandling?: ErrorHandling;
+    /** 主动提问触发场景（默认 ['ambiguity', 'decision', 'missing_info']） */
+    readonly askOn?: AskOnTrigger | readonly AskOnTrigger[];
+    /** 主动提问次数上限：按一次用户输入（turn 粒度）计，防单次输入被打断过多次（默认 10） */
+    readonly askLimit?: number;
+}
+/**
+ * L2 行为策略全集
+ * 角色包经此集合声明行为偏好，未配置维度用全局默认值；所有维度为预定义可选值，角色只做"选择"。
+ * 诚实化声明：本集合是"设计空间"非"承诺面"——被实际消费的字段为
+ * prepare 的 summaryFocus（round-summary 提炼视角）；
+ * act 的 toolMode/temperature/outputLimit/toolStepLimit/providerRouting/multiStepReasoning/toolReadonly；
+ * reflect 的 summary/selfReview/userFollowup；global 的 askOn/askLimit/errorHandling/contextLimit/stepBudget。
+ * 边界纪律：无 understandingConfirm 开放键（并入 askOn['confirm']/ask_user，见文件头注）；无 costBudget 键（内核无定价能力、宿主无执行者，无消费者的策略键不保留，遵循"预留键非承诺"纪律）。
+ */
+export interface BehaviorStrategy {
+    /** 回答前认知策略 */
+    readonly prepare?: PrepareStrategy;
+    /** 回答中行动策略 */
+    readonly act?: ActStrategy;
+    /** 回答后沉淀策略 */
+    readonly reflect?: ReflectStrategy;
+    /** 跨阶段全局策略 */
+    readonly global?: GlobalStrategy;
+}
+/**
+ * L2 运行时策略（loop 运行态，单一策略对象）
+ * 由 BehaviorStrategy 经 resolveL2Strategy 解析 + 默认值兜底后，一次性注入 AgentLoop；
+ * 只含"角色包可影响"的行为维度，内核内部常数不在此列。
+ */
+export interface L2RuntimeStrategy {
+    /** 工具调用是否被阻止（toolMode==='block' 时为 true） */
+    readonly toolCallsBlocked: boolean;
+    /** 自审查开关（reflect.selfReview 的解析结果）：true=做一次终审。由 resolveL2Strategy 从布尔数字输入（0=关 / >0=开）映射 */
+    readonly selfReviewEnabled: boolean;
+    /** 单轮工具调用步数上限（act.toolStepLimit：0=无限制 / N=限制步数） */
+    readonly toolStepLimit: number;
+    /** 错误处理策略（global.errorHandling） */
+    readonly errorHandling: ErrorHandling;
+    /** Provider 路由策略（act.providerRouting） */
+    readonly providerRouting: ProviderRouting;
+    /** 角色包上下文上限（global.contextLimit：0=不设额外上限，有效窗口 = provider 窗口） */
+    readonly contextLimit: number;
+    /** 步数预算上限（global.stepBudget：0=未声明，走内核 maxIterations 兜底——非「不限」） */
+    readonly stepBudget: number;
+    /** 多步推理模式（act.multiStepReasoning） */
+    readonly multiStepReasoning: MultiStepReasoning;
+    /** 主动提问次数上限（global.askLimit：turn 粒度防打扰；ask_user 硬护栏拦截超限调用） */
+    readonly askLimit: number;
+    /** 工具只读模式（act.toolReadonly） */
+    readonly toolReadonly: ToolReadonly;
+}
+/** 能力声明：以中立能力命名空间（`file:write`/`web:search`）声明，由各实现映射到自有工具（见 capabilityMap.ts 映射表） */
+export interface RolePackCapability {
+    /** 中立能力名（如 `file:write` / `web:search` / `llm:summarize`） */
+    readonly capability: string;
+    /** 可选：能力说明（供 LLM 与校验器理解） */
+    readonly description?: string;
+}
+/**
+ * 组（宿主装配级）：组长角色包 + 组员名单。会议名单容器，非选择对象。
+ * 组长身份唯一（一个角色包只能是一个组的组长，宿主校验）；组员可被多组引用（引用共享）；
+ * 成员名单非空（组员被删光 → 该组失效，仅影响会议不影响日常）；组员仅作小组会议参与者，不用于日常。
+ */
+export interface RolePackTeam {
+    /** 组长角色包名（组的定义者；会议默认汇总者 = activePack） */
+    readonly leader: string;
+    /** 组员角色包名列表（非空；会议参与者） */
+    readonly members: readonly string[];
+}
+/** 角色包元数据（manifest.json 解析结果），用于匹配、传播、版本管理 */
+export interface RolePackMeta {
+    /** 角色包名称（唯一标识） */
+    readonly name: string;
+    /** UI 展示名（与 name 分离：name 为内部唯一标识，displayName 为本地化展示名，缺省回退 name=displayName ?? name） */
+    readonly displayName?: string;
+    /** 角色包描述 */
+    readonly description?: string;
+    /** 版本号 */
+    readonly version?: string;
+    /** 可选：作者/来源 */
+    readonly author?: string;
+    /** 格式版本（缺省按 1.0.0 处理） */
+    readonly formatVersion?: string;
+    /** 拟人化场景声明（tool_assistant=工具型默认 / companion=拟人化陪伴） */
+    readonly interactionType?: 'tool_assistant' | 'companion';
+    /** AI 身份标注（默认强制 true） */
+    readonly aiIdentityDisclosure?: boolean;
+    /** 未成年人保护（默认 required） */
+    readonly minorProtection?: 'required';
+    /** 接手衔接提示词：被宿主「带入对话」时预填的特色话术；角色包只描述自己，缺省由宿主回退通用话术 */
+    readonly handoffPrompt?: string;
+}
+/**
+ * 角色包（Role Pack）—— L1 内容层 + L2 策略层
+ * 从角色包文件夹的 manifest.json（唯一权威控制文件）+ 独立内容文件（persona.md/rules.md/skills/*）装配而成。
+ * 实现 ConfigResource 约束：name 从 meta 派生，content 从 personaContent 派生。
+ */
+export interface RolePack {
+    /** 角色包名称（派生自 meta.name，满足 ConfigResource 约束） */
+    readonly name: string;
+    /** 内容正文（派生自 personaContent，满足 ConfigResource 约束） */
+    readonly content: string;
+    /** 来源文件路径（manifest.json 绝对路径，满足 ConfigResource 约束） */
+    readonly filePath: string;
+    /** 角色包元数据（manifest.json） */
+    readonly meta: RolePackMeta;
+    /** 角色身份设定正文（来自 persona.md；persona 允许缺省，此时为空串） */
+    readonly personaContent: string;
+    /** 角色性格特征（traits），从 persona.md frontmatter 解析（traits.xxx = 0-1 数值），供宿主情感计算 */
+    readonly traits?: Record<string, number>;
+    /** 确定性规则列表（来自 rules.md，逐行解析）。安全规则，装载时全量注入，不可丢失 */
+    readonly rules: readonly string[];
+    /** 内嵌技能注册（manifest.skills 对象数组，各自引用包内技能文件 file 路径；能力声明已独立为顶层 capabilities） */
+    readonly skills: readonly RolePackManifestSkill[];
+    /** 能力声明（manifest.capabilities 顶层数组，独立于 skills——「能力面（权限）」与「内容面（技能正文）」分离） */
+    readonly capabilities: readonly RolePackCapability[];
+    /** 行为策略声明（manifest.strategy）；未配置的维度使用全局默认值 */
+    readonly strategy?: BehaviorStrategy;
+    /** 装配结果缓存（由 parseManifestPack 预计算；角色包装载后不可变，缓存安全） */
+    readonly _cachedAssembly?: RolePackAssembly;
+}
+/** 角色包装载结果：供装配层直接注入 system prompt；strategy 已合并默认值成为完整策略 */
+export interface RolePackAssembly {
+    /** 角色包元数据 */
+    readonly meta: RolePackMeta;
+    /** 来源文件路径（manifest.json 绝对路径，供宿主区分内置/用户来源） */
+    readonly filePath: string;
+    /** 合并后的 persona prompt（含规则注入与主动提问指令） */
+    readonly personaPrompt: string;
+    /** 内嵌技能注册（manifest.skills，对象数组，支持多个） */
+    readonly skills: readonly RolePackManifestSkill[];
+    /** 能力声明列表（manifest 顶层 capabilities） */
+    readonly capabilities: readonly RolePackCapability[];
+    /** 完整行为策略（所有维度都有值，未声明维度用默认值，异于 RolePack.strategy） */
+    readonly strategy: BehaviorStrategy;
+    /** 角色性格特征（traits），从 persona.md frontmatter 解析（traits.xxx = 0-1 数值），供宿主情感计算 */
+    readonly traits?: Record<string, number>;
+    /** manifest 校验问题（健康徽章数据源）：装载时 validateManifest 全量 issues（含 warning）。
+     *  可选；宿主 UI 据此叠加健康徽章 + 问题列表，镜像技能徽章模式。 */
+    readonly validationIssues?: readonly RolePackValidationIssue[];
+}
+/** manifest.json 中注册的技能对象：以对象数组引用包内技能文件（相对包根路径），可选 name/description */
+export interface RolePackManifestSkill {
+    /** 技能文件路径（相对角色包文件夹根）；装载时由 parseManifestPack 预缓存正文（skillsWithContent），正文经渐进披露 L2（read_skill）直取缓存，磁盘 IO 已消除 */
+    readonly file?: string;
+    /** 技能名（可选，缺省取文件名去扩展名） */
+    readonly name?: string;
+    /** 技能说明（可选，供 LLM 与校验器理解） */
+    readonly description?: string;
+    /** L3 层数据（资源 + 脚本）：由 scanPackSkills 装载时自动发现；L3 不进 system prompt，按需调用 */
+    readonly layer3?: {
+        readonly resources: ReadonlyArray<{
+            readonly path: string;
+            readonly size: number;
+            /** 资源来源子目录（resources/references，兼容主流 references/ 辅助文档目录），read_resource 据此选择读取基目录；取值 SSOT 在 `utils/scanner` */
+            readonly subdir?: ResourceSubdir;
+        }>;
+        readonly scripts: ReadonlyArray<{
+            readonly path: string;
+            /** 运行时（值域 SSOT = utils/scanner.ScriptRuntime，由 SCRIPT_RUNTIME_MAP 扩展名映射推断） */
+            readonly runtime: ScriptRuntime;
+            readonly size: number;
+        }>;
+    };
+    /** 技能正文缓存（load 时预装载，readSkillContent 直取；null=未缓存，undefined=未装载懒加载） */
+    readonly content?: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/role-pack/types.js

@@ -0,0 +1,8 @@
+/**
+ * 角色包（Role Pack）类型定义——以"角色"为单位，把身份/技能/规则组织成可装载的整体。
+ *
+ * 三层结构：L1 内容层（persona/rule/skill）、L2 策略层（枚举开关，角色只"选择"不"定义"）、
+ * L3 代码层（远期预留）。装配层经"角色包清单"抽象，只认清单不认来源。
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/role-pack/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

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

@@ -0,0 +1,38 @@
+/**
+ * 角色包格式校验器：独立于任何实现、只吃解析后的 manifest.json 对象，按 spec 严格判定
+ * （manager 宽松容错，二者互补）。文件夹形态，manifest.json 为核心控制文件。
+ * 校验：必填字段（name）、键名合法性（未知键 warning+忽略）、版本语义（formatVersion 可选，缺省 1.0.0）、
+ * 合规分档（interactionType/aiIdentityDisclosure/minorProtection）、策略键、内容路径、
+ * skills/capabilities 格式。companion 内容红线由装载方在读取内容后调用 checkCompanionContentRedline。
+ * 零依赖、纯函数。
+ */
+/** 校验严重级别：error=拒绝加载 / warning=可装载但提示 */
+export type RolePackIssueSeverity = 'error' | 'warning';
+/** 单个校验问题 */
+export interface RolePackValidationIssue {
+    severity: RolePackIssueSeverity;
+    /** 稳定问题码（机器可判读，如 MISSING_NAME / INVALID_CAPABILITY） */
+    code: string;
+    /** 字段点路径（如 name / strategy.prepare.contextAssembly） */
+    path: string;
+    /** 人类可读描述 */
+    message: string;
+}
+/** 校验结果 */
+export interface RolePackValidationResult {
+    /** 无 error 即 valid（warning 不阻塞装载） */
+    valid: boolean;
+    issues: readonly RolePackValidationIssue[];
+}
+/** handoffPrompt 最大长度（字符）：接手话术防巨型注入 prompt（rolePackManager 截断兜底复用） */
+export declare const MAX_HANDOFF_PROMPT_LEN = 2000;
+/**
+ * 校验 manifest.json：必填/版本、合规分档、策略键、skills/capabilities。
+ * 未知键 warning + 忽略；valid = 无 error（warning 不阻塞装载）。
+ */
+export declare function validateManifest(manifest: Record<string, unknown>): RolePackValidationResult;
+/** 便捷入口：校验原始 manifest.json 文本（非法 JSON 返回 INVALID_JSON error） */
+export declare function validateManifestText(raw: string): RolePackValidationResult;
+/** 校验 companion 内容红线段（虚拟亲密关系）——正文在独立内容文件，本校验器纯函数不读文件，由装载方读内容后调用；tool_assistant 豁免 */
+export declare function checkCompanionContentRedline(content: string): RolePackValidationIssue[];
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/role-pack/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,yCAAyC;AACzC,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,SAAS,CAAC;AAExD,aAAa;AACb,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,WAAW;AACX,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC5C;AAkDD,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAoX3C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,wBAAwB,CAY5F;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAiB1E;AAED,qFAAqF;AACrF,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,EAAE,CAavF"}