Skip to main content

aria_operator/
dispatch.rs

1//! Worker dispatch: one catalog row is one host capability (Spawning S6).
2//!
3//! The Judge/Coordinator points a worker at exactly one of these endpoints.
4//! The worker does not choose the next binary. It execs this crate's bin,
5//! passes unstructured JSON, and must receive a closed operator envelope.
6
7use crate::envelope::OperatorSpec;
8
9/// How a Mode 4 worker invokes one catalog binary.
10#[derive(Debug, Clone, PartialEq, Eq)]
11pub struct WorkerEndpoint {
12    /// `BIN.*` — the work definition on the sealed plan.
13    pub binary_id: String,
14    /// Operator name on the closed envelope.
15    pub operator: String,
16    /// Cargo package (`cargo run -p`).
17    pub package: String,
18    /// Catalog crate field (underscored).
19    pub crate_name: String,
20    /// Plan `resultDefinitionRef` this binary is allowed to satisfy.
21    pub result_definition_ref: String,
22    /// Family / HOST / TRANSFORM / RESIDUAL / DEEP_TAG.
23    pub layer: String,
24}
25
26impl WorkerEndpoint {
27    /// `cargo run -p <package>` — the process a worker execs.
28    #[must_use]
29    pub fn cargo_invoke(&self) -> String {
30        format!("cargo run -p {}", self.package)
31    }
32}
33
34impl From<&OperatorSpec> for WorkerEndpoint {
35    fn from(spec: &OperatorSpec) -> Self {
36        Self {
37            binary_id: spec.binary_id.clone(),
38            operator: spec.operator.clone(),
39            package: spec.package.clone(),
40            crate_name: spec.crate_name.clone(),
41            result_definition_ref: spec.result_definition_ref.clone(),
42            layer: spec.layer.clone(),
43        }
44    }
45}
46
47/// Point a worker at a `BIN.*` work definition.
48#[must_use]
49pub fn endpoint_by_binary_id(binary_id: &str) -> Option<WorkerEndpoint> {
50    crate::spec_by_id(binary_id).map(WorkerEndpoint::from)
51}
52
53/// Point a worker at a catalog operator name (`PEOPLE`, `TAG.PERSON_FOUNDER`, …).
54#[must_use]
55pub fn endpoint_by_operator(operator: &str) -> Option<WorkerEndpoint> {
56    crate::spec_by_operator(operator).map(WorkerEndpoint::from)
57}
58
59/// Point a worker at a cargo package (`aria-telemetry-people`).
60#[must_use]
61pub fn endpoint_by_package(package: &str) -> Option<WorkerEndpoint> {
62    crate::spec_by_package(package).map(WorkerEndpoint::from)
63}