@agentuity/core 1.0.41 → 1.0.43

package/src/services/queue/types.ts

@@ -1664,3 +1664,115 @@ export const WebSocketMessageSchema = z
 	.describe('Web socket message schema');
 
 export type WebSocketMessage = z.infer<typeof WebSocketMessageSchema>;
+
+// ============================================================================
+// API Response Schemas
+// ============================================================================
+
+/**
+ * Response schema for the list-queues endpoint.
+ */
+export const ListQueuesResponseSchema = z.object({
+	/** Queues in the current page */
+	queues: z.array(QueueSchema).describe('Queues in the current page'),
+	/** Optional total queue count */
+	total: z.number().optional().describe('Optional total queue count'),
+});
+
+export type ListQueuesResponse = z.infer<typeof ListQueuesResponseSchema>;
+
+/**
+ * Response schema for the batch-publish endpoint.
+ */
+export const BatchPublishResponseSchema = z.object({
+	/** Published messages */
+	messages: z.array(MessageSchema).describe('Published messages'),
+	/** Indexes that failed */
+	failed: z.array(z.number()).optional().describe('Indexes that failed'),
+});
+
+export type BatchPublishResponse = z.infer<typeof BatchPublishResponseSchema>;
+
+/**
+ * Response schema for the list-messages endpoint.
+ */
+export const ListMessagesResponseSchema = z.object({
+	/** Messages in current page */
+	messages: z.array(MessageSchema).describe('Messages in current page'),
+	/** Optional total message count */
+	total: z.number().optional().describe('Optional total message count'),
+});
+
+export type ListMessagesResponse = z.infer<typeof ListMessagesResponseSchema>;
+
+/**
+ * Response schema for the consume-messages endpoint.
+ */
+export const ConsumeMessagesResponseSchema = z.object({
+	/** Consumed messages */
+	messages: z.array(MessageSchema).describe('Consumed messages'),
+});
+
+export type ConsumeMessagesResponse = z.infer<typeof ConsumeMessagesResponseSchema>;
+
+/**
+ * Response schema for the receive-message endpoint.
+ */
+export const ReceiveMessageResponseSchema = z.object({
+	/** Received message if available */
+	message: MessageSchema.nullable().describe('Received message if available'),
+});
+
+export type ReceiveMessageResponse = z.infer<typeof ReceiveMessageResponseSchema>;
+
+/**
+ * Response schema for the get-queue-head endpoint.
+ */
+export const GetQueueHeadResponseSchema = z.object({
+	/** Oldest message offset */
+	offset: z.number().describe('Oldest message offset'),
+});
+
+export type GetQueueHeadResponse = z.infer<typeof GetQueueHeadResponseSchema>;
+
+/**
+ * Response schema for the get-queue-tail endpoint.
+ */
+export const GetQueueTailResponseSchema = z.object({
+	/** Newest message offset */
+	offset: z.number().describe('Newest message offset'),
+});
+
+export type GetQueueTailResponse = z.infer<typeof GetQueueTailResponseSchema>;
+
+/**
+ * Response schema for the list-destinations endpoint.
+ */
+export const ListDestinationsResponseSchema = z.object({
+	/** Configured destinations */
+	destinations: z.array(DestinationSchema).describe('Configured destinations'),
+});
+
+export type ListDestinationsResponse = z.infer<typeof ListDestinationsResponseSchema>;
+
+/**
+ * Response schema for the list-delivery-logs endpoint.
+ */
+export const ListDeliveryLogsResponseSchema = z.object({
+	/** Delivery log entries */
+	deliveries: z.array(DeliveryLogSchema).describe('Delivery log entries'),
+});
+
+export type ListDeliveryLogsResponse = z.infer<typeof ListDeliveryLogsResponseSchema>;
+
+/**
+ * Response schema for the list-dlq-messages endpoint.
+ */
+export const ListDlqMessagesResponseSchema = z.object({
+	/** DLQ messages */
+	messages: z.array(DeadLetterMessageSchema).describe('DLQ messages'),
+	/** Optional total DLQ message count */
+	total: z.number().optional().describe('Optional total DLQ message count'),
+});
+
+export type ListDlqMessagesResponse = z.infer<typeof ListDlqMessagesResponseSchema>;

package/src/services/region/api-reference.ts

