Skip to content

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

Python
2.8 KB
Raw Blame
"""Executable port of lean-proofs/Graff/Provider.lean."""

from __future__ import annotations

from typing import Literal

Kind = Literal["anthropic", "openai", "responses", "interactions"]
Auth = Literal["x_api_key", "bearer", "goog_api_key"]
Login = Literal["api_key", "codegraff_device", "codex_device", "kimi_device", "xai_device", "zai_cli", "chatgpt_browser", "anthropic_browser", "claude_cli"]
Catalog = Literal["baked", "codex", "kimi", "openai", "anthropic"]


def row(
    id: str,
    kind: Kind,
    auth: Auth,
    login: Login = "api_key",
    catalog: Catalog = "baked",
    sub_login: bool = False,
    takes_effort: bool = False,
) -> dict:
    return {
        "id": id,
        "kind": kind,
        "auth": auth,
        "login": login,
        "catalog": catalog,
        "sub_login": sub_login,
        "takes_effort": takes_effort,
    }


SPECS: list[dict] = [
    row("anthropic", "anthropic", "x_api_key", login="anthropic_browser", catalog="anthropic", sub_login=True),
    row("codegraff", "openai", "bearer", login="codegraff_device", catalog="openai", takes_effort=True),
    row("deepseek", "openai", "bearer", takes_effort=True),
    row("openai", "responses", "bearer"),
    row("google", "interactions", "goog_api_key", catalog="openai", takes_effort=True),
    row("minimax", "anthropic", "bearer"),
    row("xiaomi", "openai", "bearer", catalog="openai"),
    row("kilo", "openai", "bearer"),
    row("groq", "openai", "bearer"),
    row("cerebras", "openai", "bearer", catalog="openai", takes_effort=True),
    row("mistral", "openai", "bearer"),
    row("kimi", "openai", "bearer", login="kimi_device", catalog="kimi", sub_login=True),
    row("moonshot", "openai", "bearer"),
    row("xai", "openai", "bearer", login="xai_device", catalog="openai", sub_login=True),
    row("zai", "openai", "bearer", login="zai_cli", catalog="openai", sub_login=True, takes_effort=True),
    row("meta", "openai", "bearer", catalog="openai", takes_effort=True),
    row("vercel", "openai", "bearer", catalog="openai", takes_effort=True),
    row("openrouter", "openai", "bearer", catalog="openai", takes_effort=True),
    row("fugu", "openai", "bearer"),
    row("fireworks", "openai", "bearer", catalog="openai"),
    row("mlx", "openai", "bearer"),
    row("lmstudio", "openai", "bearer"),
    row("omlx", "openai", "bearer", catalog="openai", takes_effort=True),
    row("chatgpt-new", "responses", "bearer", login="chatgpt_browser", catalog="openai", sub_login=True),
    row("codex", "responses", "bearer", login="codex_device", catalog="codex", sub_login=True),
    row("claude-agent", "anthropic", "bearer", login="claude_cli", sub_login=True, takes_effort=True),
]


def ws_capable(r: dict) -> bool:
    # #514: only codex and xai serve a WS endpoint; platform OpenAI does not.
    return r["id"] in ("codex", "xai") and r["kind"] == "responses"