Struct AppService 

pub struct AppService { /* private fields */ }

Implementations

impl AppService

pub async fn eval( &self, scenario: Option<String>, scenario_file: Option<String>, scenario_name: Option<String>, strategy: &str, strategy_opts: Option<Value>, ) -> Result<String, String>

Run an evalframe evaluation suite.

Accepts a scenario (bindings + cases) and a strategy name. Automatically wires the strategy as the provider and executes the evalframe suite, returning the report (summary, scores, failures).

Injects a std global (mlua-batteries compatible shim) so evalframe’s std.lua can resolve json/fs/time from algocline’s built-in primitives.

Security: strategy is not sanitized

strategy is interpolated into a Lua string literal without escaping. This is intentional — same rationale as [make_require_code]: algocline runs Lua in the caller’s own process with full ambient authority, so Lua injection does not cross a trust boundary.

pub fn eval_history( &self, strategy: Option<&str>, limit: usize, ) -> Result<String, String>

List eval history, optionally filtered by strategy.

pub fn eval_detail(&self, eval_id: &str) -> Result<String, String>

View a specific eval result by ID.

pub async fn eval_compare( &self, eval_id_a: &str, eval_id_b: &str, ) -> Result<String, String>

Compare two eval results with statistical significance testing.

Delegates to evalframe’s stats.welch_t (single source of truth for t-distribution table and test logic). Reads persisted aggregated.scores from each eval result — no re-computation of descriptive statistics.

The comparison result is persisted to ~/.algocline/evals/ so repeated lookups of the same pair are file reads only.

impl AppService

pub async fn add_note( &self, session_id: &str, content: &str, title: Option<&str>, ) -> Result<String, String>

Append a note to a session’s log file.

pub async fn log_view( &self, session_id: Option<&str>, limit: Option<usize>, ) -> Result<String, String>

View session logs.

pub fn info(&self) -> String

Return diagnostic info about the current configuration (mise doctor style).

pub fn stats( &self, strategy_filter: Option<&str>, days: Option<u64>, ) -> Result<String, String>

Aggregate stats across all logged sessions.

Scans .meta.json files (with .json fallback for legacy logs). Optional filters: strategy (exact match), days (last N days).

impl AppService

pub async fn pkg_list(&self) -> Result<String, String>

List installed packages with metadata, showing the full override chain.

Scans all search paths in priority order. For each package:

• source: the path it was found in
• active: whether this is the effective version (highest priority wins)
• overrides: if active and a lower-priority copy exists, shows what it overrides

pub async fn pkg_install( &self, url: String, name: Option<String>, ) -> Result<String, String>

Install a package from a Git URL or local path.

pub async fn pkg_remove(&self, name: &str) -> Result<String, String>

Remove an installed package.

impl AppService

pub async fn run( &self, code: Option<String>, code_file: Option<String>, ctx: Option<Value>, ) -> Result<String, String>

Execute Lua code with optional JSON context.

pub async fn advice( &self, strategy: &str, task: String, opts: Option<Value>, ) -> Result<String, String>

Apply a built-in strategy to a task.

If the requested package is not installed, automatically installs the bundled package collection from GitHub before executing.

pub async fn continue_batch( &self, session_id: &str, responses: Vec<QueryResponse>, ) -> Result<String, String>

Continue a paused execution — batch feed.

pub async fn continue_single( &self, session_id: &str, response: String, query_id: Option<&str>, ) -> Result<String, String>

Continue a paused execution — single response (with optional query_id).

impl AppService

pub fn scenario_list(&self) -> Result<String, String>

List available scenarios in ~/.algocline/scenarios/.

Per-entry I/O errors are collected in "failures" rather than aborting.

pub fn scenario_show(&self, name: &str) -> Result<String, String>

Show the content of a named scenario.

pub async fn scenario_install(&self, url: String) -> Result<String, String>

Install scenarios from a Git URL or local path into ~/.algocline/scenarios/.

Expects the source to contain .lua files (at root or in a scenarios/ subdirectory).

impl AppService

pub async fn status(&self, session_id: Option<&str>) -> Result<String, String>

Snapshot of all active sessions for external observation.

Returns JSON with session status, metrics, progress, and strategy name. Only includes sessions currently held in the registry (paused, awaiting host LLM responses). Completed sessions are not listed here — use alc_log_view for historical data.

impl AppService

pub fn new( executor: Arc<Executor>, log_config: AppConfig, search_paths: Vec<SearchPath>, ) -> Self

Trait Implementations

impl Clone for AppService

fn clone(&self) -> AppService

Returns a duplicate of the value.

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

Performs copy-assignment from source.