dsh-click 0.1.4 → 0.3.0

package/lib/index.js

@@ -1,14 +1,35 @@
+import { KNOWN_SESSION_EVENT_TYPES } from "@deepseek-ai/dsh-session";
 import z from "@deepseek-ai/schemastery";
 import { createHash, randomUUID } from "node:crypto";
 import { existsSync } from "node:fs";
-import path from "node:path";
+import path, { join } from "node:path";
 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
 /** The observation audit event type. */
 const OBSERVED_EVENT = "dsh-click/observed";
 /** The action audit event type. */
 const ACTION_EVENT = "dsh-click/action";
+/**
+* Append one dsh-click audit event when the host can carry it safely; skip
+* silently otherwise (the tool/call + tool/result events remain the
+* model-visible log, so nothing model-visible is lost). See the module doc
+* for the three host classes.
+* @param session - the calling session.
+* @param type - the audit event type.
+* @param data - the audit payload.
+*/
+function appendAuditEvent(session, type, data) {
+	if (KNOWN_SESSION_EVENT_TYPES.has(type)) {
+		if (type === "dsh-click/observed") session.append(type, data);
+		else session.append(type, data);
+		return;
+	}
+	const append = session.append;
+	if (Function.prototype.toString.call(append).includes("ignorable")) append.call(session, type, data, { ignorable: true });
+}
 //#endregion
 //#region src/sanitize.ts
 /**
@@ -148,7 +169,7 @@ var ActionExecutor = class {
 		const session = exec.agent?.session;
 		if (session === void 0) return;
 		try {
-			session.append(ACTION_EVENT, event);
+			appendAuditEvent(session, ACTION_EVENT, event);
 		} catch {}
 	}
 	/**
@@ -348,7 +369,12 @@ const Config = z.object({
 	maxElements: z.number().min(1).max(MAX_ELEMENTS).default(500),
 	maxTreeDepth: z.number().min(1).max(64).default(32),
 	maxTextLength: z.number().min(16).max(MAX_TEXT_LENGTH).default(200),
-	rollbackEnabled: z.boolean().default(true)
+	rollbackEnabled: z.boolean().default(true),
+	ocr: z.object({
+		enabled: z.boolean().default(true),
+		command: z.string().min(1).max(256).default("tesseract"),
+		language: z.string().min(1).max(32).default("eng")
+	})
 });
 /** Throw the standard fail-loud config error for one invalid field. */
 function invalid(field, detail) {
@@ -398,6 +424,12 @@ function resolveConfig(config) {
 	if (!Number.isInteger(maxTextLength) || maxTextLength < 16 || maxTextLength > 1e4) invalid("maxTextLength", `must be an integer between 16 and ${MAX_TEXT_LENGTH}`);
 	const rollbackEnabled = config?.rollbackEnabled ?? true;
 	if (typeof rollbackEnabled !== "boolean") invalid("rollbackEnabled", "must be a boolean");
+	const ocrEnabled = config?.ocr?.enabled ?? true;
+	if (typeof ocrEnabled !== "boolean") invalid("ocr.enabled", "must be a boolean");
+	const ocrCommand = config?.ocr?.command ?? "tesseract";
+	if (typeof ocrCommand !== "string" || ocrCommand.length === 0 || ocrCommand.length > 256) invalid("ocr.command", "must be a non-empty string of at most 256 characters");
+	const ocrLanguage = config?.ocr?.language ?? "eng";
+	if (typeof ocrLanguage !== "string" || ocrLanguage.length === 0 || ocrLanguage.length > 32) invalid("ocr.language", "must be a non-empty string of at most 32 characters");
 	return Object.freeze({
 		requireApproval,
 		autoApproveMatchers: Object.freeze(autoApproveMatchers),
@@ -413,7 +445,12 @@ function resolveConfig(config) {
 		maxElements,
 		maxTreeDepth,
 		maxTextLength,
-		rollbackEnabled
+		rollbackEnabled,
+		ocr: Object.freeze({
+			enabled: ocrEnabled,
+			command: ocrCommand,
+			language: ocrLanguage
+		})
 	});
 }
 //#endregion
@@ -538,7 +575,7 @@ var ObservationStore = class {
 * @module dsh-click/version
 */
 /** Plugin version advertised in the helper-protocol handshake. */
-const VERSION = "0.1.4";
+const VERSION = "0.3.0";
 /** The helper protocol revision; bump only on incompatible wire changes. */
 const HELPER_PROTOCOL_VERSION = 1;
 //#endregion
@@ -922,6 +959,209 @@ async function sessionAcceptsImages(agent, ctx, signal) {
 	}
 }
 //#endregion
+//#region 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
+* binary resolves through the subprocess service, otherwise an unavailable
+* provider fails closed with a model-readable reason. Recognized words carry
+* their pixel boxes, which `screen_find` maps to screen coordinates for the
+* coordinate-based `click` path.
+*
+* @module dsh-click/vision/ocr
+*/
+/** Bytes cap for one tesseract TSV stdout. */
+const OCR_STDOUT_BYTES = 16777216;
+/**
+* Build the tesseract command line: write words as TSV to stdout.
+* @param command - tesseract executable.
+* @param imagePath - absolute PNG path.
+* @param language - tesseract language tag.
+* @returns the argv (argv[0] is the executable).
+*/
+function tesseractArgv(command, imagePath, language) {
+	return [
+		command,
+		imagePath,
+		"stdout",
+		"-l",
+		language,
+		"tsv"
+	];
+}
+/**
+* Parse tesseract TSV output into word boxes. Non-word rows, empty text, and
+* malformed numeric fields are skipped; a hostile or truncated stdout cannot
+* produce bogus coordinates.
+* @param tsv - tesseract TSV text from stdout.
+* @returns the recognized words.
+*/
+function parseTesseractTsv(tsv) {
+	const words = [];
+	for (const line of tsv.split(/\r?\n/u)) {
+		if (line === "" || line.startsWith("level")) continue;
+		const columns = line.split("	");
+		if (columns.length < 12 || columns[0] !== "5") continue;
+		const left = Number(columns[6]);
+		const top = Number(columns[7]);
+		const width = Number(columns[8]);
+		const height = Number(columns[9]);
+		const confidence = Number(columns[10]);
+		const text = columns[11] ?? "";
+		if (text.trim() === "") continue;
+		if (!Number.isFinite(left) || !Number.isFinite(top) || !Number.isFinite(width) || !Number.isFinite(height)) continue;
+		words.push({
+			text: text.trim(),
+			box: {
+				x: left,
+				y: top,
+				width,
+				height
+			},
+			confidence: Number.isFinite(confidence) ? confidence : 0
+		});
+	}
+	return words;
+}
+/** A provider that cannot run: `recognize` fails closed with the given reason. */
+var UnavailableOcrProvider = class {
+	id;
+	reason;
+	available = false;
+	/** @param id - provider id. @param reason - model-readable unavailability reason. */
+	constructor(id, reason) {
+		this.id = id;
+		this.reason = reason;
+	}
+	get unavailableReason() {
+		return this.reason;
+	}
+	recognize(_pngBase64, _signal) {
+		return Promise.reject(new DshClickError(`OCR unavailable: ${this.reason}`, "OCR_UNAVAILABLE"));
+	}
+};
+/** The tesseract OCR provider over `ctx.subprocess`. */
+var TesseractOcrProvider = class {
+	subprocess;
+	command;
+	language;
+	id = "tesseract";
+	available = true;
+	/**
+	* @param subprocess - the subprocess service that runs tesseract.
+	* @param command - tesseract executable name.
+	* @param language - tesseract language tag.
+	*/
+	constructor(subprocess, command, language) {
+		this.subprocess = subprocess;
+		this.command = command;
+		this.language = language;
+	}
+	async recognize(pngBase64, signal) {
+		const dir = await mkdtemp(join(tmpdir(), "dsh-click-ocr-"));
+		const imagePath = join(dir, "shot.png");
+		try {
+			await writeFile(imagePath, Buffer.from(pngBase64, "base64"));
+			const handle = this.subprocess.spawn({
+				argv: tesseractArgv(this.command, imagePath, this.language),
+				cwd: tmpdir(),
+				stdio: {
+					stdin: "ignore",
+					stdout: { maxBytes: OCR_STDOUT_BYTES },
+					stderr: { maxBytes: 65536 }
+				},
+				graceMs: 5e3,
+				...signal === void 0 ? {} : { signal }
+			});
+			const outcome = await handle.done;
+			const stdout = handle.collected.stdout?.readFrom(0).text ?? "";
+			const stderr = handle.collected.stderr?.readFrom(0).text ?? "";
+			if (outcome.exitCode !== 0) throw new DshClickError(`tesseract exited ${String(outcome.exitCode)}: ${sanitizeText(stderr, 500)}`, "OCR_FAILED");
+			return parseTesseractTsv(stdout);
+		} finally {
+			await rm(dir, {
+				recursive: true,
+				force: true
+			}).catch(() => {});
+		}
+	}
+};
+/**
+* Probe tesseract through the subprocess service and return a provider.
+* A missing binary degrades to an unavailable provider (fail closed), never a
+* crash, so the zero-dependency desktop path keeps working.
+*
+* @param subprocess - the subprocess service.
+* @param command - tesseract executable name.
+* @param language - tesseract language tag.
+* @returns the probed OCR provider.
+*/
+async function probeTesseract(subprocess, command, language) {
+	try {
+		await subprocess.resolveExecutable(command);
+		return new TesseractOcrProvider(subprocess, command, language);
+	} catch {
+		return new UnavailableOcrProvider("tesseract", `tesseract (${command}) is not installed`);
+	}
+}
+//#endregion
+//#region 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
+* model (or an external grounding service) can plug in later without touching
+* the desktop backend or the tool surface. The default is unavailable — the
+* OCR path (`screen_find`) already yields text targets, and a grounding
+* provider is optional and probed through the `dsh-click/grounding` seam.
+*
+* @module dsh-click/vision/grounding
+*/
+/** A provider that cannot run: `ground` fails closed with the given reason. */
+var UnavailableGroundingProvider = class {
+	id;
+	reason;
+	available = false;
+	/** @param id - provider id. @param reason - model-readable unavailability reason. */
+	constructor(id = "unavailable", reason = "no visual grounding provider configured") {
+		this.id = id;
+		this.reason = reason;
+	}
+	get unavailableReason() {
+		return this.reason;
+	}
+	ground(_pngBase64, _width, _height, _prompt, _signal) {
+		return Promise.reject(new DshClickError(`visual grounding unavailable: ${this.reason}`, "GROUNDING_UNAVAILABLE"));
+	}
+};
+//#endregion
+//#region 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.
+* @param rect - the window's screen rectangle.
+* @param imageWidth - screenshot width in pixels.
+* @param imageHeight - screenshot height in pixels.
+* @param box - the screenshot-space box.
+* @returns the screen-space box.
+*/
+function screenBoxFor(rect, imageWidth, imageHeight, box) {
+	const scaleX = rect.width > 0 && imageWidth > 0 ? rect.width / imageWidth : 1;
+	const scaleY = rect.height > 0 && imageHeight > 0 ? rect.height / imageHeight : 1;
+	return {
+		x: rect.x + box.x * scaleX,
+		y: rect.y + box.y * scaleY,
+		width: box.width * scaleX,
+		height: box.height * scaleY
+	};
+}
+/** Center point of a screen-space box (the coordinate `click` addresses). */
+function centerOf(box) {
+	return {
+		x: Math.round(box.x + box.width / 2),
+		y: Math.round(box.y + box.height / 2)
+	};
+}
+//#endregion
 //#region src/tools.ts
 /** Sanitize one snapshot into the model-visible window value. */
 function observedWindow(snapshot, maxTextLength) {
@@ -974,7 +1214,7 @@ function auditObservation(exec, event, auditSessionEvents = true) {
 	const session = exec.agent?.session;
 	if (session === void 0) return;
 	try {
-		session.append(OBSERVED_EVENT, event);
+		appendAuditEvent(session, OBSERVED_EVENT, event);
 	} catch {}
 }
 /** One-line window identity for render text. */
@@ -1291,6 +1531,177 @@ function screenReadTool(services) {
 		}
 	});
 }
