@agentuity/cli 1.0.21 → 1.0.23

package/src/cmd/cloud/webhook/destinations.ts

@@ -0,0 +1,274 @@
+import { z } from 'zod';
+import { createCommand, createSubcommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createWebhookAPIClient, getWebhookApiOptions } from './util';
+import { getCommand } from '../../../command-prefix';
+import { ErrorCode } from '../../../errors';
+import {
+	createWebhookDestination,
+	listWebhookDestinations,
+	updateWebhookDestination,
+	deleteWebhookDestination,
+	WebhookDestinationSchema,
+	type WebhookDestination,
+} from '@agentuity/server';
+
+const DestinationsListResponseSchema = z.object({
+	destinations: z.array(
+		z.object({
+			id: z.string(),
+			type: z.string(),
+			config: z.record(z.string(), z.unknown()),
+			created_at: z.string(),
+		})
+	),
+});
+
+const listDestinationsSubcommand = createSubcommand({
+	name: 'list',
+	aliases: ['ls'],
+	description: 'List destinations for a webhook',
+	tags: ['read-only', 'fast', 'requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud webhook destinations list wh_abc123'),
+			description: 'List webhook destinations',
+		},
+	],
+	schema: {
+		args: z.object({
+			webhook_id: z.string().min(1).describe('Webhook ID'),
+		}),
+		response: DestinationsListResponseSchema,
+	},
+	idempotent: true,
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const client = await createWebhookAPIClient(ctx);
+		const destinations = await listWebhookDestinations(
+			client,
+			args.webhook_id,
+			getWebhookApiOptions(ctx)
+		);
+
+		if (!options.json) {
+			if (destinations.length === 0) {
+				tui.info('No destinations configured');
+			} else {
+				const tableData = destinations.map((d: WebhookDestination) => ({
+					ID: d.id,
+					Type: d.type,
+					Config: JSON.stringify(d.config),
+					Created: new Date(d.created_at).toLocaleString(),
+				}));
+				tui.table(tableData, ['ID', 'Type', 'Config', 'Created']);
+			}
+		}
+
+		return {
+			destinations: destinations.map((d: WebhookDestination) => ({
+				id: d.id,
+				type: d.type,
+				config: d.config,
+				created_at: d.created_at,
+			})),
+		};
+	},
+});
+
+const createUrlDestinationSubcommand = createSubcommand({
+	name: 'url',
+	description: 'Create a URL destination for a webhook',
+	tags: ['mutating', 'creates-resource', 'requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand(
+				'cloud webhook destinations create url wh_abc123 https://example.com/webhook'
+			),
+			description: 'Create a URL destination',
+		},
+	],
+	schema: {
+		args: z.object({
+			webhook_id: z.string().min(1).describe('Webhook ID'),
+			url: z.string().min(1).describe('Destination URL'),
+		}),
+		response: WebhookDestinationSchema,
+	},
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const client = await createWebhookAPIClient(ctx);
+
+		const destination = await createWebhookDestination(
+			client,
+			args.webhook_id,
+			{
+				type: 'url',
+				config: { url: args.url },
+			},
+			getWebhookApiOptions(ctx)
+		);
+
+		if (!options.json) {
+			tui.success(`Created destination: ${destination.id}`);
+			console.log(`  URL: ${args.url}`);
+		}
+
+		return destination;
+	},
+});
+
+const createDestinationSubcommand = createCommand({
+	name: 'create',
+	description: 'Create a destination for a webhook',
+	tags: ['mutating', 'creates-resource', 'requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand(
+				'cloud webhook destinations create url wh_abc123 --url https://example.com/webhook'
+			),
+			description: 'Create a URL destination',
+		},
+	],
+	subcommands: [createUrlDestinationSubcommand],
+});
+
+const updateDestinationSubcommand = createSubcommand({
+	name: 'update',
+	description: 'Update a webhook destination',
+	tags: ['mutating', 'requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand(
+				'cloud webhook destinations update wh_abc123 whds_def456 --url https://example.com/v2'
+			),
+			description: 'Update a destination URL',
+		},
+	],
+	schema: {
+		args: z.object({
+			webhook_id: z.string().min(1).describe('Webhook ID'),
+			destination_id: z.string().min(1).describe('Destination ID'),
+		}),
+		options: z.object({
+			url: z.string().optional().describe('Updated destination URL'),
+		}),
+		response: WebhookDestinationSchema,
+	},
+
+	async handler(ctx) {
+		const { args, opts, options } = ctx;
+		const client = await createWebhookAPIClient(ctx);
+
+		const updateParams: { config?: Record<string, unknown> } = {};
+
+		if (opts.url) {
+			updateParams.config = { url: opts.url };
+		}
+
+		const destination = await updateWebhookDestination(
+			client,
+			args.webhook_id,
+			args.destination_id,
+			updateParams,
+			getWebhookApiOptions(ctx)
+		);
+
+		if (!options.json) {
+			tui.success(`Updated destination: ${destination.id}`);
+			console.log(`  URL: ${JSON.stringify(destination.config)}`);
+		}
+
+		return destination;
+	},
+});
+
+const DeleteDestinationResponseSchema = z.object({
+	success: z.boolean(),
+	webhook_id: z.string(),
+	destination_id: z.string(),
+});
+
+const deleteDestinationSubcommand = createSubcommand({
+	name: 'delete',
+	aliases: ['rm'],
+	description: 'Delete a destination from a webhook',
+	tags: ['mutating', 'deletes-resource', 'requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud webhook destinations delete wh_abc123 whds_def456 --confirm'),
+			description: 'Delete a destination',
+		},
+	],
+	schema: {
+		args: z.object({
+			webhook_id: z.string().min(1).describe('Webhook ID'),
+			destination_id: z.string().min(1).describe('Destination ID'),
+		}),
+		options: z.object({
+			confirm: z.boolean().default(false).describe('Skip confirmation prompt'),
+		}),
+		response: DeleteDestinationResponseSchema,
+	},
+
+	async handler(ctx) {
+		const { args, opts, options } = ctx;
+
+		if (!opts.confirm) {
+			tui.fatal('Use --confirm to confirm destination deletion', ErrorCode.INVALID_ARGUMENT);
+		}
+
+		const client = await createWebhookAPIClient(ctx);
+		await deleteWebhookDestination(
+			client,
+			args.webhook_id,
+			args.destination_id,
+			getWebhookApiOptions(ctx)
+		);
+
+		if (!options.json) {
+			tui.success(`Deleted destination: ${args.destination_id}`);
+		}
+
+		return {
+			success: true,
+			webhook_id: args.webhook_id,
+			destination_id: args.destination_id,
+		};
+	},
+});
+
+export const destinationsSubcommand = createCommand({
+	name: 'destinations',
+	aliases: ['dest'],
+	description: 'Manage webhook destinations',
+	tags: ['requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud webhook destinations list wh_abc123'),
+			description: 'List destinations',
+		},
+		{
+			command: getCommand(
+				'cloud webhook destinations create url wh_abc123 --url https://example.com/webhook'
+			),
+			description: 'Create a URL destination',
+		},
+	],
+	subcommands: [
+		listDestinationsSubcommand,
+		createDestinationSubcommand,
+		updateDestinationSubcommand,
+		deleteDestinationSubcommand,
+	],
+});
+
+export default destinationsSubcommand;

