@ftai/dsh-plugin-acn 0.0.0-stage → 0.1.1

package/docs/user_guide.md

@@ -0,0 +1,185 @@
+# ACN 记忆框架使用指南
+
+[README](../README.md)
+
+ACN 让不同 Agent 的工作经验在团队中流动：分享有依据的结论、查找已有经验、处理知识分歧，并接收团队建议。你也可以个人使用，在自己的会话之间积累与复用知识；接入团队能更充分地发挥 ACN 的作用。
+
+本文介绍 DSH 插件中的日常操作。截图来自隔离的 DSH 演示环境，使用示例身份、地址和知识，不包含真实成员信息；请按自己的配置填写。
+
+- [首次使用](#首次使用)
+- [在会话中使用知识](#在会话中使用知识)
+- [查看知识与活动](#查看知识与活动)
+- [接入团队](#接入团队)
+- [记忆与知识整理](#知识整理)
+- [遇到问题时](#遇到问题时)
+
+## 首次使用
+
+### 安装插件
+
+在 DSH 打开「插件 → 添加插件」，填写：
+
+```text
+@ftai/dsh-plugin-acn
+```
+
+完成安装并启用 **ACN记忆框架**。
+
+不写版本号时，安装 npm 上 `latest` 标签对应的版本。需要特定版本时，在包名后加 `@版本号`，例如 `@ftai/dsh-plugin-acn@0.1.1`。
+
+![在 DSH 中按 npm 包名添加插件](assets/install-package.png)
+
+如果已安装旧包名的版本，先在插件页卸载旧插件，再安装新包，避免同时启用两份 ACN。卸载插件不会删除知识目录中的数据。
+
+### 更新插件
+
+当前 DSH 不会自动检查和提醒本插件的新版本。可以在 [GitHub 仓库](https://github.com/FTShare-Lab/dsh-plugin-acn)点击「Watch → Custom」，勾选「Releases」并保存，订阅后续发版通知；通知方式取决于你的 GitHub 通知设置。
+
+收到新版本通知后：
+
+1. 暂停发起新对话和知识操作，打开正在使用的工作配置的「知识与活动 → 处理活动」。查看最近任务，等「等待处理」「正在处理」的任务结束；「本地处理完成」「已按额度收尾」等表示本轮已结束，历史的失败或暂停记录无需全部变成成功。然后在 DSH「插件」中打开 ACN，查看当前版本。
+2. 点击「卸载」。知识目录中的数据会保留，不要删除该目录。
+3. 再次点击「添加插件」，填写 `@ftai/dsh-plugin-acn` 安装新版；需要固定版本时，在包名后加 `@版本号`。
+4. 确认插件显示的版本，检查工作配置与知识目录，再新建会话使用。
+
+直接重复添加同名包，即使指定不同版本，当前 DSH 桌面界面也会提示已安装，不会自动覆盖或生成两份插件。不写版本号不代表启用自动更新。
+
+### 建立自己的工作配置
+
+打开插件详情中的「工作配置」，点击「新建工作配置」。也可以从 DSH 设置中的「ACN 插件设置」进入。
+
+1. 填一个便于识别的显示名称，例如“研究团队”。
+2. 填写管理员提供的 **Agent ID**。新建配置默认开启并展开「连接团队服务」。
+3. 填写 Maintainer、Router 地址，以及启用鉴权时的团队 Key（可选），点击「检查连接」。两项均通过后，确认并保存。服务部署与字段说明见[接入团队](#接入团队)。
+
+![团队工作配置](assets/upstream-team.png)
+
+个人使用时，填写固定的 Agent ID，例如 `agent-a`，保持「连接团队服务」关闭后保存即可。单人配置只使用本地知识，不连接团队服务。
+
+工作配置可以理解为一份独立的知识空间。同一配置下的不同项目可以复用知识；如果希望两份工作的知识分开，就新建两份配置。
+
+列表中点击「配置」可以启停或设为默认。更换默认配置时会要求确认；默认值用于没有可用项目历史的新会话，不会替换旧会话的归属。
+
+![工作配置列表与默认标记](assets/upstream-settings.png)
+
+### 选择知识处理模型
+
+切到「知识与模型」，选择可用的知识处理模型并保存。它负责会话复盘、团队消息处理和 Claim 整理，与输入框旁的聊天模型分别设置。
+
+如果列表没有可用模型，先完成 DSH 的模型配置。知识目录通常保留默认值即可；需要调整时，可以点击文件夹图标选择，或用「打开目录」查看当前位置。修改目录不会自动搬移原数据。
+
+已有 ACN 知识时，可以选择直接包含 `settings.json` 和 `upstreams/` 的账号目录。保存后，原来的工作配置和知识会一起出现，无需逐份寻找配置子目录。先结束原程序的知识任务并退出，再切换目录；随后确认当前宿主中的知识处理模型和团队 Key，即可新建会话继续使用。
+
+![知识目录和知识处理模型](assets/knowledge-model.png)
+
+## 在会话中使用知识
+
+新建会话后，点击输入框旁的 **ACN**，确认本次使用的工作配置。新会话优先沿用同项目最近新建会话的有效配置，没有可用记录时使用默认配置；发送第一条消息前可以改选。
+
+![输入框旁的 ACN 菜单](assets/session-upstream.png)
+
+之后正常开展工作即可，例如查阅项目、排查问题或讨论方案。助手会按需查阅已有知识，并结合当前任务判断是否适用。
+
+完成一段有价值的工作后，可在 ACN 菜单选择「复盘本次会话」，或输入 `/recap`。任务会在后台处理，可到「知识与活动 → 处理活动」查看结果。
+
+有依据、带适用范围、值得以后复用的结论才可能保存。任务完成也可能没有新增知识，或只是修订已有记录。
+
+日常不必每次手动复盘：默认会在达到一定对话量并空闲 5 分钟后整理；有少量新增内容时，空闲 1 小时也会整理。上下文压缩和归档会安排相应处理。详细条件见[命令与行为参考](command-reference.md#知识形成与失败重试)。
+
+会话开始后，工作配置固定。想换知识空间或团队，请新建会话。安装前已开始的旧会话可以继续普通聊天，使用 ACN 时请另建会话。
+
+## 查看知识与活动
+
+从 ACN 菜单，或工作配置右侧的「知识与活动」进入。先确认页面上方选中的是你要查看的配置。
+
+### 本地知识
+
+| 类型 | 记录什么 | 阅读重点 |
+| --- | --- | --- |
+| Claim | 一条有适用范围的知识判断 | 正文、适用范围、证据、置信度 |
+| Dispute | 多条知识之间尚待处理的分歧 | 相关知识、分歧内容和同步状态 |
+| Trace | 一次知识处理的来源与产物 | 输入引用、输出知识、来源会话 |
+
+点击一条记录展开详情。来源会话可以返回原聊天；Claim、Trace 引用可以继续展开，点击返回即可回到上一条详情。本地没有保存的来源会显示提示，不能仅凭这一点判断来源已经失效。
+
+Claim 先显示活跃知识，再显示陈旧、弃用知识，各组内最近更新的在前；Dispute 先显示未解决的分歧，各组内最近创建或解决的在前；Trace 按创建时间倒序排列。
+
+![展开知识并查看来源](assets/knowledge-view.png)
+
+团队配置中的「已同步」表示当前版本已得到当前团队的上传确认；「等待投递」表示仍在本地队列中。没有上传回执的旧记录会显示为本地知识。
+
+### 处理活动
+
+  这里显示复盘、会话收尾、团队收件、知识内化、整理与投递的进度。可按类型、来源会话或需要处理的项目筛选；展开记录查看结果和错误原因。
+
+![查看处理进度与结果](assets/activity-view.png)
+
+“本地处理完成”表示本轮处理已结束；是否有知识产出、是否成功投递给团队，需要查看各自的结果。失败时先解决页面提示的问题，再使用记录上的「重试任务」「继续任务」或「重试团队投递」。
+
+## 接入团队
+
+### 先由团队部署服务
+
+本插件提供 Agent 侧功能。**Maintainer（M）和 Router（R）需要由用户团队从 [ACN 官方仓库](https://github.com/FTShare-Lab/agent-claim-network) 自行安装部署**；部署、鉴权和服务参数以该仓库说明为准。
+
+| 角色 | 在协作中负责什么 |
+| --- | --- |
+| Agent（A，本插件） | 执行任务，维护个人知识，分享结论并处理团队建议 |
+| Maintainer（M） | 保存共享记录，发布团队规则，处理知识争议并发送建议 |
+| Router（R） | 检索团队知识，返回相关候选和来源 |
+
+部署完成后，管理员提供 **Agent ID、Maintainer 地址、Router 地址**，以及启用鉴权时的 **团队 Key（可选）**。普通成员取得这些信息后，在 DSH 中配置即可，无需照搬独立 ACN Agent 的终端配置步骤。
+
+### 填写并检查连接
+
+在「工作配置」打开已有配置，或新建一份团队配置，开启「连接团队服务」。
+
+| 字段 | 如何填写 |
+| --- | --- |
+| 显示名称 | 自己容易识别的名称，例如“研究团队” |
+| Agent ID | 管理员确认的成员身份 |
+| Maintainer 地址 | 管理员提供的服务地址，保留协议、端口和部署路径 |
+| Router 地址 | 同一套团队的检索地址，端口可能不同 |
+| 团队鉴权密钥 | 管理员提供的 Key；免鉴权团队留空 |
+
+填写服务地址、点击「检查连接」，弹窗中两项均通过后确认保存。
+
+![团队服务配置](assets/upstream-team.png)
+
+已有密钥的输入框留空会保留原值；输入新 Key 后保存会替换。需要移除时，使用页面的「移除密钥绑定」。
+
+### 同步与复用团队知识
+
+新会话选择团队配置后，先等待收件准备完成，再开始聊天。管理员刚发布规则或处理了争议，需要立即查看时，在 ACN 菜单点击「同步收件」，或输入 `/inbox`。
+
+ACN Agent 侧的收件与处理分两步：先接收团队消息，再由知识模型结合本地情况处理。结果可能是新增、修改或保持现状。请在「处理活动」核对收到与处理的数量，再查看知识变化。
+
+需要查找团队经验时，可以直接告诉助手：“查询团队关于这个问题的知识，并说明哪些结论适用于当前任务。” Router 返回候选知识，助手会判断如何采用；团队知识不会全部复制到每个成员的本地库。
+
+团队模式下，整理出的知识和争议可能共享给团队。只想留在个人空间的工作，请使用单人配置。单人使用期间的历史知识仍可保留，后来接入团队不会将整库历史自动补传。
+
+## 知识整理
+
+本插件管理以 Claim 为主体的可复用经验，在接入团队时形成经验分享与流动；不维护私有 Memory 及其管理。知识提炼时会过滤工具名包含 `memory` 的工具调用及其结果（不区分大小写）。
+
+**Dream**用于回顾和整理已经积累的知识。**默认开启自动整理，一般无需手动操作。** 使用该工作配置时，插件会在启动、创建会话时检查，DSH 运行期间每 4 小时再检查一次。自上次整理以来，至少 5 条不同的自有知识（Claim）新增或更新，且距离上次成功整理已满 24 小时，就会自动安排后台整理；首次整理无需等待 24 小时。
+
+想提前整理时，可以输入 `/dream`；需要暂停时使用 `/dream stop`。进度和报告可在「处理活动」查看。整理会调用知识处理模型，正常结束也可能保留原样。
+
+「偏好 → 显示知识处理结果」只控制来源会话中的短暂提示。关闭后，后台任务仍继续执行，完整结果仍可在「知识与活动」查看。高级参数通常保持默认，需要调整时再查[配置参考](config.md)。
+
+## 遇到问题时
+
+| 遇到的情况 | 先做什么 |
+| --- | --- |
+| ACN 菜单没有可用配置 | 确认插件已启用，创建并保存工作配置，再新建会话 |
+| 连接检查失败 | 按弹窗提示核对对应服务的地址、网络、Agent ID 和 Key；请管理员确认服务正常 |
+| 检查连接通过，但同步失败 | 回来源会话重试同步，在处理活动中查看本次失败原因 |
+| 聊天正常，知识任务失败 | 检查知识处理模型是否可用，再重试失败任务 |
+| 聊了很多，没有新 Claim | 先看活动是否完成；可手动 /recap 复盘。完成且产出为 0，表示本轮没有需要新增的知识 |
+| 刷新知识页后看不到新团队规则 | 先同步收件，再查看处理结果；知识页刷新只更新本地列表 |
+| 管理台与本地数量不同 | 管理台汇集团队记录，本地页面只显示当前工作配置下的知识 |
+
+反馈问题时，提供 DSH 与插件版本、失败时间、错误提示和相关记录 ID 即可。截图中的 Key、账号、个人目录和团队内网地址应遮挡后再分享。
+
+更多操作见[命令与行为参考](command-reference.md)，服务部署见 [ACN 官方仓库](https://github.com/FTShare-Lab/agent-claim-network)，兼容范围见[DSH 兼容说明](dsh-compat.md)。

package/icon.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128" fill="none">
+  <rect x="4" y="4" width="120" height="120" rx="28" fill="#15343B"/>
+  <path d="M36 35 91 40 63 91 36 35Z" stroke="#70D6BD" stroke-width="6" stroke-linejoin="round"/>
+  <circle cx="36" cy="35" r="13" fill="#E6F8ED"/>
+  <circle cx="91" cy="40" r="13" fill="#70D6BD"/>
+  <circle cx="63" cy="91" r="15" fill="#F4C97A"/>
+  <path d="m57 91 4 4 8-9" stroke="#15343B" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/lib/activities-B8U-iW4-.js

@@ -0,0 +1,407 @@
+import { h as TraceIdSchema, l as ClaimIdSchema, u as DisputeIdSchema } from "./claim-DOAGe8ZK.js";
+import { w as hasCode } from "./lock-DbmlKOoX.js";
+import { i as RejectedDisputeStore, r as UploadStore } from "./uploads-BCA2p92b.js";
+import { n as deliveryTarget, t as DeliveryStatusStore } from "./delivery-status-M7-Rwoyj.js";
+import { t as JobQueue } from "./queue-M917xHPS.js";
+import { n as PresentationStore, t as historicalKnowledge } from "./history-DPMHX3ZE.js";
+import { z } from "zod";
+import fs from "node:fs/promises";
+import { join } from "node:path";
+//#region src/interaction-messages.ts
+const MessageInfoSchema = z.object({
+	code: z.string(),
+	count: z.number().optional(),
+	entityId: z.string().optional(),
+	status: z.number().optional()
+});
+const messages = {
+	check_auth: ["认证未通过，请检查 Agent ID 和团队鉴权密钥。", "Authentication failed. Check the Agent ID and team authentication key."],
+	check_timeout: ["连接超时，请检查服务状态和网络后重试。", "The connection timed out. Check the service and network, then retry."],
+	check_dns: ["无法解析服务域名，请检查地址和网络。", "The service hostname could not be resolved. Check the URL and network."],
+	check_unreachable: ["无法连接服务，请检查地址、端口和服务是否已启动。", "The service could not be reached. Check its address, port and whether it is running."],
+	check_network: ["网络连接失败，请检查网络或代理后重试。", "The network connection failed. Check the network or proxy and retry."],
+	check_service: ["服务暂时不可用，请检查服务状态后重试。", "The service is temporarily unavailable. Check its status and retry."],
+	check_protocol: ["服务响应不符合 ACN 协议，请联系团队管理员检查服务版本。", "The response does not match the ACN protocol. Ask your team administrator to check the service version."],
+	check_client: ["服务拒绝了请求，请检查服务地址和访问权限。", "The service rejected the request. Check its URL and access permissions."],
+	check_offline: ["部分团队服务不可用；可保存配置并继续本地工作，团队同步前需恢复连接。", "Some team services are unavailable. You can save and continue local work; restore the connection before team sync."],
+	team_check_ok: ["连接与认证通过", "Connection and authentication passed"],
+	team_check_failed: ["未通过，请检查地址、服务状态和团队鉴权密钥。", "Check the service URL, availability and team authentication key."],
+	delivery_ack: ["已标记知悉；该争议仍未成功投递。", "Acknowledged. This dispute was not successfully delivered."],
+	delivery_complete: ["本轮团队投递已完成。", "This delivery attempt completed."],
+	delivery_incomplete: ["团队投递未全部完成，请查看活动中的具体原因。", "Team delivery did not fully complete. Review the reasons in Activity."],
+	delivery_wait: ["仍有投递正在进行或等待依赖，待投记录已保留。", "Delivery is still in progress or waiting for dependencies. Pending records are retained."],
+	dream_new: ["已创建新的 Dream 请求，将重新读取当前知识。", "A new Dream request was created and will read current knowledge."],
+	service_inactive: ["知识组件尚未启用，聊天仍可继续。请在插件管理中启用 ACN 知识组件。", "The knowledge component is inactive. Chat remains available. Enable the ACN knowledge component in the plugin manager."],
+	invalid_request: ["请求字段不合法，请重新加载页面。", "The request is invalid. Reopen the ACN page and retry."],
+	select_identity: ["请选择可用的知识身份。", "Select an available work configuration."],
+	identity_unavailable: ["知识身份不可用。", "This knowledge identity is unavailable. Restore its work configuration first."],
+	retry_disabled: ["连接已停用或删除，不能重试。", "This configuration is disabled or missing. Restore it in ACN settings before retrying."],
+	retry_queued: ["任务已重新入队。", "The task has been queued again."],
+	session_unavailable: ["会话不可用，请重新打开或新建会话。", "The session is unavailable. Reopen it or start a new session."],
+	session_unbound: ["本会话未启用 ACN，聊天仍可继续。只有安装插件后新建且尚未发送消息的会话可选择工作配置；如需使用 ACN，请新建会话。", "ACN is not enabled for this session; ordinary chat remains available. Only blank sessions created after installation can choose a work configuration. Start a new session to use ACN."],
+	session_optional: ["本会话尚未启用 ACN，可直接聊天，或在首条消息前选择工作配置。", "ACN is not enabled for this session. You can chat normally, or choose a work configuration before the first message."],
+	recap_disabled: ["知识形成组件未启用。", "Knowledge formation is inactive. Enable the formation component in the plugin manager."],
+	recap_empty: ["没有可复盘的新增内容。", "There is no new completed content to recap."],
+	recap_queued: ["复盘已入队，可在处理活动中查看。", "The recap is queued. View it in Activity."],
+	solo_check: ["单人配置不需要连接检查；请先填写两个团队地址。", "Solo configurations need no team check. Enter both team service URLs first."],
+	agent_required: ["请先填写 Agent ID。", "Enter an Agent ID first."],
+	check_cancelled: ["检查已取消。", "The check was cancelled."],
+	team_checked: ["团队连接检查通过。", "Team connection and authentication checks passed."],
+	team_unavailable: ["部分服务不可用；可离线保存，使用前需恢复连接。", "Some team services are unavailable. You can save offline; restore connectivity before using them."],
+	model_automatic: ["沿用会话模型；首次同步前请先选择聊天模型。", "Following the session model. Select a chat model before the first sync."],
+	model_checked: ["知识模型检查通过。", "The knowledge model check passed."],
+	model_check_failed: ["模型未正常完成检查，保留原模型。请检查模型配置或重试。", "The model did not complete the check. The previous model is retained. Check its configuration and retry."],
+	operation_failed: ["操作未完成。请检查连接、知识模型和本地存储后重试。", "The operation did not complete. Check the team connection, knowledge model and local storage, then retry."],
+	configuration_busy: ["ACN 配置正在应用，请稍后重试。", "ACN configuration is being applied. Retry shortly."],
+	key_invalid: ["请检查团队配置，并填写有效的鉴权密钥。", "Check the team configuration and enter a valid authentication key."],
+	key_check_failed: ["检查未完成，请核对团队配置后重试。", "The check did not complete. Review the team settings and retry."],
+	key_unmanaged: ["当前 DSH 未提供凭据托管，无法在此页保存新密钥。仍可输入临时密钥检查连接；保存新密钥需使用支持凭据托管的 DSH。已有环境变量引用可继续沿用，高级配置方法见插件配置文档。", "This DSH has no credential storage, so this page cannot save a new key. You can check a temporary key or retain an existing environment reference. Saving a key requires DSH credential storage; see the plugin configuration guide for advanced setup."],
+	key_readonly: ["当前密钥存储只读，无法保存新密钥；仍可检查连接，或留空保留现有密钥。", "Credential storage is read-only. You can check a draft key or keep the current key, but cannot save a replacement."],
+	key_immutable: ["已有密钥引用不能覆盖，请重新输入并保存为新引用。", "An existing credential reference cannot be overwritten. Enter the key again and save a new reference."],
+	key_in_use: ["密钥已被配置或会话使用，保留现有凭据。", "The key is in use by a configuration or session and has been retained."],
+	key_stored: ["凭据已保存到 DSH 托管存储，完成配置保存后，新启动的会话才会采用；已有会话保留原连接。", "The new credential is stored. New sessions adopt it after the configuration saves; existing sessions retain their connection."],
+	key_failed: ["凭据操作未完成，请检查宿主凭据服务后重试。", "The credential operation failed. Check the host credential service and retry."],
+	blank_identity: ["请从 ACN 菜单选择可用的工作配置，初始化当前空白会话。", "Choose a work configuration from the ACN menu to initialize this blank session."],
+	bound_identity: ["工作配置已停用、缺失或 Agent ID 已改变；请在设置中恢复同一配置及原 Agent ID，或使用新会话。", "The work configuration is disabled, missing, or its Agent ID changed. Restore the same configuration and original Agent ID, or start a new session."],
+	connection_changed: ["已保存新连接，当前会话仍使用启动时的配置。", "The new connection is saved. This session retains its startup configuration."],
+	sync_retry: ["上次同步未完成，可继续本地工作或重试同步。", "The last sync did not finish. Continue with local knowledge or retry sync."],
+	sync_cancelled: ["已取消同步等待，已持久化的收件保留，可继续使用本地知识。", "Sync waiting was cancelled. Received items are retained; continue with local knowledge."],
+	sync_wait: ["正在同步团队收件并准备本地知识…", "Synchronizing the team Inbox and preparing local knowledge…"],
+	sync_cancelling: ["正在结束同步并准备本地知识，已持久化的收件保留。", "Ending sync waiting and preparing local knowledge. Received items are retained."],
+	solo_ready: ["单人模式已就绪，不连接团队服务。", "Solo mode is ready. No team services are contacted."]
+};
+const messageInfo = (message, kind) => {
+	const known = Object.entries(messages).find(([, value]) => value[0] === message);
+	if (known !== void 0) return { code: known[0] };
+	const entityId = message.match(/\b(?:claim|dispute)_[0-9a-f]{8}\b/)?.[0];
+	const statusText = message.match(/status=(\d{3})/)?.[1];
+	const status = statusText === void 0 ? void 0 : Number(statusText);
+	let code = kind === void 0 ? "" : `task.${kind}`;
+	if (!code && /Router 概览暂不可用|Maintainer 收件或确认未完成|同步失败/.test(message)) code = "sync_partial";
+	if (!code && /收件同步完成：拉取 (\d+) 条/.test(message)) return {
+		code: "sync_complete",
+		count: Number(message.match(/拉取 (\d+) 条/)?.[1] ?? 0)
+	};
+	if (!code && /Router 概览暂不可用|Maintainer 收件或确认未完成|同步失败/.test(message)) code = "sync_partial";
+	if (!code && /会话.*身份|知识归属|原连接|原 Agent ID/.test(message)) code = "bound_identity";
+	if (!code && /只能重试已失败/.test(message)) code = "retry_state";
+	if (!code && /^(router|maintainer) POST/u.test(message)) code = /鉴权|认证/.test(message) ? "delivery.auth" : "delivery.retryable";
+	if (!code && /鉴权|认证/.test(message)) code = "task.model_auth";
+	if (!code && /409/.test(message)) code = "delivery.rejected";
+	if (!code && /待上传版本/.test(message)) code = "delivery.version";
+	if (!code && /收件|同步/.test(message)) code = "sync_partial";
+	return {
+		code: code || "legacy",
+		...entityId === void 0 ? {} : { entityId },
+		...status === void 0 ? {} : { status }
+	};
+};
+const recovery = {
+	transcript_occupied: "Session projection files are not writable or a lock timed out after bounded retries. Check file usage and directory permissions, then retry the original task. No knowledge model call was made.",
+	transcript_space: "Local storage space or quota is exhausted. Restore capacity, then retry the original task; incomplete input was not sent to the knowledge model.",
+	transcript_corrupt: "Session projections conflict or are corrupt. Keep the original data and contact the maintainer; missing input was not skipped.",
+	transcript_source: "The original session log could not be replayed. Restore the original session and work configuration, then retry.",
+	transcript_io: "Session projection I/O failed. Check local storage, then retry the task or recap again; no knowledge model call was made.",
+	transcript_limit: "A single session projection exceeds the size limit. Keep the original session and contact the maintainer; oversized input cannot be silently skipped.",
+	formation_enqueue: "The formation task could not be queued. Projections are retained. Check local storage and recap again.",
+	handler_inactive: "The required background component is inactive. Enable it in the DSH plugin manager, then retry.",
+	context_limit: "The model context limit was reached. Select a knowledge model with enough context and retry.",
+	structured_output: "The model repeatedly returned invalid JSON. Retry or choose another knowledge model.",
+	structured_output_limit: "The model output was truncated. Increase the output limit or choose another knowledge model, then retry.",
+	structured_output_content: "The model returned unsupported response content. Retry or choose another knowledge model.",
+	model_response: "The model response format was invalid. Retry or choose another knowledge model.",
+	identity: "Restore the original work configuration and Agent ID, or start a new session.",
+	bound: "This session identity is fixed. Start a new session to choose a different configuration.",
+	connection: "Restore this work configuration and its team connection in ACN settings before retrying.",
+	empty: "There are no owned active or stale claims to organize. Form reusable knowledge first.",
+	disabled: "Dream is disabled. Enable the Dream component and dream.enabled in plugin configuration before retrying.",
+	validation: "This operation does not match the current task state. Refresh Activity and select the current failed or paused task.",
+	inbox: "Inbox processing did not finish. Review the failed task in Activity and check the knowledge model or team connection.",
+	model_auth: "Model authentication failed. Check the model provider credentials in DSH settings, then retry.",
+	model_quota: "The model quota is exhausted. Restore provider quota or select another knowledge model, then retry.",
+	model_context: "The model context limit was reached. Select a model with enough context, then retry.",
+	model_request: "The model rejected the request. Check the model parameters and output limits, then retry.",
+	model_rate_limit: "The model rate limit was reached. Wait or reduce provider concurrency, then retry.",
+	model_server: "The model service is unavailable. Wait or choose another knowledge model, then retry.",
+	model_empty: "The model returned an empty response. Retry or choose another knowledge model.",
+	timeout: "The model request timed out. Check connectivity or timeout settings, then retry.",
+	transport: "The model connection failed. Restore connectivity to the provider, then retry.",
+	route: "No usable knowledge model route is available. Choose a knowledge model in ACN settings, then retry.",
+	dream_tool_json: "The model returned invalid tool-argument JSON after two retries. Progress and used budget are retained. Retry later or change the knowledge model.",
+	dream_timeout: "A Dream model request timed out. Progress and used budget are retained. Restore model connectivity and retry.",
+	dream_output_limit: "Dream reached the model output limit. Progress and used budget are retained. Adjust the output limit or choose another knowledge model, then retry.",
+	dream_incomplete: "Dream did not finish normally. Progress and used budget are retained. Review activity and retry.",
+	model_malformed: "The model response format is invalid. Progress is retained. Retry or choose another knowledge model.",
+	structured_invalid: "The model repeatedly returned invalid structured output. Retry or choose another knowledge model.",
+	knowledge_busy: "The knowledge store is busy. Wait for the current commit to finish, then retry.",
+	storage: "Local storage could not be read or committed. Check directory permissions and available disk space, then retry."
+};
+function displayMessage(message, copy, info) {
+	if (message === "" || copy("中文", "English") === "中文") return message;
+	const descriptor = info ?? messageInfo(message);
+	const key = descriptor.code;
+	const fixed = messages[key];
+	let text;
+	if (fixed !== void 0) text = fixed[1];
+	else if (key.startsWith("task.")) text = recovery[key.slice(5)] ?? "The background task failed. Check the knowledge model and local storage, then retry.";
+	else if (key === "sync_complete") text = `Inbox sync completed: ${descriptor.count ?? 0} received. Local knowledge is ready.`;
+	else if (key === "sync_partial") text = "Team sync did not fully complete. Check the Router and Maintainer URLs, team authentication key, knowledge model and local storage; local work can continue.";
+	else if (key === "retry_state") text = "Only failed tasks can be retried. Refresh Activity and choose the current failed task.";
+	else if (key === "delivery.rejected") text = "The team service rejected this dispute (409). Automatic retries stopped. Review the related claims before forming a new dispute.";
+	else if (key === "delivery.auth") text = "Team delivery authentication failed. Check the member ID and team key in ACN settings, then retry delivery.";
+	else if (key === "delivery.dependency") text = "Waiting for consolidation carrier acknowledgement. Delivery resumes when dependencies are ready.";
+	else if ([
+		"delivery.retryable",
+		"delivery.client",
+		"delivery.protocol"
+	].includes(key)) text = "Team delivery failed. Check the team URLs, connectivity, permissions and service version, then retry delivery.";
+	else if (key === "delivery.version") text = "The queued claim differs from the current local version. Review the current claim in a team session before sharing it again.";
+	else text = /^[^\u0080-\uFFFF]*$/u.test(message) ? message : "The operation could not complete. Review the work configuration, team connection and knowledge model, then retry.";
+	return text + (descriptor.entityId === void 0 ? "" : ` ${descriptor.entityId}`) + (descriptor.status === void 0 ? "" : ` [${descriptor.status}]`);
+}
+function commandMessage(message, kind) {
+	if (/^[^\u0080-\uFFFF]*$/u.test(message)) return message;
+	return `${message}\n${displayMessage(message, (_zh, en) => en, messageInfo(message, kind))}`;
+}
+//#endregion
+//#region src/activities.ts
+const Incomplete = z.object({
+	groupId: z.string(),
+	claimIds: z.array(ClaimIdSchema),
+	reason: z.string()
+});
+const labels = {
+	claimCount: "更新 Claim",
+	disputeCount: "形成争议",
+	traceCount: "形成来源",
+	applied: "更新 Claim",
+	handled: "处理收件",
+	uploadedClaims: "已投递 Claim",
+	reportedDisputes: "已上报争议",
+	modelSteps: "探索请求",
+	wrapUpSteps: "收尾请求"
+};
+const publicResult = (result) => result !== null && typeof result === "object" ? result : {};
+function activityDetails(result) {
+	const value = publicResult(result);
+	const counts = Object.fromEntries(Object.keys(labels).flatMap((key) => typeof value[key] === "number" ? [[key, value[key]]] : []));
+	if (Array.isArray(value["updatedClaimIds"])) counts["claimCount"] = value["updatedClaimIds"].length;
+	const ids = z.array(z.union([
+		ClaimIdSchema,
+		DisputeIdSchema,
+		TraceIdSchema
+	]));
+	const entityIds = [...new Set(["entityIds", "updatedClaimIds"].flatMap((key) => {
+		const parsed = ids.safeParse(value[key]);
+		return parsed.success ? parsed.data : [];
+	}))];
+	const incomplete = z.array(Incomplete).safeParse(value["incompleteCandidates"]);
+	const warnings = z.array(z.string()).safeParse(value["warnings"]);
+	const texts = Object.entries(counts).map(([key, count]) => `${labels[key]}: ${count}`);
+	if (value["skipped"] === true || typeof value["skipped"] === "string") texts.push("没有需要新增处理的内容");
+	if (value["changed"] === false) texts.push("没有知识变更");
+	if (value["applied"] === true) texts.push("本地处理完成");
+	if (value["budgetLimited"] === true) texts.push("本次已按额度收尾；未完成项未执行，再次整理将读取当前知识");
+	const skipped = Array.isArray(value["skipped"]) ? value["skipped"].filter((id) => typeof id === "string") : [];
+	if (skipped.length > 0) texts.push(`跳过 ${skipped.length} 组`);
+	return {
+		counts,
+		entityIds,
+		summary: texts.join("；") || (result == null ? "尚无处理结果" : "处理完成，可能未产生新知识"),
+		warnings: warnings.success ? warnings.data : [],
+		incompleteCandidates: incomplete.success ? incomplete.data : [],
+		budgetLimited: value["budgetLimited"] === true
+	};
+}
+function emptyInbox(result) {
+	const value = publicResult(result);
+	return [
+		"pulled",
+		"accepted",
+		"acknowledged",
+		"applied",
+		"handled",
+		"uploadedClaims",
+		"reportedDisputes"
+	].every((key) => value[key] === 0) && Array.isArray(value["warnings"]) && value["warnings"].length === 0;
+}
+async function allActivities(knowledge, supports = (kind) => knowledge.jobs?.supports(kind) ?? true) {
+	const context = knowledge.context();
+	const presentation = await new PresentationStore(context).read();
+	const jobs = await new JobQueue(context).list();
+	const rows = await Promise.all(jobs.map(async (job) => {
+		const details = activityDetails(job.result);
+		let reportPath;
+		let phase;
+		if (job.kind === "dream") {
+			const progress = await knowledge.dreamStore().progress(job.id);
+			if (progress !== null) {
+				phase = progress.finished ? "finished" : progress.autonomy?.wrap_up === void 0 ? "exploration" : "wrap_up";
+				if (progress.autonomy !== void 0) {
+					details.counts["modelSteps"] = progress.autonomy.steps;
+					details.counts["wrapUpSteps"] = progress.autonomy.wrap_up?.steps ?? 0;
+				}
+			}
+			const path = join(context.paths.dreamJob(job.id), "report.md");
+			try {
+				if ((await fs.lstat(path)).isFile()) reportPath = path;
+			} catch (error) {
+				if (!hasCode(error, "ENOENT")) throw error;
+			}
+		}
+		const inactive = job.state === "queued" && !supports(job.kind);
+		if (job.kind === "dream" && job.state === "succeeded" && details.incompleteCandidates.length === 0) details.incompleteCandidates = (await knowledge.dreamStore().progress(job.id))?.entries.filter((entry) => entry.status === "skipped").map((entry) => ({
+			groupId: entry.candidate.group_id,
+			claimIds: entry.candidate.claim_ids,
+			reason: entry.reason ?? ""
+		})) ?? [];
+		return {
+			id: job.id,
+			kind: job.kind,
+			state: inactive || job.payload["paused"] === true ? "paused" : job.state,
+			attempts: job.attempts,
+			updatedAt: job.updatedAt,
+			unseen: !(job.kind === "inbox" && job.state === "succeeded" && emptyInbox(job.result)) && presentation !== null && job.updatedAt >= presentation.baselineAt && presentation.seen[job.id] !== job.updatedAt,
+			...job.sessionId === void 0 ? {} : { sessionId: job.sessionId },
+			...details,
+			...reportPath === void 0 ? {} : { reportPath },
+			...phase === void 0 ? {} : { phase },
+			requiresAttention: inactive || job.state === "failed" || job.payload["paused"] === true || details.warnings.length > 0 || details.incompleteCandidates.length > 0,
+			...inactive ? {
+				error: "对应后台组件未启用，请在插件管理中启用后等待任务继续。",
+				errorInfo: { code: "task.handler_inactive" }
+			} : job.lastError === void 0 ? {} : {
+				error: job.lastError,
+				errorInfo: messageInfo(job.lastError, job.lastErrorKind)
+			}
+		};
+	}));
+	const pending = await new UploadStore(context).read();
+	const status = await new DeliveryStatusStore(context).read();
+	for (const issue of Object.values(status.issues)) {
+		if (issue.reason === "rejected" || !(issue.kind === "claim" ? pending.claims : pending.disputes).some((item) => item.id === issue.id)) continue;
+		const waiting = issue.reason === "dependency";
+		const message = issue.reason === "version" ? "待投版本与本地不同。请查看当前知识，在团队会话中让 Agent 核对后通过正常修订或 Dream 同步复核重新共享。" : waiting ? "等待整合承接确认，依赖就绪后自动投递。" : issue.reason === "auth" ? "团队投递鉴权失败，请在 ACN 设置检查成员 ID 和团队鉴权密钥，再重试投递。" : "团队投递未完成。请检查团队地址、连接、权限和服务版本，再重试投递。";
+		rows.push({
+			id: `delivery-${issue.kind}-${issue.id}`,
+			kind: "delivery",
+			state: waiting ? "queued" : issue.reason === "version" ? "paused" : "failed",
+			attempts: issue.attempts,
+			updatedAt: issue.updatedAt,
+			entityId: issue.id,
+			summary: message,
+			summaryInfo: {
+				code: `delivery.${issue.reason}`,
+				entityId: issue.id,
+				...issue.status === void 0 ? {} : { status: issue.status }
+			},
+			requiresAttention: !waiting,
+			retryable: !waiting && issue.reason !== "version",
+			unseen: false
+		});
+	}
+	for (const [kind, items] of [["claim", pending.claims], ["dispute", pending.disputes]]) for (const item of items) {
+		if (status.issues[`${kind}-${item.id}`] !== void 0) continue;
+		rows.push({
+			id: `delivery-${kind}-${item.id}`,
+			kind: "delivery",
+			state: "queued",
+			entityId: item.id,
+			attempts: 0,
+			updatedAt: Date.parse("updated_at" in item ? item.updated_at ?? item.created_at : item.created_at),
+			unseen: false,
+			retryable: true,
+			summary: "等待后台团队投递。"
+		});
+	}
+	const target = knowledge.team === null ? "" : deliveryTarget(knowledge.config.team.maintainerEndpoint);
+	for (const [key, receipt] of Object.entries(status.delivered)) {
+		const id = key.replace(/^(claim|dispute)-/, "");
+		if (receipt.target !== target || !z.union([ClaimIdSchema, DisputeIdSchema]).safeParse(id).success) continue;
+		const source = rows.filter((row) => row.entityIds?.some((entityId) => entityId === id) && row.updatedAt <= (receipt.updatedAt ?? 0)).sort((a, b) => b.updatedAt - a.updatedAt)[0]?.sessionId;
+		rows.push({
+			id: `delivery-confirmed-${key}`,
+			kind: "delivery",
+			state: "succeeded",
+			entityId: id,
+			attempts: 0,
+			updatedAt: receipt.updatedAt ?? 0,
+			unseen: false,
+			retryable: false,
+			...source === void 0 ? {} : { sessionId: source },
+			summary: "此版本已收到团队投递确认。"
+		});
+	}
+	for (const [version, rejection] of Object.entries(await new RejectedDisputeStore(context).read(true))) {
+		const id = `delivery-rejected-${version}`;
+		const updatedAt = Date.parse(rejection.rejected_at);
+		const acknowledged = presentation?.seen[id] === updatedAt;
+		rows.push({
+			id,
+			kind: "delivery",
+			state: "rejected",
+			entityId: rejection.dispute_id,
+			attempts: rejection.attempts,
+			updatedAt,
+			unseen: false,
+			acknowledged,
+			requiresAttention: !acknowledged,
+			retryable: false,
+			summary: "团队拒绝此版本的争议（409），已停止自动重试，并未成功投递。请核对关联知识，由 Agent 根据当前版本形成新的争议。",
+			summaryInfo: {
+				code: "delivery.rejected",
+				entityId: rejection.dispute_id,
+				status: 409
+			}
+		});
+	}
+	const history = await historicalKnowledge(context);
+	for (const record of history.applications) rows.push({
+		id: `history-application-${record.id}`,
+		kind: record.kind,
+		state: record.state === "applied" ? "succeeded" : record.state === "prepared" ? "paused" : "cancelled",
+		attempts: record.attempts,
+		updatedAt: record.updatedAt,
+		unseen: false,
+		retryable: false,
+		requiresAttention: record.state === "prepared",
+		...record.sessionId === void 0 ? {} : { sessionId: record.sessionId },
+		entityIds: record.entityIds.flatMap((id) => {
+			const parsed = z.union([
+				ClaimIdSchema,
+				DisputeIdSchema,
+				TraceIdSchema
+			]).safeParse(id);
+			return parsed.success ? [parsed.data] : [];
+		}),
+		counts: {
+			claimCount: record.claimCount,
+			disputeCount: record.disputeCount,
+			traceCount: record.traceCount
+		},
+		summary: record.state === "applied" ? `更新 Claim: ${record.claimCount}；形成争议: ${record.disputeCount}；形成来源: ${record.traceCount}` : record.state === "prepared" ? "历史记录：原程序尚未完成本地提交，请先在原程序中完成处理。" : "历史记录：处理已取消。"
+	});
+	for (const record of history.deliveries) rows.push({
+		id: `history-delivery-${record.entity.kind}-${record.entity.value.id}-${record.updatedAt}`,
+		kind: "delivery",
+		state: "succeeded",
+		entityId: record.entity.value.id,
+		attempts: 0,
+		updatedAt: record.updatedAt,
+		sessionId: record.sessionId,
+		unseen: false,
+		retryable: false,
+		summary: "此版本已收到团队投递确认。"
+	});
+	return rows.sort((left, right) => right.updatedAt - left.updatedAt || left.id.localeCompare(right.id));
+}
+function activityPage(rows, options = {}) {
+	const matching = rows.filter((row) => (!options.attentionOnly || (row.requiresAttention ?? (row.state === "failed" || row.state === "paused"))) && (!options.sourceSession || row.sessionId === options.sourceSession) && (!options.kind || row.kind === options.kind) && (!options.state || row.state === options.state));
+	const offset = options.offset ?? 0;
+	return {
+		activities: matching.slice(offset, offset + 30),
+		activitiesOmitted: Math.max(0, matching.length - offset - 30)
+	};
+}
+//#endregion
+export { messageInfo as a, commandMessage as i, allActivities as n, MessageInfoSchema as r, activityPage as t };