Platform references
Architecture, subsystem contracts, invariants, and protocol references for the Cinatra platform. These document how the system is built; for the task-oriented authoring workflow see the Developer Guide.
Architecture & runtime
Section titled “Architecture & runtime”- Architecture — how the platform is composed: monorepo layout, runtime split, package boundaries
- Source package architecture — how a domain capability is structured as a workspace package
- LLM orchestration — the central orchestration layer over the provider SDKs
- BullMQ and agent-runtime boundary — the job-queue ↔ runtime seam
- WayFlow
InputMessageNodecontract - WayFlow
user_envelopecontract - WayFlow runtime hot-reload
Security & access
Section titled “Security & access”- Security — identities, authentication, authorization, secrets, agent execution safety
- Authorization admin powers
- Project scoping
- Extension access contract
- Extension permissions
- Extension data ownership
- Extension IoC safeguards
Objects & data
Section titled “Objects & data”- Objects: the canonical surface
- Objects layer — the typed object store, dual-write hooks, registration
- Objects surface unification
- Data safety: undo and versioning
Agents
Section titled “Agents”- Agent spec — compact Open Agent Specification (OAS) Flow
- Agent packaging
- ensureAgentPackage
- Chat agent authoring review
Extensions
Section titled “Extensions”- Extensions — the extension system end to end
- Extension kinds — choose your kind — the per-kind authoring landing page
- Extension SDK ABI and dependencies — the frozen author-facing ABI, the dependency rules, and the schema-migration contract
- The runtime-store
serverEntrycontract — built-artifact resolution, dependency modes, and the operator refresh runbook - Extension-coupling audit gates — the zero-floor IoC end-state, classification, and exemption policy
- Extension lifecycle and distribution
- Extension README contract
- Extension dev fixtures
Per-kind authoring guides
Section titled “Per-kind authoring guides”- Authoring agent extensions
- Authoring connector extensions
- Authoring artifact extensions
- Authoring skill extensions
- Authoring workflow extensions
Connectors
Section titled “Connectors”- Integrating Cinatra with a CMS
- CRM connector — the provider-neutral CRM facade (Twenty)
- PM connector — the provider-neutral project-management facade for mirroring agent-run schedules (Plane)
- Email connector
- Blog and social-media connectors
- Drupal connector
Artifacts
Section titled “Artifacts”- Artifacts — architecture, threat model and invariants
- Artifacts — LLM attachments and prompt-window upload
- Artifacts — preflight and legacy-media purge gate
Workflows & dashboards
Section titled “Workflows & dashboards”- Workflow extension doctrine
- Workflow extensions as app surfaces
- Cinatra BPMN Profile 1.0
- Dashboards platform
- Release workflows
- Notifications
Skills
Section titled “Skills”- Skills lifecycle — states, revisions, content authority, catalog rebuilds
- Skill matching
- Skills storage layout
- Shell skills
Open standards & protocols
Section titled “Open standards & protocols”- Open standards in Cinatra — A2A, AG-UI, A2UI, OAS
- A2UI usage in Cinatra
- Cross-instance collaboration
Testing & CI
Section titled “Testing & CI”Docs content licensed under CC-BY-4.0; embedded code snippets under Apache-2.0.