pm-orchestrator-runner 1.0.7 → 1.0.8

package/dist/queue/queue-poller.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Queue Poller - Polls queue and executes tasks
+ * Per spec/20_QUEUE_STORE.md
+ *
+ * Features:
+ * - Polling interval configurable (default 1000ms)
+ * - 1 task per tick
+ * - In-flight limit: 1 (no concurrent execution)
+ * - Fail-closed error handling
+ */
+import { EventEmitter } from 'events';
+import { QueueStore, QueueItem } from './queue-store';
+/**
+ * Task executor function type
+ * Returns status and optional error message
+ */
+export type TaskExecutor = (item: QueueItem) => Promise<{
+    status: 'COMPLETE' | 'ERROR';
+    errorMessage?: string;
+}>;
+/**
+ * Poller configuration
+ */
+export interface QueuePollerConfig {
+    /** Polling interval in milliseconds (default: 1000) */
+    pollIntervalMs?: number;
+    /** Max stale task age in milliseconds (default: 5 minutes) */
+    maxStaleTaskAgeMs?: number;
+    /** Recover stale tasks on startup (default: true) */
+    recoverOnStartup?: boolean;
+}
+/**
+ * Poller state
+ */
+export interface QueuePollerState {
+    isRunning: boolean;
+    inFlight: QueueItem | null;
+    lastPollAt: string | null;
+    tasksProcessed: number;
+    errors: number;
+}
+/**
+ * Poller events
+ */
+export interface QueuePollerEvents {
+    started: [];
+    stopped: [];
+    poll: [{
+        queuedCount: number;
+    }];
+    claimed: [QueueItem];
+    completed: [QueueItem];
+    error: [QueueItem, Error];
+    'no-task': [];
+    'already-claimed': [string];
+    'stale-recovered': [number];
+}
+/**
+ * Queue Poller
+ * Polls the queue store and executes tasks
+ */
+export declare class QueuePoller extends EventEmitter {
+    private readonly store;
+    private readonly executor;
+    private readonly pollIntervalMs;
+    private readonly maxStaleTaskAgeMs;
+    private readonly recoverOnStartup;
+    private pollTimer;
+    private inFlight;
+    private isRunning;
+    private lastPollAt;
+    private tasksProcessed;
+    private errors;
+    constructor(store: QueueStore, executor: TaskExecutor, config?: QueuePollerConfig);
+    /**
+     * Start polling
+     */
+    start(): Promise<void>;
+    /**
+     * Stop polling
+     */
+    stop(): void;
+    /**
+     * Single poll iteration
+     * - Skip if task in-flight
+     * - Claim oldest QUEUED task
+     * - Execute and update status
+     */
+    poll(): Promise<void>;
+    /**
+     * Get current state
+     */
+    getState(): QueuePollerState;
+    /**
+     * Check if poller is running
+     */
+    isActive(): boolean;
+    /**
+     * Check if task is in-flight
+     */
+    hasInFlight(): boolean;
+    /**
+     * Get in-flight task
+     */
+    getInFlight(): QueueItem | null;
+}
+//# sourceMappingURL=queue-poller.d.ts.map

package/dist/queue/queue-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-poller.d.ts","sourceRoot":"","sources":["../../src/queue/queue-poller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAmB,MAAM,eAAe,CAAC;AAEvE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,SAAS,KACZ,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,EAAE,CAAC;IACZ,OAAO,EAAE,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IACrB,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC1B,SAAS,EAAE,EAAE,CAAC;IACd,iBAAiB,EAAE,CAAC,MAAM,CAAC,CAAC;IAC5B,iBAAiB,EAAE,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAE3C,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,MAAM,CAAa;gBAGzB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,YAAY,EACtB,MAAM,GAAE,iBAAsB;IAUhC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoE3B;;OAEG;IACH,QAAQ,IAAI,gBAAgB;IAU5B;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,WAAW,IAAI,SAAS,GAAG,IAAI;CAGhC"}

