@shgroup/dsh-serenity-hooks 1.56.10 → 1.57.1

package/lib/access-CNccNtgf.js

@@ -1,79 +0,0 @@
-//#region src/host/access.ts
-/**
-* host/access.ts — 宿主访问收口（S142 review F-06）
-*
-* 为什么存在：dsp 此前在 30+ 个文件里各自用 `(ctx as unknown as {…})` 断言读取宿主
-* 服务——契约表达分散、失败模式各异（多数静默 undefined）。本模块是**唯一**读取宿主
-* 的入口：所有 `ctx.get` / `ctx.<service>` 的形状断言集中在此，调用点只拿类型化结果。
-*
-* 约定：
-*  - 只读、无副作用；服务缺失一律返回 `undefined`（调用方决定降级策略），**不抛错**
-*    （宿主对插件 apply 抛错 = 整个 dsh 启动失败，访问层不能成为单点）。
-*  - 形状以 `AI_LAB/dsh-harness-public` @ 0.1.2-rc.1 为准；成员缺失由
-*    `host/contract.ts` 的探针在装载时与 `dashboard health` 中报告。
-*  - 迁移是渐进的：新代码必须走本模块；旧调用点逐轮收敛（F-06 轮次记录见 CHANGELOG）。
-*/
-/** 通用读取：`ctx.get(name)`（含异常吞掉——服务 getter 抛错视为不可用） */
-function hostService(ctx, name) {
-	const c = ctx;
-	if (typeof c?.get !== "function") return void 0;
-	try {
-		return c.get(name);
-	} catch {
-		return;
-	}
-}
-/**
-* 直接属性读取（injected 服务：`ctx.<name>`），属性缺失**或读取抛错**时回落 `ctx.get`。
-*
-* v1.31.4 修复（R↓，实证 v1.31.3 真机首测）：cordis 的 Context 是 Proxy，
-* `ReflectService.handler.get`（`vendor/cordis/src/reflect.ts`）对**未经 `inject` 声明**
-* 的服务名会沿 fiber 链查找，找不到时**抛错**而非返回 undefined：
-*
-*   cannot get property "<name>" without inject
-*
-* 于是"先直接属性读、失败回落 ctx.get"的写法在**真实 cordis** 下永远走不到回落分支——
-* 异常直接逃逸（`hostService` 的 try/catch 被绕过）。v1.31.3 的 `hostSubagents`
-* 正是这样炸的：`subagents` 是 lazy 服务（不在插件 `inject` 列表内）。
-* 现有 fake ctx 单测（普通对象无 getter）复现不了 → 真 cordis 用例见
-* `tests/host/cordis-access.test.ts`。
-*
-* 为什么吞掉异常而不是让它冒泡：本模块的契约是"服务缺失一律返回 undefined，**不抛错**"
-* （宿主对插件 apply 抛错 = 整个 dsh 启动失败）。读取失败 = 服务不可用，等价于缺失。
-*/
-function hostInjected(ctx, name) {
-	const c = ctx;
-	try {
-		const direct = c?.[name];
-		if (direct !== void 0) return direct;
-	} catch {}
-	return hostService(ctx, name);
-}
-/** `ctx.sessions`（injected） */
-function hostSessions(ctx) {
-	return hostInjected(ctx, "sessions");
-}
-/** `ctx.agents`（injected） */
-function hostAgents(ctx) {
-	return hostInjected(ctx, "agents");
-}
-/** `ctx.webServer`（injected） */
-function hostWebServer(ctx) {
-	return hostInjected(ctx, "webServer");
-}
-/** `ctx.settings`（injected；提供 settings 面板装配通道） */
-function hostSettings(ctx) {
-	return hostInjected(ctx, "settings");
-}
-/** `ctx.web`（injected；v1.30.12 web_fetch provider 注册通道） */
-function hostWeb(ctx) {
-	return hostInjected(ctx, "web");
-}
-function hostSubagents(ctx) {
-	return hostInjected(ctx, "subagents");
-}
-function hostLlm(ctx) {
-	return hostInjected(ctx, "llm");
-}
-//#endregion
-export { hostSessions as a, hostWeb as c, hostService as i, hostWebServer as l, hostInjected as n, hostSettings as o, hostLlm as r, hostSubagents as s, hostAgents as t };

