@agentuity/cli 1.0.22 → 1.0.23

package/src/cmd/cloud/schedule/destination/create.ts

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createScheduleAdapter } from '../util';
+import { getCommand } from '../../../../command-prefix';
+
+const CreateDestinationResponseSchema = z.object({
+	destination: z.object({
+		id: z.string(),
+		schedule_id: z.string(),
+		created_at: z.string(),
+		updated_at: z.string(),
+		created_by: z.string(),
+		type: z.enum(['url', 'sandbox']),
+		config: z.record(z.string(), z.unknown()),
+	}),
+});
+
+export const createSubcommand = createCommand({
+	name: 'create',
+	description: 'Create destination for a schedule',
+	tags: ['mutating', 'creates-resource', 'requires-auth'],
+	requires: { auth: true, region: true },
+	optional: { project: true },
+	examples: [
+		{
+			command: getCommand('cloud schedule destination create url sched_abc123 https://example.com'),
+			description: 'Create URL destination',
+		},
+		{
+			command: getCommand('cloud schedule destination create url sched_abc123 https://example.com --method POST'),
+			description: 'Create URL destination with POST method',
+		},
+	],
+	schema: {
+		args: z.object({
+			type: z.enum(['url', 'sandbox']).describe('Destination type (url or sandbox)'),
+			schedule_id: z.string().min(1).describe('Schedule ID'),
+			target: z.string().min(1).describe('Destination URL or sandbox ID'),
+		}),
+		options: z.object({
+			method: z.string().optional().describe('HTTP method for URL destination'),
+			timeout: z.coerce.number().optional().describe('Request timeout in milliseconds'),
+			config: z.string().optional().describe('Additional config as JSON object'),
+		}),
+		response: CreateDestinationResponseSchema,
+	},
+
+	async handler(ctx) {
+		const { args, opts, options } = ctx;
+		const schedule = createScheduleAdapter(ctx);
+
+		if (args.type === 'sandbox' && !args.target.startsWith('sbx_')) {
+			tui.fatal('Sandbox target must start with "sbx_"');
+		}
+		if (args.type === 'url' && !args.target.startsWith('http://') && !args.target.startsWith('https://')) {
+			tui.fatal('URL target must start with http:// or https://');
+		}
+
+		let parsedConfig: Record<string, unknown> = {};
+		if (opts.config) {
+			try {
+				parsedConfig = JSON.parse(opts.config) as Record<string, unknown>;
+			} catch (e) {
+				tui.fatal(`Invalid JSON in --config: ${e instanceof Error ? e.message : String(e)}`);
+			}
+		}
+
+		const config: Record<string, unknown> = {
+			...parsedConfig,
+		};
+
+		if (args.type === 'url') {
+			config.url = args.target;
+		}
+		if (args.type === 'sandbox') {
+			config.sandbox_id = args.target;
+		}
+		if (opts.method && args.type === 'url') {
+			config.method = opts.method;
+		}
+		if (opts.timeout !== undefined && args.type === 'url') {
+			config.timeout = opts.timeout;
+		}
+
+		const result = await schedule.createDestination(args.schedule_id, {
+			type: args.type,
+			config,
+		});
+
+		if (!options.json) {
+			tui.success(`Created destination: ${result.destination.id}`);
+			tui.table(
+				[
+					{
+						ID: result.destination.id,
+						Type: result.destination.type,
+						Config: JSON.stringify(result.destination.config),
+					},
+				],
+				undefined,
+				{ layout: 'vertical' }
+			);
+		}
+
+		return result;
+	},
+});
+
+export default createSubcommand;

package/src/cmd/cloud/schedule/destination/delete.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createScheduleAdapter } from '../util';
+import { getCommand } from '../../../../command-prefix';
+
+const DestinationDeleteResponseSchema = z.object({
+	success: z.boolean(),
+	destination_id: z.string(),
+});
+
+export const deleteSubcommand = createCommand({
+	name: 'delete',
+	aliases: ['rm'],
+	description: 'Delete a destination',
+	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
+	requires: { auth: true, region: true },
+	optional: { project: true },
+	idempotent: true,
+	examples: [
+		{
+			command: getCommand('cloud schedule destination delete sdest_abc456'),
+			description: 'Delete destination',
+		},
+	],
+	schema: {
+		args: z.object({
+			destination_id: z.string().min(1).describe('Destination ID'),
+		}),
+		response: DestinationDeleteResponseSchema,
+	},
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const schedule = createScheduleAdapter(ctx);
+		await schedule.deleteDestination(args.destination_id);
+
+		if (!options.json) {
+			tui.success(`Deleted destination: ${args.destination_id}`);
+		}
+
+		return { success: true, destination_id: args.destination_id };
+	},
+});
+
+export default deleteSubcommand;

