@agentuity/server 0.0.41 → 0.0.43

package/dist/logger.js

@@ -0,0 +1,238 @@
+import { format, inspect } from 'node:util';
+const LOG_LEVELS = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+};
+const BOLD = '\x1b[1m';
+const RESET = '\x1b[0m';
+// Helper to convert hex color to ANSI 24-bit color code
+function hexToAnsi(hex) {
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    return `\x1b[38;2;${r};${g};${b}m`;
+}
+function shouldUseColors() {
+    // Check for NO_COLOR environment variable (any non-empty value disables colors)
+    if (process.env.NO_COLOR) {
+        return false;
+    }
+    // Check for TERM=dumb
+    if (process.env.TERM === 'dumb') {
+        return false;
+    }
+    // Check if stdout is a TTY
+    if (process.stdout && typeof process.stdout.isTTY !== 'undefined' && !process.stdout.isTTY) {
+        return false;
+    }
+    return true;
+}
+const USE_COLORS = shouldUseColors();
+function getLogColors(scheme) {
+    if (scheme === 'light') {
+        // Darker, high-contrast colors for light backgrounds
+        return {
+            trace: {
+                level: hexToAnsi('#008B8B') + BOLD, // Dark cyan
+                message: hexToAnsi('#4B4B4B'), // Dark gray
+                timestamp: hexToAnsi('#808080'), // Gray
+            },
+            debug: {
+                level: hexToAnsi('#0000CD') + BOLD, // Medium blue
+                message: hexToAnsi('#006400'), // Dark green
+                timestamp: hexToAnsi('#808080'),
+            },
+            info: {
+                level: hexToAnsi('#FF8C00') + BOLD, // Dark orange
+                message: hexToAnsi('#0066CC') + BOLD, // Strong blue
+                timestamp: hexToAnsi('#808080'),
+            },
+            warn: {
+                level: hexToAnsi('#9400D3') + BOLD, // Dark violet
+                message: hexToAnsi('#8B008B'), // Dark magenta
+                timestamp: hexToAnsi('#808080'),
+            },
+            error: {
+                level: hexToAnsi('#DC143C') + BOLD, // Crimson
+                message: hexToAnsi('#8B0000') + BOLD, // Dark red
+                timestamp: hexToAnsi('#808080'),
+            },
+        };
+    }
+    // Dark mode colors (brighter for dark backgrounds)
+    return {
+        trace: {
+            level: hexToAnsi('#00FFFF') + BOLD, // Cyan
+            message: hexToAnsi('#A0A0A0'), // Light gray
+            timestamp: hexToAnsi('#666666'),
+        },
+        debug: {
+            level: hexToAnsi('#5C9CFF') + BOLD, // Blue
+            message: hexToAnsi('#90EE90'), // Light green
+            timestamp: hexToAnsi('#666666'),
+        },
+        info: {
+            level: hexToAnsi('#FFD700') + BOLD, // Gold/Yellow
+            message: hexToAnsi('#FFFFFF') + BOLD, // White
+            timestamp: hexToAnsi('#666666'),
+        },
+        warn: {
+            level: hexToAnsi('#FF00FF') + BOLD, // Magenta
+            message: hexToAnsi('#FF00FF'), // Magenta
+            timestamp: hexToAnsi('#666666'),
+        },
+        error: {
+            level: hexToAnsi('#FF4444') + BOLD, // Red
+            message: hexToAnsi('#FF4444'), // Red
+            timestamp: hexToAnsi('#666666'),
+        },
+    };
+}
+/**
+ * Console logger implementation
+ */
+export class ConsoleLogger {
+    level;
+    showTimestamp;
+    colorScheme;
+    colors;
+    showPrefix = true;
+    context;
+    constructor(level = 'info', showTimestamp = false, colorScheme = 'dark', context = {}) {
+        this.level = level;
+        this.showTimestamp = showTimestamp;
+        this.colorScheme = colorScheme;
+        this.colors = getLogColors(this.colorScheme);
+        this.context = context;
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+    setTimestamp(enabled) {
+        this.showTimestamp = enabled;
+    }
+    setColorScheme(scheme) {
+        this.colorScheme = scheme;
+        this.colors = getLogColors(this.colorScheme);
+    }
+    setShowPrefix(show) {
+        this.showPrefix = show;
+    }
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.level];
+    }
+    formatMessage(message, args) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const base = format(message, ...args);
+            if (!this.context || Object.keys(this.context).length === 0) {
+                return base;
+            }
+            const ctx = Object.entries(this.context)
+                .map(([k, v]) => `${k}=${typeof v === 'object' ? inspect(v, { depth: 2, maxArrayLength: 50, colors: false }) : String(v)}`)
+                .join(' ');
+            const result = `${base} ${ctx}`;
+            const MAX_LENGTH = 10000;
+            if (result.length > MAX_LENGTH) {
+                return `${result.slice(0, MAX_LENGTH)} …(+${result.length - MAX_LENGTH} chars truncated)`;
+            }
+            return result;
+        }
+        catch {
+            const base = [String(message), ...args.map((a) => String(a))].join(' ');
+            return this.context && Object.keys(this.context).length > 0
+                ? `${base} ${JSON.stringify(this.context)}`
+                : base;
+        }
+    }
+    log(level, message, ...args) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const colors = this.colors[level];
+        const levelText = `[${level.toUpperCase()}]`;
+        const formattedMessage = this.formatMessage(message, args);
+        let output = '';
+        if (USE_COLORS) {
+            if (this.showPrefix) {
+                if (this.showTimestamp) {
+                    const timestamp = new Date().toISOString();
+                    output = `${colors.timestamp}[${timestamp}]${RESET} ${colors.level}${levelText}${RESET} ${colors.message}${formattedMessage}${RESET}`;
+                }
+                else {
+                    output = `${colors.level}${levelText}${RESET} ${colors.message}${formattedMessage}${RESET}`;
+                }
+            }
+            else {
+                // No prefix - just the message with color
+                output = `${colors.message}${formattedMessage}${RESET}`;
+            }
+        }
+        else {
+            // No colors - plain text output
+            if (this.showPrefix) {
+                if (this.showTimestamp) {
+                    const timestamp = new Date().toISOString();
+                    output = `[${timestamp}] ${levelText} ${formattedMessage}`;
+                }
+                else {
+                    output = `${levelText} ${formattedMessage}`;
+                }
+            }
+            else {
+                // No prefix, no colors - just message
+                output = formattedMessage;
+            }
+        }
+        if (level === 'error') {
+            console.error(output);
+        }
+        else if (level === 'warn') {
+            console.warn(output);
+        }
+        else {
+            console.log(output);
+        }
+    }
+    trace(message, ...args) {
+        this.log('trace', message, ...args);
+    }
+    debug(message, ...args) {
+        this.log('debug', message, ...args);
+    }
+    info(message, ...args) {
+        this.log('info', message, ...args);
+    }
+    warn(message, ...args) {
+        this.log('warn', message, ...args);
+    }
+    error(message, ...args) {
+        this.log('error', message, ...args);
+    }
+    fatal(message, ...args) {
+        this.log('error', message, ...args);
+        process.exit(1);
+    }
+    child(opts) {
+        return new ConsoleLogger(this.level, this.showTimestamp, this.colorScheme, {
+            ...this.context,
+            ...opts,
+        });
+    }
+}
+/**
+ * Create a new console logger instance
+ *
+ * @param level - The minimum log level to display
+ * @param showTimestamp - Whether to show timestamps in log messages
+ * @param colorScheme - The color scheme to use ('light' or 'dark')
+ * @param context - Initial context for the logger
+ * @returns A new ConsoleLogger instance
+ */
+export function createLogger(level = 'info', showTimestamp = false, colorScheme = 'dark', context = {}) {
+    return new ConsoleLogger(level, showTimestamp, colorScheme, context);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/server",
-	"version": "0.0.41",
+	"version": "0.0.43",
 	"type": "module",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",

package/src/api/api.ts

@@ -13,7 +13,11 @@ import { z } from 'zod';
 export interface APIErrorResponse {
 	success: boolean;
 	code?: string;
-	message: string;
+	message?: string;
+	error?: {
+		name?: string;
+		issues?: z.ZodIssue[];
+	};
 	details?: Record<string, unknown>;
 }
 
@@ -189,6 +193,11 @@ export class APIClient {
 				);
 			}
 
