Struct SimpleAgentWrapper 

pub struct SimpleAgentWrapper { /* private fields */ }

Thread-safe, Clone-able FFI wrapper around the narrow SimpleAgent contract.

All methods return BindingResult<String> (or simple scalars) so that language bindings (Python/PyO3, Node/NAPI, Go/CGo) never touch Rust-only types.

Implementations

impl SimpleAgentWrapper

pub fn create( name: &str, purpose: Option<&str>, key_algorithm: Option<&str>, ) -> BindingResult<(Self, String)>

Create a new agent with persistent identity.

Returns (wrapper, info_json) where info_json is a serialized jacs::simple::AgentInfo.

pub fn load( config_path: Option<&str>, strict: Option<bool>, ) -> BindingResult<Self>

Load an existing agent from a config file.

pub fn load_with_info( config_path: Option<&str>, strict: Option<bool>, ) -> BindingResult<(Self, String)>

Load an existing agent from a config file and return canonical metadata.

pub fn ephemeral(algorithm: Option<&str>) -> BindingResult<(Self, String)>

Create an ephemeral (in-memory, throwaway) agent.

Returns (wrapper, info_json).

pub fn create_with_params(params_json: &str) -> BindingResult<(Self, String)>

Create an agent with full programmatic control via JSON parameters.

params_json is a JSON string of [CreateAgentParams] fields. The storage field is skipped during deserialization (use builder for that). Returns (wrapper, info_json) where info_json is a serialized jacs::simple::AgentInfo.

pub fn from_agent(agent: SimpleAgent) -> Self

Wrap an existing SimpleAgent in a SimpleAgentWrapper.

pub fn inner_ref(&self) -> &SimpleAgent

Get a reference to the inner SimpleAgent.

This is intended for advanced operations (attestation, reencrypt, etc.) that need direct access to the underlying agent. Language bindings should prefer the wrapper methods for the narrow contract.

pub fn get_agent_id(&self) -> BindingResult<String>

Get the agent’s unique ID.

pub fn key_id(&self) -> BindingResult<String>

Get the JACS key ID (signing key identifier).

pub fn is_strict(&self) -> bool

Whether the agent is in strict mode.

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

Config file path, if loaded from disk.

pub fn export_agent(&self) -> BindingResult<String>

Export the agent’s identity JSON for P2P exchange.

pub fn get_public_key_pem(&self) -> BindingResult<String>

Get the public key as a PEM string.

pub fn get_public_key_base64(&self) -> BindingResult<String>

Get the public key as base64-encoded raw bytes (FFI-safe).

pub fn diagnostics(&self) -> String

Runtime diagnostic info as a JSON string.

pub fn verify_self(&self) -> BindingResult<String>

Verify the agent’s own document signature. Returns JSON VerificationResult.

pub fn verify_json(&self, signed_document: &str) -> BindingResult<String>

Verify a signed document JSON string. Returns JSON VerificationResult.

pub fn verify_with_key_json( &self, signed_document: &str, public_key_base64: &str, ) -> BindingResult<String>

Verify a signed document with an explicit public key (base64-encoded). Returns JSON VerificationResult.

pub fn verify_by_id_json(&self, document_id: &str) -> BindingResult<String>

Verify a stored document by its ID (e.g., “uuid:version”). Returns JSON VerificationResult.

pub fn sign_message_json(&self, data_json: &str) -> BindingResult<String>

Sign a JSON message string. Returns the signed JACS document JSON.

pub fn sign_raw_bytes_base64(&self, data: &[u8]) -> BindingResult<String>

Sign raw bytes and return the signature as base64 (FFI-safe).

pub fn sign_file_json( &self, file_path: &str, embed: bool, ) -> BindingResult<String>

Sign a file with optional content embedding. Returns the signed JACS document JSON.

pub fn to_yaml(&self, json_str: &str) -> BindingResult<String>

Convert a JSON string to YAML.

pub fn from_yaml(&self, yaml_str: &str) -> BindingResult<String>

Convert a YAML string to pretty-printed JSON.

pub fn to_html(&self, json_str: &str) -> BindingResult<String>

Convert a JSON string to a self-contained HTML document.

pub fn from_html(&self, html_str: &str) -> BindingResult<String>

Extract JSON from an HTML document produced by to_html.

Trait Implementations

impl Clone for SimpleAgentWrapper

fn clone(&self) -> SimpleAgentWrapper

Returns a duplicate of the value.

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

Performs copy-assignment from source.