package/src/cmd/cloud/schedule/destination/get.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createScheduleAdapter } from '../util';
+import { getCommand } from '../../../../command-prefix';
+
+const DestinationGetResponseSchema = z.object({
+	destination: z.object({
+		id: z.string(),
+		schedule_id: z.string(),
+		created_at: z.string(),
+		updated_at: z.string(),
+		created_by: z.string(),
+		type: z.enum(['url', 'sandbox']),
+		config: z.record(z.string(), z.unknown()),
+	}),
+});
+
+export const getSubcommand = createCommand({
+	name: 'get',
+	description: 'Get destination details',
+	tags: ['read-only', 'fast', 'requires-auth'],
+	requires: { auth: true, region: true },
+	optional: { project: true },
+	idempotent: true,
+	examples: [
+		{
+			command: getCommand('cloud schedule destination get sched_abc123 sdest_abc456'),
+			description: 'Get destination details',
+		},
+	],
+	schema: {
+		args: z.object({
+			schedule_id: z.string().min(1).describe('Schedule ID'),
+			destination_id: z.string().min(1).describe('Destination ID'),
+		}),
+		response: DestinationGetResponseSchema,
+	},
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const schedule = createScheduleAdapter(ctx);
+		const destination = await schedule.getDestination(args.schedule_id, args.destination_id);
+
+		if (!options.json) {
+			tui.table(
+				[
+					{
+						ID: destination.id,
+						'Schedule ID': destination.schedule_id,
+						Type: destination.type,
+						Config: JSON.stringify(destination.config),
+						Created: new Date(destination.created_at).toLocaleString(),
+						Updated: new Date(destination.updated_at).toLocaleString(),
+					},
+				],
+				undefined,
+				{ layout: 'vertical' }
+			);
+		}
+
+		return { destination };
+	},
+});
+
+export default getSubcommand;

package/src/cmd/cloud/schedule/destination/index.ts

@@ -0,0 +1,27 @@
+import { createCommand } from '../../../../types';
+import { createSubcommand } from './create';
+import { listSubcommand } from './list';
+import { getSubcommand } from './get';
+import { deleteSubcommand } from './delete';
+import { getCommand } from '../../../../command-prefix';
+
+export const command = createCommand({
+	name: 'destination',
+	aliases: ['dest'],
+	description: 'Manage schedule destinations',
+	tags: ['requires-auth'],
+	requires: { auth: true },
+	subcommands: [createSubcommand, listSubcommand, getSubcommand, deleteSubcommand],
+	examples: [
+		{
+			command: getCommand('cloud schedule destination list sched_abc123'),
+			description: 'List destinations',
+		},
+		{
+			command: getCommand('cloud schedule destination create url sched_abc123 https://example.com'),
+			description: 'Create URL destination',
+		},
+	],
+});
+
+export default command;

