@agentuity/queue 3.0.11 → 3.1.0

package/dist/service.js

@@ -0,0 +1,501 @@
+/**
+ * @module queue
+ *
+ * Queue service for publishing messages to Agentuity queues.
+ *
+ * Used internally by `@agentuity/queue`'s `QueueClient`. App code should
+ * use `QueueClient` directly rather than reaching for these primitives.
+ *
+ * @example
+ * ```typescript
+ * import { QueueClient } from '@agentuity/queue';
+ *
+ * const queue = new QueueClient();
+ * const result = await queue.publish('order-queue', {
+ *   orderId: 123,
+ *   action: 'process',
+ * });
+ * console.log(`Published message ${result.id}`);
+ * ```
+ */
+import { buildUrl, toPayload, toServiceException } from '@agentuity/adapter';
+import { StructuredError } from '@agentuity/adapter';
+import { z } from 'zod';
+/**
+ * Parameters for publishing a message to a queue.
+ *
+ * @example
+ * ```typescript
+ * const params: QueuePublishParams = {
+ *   metadata: { priority: 'high' },
+ *   partitionKey: 'customer-123',
+ *   idempotencyKey: 'order-456-v1',
+ *   ttl: 3600, // 1 hour
+ * };
+ * ```
+ */
+export const QueuePublishParamsSchema = z.object({
+    /**
+     * Optional metadata to attach to the message.
+     * Can contain any JSON-serializable data for message routing or filtering.
+     */
+    metadata: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe('Optional metadata to attach to the message.'),
+    /**
+     * Optional partition key for message ordering.
+     * Messages with the same partition key are guaranteed to be processed in order.
+     */
+    partitionKey: z.string().optional().describe('Optional partition key for message ordering.'),
+    /**
+     * Optional idempotency key for deduplication.
+     * If a message with the same key was recently published, it will be deduplicated.
+     */
+    idempotencyKey: z.string().optional().describe('Optional idempotency key for deduplication.'),
+    /**
+     * Optional time-to-live in seconds.
+     * Messages will expire and be removed after this duration.
+     */
+    ttl: z.number().optional().describe('Optional time-to-live in seconds.'),
+    /**
+     * Optional project ID for cross-project publishing.
+     * If not specified, uses the current project context.
+     */
+    projectId: z.string().optional().describe('Optional project ID for cross-project publishing.'),
+    /**
+     * Optional agent ID for attribution.
+     * If not specified, uses the current agent context.
+     */
+    agentId: z.string().optional().describe('Optional agent ID for attribution.'),
+    /**
+     * Whether to publish synchronously.
+     * When true, the API waits for the message to be fully persisted before returning.
+     * When false (default), the API returns immediately with a pending message.
+     */
+    sync: z.boolean().optional().describe('Whether to publish synchronously.'),
+});
+/**
+ * Result of publishing a message to a queue.
+ *
+ * @example
+ * ```typescript
+ * const result = await queue.publish('my-queue', payload);
+ * console.log(`Message ${result.id} published at offset ${result.offset}`);
+ * ```
+ */
+export const QueuePublishResultSchema = z.object({
+    /**
+     * The unique message ID (prefixed with msg_).
+     * Use this ID to track, acknowledge, or delete the message.
+     */
+    id: z.string().describe('The unique message ID (prefixed with msg_).'),
+    /**
+     * The sequential offset of the message in the queue.
+     * Offsets are monotonically increasing and can be used for log-style consumption.
+     */
+    offset: z.number().describe('The sequential offset of the message in the queue.'),
+    /**
+     * ISO 8601 timestamp when the message was published.
+     */
+    publishedAt: z.string().describe('ISO 8601 timestamp when the message was published.'),
+});
+/**
+ * Parameters for creating a queue.
+ *
+ * @example
+ * ```typescript
+ * const result = await queue.createQueue('my-queue', {
+ *   queueType: 'pubsub',
+ *   settings: { defaultTtlSeconds: 86400 },
+ * });
+ * ```
+ */
+export const QueueCreateParamsSchema = z.object({
+    /**
+     * Type of queue to create.
+     * - `worker`: Messages are consumed by exactly one consumer with acknowledgment.
+     * - `pubsub`: Messages are broadcast to all subscribers.
+     * @default 'worker'
+     */
+    queueType: z.enum(['worker', 'pubsub']).optional().describe('Type of queue to create.'),
+    /**
+     * Optional description of the queue's purpose.
+     */
+    description: z.string().optional().describe("Optional description of the queue's purpose."),
+    /**
+     * Optional settings to customize queue behavior.
+     * Only provided fields are applied; others use server defaults.
+     */
+    settings: z
+        .object({
+        /** Default time-to-live for messages in seconds. Null means no expiration. */
+        defaultTtlSeconds: z
+            .number()
+            .nullable()
+            .optional()
+            .describe('Default time-to-live for messages in seconds. Null means no expiration.'),
+        /** Time in seconds a message is invisible after being received. */
+        defaultVisibilityTimeoutSeconds: z
+            .number()
+            .optional()
+            .describe('Time in seconds a message is invisible after being received.'),
+        /** Maximum number of delivery attempts before moving to DLQ. */
+        defaultMaxRetries: z
+            .number()
+            .optional()
+            .describe('Maximum number of delivery attempts before moving to DLQ.'),
+        /** Maximum number of messages a single client can process concurrently. */
+        maxInFlightPerClient: z
+            .number()
+            .optional()
+            .describe('Maximum number of messages a single client can process concurrently.'),
+        /** Retention period for acknowledged messages in seconds. */
+        retentionSeconds: z
+            .number()
+            .optional()
+            .describe('Retention period for acknowledged messages in seconds.'),
+    })
+        .optional()
+        .describe('Optional settings to customize queue behavior.'),
+});
+/**
+ * Result of creating a queue.
+ */
+export const QueueCreateResultSchema = z.object({
+    /** The queue name. */
+    name: z.string().describe('The queue name.'),
+    /** The queue type ('worker' or 'pubsub'). */
+    queueType: z.string().describe("The queue type ('worker' or 'pubsub')."),
+});
+// ============================================================================
+// Errors
+// ============================================================================
+/**
+ * Error thrown when a publish operation fails.
+ *
+ * This is a general error for publish failures that aren't specifically
+ * validation or not-found errors.
+ */
+export const QueuePublishError = StructuredError('QueuePublishError');
+/**
+ * Error thrown when a queue creation operation fails.
+ *
+ * This is a general error for create failures that aren't specifically
+ * validation, not-found, or conflict (409) errors.
+ */
+export const QueueCreateError = StructuredError('QueueCreateError');
+/**
+ * Error thrown when a queue is not found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await queue.publish('non-existent', 'payload');
+ * } catch (error) {
+ *   if (error instanceof QueueNotFoundError) {
+ *     console.error('Queue does not exist');
+ *   }
+ * }
+ * ```
+ */
+export const QueueNotFoundError = StructuredError('QueueNotFoundError');
+/**
+ * Error thrown when validation fails.
+ *
+ * Contains the field name and optionally the invalid value for debugging.
+ */
+export const QueueValidationError = StructuredError('QueueValidationError')();
+// ============================================================================
+// Internal Validation
+// ============================================================================
+const MAX_QUEUE_NAME_LENGTH = 256;
+const MAX_PAYLOAD_SIZE = 1048576;
+const MAX_PARTITION_KEY_LENGTH = 256;
+const MAX_IDEMPOTENCY_KEY_LENGTH = 256;
+const VALID_QUEUE_NAME_REGEX = /^[a-z_][a-z0-9_-]*$/;
+/** @internal */
+function validateQueueNameInternal(name) {
+    if (!name || name.length === 0) {
+        throw new QueueValidationError({
+            message: 'Queue name cannot be empty',
+            field: 'queueName',
+            value: name,
+        });
+    }
+    if (name.length > MAX_QUEUE_NAME_LENGTH) {
+        throw new QueueValidationError({
+            message: `Queue name must not exceed ${MAX_QUEUE_NAME_LENGTH} characters`,
+            field: 'queueName',
+            value: name,
+        });
+    }
+    if (!VALID_QUEUE_NAME_REGEX.test(name)) {
+        throw new QueueValidationError({
+            message: 'Queue name must start with a letter or underscore and contain only lowercase letters, digits, underscores, and hyphens',
+            field: 'queueName',
+            value: name,
+        });
+    }
+}
+/** @internal */
+function validatePayloadInternal(payload) {
+    if (!payload || payload.length === 0) {
+        throw new QueueValidationError({
+            message: 'Payload cannot be empty',
+            field: 'payload',
+        });
+    }
+    if (payload.length > MAX_PAYLOAD_SIZE) {
+        throw new QueueValidationError({
+            message: `Payload size exceeds ${MAX_PAYLOAD_SIZE} byte limit (${payload.length} bytes)`,
+            field: 'payload',
+            value: payload.length,
+        });
+    }
+}
+/**
+ * Unwraps the standard API response envelope.
+ *
+ * The queue server returns responses wrapped in:
+ *   { success: true, data: { [key]: { ...actual data... } } }
+ *
+ * Since `fromResponse()` parses the raw JSON body, `res.data` from the
+ * adapter is the full envelope. This helper extracts the nested data by key.
+ *
+ * Falls back to treating the input as already-unwrapped data (e.g., in tests
+ * using mock adapters that provide flat data directly).
+ *
+ * @internal
+ */
+function unwrapApiResponse(data, key) {
+    if (data !== null && typeof data === 'object') {
+        const body = data;
+        if (body.success === true && typeof body.data === 'object' && body.data !== null) {
+            const envelope = body.data;
+            if (key in envelope) {
+                return envelope[key];
+            }
+        }
+    }
+    return data;
+}
+// ============================================================================
+// QueueStorageService Implementation
+// ============================================================================
+/**
+ * HTTP-based implementation of the {@link QueueService} interface.
+ *
+ * This service communicates with the Agentuity Queue API to publish
+ * messages. App code should use `QueueClient` from `@agentuity/queue`
+ * rather than instantiating this class directly.
+ */
+export class QueueStorageService {
+    #adapter;
+    #baseUrl;
+    #knownQueues = new Set();
+    /**
+     * Creates a new QueueStorageService.
+     *
+     * @param baseUrl - The base URL of the Queue API
+     * @param adapter - The fetch adapter for making HTTP requests
+     */
+    constructor(baseUrl, adapter) {
+        this.#adapter = adapter;
+        this.#baseUrl = baseUrl;
+    }
+    /**
+     * @inheritdoc
+     */
+    async publish(queueName, payload, params) {
+        // Validate inputs before sending to API
+        validateQueueNameInternal(queueName);
+        const [body] = await toPayload(payload);
+        const payloadStr = typeof payload === 'string' ? payload : body;
+        validatePayloadInternal(payloadStr);
+        // Validate optional params
+        if (params?.partitionKey && params.partitionKey.length > MAX_PARTITION_KEY_LENGTH) {
+            throw new QueueValidationError({
+                message: `Partition key must not exceed ${MAX_PARTITION_KEY_LENGTH} characters`,
+                field: 'partitionKey',
+                value: params.partitionKey.length,
+            });
+        }
+        if (params?.idempotencyKey && params.idempotencyKey.length > MAX_IDEMPOTENCY_KEY_LENGTH) {
+            throw new QueueValidationError({
+                message: `Idempotency key must not exceed ${MAX_IDEMPOTENCY_KEY_LENGTH} characters`,
+                field: 'idempotencyKey',
+                value: params.idempotencyKey.length,
+            });
+        }
+        if (params?.ttl !== undefined && params.ttl < 0) {
+            throw new QueueValidationError({
+                message: 'TTL cannot be negative',
+                field: 'ttl',
+                value: params.ttl,
+            });
+        }
+        const basePath = `/queue/messages/publish/${encodeURIComponent(queueName)}`;
+        const url = buildUrl(this.#baseUrl, params?.sync ? `${basePath}?sync=true` : basePath);
+        const requestBody = {
+            payload: typeof payload === 'string' ? payload : body,
+        };
+        if (params?.metadata) {
+            requestBody.metadata = params.metadata;
+        }
+        if (params?.partitionKey) {
+            requestBody.partition_key = params.partitionKey;
+        }
+        if (params?.idempotencyKey) {
+            requestBody.idempotency_key = params.idempotencyKey;
+        }
+        if (params?.ttl !== undefined) {
+            requestBody.ttl_seconds = params.ttl;
+        }
+        if (params?.projectId) {
+            requestBody.project_id = params.projectId;
+        }
+        if (params?.agentId) {
+            requestBody.agent_id = params.agentId;
+        }
+        const signal = AbortSignal.timeout(30_000);
+        const res = await this.#adapter.invoke(url, {
+            method: 'POST',
+            signal,
+            body: JSON.stringify(requestBody),
+            contentType: 'application/json',
+            telemetry: {
+                name: 'agentuity.queue.publish',
+                attributes: {
+                    queueName,
+                },
+            },
+        });
+        if (res.ok) {
+            const data = unwrapApiResponse(res.data, 'message');
+            const result = QueuePublishResultSchema.safeParse({
+                id: data.id,
+                offset: data.offset,
+                publishedAt: data.published_at,
+            });
+            if (result.success) {
+                return result.data;
+            }
+            throw new QueuePublishError({
+                message: `Queue publish returned an unexpected response format: ${result.error.message}`,
+            });
+        }
+        if (res.response.status === 404) {
+            throw new QueueNotFoundError({
+                message: `Queue not found: ${queueName}`,
+            });
+        }
+        throw await toServiceException('POST', url, res.response);
+    }
+    /**
+     * @inheritdoc
+     */
+    async createQueue(queueName, params) {
+        validateQueueNameInternal(queueName);
+        if (this.#knownQueues.has(queueName)) {
+            return {
+                name: queueName,
+                queueType: params?.queueType ?? 'worker',
+            };
+        }
+        const url = buildUrl(this.#baseUrl, '/queue/create');
+        const requestBody = {
+            name: queueName,
+            queue_type: params?.queueType ?? 'worker',
+        };
+        if (params?.description !== undefined) {
+            requestBody.description = params.description;
+        }
+        if (params?.settings) {
+            const settings = {};
+            if (params.settings.defaultTtlSeconds !== undefined) {
+                settings.default_ttl_seconds = params.settings.defaultTtlSeconds;
+            }
+            if (params.settings.defaultVisibilityTimeoutSeconds !== undefined) {
+                settings.default_visibility_timeout_seconds =
+                    params.settings.defaultVisibilityTimeoutSeconds;
+            }
+            if (params.settings.defaultMaxRetries !== undefined) {
+                settings.default_max_retries = params.settings.defaultMaxRetries;
+            }
+            if (params.settings.maxInFlightPerClient !== undefined) {
+                settings.max_in_flight_per_client = params.settings.maxInFlightPerClient;
+            }
+            if (params.settings.retentionSeconds !== undefined) {
+                settings.retention_seconds = params.settings.retentionSeconds;
+            }
+            if (Object.keys(settings).length > 0) {
+                requestBody.settings = settings;
+            }
+        }
+        const signal = AbortSignal.timeout(30_000);
+        const res = await this.#adapter.invoke(url, {
+            method: 'POST',
+            signal,
+            body: JSON.stringify(requestBody),
+            contentType: 'application/json',
+            telemetry: {
+                name: 'agentuity.queue.create',
+                attributes: {
+                    queueName,
+                },
+            },
+        });
+        if (res.ok) {
+            const data = unwrapApiResponse(res.data, 'queue');
+            const result = QueueCreateResultSchema.safeParse({
+                name: data.name,
+                queueType: data.queue_type,
+            });
+            if (result.success) {
+                this.#knownQueues.add(queueName);
+                return result.data;
+            }
+            throw new QueueCreateError({
+                message: `Queue create returned an unexpected response format: ${result.error.message}`,
+            });
+        }
+        if (res.response.status === 409) {
+            this.#knownQueues.add(queueName);
+            return {
+                name: queueName,
+                queueType: params?.queueType ?? 'worker',
+            };
+        }
+        throw await toServiceException('POST', url, res.response);
+    }
+    /**
+     * @inheritdoc
+     */
+    async deleteQueue(queueName) {
+        validateQueueNameInternal(queueName);
+        const url = buildUrl(this.#baseUrl, `/queue/delete/${encodeURIComponent(queueName)}`);
+        const signal = AbortSignal.timeout(30_000);
+        const res = await this.#adapter.invoke(url, {
+            method: 'DELETE',
+            signal,
+            telemetry: {
+                name: 'agentuity.queue.delete',
+                attributes: {
+                    queueName,
+                },
+            },
+        });
+        if (res.ok) {
+            this.#knownQueues.delete(queueName);
+            return;
+        }
+        if (res.response.status === 404) {
+            throw new QueueNotFoundError({
+                message: `Queue not found: ${queueName}`,
+            });
+        }
+        throw await toServiceException('DELETE', url, res.response);
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/queue",
-	"version": "3.0.11",
+	"version": "3.1.0",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -25,8 +25,9 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "3.0.11",
-		"@agentuity/adapter": "3.0.11",
+		"@agentuity/adapter": "3.1.0",
+		"@agentuity/config": "3.1.0",
+		"@agentuity/client": "3.1.0",
 		"zod": "^4.3.5"
 	},
 	"devDependencies": {

package/src/index.ts

@@ -1,18 +1,4 @@
-export {
-	QueueStorageService,
-	QueueService,
-	type QueuePublishParams,
-	type QueuePublishResult,
-	type QueueCreateParams,
-	type QueueCreateResult,
-	QueuePublishParamsSchema,
-	QueuePublishResultSchema,
-	QueueCreateParamsSchema,
-	QueueCreateResultSchema,
-	QueuePublishError,
-	QueueNotFoundError,
-	QueueValidationError,
-} from '@agentuity/core/queue';
+export * from './service.ts';
 
 import {
 	QueueStorageService,
@@ -20,20 +6,19 @@ import {
 	type QueuePublishResult,
 	type QueueCreateParams,
 	type QueueCreateResult,
-} from '@agentuity/core/queue';
-import { createServerFetchAdapter, buildClientHeaders, type Logger } from '@agentuity/adapter';
-import { createMinimalLogger, StructuredError } from '@agentuity/core';
-import { getEnv } from '@agentuity/core';
-import { getServiceUrls } from '@agentuity/core/config';
+} from './service.ts';
+import { StructuredError } from '@agentuity/adapter';
+import { getServiceUrls } from '@agentuity/config';
+import {
+	createServiceAdapter,
+	isLogger,
+	resolveApiKey,
+	resolveRegion,
+	resolveServiceUrl,
+	type Logger,
+} from '@agentuity/client';
 import { z, ZodError } from 'zod';
 
-const isLogger = (val: unknown): val is Logger =>
-	typeof val === 'object' &&
-	val !== null &&
-	['info', 'warn', 'error', 'debug', 'trace'].every(
-		(m) => typeof (val as Record<string, unknown>)[m] === 'function'
-	);
-
 const QueueClientValidationError = StructuredError('QueueClientValidationError')<{
 	schema: string;
 	issues: Array<{ path: string; message: string }>;
@@ -68,21 +53,18 @@ export class QueueClient {
 			}
 			throw err;
 		}
-		const apiKey =
-			validatedOptions.apiKey || getEnv('AGENTUITY_SDK_KEY') || getEnv('AGENTUITY_CLI_KEY');
-		const region = getEnv('AGENTUITY_REGION') ?? 'usc';
-		const serviceUrls = getServiceUrls(region);
-
-		const url = validatedOptions.url || getEnv('AGENTUITY_QUEUE_URL') || serviceUrls.catalyst;
-
-		const logger = validatedOptions.logger ?? createMinimalLogger();
-
-		const headers = buildClientHeaders({
+		const apiKey = resolveApiKey(validatedOptions.apiKey);
+		const serviceUrls = getServiceUrls(resolveRegion());
+		const url = resolveServiceUrl({
+			url: validatedOptions.url,
+			envKey: 'AGENTUITY_QUEUE_URL',
+			fallback: serviceUrls.catalyst,
+		});
+		const { adapter } = createServiceAdapter({
 			apiKey,
 			orgId: validatedOptions.orgId,
+			logger: validatedOptions.logger,
 		});
-
-		const adapter = createServerFetchAdapter({ headers }, logger);
 		this.#service = new QueueStorageService(url, adapter);
 	}