How akadaan310/ora works
ORA is a model-free engine with an HTTP service and Python/TypeScript clients. The main workflow is an owner or script creating an ORA, explicitly reviewing and activating it, submitting a granted mission, and retrieving its result; the engine records transitions and mission events in a hash-chained SQLite ledger. The graph also includes documented catalog, PURL, listener, and native-kernel capabilities. Source excerpts establish the HTTP-to-engine and native-call paths; unsampled subsystems are included only where README capabilities support them.
Main entry points: engine.py Engine · app.py HTTP service · ora_client.py Python SDK · ora.ts TypeScript SDK
Components 16
Client and API
- Python SDK
sdk/python/ora_client.py - TypeScript SDK
sdk/typescript/ora.ts - HTTP service
service/app.py
ORA Runtime
- Engine
service/engine.py - ORA lifecycle
service/engine.py - Mission worker
service/engine.py - Mission capabilities
service/engine.py - Event listener
service/engine.py - SQLite event ledger
service/engine.py
Native Kernel
- Native bridge
service/native.py - C ABI
src/c_api.cpp - C++ primitives
src/tower.cpp - Kernel interfaces
include/ora/tower.hpp
Catalog and Protocol
- Candidate catalog
catalog/160_candidates.json - PURL preview
service/engine.py
Other components
- Owner or script
Connections 16
- Owner or script → Python SDK: uses
README.md - Owner or script → TypeScript SDK: uses
README.md - Python SDK → HTTP service: calls HTTP
sdk/python/ora_client.py - TypeScript SDK → HTTP service: calls HTTP
sdk/typescript/ora.ts - HTTP service → Engine: routes requests
service/app.py - HTTP service → Candidate catalog: reads candidates
service/app.py - HTTP service → PURL preview: compiles previews
service/app.py - Engine → ORA lifecycle: creates and transitions
service/engine.py - Engine → Mission worker: queues missions
service/engine.py - Mission worker → Mission capabilities: dispatches missions
service/engine.py - Engine → Event listener: handles observations
service/app.py - Engine → SQLite event ledger: reads and writes
service/engine.py - Mission capabilities → Native bridge: uses for scenes
service/engine.py - Native bridge → C ABI: calls ABI
service/native.py - C ABI → C++ primitives: calls primitives
src/c_api.cpp - C++ primitives → Kernel interfaces: implements
src/tower.cpp