@chinudotdev/testkit

Test utilities for agent-core/v1 — scripted fakes and gateway stream contract helpers.

Use when building or testing providers and loop integrations without live API calls.

Install

npm install @chinudotdev/testkit

Quick start

import { fakeProvider, assertStreamContract, collectGatewayEvents } from "@chinudotdev/testkit";
import { createOpenAIProvider } from "@chinudotdev/provider-openai";

// Drain a real provider against a mock server
const events = await collectGatewayEvents(provider, request, signal);
assertStreamContract(events);

// Or drive the loop with a scripted fake
const provider = fakeProvider([
  { type: "text_delta", index: 0, text: "Hi" },
  { type: "stop", reason: "end_turn" },
]);

Exports

• fakeProvider(script) — playback gateway events from a script
• fakeExecutor / fakeDecider — loop test doubles
• assertStreamContract(events) — §3.2 clauses 1–10
• collectGatewayEvents(provider, request, signal?) — drain a provider stream

Docs

• Conformance kit
• Provider P-suite layout

License

MIT