Intelligent edge runtime — auth, routing, scheduling, self-healing, and the Cortex Protocol.
@codmir/cortex
Cortex is the intelligent edge runtime that unifies authentication, AI model routing, adaptive scheduling, self-healing process management, and a structured protocol for multi-agent coordination. It gives your application a single orchestration layer that authenticates users, routes tasks to the optimal AI model, learns from execution history, and automatically restarts failed processes — while providing a file-based protocol for thousands of agents to reason together without stepping on each other.
Install
npm install @codmir/cortexQuick Start
import { Cortex } from '@codmir/cortex';
const cortex = new Cortex({
auth: {
jwtSecret: process.env.JWT_SECRET!,
jwtIssuer: 'my-app',
accessTokenTtl: 900,
refreshTokenTtl: 30 * 86400,
},
models: [
{
id: 'claude-sonnet',
provider: 'anthropic',
tier: 'standard',
costPer1kInput: 0.003,
costPer1kOutput: 0.015,
avgLatencyMs: 1200,
qualityScore: 90,
capabilities: ['code', 'reasoning', 'analysis'],
maxTokens: 200_000,
healthy: true,
circuitOpen: false,
},
],
threat: { maxFailedAttempts: 5 },
router: { defaultStrategy: 'balanced' },
scheduler: { maxConcurrency: 32 },
healer: { checkIntervalMs: 10_000 },
mesh: { maxProcesses: 64 },
});
// Authenticate a user
const session = await cortex.authenticate(token, {
userId: 'user_123',
ip: '192.168.1.1',
});
// Route and execute a task
const result = await cortex.executeTask({
id: 'task_1',
type: 'code-review',
input: { files: ['src/index.ts'] },
});
// Listen for events
cortex.on((event) => {
console.log(`[${event.type}]`, event.payload);
});
// Clean up
cortex.destroy();Two Layers
Cortex is organized into two layers: Intelligence for runtime orchestration and Protocol for persistent, file-based agent coordination.
Intelligence Layer
Runtime services that handle auth, routing, scheduling, and healing.
| Class | Purpose |
|---|---|
| Cortex | Unified orchestrator combining all intelligence services |
| ThreatDetector | Real-time threat assessment for auth events |
| SmartRouter | Route tasks to the optimal AI model |
| AdaptiveScheduler | EMA-based learning for model selection and concurrency |
| SelfHealer | Heartbeat monitoring with automatic restart and escalation |
Protocol Layer
File-based persistence in a .cortex/ directory. Agents read and write structured reasoning so thousands of agents can work as one mind.
| Class | Purpose |
|---|---|
| CortexIO | Read and write .cortex/ directory files |
| DNAManager | Encode project intelligence — stack, architecture, constraints, patterns |
| Timeline | Append-only reasoning ledger for decisions, failures, and learnings |
| SwarmProtocol | Multi-agent coordination — recruit, assign, lock, merge |
The protocol layer is documented in detail on the Cortex Protocol page.