AgentOS Extensions

Official extension registry for the AgentOS ecosystem.

Published Extensions

All extensions are published to npm under the @framers scope.

| Package | Description | npm | |---------|-------------|-----| | @framers/agentos-ext-auth | JWT authentication & subscription management | | | @framers/agentos-ext-anchor-providers | Solana on-chain provenance anchoring | | | @framers/agentos-ext-tip-ingestion | Tip content processing pipeline | | | @framers/agentos-ext-web-search | Multi-provider web search & fact-checking | | | @framers/agentos-ext-web-browser | Browser automation & content extraction | | | @framers/agentos-ext-telegram | Telegram Bot API integration | | | @framers/agentos-ext-telegram-bot | Telegram bot communications handler | | | @framers/agentos-ext-cli-executor | Shell command execution & file management | | | @framers/agentos-ext-channel-telegram | Telegram messaging channel (grammY) | | | @framers/agentos-ext-channel-whatsapp | WhatsApp messaging channel (Baileys) | | | @framers/agentos-ext-channel-discord | Discord messaging channel (discord.js) | | | @framers/agentos-ext-channel-slack | Slack messaging channel (Bolt) | | | @framers/agentos-ext-channel-webchat | Built-in WebChat channel (Socket.IO) | |

Repository Structure

agentos-extensions/
├── .changeset/            # Changesets for versioning & publishing
├── .github/workflows/     # CI, release, TypeDoc pages
├── logos/                 # Branding assets
├── templates/             # Starter templates for new extensions
│   ├── basic-tool/        # Single tool template
│   ├── multi-tool/        # Multiple tools template
│   ├── guardrail/         # Safety/compliance template
│   └── workflow/          # Multi-step process template
├── registry/
│   ├── curated/           # Official & verified extensions
│   │   ├── auth/          # Authentication & subscriptions
│   │   ├── communications/# Messaging (Telegram bot)
│   │   ├── integrations/  # External services (Telegram API)
│   │   ├── provenance/    # On-chain anchoring & tip ingestion
│   │   ├── research/      # Web search & browser automation
│   │   ├── channels/       # Messaging channels (Telegram, WhatsApp, Discord, Slack, WebChat)
│   │   └── system/        # CLI executor
│   └── community/         # Community-contributed extensions
├── scripts/               # Registry build & scaffolding tools
├── registry.json          # Auto-generated extension manifest
├── pnpm-workspace.yaml    # Workspace packages for publishing
└── typedoc.json           # API docs config

Quick Start

Install an extension

npm install @framers/agentos-ext-web-search

Use in your agent

import { AgentOS } from '@framers/agentos';
import webSearch from '@framers/agentos-ext-web-search';

const agentos = new AgentOS();
await agentos.initialize({
  extensionManifest: {
    packs: [{
      factory: () => webSearch({ /* config */ })
    }]
  }
});

Create a new extension

# Use the scaffolding script
pnpm run create-extension

# Or copy a template
cp -r templates/basic-tool registry/curated/category/my-extension
cd registry/curated/category/my-extension
pnpm install
pnpm run dev

Releasing & Publishing

This repo uses Changesets for multi-package versioning and npm publishing. See RELEASING.md for the full workflow.

TL;DR

# 1. Make your changes to one or more extensions

# 2. Add a changeset describing what changed
pnpm changeset

# 3. Commit and push to master
git add . && git commit -m "feat: my changes" && git push

# 4. The GitHub Action opens a "Version Packages" PR
#    → Merge it to publish updated packages to npm

Each extension is versioned and published independently. A change to web-search does not bump telegram.

Naming Convention

| Type | Pattern | Example | |------|---------|---------| | Extension | @framers/agentos-ext-{name} | @framers/agentos-ext-web-search | | Template | @framers/agentos-template-{type} | @framers/agentos-template-basic-tool |

CI/CD

All extensions get free CI/CD via GitHub Actions:

• CI (ci.yml): Lint, test, typecheck on every PR
• Release (release.yml): Changesets auto-version PRs + npm publish on merge
• TypeDoc (pages-typedoc.yml): API docs deployed to framersai.github.io/agentos-extensions
• Extension validation (extension-validation.yml): Manifest & structure checks
• Dependabot: Automated dependency updates with auto-merge for patches

Quality Standards

All Extensions

• TypeScript with strict mode

• 80% test coverage

• MIT license
• No hardcoded secrets

Additional for Curated

• Professional code review
• Performance benchmarks
• Integration tests
• Migration guides

Documentation

• API Reference (TypeDoc)
• How Extensions Work
• Extension Architecture
• Auto-Loading Extensions
• Agency Collaboration Examples
• Self-Hosted Registries
• Migration Guide
• Releasing & Publishing
• Contributing

Contributing

See CONTRIBUTING.md for detailed guidelines.

• Submit New Extension
• Report Bug
• Request Feature

Links

• Website: frame.dev
• AgentOS: agentos.sh
• Marketplace: vca.chat
• npm: @framers
• API Docs: framersai.github.io/agentos-extensions
• Contact: [email protected]

License

All extensions in this repository are MIT licensed.