agent-world 0.13.0 → 0.15.0

package/dist/core/queue-manager.d.ts

@@ -0,0 +1,84 @@
+import type { World, QueuedMessage, StorageAPI, WorldMessageEvent } from './types.js';
+export declare const pausedQueues: Set<string>;
+type QueueStorageOperations = Required<Pick<StorageAPI, 'getQueuedMessages' | 'addQueuedMessage' | 'updateMessageQueueStatus' | 'incrementQueueMessageRetry' | 'removeQueuedMessage'>>;
+export declare function getQueueStorageOrThrow(caller: string): QueueStorageOperations;
+/**
+ * Core queue processing trigger. Finds the next 'queued' message for the chat,
+ * marks it 'sending', and publishes it. Registers a world-activity listener to
+ * chain to the next message after response completion.
+ *
+ * Guards: pause flag, active-processing check, per-chat dedup.
+ */
+export declare function triggerPendingQueueResume(world: World, chatId: string, options?: {
+    recoverStaleSending?: boolean;
+}): void;
+/**
+ * Synchronously add the old chat's queue to the paused set on chat switch.
+ * Called by managers.ts restoreChat.
+ */
+export declare function autoPauseQueueForChat(worldId: string, chatId: string): void;
+/**
+ * Clear the pause flag for a chat (used when activating/restoring a chat).
+ */
+export declare function clearQueuePauseForChat(worldId: string, chatId: string): void;
+/**
+ * Add a message to the queue for a chat. Returns the created QueuedMessage or null.
+ */
+export declare function addToQueue(worldId: string, chatId: string, content: string, sender: string, options?: {
+    triggerProcessing?: boolean;
+    targetWorld?: World | null;
+    source?: 'direct' | 'queue' | 'retry';
+    preassignedMessageId?: string;
+}): Promise<QueuedMessage | null>;
+/**
+ * Runtime-start recovery hook.
+ * Resets interrupted `sending` queue rows back to `queued`.
+ */
+export declare function recoverQueueSendingMessages(): Promise<number>;
+/**
+ * Immediate dispatch helper for non-user chat messages.
+ */
+export declare function dispatchImmediateChatMessage(worldId: string, chatId: string, content: string, sender: string, targetWorld?: World | null, options?: {
+    source?: 'direct' | 'queue' | 'retry';
+    preassignedMessageId?: string;
+}): Promise<WorldMessageEvent>;
+/**
+ * External user-send ingress helper.
+ * Queue-backed submission is restricted to user-authored turns only.
+ */
+export declare function enqueueAndProcessUserTurn(worldId: string, chatId: string, content: string, sender: string, targetWorld?: World | null, options?: {
+    source?: 'direct' | 'queue' | 'retry';
+    preassignedMessageId?: string;
+}): Promise<QueuedMessage | null>;
+/**
+ * Return all queue messages (queued, sending, error) for a chat.
+ */
+export declare function getQueueMessages(worldId: string, chatId: string): Promise<QueuedMessage[]>;
+/**
+ * Remove a specific message from the queue by messageId.
+ */
+export declare function removeFromQueue(worldId: string, messageId: string): Promise<void>;
+/**
+ * Pause queue processing for a chat. Current in-flight message completes normally.
+ */
+export declare function pauseChatQueue(worldId: string, chatId: string): Promise<void>;
+/**
+ * Resume queue processing for a chat. Clears the pause flag and triggers the next item.
+ */
+export declare function resumeChatQueue(worldId: string, chatId: string): Promise<void>;
+/**
+ * Stop queue processing: cancel remaining queued messages and set pause flag.
+ * The current in-flight message completes normally.
+ */
+export declare function stopChatQueue(worldId: string, chatId: string): Promise<void>;
+/**
+ * Clear the entire queue for a chat (removes all queue rows including cancelled/error).
+ */
+export declare function clearChatQueue(worldId: string, chatId: string): Promise<void>;
+/**
+ * Reset a failed queue message (status='error') back to 'queued' with retry_count=0,
+ * then trigger queue processing. Allows the user to manually retry after automatic
+ * retries have been exhausted.
+ */
+export declare function retryQueueMessage(worldId: string, messageId: string, chatId: string): Promise<void>;
+export {};

package/dist/core/queue-manager.d.ts.map

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