@ai-setting/roy-agent-core 1.7.64 → 1.7.65

package/dist/env/task/plugins/decision-port.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview Task #4467 — decision model 载体适配层（DecisionPort）
+ *
+ * 契约：/tmp/task-create-verdict-contract-v2.md §7
+ *
+ * 载体实测事实（#4107 踩过的坑，务必照抄）：
+ *   - baseURL 本身就是请求地址，**不是** `{baseURL}/chat/completions`
+ *   - **不能用标准 chat/completions 格式**：`state` / `questions` 必须是**顶层键**
+ *     （标准 `messages:[...]` → 400 `Field required: state & Field required: questions`）
+ *   - 响应形态：`{ answers: { <key>: { type, choice, confidence, probabilities } }, usage, latency_ms }`
+ *   - API 硬限：`questions.<key>.criteria` 最多 255 个 choices
+ *   - 超时是真实风险：实测 100ms ~ 13452ms
+ */
+export interface DecisionRequest {
+    /**
+     * 决策上下文。
+     *
+     * ⚠️ Task #4620：**可以是一段文本**。
+     *   - systemone 载体（阿里百炼）：JSON 对象 `{task_to_route, similar_tasks}`
+     *   - laya 载体（#4614 的微调模型）：中文文本
+     *     `【新任务标题】…\n【新任务描述】…\n【候选任务】…`
+     *
+     *   两种形态都合法 —— 载体**只在训练分布内**才判得准（实测差 32.5 个百分点），
+     *   见 `laya-train/scripts/format_probe.py`。
+     *
+     * ⚠️ 类型放宽到 `unknown` 而非 `Record<string, unknown>` —— 因为文本 state
+     *   不是对象。**运行时按原样透传**（JSON.stringify 会把它序列化成字符串）。
+     */
+    state: unknown;
+    questions: Record<string, unknown>;
+}
+export interface DecisionAnswer {
+    choice: string;
+    confidence: number;
+    probabilities?: Record<string, number>;
+    /**
+     * Task #4627 — **Jev 公式置信度**（#302 的核心字段）。
+     *
+     * ⚠️ `confidence` 是**归一化熵**，**不是** Jev 公式置信度。
+     *   laya 同时返回两个字段，60 条实测里 20 条差异 > 0.05。
+     *   门禁**必须**读 `x_jev_confidence`（缺失时回退 `answer_confidence` → `confidence`）。
+     *
+     *   `LayaDecisionPort` 已在 normalize() 里把 `confidence` 覆盖成选源后的值，
+     *   但那是**载体侧**的归一化 —— 判定层不能依赖它（换载体就失效）。
+     *   所以判定层自己再选一次源，两层都指向 `x_jev_confidence`。
+     */
+    x_jev_confidence?: number;
+    /** Jev 公式置信度的另一个别名（laya 返回） */
+    answer_confidence?: number;
+}
+export interface DecisionResponse {
+    answers: Record<string, DecisionAnswer>;
+    usage?: {
+        input_tokens?: number;
+    };
+    latency_ms?: number;
+}
+export interface DecisionPort {
+    /** 执行一次决策。失败抛错，调用方按契约 §8 降级。 */
+    decide(req: DecisionRequest): Promise<DecisionResponse>;
+    /** 供测试/熔断查询当前是否已自我禁用 */
+    isDisabled(): boolean;
+}
+export interface SystemOneDecisionPortOptions {
+    /** 端点（**本身就是请求地址**，不要拼 /chat/completions） */
+    baseURL: string;
+    apiKey: string;
+    model: string;
+    /** 硬超时（默认 2000ms，契约 P8） */
+    timeoutMs?: number;
+    /** 熔断计数的 session 维度（契约 P9） */
+    sessionId?: string;
+    /** 连续超时多少次后自我禁用（默认 3） */
+    maxStrikes?: number;
+    /** 注入 fetch（测试用） */
+    fetchImpl?: typeof globalThis.fetch;
+}
+export declare class SystemOneDecisionPort implements DecisionPort {
+    private readonly baseURL;
+    private readonly apiKey;
+    private readonly model;
+    private readonly timeoutMs;
+    private readonly sessionId;
+    private readonly maxStrikes;
+    private readonly fetchImpl;
+    /** 同 session 连续超时计数 */
+    private timeoutStrikes;
+    private disabled;
+    constructor(options: SystemOneDecisionPortOptions);
+    isDisabled(): boolean;
+    /**
+     * 执行一次决策。
+     *
+     * Task #4494 trace 插桩 —— **这是整条链路最关键的可观测点**（真调模型）。
+     *
+     * ⚠️ 安全硬约束：`paramFilter` 只输出**结构摘要**，绝不输出
+     *    - `req.state` 全量（200 候选可达 47KB）
+     *    - `req.questions` 的 criteria 全量（每个候选一条渲染串）
+     *    - **apiKey**（它在 `this.apiKey` 上，args 里本来就没有，但绝不能
+     *      顺手把 `this` 记录下来 —— paramFilter 只用 args，不碰 this）
+     *
+     * ⚠️ 延迟观测：`resultFilter` 记录 `latency_ms`（载体自己返回）+
+     *    `answers` 的 choice/confidence。P50/P95 统计靠这个字段。
+     */
+    decide(req: DecisionRequest): Promise<DecisionResponse>;
+}
+export interface DecisionAuthConfig {
+    baseURL: string;
+    apiKey: string;
+    model: string;
+}
+/**
+ * 从 `~/.roy-agent/auth.json` 的 `providers.ali-decision` 读取端点配置。
+ *
+ * 路径与字段（实测）：
+ *   ~/.roy-agent/auth.json → providers["ali-decision"].baseURL
+ *                          → providers["ali-decision"].apiKey
+ */
+export declare function loadSystemOneAuth(authPath?: string): Promise<DecisionAuthConfig | null>;

