@bradygaster/squad-sdk 0.7.0 → 0.8.2

package/dist/client/event-bus.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cross-Session Event Bus (PRD 1)
+ *
+ * Pub/sub event bus for session lifecycle events. Enables the coordinator
+ * to observe all agent sessions from a single subscription point.
+ * Decouples event producers (sessions) from consumers (coordinator, Ralph, UI).
+ */
+export type SquadEventType = 'session.created' | 'session.destroyed' | 'session.status_changed' | 'session.message' | 'session.tool_call' | 'session.error' | 'agent.milestone' | 'coordinator.routing' | 'pool.health';
+export interface SquadEvent {
+    type: SquadEventType;
+    sessionId?: string;
+    agentName?: string;
+    payload: unknown;
+    timestamp: Date;
+}
+export type EventHandler = (event: SquadEvent) => void | Promise<void>;
+export declare class EventBus {
+    private handlers;
+    private allHandlers;
+    /** Subscribe to a specific event type */
+    on(type: SquadEventType, handler: EventHandler): () => void;
+    /** Subscribe to all events */
+    onAny(handler: EventHandler): () => void;
+    /** Emit an event to all matching subscribers */
+    emit(event: SquadEvent): Promise<void>;
+    /** Remove all handlers */
+    clear(): void;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/client/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/client/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,mBAAmB,GACnB,wBAAwB,GACxB,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,iBAAiB,GACjB,qBAAqB,GACrB,aAAa,CAAC;AAElB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAIvE,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAqD;IACrE,OAAO,CAAC,WAAW,CAAgC;IAEnD,yCAAyC;IACzC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAY3D,8BAA8B;IAC9B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAOxC,gDAAgD;IAC1C,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5C,0BAA0B;IAC1B,KAAK,IAAI,IAAI;CAId"}

package/dist/client/event-bus.js

@@ -0,0 +1,52 @@
+/**
+ * Cross-Session Event Bus (PRD 1)
+ *
+ * Pub/sub event bus for session lifecycle events. Enables the coordinator
+ * to observe all agent sessions from a single subscription point.
+ * Decouples event producers (sessions) from consumers (coordinator, Ralph, UI).
+ */
+// --- Event Bus ---
+export class EventBus {
+    handlers = new Map();
+    allHandlers = new Set();
+    /** Subscribe to a specific event type */
+    on(type, handler) {
+        if (!this.handlers.has(type)) {
+            this.handlers.set(type, new Set());
+        }
+        this.handlers.get(type).add(handler);
+        // Return unsubscribe function
+        return () => {
+            this.handlers.get(type)?.delete(handler);
+        };
+    }
+    /** Subscribe to all events */
+    onAny(handler) {
+        this.allHandlers.add(handler);
+        return () => {
+            this.allHandlers.delete(handler);
+        };
+    }
+    /** Emit an event to all matching subscribers */
+    async emit(event) {
+        const typeHandlers = this.handlers.get(event.type) ?? new Set();
+        const allPromises = [];
+        for (const handler of typeHandlers) {
+            const result = handler(event);
+            if (result instanceof Promise)
+                allPromises.push(result);
+        }
+        for (const handler of this.allHandlers) {
+            const result = handler(event);
+            if (result instanceof Promise)
+                allPromises.push(result);
+        }
+        await Promise.all(allPromises);
+    }
+    /** Remove all handlers */
+    clear() {
+        this.handlers.clear();
+        this.allHandlers.clear();
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/client/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/client/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,oBAAoB;AAEpB,MAAM,OAAO,QAAQ;IACX,QAAQ,GAA2C,IAAI,GAAG,EAAE,CAAC;IAC7D,WAAW,GAAsB,IAAI,GAAG,EAAE,CAAC;IAEnD,yCAAyC;IACzC,EAAE,CAAC,IAAoB,EAAE,OAAqB;QAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEtC,8BAA8B;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,OAAqB;QACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,IAAI,CAAC,KAAiB;QAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAChE,MAAM,WAAW,GAAoB,EAAE,CAAC;QAExC,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,MAAM,YAAY,OAAO;gBAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,MAAM,YAAY,OAAO;gBAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAED,0BAA0B;IAC1B,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/client/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Squad Client — High-Level API with Session Pool Management (PRD 1)
+ *
+ * This module provides the main Squad client API that combines:
+ * - SquadClient adapter (from adapter/client.ts) for connection management
+ * - SessionPool for multi-session lifecycle management
+ * - EventBus for cross-session event handling
+ *
+ * Applications should import from this module, not from adapter/ directly.
+ */
+export { SquadClient, type SquadClientOptions, type SquadConnectionState, } from '../adapter/client.js';
+export type { SquadSession, SquadSessionConfig, SquadSessionMetadata, SquadGetStatusResponse, SquadGetAuthStatusResponse, SquadModelInfo, } from '../adapter/types.js';
+export type SessionStatus = 'creating' | 'active' | 'idle' | 'error' | 'destroyed';
+export { SessionPool, type SessionPoolConfig, type PoolEvent, DEFAULT_POOL_CONFIG } from './session-pool.js';
+export { EventBus, type SquadEvent, type SquadEventType } from './event-bus.js';
+import { type SquadClientOptions } from '../adapter/client.js';
+import type { SquadSession, SquadSessionConfig } from '../adapter/types.js';
+import { SessionPool, type SessionPoolConfig } from './session-pool.js';
+import { EventBus } from './event-bus.js';
+export interface SquadClientWithPoolConfig extends SquadClientOptions {
+    /** Session pool configuration */
+    pool?: Partial<SessionPoolConfig>;
+}
+/**
+ * Squad Client with integrated session pool management.
+ *
+ * This is the recommended client for applications that need to manage
+ * multiple concurrent agent sessions. It provides:
+ * - Connection lifecycle management (from SquadClient)
+ * - Session pool with capacity limits and health checks
+ * - Event bus for cross-session event handling
+ *
+ * @example
+ * ```typescript
+ * const client = new SquadClientWithPool({
+ *   pool: { maxConcurrent: 5 }
+ * });
+ *
+ * await client.connect();
+ *
+ * const session1 = await client.createSession({ model: 'claude-sonnet-4.5' });
+ * const session2 = await client.createSession({ model: 'claude-haiku-4.5' });
+ *
+ * client.eventBus.on('session.created', (event) => {
+ *   console.log('New session:', event.sessionId);
+ * });
+ *
+ * await client.shutdown();
+ * ```
+ */
+export declare class SquadClientWithPool {
+    private baseClient;
+    readonly pool: SessionPool;
+    readonly eventBus: EventBus;
+    constructor(config?: SquadClientWithPoolConfig);
+    /** Connect to the Copilot CLI server */
+    connect(): Promise<void>;
+    /** Disconnect from the Copilot CLI server */
+    disconnect(): Promise<Error[]>;
+    /** Force disconnect without graceful cleanup */
+    forceDisconnect(): Promise<void>;
+    /** Get current connection state */
+    getState(): import("../adapter/client.js").SquadConnectionState;
+    /** Check if connected */
+    isConnected(): boolean;
+    /**
+     * Create a new session and add it to the pool.
+     * Throws if the pool is at capacity.
+     */
+    createSession(config?: SquadSessionConfig): Promise<SquadSession>;
+    /**
+     * Resume an existing session and add it to the pool if not present.
+     */
+    resumeSession(sessionId: string, config?: SquadSessionConfig): Promise<SquadSession>;
+    /**
+     * Delete a session and remove it from the pool.
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /** List all sessions from the base client */
+    listSessions(): Promise<import("../adapter/types.js").SquadSessionMetadata[]>;
+    /** Send a ping to verify connectivity */
+    ping(message?: string): Promise<{
+        message: string;
+        timestamp: number;
+        protocolVersion?: number;
+    }>;
+    /** Get CLI status information */
+    getStatus(): Promise<import("../adapter/types.js").SquadGetStatusResponse>;
+    /** Get authentication status */
+    getAuthStatus(): Promise<import("../adapter/types.js").SquadGetAuthStatusResponse>;
+    /** List available models */
+    listModels(): Promise<import("../adapter/types.js").SquadModelInfo[]>;
+    /** Subscribe to session lifecycle events */
+    on(eventType: any, handler: any): () => void;
+    /**
+     * Graceful shutdown — destroy all sessions and disconnect.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAGnF,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhF,OAAO,EAAkC,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,UAAU,CAAkB;IACpC,SAAgB,IAAI,EAAE,WAAW,CAAC;IAClC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;gBAEvB,MAAM,GAAE,yBAA8B;IAgBlD,wCAAwC;IAClC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,6CAA6C;IACvC,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAKpC,gDAAgD;IAC1C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC,mCAAmC;IACnC,QAAQ;IAIR,yBAAyB;IACzB,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACG,aAAa,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAuB3E;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAgB9F;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrD,6CAA6C;IACvC,YAAY;IAIlB,yCAAyC;IACnC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM;;;;;IAI3B,iCAAiC;IAC3B,SAAS;IAIf,gCAAgC;IAC1B,aAAa;IAInB,4BAA4B;IACtB,UAAU;IAIhB,4CAA4C;IAC5C,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;IAI/B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}

package/dist/client/index.js

@@ -0,0 +1,170 @@
+/**
+ * Squad Client — High-Level API with Session Pool Management (PRD 1)
+ *
+ * This module provides the main Squad client API that combines:
+ * - SquadClient adapter (from adapter/client.ts) for connection management
+ * - SessionPool for multi-session lifecycle management
+ * - EventBus for cross-session event handling
+ *
+ * Applications should import from this module, not from adapter/ directly.
+ */
+// Re-export core types and classes from adapter layer
+export { SquadClient, } from '../adapter/client.js';
+// Re-export pool and event bus
+export { SessionPool, DEFAULT_POOL_CONFIG } from './session-pool.js';
+export { EventBus } from './event-bus.js';
+// --- High-Level Client with Pool Management ---
+import { SquadClient as BaseSquadClient } from '../adapter/client.js';
+import { SessionPool } from './session-pool.js';
+import { EventBus } from './event-bus.js';
+/**
+ * Squad Client with integrated session pool management.
+ *
+ * This is the recommended client for applications that need to manage
+ * multiple concurrent agent sessions. It provides:
+ * - Connection lifecycle management (from SquadClient)
+ * - Session pool with capacity limits and health checks
+ * - Event bus for cross-session event handling
+ *
+ * @example
+ * ```typescript
+ * const client = new SquadClientWithPool({
+ *   pool: { maxConcurrent: 5 }
+ * });
+ *
+ * await client.connect();
+ *
+ * const session1 = await client.createSession({ model: 'claude-sonnet-4.5' });
+ * const session2 = await client.createSession({ model: 'claude-haiku-4.5' });
+ *
+ * client.eventBus.on('session.created', (event) => {
+ *   console.log('New session:', event.sessionId);
+ * });
+ *
+ * await client.shutdown();
+ * ```
+ */
+export class SquadClientWithPool {
+    baseClient;
+    pool;
+    eventBus;
+    constructor(config = {}) {
+        this.baseClient = new BaseSquadClient(config);
+        this.pool = new SessionPool(config.pool);
+        this.eventBus = new EventBus();
+        // Wire pool events to event bus
+        this.pool.on((event) => {
+            this.eventBus.emit({
+                type: event.type,
+                sessionId: event.sessionId,
+                payload: event,
+                timestamp: event.timestamp,
+            });
+        });
+    }
+    /** Connect to the Copilot CLI server */
+    async connect() {
+        return this.baseClient.connect();
+    }
+    /** Disconnect from the Copilot CLI server */
+    async disconnect() {
+        await this.pool.shutdown();
+        return this.baseClient.disconnect();
+    }
+    /** Force disconnect without graceful cleanup */
+    async forceDisconnect() {
+        await this.pool.shutdown();
+        return this.baseClient.forceDisconnect();
+    }
+    /** Get current connection state */
+    getState() {
+        return this.baseClient.getState();
+    }
+    /** Check if connected */
+    isConnected() {
+        return this.baseClient.isConnected();
+    }
+    /**
+     * Create a new session and add it to the pool.
+     * Throws if the pool is at capacity.
+     */
+    async createSession(config = {}) {
+        const session = await this.baseClient.createSession(config);
+        // Convert to pool-compatible session format
+        const poolSession = {
+            id: session.sessionId,
+            agentName: config.model ?? 'default',
+            status: 'active',
+            createdAt: new Date(),
+        };
+        this.pool.add(poolSession);
+        await this.eventBus.emit({
+            type: 'session.created',
+            sessionId: session.sessionId,
+            payload: { session },
+            timestamp: new Date(),
+        });
+        return session;
+    }
+    /**
+     * Resume an existing session and add it to the pool if not present.
+     */
+    async resumeSession(sessionId, config = {}) {
+        const session = await this.baseClient.resumeSession(sessionId, config);
+        if (!this.pool.get(sessionId)) {
+            const poolSession = {
+                id: session.sessionId,
+                agentName: config.model ?? 'resumed',
+                status: 'active',
+                createdAt: new Date(),
+            };
+            this.pool.add(poolSession);
+        }
+        return session;
+    }
+    /**
+     * Delete a session and remove it from the pool.
+     */
+    async deleteSession(sessionId) {
+        await this.baseClient.deleteSession(sessionId);
+        this.pool.remove(sessionId);
+        await this.eventBus.emit({
+            type: 'session.destroyed',
+            sessionId,
+            payload: null,
+            timestamp: new Date(),
+        });
+    }
+    /** List all sessions from the base client */
+    async listSessions() {
+        return this.baseClient.listSessions();
+    }
+    /** Send a ping to verify connectivity */
+    async ping(message) {
+        return this.baseClient.ping(message);
+    }
+    /** Get CLI status information */
+    async getStatus() {
+        return this.baseClient.getStatus();
+    }
+    /** Get authentication status */
+    async getAuthStatus() {
+        return this.baseClient.getAuthStatus();
+    }
+    /** List available models */
+    async listModels() {
+        return this.baseClient.listModels();
+    }
+    /** Subscribe to session lifecycle events */
+    on(eventType, handler) {
+        return this.baseClient.on(eventType, handler);
+    }
+    /**
+     * Graceful shutdown — destroy all sessions and disconnect.
+     */
+    async shutdown() {
+        await this.pool.shutdown();
+        await this.baseClient.disconnect();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}

package/dist/client/session-pool.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Session Pool Manager (PRD 1)
+ *
+ * Manages the lifecycle of multiple concurrent agent sessions.
+ * Tracks session state, enforces concurrency limits, and handles
+ * cleanup of idle/errored sessions.
+ */
+export type SessionStatus = 'creating' | 'active' | 'idle' | 'error' | 'destroyed';
+export interface SquadSession {
+    id: string;
+    agentName: string;
+    status: SessionStatus;
+    createdAt: Date;
+}
+export interface SessionPoolConfig {
+    /** Maximum concurrent sessions */
+    maxConcurrent: number;
+    /** Idle timeout before auto-cleanup (ms) */
+    idleTimeout: number;
+    /** Health check interval (ms) */
+    healthCheckInterval: number;
+}
+export declare const DEFAULT_POOL_CONFIG: SessionPoolConfig;
+export type PoolEventType = 'session.added' | 'session.removed' | 'session.status_changed' | 'pool.at_capacity' | 'pool.health_check';
+export interface PoolEvent {
+    type: PoolEventType;
+    sessionId?: string;
+    oldStatus?: SessionStatus;
+    newStatus?: SessionStatus;
+    timestamp: Date;
+}
+export declare class SessionPool {
+    private config;
+    private sessions;
+    private healthCheckTimer;
+    private cleanupTimer;
+    private listeners;
+    constructor(config?: Partial<SessionPoolConfig>);
+    /** Add a session to the pool */
+    add(session: SquadSession): void;
+    /** Remove a session from the pool */
+    remove(sessionId: string): boolean;
+    /** Get a session by ID */
+    get(sessionId: string): SquadSession | undefined;
+    /** Find a session by agent name */
+    findByAgent(agentName: string): SquadSession | undefined;
+    /** Get all active sessions */
+    active(): SquadSession[];
+    /** Update session status and emit event */
+    updateStatus(sessionId: string, newStatus: SessionStatus): void;
+    /** Current pool size */
+    get size(): number;
+    /** Whether the pool is at capacity */
+    get atCapacity(): boolean;
+    /** Destroy all sessions and stop timers */
+    shutdown(): Promise<void>;
+    /** Subscribe to pool events */
+    on(handler: (event: PoolEvent) => void): () => void;
+    /** Emit a pool event to all listeners */
+    private emitEvent;
+    /** Start the health check timer */
+    private startHealthCheckTimer;
+    /** Start the idle session cleanup timer */
+    private startCleanupTimer;
+}
+//# sourceMappingURL=session-pool.d.ts.map

package/dist/client/session-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pool.d.ts","sourceRoot":"","sources":["../../src/client/session-pool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;CACjB;AAID,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IAEtB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,mBAAmB,EAAE,iBAIjC,CAAC;AAIF,MAAM,MAAM,aAAa,GACrB,eAAe,GACf,iBAAiB,GACjB,wBAAwB,GACxB,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;CACjB;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,SAAS,CAAyC;gBAE9C,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAMnD,gCAAgC;IAChC,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAgBhC,qCAAqC;IACrC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAYlC,0BAA0B;IAC1B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIhD,mCAAmC;IACnC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAOxD,8BAA8B;IAC9B,MAAM,IAAI,YAAY,EAAE;IAIxB,2CAA2C;IAC3C,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI;IAiB/D,wBAAwB;IACxB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sCAAsC;IACtC,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,2CAA2C;IACrC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,+BAA+B;IAC/B,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI;IAQnD,yCAAyC;IACzC,OAAO,CAAC,SAAS;IAMjB,mCAAmC;IACnC,OAAO,CAAC,qBAAqB;IAS7B,2CAA2C;IAC3C,OAAO,CAAC,iBAAiB;CAa1B"}

package/dist/client/session-pool.js

@@ -0,0 +1,145 @@
+/**
+ * Session Pool Manager (PRD 1)
+ *
+ * Manages the lifecycle of multiple concurrent agent sessions.
+ * Tracks session state, enforces concurrency limits, and handles
+ * cleanup of idle/errored sessions.
+ */
+export const DEFAULT_POOL_CONFIG = {
+    maxConcurrent: 10,
+    idleTimeout: 300_000, // 5 minutes
+    healthCheckInterval: 30_000, // 30 seconds
+};
+// --- Session Pool ---
+export class SessionPool {
+    config;
+    sessions = new Map();
+    healthCheckTimer = null;
+    cleanupTimer = null;
+    listeners = [];
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_POOL_CONFIG, ...config };
+        this.startHealthCheckTimer();
+        this.startCleanupTimer();
+    }
+    /** Add a session to the pool */
+    add(session) {
+        if (this.atCapacity) {
+            this.emitEvent({
+                type: 'pool.at_capacity',
+                timestamp: new Date(),
+            });
+            throw new Error(`SessionPool at capacity (${this.config.maxConcurrent})`);
+        }
+        this.sessions.set(session.id, session);
+        this.emitEvent({
+            type: 'session.added',
+            sessionId: session.id,
+            timestamp: new Date(),
+        });
+    }
+    /** Remove a session from the pool */
+    remove(sessionId) {
+        const existed = this.sessions.delete(sessionId);
+        if (existed) {
+            this.emitEvent({
+                type: 'session.removed',
+                sessionId,
+                timestamp: new Date(),
+            });
+        }
+        return existed;
+    }
+    /** Get a session by ID */
+    get(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /** Find a session by agent name */
+    findByAgent(agentName) {
+        for (const session of this.sessions.values()) {
+            if (session.agentName === agentName)
+                return session;
+        }
+        return undefined;
+    }
+    /** Get all active sessions */
+    active() {
+        return Array.from(this.sessions.values()).filter(s => s.status === 'active');
+    }
+    /** Update session status and emit event */
+    updateStatus(sessionId, newStatus) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        const oldStatus = session.status;
+        if (oldStatus !== newStatus) {
+            session.status = newStatus;
+            this.emitEvent({
+                type: 'session.status_changed',
+                sessionId,
+                oldStatus,
+                newStatus,
+                timestamp: new Date(),
+            });
+        }
+    }
+    /** Current pool size */
+    get size() {
+        return this.sessions.size;
+    }
+    /** Whether the pool is at capacity */
+    get atCapacity() {
+        return this.sessions.size >= this.config.maxConcurrent;
+    }
+    /** Destroy all sessions and stop timers */
+    async shutdown() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = null;
+        }
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        this.sessions.clear();
+    }
+    /** Subscribe to pool events */
+    on(handler) {
+        this.listeners.push(handler);
+        return () => {
+            const index = this.listeners.indexOf(handler);
+            if (index !== -1)
+                this.listeners.splice(index, 1);
+        };
+    }
+    /** Emit a pool event to all listeners */
+    emitEvent(event) {
+        for (const listener of this.listeners) {
+            listener(event);
+        }
+    }
+    /** Start the health check timer */
+    startHealthCheckTimer() {
+        this.healthCheckTimer = setInterval(() => {
+            this.emitEvent({
+                type: 'pool.health_check',
+                timestamp: new Date(),
+            });
+        }, this.config.healthCheckInterval);
+    }
+    /** Start the idle session cleanup timer */
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            const now = Date.now();
+            for (const session of this.sessions.values()) {
+                if (session.status === 'idle') {
+                    const idleTime = now - session.createdAt.getTime();
+                    if (idleTime > this.config.idleTimeout) {
+                        this.remove(session.id);
+                    }
+                }
+            }
+        }, this.config.idleTimeout);
+    }
+}
+//# sourceMappingURL=session-pool.js.map

