Graphorin

Appearance

Graphorin API reference v0.7.0

Graphorin API reference / @graphorin/provider / adapters/vercel

adapters/vercel ​

vercelAdapter - wraps a Vercel AI SDK LanguageModel-shaped value into a Graphorin Provider. The adapter is the default cloud path: it speaks the AI SDK's streamText / generateText API and maps the resulting events onto the canonical ProviderEvent discriminated union.

Outbound, the adapter converts Graphorin messages / tools onto the AI SDK call contract (see vercel-messages.ts): tool definitions become a name-keyed record with jsonSchema()-shaped input schemas, assistant toolCalls become tool-call content parts, and ToolMessages become tool-result messages - the SDK zod-validates all of these and rejects the raw Graphorin shapes.

The AI SDK is an optional peer dependency of @graphorin/provider. Production callers leave runtimeOverrides unset and the adapter dynamically imports the package on first use; test fixtures pass a runtimeOverrides value to short-circuit the import and feed fixture chunks directly. The overrides shape is intentionally structural so users can supply hand-rolled stubs or any compatible library.

Interfaces ​

InterfaceDescription
AISDKChunkLoose chunk shape emitted by the AI SDK's streamText. The shape is intentionally permissive - we accept anything that carries the fields we use and ignore the rest. This keeps the adapter tolerant of additive AI SDK schema changes.
LanguageModelLikeStructural shape the adapter expects from the AI SDK language model value. The real LanguageModelV4 matches this shape. Re-declared here so we do not pin a hard dependency on @ai-sdk/provider.
VercelAdapterOptionsOptions accepted by vercelAdapter.
VercelRuntimeOverridesSubset of the AI SDK surface used by the adapter.

Functions ​

FunctionDescription
__resetVercelRuntimeCacheTest-only hook that resets the cached AI SDK runtime. Provider tests that mutate the cache (e.g. by injecting a mock then verifying the default loader runs) call this between scenarios.
vercelAdapterWrap a Vercel AI SDK language-model value in a Graphorin Provider. Outbound requests are converted onto the AI SDK call contract (name-keyed tools, tool-call / tool-result content parts - see vercel-messages.ts); the streaming chunks emitted by the AI SDK are translated back onto Graphorin ProviderEvents.