@ariaflowagents/config

Config loader for AriaFlow projects. This package parses ariaflow.json(c) and .ariaflow/* directories to produce ready-to-run agent configs.

Usage

import 'dotenv/config';
import { openai } from '@ai-sdk/openai';
import { createRuntimeFromConfig, loadAriaflowConfig } from '@ariaflowagents/config';

const loaded = await loadAriaflowConfig({
  cwd: process.cwd(),
  modelRegistry: {
    default: openai('gpt-4o-mini') as any,
    'openai:gpt-4o-mini': openai('gpt-4o-mini') as any,
  },
});

const runtime = createRuntimeFromConfig(loaded);

for await (const part of runtime.stream({ input: 'Hello!' })) {
  if (part.type === 'text-delta') process.stdout.write(part.text);
}

Config Locations (Precedence)

1. Global: ~/.config/ariaflow/ariaflow.json(c)
2. Custom: ARIAFLOW_CONFIG
3. Project: ariaflow.json(c) at git root
4. .ariaflow/ directories (agents/flows/tools/skills)
5. Inline: ARIAFLOW_CONFIG_CONTENT

Folder Layout

.ariaflow/
  agent/
  flow/
  tools/
  skill/
  prompts/

Notes

• Models are resolved via modelRegistry.
• Tools can be loaded from .ariaflow/tools/*/tool.json and config entries.
• Skill loading is opt-in via a skill-loader tool config.