package/dist/env/task/plugins/decision-renderers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview Task #4620 — DecisionRenderer 的两个实现
+ *
+ * `DecisionHintPlugin`（#4481）的判定逻辑是载体无关的；**渲染**不是。
+ * 不同载体的模型是在各自的渲染分布上训出来的，把 state/criteria 发成
+ * 另一种形态，模型就落到分布外 —— 实测代价高达 32.5 个百分点。
+ *
+ *   实测（200 条 held-out，laya-train/scripts/format_probe.py）：
+ *     laya 原样 state + laya 原样 key  → 79.00%
+ *     roy JSON state + laya key        → 56.50%
+ *     laya state + roy key             → 63.00%
+ *     roy JSON state + roy key         → 46.50%
+ */
+import { layaCandidateKey, layaCandidateValue, LAYA_NEW_TASK_DESC } from "./laya-render";
+import type { DecisionRenderer } from "./decision-hint-plugin";
+/** Stage A 的 instructions —— 两个载体各自训练时用的措辞 */
+export declare const SYSTEMONE_STAGE_A_INSTRUCTIONS = "\u5224\u65AD\u672C\u6B21\u300E\u65B0\u4EFB\u52A1\u8BF7\u6C42\u300F\u5E94\u8BE5\u65B0\u5EFA\u8FD8\u662F\u590D\u7528\u67D0\u4E2A\u5DF2\u6709\u4EFB\u52A1\u3002\u82E5\u5E94\u590D\u7528\uFF0C\u9009\u8BE5\u4EFB\u52A1\u7684 #id\uFF1B\u82E5\u5E94\u65B0\u5EFA\uFF0C\u9009 NEW_TASK\u3002\u8F93\u51FA choice/confidence/probabilities\u3002";
+export declare const LAYA_STAGE_A_INSTRUCTIONS = "\u4F18\u5148\u590D\u7528\uFF1A\u82E5\u5019\u9009\u4E0E\u8BF7\u6C42\u5C5E\u4E8E\u540C\u4E00\u5DE5\u4F5C\u6D41/\u540C\u4E00\u7CFB\u5217/\u76EE\u6807\u91CD\u53E0\uFF0C\u5FC5\u987B\u9009\u8BE5\u5019\u9009\u7684 #id\uFF1B\u4EC5\u5F53\u5B8C\u5168\u65E0\u5173\u65F6\u624D\u9009 NEW_TASK\u3002";
+/**
+ * systemone 渲染器 —— 阿里百炼 systemone / #4107 的默认形态。
+ *
+ * state 是 JSON 对象（`task_to_route` + `similar_tasks`），
+ * criteria key = `#<id> [<type>] <title[:40]>`。
+ */
+export declare const systemoneRenderer: DecisionRenderer;
+/**
+ * laya 渲染器 —— #4614 的 Laya 微调模型的训练格式。
+ *
+ * state 是中文文本，候选**重复**在 state 与 criteria 里（训练时的形态）。
+ * criteria key = `#<id> <title[:50]>`（无 `[type]` 段）。
+ */
+export declare const layaRenderer: DecisionRenderer;
+export { LAYA_NEW_TASK_DESC, layaCandidateKey, layaCandidateValue };

package/dist/env/task/plugins/index.d.ts

@@ -2,6 +2,7 @@
  * @fileoverview Task Plugins Module
  */
 export { TaskTagPlugin } from "./task-tag-plugin";
+export { LayaDecisionPlugin, createLayaDecisionPlugin, LAYA_REUSE_THRESHOLD, type LayaDecisionPluginOptions, } from "./laya-decision-plugin";
 export { createAutoTaskPlugin, type AutoTaskPluginConfig, } from "./auto-task-plugin";
 export { WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, } from "./workflow-extractor-agent";
 export { LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, type TaskNotifyConfig, NotifyType, } from "./lark-cli-task-notify-plugin";

package/dist/env/task/plugins/index.js

@@ -1,20 +1,24 @@
 import {
+  LAYA_REUSE_THRESHOLD,
   LarkCliTaskNotifyHook,
+  LayaDecisionPlugin,
   NotifyType,
   PerTaskGroupChatPlugin,
   TaskTagPlugin,
   WORKFLOW_EXTRACTOR_PROMPT,
   createAutoTaskPlugin,
   createLarkCliTaskNotifyHook,
+  createLayaDecisionPlugin,
   createPerTaskGroupChatPlugin,
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-ry2eztft.js";
+} from "../../../shared/@ai-setting/roy-agent-core-f6c0nadn.js";
 import"../../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
 import"../../../shared/@ai-setting/roy-agent-core-9bs6xrav.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-6masakz4.js";
+import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
 import {
   DEFAULT_APP_LINK_BASE,
   LarkCardPatchNotifier,
@@ -63,6 +67,7 @@ export {
   formatDurationMs,
   formatDateTimeForDisplay,
   createPerTaskGroupChatPlugin,
+  createLayaDecisionPlugin,
   createLarkCliTaskNotifyHook,
   createAutoTaskPlugin,
   buildWorkflowCard,
@@ -72,7 +77,9 @@ export {
   TaskTagPlugin,
   PerTaskGroupChatPlugin,
   NotifyType,
+  LayaDecisionPlugin,
   LarkCliTaskNotifyHook,
   LarkCardPatchNotifier,
+  LAYA_REUSE_THRESHOLD,
   DEFAULT_APP_LINK_BASE
 };

package/dist/env/task/plugins/laya-decision-plugin.d.ts

@@ -0,0 +1,136 @@
+/**
+ * @fileoverview Task #4620 — Laya 决策插件：把 #4467 的 decision 检测接到本地 Laya 服务
+ *
+ * 与 `DecisionHintPlugin`（#4481，阿里百炼 provider）的关系：
+ *   - `DecisionHintPlugin` 是**载体无关**的判定逻辑（Stage A/B、门槛、hint 渲染）
+ *   - 本文件是**载体接入层**：读 `~/.roy-agent/auth.json` 的 `providers["laya-decision"]`，
+ *     构造 `LayaDecisionPort`，再把 port 注入 `DecisionHintPlugin`
+ *
+ * 形态：**只提示，不拦截**（与 #4467 契约一致）。
+ *
+ * ── fail-open 总原则（硬要求） ────────────────────────────────────────────────
+ *
+ * 本插件挂在 `task:before.create` 上，**任何**异常都不得影响 task_create：
+ *   - auth.json 读不到 / provider 不存在 → 不装 port → 插件直接跳过
+ *   - 网络错误 / 超时 / HTTP 非 2xx / 响应结构不对 → 判定降级为 null → 不出 hint
+ *   - 熔断后 → isDisabled() → 跳过
+ *   - 候选为空 → 不调模型
+ *
+ * 因此这里的**每一个** await 都有 try/catch 包裹，且 catch 里只记日志、绝不 rethrow。
+ *
+ * ── 置信度门禁 ──────────────────────────────────────────────────────────────
+ *
+ * 复用建议（"应复用 #X"）是**破坏性建议**（用户可能因此不建新任务），
+ * 按 #4467 的 Q4 拍板用高门槛（`REUSE_ADOPT_THRESHOLD` 之上单独一档；
+ * Task #4643 起默认 **≥ 0.92**）。
+ * laya 的 `x_jev_confidence` 在 896 条实测中：thr=0.85 → 提示精确率 80.5%、
+ * thr=0.90 → 84.9%、thr=0.95 → 87.0%（coverage 28.7% / 25.9% / 18.9%）。
+ * ⚠️ Task #4643 live 实测（25 条 gold unseen）：0.85~0.92 区间零 case，
+ * 误报的 jev 全部 ≥0.938 —— 该模型「错得自信」，单纯提阈值滤不掉误报。
+ */
+import type { DecisionPort } from "./decision-port";
+import type { TaskCreateContext } from "../hooks/contexts";
+/** 复用建议的置信度门禁（#4467 Q4：破坏性动作门槛；Task #4643 提到 0.92） */
+export declare const LAYA_REUSE_THRESHOLD = 0.92;
+export interface LayaDecisionPluginOptions {
+    /** auth.json 路径（默认 ~/.roy-agent/auth.json） */
+    authPath?: string;
+    /** 硬超时（默认 2000ms） */
+    timeoutMs?: number;
+    /** 连续超时多少次后自我禁用（默认 3） */
+    maxStrikes?: number;
+    /** 置信度来源（默认 auto：x_jev_confidence 优先） */
+    confidencePref?: "auto" | "jev" | "entropy";
+    /** 注入 fetch（测试用） */
+    fetchImpl?: typeof globalThis.fetch;
+    /** 注入 port（测试用；给了就不读 auth.json） */
+    decisionPort?: DecisionPort;
+    /** 注入上下文读取（生产用 getEnvContextOrEmpty().parentTaskId） */
+    envParentTaskIdProvider?: () => number | undefined | null;
+    /**
+     * 「建议复用」硬提示的置信度门禁（默认 LAYA_REUSE_THRESHOLD = 0.92）。
+     * 896 条实测：0.85 → 精确率 80.5%（coverage 28.7%）、0.9 → 84.9%、0.95 → 87.0%。
+     */
+    reuseThreshold?: number;
+    /** 低于此置信度完全不出提示（默认与 reuseThreshold 同值 = 0.92） */
+    softHintThreshold?: number;
+    /**
+     * 单候选快捷路径（默认 false）。
+     * 开启后「只有 1 个候选 → 不调模型直接提示」—— 该路径**没有置信度**，
+     * 与「必须门禁 ≥0.92」冲突，所以默认关掉。
+     */
+    singleCandidateShortcut?: boolean;
+}
+/**
+ * Laya 决策插件 —— 挂在 `task:before.create` 上。
+ *
+ * 用法：
+ * ```ts
+ * const plugin = new LayaDecisionPlugin();
+ * await plugin.execute(ctx);   // ctx: TaskCreateContext | { data: TaskCreateContext }
+ * ```
+ *
+ * ⚠️ `execute()` **永远不抛**。
+ */
+export declare class LayaDecisionPlugin {
+    readonly name = "laya-decision";
+    readonly version = "1.0.0";
+    readonly description = "Task #4620 \u2014 task:before.create \u51B3\u7B56\u68C0\u6D4B\uFF08\u672C\u5730 Laya \u670D\u52A1\u8F7D\u4F53\uFF0C\u53EA\u63D0\u793A\u4E0D\u62E6\u622A\uFF09";
+    private readonly options;
+    private port;
+    private portResolved;
+    private inner;
+    constructor(options?: LayaDecisionPluginOptions);
+    /** 当前是否已自我禁用（熔断）—— 供观测 */
+    isDisabled(): boolean;
+    /**
+     * hook 入口 —— **永不抛**。
+     *
+     * 失败路径一律是「不出 hint」，不影响 task_create 的成功语义。
+     */
+    execute(ctx: TaskCreateContext | {
+        data: TaskCreateContext;
+    }): Promise<void>;
+    /** 懒加载 + 缓存 port（读 auth.json 只做一次） */
+    private ensureInner;
+    private resolvePort;
+}
+/** 取进程级共享实例（仅生产路径用；传了 options 就新建，避免测试串味） */
+export declare function getSharedLayaDecisionPlugin(options?: LayaDecisionPluginOptions): LayaDecisionPlugin;
+/**
+ * Task #4627 — 把 LayaDecisionPlugin 包成**可注册到 task hook** 的形态。
+ *
+ * ⚠️ 为什么不是 Agent `Plugin`：
+ *   - `AgentComponent.registerPlugin(agentName, plugin)` 只把 plugin 放进
+ *     `agent.plugins` Map，**不写 globalHookManager**。
+ *   - `agent.plugins` 只由 `executePluginHooks()` 派发，且只在 **agent 作用域**
+ *     的 hook 点被调用（`agent:before.start` / `agent:before.llm` / `agent:before.tool`
+ *     / `agent:after.tool` / `agent:on.iteration` / `agent:after.react`
+ *     / `agent:after.complete` / `agent:on.error` / `on.error`）
+ *     —— **不含 `task:before.create`**。
+ *   - `task:before.create` 真正的派发路径是：
+ *     `TaskComponent.createTask()` → `executeHook(TaskHookPoints.BEFORE_CREATE, createCtx)`
+ *     → `globalHookManager.execute("task:before.create", data, metadata)`
+ *   - 所以正确注册方式是 `taskComponent.registerHook(TaskHookPoints.BEFORE_CREATE, {...})`。
+ *
+ *   附带类型问题（Agent `Plugin` 这条路本身走不通）：
+ *   - `agent/types.ts` 的 `HookPoint` 联合类型里**没有** `"task:before.create"`
+ *     （旧代码用 `as HookPoint` 强转绕过 → 运行期不报错但永远不触发）
+ *   - `hook/types.ts` 的 `HookResult` 是 `{stopped?, action?, results?}`，
+ *     **没有** `continue` 字段（旧代码 `return { continue: true }` 不匹配）
+ *
+ * 本工厂返回的是 `Hook` 形态（`hook/types.ts`），由
+ * `registerLayaDecisionTaskHook()` 负责注册到 task hook 通道。
+ *
+ * ⚠️ fail-open：注册失败不影响 agent 启动（调用方自行 try/catch）。
+ */
+export declare function createLayaDecisionPlugin(options?: LayaDecisionPluginOptions): {
+    /** Hook 唯一名称（用于幂等去重 / unregister） */
+    name: string;
+    /** 执行优先级 */
+    priority: number;
+    /** hook 执行体 —— 永不抛 */
+    execute: (ctx: unknown) => Promise<void>;
+    /** 内层插件实例（供观测 / 测试） */
+    plugin: LayaDecisionPlugin;
+};

package/dist/env/task/plugins/laya-port.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @fileoverview Task #4620 — Laya 自托管决策服务的 DecisionPort 实现
+ *
+ * 背景：#4467 的 decision 检测最初接的是阿里百炼的 systemone（`ali-decision`
+ * provider）。#4614 把一个 Laya 微调模型训到严格 held-out 81.8%，本文件把它
+ * 封装成**标准 Jev 语义服务**后接进同一套 `DecisionPort` 抽象。
+ *
+ * ── 协议对照（与阿里百炼 systemone 同构，服务端实测） ────────────────────────
+ *
+ * | 维度           | 阿里百炼 systemone            | Laya laya-serve            |
+ * |----------------|-------------------------------|----------------------------|
+ * | 请求 URL       | baseURL 本身就是请求地址       | `{baseURL}/v1/systemone`   |
+ * | 请求体顶层键   | state / questions              | state / questions          |
+ * | body.model     | decision-model-preview         | task-decision              |
+ * | 鉴权 header    | Authorization: Bearer <key>    | Authorization: Bearer <key>|
+ * | 响应 answers   | { qid: {choice, confidence,     | 同构 + 额外字段             |
+ * |                |   probabilities} }             |   x_jev_confidence         |
+ * |                |                               |   answer_confidence        |
+ * |                |                               |   action.act_probability   |
+ * | usage          | { input_tokens }               | { input_tokens,            |
+ * |                |                               |   state_tokens,            |
+ * |                |                               |   state_tokens_dropped,    |
+ * |                |                               |   truncated, ... }         |
+ * | routing        | 无                            | { model, repo }            |
+ *
+ * ⚠️ **confidence 语义陷阱（#302）**：laya 返回两个置信度：
+ *   - `confidence`         = 归一化熵（不是 Jev 公式置信度）
+ *   - `x_jev_confidence`   = Jev 公式算出的置信度
+ *   按 laya 源码注释，**从 Jev 移植阈值的客户端应读 `x_jev_confidence`**。
+ *   本 port 默认用 `x_jev_confidence`，缺失时回退 `answer_confidence` → `confidence`。
+ *   用 `confidencePref` 可强制指定来源（便于 A/B 对比）。
+ *
+ * ⚠️ **state 截断**：laya 的 usage 会报 `state_tokens_dropped` / `truncated`。
+ *   本 port **不静默吞掉**这个信号 —— 它把 `truncated` 抬到 answer 的 `truncated`
+ *   字段上，让调用方（插件）能降级或记录。截断意味着候选描述被部分丢弃，
+ *   模型的判别力会下降，属于**必须观测**的状态。
+ *
+ * ── 与 `SystemOneDecisionPort` 的关系 ──────────────────────────────────────
+ *
+ * 二者实现同一套超时 / 熔断 / 泄漏断言语义，但：
+ *   - SystemOne: baseURL **就是**请求地址；响应无 x_jev_confidence
+ *   Laya:       baseURL 是**服务根**，请求地址是 `{baseURL}/v1/systemone`；
+ *               多一层 x_jev_confidence 的解析与截断信号
+ * 抽出一个共用的基类会引入"URL 拼不拼"的分支混乱，所以这里独立实现，
+ * 共享的纯逻辑（超时判定、熔断计数）保持一致的语义约定。
+ */
+import type { DecisionPort, DecisionRequest, DecisionResponse } from "./decision-port";
+/** laya 的 answers 里多出来的字段（父接口只声明了 choice/confidence/probabilities） */
+export interface LayaDecisionAnswer {
+    choice: string;
+    confidence: number;
+    /** Jev 公式置信度 —— #302：从 Jev 移植阈值的客户端应读这个 */
+    x_jev_confidence?: number;
+    /** 温度缩放后的答案置信度 */
+    answer_confidence?: number;
+    probabilities?: Record<string, number>;
+    action?: {
+        act_probability?: number;
+    };
+    /** laya 报 state 被截断时为 true —— 本 port 从 usage 抬升上来 */
+    truncated?: boolean;
+}
+export interface LayaDecisionResponse extends DecisionResponse {
+    answers: Record<string, LayaDecisionAnswer>;
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        state_tokens?: number;
+        state_tokens_dropped?: number;
+        truncated?: boolean;
+        truncated_questions?: string[];
+    };
+    routing?: {
+        model?: string;
+        repo?: string;
+    };
+}
+export interface LayaDecisionPortOptions {
+    /** 服务根地址，例如 http://127.0.0.1:8901（**不带** /v1/systemone） */
+    baseURL: string;
+    apiKey: string;
+    /** 注册在服务上的模型名（默认 task-decision） */
+    model?: string;
+    /** 硬超时（默认 2000ms） */
+    timeoutMs?: number;
+    /** 连续超时多少次后自我禁用（默认 3） */
+    maxStrikes?: number;
+    /** 注入 fetch（测试用） */
+    fetchImpl?: typeof globalThis.fetch;
+    /**
+     * 置信度来源：auto（默认，优先 x_jev_confidence）/ jev / entropy
+     * - auto：x_jev_confidence → answer_confidence → confidence
+     * - jev：只用 x_jev_confidence（缺失则视为 0）
+     * - entropy：只用 confidence（归一化熵）
+     */
+    confidencePref?: "auto" | "jev" | "entropy";
+}
+export declare class LayaDecisionPort implements DecisionPort {
+    private readonly baseURL;
+    private readonly apiKey;
+    private readonly model;
+    private readonly timeoutMs;
+    private readonly maxStrikes;
+    private readonly fetchImpl;
+    private readonly confidencePref;
+    /** 同 session 连续超时计数 */
+    private timeoutStrikes;
+    private disabled;
+    constructor(options: LayaDecisionPortOptions);
+    isDisabled(): boolean;
+    /** 请求地址：baseURL 是服务根 → 拼 /v1/systemone */
+    get endpoint(): string;
+    decide(req: DecisionRequest): Promise<LayaDecisionResponse>;
+    /**
+     * 归一化响应：
+     *   1. 把 usage 里的截断信号抬到每个 answer 的 `truncated` 上
+     *   2. 统一置信度字段（`confidence` 保持原义，另给 `jevConfidence`）
+     */
+    private normalize;
+    /**
+     * 置信度选取（#302 的核心）。
+     *
+     * auto 顺序：x_jev_confidence → answer_confidence → confidence
+     * jev 顺序：只用 x_jev_confidence（没有则 0）
+     * entropy 顺序：只用 confidence
+     */
+    private pickConfidence;
+}
+export interface LayaAuthConfig {
+    baseURL: string;
+    apiKey: string;
+    model: string;
+}
+/**
+ * 从 `~/.roy-agent/auth.json` 的 `providers["laya-decision"]` 读取端点配置。
+ *
+ * 路径：~/.roy-agent/auth.json → providers["laya-decision"].baseURL
+ *                                  → providers["laya-decision"].apiKey
+ *                                  → providers["laya-decision"].model（可选）
+ *
+ * ⚠️ 读不到就返回 null —— 调用方必须 fail-open（不提示、不报错）。
+ */
+export declare function loadLayaAuth(authPath?: string): Promise<LayaAuthConfig | null>;

package/dist/env/task/plugins/laya-render.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview Task #4620 — Laya 专用的 state / criteria 渲染
+ *
+ * ── 为什么需要这个文件 ──────────────────────────────────────────────────────
+ *
+ * `decision-hint-plugin.ts`（#4481）里的 `buildStageARequest` 是按**阿里百炼
+ * systemone** 的习惯写的：state 传一个 JSON 对象，criteria key 用
+ * `#<id> [<type>] <title>`。
+ *
+ * 但 #4614 训出来的 Laya 模型是在**完全不同的渲染格式**上训练的
+ * （`laya-train/scripts/build_dataset.py`）：
+ *
+ *   state = "【新任务标题】{title}\n"
+ *           "【新任务描述】{desc[:600]}\n"
+ *           "【候选任务】\n"
+ *           "{key}\n    {value}\n..."          ← 候选也**重复**在 state 里
+ *   key   = "#{id} {title[:50]}"               ← 没有 [type] 段
+ *   value = "{status_letter}|{ago}|{desc[:45]} [tags: a,b,c,d]"   ← 与 roy-agent 相同
+ *
+ * Task #4620 实测（200 条 held-out，scripts/format_probe.py）：
+ *
+ *   | state 格式 | key 格式 | 准确率   |
+ *   |-------------|----------|----------|
+ *   | laya 原样   | laya 原样 | **79.00%** |
+ *   | roy JSON   | laya 原样 | 56.50%   |
+ *   | laya 原样   | roy      | 63.00%   |
+ *   | roy JSON   | roy      | 46.50%   |
+ *
+ * → **两个格式都要对齐**：state 换成 laya 的中文文本形态，key 换成 laya 的
+ *   `#{id} {title[:50]}`（去掉 `[type]` 段）。这是把 46.5% 拉回 79% 的关键。
+ *
+ * ── 与roy-agent 的 key 映射 ─────────────────────────────────────────────────
+ *
+ * laya 的 key 是 `#{id} {title[:50]}`，模型回的 choice 也是这个形态。
+ * 插件要把 choice 映射回 task id —— 见 `matchChoiceToCandidate`。
+ */
+/** laya 训练时的候选 key 长度上限（build_dataset.py: `t["title"][:50]`） */
+export declare const LAYA_CANDIDATE_TITLE_MAX = 50;
+/** laya 训练时的候选描述长度上限（build_dataset.py: `t["desc"][:45]`） */
+export declare const LAYA_CANDIDATE_DESC_MAX = 45;
+/** laya 训练时的 tags 展示上限（build_dataset.py: `t["tags"][:4]`） */
+export declare const LAYA_CANDIDATE_TAGS_MAX = 4;
+/** 新任务描述在 state 里的长度上限（build_dataset.py: `req_desc[:600]`） */
+export declare const LAYA_STATE_DESC_MAX = 600;
+/** laya 训练时的 NEW_TASK 选项描述（必须逐字一致，见 build_dataset.py） */
+export declare const LAYA_NEW_TASK_DESC = "\u65B0\u5EFA\u4E3A\u72EC\u7ACB\u4EFB\u52A1\uFF08\u4E0E\u6240\u6709\u73B0\u6709\u5019\u9009\u5747\u65E0\u660E\u786E\u5173\u8054\uFF09";
+export interface LayaCandidate {
+    id: number;
+    title: string;
+    status: string;
+    /** 相对时间，形如 "3d" / "5h" / "12m" */
+    ago: string;
+    description: string;
+    tags: string[];
+}
+export interface LayaStateInput {
+    title: string;
+    description: string;
+    /** Task #4669 — req 任务自身的 tags（渲染成【请求标签】行；无 tags 时省略） */
+    tags?: string[];
+    candidates: LayaCandidate[];
+}
+/** laya key = `#{id} {title[:50]}` —— 注意**没有** `[type]` 段 */
+export declare function layaCandidateKey(c: {
+    id: number;
+    title: string;
+}): string;
+/**
+ * laya value = `{status_letter}|{ago}|{desc[:45]} [tags: a,b,c,d]`
+ *
+ * 与 roy-agent 的 `renderCandidateValue`（#4107 模板）**结构一致**，
+ * 只有 status 字母大小写不同（laya 训练用大写）。
+ */
+export declare function layaCandidateValue(c: {
+    status: string;
+    ago: string;
+    description: string;
+    tags?: string[];
+}): string;
+/**
+ * 渲染 laya 训练格式的 state。
+ *
+ * ⚠️ 候选**同时**出现在 state 文本里和 criteria 里 —— 这是训练时的形态，
+ *   不是冗余：模型是从 state 的自然语言里读候选的。
+ */
+export declare function renderLayaState(input: LayaStateInput): string;
+/**
+ * 渲染 laya 训练格式的 criteria。
+ *
+ * NEW_TASK 的**描述必须逐字**用 `LAYA_NEW_TASK_DESC` —— 训练集里每个 case
+ * 都是这句话，换字会让模型对「新建」这个选项的先验偏移。
+ */
+export declare function renderLayaCriteria(candidates: LayaCandidate[]): Record<string, string>;
+/**
+ * 把模型回的 choice 映射回候选 task id。
+ *
+ * laya 的 choice 是完整的 key（`#1234 标题...`），但也可能被截断成裸 `#1234`。
+ * 两种都要认。
+ */
+export declare function matchChoiceToCandidate(choice: string, candidates: LayaCandidate[]): number | undefined;

package/dist/env/task/tools/index.js

@@ -9,7 +9,8 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-xw4wsj38.js";
+} from "../../../shared/@ai-setting/roy-agent-core-t0ktaevq.js";
+import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
 import"../../../shared/@ai-setting/roy-agent-core-7cbpmk4q.js";
 import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";

