@nativeharness/conformance

The specs as runnable tests. sandboxConformance() holds anyone's SandboxProvider to the same 41-case contract the built-in providers pass.

npm install -D @nativeharness/conformance

import { sandboxConformance } from "@nativeharness/conformance";

sandboxConformance({
  name: "my-provider",
  create: () => new MyProvider(),
});

That is the whole test file. It covers acquire, hydrate, exec, collect, release and destroy; reuse and its ceilings; output limits; path scope; deletes; and what capabilities has to actually mean.

A written spec drifts from the code. This one cannot: it is the same suite the repository runs against its own three providers.

vitest is a peer dependency — the suite registers tests in your runner, so it has to bind to the copy that is running them.

Part of nativeharness — the agent harness native to your app. Apache-2.0 · docs · source