@standardagents/cloudflare

Cloudflare Workers AI provider for Standard Agents.

This package wraps Cloudflare Workers AI text generation models behind the Standard Agents provider interface. It supports:

• streaming and non-streaming chat generation
• Standard Agents message and tool translation
• usage normalization
• provider-owned cost calculation for documented Workers AI models

Install

npm install @standardagents/cloudflare @standardagents/spec

Usage

import { cloudflare } from '@standardagents/cloudflare';

const provider = cloudflare({
  apiKey: process.env.CLOUDFLARE_API_TOKEN!,
});

const result = await provider.generate({
  model: '@cf/meta/llama-3.1-8b-instruct',
  messages: [{ role: 'user', content: 'Summarize this in one sentence.' }],
});

console.log(result.content);
console.log(result.usage?.cost);

Factory

The package exports:

• cloudflare(config) - provider factory
• CloudflareProvider - provider class
• cloudflareProviderOptions - Zod schema for provider-specific options

Pricing Helpers

Known Workers AI model pricing is available through both the package root and the pure @standardagents/cloudflare/pricing subpath:

import { calculateCloudflareUsageCost } from '@standardagents/cloudflare/pricing';

const cost = calculateCloudflareUsageCost('@cf/meta/llama-3.1-8b-instruct', {
  promptTokens: 1000,
  completionTokens: 250,
});

For known models, generated and streamed responses attach the same value to usage.cost. Custom or private model IDs should define explicit model pricing in AgentBuilder because unknown provider prices are not guessed.