agent-desktop-ffi

What problem does it solve?

This Skill provides direct C-ABI bindings to agent-desktop's PlatformAdapter, allowing for low-level interaction with applications via OS accessibility trees, without the need for spawning the CLI binary per call.

Core Features & Use Cases

• C-ABI Bindings: Consumers can link to libagent_desktop_ffi and call ad_* functions directly.
• Observe-Act Workflow: Supports the canonical observe-act workflow with ad_init, ad_snapshot, ad_execute_by_ref, and ad_free_string.
• Session Adapters: Manages session namespaces for refmap persistence using ad_adapter_create_with_session.
• Structured Session Trace: Enables file-based JSONL tracing for debugging and analysis.
• Main Thread Requirement: Ensures that all adapter-touching entrypoints are called from the main thread on macOS.

Quick Start

Initialize the adapter and create a session:

ad_init(AD_ABI_VERSION_MAJOR)
adapter = ad_adapter_create_with_session("s1")