@inkeep/agents-cli 0.41.2 → 0.42.0

package/dist/commands/pull-v3/components/environment-generator.js

@@ -4,10 +4,13 @@ const DEFAULT_STYLE = {
 	semicolons: true,
 	indentation: "  "
 };
+/**
+* Utility functions
+*/
 function formatString(str, quote = "'", multiline = false) {
 	if (!str) return `${quote}${quote}`;
 	if (multiline && (str.includes("\n") || str.length > 80)) return `\`${str.replace(/`/g, "\\`")}\``;
-	return `${quote}${str.replace(new RegExp(quote, "g"), "\\" + quote)}${quote}`;
+	return `${quote}${str.replace(new RegExp(quote, "g"), `\\${quote}`)}${quote}`;
 }
 /**
 * Format credentials object for environment settings
@@ -55,7 +58,7 @@ function formatCredentialsObject(credentials, style, indentLevel) {
 function generateEnvironmentSettingsDefinition(environmentName, environmentData, style = DEFAULT_STYLE) {
 	if (!environmentName || typeof environmentName !== "string") throw new Error("environmentName is required and must be a string");
 	if (!environmentData || typeof environmentData !== "object") throw new Error(`environmentData is required for environment '${environmentName}'`);
-	const { quotes, semicolons, indentation } = style;
+	const { semicolons, indentation } = style;
 	const semi = semicolons ? ";" : "";
 	const lines = [];
 	lines.push(`export const ${environmentName} = registerEnvironmentSettings({`);
@@ -71,7 +74,7 @@ function generateEnvironmentSettingsDefinition(environmentName, environmentData,
 * Generate Main Environment Settings Index (index.ts)
 */
 function generateEnvironmentIndexDefinition(environments, style = DEFAULT_STYLE) {
-	const { quotes, semicolons, indentation } = style;
+	const { semicolons, indentation } = style;
 	const semi = semicolons ? ";" : "";
 	const lines = [];
 	lines.push(`export const envSettings = createEnvironmentSettings({`);
@@ -83,7 +86,7 @@ function generateEnvironmentIndexDefinition(environments, style = DEFAULT_STYLE)
 /**
 * Generate imports for individual environment settings file
 */
-function generateEnvironmentSettingsImports(environmentName, environmentData, style = DEFAULT_STYLE) {
+function generateEnvironmentSettingsImports(environmentData, style = DEFAULT_STYLE) {
 	const { quotes, semicolons } = style;
 	const q = quotes === "single" ? "'" : "\"";
 	const semi = semicolons ? ";" : "";
@@ -112,9 +115,9 @@ function generateEnvironmentIndexImports(environments, style = DEFAULT_STYLE) {
 * Generate complete environment settings file
 */
 function generateEnvironmentSettingsFile(environmentName, environmentData, style = DEFAULT_STYLE) {
-	const imports = generateEnvironmentSettingsImports(environmentName, environmentData, style);
+	const imports = generateEnvironmentSettingsImports(environmentData, style);
 	const definition = generateEnvironmentSettingsDefinition(environmentName, environmentData, style);
-	return imports.join("\n") + "\n\n" + definition + "\n";
+	return `${imports.join("\n")}\n\n${definition}\n`;
 }
 /**
 * Generate complete environment index file
@@ -122,7 +125,7 @@ function generateEnvironmentSettingsFile(environmentName, environmentData, style
 function generateEnvironmentIndexFile(environments, style = DEFAULT_STYLE) {
 	const imports = generateEnvironmentIndexImports(environments, style);
 	const definition = generateEnvironmentIndexDefinition(environments, style);
-	return imports.join("\n") + "\n\n" + definition + "\n";
+	return `${imports.join("\n")}\n\n${definition}\n`;
 }
 /**
 * Generate environment file (alias for generateEnvironmentSettingsFile)

package/dist/commands/pull-v3/components/function-tool-generator.js

@@ -1,5 +1,3 @@
-import { jsonSchemaToZod } from "json-schema-to-zod";
-
 //#region src/commands/pull-v3/components/function-tool-generator.ts
 const DEFAULT_STYLE = {
 	quotes: "single",
@@ -15,7 +13,7 @@ function toCamelCase(str) {
 function formatString(str, quote = "'", multiline = false) {
 	if (!str) return `${quote}${quote}`;
 	if (multiline && (str.includes("\n") || str.length > 80)) return `\`${str.replace(/`/g, "\\`")}\``;
-	return `${quote}${str.replace(new RegExp(quote, "g"), "\\" + quote)}${quote}`;
+	return `${quote}${str.replace(new RegExp(quote, "g"), `\\${quote}`)}${quote}`;
 }
 /**
 * Format JavaScript function code with proper indentation
@@ -54,7 +52,7 @@ function generateFunctionToolDefinition(toolId, toolData, style = DEFAULT_STYLE)
 			if (index === 0) return `${indentation}inputSchema: ${line}`;
 			return `${indentation}${line}`;
 		}).join("\n");
-		lines.push(formattedSchema + ",");
+		lines.push(`${formattedSchema},`);
 	}
 	const executeCode = toolData.executeCode || toolData.execute;
 	if (executeCode) {
@@ -73,7 +71,7 @@ function generateFunctionToolDefinition(toolId, toolData, style = DEFAULT_STYLE)
 /**
 * Generate imports needed for a function tool file
 */
-function generateFunctionToolImports(toolId, toolData, style = DEFAULT_STYLE) {
+function generateFunctionToolImports(style = DEFAULT_STYLE) {
 	const { quotes, semicolons } = style;
 	const q = quotes === "single" ? "'" : "\"";
 	const semi = semicolons ? ";" : "";
@@ -85,9 +83,9 @@ function generateFunctionToolImports(toolId, toolData, style = DEFAULT_STYLE) {
 * Generate complete function tool file (imports + definition)
 */
 function generateFunctionToolFile(toolId, toolData, style = DEFAULT_STYLE) {
-	const imports = generateFunctionToolImports(toolId, toolData, style);
+	const imports = generateFunctionToolImports(style);
 	const definition = generateFunctionToolDefinition(toolId, toolData, style);
-	return imports.join("\n") + "\n\n" + definition + "\n";
+	return `${imports.join("\n")}\n\n${definition}\n`;
 }
 
 //#endregion

package/dist/commands/pull-v3/components/mcp-tool-generator.js

@@ -13,7 +13,7 @@ function toCamelCase(str) {
 function formatString(str, quote = "'", multiline = false) {
 	if (!str) return `${quote}${quote}`;
 	if (multiline && (str.includes("\n") || str.length > 80)) return `\`${str.replace(/`/g, "\\`")}\``;
-	return `${quote}${str.replace(new RegExp(quote, "g"), "\\" + quote)}${quote}`;
+	return `${quote}${str.replace(new RegExp(quote, "g"), `\\${quote}`)}${quote}`;
 }
 /**
 * Generate MCP Tool Definition using mcpTool() builder function
@@ -47,7 +47,7 @@ function generateMcpToolDefinition(toolId, toolData, style = DEFAULT_STYLE, regi
 			if (index === 0) return `${indentation}headers: ${line}`;
 			return `${indentation}${line}`;
 		}).join("\n");
-		lines.push(formattedHeaders + ",");
+		lines.push(`${formattedHeaders},`);
 	}
 	if (toolData.credential) if (typeof toolData.credential === "object") {
 		const credentialStr = JSON.stringify(toolData.credential);
@@ -64,7 +64,7 @@ function generateMcpToolDefinition(toolId, toolData, style = DEFAULT_STYLE, regi
 /**
 * Generate imports needed for an MCP tool file
 */
-function generateMcpToolImports(toolId, toolData, style = DEFAULT_STYLE) {
+function generateMcpToolImports(toolData, style = DEFAULT_STYLE) {
 	const { quotes, semicolons } = style;
 	const q = quotes === "single" ? "'" : "\"";
 	const semi = semicolons ? ";" : "";
@@ -77,9 +77,9 @@ function generateMcpToolImports(toolId, toolData, style = DEFAULT_STYLE) {
 * Generate complete MCP tool file (imports + definition)
 */
 function generateMcpToolFile(toolId, toolData, style = DEFAULT_STYLE, registry) {
-	const imports = generateMcpToolImports(toolId, toolData, style);
+	const imports = generateMcpToolImports(toolData, style);
 	const definition = generateMcpToolDefinition(toolId, toolData, style, registry);
-	return imports.join("\n") + "\n\n" + definition + "\n";
+	return `${imports.join("\n")}\n\n${definition}\n`;
 }
 
 //#endregion

package/dist/commands/pull-v3/components/project-generator.js

@@ -62,7 +62,7 @@ function generateProjectDefinition(projectId, projectData, style = DEFAULT_STYLE
 /**
 * Generate imports needed for a project file
 */
-function generateProjectImports(projectId, projectData, style = DEFAULT_STYLE, registry) {
+function generateProjectImports(projectData, style = DEFAULT_STYLE, registry) {
 	const imports = [];
 	imports.push(generateImport(["project"], "@inkeep/agents-sdk", style));
 	if (registry) {
@@ -83,8 +83,8 @@ function generateProjectImports(projectId, projectData, style = DEFAULT_STYLE, r
 			else if (typeof projectData.tools === "object") toolIds = Object.keys(projectData.tools);
 			for (const toolId of toolIds) {
 				let componentType = "tools";
-				if (registry && registry.get(toolId, "functionTools")) componentType = "functionTools";
-				else if (registry && registry.get(toolId, "tools")) componentType = "tools";
+				if (registry?.get(toolId, "functionTools")) componentType = "functionTools";
+				else if (registry?.get(toolId, "tools")) componentType = "tools";
 				referencedComponents.push({
 					id: toolId,
 					type: componentType
@@ -138,7 +138,7 @@ function generateProjectImports(projectId, projectData, style = DEFAULT_STYLE, r
 * Generate complete project file (imports + definition)
 */
 function generateProjectFile(projectId, projectData, style = DEFAULT_STYLE, registry) {
-	return generateFileContent(generateProjectImports(projectId, projectData, style, registry), [generateProjectDefinition(projectId, projectData, style, registry)]);
+	return generateFileContent(generateProjectImports(projectData, style, registry), [generateProjectDefinition(projectId, projectData, style, registry)]);
 }
 
 //#endregion

package/dist/commands/pull-v3/components/status-component-generator.js

@@ -21,7 +21,7 @@ function toCamelCase(str) {
 function formatString(str, quote = "'", multiline = false) {
 	if (!str) return `${quote}${quote}`;
 	if (multiline && (str.includes("\n") || str.length > 80)) return `\`${str.replace(/`/g, "\\`")}\``;
-	return `${quote}${str.replace(new RegExp(quote, "g"), "\\" + quote)}${quote}`;
+	return `${quote}${str.replace(new RegExp(quote, "g"), `\\${quote}`)}${quote}`;
 }
 /**
 * Convert JSON Schema to Zod schema using existing utility
@@ -58,9 +58,9 @@ function generateStatusComponentDefinition(componentId, componentData, style = D
 			const schemaLines = zodSchema.split("\n");
 			lines.push(`${indentation}detailsSchema: ${schemaLines[0]}`);
 			schemaLines.slice(1, -1).forEach((line) => {
-				lines[lines.length - 1] += "\n" + indentation + line;
+				lines[lines.length - 1] += `\n${indentation}${line}`;
 			});
-			lines[lines.length - 1] += "\n" + indentation + schemaLines[schemaLines.length - 1] + ",";
+			lines[lines.length - 1] += `\n${indentation}${schemaLines[schemaLines.length - 1]},`;
 		} else lines.push(`${indentation}detailsSchema: ${zodSchema},`);
 	}
 	if (lines.length > 0 && lines[lines.length - 1].endsWith(",")) lines[lines.length - 1] = lines[lines.length - 1].slice(0, -1);
@@ -70,7 +70,7 @@ function generateStatusComponentDefinition(componentId, componentData, style = D
 /**
 * Generate imports needed for a status component file
 */
-function generateStatusComponentImports(componentId, componentData, style = DEFAULT_STYLE) {
+function generateStatusComponentImports(componentData, style = DEFAULT_STYLE) {
 	const { quotes, semicolons } = style;
 	const q = quotes === "single" ? "'" : "\"";
 	const semi = semicolons ? ";" : "";
@@ -83,9 +83,9 @@ function generateStatusComponentImports(componentId, componentData, style = DEFA
 * Generate complete status component file (imports + definition)
 */
 function generateStatusComponentFile(componentId, componentData, style = DEFAULT_STYLE) {
-	const imports = generateStatusComponentImports(componentId, componentData, style);
+	const imports = generateStatusComponentImports(componentData, style);
 	const definition = generateStatusComponentDefinition(componentId, componentData, style);
-	return imports.join("\n") + "\n\n" + definition + "\n";
+	return `${imports.join("\n")}\n\n${definition}\n`;
 }
 
 //#endregion

package/dist/commands/pull-v3/components/trigger-generator.js

@@ -0,0 +1,114 @@
+import { DEFAULT_STYLE, formatString, generateFileContent, generateImport, toCamelCase } from "../utils/generator-utils.js";
+
+//#region src/commands/pull-v3/components/trigger-generator.ts
+/**
+* Trigger Generator - Generate trigger definitions
+*
+* Generates triggers using the Trigger class from @inkeep/agents-sdk
+* Triggers are webhooks that can invoke agent conversations
+*/
+/**
+* Format authentication configuration
+* New format uses headers array: { headers: [{ name, valueHash, valuePrefix }] }
+* We generate code that uses environment variables for the secret values
+*/
+function formatAuthentication(auth, style, indentLevel) {
+	if (!auth) return "";
+	const { indentation, quotes } = style;
+	const q = quotes === "single" ? "'" : "\"";
+	const indent = indentation.repeat(indentLevel);
+	const innerIndent = indentation.repeat(indentLevel + 1);
+	const headerIndent = indentation.repeat(indentLevel + 2);
+	const lines = [];
+	if (auth.headers && Array.isArray(auth.headers) && auth.headers.length > 0) {
+		lines.push(`${indent}authentication: {`);
+		lines.push(`${innerIndent}headers: [`);
+		for (const header of auth.headers) {
+			const envVarName = `TRIGGER_AUTH_${header.name.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`;
+			lines.push(`${headerIndent}{`);
+			lines.push(`${headerIndent}${indentation}name: ${q}${header.name}${q},`);
+			lines.push(`${headerIndent}${indentation}value: process.env.${envVarName} || ${q}${q},`);
+			lines.push(`${headerIndent}},`);
+		}
+		lines.push(`${innerIndent}],`);
+		lines.push(`${indent}},`);
+	}
+	return lines.join("\n");
+}
+/**
+* Format output transform configuration
+*/
+function formatOutputTransform(transform, style, indentLevel) {
+	if (!transform) return "";
+	const { indentation } = style;
+	const indent = indentation.repeat(indentLevel);
+	const innerIndent = indentation.repeat(indentLevel + 1);
+	const lines = [];
+	lines.push(`${indent}outputTransform: {`);
+	if (transform.jmespath) lines.push(`${innerIndent}jmespath: '${transform.jmespath}',`);
+	if (transform.objectTransformation) {
+		const formattedTransform = JSON.stringify(transform.objectTransformation, null, 2).split("\n").map((line, index) => {
+			if (index === 0) return `${innerIndent}objectTransformation: ${line}`;
+			return `${innerIndent}${line}`;
+		}).join("\n");
+		lines.push(`${formattedTransform},`);
+	}
+	if (lines.length > 1 && lines[lines.length - 1].endsWith(",")) lines[lines.length - 1] = lines[lines.length - 1].slice(0, -1);
+	lines.push(`${indent}},`);
+	return lines.join("\n");
+}
+/**
+* Generate Trigger Definition using Trigger class
+*/
+function generateTriggerDefinition(triggerId, triggerData, style = DEFAULT_STYLE) {
+	if (!triggerId || typeof triggerId !== "string") throw new Error("triggerId is required and must be a string");
+	if (!triggerData || typeof triggerData !== "object") throw new Error(`triggerData is required for trigger '${triggerId}'`);
+	const missingFields = ["name", "messageTemplate"].filter((field) => !triggerData[field] || triggerData[field] === null || triggerData[field] === void 0);
+	if (missingFields.length > 0) throw new Error(`Missing required fields for trigger '${triggerId}': ${missingFields.join(", ")}`);
+	const { quotes, semicolons, indentation } = style;
+	const q = quotes === "single" ? "'" : "\"";
+	const semi = semicolons ? ";" : "";
+	const triggerVarName = toCamelCase(triggerId);
+	const lines = [];
+	lines.push(`export const ${triggerVarName} = new Trigger({`);
+	lines.push(`${indentation}id: ${formatString(triggerId, q)},`);
+	lines.push(`${indentation}name: ${formatString(triggerData.name, q)},`);
+	if (triggerData.description) lines.push(`${indentation}description: ${formatString(triggerData.description, q, true)},`);
+	if (triggerData.enabled !== void 0 && triggerData.enabled !== null) lines.push(`${indentation}enabled: ${triggerData.enabled},`);
+	lines.push(`${indentation}messageTemplate: ${formatString(triggerData.messageTemplate, q, true)},`);
+	if (triggerData.inputSchema) {
+		const formattedSchema = JSON.stringify(triggerData.inputSchema, null, 2).split("\n").map((line, index) => {
+			if (index === 0) return `${indentation}inputSchema: ${line}`;
+			return `${indentation}${line}`;
+		}).join("\n");
+		lines.push(`${formattedSchema},`);
+	}
+	if (triggerData.outputTransform) {
+		const outputTransformFormatted = formatOutputTransform(triggerData.outputTransform, style, 1);
+		if (outputTransformFormatted) lines.push(outputTransformFormatted);
+	}
+	if (triggerData.authentication) {
+		const authFormatted = formatAuthentication(triggerData.authentication, style, 1);
+		if (authFormatted) lines.push(authFormatted);
+	}
+	if (lines.length > 0 && lines[lines.length - 1].endsWith(",")) lines[lines.length - 1] = lines[lines.length - 1].slice(0, -1);
+	lines.push(`})${semi}`);
+	return lines.join("\n");
+}
+/**
+* Generate imports needed for a trigger file
+*/
+function generateTriggerImports(style = DEFAULT_STYLE) {
+	const imports = [];
+	imports.push(generateImport(["Trigger"], "@inkeep/agents-sdk", style));
+	return imports;
+}
+/**
+* Generate complete trigger file (imports + definition)
+*/
+function generateTriggerFile(triggerId, triggerData, style = DEFAULT_STYLE) {
+	return generateFileContent(generateTriggerImports(style), [generateTriggerDefinition(triggerId, triggerData, style)]);
+}
+
+//#endregion
+export { generateTriggerDefinition, generateTriggerFile, generateTriggerImports };

package/dist/commands/pull-v3/index.js

@@ -1,15 +1,13 @@
 import { ManagementApiClient } from "../../api.js";
-import "../../utils/config.js";
 import { initializeCommand } from "../../utils/cli-pipeline.js";
 import { performBackgroundVersionCheck } from "../../utils/background-version-check.js";
-import "../../utils/json-comparison.js";
 import { loadProject } from "../../utils/project-loader.js";
 import { extractSubAgents } from "./utils/component-registry.js";
-import { compareProjects } from "./project-comparator.js";
 import { checkAndPromptForStaleComponentCleanup, cleanupStaleComponents, copyProjectToTemp } from "./component-updater.js";
 import { introspectGenerate } from "./introspect-generator.js";
+import { compareProjects } from "./project-comparator.js";
 import { existsSync, mkdirSync } from "node:fs";
-import { basename, dirname, join, resolve } from "node:path";
+import { join, resolve } from "node:path";
 import * as p from "@clack/prompts";
 import chalk from "chalk";
 import { EventEmitter } from "node:events";
@@ -38,7 +36,7 @@ function resetStdinState() {
 /**
 * Create project directory structure
 */
-function createProjectStructure(projectDir, projectId) {
+function createProjectStructure(projectDir) {
 	const projectRoot = projectDir;
 	const paths = {
 		projectRoot,
@@ -60,11 +58,11 @@ function createProjectStructure(projectDir, projectId) {
 /**
 * Enrich canDelegateTo references with component type information
 */
-function enrichCanDelegateToWithTypes(project, debug = false) {
+function enrichCanDelegateToWithTypes(project) {
 	const agentIds = new Set(project.agents ? Object.keys(project.agents) : []);
 	const subAgentIds = new Set(Object.keys(extractSubAgents(project)));
 	const externalAgentIds = new Set(project.externalAgents ? Object.keys(project.externalAgents) : []);
-	const enrichCanDelegateToArray = (canDelegateTo, context) => {
+	const enrichCanDelegateToArray = (canDelegateTo) => {
 		if (!Array.isArray(canDelegateTo)) return;
 		for (let i = 0; i < canDelegateTo.length; i++) {
 			const item = canDelegateTo[i];
@@ -79,15 +77,15 @@ function enrichCanDelegateToWithTypes(project, debug = false) {
 		}
 	};
 	if (project.agents) {
-		for (const [_, agentData] of Object.entries(project.agents)) if (agentData.subAgents) {
-			for (const [subAgentId, subAgentData] of Object.entries(agentData.subAgents)) if (subAgentData.canDelegateTo) enrichCanDelegateToArray(subAgentData.canDelegateTo, `subAgent:${subAgentId}`);
+		for (const agentData of Object.values(project.agents)) if (agentData.subAgents) {
+			for (const subAgentData of Object.values(agentData.subAgents)) if (subAgentData.canDelegateTo) enrichCanDelegateToArray(subAgentData.canDelegateTo);
 		}
 	}
 }
 /**
 * Read existing project from filesystem if it exists
 */
-async function readExistingProject(projectRoot, debug = false) {
+async function readExistingProject(projectRoot) {
 	if (!existsSync(join(projectRoot, "index.ts"))) return null;
 	try {
 		const { loadProject: loadProject$1 } = await import("../../utils/project-loader.js");
@@ -97,9 +95,7 @@ async function readExistingProject(projectRoot, debug = false) {
 				reject(/* @__PURE__ */ new Error("getFullDefinition() timed out after 30 seconds - likely circular reference or infinite loop in local project"));
 			}, 3e4);
 		})]);
-	} catch (error) {
-		const errorMessage = error instanceof Error ? error.message : String(error);
-		errorMessage.includes("Credential") && errorMessage.includes("not found");
+	} catch {
 		return null;
 	}
 }
@@ -125,7 +121,7 @@ async function pullV3Command(options) {
 	else console.log(chalk.gray("  Smart comparison • Detect all changes • Targeted updates"));
 	const s = p.spinner();
 	try {
-		const { config, profile, isCI } = await initializeCommand({
+		const { config, isCI } = await initializeCommand({
 			configPath: options.config,
 			profileName: options.profile,
 			tag: options.tag,
@@ -192,7 +188,7 @@ async function pullV3Command(options) {
 			}
 		}
 		s.start(`Fetching project: ${projectId}`);
-		const remoteProject = await (await ManagementApiClient.create(config.agentsManageApiUrl, options.config, config.tenantId, projectId, isCI, config.agentsManageApiKey)).getFullProject(projectId);
+		const remoteProject = await (await ManagementApiClient.create(config.agentsApiUrl, options.config, config.tenantId, projectId, isCI, config.agentsApiKey)).getFullProject(projectId);
 		if (options.debug && remoteProject.functions) {
 			console.log(chalk.gray("   📋 Project-level functions from API:"), Object.keys(remoteProject.functions));
 			Object.entries(remoteProject.functions).forEach(([id, data]) => {
@@ -219,21 +215,20 @@ async function pullV3Command(options) {
 		}
 		if (remoteProject.agents && remoteProject.tools) {
 			const projectToolIds = Object.keys(remoteProject.tools);
-			for (const [agentId, agentData] of Object.entries(remoteProject.agents)) if (agentData.tools) {
-				Object.keys(agentData.tools).length;
+			for (const agentData of Object.values(remoteProject.agents)) if (agentData.tools) {
 				const agentSpecificTools = Object.fromEntries(Object.entries(agentData.tools).filter(([toolId]) => !projectToolIds.includes(toolId)));
 				if (Object.keys(agentSpecificTools).length > 0) agentData.tools = agentSpecificTools;
 				else delete agentData.tools;
 			}
 		}
-		enrichCanDelegateToWithTypes(remoteProject, options.debug);
+		enrichCanDelegateToWithTypes(remoteProject);
 		s.message("Project data fetched");
 		if (options.json) {
 			console.log(JSON.stringify(remoteProject, null, 2));
 			restoreLogLevel();
 			return;
 		}
-		const paths = createProjectStructure(projectDir, projectId);
+		const paths = createProjectStructure(projectDir);
 		if (options.introspect) {
 			console.log(chalk.yellow("\n🔍 Introspect mode: Regenerating all files from scratch"));
 			s.start("Generating all files deterministically...");
@@ -247,7 +242,7 @@ async function pullV3Command(options) {
 			if (batchMode) return { success: true };
 			process.exit(0);
 		}
-		const localProject = await readExistingProject(paths.projectRoot, options.debug);
+		const localProject = await readExistingProject(paths.projectRoot);
 		if (!localProject) s.message("No existing project found - treating as new project");
 		else s.message("Existing project loaded");
 		s.start("Building component registry from local files...");
@@ -261,7 +256,7 @@ async function pullV3Command(options) {
 			const nameGroups = /* @__PURE__ */ new Map();
 			for (const comp of allComponents) {
 				if (!nameGroups.has(comp.name)) nameGroups.set(comp.name, []);
-				nameGroups.get(comp.name).push(comp);
+				nameGroups.get(comp.name)?.push(comp);
 			}
 			for (const [varName, components] of nameGroups.entries()) if (components.length > 1) {
 				console.log(chalk.red(`   ❌ Variable name conflict: "${varName}"`));
@@ -269,7 +264,7 @@ async function pullV3Command(options) {
 			} else console.log(chalk.gray(`   ✅ ${varName} (${components[0].type}:${components[0].id})`));
 		}
 		s.start("Comparing projects for changes...");
-		const comparison = await compareProjects(localProject, remoteProject, localRegistry, options.debug);
+		const comparison = await compareProjects(localProject, remoteProject, options.debug);
 		if (!comparison.hasChanges && !options.force) {
 			s.stop();
 			console.log(chalk.green("✅ Project is already up to date"));
@@ -289,7 +284,7 @@ async function pullV3Command(options) {
 			copyProjectToTemp(paths.projectRoot, tempDirName);
 			console.log(chalk.green(`✅ Existing project copied to temp directory`));
 			s.start("Checking for stale components...");
-			const shouldCleanupStale = await checkAndPromptForStaleComponentCleanup(paths.projectRoot, remoteProject, localRegistry);
+			const shouldCleanupStale = await checkAndPromptForStaleComponentCleanup(remoteProject, localRegistry);
 			resetStdinState();
 			if (shouldCleanupStale) {
 				s.start("Cleaning up stale components from temp directory...");
@@ -315,7 +310,7 @@ async function pullV3Command(options) {
 				const nameGroups = /* @__PURE__ */ new Map();
 				for (const comp of allComponents) {
 					if (!nameGroups.has(comp.name)) nameGroups.set(comp.name, []);
-					nameGroups.get(comp.name).push(comp);
+					nameGroups.get(comp.name)?.push(comp);
 				}
 				for (const [varName, components] of nameGroups.entries()) if (components.length > 1) {
 					console.log(chalk.red(`   ❌ Variable name conflict: "${varName}"`));
@@ -333,9 +328,9 @@ async function pullV3Command(options) {
 			const newComponentsForContext = newComponentResults && newComponentResults.length > 0 ? newComponentResults.filter((result) => result.success).map((result) => ({
 				componentId: result.componentId,
 				componentType: result.componentType,
-				filePath: result.filePath.replace(paths.projectRoot + "/", "")
+				filePath: result.filePath.replace(`${paths.projectRoot}/`, "")
 			})) : void 0;
-			await updateModifiedComponents(comparison, remoteProject, localRegistry, paths.projectRoot, options.env || "development", options.debug, tempDirName, newComponentsForContext);
+			await updateModifiedComponents(comparison, remoteProject, localRegistry, paths.projectRoot, options.debug, tempDirName, newComponentsForContext);
 		}
 		s.start("Generating project index file in temp directory...");
 		const { generateProjectIndex } = await import("./project-index-generator.js");
@@ -380,7 +375,7 @@ async function pullAllProjects(options) {
 	console.log(chalk.gray("  • Existing projects: Smart comparison + LLM merging + confirmation prompts"));
 	console.log(chalk.gray("  • New projects: Fresh generation with introspect mode\n"));
 	performBackgroundVersionCheck();
-	const { config, profile, isCI } = await initializeCommand({
+	const { config, isCI } = await initializeCommand({
 		configPath: options.config,
 		profileName: options.profile,
 		tag: options.tag,
@@ -392,7 +387,7 @@ async function pullAllProjects(options) {
 	const s = p.spinner();
 	try {
 		s.start("Fetching project list from API...");
-		const projects = await (await ManagementApiClient.create(config.agentsManageApiUrl, options.config, config.tenantId, void 0, isCI, config.agentsManageApiKey)).listAllProjects();
+		const projects = await (await ManagementApiClient.create(config.agentsApiUrl, options.config, config.tenantId, void 0, isCI, config.agentsApiKey)).listAllProjects();
 		s.stop(`Found ${projects.length} project(s)`);
 		if (projects.length === 0) {
 			console.log(chalk.yellow("No projects found for this tenant."));
@@ -486,8 +481,8 @@ async function pullSingleProject(projectId, projectName, options, config, isCI)
 			if (originalLogLevel !== void 0) process.env.LOG_LEVEL = originalLogLevel;
 			else delete process.env.LOG_LEVEL;
 		};
-		const remoteProject = await (await ManagementApiClient.create(config.agentsManageApiUrl, options.config, config.tenantId, projectId, isCI, config.agentsManageApiKey)).getFullProject(projectId);
-		await introspectGenerate(remoteProject, createProjectStructure(targetDir, projectId), options.env || "development", false);
+		const remoteProject = await (await ManagementApiClient.create(config.agentsApiUrl, options.config, config.tenantId, projectId, isCI, config.agentsApiKey)).getFullProject(projectId);
+		await introspectGenerate(remoteProject, createProjectStructure(targetDir), options.env || "development", false);
 		restoreLogLevel();
 		return {
 			projectId,

package/dist/commands/pull-v3/introspect-generator.js

@@ -12,6 +12,7 @@ import { generateProjectFile } from "./components/project-generator.js";
 import { generateStatusComponentFile } from "./components/status-component-generator.js";
 import { generateSubAgentFile } from "./components/sub-agent-generator.js";
 import { ComponentRegistry, registerAllComponents } from "./utils/component-registry.js";
+import { generateTriggerFile } from "./components/trigger-generator.js";
 import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import chalk from "chalk";
@@ -33,7 +34,7 @@ function ensureDir(filePath) {
 * Check if an agent is complete enough for code generation
 * An agent needs a name, defaultSubAgentId, and at least one sub-agent
 */
-function isAgentComplete(agentId, agentData) {
+function isAgentComplete(agentData) {
 	if (!agentData.name) return {
 		complete: false,
 		reason: "missing name"
@@ -102,7 +103,7 @@ async function introspectGenerate(project, paths, environment, debug, options =
 			generatedFiles.push(functionFile);
 			functionToolsGenerated.add(toolId);
 		}
-		if (project.agents) for (const [agentId, agentData] of Object.entries(project.agents)) {
+		if (project.agents) for (const agentData of Object.values(project.agents)) {
 			const agentFunctionTools = agentData.functionTools;
 			const agentFunctions = agentData.functions;
 			if (agentFunctionTools) for (const [toolId, toolData] of Object.entries(agentFunctionTools)) {
@@ -126,7 +127,7 @@ async function introspectGenerate(project, paths, environment, debug, options =
 			}
 		}
 		if (project.functions) {
-			for (const [funcId, funcData] of Object.entries(project.functions)) if (!functionToolsGenerated.has(funcId)) {
+			for (const funcId of Object.keys(project.functions)) if (!functionToolsGenerated.has(funcId)) {
 				if (!(Object.values(project.functionTools || {}).some((ft) => ft.functionId === funcId) || Object.values(project.agents || {}).some((agent) => Object.values(agent.functionTools || {}).some((ft) => ft.functionId === funcId))) && debug) console.log(chalk.yellow(`⚠️  Skipping orphaned function '${funcId}' - no functionTool references it`));
 			}
 		}
@@ -182,7 +183,7 @@ async function introspectGenerate(project, paths, environment, debug, options =
 		}
 		const completeAgentIds = /* @__PURE__ */ new Set();
 		if (project.agents) for (const [agentId, agentData] of Object.entries(project.agents)) {
-			const completeness = isAgentComplete(agentId, agentData);
+			const completeness = isAgentComplete(agentData);
 			if (completeness.complete) completeAgentIds.add(agentId);
 			else {
 				skippedAgents.push({
@@ -196,7 +197,7 @@ async function introspectGenerate(project, paths, environment, debug, options =
 			let totalSubAgents = 0;
 			for (const [agentId, agentData] of Object.entries(project.agents)) {
 				if (!completeAgentIds.has(agentId)) continue;
-				if (agentData.subAgents) for (const [subAgentId, subAgentData] of Object.entries(agentData.subAgents)) totalSubAgents++;
+				if (agentData.subAgents) for (const _subAgentId of Object.keys(agentData.subAgents)) totalSubAgents++;
 			}
 			if (totalSubAgents > 0) for (const [agentId, agentData] of Object.entries(project.agents)) {
 				if (!completeAgentIds.has(agentId)) continue;
@@ -219,6 +220,13 @@ async function introspectGenerate(project, paths, environment, debug, options =
 			ensureDir(agentFile);
 			writeFileSync(agentFile, agentContent, "utf-8");
 			generatedFiles.push(agentFile);
+			if (agentData.triggers && Object.keys(agentData.triggers).length > 0) for (const [triggerId, triggerData] of Object.entries(agentData.triggers)) {
+				const triggerFile = join(paths.agentsDir, "triggers", `${triggerId}.ts`);
+				const triggerContent = generateTriggerFile(triggerId, triggerData, style);
+				ensureDir(triggerFile);
+				writeFileSync(triggerFile, triggerContent, "utf-8");
+				generatedFiles.push(triggerFile);
+			}
 		}
 		const projectDataForGenerator = {
 			...project,
@@ -251,7 +259,7 @@ async function introspectGenerate(project, paths, environment, debug, options =
 */
 function findContextConfigData(project, contextId) {
 	if (project.agents) {
-		for (const [agentId, agentData] of Object.entries(project.agents)) if (agentData.contextConfig) {
+		for (const agentData of Object.values(project.agents)) if (agentData.contextConfig) {
 			if (agentData.contextConfig.id === contextId) return agentData.contextConfig;
 		}
 	}
@@ -261,7 +269,7 @@ function findContextConfigData(project, contextId) {
 */
 function findStatusComponentData(project, statusId) {
 	if (project.agents) {
-		for (const [agentId, agentData] of Object.entries(project.agents)) if (agentData.statusUpdates && agentData.statusUpdates.statusComponents) for (const statusComp of agentData.statusUpdates.statusComponents) {
+		for (const agentData of Object.values(project.agents)) if (agentData.statusUpdates?.statusComponents) for (const statusComp of agentData.statusUpdates.statusComponents) {
 			let compId;
 			if (typeof statusComp === "string") compId = statusComp;
 			else if (typeof statusComp === "object" && statusComp) compId = statusComp.type;

package/dist/commands/pull-v3/llm-content-merger.js

@@ -54,7 +54,7 @@ async function mergeComponentsWithLLM(request) {
 		let relativePath = "";
 		for (let i = 0; i < upLevels; i++) relativePath += "../";
 		relativePath += toParts.slice(commonLength).join("/");
-		return relativePath.startsWith("../") ? relativePath : "./" + relativePath;
+		return relativePath.startsWith("../") ? relativePath : `./${relativePath}`;
 	}
 	const componentsToExportList = componentsToExport && componentsToExport.length > 0 ? componentsToExport.map((c) => `- ${c.variableName} (${c.reason})`).join("\n") : "";
 	const prompt = `You are a TypeScript code expert tasked with intelligently merging component updates.