package/dist/client/session-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pool.js","sourceRoot":"","sources":["../../src/client/session-pool.ts"],"names":[],"mappings":"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"}

package/dist/config/agent-doc.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Agent Documentation Parser (M2-12)
+ *
+ * Extracts structured metadata from .agent.md files so the markdown
+ * becomes a reference document while typed config remains the runtime
+ * source of truth.
+ *
+ * @module config/agent-doc
+ */
+/**
+ * Structured metadata extracted from an agent .md file.
+ */
+export interface AgentDocMetadata {
+    /** Agent name from the IDENTITY section or top-level heading */
+    name?: string;
+    /** One-line description / role */
+    description?: string;
+    /** Capability strings listed under CAPABILITIES */
+    capabilities: string[];
+    /** Routing hints (work-type patterns this agent handles) */
+    routingHints: string[];
+    /** Model preferences (e.g. "claude-sonnet-4.5") */
+    modelPreferences: string[];
+    /** Constraints / boundaries the agent must follow */
+    constraints: string[];
+    /** Tool names the agent is allowed to use */
+    tools: string[];
+    /** Extra sections not in the standard set, keyed by heading */
+    extraSections: Record<string, string>;
+}
+/**
+ * Parse an agent .agent.md file into structured metadata.
+ *
+ * Recognised top-level (##) sections:
+ *   IDENTITY, CAPABILITIES, ROUTING, CONSTRAINTS, TOOLS
+ *
+ * Any other ## sections are captured in `extraSections`.
+ *
+ * @param markdown - Raw markdown content of the agent doc
+ * @returns Parsed metadata
+ */
+export declare function parseAgentDoc(markdown: string): AgentDocMetadata;
+//# sourceMappingURL=agent-doc.d.ts.map

package/dist/config/agent-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-doc.d.ts","sourceRoot":"","sources":["../../src/config/agent-doc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,qDAAqD;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAWD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAmDhE"}