Repository navigation
FirstCall v0.1.0
FirstCall v0.1.0
FirstCall is a Rust 2024 local-first verified API recipe workbench for turning request sources into verified, reusable recipes and redacted agent-ready API tool packages.
Highlights
- Desktop GUI workbench for request-source intake, parser notes, draft candidate review, runtime slot/auth entry, local execution, attempts, recipes, and settings.
firstcall-cliautomation surface for verify, package, validate-package, inspect-package, import-package, recipe-list, recipe-show, and JSON reports.- Static source adapters for curl, docs, OpenAPI, Postman Collection, HAR,
.http/.rest, Hurl, Bruno/OpenCollection, and GraphQL-over-HTTP JSON body detection. - OpenAPI local relative JSON/YAML
$refsupport with safe handling for remote refs, cycles, depth limits, malformed files, and resolver-root boundaries. - Redacted agent package export with manifest validation, inspect-gated import, and storage-backed re-verification.
- Optional MCP compile smoke through
validate-package --mcp-compile-smoke. - Optional native keyring backend for GUI credential UX, with session-memory fallback.
- Desktop feature split: default builds include the GUI, while
firstcall-clisupports--no-default-featuresCLI-only builds. - Native save dialogs for GUI Markdown/JSON recipe exports.
- CI coverage for cross-platform builds, CLI-only builds, security audit, and local loopback lifecycle verification.
Safety Boundaries
- Local-first only: no cloud backend or marketplace.
- CLI verification remains environment-first and does not read GUI keyring/session-memory secrets.
- Imported scripts/tests/runtime hooks from source tools are not executed.
- Remote OpenAPI refs are not fetched.
- Generated
mcp-server/files are package artifacts, not import source of truth. - Raw secrets are not intentionally written to SQLite, exports, package files, logs, CLI reports, recipe-list, or recipe-show output.
- Mutating HTTP methods require the existing
--allow-mutatingguard.
Validation
This release is expected to pass:
cargo fmt --all -- --checkcargo clippy --all-targets --all-features -- -D warningscargo test --lockedcargo build --lockedcargo build --locked --bin firstcall-cli --no-default-featurescargo build --locked --features "desktop native-keyring"