@agent-forge/plugin-desktop-windows-observe

Read-only Windows desktop observation capability plugin for Agent Forge, extracted from the host's src/plugins/desktop (D-075 S3). It registers five read-only tools — desktop_probe, desktop_session_open, desktop_observe, desktop_reobserve, desktop_session_stop — backed by the Windows UI Automation PowerShell driver. It never registers an input or replay tool.

The plugin ships its own UIA adapter. On non-Windows platforms importing the package does not throw; every tool reports an explicit unsupported result instead of probing or falling back to a different driver.

Install

# from a local checkout
agent-forge plugin install ./plugins/desktop-windows-observe

# from npm
agent-forge plugin install @ai-agent-forge/plugin-desktop-windows-observe

The package ships two manifests: agent-forge.json (ecosystem manifest for the deterministic plugin resolver, platform.os: ["windows"]) and plugin.json (host-load manifest consumed by loadCapabilityPluginFromManifest, entry ./dist/entry.js).

Library surface

import { DesktopWindowsAdapter, WindowsUiAutomationDriver } from "@agent-forge/plugin-desktop-windows-observe";

• DesktopWindowsAdapter — UIA adapter facade (the host's default desktop wiring constructs this one).
• WindowsUiAutomationDriver(options?) — PowerShell UIA driver; supports command/timeoutMs/spawnSync/platform injection for brokers and tests.
• createDesktopObserveCapabilityFactoryV1(runtime) — registers the five observation tools on a CapabilityAPI.
• Default export of dist/entry.js — the precomposed factory used by external plugin loading.

The UIA adapter code is a deliberate inlined copy shared with @agent-forge/plugin-desktop-windows-input so both packages stay self-contained.

Development

npm install --ignore-scripts        # repo root, creates the workspace symlink
npm run build                       # plugins/desktop-windows-observe (tsgo)
npm test                            # vitest; the entry fidelity test requires `npm run build` first