@agentuity/server 0.1.16 → 0.1.18

package/dist/api/queue/dlq.js

@@ -0,0 +1,204 @@
+import { z } from 'zod';
+import { APIResponseSchema, APIResponseSchemaNoData } from '../api';
+import { DeadLetterMessageSchema, MessageSchema, } from './types';
+import { QueueError, QueueNotFoundError, MessageNotFoundError, queueApiPath, queueApiPathWithQuery, buildQueueHeaders, } from './util';
+import { validateQueueName, validateMessageId, validateLimit, validateOffset } from './validation';
+const DlqListResponseSchema = APIResponseSchema(z.object({
+    messages: z.array(DeadLetterMessageSchema),
+    total: z.number().optional(),
+}));
+const ReplayDlqResponseSchema = APIResponseSchema(z.object({ message: MessageSchema }));
+const DeleteDlqResponseSchema = APIResponseSchemaNoData();
+/**
+ * List messages in the dead letter queue.
+ *
+ * Retrieves messages that failed processing after exhausting all retries.
+ * These messages can be inspected, replayed back to the main queue, or deleted.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue whose DLQ to list
+ * @param params - Optional pagination parameters (limit, offset)
+ * @returns Object containing dead letter messages and optional total count
+ * @throws {QueueValidationError} If validation fails (invalid queue name, limit, or offset)
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // List first 10 dead letter messages
+ * const result = await listDeadLetterMessages(client, 'order-queue', { limit: 10 });
+ * for (const msg of result.messages) {
+ *   console.log(`Failed message ${msg.id}: ${msg.failure_reason}`);
+ *   console.log(`Attempts: ${msg.delivery_attempts}, Moved at: ${msg.moved_at}`);
+ * }
+ * ```
+ */
+export async function listDeadLetterMessages(client, queueName, params, options) {
+    validateQueueName(queueName);
+    if (params?.limit !== undefined) {
+        validateLimit(params.limit);
+    }
+    if (params?.offset !== undefined) {
+        validateOffset(params.offset);
+    }
+    const searchParams = new URLSearchParams();
+    if (params?.limit !== undefined) {
+        searchParams.set('limit', String(params.limit));
+    }
+    if (params?.offset !== undefined) {
+        searchParams.set('offset', String(params.offset));
+    }
+    const queryString = searchParams.toString();
+    const url = queueApiPathWithQuery('dlq/list', queryString || undefined, queueName);
+    const resp = await client.get(url, DlqListResponseSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return { messages: resp.data.messages, total: resp.data.total };
+    }
+    if (resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to list dead letter messages',
+    });
+}
+/**
+ * Replay a dead letter message back to the main queue.
+ *
+ * Moves a message from the dead letter queue back to the main queue for
+ * reprocessing. The message state is reset to pending and retry count is
+ * preserved. Use this after fixing the underlying issue that caused the failure.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param messageId - The message ID to replay (prefixed with msg_)
+ * @returns The replayed message with updated state
+ * @throws {QueueValidationError} If validation fails (invalid queue name or message ID)
+ * @throws {MessageNotFoundError} If the message does not exist in the DLQ
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Replay a failed message after fixing the bug
+ * const message = await replayDeadLetterMessage(client, 'order-queue', 'msg_abc123');
+ * console.log(`Replayed message ${message.id}, now in state: ${message.state}`);
+ * ```
+ */
+export async function replayDeadLetterMessage(client, queueName, messageId, options) {
+    validateQueueName(queueName);
+    validateMessageId(messageId);
+    const url = queueApiPath('dlq/replay', queueName, messageId);
+    const resp = await client.post(url, undefined, ReplayDlqResponseSchema, undefined, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return resp.data.message;
+    }
+    if (resp.message?.includes('message') && resp.message?.includes('not found')) {
+        throw new MessageNotFoundError({
+            queueName,
+            messageId,
+            message: resp.message,
+        });
+    }
+    if (resp.message?.includes('queue') && resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to replay dead letter message',
+    });
+}
+/**
+ * Purge all messages from a dead letter queue.
+ *
+ * Permanently deletes all messages in the dead letter queue. This operation
+ * cannot be undone. Use with caution - consider reviewing or exporting
+ * messages before purging.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue whose DLQ to purge
+ * @returns void
+ * @throws {QueueValidationError} If validation fails (invalid queue name)
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Purge all dead letter messages after investigation
+ * await purgeDeadLetter(client, 'order-queue');
+ * console.log('All dead letter messages have been deleted');
+ * ```
+ */
+export async function purgeDeadLetter(client, queueName, options) {
+    validateQueueName(queueName);
+    const url = queueApiPath('dlq/purge', queueName);
+    const resp = await client.delete(url, DeleteDlqResponseSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return;
+    }
+    if (resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to purge dead letter queue',
+    });
+}
+/**
+ * Delete a specific message from the dead letter queue.
+ *
+ * Permanently removes a single message from the dead letter queue.
+ * Use this when you've determined that a specific failed message
+ * should not be retried and can be discarded.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param messageId - The message ID to delete (prefixed with msg_)
+ * @returns void
+ * @throws {QueueValidationError} If validation fails (invalid queue name or message ID)
+ * @throws {MessageNotFoundError} If the message does not exist in the DLQ
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Delete a message that cannot be recovered
+ * await deleteDeadLetterMessage(client, 'order-queue', 'msg_abc123');
+ * console.log('Dead letter message deleted');
+ * ```
+ */
+export async function deleteDeadLetterMessage(client, queueName, messageId, options) {
+    validateQueueName(queueName);
+    validateMessageId(messageId);
+    const url = queueApiPath('dlq/delete', queueName, messageId);
+    const resp = await client.delete(url, DeleteDlqResponseSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return;
+    }
+    if (resp.message?.includes('queue') && resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName,
+            message: resp.message,
+        });
+    }
+    if (resp.message?.includes('message') && resp.message?.includes('not found')) {
+        throw new MessageNotFoundError({
+            queueName,
+            messageId,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to delete dead letter message',
+    });
+}
+//# sourceMappingURL=dlq.js.map

