Skip to content

graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs

Python
6.6 KB
Raw Blame
//! Who made a model, as a stable slug for a client's logo (`graff/models`).
//!
//! The catalog keys a model by the route that serves it (`provider`) and its
//! name. The route is not the maker: `codegraff/claude-opus-5` is Anthropic's
//! model served by the Codegraff gateway, `groq/openai/gpt-oss-120b` is
//! OpenAI's. So the name decides first — a router's `vendor/model` prefix,
//! then the model family — and the provider only when the provider is itself
//! the lab. Unknown (local, custom, router-only) models get null, and a
//! client falls back to its own matching.

const std = @import("std");

const Rule = struct { key: []const u8, maker: []const u8 };

/// A router's `vendor/…` prefix (OpenRouter, Vercel, Groq, Fireworks slugs).
const vendor_prefixes = [_]Rule{
    .{ .key = "anthropic", .maker = "anthropic" }, .{ .key = "openai", .maker = "openai" },
    .{ .key = "google", .maker = "google" },       .{ .key = "x-ai", .maker = "xai" },
    .{ .key = "xai", .maker = "xai" },             .{ .key = "moonshotai", .maker = "moonshot" },
    .{ .key = "moonshot", .maker = "moonshot" },   .{ .key = "z-ai", .maker = "zai" },
    .{ .key = "zai", .maker = "zai" },             .{ .key = "zai-org", .maker = "zai" },
    .{ .key = "deepseek", .maker = "deepseek" },   .{ .key = "deepseek-ai", .maker = "deepseek" },
    .{ .key = "xiaomi", .maker = "xiaomi" },       .{ .key = "minimax", .maker = "minimax" },
    .{ .key = "mistralai", .maker = "mistral" },   .{ .key = "mistral", .maker = "mistral" },
    .{ .key = "alibaba", .maker = "alibaba" },     .{ .key = "qwen", .maker = "alibaba" },
    .{ .key = "meta", .maker = "meta" },           .{ .key = "meta-llama", .maker = "meta" },
};

/// The model family at the start of the bare name.
const families = [_]Rule{
    .{ .key = "claude", .maker = "anthropic" }, .{ .key = "gpt", .maker = "openai" },
    .{ .key = "o1", .maker = "openai" },        .{ .key = "o3", .maker = "openai" },
    .{ .key = "o4", .maker = "openai" },        .{ .key = "codex", .maker = "openai" },
    .{ .key = "gemini", .maker = "google" },    .{ .key = "gemma", .maker = "google" },
    .{ .key = "grok", .maker = "xai" },         .{ .key = "kimi", .maker = "moonshot" },
    .{ .key = "k2", .maker = "moonshot" },      .{ .key = "k3", .maker = "moonshot" },
    .{ .key = "glm", .maker = "zai" },          .{ .key = "deepseek", .maker = "deepseek" },
    .{ .key = "mimo", .maker = "xiaomi" },      .{ .key = "minimax", .maker = "minimax" },
    .{ .key = "mistral", .maker = "mistral" },  .{ .key = "codestral", .maker = "mistral" },
    .{ .key = "devstral", .maker = "mistral" }, .{ .key = "magistral", .maker = "mistral" },
    .{ .key = "qwen", .maker = "alibaba" },     .{ .key = "llama", .maker = "meta" },
    .{ .key = "muse", .maker = "meta" },
};

/// Providers that are the lab behind every model they serve.
const lab_providers = [_]Rule{
    .{ .key = "anthropic", .maker = "anthropic" }, .{ .key = "openai", .maker = "openai" },
    .{ .key = "codex", .maker = "openai" },        .{ .key = "google", .maker = "google" },
    .{ .key = "xai", .maker = "xai" },             .{ .key = "kimi", .maker = "moonshot" },
    .{ .key = "moonshot", .maker = "moonshot" },   .{ .key = "zai", .maker = "zai" },
    .{ .key = "deepseek", .maker = "deepseek" },   .{ .key = "xiaomi", .maker = "xiaomi" },
    .{ .key = "minimax", .maker = "minimax" },     .{ .key = "mistral", .maker = "mistral" },
    .{ .key = "meta", .maker = "meta" },
};

