@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