agent-desktop-ffi

Direct C-ABI bindings to the agent-desktop PlatformAdapter allow low-level application interaction via OS accessibility trees, eliminating the overhead of spawning a CLI binary per call. You link to libagent_desktop_ffi and invoke ad_* functions directly.

The observe-act workflow uses ad_init for initialization, ad_snapshot to capture state, ad_execute_by_ref to perform actions, and ad_free_string to release memory. This canonical sequence manages low-level application interaction through the PlatformAdapter.

Yes, macOS requires all adapter-touching entrypoints to be called from the main thread. This constraint ensures stable low-level application interaction and proper communication with the OS accessibility tree.

You persist refmaps by managing session namespaces with ad_adapter_create_with_session. This function initializes a dedicated session adapter that maintains refmap state for consistent low-level application interaction.

Yes, structured session tracing enables file-based JSONL tracing for debugging and analysis. This records the C-ABI application interaction calls made through the PlatformAdapter, allowing you to inspect the execution flow.

Using these C-ABI bindings requires agent-desktop installed and a C-ABI compatible environment. It is designed for advanced users familiar with C-ABI and application accessibility concepts.