dsh-diff-approval 0.30.1 → 0.31.0

package/lib/types/annotate-skill.d.ts

@@ -16,7 +16,7 @@ export declare const ANNOTATE_SKILL_DESCRIPTION: string;
 /** Extra routing guidance for the catalog. */
 export declare const ANNOTATE_SKILL_WHEN_TO_USE: string;
 /** The instruction body the agent loads. */
-export declare const ANNOTATE_SKILL_CONTENT = "# \u7528\u5361\u7247\u7ED9\u4EE3\u7801\u505A\u6279\u6CE8\n\n\u6539\u52A8\u5BA1\u6279\u9762\u677F\u91CC\u7684\u5361\u7247 = \u9488\u5BF9**\u5177\u4F53\u51E0\u884C\u4EE3\u7801**\u7684\u5BF9\u8BDD\u3002\u4F60\u5199\u7684\u6279\u6CE8\u4F1A\u6210\u4E3A\u5361\u7247\u7684\u7B2C\u4E00\u6761\u5185\u5BB9\uFF08\u4F60\u5728\u5DE5\u5177\u91CC\u5199\u7684 `note`\uFF09\uFF0C\u7528\u6237\u5C31\u5728\u4EE3\u7801\u65C1\u8FB9\u770B\u5230\u5B83\uFF0C\u5E76\u4E14\u53EF\u4EE5\u5728\u8FD9\u5F20\u5361\u7247\u91CC\u56DE\u4F60\uFF1B\u4ED6\u7684\u56DE\u590D\u4F1A\u4EE5 `[\u8BC4\u8BBA] (path:lines)` \u7684\u6D88\u606F\u56DE\u5230\u4F60\u3002\n\n## \u4EC0\u4E48\u65F6\u5019\u8BE5\u7528\n\n- \u7528\u6237\u60F3\u8BFB\u4EE3\u7801\uFF1A\u628A**\u8C03\u7528\u94FE**\u4E00\u6B65\u6B65\u6279\u6CE8\u51FA\u6765\uFF08\u6BCF\u4E2A\u5173\u952E\u8C03\u7528\u70B9\u4E00\u5F20\u5361\uFF0C\u6309\u9605\u8BFB\u987A\u5E8F\uFF09\uFF0C\u6BD4\u5728\u56DE\u590D\u91CC\u8D34\u4E00\u5927\u6BB5\u4EE3\u7801\u6216\u884C\u53F7\u6E05\u5355\u6E05\u695A\u5F97\u591A\u3002\n- \u4F60\u8981\u6307\u51FA\u67D0\u6BB5\u4EE3\u7801\u7684\u95EE\u9898\u3001\u7406\u7531\u3001\u6216\u9700\u8981\u6CE8\u610F\u7684\u5730\u65B9\uFF08Review \u573A\u666F\uFF09\uFF0C\u8BA9\u8BC1\u636E\u5C31\u8D34\u5728\u8BC1\u636E\u6240\u5728\u7684\u884C\u4E0A\u3002\n- \u4F60\u6B63\u5728\u8BA8\u8BBA\u67D0\u6BB5\u4EE3\u7801\uFF0C\u60F3\u628A\u8BDD\u76F4\u63A5\u6302\u5728\u90A3\u4E9B\u884C\u4E0A\uFF0C\u800C\u4E0D\u662F\u8BA9\u7528\u6237\u5728\u56DE\u590D\u91CC\u5BF9\u7740\u884C\u53F7\u627E\u3002\n\n\u4E0D\u8981\u5728\u7528\u6237\u6CA1\u8BA9\u4F60\u8BB2\u4EE3\u7801\u65F6\u5237\u5361\u7247\uFF0C\u4E5F\u4E0D\u8981\u7528\u5B83\u4EE3\u66FF\u56DE\u590D\uFF1A\u5361\u7247\u662F**\u8865\u5145**\uFF0C\u4F60\u7684\u56DE\u7B54\u8FD8\u662F\u8981\u5199\u5728\u56DE\u590D\u91CC\uFF08\u53EF\u4EE5\u7B80\u77ED\u8BF4\"\u5DF2\u5728\u4EE3\u7801\u4E0A\u6807\u4E86 3 \u5904\"\u5E76\u7ED9\u51FA\u8981\u70B9\uFF09\u3002\n\n## \u600E\u4E48\u8C03\u7528 `diff_approval_annotate`\n\n- `path`\uFF1A\u9762\u677F\u91CC\u90A3\u4E2A\u6587\u4EF6\u3002\u4F60\u8BFB\u6587\u4EF6\u65F6\u7528\u7684\u8DEF\u5F84\u4E5F\u884C\uFF08\u6309\u5C3E\u90E8\u5339\u914D\uFF09\uFF1B\u5339\u914D\u5230\u591A\u4E2A\u4F1A\u88AB\u62D2\uFF0C\u628A\u5B8C\u6574\u8DEF\u5F84\u7ED9\u5B83\u3002\n  **\u6587\u4EF6\u8FD8\u4E0D\u5728\u9762\u677F\u7684\u5217\u8868\u91CC\u4E5F\u6CA1\u5173\u7CFB\uFF1A\u4F1A\u81EA\u52A8\u52A0\u8FDB\u53BB**\uFF08\u5DE5\u4F5C\u533A\u91CC\u80FD\u8BFB\u6210\u6587\u672C\u7684\u6587\u4EF6\uFF09\uFF0C\u6240\u4EE5\"\u7528\u6237\u60F3\u8BFB\u61C2\u67D0\u4E2A\u6587\u4EF6\"\u4E0D\u5FC5\u5148\u7B49\u6539\u52A8\u53D1\u751F\u3002\u5DE5\u4F5C\u533A\u4E4B\u5916\u3001\u6216\u8BFB\u4E0D\u51FA\u6587\u672C\uFF0C\u624D\u4F1A\u88AB\u62D2\u3002\n- `startLine` / `endLine`\uFF1A**\u73B0\u5728**\u7684\u884C\u53F7\uFF081 \u8D77\uFF0C\u542B\u4E24\u7AEF\uFF1B\u7701\u7565 `endLine` \u5C31\u662F\u4E00\u884C\uFF09\u3002\u5148\u8BFB\u6587\u4EF6\u518D\u5199\u53F7\uFF0C\u522B\u51ED\u8BB0\u5FC6\u3002\n- `note`\uFF1A\u5361\u7247\u4E0A\u5199\u7684\u8BDD\u3002\u8981\u77ED\u2014\u2014\u5361\u7247\u662F**\u6309\u884C**\u6392\u7248\u3001\u884C\u9AD8\u6309\u884C\u7B97\u7684\uFF08\u4E0A\u9650 1000 \u5B57\u7B26\uFF0C\u8D85\u4E86\u4F1A\u88AB\u62D2\uFF09\u3002\u8BB2\u6D41\u7A0B\u65F6\uFF0C\u628A\u8FD9\u4E00\u6B65\u7684\u5E8F\u53F7\u5199\u5728 note \u7684**\u6700\u524D\u9762**\uFF08`1. \u2026`\u3001`2. \u2026`\uFF09\u3002\n- `quote`\uFF08\u53EF\u9009\uFF0C\u5EFA\u8BAE\u7ED9\uFF09\uFF1A\u4F60\u8BFB\u5230\u7684\u90A3\u51E0\u884C\u539F\u6587\uFF08\u6362\u884C\u8FDE\u63A5\uFF09\u3002\u6587\u4EF6\u5728\u4F60\u8BFB\u5B8C\u4E4B\u540E\u53C8\u53D8\u4E86\u7684\u8BDD\uFF0C\u4F1A\u5F53\u573A\u88AB\u62D2\u5E76\u628A\u73B0\u5728\u7684\u539F\u6587\u7ED9\u4F60\uFF0C\u907F\u514D\u6279\u6CE8\u6302\u5728\u9519\u8BEF\u7684\u884C\u4E0A\u3002\n\n## \u8BB2\u6D41\u7A0B\u5C31\u5728\u6B63\u6587\u5F00\u5934\u5199\u5E8F\u53F7\n\n\u5982\u679C\u8FD9\u51E0\u5F20\u5361\u662F**\u4E00\u6761\u6D41\u7A0B/\u8C03\u7528\u94FE\u7684\u6B65\u9AA4**\uFF0C\u628A\u5E8F\u53F7\u5199\u5728 note \u7684\u6700\u524D\u9762\uFF0C\u7528\u6237\u5C31\u80FD\u6309\u53F7\u8BFB\uFF1A\n\n- \u5E8F\u53F7\u6CA1\u6709\u4E13\u95E8\u53C2\u6570\uFF0C\u4E5F\u4E0D\u662F\u9762\u677F\u753B\u7684\u2014\u2014\u5B83\u5C31\u662F\u6B63\u6587\u7684\u5934\u51E0\u4E2A\u5B57\u7B26\uFF0C\u6240\u4EE5\u5361\u7247\u91CC\u3001\u5217\u8868\u91CC\u3001\u590D\u5236\u51FA\u53BB\u7684\u5185\u5BB9\u91CC\u90FD\u5E26\u7740\u5B83\uFF0C\u4F60\u5728\u56DE\u590D\u91CC\u4E5F\u80FD\u5F15\u7528\u540C\u4E00\u4E2A\u53F7\u3002\n- \u53F7\u7531\u4F60\u6392\uFF1A\u6309\u4F60\u5E0C\u671B\u7528\u6237\u9605\u8BFB\u7684\u987A\u5E8F\uFF1B1\u30012\u30013\u2026 \u8FDE\u4E0D\u8FDE\u7EED\u3001\u91CD\u4E0D\u91CD\u590D\u90FD\u968F\u4F60\uFF08**\u4E0D\u9700\u8981\u552F\u4E00**\uFF0C\u8BB2\u540C\u4E00\u4E2A\u70B9\u7684\u8865\u5145\u5361\u53EF\u4EE5\u540C\u53F7\uFF09\u3002\n- \u987A\u5E8F\u53F7\u4E5F\u5199\u8FDB\u4F60\u7684\u56DE\u590D\uFF08\"\u6211\u5728\u4EE3\u7801\u4E0A\u6807\u4E86 1\u20135\uFF0C\u4ECE X \u5F00\u59CB\"\uFF09\uFF0C\u8FD9\u6837\u9762\u677F\u91CC\u7684\u53F7\u548C\u56DE\u590D\u91CC\u7684\u53F7\u5BF9\u5F97\u4E0A\u3002\n- \u96F6\u6563\u7684\u6279\u6CE8\uFF08\u4E0D\u662F\u4E00\u4E32\u6B65\u9AA4\uFF09**\u4E0D\u8981**\u5199\u53F7\u3002\n\n## \u4E00\u5F20\u5361\u4E00\u4E2A\u70B9\n\n- \u8303\u56F4\u8981\u5C0F\uFF1A**\u6700\u591A 60 \u884C**\uFF0C\u901A\u5E38 1\u20135 \u884C\u5C31\u591F\u3002\u8981\u8BB2\u6574\u6BB5\u903B\u8F91\u5C31\u62C6\u6210\u51E0\u5F20\u5361\u3002\n- \u4E00\u6761\u8C03\u7528\u94FE = \u4E00\u5F20\u5361\u4E00\u4E2A\u8C03\u7528\u70B9\uFF0C\u6309\u4F60\u5E94\u8BE5\u8BA9\u7528\u6237\u9605\u8BFB\u7684\u987A\u5E8F\u4F9D\u6B21\u521B\u5EFA\uFF1B\u4E0D\u8981\u628A\u6240\u6709\u6B65\u9AA4\u585E\u8FDB\u4E00\u5F20\u5361\u3002\n- note \u91CC\u53EA\u8C08\u8FD9\u4E9B\u884C\uFF08\u6700\u591A\u5E26\u4E0A\u76F4\u63A5\u76F8\u90BB\u7684\u4E00\u4E24\u884C\uFF09\uFF0C\u4E0D\u8981\u6269\u5230\u6574\u4E2A\u6587\u4EF6\u6216\u6574\u4E2A\u4EFB\u52A1\u3002\n- \u5199\u6CD5\u6CBF\u7528\u6279\u6CE8\u7684\u89C4\u77E9\uFF1A\u4E0D\u8D85\u8FC7 3 \u884C\u3001\u884C\u95F4\u4E0D\u7A7A\u884C\u3001**\u4E0D\u8981 Markdown \u8868\u683C/\u5217\u8868/\u6807\u9898/\u56F4\u680F\u4EE3\u7801\u5757**\uFF08\u5361\u7247\u6309\u884C\u6392\u7248\uFF0C\u8868\u683C\u4F1A\u8BFB\u6210\u4E00\u5806\u7AD6\u7EBF\u5E76\u628A\u9AD8\u5EA6\u7B97\u9519\uFF09\uFF0C\u884C\u5185\u53EA\u7528 `\u4EE3\u7801` \u548C **\u52A0\u7C97**\u3002\u8981\u5F15\u7528\u522B\u5904\u5C31\u5199 `\u6587\u4EF6:\u884C\u53F7`\u3002\n- \u7528\u7528\u6237\u7684\u8BED\u8A00\u5199 note\u3002\n\n## \u90A3\u51E0\u884C\u5DF2\u7ECF\u88AB\u5360\u7528\u65F6\n\n\u5982\u679C\u8FD9\u4E9B\u884C\u5DF2\u7ECF\u843D\u5728**\u67D0\u5F20\u5361\u7247\u91CC**\uFF0C\u8C03\u7528\u4F1A\u88AB\u62D2\uFF0C\u62D2\u7EDD\u4FE1\u606F\u91CC\u4F1A\u5199\u660E\u662F\u54EA\u4E00\u5F20\uFF08id\u3001\u884C\u53F7\u3001\u5B83\u5F00\u5934\u7684\u8BDD\uFF09\u3002\u8FD9\u4E0D\u662F\u9519\u8BEF\uFF0C\u662F\"\u8FD9\u91CC\u5DF2\u7ECF\u6709\u8BDD\u8BF4\u4E86\"\uFF1A\n\n- \u6362\u4E00\u5904\u884C\u53F7\uFF1B\u6216\u8005\n- \u628A\u8FD9\u4EF6\u4E8B\u5199\u8FDB\u4F60\u7684\u56DE\u590D\u91CC\uFF0C\u4E0D\u8981\u8BD5\u56FE\u786C\u585E\u8FDB\u90A3\u5F20\u5361\uFF1A\u90A3\u5F20\u5361\u7684\u5BF9\u8BDD\u5C5E\u4E8E\u5199\u5B83\u7684\u4EBA\uFF08\u53EF\u80FD\u662F\u7528\u6237\uFF0C\u4E5F\u53EF\u80FD\u662F\u4F60\u65E9\u5148\u5199\u7684\uFF09\u3002\u5982\u679C\u7528\u6237\u60F3\u5728\u90A3\u5F20\u5361\u4E0A\u7EE7\u7EED\u804A\uFF0C\u4ED6\u4F1A\u5728\u5361\u7247\u91CC\u56DE\u590D\u4F60\uFF0C\u90A3\u65F6\u4F60\u4F1A\u6536\u5230 `[\u8BC4\u8BBA]`\uFF0C\u6309 `dsh-diff-approval-comment` \u7684\u89C4\u77E9\u56DE\u7B54\u5373\u53EF\u3002\n\n**\u4E0D\u8981**\u5728\u56DE\u590D\u91CC\u5047\u88C5\u5DF2\u7ECF\u6279\u6CE8\u6210\u529F\u2014\u2014\u5DE5\u5177\u8FD4\u56DE\u7684\u662F\"refused: ...\"\u5C31\u8BF4\u660E\u6CA1\u6709\u5361\u7247\u88AB\u521B\u5EFA\u3002\n";
+export declare const ANNOTATE_SKILL_CONTENT = "# \u7528\u5361\u7247\u7ED9\u4EE3\u7801\u505A\u6279\u6CE8\n\n\u6539\u52A8\u5BA1\u6279\u9762\u677F\u91CC\u7684\u5361\u7247 = \u9488\u5BF9**\u5177\u4F53\u51E0\u884C\u4EE3\u7801**\u7684\u5BF9\u8BDD\u3002\u4F60\u5199\u7684\u6279\u6CE8\u4F1A\u6210\u4E3A\u5361\u7247\u7684\u7B2C\u4E00\u6761\u5185\u5BB9\uFF08\u4F60\u5728\u5DE5\u5177\u91CC\u5199\u7684 `note`\uFF09\uFF0C\u7528\u6237\u5C31\u5728\u4EE3\u7801\u65C1\u8FB9\u770B\u5230\u5B83\uFF0C\u5E76\u4E14\u53EF\u4EE5\u5728\u8FD9\u5F20\u5361\u7247\u91CC\u56DE\u4F60\uFF1B\u4ED6\u7684\u56DE\u590D\u4F1A\u4EE5 `[\u8BC4\u8BBA] (path:lines)` \u7684\u6D88\u606F\u56DE\u5230\u4F60\u3002\n\n## \u4EC0\u4E48\u65F6\u5019\u8BE5\u7528\n\n- \u7528\u6237\u60F3\u8BFB\u4EE3\u7801\uFF1A\u628A**\u8C03\u7528\u94FE**\u4E00\u6B65\u6B65\u6279\u6CE8\u51FA\u6765\uFF08\u6BCF\u4E2A\u5173\u952E\u8C03\u7528\u70B9\u4E00\u5F20\u5361\uFF0C\u6309\u9605\u8BFB\u987A\u5E8F\uFF09\uFF0C\u6BD4\u5728\u56DE\u590D\u91CC\u8D34\u4E00\u5927\u6BB5\u4EE3\u7801\u6216\u884C\u53F7\u6E05\u5355\u6E05\u695A\u5F97\u591A\u3002\n- \u4F60\u8981\u6307\u51FA\u67D0\u6BB5\u4EE3\u7801\u7684\u95EE\u9898\u3001\u7406\u7531\u3001\u6216\u9700\u8981\u6CE8\u610F\u7684\u5730\u65B9\uFF08Review \u573A\u666F\uFF09\uFF0C\u8BA9\u8BC1\u636E\u5C31\u8D34\u5728\u8BC1\u636E\u6240\u5728\u7684\u884C\u4E0A\u3002\n- \u4F60\u6B63\u5728\u8BA8\u8BBA\u67D0\u6BB5\u4EE3\u7801\uFF0C\u60F3\u628A\u8BDD\u76F4\u63A5\u6302\u5728\u90A3\u4E9B\u884C\u4E0A\uFF0C\u800C\u4E0D\u662F\u8BA9\u7528\u6237\u5728\u56DE\u590D\u91CC\u5BF9\u7740\u884C\u53F7\u627E\u3002\n\n\u4E0D\u8981\u5728\u7528\u6237\u6CA1\u8BA9\u4F60\u8BB2\u4EE3\u7801\u65F6\u5237\u5361\u7247\uFF0C\u4E5F\u4E0D\u8981\u7528\u5B83\u4EE3\u66FF\u56DE\u590D\uFF1A\u5361\u7247\u662F**\u8865\u5145**\uFF0C\u4F60\u7684\u56DE\u7B54\u8FD8\u662F\u8981\u5199\u5728\u56DE\u590D\u91CC\uFF08\u53EF\u4EE5\u7B80\u77ED\u8BF4\"\u5DF2\u5728\u4EE3\u7801\u4E0A\u6807\u4E86 3 \u5904\"\u5E76\u7ED9\u51FA\u8981\u70B9\uFF09\u3002\n\n## \u600E\u4E48\u8C03\u7528 `diff_approval_annotate`\n\n- `path`\uFF1A\u9762\u677F\u91CC\u90A3\u4E2A\u6587\u4EF6\u3002\u4F60\u8BFB\u6587\u4EF6\u65F6\u7528\u7684\u8DEF\u5F84\u4E5F\u884C\uFF08\u6309\u5C3E\u90E8\u5339\u914D\uFF09\uFF1B\u5339\u914D\u5230\u591A\u4E2A\u4F1A\u88AB\u62D2\uFF0C\u628A\u5B8C\u6574\u8DEF\u5F84\u7ED9\u5B83\u3002\n  **\u6587\u4EF6\u8FD8\u4E0D\u5728\u9762\u677F\u7684\u5217\u8868\u91CC\u4E5F\u6CA1\u5173\u7CFB\uFF1A\u4F1A\u81EA\u52A8\u52A0\u8FDB\u53BB**\uFF08\u5DE5\u4F5C\u533A\u91CC\u80FD\u8BFB\u6210\u6587\u672C\u7684\u6587\u4EF6\uFF09\uFF0C\u6240\u4EE5\"\u7528\u6237\u60F3\u8BFB\u61C2\u67D0\u4E2A\u6587\u4EF6\"\u4E0D\u5FC5\u5148\u7B49\u6539\u52A8\u53D1\u751F\u3002\u5DE5\u4F5C\u533A\u4E4B\u5916\u3001\u6216\u8BFB\u4E0D\u51FA\u6587\u672C\uFF0C\u624D\u4F1A\u88AB\u62D2\u3002\n- `startLine` / `endLine`\uFF1A**\u73B0\u5728**\u7684\u884C\u53F7\uFF081 \u8D77\uFF0C\u542B\u4E24\u7AEF\uFF1B\u7701\u7565 `endLine` \u5C31\u662F\u4E00\u884C\uFF09\u3002\u5148\u8BFB\u6587\u4EF6\u518D\u5199\u53F7\uFF0C\u522B\u51ED\u8BB0\u5FC6\u3002\n- `note`\uFF1A\u5361\u7247\u4E0A\u5199\u7684\u8BDD\u3002\u8981\u77ED\u2014\u2014\u5361\u7247\u662F**\u6309\u884C**\u6392\u7248\u3001\u884C\u9AD8\u6309\u884C\u7B97\u7684\uFF08\u4E0A\u9650 1000 \u5B57\u7B26\uFF0C\u8D85\u4E86\u4F1A\u88AB\u62D2\uFF09\u3002\u8BB2\u6D41\u7A0B\u65F6\uFF0C\u628A\u8FD9\u4E00\u6B65\u7684\u5E8F\u53F7\u5199\u5728 note \u7684**\u6700\u524D\u9762**\uFF08`1. \u2026`\u3001`2. \u2026`\uFF09\u3002\n- `quote`\uFF08\u53EF\u9009\uFF0C\u5EFA\u8BAE\u7ED9\uFF09\uFF1A\u4F60\u8BFB\u5230\u7684\u90A3\u51E0\u884C\u539F\u6587\uFF08\u6362\u884C\u8FDE\u63A5\uFF09\u3002\u6587\u4EF6\u5728\u4F60\u8BFB\u5B8C\u4E4B\u540E\u53C8\u53D8\u4E86\u7684\u8BDD\uFF0C\u4F1A\u5F53\u573A\u88AB\u62D2\u5E76\u628A\u73B0\u5728\u7684\u539F\u6587\u7ED9\u4F60\uFF0C\u907F\u514D\u6279\u6CE8\u6302\u5728\u9519\u8BEF\u7684\u884C\u4E0A\u3002\n- `category`\uFF08\u53EF\u9009\uFF09\uFF1A**\u7ED9\"\u4E00\u7C7B\u6279\u6CE8\"\u8D77\u4E00\u4E2A id**\u3002\u540C\u4E00\u7C7B\uFF08\u540C\u4E00\u8F6E\u3001\u540C\u4E00\u4E3B\u9898\u3001\u540C\u4E00\u6B21\u8BB2\u89E3\uFF09\u6BCF\u6B21\u8C03\u7528\u90FD\u4F20**\u540C\u4E00\u4E2A** id\uFF0C\u6362\u6210\u53E6\u4E00\u7C7B\u5C31\u6362\u4E00\u4E2A id\u3002\u9762\u677F\u4F1A\u6309\u8FD9\u4E2A id \u7ED9\u8BC4\u8BBA\u5217\u8868\u91CC\u7684\u90A3\u6761\u8BC4\u8BBA\u753B\u4E00\u4E2A**\u5F69\u8272\u5706\u70B9**\uFF0C\u6240\u4EE5**\u540C\u4E00\u7C7B\u7684\u6279\u6CE8\u662F\u540C\u4E00\u4E2A\u989C\u8272**\uFF0C\u4E24\u7C7B\u4E4B\u95F4\u53EF\u4EE5\u9760\u989C\u8272\u533A\u5206\u3002**\u4E0D\u4F20 `category` \u5C31\u5B8C\u5168\u4E0D\u753B\u5706\u70B9**\u2014\u2014\u5B83\u662F\u53EF\u9009\u7684\uFF0C\u5706\u70B9\u53EA\u4E3A\"\u6709\u7C7B\u522B\"\u7684\u6279\u6CE8\u800C\u753B\u3002\n  - \u989C\u8272\u53EA\u6709 12 \u79CD\uFF0Cid \u662F\u6563\u5217\u5230\u989C\u8272\u4E0A\u7684\uFF0C\u6240\u4EE5**\u4E24\u4E2A\u4E0D\u540C\u7684 id \u53EF\u80FD\u649E\u6210\u540C\u4E00\u4E2A\u989C\u8272**\uFF0C\u90A3\u65F6\u8FD9\u4E24\u7C7B\u770B\u8D77\u6765\u4E00\u6837\uFF1A\u8FD9\u4E0D\u662F\"\u5206\u4E86\u51E0\u7C7B\u4E00\u76EE\u4E86\u7136\"\uFF0C\u53EA\u662F\"\u540C\u4E00\u7C7B\u989C\u8272\u4E00\u81F4\"\u3002\u60F3\u8BA9\u4EBA\u5206\u5F97\u6E05\uFF0C\u5C31**\u6709\u610F\u8BC6\u5730\u590D\u7528\u540C\u4E00\u4E2A id**\uFF0C\u4E0D\u8981\u7ED9\u540C\u4E00\u7C7B\u6362\u65B0 id\u3002\n  - id \u672C\u8EAB\u4E0D\u89E3\u6790\uFF1A\u968F\u4FBF\u7ED9\uFF08uuid \u4E5F\u884C\uFF09\u3002\u989C\u8272\u7531\u5B83\u7B97\u51FA\u6765\uFF1B\u4F60\u5199\u7684 id \u53EA\u51FA\u73B0\u5728\u5706\u70B9\u7684 **`title` / `aria-label`** \u91CC\uFF08\u9F20\u6807\u60AC\u505C\u3001\u6216\u8BFB\u5C4F\u8F6F\u4EF6\uFF09\uFF0C**\u4E0D\u662F\u5C4F\u5E55\u4E0A\u7684\u6587\u5B57**\u3002\u4F1A\u53BB\u6389\u4E24\u7AEF\u7A7A\u767D\uFF1B\u6700\u591A 64 \u4E2A\u5B57\u7B26\uFF0C\u8D85\u4E86**\u622A\u65AD**\uFF08\u4E0D\u4F1A\u56E0\u6B64\u62D2\u6389\u6574\u6761\u6279\u6CE8\uFF09\u3002\n\n## \u8BB2\u6D41\u7A0B\u5C31\u5728\u6B63\u6587\u5F00\u5934\u5199\u5E8F\u53F7\n\n\u5982\u679C\u8FD9\u51E0\u5F20\u5361\u662F**\u4E00\u6761\u6D41\u7A0B/\u8C03\u7528\u94FE\u7684\u6B65\u9AA4**\uFF0C\u628A\u5E8F\u53F7\u5199\u5728 note \u7684\u6700\u524D\u9762\uFF0C\u7528\u6237\u5C31\u80FD\u6309\u53F7\u8BFB\uFF1A\n\n- \u5E8F\u53F7\u6CA1\u6709\u4E13\u95E8\u53C2\u6570\uFF0C\u4E5F\u4E0D\u662F\u9762\u677F\u753B\u7684\u2014\u2014\u5B83\u5C31\u662F\u6B63\u6587\u7684\u5934\u51E0\u4E2A\u5B57\u7B26\uFF0C\u6240\u4EE5\u5361\u7247\u91CC\u3001\u5217\u8868\u91CC\u3001\u590D\u5236\u51FA\u53BB\u7684\u5185\u5BB9\u91CC\u90FD\u5E26\u7740\u5B83\uFF0C\u4F60\u5728\u56DE\u590D\u91CC\u4E5F\u80FD\u5F15\u7528\u540C\u4E00\u4E2A\u53F7\u3002\n- \u53F7\u7531\u4F60\u6392\uFF1A\u6309\u4F60\u5E0C\u671B\u7528\u6237\u9605\u8BFB\u7684\u987A\u5E8F\uFF1B1\u30012\u30013\u2026 \u8FDE\u4E0D\u8FDE\u7EED\u3001\u91CD\u4E0D\u91CD\u590D\u90FD\u968F\u4F60\uFF08**\u4E0D\u9700\u8981\u552F\u4E00**\uFF0C\u8BB2\u540C\u4E00\u4E2A\u70B9\u7684\u8865\u5145\u5361\u53EF\u4EE5\u540C\u53F7\uFF09\u3002\n- \u987A\u5E8F\u53F7\u4E5F\u5199\u8FDB\u4F60\u7684\u56DE\u590D\uFF08\"\u6211\u5728\u4EE3\u7801\u4E0A\u6807\u4E86 1\u20135\uFF0C\u4ECE X \u5F00\u59CB\"\uFF09\uFF0C\u8FD9\u6837\u9762\u677F\u91CC\u7684\u53F7\u548C\u56DE\u590D\u91CC\u7684\u53F7\u5BF9\u5F97\u4E0A\u3002\n- \u96F6\u6563\u7684\u6279\u6CE8\uFF08\u4E0D\u662F\u4E00\u4E32\u6B65\u9AA4\uFF09**\u4E0D\u8981**\u5199\u53F7\u3002\n\n## \u4E00\u5F20\u5361\u4E00\u4E2A\u70B9\n\n- \u8303\u56F4\u8981\u5C0F\uFF1A**\u6700\u591A 60 \u884C**\uFF0C\u901A\u5E38 1\u20135 \u884C\u5C31\u591F\u3002\u8981\u8BB2\u6574\u6BB5\u903B\u8F91\u5C31\u62C6\u6210\u51E0\u5F20\u5361\u3002\n- \u4E00\u6761\u8C03\u7528\u94FE = \u4E00\u5F20\u5361\u4E00\u4E2A\u8C03\u7528\u70B9\uFF0C\u6309\u4F60\u5E94\u8BE5\u8BA9\u7528\u6237\u9605\u8BFB\u7684\u987A\u5E8F\u4F9D\u6B21\u521B\u5EFA\uFF1B\u4E0D\u8981\u628A\u6240\u6709\u6B65\u9AA4\u585E\u8FDB\u4E00\u5F20\u5361\u3002\n- note \u91CC\u53EA\u8C08\u8FD9\u4E9B\u884C\uFF08\u6700\u591A\u5E26\u4E0A\u76F4\u63A5\u76F8\u90BB\u7684\u4E00\u4E24\u884C\uFF09\uFF0C\u4E0D\u8981\u6269\u5230\u6574\u4E2A\u6587\u4EF6\u6216\u6574\u4E2A\u4EFB\u52A1\u3002\n- \u5199\u6CD5\u6CBF\u7528\u6279\u6CE8\u7684\u89C4\u77E9\uFF1A\u4E0D\u8D85\u8FC7 3 \u884C\u3001\u884C\u95F4\u4E0D\u7A7A\u884C\u3001**\u4E0D\u8981 Markdown \u8868\u683C/\u5217\u8868/\u6807\u9898/\u56F4\u680F\u4EE3\u7801\u5757**\uFF08\u5361\u7247\u6309\u884C\u6392\u7248\uFF0C\u8868\u683C\u4F1A\u8BFB\u6210\u4E00\u5806\u7AD6\u7EBF\u5E76\u628A\u9AD8\u5EA6\u7B97\u9519\uFF09\uFF0C\u884C\u5185\u53EA\u7528 `\u4EE3\u7801` \u548C **\u52A0\u7C97**\u3002\u8981\u5F15\u7528\u522B\u5904\u5C31\u5199 `\u6587\u4EF6:\u884C\u53F7`\u3002\n- \u7528\u7528\u6237\u7684\u8BED\u8A00\u5199 note\u3002\n\n## \u90A3\u51E0\u884C\u5DF2\u7ECF\u88AB\u5360\u7528\u65F6\n\n\u5982\u679C\u8FD9\u4E9B\u884C\u5DF2\u7ECF\u843D\u5728**\u67D0\u5F20\u5361\u7247\u91CC**\uFF0C\u8C03\u7528\u4F1A\u88AB\u62D2\uFF0C\u62D2\u7EDD\u4FE1\u606F\u91CC\u4F1A\u5199\u660E\u662F\u54EA\u4E00\u5F20\uFF08id\u3001\u884C\u53F7\u3001\u5B83\u5F00\u5934\u7684\u8BDD\uFF09\u3002\u8FD9\u4E0D\u662F\u9519\u8BEF\uFF0C\u662F\"\u8FD9\u91CC\u5DF2\u7ECF\u6709\u8BDD\u8BF4\u4E86\"\uFF1A\n\n- \u6362\u4E00\u5904\u884C\u53F7\uFF1B\u6216\u8005\n- \u628A\u8FD9\u4EF6\u4E8B\u5199\u8FDB\u4F60\u7684\u56DE\u590D\u91CC\uFF0C\u4E0D\u8981\u8BD5\u56FE\u786C\u585E\u8FDB\u90A3\u5F20\u5361\uFF1A\u90A3\u5F20\u5361\u7684\u5BF9\u8BDD\u5C5E\u4E8E\u5199\u5B83\u7684\u4EBA\uFF08\u53EF\u80FD\u662F\u7528\u6237\uFF0C\u4E5F\u53EF\u80FD\u662F\u4F60\u65E9\u5148\u5199\u7684\uFF09\u3002\u5982\u679C\u7528\u6237\u60F3\u5728\u90A3\u5F20\u5361\u4E0A\u7EE7\u7EED\u804A\uFF0C\u4ED6\u4F1A\u5728\u5361\u7247\u91CC\u56DE\u590D\u4F60\uFF0C\u90A3\u65F6\u4F60\u4F1A\u6536\u5230 `[\u8BC4\u8BBA]`\uFF0C\u6309 `dsh-diff-approval-comment` \u7684\u89C4\u77E9\u56DE\u7B54\u5373\u53EF\u3002\n\n**\u4E0D\u8981**\u5728\u56DE\u590D\u91CC\u5047\u88C5\u5DF2\u7ECF\u6279\u6CE8\u6210\u529F\u2014\u2014\u5DE5\u5177\u8FD4\u56DE\u7684\u662F\"refused: ...\"\u5C31\u8BF4\u660E\u6CA1\u6709\u5361\u7247\u88AB\u521B\u5EFA\u3002\n";
 /** One runtime skill contribution, in the shape `ctx.skills.register` takes. */
 export interface AnnotateSkillRegistration {
     /** Kebab-case identity the agent loads by. */

package/lib/types/annotate-tool.d.ts

@@ -46,6 +46,13 @@ export interface AnnotateToolArgs {
     endLine?: number | undefined;
     /** What the card says. Kept short: the card is drawn line by line beside the code. */
     note: string;
+    /**
+     * Optional class of annotation — the same id for every annotation of one kind, a different one for the
+     * next. The panel draws a coloured round dot from it (see `category-color.ts`), so an agent's several
+     * passes over the same review are tellable apart at a glance. Opaque: hashed for the colour and shown
+     * back to the reader as written. Trimmed, and cut to 64 characters.
+     */
+    category?: string | undefined;
     /** Optional guard: the exact text the caller believes those lines hold (newline-joined). */
     quote?: string | undefined;
 }
@@ -90,6 +97,10 @@ export declare const ANNOTATE_TOOL_PARAMETERS: {
             readonly type: "string";
             readonly description: string;
         };
+        readonly category: {
+            readonly type: "string";
+            readonly description: string;
+        };
     };
 };
 /**

package/lib/types/annotate.d.ts

@@ -43,6 +43,26 @@ export declare const MAX_ANNOTATION_LINES = 60;
  * own reply to the user, which is not measured in code rows.
  */
 export declare const MAX_ANNOTATION_CHARS = 1000;