+/**
+* `screen_find` — find clickable text/visual targets in a window whose
+* accessibility tree is empty (no UIA elements). It captures the window,
+* runs OCR (when the probed provider is available) and, when a grounding
+* provider is mounted and a query is given, visual grounding, then returns
+* screen-coordinate targets plus an observationId for the coordinate-based
+* `click` path. Read-only: never needs approval.
+*
+* @param services - runtime services.
+* @returns the tool definition.
+*/
+function screenFindTool(services) {
+	const { config, backend, observations, ocr, grounding } = services;
+	return defineTool({
+		name: "screen_find",
+		description: "Find clickable text (or a described visual target) in a desktop window that exposes no accessibility tree, via OCR and optional visual grounding. Returns screen-coordinate targets plus an observationId; later `click` calls address a target by its (x, y) coordinates and cite this observationId in `basedOn`. Read-only: never needs approval.",
+		parameters: {
+			target: {
+				type: "object",
+				description: "Which window to search (windowId, windowTitle, or processId); omitted = the foreground window.",
+				properties: {
+					windowId: {
+						type: "integer",
+						description: "Native window handle from app_list."
+					},
+					windowTitle: {
+						type: "string",
+						description: "Visible window title (matched case-insensitively by substring)."
+					},
+					processId: {
+						type: "integer",
+						description: "Owning process id."
+					}
+				},
+				additionalProperties: false
+			},
+			query: {
+				type: "string",
+				description: "Optional substring to filter OCR text by, or the visual target description for grounding."
+			},
+			maxSide: {
+				type: "integer",
+				description: "Longest side in pixels; larger captures are downscaled."
+			}
+		},
+		output: {
+			schema: {
+				type: "object",
+				properties: {
+					ok: {
+						type: "boolean",
+						const: true
+					},
+					observationId: { type: "string" },
+					window: {
+						type: "object",
+						properties: {
+							windowId: { type: "integer" },
+							processId: { type: "integer" },
+							title: { type: "string" },
+							className: { type: "string" },
+							executablePath: { oneOf: [{ type: "string" }, { type: "null" }] },
+							rect: {
+								type: "object",
+								properties: {
+									x: { type: "integer" },
+									y: { type: "integer" },
+									width: { type: "integer" },
+									height: { type: "integer" }
+								},
+								additionalProperties: false
+							},
+							foreground: { type: "boolean" }
+						},
+						additionalProperties: false
+					},
+					ocrAvailable: { type: "boolean" },
+					targets: {
+						type: "array",
+						items: {
+							type: "object",
+							properties: {
+								text: { type: "string" },
+								x: { type: "integer" },
+								y: { type: "integer" },
+								width: { type: "integer" },
+								height: { type: "integer" },
+								confidence: { type: "number" },
+								source: {
+									type: "string",
+									enum: ["ocr", "grounding"]
+								}
+							},
+							additionalProperties: false
+						}
+					}
+				},
+				additionalProperties: false
+			},
+			render(_args, value) {
+				const result = value;
+				const lines = [
+					`Text/visual targets in ${windowLine(result.window)}:`,
+					`observationId: ${result.observationId}`,
+					`OCR available: ${result.ocrAvailable}`,
+					`${result.targets.length} target(s):`
+				];
+				for (const target of result.targets) lines.push(`- ${JSON.stringify(target.text)} at (${target.x}, ${target.y}) ${target.width}x${target.height} [${target.source}]`);
+				lines.push("cite this observationId in click `basedOn` and address a target by its (x, y) coordinates.");
+				return [{
+					type: "text",
+					text: lines.join("\n")
+				}];
+			}
+		},
+		timeoutMs: config.helperTimeoutMs + 3e4,
+		async execute(args, exec) {
+			backendGuard(services);
+			const parsed = args;
+			const requestedSide = parsed.maxSide;
+			const maxSide = requestedSide === void 0 ? config.maxScreenshotSide : Math.min(requestedSide, config.maxScreenshotSide);
+			const shot = await backend.shot(parsed.target ?? {}, maxSide, exec.signal);
+			const sanitized = observedWindow(shot.snapshot, config.maxTextLength);
+			const record = observations.record(shot.snapshot);
+			const targets = [];
+			if (ocr.available) for (const word of await ocr.recognize(shot.pngBase64, exec.signal)) {
+				const box = screenBoxFor(shot.snapshot.rect, shot.width, shot.height, word.box);
+				const center = centerOf(box);
+				targets.push({
+					text: sanitizeVisible(word.text, config.maxTextLength),
+					x: center.x,
+					y: center.y,
+					width: Math.round(box.width),
+					height: Math.round(box.height),
+					confidence: word.confidence / 100,
+					source: "ocr"
+				});
+			}
+			const query = parsed.query?.trim() ?? "";
+			if (grounding.available && query !== "") for (const target of await grounding.ground(shot.pngBase64, shot.width, shot.height, query, exec.signal)) {
+				const box = screenBoxFor(shot.snapshot.rect, shot.width, shot.height, target.box);
+				const center = centerOf(box);
+				targets.push({
+					text: sanitizeVisible(target.label, config.maxTextLength),
+					x: center.x,
+					y: center.y,
+					width: Math.round(box.width),
+					height: Math.round(box.height),
+					confidence: target.confidence,
+					source: "grounding"
+				});
+			}
+			const filtered = query === "" ? targets : targets.filter((target) => target.text.toLowerCase().includes(query.toLowerCase()));
+			auditObservation(exec, {
+				observationId: record.id,
+				windowId: shot.snapshot.windowId,
+				processId: shot.snapshot.processId,
+				executablePath: sanitized.executablePath,
+				windowTitle: sanitized.title,
+				elementCount: 0
+			}, config.auditSessionEvents);
+			return {
+				ok: true,
+				observationId: record.id,
+				window: sanitized,
+				ocrAvailable: ocr.available,
+				targets: filtered
+			};
+		}
+	});
+}
 /** The shared window-action output schema (click/scroll/key). */
 function actionOutputSchema(withRestored) {
 	return {
@@ -1773,6 +2184,7 @@ function allTools(services) {
 	return [
 		screenShotTool(services),
 		screenReadTool(services),
+		screenFindTool(services),
 		clickTool(services),
 		typeTool(services),
 		scrollTool(services),
@@ -1787,30 +2199,35 @@ const name = "dsh-click";
 /** Hard services: the tool registry every contribution lands in. */
 const inject = ["tools"];
 /**
-* Mount the plugin: resolve config, select the platform backend, and register
+* Mount the plugin: resolve config, select the platform backend, probe the
+* optional OCR provider, read the optional visual-grounding seam, and register
 * every tool through `ctx.tools.register` (each registration is an effect
 * whose disposer removes exactly that tool on stop/HMR).
 *
 * @param ctx - context carrying the tools registry.
 * @param config - raw loader config; defaults applied through {@link resolveConfig}.
 */
-function apply(ctx, config) {
+async function apply(ctx, config) {
 	const resolved = resolveConfig(config);
 	const backend = ctx.get("dsh-click/backend") ?? createBackend(ctx, resolved);
 	const observations = new ObservationStore(resolved);
+	const actions = new ActionExecutor({
+		ctx,
+		config: resolved,
+		backend,
+		observations
+	});
+	const subprocess = ctx.get("subprocess");
 	const services = {
 		ctx,
 		config: resolved,
 		backend,
 		observations,
-		actions: new ActionExecutor({
-			ctx,
-			config: resolved,
-			backend,
-			observations
-		})
+		actions,
+		ocr: resolved.ocr.enabled && subprocess !== void 0 ? await probeTesseract(subprocess, resolved.ocr.command, resolved.ocr.language) : new UnavailableOcrProvider("ocr-disabled", resolved.ocr.enabled ? "the subprocess service is not mounted" : "OCR is disabled by config"),
+		grounding: ctx.get("dsh-click/grounding") ?? new UnavailableGroundingProvider()
 	};
 	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, UnavailableBackend, VERSION, allTools, apply, createBackend, inject, name, observationIdOf, redactSensitive, resolveConfig, sanitizePath, sanitizeText, sanitizeVisible };
+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/config.d.ts

@@ -45,6 +45,19 @@ export declare const MAX_TREE_DEPTH = 64;
 export declare const DEFAULT_MAX_TEXT_LENGTH = 200;
 /** Ceiling on the sanitization truncation length. */
 export declare const MAX_TEXT_LENGTH = 10000;
+/** Default tesseract executable for the optional OCR path. */
+export declare const DEFAULT_OCR_COMMAND = "tesseract";
+/** Default OCR language (tesseract language data). */
+export declare const DEFAULT_OCR_LANGUAGE = "eng";
+/** Optical character recognition (optional; probed at mount). */
+export interface OcrConfig {
+    /** Enable OCR-based text finding when a window has no UIA tree (default true). */
+    enabled?: boolean;
+    /** tesseract executable name (default "tesseract"). */
+    command?: string;
+    /** tesseract language tag (default "eng"). */
+    language?: string;
+}
 /** Configuration for the dsh-click desktop-control tools. */
 export interface Config {
     /** Gate every mutating action (click/type/scroll/key/app_launch) behind approval (default true). */
@@ -53,11 +66,11 @@ export interface Config {
     autoApproveWindows?: string[];
     /**
      * Whether dsh-click session audit events (`dsh-click/observed`/`dsh-click/action`)
-     * are appended to the session log (default true). Set false when the harness
-     * session reader does not recognize these event types (e.g. DeepSeek Harness
-     * rc.6/rc.7 static event whitelist without a plugin registration surface):
-     * a log containing them then refuses resume with
-     * "event type ... unknown to this harness and not marked ignorable".
+     * are appended to the session log (default true). The adaptive audit gate
+     * already skips the append on envelope-less hosts (rc.6–rc.8, 0.1.1-rc.2,
+     * and 0.1.2-alpha.1, which fails closed on unknown types at read); set
+     * false to stop audit appends entirely, even on hosts that carry the
+     * `ignorable` envelope.
      */
     auditSessionEvents?: boolean;
     /** Whether mutating actions may bring the target window to the foreground as a fallback (default 'never'). */
@@ -84,6 +97,8 @@ export interface Config {
     maxTextLength?: number;
     /** Back up and restore control text when `type` fails (default true). */
     rollbackEnabled?: boolean;
+    /** Optical character recognition (optional; probed at mount). */
+    ocr?: OcrConfig;
 }
 /** Fully resolved configuration captured at plugin load. */
 export interface ResolvedConfig {
@@ -117,6 +132,12 @@ export interface ResolvedConfig {
     maxTextLength: number;
     /** Whether `type` backs up and restores control text on failure. */
     rollbackEnabled: boolean;
+    /** OCR configuration (probed at mount). */
+    ocr: {
+        enabled: boolean;
+        command: string;
+        language: string;
+    };
 }
 /** Schemastery schema for loader-validated configuration. */
 export declare const Config: z<Config>;

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/events.d.ts

@@ -1,16 +1,23 @@
 /**
  * Session audit events for dsh-click (declaration merging into the harness's
- * `SessionEventMap`). Both events are log-only; the two-argument
- * `Session.append` form is retained because the published peers (through
- * 0.1.1-rc.2) expose no append-envelope (`ignorable`) option for plugin
- * events, so the two-argument form typechecks and runs across the line. Tool arguments and rendered results are
- * already logged by the tool runtime as `tool/call` + `tool/result`; these
- * events carry the observation and action facts that exist outside them:
- * window identity, process identity, and the approval/outcome audit trail.
+ * `SessionEventMap`) and the adaptive append gate. Both events are log-only;
+ * tool arguments and rendered results are already logged by the tool runtime
+ * as `tool/call` + `tool/result`, and these events carry the observation and
+ * action facts that exist outside them: window identity, process identity,
+ * and the approval/outcome audit trail.
+ *
+ * The gate appends only when the host can carry the events safely:
+ * - hosts whose known-type set covers the vocabulary append plainly;
+ * - hosts with an `ignorable` append option (pre-0.1.2 master builds) append
+ *   with the marker, so builds that do not know the type skip it on restore;
+ * - envelope-less hosts (0.1.0-rc.6/rc.8, 0.1.1-rc.2, and 0.1.2-alpha.1,
+ *   which removed the envelope and fails closed on unknown types at read)
+ *   get no append — the tool results remain the reconstructable audit trail.
  *
  * @module dsh-click/events
  */
 import type { ImageMediaType } from '@deepseek-ai/dsh-attachment';
+import { type Session } from '@deepseek-ai/dsh-session';
 /** Process identity facts captured immediately before and after an action. */
 export interface ProcessFacts {
     /** Process id owning the target window. */
@@ -108,4 +115,14 @@ export type ActionEvent = {
     restored?: boolean;
     detail?: string;
 };
+/**
+ * Append one dsh-click audit event when the host can carry it safely; skip
+ * silently otherwise (the tool/call + tool/result events remain the
+ * model-visible log, so nothing model-visible is lost). See the module doc
+ * for the three host classes.
+ * @param session - the calling session.
+ * @param type - the audit event type.
+ * @param data - the audit payload.
+ */
+export declare function appendAuditEvent(session: Session, type: typeof OBSERVED_EVENT | typeof ACTION_EVENT, data: ObservedEvent | ActionEvent): void;
 //# sourceMappingURL=events.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEjE,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAA;IACX,gFAAgF;IAChF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,SAAS,EAAE,cAAc,CAAA;IACzB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,OAAO,QAAQ,gCAAgC,CAAC;IAC9C,UAAU,eAAe;QACvB;;;;;WAKG;QACH,oBAAoB,EAAE;YACpB,mDAAmD;YACnD,aAAa,EAAE,MAAM,CAAA;YACrB,8BAA8B;YAC9B,QAAQ,EAAE,MAAM,CAAA;YAChB,oCAAoC;YACpC,SAAS,EAAE,MAAM,CAAA;YACjB,0DAA0D;YAC1D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;YAC7B,8BAA8B;YAC9B,WAAW,EAAE,MAAM,CAAA;YACnB,iDAAiD;YACjD,YAAY,EAAE,MAAM,CAAA;YACpB,8DAA8D;YAC9D,KAAK,CAAC,EAAE,aAAa,CAAA;SACtB,CAAA;QACD;;;;WAIG;QACH,kBAAkB,EAAE;YAClB,gCAAgC;YAChC,IAAI,EAAE,MAAM,CAAA;YACZ,sFAAsF;YACtF,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,CAAA;YAC3C,+DAA+D;YAC/D,OAAO,EAAE,IAAI,GAAG,OAAO,CAAA;YACvB,8DAA8D;YAC9D,aAAa,CAAC,EAAE,MAAM,CAAA;YACtB,gEAAgE;YAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;YACjB,mDAAmD;YACnD,aAAa,CAAC,EAAE,YAAY,CAAA;YAC5B,kDAAkD;YAClD,YAAY,CAAC,EAAE,YAAY,CAAA;YAC3B,oEAAoE;YACpE,QAAQ,CAAC,EAAE,OAAO,CAAA;YAClB,kEAAkE;YAClE,MAAM,CAAC,EAAE,MAAM,CAAA;SAChB,CAAA;KACF;CACF;AAED,wCAAwC;AACxC,eAAO,MAAM,cAAc,EAAG,oBAA6B,CAAA;AAE3D,mCAAmC;AACnC,eAAO,MAAM,YAAY,EAAG,kBAA2B,CAAA;AAEvD,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,CAAA;IAC3C,OAAO,EAAE,IAAI,GAAG,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"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"}