@jayyuen66/dsh-plugin-shared 0.1.9 → 0.2.1

package/dist/types/tool-events.d.ts

@@ -1,29 +1,58 @@
 import type { SessionEvent } from "@deepseek-ai/dsh-session";
+import type { ToolCallId } from "@deepseek-ai/dsh-llm/brand";
+import type { ContentBlock } from "@deepseek-ai/dsh-llm/types";
+import type { JsonValue } from "@deepseek-ai/dsh-util-values";
 export type { SessionEvent } from "@deepseek-ai/dsh-session";
-export type { PtcDispatchEventData, PtcDispatchStartEventData } from "@deepseek-ai/dsh-tools/types";
+/** 一枚 PTC 子调度**开始**时记下的载荷。字段与宿主声明逐位同形，理由见文件头。 */
+export interface PtcDispatchStartEventData {
+    rootCallId: ToolCallId;
+    parentCallId: ToolCallId;
+    subCallId: ToolCallId;
+    name: string;
+    arguments: unknown;
+}
+/** 一枚 PTC 子调度**结算**时记下的载荷：结算面沿用 `tool/result` 自己的词表。 */
+export interface PtcDispatchEventData extends PtcDispatchStartEventData {
+    isError: boolean;
+    content: ContentBlock[];
+    /** 可重放的工具侧呈现元数据，与模型可见内容分开记账。 */
+    meta?: JsonValue;
+    /** 可选的失败身份与原始用户可见细节，不在模型可见内容里。 */
+    error?: {
+        name: string;
+        code: string;
+        reason?: string;
+    };
+}
+declare module "@deepseek-ai/dsh-session/types" {
+    interface SessionEventMap {
+        "tool/ptc-dispatch-start": PtcDispatchStartEventData;
+        "tool/ptc-dispatch": PtcDispatchEventData;
+    }
+}
 /**
- * 一条 tool/call 的记账记录。
+ * 一条 tool/call 的记录。
  *
- * 字段一律 `readonly`：台账一旦入表就只作证据读，账目被就地改写会让证据链失去意义。
+ * 字段一律 `readonly`：记录一旦入表就只作证据读，记录被就地改写会让证据链失去意义。
  */
 export interface ToolCallRecord {
     /**
-     * 调用名（edit/write/str_replace_editor/read/grep/…）——本模块的**分桶键**，必选。
+     * 调用名（edit/write/str_replace_editor/read/grep/…）——本模块的**分组键**，必选。
      *
      * 官方把它声明成必选 `string`（`tool/call` 见 packages/core/session/src/types.ts:361，
      * PtcDispatchStartEventData.name 见 packages/core/tools/src/types.ts:15），但运行期拦不住
-     * （依据见 usableName）。所以可空性在**扫描层**就处理掉了，不带到类型面：callRecordOf 遇到
-     * 缺可用 name 的调用类事件整条跳过，与 hasObjectData 同一口径。
+     * （依据见 usableName）。所以可空性在**扫描层**就处理掉了，不带到类型声明：callRecordOf 遇到
+     * 缺可用 name 的调用类事件整条跳过，与 hasObjectData 同一规则。
      *
      * 为什么不把过滤留给消费方：下游分类全建立在 name 上——editPathOf 的 str_replace_editor
-     * 只读判定、门禁侧的 EDIT_TOOLS 与 refSearchTools 名单——而 editPathOf 的兜底分支会把任何
-     * 非 str_replace_editor 的调用一律判成 write。无名调用一旦进了台账，只要它的 arguments
+     * 只读判定、检查侧的 EDIT_TOOLS 与 refSearchTools 名单——而 editPathOf 的回退分支会把任何
+     * 非 str_replace_editor 的调用一律判成 write。无名调用一旦进了记录，只要它的 arguments
      * 里有 file_path 就算成写操作。现在是靠三个消费方各自记得先判一次才没出事——那是同一条
      * 不变式的三份手抄，漏一份就出事。
      *
-     * 与 callId 的差别是**为什么一个必选、一个可空**：callId 由 usableCallId 兜底，且它有
-     * nc:<seq> 兜底席位（消费方的 noCallId 桶专门收那种行），缺了不影响归类；name 一旦缺了
-     * 就没法分桶、没有兜底席位，只能在入口滤掉。
+     * 与 callId 的差别是**为什么一个必选、一个可空**：callId 由 usableCallId 回退，且它有
+     * `nc:<seq>` 回退值（消费方的 noCallId 组专门收那种行），缺了不影响归类；name 一旦缺了
+     * 就没法分组、没有回退值，只能在入口滤掉。
      */
     readonly name: string;
     /** callId：tool/result 串联键；缺失时由调用方按 seq 造 `nc:` 键。 */
@@ -32,8 +61,8 @@ export interface ToolCallRecord {
     readonly arguments: Record<string, unknown>;
     /**
      * arguments 原始值无法解析为对象（JSON 字符串非法、或非字符串非对象）。
-     * 调用方据此保留各自语义——有的把坏参判成"这次编辑不记账"，有的仍记账但路径留空。
-     * 共享层只标记不决策：把两档策略统一掉，等于在其中一侧悄悄改掉门禁的松紧。
+     * 调用方据此保留各自语义——有的把无效参数判成"这次编辑不入记录"，有的仍记录但路径留空。
+     * 共享层只标记不决策：把两档策略统一掉，等于在其中一侧悄悄改掉检查的宽严。
      */
     readonly badArguments: boolean;
     /**
@@ -48,24 +77,24 @@ export interface ToolResultRecord {
     readonly isError: boolean;
     readonly seq: number;
 }
-/** 一条事件产出的记账行（call 与 result 互斥；非记账事件两位都是 undefined）。 */
+/** 一条事件产出的记录行（call 与 result 互斥；非记录事件两位都是 undefined）。 */
 export interface ToolEventRows {
     readonly call: ToolCallRecord | undefined;
     readonly result: ToolResultRecord | undefined;
 }
 /**
- * **单条事件**的记账行（`scanToolEvents` 的一步，也是它唯一的实现处）。
+ * **单条事件**的记录行（`scanToolEvents` 的一步，也是它唯一的实现处）。
  *
- * 之所以导出：有的消费方要把同一套台账折成投影单元（增量折叠），折叠与"注册表缺席时的全量
- * 扫描"必须逐字同源——两处各写一遍字段读取，就会在两行上给出不同的证据链（那是安全门禁的
+ * 之所以导出：有的消费方要把同一套记录折成投影单元（增量折叠），折叠与"注册表缺席时的全量
+ * 扫描"必须逐字同源——两处各写一遍字段读取，就会在两行上给出不同的证据链（那是安全检查的
  * fail-open）。折叠侧传 `event.seq`，扫描侧传数组下标，两者在官方 `seq = log.length` 的连号
- * 契约下是同一个值。
+ * 约定下是同一个值。
  */
 export declare function toolEventRowsOf(event: SessionEvent, index: number): ToolEventRows;
 /**
  * 扫描事件流 → tool/call 与 tool/result 两张表。
- * 只收集形状可用的事件，其余静默跳过——调用方（门禁/证据链）以空表安全降级，不因零星
- * 坏事件抛错。数组空洞（类型面不可表示、重放数据里却可能出现）同样跳过。
+ * 只收集形状可用的事件，其余静默跳过——调用方（检查/证据链）以空表安全回退，不因零星
+ * 坏事件抛错。数组空洞（类型声明不可表示、重放数据里却可能出现）同样跳过。
  * seq 取事件在入参数组里的下标（与折叠侧按 seq 归因的语义同一个值）。
  */
 export declare function scanToolEvents(events: readonly SessionEvent[]): {
@@ -76,7 +105,7 @@ export declare function scanToolEvents(events: readonly SessionEvent[]): {
  * {@link editPathOf} 的返回值。按 `kind` 判别联合。
  *
  * 只有两支：**`write` / `read-view`**。取不到路径时仍返回所属那一支、只把 `path` 置为
- * `undefined`——判据是工具名与 `command`，与路径取不取得到无关；再多一枚 `skip` 只会逼
+ * `undefined`——判断依据是工具名与 `command`，与路径取不取得到无关；再多一个 `skip` 只会逼
  * 调用方写出永不执行的分支。路径有没有由 `path === undefined` 表达。
  */
 export type EditTarget = {

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@jayyuen66/dsh-plugin-shared",
-  "version": "0.1.9",
-  "description": "dsh 自研插件的共享工具库：tool 事件流记账扫描 + 卡片 apply/差异骨架 + 官方作业结局映射 + 项目键派生 + 代理对安全截断。作为库包被 import，不由用户启用",
+  "version": "0.2.1",
+  "description": "dsh 自研插件的共享工具库：tool 事件流记账扫描 + 卡片 apply/差异骨架 + 统一设置卡 UI 组件 + 官方作业结局映射 + 项目键派生 + 代理对安全截断。作为库包被 import，不由用户启用",
   "keywords": [
     "cordis",
     "dsh",
     "plugin",
+    "settings-card",
     "tool-events"
   ],
   "homepage": "https://github.com/JayYuen666/dsh-plugin-shared#readme",
@@ -45,6 +46,10 @@
       "types": "./dist/types/card-diff.d.ts",
       "default": "./dist/card-diff.js"
     },
+    "./lib/card-ui": {
+      "types": "./dist/types/card-ui.d.ts",
+      "default": "./dist/card-ui.js"
+    },
     "./lib/project-key": {
       "types": "./dist/types/project-key.d.ts",
       "default": "./dist/project-key.js"
@@ -114,36 +119,47 @@
     "registry": "https://registry.npmjs.org"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.5",
-    "@deepseek-ai/dsh-brand": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-client-locale": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-jobs": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-output-retention": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-scope": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-session": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-shell": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.3",
-    "@types/node": "26.6.5",
+    "@deepseek-ai/cordis": "4.0.6-alpha.1",
+    "@deepseek-ai/dsh-brand": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-jobs": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-output-retention": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-scope": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-shell": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-tool-executor-ptc": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-util-values": "0.2.2-alpha.2",
+    "@e18e/eslint-plugin": "0.8.1",
+    "@types/node": "26.6.6",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
     "@vitest/coverage-v8": "5.0.5",
+    "eslint-plugin-regexp": "3.3.2",
     "eslint-plugin-sonarjs": "4.2.2",
-    "oxfmt": "0.74.0",
-    "oxlint": "1.89.0",
+    "eslint-plugin-zod": "5.2.2",
+    "happy-dom": "21.0.4",
+    "oxfmt": "0.75.0",
+    "oxlint": "1.90.0",
     "oxlint-tsgolint": "7.0.2005",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.1",
     "rolldown": "1.2.15",
     "typescript": "7.0.2",
     "vite": "8.3.5",
     "vitest": "5.0.5"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/cordis": "^4.0.5||^4.0.6-alpha.1",
     "@deepseek-ai/dsh": "^0.2.1-rc.3",
-    "@deepseek-ai/dsh-client-locale": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-jobs": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-output-retention": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-session": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-shell": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.3"
+    "@deepseek-ai/dsh-client-locale": "^0.2.1-rc.3",
+    "@deepseek-ai/dsh-jobs": "^0.2.1-rc.3",
+    "@deepseek-ai/dsh-output-retention": "^0.2.1-rc.3",
+    "@deepseek-ai/dsh-session": "^0.2.1-rc.3",
+    "@deepseek-ai/dsh-shell": "^0.2.1-rc.3",
+    "@deepseek-ai/dsh-tools": "^0.2.1-rc.3",
+    "react": "^19.3.0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -169,6 +185,9 @@
     },
     "@deepseek-ai/dsh-tools": {
       "optional": true
+    },
+    "react": {
+      "optional": true
     }
   },
   "icon": "icon.svg",

package/dist/build/canonicalize-region-paths-BxladpX3.js

@@ -1 +0,0 @@
-const e=/^\/\/#region .*$/gmu,t=/^[^\s'"`]+$/u,n=/^(?:\.\.?\/)+/u,r=/[/\\]+/u;function i(e){let t=e.replace(/[/\\]+$/u,``),n=Math.max(t.lastIndexOf(`/`),t.lastIndexOf(`\\`));return n===-1?t:t.slice(n+1)}function a(e){let t=e.replace(/[/\\]+$/u,``),n=Math.max(t.lastIndexOf(`/`),t.lastIndexOf(`\\`));return n===-1?t:t.slice(0,n)}function o(e){let t=i(e);return[i(a(e)),t].filter(e=>e.length>0)}function s(e,t){let n=e;for(let e of t)n.startsWith(`${e}/`)&&(n=n.slice(e.length+1));return n}function c(e){return e.split(r)}function l(e){let t=[...e];for(;t.length>1&&t.at(-1)===``;)t.pop();return t}function u(e){return e.startsWith(`/`)||e.startsWith(`\\`)||/^[A-Za-z]:[\\/]/u.test(e)}function d(e,t){let n=u(e);if(n!==u(t))return null;let r=l(c(e)),i=l(c(t));if(n&&r[0]!==i[0])return null;let a=0;for(;a<r.length&&a<i.length&&r[a]===i[a];)a+=1;return[...Array.from({length:r.length-a},()=>`..`),...i.slice(a)]}function f(e){if(e===null||e.length===0)return``;let t=0;for(;t<e.length&&e[t]===`..`;)t+=1;return t===e.length?``:e.slice(t).join(`/`)}function p(e,t){return{own:f(d(e,t)),parent:f(d(e,a(t)))}}function m(e,t){return t.own.length>0&&e.startsWith(`${t.own}/`)?e.slice(t.own.length+1):t.parent.length>0&&e.startsWith(`${t.parent}/`)?e.slice(t.parent.length+1):e}function h(e,r,i){let a=e.slice(10);if(!t.test(a))return e;let o=a.replace(n,``);return`//#region ${i===null?s(o,r):m(o,i)}`}function g(t,n,r){let i=o(n);if(r===void 0)return i.length===0?t:t.replaceAll(e,e=>h(e,i,null));let a=p(r,n);return t.replaceAll(e,e=>h(e,i,a))}export{g as t};