Skip to content

codeitalldev/codeitall

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

codeitall — Rust API behavioral oracle

Version-pinned behavioral oracle for Rust package APIs, built for AI coding agents. Five deterministic tools backed by a Postgres substrate of 66,549,370 pattern_records and 107 successful probe runs across 7 task families (datetime, duration, base64, JSON strict-vs-permissive, JWT verify, AEAD encrypt/decrypt, constant-time compare).

Hosted, free, no signup: https://api.codeitall.dev

This repository is codeitall's public surface — the API reference, OpenAPI spec, the "For AI Agents" page, and the per-family pages. The ingest/indexer and server source are not redistributed; you consume codeitall by querying the hosted API, not by running it yourself.

What it answers

The differentiator from a docs RAG: the substrate captures runtime behavior (what a function actually does on a canonical input set, observed empirically), not just documentation (what it claims to do). It targets the documentation-vs-runtime gap — yank status, RustSec advisories, deprecation renames, and cross-implementation behavior tables.

Tools

Tool Use it for
answer_api_question Open-ended Rust API questions; routes deterministically (rule-based, no LLM) and falls back to bge-m3 cosine retrieval.
signature_search You know the signature shape (fn(&str) -> Result<Vec<u8>, _>); get ranked candidate functions + crate, downloads, yank status.
behavior_lookup A specific (crate, fn_name); get the probe-observation table verbatim — each row (input, outcome=ok|err|panic, value_or_error).
compare_implementations A task category (e.g. "base64 crates"); get the side-by-side cross-implementation behavior table.
find_modern_equivalent A suspected-deprecated call; get the current canonical alternative + yank/advisory rows.

Determinism contract

No generative LLM sits between a request and its response. Every response is SQL + deterministic templating; the only model in the hot path is bge-m3, a deterministic text→vector embedder used for the cosine fallback (same input → same vector → same hits). This is a regression-pinned invariant.

Quickstart

# Mint a free anonymous key (no email, no signup):
curl -sX POST https://api.codeitall.dev/v1/keys \
  -H 'content-type: application/json' -d '{}'

# Ask a question (HTTP REST):
curl -sX POST https://api.codeitall.dev/v1/answer_api_question \
  -H 'content-type: application/json' \
  -d '{"question":"how do I parse a duration string in rust"}'

GET aliases exist for every tool (browse-only clients); signature_search also accepts a shape_b64 (base64url) parameter so URL re-encoding can't mangle type-signature characters.

Access modes

  • MCP — SSE/HTTP at https://api.codeitall.dev/mcp (Bearer key), or stdio for self-hosters.
  • HTTP RESTPOST/GET /v1/<tool>.
  • OpenAPI 3.1openapi.json (live: https://api.codeitall.dev/openapi.json).

Docs in this repo

Cost & limits

Free. Per-IP key issuance cap (10/day) and per-key quota (10,000/day). No paid tier, no email capture, no signup.

About

codeitall — public surface (docs + OpenAPI 3.1) for the hosted Rust API behavioral oracle at api.codeitall.dev

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages