attocode 0.1.0

package/dist/src/core/queues/atomic-counter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Lock-free monotonic counter for generating unique submission identifiers.
+ * Uses bigint for virtually unlimited range without overflow concerns.
+ */
+export declare class AtomicCounter {
+    private counter;
+    /**
+     * Creates a new AtomicCounter instance.
+     * @param initial - Optional initial value (default: 0n)
+     */
+    constructor(initial?: bigint);
+    /**
+     * Generates the next unique submission ID.
+     * Increments the internal counter and returns an ID in format `sub-{base36}`.
+     * @returns Unique string ID (e.g., 'sub-0', 'sub-1', 'sub-a', 'sub-1s')
+     */
+    next(): string;
+    /**
+     * Returns the current counter value without incrementing.
+     * Useful for inspection and debugging.
+     * @returns Current counter value as bigint
+     */
+    current(): bigint;
+    /**
+     * Resets the counter to a specified value or zero.
+     * Primarily useful for testing scenarios.
+     * @param value - Optional value to reset to (default: 0n)
+     */
+    reset(value?: bigint): void;
+}
+/**
+ * Global singleton counter instance for generating unique submission IDs
+ * across the application.
+ */
+export declare const globalCounter: AtomicCounter;
+//# sourceMappingURL=atomic-counter.d.ts.map

package/dist/src/core/queues/atomic-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-counter.d.ts","sourceRoot":"","sources":["../../../../src/core/queues/atomic-counter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;gBACS,OAAO,GAAE,MAAW;IAIhC;;;;OAIG;IACH,IAAI,IAAI,MAAM;IAMd;;;;OAIG;IACH,OAAO,IAAI,MAAM;IAIjB;;;;OAIG;IACH,KAAK,CAAC,KAAK,GAAE,MAAW,GAAG,IAAI;CAGhC;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/src/core/queues/atomic-counter.js

@@ -0,0 +1,46 @@
+/**
+ * Lock-free monotonic counter for generating unique submission identifiers.
+ * Uses bigint for virtually unlimited range without overflow concerns.
+ */
+export class AtomicCounter {
+    counter;
+    /**
+     * Creates a new AtomicCounter instance.
+     * @param initial - Optional initial value (default: 0n)
+     */
+    constructor(initial = 0n) {
+        this.counter = initial;
+    }
+    /**
+     * Generates the next unique submission ID.
+     * Increments the internal counter and returns an ID in format `sub-{base36}`.
+     * @returns Unique string ID (e.g., 'sub-0', 'sub-1', 'sub-a', 'sub-1s')
+     */
+    next() {
+        const id = this.counter;
+        this.counter += 1n;
+        return `sub-${id.toString(36)}`;
+    }
+    /**
+     * Returns the current counter value without incrementing.
+     * Useful for inspection and debugging.
+     * @returns Current counter value as bigint
+     */
+    current() {
+        return this.counter;
+    }
+    /**
+     * Resets the counter to a specified value or zero.
+     * Primarily useful for testing scenarios.
+     * @param value - Optional value to reset to (default: 0n)
+     */
+    reset(value = 0n) {
+        this.counter = value;
+    }
+}
+/**
+ * Global singleton counter instance for generating unique submission IDs
+ * across the application.
+ */
+export const globalCounter = new AtomicCounter();
+//# sourceMappingURL=atomic-counter.js.map

package/dist/src/core/queues/atomic-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-counter.js","sourceRoot":"","sources":["../../../../src/core/queues/atomic-counter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,aAAa;IAChB,OAAO,CAAS;IAExB;;;OAGG;IACH,YAAY,UAAkB,EAAE;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACxB,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QACnB,OAAO,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAgB,EAAE;QACtB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC"}

