Providers

Most apps configure storage, realtime, and file providers through the runtime or a framework adapter that creates one:

createAgentRuntime({
  agent,
  storage,
  realtime,
  live: { mode: "auto" },
  files,
  scopeKey: (identity) => identity.workspaceId,
});

Only provider package authors need the lower-level contracts:

• ThreadStore for durable thread state;
• ThreadLiveProvider for cross-process wakeups and live updates;
• FileProvider for immutable transcript attachments.

Capability bindings follow the same pattern for services the agent's tools declare, such as a sandbox: the tool declares the requirement and the runtime's capabilities record supplies the implementation.

Normal application code should not depend on provider record shapes.

Provider authors should also read Persisted Data Model. Use Provider Implementations when writing or validating a custom provider.