package/src/cmd/cloud/webhook/get.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createWebhookAPIClient, getWebhookApiOptions } from './util';
+import { getCommand } from '../../../command-prefix';
+import { getWebhook, WebhookSchema } from '@agentuity/server';
+
+export const getSubcommand = createCommand({
+	name: 'get',
+	description: 'Get webhook details',
+	tags: ['read-only', 'fast', 'requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud webhook get wh_abc123'),
+			description: 'Get webhook details',
+		},
+	],
+	schema: {
+		args: z.object({
+			id: z.string().min(1).describe('Webhook ID'),
+		}),
+		response: WebhookSchema,
+	},
+	idempotent: true,
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const client = await createWebhookAPIClient(ctx);
+		const apiOptions = getWebhookApiOptions(ctx);
+
+		const webhook = await getWebhook(client, args.id, apiOptions);
+
+		if (!options.json) {
+			const details: Record<string, unknown> = {
+				Name: webhook.name,
+				ID: webhook.id,
+			};
+
+			if (webhook.description) {
+				details.Description = webhook.description;
+			}
+
+			if (webhook.url) {
+				details.URL = webhook.url;
+			}
+
+			details['Created By'] = webhook.created_by;
+			details.Created = new Date(webhook.created_at).toISOString();
+			details.Updated = new Date(webhook.updated_at).toISOString();
+
+			tui.table([details], undefined, { layout: 'vertical' });
+		}
+
+		return webhook;
+	},
+});
+
+export default getSubcommand;