+/**
+ * The most characters a category id may carry.
+ *
+ * The id is a grouping key, not prose: it is hashed for a colour and shown back in the mark's own label,
+ * so anything past this is noise the reader would never see. Longer ids are TRUNCATED rather than
+ * refused (see {@link normalizeCategory}).
+ */
+export declare const MAX_ANNOTATION_CATEGORY_CHARS = 64;
+/**
+ * The category id as it is stored: trimmed, and cut to {@link MAX_ANNOTATION_CATEGORY_CHARS}.
+ *
+ * TRUNCATED rather than refused: the id is only ever hashed into a colour and echoed in the mark's label,
+ * so an over-long one still groups its annotations consistently — every call of that class is cut in the
+ * same place — while refusing would fail an entire annotation over a cosmetic detail. Absent, empty and
+ * whitespace-only all mean the same thing: no class, so no dot (see `CommentRecord.category`).
+ *
+ * @param value - the id the caller passed, if any.
+ * @returns the id to store, or `undefined` when there is none.
+ */
+export declare function normalizeCategory(value: string | undefined): string | undefined;
 /** What the agent asked for, once the tool layer has resolved which pending entry it means. */
 export interface AnnotationRequest {
     /** The session the annotation belongs to, i.e. the one whose panel will draw it. */
@@ -58,6 +78,14 @@ export interface AnnotationRequest {
     endLine?: number | undefined;
     /** The annotation itself: the card's first turn, written by the agent. */
     note: string;
+    /**
+     * Optional class of annotation: the same id for every annotation of one kind, a different one for the
+     * next. Opaque to the host and to the panel — hashed into a colour and shown back to the reader in the
+     * mark's label — so an agent annotating several passes can be told apart at a glance. Normalised by
+     * {@link normalizeCategory}: trimmed, empty means absent, cut to
+     * {@link MAX_ANNOTATION_CATEGORY_CHARS}.
+     */
+    category?: string | undefined;
     /**
      * Optional guard: the text the caller believes those lines read, newline-joined.
      *

package/lib/types/client/PendingPanel.d.ts

@@ -22,15 +22,12 @@ import type { VisibleLines } from './windowed-highlight.ts';
  * floor is not just a drag limit, it is the width at which the footer is still itself.
  */
 export declare const MIN_LIST_WIDTH_PX = 260;
-/** Normalize a path for comparison: forward slashes, no trailing slash. */
-export declare function normalizeDiffPath(p: string): string;
-/** Whether a produced-file chip path and a pending file path refer to the same
- *  file, tolerant of separator style (\\ vs /) and of a workspace-relative vs
- *  absolute form. `chipPath` is typically the harness's workspace-relative
- *  forward-slash path; `filePath` is the host's absolute native-separator path.
- *  Matching is case-insensitive so a Windows drive/segment case difference does
- *  not miss the file the user clicked. */
-export declare function diffPathsMatch(chipPath: string, filePath: string, workspacePath: string | undefined): boolean;
+/**
+ * Path comparison, re-exported from its own module so every existing importer keeps working: the panel's
+ * own jump, the plugin's press bridge and the store reader all ask the same question, and they must not
+ * each carry their own answer (see `path-match.ts`).
+ */
+export { diffPathsMatch, normalizeDiffPath } from './path-match.ts';
 /** The dsh shell's sidebar auto-collapse breakpoint (ui-layout columns.ts):
  * below it the sidebar auto-collapses, and the file list floats on the same
  * breakpoint so the two stay consistent. */
@@ -82,17 +79,27 @@ export interface PendingPanelDockProps {
     docked?: boolean;
     /** The element the docked panel portals its content into. */
     dockHost?: HTMLElement;
+    /**
+     * Whether this seat is SHOWING anything, and so whether it should read the host at all.
+     *
+     * A seat that is not on screen — a docked tab the reader has switched away from — draws nothing, so
+     * its poll reads a list nobody is looking at, once a second, for a session the reader may not even be
+     * in. `false` stops that read; the seat keeps what it last read and starts again the moment it is
+     * shown. Absent means "always showing", which is what the footer entry is: its badge is the reader's
+     * at-a-glance count, and a badge that never read would simply show nothing.
+     */
+    showing?: boolean;
+    /**
+     * Ask the host how many rows this session has, WITHOUT reading the list (`list-count`).
+     *
+     * This is what the tick asks while this seat has no surface on screen: the badge is the thing that has
+     * to keep working while the panel is shut, and the full read is what makes it slow (it ships every
+     * visible entry's whole old and new text). A seat that IS on screen keeps the full read, and so does a
+     * face that offers no counter at all — absent means "this face cannot count", which is today's
+     * behaviour: one full read per tick.
+     */
+    onRefreshCount?: ((sessionId: SessionId | undefined) => void) | undefined;
 }
-/**
- * Open the DSH settings dialog and switch to this plugin's section. The
- * settings shell keeps its open state and the active section id as
- * component-local viewing state with no cross-plugin service, so the dialog
- * is opened by clicking the sidebar's settings trigger and then the nav cell
- * for this section. `element.click()` still fires React's delegated click
- * handlers, reaching the same state transitions a user gesture would.
- * @param sectionLabel - the nav label of this plugin's settings section.
- */
-export declare function openSettingsSection(sectionLabel: string): void;
 /**
  * How much of the window the app itself occupies on each side of the conversation
  * — how far the floating panel has to start from an edge to leave that part
@@ -237,5 +244,4 @@ export declare function fittingItems(widths: readonly number[], available: numbe
  */
 export declare function inlineItemCount(widths: readonly number[], available: number, gap: number, overflowWidth: number): number;
 /** Render the pending-edit review panel and its unified footer action. */
-export declare function PendingPanel({ wide, useSessions, sessionId, usePending, onRefresh, onKeep, onRevert, onBlockKeep, onBlockRevert, onOpen, onPreviewImage, onPasteReference, onCommentAdd, onCommentRemove, onCommentRemoveMany, onCommentAsk, onUndo, onRedo, onImportVcs, onRefreshVcs, onBrowse, onAddPath, onKeepAll, onRevertAll, onKeepMany, onRevertMany, onAckRedoCleared, onAckUndoNotice, collapseSidebar, t, docked, dockHost, onOpenDock, closeDock, useDock, }: PendingPanelProps): import("react").JSX.Element;
-export {};
+export declare function PendingPanel({ wide, useSessions, sessionId, usePending, pendingView, showing, onRefresh, onRefreshCount, onMarkSeen, onKeep, onRevert, onBlockKeep, onBlockRevert, onOpen, onPreviewImage, onPasteReference, onCommentAdd, onCommentRemove, onCommentRemoveMany, onCommentAsk, onCommentSeen, onUndo, onRedo, onImportVcs, onRefreshVcs, onBrowse, onAddPath, onKeepAll, onKeepMany, onRevertMany, onAckRedoCleared, onAckUndoNotice, collapseSidebar, t, docked, dockHost, onOpenDock, closeDock, useDock, onCheckUpdate, }: PendingPanelProps): import("react").JSX.Element;

package/lib/types/client/category-color.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The colour a comment's CATEGORY is drawn as: one round dot per class of annotation.
+ *
+ * An agent annotating several passes over the same review (a call-chain walk, then the findings, then a
+ * second round of questions) can pass the same `category` id for every annotation of one kind and a
+ * different id for the next — and the reader then sees at a glance which class each comment belongs to,
+ * without reading a word. The id itself is opaque here: this module never parses it, only hashes it.
+ *
+ * The mapping is a plain hash into a fixed palette, so it is the SAME colour on any host and after any
+ * reload, with nothing persisted beyond the id the record already carries. Two ids can collide on one
+ * colour — 12 buckets cannot promise otherwise — which is why the reader also gets the id in words
+ * (`title`/`aria-label`): colour is a fast cue, never the only one.
+ *
+ * @module dsh-diff-approval/src/client/category-color
+ */
+/**
+ * The twelve colours, in the order the hash indexes them — and THE ORDER IS PART OF THE CONTRACT, because
+ * the index is the bucket (see `categoryColorIndex`).
+ *
+ * The SET was chosen by CIEDE2000, not by eye and not by hue angle: it is a coordinate-ascent result over
+ * twelve colour families, and its MINIMUM pairwise ΔE00 is **18.82** — owned by the light blue and the grey
+ * — with every entry between L* 42 and 70, so each reads as a mark on the panel's light and dark surfaces
+ * alike. An earlier palette looked well spaced on the hue wheel and was not: indigo `#6E56CF` against
+ * purple `#8E4EC6` sat 20° apart at the same lightness and chroma — ΔE00 **6.94** on a 3px mark — and a
+ * near-duplicate green `#57a751` would have passed a hue-angle floor at ΔE00 2.65.
+ *
+ * THE ORDER was then solved for SEPARATELY (2026-10-06), because the set's spacing says nothing about the
+ * spacing of NEIGHBOURING buckets: the array used to be a hue ramp, so two categories whose hashes landed
+ * on adjacent indices — 2 times out of 12, which is the reader's own pair at indices 7 and 8 — differed by
+ * as little as ΔE00 19.28. The sequence below is the bottleneck Hamiltonian path over those same twelve
+ * colours: the order that MAXIMISES the MINIMUM ΔE00 over the eleven consecutive pairs, proved optimal by
+ * a DP over (mask, last) in the scratch script that chose it. Its consecutive minimum is **32.7475** — the
+ * full value is 32.74748843826888, which is why the test's floor is 32.7474 and not the rounded figure —
+ * owned by the grey and the red, against 19.2835 for the shipped order, and the set itself is byte-identical,
+ * so the whole-palette floor above is still 18.82. `tests/category-color.client.spec.ts` asserts BOTH numbers
+ * (whole-set and consecutive) plus the L* band, so a thirteenth colour or a reshuffle fails a test rather
+ * than shipping.
+ *
+ * Two categories can still collide EXACTLY — twelve buckets cannot promise otherwise, and `alpha`/`beta` in
+ * the spec do — so the promise this order keeps is "adjacent buckets differ a lot", never "different ids
+ * always differ"; colour is a fast cue, and the id in the mark's own `title`/`aria-label` is the exact one.
+ */
+export declare const CATEGORY_COLORS: readonly ["#7F888E", "#C33D41", "#6A5CA4", "#7AAB83", "#B8A3CA", "#1D6F66", "#DC54B9", "#80A5EB", "#8D711B", "#13A9BF", "#577F11", "#C19784"];
+/**
+ * Which palette entry a category id maps to: FNV-1a (32-bit) over the id's UTF-16 code units, mod 12.
+ *
+ * FNV-1a because it is four lines, has no dependencies, and spreads uuid-shaped ids (the reader's own
+ * suggestion: "passing a uuid per call") well enough that a handful of categories rarely collide. It is
+ * pinned by a test with a fixed id, so changing the hash is a visible decision rather than a silent
+ * recolouring of every existing annotation.
+ *
+ * @param category - the category id, as it was stored (already trimmed and capped by the tool rule).
+ * @returns the index into {@link CATEGORY_COLORS}, 0..11.
+ */
+export declare function categoryColorIndex(category: string): number;
+/**
+ * The colour one category is drawn as.
+ *
+ * @param category - the category id.
+ * @returns a `#RRGGBB` string from {@link CATEGORY_COLORS}.
+ */
+export declare function categoryColor(category: string): string;

package/lib/types/client/chords.d.ts

@@ -9,13 +9,6 @@
  * @module dsh-diff-approval/client/chords
  */
 import type { Translator } from './locales.ts';
-/**
- * One stored chord as a hint renders it: modifiers as written, arrow keys as
- * glyphs (`Ctrl+ArrowUp` → `Ctrl+↑`).
- * @param chord - the stored chord.
- * @returns the hint text; `''` for an unbound action.
- */
-export declare function chordHint(chord: string): string;
 /**
  * One action's chord as a hint.
  * @param action - the keybinding action id (see `DEFAULT_KEYBINDINGS`).
@@ -31,19 +24,79 @@ export declare function chordLabel(action: string): string;
  * @returns the label, with ` (chord)` appended when one is configured.
  */
 export declare function withChord(label: string, action: string): string;
+/** One chord in both the forms a tooltip needs, read from a single setting so the two cannot drift. */
+export interface ChordShortcut {
+    /**
+     * The keycaps, in order, with a literal `'+'` between the parts: the shell renders one `<kbd>` per
+     * entry and groups a combination into a single keycap when the array carries a separator (see the
+     * primitives' `ShortcutKeys`).
+     */
+    keys: string[];
+    /** The `aria-keyshortcuts` value: the same chord spelled in DOM key names. */
+    aria: string;
+}
+/**
+ * One action's shortcut, as a tooltip's `shortcutKeys` and the anchor's `aria-keyshortcuts`.
+ * @param action - the keybinding action id (see `DEFAULT_KEYBINDINGS`).
+ * @returns the two forms, or `undefined` when the action is unbound.
+ */
+export declare function shortcutOf(action: string): ChordShortcut | undefined;
+/**
+ * The quick-summon chord: its own setting rather than one of `DEFAULT_KEYBINDINGS`, since it is the
+ * one chord the panel is opened BY rather than one it answers inside.
+ * @returns the two forms, or `undefined` when the chord is unbound.
+ */
+export declare function summonShortcut(): ChordShortcut | undefined;
+/**
+ * Escape alone: the key the INNERMOST dismissible answers to (the search bar, a dialog), which no
+ * panel chord stands behind — the quick-summon chord closes the panel, not the bar inside it.
+ * @returns the keycaps and the aria form.
+ */
+export declare function escapeShortcut(): ChordShortcut;
+/**
+ * The panel's close button: Escape always, plus the quick-summon chord while one is bound.
+ *
+ * This is the one place the shell's one-chord model needs a judgment: these are two WAYS out, not a
+ * sequence, so they stay two keycaps (`['Esc', 'Ctrl+D']`) and two space-separated aria shortcuts —
+ * grouping them into one cap with separators would read as "press Esc, then Ctrl+D".
+ * @returns the keycaps and the aria form.
+ */
+export declare function closeShortcut(): ChordShortcut;
+/** What one tooltip site hands the shell, decided here so that no call site ever branches. */
+export interface TooltipChord {
+    /**
+     * The label for the shell's `Tooltip`: the action's own name where the shell draws keycaps, and the
+     * label this plugin spelled before the primitives' 0.1.7-rc.2 — chord glued in — where it cannot.
+     */
+    label: string;
+    /** The keycaps to pass, or `undefined` when there is no chord or this host cannot draw one. */
+    shortcutKeys: readonly string[] | undefined;
+    /** The anchor's `aria-keyshortcuts`: plain text, and the same on every host. */
+    aria: string | undefined;
+}
+/**
+ * A tooltip for one action's chord.
+ * @param label - the translated action label.
+ * @param action - the keybinding action id, or `undefined` for a control that has no chord at all.
+ * @returns the label, keycaps and aria; an unbound or absent action keeps the plain label.
+ */
+export declare function actionTooltip(label: string, action: string | undefined): TooltipChord;
+/**
+ * The entry buttons that open the panel (the session header's, the footer badge): what it holds, and
+ * the chord that does the same. With the chord unbound the plain label is the whole hint.
+ * @param t - the panel's translator.
+ * @returns the label, keycaps and aria.
+ */
+export declare function summonTooltip(t: Translator): TooltipChord;
 /**
- * How the panel's close button names its two ways out: Escape, and the
- * quick-summon chord when the user still has one bound. Unbinding the chord
- * leaves Escape as the only answer, so the hint then says just that.
+ * The panel's close button: Escape, plus the quick-summon chord while one is bound.
  * @param t - the panel's translator.
- * @returns the tooltip label.
+ * @returns the label, keycaps and aria.
  */
-export declare function closeHint(t: Translator): string;
+export declare function closeTooltip(t: Translator): TooltipChord;
 /**
- * How an entry button names what it opens: the pending-changes panel, plus the
- * chord that does the same. With the chord unbound the plain label is the whole
- * hint — never an empty parenthetical.
+ * A control only Escape dismisses — the search bar — which no panel chord stands behind.
  * @param t - the panel's translator.
- * @returns the tooltip label.
+ * @returns the label, keycaps and aria.
  */
-export declare function summonHint(t: Translator): string;
+export declare function escapeTooltip(t: Translator): TooltipChord;

package/lib/types/client/discussion.d.ts

@@ -127,6 +127,13 @@ export interface Discussion {
     quoteWrap?: boolean;
     /** How many older messages the row cap left out of the render. */
     hidden?: number;
+    /**
+     * Something the reader has not looked at yet arrived in this thread — an agent's own annotation, or
+     * an answer to one of its questions — so the card wears the dot. Host truth, carried through from
+     * the stored record (see `CommentRecord.unseen`): the block draws it and the card's own visibility
+     * is what asks the host to take it down.
+     */
+    unseen?: boolean;
 }
 /** Rows a folded block occupies: its header line. */
 export declare const DISCUSSION_HEADER_ROWS = 1;

package/lib/types/client/dock.d.ts

@@ -14,7 +14,8 @@
  */
 import type { ReactNode } from 'react';
 import type { HostObservable, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
-import type { PendingDiffSnapshot } from './slots.ts';
+import type { SessionId } from '@deepseek-ai/dsh-client-connection/client';
+import type { PendingDiffSnapshot, PendingViewHooks } from './slots.ts';
 /** The tab type's `kind`: what `openTab` names. */
 export declare const DIFF_DOCK_KIND = "diff-approval";
 /** The registration's `id`: the key its body and title register under. The
@@ -120,11 +121,15 @@ type TabInfoHook = () => {
         readonly visible: boolean;
     };
 };
-export interface DiffDockBodyProps extends PropsLocale<'diff-approval'> {
+export interface DiffDockBodyProps extends PropsLocale<'diff-approval'>, PendingViewHooks {
     /** The seat's own tab hook (the sidebar framework injects it). */
     readonly useTabInfo?: TabInfoHook;
-    /** This plugin's pending store hook, for the chip's count. */
+    /** This plugin's pending store hook, for the chip's count where no per-session reader reaches it. */
     readonly usePending?: (select: (snapshot: PendingDiffSnapshot) => unknown) => unknown;
+    /** The session seat, when this host composes one into the tab (see `session-seat.ts`). */
+    readonly useSessions?: ((select: (state: unknown) => unknown) => unknown) | undefined;
+    /** The session this dock tab belongs to, when the shell composes one. */
+    readonly sessionId?: SessionId | undefined;
     /** Whether the panel renders as the docked body (set by the tab seat's face). */
     readonly docked?: boolean;
     /** Report this body's visibility to the dock state (see {@link DockFace}). */

package/lib/types/client/dsh-icons.d.ts

@@ -24,6 +24,7 @@
  * @module dsh-diff-approval/client/dsh-icons
  */
 import * as primitives from '@deepseek-ai/dsh-client-ui-primitives';
+import type { ReactElement } from 'react';
 /** The pending-changes glyph: the sidebar's badge and the header entry carry it. */
 export declare const IconListPenOutline16: ({ size, className }: primitives.IconProps) => import("react").JSX.Element;
 /** The list's fold chevrons. */
@@ -56,5 +57,42 @@ export declare const IconSettingsOutline16: ({ size, className }: primitives.Ico
  * Re-exported so one module names everything this plugin takes from the shell's primitives: these
  * names have survived both releases, and a caller has no reason to reach past this file.
  */
-export { Menu, Toast, Tooltip, writeClipboard } from '@deepseek-ai/dsh-client-ui-primitives';
+export { Menu, Toast, writeClipboard } from '@deepseek-ai/dsh-client-ui-primitives';
 export type { MenuEntry } from '@deepseek-ai/dsh-client-ui-primitives';
+/** The tooltip props this plugin uses, including the one the installed types do not know yet. */
+export interface ShellTooltipProps {
+    label: string;
+    side?: 'right' | 'bottom' | 'top' | undefined;
+    delayMs?: number | undefined;
+    maxWidth?: number | undefined;
+    disabled?: boolean | undefined;
+    /**
+     * The keycaps the bubble renders AFTER its label, one `<kbd>` per entry, with a literal `'+'`
+     * between the parts so the shell groups a combination into a single keycap. `undefined` (or an
+     * empty array) renders no keycaps at all — which is what an unbound action passes.
+     */
+    shortcutKeys?: readonly string[] | undefined;
+    children: ReactElement;
+}
+/**
+ * The primitives' `Tooltip`, typed with the props above.
+ *
+ * `shortcutKeys` arrived in the primitives' 0.1.7-rc.2 — the release the host runs — while what this
+ * repo COMPILES against is 0.1.0-rc.6, whose `Tooltip.d.ts` predates it. Passing the prop at a call
+ * site is therefore a type error even though the running component accepts it (and an older one simply
+ * ignores an unknown prop). The cast lives here, once, at the same boundary this module already uses
+ * to bridge shell versions, rather than at every call site.
+ */
+export declare const Tooltip: (props: ShellTooltipProps) => ReactElement;
+/**
+ * Whether the running shell can draw a shortcut beside a tooltip's label.
+ *
+ * `ShortcutKeys` and the `Tooltip.shortcutKeys` prop shipped together in the primitives'
+ * **0.1.7-rc.2**: across all 24 installed versions this plugin is tested against, the component is
+ * absent from every release up to and including 0.1.7-rc.1 (`lib/index.js` does not contain the name
+ * at all, and `Tooltip.d.ts` takes no `shortcutKeys`) and present from 0.1.7-rc.2 on (`function
+ * ShortcutKeys(...)`, exported, and `shortcutKeys?: readonly string[]` on `Tooltip`) — the same
+ * release the prop arrived in, so the two can never disagree. An older host ignores an unknown prop
+ * silently, which is why a caller must not rely on the prop alone (see `chords.ts`).
+ */
+export declare const SHELL_DRAWS_SHORTCUTS: boolean;

package/lib/types/client/header-entry.d.ts

@@ -20,14 +20,15 @@
 import type { ReactNode } from 'react';
 import type { HostObservable, InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { SessionId } from '@deepseek-ai/dsh-client-connection/client';
-import type { PendingDiffSnapshot } from './slots.ts';
+import type { PendingDiffSnapshot, PendingViewHooks } from './slots.ts';
 import type { DockSnapshot } from './dock.tsx';
-/** What the header entry reads from this plugin's own face: the two observables.
- *  Everything else it needs (the button's own click) goes through the window
- *  events, so the entry never holds a copy of the panel's state. */
-export interface HeaderEntryFace {
+/** What the header entry reads from this plugin's own face: the two observables, and the per-session
+ *  view reader (`pendingView`) that keeps its count on ITS session. Everything else it needs (the
+ *  button's own click) goes through the window events, so the entry never holds a copy of the panel's
+ *  state. */
+export interface HeaderEntryFace extends PendingViewHooks {
     hooks: {
-        /** Live pending-diff snapshot: the count on the button. */
+        /** Live pending-diff snapshot: the fallback count for a face with no per-session reader. */
         pending: HostObservable<PendingDiffSnapshot>;
         /** The dock's state, absent in a build without a right sidebar. */
         dock?: HostObservable<DockSnapshot>;
@@ -71,4 +72,4 @@ export type DiffApprovalHeaderEntryProps = InjectFace<HeaderEntryFace> & HeaderE
  * @param props - the bound hooks, the session seat, and the translator.
  * @returns the icon button, with the pending count while there is one.
  */
-export declare function DiffApprovalHeaderEntry({ usePending, useSessions, useDock, sessionId, t }: DiffApprovalHeaderEntryProps): ReactNode;
+export declare function DiffApprovalHeaderEntry({ usePending, useSessions, useDock, pendingView, sessionId, t }: DiffApprovalHeaderEntryProps): ReactNode;

package/lib/types/client/locales.d.ts

@@ -14,7 +14,6 @@ export declare const zh: {
     'panel.tab.pending': string;
     'panel.tab.comments': string;
     'panel.commentsEmpty': string;
-    'panel.commentOutdated': string;
     'panel.aria': string;
     'panel.stats': string;
     'panel.blockPosition': string;
@@ -23,12 +22,22 @@ export declare const zh: {
     'panel.blockSingle': string;
     'chip.openDefault': string;
     'chip.reviewInPanel': string;
+    'chip.copyPath': string;
+    'chip.about': string;
+    'chip.about.title': string;
+    'panel.confirmFileTitle': string;
+    'panel.batchConfirmTitle': string;
+    'chip.about.body': string;
+    'chip.about.ok': string;
+    'update.chip': string;
+    'update.body': string;
+    'update.npm': string;
+    'update.github': string;
+    'update.dismiss': string;
     'chip.gone': string;
     'panel.fileNotPending': string;
     'panel.selectHint': string;
     'panel.searchPlaceholder': string;
-    'panel.missing': string;
-    'panel.missingHint': string;
     'panel.externalChanged': string;
     'panel.dismiss': string;
     'panel.pasteOnCopy': string;
@@ -76,6 +85,8 @@ export declare const zh: {
     'settings.commentDesc': string;
     'settings.diffView': string;
     'settings.diffViewDesc': string;
+    'settings.chipMenu': string;
+    'settings.chipMenu.help': string;
     'settings.diffPreview': string;
     'panel.keyDesc': string;
     'panel.shortcutNone': string;
@@ -98,26 +109,29 @@ export declare const zh: {
     'panel.key.coverRight': string;
     'panel.key.coverTop': string;
     'settings.tabLabel': string;
-    'row.create': string;
     'row.failed': string;
+    'panel.unseen': string;
+    'panel.commentCategory': string;
     'row.dismiss': string;
     'row.keepListed': string;
     'row.keepRemove': string;
     'row.revertRemove': string;
+    'row.deleteRemove': string;
     'panel.batchKeepAsk': string;
     'panel.batchKeepRemoveAsk': string;
     'panel.batchRevertAsk': string;
     'panel.batchRevertRemoveAsk': string;
     'panel.batchKeepAllAsk': string;
     'panel.batchRevertAllAsk': string;
+    'panel.batchRevertAllDeletedAsk': string;
     'panel.batchCloseAsk': string;
     'panel.batchDeletes': string;
-    'panel.batchAndMore': string;
+    'panel.batchDeletesList': string;
     'panel.batchGo': string;
     'panel.removeOneAsk': string;
     'panel.removeCommentsOne': string;
     'panel.removeCommentsMany': string;
-    'panel.removeCommentsMore': string;
+    'panel.batchCommentsList': string;
     'row.added': string;
     'row.removed': string;
     'action.keep': string;
@@ -232,6 +246,7 @@ export declare const zh: {
     'panel.addNoEntries': string;
     'panel.addMissing': string;
     'panel.addOutside': string;
+    'panel.addOtherSession': string;
     'panel.addNotAFile': string;
     'panel.addFailed': string;
     'action.cancel': string;
@@ -263,7 +278,6 @@ export declare const en: {
     'panel.tab.pending': string;
     'panel.tab.comments': string;
     'panel.commentsEmpty': string;
-    'panel.commentOutdated': string;
     'panel.aria': string;
     'panel.stats': string;
     'panel.blockPosition': string;
@@ -272,12 +286,22 @@ export declare const en: {
     'panel.blockSingle': string;
     'chip.openDefault': string;
     'chip.reviewInPanel': string;
+    'chip.copyPath': string;
+    'chip.about': string;
+    'chip.about.title': string;
+    'panel.confirmFileTitle': string;
+    'panel.batchConfirmTitle': string;
+    'chip.about.body': string;
+    'chip.about.ok': string;
+    'update.chip': string;
+    'update.body': string;
+    'update.npm': string;
+    'update.github': string;
+    'update.dismiss': string;
     'chip.gone': string;
     'panel.fileNotPending': string;
     'panel.selectHint': string;
     'panel.searchPlaceholder': string;
-    'panel.missing': string;
-    'panel.missingHint': string;
     'panel.externalChanged': string;
     'panel.dismiss': string;
     'panel.pasteOnCopy': string;
@@ -325,6 +349,8 @@ export declare const en: {
     'settings.commentDesc': string;
     'settings.diffView': string;
     'settings.diffViewDesc': string;
+    'settings.chipMenu': string;
+    'settings.chipMenu.help': string;
     'settings.diffPreview': string;
     'panel.keyDesc': string;
     'panel.shortcutNone': string;
@@ -347,26 +373,29 @@ export declare const en: {
     'panel.key.coverRight': string;
     'panel.key.coverTop': string;
     'settings.tabLabel': string;
-    'row.create': string;
     'row.failed': string;
+    'panel.unseen': string;
+    'panel.commentCategory': string;
     'row.dismiss': string;
     'row.keepListed': string;
     'row.keepRemove': string;
     'row.revertRemove': string;
+    'row.deleteRemove': string;
     'panel.batchKeepAsk': string;
     'panel.batchKeepRemoveAsk': string;
     'panel.batchRevertAsk': string;
     'panel.batchRevertRemoveAsk': string;
     'panel.batchKeepAllAsk': string;
     'panel.batchRevertAllAsk': string;
+    'panel.batchRevertAllDeletedAsk': string;
     'panel.batchCloseAsk': string;
     'panel.batchDeletes': string;
-    'panel.batchAndMore': string;
+    'panel.batchDeletesList': string;
     'panel.batchGo': string;
     'panel.removeOneAsk': string;
     'panel.removeCommentsOne': string;
     'panel.removeCommentsMany': string;
-    'panel.removeCommentsMore': string;
+    'panel.batchCommentsList': string;
     'row.added': string;
     'row.removed': string;
     'action.keep': string;
@@ -481,6 +510,7 @@ export declare const en: {
     'panel.addNoEntries': string;
     'panel.addMissing': string;
     'panel.addOutside': string;
+    'panel.addOtherSession': string;
     'panel.addNotAFile': string;
     'panel.addFailed': string;
     'action.cancel': string;