Struct ForgeState 

pub struct ForgeState { /* private fields */ }

Implementations

impl ForgeState

pub fn new() -> Option<Self>

Initialise Forge from saved config and environment variables.

pub fn from_config(config: &ForgeUserConfig) -> Option<Self>

Initialise Forge from user configuration. Returns None when no API key is configured for the active provider, or the runtime cannot start.

pub fn with_api_key(api_key: impl Into<String>) -> Option<Self>

Initialise Forge with explicit credentials (used when saving keys in UI).

pub fn apply_config(&mut self, config: &ForgeUserConfig) -> bool

Apply UI configuration (provider, model, active API key).

pub fn provider(&self) -> ForgeProvider

pub fn model(&self) -> &str

pub fn set_provider(&mut self, provider: ForgeProvider)

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

pub fn set_api_key(&mut self, api_key: impl Into<String>) -> bool

Replace the API key for the active provider.

pub fn start(&mut self, prompt: String) -> Result<u64>

Create a new session and start a background Claude stream. Returns the session id (always > 0).

pub fn revise(&mut self, id: u64, prompt: String) -> Result<()>

Re-prompt an existing creation. The current src/lib.rs and latest prompt are included so Claude edits the app rather than starting over.

pub fn snapshot(&self, id: u64) -> Option<ForgeSnapshot>

Fetch a read-only snapshot of a session, if it exists.

pub fn list_ids(&self) -> Vec<u64>

List all known session ids, oldest-first.

pub fn list_creations(&self) -> Vec<ForgeCreationSummary>

List all known creations, newest-first.

pub fn delete_creation(&mut self, id: u64) -> Result<()>

Delete a creation and its generated project directory.

pub fn build(&mut self, id: u64) -> Result<()>

Kick off a cargo build for a session whose streaming is done. Subsequent calls while building are no-ops. Does NOT consume an auto-retry — this is an explicit manual rebuild (e.g. after the user edits an error message and wants another shot).

pub fn set_auto_fix(&mut self, id: u64, enabled: bool)

Toggle auto-fix on a session. No-op if the session doesn’t exist.

pub fn artifact_bytes(&self, id: u64) -> Option<Vec<u8>>

Read the built artifact bytes for a session, if the build succeeded.

pub fn system_prompt_len(&self) -> usize

Convenience for the UI: the system prompt length (tokens ~ chars/4), so we can show a rough “context used” indicator.

pub fn output_dir(&self) -> PathBuf

pub fn set_output_dir(&mut self, dir: PathBuf) -> Result<()>