Struct Daemon 

pub struct Daemon { /* private fields */ }

Shared daemon state. Cheap to clone (it’s an Arc inside).

Implementations

impl Daemon

pub fn skill_list(&self, session_id: &str) -> Result<SkillListResponse>

List skills available in skills_dir. Execution dispatch lands in M6.

pub fn skill_show( &self, session_id: &str, name: &str, ) -> Result<SkillShowResponse>

Show the SKILL.md for a named skill.

pub fn capture( &self, session_id: &str, page_id: &str, scope: CaptureScope, ) -> Result<CaptureResponse>

Take a screenshot. Returns the on-disk path; bytes are not inlined per docs/PROTOCOL.md.

pub fn viewport( &self, session_id: &str, page_id: &str, viewport: Viewport, ) -> Result<ViewportResponse>

Set the page viewport. Triggers a fresh-full re-baseline on the next vs_view (the protocol’s ? viewport_changed warning is the agent-visible cue).

pub fn layout( &self, session_id: &str, page_id: &str, refs: Vec<Ref>, ) -> Result<LayoutResponse>

pub fn auth_save( &self, session_id: &str, page_id: &str, name: &str, ) -> Result<AuthSaveResponse>

pub fn auth_load( &self, session_id: &str, page_id: &str, name: &str, ) -> Result<AuthLoadResponse>

pub fn auth_list(&self, session_id: &str) -> Result<AuthListResponse>

pub fn auth_clear( &self, session_id: &str, name: &str, ) -> Result<AuthClearResponse>

impl Daemon

pub fn session_open(&self, policy: Option<&str>) -> Result<SessionOpenResponse>

Open a fresh session. Returns the new id and a synthetic empty session-scoped state token (0000…); page-scoped tokens come from vs_open.

pub fn session_close(&self, session_id: &str) -> Result<SessionCloseResponse>

pub fn open(&self, session_id: &str, url: &str) -> Result<OpenResponse>

pub fn close(&self, session_id: &str, page_id: &str) -> Result<CloseResponse>

impl Daemon

pub fn view( &self, session_id: &str, page_id: &str, force_full: bool, ) -> Result<ViewResponse>

pub fn read( &self, session_id: &str, page_id: &str, r: Ref, ) -> Result<ReadResponse>

pub fn act(&self, call: ActCall) -> Result<ActResponse>

pub fn find(&self, session_id: &str, query: &str) -> Result<FindResponse>

pub fn wait( &self, session_id: &str, page_id: &str, cond: EngineWait, budget: Duration, ) -> Result<WaitResponse>

pub fn status(&self, session_id_opt: Option<&str>) -> Result<StatusResponse>

Single-block summary: open pages, recent actions, total counts. session_id_opt = None returns a workspace-wide summary.

impl Daemon

pub fn extract( &self, session_id: &str, page_id: &str, schema: &str, before_token: StateToken, ) -> Result<ExtractResponse>

Extract structured data from a page using a known schema.

pub fn mark( &self, session_id: &str, page_id: &str, r: Ref, name: &str, before_token: StateToken, ) -> Result<MarkResponse>

Persist r as a named anchor in the session.

pub fn annotate( &self, session_id: &str, target: &AnnotationTarget, key: &str, value: Option<&str>, ) -> Result<AnnotateResponse>

Attach (key, value) to target.

pub fn log( &self, session_id: &str, page_id: Option<String>, group_label: Option<String>, since_started_at: Option<i64>, limit: Option<i64>, ) -> Result<LogResponse>

Slice the audit log for the session.

impl Daemon

pub fn new(store: Store, engine: Arc<EngineRuntime>) -> Self

Build a daemon around an existing store and engine. Optional fields default to sensible values; tune via the with_* chain.

pub fn with_captures_dir(self, dir: impl Into<PathBuf>) -> Self

Pin the on-disk path where vs_capture writes images. Must run before the daemon is Arc::cloned.

pub fn with_skills_dir(self, dir: impl Into<PathBuf>) -> Self

Pin the on-disk path where vs_skill looks up composed skills.

pub fn with_master_key(self, key: MasterKey) -> Self

Pin the master key used by vs_auth save|load. Without this, auth-modifying primitives return BadRequest "no master key".

pub fn inspect_console( &self, session_id: &str, page_id: &str, ) -> Result<Vec<ConsoleEntry>>

Snapshot the engine’s console ring buffer for page.

pub fn inspect_network( &self, session_id: &str, page_id: &str, ) -> Result<Vec<NetworkEntry>>

Snapshot the engine’s network ring buffer for page.

pub fn inspect_request( &self, session_id: &str, page_id: &str, seq: u64, ) -> Result<Option<RequestDetail>>

Look up the full detail (headers + bodies) for a captured network request by seq.

pub fn inspect_eval( &self, session_id: &str, page_id: &str, expr: &str, ) -> Result<EvalResult>

pub fn inspect_storage( &self, session_id: &str, page_id: &str, scope: StorageScope, ) -> Result<Vec<StorageEntry>>

pub fn inspect_cookie_events( &self, session_id: &str, page_id: &str, ) -> Result<Vec<CookieEvent>>

pub fn cursor_op( &self, session_id: &str, page_id: &str, op: CursorOp, mode: InputMode, ) -> Result<StateToken>

pub fn inspect_scripts( &self, session_id: &str, page_id: &str, ) -> Result<Vec<ScriptEntry>>

pub fn inspect_script_source( &self, session_id: &str, page_id: &str, seq: u64, ) -> Result<Option<ScriptSource>>

pub fn inspect_dom( &self, session_id: &str, page_id: &str, r: Ref, extra_props: Vec<String>, ) -> Result<Option<DomDetail>>

pub fn inspect_performance( &self, session_id: &str, page_id: &str, ) -> Result<PerformanceMetrics>

pub fn dispatch(&self, primitives: &[Primitive]) -> Vec<DispatchOutcome>

order; per-primitive failures (parse errors, unknown sessions, stale tokens, etc.) produce inline error envelopes but do not abort the rest of the sequence.

Audit rows are written per primitive — a sequence does not become one audit row.

Today every wire frame parses to exactly one [Primitive] (i.e. one Request), so the inbound vec has length 1. Composite-flag primitives (PRs 2–6 of M5.5) and the v2 wire pipeline syntax (ADR 0007) both feed

Trait Implementations

impl Clone for Daemon

fn clone(&self) -> Daemon

Returns a duplicate of the value.

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

Performs copy-assignment from source.