app/agent/cloudflareBackend.ts

zzmq.dev@gmail.com/zz / app / agent / cloudflareBackend.ts @ bce62350 Download

Ladder Summary

file The file implements a Cloudflare Workers AI chat backend by exposing the function **`createCloudflareBackend`**, which reads the required `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID` environment variables, then returns a `ChatBackend` built with `createOpenAiCompatBackend` configured for Cloudflare’s OpenAI‑compatible endpoint. Internal helpers `apiToken()` and `accountId()` validate the credentials, ensuring any missing configuration throws an early error before the CLI UI is entered. No other classes or functions are exported.

// Cloudflare Workers AI as a remote backend -- OpenAI-compatible chat

// completions, free up to 10,000 Neurons/account/day with no card on

// file. Notable beyond just being another free tier: this is the

// actual platform zz targets for its remote backend (see the Cloudflare

// competition framing in site/content), so this doubles as a live

// preview of that deployment target's own model-serving story.

import { createOpenAiCompatBackend } from "./openaiCompatBackend.js";

import type { ChatBackend } from "./chatBackend.js";

function apiToken(): string {

const key = process.env.CLOUDFLARE_API_TOKEN;

if (!key) throw new Error("Cloudflare Workers AI backend needs an API token: set CLOUDFLARE_API_TOKEN in your environment or app/.env (create one with Workers AI permission at https://dash.cloudflare.com/profile/api-tokens) -- never paste the token itself into chat.");

return key;

}

function accountId(): string {

const id = process.env.CLOUDFLARE_ACCOUNT_ID;

if (!id) throw new Error("Cloudflare Workers AI backend needs your account id: set CLOUDFLARE_ACCOUNT_ID in your environment or app/.env (shown by `wrangler whoami`).");

return id;

}

export function createCloudflareBackend(model: string): ChatBackend {

// Both resolved eagerly (accountId() already was; apiToken() now is

// too) -- callers (zz work/--assist) call this before

// resolveCliBackendMode/enterFullscreen, specifically so a missing

// credential fails fast as a plain CLI error instead of surfacing

// deep inside a TUI session on the first draft attempt.

const account = accountId();

const token = apiToken();

return createOpenAiCompatBackend({

name: `cloudflare:${model}`,

url: `https://api.cloudflare.com/client/v4/accounts/${account}/ai/v1/chat/completions`,

model,

apiKey: () => token,

});

}