package/lib/acp-core.d.ts

@@ -1,80 +0,0 @@
-/**
- * acp-core.ts — ACP 会话管理层（F4c，v1.26.0 实验性）
- *
- * **传输无关**：方法处理器（initialize/session/new/prompt/cancel/list/close/request_permission）
- * 不依赖任何传输（stdio/HTTP/直调）——企业微信桥同进程直调处理器函数，
- * acp-http 端点（外部程序化面）与未来 stdio 独立进程复用同一处理器。
- *
- * Skiff 映射（S142 用户拍板：指定 认知容器+角色+会话（可选）进行对话）：
- *   - session/new { ccc, role, sessionId? } → createSkiffAgent / getSkiffAgent 复用
- *     （无 sessionId → 新建；有 → 进程内延续——与 v1.25.10 调试页同语义）
- *   - session/prompt → askSkiff(agent, question, 0)（全量轨迹）
- *   - session/cancel → agent.interrupt（DSH 能力）
- *   - session/close → unregisterSkiffSession（释放 agent + 注册表清理）
- *   - session/request_permission → 恒 allow（G9：白名单即授权）
- *
- * 实验性质：仅当 ACP 服务装配（settings acpEnabled）且 CCC 配置了角色时才创建 agent；
- * 未启用时本模块零副作用（无监听、无 agent）。
- */
-import type { Context } from 'cordis';
-interface JsonRpcResponse {
-    jsonrpc: '2.0';
-    id: string | number | null;
-    result?: unknown;
-    error?: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-}
-/** JSON-RPC 错误码（对齐标准） */
-export declare const RPC_ERROR: {
-    readonly PARSE: -32700;
-    readonly INVALID_REQUEST: -32600;
-    readonly METHOD_NOT_FOUND: -32601;
-    readonly INVALID_PARAMS: -32602;
-    readonly INTERNAL: -32603;
-};
-/**
- * ACP 会话管理器：持有 skiff agent 会话（与 skiff-core 注册表同源——
- * 创建走 createSkiffAgent（自动注册），关闭走 unregisterSkiffSession）。
- * 传输无关：HTTP 端点/企业微信桥/未来 stdio 都调 handle(method, params)。
- */
-export declare class AcpServer {
-    private readonly ctx;
-    constructor(ctx: Context);
-    /** 实现级方法调度（返回 result 或抛 JSON-RPC 语义错误） */
-    handle(method: string, params: Record<string, unknown> | undefined): Promise<unknown>;
-    private initialize;
-    /**
-     * session/new：{ ccc, role, sessionId? } → 创建或延续 skiff 会话。
-     * 无 sessionId → createSkiffAgent（新会话，continued:false）；
-     * 有 → 进程内延续（getSkiffAgent 命中 + role/ccc 绑定校验；未命中 → 错误）。
-     */
-    private newSession;
-    private listSessions;
-    /**
-     * session/prompt：{ sessionId, question } → 答案（**v1.26.10：不返回 trajectory**——
-     * 3100 对外只提供问答，轨迹含工具结果等内部信息；3099 调试页另走 /ask 保留）
-     */
-    private prompt;
-    /** session/cancel：{ sessionId } → 取消该会话的当前活动（Agent.cancel，宿主 rc.1 契约） */
-    private cancel;
-    /** session/close：{ sessionId } → 释放 agent + 注册表清理（进程内） */
-    private closeSession;
-}
-/** 方法不存在错误（JSON-RPC -32601） */
-export declare class RpcMethodError extends Error {
-    constructor(message: string);
-}
-/** 参数错误（JSON-RPC -32602） */
-export declare class RpcInvalidParams extends Error {
-    constructor(message: string);
-}
-/**
- * JSON-RPC 2.0 批处理（单帧）：解析请求/通知 → 调 AcpServer.handle → 响应。
- * 传输无关：acp-http 端点 / 未来 stdio 共用。
- * @returns 响应帧数组（请求有响应；通知无；解析失败 → 单错误响应）
- */
-export declare function dispatchRpc(server: AcpServer, frame: unknown): Promise<JsonRpcResponse[]>;
-export {};

