@agentuity/core 1.0.32 → 1.0.34

package/dist/services/queue/websocket.js

@@ -0,0 +1,472 @@
+/**
+ * @module websocket
+ *
+ * WebSocket client for real-time queue message subscriptions.
+ *
+ * Provides both a callback-based API ({@link createQueueWebSocket}) and an
+ * async iterator API ({@link subscribeToQueue}) for receiving messages from
+ * a queue in real time via WebSocket.
+ *
+ * @example Callback-based API
+ * ```typescript
+ * import { createQueueWebSocket } from '@agentuity/server';
+ *
+ * const connection = createQueueWebSocket({
+ *     queueName: 'order-processing',
+ *     baseUrl: 'https://catalyst.agentuity.cloud',
+ *     onMessage: (message) => {
+ *         console.log('Received:', message.id, message.payload);
+ *     },
+ *     onOpen: () => console.log('Connected'),
+ *     onClose: (code, reason) => console.log('Closed:', code, reason),
+ *     onError: (error) => console.error('Error:', error),
+ * });
+ *
+ * // Later: close the connection
+ * connection.close();
+ * ```
+ *
+ * @example Resuming from a previous session
+ * ```typescript
+ * import { createQueueWebSocket } from '@agentuity/server';
+ *
+ * // Use a previously obtained clientId and lastOffset to resume
+ * const connection = createQueueWebSocket({
+ *     queueName: 'order-processing',
+ *     baseUrl: 'https://catalyst.agentuity.cloud',
+ *     clientId: previousClientId,
+ *     lastOffset: previousOffset,
+ *     onMessage: (message) => {
+ *         console.log('Received:', message.id, message.payload);
+ *     },
+ * });
+ * ```
+ *
+ * @example Async iterator API
+ * ```typescript
+ * import { subscribeToQueue } from '@agentuity/server';
+ *
+ * const controller = new AbortController();
+ * for await (const message of subscribeToQueue({
+ *     queueName: 'order-processing',
+ *     baseUrl: 'https://catalyst.agentuity.cloud',
+ *     signal: controller.signal,
+ * })) {
+ *     console.log('Received:', message.id, message.payload);
+ * }
+ * ```
+ */
+import { z } from 'zod';
+import { WebSocketAuthResponseSchema, WebSocketMessageSchema } from "./types.js";
+import { getEnv } from "../env.js";
+import { QueueError } from "./util.js";
+import { validateQueueName } from "./validation.js";
+/** Options for creating a queue WebSocket subscription. */
+export const QueueWebSocketOptionsSchema = z.object({
+    queueName: z.string().describe('Queue name to subscribe to'),
+    apiKey: z
+        .string()
+        .optional()
+        .describe('Optional API key override; falls back to AGENTUITY_SDK_KEY'),
+    baseUrl: z.string().describe('Base Catalyst URL used to construct the WebSocket endpoint'),
+    onMessage: z
+        .custom()
+        .describe('Callback invoked for each received queue message'),
+    onOpen: z.custom().optional().describe('Callback invoked after auth succeeds'),
+    onClose: z
+        .custom()
+        .optional()
+        .describe('Callback invoked when the socket closes'),
+    onError: z
+        .custom()
+        .optional()
+        .describe('Callback invoked when an error occurs'),
+    autoReconnect: z
+        .boolean()
+        .optional()
+        .describe('Whether to automatically reconnect after disconnection'),
+    maxReconnectAttempts: z
+        .number()
+        .optional()
+        .describe('Maximum reconnect attempts before giving up'),
+    reconnectDelayMs: z.number().optional().describe('Initial reconnect delay in milliseconds'),
+    maxReconnectDelayMs: z.number().optional().describe('Maximum reconnect delay in milliseconds'),
+    clientId: z.string().optional().describe('Optional prior client id used for resume semantics'),
+    lastOffset: z
+        .number()
+        .optional()
+        .describe('Optional last processed offset used to resume stream consumption'),
+    orgId: z
+        .string()
+        .optional()
+        .describe('Optional org id for API keys requiring explicit org scope'),
+});
+/** Options for the async iterator queue subscription. */
+export const SubscribeToQueueOptionsSchema = z.object({
+    queueName: z.string().describe('Queue name to subscribe to'),
+    apiKey: z
+        .string()
+        .optional()
+        .describe('Optional API key override; falls back to AGENTUITY_SDK_KEY'),
+    baseUrl: z.string().describe('Base Catalyst URL used to construct the WebSocket endpoint'),
+    signal: z.custom().optional().describe('AbortSignal used to stop the subscription'),
+    clientId: z.string().optional().describe('Optional prior client id used for resume semantics'),
+    lastOffset: z
+        .number()
+        .optional()
+        .describe('Optional last processed offset used to resume stream consumption'),
+    orgId: z
+        .string()
+        .optional()
+        .describe('Optional org id for API keys requiring explicit org scope'),
+});
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+/**
+ * Resolve the API key from the options or the AGENTUITY_SDK_KEY environment variable.
+ * Throws a {@link QueueError} if no API key is available.
+ */
+function resolveApiKey(apiKey) {
+    const key = apiKey ?? getEnv('AGENTUITY_SDK_KEY');
+    if (!key) {
+        throw new QueueError({
+            message: 'No API key provided. Pass apiKey in options or set the AGENTUITY_SDK_KEY environment variable.',
+        });
+    }
+    return key;
+}
+/**
+ * Convert an HTTP(S) base URL to a WebSocket URL and append the queue path.
+ *
+ * The WebSocket route is registered at `/queue/ws/{name}` (not versioned).
+ */
+function buildWebSocketUrl(baseUrl, queueName) {
+    const wsUrl = baseUrl.replace(/^https:\/\//, 'wss://').replace(/^http:\/\//, 'ws://');
+    // Remove trailing slash if present
+    const base = wsUrl.replace(/\/$/, '');
+    return `${base}/queue/ws/${encodeURIComponent(queueName)}`;
+}
+// ============================================================================
+// Callback-based API
+// ============================================================================
+/**
+ * Create a WebSocket connection to receive real-time messages from a queue.
+ *
+ * The connection handles authentication, automatic reconnection with exponential
+ * backoff, and ping/pong keep-alive (handled automatically by the WebSocket
+ * implementation).
+ *
+ * @param options - Configuration for the WebSocket connection
+ * @returns A {@link QueueWebSocketConnection} handle for managing the connection
+ * @throws {QueueError} If no API key is available
+ * @throws {QueueValidationError} If the queue name is invalid
+ *
+ * @example
+ * ```typescript
+ * const connection = createQueueWebSocket({
+ *     queueName: 'order-processing',
+ *     baseUrl: 'https://catalyst.agentuity.cloud',
+ *     onMessage: (message) => {
+ *         console.log('Received:', message.id, message.payload);
+ *     },
+ * });
+ *
+ * // Later: close the connection
+ * connection.close();
+ * ```
+ */
+export function createQueueWebSocket(options) {
+    // Validate inputs eagerly so callers get immediate feedback.
+    validateQueueName(options.queueName);
+    const apiKey = resolveApiKey(options.apiKey);
+    const { queueName, baseUrl, onMessage, onOpen, onClose, onError, autoReconnect = true, maxReconnectAttempts = Infinity, reconnectDelayMs = 1000, maxReconnectDelayMs = 30000, orgId, } = options;
+    let state = 'connecting';
+    let ws = null;
+    let intentionallyClosed = false;
+    let reconnectAttempts = 0;
+    let reconnectTimer = null;
+    let clientId = options.clientId;
+    let lastProcessedOffset = options.lastOffset;
+    function connect() {
+        if (intentionallyClosed)
+            return;
+        const url = buildWebSocketUrl(baseUrl, queueName);
+        state = reconnectAttempts > 0 ? 'reconnecting' : 'connecting';
+        try {
+            ws = new WebSocket(url);
+        }
+        catch (err) {
+            state = 'closed';
+            onError?.(new QueueError({
+                message: `Failed to create WebSocket connection: ${err instanceof Error ? err.message : String(err)}`,
+                queueName,
+                cause: err instanceof Error ? err : undefined,
+            }));
+            scheduleReconnect();
+            return;
+        }
+        ws.onopen = () => {
+            state = 'authenticating';
+            // Send auth message — raw API key, no "Bearer " prefix.
+            // Include client_id and last_offset on reconnect for resumption.
+            const authPayload = { authorization: apiKey, orgId };
+            if (clientId) {
+                authPayload.client_id = clientId;
+            }
+            if (lastProcessedOffset !== undefined) {
+                authPayload.last_offset = lastProcessedOffset;
+            }
+            ws.send(JSON.stringify(authPayload));
+        };
+        /** Whether the auth handshake has completed successfully. */
+        let authenticated = false;
+        ws.onmessage = (event) => {
+            const raw = typeof event.data === 'string' ? event.data : String(event.data);
+            if (!authenticated) {
+                // First message after open must be the auth response.
+                try {
+                    const parsed = JSON.parse(raw);
+                    const authResult = WebSocketAuthResponseSchema.safeParse(parsed);
+                    if (!authResult.success) {
+                        const err = new QueueError({
+                            message: `Unexpected auth response from server: ${raw}`,
+                            queueName,
+                        });
+                        onError?.(err);
+                        ws?.close(4000, 'Invalid auth response');
+                        return;
+                    }
+                    if (!authResult.data.success) {
+                        const err = new QueueError({
+                            message: `Authentication failed: ${authResult.data.error ?? 'Unknown error'}`,
+                            queueName,
+                        });
+                        onError?.(err);
+                        // Auth rejection is terminal — do not reconnect with the same bad credentials.
+                        intentionallyClosed = true;
+                        ws?.close(4001, 'Auth failed');
+                        return;
+                    }
+                    authenticated = true;
+                    reconnectAttempts = 0; // Reset on successful auth.
+                    state = 'connected';
+                    if (authResult.data.client_id) {
+                        clientId = authResult.data.client_id;
+                    }
+                    onOpen?.();
+                }
+                catch {
+                    const err = new QueueError({
+                        message: `Failed to parse auth response: ${raw}`,
+                        queueName,
+                    });
+                    onError?.(err);
+                    ws?.close(4000, 'Invalid auth response');
+                }
+                return;
+            }
+            // Normal message after authentication.
+            try {
+                const parsed = JSON.parse(raw);
+                const msgResult = WebSocketMessageSchema.safeParse(parsed);
+                if (msgResult.success && msgResult.data.messages.length > 0) {
+                    for (const msg of msgResult.data.messages) {
+                        onMessage(msg);
+                        if (msg.offset !== undefined) {
+                            lastProcessedOffset = msg.offset;
+                        }
+                    }
+                }
+            }
+            catch {
+                // Non-JSON frames are silently ignored; the server may send
+                // ping text frames that are not JSON.
+            }
+        };
+        ws.onclose = (event) => {
+            state = 'closed';
+            ws = null;
+            onClose?.(event.code, event.reason);
+            // Reconnect on any unintentional close — whether we were fully
+            // connected, mid-auth, or never authenticated (transient network issue).
+            if (!intentionallyClosed) {
+                scheduleReconnect();
+            }
+        };
+        ws.onerror = () => {
+            // The browser/Node WebSocket fires `error` then `close`.
+            // We report the error but let `onclose` handle reconnection.
+            onError?.(new QueueError({
+                message: 'WebSocket connection error',
+                queueName,
+            }));
+        };
+    }
+    function scheduleReconnect() {
+        if (intentionallyClosed || !autoReconnect)
+            return;
+        if (reconnectAttempts >= maxReconnectAttempts) {
+            onError?.(new QueueError({
+                message: `Exceeded maximum reconnection attempts (${maxReconnectAttempts})`,
+                queueName,
+            }));
+            return;
+        }
+        // Exponential backoff with jitter, capped at maxReconnectDelayMs.
+        const baseDelay = reconnectDelayMs * Math.pow(2, reconnectAttempts);
+        const jitter = 0.5 + Math.random() * 0.5;
+        const delay = Math.min(Math.floor(baseDelay * jitter), maxReconnectDelayMs);
+        reconnectAttempts++;
+        state = 'reconnecting';
+        reconnectTimer = setTimeout(() => {
+            reconnectTimer = null;
+            connect();
+        }, delay);
+    }
+    // Kick off the initial connection.
+    connect();
+    return {
+        close() {
+            intentionallyClosed = true;
+            if (reconnectTimer !== null) {
+                clearTimeout(reconnectTimer);
+                reconnectTimer = null;
+            }
+            if (ws) {
+                ws.close(1000, 'Client closed');
+                ws = null;
+            }
+            state = 'closed';
+        },
+        get state() {
+            return state;
+        },
+        get clientId() {
+            return clientId;
+        },
+        get lastOffset() {
+            return lastProcessedOffset;
+        },
+    };
+}
+// ============================================================================
+// Async Iterator API
+// ============================================================================
+/**
+ * Subscribe to real-time messages from a queue via WebSocket.
+ *
+ * Returns an async iterator that yields messages as they arrive.
+ * The connection is automatically managed (auth, reconnection, cleanup).
+ *
+ * @param options - Configuration for the subscription
+ * @returns An async generator that yields {@link Message} objects
+ * @throws {QueueError} If no API key is available
+ * @throws {QueueValidationError} If the queue name is invalid
+ *
+ * @example
+ * ```typescript
+ * const controller = new AbortController();
+ * for await (const message of subscribeToQueue({
+ *     queueName: 'order-processing',
+ *     baseUrl: 'https://catalyst.agentuity.cloud',
+ *     signal: controller.signal,
+ * })) {
+ *     console.log('Received:', message.id, message.payload);
+ * }
+ * ```
+ */
+export async function* subscribeToQueue(options) {
+    const { signal } = options;
+    // Check if already aborted.
+    if (signal?.aborted)
+        return;
+    // A queue for buffering messages between the WebSocket callbacks and the
+    // async iterator consumer.
+    const buffer = [];
+    let resolve = null;
+    let done = false;
+    let lastError = null;
+    function push(message) {
+        buffer.push(message);
+        if (resolve) {
+            resolve();
+            resolve = null;
+        }
+    }
+    function finish(error) {
+        done = true;
+        if (error)
+            lastError = error;
+        if (resolve) {
+            resolve();
+            resolve = null;
+        }
+    }
+    const connection = createQueueWebSocket({
+        queueName: options.queueName,
+        apiKey: options.apiKey,
+        baseUrl: options.baseUrl,
+        clientId: options.clientId,
+        lastOffset: options.lastOffset,
+        orgId: options.orgId,
+        onMessage: push,
+        onError: (err) => {
+            // Terminal errors should stop the iterator.
+            // Auth failures and max-reconnect-exceeded are terminal.
+            // Transient errors (connection drops, server shutdown) are handled
+            // by the reconnection logic in createQueueWebSocket.
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes('Authentication failed') ||
+                msg.includes('Exceeded maximum reconnection attempts') ||
+                msg.includes('No API key provided')) {
+                finish(err);
+            }
+            else {
+                // Transient error — don't store it; the reconnection logic in
+                // createQueueWebSocket will handle retry.  Storing it would cause
+                // it to be thrown on clean shutdown / abort.
+            }
+        },
+        onClose: () => {
+            // Only finish if the connection is intentionally closed (signal aborted).
+            // Otherwise, the callback-based API handles reconnection.
+        },
+        autoReconnect: true,
+    });
+    // Wire up the abort signal to close the connection.
+    const onAbort = () => {
+        connection.close();
+        finish();
+    };
+    signal?.addEventListener('abort', onAbort, { once: true });
+    try {
+        while (!done) {
+            // Drain buffered messages.
+            while (buffer.length > 0) {
+                yield buffer.shift();
+                // Re-check after yield in case signal was aborted.
+                if (done || signal?.aborted)
+                    return;
+            }
+            if (done || signal?.aborted)
+                return;
+            // Wait for the next message or completion.
+            await new Promise((r) => {
+                resolve = r;
+            });
+        }
+        // Drain any remaining messages.
+        while (buffer.length > 0) {
+            yield buffer.shift();
+        }
+        if (lastError) {
+            throw lastError;
+        }
+    }
+    finally {
+        signal?.removeEventListener('abort', onAbort);
+        connection.close();
+    }
+}
+//# sourceMappingURL=websocket.js.map

