Agent / foldkit-agent-native

Compatibility proof

The adapter is checked against @agent-native/core@0.177.1 using the real Agent Native registry, tool runtime, and schema wrapper rather than stand-ins.

Run from the repository root:

bash
pnpm exec vitest run packages/agent-native/test/framework.test.ts

No LLM credentials or network server are required; the suite uses an in-memory PGlite database for Agent Native's internal metadata lookups.

Framework surfaceWhat the test proves
Package registryregisterPackageActions + autoDiscoverActions discovers the generated entry; an app-local action file wins a name collision.
Agent tool runtimeactionsToEngineTools advertises the encoded schema; executeAgentToolCall changes the Foldkit Model for an authorized caller and refuses another caller.
Schema wrapperdefineAction derives parameters, preserves transforming input for the one decode in Foldkit, and rejects excess fields.

The public adapter types are checked against Agent Native's real ActionTool type. Agent Native remains a peer/development dependency of this adapter rather than a dependency of core foldkit-agent.