package/src/cmd/cloud/webhook/index.ts

@@ -0,0 +1,46 @@
+import { createCommand } from '../../../types';
+import { listSubcommand } from './list';
+import { createSubcommand } from './create';
+import { getSubcommand } from './get';
+import { deleteSubcommand } from './delete';
+import { destinationsSubcommand } from './destinations';
+import { receiptsSubcommand } from './receipts';
+import { deliveriesSubcommand } from './deliveries';
+import { getCommand } from '../../../command-prefix';
+
+export const command = createCommand({
+	name: 'webhook',
+	aliases: ['webhooks'],
+	description: 'Manage webhooks for receiving external HTTP callbacks',
+	tags: ['requires-auth'],
+	examples: [
+		{
+			command: getCommand('cloud webhook list'),
+			description: 'List all webhooks',
+		},
+		{
+			command: getCommand('cloud webhook create --name my-webhook'),
+			description: 'Create a webhook',
+		},
+		{
+			command: getCommand('cloud webhook get wh_abc123'),
+			description: 'Get webhook details',
+		},
+		{
+			command: getCommand('cloud webhook destinations list wh_abc123'),
+			description: 'List webhook destinations',
+		},
+	],
+	subcommands: [
+		listSubcommand,
+		createSubcommand,
+		getSubcommand,
+		deleteSubcommand,
+		destinationsSubcommand,
+		receiptsSubcommand,
+		deliveriesSubcommand,
+	],
+	requires: { auth: true },
+});
+
+export default command;

package/src/cmd/cloud/webhook/list.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createWebhookAPIClient, getWebhookApiOptions } from './util';
+import { getCommand } from '../../../command-prefix';
+import { listWebhooks, type Webhook } from '@agentuity/server';
+
+const WebhookListResponseSchema = z.object({
+	webhooks: z.array(
+		z.object({
+			name: z.string(),
+			id: z.string(),
+			description: z.string().nullable().optional(),
+			created_at: z.string(),
+		})
+	),
+});
+
+export const listSubcommand = createCommand({
+	name: 'list',
+	aliases: ['ls'],
+	description: 'List all webhooks',
+	tags: ['read-only', 'fast', 'requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{ command: getCommand('cloud webhook list'), description: 'List all webhooks' },
+		{ command: getCommand('cloud webhook ls'), description: 'List all webhooks (alias)' },
+	],
+	schema: {
+		args: z.object({}),
+		options: z.object({
+			orgId: z.string().optional().describe('Filter by organization ID'),
+			limit: z.coerce
+				.number()
+				.min(0)
+				.optional()
+				.describe('Maximum number of webhooks to return'),
+			offset: z.coerce.number().min(0).optional().describe('Offset for pagination'),
+		}),
+		response: WebhookListResponseSchema,
+	},
+	idempotent: true,
+
+	async handler(ctx) {
+		const { options, opts } = ctx;
+		const client = await createWebhookAPIClient(ctx);
+		const webhookOptions = opts?.orgId ? { orgId: opts.orgId } : getWebhookApiOptions(ctx);
+		const result = await listWebhooks(
+			client,
+			{
+				limit: opts.limit,
+				offset: opts.offset,
+			},
+			webhookOptions
+		);
+
+		if (!options.json) {
+			if (result.webhooks.length === 0) {
+				tui.info('No webhooks found');
+			} else {
+				const tableData = result.webhooks.map((w: Webhook) => ({
+					Name: w.name,
+					ID: w.id,
+					Description: w.description ?? '-',
+					Created: new Date(w.created_at).toLocaleString(),
+				}));
+				tui.table(tableData, ['Name', 'ID', 'Description', 'Created']);
+			}
+		}
+
+		return {
+			webhooks: result.webhooks.map((w: Webhook) => ({
+				name: w.name,
+				id: w.id,
+				description: w.description,
+				created_at: w.created_at,
+			})),
+		};
+	},
+});
+
+export default listSubcommand;

