@plumeai/plugin-sdk 0.1.8 → 0.2.1

package/dist/client/ui/src/i18n/messages/en.d.ts

@@ -26,6 +26,7 @@ export declare const en: {
     "override.projectValue": string;
     "override.globalValue": string;
     "override.overriddenNote": string;
+    "override.looseningIgnored": string;
     "override.repoBanned": string;
     "fileAction.exists": string;
     "fileAction.replaceDetail": string;
@@ -169,6 +170,7 @@ export declare const en: {
     "sessionCard.output": string;
     "sessionCard.partMain": string;
     "sessionCard.started": string;
+    "sessionCard.stewardedBy": string;
     "sessionCard.readCache": string;
     "reorder.saveFailed": string;
     "sidebar.created": string;
@@ -739,6 +741,8 @@ export declare const en: {
     "sessionMenu.markRead": string;
     "sessionMenu.markedUnread": string;
     "sessionMenu.markedRead": string;
+    "sessionMenu.revokeSteward": string;
+    "sessionMenu.stewardRevoked": string;
     "sessionMenu.project": string;
     "sessionMenu.moveToProject": string;
     "sessionMenu.currentProject": string;
@@ -788,7 +792,6 @@ export declare const en: {
     "tools.edit": string;
     "tools.read": string;
     "tools.bash": string;
-    "tools.monitor": string;
     "tools.output": string;
     "tools.outputOf": string;
     "tools.outputOfTimes": {
@@ -805,39 +808,17 @@ export declare const en: {
     "peers.letter": string;
     "peers.open": string;
     "peers.sessionGone": string;
-    "jobReturn.done": string;
-    "jobReturn.failed": string;
-    "jobReturn.exitCode": string;
-    "jobReturn.killed": string;
-    "jobReturn.many": {
-        one: string;
-        other: string;
-    };
-    "jobReturn.failedCount": string;
-    "jobReturn.monitorLines": {
-        one: string;
-        other: string;
-    };
-    "jobReturn.monitorStopped": string;
-    "jobReturn.monitorIdle": string;
-    "jobReturn.monitorMaxEvents": string;
-    "jobReturn.manyUpdates": {
-        one: string;
-        other: string;
-    };
-    "wakeupReturn.fired": string;
-    "sessionReturn.from": string;
-    "sessionReturn.failed": string;
+    "delivery.fromSession": string;
+    "delivery.failed": string;
+    "delivery.incomplete": string;
     "tools.find": string;
     "tools.grep": string;
     "tools.ls": string;
-    "tools.todo": string;
-    "tools.todoOf": string;
-    "tools.todoAt": string;
     "tools.using": string;
     "tools.countOf": string;
     "tools.countTimes": string;
     "tools.run": string;
+    "tools.answeredBy": string;
     "step.thinking": {
         one: string;
         other: string;
@@ -857,6 +838,7 @@ export declare const en: {
     "questionNav.imageMessage": string;
     "userMessage.fromChild": string;
     "userMessage.fromPlugin": string;
+    "userMessage.relayedBy": string;
     "userMessage.showMore": string;
     "userMessage.showLess": string;
     "conversation.quoteToComposer": string;
@@ -877,22 +859,6 @@ export declare const en: {
     "common.send": string;
     "userMessage.turnRunning": string;
     "userMessage.editResend": string;
-    "taskStrip.queued": string;
-    "taskStrip.mainBusy": string;
-    "taskStrip.done": string;
-    "taskStrip.failedWith": string;
-    "taskStrip.failed": string;
-    "taskStrip.stalled": string;
-    "taskStrip.maxTurns": string;
-    "taskStrip.interrupted": string;
-    "taskStrip.withdrawn": string;
-    "taskStrip.runNow": string;
-    "taskStrip.withdraw": string;
-    "taskStrip.withdrawOne": string;
-    "taskStrip.retryOne": string;
-    "taskStrip.resumeOne": string;
-    "taskStrip.remove": string;
-    "taskStrip.removeOne": string;
     "sideMessage.reask": string;
     "sideMessage.busy": string;
     "sideMessage.editAndReask": string;
@@ -1019,6 +985,8 @@ export declare const en: {
     "composer.permissionAsk": string;
     "composer.permissionAuto": string;
     "composer.permissionFull": string;
+    "composer.permissionProject": string;
+    "permission.projectNote": string;
     "permission.mode": string;
     "permission.question": string;
     "permission.askDetail": string;
@@ -1040,13 +1008,36 @@ export declare const en: {
     "permission.once": string;
     "approval.fromChild": string;
     "approval.childUntitled": string;
-    "approval.bash": string;
-    "approval.write": string;
-    "approval.edit": string;
-    "approval.read": string;
+    "approval.command": string;
+    "approval.create": string;
+    "approval.modify": string;
+    "approval.view": string;
     "approval.expiresIn": string;
+    "approval.requestUnavailable": string;
+    "approval.decline": string;
     "running.waitingForAnswer": string;
     "composer.plumePlaceholder": string;
+    "contextMeter.usedPercent": string;
+    "contextMeter.windowUsage": string;
+    "contextMeter.window": string;
+    "contextMeter.usedOfLimit": string;
+    "contextMeter.percentUsed": string;
+    "contextMeter.fileCount": {
+        one: string;
+        other: string;
+    };
+    "contextMeter.nearLimit": string;
+    "contextMeter.used": string;
+    "contextMeter.remaining": string;
+    "contextMeter.memoryFiles": string;
+    "contextMeter.noMemoryFiles": string;
+    "contextMeter.segment.messages": string;
+    "contextMeter.segment.tools": string;
+    "contextMeter.segment.mcpTools": string;
+    "contextMeter.segment.skills": string;
+    "contextMeter.segment.systemPrompt": string;
+    "contextMeter.segment.conventions": string;
+    "contextMeter.segment.memory": string;
     "command.slash": string;
     "command.builtin": string;
     "command.custom": string;
@@ -1063,6 +1054,12 @@ export declare const en: {
     "general.autoReviewDetail": string;
     "general.fullAccess": string;
     "general.fullAccessDetail": string;
+    "general.alwaysAllowDetail": string;
+    "general.alwaysAllowEmpty": string;
+    "general.alwaysAllowClear": string;
+    "general.alwaysAllowRevoke": string;
+    "general.alwaysAllowCore": string;
+    "general.alwaysAllowRead": string;
     "general.section": string;
     "general.hideEmptiedProjects": string;
     "general.hideEmptiedProjectsDetail": string;
@@ -1110,6 +1107,7 @@ export declare const en: {
     "retry.fixedDetail": string;
     "plugins.failed": string;
     "plugins.waiting": string;
+    "plugins.observesAll": string;
     "about.intro": string;
     "about.checking": string;
     "about.checkInterval": string;

package/dist/client/ui/src/i18n/messages/zh-CN.d.ts

@@ -24,6 +24,7 @@ export declare const zhCN: {
     readonly "override.projectValue": "项目值";
     readonly "override.globalValue": "全局值";
     readonly "override.overriddenNote": "⚠ 被项目值{mode}，不生效";
+    readonly "override.looseningIgnored": "会放宽权限，已被忽略：仓库里的配置只能收紧权限，放宽要在本机的设置里改";
     readonly "override.repoBanned": "不允许放在仓库文件里，已被忽略";
     readonly "fileAction.exists": "「{name}」已存在";
     readonly "fileAction.noTerminal": "请先安装并启用终端插件。";
@@ -146,6 +147,7 @@ export declare const zhCN: {
     readonly "sessionCard.output": "输出";
     readonly "sessionCard.partMain": "主会话";
     readonly "sessionCard.started": "{at} 开始";
+    readonly "sessionCard.stewardedBy": "由 {name} 代管";
     readonly "sessionCard.readCache": "读缓存 {n}";
     readonly "reorder.saveFailed": "排序未能保存：{reason}";
     readonly "sidebar.created": "最近创建";
@@ -655,6 +657,8 @@ export declare const zhCN: {
     readonly "sessionMenu.markRead": "标记为已读";
     readonly "sessionMenu.markedUnread": "已标记为未读";
     readonly "sessionMenu.markedRead": "已标记为已读";
+    readonly "sessionMenu.revokeSteward": "停止代管";
+    readonly "sessionMenu.stewardRevoked": "已停止代管，插件不能再往这个会话里转话、答卡";
     readonly "sessionMenu.project": "项目";
     readonly "sessionMenu.moveToProject": "移动到项目";
     readonly "sessionMenu.currentProject": "当前项目";
@@ -704,7 +708,6 @@ export declare const zhCN: {
     readonly "tools.edit": "修改文件";
     readonly "tools.read": "读取文件";
     readonly "tools.bash": "执行命令";
-    readonly "tools.monitor": "监视命令";
     readonly "tools.output": "查看输出";
     readonly "tools.outputOf": "查看「{what}」的输出";
     readonly "tools.outputOfTimes": "查看「{what}」的输出 {n} 次";
@@ -715,30 +718,17 @@ export declare const zhCN: {
     readonly "peers.letter": "其他会话的消息";
     readonly "peers.open": "打开这个会话";
     readonly "peers.sessionGone": "这个会话已经不在了";
-    readonly "jobReturn.done": "后台命令完成";
-    readonly "jobReturn.failed": "后台命令失败";
-    readonly "jobReturn.exitCode": "退出码 {code}";
-    readonly "jobReturn.killed": "被终止";
-    readonly "jobReturn.many": "{n} 个后台命令结束";
-    readonly "jobReturn.failedCount": "{n} 个失败";
-    readonly "jobReturn.monitorLines": "监视到 {n} 行新输出";
-    readonly "jobReturn.monitorStopped": "监视已停止";
-    readonly "jobReturn.monitorIdle": "长时间没有输出";
-    readonly "jobReturn.monitorMaxEvents": "达到行数上限";
-    readonly "jobReturn.manyUpdates": "{n} 个后台命令有新输出";
-    readonly "wakeupReturn.fired": "定时唤醒";
-    readonly "sessionReturn.from": "来自新会话";
-    readonly "sessionReturn.failed": "没跑完";
+    readonly "delivery.fromSession": "来自新会话";
+    readonly "delivery.failed": "没跑完";
+    readonly "delivery.incomplete": "只做了一部分";
     readonly "tools.find": "查找文件";
     readonly "tools.grep": "搜索内容";
     readonly "tools.ls": "列出目录";
-    readonly "tools.todo": "更新清单";
-    readonly "tools.todoOf": "更新清单 {done}/{total}";
-    readonly "tools.todoAt": "更新清单 {done}/{total} · {task}";
     readonly "tools.using": "使用工具";
     readonly "tools.countOf": "{kind} {count} 个";
     readonly "tools.countTimes": "{kind} {count} 次";
     readonly "tools.run": "工具调用";
+    readonly "tools.answeredBy": "由 {name} 代答";
     readonly "step.thinking": "思考 {n} 次";
     readonly "step.separator": " · ";
     readonly "conversation.showEarlier": "显示更早的 {n} 轮（共 {total} 轮）";
@@ -753,6 +743,7 @@ export declare const zhCN: {
     readonly "userMessage.showMore": "展开全文";
     readonly "userMessage.fromChild": "来自子会话";
     readonly "userMessage.fromPlugin": "来自{name}";
+    readonly "userMessage.relayedBy": "{name} 转来";
     readonly "userMessage.showLess": "收起";
     readonly "conversation.quoteToComposer": "引用到输入框";
     readonly "composer.quotesTitle": "对话引用";
@@ -766,22 +757,6 @@ export declare const zhCN: {
     readonly "common.send": "发送";
     readonly "userMessage.turnRunning": "回合进行中，无法编辑";
     readonly "userMessage.editResend": "编辑并重新发送";
-    readonly "taskStrip.queued": "排队中";
-    readonly "taskStrip.mainBusy": "主会话执行中";
-    readonly "taskStrip.done": "已完成";
-    readonly "taskStrip.failedWith": "失败 · {error} · 可重试";
-    readonly "taskStrip.failed": "失败 · 可重试";
-    readonly "taskStrip.stalled": "没做完 · 反复做同一个调用后停下 · 可重试";
-    readonly "taskStrip.maxTurns": "没做完 · 到了轮数上限 · 可重试";
-    readonly "taskStrip.interrupted": "主会话已暂停，任务一并中断 · 可继续";
-    readonly "taskStrip.withdrawn": "已撤回";
-    readonly "taskStrip.runNow": "立即执行";
-    readonly "taskStrip.withdraw": "撤回，内容回到输入框";
-    readonly "taskStrip.withdrawOne": "撤回这个任务，内容回到输入框";
-    readonly "taskStrip.retryOne": "重试这个任务";
-    readonly "taskStrip.resumeOne": "继续这个任务";
-    readonly "taskStrip.remove": "从列表移除";
-    readonly "taskStrip.removeOne": "把这条从列表移除";
     readonly "sideMessage.reask": "重新提问";
     readonly "sideMessage.busy": "回答进行中，无法编辑";
     readonly "sideMessage.editAndReask": "编辑并重新提问";
@@ -875,6 +850,8 @@ export declare const zhCN: {
     readonly "composer.permissionAsk": "请求批准";
     readonly "composer.permissionAuto": "帮我批准";
     readonly "composer.permissionFull": "完全访问";
+    readonly "composer.permissionProject": "{mode}：这个项目的 .plume/config.json 要求的";
+    readonly "permission.projectNote": "这个项目的 .plume/config.json 要求「{mode}」，这里的对话都按它来。下面改的是本机设置，在这个项目里不会比「{mode}」宽。";
     readonly "permission.mode": "权限模式";
     readonly "permission.question": "应如何批准 Plume 操作？";
     readonly "permission.askDetail": "编辑文件和运行会改动东西的命令时始终询问";
@@ -896,13 +873,33 @@ export declare const zhCN: {
     readonly "permission.once": "允许一次";
     readonly "approval.fromChild": "来自「{title}」的请求";
     readonly "approval.childUntitled": "未命名";
-    readonly "approval.bash": "执行命令";
-    readonly "approval.write": "写入文件";
-    readonly "approval.edit": "修改文件";
-    readonly "approval.read": "读取文件";
+    readonly "approval.command": "执行命令";
+    readonly "approval.create": "写入文件";
+    readonly "approval.modify": "修改文件";
+    readonly "approval.view": "读取文件";
     readonly "approval.expiresIn": "{time} 后失效";
+    readonly "approval.requestUnavailable": "这张卡画不出来（画它的插件停用了或出了错），只能不答。";
+    readonly "approval.decline": "不答";
     readonly "running.waitingForAnswer": "等待你的回答";
     readonly "composer.plumePlaceholder": "输入消息，/ 命令，@ 引用";
+    readonly "contextMeter.usedPercent": "上下文占用 {percent}%";
+    readonly "contextMeter.windowUsage": "上下文窗口用量";
+    readonly "contextMeter.window": "上下文窗口";
+    readonly "contextMeter.usedOfLimit": "{used} / {limit} 个 token";
+    readonly "contextMeter.percentUsed": "已用 {percent}%";
+    readonly "contextMeter.fileCount": "{n} 个文件";
+    readonly "contextMeter.nearLimit": "接近上限，较早的消息会被自动摘要压缩。开新对话可以拿回全部窗口。";
+    readonly "contextMeter.used": "上一次请求";
+    readonly "contextMeter.remaining": "剩余空间";
+    readonly "contextMeter.memoryFiles": "记忆文件";
+    readonly "contextMeter.noMemoryFiles": "当前未加载项目指令或记忆";
+    readonly "contextMeter.segment.messages": "对话消息";
+    readonly "contextMeter.segment.tools": "工具";
+    readonly "contextMeter.segment.mcpTools": "MCP 工具";
+    readonly "contextMeter.segment.skills": "技能目录";
+    readonly "contextMeter.segment.systemPrompt": "系统提示词";
+    readonly "contextMeter.segment.conventions": "项目指令";
+    readonly "contextMeter.segment.memory": "记忆";
     readonly "command.slash": "斜杠命令";
     readonly "command.builtin": "命令";
     readonly "command.custom": "自定义命令";
@@ -919,6 +916,12 @@ export declare const zhCN: {
     readonly "general.autoReviewDetail": "开启后命令在沙箱里直接运行，只对检测到的风险操作请求批准，比如递归删除、强制推送、写到项目外。关闭时，只读命令以外的操作都要你批准。";
     readonly "general.fullAccess": "完全访问";
     readonly "general.fullAccessDetail": "开启后 Plume 无需批准即可修改文件、执行命令并访问网络。这会显著提高数据丢失或意外行为的风险。";
+    readonly "general.alwaysAllowDetail": "在审批卡上点「以后不再问」记下的批准，只存在这台电脑上。撤销后，下次遇到同样的操作会重新询问。";
+    readonly "general.alwaysAllowEmpty": "还没有。在审批卡上点「以后不再问」后，批准会列在这里，可以随时撤销。";
+    readonly "general.alwaysAllowClear": "全部撤销";
+    readonly "general.alwaysAllowRevoke": "撤销";
+    readonly "general.alwaysAllowCore": "Plume";
+    readonly "general.alwaysAllowRead": "读取 {path}";
     readonly "general.section": "常规";
     readonly "general.hideEmptiedProjects": "归档后收起项目";
     readonly "general.hideEmptiedProjectsDetail": "项目下的会话全部归档后，连项目一起从列表收起。从没有过会话的项目始终保留。";
@@ -966,6 +969,7 @@ export declare const zhCN: {
     readonly "retry.fixedDetail": "每次大致等这么久，上下浮动两成，免得断线后大家同时重连；服务端明确要求等更久时按服务端（最多 5 分钟）。";
     readonly "plugins.failed": "加载失败";
     readonly "plugins.waiting": "等待服务：{services}";
+    readonly "plugins.observesAll": "能看到所有会话的运行情况：发给模型的内容、模型的回复、等人答的卡";
     readonly "about.intro": "查看当前版本、更新内容，手动检查更新、设置自动检查的频率。";
     readonly "about.checking": "正在检查…";
     readonly "about.checkInterval": "自动检查更新";

package/dist/contract/src/changes.d.ts

@@ -1,13 +1,15 @@
-/** 文件工具留下的本轮净变化；快照和撤销由提供 file.changes 服务的插件负责。 */
+/** 替模型改过的文件：本体记下的改动快照（`ToolResultMessage.changes`）汇总成的净变化、能不能撤销，见 `PluginChanges`。 */
 export interface ChangeHunk {
     oldStart: number;
     newStart: number;
-    lines: {
-        type: "context" | "add" | "remove";
-        text: string;
-        oldLine?: number;
-        newLine?: number;
-    }[];
+    lines: ChangeLine[];
+}
+/** diff 里的一行；行号只在那一边有这一行时给。 */
+export interface ChangeLine {
+    type: "context" | "add" | "remove";
+    text: string;
+    oldLine?: number;
+    newLine?: number;
 }
 export interface ChangedFile {
     /** 真实绝对路径；界面只在显示时相对化，文件菜单和撤销不丢失工作目录。 */
@@ -27,11 +29,27 @@ export interface FileChangesSummary {
     files: ChangedFile[];
     warnings: string[];
 }
-/** 快照标识来自工具结果的 changeId / changeIds，不接受界面传来的文件原文。 */
-export interface FileChangesService {
-    collect(sessionId: string, cwd: string, ids: readonly string[]): Promise<FileChangesSummary>;
-    /** path 不给时撤销全部；写入前重新校验快照、当前内容和项目边界。 */
-    undo(sessionId: string, cwd: string, ids: readonly string[], path?: string): Promise<void>;
+/**
+ * 工具结果的 `details` 带上这几个字段，就是声明「这次调用改了一个文件，改的是这几处」：转录的通用卡片按它画 diff、写 +N −M，
+ * 一段活的那一行把各次的加减合起来。只说这一次改了什么给人看；改了哪些文件、能不能撤销是本体记的 `ToolResultMessage.changes`，
+ * 不用工具声明。命令改的文件只有那一份，没有这一份。`details` 里别的字段照旧归插件。
+ */
+export interface FileDiffDetails {
+    /** 改的是哪个文件，给人看的写法（工作目录里的写相对路径）；diff 按它的扩展名配色。 */
+    path: string;
+    added: number;
+    removed: number;
+    hunks: ChangeHunk[];
+}
+/**
+ * `ctx.changes`：本体记下的改动快照汇总和撤销（交付卡、侧边聊天告诉主会话它改过哪些文件）。快照标识来自工具结果的
+ * `ToolResultMessage.changes.ids`，不接受界面传来的文件原文；工作目录用会话自己的。本体提供，别的插件换不掉。
+ */
+export interface PluginChanges {
+    /** 这组快照的净变化：同一文件只算首次写之前到末次写之后，改回原样的不列；快照读不出来时 `warnings` 不为空。没有这个会话时抛错。 */
+    collect(sessionId: string, ids: readonly string[]): Promise<FileChangesSummary>;
+    /** 撤销这组快照改过的文件，`path` 不给时全部；写入前重新校验快照、当前内容和项目边界，有一个不对就都不写，抛错的 message 给人看。 */
+    undo(sessionId: string, ids: readonly string[], path?: string): Promise<void>;
 }
 /** 撤回、编辑重发截掉一段对话时，那段里改过的一个文件。`problem` 为 null 的能安全退回到截断点之前。 */
 export interface RevertFile {

package/dist/contract/src/diagnostics.d.ts

@@ -30,7 +30,9 @@ export interface SessionObservation {
         stop: TurnStop;
     };
 }
-/** 后台进程只按所属会话和任务 id 操作，不能传 pid 或日志路径。 */
+/**
+ * 会话里登记着的一项后台任务（`ToolRun.track` 登记的），`ctx.sessions.jobs` 列出的样子。只按所属会话和任务 id 操作，不能传 pid 或日志路径。
+ */
 export interface BackgroundJobInfo {
     id: string;
     command: string;
@@ -39,32 +41,32 @@ export interface BackgroundJobInfo {
     finishedAt?: number;
     exitCode: number | null;
     pid?: number;
+    /** `stopping`：经 `ctx.sessions.stopJob`（或删会话）叫它停了，还没退出。 */
     status: "running" | "stopping" | "exited" | "failed";
     error?: string;
-    kind?: "monitor";
+    /** 每有新输出就叫醒这个会话开一轮（监视命令）：人得认得出哪一个在持续花钱。普通后台命令没有。 */
+    wakes?: true;
 }
-export interface BackgroundJobsService {
-    list(sessionId: string): BackgroundJobInfo[];
-    /** 尾部输出；不标记为模型已读，不消费后台送达。 */
-    output(sessionId: string, jobId: string): Promise<{
-        text: string;
-        done: boolean;
-        truncated: boolean;
-        error?: string;
-    }>;
-    stop(sessionId: string, jobId: string, force: boolean): boolean;
+/** 一项后台任务的尾部输出（`ctx.sessions.jobOutput`）：给人看的，不算模型读过，也不消费它的送达。 */
+export interface BackgroundJobOutput {
+    text: string;
+    /** 任务结束了、输出也写全了。 */
+    done: boolean;
+    /** 只给了尾部，前面还有。 */
+    truncated: boolean;
+    error?: string;
 }
 /**
- * 模型给一个会话安排的「以后再接着做」：`schedule_wakeup` 的一次性唤醒（`kind: "wakeup"`）或 `cron_create` 的定时触发，还没触发的那一个。
- * 只活在 agent 进程的内存里：退出应用、人按停止、撤回或编辑重发都会取消。
+ * 一个会话里约好的「以后再接着做」（`ToolRun.schedule`），还没触发的那一个：`kind: "wakeup"` 是到某个时刻的一次性唤醒，
+ * `"cron"` 按 cron 表达式触发（一次或循环）。只活在 agent 进程的内存里：退出应用、人按停止、撤回或编辑重发截掉约它的那次调用都会取消。
  */
 export interface SessionWakeup {
     /** `wake-1`、`cron-2`，在会话里唯一。 */
     id: string;
     kind: "wakeup" | "cron";
-    /** 到点时送给模型的那段话，模型写给自己的。 */
+    /** 到点时要接着做的事，模型写给自己的。 */
     prompt: string;
-    /** 给人看的几个字（一次性唤醒必填）；没有时界面用 `prompt` 的第一行。 */
+    /** 给人看的几个字；没有时界面用 `prompt` 的第一行。 */
     reason?: string;
     /** 5 段 cron 表达式，本地时间；一次性唤醒没有。 */
     cron?: string;
@@ -77,10 +79,3 @@ export interface SessionWakeup {
     /** 已经触发过几次。 */
     fired: number;
 }
-/** 服务 `session.wakeups`：读、取消会话里待触发的定时唤醒。内置插件 plume.tools 提供（它注册 `schedule_wakeup`、`cron_*` 这几件工具）。 */
-export interface SessionWakeupsService {
-    /** 按下一次触发的先后；会话没有、没安排过时是空数组。 */
-    list(sessionId: string): SessionWakeup[];
-    /** 取消一个；已经触发了、不存在时返回 false。 */
-    cancel(sessionId: string, id: string): boolean;
-}

package/dist/contract/src/index.d.ts

@@ -1,13 +1,13 @@
 /**
  * 共享类型：跨包、跨进程的约定都在这里，只有类型，没有运行时代码。按用途分文件：
  *
- * - `plugin.ts`：插件逻辑入口的 API（钩子、工具、ctx）；界面入口的在 `ui.ts`（`@plume/contract/ui`）；`resources.ts`：服务 `resources` 的资源地址；
+ * - `plugin.ts`：插件逻辑入口的 API（钩子、工具、ctx）；界面入口的在 `ui.ts`（`@plume/contract/ui`）；`resources.ts`：`ctx.resources` 的资源地址；
  * - `service.ts`：agent 进程给界面的 AgentService、事件和视图；`usage.ts`：存储页和插件读的使用统计数据；
  * - `app.ts`：agent 和装配它的应用之间的约定（待加载的插件、日志）。
  *
  * 消息类型定义在 `@plume/llm`，在这里转出，使用方一律从 `@plume/contract` 引用。
  */
-export type { ApiFormat, AssistantMessage, DeliveredReport, ImageContent, Message, MessageAttachment, PeerLetter, TextContent, ToolResultMessage, ToolSpec, UserContent, UserMessage, } from "../../core/llm/types.d.ts";
+export type { ApiFormat, AssistantMessage, DeliveredReport, FileChanges, ImageContent, Message, MessageAttachment, PeerLetter, TextContent, ToolResultMessage, ToolSpec, UserContent, UserMessage, } from "../../core/llm/types.d.ts";
 export type { CallContext } from "../../infra/rpc/src/index.d.ts";
 export type * from "./app.ts";
 export type * from "./changes.ts";