Skip to main content

AgentServiceV1

Struct AgentServiceV1 

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

Production service facade for exact-version durable Agent submission, authorization-first reads, and two-phase cancellation.

Implementations§

Source§

impl AgentServiceV1

Source

pub async fn load_activity( &self, caller: AgentServiceCaller, run_id: RunId, after: Option<&JournalHead>, ) -> Result<AgentRunActivityPage, AgentServiceError>

Authorizes before verifying an Agent and reading one exact journal suffix.

A one-event page bounds private payload materialization in the store. No cursor starts at sequence one. The store checks a supplied head against the retained event; it never treats caller metadata as trusted authority. Snapshots may coalesce transitions and must not be interpreted at the head.

§Errors

Denial precedes existence/cursor validation. Missing history, changed scope or any mismatch fails closed rather than silently restarting replay.

Source§

impl AgentServiceV1

Source

pub async fn check_readiness(&self) -> Result<(), AgentServiceReadinessError>

Checks frozen Agent/executable bindings and the actual store’s schema.

Read-only and unauthenticated: this is a trusted host operation, not a business endpoint. Does not call initial-state factories, policy decisions, or executors. The host must separately check identity/policy dependencies, bound this future, and qualify database role privileges before deployment. Readiness is an observation, not a guarantee of future request success.

§Errors

Rejects empty/drifted/missing executable deployments or unavailable schema.

Source§

impl AgentServiceV1

Source

pub fn new( store: PostgresStore, executable: ExecutableGraphRegistry, deployments: AgentServiceRegistry, authorizer: Arc<dyn AgentServiceAuthorizer>, ) -> Result<Self, AgentServiceBuildError>

Binds one durable provider, executable deployment, public Agent registry, and mandatory authorizer.

§Errors

Rejects malformed embedded schemas or a deployment registry that omitted either the admission or service-control schema.

Source

pub fn submit<'service>( &'service self, caller: AgentServiceCaller, key: &'service AgentSubmissionKey, agent: &'service CapabilityIdentity, request: AgentRequest, ) -> BoxFuture<'service, Result<AgentRunAdmissionOutcome, AgentServiceError>>

Authorizes and durably submits one exact Agent version under a tenant-scoped idempotency key.

Candidate run/checkpoint/event identities and initial state are generated only after authorization grants the request. Lost acknowledgements are recovered by calling this method again with the same key and content.

§Errors

Returns closed registry, authorization, state, admission, or storage failures. No process-local execution path can bypass durable admission.

Source

pub async fn load( &self, caller: AgentServiceCaller, run_id: RunId, ) -> Result<AgentRunSnapshot, AgentServiceError>

Authorizes before loading one tenant-scoped public run snapshot.

§Errors

Authorization failures precede and therefore hide not-found results.

Source

pub async fn load_by_key( &self, caller: AgentServiceCaller, key: &AgentSubmissionKey, ) -> Result<AgentRunSnapshot, AgentServiceError>

Authorizes before resolving an opaque submission key to a public run.

§Errors

Authorization failures precede and therefore hide key existence.

Source

pub async fn request_cancellation( &self, caller: AgentServiceCaller, run_id: RunId, ids: AgentCancellationIds, ) -> Result<AgentCancellationOutcome, AgentServiceError>

Authorizes and atomically commits cancellation intent before workers cooperatively stop and the durable lifecycle confirms cancellation.

Waiting runs abandon every outstanding interrupt/timer in the same transaction. Active runs append the request and lifecycle projection in one transaction. A retry with the same AgentCancellationIds returns idempotently after either request or final confirmation has committed.

§Errors

Returns authorization, terminal/conflicting cancellation, schema, optimistic concurrency, integrity, or database failures.

Trait Implementations§

Source§

impl Clone for AgentServiceV1

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for AgentServiceV1

Source§

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

Formats the value using the given formatter. 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<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

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

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

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
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

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

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

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.
Source§

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

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

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
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

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