@agentuity/core 1.0.33 → 1.0.35

package/dist/services/keyvalue.js

@@ -1,305 +0,0 @@
-import { buildUrl, toServiceException, toPayload } from "./_util.js";
-/**
- * Minimum TTL value in seconds (1 minute)
- */
-export const KV_MIN_TTL_SECONDS = 60;
-/**
- * Maximum TTL value in seconds (90 days)
- */
-export const KV_MAX_TTL_SECONDS = 7776000;
-/**
- * Default TTL value in seconds (7 days) - used when namespace is auto-created or no TTL specified
- */
-export const KV_DEFAULT_TTL_SECONDS = 604800;
-/**
- * Decodes a base64 string to a Uint8Array.
- */
-function base64ToBytes(base64) {
-    const binaryString = atob(base64);
-    const bytes = new Uint8Array(binaryString.length);
-    for (let i = 0; i < binaryString.length; i++) {
-        bytes[i] = binaryString.charCodeAt(i);
-    }
-    return bytes;
-}
-/**
- * Deserializes search result values from the server's wire format.
- *
- * The Go server stores values as []byte, which Go's json.Marshal
- * base64-encodes when embedding in a JSON response. This function
- * decodes each item's value from base64 and parses it according
- * to its contentType, aligning search() behavior with get().
- */
-function deserializeSearchResults(data) {
-    for (const item of Object.values(data)) {
-        if (typeof item.value === 'string') {
-            try {
-                const bytes = base64ToBytes(item.value);
-                const ct = (item.contentType ?? '').toLowerCase();
-                if (ct.includes('json')) {
-                    const text = new TextDecoder().decode(bytes);
-                    item.value = JSON.parse(text);
-                }
-                else if (ct.startsWith('text/')) {
-                    item.value = new TextDecoder().decode(bytes);
-                }
-                else {
-                    item.value = bytes.buffer;
-                }
-            }
-            catch {
-                // If base64 decoding or parsing fails, leave value as-is
-            }
-        }
-    }
-    return data;
-}
-export class KeyValueStorageService {
-    #adapter;
-    #baseUrl;
-    constructor(baseUrl, adapter) {
-        this.#adapter = adapter;
-        this.#baseUrl = baseUrl;
-    }
-    async get(name, key) {
-        const url = buildUrl(this.#baseUrl, `/kv/${encodeURIComponent(name)}/${encodeURIComponent(key)}`);
-        const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
-        const res = await this.#adapter.invoke(url, {
-            method: 'GET',
-            signal,
-            telemetry: {
-                name: 'agentuity.keyvalue.get',
-                attributes: {
-                    name,
-                    key,
-                },
-            },
-        });
-        if (res.ok) {
-            const expiresAt = res.response.headers.get('x-expires-at') ?? undefined;
-            return {
-                data: res.data,
-                contentType: res.response.headers.get('content-type') ?? 'application/octet-stream',
-                exists: true,
-                ...(expiresAt && { expiresAt }),
-            };
-        }
-        if (res.response.status === 404) {
-            return { exists: false };
-        }
-        throw await toServiceException('GET', url, res.response);
-    }
-    /**
-     * set a value in the key value storage
-     *
-     * @param name - the name of the key value storage
-     * @param key - the key to set the value of
-     * @param value - the value to set in any of the supported data types
-     * @param params - the KeyValueStorageSetParams
-     *
-     * @remarks
-     * TTL behavior:
-     * - If TTL is not specified (undefined), the key inherits the namespace's default TTL
-     * - If TTL is null or 0, the key will not expire
-     * - If TTL is a positive number, the key expires after that many seconds
-     * - TTL values below 60 seconds are clamped to 60 seconds by the server
-     * - TTL values above 7,776,000 seconds (90 days) are clamped to 90 days
-     * - If the namespace doesn't exist, it is auto-created with a 7-day default TTL
-     */
-    async set(name, key, value, params) {
-        // TTL handling: only include if explicitly provided
-        // null or 0 = no expiration (send 0 to server), positive = TTL in seconds
-        // undefined = not sent, server uses namespace default
-        let ttlstr = '';
-        if (params?.ttl !== undefined) {
-            const ttlValue = params.ttl === null ? 0 : params.ttl;
-            ttlstr = `/${ttlValue}`;
-        }
-        const url = buildUrl(this.#baseUrl, `/kv/${encodeURIComponent(name)}/${encodeURIComponent(key)}${ttlstr}`);
-        const [body, contentType] = await toPayload(value);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'PUT',
-            signal,
-            body,
-            contentType: params?.contentType || contentType,
-            telemetry: {
-                name: 'agentuity.keyvalue.set',
-                attributes: {
-                    name,
-                    key,
-                    ttl: ttlstr,
-                },
-            },
-        });
-        if (res.ok) {
-            return;
-        }
-        throw await toServiceException('PUT', url, res.response);
-    }
-    async delete(name, key) {
-        const url = buildUrl(this.#baseUrl, `/kv/${encodeURIComponent(name)}/${encodeURIComponent(key)}`);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'DELETE',
-            signal,
-            telemetry: {
-                name: 'agentuity.keyvalue.delete',
-                attributes: {
-                    name,
-                    key,
-                },
-            },
-        });
-        if (res.ok) {
-            return;
-        }
-        throw await toServiceException('DELETE', url, res.response);
-    }
-    async getStats(name) {
-        const url = buildUrl(this.#baseUrl, `/kv/stats/${encodeURIComponent(name)}`);
-        const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
-        const res = await this.#adapter.invoke(url, {
-            method: 'GET',
-            signal,
-            telemetry: {
-                name: 'agentuity.keyvalue.getStats',
-                attributes: { name },
-            },
-        });
-        if (res.ok) {
-            return res.data;
-        }
-        throw await toServiceException('GET', url, res.response);
-    }
-    async getAllStats(params) {
-        const queryParams = new URLSearchParams();
-        if (params?.limit !== undefined) {
-            queryParams.set('limit', String(params.limit));
-        }
-        if (params?.offset !== undefined) {
-            queryParams.set('offset', String(params.offset));
-        }
-        if (params?.sort) {
-            queryParams.set('sort', params.sort);
-        }
-        if (params?.direction) {
-            queryParams.set('direction', params.direction);
-        }
-        if (params?.name) {
-            queryParams.set('name', params.name);
-        }
-        if (params?.projectId) {
-            queryParams.set('project_id', params.projectId);
-        }
-        if (params?.agentId) {
-            queryParams.set('agent_id', params.agentId);
-        }
-        if (params?.projectName) {
-            queryParams.set('project_name', params.projectName);
-        }
-        if (params?.agentName) {
-            queryParams.set('agent_name', params.agentName);
-        }
-        const queryString = queryParams.toString();
-        const url = buildUrl(this.#baseUrl, `/kv/stats${queryString ? `?${queryString}` : ''}`);
-        const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
-        const res = await this.#adapter.invoke(url, {
-            method: 'GET',
-            signal,
-            telemetry: {
-                name: 'agentuity.keyvalue.getAllStats',
-                attributes: {},
-            },
-        });
-        if (res.ok) {
-            return res.data;
-        }
-        throw await toServiceException('GET', url, res.response);
-    }
-    async getNamespaces() {
-        const url = buildUrl(this.#baseUrl, '/kv/namespaces');
-        const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
-        const res = await this.#adapter.invoke(url, {
-            method: 'GET',
-            signal,
-            telemetry: {
-                name: 'agentuity.keyvalue.getNamespaces',
-                attributes: {},
-            },
-        });
-        if (res.ok) {
-            return res.data;
-        }
-        throw await toServiceException('GET', url, res.response);
-    }
-    async search(name, keyword) {
-        const url = buildUrl(this.#baseUrl, `/kv/search/${encodeURIComponent(name)}/${encodeURIComponent(keyword)}`);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'GET',
-            signal,
-            telemetry: {
-                name: 'agentuity.keyvalue.search',
-                attributes: { name, keyword },
-            },
-        });
-        if (res.ok) {
-            return deserializeSearchResults(res.data);
-        }
-        throw await toServiceException('GET', url, res.response);
-    }
-    async getKeys(name) {
-        const url = buildUrl(this.#baseUrl, `/kv/keys/${encodeURIComponent(name)}`);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'GET',
-            signal,
-            telemetry: {
-                name: 'agentuity.keyvalue.getKeys',
-                attributes: { name },
-            },
-        });
-        if (res.ok) {
-            return res.data;
-        }
-        throw await toServiceException('GET', url, res.response);
-    }
-    async deleteNamespace(name) {
-        const url = buildUrl(this.#baseUrl, `/kv/${encodeURIComponent(name)}`);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'DELETE',
-            signal,
-            telemetry: {
-                name: 'agentuity.keyvalue.deleteNamespace',
-                attributes: { name },
-            },
-        });
-        if (res.ok) {
-            return;
-        }
-        throw await toServiceException('DELETE', url, res.response);
-    }
-    async createNamespace(name, params) {
-        const url = buildUrl(this.#baseUrl, `/kv/${encodeURIComponent(name)}`);
-        const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
-        const body = params?.defaultTTLSeconds !== undefined
-            ? JSON.stringify({ default_ttl_seconds: params.defaultTTLSeconds })
-            : undefined;
-        const res = await this.#adapter.invoke(url, {
-            method: 'POST',
-            signal,
-            ...(body && { body, contentType: 'application/json' }),
-            telemetry: {
-                name: 'agentuity.keyvalue.createNamespace',
-                attributes: { name },
-            },
-        });
-        if (res.ok) {
-            return;
-        }
-        throw await toServiceException('POST', url, res.response);
-    }
-}
-//# sourceMappingURL=keyvalue.js.map

