hermes-agent/skills
Teknium 9d6d772837
feat(computer_use): follow cua-driver's verify → escalate ladder (#67123)
Hermes' computer_use wrapper dropped cua-driver's structured action verdicts,
exposed no delivery_mode, and injected background-only guidance — so the agent
reported unverified no-ops as success and concluded cua-driver 'cannot drive'
Electron/Chromium surfaces (observed live on tldraw offline). Fixes #67052.

Phase A — preserve the result contract:
- ActionResult carries verified/effect/escalation/path/degraded/code/delivery_mode
- CuaDriverBackend._action() reads structuredContent (was data-only); a helper
  normalizes it, additive and None-safe on old drivers
- _text_response surfaces the fields additively (ok stays transport-only)

Phase B — bounded, model-reachable foreground:
- delivery_mode (background|foreground) + bring_to_front on the schema, dispatcher,
  ABC, and all input methods
- foreground is capability-gated (input.delivery_mode); old drivers get a
  structured foreground_unsupported refusal, never a silent background downgrade
- no automatic/hidden foreground retry — the model selects it from the signal

Phase C — guidance + isolation:
- system prompt (prompt_builder) and bundled skills/computer-use/SKILL.md go from
  background-ONLY to background-FIRST, teaching the AX→PX→foreground ladder driven
  by returned effect/escalation, not predicted from the app being Electron
- foreground approval scoped by (action, delivery_mode): a background approval
  never silently authorizes foreground
- approval state keyed per session_id so concurrent gateway runs don't leak unlocks

Tests: tests/tools/test_computer_use_delivery_ladder.py (15) cover confirmed/
unverifiable/suspected_noop/degraded/old-driver verdicts, delivery_mode gating +
foreground_unsupported, and session-scoped foreground approval. Existing 265
computer_use tests still green.

Live E2E (real cua-driver 0.8.3 + tldraw offline on Linux/X11): a background click
returned effect='unverifiable'/path='ax' (no fabricated success), and a foreground
request returned code='foreground_unsupported' — correct on a driver that predates
the input.delivery_mode capability.
2026-07-18 13:59:35 -07:00
..
apple feat(computer_use): cross-platform cua-driver (macOS/Windows/Linux) 2026-06-22 06:42:30 -07:00
autonomous-ai-agents fix(webhook): make dual-stack bind exclusive 2026-07-16 12:36:51 +05:30
computer-use feat(computer_use): follow cua-driver's verify → escalate ladder (#67123) 2026-07-18 13:59:35 -07:00
creative feat(skills): expand humanizer patterns and humanize its own prose 2026-07-14 22:44:11 -04:00
data-science feat(skills): declare platforms frontmatter for all 79 undeclared built-in skills 2026-05-08 14:27:40 -07:00
dogfood feat(skills): declare platforms frontmatter for all 79 undeclared built-in skills 2026-05-08 14:27:40 -07:00
email docs(skills): fix himalaya CLI arg order and download flag 2026-06-20 20:42:49 -07:00
github fix(skills/github): resolve .env via HERMES_HOME, not hardcoded ~/.hermes 2026-06-10 15:10:11 -07:00
hermes-desktop-plugins docs(desktop): hermes-desktop-plugins skill + starter template 2026-07-13 17:57:54 -04:00
index-cache Release set of skills 2026-02-25 05:21:17 -08:00
media fix: remove dead f-string prefixes via ruff F541 (216 sites) (#52336) 2026-07-05 13:42:46 -07:00
mlops chore(skills): move red-team skills (godmode, obliteratus) to optional-skills — Anthropic classifier (#43221) 2026-06-09 21:41:00 -07:00
note-taking fix(skills): widen HERMES_HOME-aware .env resolution to all sibling skills 2026-06-10 15:10:11 -07:00
productivity docs(pets): feature guide, petdex skill + catalog 2026-06-20 14:18:43 -05:00
research docs: reconcile docs with code across last 3 releases (#54254) 2026-06-28 12:47:50 -07:00
smart-home feat(skills): declare platforms frontmatter for all 79 undeclared built-in skills 2026-05-08 14:27:40 -07:00
social-media fix(skills): document xurl X Article ingestion 2026-06-03 15:11:57 -07:00
software-development docs: sharpen software-development skills 2026-06-20 23:23:47 -07:00
yuanbao feat(skills): declare platforms frontmatter for all 79 undeclared built-in skills 2026-05-08 14:27:40 -07:00