Struct SubmitQuery 

pub struct SubmitQuery {
    pub ok: Option<bool>,
    pub verdict: Option<String>,
}

POST /v1/worker/submit. Bearer = encoded CapToken. Body = raw text/octet.

Simplification-axis endpoint for SubAgents. Removes the JSON construction, duplicated task_id, and JSON-escape burden of /v1/worker/result — the worker completes a POST with just token + raw body. Origin: the recent clean-up of the SubAgent contract drift (fewer IDs to pass around, multi-line escape accidents eliminated).

GH #42 @file: sentinel: workers whose result body is too large to re-emit inline (multi-KB structured output) may Write the payload to a file under their task’s work_dir and submit the body @file:<abs-path> instead — see [resolve_file_sentinel]. Non-sentinel bodies pass through unchanged. The step must opt in via allow_file_submit: true (GH #43, default-deny — see [FILE_SENTINEL_ALLOW_KEY]).

submit_format: "json" opt-in: a step whose meta channel declares [SUBMIT_FORMAT_KEY] as "json" gets its final body parsed into a structured Value before it is folded into the flow ctx, so a downstream fanout / branch can address fields inside it. Applied after sentinel resolution (so the two combine), declared-strict (unparseable → 422), default-deny for every undeclared step — see [resolve_submit_value].

Behavior:

• task_id is auto-looked-up server-side from the token (already bound to the CapToken).
• Body raw bytes go as-is into Value::String for submit_output + post_result (unless the step declared submit_format: "json", above).
• ok=true fixed (= the submit endpoint is success-path only). For the error path, use /v1/worker/result with an explicit ok=false.

Fields

ok: Option<bool>

Optional. ok=false signals failure (= DispatchOutcome::Blocked, caught by the flow.ir Try path). Unspecified (None) is treated as ok=true (= normal success).

verdict: Option<String>

GH #76 HTTP wire: opt-in verdict tier selector. When absent, ok alone drives the tier (pre-#76 byte-for-byte behavior: ok=true|absent → Pass, ok=false → Blocked). When present, must be one of "pass", "blocked", "skip" — anything else returns 400. verdict=skip requires ok to be absent or true: an explicit verdict=skip&ok=false is a conflicting signal and also returns 400. verdict=pass / verdict=blocked semantics match the corresponding ok boolean; a verdict=pass&ok=false or verdict=blocked&ok=true combination is also a conflict → 400.

Trait Implementations

impl Debug for SubmitQuery

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SubmitQuery

fn default() -> SubmitQuery

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SubmitQuery

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.