@base44-preview/cli 0.0.19-pr.124.a7f34a6 → 0.0.21-pr.112.b9c226a

package/dist/index.js

@@ -15,6 +15,8 @@ import { finished } from "node:stream/promises";
 import path$1, { dirname as dirname$1, parse } from "path";
 import EE, { EventEmitter as EventEmitter$1 } from "events";
 import fs$2 from "fs";
+import { getAppClient } from "@core/clients/index.js";
+import { formatApiError } from "@core/errors.js";
 import { Buffer as Buffer$1 } from "buffer";
 import { randomBytes, randomUUID } from "node:crypto";
 import { StringDecoder } from "node:string_decoder";
@@ -23,6 +25,8 @@ import * as realZlib$1 from "zlib";
 import realZlib from "zlib";
 import assert$1 from "node:assert";
 import tty from "node:tty";
+import { fetchAgents, pushAgents, writeAgents } from "@core/resources/agent/index.js";
+import { readProjectConfig } from "@core/index.js";
 import { scheduler, setImmediate as setImmediate$1, setTimeout as setTimeout$1 } from "node:timers/promises";
 import { serialize } from "node:v8";
 import { Buffer as Buffer$2 } from "node:buffer";
@@ -7899,6 +7903,15 @@ var AuthValidationError = class extends Error {
 		this.name = "AuthValidationError";
 	}
 };
+/**
+* Formats an API error response into a human-readable string.
+* Prefers `message` (human-readable) over `detail`.
+*/
+function formatApiError$1(errorJson) {
+	const error = errorJson;
+	const content = error?.message ?? error?.detail ?? errorJson;
+	return typeof content === "string" ? content : JSON.stringify(content, null, 2);
+}
 
 //#endregion
 //#region src/core/consts.ts
@@ -16553,7 +16566,7 @@ async function readAllEntities(entitiesDir) {
 //#endregion
 //#region src/core/resources/entity/api.ts
 async function syncEntities(entities) {
-	const appClient = getAppClient();
+	const appClient = getAppClient$1();
 	const schemaSyncPayload = Object.fromEntries(entities.map((entity) => [entity.name, entity]));
 	const response = await appClient.put("entity-schemas", {
 		json: { entityNameToSchema: schemaSyncPayload },
@@ -16561,8 +16574,8 @@ async function syncEntities(entities) {
 	});
 	if (!response.ok) {
 		const errorJson = await response.json();
-		if (response.status === 428) throw new Error(`Failed to delete entity: ${errorJson.message}`);
-		throw new Error(`Error occurred while syncing entities ${errorJson.message}`);
+		if (response.status === 428) throw new Error(`Failed to delete entity: ${formatApiError$1(errorJson)}`);
+		throw new Error(`Error occurred while syncing entities: ${formatApiError$1(errorJson)}`);
 	}
 	return SyncEntitiesResponseSchema.parse(await response.json());
 }
@@ -16650,7 +16663,7 @@ function toDeployPayloadItem(fn) {
 	};
 }
 async function deployFunctions(functions) {
-	const appClient = getAppClient();
+	const appClient = getAppClient$1();
 	const payload = { functions: functions.map(toDeployPayloadItem) };
 	const response = await appClient.put("backend-functions", {
 		json: payload,
@@ -16684,6 +16697,98 @@ const functionResource = {
 	push: pushFunctions
 };
 
+//#endregion
+//#region src/core/resources/agent/schema.ts
+const EntityToolConfigSchema = object({
+	entity_name: string().min(1),
+	allowed_operations: array(_enum([
+		"read",
+		"create",
+		"update",
+		"delete"
+	])).default([])
+});
+const BackendFunctionToolConfigSchema = object({
+	function_name: string().min(1),
+	description: string().default("agent backend function")
+});
+const ToolConfigSchema = union([EntityToolConfigSchema, BackendFunctionToolConfigSchema]);
+const AgentConfigSchema = object({
+	name: string().regex(/^[a-z0-9_]+$/, "Agent name must be lowercase alphanumeric with underscores").min(1).max(100),
+	description: string().min(1, "Agent description cannot be empty"),
+	instructions: string().min(1, "Agent instructions cannot be empty"),
+	tool_configs: array(ToolConfigSchema).default([]),
+	whatsapp_greeting: string().nullable().optional()
+});
+const SyncAgentsResponseSchema = object({
+	created: array(string()),
+	updated: array(string()),
+	deleted: array(string())
+});
+const AgentConfigApiResponseSchema = object({
+	name: string(),
+	description: string(),
+	instructions: string(),
+	tool_configs: array(ToolConfigSchema).default([]),
+	whatsapp_greeting: string().nullable().optional()
+});
+const ListAgentsResponseSchema = object({
+	items: array(AgentConfigApiResponseSchema),
+	total: number()
+});
+
+//#endregion
+//#region src/core/resources/agent/config.ts
+async function readAgentFile(agentPath) {
+	const parsed = await readJsonFile(agentPath);
+	const result = AgentConfigSchema.safeParse(parsed);
+	if (!result.success) throw new Error(`Invalid agent configuration in ${agentPath}: ${result.error.issues.map((e$1) => e$1.message).join(", ")}`);
+	return result.data;
+}
+async function readAllAgents(agentsDir) {
+	if (!await pathExists(agentsDir)) return [];
+	const files = await globby(`*.${CONFIG_FILE_EXTENSION_GLOB}`, {
+		cwd: agentsDir,
+		absolute: true
+	});
+	const agents = await Promise.all(files.map((filePath) => readAgentFile(filePath)));
+	const names = /* @__PURE__ */ new Set();
+	for (const agent of agents) {
+		if (names.has(agent.name)) throw new Error(`Duplicate agent name "${agent.name}"`);
+		names.add(agent.name);
+	}
+	return agents;
+}
+
+//#endregion
+//#region src/core/resources/agent/api.ts
+async function pushAgents$1(agents) {
+	const appClient = getAppClient();
+	const payload = agents.map((agent) => ({
+		name: agent.name,
+		description: agent.description,
+		instructions: agent.instructions,
+		tool_configs: agent.tool_configs,
+		whatsapp_greeting: agent.whatsapp_greeting ?? null
+	}));
+	const response = await appClient.put("agent-configs", {
+		json: payload,
+		throwHttpErrors: false
+	});
+	if (!response.ok) {
+		const errorJson = await response.json();
+		throw new Error(`Error occurred while syncing agents: ${formatApiError(errorJson)}`);
+	}
+	return SyncAgentsResponseSchema.parse(await response.json());
+}
+
+//#endregion
+//#region src/core/resources/agent/resource.ts
+const agentResource = {
+	readAll: readAllAgents,
+	push: pushAgents$1
+};
+
 //#endregion
 //#region src/core/project/schema.ts
 const TemplateSchema = object({
@@ -16704,7 +16809,8 @@ const ProjectConfigSchema = object({
 	description: string().optional(),
 	site: SiteConfigSchema.optional(),
 	entitiesDir: string().optional().default("entities"),
-	functionsDir: string().optional().default("functions")
+	functionsDir: string().optional().default("functions"),
+	agentsDir: string().optional().default("agents")
 });
 const AppConfigSchema = object({ id: string().min(1, "id cannot be empty") });
 const CreateProjectResponseSchema = looseObject({ id: string() });
@@ -16760,7 +16866,7 @@ async function findProjectRoot(startPath) {
 * @example
 * const { project, entities, functions } = await readProjectConfig();
 */
-async function readProjectConfig(projectRoot) {
+async function readProjectConfig$1(projectRoot) {
 	let found;
 	if (projectRoot) {
 		const configPath$1 = await findConfigInDir(projectRoot);
@@ -16776,7 +16882,11 @@ async function readProjectConfig(projectRoot) {
 	if (!result.success) throw new Error(`Invalid project configuration: ${result.error.message}`);
 	const project = result.data;
 	const configDir = dirname(configPath);
-	const [entities, functions] = await Promise.all([entityResource.readAll(join(configDir, project.entitiesDir)), functionResource.readAll(join(configDir, project.functionsDir))]);
+	const [entities, functions, agents] = await Promise.all([
+		entityResource.readAll(join(configDir, project.entitiesDir)),
+		functionResource.readAll(join(configDir, project.functionsDir)),
+		agentResource.readAll(join(configDir, project.agentsDir))
+	]);
 	return {
 		project: {
 			...project,
@@ -16784,7 +16894,8 @@ async function readProjectConfig(projectRoot) {
 			configPath
 		},
 		entities,
-		functions
+		functions,
+		agents
 	};
 }
 
@@ -25412,7 +25523,7 @@ async function uploadSite(archivePath) {
 	const blob = new Blob([archiveBuffer], { type: "application/gzip" });
 	const formData = new FormData();
 	formData.append("file", blob, "dist.tar.gz");
-	const response = await getAppClient().post("deploy-dist", { body: formData });
+	const response = await getAppClient$1().post("deploy-dist", { body: formData });
 	return DeployResponseSchema.parse(await response.json());
 }
 
@@ -30517,7 +30628,7 @@ const base44Client = distribution_default.create({
 * const appClient = getAppClient();
 * const response = await appClient.get("entities");
 */
-function getAppClient() {
+function getAppClient$1() {
 	const { id } = getAppConfig();
 	return base44Client.extend({ prefixUrl: new URL(`/api/apps/${id}/`, getBase44ApiUrl()).href });
 }
@@ -31337,7 +31448,7 @@ const logoutCommand = new Command("logout").description("Logout from current dev
 //#endregion
 //#region src/cli/commands/entities/push.ts
 async function pushEntitiesAction() {
-	const { entities } = await readProjectConfig();
+	const { entities } = await readProjectConfig$1();
 	if (entities.length === 0) return { outroMessage: "No entities found in project" };
 	M.info(`Found ${entities.length} entities to push`);
 	const result = await runTask("Pushing entities to Base44", async () => {
@@ -31355,10 +31466,56 @@ const entitiesPushCommand = new Command("entities").description("Manage project
 	await runCommand(pushEntitiesAction, { requireAuth: true });
 }));
 
+//#endregion
+//#region src/cli/commands/agents/pull.ts
+async function pullAgentsAction() {
+	const { project } = await readProjectConfig();
+	const agentsDir = join(dirname(project.configPath), project.agentsDir);
+	const response = await runTask("Fetching agents from Base44", async () => {
+		return await fetchAgents();
+	}, {
+		successMessage: "Agents fetched successfully",
+		errorMessage: "Failed to fetch agents"
+	});
+	if (response.items.length === 0) return { outroMessage: "No agents found on Base44" };
+	const { written, deleted } = await runTask("Writing agent files", async () => {
+		return await writeAgents(agentsDir, response.items);
+	}, {
+		successMessage: "Agent files written successfully",
+		errorMessage: "Failed to write agent files"
+	});
+	if (written.length > 0) M.success(`Written: ${written.join(", ")}`);
+	if (deleted.length > 0) M.warn(`Deleted: ${deleted.join(", ")}`);
+	return { outroMessage: `Pulled ${response.total} agents to ${agentsDir}` };
+}
+const agentsPullCommand = new Command("pull").description("Pull agents from Base44 to local files (replaces all local agent configs)").action(async () => {
+	await runCommand(pullAgentsAction, { requireAuth: true });
+});
+
+//#endregion
+//#region src/cli/commands/agents/push.ts
+async function pushAgentsAction() {
+	const { agents } = await readProjectConfig();
+	M.info(agents.length === 0 ? "No local agents found - this will delete all remote agents" : `Found ${agents.length} agents to push`);
+	const result = await runTask("Pushing agents to Base44", async () => {
+		return await pushAgents(agents);
+	}, {
+		successMessage: "Agents pushed successfully",
+		errorMessage: "Failed to push agents"
+	});
+	if (result.created.length > 0) M.success(`Created: ${result.created.join(", ")}`);
+	if (result.updated.length > 0) M.success(`Updated: ${result.updated.join(", ")}`);
+	if (result.deleted.length > 0) M.warn(`Deleted: ${result.deleted.join(", ")}`);
+	return {};
+}
+const agentsCommand = new Command("agents").description("Manage project agents").addCommand(new Command("push").description("Push local agents to Base44 (replaces all remote agent configs)").action(async () => {
+	await runCommand(pushAgentsAction, { requireAuth: true });
+})).addCommand(agentsPullCommand);
+
 //#endregion
 //#region src/cli/commands/functions/deploy.ts
 async function deployFunctionsAction() {
-	const { functions } = await readProjectConfig();
+	const { functions } = await readProjectConfig$1();
 	if (functions.length === 0) return { outroMessage: "No functions found. Create functions in the 'functions' directory." };
 	M.info(`Found ${functions.length} ${functions.length === 1 ? "function" : "functions"} to deploy`);
 	const result = await runTask("Deploying functions to Base44", async () => {
@@ -38139,7 +38296,7 @@ async function executeCreate({ template, name: rawName, description, projectPath
 		id: projectId,
 		projectRoot: resolvedPath
 	});
-	const { project, entities } = await readProjectConfig(resolvedPath);
+	const { project, entities } = await readProjectConfig$1(resolvedPath);
 	let finalAppUrl;
 	if (entities.length > 0) {
 		let shouldPushEntities;
@@ -38762,7 +38919,7 @@ const dashboardCommand = new Command("dashboard").description("Open the app dash
 //#endregion
 //#region src/cli/commands/project/deploy.ts
 async function deployAction$1(options) {
-	const projectData = await readProjectConfig();
+	const projectData = await readProjectConfig$1();
 	if (!hasResourcesToDeploy(projectData)) return { outroMessage: "No resources found to deploy" };
 	const { project, entities, functions } = projectData;
 	const summaryLines = [];
@@ -38911,7 +39068,7 @@ const linkCommand = new Command("link").description("Link a local project to a B
 //#endregion
 //#region src/cli/commands/site/deploy.ts
 async function deployAction(options) {
-	const { project } = await readProjectConfig();
+	const { project } = await readProjectConfig$1();
 	if (!project.site?.outputDirectory) throw new Error("No site configuration found. Please add 'site.outputDirectory' to your config.jsonc");
 	const outputDir = resolve(project.root, project.site.outputDirectory);
 	if (!options.yes) {
@@ -38931,7 +39088,7 @@ const siteDeployCommand = new Command("site").description("Manage site deploymen
 
 //#endregion
 //#region package.json
-var version = "0.0.19";
+var version = "0.0.21";
 
 //#endregion
 //#region src/cli/program.ts
@@ -38946,6 +39103,7 @@ program.addCommand(dashboardCommand);
 program.addCommand(deployCommand);
 program.addCommand(linkCommand);
 program.addCommand(entitiesPushCommand);
+program.addCommand(agentsCommand);
 program.addCommand(functionsDeployCommand);
 program.addCommand(siteDeployCommand);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/cli",
-  "version": "0.0.19-pr.124.a7f34a6",
+  "version": "0.0.21-pr.112.b9c226a",
   "description": "Base44 CLI - Unified interface for managing Base44 applications",
   "type": "module",
   "bin": {