@framers/agentos-extensions-registry

Extension catalog for AgentOS — metadata, query helpers, and createCuratedManifest() factory.

What this package is

This is the catalog and SDK for AgentOS extensions. It does not contain extension source code — it provides:

• Static metadata catalogs (CHANNEL_CATALOG, TOOL_CATALOG, PROVIDER_CATALOG) describing every known extension: its name, package, SDK, required secrets, and capabilities.
• Query helpers (getChannelEntry(), getToolEntry(), getProviderEntry()) for looking up catalog entries at runtime.
• Dynamic loader (createCuratedManifest()) that resolves which extension packages are actually installed, then builds an ExtensionManifest the AgentOS runtime can consume.

Architecture: catalog vs. source code

| Package | Role | |---|---| | @framers/agentos-extensions | Source code — the actual channel adapters, tool implementations, and extension packs | | @framers/agentos-extensions-registry (this) | Catalog/SDK — indexes the extensions above, stores metadata, and dynamically loads whichever packages are installed | | @framers/agentos | Runtime — provides ITool, IChannelAdapter, ExtensionManifest, and the agent kernel that consumes the manifest |

Dependency direction: this package depends on @framers/agentos for runtime types (peer dep) and references extension packages from @framers/agentos-extensions as optional dependencies. Only installed extensions are loaded; missing packages are silently skipped.

Installation

pnpm add @framers/agentos-extensions-registry

Then install whichever extension packages you need (e.g. @framers/agentos-ext-telegram). Only installed packages will be loaded by createCuratedManifest().

Main exports

| Export | Description | |---|---| | createCuratedManifest(options?) | Builds an ExtensionManifest from installed extensions. Accepts channel/tool filters, secrets, and per-extension overrides. | | CHANNEL_CATALOG | Static catalog of all 37 channel platform entries (platform, package, SDK, required secrets) | | TOOL_CATALOG | Static catalog of tool extensions (web search, CLI executor, image search, etc.) | | PROVIDER_CATALOG | Static catalog of 21 LLM provider entries (provider name, models, base URLs) | | getAvailableExtensions() | Returns only extensions whose npm packages are resolvable in the current environment | | getAvailableChannels() | Returns only channel adapters whose packages are installed | | SECRET_ENV_MAP | Maps secret keys (e.g. telegram.botToken) to environment variable names |

Usage

import { createCuratedManifest } from '@framers/agentos-extensions-registry';

// Load all installed extensions
const manifest = await createCuratedManifest({ channels: 'all', tools: 'all' });

// Or selectively enable specific channels
const manifest = await createCuratedManifest({
  channels: ['telegram', 'discord', 'slack'],
  tools: 'all',
  secrets: {
    'telegram.botToken': process.env.TELEGRAM_BOT_TOKEN,
    'discord.botToken': process.env.DISCORD_BOT_TOKEN,
    'slack.botToken': process.env.SLACK_BOT_TOKEN,
  },
});

// Pass to AgentOS runtime
const agent = new AgentOS();
await agent.initialize({ extensionManifest: manifest });

createCuratedManifest(options?)

| Parameter | Type | Default | Description | |---|---|---|---| | channels | string[] \| 'all' \| 'none' | 'all' | Which channel platforms to enable | | tools | string[] \| 'all' \| 'none' | 'all' | Which tool extensions to enable | | secrets | Record<string, string> | {} | Secrets map (falls back to env vars) | | basePriority | number | 0 | Base priority for all extensions | | overrides | Record<string, Override> | {} | Per-extension overrides: { enabled?, priority?, options? } |

License

MIT