Radkit Cloud Runtime Stub

This crate is a minimal stub that compiles in place of the paid agents.sh cloud runtime.

What it does

• Provides a PaidRuntime type that matches the public API surface expected by consumers.
• Compiles successfully with radkit when you depend on the runtime feature.
• When serve() is called outside the agents.sh cloud environment, it immediately returns an error: ServerStartFailed("This runtime only runs inside the agents.sh cloud environment").

Usage

Add the stub to your workspace or pull it in as a dependency while developing locally against the public API of the paid runtime. Calls to serve() will fail fast, making it clear that cloud-only functionality is not available here.

Example

use radkit::agent::{Agent, AgentDefinition};
use radkit::models::providers::AnthropicLlm;
use radkit_cloud::PaidRuntime;

fn agent() -> AgentDefinition {
    Agent::builder().with_name("HR Agent").build()
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Use whatever LLM your project expects; it is never called by this stub.
    let llm = AnthropicLlm::from_env("claude-3-5-sonnet")?;
    // Running locally will fail immediately with the cloud-only error.
    PaidRuntime::new(agent(), llm).serve().await?;

    Ok(())
}

Build

cargo check

Notes

• This crate intentionally omits all cloud runtime behavior; it only exists to satisfy compilation for local development.
• On WASI+p1 targets, serve() is not built (matches the upstream radkit conditional).***