+			// Handle Zod validation errors from the API
+			if (errorData?.error?.name === 'ZodError' && errorData.error.issues) {
+				throw new ValidationError('API validation failed', errorData.error.issues);
+			}
+
 			// Throw with message from API if available
 			if (errorData?.message) {
 				throw new APIError(errorData.message, response.status, errorData.code);

package/src/api/index.ts

@@ -1,3 +1,4 @@
 export * from './api';
 export * from './org';
 export * from './project';
+export * from './user';

package/src/api/project/create.ts

@@ -29,7 +29,7 @@ export type CreateProjectResponse = z.infer<typeof CreateProjectResponseSchema>;
  * @param body
  * @returns
  */
-export async function createProject(
+export async function projectCreate(
 	client: APIClient,
 	body: CreateProjectRequest
 ): Promise<Omit<CreateProjectResponse, 'projectKey'>> {

package/src/api/project/delete.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchema } from '../api';
+
+const ProjectDeleteRequestSchema = z.object({ ids: z.array(z.string()) });
+const ProjectDeleteResponseSchema = APIResponseSchema(z.array(z.string()));
+
+type ProjectDeleteRequest = z.infer<typeof ProjectDeleteRequestSchema>;
+type ProjectDeleteResponse = z.infer<typeof ProjectDeleteResponseSchema>;
+
+export async function projectDelete(client: APIClient, ...ids: string[]) {
+	const resp = await client.request<ProjectDeleteResponse, ProjectDeleteRequest>(
+		'DELETE',
+		'/cli/project',
+		ProjectDeleteResponseSchema,
+		{ ids },
+		ProjectDeleteRequestSchema
+	);
+
+	if (resp.data) {
+		return resp.data;
+	}
+
+	throw new Error(resp.message ?? 'failed to delete project');
+}

package/src/api/project/env-delete.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchema } from '../api';
+
+const _ProjectEnvDeleteRequestSchema = z.object({
+	id: z.string().describe('the project id'),
+	env: z.array(z.string()).optional().describe('environment variable keys to delete'),
+	secrets: z.array(z.string()).optional().describe('secret keys to delete'),
+});
+
+const ProjectEnvDeleteResponseSchema = APIResponseSchema(z.object({}));
+
+type ProjectEnvDeleteRequest = z.infer<typeof _ProjectEnvDeleteRequestSchema>;
+type ProjectEnvDeleteResponse = z.infer<typeof ProjectEnvDeleteResponseSchema>;
+
+/**
+ * Delete environment variables and/or secrets from a project.
+ * Provide arrays of keys to delete.
+ */
+export async function projectEnvDelete(
+	client: APIClient,
+	request: ProjectEnvDeleteRequest
+): Promise<void> {
+	const { id, env, secrets } = request;
+
+	const resp = await client.request<ProjectEnvDeleteResponse, Omit<ProjectEnvDeleteRequest, 'id'>>(
+		'DELETE',
+		`/cli/project/${id}/env`,
+		ProjectEnvDeleteResponseSchema,
+		{
+			env,
+			secrets,
+		}
+	);
+
+	if (!resp.success) {
+		throw new Error(resp.message ?? 'failed to delete project env');
+	}
+
+	// Delete operations don't return data, success is sufficient
+}

package/src/api/project/env-update.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchema } from '../api';
+import type { Project } from './get';
+import { projectGet } from './get';
+
+const _ProjectEnvUpdateRequestSchema = z.object({
+	id: z.string().describe('the project id'),
+	env: z.record(z.string(), z.string()).optional().describe('environment variables to set/update'),
+	secrets: z.record(z.string(), z.string()).optional().describe('secrets to set/update'),
+});
+
+const ProjectEnvUpdateResponseSchema = APIResponseSchema(
+	z.object({
+		id: z.string().describe('the project id'),
+		orgId: z.string().describe('the organization id'),
+		api_key: z.string().optional().describe('the SDK api key for the project'),
+		env: z.record(z.string(), z.string()).optional().describe('the environment key/values'),
+		secrets: z.record(z.string(), z.string()).optional().describe('the secrets key/values'),
+	})
+);
+
+type ProjectEnvUpdateRequest = z.infer<typeof _ProjectEnvUpdateRequestSchema>;
+type ProjectEnvUpdateResponse = z.infer<typeof ProjectEnvUpdateResponseSchema>;
+
+/**
+ * Update environment variables and/or secrets for a project.
+ * This will merge the provided env/secrets with existing values.
+ * Keys starting with 'AGENTUITY_' should be filtered out before calling this function.
+ */
+export async function projectEnvUpdate(
+	client: APIClient,
+	request: ProjectEnvUpdateRequest
+): Promise<Project> {
+	const { id, env, secrets } = request;
+
+	const resp = await client.request<ProjectEnvUpdateResponse, Omit<ProjectEnvUpdateRequest, 'id'>>(
+		'PUT',
+		`/cli/project/${id}/env`,
+		ProjectEnvUpdateResponseSchema,
+		{
+			env,
+			secrets,
+		}
+	);
+
+	if (!resp.success) {
+		throw new Error(resp.message ?? 'failed to update project env');
+	}
+
+	if (resp.data) {
+		return resp.data;
+	}
+
+	// If the API didn't return data, fetch the updated project
+	// This handles backends that return success without the full project data
+	return projectGet(client, { id, mask: false });
+}

