Skip to content

feat(drivers): add HCU Windows adapter and platform contracts - #815

Draft
hqhq1025 wants to merge 6 commits into
scaleapi:mainfrom
hqhq1025:feat/hcu-driver-windows
Draft

hqhq1025 wants to merge 6 commits into
scaleapi:mainfrom
hqhq1025:feat/hcu-driver-windows

Conversation

@hqhq1025

Copy link
Copy Markdown

Draft: Windows needs a published, immutable HCU archive before this can merge.
This change is based on #730. The local native-disk fixes are tracked separately
in #814.

The existing Windows work pointed at an unpublished v1.0.1 ZIP and older
runtime hashes. This draft removes that unusable download declaration and
prepares the Windows adapter against the locally validated runtime.

  • Select WindowsDriver and isolate the HCU process's Windows environment.
  • Keep separate Linux and Windows MCP manifests. The current Windows contract
    differs from the published Linux v1.0.1 contract.
  • Verify the Go executable, native provider and input-acknowledgement DLL before
    starting HCU. Missing or changed files fail readiness.
  • Verify the staged ZIP before extraction and require all three runtime files.
  • Regenerate all retained tool fields, including titles, with UTF-8/LF output.
  • Carry the bounded-session and no-replay behavior from feat(drivers): add the Hybrid Computer Use driver #730 to both platforms.

Linux keeps its existing published archive and contract. No Windows download
URL is configured: a development bundle must supply the archive through its
file collection, and installation explicitly fails if it is absent.

Validation

  • Full framework and protocol unit suites: 17,337 passed, 8 skipped.
  • Lint and plugin API compatibility checks pass.
  • Tests cover both platform manifests, missing/corrupt runtime components,
    cancelled and stalled calls, queue failure and fresh sessions without replay.
  • A real Windows desktop checks missing and incorrect archives, installs the
    correct staged archive, verifies all runtime pins and the Windows manifest,
    and completes AX and GUI screenshot calls. The desktop is closed afterward.
  • The Linux real-GTK integration and its published release remain covered by
    feat(drivers): add the Hybrid Computer Use driver #730.

Required before merge

  • Publish the upstream HCU Windows build containing the input, text-read and
    UIA fixes.
  • Replace the local-build pins with the published release's verified pins and
    add its real download URL.
  • Re-run Windows installation from that public URL. The staged-archive smoke
    test does not establish public download availability.

The documentation site should cover Windows runtime placement, architecture
support, the platform manifests, and release-pin updates.

Pin HCU 1.0.1 release and executable hashes, and forward its AX and GUI tools.

Preserve Linux accessibility setup, add manifest regeneration, and test installation, server isolation and readiness offline.
# Conflicts:
#	src/agent_env/drivers/envs/hcu/driver.py

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant