@inkeep/agents-cli 0.53.10 → 0.53.12

package/dist/agents-cli/package.js

@@ -1,6 +1,6 @@
 //#region package.json
 var name = "@inkeep/agents-cli";
-var version = "0.53.10";
+var version = "0.53.12";
 
 //#endregion
 export { name, version };

package/dist/commands/pull-v4/generators/sub-agent-generator.js

@@ -52,7 +52,7 @@ function generateSubAgentDefinition(data) {
 	if (hasHeadersTemplateVariables && parsed.contextConfigId && parsed.contextConfigHeadersReference && parsed.contextConfigHeadersReference.local !== true) namedImports.push(parsed.contextConfigHeadersReference.name);
 	if (namedImports.length > 0 && parsed.contextConfigId) sourceFile.addImportDeclaration({
 		namedImports: [...new Set(namedImports)],
-		moduleSpecifier: `../context-configs/${parsed.contextConfigId}`
+		moduleSpecifier: `../../context-configs/${parsed.contextConfigId}`
 	});
 	addCanUseToolImports(sourceFile, parsed.canUse, parsed.referenceOverrides?.tools);
 	addDataComponentImports(sourceFile, parsed.dataComponents, parsed.referenceOverrides?.dataComponents);

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

@@ -1,4 +1,4 @@
-import { collectTemplateVariableNames, createInMemoryProject, isPlainObject, toCamelCase } from "./utils.js";
+import { buildComponentFileName, collectTemplateVariableNames, createInMemoryProject, isPlainObject, toCamelCase } from "./utils.js";
 import { buildComponentRegistryFromParsing } from "./component-parser.js";
 import { generateAgentDefinition } from "./generators/agent-generator.js";
 import { generateArtifactComponentDefinition } from "./generators/artifact-component-generator.js";
@@ -109,7 +109,7 @@ function collectCredentialRecords(context) {
 	if (!context.project.credentialReferences) return [];
 	return Object.entries(context.project.credentialReferences).map(([credentialId, credentialData]) => ({
 		id: credentialId,
-		filePath: resolveRecordFilePath(context, "credentials", credentialId, join(context.paths.credentialsDir, `${credentialId}.ts`)),
+		filePath: resolveRecordFilePath(context, "credentials", credentialId, join(context.paths.credentialsDir, buildComponentFileName(credentialId, credentialData.name ?? void 0))),
 		payload: {
 			credentialId,
 			...credentialData
@@ -120,7 +120,7 @@ function collectArtifactComponentRecords(context) {
 	if (!context.project.artifactComponents) return [];
 	return Object.entries(context.project.artifactComponents).map(([artifactComponentId, artifactComponentData]) => ({
 		id: artifactComponentId,
-		filePath: resolveRecordFilePath(context, "artifactComponents", artifactComponentId, join(context.paths.artifactComponentsDir, `${artifactComponentId}.ts`)),
+		filePath: resolveRecordFilePath(context, "artifactComponents", artifactComponentId, join(context.paths.artifactComponentsDir, buildComponentFileName(artifactComponentId, artifactComponentData.name ?? void 0))),
 		payload: {
 			artifactComponentId,
 			...artifactComponentData
@@ -131,7 +131,7 @@ function collectDataComponentRecords(context) {
 	if (!context.project.dataComponents) return [];
 	return Object.entries(context.project.dataComponents).map(([dataComponentId, dataComponent]) => ({
 		id: dataComponentId,
-		filePath: resolveRecordFilePath(context, "dataComponents", dataComponentId, join(context.paths.dataComponentsDir, `${dataComponentId}.ts`)),
+		filePath: resolveRecordFilePath(context, "dataComponents", dataComponentId, join(context.paths.dataComponentsDir, buildComponentFileName(dataComponentId, dataComponent.name ?? void 0))),
 		payload: {
 			dataComponentId,
 			...dataComponent
@@ -169,7 +169,7 @@ function collectContextConfigRecords(context) {
 function collectToolRecords(context) {
 	return Object.entries(context.project.tools ?? {}).map(([toolId, toolData]) => ({
 		id: toolId,
-		filePath: resolveRecordFilePath(context, "tools", toolId, join(context.paths.toolsDir, `${toolId}.ts`)),
+		filePath: resolveRecordFilePath(context, "tools", toolId, join(context.paths.toolsDir, buildComponentFileName(toolId, toolData.name ?? void 0))),
 		payload: {
 			mcpToolId: toolId,
 			...toolData
@@ -228,7 +228,7 @@ function collectTriggerRecords(context) {
 		if (!agentData?.triggers) continue;
 		for (const [triggerId, triggerData] of Object.entries(agentData.triggers)) records.push({
 			id: triggerId,
-			filePath: resolveRecordFilePath(context, "triggers", triggerId, join(context.paths.agentsDir, "triggers", `${triggerId}.ts`)),
+			filePath: resolveRecordFilePath(context, "triggers", triggerId, join(context.paths.agentsDir, "triggers", buildComponentFileName(triggerId, triggerData.name ?? void 0))),
 			payload: {
 				triggerId,
 				...triggerData
@@ -245,7 +245,7 @@ function collectScheduledTriggerRecords(context) {
 		if (!agentData?.scheduledTriggers) continue;
 		for (const [scheduledTriggerId, scheduledTriggerData] of Object.entries(agentData.scheduledTriggers)) records.push({
 			id: scheduledTriggerId,
-			filePath: resolveRecordFilePath(context, "scheduledTriggers", scheduledTriggerId, join(context.paths.agentsDir, "scheduled-triggers", `${scheduledTriggerId}.ts`)),
+			filePath: resolveRecordFilePath(context, "scheduledTriggers", scheduledTriggerId, join(context.paths.agentsDir, "scheduled-triggers", buildComponentFileName(scheduledTriggerId, scheduledTriggerData.name ?? void 0))),
 			payload: {
 				scheduledTriggerId,
 				...scheduledTriggerData
@@ -260,7 +260,8 @@ function collectAgentRecords(context) {
 	for (const agentId of context.completeAgentIds) {
 		const agentData = context.project.agents[agentId];
 		if (!agentData) continue;
-		const agentFilePath = resolveRecordFilePath(context, "agents", agentId, join(context.paths.agentsDir, `${agentId}.ts`));
+		const agentName = typeof agentData.name === "string" ? agentData.name : void 0;
+		const agentFilePath = resolveRecordFilePath(context, "agents", agentId, join(context.paths.agentsDir, buildComponentFileName(agentId, agentName)));
 		const existingAgent = context.existingComponentRegistry?.get(agentId, "agents");
 		const subAgentReferences = collectSubAgentReferenceOverrides(context, agentData, agentFilePath);
 		const statusUpdates = asRecord(agentData.statusUpdates);
@@ -291,7 +292,8 @@ function collectSubAgentRecords(context) {
 			const payload = asRecord(subAgentData);
 			if (!payload) continue;
 			const referenceOverrides = collectSubAgentDependencyReferenceOverrides(context, payload);
-			const subAgentFilePath = resolveRecordFilePath(context, "subAgents", subAgentId, join(context.paths.agentsDir, "sub-agents", `${subAgentId}.ts`));
+			const subAgentName = typeof payload.name === "string" ? payload.name : void 0;
+			const subAgentFilePath = resolveRecordFilePath(context, "subAgents", subAgentId, join(context.paths.agentsDir, "sub-agents", buildComponentFileName(subAgentId, subAgentName)));
 			const contextTemplateReferences = collectContextTemplateReferences(context, agentData, subAgentFilePath, [typeof payload.prompt === "string" ? payload.prompt : void 0]);
 			records.push({
 				id: subAgentId,
@@ -323,9 +325,10 @@ function collectStatusComponentRecords(context) {
 			if (!payload) continue;
 			const statusComponentId = resolveStatusComponentId(payload);
 			if (!statusComponentId || statusComponentRecordsById.has(statusComponentId)) continue;
+			const statusComponentName = typeof payload.name === "string" ? payload.name : void 0;
 			statusComponentRecordsById.set(statusComponentId, {
 				id: statusComponentId,
-				filePath: resolveRecordFilePath(context, "statusComponents", statusComponentId, join(context.paths.statusComponentsDir, `${statusComponentId}.ts`)),
+				filePath: resolveRecordFilePath(context, "statusComponents", statusComponentId, join(context.paths.statusComponentsDir, buildComponentFileName(statusComponentId, statusComponentName))),
 				payload: {
 					statusComponentId,
 					...payload

package/dist/commands/pull-v4/utils.js

@@ -55,6 +55,29 @@ function toCamelCase(input) {
 	const result = input.replace(/[^a-zA-Z0-9](.)/g, (_, char) => char.toUpperCase()).replace(/^[0-9]/, "_$&");
 	return result.charAt(0).toLowerCase() + result.slice(1);
 }
+function toKebabCase(input) {
+	return input.trim().replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-+|-+$/g, "").toLowerCase();
+}
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const CUID_RE = /^c[a-z0-9]{24,}$/;
+const NANOID_RE = /^[a-z0-9]{16,}$/;
+function isHumanReadableId(id) {
+	if (UUID_RE.test(id) || CUID_RE.test(id) || NANOID_RE.test(id)) return false;
+	const segments = id.split(/[-_]/);
+	if (segments.length === 1 && id.length > 8) {
+		const hasLetters = /[a-zA-Z]/.test(id);
+		const hasDigits = /[0-9]/.test(id);
+		if (hasLetters && hasDigits) return false;
+	}
+	return segments.filter((s) => /^[a-zA-Z]+\d{0,2}$/.test(s)).length / segments.length >= .5;
+}
+const ID_SUFFIX_LENGTH = 8;
+function buildComponentFileName(id, name) {
+	if (!name || isHumanReadableId(id)) return `${id}.ts`;
+	const kebabName = toKebabCase(name);
+	if (!kebabName || kebabName === id) return `${id}.ts`;
+	return `${kebabName}-${id.slice(-ID_SUFFIX_LENGTH)}.ts`;
+}
 function createUniqueReferenceName(baseName, reservedNames, conflictSuffix) {
 	if (!reservedNames.has(baseName)) {
 		reservedNames.add(baseName);
@@ -232,4 +255,4 @@ function hasReferences(references) {
 }
 
 //#endregion
-export { TEMPLATE_VARIABLE_REGEX, addFactoryConfigVariable, addObjectEntries, addReferenceGetterProperty, addStringProperty, addValueToObject, collectTemplateVariableNames, convertJsonSchemaToZodSafe, convertNullToUndefined, createFactoryDefinition, createInMemoryProject, createUniqueReferenceName, expectSnapshots, formatInlineLiteral, formatPropertyName, formatStringLiteral, formatTemplate, hasReferences, isPlainObject, resolveReferenceName, toCamelCase };
+export { TEMPLATE_VARIABLE_REGEX, addFactoryConfigVariable, addObjectEntries, addReferenceGetterProperty, addStringProperty, addValueToObject, buildComponentFileName, collectTemplateVariableNames, convertJsonSchemaToZodSafe, convertNullToUndefined, createFactoryDefinition, createInMemoryProject, createUniqueReferenceName, expectSnapshots, formatInlineLiteral, formatPropertyName, formatStringLiteral, formatTemplate, hasReferences, isHumanReadableId, isPlainObject, resolveReferenceName, toCamelCase, toKebabCase };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-cli",
-  "version": "0.53.10",
+  "version": "0.53.12",
   "description": "Inkeep CLI tool",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,8 +37,8 @@
     "tsx": "^4.20.5",
     "yaml": "^2.7.0",
     "zod": "^4.3.6",
-    "@inkeep/agents-core": "^0.53.10",
-    "@inkeep/agents-sdk": "^0.53.10"
+    "@inkeep/agents-core": "^0.53.12",
+    "@inkeep/agents-sdk": "^0.53.12"
   },
   "devDependencies": {
     "diff": "^8.0.3",