Skip to main content

Auth

Authentication and subscription management extension that integrates with AgentOS via the service injection pattern.

Why This Exists​

Auth logic doesn't belong in the core library. This extension demonstrates clean separation:

  • Core AgentOS: Pure orchestration
  • Auth Extension: Optional middleware
  • Your choice: Use ours, bring your own, or omit entirely

Installation​

import { createAuthExtension } from '@framers/agentos-extensions/auth';
import { AgentOS } from '@framers/agentos';

const authExtension = createAuthExtension({
  jwtSecret: process.env.JWT_SECRET,
  defaultTier: 'free',
});

const agentos = new AgentOS();
await agentos.initialize({
  authService: authExtension.authService,
  subscriptionService: authExtension.subscriptionService,
});

Features​

  • JWT Authentication: Token generation, validation, refresh
  • Password Hashing: BCrypt with configurable rounds
  • Subscription Tiers: Multi-tier with feature flags
  • Tool Permissions: Integrate with AgentOS tool system
  • Persona Gating: Tier-based persona access

Usage​

See examples for complete integration patterns.

Author​

Framers AI (support@frame.dev)

License​

Apache-2.0