package/dist/api/queue/dlq.js.map

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

package/dist/api/queue/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @module queue
+ *
+ * Queue API client for managing message queues, messages, destinations, and dead letter queues.
+ *
+ * This module provides a complete client for the Agentuity Queue API, supporting:
+ * - **Queue Management**: Create, read, update, and delete message queues
+ * - **Message Operations**: Publish, consume, acknowledge, and manage messages
+ * - **Destinations**: Configure webhook endpoints for automatic message delivery
+ * - **Dead Letter Queue**: Handle failed messages that exceeded retry limits
+ *
+ * @example Basic Queue Operations
+ * ```typescript
+ * import { createQueue, publishMessage, receiveMessage, ackMessage } from '@agentuity/server';
+ *
+ * // Create a worker queue
+ * const queue = await createQueue(client, {
+ *   name: 'order-processing',
+ *   queue_type: 'worker',
+ * });
+ *
+ * // Publish a message
+ * await publishMessage(client, 'order-processing', {
+ *   payload: { orderId: 123 },
+ * });
+ *
+ * // Receive and acknowledge a message
+ * const message = await receiveMessage(client, 'order-processing');
+ * if (message) {
+ *   // Process the message...
+ *   await ackMessage(client, 'order-processing', message.id);
+ * }
+ * ```
+ *
+ * @example Webhook Destinations
+ * ```typescript
+ * import { createDestination } from '@agentuity/server';
+ *
+ * // Messages are automatically delivered to this URL
+ * await createDestination(client, 'order-processing', {
+ *   destination_type: 'http',
+ *   config: { url: 'https://api.example.com/webhook' },
+ * });
+ * ```
+ */
+export { QueueTypeSchema, QueueSettingsSchema, QueueStatsSchema, QueueSchema, MessageStateSchema, MessageSchema, DestinationTypeSchema, HttpDestinationConfigSchema, DestinationStatsSchema, DestinationSchema, DeadLetterMessageSchema, CreateQueueRequestSchema, UpdateQueueRequestSchema, ListQueuesRequestSchema, PublishMessageRequestSchema, BatchPublishMessagesRequestSchema, ListMessagesRequestSchema, ConsumeMessagesRequestSchema, CreateDestinationRequestSchema, UpdateDestinationRequestSchema, ListDlqRequestSchema, type QueueType, type QueueSettings, type QueueStats, type Queue, type MessageState, type Message, type DestinationType, type HttpDestinationConfig, type DestinationStats, type Destination, type DeadLetterMessage, type CreateQueueRequest, type UpdateQueueRequest, type ListQueuesRequest, type PublishMessageRequest, type BatchPublishMessagesRequest, type ListMessagesRequest, type ConsumeMessagesRequest, type CreateDestinationRequest, type UpdateDestinationRequest, type ListDlqRequest, type QueueApiOptions, AnalyticsGranularitySchema, TimePeriodSchema, LatencyStatsSchema, QueueCurrentStatsSchema, QueuePeriodStatsSchema, DestinationAnalyticsSchema, QueueAnalyticsSchema, QueueSummarySchema, OrgAnalyticsSummarySchema, OrgAnalyticsSchema, TimeSeriesPointSchema, TimeSeriesDataSchema, SSEStatsEventSchema, type AnalyticsGranularity, type AnalyticsOptions, type StreamAnalyticsOptions, type TimePeriod, type LatencyStats, type QueueCurrentStats, type QueuePeriodStats, type DestinationAnalytics, type QueueAnalytics, type QueueSummary, type OrgAnalyticsSummary, type OrgAnalytics, type TimeSeriesPoint, type TimeSeriesData, type SSEStatsEvent, SourceAuthTypeSchema, SourceSchema, CreateSourceRequestSchema, UpdateSourceRequestSchema, type SourceAuthType, type Source, type CreateSourceRequest, type UpdateSourceRequest, } from './types';
+export { QueueError, QueueNotFoundError, MessageNotFoundError, DestinationNotFoundError, DestinationAlreadyExistsError, QueueInvalidArgumentError, SourceNotFoundError, SourceAlreadyExistsError, } from './util';
+export { createQueue, getQueue, listQueues, updateQueue, deleteQueue, pauseQueue, resumeQueue, } from './queues';
+export { publishMessage, batchPublishMessages, getMessage, getMessageByOffset, listMessages, deleteMessage, replayMessage, consumeMessages, getQueueHead, getQueueTail, receiveMessage, ackMessage, nackMessage, } from './messages';
+export { listDeadLetterMessages, replayDeadLetterMessage, purgeDeadLetter, deleteDeadLetterMessage, } from './dlq';
+export { createDestination, listDestinations, updateDestination, deleteDestination, } from './destinations';
+export { createSource, listSources, getSource, updateSource, deleteSource } from './sources';
+export { getOrgAnalytics, getQueueAnalytics, getQueueTimeSeries, streamOrgAnalytics, streamQueueAnalytics, } from './analytics';
+export { QueueValidationError, validateQueueName, validateQueueType, validatePayload, validateMessageId, validateDestinationId, validateDescription, validatePartitionKey, validateIdempotencyKey, validateTTL, validateVisibilityTimeout, validateMaxRetries, validateMaxInFlight, validateOffset, validateLimit, validateBatchSize, validateWebhookUrl, validateDestinationConfig, validateSourceId, validateSourceName, MAX_QUEUE_NAME_LENGTH, MIN_QUEUE_NAME_LENGTH, MAX_PAYLOAD_SIZE, MAX_DESCRIPTION_LENGTH, MAX_BATCH_SIZE, MAX_METADATA_SIZE, MAX_PARTITION_KEY_LENGTH, MAX_IDEMPOTENCY_KEY_LENGTH, MAX_VISIBILITY_TIMEOUT, MAX_RETRIES, MAX_IN_FLIGHT, MAX_SOURCE_NAME_LENGTH, } from './validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/queue/index.d.ts.map

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

