@inkeep/agents-cli 0.51.0 → 0.53.0

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

@@ -1,32 +0,0 @@
-import { generateProjectFile } from "./components/project-generator.js";
-import { writeFileSync } from "node:fs";
-import { join } from "node:path";
-
-//#region src/commands/pull-v3/project-index-generator.ts
-/**
-* Project Index Generator - Generate index.ts file for new projects
-*/
-/**
-* Generate project index.ts file
-*/
-async function generateProjectIndex(projectRoot, remoteProject, localRegistry, projectId) {
-	const indexPath = join(projectRoot, "index.ts");
-	const defaultStyle = {
-		quotes: "single",
-		indentation: "  ",
-		semicolons: true
-	};
-	const registryComponents = localRegistry.getAllComponents();
-	writeFileSync(indexPath, generateProjectFile(projectId, {
-		...remoteProject,
-		agents: registryComponents.filter((c) => c.type === "agents").map((c) => c.id),
-		tools: registryComponents.filter((c) => c.type === "tools").map((c) => c.id),
-		externalAgents: registryComponents.filter((c) => c.type === "externalAgents").map((c) => c.id),
-		dataComponents: registryComponents.filter((c) => c.type === "dataComponents").map((c) => c.id),
-		artifactComponents: registryComponents.filter((c) => c.type === "artifactComponents").map((c) => c.id),
-		credentialReferences: registryComponents.filter((c) => c.type === "credentials").map((c) => c.id)
-	}, defaultStyle, localRegistry), "utf8");
-}
-
-//#endregion
-export { generateProjectIndex };

package/dist/commands/pull-v3/project-validator.js