package/src/cmd/cloud/schedule/destination/list.ts

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+import { createCommand } from '../../../../types';
+import * as tui from '../../../../tui';
+import { createScheduleAdapter } from '../util';
+import { getCommand } from '../../../../command-prefix';
+
+const DestinationListResponseSchema = z.object({
+	destinations: z.array(
+		z.object({
+			id: z.string(),
+			schedule_id: z.string(),
+			created_at: z.string(),
+			updated_at: z.string(),
+			created_by: z.string(),
+			type: z.enum(['url', 'sandbox']),
+			config: z.record(z.string(), z.unknown()),
+		})
+	),
+});
+
+export const listSubcommand = createCommand({
+	name: 'list',
+	aliases: ['ls'],
+	description: 'List destinations for a schedule',
+	tags: ['read-only', 'fast', 'requires-auth'],
+	requires: { auth: true, region: true },
+	optional: { project: true },
+	idempotent: true,
+	examples: [
+		{
+			command: getCommand('cloud schedule destination list sched_abc123'),
+			description: 'List schedule destinations',
+		},
+	],
+	schema: {
+		args: z.object({
+			schedule_id: z.string().min(1).describe('Schedule ID'),
+		}),
+		response: DestinationListResponseSchema,
+	},
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const schedule = createScheduleAdapter(ctx);
+		const result = await schedule.get(args.schedule_id);
+
+		if (!options.json) {
+			if (result.destinations.length === 0) {
+				tui.info('No destinations configured');
+			} else {
+				tui.table(
+					result.destinations.map((destination: {
+						id: string;
+						type: 'url' | 'sandbox';
+						config: Record<string, unknown>;
+						created_at: string;
+					}) => ({
+						ID: destination.id,
+						Type: destination.type,
+						Config: JSON.stringify(destination.config),
+						Created: new Date(destination.created_at).toLocaleString(),
+					})),
+					['ID', 'Type', 'Config', 'Created']
+				);
+			}
+		}
+
+		return { destinations: result.destinations };
+	},
+});
+
+export default listSubcommand;

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

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createScheduleAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+
+const ScheduleGetResponseSchema = z.object({
+	schedule: z.object({
+		id: z.string(),
+		created_at: z.string(),
+		updated_at: z.string(),
+		created_by: z.string(),
+		name: z.string(),
+		description: z.string().nullable(),
+		expression: z.string(),
+		due_date: z.string(),
+	}),
+	destinations: z.array(
+		z.object({
+			id: z.string(),
+			schedule_id: z.string(),
+			created_at: z.string(),
+			updated_at: z.string(),
+			created_by: z.string(),
+			type: z.enum(['url', 'sandbox']),
+			config: z.record(z.string(), z.unknown()),
+		})
+	),
+});
+
+export const getSubcommand = createCommand({
+	name: 'get',
+	description: 'Get schedule details',
+	tags: ['read-only', 'fast', 'requires-auth'],
+	requires: { auth: true, region: true },
+	optional: { project: true },
+	idempotent: true,
+		examples: [
+			{ command: getCommand('cloud schedule get sched_abc123'), description: 'Get schedule details' },
+		],
+	schema: {
+		args: z.object({
+			schedule_id: z.string().min(1).describe('Schedule ID'),
+		}),
+		response: ScheduleGetResponseSchema,
+	},
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const schedule = createScheduleAdapter(ctx);
+		const result = await schedule.get(args.schedule_id);
+
+		if (!options.json) {
+			const details: Record<string, unknown> = {
+				Name: result.schedule.name,
+				ID: result.schedule.id,
+				Expression: result.schedule.expression,
+				Description: result.schedule.description ?? '-',
+				'Next Due': result.schedule.due_date,
+				Created: new Date(result.schedule.created_at).toLocaleString(),
+				Updated: new Date(result.schedule.updated_at).toLocaleString(),
+			};
+
+			tui.table([details], undefined, { layout: 'vertical', padStart: '  ' });
+
+			tui.newline();
+			tui.info('Destinations');
+			if (result.destinations.length === 0) {
+				tui.info('No destinations configured');
+			} else {
+				tui.table(
+					result.destinations.map((destination: {
+						id: string;
+						type: 'url' | 'sandbox';
+						config: Record<string, unknown>;
+						created_at: string;
+					}) => ({
+						ID: destination.id,
+						Type: destination.type,
+						Config: JSON.stringify(destination.config),
+						Created: new Date(destination.created_at).toLocaleString(),
+					})),
+					['ID', 'Type', 'Config', 'Created']
+				);
+			}
+		}
+
+		return result;
+	},
+});
+
+export default getSubcommand;

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

@@ -0,0 +1,36 @@
+import { createCommand } from '../../../types';
+import { listSubcommand } from './list';
+import { createSubcommand } from './create';
+import { getSubcommand } from './get';
+import { deleteSubcommand } from './delete';
+import { updateSubcommand } from './update';
+import destinationSubcommand from './destination';
+import deliverySubcommand from './delivery';
+import { getCommand } from '../../../command-prefix';
+
+export const command = createCommand({
+	name: 'schedule',
+	aliases: ['schedules', 'sched'],
+	description: 'Manage scheduled tasks',
+	tags: ['requires-auth'],
+	requires: { auth: true },
+	subcommands: [
+		listSubcommand,
+		createSubcommand,
+		getSubcommand,
+		deleteSubcommand,
+		updateSubcommand,
+		destinationSubcommand,
+		deliverySubcommand,
+	],
+	examples: [
+		{ command: getCommand('cloud schedule list'), description: 'List schedules' },
+		{
+			command: getCommand("cloud schedule create --name nightly --expression '0 0 * * *'"),
+			description: 'Create a schedule',
+		},
+		{ command: getCommand('cloud schedule get sched_abc123'), description: 'Get schedule details' },
+	],
+});
+
+export default command;

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

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createScheduleAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+
+const ScheduleListResponseSchema = z.object({
+	schedules: z.array(
+		z.object({
+			id: z.string(),
+			created_at: z.string(),
+			updated_at: z.string(),
+			created_by: z.string(),
+			name: z.string(),
+			description: z.string().nullable(),
+			expression: z.string(),
+			due_date: z.string(),
+		})
+	),
+	total: z.number(),
+});
+
+export const listSubcommand = createCommand({
+	name: 'list',
+	aliases: ['ls'],
+	description: 'List schedules',
+	tags: ['read-only', 'fast', 'requires-auth'],
+	requires: { auth: true, region: true },
+	optional: { project: true },
+	idempotent: true,
+	examples: [
+		{ command: getCommand('cloud schedule list'), description: 'List schedules' },
+		{ command: getCommand('cloud schedule list --limit 20'), description: 'List 20 schedules' },
+	],
+	schema: {
+		options: z.object({
+			limit: z.coerce.number().min(0).optional().describe('Maximum number of schedules'),
+			offset: z.coerce.number().min(0).optional().describe('Pagination offset'),
+		}),
+		response: ScheduleListResponseSchema,
+	},
+
+	async handler(ctx) {
+		const { opts, options } = ctx;
+		const schedule = createScheduleAdapter(ctx);
+		const result = await schedule.list({ limit: opts.limit, offset: opts.offset });
+
+		if (!options.json) {
+			if (result.schedules.length === 0) {
+				tui.info('No schedules found');
+			} else {
+				tui.table(
+					result.schedules.map((item: {
+						id: string;
+						created_at: string;
+						updated_at: string;
+						created_by: string;
+						name: string;
+						description: string | null;
+						expression: string;
+						due_date: string;
+					}) => ({
+						Name: item.name,
+						ID: item.id,
+						Expression: item.expression,
+						'Next Due': item.due_date,
+						Created: new Date(item.created_at).toLocaleString(),
+					})),
+					['Name', 'ID', 'Expression', 'Next Due', 'Created']
+				);
+			}
+		}
+
+		return result;
+	},
+});
+
+export default listSubcommand;

