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
impl AgentServiceV1
Sourcepub async fn load_activity(
&self,
caller: AgentServiceCaller,
run_id: RunId,
after: Option<&JournalHead>,
) -> Result<AgentRunActivityPage, AgentServiceError>
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
impl AgentServiceV1
Sourcepub async fn check_readiness(&self) -> Result<(), AgentServiceReadinessError>
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
impl AgentServiceV1
Sourcepub fn new(
store: PostgresStore,
executable: ExecutableGraphRegistry,
deployments: AgentServiceRegistry,
authorizer: Arc<dyn AgentServiceAuthorizer>,
) -> Result<Self, AgentServiceBuildError>
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.
Sourcepub fn submit<'service>(
&'service self,
caller: AgentServiceCaller,
key: &'service AgentSubmissionKey,
agent: &'service CapabilityIdentity,
request: AgentRequest,
) -> BoxFuture<'service, Result<AgentRunAdmissionOutcome, AgentServiceError>>
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.
Sourcepub async fn load(
&self,
caller: AgentServiceCaller,
run_id: RunId,
) -> Result<AgentRunSnapshot, AgentServiceError>
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.
Sourcepub async fn load_by_key(
&self,
caller: AgentServiceCaller,
key: &AgentSubmissionKey,
) -> Result<AgentRunSnapshot, AgentServiceError>
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.
Sourcepub async fn request_cancellation(
&self,
caller: AgentServiceCaller,
run_id: RunId,
ids: AgentCancellationIds,
) -> Result<AgentCancellationOutcome, AgentServiceError>
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
impl Clone for AgentServiceV1
Auto Trait Implementations§
impl !RefUnwindSafe for AgentServiceV1
impl !UnwindSafe for AgentServiceV1
impl Forget for AgentServiceV1
impl Freeze for AgentServiceV1
impl Move for AgentServiceV1
impl Send for AgentServiceV1
impl Sync for AgentServiceV1
impl Unpin for AgentServiceV1
impl UnsafeUnpin for AgentServiceV1
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
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 moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
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