feat(package): expose agentv authoring facade

[christso]

Summary

AgentV authoring now has one public package story: users install/import agentv for CLI and TypeScript APIs, while @agentv/sdk and @agentv/core stop being canonical public authoring surfaces. The CLI, Dashboard, and tests still keep a lower-level core workspace layer internally, but public contracts are routed through deliberate agentv/* facade subpaths instead of broad separate package promises.

This keeps AgentV aligned with Promptfoo's practical model: one obvious public package, private internal layers, and narrow contract exports where they earn their keep. The branch preserves the ergonomic helper names defineAssertion() and defineScriptGrader() while moving docs, examples, and package exports toward agentv imports.

Decisions

Surface	Decision
agentv	Canonical public CLI + TypeScript facade, with root and agentv/sdk, agentv/config, agentv/provider, agentv/contracts exports.
@agentv/sdk	Private/internal implementation package; not taught as canonical authoring.
@agentv/core	Private lower-level engine/contracts workspace layer for CLI, Dashboard, tests, and implementation code.
CLI internals	No longer depend on the SDK facade for the Vitest grader path.

Validation

• git diff --check
• bun --filter @agentv/core typecheck
• bun --filter @agentv/sdk typecheck
• bun --filter agentv typecheck
• bun --filter agentv build
• bun run build
• Focused Bun tests for TypeScript eval loader, SDK package graph/evaluate/Vitest, CLI package exports/create assertion/eval Vitest
• Biome checks on changed TypeScript/docs-support files
• Post-rebase git diff --check origin/main...HEAD

Known gap: bun run validate:examples still fails on unchanged pre-existing examples/showcase/multi-model-benchmark/evals/benchmark.eval.yaml object-shaped evaluate_options.repeat; origin/main has the same issue. No live eval dogfood was run because this branch changes package/import/docs plumbing rather than eval execution or grader behavior.

Related

Beads: av-97sv, av-qxxr, av-b6u5, av-3c0o, av-zi7k, av-krn3

---

[cloudflare-workers-and-pages]

Deploying agentv with    Cloudflare Pages

Latest commit:	047bd82
Status:	✅  Deploy successful!
Preview URL:	https://212c233e.agentv.pages.dev
Branch Preview URL:	https://av-97sv-sdk-surface.agentv.pages.dev

View logs