Configuration

import { ExuluProvider } from "@exulu/backend";

const provider = new ExuluProvider({
  id,                        // string — required
  name,                      // string — required
  description,               // string — required
  type,                      // "agent" — required
  provider,                  // string — required
  config,                    // ExuluProviderConfig
  capabilities,              // capabilities object
  maxContextLength,          // number
  workflows,                 // ExuluProviderWorkflowConfig
  queue,                     // ExuluQueueConfig
  authenticationInformation, // string
});

type ExuluProviderConfig = {
  name?: string;                                          // Model display name
  model?: {
    create: (params: {
      apiKey?: string;
      user?: number;
      role?: string;
      project?: string;
      agent?: string;
    }) => LanguageModel;
  };
  instructions?: string;                                  // Default system prompt
  memory?: string;                                        // Context ID for memory retrieval
};

import { createAnthropic } from "@ai-sdk/anthropic";

config: {
  name: "claude-sonnet-4-5",
  model: {
    create: ({ apiKey }) =>
      createAnthropic({ apiKey })("claude-sonnet-4-5-20251219"),
  },
  instructions: `You are a helpful assistant. Answer questions accurately and concisely.
When you use a tool, do not repeat the raw output — summarise the key information instead.`,
  memory: "user_interactions",
}

capabilities: {
  text: boolean;
  images: imageTypes[];   // e.g. [".png", ".jpg", ".jpeg", ".gif", ".webp"]
  files: fileTypes[];     // e.g. [".pdf", ".docx", ".xlsx", ".txt"]
  audio: audioTypes[];    // e.g. [".mp3", ".wav", ".m4a"]
  video: videoTypes[];    // e.g. [".mp4"]
}

maxContextLength: 200_000  // e.g. for Claude 3.5 Sonnet

type ExuluProviderWorkflowConfig = {
  enabled: boolean;
  queue?: Promise<ExuluQueueConfig>;
};

import { ExuluProvider } from "@exulu/backend";
import { createOpenAI } from "@ai-sdk/openai";

export const researchProvider = new ExuluProvider({
  id: "research_agent",
  name: "Research agent",
  description: "Deep-research agent that uses web search and document analysis to answer complex questions.",
  type: "agent",
  provider: "openai",

  config: {
    name: "gpt-4o",
    model: {
      create: ({ apiKey }) => createOpenAI({ apiKey })("gpt-4o"),
    },
    instructions: `You are an expert research assistant.
Gather information from multiple sources before answering. Always cite your sources inline.
When you are unsure, say so rather than speculating.`,
  },

  capabilities: {
    text: true,
    images: [".png", ".jpg", ".jpeg", ".gif", ".webp"],
    files: [".pdf", ".docx", ".txt", ".md"],
    audio: [],
    video: [],
  },

  maxContextLength: 128_000,

  authenticationInformation: "Uses the OPENAI_API_KEY variable set in Administration → Variables.",
});