package/src/cmd/cloud/webhook/receipts.ts

@@ -0,0 +1,157 @@
+import { z } from 'zod';
+import { createCommand, createSubcommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createWebhookAPIClient, getWebhookApiOptions } from './util';
+import { getCommand } from '../../../command-prefix';
+import {
+	listWebhookReceipts,
+	getWebhookReceipt,
+	WebhookReceiptSchema,
+	type WebhookReceipt,
+} from '@agentuity/server';
+
+const ReceiptsListResponseSchema = z.object({
+	receipts: z.array(
+		z.object({
+			id: z.string(),
+			date: z.string(),
+			webhook_id: z.string(),
+		})
+	),
+});
+
+const listReceiptsSubcommand = createSubcommand({
+	name: 'list',
+	aliases: ['ls'],
+	description: 'List receipts for a webhook',
+	tags: ['read-only', 'fast', 'requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud webhook receipts list wh_abc123'),
+			description: 'List webhook receipts',
+		},
+	],
+	schema: {
+		args: z.object({
+			webhook_id: z.string().min(1).describe('Webhook ID'),
+		}),
+		options: z.object({
+			limit: z.coerce
+				.number()
+				.min(0)
+				.optional()
+				.describe('Maximum number of receipts to return'),
+			offset: z.coerce.number().min(0).optional().describe('Offset for pagination'),
+		}),
+		response: ReceiptsListResponseSchema,
+	},
+	idempotent: true,
+
+	async handler(ctx) {
+		const { args, opts, options } = ctx;
+		const client = await createWebhookAPIClient(ctx);
+		const result = await listWebhookReceipts(
+			client,
+			args.webhook_id,
+			{
+				limit: opts.limit,
+				offset: opts.offset,
+			},
+			getWebhookApiOptions(ctx)
+		);
+
+		if (!options.json) {
+			if (result.receipts.length === 0) {
+				tui.info('No receipts found');
+			} else {
+				const tableData = result.receipts.map((r: WebhookReceipt) => ({
+					ID: r.id,
+					Date: new Date(r.date).toLocaleString(),
+					'Webhook ID': r.webhook_id,
+				}));
+				tui.table(tableData, ['ID', 'Date', 'Webhook ID']);
+			}
+		}
+
+		return {
+			receipts: result.receipts.map((r: WebhookReceipt) => ({
+				id: r.id,
+				date: r.date,
+				webhook_id: r.webhook_id,
+			})),
+		};
+	},
+});
+
+const getReceiptSubcommand = createSubcommand({
+	name: 'get',
+	description: 'Get receipt details',
+	tags: ['read-only', 'fast', 'requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud webhook receipts get wh_abc123 whrc_def456'),
+			description: 'Get receipt details',
+		},
+	],
+	schema: {
+		args: z.object({
+			webhook_id: z.string().min(1).describe('Webhook ID'),
+			receipt_id: z.string().min(1).describe('Receipt ID'),
+		}),
+		response: WebhookReceiptSchema,
+	},
+	idempotent: true,
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const client = await createWebhookAPIClient(ctx);
+		const receipt = await getWebhookReceipt(
+			client,
+			args.webhook_id,
+			args.receipt_id,
+			getWebhookApiOptions(ctx)
+		);
+
+		if (!options.json) {
+			const details: Record<string, unknown> = {
+				ID: receipt.id,
+				Date: new Date(receipt.date).toLocaleString(),
+				'Webhook ID': receipt.webhook_id,
+			};
+
+			tui.table([details], undefined, { layout: 'vertical' });
+
+			tui.newline();
+			tui.info('Headers');
+			tui.json(receipt.headers);
+
+			tui.newline();
+			tui.info('Payload');
+			tui.json(receipt.payload);
+		}
+
+		return receipt;
+	},
+});
+
+export const receiptsSubcommand = createCommand({
+	name: 'receipts',
+	description: 'Manage webhook receipts',
+	tags: ['requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud webhook receipts list wh_abc123'),
+			description: 'List receipts',
+		},
+		{
+			command: getCommand('cloud webhook receipts get wh_abc123 whrc_def456'),
+			description: 'Get receipt details',
+		},
+	],
+	subcommands: [listReceiptsSubcommand, getReceiptSubcommand],
+});
+
+export default receiptsSubcommand;

