@ank1015/agents-provider-fireworks

Runtime Fireworks Chat Completions provider adapter for the @ank1015/agents packages.

This package uses Fireworks' OpenAI-compatible Chat Completions endpoint through the openai SDK. It streams Fireworks chunks into the normalized assistant event stream used by @ank1015/agents-contracts.

Install

pnpm add @ank1015/agents-provider-fireworks

Usage

import { createFireworksProviderAdapter } from '@ank1015/agents-provider-fireworks';

const adapter = createFireworksProviderAdapter({
  provider: 'fireworks',
  apiKey: {
    type: 'env',
    name: 'FIREWORKS_API_KEY',
  },
});

The default base URL is https://api.fireworks.ai/inference/v1. Pass baseUrl in provider config to override it.

Notes

• Runtime model support is catalog-only through @ank1015/agents-provider-fireworks-spec.
• max_tokens is only sent when callers provide providerOptions.max_tokens.
• Fireworks custom grammar tools are not accepted through generic request tools; use providerOptions.response_format with type: 'grammar' instead.