Integration Recipes
Implementation-backed request and execution patterns
Recipe: End-to-End Runtime Request
- Host/runtime handshake establishes limits.
- Client sends REQ with cap URN.
- Input streams arrive via STREAM_START/CHUNK/STREAM_END.
- Plugin returns output stream(s) and END.
Failure path: invalid frames or routing mismatches produce ERR and terminate request flow.
Recipe: Graph Execution (Macino)
- Build execution DAG from cap graph.
- Run independent branches in parallel where possible.
- Fan-in nodes wait for all upstream dependencies.
- Cycle detection rejects invalid graphs before execution.
Recipe: Missing Capability
If no cap accepts the request URN, registry/host returns an explicit no-handler error.
Test Anchors
capdag/src/bifaci/integration_tests.rs:163capdag/src/bifaci/in_process_host.rs:610,capdag/src/bifaci/in_process_host.rs:687,capdag/src/bifaci/in_process_host.rs:843capdag/macino/tests/testcartridge_integration.rs:150,capdag/macino/tests/testcartridge_integration.rs:310,capdag/macino/tests/testcartridge_integration.rs:354,capdag/macino/tests/testcartridge_integration.rs:413