@@ -1,358 +0,0 @@
-import { compareProjects } from "./project-comparator.js";
-import { enrichCanDelegateToWithTypes } from "./index.js";
-import { buildComponentRegistryFromParsing } from "./component-parser.js";
-import { copyFileSync, existsSync, mkdirSync, readdirSync, rmSync, statSync } from "node:fs";
-import { dirname, join } from "node:path";
-import chalk from "chalk";
-
-//#region src/commands/pull-v3/project-validator.ts
-/**
-* Project Validator - Validate generated projects with TypeScript compilation and equivalence checking
-*/
-/**
-* Get a complete preview of an object for logging (pretty-printed JSON)
-*/
-function getObjectPreview(obj) {
-	if (obj === null) return "null";
-	if (obj === void 0) return "undefined";
-	try {
-		if (typeof obj === "object") return JSON.stringify(obj, null, 2);
-		return String(obj);
-	} catch {
-		return `[Error stringifying: ${typeof obj}]`;
-	}
-}
-/**
-* Find key differences between two objects without full JSON dump
-*/
-/**
-* Extract credential IDs from an agent object, handling different storage structures
-*/
-function extractCredentialIds(agentObj) {
-	const credentialIds = [];
-	if (agentObj.credentials && Array.isArray(agentObj.credentials)) agentObj.credentials.forEach((cred) => {
-		if (cred.id) credentialIds.push(cred.id);
-	});
-	if (agentObj.contextConfig?.contextVariables) Object.values(agentObj.contextConfig.contextVariables).forEach((variable) => {
-		if (variable && typeof variable === "object" && variable.credentialReferenceId) credentialIds.push(variable.credentialReferenceId);
-	});
-	return [...new Set(credentialIds)];
-}
-const IGNORED_COMPARISON_FIELDS = new Set([
-	"type",
-	"tenantId",
-	"projectId",
-	"agentId",
-	"lastError",
-	"lastErrorAt",
-	"status",
-	"usedBy",
-	"tools",
-	"createdAt",
-	"updatedAt"
-]);
-function findKeyDifferences(obj1, obj2) {
-	const differences = [];
-	const allKeys = new Set([...Object.keys(obj1 || {}), ...Object.keys(obj2 || {})]);
-	for (const key of allKeys) {
-		const val1 = obj1?.[key];
-		const val2 = obj2?.[key];
-		if (key.startsWith("_") || IGNORED_COMPARISON_FIELDS.has(key)) continue;
-		if (key === "credentials") {
-			const creds1 = extractCredentialIds(obj1);
-			const creds2 = extractCredentialIds(obj2);
-			creds1.sort();
-			creds2.sort();
-			if (JSON.stringify(creds1) !== JSON.stringify(creds2)) differences.push(`~ credentials: usage differs (${creds1.join(", ")} vs ${creds2.join(", ")})`);
-			continue;
-		}
-		const val1IsEmpty = val1 === null || val1 === void 0 || Array.isArray(val1) && val1.length === 0 || typeof val1 === "object" && val1 !== null && Object.keys(val1).length === 0;
-		const val2IsEmpty = val2 === null || val2 === void 0 || Array.isArray(val2) && val2.length === 0 || typeof val2 === "object" && val2 !== null && Object.keys(val2).length === 0;
-		if (val1IsEmpty && val2IsEmpty) continue;
-		if (val1IsEmpty && !val2IsEmpty) differences.push(`+ ${key}: ${typeof val2} (only in remote)`);
-		else if (!val1IsEmpty && val2IsEmpty) differences.push(`- ${key}: ${typeof val1} (only in generated)`);
-		else if (val1 !== val2) if (Array.isArray(val1) && Array.isArray(val2)) {
-			if (val1.length !== val2.length) differences.push(`~ ${key}: array length differs (${val1.length} vs ${val2.length})`);
-		} else if (typeof val1 === "object" && typeof val2 === "object" && val1 !== null && val2 !== null) {
-			const filterKeys = (obj) => Object.keys(obj).filter((k) => {
-				if (k.startsWith("_") || IGNORED_COMPARISON_FIELDS.has(k)) return false;
-				const v = obj[k];
-				return !(v === null || v === void 0 || Array.isArray(v) && v.length === 0 || typeof v === "object" && v !== null && Object.keys(v).length === 0);
-			});
-			const keys1 = filterKeys(val1);
-			const keys2 = filterKeys(val2);
-			const subKeys1 = keys1.length;
-			const subKeys2 = keys2.length;
-			if (subKeys1 !== subKeys2) differences.push(`~ ${key}: object size differs (${subKeys1} vs ${subKeys2} keys)`);
-		} else if (typeof val1 !== typeof val2) differences.push(`~ ${key}: type differs (${typeof val1} vs ${typeof val2})`);
-		else if (key === "render" || key === "component") {
-			const val1Preview = getObjectPreview(val1);
-			const val2Preview = getObjectPreview(val2);
-			differences.push(`~ ${key}:`);
-			differences.push(`    Generated: ${val1Preview}`);
-			differences.push(`    Remote:    ${val2Preview}`);
-		} else {
-			const val1Str = String(val1);
-			const val2Str = String(val2);
-			if (val1Str.length < 100 && val2Str.length < 100) differences.push(`~ ${key}: "${val1Str}" vs "${val2Str}"`);
-			else differences.push(`~ ${key}: values differ (both ${typeof val1})`);
-		}
-	}
-	return differences.slice(0, 10);
-}
-/**
-* Get a specific component from a project by type and ID
-*/
-function getComponentFromProject(project, componentType, componentId) {
-	switch (componentType) {
-		case "credentials": return project.credentialReferences?.[componentId];
-		case "tools": return project.tools?.[componentId];
-		case "agents": return project.agents?.[componentId];
-		case "subAgents":
-			if (project.agents) {
-				for (const [_agentId, agentData] of Object.entries(project.agents)) if (agentData.subAgents?.[componentId]) return agentData.subAgents[componentId];
-			}
-			return null;
-		case "contextConfigs":
-			if (project.agents) {
-				for (const [_agentId, agentData] of Object.entries(project.agents)) if (agentData.contextConfig && agentData.contextConfig.id === componentId) return agentData.contextConfig;
-			}
-			return null;
-		case "fetchDefinitions":
-			if (project.agents) {
-				for (const [_agentId, agentData] of Object.entries(project.agents)) if (agentData.contextConfig?.contextVariables) {
-					for (const [_varId, variable] of Object.entries(agentData.contextConfig.contextVariables)) if (variable && typeof variable === "object" && variable.id === componentId) return variable;
-				}
-			}
-			return null;
-		case "dataComponents": return project.dataComponents?.[componentId];
-		case "artifactComponents": return project.artifactComponents?.[componentId];
-		case "externalAgents": return project.externalAgents?.[componentId];
-		case "functions": return project.functions?.[componentId];
-		case "functionTools": return project.functionTools?.[componentId];
-		default: return null;
-	}
-}
-/**
-* Load project from temp directory and compare with remote project
-*/
-async function validateProjectEquivalence(tempDir, remoteProject) {
-	try {
-		const { loadProject } = await import("../../utils/project-loader.js");
-		const tempProject = await loadProject(tempDir);
-		const tempProjectDefinition = await Promise.race([tempProject.getFullDefinition(), new Promise((_, reject) => {
-			setTimeout(() => {
-				reject(/* @__PURE__ */ new Error("getFullDefinition() timed out after 30 seconds"));
-			}, 3e4);
-		})]);
-		enrichCanDelegateToWithTypes(tempProjectDefinition);
-		buildComponentRegistryFromParsing(tempDir, false);
-		const comparison = await compareProjects(tempProjectDefinition, remoteProject, true);
-		if (!comparison.hasChanges) return true;
-		let hasMeaningfulDifferences = false;
-		let hasAddedOrDeleted = false;
-		const meaningfulDiffs = [];
-		const addedComponents = [];
-		const deletedComponents = [];
-		for (const [componentType, changes] of Object.entries(comparison.componentChanges)) {
-			if (changes.added.length > 0) {
-				addedComponents.push({
-					type: componentType,
-					ids: changes.added
-				});
-				hasAddedOrDeleted = true;
-			}
-			if (changes.deleted.length > 0) {
-				deletedComponents.push({
-					type: componentType,
-					ids: changes.deleted
-				});
-				hasAddedOrDeleted = true;
-			}
-			if (changes.modified.length > 0) for (const modifiedId of changes.modified) {
-				const generatedComponent = getComponentFromProject(tempProjectDefinition, componentType, modifiedId);
-				const remoteComponent = getComponentFromProject(remoteProject, componentType, modifiedId);
-				if (generatedComponent && remoteComponent) {
-					const differences = findKeyDifferences(generatedComponent, remoteComponent);
-					if (differences.length > 0) {
-						meaningfulDiffs.push({
-							componentType,
-							componentId: modifiedId,
-							differences
-						});
-						hasMeaningfulDifferences = true;
-					}
-				} else if (!generatedComponent) {
-					meaningfulDiffs.push({
-						componentType,
-						componentId: modifiedId,
-						differences: [],
-						isMissing: "generated"
-					});
-					hasMeaningfulDifferences = true;
-				} else if (!remoteComponent) {
-					meaningfulDiffs.push({
-						componentType,
-						componentId: modifiedId,
-						differences: [],
-						isMissing: "remote"
-					});
-					hasMeaningfulDifferences = true;
-				}
-			}
-		}
-		if (!hasMeaningfulDifferences && !hasAddedOrDeleted) return true;
-		console.log(chalk.yellow(`      🔄 Found differences:`));
-		for (const { type, ids } of addedComponents) {
-			console.log(chalk.cyan(`         ${type}:`));
-			console.log(chalk.green(`           ➕ Added: ${ids.join(", ")}`));
-		}
-		for (const { type, ids } of deletedComponents) {
-			console.log(chalk.cyan(`         ${type}:`));
-			console.log(chalk.red(`           ➖ Deleted: ${ids.join(", ")}`));
-		}
-		const modifiedByType = /* @__PURE__ */ new Map();
-		for (const diff of meaningfulDiffs) {
-			const existing = modifiedByType.get(diff.componentType) ?? [];
-			existing.push(diff);
-			modifiedByType.set(diff.componentType, existing);
-		}
-		for (const [componentType, diffs] of modifiedByType) {
-			console.log(chalk.cyan(`         ${componentType}:`));
-			console.log(chalk.yellow(`           📝 Modified: ${diffs.map((d) => d.componentId).join(", ")}`));
-			for (const diff of diffs) {
-				console.log(chalk.gray(`              ${diff.componentId} detailed differences:`));
-				if (diff.isMissing === "generated") console.log(chalk.red(`                Component missing in generated project`));
-				else if (diff.isMissing === "remote") console.log(chalk.red(`                Component missing in remote project`));
-				else for (const d of diff.differences) console.log(chalk.gray(`                ${d}`));
-			}
-		}
-		return false;
-	} catch (error) {
-		const errorMsg = error instanceof Error ? error.message : String(error);
-		console.log(chalk.red(`   ❌ Project validation failed: ${errorMsg}`));
-		return false;
-	}
-}
-let isWaitingForInput = false;
-let currentKeypressHandler = null;
-async function validateTempDirectory(originalProjectRoot, tempDirName, remoteProject, options) {
-	const tempDir = join(originalProjectRoot, tempDirName);
-	const skipExit = options?.skipExit ?? false;
-	if (await validateProjectEquivalence(tempDir, remoteProject)) {
-		console.log(chalk.green(`\n✅ Project is already up to date - no meaningful changes detected`));
-		console.log(chalk.gray(`   Cleaning up temp directory...`));
-		try {
-			rmSync(tempDir, {
-				recursive: true,
-				force: true
-			});
-			console.log(chalk.gray(`   Temp directory cleaned up.`));
-		} catch {
-			console.log(chalk.yellow(`   Note: Could not clean up temp directory: ${tempDirName}`));
-		}
-		console.log(chalk.green(`\n🎉 Pull completed - project is up to date!`));
-		if (!skipExit) process.exit(0);
-		return {
-			success: true,
-			upToDate: true
-		};
-	}
-	console.log(chalk.yellow(`\n❓ Would you like to overwrite your project files with the generated files?`));
-	console.log(chalk.gray(`   This will replace your current files with the validated generated ones.`));
-	console.log(chalk.green(`   [Y] Yes - Replace files and clean up temp directory`));
-	console.log(chalk.red(`   [N] No - Keep temp directory for manual review`));
-	return new Promise((resolve$1) => {
-		if (isWaitingForInput && currentKeypressHandler) process.stdin.removeListener("data", currentKeypressHandler);
-		process.stdin.removeAllListeners("data");
-		process.stdin.removeAllListeners("keypress");
-		process.stdin.removeAllListeners("end");
-		if (process.stdin.isTTY && !process.stdin.isRaw) process.stdin.setRawMode(true);
-		if (process.stdin.isPaused()) process.stdin.resume();
-		process.stdin.setEncoding("utf8");
-		const onKeypress = (key) => {
-			if (!isWaitingForInput) return;
-			isWaitingForInput = false;
-			currentKeypressHandler = null;
-			process.stdin.removeAllListeners("data");
-			process.stdin.removeAllListeners("keypress");
-			process.stdin.removeAllListeners("end");
-			if (process.stdin.isTTY) process.stdin.setRawMode(false);
-			process.stdin.pause();
-			const normalizedKey = key.toLowerCase();
-			if (normalizedKey === "y") {
-				console.log(chalk.green(`\n✅ Selected: Yes - Replacing files...`));
-				overwriteProjectFiles(originalProjectRoot, tempDirName, tempDir);
-				console.log(chalk.green(`\n🎉 Pull completed successfully!`));
-				if (!skipExit) process.exit(0);
-				resolve$1({ success: true });
-			} else if (normalizedKey === "n") {
-				console.log(chalk.yellow(`\n❌ Selected: No - Files not replaced`));
-				console.log(chalk.gray(`📂 Generated files remain in: ${tempDirName}`));
-				console.log(chalk.gray(`   You can manually review and copy files as needed.`));
-				console.log(chalk.cyan(`\n✅ Pull completed - temp directory preserved for review.`));
-				if (!skipExit) process.exit(0);
-				resolve$1({
-					success: true,
-					userDeclined: true
-				});
-			} else {
-				console.log(chalk.red(`\n❌ Invalid key: "${key}". Please press Y or N.`));
-				console.log(chalk.gray(`📂 Files not replaced. Generated files remain in: ${tempDirName}`));
-				console.log(chalk.yellow(`\n⚠️ Pull completed with invalid input - temp directory preserved.`));
-				if (!skipExit) process.exit(0);
-				resolve$1({
-					success: true,
-					userDeclined: true
-				});
-			}
-		};
-		currentKeypressHandler = onKeypress;
-		isWaitingForInput = true;
-		process.stdin.once("data", onKeypress);
-		process.stdout.write(chalk.cyan("\nPress [Y] for Yes or [N] for No: "));
-	});
-}
-/**
-* Overwrite project files with validated temp directory files and clean up
-*/
-function overwriteProjectFiles(originalProjectRoot, tempDirName, tempDir) {
-	try {
-		console.log(chalk.cyan(`\n🔄 Replacing project files with generated files...`));
-		let filesReplaced = 0;
-		function copyRecursively(sourceDir, targetDir) {
-			if (!existsSync(sourceDir)) return;
-			const entries = readdirSync(sourceDir);
-			for (const entry of entries) {
-				if (entry.startsWith(".temp-") || entry.startsWith(".DS_Store") || entry === "node_modules" || entry === ".git" || entry === "tsconfig.json" || entry === "package.json") continue;
-				const sourcePath = join(sourceDir, entry);
-				const targetPath = join(targetDir, entry);
-				const stat = statSync(sourcePath);
-				if (stat.isDirectory()) copyRecursively(sourcePath, targetPath);
-				else if (stat.isFile()) {
-					mkdirSync(dirname(targetPath), { recursive: true });
-					copyFileSync(sourcePath, targetPath);
-					filesReplaced++;
-					const relativePath = targetPath.replace(`${originalProjectRoot}/`, "");
-					console.log(chalk.green(`   ✅ Replaced: ${relativePath}`));
-				}
-			}
-		}
-		copyRecursively(tempDir, originalProjectRoot);
-		console.log(chalk.cyan(`\n🧹 Cleaning up temp directory...`));
-		rmSync(tempDir, {
-			recursive: true,
-			force: true
-		});
-		console.log(chalk.green(`\n🎉 Successfully replaced ${filesReplaced} files!`));
-		console.log(chalk.gray(`   Your project files have been updated with the generated content.`));
-		console.log(chalk.gray(`   Temp directory cleaned up.`));
-	} catch (error) {
-		const errorMsg = error instanceof Error ? error.message : String(error);
-		console.log(chalk.red(`\n❌ Failed to overwrite project files: ${errorMsg}`));
-		console.log(chalk.yellow(`   Generated files remain in: ${tempDirName} for manual review`));
-	}
-}
-
-//#endregion
-export { validateTempDirectory };

