SmartAssist Rust Implementation

High-performance Rust implementation of the SmartAssist AI agent gateway.

Crates

Crate	Description
`smartassist-core`	Core types, configuration, and shared utilities
`smartassist-sandbox`	Command execution sandboxing with platform-specific profiles
`smartassist-channels`	Messaging channel abstractions (Telegram, Discord, Slack, etc.)
`smartassist-agent`	Agent runtime with tool execution framework
`smartassist-memory`	Memory and context management for agents
`smartassist-gateway`	JSON-RPC gateway server over WebSocket
`smartassist-cli`	Command-line interface
`smartassist-plugin-sdk`	Plugin development kit for extensions
`smartassist-providers`	Model provider integrations (Anthropic, OpenAI, Google)
`smartassist-secrets`	Encrypted secrets and credential management

Building

# Build all crates
cargo build --workspace

# Build with release optimizations
cargo build --workspace --release

# Build CLI only
cargo build -p smartassist-cli

Testing

# Run all tests
cargo test --workspace

# Run tests for a specific crate
cargo test -p smartassist-agent

# Run tests with specific channel features
cargo test -p smartassist-channels --features telegram

Running

# Start the gateway with Anthropic (default)
ANTHROPIC_API_KEY=your-key cargo run -p smartassist-cli -- gateway run

# Start with OpenAI
OPENAI_API_KEY=your-key cargo run -p smartassist-cli -- gateway run --provider openai

# Start with Google Gemini
GOOGLE_API_KEY=your-key cargo run -p smartassist-cli -- gateway run --provider google

# Start on a specific port with custom model
ANTHROPIC_API_KEY=xxx cargo run -p smartassist-cli -- gateway run --port 18789 --model claude-opus-4-20250514

# Show help
cargo run -p smartassist-cli -- --help

Environment variables:

ANTHROPIC_API_KEY - Anthropic Claude API key
OPENAI_API_KEY - OpenAI API key
GOOGLE_API_KEY or GEMINI_API_KEY - Google Gemini API key
SMARTASSIST_PROVIDER - Default provider (anthropic, openai, google)
SMARTASSIST_MODEL - Default model to use

Channel Features

Messaging channels are feature-gated to reduce compile time and dependencies:

# Build with Telegram support
cargo build -p smartassist-channels --features telegram

# Build with Discord support
cargo build -p smartassist-channels --features discord

# Build with Slack support
cargo build -p smartassist-channels --features slack

# Build with WebSocket support
cargo build -p smartassist-channels --features web

# Build with Signal support
cargo build -p smartassist-channels --features signal

# Build with iMessage support (macOS only)
cargo build -p smartassist-channels --features imessage

# Build with WhatsApp support
cargo build -p smartassist-channels --features whatsapp

# Build with LINE support
cargo build -p smartassist-channels --features line

# Build with all channels
cargo build -p smartassist-channels --features "telegram,discord,slack,web,signal,imessage,whatsapp,line"

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        smartassist-cli                          │
│                    (Command-line interface)                     │
└─────────────────────────────────────────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│                      smartassist-gateway                        │
│              (JSON-RPC over WebSocket server)                   │
│                                                                 │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐            │
│  │  Health  │ │   Chat   │ │ Sessions │ │  Config  │  ...       │
│  │ Handler  │ │ Handler  │ │ Handler  │ │ Handler  │            │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘            │
└─────────────────────────────────────────────────────────────────┘
                               │
          ┌────────────────────┼────────────────────┐
          ▼                    ▼                    ▼
┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐
│ smartassist-agent│  │smartassist-      │  │smartassist-memory │
│ (Agent runtime)  │  │  channels        │  │ (Context store)  │
│                  │  │  (Messaging)     │  │                  │
│  ┌────────────┐  │  │  ┌──────────┐    │  │  ┌────────────┐  │
│  │ Tools      │  │  │  │ Telegram │    │  │  │ Embeddings │  │
│  ├────────────┤  │  │  ├──────────┤    │  │  ├────────────┤  │
│  │ Sessions   │  │  │  │ Discord  │    │  │  │ Vector DB  │  │
│  ├────────────┤  │  │  ├──────────┤    │  │  └────────────┘  │
│  │ Streaming  │  │  │  │ Slack    │    │  │                  │
│  └────────────┘  │  │  ├──────────┤    │  └──────────────────┘
│                  │  │  │ Signal   │    │
│                  │  │  ├──────────┤    │
│                  │  │  │ WhatsApp │    │
│                  │  │  ├──────────┤    │
│                  │  │  │ Web +more│    │
│                  │  │  └──────────┘    │
└──────────────────┘  └──────────────────┘
          │
          ▼
┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐
│smartassist-      │  │smartassist-      │  │ smartassist-     │
│  sandbox         │  │  providers       │  │  secrets         │
│ (Cmd execution)  │  │ (AI models)      │  │ (Credentials)    │
└──────────────────┘  └──────────────────┘  └──────────────────┘
          │                    │                    │
          ▼                    ▼                    ▼
┌─────────────────────────────────────────────────────────────────┐
│                       smartassist-core                          │
│                    (Types & configuration)                      │
└─────────────────────────────────────────────────────────────────┘

Implementation Status

All 4 specification phases are complete:

Phase	Focus	Status
Phase 1	Core Infrastructure (providers, gateway, tools)	Complete
Phase 2	Channels (Telegram, Discord, Slack, Signal, WhatsApp, iMessage, LINE, Web)	Complete
Phase 3	Advanced Features (Plugin SDK, browser automation, memory/embeddings)	Complete
Phase 4	Platform & Polish (CLI, config validation, comprehensive testing)	Complete

Key metrics: 167 source files, 725 tests passing, 101 agent tools, 46 gateway RPC methods, 11 workspace crates.

Agent Tools

The agent includes 101 built-in tools:

File System

read - Read file contents
write - Write file contents
edit - Edit files with diff-based changes
glob - Find files by pattern
grep - Search file contents

File Operations

file_copy - Copy files to a new location
file_move - Move or rename files
file_stat - Get file/directory information (size, timestamps, permissions)
file_delete - Delete files or directories (requires approval)

Checksum

file_checksum - Compute file hash (MD5, SHA1, SHA256, SHA512)
file_verify - Verify file matches expected hash

Template

template - Substitute variables in template strings
format - Format values (JSON, numbers, bytes, durations)

System

bash - Execute shell commands

Process

process_list - List running processes
process_info - Get current process information

Utility

sleep - Wait for a specified duration
temp_file - Create a temporary file
temp_dir - Create a temporary directory
echo - Echo a value back (useful for testing)

Environment

env_get - Get environment variable value
env_list - List environment variables
env_check - Check if environment variables exist

HTTP

http_request - Make HTTP requests to APIs
url_parse - Parse URL into components
url_build - Build URL with query parameters

Network

dns_lookup - DNS record lookup
port_check - Check TCP port connectivity
http_ping - Check HTTP/HTTPS endpoint reachability
net_info - Get network interface information

Web

web_fetch - Fetch and process web pages
web_search - Search the web

Messaging

message - Send messages
sessions_spawn - Create new agent sessions
sessions_send - Send to existing sessions
sessions_list - List active sessions
sessions_history - Get session history
session_status - Get session status

Memory

memory_search - Search stored memories
memory_get - Retrieve specific memories
memory_store - Store information in memory
memory_index - Index and organize memory entries

Automation

cron - Schedule recurring tasks
gateway - Control the gateway
nodes - Manage distributed nodes

Media

image - Analyze images
tts - Text-to-speech

Browser

browser - Browser automation

Channel Actions

telegram_actions - Telegram-specific actions
discord_actions - Discord-specific actions
slack_actions - Slack-specific actions

Notebook

notebook_edit - Edit Jupyter notebook cells

Code Intelligence

lsp - Language Server Protocol for go-to-definition, find-references, hover

Task Management

task_create - Create tasks to track work
task_list - List all tasks
task_update - Update task status
task_get - Get task details

Interactive

ask_user - Ask user questions with multiple choice options
confirm - Request user confirmation for actions

Planning

enter_plan_mode - Enter planning mode for implementation design
exit_plan_mode - Exit planning mode and submit plan for approval

Skills

skill - Invoke a registered skill (slash command)
skill_list - List available skills

Diagnostics

system_info - Get system information (OS, architecture, environment)
health_check - Check agent health and status
diagnostic - Run diagnostics to troubleshoot issues

Context Management

context_add - Add information to working context for later reference
context_get - Retrieve entries from working context
context_clear - Clear the working context

Diff & Patch

diff - Generate diffs between text or files
patch - Preview and apply search/replace changes

Git

git_status - Get repository status (staged, modified, untracked)
git_log - View commit history
git_diff - View changes
git_branch - List and manage branches

JSON/YAML

json_query - Query JSON data using path expressions
json_transform - Transform JSON (pick, omit, rename, flatten)
yaml - Parse and convert between YAML and JSON

Encoding & Hashing

base64 - Base64 encode/decode
hex - Hexadecimal encode/decode
hash - Compute hashes (MD5, SHA1, SHA256, SHA512)
url_encode - URL encode/decode

Time & Date

now - Get current date and time
date_parse - Parse and format date strings
date_calc - Date calculations (add, subtract, diff)

String Manipulation

case - Convert case (upper, lower, camel, snake, kebab)
split_join - Split and join strings
replace - Text replacement with regex support
trim_pad - Trim whitespace or pad strings

