dsh-click 0.3.25 → 0.3.26

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.3.26] - 2026-10-27
+
+### Fixed
+
+- **Element-targeted actions now verify the target instead of the whole window (issue #29).** `screen_read` stores a per-element hash; `click`/`type`/`scroll` re-read the tree and allow the action when the addressed element is unchanged, even if an unrelated clock, cursor, spinner, or memory label moved the whole-tree hash. `staleCheckTree` gains `target` and becomes the default; `strict` preserves the old whole-window refusal, and `off` remains the explicit escape hatch. Screenshot-only observations and `key` fall back to the strict whole-tree check. Added unchanged-target and changed-target regression tests.
+
 ## [0.3.25] - 2026-10-26
 
 ### Added

package/README-es.md

@@ -183,7 +183,7 @@ Todos los ajustes son campos `Config` de Schemastery (modificables desde cordis.
 | `maxHelperOutputBytes` | `25165824` | Límite de una respuesta del helper en bytes (1024..67108864) |
 | `maxScreenshotSide` | `2560` | Lado más largo de la captura en píxeles (320..7680); las mayores se reducen |
 | `staleCheckPixels` | `true` | Comparar un hash de píxeles fresco antes de cada acción y rechazar si cambió |
-| `staleCheckTree` | `strict` | Frescura del árbol de toda la ventana: `strict` rechaza cualquier nodo cambiado; `off` omite el hash del árbol (escape para relojes/cursores; identidad/edad/píxeles siguen aplicando) |
+| `staleCheckTree` | `target` | Frescura del árbol: `target` verifica el elemento destino (por defecto), `strict` rechaza cualquier nodo cambiado, `off` omite el hash del árbol |
 | `maxObservationAgeMs` | `30000` | Antigüedad máxima en ms de una observación que una acción puede citar (1000..600000) |
 | `maxCachedObservations` | `8` | Límite LRU de observaciones en caché (1..64) |
 | `maxElements` | `500` | Límite de elementos de accesibilidad por `screen_read` (1..2000) |

package/README-hi.md

@@ -183,7 +183,7 @@ Error: dsh-click backend unavailable on linux: Linux backend is reserved but not
 | `maxHelperOutputBytes` | `25165824` | एक हेल्पर प्रतिक्रिया की बाइट सीमा (1024..67108864) |
 | `maxScreenshotSide` | `2560` | कैप्चर की सबसे लंबी भुजा पिक्सेल में (320..7680); बड़ी कैप्चर छोटी की जाती हैं |
 | `staleCheckPixels` | `true` | हर क्रिया से पहले ताज़ा पिक्सेल हैश मिलाएँ और बदलाव पर अस्वीकार करें |
-| `staleCheckTree` | `strict` | पूरी विंडो के ट्री की ताज़गी: `strict` किसी भी बदले नोड पर अस्वीकार करता है; `off` ट्री हैश छोड़ता है (घड़ी/कर्सर के लिए एस्केप; पहचान/आयु/पिक्सेल जाँच लागू रहती हैं) |
+| `staleCheckTree` | `target` | ट्री ताज़गी: `target` लक्ष्य तत्व जाँचता है (डिफ़ॉल्ट), `strict` किसी भी बदले नोड पर अस्वीकार, `off` ट्री हैश छोड़ता है |
 | `maxObservationAgeMs` | `30000` | किसी अवलोकन की अधिकतम आयु ms में जिसे कोई क्रिया उद्धृत कर सकती है (1000..600000) |
 | `maxCachedObservations` | `8` | कैश किए गए अवलोकनों की LRU सीमा (1..64) |
 | `maxElements` | `500` | प्रति `screen_read` एक्सेसिबिलिटी एलिमेंट की सीमा (1..2000) |

package/README-pt.md

@@ -183,7 +183,7 @@ Todos os ajustes são campos `Config` do Schemastery (alteráveis pelo cordis.ym
 | `maxHelperOutputBytes` | `25165824` | Limite de uma resposta do helper em bytes (1024..67108864) |
 | `maxScreenshotSide` | `2560` | Maior lado da captura em pixels (320..7680); capturas maiores são reduzidas |
 | `staleCheckPixels` | `true` | Comparar um hash de pixels novo antes de cada ação e recusar se mudou |
-| `staleCheckTree` | `strict` | Frescor da árvore de toda a janela: `strict` recusa qualquer nó alterado; `off` ignora o hash da árvore (escape para relógios/cursores; identidade/idade/pixels continuam valendo) |
+| `staleCheckTree` | `target` | Frescor da árvore: `target` verifica o elemento alvo (padrão), `strict` recusa qualquer nó alterado, `off` ignora o hash da árvore |
 | `maxObservationAgeMs` | `30000` | Idade máxima em ms de uma observação que uma ação pode citar (1000..600000) |
 | `maxCachedObservations` | `8` | Limite LRU de observações em cache (1..64) |
 | `maxElements` | `500` | Limite de elementos de acessibilidade por `screen_read` (1..2000) |

package/README-zh.md

@@ -183,7 +183,7 @@ Error: dsh-click backend unavailable on linux: Linux backend is reserved but not
 | `maxHelperOutputBytes` | `25165824` | 单次 helper 响应的字节上限（1024..67108864） |
 | `maxScreenshotSide` | `2560` | 截图最长边像素（320..7680）；超出即缩放 |
 | `staleCheckPixels` | `true` | 每次操作前对比新像素哈希，变化即拒绝 |
-| `staleCheckTree` | `strict` | 整窗控件树新鲜度：`strict` 任一节点变化即拒绝；`off` 跳过整树哈希（时钟/光标的逃生口；身份/年龄/像素检查仍生效） |
+| `staleCheckTree` | `target` | 控件树新鲜度：`target` 校验目标元素（默认），`strict` 任一节点变化即拒绝，`off` 跳过整树哈希（身份/年龄/像素检查仍生效） |
 | `maxObservationAgeMs` | `30000` | 操作可引用观察的最大时限（毫秒，1000..600000） |
 | `maxCachedObservations` | `8` | 观察缓存 LRU 上限（1..64） |
 | `maxElements` | `500` | 每次 `screen_read` 的无障碍元素上限（1..2000） |

package/README.md

@@ -183,7 +183,7 @@ All tunables are Schemastery `Config` fields (changeable from cordis.yml). An id
 | `maxHelperOutputBytes` | `25165824` | Cap on one helper response in bytes (1024..67108864) |
 | `maxScreenshotSide` | `2560` | Longest screenshot side in pixels (320..7680); larger captures are downscaled |
 | `staleCheckPixels` | `true` | Compare a fresh pixel hash before every action and refuse on change |
-| `staleCheckTree` | `strict` | Whole-window tree freshness: `strict` refuses any changed node; `off` skips the tree hash (escape hatch for clocks/cursors; identity/age/pixel checks still apply) |
+| `staleCheckTree` | `target` | Accessibility-tree freshness: `target` verifies the addressed element (default), `strict` refuses any changed node, `off` skips the tree hash (identity/age/pixel checks still apply) |
 | `maxObservationAgeMs` | `30000` | Maximum age in ms of an observation an action may cite (1000..600000) |
 | `maxCachedObservations` | `8` | LRU cap on cached observations (1..64) |
 | `maxElements` | `500` | Cap on accessibility elements per `screen_read` (1..2000) |

package/cordis.patch.yml

@@ -37,7 +37,7 @@
         # 'strict' refuses any changed tree node; 'off' skips the whole-tree
         # hash for windows with a ticking clock/cursor (identity/age/pixel
         # checks still apply).
-        staleCheckTree: strict
+        staleCheckTree: target
         # Maximum age in ms of an observation that an action may still base
         # on (1000..600000). Older observations are refused and must be
         # re-observed.

package/lib/index.js

@@ -7,7 +7,7 @@ import { fileURLToPath } from "node:url";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import { mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
-//#region src/events.ts
+// src/events.ts
 /** The observation audit event type. */
 const OBSERVED_EVENT = "dsh-click/observed";
 /** The action audit event type. */
@@ -36,8 +36,7 @@ function appendAuditEvent(session, type, data) {
 	else session.append(type, data);
 	return "appended";
 }
-//#endregion
-//#region src/sanitize.ts
+// src/sanitize.ts
 /**
 * Pure display/audit redaction for everything dsh-click shows to the model or
 * writes to a session log: window titles, executable paths, and free text that
@@ -104,8 +103,7 @@ function redactSensitive(text) {
 function sanitizeVisible(text, maxLength) {
 	return sanitizeText(redactSensitive(text), maxLength);
 }
-//#endregion
-//#region src/platform/types.ts
+// src/platform/types.ts
 /** Error with a stable machine-routing code, model-readable message included. */
 var DshClickError = class extends Error {
 	code;
@@ -146,8 +144,7 @@ function expectProcessFacts(value, op) {
 		executablePath
 	};
 }
-//#endregion
-//#region src/actions.ts
+// src/actions.ts
 /** Approval failure detail, model-readable. */
 const APPROVAL_DETAIL = {
 	rejected: "rejected by the approval answerer",
@@ -192,12 +189,21 @@ var ActionExecutor = class {
 	* @param signal - cancellation.
 	* @returns the cited record and the fresh snapshot.
 	*/
-	async requireFreshWindow(observationId, windowId, signal) {
+	async requireFreshWindow(observationId, windowId, signal, targetRef) {
 		const record = this.deps.observations.get(observationId);
 		if (record === void 0) throw new DshClickError(`unknown observation "${observationId}" — run screen_read or screen_shot again and cite the returned observationId`, "UNKNOWN_OBSERVATION");
 		if (record.windowId !== windowId) throw new DshClickError(`observation ${observationId} belongs to window ${record.windowId}, not ${windowId}`, "UNKNOWN_OBSERVATION");
-		const fresh = await this.deps.backend.snapshot(windowId, signal);
-		const verdict = this.deps.observations.verify(record, fresh);
+		let fresh = await this.deps.backend.snapshot(windowId, signal);
+		let targetElements;
+		if (targetRef !== void 0 && record.elementHashes !== void 0 && this.config.staleCheckTree === "target") {
+			const tree = await this.deps.backend.tree({ windowId }, this.config.maxElements, this.config.maxTreeDepth, false, signal);
+			fresh = tree.snapshot;
+			targetElements = tree.elements;
+		}
+		const verdict = this.deps.observations.verify(record, fresh, Date.now(), targetRef === void 0 ? void 0 : {
+			ref: targetRef,
+			elements: targetElements ?? []
+		});
 		if (!verdict.ok) throw new DshClickError(`${verdict.detail} — run screen_read or screen_shot again before acting`, verdict.code);
 		return {
 			record,
@@ -253,12 +259,12 @@ var ActionExecutor = class {
 	* @param run - the backend call (receives the resolved focus flag).
 	* @returns the validated backend outcome.
 	*/
-	async perform(toolName, exec, observationId, windowId, run) {
+	async perform(toolName, exec, observationId, windowId, run, targetRef) {
 		let approved = "none";
 		let observationIdAudited;
 		let windowIdAudited;
 		try {
-			const { record } = await this.requireFreshWindow(observationId, windowId, exec.signal);
+			const { record } = await this.requireFreshWindow(observationId, windowId, exec.signal, targetRef);
 			observationIdAudited = observationId;
 			windowIdAudited = windowId;
 			approved = await this.gate(exec, toolName, {
@@ -334,8 +340,7 @@ var ActionExecutor = class {
 		}
 	}
 };
-//#endregion
-//#region src/config.ts
+// src/config.ts
 /**
 * Plugin configuration and its explicit resolve step. `resolveConfig` re-judges
 * every default and bound so programmatic construction that bypasses
@@ -375,7 +380,11 @@ const Config = z.object({
 	maxHelperOutputBytes: z.number().min(1024).max(MAX_HELPER_OUTPUT_BYTES).default(DEFAULT_MAX_HELPER_OUTPUT_BYTES),
 	maxScreenshotSide: z.number().min(320).max(MAX_SCREENSHOT_SIDE).default(DEFAULT_MAX_SCREENSHOT_SIDE),
 	staleCheckPixels: z.boolean().default(true),
-	staleCheckTree: z.union(["strict", "off"]).default("strict"),
+	staleCheckTree: z.union([
+		"strict",
+		"target",
+		"off"
+	]).default("target"),
 	maxObservationAgeMs: z.number().min(MIN_OBSERVATION_AGE_MS).max(MAX_OBSERVATION_AGE_MS).default(DEFAULT_MAX_OBSERVATION_AGE_MS),
 	maxCachedObservations: z.number().min(1).max(64).default(8),
 	maxElements: z.number().min(1).max(MAX_ELEMENTS).default(500),
@@ -424,8 +433,8 @@ function resolveConfig(config) {
 	if (!Number.isInteger(maxScreenshotSide) || maxScreenshotSide < 320 || maxScreenshotSide > 7680) invalid("maxScreenshotSide", `must be an integer between 320 and ${MAX_SCREENSHOT_SIDE}`);
 	const staleCheckPixels = config?.staleCheckPixels ?? true;
 	if (typeof staleCheckPixels !== "boolean") invalid("staleCheckPixels", "must be a boolean");
-	const staleCheckTree = config?.staleCheckTree ?? "strict";
-	if (staleCheckTree !== "strict" && staleCheckTree !== "off") invalid("staleCheckTree", "must be \"strict\" or \"off\"");
+	const staleCheckTree = config?.staleCheckTree ?? "target";
+	if (staleCheckTree !== "strict" && staleCheckTree !== "target" && staleCheckTree !== "off") invalid("staleCheckTree", "must be \"strict\", \"target\", or \"off\"");
 	const maxObservationAgeMs = config?.maxObservationAgeMs ?? 3e4;
 	if (!Number.isFinite(maxObservationAgeMs) || maxObservationAgeMs < 1e3 || maxObservationAgeMs > 6e5) invalid("maxObservationAgeMs", `must be a finite number between ${MIN_OBSERVATION_AGE_MS} and ${MAX_OBSERVATION_AGE_MS}`);
 	const maxCachedObservations = config?.maxCachedObservations ?? 8;
@@ -468,8 +477,7 @@ function resolveConfig(config) {
 		})
 	});
 }
-//#endregion
-//#region src/observe.ts
+// src/observe.ts
 /**
 * Observation cache and the staleness boundary. Every observation stores the
 * window's identity facts plus content hashes; before any action the executor
@@ -498,6 +506,18 @@ function observationIdOf(snapshot) {
 	]);
 	return createHash("sha256").update(material).digest("hex").slice(0, 32);
 }
+/** Hash one captured element's identity-relevant fields. */
+function elementHashOf(element) {
+	return createHash("sha256").update(JSON.stringify([
+		element.elementId,
+		element.controlType,
+		element.name,
+		element.automationId,
+		element.rect,
+		element.enabled,
+		element.patterns
+	])).digest("hex");
+}
 /** Bounded LRU cache of observations, plus the staleness verdict logic. */
 var ObservationStore = class {
 	config;
@@ -512,7 +532,7 @@ var ObservationStore = class {
 	* @param snapshot - the snapshot facts it came from.
 	* @returns the stored record (id = hash of the state).
 	*/
-	record(snapshot) {
+	record(snapshot, elements) {
 		const record = {
 			id: observationIdOf(snapshot),
 			windowId: snapshot.windowId,
@@ -523,6 +543,7 @@ var ObservationStore = class {
 			rect: { ...snapshot.rect },
 			treeHash: snapshot.treeHash,
 			shotHash: snapshot.shotHash,
+			...elements === void 0 ? {} : { elementHashes: Object.fromEntries(elements.map((element) => [element.elementId, elementHashOf(element)])) },
 			elementCount: snapshot.elementCount,
 			observedAt: Date.now()
 		};
@@ -556,7 +577,7 @@ var ObservationStore = class {
 	* @param now - wall-clock now (injectable for tests).
 	* @returns the verdict.
 	*/
-	verify(record, fresh, now = Date.now()) {
+	verify(record, fresh, now = Date.now(), target) {
 		if (now - record.observedAt > this.config.maxObservationAgeMs) return {
 			ok: false,
 			code: "EXPIRED",
@@ -567,12 +588,18 @@ var ObservationStore = class {
 			code: "STALE_IDENTITY",
 			detail: `window ${record.windowId} no longer matches observation ${record.id} (title/class/process or rect changed)`
 		};
-		if (this.config.staleCheckTree !== "off" && fresh.treeHash !== record.treeHash) return {
-			ok: false,
-			code: "STALE_TREE",
-			detail: `the accessibility tree of window ${record.windowId} changed since observation ${record.id}`
-		};
-		if (this.config.staleCheckPixels && fresh.shotHash !== record.shotHash) return {
+		let scopedTargetUnchanged = false;
+		if (this.config.staleCheckTree !== "off" && fresh.treeHash !== record.treeHash) {
+			const expected = target === void 0 || record.elementHashes === void 0 ? void 0 : record.elementHashes[target.ref];
+			const current = target?.elements.find((element) => element.elementId === target.ref);
+			if (this.config.staleCheckTree === "target" && expected !== void 0 && current !== void 0 && elementHashOf(current) === expected) scopedTargetUnchanged = true;
+			else return {
+				ok: false,
+				code: "STALE_TREE",
+				detail: target === void 0 ? `the accessibility tree of window ${record.windowId} changed since observation ${record.id}` : `target element ${target.ref} changed or disappeared since observation ${record.id}`
+			};
+		}
+		if (!scopedTargetUnchanged && this.config.staleCheckPixels && fresh.shotHash !== record.shotHash) return {
 			ok: false,
 			code: "STALE_PIXELS",
 			detail: `the pixels of window ${record.windowId} changed since observation ${record.id}`
@@ -580,8 +607,7 @@ var ObservationStore = class {
 		return { ok: true };
 	}
 };
-//#endregion
-//#region src/version.ts
+// src/version.ts
 /**
 * The plugin version, hardcoded on purpose: it rides the helper-process
 * protocol handshake, so it must track `package.json` or released helpers
@@ -591,11 +617,10 @@ var ObservationStore = class {
 * @module dsh-click/version
 */
 /** Plugin version advertised in the helper-protocol handshake. */
-const VERSION = "0.3.25";
+const VERSION = "0.3.26";
 /** The helper protocol revision; bump only on incompatible wire changes. */
 const HELPER_PROTOCOL_VERSION = 1;
-//#endregion
-//#region src/platform/runner.ts
+// src/platform/runner.ts
 /**
 * The Windows backend: every operation spawns the native PowerShell helper
 * (`native/win32/dsh-click-helper.ps1`) through the harness's `ctx.subprocess`
@@ -879,8 +904,7 @@ var HelperBackend = class {
 		};
 	}
 };
-//#endregion
-//#region src/platform/selection.ts
+// src/platform/selection.ts
 /** A backend that cannot act: every operation fails closed with the given reason. */
 var UnavailableBackend = class {
 	platform;
@@ -951,8 +975,7 @@ function createBackend(ctx, config) {
 	}
 	return new UnavailableBackend(process.platform, RESERVED_BACKENDS[process.platform] ?? "unsupported platform");
 }
-//#endregion
-//#region src/vision.ts
+// src/vision.ts
 /**
 * Resolve whether the calling agent's current model declares image input.
 *
@@ -974,8 +997,7 @@ async function sessionAcceptsImages(agent, ctx, signal) {
 		return false;
 	}
 }
-//#endregion
-//#region src/vision/ocr.ts
+// src/vision/ocr.ts
 /**
 * Optical character recognition seam for windows without a UIA tree. OCR is
 * optional and probed at mount: the `tesseract` provider is used only when the
@@ -1120,8 +1142,7 @@ async function probeTesseract(subprocess, command, language) {
 		return new UnavailableOcrProvider("tesseract", `tesseract (${command}) is not installed`);
 	}
 }
-//#endregion
-//#region src/vision/grounding.ts
+// src/vision/grounding.ts
 /**
 * Visual grounding seam: turning a screenshot plus a natural-language prompt
 * into labeled bounding boxes. Kept as an independent provider so a vision
@@ -1149,8 +1170,7 @@ var UnavailableGroundingProvider = class {
 		return Promise.reject(new DshClickError(`visual grounding unavailable: ${this.reason}`, "GROUNDING_UNAVAILABLE"));
 	}
 };
-//#endregion
-//#region src/vision/index.ts
+// src/vision/index.ts
 /**
 * Map one screenshot box (possibly downscaled by `maxScreenshotSide`) to its
 * screen-space box, centering on the window's screen rect origin.
@@ -1177,8 +1197,7 @@ function centerOf(box) {
 		y: Math.round(box.y + box.height / 2)
 	};
 }
-//#endregion
-//#region src/tools.ts
+// src/tools.ts
 /** Sanitize one snapshot into the model-visible window value. */
 function observedWindow(snapshot, maxTextLength) {
 	return {
@@ -1533,7 +1552,7 @@ function screenReadTool(services) {
 			const parsed = args;
 			const tree = await backend.tree(parsed.target ?? {}, config.maxElements, config.maxTreeDepth, parsed.includePixels ?? true, exec.signal);
 			const sanitized = observedWindow(tree.snapshot, config.maxTextLength);
-			const record = observations.record(tree.snapshot);
+			const record = observations.record(tree.snapshot, tree.elements);
 			auditObservation(exec, {
 				observationId: record.id,
 				windowId: tree.snapshot.windowId,
@@ -1858,7 +1877,7 @@ function clickTool(services) {
 					y: target.y
 				},
 				button: parsed.button ?? "left"
-			}, focusFallback, exec.signal));
+			}, focusFallback, exec.signal), byElement ? target.elementId : void 0);
 			return {
 				ok: true,
 				windowId: outcome.windowId,
@@ -1917,7 +1936,7 @@ function typeTool(services) {
 				elementId: parsed.elementId,
 				text: parsed.text,
 				rollback: config.rollbackEnabled
-			}, focusFallback, exec.signal));
+			}, focusFallback, exec.signal), parsed.elementId);
 			return {
 				ok: true,
 				windowId: outcome.windowId,
@@ -1986,7 +2005,7 @@ function scrollTool(services) {
 				...parsed.elementId !== void 0 ? { elementId: parsed.elementId } : {},
 				direction: parsed.direction,
 				amount
-			}, focusFallback, exec.signal));
+			}, focusFallback, exec.signal), parsed.elementId);
 			return {
 				ok: true,
 				windowId: outcome.windowId,
@@ -2214,8 +2233,7 @@ function allTools(services) {
 		appLaunchTool(services)
 	];
 }
-//#endregion
-//#region src/index.ts
+// src/index.ts
 const name = "dsh-click";
 /** Hard services: the tool registry every contribution lands in, plus the subprocess runtime the Windows helper spawns through. */
 const inject = ["tools", "subprocess"];
@@ -2250,5 +2268,4 @@ async function apply(ctx, config) {
 	};
 	for (const tool of allTools(services)) ctx.effect(() => ctx.tools.register(tool), `dsh-click: ${tool.name} tool`);
 }
-//#endregion
 export { ACTION_EVENT, ActionExecutor, Config, DshClickError, HELPER_PROTOCOL_VERSION, HelperBackend, OBSERVED_EVENT, ObservationStore, TesseractOcrProvider, UnavailableBackend, UnavailableGroundingProvider, UnavailableOcrProvider, VERSION, allTools, apply, centerOf, createBackend, inject, name, observationIdOf, parseTesseractTsv, probeTesseract, redactSensitive, resolveConfig, sanitizePath, sanitizeText, sanitizeVisible, screenBoxFor, tesseractArgv };

package/lib/types/actions.d.ts

@@ -80,7 +80,7 @@ export declare class ActionExecutor {
      * @param run - the backend call (receives the resolved focus flag).
      * @returns the validated backend outcome.
      */
-    perform(toolName: string, exec: ToolRunContext, observationId: string, windowId: number, run: (focusFallback: boolean) => Promise<ActionOutcome>): Promise<ActionOutcome>;
+    perform(toolName: string, exec: ToolRunContext, observationId: string, windowId: number, run: (focusFallback: boolean) => Promise<ActionOutcome>, targetRef?: string): Promise<ActionOutcome>;
     /**
      * Gate and launch one application. No window observation exists yet, so the
      * gate runs against the requested name/path alone and the launch outcome's

package/lib/types/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,EAAE,gBAAgB,EAA0B,MAAM,cAAc,CAAA;AAEvE,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAuB,MAAM,qBAAqB,CAAA;AAErI,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAA;AAS5D,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAA;CACxC;AAED,yEAAyE;AACzE,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,+DAA+D;IAC/D,OAAO,CAAC,eAAe,CAAQ;IAC/B,2CAA2C;gBACd,IAAI,EAAE,kBAAkB;IAErD,4BAA4B;IAC5B,OAAO,KAAK,GAAG,GAEd;IAED,2BAA2B;IAC3B,OAAO,KAAK,MAAM,GAEjB;IAED,gFAAgF;IAChF,OAAO,CAAC,KAAK;IAkBb;;;;;;;;OAQG;YACW,kBAAkB;IAyBhC;;;;;;;;;;;OAWG;YACW,IAAI;IAuClB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;;;;;;;;;OAUG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,cAAc,EACpB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,CAAC,aAAa,EAAE,OAAO,KAAK,OAAO,CAAC,aAAa,CAAC,GACtD,OAAO,CAAC,aAAa,CAAC;IAwCzB;;;;;;;;;OASG;IACG,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAoBlG"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,EAAE,gBAAgB,EAA0B,MAAM,cAAc,CAAA;AAEvE,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAuB,MAAM,qBAAqB,CAAA;AAErI,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAA;AAS5D,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAA;CACxC;AAED,yEAAyE;AACzE,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,+DAA+D;IAC/D,OAAO,CAAC,eAAe,CAAQ;IAC/B,2CAA2C;gBACd,IAAI,EAAE,kBAAkB;IAErD,4BAA4B;IAC5B,OAAO,KAAK,GAAG,GAEd;IAED,2BAA2B;IAC3B,OAAO,KAAK,MAAM,GAEjB;IAED,gFAAgF;IAChF,OAAO,CAAC,KAAK;IAkBb;;;;;;;;OAQG;YACW,kBAAkB;IAiChC;;;;;;;;;;;OAWG;YACW,IAAI;IAuClB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;;;;;;;;;OAUG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,cAAc,EACpB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,CAAC,aAAa,EAAE,OAAO,KAAK,OAAO,CAAC,aAAa,CAAC,EACvD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC;IAwCzB;;;;;;;;;OASG;IACG,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAoBlG"}

package/lib/types/config.d.ts

@@ -86,13 +86,13 @@ export interface Config {
     /** Compare a fresh pixel hash before every action (default true; the stale-state boundary). */
     staleCheckPixels?: boolean;
     /**
-     * Whole-window accessibility-tree staleness policy. `strict` refuses an action when any
-     * node in the window changed; `off` skips the whole-tree hash while keeping identity,
-     * observation-age, and (unless disabled) pixel checks. `off` is the escape hatch for
-     * windows with a ticking clock/cursor; per-element scoped verification is the planned
-     * default replacement.
+     * Accessibility-tree staleness policy. `strict` refuses an action when any node in the
+     * window changed; `target` (default) lets `click`/`type`/`scroll` proceed when the
+     * addressed element itself is unchanged, even if an unrelated clock/cursor moved the
+     * whole-tree hash; `off` skips the tree hash entirely. Identity, observation-age, and
+     * (unless disabled) pixel checks still apply.
      */
-    staleCheckTree?: 'strict' | 'off';
+    staleCheckTree?: 'strict' | 'target' | 'off';
     /** Maximum age in ms of an observation that an action may still base on (default 30000). */
     maxObservationAgeMs?: number;
     /** Cap on cached observations (default 8). */
@@ -129,7 +129,7 @@ export interface ResolvedConfig {
     /** Whether the pixel-level stale check runs. */
     staleCheckPixels: boolean;
     /** Whole-window tree-staleness policy. */
-    staleCheckTree: 'strict' | 'off';
+    staleCheckTree: 'strict' | 'target' | 'off';
     /** Maximum observation age in milliseconds. */
     maxObservationAgeMs: number;
     /** Cap on cached observations. */

package/lib/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAA;AAEvC,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,CAAA;AAE7C,uDAAuD;AACvD,eAAO,MAAM,yBAAyB,QAAS,CAAA;AAE/C,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,SAAU,CAAA;AAE5C,sFAAsF;AACtF,eAAO,MAAM,+BAA+B,QAAmB,CAAA;AAE/D,sCAAsC;AACtC,eAAO,MAAM,uBAAuB,QAAmB,CAAA;AAEvD,2FAA2F;AAC3F,eAAO,MAAM,2BAA2B,OAAO,CAAA;AAE/C,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,MAAM,CAAA;AACtC,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAEvC,8EAA8E;AAC9E,eAAO,MAAM,8BAA8B,QAAS,CAAA;AAEpD,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,OAAQ,CAAA;AAC3C,eAAO,MAAM,sBAAsB,SAAU,CAAA;AAE7C,4EAA4E;AAC5E,eAAO,MAAM,+BAA+B,IAAI,CAAA;AAEhD,sCAAsC;AACtC,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAEzC,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAEvC,kCAAkC;AAClC,eAAO,MAAM,YAAY,OAAQ,CAAA;AAEjC,4DAA4D;AAC5D,eAAO,MAAM,sBAAsB,KAAK,CAAA;AAExC,iCAAiC;AACjC,eAAO,MAAM,cAAc,KAAK,CAAA;AAEhC,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C,qDAAqD;AACrD,eAAO,MAAM,eAAe,QAAS,CAAA;AAErC,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,cAAc,CAAA;AAE9C,sDAAsD;AACtD,eAAO,MAAM,oBAAoB,QAAQ,CAAA;AAEzC,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,MAAM;IACrB,oGAAoG;IACpG,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,sGAAsG;IACtG,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC7B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,8GAA8G;IAC9G,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,iGAAiG;IACjG,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAA;IAC5C,4FAA4F;IAC5F,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,8CAA8C;IAC9C,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,iEAAiE;IACjE,GAAG,CAAC,EAAE,SAAS,CAAA;CAChB;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,eAAe,EAAE,OAAO,CAAA;IACxB,qEAAqE;IACrE,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC1C,oEAAoE;IACpE,kBAAkB,EAAE,OAAO,CAAA;IAC3B,2CAA2C;IAC3C,aAAa,EAAE,aAAa,CAAA;IAC5B,8BAA8B;IAC9B,SAAS,EAAE,SAAS,CAAA;IACpB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAA;IACvB,2CAA2C;IAC3C,oBAAoB,EAAE,MAAM,CAAA;IAC5B,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAA;IACzB,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAA;IACzB,0CAA0C;IAC1C,cAAc,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAA;IAC3C,+CAA+C;IAC/C,mBAAmB,EAAE,MAAM,CAAA;IAC3B,kCAAkC;IAClC,qBAAqB,EAAE,MAAM,CAAA;IAC7B,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,eAAe,EAAE,OAAO,CAAA;IACxB,2CAA2C;IAC3C,GAAG,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7D;AAED,6DAA6D;AAC7D,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAsB3B,CAAA;AAgBF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAyFxE"}

package/lib/types/observe.d.ts

@@ -8,7 +8,7 @@
  * @module dsh-click/observe
  */
 import type { ResolvedConfig } from './config.js';
-import type { Rect, WindowSnapshot } from './platform/types.js';
+import type { ElementInfo, Rect, WindowSnapshot } from './platform/types.js';
 /** One cached observation, immutable after construction. */
 export interface ObservationRecord {
     /** Observation id (content hash). */
@@ -21,6 +21,8 @@ export interface ObservationRecord {
     rect: Rect;
     treeHash: string;
     shotHash: string;
+    /** Per-element hashes captured from a tree read (absent for screenshot-only observations). */
+    elementHashes?: Readonly<Record<string, string>>;
     elementCount: number;
     /** Wall-clock capture time in milliseconds. */
     observedAt: number;
@@ -40,6 +42,8 @@ export type FreshnessVerdict = {
  * @returns a hex observation id.
  */
 export declare function observationIdOf(snapshot: WindowSnapshot): string;
+/** Hash one captured element's identity-relevant fields. */
+export declare function elementHashOf(element: ElementInfo): string;
 /** Bounded LRU cache of observations, plus the staleness verdict logic. */
 export declare class ObservationStore {
     private readonly config;
@@ -52,7 +56,7 @@ export declare class ObservationStore {
      * @param snapshot - the snapshot facts it came from.
      * @returns the stored record (id = hash of the state).
      */
-    record(snapshot: WindowSnapshot): ObservationRecord;
+    record(snapshot: WindowSnapshot, elements?: readonly ElementInfo[]): ObservationRecord;
     /**
      * Look one observation up by id.
      *
@@ -72,6 +76,9 @@ export declare class ObservationStore {
      * @param now - wall-clock now (injectable for tests).
      * @returns the verdict.
      */
-    verify(record: ObservationRecord, fresh: WindowSnapshot, now?: number): FreshnessVerdict;
+    verify(record: ObservationRecord, fresh: WindowSnapshot, now?: number, target?: {
+        readonly ref: string;
+        readonly elements: readonly ElementInfo[];
+    }): FreshnessVerdict;
 }
 //# sourceMappingURL=observe.d.ts.map

package/lib/types/observe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/observe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAE/D,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wFAAwF;AACxF,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,qBAAqB,GAAG,SAAS,GAAG,gBAAgB,GAAG,YAAY,GAAG,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7H;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAYhE;AAED,2EAA2E;AAC3E,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D,wEAAwE;gBAC3C,MAAM,EAAE,cAAc;IAEnD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,iBAAiB;IAwBnD;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI9C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,GAAE,MAAmB,GAAG,gBAAgB;CAsCrG"}
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/observe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAE5E,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,8FAA8F;IAC9F,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAChD,YAAY,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wFAAwF;AACxF,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,qBAAqB,GAAG,SAAS,GAAG,gBAAgB,GAAG,YAAY,GAAG,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7H;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAYhE;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAU1D;AAED,2EAA2E;AAC3E,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D,wEAAwE;gBAC3C,MAAM,EAAE,cAAc;IAEnD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,GAAG,iBAAiB;IA2BtF;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI9C;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,cAAc,EACrB,GAAG,GAAE,MAAmB,EACxB,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;KAAE,GAC3E,gBAAgB;CAoDpB"}

package/lib/types/version.d.ts

@@ -7,7 +7,7 @@
  * @module dsh-click/version
  */
 /** Plugin version advertised in the helper-protocol handshake. */
-export declare const VERSION = "0.3.25";
+export declare const VERSION = "0.3.26";
 /** The helper protocol revision; bump only on incompatible wire changes. */
 export declare const HELPER_PROTOCOL_VERSION = 1;
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-click",
-  "version": "0.3.25",
+  "version": "0.3.26",
   "description": "Cross-platform native desktop control tools for DeepSeek Harness (Windows first): screen_shot, screen_read (accessibility tree + pixel description for text-only models), click/type/scroll/key, and app_list/app_launch — every mutating action gated by approval, never stealing foreground focus, with stale-observation rejection and process-identity checks",
   "repository": {
     "type": "git",
@@ -137,7 +137,7 @@
     "oxlint": "0.18.1",
     "vitest": "^3.2.0",
     "@deepseek-ai/dsh-working-directory": "0.2.1-rc.2",
-    "tsdown": "^0.23.1",
+    "tsdown": "^0.23.2",
     "typescript": "^5.9.0"
   },
   "scripts": {