package/src/cmd/cloud/webhook/util.ts

@@ -0,0 +1,35 @@
+import type { Logger } from '@agentuity/core';
+import { APIClient, type WebhookApiOptions } from '@agentuity/server';
+import { getGlobalCatalystAPIClient } from '../../../config';
+import type { AuthData, Config, GlobalOptions } from '../../../types';
+
+/**
+ * Context required for webhook API operations.
+ */
+export interface WebhookContext {
+	logger: Logger;
+	auth: AuthData;
+	config: Config | null;
+	options: GlobalOptions;
+	orgId?: string;
+}
+
+/**
+ * Creates an API client for webhook operations.
+ *
+ * Webhooks are global resources that don't require a project context.
+ * Uses the global Catalyst API client with user authentication.
+ */
+export async function createWebhookAPIClient(ctx: WebhookContext): Promise<APIClient> {
+	return getGlobalCatalystAPIClient(ctx.logger, ctx.auth, ctx.config?.name);
+}
+
+/**
+ * Creates WebhookApiOptions from the CLI context.
+ * Prioritizes explicit orgId on context, then falls back to global --org-id option,
+ * and finally to the preferred org from the profile configuration.
+ */
+export function getWebhookApiOptions(ctx: WebhookContext): WebhookApiOptions | undefined {
+	const orgId = ctx.orgId ?? ctx.options.orgId ?? ctx.config?.preferences?.orgId;
+	return orgId ? { orgId } : undefined;
+}

package/src/cmd/project/add/domain.ts

@@ -95,7 +95,7 @@ export const domainSubcommand = createSubcommand({
 				message: `Checking DNS for ${domain}`,
 				clearOnSuccess: true,
 				callback: async () => {
-					return checkCustomDomainForDNS(project.projectId, [domain], config);
+					return checkCustomDomainForDNS(project.projectId, [domain], project.region, config);
 				},
 			});
 
@@ -117,11 +117,17 @@ export const domainSubcommand = createSubcommand({
 				}
 
 				tui.newline();
-				tui.warning('DNS record not yet configured. Please add the following CNAME record:');
+				tui.warning(
+					'DNS record not yet configured. Please add one of the following DNS records:'
+				);
 				tui.newline();
 				tui.output(`  ${tui.colorInfo('Domain:')}  ${tui.colorPrimary(result.domain)}`);
-				tui.output(`  ${tui.colorInfo('Type:')}    ${tui.colorPrimary(result.recordType)}`);
-				tui.output(`  ${tui.colorInfo('Target:')}  ${tui.colorPrimary(result.target)}`);
+				tui.output(`  ${tui.colorInfo('CNAME:')}   ${tui.colorPrimary(result.target)}`);
+				if (result.aRecordTarget) {
+					tui.output(
+						`  ${tui.colorInfo('A:')}       ${tui.colorPrimary(result.aRecordTarget)}`
+					);
+				}
 				tui.newline();
 
 				if (isMisconfigured(result)) {