package/dist/services/queue/websocket.js.map

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

package/dist/services/region/create.d.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import { APIClient } from '../api.ts';
+/**
+ * Validates a database name for PostgreSQL compatibility.
+ * Matches the server-side validation in catalyst.
+ */
+export declare function validateDatabaseName(name: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validates an S3 bucket name according to AWS S3 naming rules.
+ * Matches the server-side validation in catalyst.
+ */
+export declare function validateBucketName(name: string): {
+    valid: boolean;
+    error?: string;
+};
+export declare const ResourceSpec: z.ZodObject<{
+    type: z.ZodEnum<{
+        s3: "s3";
+        db: "db";
+    }>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CreateResourcesRequest: z.ZodObject<{
+    resources: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            s3: "s3";
+            db: "db";
+        }>;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const CreatedResource: z.ZodObject<{
+    type: z.ZodString;
+    name: z.ZodString;
+    env: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export declare const CreateResourcesResponse: z.ZodObject<{
+    created: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        name: z.ZodString;
+        env: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const CreateResourcesResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        created: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            name: z.ZodString;
+            env: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export type CreateResourcesRequest = z.infer<typeof CreateResourcesRequest>;
+export type CreateResourcesResponse = z.infer<typeof CreateResourcesResponseSchema>;
+export type CreatedResource = z.infer<typeof CreatedResource>;
+/**
+ * Create one or more resources (DB or S3) for an organization in a specific region
+ * Requires CLI authentication
+ *
+ * @param client - Catalyst API client
+ * @param orgId - Organization ID
+ * @param region - Cloud region
+ * @param resources - Array of resources to create
+ * @returns
+ */
+export declare function createResources(client: APIClient, orgId: string, region: string, resources: Array<{
+    type: 'db' | 's3';
+    name?: string;
+    description?: string;
+}>): Promise<CreatedResource[]>;
+//# sourceMappingURL=create.d.ts.map

package/dist/services/region/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/services/region/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAqB,SAAS,EAAE,MAAM,WAAW,CAAC;AA6BzD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA0BrF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAqDnF;AAgBD,eAAO,MAAM,YAAY;;;;;;;iBAIvB,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;iBAEjC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;iBAElC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;8BAA6C,CAAC;AAExF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC5E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1E,OAAO,CAAC,eAAe,EAAE,CAAC,CA8B5B"}