pm-orchestrator-runner 1.0.0

package/dist/pool/agent-pool.d.ts

@@ -0,0 +1,284 @@
+/**
+ * L1/L2 Agent Pool
+ * Based on 04_COMPONENTS.md L98-155
+ *
+ * L1 Subagent Pool: Max 9 parallel read-only subagents
+ * L2 Executor Pool: Max 4 parallel executors with write permissions
+ */
+import { EventEmitter } from 'events';
+import { AgentType, TaskStatus } from '../models/enums';
+import { ErrorCode } from '../errors/error-codes';
+/**
+ * Agent Pool Error
+ */
+export declare class AgentPoolError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: Record<string, unknown>;
+    constructor(code: ErrorCode, message?: string, details?: Record<string, unknown>);
+}
+/**
+ * Agent permissions interface
+ */
+interface AgentPermissions {
+    read: boolean;
+    write: boolean;
+    execute: boolean;
+    allowedPaths?: string[];
+    writeScopes?: string[];
+    readScopes?: string[];
+}
+/**
+ * L1 Subagent info
+ */
+interface L1SubagentInfo {
+    id: string;
+    type: AgentType;
+    permissions: AgentPermissions;
+    started_at: string;
+    current_task?: string;
+    duration_seconds: number;
+}
+/**
+ * L2 Executor task info
+ */
+interface ExecutorTaskInfo {
+    task_id: string;
+    description?: string;
+    files?: string[];
+    status?: TaskStatus;
+    evidence?: Record<string, unknown>;
+}
+/**
+ * L2 Executor info
+ */
+interface L2ExecutorInfo {
+    id: string;
+    permissions: AgentPermissions;
+    started_at: string;
+    heldLocks: string[];
+    current_task: ExecutorTaskInfo;
+    canWrite: (path: string) => boolean;
+}
+/**
+ * Pool statistics
+ */
+interface PoolStatistics {
+    total_capacity: number;
+    active_count: number;
+    available_slots: number;
+    utilization_percent: number;
+    total_acquisitions: number;
+}
+/**
+ * Queued acquisition info
+ */
+interface QueuedAcquisition {
+    queued: boolean;
+    position: number;
+}
+/**
+ * Executor health info
+ */
+interface ExecutorHealth {
+    status: 'healthy' | 'stale' | 'error';
+    last_activity: string;
+}
+/**
+ * Task completion info
+ */
+interface TaskCompletionInfo {
+    status: TaskStatus;
+    evidence: Record<string, unknown> | null;
+}
+/**
+ * Evidence record
+ */
+interface EvidenceRecord {
+    type: string;
+    path: string;
+    hash: string;
+}
+/**
+ * Lock info
+ */
+interface LockInfo {
+    locked: boolean;
+    holder?: string;
+}
+/**
+ * Global semaphore for coordinating pool access
+ */
+declare class GlobalSemaphore {
+    private activeCount;
+    acquire(): void;
+    release(): void;
+    getActiveCount(): number;
+}
+/**
+ * Acquisition options for L1
+ */
+interface L1AcquisitionOptions {
+    allowedPaths?: string[];
+}
+/**
+ * Acquisition options for L2
+ */
+interface L2AcquisitionOptions {
+    writeScopes?: string[];
+    readScopes?: string[];
+    lockPaths?: string[];
+}
+/**
+ * Release options
+ */
+interface ReleaseOptions {
+    force?: boolean;
+}
+/**
+ * L1 Subagent Pool
+ * Max 9 parallel read-only subagents
+ */
+export declare class L1SubagentPool {
+    private readonly maxCapacity;
+    private agents;
+    private queueEnabled;
+    private queue;
+    private totalAcquisitions;
+    /**
+     * Get maximum pool capacity
+     */
+    getMaxCapacity(): number;
+    /**
+     * Get number of active subagents
+     */
+    getActiveCount(): number;
+    /**
+     * Get available slots
+     */
+    getAvailableSlots(): number;
+    /**
+     * Enable or disable queueing
+     */
+    enableQueueing(enabled: boolean): void;
+    /**
+     * Acquire a subagent slot
+     */
+    acquire(id: string, type: AgentType, options?: L1AcquisitionOptions): L1SubagentInfo;
+    /**
+     * Queue an acquisition when pool is full
+     */
+    queueAcquisition(id: string, type: AgentType, options?: L1AcquisitionOptions): QueuedAcquisition;
+    /**
+     * Release a subagent slot
+     */
+    release(id: string): void;
+    /**
+     * Release all subagents
+     */
+    releaseAll(): void;
+    /**
+     * Check if agent is active
+     */
+    isActive(id: string): boolean;
+    /**
+     * Assign task to agent
+     */
+    assignTask(id: string, taskId: string): void;
+    /**
+     * Get agent info
+     */
+    getAgentInfo(id: string): L1SubagentInfo;
+    /**
+     * Set start time for testing
+     */
+    setStartTimeForTesting(id: string, timestamp: number): void;
+    /**
+     * Get pool statistics
+     */
+    getStatistics(): PoolStatistics;
+}
+/**
+ * L2 Executor Pool
+ * Max 4 parallel executors with write permissions
+ */
+export declare class L2ExecutorPool extends EventEmitter {
+    private readonly maxCapacity;
+    private executors;
+    private locks;
+    private globalSemaphore;
+    private totalAcquisitions;
+    /**
+     * Get maximum pool capacity
+     */
+    getMaxCapacity(): number;
+    /**
+     * Get number of active executors
+     */
+    getActiveCount(): number;
+    /**
+     * Get available slots
+     */
+    getAvailableSlots(): number;
+    /**
+     * Acquire an executor slot
+     */
+    acquire(id: string, options?: L2AcquisitionOptions): L2ExecutorInfo;
+    /**
+     * Release an executor slot
+     */
+    release(id: string, options?: ReleaseOptions): void;
+    /**
+     * Release all executors
+     */
+    releaseAll(): void;
+    /**
+     * Get lock info
+     */
+    getLockInfo(path: string): LockInfo;
+    /**
+     * Assign task to executor
+     */
+    assignTask(id: string, task: Partial<ExecutorTaskInfo>): void;
+    /**
+     * Update task status
+     */
+    updateTaskStatus(id: string, status: TaskStatus): void;
+    /**
+     * Complete task with evidence
+     */
+    completeTask(id: string, completion: TaskCompletionInfo): void;
+    /**
+     * Record evidence
+     */
+    recordEvidence(id: string, evidence: EvidenceRecord): void;
+    /**
+     * Get task evidence
+     */
+    getTaskEvidence(id: string): EvidenceRecord[];
+    /**
+     * Get executor info
+     */
+    getExecutorInfo(id: string): L2ExecutorInfo;
+    /**
+     * Get executor health
+     */
+    getExecutorHealth(id: string): ExecutorHealth;
+    /**
+     * Set last activity for testing
+     */
+    setLastActivityForTesting(id: string, timestamp: number): void;
+    /**
+     * Cleanup stale executors
+     */
+    cleanupStaleExecutors(thresholdSeconds: number): void;
+    /**
+     * Get global semaphore
+     */
+    getGlobalSemaphore(): GlobalSemaphore;
+    /**
+     * Get pool statistics
+     */
+    getStatistics(): PoolStatistics;
+}
+export {};
+//# sourceMappingURL=agent-pool.d.ts.map

package/dist/pool/agent-pool.d.ts.map

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