package/dist/src/core/queues/event-queue.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Unbounded pub/sub event emitter for Agent to UI communication.
+ * Unlike SubmissionQueue, this never blocks the producer (agent).
+ * Uses fire-and-forget semantics with async dispatch.
+ */
+import type { AgentEvent, EventEnvelope, SubmissionId } from '../protocol/types.js';
+/**
+ * Generic event listener that receives all events.
+ */
+export type EventListener = (envelope: EventEnvelope) => void;
+/**
+ * Typed event listener that receives events of a specific type.
+ */
+export type TypedEventListener<T extends AgentEvent> = (envelope: EventEnvelope & {
+    event: T;
+}) => void;
+/**
+ * Configuration for the EventQueue.
+ */
+export interface EventQueueConfig {
+    /** Maximum number of recent events to store (default: 100) */
+    maxRecentEvents?: number;
+}
+/**
+ * Statistics about the event queue for debugging.
+ */
+export interface EventQueueStats {
+    /** Number of global listeners */
+    globalListeners: number;
+    /** Number of typed listeners by event type */
+    typedListeners: Record<string, number>;
+    /** Number of recent events in buffer */
+    recentEventsCount: number;
+}
+/**
+ * Error thrown when a once() call times out.
+ */
+export declare class EventTimeoutError extends Error {
+    constructor(eventType: string, timeout: number);
+}
+/**
+ * An unbounded pub/sub event emitter for Agent to UI communication.
+ *
+ * Features:
+ * - Fire-and-forget semantics (never blocks producer)
+ * - Typed event subscriptions
+ * - Recent events buffer for reconnection/replay
+ * - Async dispatch via queueMicrotask
+ */
+export declare class EventQueue {
+    private readonly maxRecentEvents;
+    private readonly recentEvents;
+    private readonly globalListeners;
+    private readonly typedListeners;
+    /**
+     * Creates a new EventQueue.
+     * @param config - Optional configuration
+     */
+    constructor(config?: EventQueueConfig);
+    /**
+     * Emits an event to all listeners.
+     * Never blocks - uses fire-and-forget semantics.
+     *
+     * @param submissionId - The submission this event relates to
+     * @param event - The event to emit
+     */
+    emit(submissionId: SubmissionId, event: AgentEvent): void;
+    /**
+     * Subscribes to all events.
+     *
+     * @param listener - The listener to call for each event
+     * @returns Unsubscribe function
+     */
+    subscribe(listener: EventListener): () => void;
+    /**
+     * Subscribes to events of a specific type.
+     *
+     * @param type - The event type to listen for
+     * @param listener - The listener to call for matching events
+     * @returns Unsubscribe function
+     */
+    on<T extends AgentEvent>(type: T['type'], listener: TypedEventListener<T>): () => void;
+    /**
+     * Returns a promise that resolves with the first matching event.
+     *
+     * @param type - The event type to wait for
+     * @param timeout - Optional timeout in ms (rejects with EventTimeoutError)
+     * @returns Promise that resolves with the matching event envelope
+     */
+    once<T extends AgentEvent>(type: T['type'], timeout?: number): Promise<EventEnvelope & {
+        event: T;
+    }>;
+    /**
+     * Gets recent events, optionally filtered by timestamp.
+     *
+     * @param since - Optional timestamp to filter events after
+     * @returns Array of recent event envelopes
+     */
+    getRecentEvents(since?: number): EventEnvelope[];
+    /**
+     * Gets recent events filtered by submission ID.
+     *
+     * @param submissionId - The submission ID to filter by
+     * @returns Array of event envelopes for the submission
+     */
+    getEventsForSubmission(submissionId: SubmissionId): EventEnvelope[];
+    /**
+     * Clears all listeners and recent events.
+     */
+    clear(): void;
+    /**
+     * Returns statistics about the queue for debugging.
+     */
+    stats(): EventQueueStats;
+    /**
+     * Adds an envelope to the recent events buffer.
+     * Maintains circular buffer semantics.
+     */
+    private addToRecentEvents;
+    /**
+     * Notifies all listeners of an event asynchronously.
+     * Ignores listener errors (fire-and-forget).
+     */
+    private notifyListeners;
+}
+//# sourceMappingURL=event-queue.d.ts.map

package/dist/src/core/queues/event-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-queue.d.ts","sourceRoot":"","sources":["../../../../src/core/queues/event-queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,UAAU,IAAI,CACrD,QAAQ,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,KACnC,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI/C;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiC;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0D;IAEzF;;;OAGG;gBACS,MAAM,CAAC,EAAE,gBAAgB;IAIrC;;;;;;OAMG;IACH,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAczD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAQ9C;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,UAAU,EACrB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EACf,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,MAAM,IAAI;IAmBb;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,SAAS,UAAU,EACvB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC;IA8BxC;;;;;OAKG;IACH,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAQhD;;;;;OAKG;IACH,sBAAsB,CAAC,YAAY,EAAE,YAAY,GAAG,aAAa,EAAE;IAMnE;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,KAAK,IAAI,eAAe;IAaxB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;OAGG;IACH,OAAO,CAAC,eAAe;CA0BxB"}

