dsh-hooks 0.11.0 → 0.13.0

package/lib/client.js

@@ -31,6 +31,44 @@ window.__ModuleLoader__.load({
 		async function fetchHistory(n = 50, fetchFn = fetch) {
 			return getJson(`/dsh-hooks/history?n=${Math.max(1, Math.min(500, Math.floor(n)))}`, fetchFn);
 		}
+		/** Outcomes a hook run can end in (kept in sync with the host record type). */
+		const HISTORY_OUTCOMES = [
+			"spawned",
+			"exit-0",
+			"exit-nonzero",
+			"timeout",
+			"spawn-failed",
+			"skipped",
+			"sent",
+			"send-failed"
+		];
+		/**
+		* Apply the panel's filters to a batch of records. The three conditions are
+		* AND-ed; an empty filter keeps everything (the timeline's default view).
+		*/
+		function filterHistory(records, filter) {
+			const session = filter.session?.trim().toLowerCase();
+			return records.filter((record) => {
+				if (filter.event !== void 0 && filter.event !== "" && record.event !== filter.event) return false;
+				if (filter.outcome !== void 0 && filter.outcome !== "" && record.outcome !== filter.outcome) return false;
+				if (session !== void 0 && session !== "") {
+					const id = record.sessionId?.toLowerCase() ?? "";
+					const name = record.sessionName?.toLowerCase() ?? "";
+					if (!id.includes(session) && !name.includes(session)) return false;
+				}
+				return true;
+			});
+		}
+		/** Serialize records as JSONL — byte-compatible with the on-disk history log. */
+		function historyToJsonl(records) {
+			if (records.length === 0) return "";
+			return `${records.map((record) => JSON.stringify(record)).join("\n")}\n`;
+		}
+		/** Download file name for a history export, stamped with local time. */
+		function historyExportName(now = /* @__PURE__ */ new Date()) {
+			const pad = (n) => String(n).padStart(2, "0");
+			return `dsh-hooks-history-${`${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`}.jsonl`;
+		}
 		async function postTest(body, fetchFn = fetch) {
 			try {
 				const response = await fetchFn("/dsh-hooks/test", {
@@ -200,18 +238,22 @@ window.__ModuleLoader__.load({
 		const EVENTS = [
 			"turn/start",
 			"turn/end",
+			"tree/settled",
 			"step/end",
 			"tool/call",
 			"tool/result",
 			"user/message",
 			"approval/asked",
+			"approval/decided",
 			"session/title",
 			"session/created",
 			"session/disposed",
 			"agent/created",
 			"agent/disposed",
 			"agent/error",
-			"agent/status"
+			"agent/status",
+			"hook/failed",
+			"usage/daily"
 		];
 		const TURN_END_REASONS = [
 			"completed",
@@ -313,10 +355,35 @@ window.__ModuleLoader__.load({
 				}
 			});
 			const [loadError, setLoadError] = (0, react.useState)(false);
+			const [historyFilter, setHistoryFilterState] = (0, react.useState)(() => ({
+				event: loadStored("dsh-hooks.historyEvent", ""),
+				outcome: loadStored("dsh-hooks.historyOutcome", ""),
+				session: loadStored("dsh-hooks.historySession", "")
+			}));
+			const setHistoryFilter = (patch) => {
+				setHistoryFilterState((current) => {
+					const next = {
+						...current,
+						...patch
+					};
+					storeValue("dsh-hooks.historyEvent", next.event ?? "");
+					storeValue("dsh-hooks.historyOutcome", next.outcome ?? "");
+					storeValue("dsh-hooks.historySession", next.session ?? "");
+					return next;
+				});
+			};
+			const visibleHistory = history === null ? null : filterHistory(history, historyFilter);
+			const historyFiltered = (historyFilter.event ?? "") !== "" || (historyFilter.outcome ?? "") !== "" || (historyFilter.session ?? "") !== "";
 			const [event, setEvent] = (0, react.useState)("turn/end");
 			const [reason, setReason] = (0, react.useState)("completed");
 			const [tool, setTool] = (0, react.useState)("");
 			const [testResult, setTestResult] = (0, react.useState)(null);
+			const [mockFields, setMockFields] = (0, react.useState)({
+				runningSubagents: "",
+				durationMs: "",
+				usageInputTokens: "",
+				usageOutputTokens: ""
+			});
 			const [notifyChannel, setNotifyChannel] = (0, react.useState)("webhook");
 			const [notifyUrl, setNotifyUrl] = (0, react.useState)("");
 			const [notifySlack, setNotifySlack] = (0, react.useState)(false);
@@ -341,7 +408,7 @@ window.__ModuleLoader__.load({
 			const refresh = (0, react.useCallback)(async () => {
 				const [statusInfo, records, feishuInfo] = await Promise.all([
 					fetchStatus(),
-					fetchHistory(30),
+					fetchHistory(200),
 					fetchFeishuStatus()
 				]);
 				setStatus(statusInfo);
@@ -375,18 +442,47 @@ window.__ModuleLoader__.load({
 			}, [
 				event,
 				reason,
-				tool
+				tool,
+				mockFields
 			]);
+			/** Numeric overrides the user actually filled in (empty inputs are skipped). */
+			const testFields = () => {
+				const fields = {};
+				for (const [key, raw] of Object.entries(mockFields)) {
+					const text = raw.trim();
+					if (text === "") continue;
+					const value = Number(text);
+					if (Number.isFinite(value)) fields[key] = value;
+				}
+				return Object.keys(fields).length > 0 ? fields : void 0;
+			};
 			const runTest = async (execute) => {
 				const result = await postTest({
 					event,
 					reason: event === "turn/end" && reason !== "" ? reason : void 0,
 					tool: tool !== "" ? tool : void 0,
+					fields: testFields(),
 					execute
 				});
 				setTestResult(result);
 				if (execute) refresh();
 			};
+			/** Download the filtered timeline as JSONL (same shape as the on-disk log). */
+			const exportHistory = () => {
+				const records = visibleHistory ?? [];
+				if (records.length === 0) return;
+				const name = historyExportName();
+				const blob = new Blob([historyToJsonl(records)], { type: "application/x-ndjson" });
+				const url = URL.createObjectURL(blob);
+				try {
+					const anchor = document.createElement("a");
+					anchor.href = url;
+					anchor.download = name;
+					anchor.click();
+				} finally {
+					setTimeout(() => URL.revokeObjectURL(url), 0);
+				}
+			};
 			const sendNotifyTest = async () => {
 				setNotifyResult(null);
 				const result = await postNotifyTest(notifyChannel, notifyUrl.trim() || void 0, notifySlack);
@@ -699,6 +795,46 @@ window.__ModuleLoader__.load({
 									})
 								]
 							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dh-test-row",
+								children: [
+									[
+										"runningSubagents",
+										"runningSubagents",
+										"0"
+									],
+									[
+										"durationMs",
+										"durationMs",
+										"1200"
+									],
+									[
+										"usageInputTokens",
+										"usage 输入",
+										"120000"
+									],
+									[
+										"usageOutputTokens",
+										"usage 输出",
+										"45000"
+									]
+								].map(([key, label, placeholder]) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+									className: "dh-field",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+										className: "dh-field-label",
+										children: [label, "（可选）"]
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+										className: "dh-input",
+										value: mockFields[key],
+										inputMode: "numeric",
+										onChange: (e) => setMockFields((current) => ({
+											...current,
+											[key]: e.target.value
+										})),
+										placeholder
+									})]
+								}, key))
+							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: "dh-buttons",
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
@@ -1343,58 +1479,152 @@ window.__ModuleLoader__.load({
 							]
 						}, hook.index))
 					})] }),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-						className: "dh-section-head",
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("h3", {
-							className: "dh-section-title",
-							children: ["执行历史（最近 30 条）", status !== null && status.historyCount > 0 ? ` · ${status.historyCount} 条` : ""]
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-							type: "button",
-							className: "dh-button dh-toggle",
-							onClick: () => setHistoryOpen(!historyOpen),
-							"aria-expanded": historyOpen,
-							children: historyOpen ? "收起 ▲" : "展开 ▼"
-						})]
-					}), historyOpen && (history === null || history.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "dh-empty",
-						children: history === null ? "加载中…" : "暂无记录"
-					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "dh-timeline",
-						children: [...history].reverse().map((record, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-							className: "dh-record",
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: "dh-record-main",
-								children: [
-									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-										className: "dh-record-top",
-										children: [
-											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-												className: "dh-record-time",
-												children: formatTime(record.ts)
-											}),
-											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-												className: "dh-record-event",
-												children: record.event
-											}),
-											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-												className: `dh-outcome ${outcomeClass(record.outcome)}`,
-												children: outcomeLabel(record.outcome)
-											})
-										]
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-										className: "dh-record-command",
-										title: record.command,
-										children: record.command
-									}),
-									record.error !== void 0 && record.error !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-										className: "dh-record-error",
-										children: record.error.slice(0, 200)
-									})
-								]
-							})
-						}, `${record.ts}-${index}`))
-					}))] })
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", { children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dh-section-head",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("h3", {
+								className: "dh-section-title",
+								children: ["执行历史（最近 30 条）", status !== null && status.historyCount > 0 ? ` · ${status.historyCount} 条` : ""]
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dh-button dh-toggle",
+								onClick: () => setHistoryOpen(!historyOpen),
+								"aria-expanded": historyOpen,
+								children: historyOpen ? "收起 ▲" : "展开 ▼"
+							})]
+						}),
+						historyOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dh-test-row dh-history-filters",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+									className: "dh-field",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dh-field-label",
+										children: "事件"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+										className: "dh-select",
+										value: historyFilter.event ?? "",
+										onChange: (e) => setHistoryFilter({ event: e.target.value }),
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+											value: "",
+											children: "全部"
+										}), EVENTS.map((name) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+											value: name,
+											children: name
+										}, name))]
+									})]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+									className: "dh-field",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dh-field-label",
+										children: "结果"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+										className: "dh-select",
+										value: historyFilter.outcome ?? "",
+										onChange: (e) => setHistoryFilter({ outcome: e.target.value }),
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+											value: "",
+											children: "全部"
+										}), HISTORY_OUTCOMES.map((name) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+											value: name,
+											children: outcomeLabel(name)
+										}, name))]
+									})]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+									className: "dh-field",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dh-field-label",
+										children: "会话（可选）"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+										className: "dh-input",
+										value: historyFilter.session ?? "",
+										onChange: (e) => setHistoryFilter({ session: e.target.value }),
+										placeholder: "id 或名称片段"
+									})]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "dh-buttons",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dh-button",
+										disabled: !historyFiltered,
+										onClick: () => setHistoryFilter({
+											event: "",
+											outcome: "",
+											session: ""
+										}),
+										children: "清空过滤"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dh-button",
+										disabled: (visibleHistory ?? []).length === 0,
+										onClick: exportHistory,
+										children: "导出 JSONL"
+									})]
+								})
+							]
+						}),
+						historyOpen && history !== null && history.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dh-history-count",
+							children: [
+								"显示 ",
+								visibleHistory?.length ?? 0,
+								" / 共 ",
+								history.length,
+								" 条（最近 200 条内）",
+								historyFiltered ? " · 已过滤" : ""
+							]
+						}),
+						historyOpen && (history === null || history.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dh-empty",
+							children: history === null ? "加载中…" : "暂无记录"
+						}) : (visibleHistory ?? []).length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dh-empty",
+							children: "没有符合过滤条件的记录"
+						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dh-timeline",
+							children: [...visibleHistory ?? []].reverse().map((record, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dh-record",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "dh-record-main",
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+											className: "dh-record-top",
+											children: [
+												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+													className: "dh-record-time",
+													children: formatTime(record.ts)
+												}),
+												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+													className: "dh-record-event",
+													children: record.event
+												}),
+												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+													className: `dh-outcome ${outcomeClass(record.outcome)}`,
+													children: outcomeLabel(record.outcome)
+												})
+											]
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+											className: "dh-record-command",
+											title: record.command,
+											children: record.command
+										}),
+										record.sessionName !== void 0 && record.sessionName !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+											className: "dh-record-session",
+											children: record.sessionName
+										}),
+										record.error !== void 0 && record.error !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+											className: "dh-record-error",
+											children: record.error.slice(0, 200)
+										})
+									]
+								})
+							}, `${record.ts}-${index}`))
+						}))
+					] })
 				]
 			});
 		}