package/dist/queue/queue-poller.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * Queue Poller - Polls queue and executes tasks
+ * Per spec/20_QUEUE_STORE.md
+ *
+ * Features:
+ * - Polling interval configurable (default 1000ms)
+ * - 1 task per tick
+ * - In-flight limit: 1 (no concurrent execution)
+ * - Fail-closed error handling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueuePoller = void 0;
+const events_1 = require("events");
+/**
+ * Queue Poller
+ * Polls the queue store and executes tasks
+ */
+class QueuePoller extends events_1.EventEmitter {
+    store;
+    executor;
+    pollIntervalMs;
+    maxStaleTaskAgeMs;
+    recoverOnStartup;
+    pollTimer = null;
+    inFlight = null;
+    isRunning = false;
+    lastPollAt = null;
+    tasksProcessed = 0;
+    errors = 0;
+    constructor(store, executor, config = {}) {
+        super();
+        this.store = store;
+        this.executor = executor;
+        this.pollIntervalMs = config.pollIntervalMs ?? 1000;
+        this.maxStaleTaskAgeMs = config.maxStaleTaskAgeMs ?? 5 * 60 * 1000;
+        this.recoverOnStartup = config.recoverOnStartup ?? true;
+    }
+    /**
+     * Start polling
+     */
+    async start() {
+        if (this.isRunning) {
+            return;
+        }
+        this.isRunning = true;
+        // Recover stale tasks on startup (fail-closed)
+        if (this.recoverOnStartup) {
+            try {
+                const recovered = await this.store.recoverStaleTasks(this.maxStaleTaskAgeMs);
+                if (recovered > 0) {
+                    this.emit('stale-recovered', recovered);
+                }
+            }
+            catch (error) {
+                // Log but don't fail startup
+                // eslint-disable-next-line no-console
+                console.error('[QueuePoller] Failed to recover stale tasks:', error);
+            }
+        }
+        this.emit('started');
+        // Start polling loop
+        this.pollTimer = setInterval(() => {
+            this.poll().catch(error => {
+                // eslint-disable-next-line no-console
+                console.error('[QueuePoller] Poll error:', error);
+            });
+        }, this.pollIntervalMs);
+        // Immediate first poll
+        await this.poll();
+    }
+    /**
+     * Stop polling
+     */
+    stop() {
+        if (!this.isRunning) {
+            return;
+        }
+        this.isRunning = false;
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        this.emit('stopped');
+    }
+    /**
+     * Single poll iteration
+     * - Skip if task in-flight
+     * - Claim oldest QUEUED task
+     * - Execute and update status
+     */
+    async poll() {
+        if (!this.isRunning) {
+            return;
+        }
+        this.lastPollAt = new Date().toISOString();
+        // In-flight limit: 1
+        if (this.inFlight) {
+            return;
+        }
+        // Try to claim a task
+        const claimResult = await this.store.claim();
+        if (!claimResult.success) {
+            if (claimResult.error) {
+                // Task was claimed by another process
+                this.emit('already-claimed', claimResult.error);
+            }
+            else {
+                // No tasks in queue
+                this.emit('no-task');
+            }
+            return;
+        }
+        const item = claimResult.item;
+        this.inFlight = item;
+        this.emit('claimed', item);
+        try {
+            // Execute the task
+            const result = await this.executor(item);
+            // Update status
+            await this.store.updateStatus(item.task_id, result.status, result.errorMessage);
+            if (result.status === 'COMPLETE') {
+                this.tasksProcessed++;
+                this.emit('completed', item);
+            }
+            else {
+                this.errors++;
+                this.emit('error', item, new Error(result.errorMessage || 'Task failed'));
+            }
+        }
+        catch (error) {
+            // Fail-closed: mark as ERROR
+            this.errors++;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            try {
+                await this.store.updateStatus(item.task_id, 'ERROR', errorMessage);
+            }
+            catch (updateError) {
+                // Log but don't throw - we've already failed
+                // eslint-disable-next-line no-console
+                console.error('[QueuePoller] Failed to update error status:', updateError);
+            }
+            this.emit('error', item, error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            this.inFlight = null;
+        }
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return {
+            isRunning: this.isRunning,
+            inFlight: this.inFlight,
+            lastPollAt: this.lastPollAt,
+            tasksProcessed: this.tasksProcessed,
+            errors: this.errors,
+        };
+    }
+    /**
+     * Check if poller is running
+     */
+    isActive() {
+        return this.isRunning;
+    }
+    /**
+     * Check if task is in-flight
+     */
+    hasInFlight() {
+        return this.inFlight !== null;
+    }
+    /**
+     * Get in-flight task
+     */
+    getInFlight() {
+        return this.inFlight;
+    }
+}
+exports.QueuePoller = QueuePoller;
+//# sourceMappingURL=queue-poller.js.map

package/dist/queue/queue-poller.js.map

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

package/dist/queue/queue-store.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Queue Store - DynamoDB Local implementation
+ * Per spec/20_QUEUE_STORE.md
+ *
+ * Provides queue operations with:
+ * - Atomic QUEUED -> RUNNING transitions (conditional update)
+ * - Double execution prevention
+ * - Fail-closed error handling
+ */
+/**
+ * Queue Item status
+ * Per spec/20: QUEUED / RUNNING / COMPLETE / ERROR
+ */
+export type QueueItemStatus = 'QUEUED' | 'RUNNING' | 'COMPLETE' | 'ERROR';
+/**
+ * Queue Item schema
+ * Per spec/20_QUEUE_STORE.md
+ */
+export interface QueueItem {
+    task_id: string;
+    task_group_id: string;
+    session_id: string;
+    status: QueueItemStatus;
+    prompt: string;
+    created_at: string;
+    updated_at: string;
+    error_message?: string;
+}
+/**
+ * Queue Store configuration
+ */
+export interface QueueStoreConfig {
+    /** DynamoDB endpoint (default: http://localhost:8000) */
+    endpoint?: string;
+    /** Table name (default: pm-runner-queue) */
+    tableName?: string;
+    /** AWS region (default: local) */
+    region?: string;
+}
+/**
+ * Claim result
+ */
+export interface ClaimResult {
+    success: boolean;
+    item?: QueueItem;
+    error?: string;
+}
+/**
+ * Task Group summary for listing
+ * Per spec/19_WEB_UI.md: task group list view
+ */
+export interface TaskGroupSummary {
+    task_group_id: string;
+    task_count: number;
+    created_at: string;
+    latest_updated_at: string;
+}
+/**
+ * Queue Store
+ * Manages task queue with DynamoDB Local
+ */
+export declare class QueueStore {
+    private readonly client;
+    private readonly docClient;
+    private readonly tableName;
+    private readonly endpoint;
+    constructor(config?: QueueStoreConfig);
+    /**
+     * Get table name
+     */
+    getTableName(): string;
+    /**
+     * Get endpoint
+     */
+    getEndpoint(): string;
+    /**
+     * Check if table exists
+     */
+    tableExists(): Promise<boolean>;
+    /**
+     * Create table with required GSIs
+     * Per spec/20_QUEUE_STORE.md table definition
+     */
+    createTable(): Promise<void>;
+    /**
+     * Ensure table exists, create if not
+     */
+    ensureTable(): Promise<void>;
+    /**
+     * Wait for table to become active
+     */
+    private waitForTableActive;
+    /**
+     * Enqueue a new task
+     * Creates item with status=QUEUED
+     *
+     * @param sessionId - Session ID
+     * @param taskGroupId - Task Group ID
+     * @param prompt - User prompt
+     * @param taskId - Optional task ID (generates if not provided)
+     * @returns Created queue item
+     */
+    enqueue(sessionId: string, taskGroupId: string, prompt: string, taskId?: string): Promise<QueueItem>;
+    /**
+     * Get item by task_id
+     */
+    getItem(taskId: string): Promise<QueueItem | null>;
+    /**
+     * Claim the oldest QUEUED task (atomic QUEUED -> RUNNING)
+     * Per spec: Uses conditional update for double execution prevention
+     *
+     * @returns ClaimResult with success flag and item if claimed
+     */
+    claim(): Promise<ClaimResult>;
+    /**
+     * Update task status
+     * Per spec: RUNNING -> COMPLETE or RUNNING -> ERROR
+     *
+     * @param taskId - Task ID
+     * @param status - New status
+     * @param errorMessage - Optional error message (for ERROR status)
+     */
+    updateStatus(taskId: string, status: QueueItemStatus, errorMessage?: string): Promise<void>;
+    /**
+     * Get items by session ID
+     * Uses session-index GSI
+     */
+    getBySession(sessionId: string): Promise<QueueItem[]>;
+    /**
+     * Get items by status
+     * Uses status-index GSI
+     */
+    getByStatus(status: QueueItemStatus): Promise<QueueItem[]>;
+    /**
+     * Get items by task group ID
+     * Uses task-group-index GSI
+     * Per spec/19_WEB_UI.md: for listing tasks in a task group
+     */
+    getByTaskGroup(taskGroupId: string): Promise<QueueItem[]>;
+    /**
+     * Get all distinct task groups with summary
+     * Per spec/19_WEB_UI.md: for task group list view
+     * Note: Uses Scan - consider pagination for large datasets
+     */
+    getAllTaskGroups(): Promise<TaskGroupSummary[]>;
+    /**
+     * Delete item (for testing)
+     */
+    deleteItem(taskId: string): Promise<void>;
+    /**
+     * Mark stale RUNNING tasks as ERROR
+     * Per spec: fail-closed - don't leave tasks in "limbo"
+     *
+     * @param maxAgeMs - Max age in milliseconds for RUNNING tasks
+     * @returns Number of tasks marked as ERROR
+     */
+    recoverStaleTasks(maxAgeMs?: number): Promise<number>;
+    /**
+     * Close the client connection
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=queue-store.d.ts.map

package/dist/queue/queue-store.d.ts.map

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