Skip to main content

SdkAgent

Struct SdkAgent 

Source
pub struct SdkAgent(/* private fields */);
Expand description

SDK-owned emulation runtime component.

The wrapper makes ownership transfer explicit: public adapters receive an SDK component, and crate::server::RpcEngine consumes that component as the sole live-loop owner. It intentionally does not implement Deref: model/tool-loop entry points stay unreachable outside the SDK/runtime implementation boundary.

Implementations§

Source§

impl SdkAgent

Source

pub fn config(&self) -> &Config

Read the resolved runtime configuration without acquiring loop ownership.

Source

pub fn set_recorder(&mut self, writer: SidecarWriter)

Install the full-fidelity sidecar writer used by SDK persistence.

Source

pub fn set_reduction_policy(&mut self, policy: ReductionPolicy)

Install the reversible provider-view reduction policy.

Source

pub fn reduction_policy(&self) -> Option<&ReductionPolicy>

Inspect the current provider-view reduction policy.

Source

pub fn set_reduction_log(&mut self, log: ReductionLog)

Replace the reversible reduction log after an SDK-owned projection.

Source

pub fn reduction_log(&self) -> &ReductionLog

Inspect the reversible reduction log.

Source

pub fn prepare_cleared_turns_summary( &self, messages: &[ChatMessage], policy: &ReductionPolicy, prior: &ReductionLog, ) -> Option<PreparedClearSummary>

Prepare optional cleared-turn summary metadata without sending a turn.

Source

pub fn set_span_summarizer( &mut self, summarizer: impl SpanSummarizer + Send + Sync + 'static, )

Install a reduction span summarizer.

Source

pub fn set_session_titler( &mut self, titler: impl SessionTitler + Send + Sync + 'static, )

Install the optional persisted-session title generator.

Source

pub fn auto_title(&self) -> Option<String>

Generate a title from canonical history when configured.

Source

pub fn set_subagent_store( &mut self, store: Arc<SessionStore>, session_name: impl Into<String>, )

Attach a session store for SDK-owned subagent persistence.

Source

pub fn set_claude_runtime_manifest(&mut self, manifest: ClaudeRuntimeManifest)

Install restored Claude runtime state without activating a timer.

Source

pub fn claude_runtime_manifest(&self) -> Option<&ClaudeRuntimeManifest>

Inspect restored Claude runtime state.

Source

pub fn claude_runtime_manifest_mut( &mut self, ) -> Option<&mut ClaudeRuntimeManifest>

Mutate Claude runtime state from the SDK scheduler/persistence driver.

Source

pub fn restore_claude_project_agents(&mut self) -> CoreResult<usize>

Restore project-scoped Claude agent definitions after disk reload.

Source

pub fn load_session(&mut self, session: Session)

Replace canonical history with a loaded normalized session.

Source

pub fn load_transcript(&mut self, path: impl AsRef<Path>) -> CoreResult<()>

Load a Supercode transcript through the SDK component.

Source

pub fn save_transcript(&self, path: impl AsRef<Path>) -> CoreResult<()>

Save the canonical transcript through the SDK component.

Source

pub fn history(&self) -> &[ChatMessage]

Read canonical history at a quiescent boundary.

Source

pub fn rewind_to(&mut self, checkpoint: usize)

Rewind canonical history to a prior message boundary.

Source

pub fn append_system_note(&mut self, text: &str)

Append an SDK-assembled system note.

Source

pub fn register_tool(&mut self, tool: impl Tool + 'static)

Register one configured tool before transferring live-loop ownership.

Source

pub fn register_mcp_prompt( &mut self, command_name: impl Into<String>, source: impl SdkPromptSource + 'static, )

Register one MCP prompt source before transferring loop ownership.

Source

pub fn tool_schemas(&self) -> Vec<ToolSchema>

Inspect the exact next-request tool schemas for preflight measurement.

Source

pub fn set_context_limit(&mut self, limit: u64)

Arm the per-request context limit guard.

Source

pub fn context_limit(&self) -> Option<u64>

Inspect the armed context limit.

Source

pub fn set_model(&mut self, model: impl Into<String>)

Switch the next-request model at a quiescent boundary.

Source

pub fn request_issued(&self) -> bool

Whether a provider request has actually been issued.

Source

pub fn session_name(&self) -> Option<&str>

Configured durable session name.

Source

pub fn session_persist(&self) -> bool

Whether persistence is enabled for this component.

Source

pub fn git_metadata(&self) -> Option<&GitMetadataRecord>

Captured git provenance.

Source

pub fn save_git_metadata( &self, store: &SessionStore, name: &str, ) -> CoreResult<()>

Save captured git provenance.

Source

pub fn turn_count(&self) -> usize

Number of non-system canonical messages.

Source

pub fn total_output_tokens(&self) -> u64

Cumulative provider-reported output tokens.

Trait Implementations§

Source§

impl From<Agent> for SdkAgent

Source§

fn from(agent: Agent) -> Self

Converts to this type from the input type.

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> 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> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

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

Initializes a with the given initializer. Read more
Source§

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

Dereferences the given pointer. Read more
Source§

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

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

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

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

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + 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
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + 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> 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, 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.
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