package/dist/commands/pull-v3/targeted-typescript-placeholders.js

@@ -1,173 +0,0 @@
-import { Node, Project } from "ts-morph";
-import { randomBytes } from "node:crypto";
-
-//#region src/commands/pull-v3/targeted-typescript-placeholders.ts
-/**
-* Targeted TypeScript Placeholder System
-*
-* Uses AST parsing to intelligently identify large content blocks for replacement:
-* - prompt: (template literals or strings)
-* - description: (string literals)
-* - inputSchema: (object literals)
-* - detailsSchema: (object literals)
-* - props: (object literals in artifact/data components)
-*/
-/**
-* Generate a unique placeholder ID
-*/
-function generatePlaceholderId() {
-	return randomBytes(4).toString("hex").toUpperCase();
-}
-/**
-* Minimum length threshold for replacement (only replace if longer than this)
-*/
-const MIN_REPLACEMENT_LENGTH = 10;
-/**
-* Create targeted placeholders using AST parsing for better accuracy
-*/
-function createTargetedTypeScriptPlaceholders(content) {
-	const replacements = {};
-	let replacedFields = 0;
-	const originalSize = content.length;
-	try {
-		const sourceFile = new Project({ useInMemoryFileSystem: true }).createSourceFile("temp.ts", content);
-		const replacementOperations = [];
-		sourceFile.forEachDescendant((node) => {
-			if (Node.isPropertyAssignment(node)) {
-				const propertyName = node.getName();
-				const valueNode = node.getInitializer();
-				if (!valueNode) return;
-				let valueText = valueNode.getText();
-				if (valueText.trim().length < MIN_REPLACEMENT_LENGTH) return;
-				let placeholderPrefix = "";
-				switch (propertyName) {
-					case "prompt":
-						placeholderPrefix = "PROMPT";
-						break;
-					case "description":
-						placeholderPrefix = "DESC";
-						break;
-					case "inputSchema":
-						placeholderPrefix = "INPUT_SCHEMA";
-						break;
-					case "detailsSchema":
-						placeholderPrefix = "DETAILS_SCHEMA";
-						break;
-					case "props":
-						placeholderPrefix = "PROPS";
-						break;
-					case "render":
-						placeholderPrefix = "RENDER";
-						break;
-					default: return;
-				}
-				const start = valueNode.getStart();
-				let end = valueNode.getEnd();
-				const propertyEnd = node.getEnd();
-				if (propertyName === "inputSchema" || propertyName === "render") {
-					const searchStart = start;
-					let braceCount = 0;
-					let correctEnd = -1;
-					let inString = false;
-					let stringChar = "";
-					for (let i = searchStart; i < content.length; i++) {
-						const char = content[i];
-						const prevChar = i > 0 ? content[i - 1] : "";
-						if ((char === "\"" || char === "'") && prevChar !== "\\") {
-							if (!inString) {
-								inString = true;
-								stringChar = char;
-							} else if (char === stringChar) {
-								inString = false;
-								stringChar = "";
-							}
-						}
-						if (!inString) {
-							if (char === "{") braceCount++;
-							else if (char === "}") {
-								braceCount--;
-								if (braceCount === 0) {
-									let j = i + 1;
-									while (j < content.length && /\s/.test(content[j])) j++;
-									if (j < content.length && content[j] === ",") {
-										correctEnd = j + 1;
-										break;
-									}
-								}
-							}
-						}
-					}
-					if (correctEnd > start && correctEnd < end + 100) {
-						end = correctEnd;
-						valueText = content.slice(start, end);
-					}
-				} else if (!content.slice(end, end + 20).match(/^\s*[,}]/)) {
-					let correctEnd = end;
-					while (correctEnd > start && !content.slice(correctEnd, correctEnd + 10).match(/^\s*[,}]/)) correctEnd--;
-					if (correctEnd > start) {
-						end = correctEnd;
-						valueText = content.slice(start, end);
-					} else return;
-				}
-				if (end > propertyEnd) return;
-				const actualText = content.slice(start, end);
-				if (valueText !== actualText) return;
-				if (!content.slice(end, end + 20).match(/^\s*[,}]/)) return;
-				const placeholder = `<${placeholderPrefix}_${generatePlaceholderId()}>`;
-				replacements[placeholder] = valueText;
-				replacedFields++;
-				replacementOperations.push({
-					start,
-					end,
-					placeholder,
-					originalText: valueText
-				});
-			}
-		});
-		replacementOperations.sort((a, b) => b.start - a.start);
-		let processedContent = content;
-		for (const op of replacementOperations) processedContent = processedContent.slice(0, op.start) + op.placeholder + processedContent.slice(op.end);
-		const processedSize = processedContent.length;
-		const savings = originalSize - processedSize;
-		const savingsPercentage = originalSize > 0 ? savings / originalSize * 100 : 0;
-		return {
-			processedContent,
-			replacements,
-			stats: {
-				originalSize,
-				processedSize,
-				savings,
-				savingsPercentage,
-				replacedFields
-			}
-		};
-	} catch {
-		return {
-			processedContent: content,
-			replacements: {},
-			stats: {
-				originalSize,
-				processedSize: originalSize,
-				savings: 0,
-				savingsPercentage: 0,
-				replacedFields: 0
-			}
-		};
-	}
-}
-/**
-* Restore placeholders in TypeScript content
-*/
-function restoreTargetedTypeScriptPlaceholders(content, replacements) {
-	let restoredContent = content;
-	const sortedPlaceholders = Object.keys(replacements).sort((a, b) => b.length - a.length);
-	for (const placeholder of sortedPlaceholders) {
-		const originalValue = replacements[placeholder];
-		if (!restoredContent.includes(placeholder)) continue;
-		restoredContent = restoredContent.replace(placeholder, originalValue);
-	}
-	return restoredContent;
-}
-
-//#endregion
-export { createTargetedTypeScriptPlaceholders, restoreTargetedTypeScriptPlaceholders };