Skip to content

Nudge v1.0.0

Choose a tag to compare

View all tags
@NekomyaDev NekomyaDev released this 24 Jul 13:48
V1.0.0
1d4df2f

Nudge v1.0 — the typed, replayable, budget-aware language for LLM agents. Write the agent once, compile it to Python or TypeScript, replay its traces as tests at zero token cost.

Highlights

  • Typed LLM calls — llm"""...""" with { schema: Report, budget: 0.04 USD, retry: 3 with repair }; schema validation with an automatic repair loop
  • Trace-as-test — every run records a trace; test blocks replay it in CI at zero token cost (nudgec test)
  • Budget walls — per-call and per-run USD budgets, enforced deterministically against the fake provider
  • Hybrid replay — NUDGE_REPLAY_MODE=llm replays the LLM from a trace while tools run live
  • Streaming — stream let with incremental schema validation and early abort
  • Checkpoint/resume — agent/state blocks checkpoint every write; nudgec resume <run_id> continues crashed runs
  • Reducer state — l | merge r CRDT-style joins (dict union, list append-dedup)
  • Model routing — route{ cheap: "m1" when cond, strong: "m2" otherwise } with the chosen label in the trace
  • Static cost report — nudgec cost counts llm call sites per fn (fake pricing, retry×repair worst case)
  • Multi-server MCP routing — NUDGE_MCP_SERVERS registry, fail-fast on unknown servers
  • Two backends — Python (full) and TypeScript (nudgec build-ts + shipped TS runtime)
  • OTel export — NUDGE_OTEL=<path> writes every trace record as an OTel-shaped JSONL span
  • Frozen trace format — v1 record schema frozen; nudgec trace-check validates conformance
  • A2A export — nudgec a2a emits A2A agent cards from your agents/fns
  • LSP — nudgec lsp serves editor diagnostics over stdio (dependency-free)

Numbers

  • 97 tests green (CI on every push) · 29-line self-testing research agent example · zero compiler dependencies
  • Design doc v1.13 frozen · full roadmap complete (v0.1 MVP → v0.2 → v0.3 → v0.4 → v1.0)

Quickstart

cargo build                              # the nudgec compiler
export PYTHONPATH=$PWD/runtime
nudgec check examples/research_agent.ndg
nudgec test  examples/research_agent.ndg # replay the committed trace — zero tokens
Assets 2
Loading