@@ -1413,7 +1643,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/settings-card.module.css?inline
-		var settings_card_module_default = ":root {\n  --dsh-hooks-border: #80849038;\n  --dsh-hooks-muted: #767c85;\n  --dsh-hooks-accent: #4d8df7;\n  --dsh-hooks-ok: #3fb56b;\n  --dsh-hooks-bad: #e5534b;\n  --dsh-hooks-warn: #d9a13c;\n}\n\n.dh-card {\n  flex-direction: column;\n  gap: 14px;\n  padding: 12px 4px;\n  font-size: 13px;\n  line-height: 1.5;\n  display: flex;\n}\n\n.dh-card-head {\n  align-items: center;\n  gap: 10px;\n  display: flex;\n}\n\n.dh-card-title {\n  font-size: 14px;\n  font-weight: 600;\n}\n\n.dh-badges {\n  gap: 6px;\n  display: flex;\n}\n\n.dh-badge {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  background: #80849029;\n  border-radius: 9px;\n  padding: 1px 7px;\n  font-size: 11px;\n}\n\n.dh-section-title {\n  color: var(--dsh-hooks-muted);\n  text-transform: uppercase;\n  letter-spacing: .04em;\n  margin: 0 0 8px;\n  font-size: 12px;\n  font-weight: 600;\n}\n\n.dh-section-head {\n  justify-content: space-between;\n  align-items: center;\n  gap: 8px;\n  margin: 0 0 8px;\n  display: flex;\n}\n\n.dh-section-head .dh-section-title {\n  margin: 0;\n}\n\n.dh-toggle {\n  padding: 2px 10px;\n  font-size: 11px;\n}\n\n.dh-field-narrow {\n  flex: 0 0 150px;\n}\n\n.dh-feishu-row {\n  align-items: flex-end;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-timeline {\n  flex-direction: column;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-record {\n  border: 1px solid var(--dsh-hooks-border);\n  border-radius: 6px;\n  gap: 8px;\n  padding: 7px 9px;\n  display: flex;\n}\n\n.dh-record-main {\n  flex: 1;\n  min-width: 0;\n}\n\n.dh-record-top {\n  align-items: baseline;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-record-time {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  font-size: 11px;\n}\n\n.dh-record-event {\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  font-weight: 600;\n  overflow: hidden;\n}\n\n.dh-record-command {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  text-align: left;\n  direction: rtl;\n  font-size: 12px;\n  overflow: hidden;\n}\n\n.dh-outcome {\n  white-space: nowrap;\n  border-radius: 9px;\n  align-self: flex-start;\n  padding: 1px 7px;\n  font-size: 11px;\n}\n\n.dh-outcome-ok {\n  color: var(--dsh-hooks-ok);\n  background: #3fb56b29;\n}\n\n.dh-outcome-bad {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b29;\n}\n\n.dh-outcome-warn {\n  color: var(--dsh-hooks-warn);\n  background: #d9a13c29;\n}\n\n.dh-outcome-neutral {\n  color: var(--dsh-hooks-muted);\n  background: #80849029;\n}\n\n.dh-record-error {\n  color: var(--dsh-hooks-bad);\n  white-space: pre-wrap;\n  word-break: break-all;\n  margin-top: 4px;\n  font-size: 11px;\n}\n\n.dh-empty {\n  color: var(--dsh-hooks-muted);\n  padding: 6px 2px;\n  font-size: 12px;\n}\n\n.dh-test-form {\n  flex-direction: column;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-test-row {\n  gap: 8px;\n  display: flex;\n}\n\n.dh-field {\n  flex-direction: column;\n  flex: 1;\n  gap: 3px;\n  min-width: 0;\n  display: flex;\n}\n\n.dh-field-label {\n  color: var(--dsh-hooks-muted);\n  font-size: 11px;\n}\n\n.dh-input, .dh-select {\n  border: 1px solid var(--dsh-hooks-border);\n  color: inherit;\n  box-sizing: border-box;\n  background: #8084901f;\n  border-radius: 5px;\n  outline: none;\n  width: 100%;\n  padding: 5px 8px;\n  font-size: 12px;\n}\n\nbody[data-ds-dark-theme] .dh-select {\n  color-scheme: dark;\n}\n\n.dh-select option {\n  background-color: var(--dsw-specific-menu, transparent);\n  color: inherit;\n}\n\n.dh-input:focus, .dh-select:focus {\n  border-color: var(--dsh-hooks-accent);\n}\n\n.dh-buttons {\n  gap: 8px;\n  display: flex;\n}\n\n.dh-button {\n  border: 1px solid var(--dsh-hooks-border);\n  color: inherit;\n  cursor: pointer;\n  background: #8084901f;\n  border-radius: 5px;\n  padding: 5px 12px;\n  font-size: 12px;\n}\n\n.dh-button:hover {\n  background: #80849038;\n}\n\n.dh-button-primary {\n  background: var(--dsh-hooks-accent);\n  border-color: var(--dsh-hooks-accent);\n  color: #fff;\n}\n\n.dh-button-primary:hover {\n  background: #3c7de8;\n}\n\n.dh-test-results {\n  flex-direction: column;\n  gap: 4px;\n  display: flex;\n}\n\n.dh-test-line {\n  word-break: break-all;\n  border-radius: 5px;\n  padding: 4px 8px;\n  font-size: 12px;\n}\n\n.dh-test-line-match {\n  color: var(--dsh-hooks-ok);\n  background: #3fb56b24;\n}\n\n.dh-test-line-skip {\n  color: var(--dsh-hooks-muted);\n  background: #8084901a;\n}\n\n.dh-error-banner {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b1f;\n  border: 1px solid #e5534b66;\n  border-radius: 6px;\n  padding: 8px 10px;\n  font-size: 12px;\n}\n\n.dh-feishu {\n  flex-direction: column;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-feishu-form, .dh-feishu-status, .dh-feishu-qr {\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-feishu-qr-img {\n  border: 1px solid var(--dsh-hooks-border);\n  box-sizing: border-box;\n  background: #fff;\n  border-radius: 8px;\n  width: 220px;\n  height: 220px;\n  padding: 6px;\n}\n\n.dh-feishu-line {\n  font-size: 12px;\n}\n\n.dh-feishu-ok {\n  color: var(--dsh-hooks-ok);\n}\n\n.dh-feishu-error {\n  color: var(--dsh-hooks-bad);\n  word-break: break-all;\n  font-size: 12px;\n}\n\n.dh-feishu-hint {\n  color: var(--dsh-hooks-muted);\n  font-size: 11px;\n}\n\n.dh-feishu-link {\n  color: var(--dsh-hooks-accent);\n  font-size: 12px;\n}\n\n.dh-badge-bad {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b29;\n}\n\n.dh-error-retry {\n  flex-shrink: 0;\n  margin-left: 8px;\n  padding: 2px 10px;\n  font-size: 11px;\n}\n\n.dh-check {\n  color: var(--dsh-hooks-muted);\n  align-items: center;\n  gap: 6px;\n  font-size: 12px;\n  display: flex;\n}\n\n.dh-button-small {\n  padding: 2px 8px;\n  font-size: 11px;\n}\n\n.dh-button-danger {\n  color: var(--dsh-hooks-bad);\n  border-color: #e5534b80;\n}\n\n.dh-button-danger:hover {\n  background: #e5534b24;\n}\n\n.dh-hook-list, .dh-hook-editor {\n  flex-direction: column;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-hook {\n  border: 1px solid var(--dsh-hooks-border);\n  border-radius: 6px;\n  flex-direction: column;\n  gap: 4px;\n  padding: 7px 9px;\n  display: flex;\n}\n\n.dh-hook-editing {\n  border-color: #4d8df766;\n  gap: 8px;\n  padding: 9px;\n}\n\n.dh-hook-head {\n  align-items: baseline;\n  gap: 8px;\n  min-width: 0;\n  display: flex;\n}\n\n.dh-hook-event {\n  white-space: nowrap;\n  font-size: 12px;\n  font-weight: 600;\n}\n\n.dh-hook-action {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  text-align: left;\n  direction: rtl;\n  flex: 1;\n  min-width: 0;\n  font-size: 12px;\n  overflow: hidden;\n}\n\n.dh-hook-match {\n  color: var(--dsh-hooks-accent);\n  word-break: break-all;\n  font-size: 11px;\n}\n\n.dh-hook-meta {\n  align-items: center;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-match-key {\n  flex: 0 0 130px;\n}\n\n.dh-feishu-preview {\n  color: var(--dsh-hooks-muted);\n  border-left: 2px solid var(--dsh-hooks-border);\n  word-break: break-all;\n  max-height: 120px;\n  padding: 4px 8px;\n  font-size: 11px;\n  overflow: hidden;\n}\n";
+		var settings_card_module_default = ":root {\n  --dsh-hooks-border: #80849038;\n  --dsh-hooks-muted: #767c85;\n  --dsh-hooks-accent: #4d8df7;\n  --dsh-hooks-ok: #3fb56b;\n  --dsh-hooks-bad: #e5534b;\n  --dsh-hooks-warn: #d9a13c;\n}\n\n.dh-card {\n  flex-direction: column;\n  gap: 14px;\n  padding: 12px 4px;\n  font-size: 13px;\n  line-height: 1.5;\n  display: flex;\n}\n\n.dh-card-head {\n  align-items: center;\n  gap: 10px;\n  display: flex;\n}\n\n.dh-card-title {\n  font-size: 14px;\n  font-weight: 600;\n}\n\n.dh-badges {\n  gap: 6px;\n  display: flex;\n}\n\n.dh-badge {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  background: #80849029;\n  border-radius: 9px;\n  padding: 1px 7px;\n  font-size: 11px;\n}\n\n.dh-section-title {\n  color: var(--dsh-hooks-muted);\n  text-transform: uppercase;\n  letter-spacing: .04em;\n  margin: 0 0 8px;\n  font-size: 12px;\n  font-weight: 600;\n}\n\n.dh-section-head {\n  justify-content: space-between;\n  align-items: center;\n  gap: 8px;\n  margin: 0 0 8px;\n  display: flex;\n}\n\n.dh-section-head .dh-section-title {\n  margin: 0;\n}\n\n.dh-toggle {\n  padding: 2px 10px;\n  font-size: 11px;\n}\n\n.dh-field-narrow {\n  flex: 0 0 150px;\n}\n\n.dh-feishu-row {\n  align-items: flex-end;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-timeline {\n  flex-direction: column;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-record {\n  border: 1px solid var(--dsh-hooks-border);\n  border-radius: 6px;\n  gap: 8px;\n  padding: 7px 9px;\n  display: flex;\n}\n\n.dh-record-main {\n  flex: 1;\n  min-width: 0;\n}\n\n.dh-record-top {\n  align-items: baseline;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-record-time {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  font-size: 11px;\n}\n\n.dh-record-event {\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  font-weight: 600;\n  overflow: hidden;\n}\n\n.dh-record-command {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  text-align: left;\n  direction: rtl;\n  font-size: 12px;\n  overflow: hidden;\n}\n\n.dh-outcome {\n  white-space: nowrap;\n  border-radius: 9px;\n  align-self: flex-start;\n  padding: 1px 7px;\n  font-size: 11px;\n}\n\n.dh-outcome-ok {\n  color: var(--dsh-hooks-ok);\n  background: #3fb56b29;\n}\n\n.dh-outcome-bad {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b29;\n}\n\n.dh-outcome-warn {\n  color: var(--dsh-hooks-warn);\n  background: #d9a13c29;\n}\n\n.dh-outcome-neutral {\n  color: var(--dsh-hooks-muted);\n  background: #80849029;\n}\n\n.dh-record-error {\n  color: var(--dsh-hooks-bad);\n  white-space: pre-wrap;\n  word-break: break-all;\n  margin-top: 4px;\n  font-size: 11px;\n}\n\n.dh-empty {\n  color: var(--dsh-hooks-muted);\n  padding: 6px 2px;\n  font-size: 12px;\n}\n\n.dh-history-filters {\n  flex-wrap: wrap;\n  align-items: flex-end;\n  margin-bottom: 6px;\n}\n\n.dh-history-filters .dh-buttons {\n  flex: none;\n}\n\n.dh-history-count {\n  color: var(--dsh-hooks-muted);\n  padding: 0 2px 6px;\n  font-size: 11px;\n}\n\n.dh-record-session {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  font-size: 11px;\n  overflow: hidden;\n}\n\n.dh-test-form {\n  flex-direction: column;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-test-row {\n  gap: 8px;\n  display: flex;\n}\n\n.dh-field {\n  flex-direction: column;\n  flex: 1;\n  gap: 3px;\n  min-width: 0;\n  display: flex;\n}\n\n.dh-field-label {\n  color: var(--dsh-hooks-muted);\n  font-size: 11px;\n}\n\n.dh-input, .dh-select {\n  border: 1px solid var(--dsh-hooks-border);\n  color: inherit;\n  box-sizing: border-box;\n  background: #8084901f;\n  border-radius: 5px;\n  outline: none;\n  width: 100%;\n  padding: 5px 8px;\n  font-size: 12px;\n}\n\nbody[data-ds-dark-theme] .dh-select {\n  color-scheme: dark;\n}\n\n.dh-select option {\n  background-color: var(--dsw-specific-menu, transparent);\n  color: inherit;\n}\n\n.dh-input:focus, .dh-select:focus {\n  border-color: var(--dsh-hooks-accent);\n}\n\n.dh-buttons {\n  gap: 8px;\n  display: flex;\n}\n\n.dh-button {\n  border: 1px solid var(--dsh-hooks-border);\n  color: inherit;\n  cursor: pointer;\n  background: #8084901f;\n  border-radius: 5px;\n  padding: 5px 12px;\n  font-size: 12px;\n}\n\n.dh-button:hover {\n  background: #80849038;\n}\n\n.dh-button-primary {\n  background: var(--dsh-hooks-accent);\n  border-color: var(--dsh-hooks-accent);\n  color: #fff;\n}\n\n.dh-button-primary:hover {\n  background: #3c7de8;\n}\n\n.dh-test-results {\n  flex-direction: column;\n  gap: 4px;\n  display: flex;\n}\n\n.dh-test-line {\n  word-break: break-all;\n  border-radius: 5px;\n  padding: 4px 8px;\n  font-size: 12px;\n}\n\n.dh-test-line-match {\n  color: var(--dsh-hooks-ok);\n  background: #3fb56b24;\n}\n\n.dh-test-line-skip {\n  color: var(--dsh-hooks-muted);\n  background: #8084901a;\n}\n\n.dh-error-banner {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b1f;\n  border: 1px solid #e5534b66;\n  border-radius: 6px;\n  padding: 8px 10px;\n  font-size: 12px;\n}\n\n.dh-feishu {\n  flex-direction: column;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-feishu-form, .dh-feishu-status, .dh-feishu-qr {\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-feishu-qr-img {\n  border: 1px solid var(--dsh-hooks-border);\n  box-sizing: border-box;\n  background: #fff;\n  border-radius: 8px;\n  width: 220px;\n  height: 220px;\n  padding: 6px;\n}\n\n.dh-feishu-line {\n  font-size: 12px;\n}\n\n.dh-feishu-ok {\n  color: var(--dsh-hooks-ok);\n}\n\n.dh-feishu-error {\n  color: var(--dsh-hooks-bad);\n  word-break: break-all;\n  font-size: 12px;\n}\n\n.dh-feishu-hint {\n  color: var(--dsh-hooks-muted);\n  font-size: 11px;\n}\n\n.dh-feishu-link {\n  color: var(--dsh-hooks-accent);\n  font-size: 12px;\n}\n\n.dh-badge-bad {\n  color: var(--dsh-hooks-bad);\n  background: #e5534b29;\n}\n\n.dh-error-retry {\n  flex-shrink: 0;\n  margin-left: 8px;\n  padding: 2px 10px;\n  font-size: 11px;\n}\n\n.dh-check {\n  color: var(--dsh-hooks-muted);\n  align-items: center;\n  gap: 6px;\n  font-size: 12px;\n  display: flex;\n}\n\n.dh-button-small {\n  padding: 2px 8px;\n  font-size: 11px;\n}\n\n.dh-button-danger {\n  color: var(--dsh-hooks-bad);\n  border-color: #e5534b80;\n}\n\n.dh-button-danger:hover {\n  background: #e5534b24;\n}\n\n.dh-hook-list, .dh-hook-editor {\n  flex-direction: column;\n  gap: 6px;\n  display: flex;\n}\n\n.dh-hook {\n  border: 1px solid var(--dsh-hooks-border);\n  border-radius: 6px;\n  flex-direction: column;\n  gap: 4px;\n  padding: 7px 9px;\n  display: flex;\n}\n\n.dh-hook-editing {\n  border-color: #4d8df766;\n  gap: 8px;\n  padding: 9px;\n}\n\n.dh-hook-head {\n  align-items: baseline;\n  gap: 8px;\n  min-width: 0;\n  display: flex;\n}\n\n.dh-hook-event {\n  white-space: nowrap;\n  font-size: 12px;\n  font-weight: 600;\n}\n\n.dh-hook-action {\n  color: var(--dsh-hooks-muted);\n  white-space: nowrap;\n  text-overflow: ellipsis;\n  text-align: left;\n  direction: rtl;\n  flex: 1;\n  min-width: 0;\n  font-size: 12px;\n  overflow: hidden;\n}\n\n.dh-hook-match {\n  color: var(--dsh-hooks-accent);\n  word-break: break-all;\n  font-size: 11px;\n}\n\n.dh-hook-meta {\n  align-items: center;\n  gap: 8px;\n  display: flex;\n}\n\n.dh-match-key {\n  flex: 0 0 130px;\n}\n\n.dh-feishu-preview {\n  color: var(--dsh-hooks-muted);\n  border-left: 2px solid var(--dsh-hooks-border);\n  word-break: break-all;\n  max-height: 120px;\n  padding: 4px 8px;\n  font-size: 11px;\n  overflow: hidden;\n}\n";
 		//#endregion
 		//#region src/client/index.ts
 		const name = "dsh-hooks";

