@agentuity/core 1.0.32 → 1.0.34

package/dist/services/{queue.d.ts → queue/service.d.ts}

@@ -17,7 +17,8 @@
  * console.log(`Published message ${result.id}`);
  * ```
  */
-import { FetchAdapter } from './adapter.ts';
+import { FetchAdapter } from '../adapter.ts';
+import { z } from 'zod';
 /**
  * Parameters for publishing a message to a queue.
  *
@@ -31,44 +32,16 @@ import { FetchAdapter } from './adapter.ts';
  * };
  * ```
  */
-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;
-}
+export declare const QueuePublishParamsSchema: z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    partitionKey: z.ZodOptional<z.ZodString>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+    projectId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    sync: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type QueuePublishParams = z.infer<typeof QueuePublishParamsSchema>;
 /**
  * Result of publishing a message to a queue.
  *
@@ -78,22 +51,12 @@ export interface QueuePublishParams {
  * 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;
-}
+export declare const QueuePublishResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    offset: z.ZodNumber;
+    publishedAt: z.ZodString;
+}, z.core.$strip>;
+export type QueuePublishResult = z.infer<typeof QueuePublishResultSchema>;
 /**
  * Parameters for creating a queue.
  *
@@ -105,44 +68,29 @@ export interface QueuePublishResult {
  * });
  * ```
  */
-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;
-    };
-}
+export declare const QueueCreateParamsSchema: z.ZodObject<{
+    queueType: z.ZodOptional<z.ZodEnum<{
+        worker: "worker";
+        pubsub: "pubsub";
+    }>>;
+    description: z.ZodOptional<z.ZodString>;
+    settings: z.ZodOptional<z.ZodObject<{
+        defaultTtlSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        defaultVisibilityTimeoutSeconds: z.ZodOptional<z.ZodNumber>;
+        defaultMaxRetries: z.ZodOptional<z.ZodNumber>;
+        maxInFlightPerClient: z.ZodOptional<z.ZodNumber>;
+        retentionSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type QueueCreateParams = z.infer<typeof QueueCreateParamsSchema>;
 /**
  * Result of creating a queue.
  */
-export interface QueueCreateResult {
-    /** The queue name. */
-    name: string;
-    /** The queue type ('worker' or 'pubsub'). */
-    queueType: string;
-}
+export declare const QueueCreateResultSchema: z.ZodObject<{
+    name: z.ZodString;
+    queueType: z.ZodString;
+}, z.core.$strip>;
+export type QueueCreateResult = z.infer<typeof QueueCreateResultSchema>;
 /**
  * Queue service interface for publishing messages.
  *
@@ -250,7 +198,7 @@ export declare const QueuePublishError: {
     new (args?: {
         message?: string;
         cause?: unknown;
-    } | undefined): import("../error.ts").RichError & {
+    } | undefined): import("../../error.ts").RichError & {
         readonly _tag: "QueuePublishError";
     } & Readonly<Record<string, never>>;
     readonly defaultMessage?: string;
@@ -263,7 +211,7 @@ export declare const QueuePublishError: {
     } : Shape & {
         message?: string;
         cause?: unknown;
-    }) | undefined): import("../error.ts").RichError & {
+    }) | undefined): import("../../error.ts").RichError & {
         readonly _tag: "QueuePublishError";
     } & Readonly<Shape>;
     readonly defaultMessage?: string;
@@ -286,7 +234,7 @@ export declare const QueueNotFoundError: {
     new (args?: {
         message?: string;
         cause?: unknown;
-    } | undefined): import("../error.ts").RichError & {
+    } | undefined): import("../../error.ts").RichError & {
         readonly _tag: "QueueNotFoundError";
     } & Readonly<Record<string, never>>;
     readonly defaultMessage?: string;
@@ -299,7 +247,7 @@ export declare const QueueNotFoundError: {
     } : Shape & {
         message?: string;
         cause?: unknown;
-    }) | undefined): import("../error.ts").RichError & {
+    }) | undefined): import("../../error.ts").RichError & {
         readonly _tag: "QueueNotFoundError";
     } & Readonly<Shape>;
     readonly defaultMessage?: string;
@@ -318,7 +266,7 @@ export declare const QueueValidationError: {
     } & {
         message?: string;
         cause?: unknown;
-    }) | undefined): import("../error.ts").RichError & {
+    }) | undefined): import("../../error.ts").RichError & {
         readonly _tag: "QueueValidationError";
     } & Readonly<{
         /** The field that failed validation */
@@ -358,4 +306,4 @@ export declare class QueueStorageService implements QueueService {
      */
     deleteQueue(queueName: string): Promise<void>;
 }
-//# sourceMappingURL=queue.d.ts.map
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/queue/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;iBA8CnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB;;;;iBAiBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAiDlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;iBAKlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,OAAO,CACN,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEvF;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAMD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAAuC,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAAwC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;QAChC,uCAAuC;eAChC,MAAM;QACb,wCAAwC;gBAChC,OAAO;;;;;;;QAHf,uCAAuC;eAChC,MAAM;QACb,wCAAwC;gBAChC,OAAO;;;CACZ,CAAC;AA2DL;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,YAAY;;IAKvD;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAKlD;;OAEG;IACG,OAAO,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC;IA6F9B;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8E5F;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA8BnD"}

package/dist/services/{queue.js → queue/service.js}

@@ -17,8 +17,156 @@
  * console.log(`Published message ${result.id}`);
  * ```
  */
-import { buildUrl, toServiceException, toPayload } from "./_util.js";
-import { StructuredError } from "../error.js";
+import { buildUrl, toServiceException, toPayload } from "../_util.js";
+import { StructuredError } from "../../error.js";
+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 ctx.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
 // ============================================================================
@@ -154,7 +302,7 @@ export class QueueStorageService {
                 value: params.ttl,
             });
         }
-        const basePath = `/queue/messages/publish/2026-01-15/${encodeURIComponent(queueName)}`;
+        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,
@@ -216,7 +364,7 @@ export class QueueStorageService {
                 queueType: params?.queueType ?? 'worker',
             };
         }
-        const url = buildUrl(this.#baseUrl, '/queue/create/2026-01-15');
+        const url = buildUrl(this.#baseUrl, '/queue/create');
         const requestBody = {
             name: queueName,
             queue_type: params?.queueType ?? 'worker',
@@ -281,7 +429,7 @@ export class QueueStorageService {
      */
     async deleteQueue(queueName) {
         validateQueueNameInternal(queueName);
-        const url = buildUrl(this.#baseUrl, `/queue/delete/2026-01-15/${encodeURIComponent(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',
@@ -305,4 +453,4 @@ export class QueueStorageService {
         throw await toServiceException('DELETE', url, res.response);
     }
 }
-//# sourceMappingURL=queue.js.map
+//# sourceMappingURL=service.js.map

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

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

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

@@ -0,0 +1,252 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+import { type CreateSourceRequest, type ListSourceEventsRequest, type QueueApiOptions, type Source, type SourceEvent, type UpdateSourceRequest } from './types.ts';
+export declare const SourceResponseSchema: 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<{
+        source: z.ZodObject<{
+            id: z.ZodString;
+            queue_id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            auth_type: z.ZodEnum<{
+                none: "none";
+                basic: "basic";
+                header: "header";
+            }>;
+            enabled: z.ZodBoolean;
+            url: z.ZodString;
+            request_count: z.ZodNumber;
+            success_count: z.ZodNumber;
+            failure_count: z.ZodNumber;
+            last_request_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            last_success_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            last_failure_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            last_failure_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const SourcesListResponseSchema: 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<{
+        sources: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            queue_id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            auth_type: z.ZodEnum<{
+                none: "none";
+                basic: "basic";
+                header: "header";
+            }>;
+            enabled: z.ZodBoolean;
+            url: z.ZodString;
+            request_count: z.ZodNumber;
+            success_count: z.ZodNumber;
+            failure_count: z.ZodNumber;
+            last_request_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            last_success_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            last_failure_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            last_failure_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const DeleteSourceResponseSchema: 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>;
+}, z.core.$strip>], "success">;
+/**
+ * Create a source for a queue.
+ *
+ * Sources are public HTTP ingestion endpoints that allow external systems to
+ * publish messages to a queue. They support various authentication methods
+ * to secure access.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue to add the source to
+ * @param params - Source configuration including name and optional auth settings
+ * @returns The created source with assigned ID and public URL
+ * @throws {QueueValidationError} If validation fails (invalid queue name or source name)
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {SourceAlreadyExistsError} If a source with the same name already exists
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const source = await createSource(client, 'order-events', {
+ *   name: 'webhook-ingestion',
+ *   description: 'Receives webhooks from external service',
+ *   auth_type: 'header',
+ *   auth_value: 'Bearer my-secret-token',
+ * });
+ * console.log(`Created source ${source.id} at ${source.url}`);
+ * ```
+ */
+export declare function createSource(client: APIClient, queueName: string, params: CreateSourceRequest, options?: QueueApiOptions): Promise<Source>;
+/**
+ * List all sources for a queue.
+ *
+ * Retrieves all HTTP ingestion endpoints configured for a queue. Each source
+ * provides a public URL for external systems to publish messages.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @returns Array of sources configured for the queue
+ * @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
+ * const sources = await listSources(client, 'order-events');
+ * for (const source of sources) {
+ *   console.log(`Source ${source.id}: ${source.name} (${source.enabled ? 'enabled' : 'disabled'})`);
+ *   console.log(`  URL: ${source.url}`);
+ *   console.log(`  Success rate: ${source.success_count}/${source.request_count}`);
+ * }
+ * ```
+ */
+export declare function listSources(client: APIClient, queueName: string, options?: QueueApiOptions): Promise<Source[]>;
+/**
+ * Get a source by ID.
+ *
+ * Retrieves a specific source's details including its public URL and statistics.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param sourceId - The source ID to retrieve (prefixed with qsrc_)
+ * @returns The source details
+ * @throws {QueueValidationError} If validation fails (invalid queue name or source ID)
+ * @throws {SourceNotFoundError} If the source does not exist
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const source = await getSource(client, 'order-events', 'qsrc_abc123');
+ * console.log(`Source: ${source.name}`);
+ * console.log(`URL: ${source.url}`);
+ * console.log(`Auth type: ${source.auth_type}`);
+ * console.log(`Last request: ${source.last_request_at}`);
+ * ```
+ */
+export declare function getSource(client: APIClient, queueName: string, sourceId: string, options?: QueueApiOptions): Promise<Source>;
+/**
+ * Update a source's configuration.
+ *
+ * Modifies an existing source's settings such as name, enabled status,
+ * or authentication configuration. Only the fields provided in params will be updated.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param sourceId - The source ID to update (prefixed with qsrc_)
+ * @param params - Fields to update (partial update supported)
+ * @returns The updated source
+ * @throws {QueueValidationError} If validation fails (invalid queue name or source ID)
+ * @throws {SourceNotFoundError} If the source does not exist
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Disable a source temporarily
+ * const updated = await updateSource(client, 'order-events', 'qsrc_abc123', {
+ *   enabled: false,
+ * });
+ *
+ * // Update authentication
+ * const updated = await updateSource(client, 'order-events', 'qsrc_abc123', {
+ *   auth_type: 'basic',
+ *   auth_value: 'user:password',
+ * });
+ * ```
+ */
+export declare function updateSource(client: APIClient, queueName: string, sourceId: string, params: UpdateSourceRequest, options?: QueueApiOptions): Promise<Source>;
+/**
+ * Delete a source from a queue.
+ *
+ * Permanently removes an HTTP ingestion endpoint. The public URL will no longer
+ * accept requests. This action cannot be undone.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param sourceId - The source ID to delete (prefixed with qsrc_)
+ * @returns void
+ * @throws {QueueValidationError} If validation fails (invalid queue name or source ID)
+ * @throws {SourceNotFoundError} If the source does not exist
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * await deleteSource(client, 'order-events', 'qsrc_abc123');
+ * console.log('Source deleted');
+ * ```
+ */
+export declare function deleteSource(client: APIClient, queueName: string, sourceId: string, options?: QueueApiOptions): Promise<void>;
+export declare const SourceEventsListResponseSchema: 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<{
+        events: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            source_id: z.ZodString;
+            queue_id: z.ZodString;
+            message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            payload: z.ZodOptional<z.ZodUnknown>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            status: z.ZodEnum<{
+                success: "success";
+                failed: "failed";
+            }>;
+            error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            http_status_code: z.ZodOptional<z.ZodNumber>;
+            remote_addr: z.ZodOptional<z.ZodString>;
+            received_at: z.ZodString;
+            created_at: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+/**
+ * List events received through a queue source.
+ *
+ * Returns the most recent events (requests) received through a source's
+ * public endpoint, including both successful and failed ingestion attempts.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param sourceId - The source ID (prefixed with qsrc_)
+ * @param params - Optional filtering and pagination
+ * @returns Array of source events
+ * @throws {QueueValidationError} If validation fails
+ * @throws {SourceNotFoundError} If the source does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const events = await listSourceEvents(client, 'order-events', 'qsrc_abc123', {
+ *   limit: 50,
+ *   status: 'failed',
+ * });
+ * ```
+ */
+export declare function listSourceEvents(client: APIClient, queueName: string, sourceId: string, params?: ListSourceEventsRequest, options?: QueueApiOptions): Promise<SourceEvent[]>;
+//# sourceMappingURL=sources.d.ts.map