Struct XFS 

pub struct XFS { /* private fields */ }

Main filesystem interface

Implementations

impl XFS

pub async fn connect( user: &str, consumer_key: &str, consumer_secret: &str, access_token: &str, access_token_secret: &str, ) -> Result<Self>

Connect to xfiles with Twitter OAuth 1.0a credentials

Arguments

• user - Twitter username (e.g., “@myagent”)
• consumer_key - Twitter API Key
• consumer_secret - Twitter API Secret
• access_token - OAuth Access Token
• access_token_secret - OAuth Access Token Secret

To get OAuth 1.0a credentials:

1. Go to https://developer.twitter.com/en/portal/dashboard
2. Create a project and app
3. Under “Keys and tokens”, generate:
   • API Key & Secret (Consumer Key & Secret)
   • Access Token & Secret
4. Ensure app has “Read and Write” permissions

Example

let consumer_key = std::env::var("TWITTER_API_KEY").unwrap();
let consumer_secret = std::env::var("TWITTER_API_SECRET").unwrap();
let access_token = std::env::var("TWITTER_ACCESS_TOKEN").unwrap();
let access_token_secret = std::env::var("TWITTER_ACCESS_TOKEN_SECRET").unwrap();
let fs = XFS::connect("@myagent", &consumer_key, &consumer_secret,
                       &access_token, &access_token_secret).await?;

pub async fn with_adapter( user: &str, adapter: Arc<dyn RemoteAdapter>, db_path: Option<&str>, ) -> Result<Self>

Create XFS with a custom adapter (useful for testing)

Arguments

• user - Username
• adapter - Custom RemoteAdapter implementation
• db_path - Optional custom database path

pub async fn open(&mut self, path: &str, mode: OpenMode) -> Result<XFile>

Open a file

Arguments

• path - File path (e.g., “memory.txt” or “logs/agent.log”)
• mode - How to open the file

pub async fn list(&self, path: &str) -> Result<Vec<String>>

List files in a directory

Arguments

• path - Directory path (use “” or “/” for root)

pub async fn history(&self, path: &str) -> Result<Vec<Commit>>

Get the history of a file

Returns all commits in chronological order

pub async fn exists(&self, path: &str) -> Result<bool>

Check if a file exists

pub fn user(&self) -> &str

Get the current user