package/dist/services/keyvalue.js.map

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

package/dist/services/queue.d.ts

@@ -1,361 +0,0 @@
-/**
- * @module queue
- *
- * Queue service for publishing messages to Agentuity queues.
- *
- * This module provides a simplified interface for agents to publish messages
- * to queues. For full queue management (CRUD, consume, acknowledge), use
- * the `@agentuity/server` package.
- *
- * @example Publishing from an agent
- * ```typescript
- * // Inside an agent handler
- * const result = await ctx.queue.publish('order-queue', {
- *   orderId: 123,
- *   action: 'process',
- * });
- * console.log(`Published message ${result.id}`);
- * ```
- */
-import { FetchAdapter } from './adapter.ts';
-/**
- * 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 interface QueuePublishParams {
-    /**
-     * Optional metadata to attach to the message.
-     * Can contain any JSON-serializable data for message routing or filtering.
-     */
-    metadata?: Record<string, unknown>;
-    /**
-     * Optional partition key for message ordering.
-     * Messages with the same partition key are guaranteed to be processed in order.
-     */
-    partitionKey?: string;
-    /**
-     * Optional idempotency key for deduplication.
-     * If a message with the same key was recently published, it will be deduplicated.
-     */
-    idempotencyKey?: string;
-    /**
-     * Optional time-to-live in seconds.
-     * Messages will expire and be removed after this duration.
-     */
-    ttl?: number;
-    /**
-     * Optional project ID for cross-project publishing.
-     * If not specified, uses the current project context.
-     */
-    projectId?: string;
-    /**
-     * Optional agent ID for attribution.
-     * If not specified, uses the current agent context.
-     */
-    agentId?: string;
-    /**
-     * 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?: boolean;
-}
-/**
- * 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 interface QueuePublishResult {
-    /**
-     * The unique message ID (prefixed with msg_).
-     * Use this ID to track, acknowledge, or delete the message.
-     */
-    id: string;
-    /**
-     * The sequential offset of the message in the queue.
-     * Offsets are monotonically increasing and can be used for log-style consumption.
-     */
-    offset: number;
-    /**
-     * ISO 8601 timestamp when the message was published.
-     */
-    publishedAt: string;
-}
-/**
- * Parameters for creating a queue.
- *
- * @example
- * ```typescript
- * const result = await ctx.queue.createQueue('my-queue', {
- *   queueType: 'pubsub',
- *   settings: { defaultTtlSeconds: 86400 },
- * });
- * ```
- */
-export interface QueueCreateParams {
-    /**
-     * 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?: 'worker' | 'pubsub';
-    /**
-     * Optional description of the queue's purpose.
-     */
-    description?: string;
-    /**
-     * Optional settings to customize queue behavior.
-     * Only provided fields are applied; others use server defaults.
-     */
-    settings?: {
-        /** Default time-to-live for messages in seconds. Null means no expiration. */
-        defaultTtlSeconds?: number | null;
-        /** Time in seconds a message is invisible after being received. */
-        defaultVisibilityTimeoutSeconds?: number;
-        /** Maximum number of delivery attempts before moving to DLQ. */
-        defaultMaxRetries?: number;
-        /** Maximum number of messages a single client can process concurrently. */
-        maxInFlightPerClient?: number;
-        /** Retention period for acknowledged messages in seconds. */
-        retentionSeconds?: number;
-    };
-}
-/**
- * Result of creating a queue.
- */
-export interface QueueCreateResult {
-    /** The queue name. */
-    name: string;
-    /** The queue type ('worker' or 'pubsub'). */
-    queueType: string;
-}
-/**
- * Queue service interface for publishing messages.
- *
- * This is the interface available to agents via `ctx.queue`. It provides
- * a simple publish-only interface suitable for agent workflows.
- *
- * For full queue management (create queues, consume messages, manage destinations),
- * use the `@agentuity/server` package.
- *
- * @example
- * ```typescript
- * // In an agent handler
- * export default createAgent('my-agent', {
- *   handler: async (ctx, input) => {
- *     // Publish a message to a queue
- *     await ctx.queue.publish('notifications', {
- *       type: 'email',
- *       to: input.email,
- *       subject: 'Welcome!',
- *     });
- *     return { success: true };
- *   },
- * });
- * ```
- */
-export interface QueueService {
-    /**
-     * Publish a message to a queue.
-     *
-     * The payload can be a string or an object. Objects are automatically
-     * JSON-stringified before publishing.
-     *
-     * @param queueName - The name of the queue to publish to
-     * @param payload - The message payload (string or JSON-serializable object)
-     * @param params - Optional publish parameters (metadata, TTL, etc.)
-     * @returns The publish result with message ID and offset
-     * @throws {QueueNotFoundError} If the queue does not exist
-     * @throws {QueueValidationError} If validation fails (invalid name, payload too large, etc.)
-     * @throws {QueuePublishError} If the publish operation fails
-     *
-     * @example Publishing a simple message
-     * ```typescript
-     * const result = await ctx.queue.publish('my-queue', 'Hello, World!');
-     * ```
-     *
-     * @example Publishing with options
-     * ```typescript
-     * const result = await ctx.queue.publish('my-queue', { task: 'process' }, {
-     *   metadata: { priority: 'high' },
-     *   idempotencyKey: 'task-123',
-     *   ttl: 3600,
-     * });
-     * ```
-     */
-    publish(queueName: string, payload: string | object, params?: QueuePublishParams): Promise<QueuePublishResult>;
-    /**
-     * Create a queue with idempotent semantics.
-     *
-     * If the queue already exists, this returns successfully without error.
-     * Safe to call multiple times — uses an internal cache to avoid redundant API calls.
-     *
-     * @param queueName - The name of the queue to create
-     * @param params - Optional creation parameters (queue type, settings, etc.)
-     * @returns The create result with queue name and type
-     * @throws {QueueValidationError} If the queue name is invalid
-     *
-     * @example Creating a worker queue
-     * ```typescript
-     * const result = await ctx.queue.createQueue('task-queue');
-     * ```
-     *
-     * @example Creating a pubsub queue with settings
-     * ```typescript
-     * const result = await ctx.queue.createQueue('events', {
-     *   queueType: 'pubsub',
-     *   settings: { defaultTtlSeconds: 86400 },
-     * });
-     * ```
-     */
-    createQueue(queueName: string, params?: QueueCreateParams): Promise<QueueCreateResult>;
-    /**
-     * Delete a queue.
-     *
-     * Permanently deletes a queue and all its messages. This action cannot be undone.
-     * If the queue has already been deleted or does not exist, a {@link QueueNotFoundError} is thrown.
-     *
-     * @param queueName - The name of the queue to delete
-     * @throws {QueueNotFoundError} If the queue does not exist
-     * @throws {QueueValidationError} If the queue name is invalid
-     *
-     * @example Deleting a queue
-     * ```typescript
-     * await ctx.queue.deleteQueue('old-queue');
-     * ```
-     */
-    deleteQueue(queueName: string): Promise<void>;
-}
-/**
- * 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 declare const QueuePublishError: {
-    new (args?: {
-        message?: string;
-        cause?: unknown;
-    } | undefined): import("../error.ts").RichError & {
-        readonly _tag: "QueuePublishError";
-    } & Readonly<Record<string, never>>;
-    readonly defaultMessage?: string;
-} & (<Shape extends {
-    [x: string]: any;
-} = Record<string, never>>() => {
-    new (args?: (Shape extends Record<string, never> ? {
-        message?: string;
-        cause?: unknown;
-    } : Shape & {
-        message?: string;
-        cause?: unknown;
-    }) | undefined): import("../error.ts").RichError & {
-        readonly _tag: "QueuePublishError";
-    } & Readonly<Shape>;
-    readonly defaultMessage?: string;
-});
-/**
- * Error thrown when a queue is not found.
- *
- * @example
- * ```typescript
- * try {
- *   await ctx.queue.publish('non-existent', 'payload');
- * } catch (error) {
- *   if (error instanceof QueueNotFoundError) {
- *     console.error('Queue does not exist');
- *   }
- * }
- * ```
- */
-export declare const QueueNotFoundError: {
-    new (args?: {
-        message?: string;
-        cause?: unknown;
-    } | undefined): import("../error.ts").RichError & {
-        readonly _tag: "QueueNotFoundError";
-    } & Readonly<Record<string, never>>;
-    readonly defaultMessage?: string;
-} & (<Shape extends {
-    [x: string]: any;
-} = Record<string, never>>() => {
-    new (args?: (Shape extends Record<string, never> ? {
-        message?: string;
-        cause?: unknown;
-    } : Shape & {
-        message?: string;
-        cause?: unknown;
-    }) | undefined): import("../error.ts").RichError & {
-        readonly _tag: "QueueNotFoundError";
-    } & Readonly<Shape>;
-    readonly defaultMessage?: string;
-});
-/**
- * Error thrown when validation fails.
- *
- * Contains the field name and optionally the invalid value for debugging.
- */
-export declare const QueueValidationError: {
-    new (args?: ({
-        /** The field that failed validation */
-        field: string;
-        /** The invalid value (for debugging) */
-        value?: unknown;
-    } & {
-        message?: string;
-        cause?: unknown;
-    }) | undefined): import("../error.ts").RichError & {
-        readonly _tag: "QueueValidationError";
-    } & Readonly<{
-        /** The field that failed validation */
-        field: string;
-        /** The invalid value (for debugging) */
-        value?: unknown;
-    }>;
-    readonly defaultMessage?: string;
-};
-/**
- * HTTP-based implementation of the QueueService interface.
- *
- * This service communicates with the Agentuity Queue API to publish messages.
- * It is automatically configured and available via `ctx.queue` in agent handlers.
- *
- * @internal This class is instantiated by the runtime; use `ctx.queue` instead.
- */
-export declare class QueueStorageService implements QueueService {
-    #private;
-    /**
-     * Creates a new QueueStorageService.
-     *
-     * @param baseUrl - The base URL of the Queue API
-     * @param adapter - The fetch adapter for making HTTP requests
-     */
-    constructor(baseUrl: string, adapter: FetchAdapter);
-    /**
-     * @inheritdoc
-     */
-    publish(queueName: string, payload: string | object, params?: QueuePublishParams): Promise<QueuePublishResult>;
-    /**
-     * @inheritdoc
-     */
-    createQueue(queueName: string, params?: QueueCreateParams): Promise<QueueCreateResult>;
-    /**
-     * @inheritdoc
-     */
-    deleteQueue(queueName: string): Promise<void>;
-}
-//# sourceMappingURL=queue.d.ts.map

package/dist/services/queue.d.ts.map

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