orchestrata_ultimate.integrations

Reference › orchestrata_ultimate › integrations

Integration adapters for external APIs and services.

The integrations package holds adapters at the boundary between Orchestrata and two external systems, and is deliberately small. One adapter pulls knowledge in from the Fireflies service; the other lets an external terminal UI, CheetahClaws, drive Orchestrata's agents. The hand-written story is integrations.

The Fireflies pair: fireflies_client is an async GraphQL client that degrades to empty results when no key is set or a call fails, and fireflies_sync upserts what it fetches into the knowledge graph as idempotent :Document nodes. Both serve specification 018 and are used by the gateway's Fireflies handler. The CheetahClaws side is the cheetahclaws subpackage (specification 050), used by the gateway's terminal UI handler. init is an empty marker.

Data flows inward on the Fireflies side (service, client, sync, graph) and command flows inward on the CheetahClaws side (slash command, governance gate, agents over CXP). Start reading at fireflies_client for the first, and at UltimateTUI in cheetahclaws for the second.

Curated narrative

The hand-written story of this package: orchestrata_ultimate.integrations.

4 modules, 1,099 lines of code.

Subpackages

Package Modules LOC
cheetahclaws 1 524

Modules

Module Summary LOC
__init__ Integration adapters for external APIs and services. 1
fireflies_client Async GraphQL client for the Fireflies API. 454
fireflies_sync Write-side Fireflies → knowledge-graph sync (SPEC-018). 120

Dependency diagram

Package dependency diagram orchestrata_ultimate.integrations