Integrations

Vercel AI SDK

What it does

Vercel AI SDK handles streaming and model access. Loop Engine governs when and whether model-requested tool actions are authorized. Use Vercel AI SDK for model execution; use Loop Engine for guard enforcement, actor attribution, and audit trails.

Quick setup

1. Install

   ⧉

   1npm install @loop-engine/adapter-vercel-ai ai

2. Wrap a tool with governance

   ⧉

   1import { streamText, tool } from "ai";
   2import { wrapTool } from "@loop-engine/adapter-vercel-ai";
   3 
   4const submitPurchaseOrder = wrapTool(
   5  tool({
   6    description: "Submit purchase order",
   7    parameters: z.object({ vendor: z.string(), amount: z.number() }),
   8    execute: async ({ vendor, amount }) => ({ orderId: "PO-0042", vendor, amount })
   9  }),
   10  {
   11    loopDefinition: purchaseOrderLoop,
   12    engine,
   13    requiresApproval: ({ amount }) => amount > 5000
   14  }
   15);

3. Run with streaming

   ⧉

   1await streamText({
   2  model: openai("gpt-4o"),
   3  tools: { submitPurchaseOrder },
   4  prompt: "Submit a PO to Acme Medical for $9,200"
   5});

How it works

1. Model requests tool invocation
2. Adapter starts and advances loop transitions
3. Approval gates hold high-impact actions
4. Human decision unblocks execution
5. Execution and evidence are appended to history

Configuration reference

| Option | Type | Default | Description | |---|---|---|---| | loopDefinition | LoopDefinition | required | Governance state machine for the tool | | engine | LoopEngine | required | Runtime instance | | requiresApproval | (input) => boolean | — | Predicate for human checkpointing | | onApprovalRequired | (loopId, input) => Promise<void> | — | Notification hook | | actor | Actor | ai-agent | Actor attribution for transition records |

Troubleshooting

• Streaming parse errors — Enforce strict JSON response contracts in tool output.
• Model resolution errors — Verify the selected model provider is available in your AI SDK config.