Sea-Claw
Sovereign AI Agent Platform

typedef struct {
    const u8* data;   // Pointer into existing buffer
    u32       len;    // Length in bytes
} SeaSlice;

#define SEA_SLICE_LIT(s) ((SeaSlice){(const u8*)(s), sizeof(s) - 1})

// 22 error codes
typedef enum {
    SEA_OK = 0,
    SEA_ERR_OOM, SEA_ERR_ARENA_FULL,
    SEA_ERR_IO, SEA_ERR_TIMEOUT,
    SEA_ERR_INVALID_INPUT, SEA_ERR_GRAMMAR_REJECT,
    SEA_ERR_TOOL_NOT_FOUND, SEA_ERR_TOOL_FAILED,
    // ... 14 more
} SeaError;

SeaArena arena;
sea_arena_create(&arena, 1024 * 1024);  // 1 MB via mmap

char* buf = sea_arena_alloc(&arena, 256, 1);  // bump alloc
snprintf(buf, 256, "Hello from arena!");

SeaSlice s = sea_arena_push_cstr(&arena, "zero-copy");
// s.data points into arena memory — no malloc

sea_arena_reset(&arena);    // ONE instruction — all memory reusable
sea_arena_destroy(&arena);  // munmap

const char* json = "{\"name\":\"Sea-Claw\",\"tools\":50}";
SeaSlice input = { .data = (const u8*)json, .len = strlen(json) };

SeaJsonValue root;
sea_json_parse(input, &arena, &root);

SeaSlice name = sea_json_get_string(&root, "name");
// name.data points into original json buffer — zero copy!

f64 tools = sea_json_get_number(&root, "tools", 0);
// tools == 50.0

SeaSlice user_input = SEA_SLICE_LIT("hello world");

// Detect shell injection: $(cmd), `cmd`, ; rm, | cat, etc.
if (sea_shield_detect_injection(user_input)) {
    return SEA_ERR_INVALID_INPUT;  // REJECTED
}

// Validate against grammar bitmap
if (!sea_shield_check(user_input, SEA_GRAMMAR_SAFE_TEXT)) {
    return SEA_ERR_GRAMMAR_REJECT;  // Invalid bytes
}
// Safe to process — every byte verified

SeaDb* db;
sea_db_open(&db, "seaclaw.db");
// Auto-creates: trajectory, config, tasks, chat_history

sea_db_log_event(db, "startup", "Sea-Claw started", "1.0.0");
sea_db_task_create(db, "Write docs", "high", "All 50 tools");
sea_db_chat_log(db, 890034905, "user", "What's the weather?");

// Load last 20 messages for conversation memory
SeaDbChatMsg msgs[20];
i32 count = sea_db_chat_history(db, chat_id, msgs, 20, &arena);

// Provider chain: OpenRouter -> OpenAI -> Gemini
SeaAgentConfig cfg = {
    .provider = SEA_LLM_OPENROUTER,
    .model    = "moonshotai/kimi-k2.5",
    .api_key  = getenv("OPENROUTER_API_KEY"),
    .fallbacks = {
        { SEA_LLM_OPENAI, getenv("OPENAI_API_KEY"), NULL, "gpt-4o-mini" },
        { SEA_LLM_GEMINI, getenv("GEMINI_API_KEY"), NULL, "gemini-2.0-flash" },
    },
    .fallback_count = 2,
};

SeaAgentResult result = sea_agent_chat(&cfg, history, count,
                                        "What files are in /tmp?", &arena);
// Agent may call file_read, dir_list, shell_exec tools automatically

// Every tool has this exact signature
typedef SeaError (*SeaToolFunc)(
    SeaSlice args, SeaArena* arena, SeaSlice* output
);

// Execute by name — O(n) scan of static array
SeaSlice args = SEA_SLICE_LIT("/root/seaclaw/README.md");
SeaSlice output;
SeaError err = sea_tool_exec("file_read", args, &arena, &output);
if (err == SEA_OK) {
    printf("%.*s\n", (int)output.len, (const char*)output.data);
}