package/src/api/project/exists.ts

@@ -1,25 +1,6 @@
 import { z } from 'zod';
 import { APIClient, APIResponseSchema, APIError } from '../api';
 
-// func ProjectWithNameExists(ctx context.Context, logger logger.Logger, baseUrl string, token string, orgId string, name string) (bool, error) {
-// 	client := util.NewAPIClient(ctx, logger, baseUrl, token)
-
-// 	var resp Response[bool]
-// 	if err := client.Do("GET", fmt.Sprintf("/cli/project/exists/%s?orgId=%s", url.PathEscape(name), url.PathEscape(orgId)), nil, &resp); err != nil {
-// 		var apiErr *util.APIError
-// 		if errors.As(err, &apiErr) {
-// 			if apiErr.Status == http.StatusConflict {
-// 				return true, nil
-// 			}
-// 			if apiErr.Status == http.StatusUnprocessableEntity {
-// 				return false, apiErr
-// 			}
-// 		}
-// 		return false, fmt.Errorf("error validating project name: %w", err)
-// 	}
-// 	return resp.Data, nil
-// }
-
 const _ProjectExistsRequestSchema = z.object({
 	name: z.string().max(255).min(1).describe('the name of the new project'),
 	organization_id: z
@@ -35,7 +16,7 @@ export type ProjectExistsRequest = z.infer<typeof _ProjectExistsRequestSchema>;
 export type ProjectExistsResponse = z.infer<typeof ProjectExistsResponseSchema>;
 
 /**
- * Create a new Project
+ * Check if a project exists by name within an organization
  *
  * @param client
  * @param body

package/src/api/project/get.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchema } from '../api';
+
+const _ProjectGetRequestSchema = z.object({
+	id: z.string().describe('the project id'),
+	mask: z.boolean().default(true).describe('if the secrets should be returned masked'),
+});
+
+const ProjectGetResponseSchema = APIResponseSchema(
+	z.object({
+		id: z.string().describe('the project id'),
+		orgId: z.string().describe('the organization id'),
+		api_key: z.string().optional().describe('the SDK api key for the project'),
+		env: z.record(z.string(), z.string()).optional().describe('the environment key/values'),
+		secrets: z.record(z.string(), z.string()).optional().describe('the secrets key/values'),
+	})
+);
+
+type ProjectGetRequest = z.infer<typeof _ProjectGetRequestSchema>;
+type ProjectGetResponse = z.infer<typeof ProjectGetResponseSchema>;
+
+export type Project = NonNullable<ProjectGetResponse['data']>;
+
+export async function projectGet(client: APIClient, request: ProjectGetRequest): Promise<Project> {
+	const resp = await client.request<ProjectGetResponse, ProjectGetRequest>(
+		'GET',
+		`/cli/project/${request.id}?mask=${request.mask ?? true}`,
+		ProjectGetResponseSchema
+	);
+
+	if (resp.data) {
+		return resp.data;
+	}
+
+	throw new Error(resp.message ?? 'failed to get project');
+}

package/src/api/project/index.ts

@@ -1,2 +1,7 @@
 export * from './create';
+export * from './delete';
+export * from './env-delete';
+export * from './env-update';
 export * from './exists';
+export * from './get';
+export * from './list';

package/src/api/project/list.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchema } from '../api';
+
+const ProjectListResponseSchema = APIResponseSchema(
+	z.array(
+		z.object({
+			id: z.string().describe('the project id'),
+			name: z.string().describe('the project name'),
+			description: z.string().optional().describe('the project description'),
+			orgId: z.string().describe('the organization id that this project is registered with'),
+			orgName: z.string().describe('the organization name'),
+		})
+	)
+);
+
+export type ProjectListResponse = z.infer<typeof ProjectListResponseSchema>;
+export type ProjectList = NonNullable<ProjectListResponse['data']>;
+
+/**
+ * List all projects
+ *
+ * @param client
+ * @returns
+ */
+export async function projectList(client: APIClient): Promise<ProjectList> {
+	const resp = await client.request<ProjectListResponse>(
+		'GET',
+		'/cli/project',
+		ProjectListResponseSchema
+	);
+
+	if (resp.data) {
+		return resp.data;
+	}
+
+	throw new Error(resp.message ?? 'failed to list projects');
+}

package/src/api/user/index.ts

@@ -0,0 +1 @@
+export * from './whoami';

package/src/api/user/whoami.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { APIResponseSchema, APIClient } from '../api';
+
+const OrganizationSchema = z.object({
+	id: z.string().describe('the unique id for the organization'),
+	name: z.string().describe('the name of the organization'),
+});
+
+const WhoamiResponseSchema = APIResponseSchema(
+	z.object({
+		firstName: z.string().describe('the first name of the user'),
+		lastName: z.string().describe('the last name of the user'),
+		organizations: z
+			.array(OrganizationSchema)
+			.describe('the organizations the user is a member of'),
+	})
+);
+
+export type WhoamiResponse = z.infer<typeof WhoamiResponseSchema>;
+export type User = NonNullable<WhoamiResponse['data']>;
+
+/**
+ * Get the current authenticated user information
+ *
+ * @param client
+ * @returns
+ */
+export async function whoami(client: APIClient): Promise<WhoamiResponse> {
+	return client.request<WhoamiResponse>('GET', '/cli/auth/user', WhoamiResponseSchema);
+}

package/src/index.ts

@@ -1,4 +1,5 @@
 export * from './config';
+export * from './logger';
 export * from './server';
 export * from './api';
 export { z } from 'zod';