dsh-click 0.3.24 → 0.3.26

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,6 +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",
+		"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),
@@ -423,6 +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 ?? "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;
@@ -451,6 +463,7 @@ function resolveConfig(config) {
 		maxHelperOutputBytes,
 		maxScreenshotSide,
 		staleCheckPixels,
+		staleCheckTree,
 		maxObservationAgeMs,
 		maxCachedObservations,
 		maxElements,
@@ -464,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
@@ -494,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;
@@ -508,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,
@@ -519,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()
 		};
@@ -542,8 +567,9 @@ var ObservationStore = class {
 	}
 	/**
 	* Compare a fresh re-observation against the cited record. The verdict is
-	* `ok` only when identity (window/pid/exe/title/class/rect), the tree hash,
-	* and — when `staleCheckPixels` is on — the pixel hash all still match, and
+	* `ok` only when identity (window/pid/exe/title/class/rect), the tree hash
+	* (unless `staleCheckTree: 'off'`), and — when `staleCheckPixels` is on — the
+	* pixel hash all still match, and
 	* the record is not older than `maxObservationAgeMs`.
 	*
 	* @param record - the observation the action cites.
@@ -551,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",
@@ -562,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 (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}`
@@ -575,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
@@ -586,11 +617,10 @@ var ObservationStore = class {
 * @module dsh-click/version
 */
 /** Plugin version advertised in the helper-protocol handshake. */
-const VERSION = "0.3.24";
+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`
@@ -874,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;
@@ -946,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.
 *
@@ -969,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
@@ -1115,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
@@ -1144,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.
@@ -1172,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 {
@@ -1528,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,
@@ -1853,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,
@@ -1912,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,
@@ -1981,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,
@@ -2209,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"];
@@ -2245,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

@@ -85,6 +85,14 @@ export interface Config {
     maxScreenshotSide?: number;
     /** Compare a fresh pixel hash before every action (default true; the stale-state boundary). */
     staleCheckPixels?: boolean;
+    /**
+     * 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' | '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). */
@@ -120,6 +128,8 @@ export interface ResolvedConfig {
     maxScreenshotSide: number;
     /** Whether the pixel-level stale check runs. */
     staleCheckPixels: boolean;
+    /** Whole-window tree-staleness policy. */
+    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":"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"}

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.
      *
@@ -62,8 +66,9 @@ export declare class ObservationStore {
     get(id: string): ObservationRecord | undefined;
     /**
      * Compare a fresh re-observation against the cited record. The verdict is
-     * `ok` only when identity (window/pid/exe/title/class/rect), the tree hash,
-     * and — when `staleCheckPixels` is on — the pixel hash all still match, and
+     * `ok` only when identity (window/pid/exe/title/class/rect), the tree hash
+     * (unless `staleCheckTree: 'off'`), and — when `staleCheckPixels` is on — the
+     * pixel hash all still match, and
      * the record is not older than `maxObservationAgeMs`.
      *
      * @param record - the observation the action cites.
@@ -71,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;;;;;;;;;;OAUG;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.24";
+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.24",
+  "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",
@@ -115,7 +115,7 @@
     "@deepseek-ai/dsh-subprocess": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0",
     "@deepseek-ai/dsh-tools": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0",
     "@deepseek-ai/dsh-user-approval": ">=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0",
-    "@deepseek-ai/schemastery": "^3.18.5-alpha.1"
+    "@deepseek-ai/schemastery": "^3.18.5"
   },
   "dependencies": {},
   "devDependencies": {
@@ -131,13 +131,13 @@
     "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.2",
     "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
     "@deepseek-ai/dsh-user-approval": "0.2.1-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.5-alpha.1",
-    "@types/node": "^22.19.0",
-    "@vitest/coverage-v8": "3.2.0",
+    "@deepseek-ai/schemastery": "^3.18.5",
+    "@types/node": "^22.20.5",
+    "@vitest/coverage-v8": "3.2.7",
     "oxlint": "0.18.1",
     "vitest": "^3.2.0",
     "@deepseek-ai/dsh-working-directory": "0.2.1-rc.2",
-    "tsdown": "^0.22.14",
+    "tsdown": "^0.23.2",
     "typescript": "^5.9.0"
   },
   "scripts": {