SDK overview

The client SDK is exported from @flue/sdk. Use it from applications that consume deployed Flue agents and workflows.

import { createFlueClient } from '@flue/sdk';

const client = createFlueClient({
  baseUrl: 'https://example.com/api',
  token: process.env.FLUE_TOKEN,
});

Client

createFlueClient(...) configures access to a deployed Flue application.

API namespaces

• client.agents invokes persistent agent instances and streams their events.
• client.workflows starts workflow runs.
• client.runs inspects and streams workflow runs.

Deployment-wide listing (all runs, all agents) is a server-side concern: compose your own endpoints from the listRuns(), getRun(), and listAgents() primitives exported by @flue/runtime. See compose your own admin endpoints.

Shared types

• Events and records describes observable events, records, and normalized model-turn data.
• Errors describes HTTP and stream errors.