Skip to content

Releases: NekomyaDev/nudge

v1.0.1

Choose a tag to compare

@github-actions github-actions released this 24 Jul 18:36

Full Changelog: V1.0.0...v1.0.1

Nudge v1.0.0

Choose a tag to compare

@NekomyaDev NekomyaDev released this 24 Jul 13:48

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 callsllm"""...""" 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 replayNUDGE_REPLAY_MODE=llm replays the LLM from a trace while tools run live
  • Streamingstream let with incremental schema validation and early abort
  • Checkpoint/resumeagent/state blocks checkpoint every write; nudgec resume <run_id> continues crashed runs
  • Reducer statel | merge r CRDT-style joins (dict union, list append-dedup)
  • Model routingroute{ cheap: "m1" when cond, strong: "m2" otherwise } with the chosen label in the trace
  • Static cost reportnudgec cost counts llm call sites per fn (fake pricing, retry×repair worst case)
  • Multi-server MCP routingNUDGE_MCP_SERVERS registry, fail-fast on unknown servers
  • Two backends — Python (full) and TypeScript (nudgec build-ts + shipped TS runtime)
  • OTel exportNUDGE_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 exportnudgec a2a emits A2A agent cards from your agents/fns
  • LSPnudgec 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