@agentuity/cli 0.0.54 → 0.0.56

package/src/config.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { existsSync } from 'node:fs';
+import { existsSync, mkdirSync } from 'node:fs';
 import type { Logger } from '@agentuity/core';
 import {
 	BuildMetadataSchema,
@@ -486,6 +486,7 @@ class ProjectConfigNotFoundExpection extends Error {
 type ProjectConfig = z.infer<typeof ProjectSchema>;
 
 function generateJSON5WithComments(
+	jsonSchema: string,
 	schema: z.ZodObject<z.ZodRawShape>,
 	data: Record<string, unknown>
 ): string {
@@ -493,6 +494,8 @@ function generateJSON5WithComments(
 	const shape = schema.shape;
 	const keys = Object.keys(shape);
 
+	lines.push(`  "$schema": "${jsonSchema}",`);
+
 	for (let i = 0; i < keys.length; i++) {
 		const key = keys[i];
 		const fieldSchema = shape[key] as z.ZodTypeAny;
@@ -551,23 +554,59 @@ export async function loadProjectConfig(
 	return result.data;
 }
 
-type InitialProjectConfig = ProjectConfig & {
-	sdkKey: string;
-};
+export const InitialProjectConfigSchema = z.intersection(
+	ProjectSchema,
+	z.object({
+		sdkKey: z.string().describe('the project specific SDK key'),
+		$schema: z.string().optional(),
+	})
+);
+
+type InitialProjectConfig = z.infer<typeof InitialProjectConfigSchema>;
 
 export async function createProjectConfig(dir: string, config: InitialProjectConfig) {
 	const { sdkKey, ...sanitizedConfig } = config;
 
+	// generate the project config
 	const configPath = join(dir, 'agentuity.json');
-	const json5Content = generateJSON5WithComments(ProjectSchema, sanitizedConfig);
+	const json5Content = generateJSON5WithComments(
+		'https://agentuity.dev/schema/cli/v1/agentuity.json',
+		ProjectSchema,
+		sanitizedConfig
+	);
 	await Bun.write(configPath, json5Content + '\n');
 
+	// generate the .env file with initial secret
 	const envPath = join(dir, '.env');
 	const comment =
 		'# AGENTUITY_SDK_KEY is a sensitive value and should not be committed to version control.';
 	const content = `${comment}\nAGENTUITY_SDK_KEY=${sdkKey}\n`;
 	await Bun.write(envPath, content);
 	await chmod(envPath, 0o600);
+
+	// generate the vscode settings
+	const vscodeDir = join(dir, '.vscode');
+	mkdirSync(vscodeDir);
+
+	const settings = {
+		'files.associations': {
+			'agentuity.json': 'jsonc',
+		},
+		'search.exclude': {
+			'**/.git/**': true,
+			'**/node_modules/**': true,
+			'**/bun.lock': true,
+			'**/.agentuity/**': true,
+		},
+		'json.schemas': [
+			{
+				fileMatch: ['agentuity.json'],
+				url: 'https://agentuity.dev/schema/cli/v1/agentuity.json',
+			},
+		],
+	};
+
+	await Bun.write(join(vscodeDir, 'settings.json'), JSON.stringify(settings, null, 2));
 }
 
 export async function loadBuildMetadata(dir: string): Promise<BuildMetadata> {

package/src/types.ts

@@ -1,9 +1,11 @@
 import type { Logger } from '@agentuity/core';
-import { Deployment } from '@agentuity/server';
+import { Deployment, BuildMetadataSchema as ServerBuildMetadataSchema } from '@agentuity/server';
 import type * as z from 'zod';
 import { z as zod } from 'zod';
 import type { APIClient } from './api';
 
+export { Deployment };
+
 export type { Logger };
 
 export const ConfigSchema = zod.object({
@@ -426,91 +428,10 @@ export type SubcommandDefinition =
 export const ProjectSchema = zod.object({
 	projectId: zod.string().describe('the project id'),
 	orgId: zod.string().describe('the organization id'),
+	region: zod.string().describe('the region identifier that the project is deployed into'),
 	deployment: Deployment.optional().describe('the deployment configuration'),
 });
 
-const FileFields = {
-	filename: zod.string().describe('the relative path for the file'),
-	version: zod.string().describe('the SHA256 content of the file'),
-	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(EvalSchema).optional().describe('the evals for the agent'),
-};
-
-const AgentSchema = zod.object({
-	...BaseAgentFields,
-	subagents: zod.array(zod.object(BaseAgentFields)).optional().describe('subagents of this agent'),
-});
-
-export const BuildMetadataSchema = zod.object({
-	routes: zod.array(
-		zod.object({
-			id: zod.string().describe('the unique calculated id for the route'),
-			filename: zod.string().describe('the relative path for the file'),
-			path: zod.string().describe('the route path'),
-			method: zod.enum(['get', 'post', 'put', 'delete', 'patch']).describe('the HTTP method'),
-			version: zod.string().describe('the SHA256 content of the file'),
-			type: zod.enum(['api', 'sms', 'email', 'cron', 'websocket', 'sse', 'stream']),
-			config: zod
-				.record(zod.string(), zod.unknown())
-				.optional()
-				.describe('type specific configuration'),
-		})
-	),
-	agents: zod.array(AgentSchema),
-	assets: zod.array(
-		zod.object({
-			filename: zod.string().describe('the relative path for the file'),
-			kind: zod.string().describe('the type of asset'),
-			contentType: zod.string().describe('the content-type for the file'),
-			size: zod.number().describe('the size in bytes for the file'),
-		})
-	),
-	project: zod.object({
-		id: zod.string().describe('the project id'),
-		name: zod.string().describe('the name of the project (from package.json)'),
-		version: zod.string().optional().describe('the version of the project (from package.json)'),
-	}),
-	deployment: zod.object({
-		id: zod.string().describe('the deployment id'),
-		date: zod.string().describe('the date the deployment was created in UTC format'),
-		git: zod
-			.object({
-				repo: zod.string().optional().describe('the repository name'),
-				commit: zod.string().optional().describe('the git commit sha'),
-				message: zod.string().optional().describe('the git commit message'),
-				branch: zod.string().optional().describe('the git branch'),
-				tags: zod.array(zod.string()).optional().describe('the tags for the current branch'),
-				pr: zod.string().optional().describe('the pull request number'),
-			})
-			.optional()
-			.describe('git commit information'),
-		build: zod.object({
-			bun: zod.string().describe('the version of bun that was used to build the deployment'),
-			agentuity: zod.string().describe('the version of the agentuity runtime'),
-			arch: zod.string().describe('the machine architecture'),
-			platform: zod.string().describe('the machine os platform'),
-		}),
-	}),
-});
-
+export const BuildMetadataSchema = ServerBuildMetadataSchema;
 export type BuildMetadata = zod.infer<typeof BuildMetadataSchema>;
 export type Project = zod.infer<typeof ProjectSchema>;