Skip to main content

Crate sutegi_ai

Crate sutegi_ai 

Source
Expand description

Agent-facing surface for sutegi.

Tools are now a core concept: register them directly on the app with App::tool / [App::stream_tool], and describe their inputs with the schema helpers. sutegi validates each call’s arguments against the declared schema, mounts POST /__tools/:name (and /__tools/:name/stream for SSE), and lists everything in the /__tools manifest and /__introspect.

ⓘ
use sutegi::prelude::*;

App::new("assistant")
    .state(db)
    .tool("create_todo", "Create a todo",
        schema::object(vec![("title", schema::string("the title"))], &["title"]),
        |c, args| {
            let todo: Todo = Todo::from_row(&args)?;   // args are validated
            let id = todo.save(c.db::<Db>())?;
            Ok(Todo { id, ..todo }.to_json())
        })
    .serve()

This crate re-exports that surface so the sutegi::ai::… path keeps working and is the home for future LLM-client helpers.

Modules§

schema
Helpers to construct JSON Schema fragments for tool parameters, so declaring a tool’s inputs reads declaratively instead of as nested map building. Used with App::tool:

Structs§

Ctx
Everything a request handler needs: the Request, the captured path Params, and typed access to shared application state.
ToolCtx
The owned context handed to AI tool closures (App::tool / App::stream_tool). Like Ctx it exposes typed state, but it owns its data so a streaming tool can keep using it after the response has begun.