package/dist/index.js

@@ -61,21 +61,21 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-vncwfzw5.js";
+} from "./shared/@ai-setting/roy-agent-core-6z412atw.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-e4hehcdr.js";
+} from "./shared/@ai-setting/roy-agent-core-hmdcz3g9.js";
 import"./shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import"./shared/@ai-setting/roy-agent-core-jm136jzh.js";
 import"./shared/@ai-setting/roy-agent-core-hjejpcg5.js";
 import"./shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import"./shared/@ai-setting/roy-agent-core-gxzxq1sf.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-xw4wsj38.js";
+import"./shared/@ai-setting/roy-agent-core-t0ktaevq.js";
 import"./shared/@ai-setting/roy-agent-core-rn57psp0.js";
 import {
   EventSourceComponent
-} from "./shared/@ai-setting/roy-agent-core-vd9zak15.js";
+} from "./shared/@ai-setting/roy-agent-core-e42v9bcq.js";
 import {
   BountyIMInstance,
   TimerInstance,
@@ -87,7 +87,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "./shared/@ai-setting/roy-agent-core-1h5bbqcg.js";
+} from "./shared/@ai-setting/roy-agent-core-18am1h07.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -112,7 +112,7 @@ import {
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-ry2eztft.js";
+} from "./shared/@ai-setting/roy-agent-core-f6c0nadn.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
@@ -130,6 +130,7 @@ import {
   getBuiltInPrompt,
   getBuiltInPromptNames
 } from "./shared/@ai-setting/roy-agent-core-6masakz4.js";
+import"./shared/@ai-setting/roy-agent-core-tr3ep81v.js";
 import"./shared/@ai-setting/roy-agent-core-0ys85x46.js";
 import"./shared/@ai-setting/roy-agent-core-zk2jg0v7.js";
 import {

package/dist/shared/@ai-setting/{roy-agent-core-1h5bbqcg.js → roy-agent-core-18am1h07.js}

@@ -13,7 +13,7 @@ import {
   createPerTaskGroupChatPlugin,
   extractPerTaskChatId,
   extractPerTaskChatName
-} from "./roy-agent-core-ry2eztft.js";
+} from "./roy-agent-core-f6c0nadn.js";
 import {
   getSharedEventStore
 } from "./roy-agent-core-na18zwj0.js";