@agentuity/cli 0.0.48 → 0.0.50

package/src/types.ts

@@ -104,11 +104,31 @@ export interface GlobalOptions {
 	logTimestamp?: boolean;
 	logPrefix?: boolean;
 	orgId?: string;
+	errorFormat?: 'json' | 'text';
+	json?: boolean;
+	quiet?: boolean;
+	noProgress?: boolean;
+	color?: 'auto' | 'always' | 'never';
+	explain?: boolean;
+	dryRun?: boolean;
+	validate?: boolean;
+}
+
+export interface PaginationInfo {
+	supported: boolean;
+	defaultLimit?: number;
+	maxLimit?: number;
+	parameters?: {
+		limit?: string;
+		offset?: string;
+		cursor?: string;
+	};
 }
 
 export interface CommandSchemas {
 	args?: z.ZodType;
 	options?: z.ZodType;
+	response?: z.ZodType;
 }
 
 export type ProjectConfig = zod.infer<typeof ProjectSchema>;
@@ -240,14 +260,19 @@ export function createSubcommand<
 	toplevel?: boolean;
 	requires?: R;
 	optional?: O;
+	examples?: string[];
+	idempotent?: boolean;
+	prerequisites?: string[];
+	pagination?: PaginationInfo;
+	tags?: string[];
 	schema?: A extends z.ZodType
 		? Op extends z.ZodType
-			? { args: A; options: Op }
-			: { args: A }
+			? { args: A; options: Op; response?: z.ZodType }
+			: { args: A; response?: z.ZodType }
 		: Op extends z.ZodType
-			? { options: Op }
-			: never;
-	handler(ctx: CommandContext<R, O, A, Op>): void | Promise<void>;
+			? { options: Op; response?: z.ZodType }
+			: { response?: z.ZodType };
+	handler(ctx: CommandContext<R, O, A, Op>): unknown | Promise<unknown>;
 }): SubcommandDefinition {
 	return definition as unknown as SubcommandDefinition;
 }
@@ -265,14 +290,19 @@ export function createCommand<
 	hidden?: boolean;
 	requires?: R;
 	optional?: O;
+	examples?: string[];
+	idempotent?: boolean;
+	prerequisites?: string[];
+	pagination?: PaginationInfo;
+	tags?: string[];
 	schema?: A extends z.ZodType
 		? Op extends z.ZodType
-			? { args: A; options: Op }
-			: { args: A }
+			? { args: A; options: Op; response?: z.ZodType }
+			: { args: A; response?: z.ZodType }
 		: Op extends z.ZodType
-			? { options: Op }
-			: never;
-	handler?(ctx: CommandContext<R, O, A, Op>): void | Promise<void>;
+			? { options: Op; response?: z.ZodType }
+			: { response?: z.ZodType };
+	handler?(ctx: CommandContext<R, O, A, Op>): unknown | Promise<unknown>;
 	subcommands?: SubcommandDefinition[];
 }): CommandDefinition {
 	return definition as unknown as CommandDefinition;
@@ -284,8 +314,13 @@ type CommandDefBase =
 			description: string;
 			aliases?: string[];
 			banner?: boolean;
+			examples?: string[];
+			idempotent?: boolean;
+			prerequisites?: string[];
+			pagination?: PaginationInfo;
+			tags?: string[];
 			schema?: CommandSchemas;
-			handler(ctx: CommandContext): void | Promise<void>;
+			handler(ctx: CommandContext): unknown | Promise<unknown>;
 			subcommands?: SubcommandDefinition[];
 	  }
 	| {
@@ -293,6 +328,11 @@ type CommandDefBase =
 			description: string;
 			aliases?: string[];
 			banner?: boolean;
+			examples?: string[];
+			idempotent?: boolean;
+			prerequisites?: string[];
+			pagination?: PaginationInfo;
+			tags?: string[];
 			schema?: CommandSchemas;
 			handler?: undefined;
 			subcommands: SubcommandDefinition[];
@@ -305,8 +345,13 @@ type SubcommandDefBase =
 			aliases?: string[];
 			toplevel?: boolean;
 			banner?: boolean;
+			examples?: string[];
+			idempotent?: boolean;
+			prerequisites?: string[];
+			pagination?: PaginationInfo;
+			tags?: string[];
 			schema?: CommandSchemas;
-			handler(ctx: CommandContext): void | Promise<void>;
+			handler(ctx: CommandContext): unknown | Promise<unknown>;
 			subcommands?: SubcommandDefinition[];
 	  }
 	| {
@@ -315,6 +360,11 @@ type SubcommandDefBase =
 			aliases?: string[];
 			toplevel?: boolean;
 			banner?: boolean;
+			examples?: string[];
+			idempotent?: boolean;
+			prerequisites?: string[];
+			pagination?: PaginationInfo;
+			tags?: string[];
 			schema?: CommandSchemas;
 			handler?: undefined;
 			subcommands: SubcommandDefinition[];
@@ -363,21 +413,24 @@ const FileFields = {
 	identifier: zod.string().describe('the folder for the file'),
 };
 
+const EvalSchema = zod.object({
+	...FileFields,
+	id: zod.string().describe('the unique calculated id for the eval'),
+	evalId: zod.string().describe('the unique id for eval for the project across deployments'),
+	name: zod.string().describe('the name of the eval'),
+	description: zod.string().optional().describe('the eval description'),
+	agentIdentifier: zod.string().describe('the identifier of the agent'),
+	projectId: zod.string().describe('the project id'),
+});
+
 const BaseAgentFields = {
 	...FileFields,
 	id: zod.string().describe('the unique calculated id for the agent'),
+	agentId: zod.string().describe('the unique id for agent for the project across deployments'),
+	projectId: zod.string().describe('the project id'),
 	name: zod.string().describe('the name of the agent'),
 	description: zod.string().optional().describe('the agent description'),
-	evals: zod
-		.array(
-			zod.object({
-				...FileFields,
-				name: zod.string().describe('the name of the eval'),
-				description: zod.string().optional().describe('the eval description'),
-			})
-		)
-		.optional()
-		.describe('the evals for the agent'),
+	evals: zod.array(EvalSchema).optional().describe('the evals for the agent'),
 };
 
 const AgentSchema = zod.object({

package/src/utils/format.ts

@@ -0,0 +1,17 @@
+/**
+ * Abbreviate a string to a maximum length, adding ellipsis if truncated
+ */
+export function abbreviate(str: string | null | undefined, maxLength = 8): string {
+	if (!str) return 'N/A';
+	if (str.length <= maxLength) return str;
+	return str.slice(0, maxLength) + '...';
+}
+
+/**
+ * Abbreviate a description (longer default length)
+ */
+export function abbreviateDescription(str: string | null | undefined, maxLength = 40): string {
+	if (!str) return 'N/A';
+	if (str.length <= maxLength) return str;
+	return str.slice(0, maxLength) + '...';
+}