package/lib/acp-http.d.ts

@@ -1,37 +0,0 @@
-/**
- * acp-http.ts — ACP HTTP JSON-RPC + 建议问答页（F4c/F4d，v1.26.x 实验性）
- *
- * node:http 服务（默认关，仅监听 127.0.0.1；启停 = 人工——设置面板「Serenity」
- * 页 ACP 区块开关 / 问答页开关，不随插件加载自动启动；仿 skiff 调试服务模式）。
- *
- * - POST /          → JSON-RPC 2.0 单帧/批处理（acpEnabled 门控；ACP 程序化面）
- * - GET  /          → 容器列表页（publicAskEnabled 门控；v1.26.2：只列已开放容器）
- * - GET  /c/<name>  → 单容器问答页（v1.26.2：URL 体现容器名，用户只输 key）
- * - POST /c/<name>/ask → 该容器问答（key 校验 + allowed 白名单校验）
- * - POST /ask       → 兼容旧形态 { key, ccc, ... }（key 校验 + allowed 校验）
- *
- * 与 skiff 调试页（人工测试面）共享同一会话核心（acp-core → skiff-core）；
- * 企业微信桥（F4c-2）同进程直调 acp-core 处理器函数，不经本端点。
- * stdio 形态（独立进程部署）后续复用同一 acp-core（官方 NDJSON 帧格式）。
- *
- * 实验性质：未开启时零资源占用（无监听、无 agent 创建）。
- */
-import type { Context } from 'cordis';
-import { type FaceSpec } from './face-host.js';
-export declare function acpHttpActive(): boolean;
-export declare function acpHttpPort(): number | null;
-/**
- * 本面的规格（C4 块 A/④：**只提供** name/port/host/enabled/handler）。
- * 两个子面（ACP JSON-RPC / 对外问答页）的路由与鉴权仍全部归 {@link handle}——
- * 面宿主不介入面语义，也**不合并** D/E 两面（两者共用会话核心但各有独立 listener/路由/HTML）。
- */
-export declare function acpHttpSpec(ctx: Context, port: number, defaultRoot?: string): FaceSpec;
-/**
- * 启动 ACP HTTP JSON-RPC + 建议问答页服务（单实例；重复启动幂等返回既有实例）。
- * C4 块 A：listener 的创建/监听/错误/端口占用/关闭归 `face-host`。
- * @param ctx 插件上下文（AcpServer 内部经 skiff-core 创建 agent）
- * @param port 监听端口（仅 127.0.0.1）
- * @param defaultRoot 默认 CCC 根（问答页候选发现兜底；resolveSkiffRoot 传入）
- */
-export declare function startAcpHttpServer(ctx: Context, port: number, defaultRoot?: string): Promise<void>;
-export declare function stopAcpHttpServer(): void;

package/lib/handyman-ops.d.ts