fn lookup(rules: []const Rule, key: []const u8) ?[]const u8 {
    for (rules) |r| if (std.ascii.eqlIgnoreCase(r.key, key)) return r.maker;
    return null;
}

/// The family is the name's leading word: up to the first `-`, `.`, `:`, `_`
/// or digit run boundary that ends a known family (`gpt-5.6` → gpt,
/// `o3-mini` → o3, `MiniMax-M3` → minimax).
fn family(bare: []const u8) ?[]const u8 {
    for (families) |r| {
        if (bare.len < r.key.len or !std.ascii.eqlIgnoreCase(bare[0..r.key.len], r.key)) continue;
        if (bare.len == r.key.len) return r.maker;
        const next = bare[r.key.len];
        if (next == '-' or next == '.' or next == ':' or next == '_' or next == ' ') return r.maker;
        // `gpt5`, `glm4`: a digit may follow a word family directly, but not a
        // bare-digit one (`o3` must not claim `o30x`, `k3` must not claim `k3s`).
        if (std.ascii.isDigit(next) and !std.ascii.isDigit(r.key[r.key.len - 1])) return r.maker;
    }
    return null;
}

pub fn of(provider: []const u8, name: []const u8) ?[]const u8 {
    var bare = name;
    if (std.mem.lastIndexOfScalar(u8, name, '/')) |last| {
        const first = std.mem.indexOfScalar(u8, name, '/').?;
        if (lookup(&vendor_prefixes, name[0..first])) |m| return m;
        bare = name[last + 1 ..]; // `accounts/fireworks/models/<model>`
    }
    if (family(bare)) |m| return m;
    return lookup(&lab_providers, provider);
}

const testing = std.testing;

fn expectMaker(expected: ?[]const u8, provider: []const u8, name: []const u8) !void {
    const got = of(provider, name);
    if (expected) |e| {
        try testing.expect(got != null);
        try testing.expectEqualStrings(e, got.?);
    } else try testing.expect(got == null);
}

test "maker: the gateway serves other labs' models" {
    try expectMaker("anthropic", "codegraff", "claude-opus-5");
    try expectMaker("xiaomi", "codegraff", "mimo-v2.6-flash");
    try expectMaker("deepseek", "codegraff", "deepseek-v4-pro");
    try expectMaker("zai", "codegraff", "glm-5.3");
    try expectMaker("moonshot", "codegraff", "kimi-k3");
    try expectMaker("xai", "codegraff", "grok-4.7");
    try expectMaker("minimax", "codegraff", "minimax-m3");
    try expectMaker("openai", "codegraff", "gpt-5.6-sol");
    try expectMaker("meta", "codegraff", "muse-spark");
}

test "maker: routers' vendor prefixes and nested slugs" {
    try expectMaker("anthropic", "openrouter", "anthropic/claude-sonnet-5");
    try expectMaker("openai", "groq", "openai/gpt-oss-120b");
    try expectMaker("alibaba", "vercel", "alibaba/qwen3-coder");
    try expectMaker("moonshot", "fireworks", "accounts/fireworks/models/kimi-k3");
    try expectMaker("google", "cerebras", "gemma-4-27b");
}

test "maker: a lab's own provider, families, and unknowns" {
    try expectMaker("moonshot", "kimi", "k3");
    try expectMaker("openai", "codex", "gpt-5.6-terra");
    try expectMaker("minimax", "minimax", "MiniMax-M3");
    try expectMaker("openai", "openai", "o3-mini");
    try expectMaker(null, "lmstudio", "lmstudio-community/some-local");
    try expectMaker(null, "mlx", "mlx-community/whatever");
    try expectMaker(null, "fugu", "fugu-1");
    try expectMaker(null, "vercel", "someco/o30x"); // bare-digit family does not claim a longer word
}