Math & Random

calc - Mathematical calculations (add, sqrt, power, etc.)
random - Generate random numbers, strings, or pick items
uuid - Generate UUIDs

Validation

validate - Validate formats (email, URL, JSON, UUID, IP, etc.)
is_empty - Check if value is empty, null, or blank

Comparison & Assertions

compare - Compare two values (eq, ne, lt, gt, contains, starts_with, ends_with)
assert - Assert a condition is true (returns error if false)
match - Match text against regex patterns with capture groups
version_compare - Compare semantic version strings

Gateway RPC Methods

The gateway exposes 46+ RPC methods for:

Health monitoring (health, status)
Chat interface (chat, chat.history, chat.abort)
Agent management (agent, agent.stream)
Session management (sessions.list, sessions.resolve, sessions.patch, sessions.delete)
Model management (models.list)
Configuration (config.get, config.set, config.patch, config.schema)
Channel messaging (send, send.poll)
Device pairing (device.pair.list, device.pair.approve, device.pair.reject, device.token.rotate, device.token.revoke)
Node management (node.list, node.describe, node.pair.request, node.pair.approve, node.pair.reject, node.unpair, node.rename, node.invoke)
Cron scheduling (cron.list, cron.status, cron.add, cron.update, cron.remove, cron.run, cron.runs, wake)
Execution approvals (exec.approvals.get, exec.approvals.set, exec.approval.request, exec.approval.resolve)
Skill management (skills.status, skills.bins, skills.install, skills.update)
System operations (system-presence, system-event, last-heartbeat, set-heartbeats, logs.tail)
Setup wizard (wizard.start, wizard.next, wizard.cancel, wizard.status)

Model Providers

The smartassist-providers crate includes integrations for major AI providers:

Anthropic Claude

Models: claude-opus-4-20250514, claude-sonnet-4-20250514, claude-3-5-haiku-20241022
Features: Streaming, tool calling, vision, 200K context

OpenAI GPT

Models: gpt-4o, gpt-4o-mini, o1, o3-mini
Features: Streaming, tool calling, vision, 128K context

Google Gemini

Models: gemini-2.0-flash, gemini-1.5-pro
Features: Streaming, tool calling, vision, 2M context

use smartassist_providers::{anthropic::AnthropicProvider, Provider};

let provider = AnthropicProvider::from_env()?;
let response = provider.chat(
    "claude-sonnet-4-20250514",
    &[Message::user("Hello!")],
    None,
).await?;

Plugin SDK

Create custom plugins using the SDK:

use smartassist_plugin_sdk::prelude::*;

pub struct MyPlugin;

#[async_trait]
impl Plugin for MyPlugin {
    fn metadata(&self) -> PluginMetadata {
        PluginMetadata {
            name: "my-plugin".to_string(),
            version: Version::parse("1.0.0").unwrap(),
            description: "My custom plugin".to_string(),
            author: Some("Author".to_string()),
            homepage: None,
            license: Some("MIT".to_string()),
            capabilities: vec![PluginCapability::Tool],
            min_smartassist_version: None,
        }
    }

    async fn initialize(&mut self, ctx: &PluginContext) -> Result<()> {
        Ok(())
    }

    async fn shutdown(&mut self) -> Result<()> {
        Ok(())
    }

    fn as_any(&self) -> &dyn std::any::Any { self }
    fn as_any_mut(&mut self) -> &mut dyn std::any::Any { self }
}

Plugin capabilities:

Channel - Custom messaging channels
Tool - Custom agent tools
ModelProvider - Custom AI model providers
Hook - Middleware and interceptors
Storage - Custom storage backends
Media - Media processing

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 7 Commits
.cargo		.cargo
crates		crates
examples/hello-plugin		examples/hello-plugin
rust-spec		rust-spec
smartassist-control		smartassist-control
tests/integration		tests/integration
.gitignore		.gitignore
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
README.md		README.md
rust-toolchain.toml		rust-toolchain.toml

Folders and files

Latest commit

History

Repository files navigation

SmartAssist Rust Implementation

Crates

Building

Testing

Running

Channel Features

Architecture

Implementation Status

Agent Tools

File System

File Operations

Archive

Checksum

Template

System

Process

Utility

Environment

HTTP

Network

Web

Messaging

Memory

Automation

Media

Browser

Channel Actions

Notebook

Code Intelligence

Task Management

Interactive

Planning

Skills

Diagnostics

Context Management

Diff & Patch

Git

JSON/YAML

Encoding & Hashing

Time & Date

String Manipulation

Math & Random

Validation

Comparison & Assertions

Gateway RPC Methods

Model Providers

Anthropic Claude

OpenAI GPT

Google Gemini

Plugin SDK

License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages