Session Coordinator Engine™

Multi-session resource coordination, conflict detection, and claim management in a single WebAssembly binary.

Overview

Session Coordinator Engine provides enterprise-grade coordination for multi-session AI systems. Track sessions, manage resource claims, detect conflicts, and prevent concurrent access issues with a simple, zero-configuration API.

Built with WebAssembly for maximum performance. Falls back to pure TypeScript when WASM is unavailable.

Installation

npm install session-coordinator-engine

Quick Start

import { initialize, registerSession, claimResource } from 'session-coordinator-engine';

// Initialize (one time)
await initialize({
  licenseKey: 'your-license-key',
  bundleId: 'com.yourcompany.app'
});

// Register a session
registerSession('session-1', 'Main Session', 'terminal-1', process.pid);

// Claim a resource
const result = claimResource('session-1', '/path/to/file.ts', 'write');

if (result.success) {
  console.log('Resource claimed successfully');
} else {
  console.log('Conflict detected:', result.conflicts);
}

Features

1. Session Management

Track multiple concurrent sessions with metadata, heartbeats, and automatic cleanup.

2. Resource Claims

Claim resources with read, write, or exclusive access modes. Automatic expiration and renewal.

3. Conflict Detection

Real-time conflict detection with detailed session information. Prevent concurrent write access and exclusive lock violations.

4. Heartbeat System

Keep sessions and claims alive with automatic heartbeat tracking. Configurable timeouts and auto-extension.

5. Zero Configuration

Works out of the box with sensible defaults. No database, no external dependencies, no setup.

6. WebAssembly Performance

Compiled to WASM for maximum speed. Transparent fallback to TypeScript when WASM is unavailable.

API Reference

Initialization

initialize(options: InitOptions): Promise<boolean>

Initialize the engine with license credentials.

Options:

• licenseKey (string) - Your license key
• bundleId (string) - Application bundle identifier
• requireWASM (boolean, optional) - Fail if WASM unavailable (default: false)

Session Management

registerSession(sessionId: string, name: string, terminal: string, pid: number): boolean
removeSession(sessionId: string): boolean
updateSession(sessionId: string, activity?: string, project?: string, files?: string[]): boolean
heartbeat(sessionId: string): boolean
listSessions(): SessionListResult

Resource Claims

claimResource(
  sessionId: string,
  resourcePath: string,
  claimType: 'read' | 'write' | 'exclusive',
  durationMinutes?: number,
  autoExtend?: boolean
): ClaimResult

releaseResource(sessionId: string, resourcePath: string): ReleaseResult
getClaimsForSession(sessionId: string): Claim[]
getClaimsForResource(resourcePath: string): Claim[]

Conflict Detection

checkConflict(
  resourcePath: string,
  claimType: 'read' | 'write' | 'exclusive',
  requestingSessionId: string
): ConflictCheckResult

Maintenance

expireStale(): number
getEngineStatus(): EngineStatus

Claim Types

read

Multiple sessions can hold read claims simultaneously. Blocked by write and exclusive claims.

write

Only one session can hold a write claim. Blocks other write and exclusive claims. Compatible with read claims.

exclusive

Only one session can hold an exclusive claim. Blocks all other claims (read, write, exclusive).

System Requirements

• Node.js 18.0.0 or higher
• No external dependencies
• No database required
• Cross-platform (Linux, macOS, Windows)

TypeScript Support

Full TypeScript definitions included. Import types directly:

import type { Session, Claim, ClaimType, ConflictInfo } from 'session-coordinator-engine';

Performance

• WASM binary: 9.6 KB
• Zero-copy string handling
• O(1) session lookup
• O(n) conflict detection (n = claims per resource, typically < 5)
• Sub-millisecond operation latency

License

Proprietary software licensed by Axis Radius Technologies LLC.

Patent applications pending.

See LICENSE file for complete terms.

Contact

For licensing inquiries:

Axis Radius Technologies LLC Email: [email protected] Web: https://axisradiustechnologies.com

Legal

Session Coordinator Engine™ is a trademark of Axis Radius Technologies LLC.

Copyright © 2026 Axis Radius Technologies LLC. All rights reserved.

This is proprietary software. Unauthorized use, distribution, or reverse engineering is prohibited.