package/dist/src/core/queues/event-queue.js

@@ -0,0 +1,208 @@
+/**
+ * Unbounded pub/sub event emitter for Agent to UI communication.
+ * Unlike SubmissionQueue, this never blocks the producer (agent).
+ * Uses fire-and-forget semantics with async dispatch.
+ */
+/**
+ * Error thrown when a once() call times out.
+ */
+export class EventTimeoutError extends Error {
+    constructor(eventType, timeout) {
+        super(`Timed out waiting for event '${eventType}' after ${timeout}ms`);
+        this.name = 'EventTimeoutError';
+    }
+}
+/**
+ * An unbounded pub/sub event emitter for Agent to UI communication.
+ *
+ * Features:
+ * - Fire-and-forget semantics (never blocks producer)
+ * - Typed event subscriptions
+ * - Recent events buffer for reconnection/replay
+ * - Async dispatch via queueMicrotask
+ */
+export class EventQueue {
+    maxRecentEvents;
+    recentEvents = [];
+    globalListeners = new Set();
+    typedListeners = new Map();
+    /**
+     * Creates a new EventQueue.
+     * @param config - Optional configuration
+     */
+    constructor(config) {
+        this.maxRecentEvents = config?.maxRecentEvents ?? 100;
+    }
+    /**
+     * Emits an event to all listeners.
+     * Never blocks - uses fire-and-forget semantics.
+     *
+     * @param submissionId - The submission this event relates to
+     * @param event - The event to emit
+     */
+    emit(submissionId, event) {
+        const envelope = {
+            submissionId,
+            event,
+            timestamp: Date.now(),
+        };
+        // Store in recent events buffer (circular)
+        this.addToRecentEvents(envelope);
+        // Notify all listeners asynchronously
+        this.notifyListeners(envelope);
+    }
+    /**
+     * Subscribes to all events.
+     *
+     * @param listener - The listener to call for each event
+     * @returns Unsubscribe function
+     */
+    subscribe(listener) {
+        this.globalListeners.add(listener);
+        return () => {
+            this.globalListeners.delete(listener);
+        };
+    }
+    /**
+     * Subscribes to events of a specific type.
+     *
+     * @param type - The event type to listen for
+     * @param listener - The listener to call for matching events
+     * @returns Unsubscribe function
+     */
+    on(type, listener) {
+        let listeners = this.typedListeners.get(type);
+        if (!listeners) {
+            listeners = new Set();
+            this.typedListeners.set(type, listeners);
+        }
+        // Cast is safe because we filter by type before calling
+        listeners.add(listener);
+        return () => {
+            listeners.delete(listener);
+            // Clean up empty sets
+            if (listeners.size === 0) {
+                this.typedListeners.delete(type);
+            }
+        };
+    }
+    /**
+     * Returns a promise that resolves with the first matching event.
+     *
+     * @param type - The event type to wait for
+     * @param timeout - Optional timeout in ms (rejects with EventTimeoutError)
+     * @returns Promise that resolves with the matching event envelope
+     */
+    once(type, timeout) {
+        return new Promise((resolve, reject) => {
+            let timeoutId;
+            let unsubscribe;
+            const cleanup = () => {
+                if (timeoutId !== undefined) {
+                    clearTimeout(timeoutId);
+                }
+                if (unsubscribe) {
+                    unsubscribe();
+                }
+            };
+            // Set up listener
+            unsubscribe = this.on(type, (envelope) => {
+                cleanup();
+                resolve(envelope);
+            });
+            // Set up timeout if specified
+            if (timeout !== undefined && timeout > 0) {
+                timeoutId = setTimeout(() => {
+                    cleanup();
+                    reject(new EventTimeoutError(type, timeout));
+                }, timeout);
+            }
+        });
+    }
+    /**
+     * Gets recent events, optionally filtered by timestamp.
+     *
+     * @param since - Optional timestamp to filter events after
+     * @returns Array of recent event envelopes
+     */
+    getRecentEvents(since) {
+        if (since === undefined) {
+            return [...this.recentEvents];
+        }
+        return this.recentEvents.filter((envelope) => envelope.timestamp > since);
+    }
+    /**
+     * Gets recent events filtered by submission ID.
+     *
+     * @param submissionId - The submission ID to filter by
+     * @returns Array of event envelopes for the submission
+     */
+    getEventsForSubmission(submissionId) {
+        return this.recentEvents.filter((envelope) => envelope.submissionId === submissionId);
+    }
+    /**
+     * Clears all listeners and recent events.
+     */
+    clear() {
+        this.globalListeners.clear();
+        this.typedListeners.clear();
+        this.recentEvents.length = 0;
+    }
+    /**
+     * Returns statistics about the queue for debugging.
+     */
+    stats() {
+        const typedListeners = {};
+        for (const [type, listeners] of this.typedListeners) {
+            typedListeners[type] = listeners.size;
+        }
+        return {
+            globalListeners: this.globalListeners.size,
+            typedListeners,
+            recentEventsCount: this.recentEvents.length,
+        };
+    }
+    /**
+     * Adds an envelope to the recent events buffer.
+     * Maintains circular buffer semantics.
+     */
+    addToRecentEvents(envelope) {
+        this.recentEvents.push(envelope);
+        // Trim to maxRecentEvents (circular buffer)
+        while (this.recentEvents.length > this.maxRecentEvents) {
+            this.recentEvents.shift();
+        }
+    }
+    /**
+     * Notifies all listeners of an event asynchronously.
+     * Ignores listener errors (fire-and-forget).
+     */
+    notifyListeners(envelope) {
+        // Notify global listeners
+        for (const listener of this.globalListeners) {
+            queueMicrotask(() => {
+                try {
+                    listener(envelope);
+                }
+                catch {
+                    // Ignore listener errors - fire and forget
+                }
+            });
+        }
+        // Notify typed listeners
+        const typedListeners = this.typedListeners.get(envelope.event.type);
+        if (typedListeners) {
+            for (const listener of typedListeners) {
+                queueMicrotask(() => {
+                    try {
+                        listener(envelope);
+                    }
+                    catch {
+                        // Ignore listener errors - fire and forget
+                    }
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=event-queue.js.map

package/dist/src/core/queues/event-queue.js.map

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

package/dist/src/core/queues/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Queue System Exports
+ *
+ * Provides the core queue infrastructure for UI/Agent communication:
+ * - AtomicCounter: Lock-free ID generation
+ * - SubmissionQueue: Bounded async queue with backpressure (UI -> Agent)
+ * - EventQueue: Unbounded pub/sub event emitter (Agent -> UI)
+ */
+export { AtomicCounter, globalCounter } from './atomic-counter.js';
+export { SubmissionQueue, QueueTimeoutError, QueueClosedError, type SubmissionQueueConfig, } from './submission-queue.js';
+export { EventQueue, EventTimeoutError, type EventListener, type TypedEventListener, type EventQueueConfig, type EventQueueStats, } from './event-queue.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/queues/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/queues/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGnE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/src/core/queues/index.js

@@ -0,0 +1,15 @@
+/**
+ * Queue System Exports
+ *
+ * Provides the core queue infrastructure for UI/Agent communication:
+ * - AtomicCounter: Lock-free ID generation
+ * - SubmissionQueue: Bounded async queue with backpressure (UI -> Agent)
+ * - EventQueue: Unbounded pub/sub event emitter (Agent -> UI)
+ */
+// Atomic counter
+export { AtomicCounter, globalCounter } from './atomic-counter.js';
+// Submission queue
+export { SubmissionQueue, QueueTimeoutError, QueueClosedError, } from './submission-queue.js';
+// Event queue
+export { EventQueue, EventTimeoutError, } from './event-queue.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/queues/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/queues/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEnE,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GAEjB,MAAM,uBAAuB,CAAC;AAE/B,cAAc;AACd,OAAO,EACL,UAAU,EACV,iBAAiB,GAKlB,MAAM,kBAAkB,CAAC"}

package/dist/src/core/queues/submission-queue.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Bounded async queue for operations from UI to Agent.
+ * Implements backpressure - when full, producers wait until space is available.
+ */
+import type { Operation, Submission, SubmissionId } from '../protocol/types.js';
+/**
+ * Configuration for the SubmissionQueue.
+ */
+export interface SubmissionQueueConfig {
+    /** Maximum number of items in the queue (default: 64) */
+    maxSize?: number;
+    /** Timeout in ms for producers waiting for space (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Error thrown when a queue operation times out.
+ */
+export declare class QueueTimeoutError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when attempting to operate on a closed queue.
+ */
+export declare class QueueClosedError extends Error {
+    constructor(message?: string);
+}
+/**
+ * A bounded async queue for operations from UI to Agent.
+ *
+ * Features:
+ * - Bounded capacity with backpressure (producers wait when full)
+ * - Async iterator support for consumption
+ * - Graceful shutdown via close()
+ * - Timeout handling for blocked producers
+ */
+export declare class SubmissionQueue {
+    private readonly maxSize;
+    private readonly timeout;
+    private readonly counter;
+    private readonly queue;
+    private readonly producerWaiters;
+    private readonly consumerWaiters;
+    private closed;
+    /**
+     * Creates a new SubmissionQueue.
+     * @param config - Optional configuration
+     */
+    constructor(config?: SubmissionQueueConfig);
+    /**
+     * Submits an operation to the queue.
+     * Blocks if the queue is full (backpressure).
+     *
+     * @param op - The operation to submit
+     * @param correlationId - Optional correlation ID for request/response tracking
+     * @returns The submission ID
+     * @throws QueueClosedError if the queue is closed
+     * @throws QueueTimeoutError if waiting for space times out
+     */
+    submit(op: Operation, correlationId?: string): Promise<SubmissionId>;
+    /**
+     * Takes the next submission from the queue.
+     * Blocks if the queue is empty.
+     *
+     * @returns The next submission, or null if the queue is closed and empty
+     */
+    take(): Promise<Submission | null>;
+    /**
+     * Non-blocking version of take().
+     * @returns The next submission, or null if the queue is empty
+     */
+    tryTake(): Submission | null;
+    /**
+     * Returns the current queue size.
+     */
+    size(): number;
+    /**
+     * Returns true if the queue is empty.
+     */
+    isEmpty(): boolean;
+    /**
+     * Returns true if the queue is full.
+     */
+    isFull(): boolean;
+    /**
+     * Returns true if the queue is closed.
+     */
+    isClosed(): boolean;
+    /**
+     * Closes the queue.
+     * - Rejects all pending producer waiters
+     * - Resolves all pending consumer waiters with null
+     * - No more submissions are accepted
+     */
+    close(): void;
+    /**
+     * Async iterator for consuming submissions.
+     * Yields submissions until the queue is closed and empty.
+     */
+    [Symbol.asyncIterator](): AsyncIterableIterator<Submission>;
+    /**
+     * Waits for space to become available in the queue.
+     * @throws QueueTimeoutError if waiting times out
+     * @throws QueueClosedError if queue is closed while waiting
+     */
+    private waitForSpace;
+    /**
+     * Wakes a waiting producer (called when space becomes available).
+     */
+    private wakeProducer;
+    /**
+     * Wakes a waiting consumer with a submission.
+     * If no consumers are waiting, the submission is already in the queue.
+     */
+    private wakeConsumer;
+}
+//# sourceMappingURL=submission-queue.d.ts.map

package/dist/src/core/queues/submission-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submission-queue.d.ts","sourceRoot":"","sources":["../../../../src/core/queues/submission-queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGhF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,GAAE,MAAoC;CAI1D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,GAAE,MAA0B;CAIhD;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;IACnE,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;gBACS,MAAM,CAAC,EAAE,qBAAqB;IAM1C;;;;;;;;;OASG;IACG,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA+B1E;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAmBxC;;;OAGG;IACH,OAAO,IAAI,UAAU,GAAG,IAAI;IAU5B;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAqBb;;;OAGG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,UAAU,CAAC;IAUlE;;;;OAIG;IACH,OAAO,CAAC,YAAY;IA+BpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAarB"}