@ycodium-ai/plugin-api 0.2.2964 → 0.2.2968

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -876,13 +876,13 @@ export interface PluginCommands {
876
876
  * 没声明或不在名单里当场 reject(reason `undeclared` / `not-declared`)。
877
877
  * 能选的命令是宿主定的一张封闭名单——`project.delete`、`thread.delete`、
878
878
  * `thread.message.assistant.complete` 这类不在里面,写进 manifest 解码就断。
879
- * 2. **只碰自己开的会话。** 带 `threadId` 的那几条(`thread.turn.start` /
880
- * `thread.turn.interrupt` / `thread.approval.respond` /
881
- * `thread.user-input.respond` / `thread.turn-intent.run` / `thread.turn-intent.cancel` /
882
- * `thread.turn-queue.resume` / `thread.external-messages.append`)只许落在你用 `thread.create` 或
883
- * `thread.import` 开出来的会话上,别的一律 reject(reason `foreign-thread`)。
884
- * 这条规矩不可声明——没有「任何会话」这个选项。**插件挂载所在的那条会话也不算
885
- * 自己的**:那是人跟 agent 对话的地方,能在那儿替人按批准等于自己给自己开绿灯。
879
+ * 2. **默认只碰自己开的会话。** 带 `threadId` 的那几条(`thread.turn.start` / `thread.turn.interrupt` /
880
+ * `thread.approval.respond` / `thread.user-input.respond` / `thread.turn-intent.run` /
881
+ * `thread.turn-intent.cancel` / `thread.turn-queue.resume` / `thread.external-messages.append`)只许落在你用
882
+ * `thread.create` 或 `thread.import` 开出来的会话上,别的 reject(reason `foreign-thread`)。
883
+ * 声明了 `threads.user` 时,除 `thread.external-messages.append` 外,可落到本机某个 project 上的用户会话
884
+ * (起轮/审批/提问/插话等);仍不转交执行归属。**插件挂载所在的那条会话也不算自己的**:
885
+ * 那是人跟 agent 对话的地方,能在那儿替人按批准等于自己给自己开绿灯。
886
886
  *
887
887
  * 署名只由服务器盖章:命令里自带的 `author`(`thread.turn.start`)与 `createdBy`
888
888
  * (`thread.create`)会被宿主剥掉,会话与消息记成没有作者,插件没有可冒用的身份。
@@ -16,8 +16,9 @@ export interface PluginApprovalOption {
16
16
  * decision, ... })` —— 那条命令一直是可派发的,缺的一直是这份清单(触发事件
17
17
  * `thread.approval-pending` 只带 threadId 与一句摘要,没有 requestId,也就答不出来)。
18
18
  *
19
- * **只应答你自己开的会话。** 插件开一轮时本来就能选满权限让 agent 压根不问,所以对
20
- * 自己开的会话按批准键不多给什么;别人在网页上开的会话不是你该替他按的(见路线图 #62)。
19
+ * **默认只应答你自己开的会话。** 插件开一轮时本来就能选满权限让 agent 压根不问,所以对
20
+ * 自己开的会话按批准键不多给什么。声明了 `threads.user` 时,也可应答本机 project 上的
21
+ * 用户会话(见路线图 #62 窄开 / YCO-231);未声明仍拒 `foreign-thread`。
21
22
  */
22
23
  export interface PluginApproval {
23
24
  readonly requestId: string;
@@ -69,7 +70,8 @@ export interface PluginUserInputQuestion {
69
70
  * 提交全部(宿主不收部分答案)。值:单选填选项的 `value`,多选填 `value` 的数组,自由
70
71
  * 文本(`allowFreeform` 为 true 时)填用户写的字符串,与网页逐字同形。
71
72
  *
72
- * **只回答你自己开的会话**,与审批同一道门:别人开的会话会被 `foreign-thread` 拒掉。
73
+ * **默认只回答你自己开的会话**,与审批同一道门;声明了 `threads.user` 时可答本机
74
+ * project 上的用户会话,否则 `foreign-thread`。
73
75
  */
74
76
  export interface PluginUserInput {
75
77
  readonly requestId: string;
@@ -1 +1 @@
1
- {"version":3,"file":"pending-requests.d.ts","sourceRoot":"","sources":["../src/pending-requests.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,kBAAkB;AAClB,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrD;AAED,gBAAgB;AAChB,MAAM,WAAW,uBAAuB;IACtC,oBAAoB;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}
1
+ {"version":3,"file":"pending-requests.d.ts","sourceRoot":"","sources":["../src/pending-requests.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,kBAAkB;AAClB,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrD;AAED,gBAAgB;AAChB,MAAM,WAAW,uBAAuB;IACtC,oBAAoB;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;CACpC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}
@@ -129,7 +129,7 @@ export interface PluginProcessHandle {
129
129
  * - `projects-unavailable` —— 这台机器读不出项目清单,`process.workspace` 判不了。
130
130
  * - `protected-env` —— `env` 想覆盖 `PATH` / `HOME` / `YCODIUM_*`。
131
131
  * - `too-many-processes` —— 这个插件活着的子进程已到上限(默认 8,见 `PluginProcess`)。
132
- * - `foreign-thread` —— 命令指的会话不是这个插件开的(路线图 #62)。
132
+ * - `foreign-thread` —— 命令指的会话不是这个插件开的(路线图 #62;声明 `threads.user` 后本机 project 用户会话除外)。
133
133
  * - `not-found` —— `ctx.fs` 的目标路径不存在。与「路径在,但读不了」分得开:后者
134
134
  * (权限、坏设备……)没有结构化原因,`reason` 留空(路线图 #14)。
135
135
  * - `spawn-failed` —— 门都过了,但进程没起来(可执行文件不在、cwd 不存在之类)。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ycodium-ai/plugin-api",
3
- "version": "0.2.2964",
3
+ "version": "0.2.2968",
4
4
  "description": "Types and definePlugin for authoring Ycodium plugins. Zero runtime dependencies.",
5
5
  "keywords": [
6
6
  "ycodium"