@loomic/openai

OpenAI provider adapter for the Loomic agentic runtime. Translates the runtime's planner interface into structured OpenAI API calls using JSON Schema mode.

What it does

• createOpenAIProvider(config) — returns a LoomicProvider that the runtime uses for planning cycles
• Uses OpenAI's structured output mode to produce typed AgentPlan objects (UI diffs, tool calls, memory candidates)
• Supports GPT-4o and any model that supports JSON Schema response format

Install

npm install @loomic/openai @loomic/types
# peer dependency:
npm install openai

Usage

import { createOpenAIProvider } from '@loomic/openai';
import { createAgenticRuntime } from '@loomic/runtime';

const runtime = createAgenticRuntime({
  provider: createOpenAIProvider({
    apiKey: process.env.OPENAI_API_KEY,
    model: 'gpt-4o',           // default
    temperature: 0.2,          // optional
  }),
});

Provider routing

Pass alongside a local provider to enable cloud/local routing:

createAgenticRuntime({
  cloudProvider: createOpenAIProvider({ apiKey: '...' }),
  localProvider: myLocalProvider,
  providerRouter: myRoutingStrategy,
});