package/dist/api/queue/index.js

@@ -0,0 +1,86 @@
+/**
+ * @module queue
+ *
+ * Queue API client for managing message queues, messages, destinations, and dead letter queues.
+ *
+ * This module provides a complete client for the Agentuity Queue API, supporting:
+ * - **Queue Management**: Create, read, update, and delete message queues
+ * - **Message Operations**: Publish, consume, acknowledge, and manage messages
+ * - **Destinations**: Configure webhook endpoints for automatic message delivery
+ * - **Dead Letter Queue**: Handle failed messages that exceeded retry limits
+ *
+ * @example Basic Queue Operations
+ * ```typescript
+ * import { createQueue, publishMessage, receiveMessage, ackMessage } from '@agentuity/server';
+ *
+ * // Create a worker queue
+ * const queue = await createQueue(client, {
+ *   name: 'order-processing',
+ *   queue_type: 'worker',
+ * });
+ *
+ * // Publish a message
+ * await publishMessage(client, 'order-processing', {
+ *   payload: { orderId: 123 },
+ * });
+ *
+ * // Receive and acknowledge a message
+ * const message = await receiveMessage(client, 'order-processing');
+ * if (message) {
+ *   // Process the message...
+ *   await ackMessage(client, 'order-processing', message.id);
+ * }
+ * ```
+ *
+ * @example Webhook Destinations
+ * ```typescript
+ * import { createDestination } from '@agentuity/server';
+ *
+ * // Messages are automatically delivered to this URL
+ * await createDestination(client, 'order-processing', {
+ *   destination_type: 'http',
+ *   config: { url: 'https://api.example.com/webhook' },
+ * });
+ * ```
+ */
+// ============================================================================
+// Types & Schemas
+// ============================================================================
+export { QueueTypeSchema, QueueSettingsSchema, QueueStatsSchema, QueueSchema, MessageStateSchema, MessageSchema, DestinationTypeSchema, HttpDestinationConfigSchema, DestinationStatsSchema, DestinationSchema, DeadLetterMessageSchema, CreateQueueRequestSchema, UpdateQueueRequestSchema, ListQueuesRequestSchema, PublishMessageRequestSchema, BatchPublishMessagesRequestSchema, ListMessagesRequestSchema, ConsumeMessagesRequestSchema, CreateDestinationRequestSchema, UpdateDestinationRequestSchema, ListDlqRequestSchema, 
+// Analytics types
+AnalyticsGranularitySchema, TimePeriodSchema, LatencyStatsSchema, QueueCurrentStatsSchema, QueuePeriodStatsSchema, DestinationAnalyticsSchema, QueueAnalyticsSchema, QueueSummarySchema, OrgAnalyticsSummarySchema, OrgAnalyticsSchema, TimeSeriesPointSchema, TimeSeriesDataSchema, SSEStatsEventSchema, 
+// Source types
+SourceAuthTypeSchema, SourceSchema, CreateSourceRequestSchema, UpdateSourceRequestSchema, } from './types';
+// ============================================================================
+// Errors
+// ============================================================================
+export { QueueError, QueueNotFoundError, MessageNotFoundError, DestinationNotFoundError, DestinationAlreadyExistsError, QueueInvalidArgumentError, SourceNotFoundError, SourceAlreadyExistsError, } from './util';
+// ============================================================================
+// Queue Operations
+// ============================================================================
+export { createQueue, getQueue, listQueues, updateQueue, deleteQueue, pauseQueue, resumeQueue, } from './queues';
+// ============================================================================
+// Message Operations
+// ============================================================================
+export { publishMessage, batchPublishMessages, getMessage, getMessageByOffset, listMessages, deleteMessage, replayMessage, consumeMessages, getQueueHead, getQueueTail, receiveMessage, ackMessage, nackMessage, } from './messages';
+// ============================================================================
+// Dead Letter Queue Operations
+// ============================================================================
+export { listDeadLetterMessages, replayDeadLetterMessage, purgeDeadLetter, deleteDeadLetterMessage, } from './dlq';
+// ============================================================================
+// Destination Operations
+// ============================================================================
+export { createDestination, listDestinations, updateDestination, deleteDestination, } from './destinations';
+// ============================================================================
+// Source Operations
+// ============================================================================
+export { createSource, listSources, getSource, updateSource, deleteSource } from './sources';
+// ============================================================================
+// Analytics Operations
+// ============================================================================
+export { getOrgAnalytics, getQueueAnalytics, getQueueTimeSeries, streamOrgAnalytics, streamQueueAnalytics, } from './analytics';
+// ============================================================================
+// Validation Utilities
+// ============================================================================
+export { QueueValidationError, validateQueueName, validateQueueType, validatePayload, validateMessageId, validateDestinationId, validateDescription, validatePartitionKey, validateIdempotencyKey, validateTTL, validateVisibilityTimeout, validateMaxRetries, validateMaxInFlight, validateOffset, validateLimit, validateBatchSize, validateWebhookUrl, validateDestinationConfig, validateSourceId, validateSourceName, MAX_QUEUE_NAME_LENGTH, MIN_QUEUE_NAME_LENGTH, MAX_PAYLOAD_SIZE, MAX_DESCRIPTION_LENGTH, MAX_BATCH_SIZE, MAX_METADATA_SIZE, MAX_PARTITION_KEY_LENGTH, MAX_IDEMPOTENCY_KEY_LENGTH, MAX_VISIBILITY_TIMEOUT, MAX_RETRIES, MAX_IN_FLIGHT, MAX_SOURCE_NAME_LENGTH, } from './validation';
+//# sourceMappingURL=index.js.map

package/dist/api/queue/index.js.map

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