Production infrastructure for AI agents

systemprompt.io • GitHub • Documentation

systemprompt-provider-contracts

Provider trait contracts for systemprompt.io - LLM, Tool, Job, Template, Component providers.

Overview

Defines the core provider trait contracts used throughout systemprompt.io. These traits establish the interface boundaries for LLM providers, tool executors, job runners, template providers, and component renderers. Implementations live in domain crates while contracts remain in the shared layer for maximum composability.

Part of the Shared layer in the systemprompt.io architecture.

Installation

Add to your Cargo.toml:

[dependencies]
systemprompt-provider-contracts = "0.0.1"

Quick Example

use systemprompt_provider_contracts::{
    LlmProvider, ChatRequest, ChatResponse, LlmProviderResult,
    ToolProvider, ToolDefinition, ToolCallRequest, ToolCallResult,
};
use async_trait::async_trait;

struct MyLlmProvider;

#[async_trait]
impl LlmProvider for MyLlmProvider {
    async fn chat(&self, request: ChatRequest) -> LlmProviderResult<ChatResponse> {
        // Implementation
        todo!()
    }
}

Core Types

Dependencies

Internal

External

License

FSL-1.1-ALv2 - See LICENSE for details.