@@ -1,97 +0,0 @@
-/**
- * handyman-ops.ts — handyman（杂工）纯逻辑层（零 DSH 依赖，可独立单测）
- *
- * v1.24.0：loop（牛马）→ handyman（杂工）重命名。语义对齐 osp loop：
- * 进度文件（handyman-<label>.md/.json）、续跑、轮次 prompt 结构、stop token。
- * 不兼容旧 loop- 进度文件（用户拍板：仅新 handyman- 前缀）。
- */
-interface HandymanProgress {
-    round: number;
-    done: boolean;
-    label: string;
-    model: string;
-    updated: string;
-    lastResponse: string;
-    /** 对齐 osp writeFailedStatus：failed 时 done=true + status=failed + errorCode */
-    status?: 'running' | 'done' | 'failed';
-    errorCode?: string;
-    errorMessage?: string;
-}
-/** label 脱敏（Windows 审计问题 17）：非法字符 → '-'，去尾点/空格，限长（按码点截断，修复代理对切散 U+FFFD） */
-export declare function sanitizeLabel(label: string): string;
-export declare function handymanProgressPaths(root: string, label: string): {
-    md: string;
-    json: string;
-};
-/** 读取进度（续跑）；无文件返回 round 0 */
-export declare function readProgress(root: string, label: string): HandymanProgress | null;
-export declare function writeProgress(root: string, label: string, p: HandymanProgress): void;
-/** 失败状态落盘（对齐 osp writeFailedStatus：done=true / status=failed / errorCode） */
-export declare function writeFailedStatus(root: string, label: string, info: {
-    errorCode: string;
-    errorMessage?: string;
-}): void;
-export declare function newStopToken(): string;
-/** 解析 model 字符串（provider/model）→ {provider, model}；无 / 视为 model-only */
-export declare function splitModel(model: string): {
-    provider: string | undefined;
-    model: string;
-};
-/** 校验模型在白名单内；不在 → 抛错（用户拍板：只能使用 CCC 配置的模型） */
-export declare function requireWhitelistedModel(model: string, models: string[]): void;
-/**
- * providerAvailabilityError — 判定「**本机有没有该 provider 的 adapter**」，并产出**可执行**的错误文本。
- * 返回 `null` = 全部可用（调用方照常继续）。
- *
- * 🔴 为什么需要它（S142 2026-09-25，owner 在 **Mac** 上实测）：`handyman` 的模型白名单写在
- *   **CCC**（`.opencode/serenity.json`，**随 git 走**），而 provider adapter 由**每台机器的宿主**
- *   注册（profile 配置 / settings 命名空间）⇒ 同一份白名单在一台机器可用、在另一台必失败。
- *   实测症状：宿主抛 `no adapter registered for provider "<p>"`（`dsh-llm`，code `NO_ADAPTER`），
- *   而**前台路径的 `diagnostic` 是空的** ⇒ 调用方（LLM）拿到 `stopReason:"error"` 却**不知道为什么**，
- *   也就无法修正自己的配置 —— 本条把「沉默的失败」变成「可执行的错误」。
- *
- * 数据来源（宿主 `LlmRuntime`）：`listProviders()` = **有 adapter 的路由**；
- * `listConfigurableProviders()` = **已声明但未必激活**的路由（含激活用的 settings 命名空间）。
- *
- * 判据边界：`model` 串里**没有 `/`** 时取不到 provider（沿用 agent 默认路由）⇒ **不判定**（跳过）。
- */
-export declare function providerAvailabilityError(models: readonly string[], facts: {
-    registered: readonly {
-        id: string;
-        name?: string;
-    }[];
-    declared?: readonly {
-        provider: string;
-        displayName?: string;
-        settingsNs?: string;
-    }[];
-    configPath?: string;
-}): string | null;
-/** 轮次 prompt（对齐老 loop 结构：回顾进度 → 自由工作 → 汇报；S134 EAP 化：固定详尽） */
-export declare function buildRoundPrompt(opts: {
-    root: string;
-    session?: string;
-    label: string;
-    round: number;
-    stopToken: string;
-    progress?: HandymanProgress | null;
-    task?: string;
-}): string;
-/**
- * handyman 规模化使用指引（guide 子命令输出；S134 继承 + v1.24.0 更新）：
- * 使用 handyman 前必须先加载 eap 设计方案；并行策略（jobs 编排）；提示词规范（详尽固定 EAP）；
- * 阅读/文字编写类 handyman 内部也加载 eap。
- */
-export declare const HANDYMAN_GUIDE = "# handyman \u2014 Scale-Up Usage Guide (guide)\n\n## Two modes (v1.31.3; default = foreground)\n| | foreground (default) | background |\n|---|---|---|\n| What | child agent(s) run the task ONCE and return their final text (jobs=[...] \u21D2 parallel, cap 10) | loop-validated worker: hard while-loop + random completion code |\n| Use when | you need result(s) back now (per-case testers, single conversions, parallel fan-out) | long/unattended work needing anti-early-finish, resumability, or parallel jobs |\n| Loop / validation | none | stop-token is the ONLY completion condition; round cap (default 100); auto-restart (\u2264100) |\n| Progress file | none | AGENT_SESSIONS/handyman-<label>.md/.json (same label resumes) |\n| Parallel jobs | **yes** \u2014 jobs=[{task,label?,model?},...], **cap 10 (fixed)** | yes (jobs=[...], handyman.maxParallel default 10) |\n| Mechanism | host delegation service ctx.subagents.start(\"spawn\") + agentOptions | ctx.agents.create + internal while-loop |\n| Model source | CCC handyman.models whitelist (same for both) | same |\n\n## \u26A0\uFE0F Before using: load eap and design the plan\nBefore calling handyman, load eap (acc-eap skill) and design the \"scale-up handyman plan\" based on the EAP framework.\n\n### 1. Task decomposition (E\u2191 Explicit)\n- Split large tasks into explicit subtasks: each subtask defines goal / input / boundaries (what to do, what not to do) / acceptance criteria\n- Make dependencies explicit: dependent tasks run serially, independent ones can run in parallel (both modes)\n\n### 2. Prompt design (handyman's task parameter)\n- task must be detailed, fixed, and EAP-compliant: clear goal, drawn boundaries, decidable acceptance criteria\n- foreground mode: the child does NOT share your conversation \u2014 restate everything it needs in task\n- Anti-example \"handle this file\" \u2014 ambiguous; good example \"read <path>, extract all rows of the\u300C\u5173\u952E\u51B3\u7B56\u300Dtable,\n  output a JSON array (fields id/conclusion/evidence), do not modify the original file\"\n- Reading/curating or text-writing work (extracting from files, summarizing, writing docs, generating text, etc.):\n  the handyman-internal agent is also required to load eap and organize output per the EAP standard\n\n### 3. Model whitelist (CCC-configured, mandatory)\n- handyman only uses models listed in .opencode/serenity.json \"handyman.models\" \u2014 never arbitrary models\n- The CCC is expected to point this whitelist at LOW-COST models: handyman is the bulk-execution channel\n- background mode: recursive subagents inside a worker inherit the worker's model automatically (DSH native)\n- foreground mode: the child is started through the host delegation service with the resolved model\n\n### 3b. \uD83D\uDD34 Provider availability (per-machine \u2014 the whitelist is NOT enough)\n- The whitelist lives in the **CCC** (\"serenity.json\", it **travels with the repository**), but provider\n  **adapters are registered per machine by the host** (profile config / settings namespace). An entry that\n  works on one machine can fail on another with: \"no adapter registered for provider <p>\".\n- Before spawning, handyman verifies the provider of the resolved model against the adapters registered\n  **on this machine**; if it is missing it reports the requested model, where it is configured, **the\n  providers that ARE available here**, any declared-but-dormant route (with its settings namespace), and the\n  exact fix \u2014 foreground puts this in \"diagnostic\", background throws it.\n- \u21D2 If you see \"has no adapter registered on this machine\": edit \".opencode/serenity.json\" \"handyman.models\"\n  (and \"handyman.defaultModel\") to a provider listed as available, or activate/register the provider on this\n  machine. **Do not retry the same call unchanged** \u2014 it fails identically.\n\n### 4. Parallel strategy (both modes)\n- Independent subtasks can run in parallel:\n  \u00B7 **foreground** \u2014 handyman(jobs=[{task,label?,model?},...]) \u21D2 fan-out of custom-model subagents, **cap 10**,\n    results come back **in the order you passed them** (label is only a display name here; per-job \"model\" allowed)\n  \u00B7 **background** \u2014 handyman(mode=\"background\", jobs=[...]): each job gets its own label + task + stop token + progress file\n- Concurrency safety guaranteed: unique sessionId (handyman-<label>-<uuid>), progress files isolated per label\n  (AGENT_SESSIONS/handyman-<label>.json) \u2014 same label resumes, different labels never interfere\n- Parallel cap: **foreground 10 (fixed)** / background handyman.maxParallel (default 10 \u2014 cheap models are cheap)\n- Aggregation: foreground returns all outputs in one result; background: after each parallel job produces progress, the main agent merges (or spawns one aggregation handyman)\n- For programmable pipeline/phase orchestration at scale, use the platform's workflow tool instead\n\n## Completion criteria\n- foreground: the child's run settles; done=true only when stopReason=\"completed\" (otherwise read diagnostic)\n- background (osp loop standard): the only completion condition = the worker echoes this round's random verification\n  code (stop token); dialogue round cap (default 100, osp fail-safe, forced stop beyond the cap, resumable);\n  automatic restart on abnormal agent stop (\u2264100 restarts, anti-infinite-loop)\n\n## Waiting UI\n- The WebUI session-header Serenity detail card shows running background handymen's progress\n  (label / round / last response), one line per parallel job, ~3s refresh (foreground mode writes no progress)\n";
-/** handyman 运行状态（进度文件摘要；WebUI 等待界面数据源） */
-interface HandymanRunInfo {
-    label: string;
-    round: number;
-    done: boolean;
-    model: string;
-    updated: string;
-    lastResponse: string;
-}
-/** 列出 AGENT_SESSIONS/handyman-*.json 的全部进度（按 updated 倒序；坏文件跳过） */
-export declare function listActiveHandymen(root: string): HandymanRunInfo[];
-export {};

package/lib/handyman-preset-inherit.d.ts

@@ -1,35 +0,0 @@
-/**
- * handyman-preset-inherit.ts — handyman worker 的 preset 继承 + 工具面收窄（纯函数，可单测）
- *
- * v1.24.0：loop → handyman 重命名。对齐 subagent 先例（applyChildComposition →
- * agentPresets.composeFrom）：handyman worker 在创建窗口内 join 发起方 agent 的 standing
- * preset 组合，从而获得 preset 层工具（read/write/edit 等）。
- *
- * **工具面收窄（用户拍板）**：worker 内部**不含 handyman 工具本身**——递归编排归主
- * agent，worker 内部只走 subagent（模型继承 worker，同样低能）。实现：setup 钩子
- * composeFrom 后对子 scope `tools.restrict({ deny: ['handyman'] })`（同 scope 注册的
- * 规则，最近 scope 胜出——worker 看不到 handyman，主 agent 不受影响）。
- *
- * agentPresets 是可选服务（ctx.get 读取）：
- *   - 无该服务 / 父未 join preset → 返回空（worker 落全局工具层 + deny handyman）；
- *   - 有且父已 join → 返回 preset id（写入 session meta 供重建）+ setup 钩子
- *     （在 agent 未发布前执行 composeFrom + restrict，失败由创建事务回滚）。
- *
- * 仅依赖 cordis 的 Context 类型（type-only，运行时擦除）——保持可被 vitest
- * 直接加载（与 ccc.ts / handyman-ops.ts 同级的纯模块约定）。
- */
-import type { Context } from 'cordis';
-/** 从父 agent ctx 解析 preset 继承的创建期组合。 */
-interface HandymanPresetInheritance {
-    /** 父 agent 的 preset id（写入子 session meta.agentPreset，供持久化重建）；无则不写。 */
-    readonly agentPreset?: string;
-    /** 创建 setup 钩子：子 scope join 父的 standing preset + deny handyman 工具；无 preset 继承时仅 deny。 */
-    readonly setup?: (childCtx: Context) => void;
-}
-/**
- * 解析 handyman worker 从父 agent 继承的 preset，并组装创建 setup 钩子。
- * @param parentCtx - 发起 handyman 的 agent 的 scope ctx；无（headless/非 agent 上下文）时为 undefined。
- * @returns 继承结果：meta 用的 agentPreset 与创建 setup 钩子。
- */
-export declare function handymanPresetInheritance(parentCtx: Context | undefined): HandymanPresetInheritance;
-export {};

package/lib/skiff-registry-BjIX_KD1.js

@@ -1,43 +0,0 @@
-import { dirname, join } from "node:path";
-import { readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-//#region src/constants.ts
-/** 常量（纯模块，零 DSH 依赖） */
-/**
-* ACC 版本：自动从 package.json 读取（单一真相源，消除与 CHANGELOG 的漂移）。
-* 发布时只需改 package.json 的 version。
-*/
-const ACC_VERSION = (() => {
-	try {
-		const here = dirname(fileURLToPath(import.meta.url));
-		return JSON.parse(readFileSync(join(here, "..", "package.json"), "utf-8")).version ?? "0.0.0";
-	} catch {
-		return "0.0.0";
-	}
-})();
-//#endregion
-//#region src/skiff-registry.ts
-const skiffSessions = /* @__PURE__ */ new Map();
-/** 查 sessionId 的 Skiff 角色名（无 → null）——向后兼容（guards/seams 依赖） */
-function skiffRoleFor(sessionId) {
-	return skiffSessions.get(sessionId)?.role ?? null;
-}
-/** 查 sessionId 的完整绑定（role + ccc；无 → null）——v1.25.10 会话追问校验 */
-function skiffSessionInfo(sessionId) {
-	return skiffSessions.get(sessionId) ?? null;
-}
-function registerSkiffSession(sessionId, role, ccc) {
-	skiffSessions.set(sessionId, {
-		role,
-		ccc
-	});
-}
-function unregisterSkiffSession(sessionId) {
-	skiffSessions.delete(sessionId);
-}
-/** 测试/调试：注册表快照（sessionId → {role, ccc}） */
-function skiffSessionSnapshot() {
-	return new Map(skiffSessions);
-}
-//#endregion
-export { unregisterSkiffSession as a, skiffSessionSnapshot as i, skiffRoleFor as n, ACC_VERSION as o, skiffSessionInfo as r, registerSkiffSession as t };

package/lib/tools/handyman.d.ts

@@ -1,24 +0,0 @@
-/**
- * handyman.ts — handyman（杂工）真实 DSH 工具（v1.24.0：loop 牛马 → handyman 杂工）
- *
- * 用户需求（S142 拍板）：
- *   - **同步**（用户明确：这个事一般不会异步——工具阻塞到完成）
- *   - **指定模型**（CCC 白名单内——handyman.models，未配置报错）
- *   - **自主循环到完成**（stop-token 唯一完成判据，对齐 osp loop）
- *   - **内部递归同样低能 subagent**（worker 工具面含 subagent，DSH 原生模型继承）
- *   - **workflow 能力**（jobs 编排：主 agent 一次并行多个杂工，maxParallel 默认 10）
- *   - **worker 不含 handyman 本身**（递归编排归主 agent，防无限嵌套）
- *   - **不兼容旧 loop 进度文件**（仅 handyman- 前缀）
- *
- * 机制：ctx.agents.create()（带 setup 钩子）创建专用 agent（进程内），
- * 每轮 followup → agent/status idle → 读 session.events 响应 → 写进度 → stop token 检查 →
- * 未完成继续下一轮；followup/等待空闲抛错（非正常停止）→ dispose 并重新 create agent
- * （重启计数，≤100），同一轮重试。工厂模式：apply 时闭包捕获插件 ctx（工具 execute 无 ctx 参数）。
- *
- * preset 继承 + 工具收窄：setup 钩子里对子 agent 执行 agentPresets.composeFrom（对齐
- * subagent 先例）+ tools.restrict deny handyman（worker 内部看不到 handyman 工具）。
- */
-import type { ToolDefinition } from '@deepseek-ai/dsh-tools';
-import type { Context } from 'cordis';
-/** 创建 handyman 工具（闭包捕获插件 ctx → 可访问 ctx.agents） */
-export declare function createHandymanTool(ctx: Context): ToolDefinition;