@@ -0,0 +1,105 @@
+import {
+	CreateResourcesApiRequestSchema,
+	DeleteResourcesApiRequestSchema,
+	RegionInfoApiSchema,
+} from './types.ts';
+import type { Service } from '../api-reference.ts';
+
+const service: Service = {
+	name: 'Regions',
+	slug: 'regions',
+	description: 'List available cloud regions and manage per-region resources',
+	endpoints: [
+		{
+			id: 'list-regions',
+			title: 'List Regions',
+			method: 'GET',
+			path: '/cli/region',
+			description: 'List all available cloud regions.',
+			pathParams: [],
+			queryParams: [],
+			requestBody: null,
+			responseDescription: 'Array of region objects.',
+			responseFields: { schema: RegionInfoApiSchema, stripRequired: true },
+			statuses: [
+				{ code: 200, description: 'Regions returned' },
+				{ code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+			],
+			examplePath: '/cli/region',
+		},
+		{
+			id: 'list-region-resources',
+			title: 'List Region Resources',
+			sectionTitle: 'Resource Management',
+			method: 'GET',
+			path: '/resource/{orgId}/{region}',
+			description: 'List resources provisioned in a specific region for an organization.',
+			pathParams: [
+				{ name: 'orgId', type: 'string', description: 'Organization ID', required: true },
+				{ name: 'region', type: 'string', description: 'Region identifier', required: true },
+			],
+			queryParams: [],
+			requestBody: null,
+			responseDescription:
+				'Returns S3 buckets, databases, and optional Redis resources for the specified region.',
+			statuses: [
+				{ code: 200, description: 'Region resources returned' },
+				{ code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+				{ code: 404, description: 'Organization or region not found' },
+			],
+			examplePath: '/resource/org_abc123/usw',
+		},
+		{
+			id: 'create-resources',
+			title: 'Create Resources',
+			sectionTitle: 'Resource Management',
+			method: 'POST',
+			path: '/resource/{orgId}/{region}',
+			description: 'Create resources in a specific region for an organization.',
+			pathParams: [
+				{ name: 'orgId', type: 'string', description: 'Organization ID', required: true },
+				{ name: 'region', type: 'string', description: 'Region identifier', required: true },
+			],
+			queryParams: [],
+			requestBody: {
+				description: 'Resource creation payload.',
+				fields: { schema: CreateResourcesApiRequestSchema },
+			},
+			responseDescription: 'Created resource objects.',
+			statuses: [
+				{ code: 201, description: 'Resources created' },
+				{ code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+				{ code: 404, description: 'Organization or region not found' },
+			],
+			examplePath: '/resource/org_abc123/usw',
+			exampleBody: { resources: [{ type: 'db', name: 'mydb' }] },
+		},
+		{
+			id: 'delete-resources',
+			title: 'Delete Resources',
+			sectionTitle: 'Resource Management',
+			method: 'DELETE',
+			path: '/resource/{orgId}/{region}',
+			description: 'Delete resources in a specific region for an organization.',
+			pathParams: [
+				{ name: 'orgId', type: 'string', description: 'Organization ID', required: true },
+				{ name: 'region', type: 'string', description: 'Region identifier', required: true },
+			],
+			queryParams: [],
+			requestBody: {
+				description: 'Resource deletion payload.',
+				fields: { schema: DeleteResourcesApiRequestSchema },
+			},
+			responseDescription: 'Empty response on success.',
+			statuses: [
+				{ code: 204, description: 'Resources deleted' },
+				{ code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+				{ code: 404, description: 'Organization or region not found' },
+			],
+			examplePath: '/resource/org_abc123/usw',
+			exampleBody: { resources: [{ type: 'db', name: 'mydb' }] },
+		},
+	],
+};
+
+export default service;

package/src/services/region/types.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+
+// ---------------------------------------------------------------------------
+// API-level Zod schemas for the Regions HTTP API.
+// ---------------------------------------------------------------------------
+
+/** Single region info (matches API response shape) */
+export const RegionInfoApiSchema = z.object({
+	region: z.string().describe('Region identifier'),
+	description: z.string().describe('Human-readable region name'),
+});
+
+export type RegionInfoApi = z.infer<typeof RegionInfoApiSchema>;
+
+/** Request body for POST /resource/{orgId}/{region} (create resources) */
+export const CreateResourcesApiRequestSchema = z.object({
+	resources: z.array(z.any()).describe("Array of { type: 'db'|'s3', name?, description? }"),
+});
+
+export type CreateResourcesApiRequest = z.infer<typeof CreateResourcesApiRequestSchema>;
+
+/** Request body for DELETE /resource/{orgId}/{region} (delete resources) */
+export const DeleteResourcesApiRequestSchema = z.object({
+	resources: z.array(z.any()).describe("Array of { type: 'db'|'s3', name }"),
+});
+
+export type DeleteResourcesApiRequest = z.infer<typeof DeleteResourcesApiRequestSchema>;