@inkeep/agents-cli 0.0.0-dev-20251219092754 → 0.0.0-dev-20251220003011

package/dist/index.js

@@ -2569,6 +2569,27 @@ const resourceIdSchema = z$3.string().min(MIN_ID_LENGTH).max(MAX_ID_LENGTH).desc
 	example: "resource_789"
 });
 resourceIdSchema.meta({ description: "Resource identifier" });
+/**
+* Creates a resource ID schema with custom description.
+* Inherits all validation from resourceIdSchema (min, max, regex pattern).
+* Use this to extend resourceIdSchema with entity-specific documentation.
+*
+* @example
+* // For Agent.defaultSubAgentId
+* createResourceIdSchema('ID of the default sub-agent. Workflow: ...', { example: 'my-subagent' })
+*
+* // For Tool.credentialReferenceId
+* createResourceIdSchema('Reference to credential for authentication', { example: 'cred-123' })
+*/
+function createResourceIdSchema(description, options) {
+	const example = options?.example ?? "resource_789";
+	const modified = z$3.string().min(MIN_ID_LENGTH).max(MAX_ID_LENGTH).describe(description).regex(URL_SAFE_ID_PATTERN, { message: "ID must contain only letters, numbers, hyphens, underscores, and dots" }).openapi({
+		description,
+		example
+	});
+	modified.meta({ description });
+	return modified;
+}
 const FIELD_MODIFIERS = {
 	id: (schema) => {
 		const modified = schema.min(MIN_ID_LENGTH).max(MAX_ID_LENGTH).describe("Resource identifier").regex(URL_SAFE_ID_PATTERN, { message: "ID must contain only letters, numbers, hyphens, underscores, and dots" }).openapi({
@@ -2818,9 +2839,11 @@ const ExternalSubAgentRelationInsertSchema = createInsertSchema(subAgentRelation
 });
 const ExternalSubAgentRelationApiInsertSchema = createApiInsertSchema(ExternalSubAgentRelationInsertSchema);
 const AgentSelectSchema = createSelectSchema(agents);
-const AgentInsertSchema = createInsertSchema(agents).extend({
-	id: resourceIdSchema,
-	name: z$3.string().trim().nonempty()
+const DEFAULT_SUB_AGENT_ID_DESCRIPTION = "ID of the default sub-agent that handles initial user messages. Required at runtime but nullable on creation to avoid circular FK dependency. Workflow: 1) POST Agent (without defaultSubAgentId), 2) POST SubAgent, 3) PATCH Agent with defaultSubAgentId.";
+const AgentInsertSchema = createInsertSchema(agents, {
+	id: () => resourceIdSchema,
+	name: () => z$3.string().trim().nonempty().describe("Agent name").openapi({ description: "Agent name" }),
+	defaultSubAgentId: () => createResourceIdSchema(DEFAULT_SUB_AGENT_ID_DESCRIPTION, { example: "my-default-subagent" }).nullable().optional()
 });
 const AgentUpdateSchema = AgentInsertSchema.partial();
 const AgentApiSelectSchema = createApiSchema(AgentSelectSchema).openapi("Agent");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-cli",
-  "version": "0.0.0-dev-20251219092754",
+  "version": "0.0.0-dev-20251220003011",
   "description": "Inkeep CLI tool",
   "type": "module",
   "main": "./dist/index.js",
@@ -55,8 +55,8 @@
     "tsx": "^4.20.5",
     "open": "^10.2.0",
     "yaml": "^2.7.0",
-    "@inkeep/agents-core": "^0.0.0-dev-20251219092754",
-    "@inkeep/agents-sdk": "^0.0.0-dev-20251219092754"
+    "@inkeep/agents-core": "^0.0.0-dev-20251220003011",
+    "@inkeep/agents-sdk": "^0.0.0-dev-20251220003011"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",
@@ -69,7 +69,7 @@
     "vitest": "^3.2.4"
   },
   "peerDependencies": {
-    "@inkeep/agents-manage-ui": "0.0.0-dev-20251219092754",
+    "@inkeep/agents-manage-ui": "0.0.0-dev-20251220003011",
     "zod": "^4.1.11"
   },
   "publishConfig": {