package/lib/config.d.ts

@@ -1,5 +1,5 @@
 /** Hookable event kinds. v1 is emit-only: no waterfall/interception events. */
-export declare const HOOK_EVENTS: readonly ['turn/start', 'turn/end', 'tree/settled', 'step/end', 'tool/call', 'tool/result', 'user/message', 'approval/asked', 'approval/decided', 'session/title', 'session/created', 'session/disposed', 'agent/created', 'agent/disposed', 'agent/error', 'agent/status', 'hook/failed'];
+export declare const HOOK_EVENTS: readonly ['turn/start', 'turn/end', 'tree/settled', 'step/end', 'tool/call', 'tool/result', 'user/message', 'approval/asked', 'approval/decided', 'session/title', 'session/created', 'session/disposed', 'agent/created', 'agent/disposed', 'agent/error', 'agent/status', 'hook/failed', 'usage/daily'];
 export type HookEvent = (typeof HOOK_EVENTS)[number];
 /** `turn/end` reason kinds (from @deepseek-ai/dsh-session TurnEndReasonMap). */
 export declare const TURN_END_REASONS: readonly ['completed', 'error', 'aborted', 'blocked', 'max-tokens', 'interrupted'];
@@ -65,8 +65,10 @@ export interface HookSpec {
     /** Per-hook timeout in milliseconds. Defaults to 10000. */
     timeoutMs?: number;
     /**
-     * Retry count for non-zero exit codes (default 0: fire-and-forget,
-     * never retried). Spawn failures and timeouts are never retried.
+     * Retry count for retryable failures (default 0: fire-and-forget, never
+     * retried). `run`: non-zero exit codes only — spawn failures and timeouts
+     * are never retried. `notify` (webhook): transport failures and HTTP
+     * 408/429/5xx; the desktop channel never retries.
      */
     retries?: number;
     /** Base delay between retries in milliseconds; doubles per attempt. Defaults to 500. */

package/lib/config.js

@@ -18,6 +18,7 @@ export const HOOK_EVENTS = [
     'agent/error',
     'agent/status',
     'hook/failed',
+    'usage/daily',
 ];
 /** `turn/end` reason kinds (from @deepseek-ai/dsh-session TurnEndReasonMap). */
 export const TURN_END_REASONS = [
@@ -34,7 +35,7 @@ export const TURN_END_REASONS = [
 // declaration self-contained.
 export const Config = Schema.object({
     hooks: Schema.array(Schema.object({
-        on: Schema.union([...HOOK_EVENTS]).description('触发事件：turn/start | turn/end | tree/settled | step/end | tool/call | tool/result | user/message | approval/asked | approval/decided | session/title | session/created | session/disposed | agent/created | agent/disposed | agent/error | agent/status | hook/failed'),
+        on: Schema.union([...HOOK_EVENTS]).description('触发事件：turn/start | turn/end | tree/settled | step/end | tool/call | tool/result | user/message | approval/asked | approval/decided | session/title | session/created | session/disposed | agent/created | agent/disposed | agent/error | agent/status | hook/failed | usage/daily'),
         when: Schema.union([...TURN_END_REASONS]).description('可选过滤：对 turn/end 匹配结束原因（completed/error/aborted/blocked/max-tokens/interrupted）；其他事件忽略该字段'),
         match: Schema.dict(Schema.union([
             Schema.regExp(),
@@ -63,7 +64,7 @@ export const Config = Schema.object({
             .default('env')
             .description('上下文传递方式：env 只传 DSH_HOOK_* 环境变量（默认）；stdin 额外把完整上下文 JSON 写入命令标准输入'),
         timeoutMs: Schema.number().default(10000).description('单次执行超时（毫秒）'),
-        retries: Schema.natural().default(0).description('非零退出码的重试次数（默认 0 不重试；spawn 失败与超时不重试）'),
+        retries: Schema.natural().default(0).description('重试次数（默认 0 不重试）：run 重试非零退出码（spawn 失败与超时不重试）；notify 的 webhook 渠道重试传输失败与 HTTP 408/429/5xx（desktop 渠道不重试）'),
         retryDelayMs: Schema.natural().default(500).description('重试基础间隔（毫秒），每次翻倍'),
         enabled: Schema.boolean()
             .default(true)

package/lib/context.d.ts

@@ -35,7 +35,7 @@ export interface HookContext {
      * pairing tool/call was never seen, e.g. after a plugin restart).
      */
     toolDurationMs?: number;
-    /** Aggregated token usage of the turn (turn/end), when reported. */
+    /** Aggregated token usage of the turn (turn/end), or of the day (usage/daily). */
     usageInputTokens?: number;
     usageOutputTokens?: number;
     usageCacheReadTokens?: number;
@@ -69,6 +69,15 @@ export interface HookContext {
     hookFailedHook?: string;
     /** Consecutive failure count when the alert fired (hook/failed). */
     hookFailures?: number;
+    /**
+     * Local calendar day (`YYYY-MM-DD`) the token totals below cover
+     * (usage/daily only; turn/end carries a single turn, not a day).
+     */
+    usageDay?: string;
+    /** Turns with reported accounting that day (usage/daily). */
+    usageTurns?: number;
+    /** Distinct sessions that contributed usage that day (usage/daily). */
+    usageSessions?: number;
     timestamp: string;
 }
 export declare function toEnv(ctx: HookContext): Record<string, string>;

package/lib/context.js

@@ -71,6 +71,12 @@ export function toEnv(ctx) {
         env.DSH_HOOK_FAILED_HOOK = ctx.hookFailedHook;
     if (ctx.hookFailures !== undefined)
         env.DSH_HOOK_FAILURES = String(ctx.hookFailures);
+    if (ctx.usageDay !== undefined)
+        env.DSH_HOOK_USAGE_DAY = ctx.usageDay;
+    if (ctx.usageTurns !== undefined)
+        env.DSH_HOOK_USAGE_TURNS = String(ctx.usageTurns);
+    if (ctx.usageSessions !== undefined)
+        env.DSH_HOOK_USAGE_SESSIONS = String(ctx.usageSessions);
     return env;
 }
 /** Render `{{DSH_HOOK_*}}` placeholders from the context map. */

package/lib/dry-run.d.ts

@@ -13,6 +13,33 @@ export declare function loadHooks(profile: string, paths?: {
     hooks: HookSpec[];
     source: string;
 };
+/**
+ * Resolve the JSONL path a profile's dsh-hooks config writes history to
+ * (`config.history.path`, else the plugin default). Deliberately lenient:
+ * `tail` must keep working while the config file is missing or mid-edit.
+ */
+export declare function loadHistoryPath(profile: string, paths?: {
+    patchFile?: string;
+}): string;
+/**
+ * Numeric context fields a simulated event may override — the ones a `match`
+ * comparison can meaningfully target. Strings keep their dedicated CLI flag /
+ * tester input (`--tool`, `--session-name`, …) and the mock defaults.
+ */
+export declare const MOCK_NUMERIC_FIELDS: readonly ['turn', 'step', 'durationMs', 'toolDurationMs', 'runningSubagents', 'totalSubagents', 'treeDurationMs', 'usageTurns', 'usageSessions', 'usageInputTokens', 'usageOutputTokens', 'usageCacheReadTokens', 'usageCacheWriteTokens', 'usageReasoningTokens'];
+export type MockNumericField = (typeof MOCK_NUMERIC_FIELDS)[number];
+export interface MockFieldsResult {
+    ctx: HookContext;
+    /** Keys that were dropped: unknown field names or non-finite numbers. */
+    ignored: string[];
+}
+/**
+ * Apply explicit numeric overrides to a simulated context. Values must be
+ * finite numbers; anything else (unknown field, string, NaN) is reported in
+ * `ignored` instead of being silently coerced — a tester must never "pass"
+ * because a filter was fed the wrong type.
+ */
+export declare function applyMockFields(ctx: HookContext, fields: Record<string, unknown> | undefined): MockFieldsResult;
 /** A synthetic context for the simulated event, overridable per field. */
 export declare function mockContext(event: string, overrides?: Partial<HookContext>): HookContext;
 export interface DryRunLine {
@@ -34,6 +61,8 @@ export interface DryRunOptions {
     reason?: TurnEndReasonKind;
     tool?: string;
     sessionName?: string;
+    /** Explicit numeric context overrides (see {@link MOCK_NUMERIC_FIELDS}). */
+    fields?: Record<string, unknown>;
     /** Actually run the matching hooks (real side effects!). */
     execute?: boolean;
     print?: (line: string) => void;