Skip to main content

WorkflowService

Struct WorkflowService 

Source
pub struct WorkflowService { /* private fields */ }
Expand description

WorkflowService handles workflow orchestration

Discovers workflows from repositories, subscribes to events, and routes job execution through WorkflowRunner (#527): jobs requesting isolation via runs_on: are scheduled onto a sandbox through the #525 P2 admission engine (SandboxPool::acquire, see workflow::scheduler); others run in-process over the VFS/Tcl bridge. There is no WorkerService dependency here — WorkflowRunner talks to SandboxPool directly.

Implementations§

Source§

impl WorkflowService

Source

pub fn new(transport: TransportConfig, signing_key: SigningKey) -> Self

Create a new WorkflowService

§Arguments
  • transport - Transport configuration for service binding
  • signing_key - Signing key for message authentication
Source

pub async fn register_repo_path( &self, repo_id: impl Into<String>, path: PathBuf, )

Register the filesystem root for a repo_id.

Once registered, scan_repo(repo_id) will glob <root>/.github/workflows/*.yml to discover workflows.

Source

pub async fn set_repo_mode(&self, repo_id: &str, mode: ParseMode)

Set the per-repo parse mode (#1432).

Acquires the per-repo serialization lock so that mode changes are atomic with concurrent rescans. A gate that loads a repo in strict mode records it here so that later rescans retain strict (the default for an unregistered repo is [ParseMode::Legacy]). Typically called by GitHubActionsAdapter::load_repo_with.

Source

pub fn set_namespace(&mut self, ns: Arc<Namespace>)

Set the VFS namespace for workflow execution.

This creates a WorkflowRunner that resolves actions through /bin/ and evaluates scripts via TclShell, using default crate::config::WorkflowConfig timeouts/concurrency and no job scheduler (every job runs in-proc — see Self::set_job_scheduler).

Source

pub fn set_namespace_with_config( &mut self, ns: Arc<Namespace>, config: &WorkflowConfig, )

Like Self::set_namespace, but honors config’s max_concurrent_runs / job_timeout_secs / step_timeout_secs (#521) instead of defaults.

Source

pub fn set_job_scheduler(&mut self, scheduler: Arc<JobScheduler>)

Attach a JobScheduler (#527) so jobs whose runs_on: requests isolation are placed onto a real sandbox through the #525 P2 admission engine, instead of always running in-proc. Must be called after set_namespace/set_namespace_with_config; a no-op (with a warning) if no runner has been configured yet.

Source

pub fn set_authorize_fn(&mut self, authorize_fn: AuthorizeFn)

Set the authorization callback for policy checks.

Source

pub fn set_expected_audience(&mut self, audience: String)

Set the expected JWT audience for envelope-verification-time validation (mirrors WorkerService::set_expected_audience). Fed by the factory from the OAuth issuer URL so JWT-authenticated IPC/QUIC requests are accepted before the per-request policy check.

Source

pub fn set_jwt_key_source(&mut self, src: Arc<dyn JwtKeySource>)

Set the JWT verification key source (local + federated). Fed by the factory from the cluster key source.

Source

pub fn set_relay_authorizer( &mut self, authorizer: Arc<dyn Fn(&[u8; 32]) -> bool + Send + Sync>, )

Inject a live MCP relay authorizer so accept_delegated_bearer consults current MCP-scope authorization at call time (not a frozen snapshot — retired keys are rejected, new keys accepted after factory start). The factory typically passes a closure over the global trust store’s is_authorized(key, "mcp"). None (never called) ⇒ fail-closed.

Source

pub async fn initialize(&self) -> Result<()>

Initialize the service: scan all registered repos and register their workflows.

Source

pub async fn start(self: Arc<Self>) -> Result<()>

Start the event subscription loop

Subscribes to worker events and routes them to registered handlers. This spawns a background task that runs until stop() is called.

Source

pub async fn stop(&self)

Stop the event subscription loop

Source

pub async fn register_handler(&self, handler: Box<dyn EventHandler>)

Register an event handler

Source

pub async fn list_workflows(&self) -> Result<Vec<WorkflowInfo>>

List registered workflows (returns wire-format types directly)

Source

pub async fn rescan_repo(&self, repo_id: &str) -> Result<()>

Rescan a repository for workflow changes (generic, non-persisting).

Resolves the per-repo parse mode and rescans in that mode, but does not write the mode back to the store. This is the entry point used by the event-triggered rescan path (HandlerResult::Rescan) and initialize. Because it never persists, a concurrent generic rescan that read a stale [ParseMode::Legacy] before a gate selected strict cannot overwrite the newer strict selection (#1432 race fix): only the explicit boundaries (Self::rescan_repo_with, load_repo_with) write the mode.

Source

pub async fn rescan_repo_with( &self, repo_id: &str, mode: ParseMode, ) -> Result<()>

Rescan a repository with an explicit [ParseMode] (#1432 boundary).

Persists the mode per-repo (via Self::set_repo_mode) so that later event-triggered rescans through the generic Self::rescan_repo retain it. Both rescan_repo and this method hold the per-repo serialization lock from mode decision through registry commit, making the scan→commit window atomic per repo (#1432 race fix: a stale Legacy scan cannot yield between its mode check and commit while a Strict selection lands in between).

Source

pub async fn start_adapter( self: &Arc<Self>, adapter: Box<dyn SubscriberAdapter>, ) -> CancellationToken

Start a subscriber adapter. Returns a CancellationToken to stop it.

The adapter runs in a background task that receives events and dispatches workflows. Cancel the returned token to stop the adapter.

Trait Implementations§

Source§

impl RequestService for WorkflowService

Source§

fn accept_delegated_bearer(&self, signer_pubkey: &[u8; 32]) -> bool

Accept delegated-bearer requests by consulting the live MCP relay authorizer (#989 review). verify_claims calls this before policy; the default false rejects all relayed caller tokens. We delegate to the injected authorizer (which checks current MCP-scope authorization) — fail-closed when no authorizer is set.

Source§

fn decode_request_body(&self, signed_body: &[u8]) -> Result<DecodedRequestBody>

Decode the signed request body exactly once (bounded) and derive the full numeric method leaf path (v16 §5.2 step 4). Read more
Source§

fn handle_request<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, ctx: &'life1 EnvelopeContext, body: &'life2 DecodedRequestBody, ) -> Pin<Box<dyn Future<Output = AnyhowResult<(Vec<u8>, Option<Continuation>)>> + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Process a request and return a response with optional continuation. Read more
Source§

fn name(&self) -> &str

Service name (for logging and registry).
Source§

fn transport(&self) -> &TransportConfig

Transport configuration (endpoint binding).
Source§

fn signing_key(&self) -> SigningKey

Ed25519 signing key for signing responses.
Source§

fn expected_audience(&self) -> Option<&str>

Expected audience (resource URL) for JWT validation. Read more
Source§

fn jwt_key_source(&self) -> Option<Arc<dyn JwtKeySource>>

JWT key source for token verification. Read more
Source§

fn producer_reach_config_handle( &self, ) -> Option<Arc<RwLock<RawRwLock, ProducerReachConfig>>>

Mutable reach source filled by the unified service spawner after the service’s QUIC and iroh listeners bind.
Source§

fn moq_origin_handle( &self, ) -> Option<Arc<RwLock<RawRwLock, Option<MoqStreamOrigin>>>>

Optional per-service MoQ origin source. The unified spawner installs a scoped origin here when this service has a relay configured.
Source§

fn pq_signing_key(&self) -> Option<SigningKey<MlDsa65>>

ML-DSA-65 signing key for the post-quantum half of the response COSE composite (#275). Returning None makes process_request fail closed before dispatch; it never selects an EdDSA-only response. The matching ML-DSA-65 public key must be anchored in the client’s PQ trust store for Hybrid verification to succeed (peer attestation). Read more
Source§

fn verifying_key(&self) -> VerifyingKey

Ed25519 verifying key for envelope signature verification.
Source§

fn delegated_user_audience( &self, _signer_pubkey: &[u8; 32], _untrusted_aud: Option<&str>, ) -> Option<&str>

Select an exact, configured audience for an already-admitted delegated user bearer. The unverified claim is only a selector: implementations must return their own configured string, never a borrowed token value. Direct and service credentials always use expected_audience instead.
Source§

fn accept_delegated_resource_leaf( &self, _ctx: &EnvelopeContext, _body: &DecodedRequestBody, ) -> bool

Admit a non-native resource bearer only for a decoded signed request leaf. Default denial preserves every service’s native issuer boundary.
Source§

fn require_cnf_binding(&self) -> bool

Whether to reject JWTs that lack a cnf key binding (jwk or jkt). Read more
Source§

fn credential_revocation_store(&self) -> Option<&dyn CredentialRevocationStore>

Credential revocation store for access token revocation. Read more
Source§

fn jwt_verify_policy(&self) -> CryptoPolicy

Fu4/#677: the minimum JWT alg policy enforced in verify_claims. Read more
Source§

fn resolve_key_subject(&self, signer_pubkey: &[u8; 32]) -> Option<Subject>

Resolve a verified signer key to an authorization subject (#446). Read more
Source§

fn cache_key_binding( &self, _verifying_key: VerifyingKey, _subject: &str, _jwt: &str, _expires_at: i64, )

Cache a verified key→subject binding in the trust store. Read more
Source§

fn accept_deferred_federate_credential(&self) -> bool

Opt in only when this serving instance has a complete request-local holder-proof, current-primary and durable Policy-use adapter. Default false preserves the generic verifier’s reserved-profile denial.
Source§

fn admit_deferred_federate_request<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, _ctx: &'life1 EnvelopeContext, _body: &'life2 DecodedRequestBody, _proof: &'life3 ParsedProof, ) -> Pin<Box<dyn Future<Output = Result<(VerifiedProof, [u8; 32], String, String, ProofReplayKey, u64), Error>> + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, Self: 'async_trait,

Verify the original holder’s proof and bind it to the exact decoded body/leaf/resource/action before identity publication. This stage must not consume replay state: generated method-policy and MAC authorization still run afterward. Durable Policy admission happens in commit_deferred_federate_request only after those gates pass.
Source§

fn commit_deferred_federate_request<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>( &'life0 self, _ctx: &'life1 EnvelopeContext, _resource: &'life2 str, _operation: &'life3 str, _replay_key: &'life4 ProofReplayKey, _replay_expiry: u64, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait, Self: 'async_trait,

Perform fresh Policy admission and durable replay consumption after the generated method-policy and mandatory MAC gates, immediately before handler dispatch. Implementations must fail closed if the durable admission service is unavailable. The default never admits a request.
Source§

fn verify_internal_work_bearer<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, _ctx: &'life1 EnvelopeContext, _token: &'life2 str, _protected: &'life3 ProtectedHeader, ) -> Pin<Box<dyn Future<Output = Result<InternalWorkClaims, Error>> + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, Self: 'async_trait,

Verify an iw+jwt internal execution work order presented as the direct JWT (single-service Model→Inference boundary, user-approved D5). Read more
Source§

fn verify_claims<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 mut EnvelopeContext, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

E2E JWT verification with unified key source. Read more
Source§

fn build_error_payload(&self, request_id: u64, error: &str) -> Vec<u8> ⓘ

Build a generic error response payload for unexpected errors. Read more
Source§

impl WorkflowHandler for WorkflowService

Source§

fn authorize<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, ctx: &'life1 EnvelopeContext, resource: &'life2 str, operation: &'life3 str, ) -> Pin<Box<dyn Future<Output = AnyhowResult<()>> + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Authorize an operation on a resource. Override to enforce policy. Read more
Source§

fn handle_scan_repo<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _ctx: &'life1 EnvelopeContext, _request_id: u64, repo_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = AnyhowResult<WorkflowResponseVariant>> + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Handle scanRepo request.
Source§

fn handle_register<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _ctx: &'life1 EnvelopeContext, _request_id: u64, data: &'life2 WorkflowDefWire, ) -> Pin<Box<dyn Future<Output = AnyhowResult<WorkflowResponseVariant>> + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Handle register request.
Source§

fn handle_list<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 EnvelopeContext, _request_id: u64, ) -> Pin<Box<dyn Future<Output = AnyhowResult<WorkflowResponseVariant>> + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handle list request.
Source§

fn handle_dispatch<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, ctx: &'life1 EnvelopeContext, _request_id: u64, request: &'life2 DispatchRequest, ) -> Pin<Box<dyn Future<Output = AnyhowResult<WorkflowResponseVariant>> + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Handle dispatch request.
Source§

fn handle_subscribe<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _ctx: &'life1 EnvelopeContext, _request_id: u64, request: &'life2 SubscribeRequest, ) -> Pin<Box<dyn Future<Output = AnyhowResult<WorkflowResponseVariant>> + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Handle subscribe request.
Source§

fn handle_unsubscribe<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _ctx: &'life1 EnvelopeContext, _request_id: u64, sub_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = AnyhowResult<WorkflowResponseVariant>> + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Handle unsubscribe request.
Source§

fn handle_get_run<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _ctx: &'life1 EnvelopeContext, _request_id: u64, run_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = AnyhowResult<WorkflowResponseVariant>> + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Handle getRun request.
Source§

fn handle_list_runs<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _ctx: &'life1 EnvelopeContext, _request_id: u64, workflow_id: &'life2 str, ) -> Pin<Box<dyn Future<Output = AnyhowResult<WorkflowResponseVariant>> + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Handle listRuns request.
Source§

fn is_resource_authorized<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, ctx: &'life1 EnvelopeContext, resource: &'life2 str, operation: &'life3 str, ) -> Pin<Box<dyn Future<Output = bool> + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Check if a specific resource+operation is authorized (non-failing). Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
§

impl<T> ServiceExt for T

§

fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>
where Self: Sized,

Apply a transformation to the response body. Read more
§

fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using HTTP status codes. Read more
§

fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using gRPC headers. Read more
§

fn follow_redirects(self) -> FollowRedirect<Self>
where Self: Sized,

Follow redirect resposes using the Standard policy. Read more
Source§

impl<S> Spawnable for S
where S: RequestService + Send + Sync,

Source§

fn name(&self) -> &str

Service name (for logging and registry).
Source§

fn registrations(&self) -> Vec<(SocketKind, TransportConfig)>

Endpoints to register with EndpointRegistry. Read more
Source§

fn run( self: Box<S>, shutdown: Arc<Notify>, on_ready: Option<Sender<()>>, ) -> Result<(), RpcError>

Run the service on current thread (blocking). Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSync for T
where T: Sync,

§

impl<T> MaybeSync for T
where T: Sync,