@agentuity/cli 0.0.6

package/src/types.ts

@@ -0,0 +1,243 @@
+import type { Logger } from './logger';
+import type * as z from 'zod';
+import { z as zod } from 'zod';
+
+export const ConfigSchema = zod.object({
+	name: zod.string().describe('Profile name'),
+	auth: zod
+		.object({
+			api_key: zod.string().optional().describe('API authentication key'),
+			user_id: zod.string().optional().describe('User ID'),
+			expires: zod.number().optional().describe('Authentication expiration timestamp'),
+		})
+		.optional()
+		.describe('Authentication credentials (managed by login/logout commands)'),
+	devmode: zod
+		.object({
+			hostname: zod.string().optional().describe('Development mode hostname'),
+		})
+		.optional()
+		.describe('Development mode configuration'),
+	overrides: zod
+		.object({
+			api_url: zod
+				.string()
+				.url()
+				.optional()
+				.describe('Override API base URL (default: https://api.agentuity.com)'),
+			app_url: zod
+				.string()
+				.url()
+				.optional()
+				.describe('Override app base URL (default: https://app.agentuity.com)'),
+			transport_url: zod
+				.string()
+				.url()
+				.optional()
+				.describe('Override transport URL (default: https://agentuity.ai)'),
+			websocket_url: zod
+				.string()
+				.url()
+				.optional()
+				.describe('Override WebSocket URL (default: wss://api.agentuity.com)'),
+			skip_version_check: zod.boolean().optional().describe('Skip CLI version check on startup'),
+		})
+		.optional()
+		.describe('URL and behavior overrides'),
+	preferences: zod
+		.object({
+			last_update_check: zod.number().optional().describe('Last update check timestamp'),
+			last_legacy_warning: zod.number().optional().describe('Last legacy CLI warning timestamp'),
+			orgId: zod.string().optional().describe('Default organization ID'),
+			project_dir: zod.string().optional().describe('Last used project directory'),
+		})
+		.optional()
+		.describe('User preferences'),
+});
+
+export type Config = zod.infer<typeof ConfigSchema>;
+
+export type LogLevel = 'debug' | 'trace' | 'info' | 'warn' | 'error';
+
+export interface Profile {
+	name: string;
+	filename: string;
+	selected: boolean;
+}
+
+export interface AuthData {
+	apiKey: string;
+	userId: string;
+	expires: Date;
+}
+
+export interface GlobalOptions {
+	config?: string;
+	logLevel: LogLevel;
+	logTimestamp?: boolean;
+	logPrefix?: boolean;
+}
+
+export interface CommandSchemas {
+	args?: z.ZodType;
+	options?: z.ZodType;
+}
+
+export type CommandContext<
+	RequiresAuth extends boolean = false,
+	ArgsSchema extends z.ZodType | undefined = undefined,
+	OptionsSchema extends z.ZodType | undefined = undefined,
+> = RequiresAuth extends true
+	? ArgsSchema extends z.ZodType
+		? OptionsSchema extends z.ZodType
+			? {
+					config: Config | null;
+					logger: Logger;
+					options: GlobalOptions;
+					auth: AuthData;
+					args: z.infer<ArgsSchema>;
+					opts: z.infer<OptionsSchema>;
+				}
+			: {
+					config: Config | null;
+					logger: Logger;
+					options: GlobalOptions;
+					auth: AuthData;
+					args: z.infer<ArgsSchema>;
+				}
+		: OptionsSchema extends z.ZodType
+			? {
+					config: Config | null;
+					logger: Logger;
+					options: GlobalOptions;
+					auth: AuthData;
+					opts: z.infer<OptionsSchema>;
+				}
+			: {
+					config: Config | null;
+					logger: Logger;
+					options: GlobalOptions;
+					auth: AuthData;
+				}
+	: ArgsSchema extends z.ZodType
+		? OptionsSchema extends z.ZodType
+			? {
+					config: Config | null;
+					logger: Logger;
+					options: GlobalOptions;
+					args: z.infer<ArgsSchema>;
+					opts: z.infer<OptionsSchema>;
+				}
+			: {
+					config: Config | null;
+					logger: Logger;
+					options: GlobalOptions;
+					args: z.infer<ArgsSchema>;
+				}
+		: OptionsSchema extends z.ZodType
+			? {
+					config: Config | null;
+					logger: Logger;
+					options: GlobalOptions;
+					opts: z.infer<OptionsSchema>;
+				}
+			: {
+					config: Config | null;
+					logger: Logger;
+					options: GlobalOptions;
+				};
+
+// Helper to create subcommands with proper type inference
+export function createSubcommand<
+	TRequiresAuth extends boolean,
+	TArgsSchema extends z.ZodType | undefined,
+	TOptionsSchema extends z.ZodType | undefined,
+>(definition: {
+	name: string;
+	description: string;
+	aliases?: string[];
+	toplevel?: boolean;
+	requiresAuth?: TRequiresAuth;
+	schema?: TArgsSchema extends z.ZodType
+		? TOptionsSchema extends z.ZodType
+			? { args: TArgsSchema; options: TOptionsSchema }
+			: { args: TArgsSchema }
+		: TOptionsSchema extends z.ZodType
+			? { options: TOptionsSchema }
+			: never;
+	handler(
+		ctx: CommandContext<TRequiresAuth extends true ? true : false, TArgsSchema, TOptionsSchema>
+	): void | Promise<void>;
+}): SubcommandDefinition {
+	return definition as unknown as SubcommandDefinition;
+}
+
+// Helper to create commands with proper type inference
+export function createCommand<
+	TRequiresAuth extends boolean,
+	TArgsSchema extends z.ZodType | undefined,
+	TOptionsSchema extends z.ZodType | undefined,
+>(definition: {
+	name: string;
+	description: string;
+	aliases?: string[];
+	hidden?: boolean;
+	requiresAuth?: TRequiresAuth;
+	schema?: TArgsSchema extends z.ZodType
+		? TOptionsSchema extends z.ZodType
+			? { args: TArgsSchema; options: TOptionsSchema }
+			: { args: TArgsSchema }
+		: TOptionsSchema extends z.ZodType
+			? { options: TOptionsSchema }
+			: never;
+	handler?(
+		ctx: CommandContext<TRequiresAuth extends true ? true : false, TArgsSchema, TOptionsSchema>
+	): void | Promise<void>;
+	subcommands?: SubcommandDefinition[];
+}): CommandDefinition {
+	return definition as unknown as CommandDefinition;
+}
+
+// Discriminated union for SubcommandDefinition
+export type SubcommandDefinition =
+	| {
+			name: string;
+			description: string;
+			aliases?: string[];
+			toplevel?: boolean;
+			requiresAuth: true;
+			schema?: CommandSchemas;
+			handler(ctx: CommandContext): void | Promise<void>;
+	  }
+	| {
+			name: string;
+			description: string;
+			aliases?: string[];
+			toplevel?: boolean;
+			requiresAuth?: false;
+			schema?: CommandSchemas;
+			handler(ctx: CommandContext): void | Promise<void>;
+	  };
+
+// Discriminated union for CommandDefinition
+export type CommandDefinition =
+	| {
+			name: string;
+			description: string;
+			aliases?: string[];
+			hidden?: boolean;
+			requiresAuth: true;
+			schema?: CommandSchemas;
+			handler?(ctx: CommandContext): void | Promise<void>;
+			subcommands?: SubcommandDefinition[];
+	  }
+	| {
+			name: string;
+			description: string;
+			aliases?: string[];
+			hidden?: boolean;
+			requiresAuth?: false;
+			schema?: CommandSchemas;
+			handler?(ctx: CommandContext): void | Promise<void>;
+			subcommands?: SubcommandDefinition[];
+	  };

package/src/version.ts

@@ -0,0 +1,29 @@
+/**
+ * Centralized version and package information
+ * Loads package.json once and caches it
+ */
+
+import pkg from '../package.json' with { type: 'json' };
+
+// Cache the package data
+let cachedPackage: typeof pkg | null = null;
+
+export function getPackage(): typeof pkg {
+	if (!cachedPackage) {
+		cachedPackage = pkg;
+	}
+	return cachedPackage;
+}
+
+export function getVersion(): string {
+	return getPackage().version || 'dev';
+}
+
+export function getPackageName(): string {
+	return getPackage().name || '@agentuity/cli';
+}
+
+export function getRevision(): string {
+	// Bun provides git SHA via Bun.revision
+	return typeof Bun !== 'undefined' && Bun.revision ? Bun.revision.substring(0, 8) : 'unknown';
+}