dsh-vision-router 2.1.2 → 2.1.4

package/lib/windows-desktop-capture.js

@@ -0,0 +1,247 @@
+import { execFile as importedExecFile } from 'node:child_process'
+import { mkdtemp, rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import path from 'node:path'
+
+function quotePowerShellSingle(value) {
+  return `'${String(value).replace(/'/g, "''")}'`
+}
+
+export function buildPerMonitorWindowsScreenshotScript(outputPath) {
+  const quotedPath = quotePowerShellSingle(outputPath)
+  const source = String.raw`using System;
+using System.Drawing;
+using System.Runtime.InteropServices;
+using System.Windows.Forms;
+
+public static class DshVisionDesktopCapture
+{
+    private static readonly IntPtr PerMonitorV2 = new IntPtr(-4);
+    private static readonly IntPtr PerMonitorV1 = new IntPtr(-3);
+
+    [DllImport("user32.dll")]
+    private static extern IntPtr SetThreadDpiAwarenessContext(IntPtr dpiContext);
+
+    private static IntPtr TrySetContext(IntPtr context)
+    {
+        try
+        {
+            return SetThreadDpiAwarenessContext(context);
+        }
+        catch (EntryPointNotFoundException)
+        {
+            return IntPtr.Zero;
+        }
+        catch (DllNotFoundException)
+        {
+            return IntPtr.Zero;
+        }
+    }
+
+    private static IntPtr EnterPerMonitorContext()
+    {
+        IntPtr previous = TrySetContext(PerMonitorV2);
+        if (previous == IntPtr.Zero)
+        {
+            previous = TrySetContext(PerMonitorV1);
+        }
+        if (previous == IntPtr.Zero)
+        {
+            throw new InvalidOperationException(
+                "could not enter a per-monitor DPI awareness context; refusing to return a potentially misaligned screenshot");
+        }
+        return previous;
+    }
+
+    private static void RestoreContext(IntPtr previous)
+    {
+        try
+        {
+            SetThreadDpiAwarenessContext(previous);
+        }
+        catch
+        {
+            // The helper process exits immediately after capture. Restoration
+            // is still attempted so this method is correct if reused.
+        }
+    }
+
+    public static void ValidateDpiContext()
+    {
+        IntPtr previous = EnterPerMonitorContext();
+        RestoreContext(previous);
+    }
+
+    public static void Capture(string outputPath)
+    {
+        IntPtr previous = EnterPerMonitorContext();
+        try
+        {
+            Rectangle bounds = SystemInformation.VirtualScreen;
+            if (bounds.Width <= 0 || bounds.Height <= 0)
+            {
+                throw new InvalidOperationException("the Windows virtual screen has no drawable area");
+            }
+
+            using (var bitmap = new Bitmap(bounds.Width, bounds.Height))
+            using (var graphics = Graphics.FromImage(bitmap))
+            {
+                graphics.CopyFromScreen(bounds.X, bounds.Y, 0, 0, bounds.Size);
+                bitmap.Save(outputPath);
+            }
+        }
+        finally
+        {
+            RestoreContext(previous);
+        }
+    }
+}`
+
+  return [
+    'Add-Type -AssemblyName System.Windows.Forms,System.Drawing',
+    `$__dshVisionCaptureSource = @'\n${source}\n'@`,
+    'try {',
+    "  Add-Type -TypeDefinition $__dshVisionCaptureSource -ReferencedAssemblies 'System.Windows.Forms.dll','System.Drawing.dll' -ErrorAction Stop",
+    '} catch {',
+    "  throw ('vision_screenshot: failed to initialize the Windows DPI-aware capture helper: ' + $_.Exception.Message)",
+    '}',
+    `[DshVisionDesktopCapture]::Capture(${quotedPath})`,
+  ].join('\n')
+}
+
+// Snapshot the native function at module evaluation. Screenshot correctness
+// must not depend on the process-wide promisify(execFile) compatibility seam
+// used by legacy Tesseract stdin support.
+const nativeExecFile = importedExecFile
+
+function execFileAsync(file, args, options) {
+  return new Promise((resolve, reject) => {
+    nativeExecFile(file, args, options, (error, stdout, stderr) => {
+      if (error) {
+        if (error && typeof error === 'object') {
+          try {
+            error.stdout = stdout
+            error.stderr = stderr
+          } catch {
+            /* preserve the original child-process error */
+          }
+        }
+        reject(error)
+        return
+      }
+      resolve({ stdout, stderr })
+    })
+  })
+}
+
+export function isAsciiWindowsPath(value) {
+  return typeof value === 'string' && value !== '' && /^[\x20-\x7e]+$/.test(value)
+}
+
+function captureTempRoots(env, tmpRoot) {
+  const roots = []
+  const add = (value) => {
+    if (!isAsciiWindowsPath(value) || roots.includes(value)) return
+    roots.push(value)
+  }
+  add(tmpRoot)
+  add(env?.TEMP)
+  add(env?.TMP)
+  if (isAsciiWindowsPath(env?.SystemRoot)) add(path.win32.join(env.SystemRoot, 'Temp'))
+  if (isAsciiWindowsPath(env?.WINDIR)) add(path.win32.join(env.WINDIR, 'Temp'))
+  return roots
+}
+
+/**
+ * CodeDom-backed PowerShell Add-Type uses TEMP/TMP while compiling the small
+ * DPI-aware C# helper. On Windows profiles whose temp path contains non-ASCII
+ * characters that compilation can fail before capture starts (#409). Pick a
+ * writable ASCII scratch directory without ever mutating process.env.
+ */
+export async function createWindowsCaptureTempDir(options = {}) {
+  const env = options.env ?? (typeof process !== 'undefined' ? process.env : {})
+  const tmpRoot = options.tmpRoot ?? tmpdir()
+  const makeTempDir = options.mkdtemp ?? mkdtemp
+  const roots = captureTempRoots(env, tmpRoot)
+  const failures = []
+
+  for (const root of roots) {
+    try {
+      return await makeTempDir(path.win32.join(root, 'dsh-vision-router-capture-'))
+    } catch (error) {
+      failures.push(error && error.message ? error.message : String(error))
+    }
+  }
+
+  const error = new Error(
+    'vision_screenshot: no writable ASCII temporary directory is available for the Windows DPI-aware capture helper',
+  )
+  error.code = 'WINDOWS_CAPTURE_TEMP_UNAVAILABLE'
+  if (failures.length > 0) error.cause = new Error(failures.join(' | '))
+  throw error
+}
+
+/**
+ * Capture the Windows virtual desktop with per-monitor DPI awareness.
+ *
+ * This is the production owner of the Windows screenshot operation. It calls
+ * the PMv2 -> PMv1 helper directly and fails closed if a correct DPI context
+ * cannot be entered; it never falls back to the known-broken logical-coordinate
+ * legacy script. macOS/Linux capture remains owned by index.js.
+ */
+export async function captureWindowsDesktop(outputPath, options = {}) {
+  const env = options.env ?? (typeof process !== 'undefined' ? process.env : {})
+  const removeTempDir = options.rm ?? rm
+  const run = options.execFileAsync ?? execFileAsync
+  let scratchDir
+
+  try {
+    scratchDir = await createWindowsCaptureTempDir({
+      env,
+      tmpRoot: options.tmpRoot,
+      mkdtemp: options.mkdtemp,
+    })
+    const script = buildPerMonitorWindowsScreenshotScript(outputPath)
+    const execOptions = {
+      windowsHide: true,
+      cwd: scratchDir,
+      env: {
+        ...env,
+        TEMP: scratchDir,
+        TMP: scratchDir,
+      },
+      ...(Number.isFinite(options.timeoutMs) && options.timeoutMs > 0
+        ? { timeout: options.timeoutMs }
+        : {}),
+      ...(options.signal === undefined ? {} : { signal: options.signal }),
+    }
+    await run(
+      options.powershell ?? 'powershell.exe',
+      ['-NoProfile', '-NonInteractive', '-STA', '-Command', script],
+      execOptions,
+    )
+  } catch (error) {
+    if (error?.code === 'WINDOWS_CAPTURE_TEMP_UNAVAILABLE') throw error
+    if (error?.name === 'AbortError' || error?.code === 'ABORT_ERR') throw error
+    const wrapped = new Error(
+      `vision_screenshot: Windows DPI-aware capture failed (${error && error.message ? error.message : String(error)})`,
+    )
+    wrapped.code = 'WINDOWS_DPI_CAPTURE_FAILED'
+    wrapped.cause = error
+    throw wrapped
+  } finally {
+    if (scratchDir) {
+      try {
+        await removeTempDir(scratchDir, {
+          recursive: true,
+          force: true,
+          maxRetries: 3,
+          retryDelay: 50,
+        })
+      } catch {
+        // Antivirus/indexing can briefly retain CodeDom files. Cleanup is
+        // best-effort and must not turn a valid screenshot into a failure.
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vision-router",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "description": "Eyes for text-only DeepSeek Harness agents: built-in free vision chain (no key) + pixel-level vision tools (Q&A, grounding, crop, pixel diff, colors, OCR, SVG trace, cutout, screenshots). One-command install, no Python, image turns work like ordinary tool-calling turns.",
   "license": "MIT",
   "repository": {
@@ -54,8 +54,8 @@
     "undici": "^7.29.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-anonymous-user-id": "^0.1.0-rc.8 || ^0.1.1-rc.1",
-    "@deepseek-ai/dsh-llm-deepseek": "^0.1.0-rc.8 || ^0.1.1-rc.1",
+    "@deepseek-ai/dsh-anonymous-user-id": "^0.1.0-rc.8 || ^0.1.1-rc.1 || ^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-llm-deepseek": "^0.1.0-rc.8 || ^0.1.1-rc.1 || ^0.1.3-alpha.2",
     "sharp": ">=0.35.3 <1"
   },
   "peerDependenciesMeta": {
@@ -69,13 +69,13 @@
     "sharp": "^0.35.3"
   },
   "scripts": {
-    "test": "node --test tests/adapter-prepare-call-compat.test.js tests/core.test.js tests/issue-374-delegated-call-config.test.js tests/grounding-coordinate-frame.test.js tests/grounding-coordinate-runtime.test.js tests/capability-advisory.test.js tests/vision-execution-policy.test.js tests/vision-backend-diagnostics.test.js tests/live-model-discovery.test.js tests/live-model-credential-resolution.test.js tests/vision-model-registry.test.js tests/live-model-client-stability.test.js tests/providers-persistence.test.js tests/provider-directory-fallback.test.js tests/model-catalog-policy.test.js tests/settings-ia-client-prelude.test.js tests/settings-ia-fj.test.js tests/settings-ia-acceptance-regression.test.js tests/settings-migration.test.js tests/settings-section-order.test.js tests/attachment-admission-policy.test.js tests/vision-resilience.test.js tests/vision-resilience-lifecycle.test.js tests/vision-breaker-readonly.test.js tests/alpha1-browser-lifecycle-integration.test.js tests/issue-367-remote-session-inject.test.js tests/client.test.js tests/issue-307-regression.test.js tests/issue-284-vision-mode-toggle.test.js tests/issue-284-vision-mode-hardening.test.js tests/issue-284-attachment-id-hint.test.js tests/issue-284-model-visibility.test.js tests/issue-284-vision-selection-effort.test.js tests/client-presentation-boundary.test.js tests/remote-settings-bridge.test.js tests/remote-settings-v2-contract.test.js tests/remote-settings-risk-confirmation.test.js tests/local-remote-settings-permission.test.js tests/rc6-real-settings-persistence.test.js tests/artifact-path-security.test.js tests/http-compat.test.js tests/catalog-corrections.test.js tests/update-check.test.js tests/update-check-signal-lifecycle.test.js tests/self-update.test.js tests/doctor.test.js tests/doctor-cli.test.js tests/legacy-session-repair.test.js tests/profile-pnpm-diagnostics.test.js tests/doctor-v2.test.js tests/doctor-cli-v2.test.js tests/doctor-runtime.test.js tests/dsh-host-capabilities.test.js tests/doctor-host-capabilities.test.js tests/session-repair-v2.test.js tests/bundle-defaults.test.js tests/file-logger.test.js tests/replay-delegation.test.js tests/twin-image-capability-fallback.test.js tests/twin-image-custom-wrapper.test.js tests/adversarial-hardening.test.js tests/vision-adversarial-hardening-v2.test.js tests/vision-capability-benchmark-visual-proof.test.js tests/wrapper-directory.test.js tests/logging-ui.test.js tests/manifest-dependencies.test.js tests/structured-bootstrap.test.js tests/structured-bootstrap-gate.test.js tests/local-ollama.test.js tests/ollama-cold-start.test.js tests/ollama-cold-start-loaded.test.js tests/zero-regression-gate.test.js tests/runtime-e2e.test.js tests/local-vision-stabilizer.test.js tests/local-connection-probe.test.js tests/repetition-guard.test.js tests/guide-scroll-gate.test.js tests/settings-scroll-jank-regression.test.js tests/android-attachment-compat.test.js tests/free-cloud-first.test.js tests/rc6-rc7-compat.test.js tests/native-image-coexistence.test.js tests/issue-276-session-image-ownership.test.js tests/issue-276-entry-policy-bridge.test.js tests/issue-276-policy-hardening.test.js tests/issue-289-native-nonintervention.test.js tests/pi-ai-bridge-wire-compat.test.js tests/mixed-router.test.js tests/depth-tier.test.js tests/depth-quota-behavior.test.js tests/structured-flow-hardening.test.js tests/structured-flow-adversarial.test.js tests/vision-budget-activation.test.js tests/runtime-boundary-fixes.test.js tests/runtime-i18n.test.js tests/tesseract-node24-boot.test.js tests/session-vision-state.test.js tests/session-vision-state-integration.test.js tests/image-resource-governor.test.js tests/resource-retention-lifecycle.test.js tests/pixel-diff-stream.test.js tests/large-image-resource-integration.test.js tests/structured-guard-idempotency.test.js tests/vision-routing-product.test.js tests/vision-runtime-performance.test.js tests/vision-routing-settings-prelude.test.js tests/v2-settings-ia-integration.test.js tests/vision-capability-router.test.js tests/vision-capability-reference.test.js tests/vision-capability-benchmark.test.js tests/vision-capability-grounding-proof-contract.test.js tests/vision-capability-probe.test.js tests/vision-capability-axis-freshness.test.js tests/vision-capability-shadow-health.test.js tests/vision-capability-benchmark-service.test.js tests/vision-capability-preflight-hardening.test.js tests/vision-capability-benchmark-contract.test.js tests/vision-capability-benchmark-client.test.js tests/vision-capability-benchmark-client-productization.test.js tests/vision-capability-adapter-route.test.js tests/vision-background-benchmark.test.js tests/vision-background-lifecycle.test.js tests/vision-background-benchmark-productization.test.js tests/vision-capability-benchmark-budget.test.js tests/vision-image-input-verdict.test.js tests/vision-capability-failure-classification.test.js tests/vision-capability-gate-client.test.js tests/v2-product-review-fixes.test.js tests/qa-top5-reliability.test.js tests/qa-screenshot-runtime.test.js tests/qa-runtime-identity.test.js tests/qa-turn-budget-cancellation.test.js tests/qa-cancellation-publication.test.js tests/qa-reliability-tail.test.js tests/qa-endpoint-route-alias.test.js tests/settings-native-card-semantics.test.js tests/settings-native-card-lazy-data.test.js tests/settings-invalid-staged-dirty.test.js tests/vision-toggle-root-hardening.test.js && node --test tests/vision-backend-runtime-policy.test.js",
+    "test": "node --test tests/adapter-prepare-call-compat.test.js tests/core.test.js tests/issue-374-delegated-call-config.test.js tests/grounding-coordinate-frame.test.js tests/grounding-coordinate-runtime.test.js tests/capability-advisory.test.js tests/vision-execution-policy.test.js tests/vision-backend-diagnostics.test.js tests/live-model-discovery.test.js tests/live-model-credential-resolution.test.js tests/vision-model-registry.test.js tests/live-model-client-stability.test.js tests/providers-persistence.test.js tests/provider-directory-fallback.test.js tests/model-catalog-policy.test.js tests/settings-ia-client-prelude.test.js tests/settings-ia-fj.test.js tests/settings-ia-acceptance-regression.test.js tests/settings-migration.test.js tests/settings-section-order.test.js tests/attachment-admission-policy.test.js tests/vision-resilience.test.js tests/vision-resilience-lifecycle.test.js tests/vision-breaker-readonly.test.js tests/alpha1-browser-lifecycle-integration.test.js tests/issue-367-remote-session-inject.test.js tests/vision-mode-toggle-injection.test.js tests/client.test.js tests/issue-307-regression.test.js tests/issue-284-vision-mode-toggle.test.js tests/issue-284-vision-mode-hardening.test.js tests/issue-284-attachment-id-hint.test.js tests/issue-284-model-visibility.test.js tests/issue-284-vision-selection-effort.test.js tests/client-presentation-boundary.test.js tests/clipboard-image-paste-compat.test.js tests/remote-settings-bridge.test.js tests/remote-settings-v2-contract.test.js tests/remote-settings-risk-confirmation.test.js tests/local-remote-settings-permission.test.js tests/rc6-real-settings-persistence.test.js tests/artifact-path-security.test.js tests/http-compat.test.js tests/catalog-corrections.test.js tests/update-check.test.js tests/update-check-signal-lifecycle.test.js tests/self-update.test.js tests/doctor.test.js tests/doctor-cli.test.js tests/legacy-session-repair.test.js tests/profile-pnpm-diagnostics.test.js tests/doctor-v2.test.js tests/doctor-cli-v2.test.js tests/doctor-runtime.test.js tests/dsh-host-capabilities.test.js tests/doctor-host-capabilities.test.js tests/session-repair-v2.test.js tests/bundle-defaults.test.js tests/file-logger.test.js tests/replay-delegation.test.js tests/twin-image-capability-fallback.test.js tests/twin-image-custom-wrapper.test.js tests/adversarial-hardening.test.js tests/vision-adversarial-hardening-v2.test.js tests/vision-capability-benchmark-visual-proof.test.js tests/wrapper-directory.test.js tests/logging-ui.test.js tests/manifest-dependencies.test.js tests/structured-bootstrap.test.js tests/structured-bootstrap-gate.test.js tests/vision-model-guidance-contract.test.js tests/local-ollama.test.js tests/ollama-cold-start.test.js tests/ollama-cold-start-loaded.test.js tests/zero-regression-gate.test.js tests/runtime-e2e.test.js tests/local-vision-stabilizer.test.js tests/local-connection-probe.test.js tests/repetition-guard.test.js tests/guide-scroll-gate.test.js tests/settings-scroll-jank-regression.test.js tests/android-attachment-compat.test.js tests/free-cloud-first.test.js tests/rc6-rc7-compat.test.js tests/native-image-coexistence.test.js tests/issue-276-session-image-ownership.test.js tests/issue-276-entry-policy-bridge.test.js tests/issue-276-policy-hardening.test.js tests/issue-289-native-nonintervention.test.js tests/pi-ai-bridge-wire-compat.test.js tests/mixed-router.test.js tests/depth-tier.test.js tests/depth-quota-behavior.test.js tests/structured-flow-hardening.test.js tests/structured-flow-adversarial.test.js tests/vision-budget-activation.test.js tests/runtime-boundary-fixes.test.js tests/runtime-i18n.test.js tests/tesseract-node24-boot.test.js tests/session-vision-state.test.js tests/session-vision-state-integration.test.js tests/image-resource-governor.test.js tests/resource-retention-lifecycle.test.js tests/pixel-diff-stream.test.js tests/large-image-resource-integration.test.js tests/structured-guard-idempotency.test.js tests/vision-routing-product.test.js tests/vision-runtime-performance.test.js tests/vision-routing-settings-prelude.test.js tests/v2-settings-ia-integration.test.js tests/vision-capability-router.test.js tests/vision-capability-reference.test.js tests/vision-capability-benchmark.test.js tests/vision-capability-grounding-proof-contract.test.js tests/vision-capability-probe.test.js tests/vision-capability-axis-freshness.test.js tests/vision-capability-shadow-health.test.js tests/vision-capability-benchmark-service.test.js tests/vision-capability-preflight-hardening.test.js tests/vision-capability-benchmark-contract.test.js tests/vision-capability-benchmark-client.test.js tests/vision-capability-benchmark-client-productization.test.js tests/vision-capability-adapter-route.test.js tests/vision-background-benchmark.test.js tests/vision-background-lifecycle.test.js tests/vision-background-benchmark-productization.test.js tests/vision-capability-benchmark-budget.test.js tests/vision-image-input-verdict.test.js tests/vision-capability-failure-classification.test.js tests/vision-capability-gate-client.test.js tests/v2-product-review-fixes.test.js tests/qa-top5-reliability.test.js tests/qa-screenshot-runtime.test.js tests/qa-runtime-identity.test.js tests/qa-turn-budget-cancellation.test.js tests/qa-cancellation-publication.test.js tests/qa-reliability-tail.test.js tests/qa-endpoint-route-alias.test.js tests/settings-native-card-semantics.test.js tests/settings-native-card-lazy-data.test.js tests/settings-invalid-staged-dirty.test.js tests/vision-toggle-root-hardening.test.js && node --test tests/vision-backend-runtime-policy.test.js",
     "test:core": "node --test tests/core.test.js tests/runtime-e2e.test.js tests/structured-bootstrap.test.js tests/structured-flow-hardening.test.js tests/structured-flow-adversarial.test.js tests/vision-execution-policy.test.js tests/vision-backend-runtime-policy.test.js",
     "test:routing": "node --test tests/issue-374-delegated-call-config.test.js tests/twin-image-capability-fallback.test.js tests/twin-image-custom-wrapper.test.js tests/vision-routing-product.test.js tests/vision-capability-router.test.js tests/vision-capability-probe.test.js tests/vision-capability-shadow-health.test.js tests/vision-runtime-performance.test.js tests/vision-background-benchmark.test.js tests/vision-image-input-verdict.test.js",
     "test:session": "node --test tests/session-vision-state.test.js tests/session-vision-state-integration.test.js tests/replay-delegation.test.js tests/legacy-session-repair.test.js tests/session-repair-v2.test.js tests/issue-276-session-image-ownership.test.js",
     "test:resources": "node --test tests/artifact-path-security.test.js tests/image-resource-governor.test.js tests/resource-retention-lifecycle.test.js tests/pixel-diff-stream.test.js tests/large-image-resource-integration.test.js tests/qa-turn-budget-cancellation.test.js tests/qa-cancellation-publication.test.js",
     "test:compat": "node --test tests/adapter-prepare-call-compat.test.js tests/attachment-admission-policy.test.js tests/rc6-rc7-compat.test.js tests/rc6-real-settings-persistence.test.js tests/android-attachment-compat.test.js tests/http-compat.test.js tests/pi-ai-bridge-wire-compat.test.js tests/native-image-coexistence.test.js tests/tesseract-node24-boot.test.js tests/dsh-host-capabilities.test.js",
-    "test:web": "node --test tests/alpha1-browser-lifecycle-integration.test.js tests/issue-367-remote-session-inject.test.js tests/client.test.js tests/client-presentation-boundary.test.js tests/settings-ia-client-prelude.test.js tests/settings-ia-acceptance-regression.test.js tests/remote-settings-bridge.test.js tests/remote-settings-v2-contract.test.js tests/local-remote-settings-permission.test.js tests/v2-settings-ia-integration.test.js tests/logging-ui.test.js",
+    "test:web": "node --test tests/alpha1-browser-lifecycle-integration.test.js tests/issue-367-remote-session-inject.test.js tests/vision-mode-toggle-injection.test.js tests/client.test.js tests/client-presentation-boundary.test.js tests/clipboard-image-paste-compat.test.js tests/settings-ia-client-prelude.test.js tests/settings-ia-acceptance-regression.test.js tests/remote-settings-bridge.test.js tests/remote-settings-v2-contract.test.js tests/local-remote-settings-permission.test.js tests/v2-settings-ia-integration.test.js tests/logging-ui.test.js",
     "test:contract": "node --test tests/manifest-dependencies.test.js tests/bundle-defaults.test.js tests/zero-regression-gate.test.js tests/issue-289-native-nonintervention.test.js tests/issue-374-delegated-call-config.test.js tests/runtime-boundary-fixes.test.js tests/runtime-i18n.test.js tests/adapter-prepare-call-compat.test.js tests/rc6-rc7-compat.test.js tests/attachment-admission-policy.test.js tests/dsh-host-capabilities.test.js tests/doctor-host-capabilities.test.js tests/structured-bootstrap.test.js tests/structured-bootstrap-gate.test.js",
     "test:grounding": "node --test tests/grounding-coordinate-frame.test.js tests/grounding-coordinate-runtime.test.js tests/vision-capability-grounding-proof-contract.test.js",
     "test:stress": "node scripts/image-resource-stress.mjs && node --test tests/large-image-resource-integration.test.js tests/resource-retention-lifecycle.test.js"

package/lib/windows-screenshot-dpi-compat.js

@@ -1,148 +0,0 @@
-const VIRTUAL_SCREEN_MARKER = '[System.Windows.Forms.SystemInformation]::VirtualScreen'
-const COPY_FROM_SCREEN_MARKER = '$g.CopyFromScreen($b.X,$b.Y,0,0,$bmp.Size)'
-const SAVE_PATTERN = /\$bmp\.Save\('((?:''|[^'])*)'\)/
-
-function powerShellBasename(file) {
-  return String(file ?? '').replace(/\\/g, '/').split('/').pop().toLowerCase()
-}
-
-function quotePowerShellSingle(value) {
-  return `'${String(value).replace(/'/g, "''")}'`
-}
-
-function savedPathFromLegacyScript(script) {
-  const match = SAVE_PATTERN.exec(String(script ?? ''))
-  return match ? match[1].replace(/''/g, "'") : undefined
-}
-
-export function isLegacyWindowsScreenshotScript(script) {
-  const source = String(script ?? '')
-  return (
-    source.includes('Add-Type -AssemblyName System.Windows.Forms,System.Drawing') &&
-    source.includes(VIRTUAL_SCREEN_MARKER) &&
-    source.includes('[System.Drawing.Graphics]::FromImage($bmp)') &&
-    source.includes(COPY_FROM_SCREEN_MARKER) &&
-    savedPathFromLegacyScript(source) !== undefined
-  )
-}
-
-export function buildPerMonitorWindowsScreenshotScript(outputPath) {
-  const quotedPath = quotePowerShellSingle(outputPath)
-  const source = String.raw`using System;
-using System.Drawing;
-using System.Runtime.InteropServices;
-using System.Windows.Forms;
-
-public static class DshVisionDesktopCapture
-{
-    private static readonly IntPtr PerMonitorV2 = new IntPtr(-4);
-    private static readonly IntPtr PerMonitorV1 = new IntPtr(-3);
-
-    [DllImport("user32.dll")]
-    private static extern IntPtr SetThreadDpiAwarenessContext(IntPtr dpiContext);
-
-    private static IntPtr TrySetContext(IntPtr context)
-    {
-        try
-        {
-            return SetThreadDpiAwarenessContext(context);
-        }
-        catch (EntryPointNotFoundException)
-        {
-            return IntPtr.Zero;
-        }
-        catch (DllNotFoundException)
-        {
-            return IntPtr.Zero;
-        }
-    }
-
-    private static IntPtr EnterPerMonitorContext()
-    {
-        IntPtr previous = TrySetContext(PerMonitorV2);
-        if (previous == IntPtr.Zero)
-        {
-            previous = TrySetContext(PerMonitorV1);
-        }
-        if (previous == IntPtr.Zero)
-        {
-            throw new InvalidOperationException(
-                "could not enter a per-monitor DPI awareness context; refusing to return a potentially misaligned screenshot");
-        }
-        return previous;
-    }
-
-    private static void RestoreContext(IntPtr previous)
-    {
-        try
-        {
-            SetThreadDpiAwarenessContext(previous);
-        }
-        catch
-        {
-            // The helper process exits immediately after capture. Restoration
-            // is still attempted so this method is correct if reused.
-        }
-    }
-
-    public static void ValidateDpiContext()
-    {
-        IntPtr previous = EnterPerMonitorContext();
-        RestoreContext(previous);
-    }
-
-    public static void Capture(string outputPath)
-    {
-        IntPtr previous = EnterPerMonitorContext();
-        try
-        {
-            Rectangle bounds = SystemInformation.VirtualScreen;
-            if (bounds.Width <= 0 || bounds.Height <= 0)
-            {
-                throw new InvalidOperationException("the Windows virtual screen has no drawable area");
-            }
-
-            using (var bitmap = new Bitmap(bounds.Width, bounds.Height))
-            using (var graphics = Graphics.FromImage(bitmap))
-            {
-                graphics.CopyFromScreen(bounds.X, bounds.Y, 0, 0, bounds.Size);
-                bitmap.Save(outputPath);
-            }
-        }
-        finally
-        {
-            RestoreContext(previous);
-        }
-    }
-}`
-
-  return [
-    'Add-Type -AssemblyName System.Windows.Forms,System.Drawing',
-    `$__dshVisionCaptureSource = @'\n${source}\n'@`,
-    'try {',
-    "  Add-Type -TypeDefinition $__dshVisionCaptureSource -ReferencedAssemblies 'System.Windows.Forms.dll','System.Drawing.dll' -ErrorAction Stop",
-    '} catch {',
-    "  throw ('vision_screenshot: failed to initialize the Windows DPI-aware capture helper: ' + $_.Exception.Message)",
-    '}',
-    `[DshVisionDesktopCapture]::Capture(${quotedPath})`,
-  ].join('\n')
-}
-
-export function rewriteWindowsScreenshotExecArgs(file, args, options = {}) {
-  const platform = options.platform ?? (typeof process !== 'undefined' ? process.platform : '')
-  if (platform !== 'win32') return args
-  const executable = powerShellBasename(file)
-  if (executable !== 'powershell.exe' && executable !== 'powershell') return args
-  if (!Array.isArray(args)) return args
-
-  const commandIndex = args.findIndex((arg) => String(arg).toLowerCase() === '-command')
-  if (commandIndex < 0 || commandIndex + 1 >= args.length) return args
-  const script = args[commandIndex + 1]
-  if (!isLegacyWindowsScreenshotScript(script)) return args
-
-  const outputPath = savedPathFromLegacyScript(script)
-  if (outputPath === undefined) return args
-  const rewritten = args.slice()
-  rewritten[commandIndex + 1] = buildPerMonitorWindowsScreenshotScript(outputPath)
-  return rewritten
-}