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 |