package/src/cmd/cloud/schedule/update.ts

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createScheduleAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+
+const ScheduleUpdateResponseSchema = z.object({
+	schedule: z.object({
+		id: z.string(),
+		created_at: z.string(),
+		updated_at: z.string(),
+		created_by: z.string(),
+		name: z.string(),
+		description: z.string().nullable(),
+		expression: z.string(),
+		due_date: z.string(),
+	}),
+});
+
+export const updateSubcommand = createCommand({
+	name: 'update',
+	description: 'Update a schedule',
+	tags: ['mutating', 'requires-auth'],
+	requires: { auth: true, region: true },
+	optional: { project: true },
+	examples: [
+		{
+			command: getCommand("cloud schedule update sched_abc123 --expression '*/5 * * * *'"),
+			description: 'Update schedule expression',
+		},
+	],
+	schema: {
+		args: z.object({
+			schedule_id: z.string().min(1).describe('Schedule ID'),
+		}),
+		options: z.object({
+			name: z.string().optional().describe('Schedule name'),
+			expression: z.string().optional().describe('Cron expression'),
+			description: z.string().optional().describe('Schedule description'),
+		}),
+		response: ScheduleUpdateResponseSchema,
+	},
+
+	async handler(ctx) {
+		const { args, opts, options } = ctx;
+		const schedule = createScheduleAdapter(ctx);
+		const result = await schedule.update(args.schedule_id, {
+			name: opts.name,
+			expression: opts.expression,
+			description: opts.description,
+		});
+
+		if (!options.json) {
+			tui.success(`Updated schedule: ${result.schedule.name}`);
+			tui.table(
+				[
+					{
+						Name: result.schedule.name,
+						ID: result.schedule.id,
+						Expression: result.schedule.expression,
+						Description: result.schedule.description ?? '-',
+						Updated: new Date(result.schedule.updated_at).toLocaleString(),
+					},
+				],
+				undefined,
+				{ layout: 'vertical' }
+			);
+		}
+
+		return result;
+	},
+});
+
+export default updateSubcommand;

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

@@ -0,0 +1,34 @@
+import { ScheduleService, type Logger } from '@agentuity/core';
+import { createServerFetchAdapter } from '@agentuity/server';
+import type { AuthData, Config, GlobalOptions, ProjectConfig } from '../../../types';
+import { getCatalystUrl } from '../../../catalyst';
+import * as tui from '../../../tui';
+
+export function createScheduleAdapter(
+	ctx: {
+		logger: Logger;
+		auth: AuthData;
+		region: string;
+		project?: ProjectConfig;
+		config: Config | null;
+		options: GlobalOptions;
+	},
+	explicitOrgId?: string
+) {
+	const orgId =
+		explicitOrgId ??
+		ctx.project?.orgId ??
+		ctx.options.orgId ??
+		(process.env.AGENTUITY_CLOUD_ORG_ID || ctx.config?.preferences?.orgId);
+	if (!orgId) {
+		tui.fatal(
+			'Organization ID is required. Either run from a project directory or use --org-id flag.'
+		);
+	}
+	const adapter = createServerFetchAdapter(
+		{ headers: { Authorization: `Bearer ${ctx.auth.apiKey}`, 'x-agentuity-orgid': orgId } },
+		ctx.logger
+	);
+	const baseUrl = getCatalystUrl(ctx.region);
+	return new ScheduleService(baseUrl, adapter);
+}