@inkeep/agents-cli 0.0.0-dev-20251021164445 → 0.0.0-dev-20251021181503

package/dist/index.js

@@ -21,11 +21,11 @@ var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
-var __copyProps = (to, from, except, desc15) => {
+var __copyProps = (to, from, except, desc16) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
       if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc15 = __getOwnPropDesc(from, key)) || desc15.enumerable });
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc16 = __getOwnPropDesc(from, key)) || desc16.enumerable });
   }
   return to;
 };
@@ -1584,7 +1584,7 @@ import {
   text,
   unique
 } from "drizzle-orm/sqlite-core";
-var tenantScoped, projectScoped, agentScoped, subAgentScoped, uiProperties, timestamps, projects, agents, contextConfigs, contextCache, subAgents, subAgentRelations, externalAgents, tasks, taskRelations, dataComponents, subAgentDataComponents, artifactComponents, subAgentArtifactComponents, tools, functionTools, functions, subAgentToolRelations, subAgentFunctionToolRelations, conversations, messages, ledgerArtifacts, apiKeys, credentialReferences, tasksRelations, projectsRelations, taskRelationsRelations, contextConfigsRelations, contextCacheRelations, subAgentsRelations, agentRelations, externalAgentsRelations, apiKeysRelations, agentToolRelationsRelations, credentialReferencesRelations, toolsRelations, conversationsRelations, messagesRelations, artifactComponentsRelations, subAgentArtifactComponentsRelations, dataComponentsRelations, subAgentDataComponentsRelations, ledgerArtifactsRelations, functionsRelations, subAgentRelationsRelations, functionToolsRelations, subAgentFunctionToolRelationsRelations;
+var tenantScoped, projectScoped, agentScoped, subAgentScoped, uiProperties, timestamps, projects, agents, contextConfigs, contextCache, subAgents, subAgentRelations, externalAgents, tasks, taskRelations, dataComponents, subAgentDataComponents, artifactComponents, subAgentArtifactComponents, tools, functionTools, functions, subAgentToolRelations, subAgentExternalAgentRelations, subAgentFunctionToolRelations, conversations, messages, ledgerArtifacts, apiKeys, credentialReferences, tasksRelations, projectsRelations, taskRelationsRelations, contextConfigsRelations, contextCacheRelations, subAgentsRelations, agentRelations, externalAgentsRelations, apiKeysRelations, agentToolRelationsRelations, credentialReferencesRelations, toolsRelations, conversationsRelations, messagesRelations, artifactComponentsRelations, subAgentArtifactComponentsRelations, dataComponentsRelations, subAgentDataComponentsRelations, ledgerArtifactsRelations, functionsRelations, subAgentRelationsRelations, functionToolsRelations, subAgentFunctionToolRelationsRelations, subAgentExternalAgentRelationsRelations;
 var init_schema = __esm({
   "../packages/agents-core/src/db/schema.ts"() {
     "use strict";
@@ -1720,7 +1720,6 @@ var init_schema = __esm({
         ...agentScoped,
         sourceSubAgentId: text("source_sub_agent_id").notNull(),
         targetSubAgentId: text("target_sub_agent_id"),
-        externalSubAgentId: text("external_sub_agent_id"),
         relationType: text("relation_type"),
         ...timestamps
       },
@@ -1736,19 +1735,18 @@ var init_schema = __esm({
     externalAgents = sqliteTable(
       "external_agents",
       {
-        ...agentScoped,
+        ...projectScoped,
         ...uiProperties,
         baseUrl: text("base_url").notNull(),
         credentialReferenceId: text("credential_reference_id"),
-        headers: blob("headers", { mode: "json" }).$type(),
         ...timestamps
       },
       (table) => [
-        primaryKey({ columns: [table.tenantId, table.projectId, table.agentId, table.id] }),
+        primaryKey({ columns: [table.tenantId, table.projectId, table.id] }),
         foreignKey({
-          columns: [table.tenantId, table.projectId, table.agentId],
-          foreignColumns: [agents.tenantId, agents.projectId, agents.id],
-          name: "external_agents_agent_fk"
+          columns: [table.tenantId, table.projectId],
+          foreignColumns: [projects.tenantId, projects.id],
+          name: "external_agents_project_fk"
         }).onDelete("cascade"),
         foreignKey({
           columns: [table.tenantId, table.projectId, table.credentialReferenceId],
@@ -1967,6 +1965,28 @@ var init_schema = __esm({
         }).onDelete("cascade")
       ]
     );
+    subAgentExternalAgentRelations = sqliteTable(
+      "sub_agent_external_agent_relations",
+      {
+        ...subAgentScoped,
+        externalAgentId: text("external_agent_id").notNull(),
+        headers: blob("headers", { mode: "json" }).$type(),
+        ...timestamps
+      },
+      (table) => [
+        primaryKey({ columns: [table.tenantId, table.projectId, table.agentId, table.id] }),
+        foreignKey({
+          columns: [table.tenantId, table.projectId, table.agentId, table.subAgentId],
+          foreignColumns: [subAgents.tenantId, subAgents.projectId, subAgents.agentId, subAgents.id],
+          name: "sub_agent_external_agent_relations_sub_agent_fk"
+        }).onDelete("cascade"),
+        foreignKey({
+          columns: [table.tenantId, table.projectId, table.externalAgentId],
+          foreignColumns: [externalAgents.tenantId, externalAgents.projectId, externalAgents.id],
+          name: "sub_agent_external_agent_relations_external_agent_fk"
+        }).onDelete("cascade")
+      ]
+    );
     subAgentFunctionToolRelations = sqliteTable(
       "sub_agent_function_tool_relations",
       {
@@ -2228,7 +2248,7 @@ var init_schema = __esm({
         fields: [externalAgents.tenantId, externalAgents.projectId],
         references: [projects.tenantId, projects.id]
       }),
-      subAgentRelations: many(subAgentRelations),
+      subAgentExternalAgentRelations: many(subAgentExternalAgentRelations),
       credentialReference: one(credentialReferences, {
         fields: [externalAgents.credentialReferenceId],
         references: [credentialReferences.id]
@@ -2300,13 +2320,13 @@ var init_schema = __esm({
         relationName: "receivedMessages"
       }),
       fromExternalAgent: one(externalAgents, {
-        fields: [messages.fromExternalAgentId],
-        references: [externalAgents.id],
+        fields: [messages.tenantId, messages.projectId, messages.fromExternalAgentId],
+        references: [externalAgents.tenantId, externalAgents.projectId, externalAgents.id],
         relationName: "receivedExternalMessages"
       }),
       toExternalAgent: one(externalAgents, {
-        fields: [messages.toExternalAgentId],
-        references: [externalAgents.id],
+        fields: [messages.tenantId, messages.projectId, messages.toExternalAgentId],
+        references: [externalAgents.tenantId, externalAgents.projectId, externalAgents.id],
         relationName: "sentExternalMessages"
       }),
       task: one(tasks, {
@@ -2390,10 +2410,6 @@ var init_schema = __esm({
         fields: [subAgentRelations.targetSubAgentId],
         references: [subAgents.id],
         relationName: "targetRelations"
-      }),
-      externalAgent: one(externalAgents, {
-        fields: [subAgentRelations.externalSubAgentId],
-        references: [externalAgents.id]
       })
     }));
     functionToolsRelations = relations(functionTools, ({ one, many }) => ({
@@ -2424,6 +2440,28 @@ var init_schema = __esm({
         })
       })
     );
+    subAgentExternalAgentRelationsRelations = relations(
+      subAgentExternalAgentRelations,
+      ({ one }) => ({
+        subAgent: one(subAgents, {
+          fields: [
+            subAgentExternalAgentRelations.tenantId,
+            subAgentExternalAgentRelations.projectId,
+            subAgentExternalAgentRelations.agentId,
+            subAgentExternalAgentRelations.subAgentId
+          ],
+          references: [subAgents.tenantId, subAgents.projectId, subAgents.agentId, subAgents.id]
+        }),
+        externalAgent: one(externalAgents, {
+          fields: [
+            subAgentExternalAgentRelations.tenantId,
+            subAgentExternalAgentRelations.projectId,
+            subAgentExternalAgentRelations.externalAgentId
+          ],
+          references: [externalAgents.tenantId, externalAgents.projectId, externalAgents.id]
+        })
+      })
+    );
   }
 });
 
@@ -2452,7 +2490,7 @@ var init_utility = __esm({
 });
 
 // ../packages/agents-core/src/validation/schemas.ts
-var StopWhenSchema, AgentStopWhenSchema, SubAgentStopWhenSchema, MIN_ID_LENGTH, MAX_ID_LENGTH, URL_SAFE_ID_PATTERN, resourceIdSchema, ModelSettingsSchema, ModelSchema, ProjectModelSchema, FunctionToolConfigSchema, createApiSchema, createApiInsertSchema, createApiUpdateSchema, createAgentScopedApiSchema, createAgentScopedApiInsertSchema, createAgentScopedApiUpdateSchema, SubAgentSelectSchema, SubAgentInsertSchema, SubAgentUpdateSchema, SubAgentApiSelectSchema, SubAgentApiInsertSchema, SubAgentApiUpdateSchema, SubAgentRelationSelectSchema, SubAgentRelationInsertSchema, SubAgentRelationUpdateSchema, SubAgentRelationApiSelectSchema, SubAgentRelationApiInsertSchema, SubAgentRelationApiUpdateSchema, SubAgentRelationQuerySchema, ExternalSubAgentRelationInsertSchema, ExternalSubAgentRelationApiInsertSchema, AgentSelectSchema, AgentInsertSchema, AgentUpdateSchema, AgentApiSelectSchema, AgentApiInsertSchema, AgentApiUpdateSchema, TaskSelectSchema, TaskInsertSchema, TaskUpdateSchema, TaskApiSelectSchema, TaskApiInsertSchema, TaskApiUpdateSchema, TaskRelationSelectSchema, TaskRelationInsertSchema, TaskRelationUpdateSchema, TaskRelationApiSelectSchema, TaskRelationApiInsertSchema, TaskRelationApiUpdateSchema, imageUrlSchema, McpTransportConfigSchema, ToolStatusSchema, McpToolDefinitionSchema, ToolSelectSchema, ToolInsertSchema, ConversationSelectSchema, ConversationInsertSchema, ConversationUpdateSchema, ConversationApiSelectSchema, ConversationApiInsertSchema, ConversationApiUpdateSchema, MessageSelectSchema, MessageInsertSchema, MessageUpdateSchema, MessageApiSelectSchema, MessageApiInsertSchema, MessageApiUpdateSchema, ContextCacheSelectSchema, ContextCacheInsertSchema, ContextCacheUpdateSchema, ContextCacheApiSelectSchema, ContextCacheApiInsertSchema, ContextCacheApiUpdateSchema, DataComponentSelectSchema, DataComponentInsertSchema, DataComponentBaseSchema, DataComponentUpdateSchema, DataComponentApiSelectSchema, DataComponentApiInsertSchema, DataComponentApiUpdateSchema, SubAgentDataComponentSelectSchema, SubAgentDataComponentInsertSchema, SubAgentDataComponentUpdateSchema, SubAgentDataComponentApiSelectSchema, SubAgentDataComponentApiInsertSchema, SubAgentDataComponentApiUpdateSchema, ArtifactComponentSelectSchema, ArtifactComponentInsertSchema, ArtifactComponentUpdateSchema, ArtifactComponentApiSelectSchema, ArtifactComponentApiInsertSchema, ArtifactComponentApiUpdateSchema, SubAgentArtifactComponentSelectSchema, SubAgentArtifactComponentInsertSchema, SubAgentArtifactComponentUpdateSchema, SubAgentArtifactComponentApiSelectSchema, SubAgentArtifactComponentApiInsertSchema, SubAgentArtifactComponentApiUpdateSchema, ExternalAgentSelectSchema, ExternalAgentInsertSchema, ExternalAgentUpdateSchema, ExternalAgentApiSelectSchema, ExternalAgentApiInsertSchema, ExternalAgentApiUpdateSchema, AllAgentSchema, ApiKeySelectSchema, ApiKeyInsertSchema, ApiKeyUpdateSchema, ApiKeyApiSelectSchema, ApiKeyApiCreationResponseSchema, ApiKeyApiInsertSchema, ApiKeyApiUpdateSchema, CredentialReferenceSelectSchema, CredentialReferenceInsertSchema, CredentialReferenceUpdateSchema, CredentialReferenceApiSelectSchema, CredentialReferenceApiInsertSchema, CredentialReferenceApiUpdateSchema, McpToolSchema, MCPToolConfigSchema, ToolUpdateSchema, ToolApiSelectSchema, ToolApiInsertSchema, ToolApiUpdateSchema, FunctionToolSelectSchema, FunctionToolInsertSchema, FunctionToolUpdateSchema, FunctionToolApiSelectSchema, FunctionToolApiInsertSchema, FunctionToolApiUpdateSchema, FunctionSelectSchema, FunctionInsertSchema, FunctionUpdateSchema, FunctionApiSelectSchema, FunctionApiInsertSchema, FunctionApiUpdateSchema, FetchConfigSchema, FetchDefinitionSchema, ContextConfigSelectSchema, ContextConfigInsertSchema, ContextConfigUpdateSchema, ContextConfigApiSelectSchema, ContextConfigApiInsertSchema, ContextConfigApiUpdateSchema, SubAgentToolRelationSelectSchema, SubAgentToolRelationInsertSchema, SubAgentToolRelationUpdateSchema, SubAgentToolRelationApiSelectSchema, SubAgentToolRelationApiInsertSchema, SubAgentToolRelationApiUpdateSchema, LedgerArtifactSelectSchema, LedgerArtifactInsertSchema, LedgerArtifactUpdateSchema, LedgerArtifactApiSelectSchema, LedgerArtifactApiInsertSchema, LedgerArtifactApiUpdateSchema, StatusComponentSchema, StatusUpdateSchema, CanUseItemSchema, FullAgentAgentInsertSchema, AgentWithinContextOfProjectSchema, PaginationSchema, ErrorResponseSchema, ExistsResponseSchema, RemovedResponseSchema, ProjectSelectSchema, ProjectInsertSchema, ProjectUpdateSchema, ProjectApiSelectSchema, ProjectApiInsertSchema, ProjectApiUpdateSchema, FullProjectDefinitionSchema, ProjectResponse, SubAgentResponse, AgentResponse, ToolResponse, ExternalAgentResponse, ContextConfigResponse, ApiKeyResponse, CredentialReferenceResponse, FunctionResponse, FunctionToolResponse, DataComponentResponse, ArtifactComponentResponse, SubAgentRelationResponse, SubAgentToolRelationResponse, ConversationResponse, MessageResponse, ProjectListResponse, SubAgentListResponse, AgentListResponse, ToolListResponse, ExternalAgentListResponse, ContextConfigListResponse, ApiKeyListResponse, CredentialReferenceListResponse, FunctionListResponse, FunctionToolListResponse, DataComponentListResponse, ArtifactComponentListResponse, SubAgentRelationListResponse, SubAgentToolRelationListResponse, ConversationListResponse, MessageListResponse, SubAgentDataComponentResponse, SubAgentArtifactComponentResponse, SubAgentDataComponentListResponse, SubAgentArtifactComponentListResponse, HeadersScopeSchema, TenantId, ProjectId, AgentId, SubAgentId, TenantParamsSchema, TenantIdParamsSchema, TenantProjectParamsSchema, TenantProjectIdParamsSchema, TenantProjectAgentParamsSchema, TenantProjectAgentIdParamsSchema, TenantProjectAgentSubAgentParamsSchema, TenantProjectAgentSubAgentIdParamsSchema, PaginationQueryParamsSchema;
+var StopWhenSchema, AgentStopWhenSchema, SubAgentStopWhenSchema, MIN_ID_LENGTH, MAX_ID_LENGTH, URL_SAFE_ID_PATTERN, resourceIdSchema, ModelSettingsSchema, ModelSchema, ProjectModelSchema, FunctionToolConfigSchema, createApiSchema, createApiInsertSchema, createApiUpdateSchema, createAgentScopedApiSchema, createAgentScopedApiInsertSchema, createAgentScopedApiUpdateSchema, SubAgentSelectSchema, SubAgentInsertSchema, SubAgentUpdateSchema, SubAgentApiSelectSchema, SubAgentApiInsertSchema, SubAgentApiUpdateSchema, SubAgentRelationSelectSchema, SubAgentRelationInsertSchema, SubAgentRelationUpdateSchema, SubAgentRelationApiSelectSchema, SubAgentRelationApiInsertSchema, SubAgentRelationApiUpdateSchema, SubAgentRelationQuerySchema, ExternalSubAgentRelationInsertSchema, ExternalSubAgentRelationApiInsertSchema, AgentSelectSchema, AgentInsertSchema, AgentUpdateSchema, AgentApiSelectSchema, AgentApiInsertSchema, AgentApiUpdateSchema, TaskSelectSchema, TaskInsertSchema, TaskUpdateSchema, TaskApiSelectSchema, TaskApiInsertSchema, TaskApiUpdateSchema, TaskRelationSelectSchema, TaskRelationInsertSchema, TaskRelationUpdateSchema, TaskRelationApiSelectSchema, TaskRelationApiInsertSchema, TaskRelationApiUpdateSchema, imageUrlSchema, McpTransportConfigSchema, ToolStatusSchema, McpToolDefinitionSchema, ToolSelectSchema, ToolInsertSchema, ConversationSelectSchema, ConversationInsertSchema, ConversationUpdateSchema, ConversationApiSelectSchema, ConversationApiInsertSchema, ConversationApiUpdateSchema, MessageSelectSchema, MessageInsertSchema, MessageUpdateSchema, MessageApiSelectSchema, MessageApiInsertSchema, MessageApiUpdateSchema, ContextCacheSelectSchema, ContextCacheInsertSchema, ContextCacheUpdateSchema, ContextCacheApiSelectSchema, ContextCacheApiInsertSchema, ContextCacheApiUpdateSchema, DataComponentSelectSchema, DataComponentInsertSchema, DataComponentBaseSchema, DataComponentUpdateSchema, DataComponentApiSelectSchema, DataComponentApiInsertSchema, DataComponentApiUpdateSchema, SubAgentDataComponentSelectSchema, SubAgentDataComponentInsertSchema, SubAgentDataComponentUpdateSchema, SubAgentDataComponentApiSelectSchema, SubAgentDataComponentApiInsertSchema, SubAgentDataComponentApiUpdateSchema, ArtifactComponentSelectSchema, ArtifactComponentInsertSchema, ArtifactComponentUpdateSchema, ArtifactComponentApiSelectSchema, ArtifactComponentApiInsertSchema, ArtifactComponentApiUpdateSchema, SubAgentArtifactComponentSelectSchema, SubAgentArtifactComponentInsertSchema, SubAgentArtifactComponentUpdateSchema, SubAgentArtifactComponentApiSelectSchema, SubAgentArtifactComponentApiInsertSchema, SubAgentArtifactComponentApiUpdateSchema, ExternalAgentSelectSchema, ExternalAgentInsertSchema, ExternalAgentUpdateSchema, ExternalAgentApiSelectSchema, ExternalAgentApiInsertSchema, ExternalAgentApiUpdateSchema, AllAgentSchema, ApiKeySelectSchema, ApiKeyInsertSchema, ApiKeyUpdateSchema, ApiKeyApiSelectSchema, ApiKeyApiCreationResponseSchema, ApiKeyApiInsertSchema, ApiKeyApiUpdateSchema, CredentialReferenceSelectSchema, CredentialReferenceInsertSchema, CredentialReferenceUpdateSchema, CredentialReferenceApiSelectSchema, CredentialReferenceApiInsertSchema, CredentialReferenceApiUpdateSchema, McpToolSchema, MCPToolConfigSchema, ToolUpdateSchema, ToolApiSelectSchema, ToolApiInsertSchema, ToolApiUpdateSchema, FunctionToolSelectSchema, FunctionToolInsertSchema, FunctionToolUpdateSchema, FunctionToolApiSelectSchema, FunctionToolApiInsertSchema, FunctionToolApiUpdateSchema, FunctionSelectSchema, FunctionInsertSchema, FunctionUpdateSchema, FunctionApiSelectSchema, FunctionApiInsertSchema, FunctionApiUpdateSchema, FetchConfigSchema, FetchDefinitionSchema, ContextConfigSelectSchema, ContextConfigInsertSchema, ContextConfigUpdateSchema, ContextConfigApiSelectSchema, ContextConfigApiInsertSchema, ContextConfigApiUpdateSchema, SubAgentToolRelationSelectSchema, SubAgentToolRelationInsertSchema, SubAgentToolRelationUpdateSchema, SubAgentToolRelationApiSelectSchema, SubAgentToolRelationApiInsertSchema, SubAgentToolRelationApiUpdateSchema, SubAgentExternalAgentRelationSelectSchema, SubAgentExternalAgentRelationInsertSchema, SubAgentExternalAgentRelationUpdateSchema, SubAgentExternalAgentRelationApiSelectSchema, SubAgentExternalAgentRelationApiInsertSchema, SubAgentExternalAgentRelationApiUpdateSchema, LedgerArtifactSelectSchema, LedgerArtifactInsertSchema, LedgerArtifactUpdateSchema, LedgerArtifactApiSelectSchema, LedgerArtifactApiInsertSchema, LedgerArtifactApiUpdateSchema, StatusComponentSchema, StatusUpdateSchema, CanUseItemSchema, canDelegateToExternalAgentSchema, FullAgentAgentInsertSchema, AgentWithinContextOfProjectSchema, PaginationSchema, ErrorResponseSchema, ExistsResponseSchema, RemovedResponseSchema, ProjectSelectSchema, ProjectInsertSchema, ProjectUpdateSchema, ProjectApiSelectSchema, ProjectApiInsertSchema, ProjectApiUpdateSchema, FullProjectDefinitionSchema, ProjectResponse, SubAgentResponse, AgentResponse, ToolResponse, ExternalAgentResponse, ContextConfigResponse, ApiKeyResponse, CredentialReferenceResponse, FunctionResponse, FunctionToolResponse, DataComponentResponse, ArtifactComponentResponse, SubAgentRelationResponse, SubAgentToolRelationResponse, ConversationResponse, MessageResponse, ProjectListResponse, SubAgentListResponse, AgentListResponse, ToolListResponse, ExternalAgentListResponse, ContextConfigListResponse, ApiKeyListResponse, CredentialReferenceListResponse, FunctionListResponse, FunctionToolListResponse, DataComponentListResponse, ArtifactComponentListResponse, SubAgentRelationListResponse, SubAgentToolRelationListResponse, ConversationListResponse, MessageListResponse, SubAgentDataComponentResponse, SubAgentArtifactComponentResponse, SubAgentDataComponentListResponse, SubAgentArtifactComponentListResponse, HeadersScopeSchema, TenantId, ProjectId, AgentId, SubAgentId, TenantParamsSchema, TenantIdParamsSchema, TenantProjectParamsSchema, TenantProjectIdParamsSchema, TenantProjectAgentParamsSchema, TenantProjectAgentIdParamsSchema, TenantProjectAgentSubAgentParamsSchema, TenantProjectAgentSubAgentIdParamsSchema, PaginationQueryParamsSchema;
 var init_schemas = __esm({
   "../packages/agents-core/src/validation/schemas.ts"() {
     "use strict";
@@ -2754,16 +2792,15 @@ var init_schemas = __esm({
       SubAgentArtifactComponentUpdateSchema
     );
     ExternalAgentSelectSchema = createSelectSchema(externalAgents).extend({
-      credentialReferenceId: z2.string().nullable().optional(),
-      headers: z2.record(z2.string(), z2.string()).nullable().optional()
+      credentialReferenceId: z2.string().nullable().optional()
     });
     ExternalAgentInsertSchema = createInsertSchema(externalAgents).extend({
       id: resourceIdSchema
     });
     ExternalAgentUpdateSchema = ExternalAgentInsertSchema.partial();
-    ExternalAgentApiSelectSchema = createAgentScopedApiSchema(ExternalAgentSelectSchema).openapi("ExternalAgent");
-    ExternalAgentApiInsertSchema = createAgentScopedApiInsertSchema(ExternalAgentInsertSchema).openapi("ExternalAgentCreate");
-    ExternalAgentApiUpdateSchema = createAgentScopedApiUpdateSchema(ExternalAgentUpdateSchema).openapi("ExternalAgentUpdate");
+    ExternalAgentApiSelectSchema = createApiSchema(ExternalAgentSelectSchema).openapi("ExternalAgent");
+    ExternalAgentApiInsertSchema = createApiInsertSchema(ExternalAgentInsertSchema).openapi("ExternalAgentCreate");
+    ExternalAgentApiUpdateSchema = createApiUpdateSchema(ExternalAgentUpdateSchema).openapi("ExternalAgentUpdate");
     AllAgentSchema = z2.discriminatedUnion("type", [
       SubAgentApiSelectSchema.extend({ type: z2.literal("internal") }),
       ExternalAgentApiSelectSchema.extend({ type: z2.literal("external") })
@@ -2828,7 +2865,8 @@ var init_schemas = __esm({
     CredentialReferenceUpdateSchema = CredentialReferenceInsertSchema.partial();
     CredentialReferenceApiSelectSchema = createApiSchema(CredentialReferenceSelectSchema).extend({
       type: z2.enum(CredentialStoreType),
-      tools: z2.array(ToolSelectSchema).optional()
+      tools: z2.array(ToolSelectSchema).optional(),
+      externalAgents: z2.array(ExternalAgentSelectSchema).optional()
     }).openapi("CredentialReference");
     CredentialReferenceApiInsertSchema = createApiInsertSchema(
       CredentialReferenceInsertSchema
@@ -2957,6 +2995,27 @@ var init_schemas = __esm({
     SubAgentToolRelationApiUpdateSchema = createAgentScopedApiUpdateSchema(
       SubAgentToolRelationUpdateSchema
     ).openapi("SubAgentToolRelationUpdate");
+    SubAgentExternalAgentRelationSelectSchema = createSelectSchema(
+      subAgentExternalAgentRelations
+    );
+    SubAgentExternalAgentRelationInsertSchema = createInsertSchema(
+      subAgentExternalAgentRelations
+    ).extend({
+      id: resourceIdSchema,
+      subAgentId: resourceIdSchema,
+      externalAgentId: resourceIdSchema,
+      headers: z2.record(z2.string(), z2.string()).nullish()
+    });
+    SubAgentExternalAgentRelationUpdateSchema = SubAgentExternalAgentRelationInsertSchema.partial();
+    SubAgentExternalAgentRelationApiSelectSchema = createAgentScopedApiSchema(
+      SubAgentExternalAgentRelationSelectSchema
+    ).openapi("SubAgentExternalAgentRelation");
+    SubAgentExternalAgentRelationApiInsertSchema = createAgentScopedApiInsertSchema(
+      SubAgentExternalAgentRelationInsertSchema
+    ).omit({ id: true, subAgentId: true }).openapi("SubAgentExternalAgentRelationCreate");
+    SubAgentExternalAgentRelationApiUpdateSchema = createAgentScopedApiUpdateSchema(
+      SubAgentExternalAgentRelationUpdateSchema
+    ).openapi("SubAgentExternalAgentRelationUpdate");
     LedgerArtifactSelectSchema = createSelectSchema(ledgerArtifacts);
     LedgerArtifactInsertSchema = createInsertSchema(ledgerArtifacts);
     LedgerArtifactUpdateSchema = LedgerArtifactInsertSchema.partial();
@@ -2985,6 +3044,11 @@ var init_schemas = __esm({
       toolSelection: z2.array(z2.string()).nullish(),
       headers: z2.record(z2.string(), z2.string()).nullish()
     }).openapi("CanUseItem");
+    canDelegateToExternalAgentSchema = z2.object({
+      externalAgentId: z2.string(),
+      subAgentExternalAgentRelationId: z2.string().optional(),
+      headers: z2.record(z2.string(), z2.string()).nullish()
+    });
     FullAgentAgentInsertSchema = SubAgentApiInsertSchema.extend({
       type: z2.literal("internal"),
       canUse: z2.array(CanUseItemSchema),
@@ -2992,16 +3056,22 @@ var init_schemas = __esm({
       dataComponents: z2.array(z2.string()).optional(),
       artifactComponents: z2.array(z2.string()).optional(),
       canTransferTo: z2.array(z2.string()).optional(),
-      canDelegateTo: z2.array(z2.string()).optional()
+      canDelegateTo: z2.array(
+        z2.union([
+          z2.string(),
+          // Internal subAgent ID
+          canDelegateToExternalAgentSchema
+          // External agent with headers
+        ])
+      ).optional()
     });
     AgentWithinContextOfProjectSchema = AgentApiInsertSchema.extend({
-      subAgents: z2.record(
-        z2.string(),
-        z2.union([FullAgentAgentInsertSchema, ExternalAgentApiInsertSchema])
-      ),
+      subAgents: z2.record(z2.string(), FullAgentAgentInsertSchema),
       // Lookup maps for UI to resolve canUse items
       tools: z2.record(z2.string(), ToolApiInsertSchema).optional(),
       // MCP tools (project-scoped)
+      externalAgents: z2.record(z2.string(), ExternalAgentApiInsertSchema).optional(),
+      // External agents (project-scoped)
       functionTools: z2.record(z2.string(), FunctionToolApiInsertSchema).optional(),
       // Function tools (agent-scoped)
       functions: z2.record(z2.string(), FunctionApiInsertSchema).optional(),
@@ -3056,6 +3126,7 @@ var init_schemas = __esm({
       functions: z2.record(z2.string(), FunctionApiInsertSchema).optional(),
       dataComponents: z2.record(z2.string(), DataComponentApiInsertSchema).optional(),
       artifactComponents: z2.record(z2.string(), ArtifactComponentApiInsertSchema).optional(),
+      externalAgents: z2.record(z2.string(), ExternalAgentApiInsertSchema).optional(),
       statusUpdates: z2.optional(StatusUpdateSchema),
       credentialReferences: z2.record(z2.string(), CredentialReferenceApiInsertSchema).optional(),
       createdAt: z2.string().optional(),
@@ -7147,11 +7218,11 @@ var require_typescript = __commonJS({
         for (var name in all)
           __defProp2(target, name, { get: all[name], enumerable: true });
       };
-      var __copyProps2 = (to, from, except, desc15) => {
+      var __copyProps2 = (to, from, except, desc16) => {
         if (from && typeof from === "object" || typeof from === "function") {
           for (let key of __getOwnPropNames2(from))
             if (!__hasOwnProp2.call(to, key) && key !== except)
-              __defProp2(to, key, { get: () => from[key], enumerable: !(desc15 = __getOwnPropDesc2(from, key)) || desc15.enumerable });
+              __defProp2(to, key, { get: () => from[key], enumerable: !(desc16 = __getOwnPropDesc2(from, key)) || desc16.enumerable });
         }
         return to;
       };
@@ -7335,7 +7406,7 @@ var require_typescript = __commonJS({
         affectsEmitOptionDeclarations: () => affectsEmitOptionDeclarations,
         allKeysStartWithDot: () => allKeysStartWithDot,
         altDirectorySeparator: () => altDirectorySeparator,
-        and: () => and20,
+        and: () => and21,
         append: () => append,
         appendIfUnique: () => appendIfUnique,
         arrayFrom: () => arrayFrom,
@@ -9557,16 +9628,16 @@ var require_typescript = __commonJS({
         return -1;
       }
       function countWhere(array, predicate) {
-        let count16 = 0;
+        let count17 = 0;
         if (array !== void 0) {
           for (let i2 = 0; i2 < array.length; i2++) {
             const v2 = array[i2];
             if (predicate(v2, i2)) {
-              count16++;
+              count17++;
             }
           }
         }
-        return count16;
+        return count17;
       }
       function filter(array, f) {
         if (array !== void 0) {
@@ -10119,12 +10190,12 @@ var require_typescript = __commonJS({
         }
         return ~low;
       }
-      function reduceLeft(array, f, initial, start, count16) {
+      function reduceLeft(array, f, initial, start, count17) {
         if (array && array.length > 0) {
           const size = array.length;
           if (size > 0) {
             let pos = start === void 0 || start < 0 ? 0 : start;
-            const end = count16 === void 0 || pos + count16 > size - 1 ? size - 1 : pos + count16;
+            const end = count17 === void 0 || pos + count17 > size - 1 ? size - 1 : pos + count17;
             let result;
             if (arguments.length <= 2) {
               result = array[pos];
@@ -10176,9 +10247,9 @@ var require_typescript = __commonJS({
         }
         return values;
       }
-      function arrayOf(count16, f) {
-        const result = new Array(count16);
-        for (let i2 = 0; i2 < count16; i2++) {
+      function arrayOf(count17, f) {
+        const result = new Array(count17);
+        for (let i2 = 0; i2 < count17; i2++) {
           result[i2] = f(i2);
         }
         return result;
@@ -10786,7 +10857,7 @@ var require_typescript = __commonJS({
       function isPatternMatch({ prefix, suffix }, candidate) {
         return candidate.length >= prefix.length + suffix.length && startsWith(candidate, prefix) && endsWith(candidate, suffix);
       }
-      function and20(f, g) {
+      function and21(f, g) {
         return (arg) => f(arg) && g(arg);
       }
       function or(...fs5) {
@@ -12293,8 +12364,8 @@ ${lanes.join("\n")}
       var durations = /* @__PURE__ */ new Map();
       function mark(markName) {
         if (enabled) {
-          const count16 = counts.get(markName) ?? 0;
-          counts.set(markName, count16 + 1);
+          const count17 = counts.get(markName) ?? 0;
+          counts.set(markName, count17 + 1);
           marks.set(markName, timestamp());
           performanceImpl == null ? void 0 : performanceImpl.mark(markName);
           if (typeof onProfilerEvent === "function") {
@@ -19805,20 +19876,20 @@ ${lanes.join("\n")}
           tokenValue = text4.substring(start2, pos);
           return isOctal;
         }
-        function scanExactNumberOfHexDigits(count16, canHaveSeparators) {
+        function scanExactNumberOfHexDigits(count17, canHaveSeparators) {
           const valueString = scanHexDigits(
             /*minCount*/
-            count16,
+            count17,
             /*scanAsManyAsPossible*/
             false,
             canHaveSeparators
           );
           return valueString ? parseInt(valueString, 16) : -1;
         }
-        function scanMinimumNumberOfHexDigits(count16, canHaveSeparators) {
+        function scanMinimumNumberOfHexDigits(count17, canHaveSeparators) {
           return scanHexDigits(
             /*minCount*/
-            count16,
+            count17,
             /*scanAsManyAsPossible*/
             true,
             canHaveSeparators
@@ -38644,13 +38715,13 @@ ${lanes.join("\n")}
             [expression]
           );
         }
-        function createReadHelper(iteratorRecord, count16) {
+        function createReadHelper(iteratorRecord, count17) {
           context.requestEmitHelper(readHelper);
           return factory2.createCallExpression(
             getUnscopedHelperName("__read"),
             /*typeArguments*/
             void 0,
-            count16 !== void 0 ? [iteratorRecord, factory2.createNumericLiteral(count16 + "")] : [iteratorRecord]
+            count17 !== void 0 ? [iteratorRecord, factory2.createNumericLiteral(count17 + "")] : [iteratorRecord]
           );
         }
         function createGeneratorHelper(body) {
@@ -60960,11 +61031,11 @@ ${lanes.join("\n")}
         return comparePaths(a, b2, ignoreCase) === 0;
       }
       function countPathComponents(path4) {
-        let count16 = 0;
+        let count17 = 0;
         for (let i2 = startsWith(path4, "./") ? 2 : 0; i2 < path4.length; i2++) {
-          if (path4.charCodeAt(i2) === 47) count16++;
+          if (path4.charCodeAt(i2) === 47) count17++;
         }
-        return count16;
+        return count17;
       }
       function comparePathsByRedirectAndNumberOfDirectorySeparators(a, b2) {
         return compareBooleans(b2.isRedirect, a.isRedirect) || compareNumberOfDirectorySeparators(a.path, b2.path);
@@ -61799,7 +61870,7 @@ ${lanes.join("\n")}
         SignatureCheckMode3[SignatureCheckMode3["Callback"] = 3] = "Callback";
         return SignatureCheckMode3;
       })(SignatureCheckMode || {});
-      var isNotOverloadAndNotAccessor = and20(isNotOverload, isNotAccessor);
+      var isNotOverloadAndNotAccessor = and21(isNotOverload, isNotAccessor);
       var intrinsicTypeKinds = new Map(Object.entries({
         Uppercase: 0,
         Lowercase: 1,
@@ -67539,7 +67610,7 @@ ${lanes.join("\n")}
                   deepCloneOrReuseNode
                 )), node);
               }
-              function deepCloneOrReuseNodes(nodes, visitor, test, start, count16) {
+              function deepCloneOrReuseNodes(nodes, visitor, test, start, count17) {
                 if (nodes && nodes.length === 0) {
                   return setTextRange(factory.createNodeArray(
                     /*elements*/
@@ -67547,7 +67618,7 @@ ${lanes.join("\n")}
                     nodes.hasTrailingComma
                   ), nodes);
                 }
-                return visitNodes2(nodes, visitor, test, start, count16);
+                return visitNodes2(nodes, visitor, test, start, count17);
               }
             }
             function createTypeNodeFromObjectType(type2) {
@@ -71504,10 +71575,10 @@ ${lanes.join("\n")}
               if (t2.flags & 512 || !expandingEnum && t2.flags | 1056) {
                 const baseType = t2.flags & 512 ? booleanType : getBaseTypeOfEnumLikeType(t2);
                 if (baseType.flags & 1048576) {
-                  const count16 = baseType.types.length;
-                  if (i2 + count16 <= types.length && getRegularTypeOfLiteralType(types[i2 + count16 - 1]) === getRegularTypeOfLiteralType(baseType.types[count16 - 1])) {
+                  const count17 = baseType.types.length;
+                  if (i2 + count17 <= types.length && getRegularTypeOfLiteralType(types[i2 + count17 - 1]) === getRegularTypeOfLiteralType(baseType.types[count17 - 1])) {
                     result.push(baseType);
-                    i2 += count16 - 1;
+                    i2 += count17 - 1;
                     continue;
                   }
                 }
@@ -76473,18 +76544,18 @@ ${lanes.join("\n")}
             let i2 = 0;
             while (i2 < length2) {
               const startId = types[i2].id;
-              let count16 = 1;
-              while (i2 + count16 < length2 && types[i2 + count16].id === startId + count16) {
-                count16++;
+              let count17 = 1;
+              while (i2 + count17 < length2 && types[i2 + count17].id === startId + count17) {
+                count17++;
               }
               if (result.length) {
                 result += ",";
               }
               result += startId;
-              if (count16 > 1) {
-                result += ":" + count16;
+              if (count17 > 1) {
+                result += ":" + count17;
               }
-              i2 += count16;
+              i2 += count17;
             }
           }
           return result;
@@ -77764,7 +77835,7 @@ ${lanes.join("\n")}
           const hasEmptyObject = hasObjectTypes && some(types, (t2) => !!(t2.flags & 524288) && !isGenericMappedType(t2) && isEmptyResolvedType(resolveStructuredTypeMembers(t2)));
           const len = types.length;
           let i2 = len;
-          let count16 = 0;
+          let count17 = 0;
           while (i2 > 0) {
             i2--;
             const source = types[i2];
@@ -77779,15 +77850,15 @@ ${lanes.join("\n")}
               const keyPropertyType = keyProperty && getRegularTypeOfLiteralType(getTypeOfSymbol(keyProperty));
               for (const target of types) {
                 if (source !== target) {
-                  if (count16 === 1e5) {
-                    const estimatedCount = count16 / (len - i2) * len;
+                  if (count17 === 1e5) {
+                    const estimatedCount = count17 / (len - i2) * len;
                     if (estimatedCount > 1e6) {
                       (_a = tracing) == null ? void 0 : _a.instant(tracing.Phase.CheckTypes, "removeSubtypes_DepthLimit", { typeIds: types.map((t2) => t2.id) });
                       error2(currentNode, Diagnostics.Expression_produces_a_union_type_that_is_too_complex_to_represent);
                       return void 0;
                     }
                   }
-                  count16++;
+                  count17++;
                   if (keyProperty && target.flags & (524288 | 2097152 | 58982400)) {
                     const t2 = getTypeOfPropertyOfType(target, keyProperty.escapedName);
                     if (t2 && isUnitType(t2) && getRegularTypeOfLiteralType(t2) !== keyPropertyType) {
@@ -78288,9 +78359,9 @@ ${lanes.join("\n")}
           return true;
         }
         function getCrossProductIntersections(types, flags) {
-          const count16 = getCrossProductUnionSize(types);
+          const count17 = getCrossProductUnionSize(types);
           const intersections = [];
-          for (let i2 = 0; i2 < count16; i2++) {
+          for (let i2 = 0; i2 < count17; i2++) {
             const constituents = types.slice();
             let n2 = i2;
             for (let j2 = types.length - 1; j2 >= 0; j2--) {
@@ -84157,14 +84228,14 @@ ${lanes.join("\n")}
               return some(type.types, (t2) => isDeeplyNestedType(t2, stack, depth, maxDepth));
             }
             const identity2 = getRecursionIdentity(type);
-            let count16 = 0;
+            let count17 = 0;
             let lastTypeId = 0;
             for (let i2 = 0; i2 < depth; i2++) {
               const t2 = stack[i2];
               if (hasMatchingRecursionIdentity(t2, identity2)) {
                 if (t2.id >= lastTypeId) {
-                  count16++;
-                  if (count16 >= maxDepth) {
+                  count17++;
+                  if (count17 >= maxDepth) {
                     return true;
                   }
                 }
@@ -85624,8 +85695,8 @@ ${lanes.join("\n")}
             ];
           }
           function inferFromTypeArguments(sourceTypes, targetTypes, variances) {
-            const count16 = sourceTypes.length < targetTypes.length ? sourceTypes.length : targetTypes.length;
-            for (let i2 = 0; i2 < count16; i2++) {
+            const count17 = sourceTypes.length < targetTypes.length ? sourceTypes.length : targetTypes.length;
+            for (let i2 = 0; i2 < count17; i2++) {
               if (i2 < variances.length && (variances[i2] & 7) === 2) {
                 inferFromContravariantTypes(sourceTypes[i2], targetTypes[i2]);
               } else {
@@ -86369,7 +86440,7 @@ ${lanes.join("\n")}
         }
         function mapTypesByKeyProperty(types, name) {
           const map2 = /* @__PURE__ */ new Map();
-          let count16 = 0;
+          let count17 = 0;
           for (const type of types) {
             if (type.flags & (524288 | 2097152 | 58982400)) {
               const discriminant = getTypeOfPropertyOfType(type, name);
@@ -86388,11 +86459,11 @@ ${lanes.join("\n")}
                     duplicate = true;
                   }
                 });
-                if (!duplicate) count16++;
+                if (!duplicate) count17++;
               }
             }
           }
-          return count16 >= 10 && count16 * 2 >= types.length ? map2 : void 0;
+          return count17 >= 10 && count17 * 2 >= types.length ? map2 : void 0;
         }
         function getKeyPropertyName(unionType) {
           const types = unionType.types;
@@ -104619,7 +104690,7 @@ ${lanes.join("\n")}
                 if (flags & (1920 | 384)) {
                   return;
                 }
-                const exportedDeclarationsCount = countWhere(declarations, and20(isNotOverloadAndNotAccessor, not2(isInterfaceDeclaration)));
+                const exportedDeclarationsCount = countWhere(declarations, and21(isNotOverloadAndNotAccessor, not2(isInterfaceDeclaration)));
                 if (flags & 524288 && exportedDeclarationsCount <= 2) {
                   return;
                 }
@@ -109008,7 +109079,7 @@ ${lanes.join("\n")}
         Debug.assertNode(visitedNode, test);
         return visitedNode;
       }
-      function visitNodes2(nodes, visitor, test, start, count16) {
+      function visitNodes2(nodes, visitor, test, start, count17) {
         if (nodes === void 0) {
           return nodes;
         }
@@ -109016,20 +109087,20 @@ ${lanes.join("\n")}
         if (start === void 0 || start < 0) {
           start = 0;
         }
-        if (count16 === void 0 || count16 > length2 - start) {
-          count16 = length2 - start;
+        if (count17 === void 0 || count17 > length2 - start) {
+          count17 = length2 - start;
         }
         let hasTrailingComma;
         let pos = -1;
         let end = -1;
-        if (start > 0 || count16 < length2) {
-          hasTrailingComma = nodes.hasTrailingComma && start + count16 === length2;
+        if (start > 0 || count17 < length2) {
+          hasTrailingComma = nodes.hasTrailingComma && start + count17 === length2;
         } else {
           pos = nodes.pos;
           end = nodes.end;
           hasTrailingComma = nodes.hasTrailingComma;
         }
-        const updated = visitArrayWorker(nodes, visitor, test, start, count16);
+        const updated = visitArrayWorker(nodes, visitor, test, start, count17);
         if (updated !== nodes) {
           const updatedArray = factory.createNodeArray(updated, hasTrailingComma);
           setTextRangePosEnd(updatedArray, pos, end);
@@ -109037,7 +109108,7 @@ ${lanes.join("\n")}
         }
         return nodes;
       }
-      function visitArray(nodes, visitor, test, start, count16) {
+      function visitArray(nodes, visitor, test, start, count17) {
         if (nodes === void 0) {
           return nodes;
         }
@@ -109045,18 +109116,18 @@ ${lanes.join("\n")}
         if (start === void 0 || start < 0) {
           start = 0;
         }
-        if (count16 === void 0 || count16 > length2 - start) {
-          count16 = length2 - start;
+        if (count17 === void 0 || count17 > length2 - start) {
+          count17 = length2 - start;
         }
-        return visitArrayWorker(nodes, visitor, test, start, count16);
+        return visitArrayWorker(nodes, visitor, test, start, count17);
       }
-      function visitArrayWorker(nodes, visitor, test, start, count16) {
+      function visitArrayWorker(nodes, visitor, test, start, count17) {
         let updated;
         const length2 = nodes.length;
-        if (start > 0 || count16 < length2) {
+        if (start > 0 || count17 < length2) {
           updated = [];
         }
-        for (let i2 = 0; i2 < count16; i2++) {
+        for (let i2 = 0; i2 < count17; i2++) {
           const node = nodes[i2 + start];
           const visited = node !== void 0 ? visitor ? visitor(node) : node : void 0;
           if (updated !== void 0 || visited === void 0 || visited !== node) {
@@ -140432,7 +140503,7 @@ ${lanes.join("\n")}
               break;
           }
         }
-        function emitList(parentNode, children, format, parenthesizerRule, start, count16) {
+        function emitList(parentNode, children, format, parenthesizerRule, start, count17) {
           emitNodeList(
             emit,
             parentNode,
@@ -140440,18 +140511,18 @@ ${lanes.join("\n")}
             format | (parentNode && getEmitFlags(parentNode) & 2 ? 65536 : 0),
             parenthesizerRule,
             start,
-            count16
+            count17
           );
         }
-        function emitExpressionList(parentNode, children, format, parenthesizerRule, start, count16) {
-          emitNodeList(emitExpression, parentNode, children, format, parenthesizerRule, start, count16);
+        function emitExpressionList(parentNode, children, format, parenthesizerRule, start, count17) {
+          emitNodeList(emitExpression, parentNode, children, format, parenthesizerRule, start, count17);
         }
-        function emitNodeList(emit2, parentNode, children, format, parenthesizerRule, start = 0, count16 = children ? children.length - start : 0) {
+        function emitNodeList(emit2, parentNode, children, format, parenthesizerRule, start = 0, count17 = children ? children.length - start : 0) {
           const isUndefined2 = children === void 0;
           if (isUndefined2 && format & 16384) {
             return;
           }
-          const isEmpty = children === void 0 || start >= children.length || count16 === 0;
+          const isEmpty = children === void 0 || start >= children.length || count17 === 0;
           if (isEmpty && format & 32768) {
             onBeforeEmitNodeArray == null ? void 0 : onBeforeEmitNodeArray(children);
             onAfterEmitNodeArray == null ? void 0 : onAfterEmitNodeArray(children);
@@ -140475,7 +140546,7 @@ ${lanes.join("\n")}
               writeSpace();
             }
           } else {
-            emitNodeListItems(emit2, parentNode, children, format, parenthesizerRule, start, count16, children.hasTrailingComma, children);
+            emitNodeListItems(emit2, parentNode, children, format, parenthesizerRule, start, count17, children.hasTrailingComma, children);
           }
           onAfterEmitNodeArray == null ? void 0 : onAfterEmitNodeArray(children);
           if (format & 15360) {
@@ -140485,7 +140556,7 @@ ${lanes.join("\n")}
             writePunctuation(getClosingBracket(format));
           }
         }
-        function emitNodeListItems(emit2, parentNode, children, format, parenthesizerRule, start, count16, hasTrailingComma, childrenTextRange) {
+        function emitNodeListItems(emit2, parentNode, children, format, parenthesizerRule, start, count17, hasTrailingComma, childrenTextRange) {
           const mayEmitInterveningComments = (format & 262144) === 0;
           let shouldEmitInterveningComments = mayEmitInterveningComments;
           const leadingLineTerminatorCount = getLeadingLineTerminatorCount(parentNode, children[start], format);
@@ -140501,7 +140572,7 @@ ${lanes.join("\n")}
           const emitListItem = getEmitListItem(emit2, parenthesizerRule);
           let previousSibling;
           let shouldDecreaseIndentAfterEmit = false;
-          for (let i2 = 0; i2 < count16; i2++) {
+          for (let i2 = 0; i2 < count17; i2++) {
             const child = children[start + i2];
             if (format & 32) {
               writeLine();
@@ -140566,7 +140637,7 @@ ${lanes.join("\n")}
           if (format & 128) {
             decreaseIndent();
           }
-          const closingLineTerminatorCount = getClosingLineTerminatorCount(parentNode, children[start + count16 - 1], format, childrenTextRange);
+          const closingLineTerminatorCount = getClosingLineTerminatorCount(parentNode, children[start + count17 - 1], format, childrenTextRange);
           if (closingLineTerminatorCount) {
             writeLine(closingLineTerminatorCount);
           } else if (format & (2097152 | 256)) {
@@ -140616,8 +140687,8 @@ ${lanes.join("\n")}
             writer.write(s2);
           }
         }
-        function writeLine(count16 = 1) {
-          for (let i2 = 0; i2 < count16; i2++) {
+        function writeLine(count17 = 1) {
+          for (let i2 = 0; i2 < count17; i2++) {
             writer.writeLine(i2 > 0);
           }
         }
@@ -141146,10 +141217,10 @@ ${lanes.join("\n")}
             }
           }
           while (true) {
-            const count16 = tempFlags2 & 268435455;
+            const count17 = tempFlags2 & 268435455;
             tempFlags2++;
-            if (count16 !== 8 && count16 !== 13) {
-              const name = count16 < 26 ? "_" + String.fromCharCode(97 + count16) : "_" + (count16 - 26);
+            if (count17 !== 8 && count17 !== 13) {
+              const name = count17 < 26 ? "_" + String.fromCharCode(97 + count17) : "_" + (count17 - 26);
               const fullName = formatGeneratedName(privateName, prefix, name, suffix);
               if (isUniqueName(fullName, privateName)) {
                 if (privateName) {
@@ -153232,12 +153303,12 @@ ${lanes.join("\n")}
         for (const line of output) {
           sys2.write(line);
         }
-        function example(ex, desc15) {
+        function example(ex, desc16) {
           const examples = typeof ex === "string" ? [ex] : ex;
           for (const example2 of examples) {
             output.push("  " + colors.blue(example2) + sys2.newLine);
           }
-          output.push("  " + getDiagnosticText(desc15) + sys2.newLine + sys2.newLine);
+          output.push("  " + getDiagnosticText(desc16) + sys2.newLine + sys2.newLine);
         }
       }
       function printAllHelp(sys2, compilerOptions, buildOptions, watchOptions) {
@@ -153889,7 +153960,7 @@ ${lanes.join("\n")}
               reportCountStatistic("Lines of " + key, value);
             }
           } else {
-            reportCountStatistic("Lines", reduceLeftIterator(lineCounts.values(), (sum, count16) => sum + count16, 0));
+            reportCountStatistic("Lines", reduceLeftIterator(lineCounts.values(), (sum, count17) => sum + count17, 0));
           }
           reportCountStatistic("Identifiers", program2.getIdentifierCount());
           reportCountStatistic("Symbols", program2.getSymbolCount());
@@ -153994,11 +154065,11 @@ ${lanes.join("\n")}
           statistics.push(s2);
           if (aggregate) solutionPerformance == null ? void 0 : solutionPerformance.addAggregateStatistic(s2);
         }
-        function reportCountStatistic(name, count16) {
+        function reportCountStatistic(name, count17) {
           reportStatisticalValue(
             {
               name,
-              value: count16,
+              value: count17,
               type: 1
               /* count */
             },
@@ -154499,8 +154570,8 @@ ${lanes.join("\n")}
                 nonlocalNode ? visitNodesWithoutCopyingPositions : void 0
               );
             }
-            function visitNodesWithoutCopyingPositions(nodes, visitor, test, start, count16) {
-              let result = visitNodes2(nodes, visitor, test, start, count16);
+            function visitNodesWithoutCopyingPositions(nodes, visitor, test, start, count17) {
+              let result = visitNodes2(nodes, visitor, test, start, count17);
               if (result) {
                 if (result.pos !== -1 || result.end !== -1) {
                   if (result === nodes) {
@@ -157394,9 +157465,9 @@ ${lanes.join("\n")}
       function getSnapshotText(snap) {
         return snap.getText(0, snap.getLength());
       }
-      function repeatString(str, count16) {
+      function repeatString(str, count17) {
         let result = "";
-        for (let i2 = 0; i2 < count16; i2++) {
+        for (let i2 = 0; i2 < count17; i2++) {
           result += str;
         }
         return result;
@@ -175528,7 +175599,7 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
         const maybeHeritageClauseSymbol = getHeritageClauseSymbolTable(classDeclaration, checker);
         const implementedType = checker.getTypeAtLocation(implementedTypeNode);
         const implementedTypeSymbols = checker.getPropertiesOfType(implementedType);
-        const nonPrivateAndNotExistedInHeritageClauseMembers = implementedTypeSymbols.filter(and20(symbolPointsToNonPrivateMember, (symbol) => !maybeHeritageClauseSymbol.has(symbol.escapedName)));
+        const nonPrivateAndNotExistedInHeritageClauseMembers = implementedTypeSymbols.filter(and21(symbolPointsToNonPrivateMember, (symbol) => !maybeHeritageClauseSymbol.has(symbol.escapedName)));
         const classType = checker.getTypeAtLocation(classDeclaration);
         const constructor = find(classDeclaration.members, (m2) => isConstructorDeclaration(m2));
         if (!classType.getNumberIndexType()) {
@@ -190203,8 +190274,8 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
       function isAmbientModuleDeclaration(node) {
         return node.kind === 268 && node.name.kind === 11;
       }
-      function isExternalModuleImportEquals(eq20) {
-        return eq20.moduleReference.kind === 284 && eq20.moduleReference.expression.kind === 11;
+      function isExternalModuleImportEquals(eq21) {
+        return eq21.moduleReference.kind === 284 && eq21.moduleReference.expression.kind === 11;
       }
       var DefinitionKind = /* @__PURE__ */ ((DefinitionKind2) => {
         DefinitionKind2[DefinitionKind2["Symbol"] = 0] = "Symbol";
@@ -195853,13 +195924,13 @@ ${content}
           if (candidates[i2] === resolvedSignature) {
             selectedItemIndex = itemsSeen;
             if (item.length > 1) {
-              let count16 = 0;
+              let count17 = 0;
               for (const i22 of item) {
                 if (i22.isVariadic || i22.parameters.length >= argumentCount) {
-                  selectedItemIndex = itemsSeen + count16;
+                  selectedItemIndex = itemsSeen + count17;
                   break;
                 }
-                count16++;
+                count17++;
               }
             }
           }
@@ -198160,8 +198231,8 @@ ${options.prefix}` : "\n" : options.prefix
         setTextRangePosEnd(newNode, getPos2(node), getEnd(node));
         return newNode;
       }
-      function assignPositionsToNodeArray(nodes, visitor, test, start, count16) {
-        const visited = visitNodes2(nodes, visitor, test, start, count16);
+      function assignPositionsToNodeArray(nodes, visitor, test, start, count17) {
+        const visited = visitNodes2(nodes, visitor, test, start, count17);
         if (!visited) {
           return visited;
         }
@@ -202838,7 +202909,7 @@ ${options.prefix}` : "\n" : options.prefix
         affectsEmitOptionDeclarations: () => affectsEmitOptionDeclarations,
         allKeysStartWithDot: () => allKeysStartWithDot,
         altDirectorySeparator: () => altDirectorySeparator,
-        and: () => and20,
+        and: () => and21,
         append: () => append,
         appendIfUnique: () => appendIfUnique,
         arrayFrom: () => arrayFrom,
@@ -217916,19 +217987,29 @@ var init_functionTools = __esm({
   }
 });
 
+// ../packages/agents-core/src/data-access/subAgentExternalAgentRelations.ts
+import { and as and5, count as count4, desc as desc4, eq as eq5 } from "drizzle-orm";
+var init_subAgentExternalAgentRelations = __esm({
+  "../packages/agents-core/src/data-access/subAgentExternalAgentRelations.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_schema();
+  }
+});
+
 // ../packages/agents-core/src/data-access/subAgentRelations.ts
-import { and as and5, count as count4, desc as desc4, eq as eq5, isNotNull } from "drizzle-orm";
+import { and as and6, count as count5, desc as desc5, eq as eq6, isNotNull } from "drizzle-orm";
 var init_subAgentRelations = __esm({
   "../packages/agents-core/src/data-access/subAgentRelations.ts"() {
     "use strict";
     init_esm_shims();
-    init_conversations();
     init_schema();
+    init_conversations();
   }
 });
 
 // ../packages/agents-core/src/data-access/subAgents.ts
-import { and as and6, count as count5, desc as desc5, eq as eq6, inArray } from "drizzle-orm";
+import { and as and7, count as count6, desc as desc6, eq as eq7, inArray } from "drizzle-orm";
 var init_subAgents = __esm({
   "../packages/agents-core/src/data-access/subAgents.ts"() {
     "use strict";
@@ -220879,26 +220960,26 @@ var require_resolve = __commonJS({
       return true;
     }
     function countKeys(schema) {
-      var count16 = 0, item;
+      var count17 = 0, item;
       if (Array.isArray(schema)) {
         for (var i2 = 0; i2 < schema.length; i2++) {
           item = schema[i2];
-          if (typeof item == "object") count16 += countKeys(item);
-          if (count16 == Infinity) return Infinity;
+          if (typeof item == "object") count17 += countKeys(item);
+          if (count17 == Infinity) return Infinity;
         }
       } else {
         for (var key in schema) {
           if (key == "$ref") return Infinity;
           if (SIMPLE_INLINED[key]) {
-            count16++;
+            count17++;
           } else {
             item = schema[key];
-            if (typeof item == "object") count16 += countKeys(item) + 1;
-            if (count16 == Infinity) return Infinity;
+            if (typeof item == "object") count17 += countKeys(item) + 1;
+            if (count17 == Infinity) return Infinity;
           }
         }
       }
-      return count16;
+      return count17;
     }
     function getFullPath(id, normalize) {
       if (normalize !== false) id = normalizeId(id);
@@ -226828,7 +226909,7 @@ var init_utils = __esm({
 });
 
 // ../packages/agents-core/src/data-access/credentialReferences.ts
-import { and as and7, count as count6, desc as desc6, eq as eq7, sql as sql3 } from "drizzle-orm";
+import { and as and8, count as count7, desc as desc7, eq as eq8, sql as sql3 } from "drizzle-orm";
 var init_credentialReferences = __esm({
   "../packages/agents-core/src/data-access/credentialReferences.ts"() {
     "use strict";
@@ -226838,7 +226919,7 @@ var init_credentialReferences = __esm({
 });
 
 // ../packages/agents-core/src/data-access/tools.ts
-import { and as and8, count as count7, desc as desc7, eq as eq8 } from "drizzle-orm";
+import { and as and9, count as count8, desc as desc8, eq as eq9 } from "drizzle-orm";
 var logger7;
 var init_tools = __esm({
   "../packages/agents-core/src/data-access/tools.ts"() {
@@ -226859,7 +226940,7 @@ var init_tools = __esm({
 });
 
 // ../packages/agents-core/src/data-access/agents.ts
-import { and as and9, count as count8, desc as desc8, eq as eq9, inArray as inArray2 } from "drizzle-orm";
+import { and as and10, count as count9, desc as desc9, eq as eq10, inArray as inArray2 } from "drizzle-orm";
 var init_agents = __esm({
   "../packages/agents-core/src/data-access/agents.ts"() {
     "use strict";
@@ -226870,6 +226951,7 @@ var init_agents = __esm({
     init_externalAgents();
     init_functions();
     init_functionTools();
+    init_subAgentExternalAgentRelations();
     init_subAgentRelations();
     init_subAgents();
     init_tools();
@@ -226877,7 +226959,7 @@ var init_agents = __esm({
 });
 
 // ../packages/agents-core/src/data-access/apiKeys.ts
-import { and as and10, count as count9, desc as desc9, eq as eq10 } from "drizzle-orm";
+import { and as and11, count as count10, desc as desc10, eq as eq11 } from "drizzle-orm";
 var init_apiKeys2 = __esm({
   "../packages/agents-core/src/data-access/apiKeys.ts"() {
     "use strict";
@@ -227891,10 +227973,10 @@ var require_codegen = __commonJS({
     }
     exports.not = not2;
     var andCode = mappend(exports.operators.AND);
-    function and20(...args) {
+    function and21(...args) {
       return args.reduce(andCode);
     }
-    exports.and = and20;
+    exports.and = and21;
     var orCode = mappend(exports.operators.OR);
     function or(...args) {
       return args.reduce(orCode);
@@ -229055,20 +229137,20 @@ var require_resolve2 = __commonJS({
       return false;
     }
     function countKeys(schema) {
-      let count16 = 0;
+      let count17 = 0;
       for (const key in schema) {
         if (key === "$ref")
           return Infinity;
-        count16++;
+        count17++;
         if (SIMPLE_INLINED.has(key))
           continue;
         if (typeof schema[key] == "object") {
-          (0, util_1.eachItem)(schema[key], (sch) => count16 += countKeys(sch));
+          (0, util_1.eachItem)(schema[key], (sch) => count17 += countKeys(sch));
         }
-        if (count16 === Infinity)
+        if (count17 === Infinity)
           return Infinity;
       }
-      return count16;
+      return count17;
     }
     function getFullPath(resolver, id = "", normalize) {
       if (normalize !== false)
@@ -232174,8 +232256,8 @@ var require_contains2 = __commonJS({
         cxt.result(valid, () => cxt.reset());
         function validateItemsWithCount() {
           const schValid = gen.name("_valid");
-          const count16 = gen.let("count", 0);
-          validateItems(schValid, () => gen.if(schValid, () => checkLimits(count16)));
+          const count17 = gen.let("count", 0);
+          validateItems(schValid, () => gen.if(schValid, () => checkLimits(count17)));
         }
         function validateItems(_valid, block) {
           gen.forRange("i", 0, len, (i2) => {
@@ -232188,16 +232270,16 @@ var require_contains2 = __commonJS({
             block();
           });
         }
-        function checkLimits(count16) {
-          gen.code((0, codegen_1._)`${count16}++`);
+        function checkLimits(count17) {
+          gen.code((0, codegen_1._)`${count17}++`);
           if (max === void 0) {
-            gen.if((0, codegen_1._)`${count16} >= ${min}`, () => gen.assign(valid, true).break());
+            gen.if((0, codegen_1._)`${count17} >= ${min}`, () => gen.assign(valid, true).break());
           } else {
-            gen.if((0, codegen_1._)`${count16} > ${max}`, () => gen.assign(valid, false).break());
+            gen.if((0, codegen_1._)`${count17} > ${max}`, () => gen.assign(valid, false).break());
             if (min === 1)
               gen.assign(valid, true);
             else
-              gen.if((0, codegen_1._)`${count16} >= ${min}`, () => gen.assign(valid, true));
+              gen.if((0, codegen_1._)`${count17} >= ${min}`, () => gen.assign(valid, true));
           }
         }
       }
@@ -233371,7 +233453,7 @@ var init_props_validation = __esm({
 });
 
 // ../packages/agents-core/src/data-access/artifactComponents.ts
-import { and as and11, count as count10, desc as desc10, eq as eq11 } from "drizzle-orm";
+import { and as and12, count as count11, desc as desc11, eq as eq12 } from "drizzle-orm";
 var init_artifactComponents = __esm({
   "../packages/agents-core/src/data-access/artifactComponents.ts"() {
     "use strict";
@@ -233383,7 +233465,7 @@ var init_artifactComponents = __esm({
 });
 
 // ../packages/agents-core/src/data-access/contextCache.ts
-import { and as and12, eq as eq12 } from "drizzle-orm";
+import { and as and13, eq as eq13 } from "drizzle-orm";
 var init_contextCache = __esm({
   "../packages/agents-core/src/data-access/contextCache.ts"() {
     "use strict";
@@ -233394,7 +233476,7 @@ var init_contextCache = __esm({
 });
 
 // ../packages/agents-core/src/data-access/conversations.ts
-import { and as and13, count as count11, desc as desc11, eq as eq13 } from "drizzle-orm";
+import { and as and14, count as count12, desc as desc12, eq as eq14 } from "drizzle-orm";
 var init_conversations2 = __esm({
   "../packages/agents-core/src/data-access/conversations.ts"() {
     "use strict";
@@ -233413,7 +233495,7 @@ var init_preview_validation = __esm({
 });
 
 // ../packages/agents-core/src/data-access/dataComponents.ts
-import { and as and14, count as count12, desc as desc12, eq as eq14 } from "drizzle-orm";
+import { and as and15, count as count13, desc as desc13, eq as eq15 } from "drizzle-orm";
 var init_dataComponents = __esm({
   "../packages/agents-core/src/data-access/dataComponents.ts"() {
     "use strict";
@@ -233435,21 +233517,21 @@ var init_agentFull = __esm({
 });
 
 // ../packages/agents-core/src/data-access/agentFull.ts
-import { and as and15, eq as eq15, inArray as inArray3, not } from "drizzle-orm";
+import { and as and16, eq as eq16, inArray as inArray3, not } from "drizzle-orm";
 var init_agentFull2 = __esm({
   "../packages/agents-core/src/data-access/agentFull.ts"() {
     "use strict";
     init_esm_shims();
-    init_conversations();
     init_schema();
+    init_conversations();
     init_agentFull();
     init_agents();
     init_artifactComponents();
     init_contextConfigs();
     init_dataComponents();
-    init_externalAgents();
     init_functions();
     init_functionTools();
+    init_subAgentExternalAgentRelations();
     init_subAgentRelations();
     init_subAgents();
     init_tools();
@@ -233457,7 +233539,7 @@ var init_agentFull2 = __esm({
 });
 
 // ../packages/agents-core/src/data-access/ledgerArtifacts.ts
-import { and as and16, count as count13, eq as eq16 } from "drizzle-orm";
+import { and as and17, count as count14, eq as eq17 } from "drizzle-orm";
 var init_ledgerArtifacts = __esm({
   "../packages/agents-core/src/data-access/ledgerArtifacts.ts"() {
     "use strict";
@@ -233468,7 +233550,7 @@ var init_ledgerArtifacts = __esm({
 });
 
 // ../packages/agents-core/src/data-access/messages.ts
-import { and as and17, asc as asc2, count as count14, desc as desc13, eq as eq17, inArray as inArray4 } from "drizzle-orm";
+import { and as and18, asc as asc2, count as count15, desc as desc14, eq as eq18, inArray as inArray4 } from "drizzle-orm";
 var init_messages = __esm({
   "../packages/agents-core/src/data-access/messages.ts"() {
     "use strict";
@@ -233478,7 +233560,7 @@ var init_messages = __esm({
 });
 
 // ../packages/agents-core/src/data-access/projects.ts
-import { and as and18, count as count15, desc as desc14, eq as eq18 } from "drizzle-orm";
+import { and as and19, count as count16, desc as desc15, eq as eq19 } from "drizzle-orm";
 var init_projects = __esm({
   "../packages/agents-core/src/data-access/projects.ts"() {
     "use strict";
@@ -233499,6 +233581,7 @@ var init_projectFull = __esm({
     init_artifactComponents();
     init_credentialReferences();
     init_dataComponents();
+    init_externalAgents();
     init_functions();
     init_projects();
     init_tools();
@@ -233507,7 +233590,7 @@ var init_projectFull = __esm({
 });
 
 // ../packages/agents-core/src/data-access/tasks.ts
-import { and as and19, eq as eq19 } from "drizzle-orm";
+import { and as and20, eq as eq20 } from "drizzle-orm";
 var init_tasks = __esm({
   "../packages/agents-core/src/data-access/tasks.ts"() {
     "use strict";
@@ -233547,6 +233630,7 @@ var init_data_access = __esm({
     init_messages();
     init_projectFull();
     init_projects();
+    init_subAgentExternalAgentRelations();
     init_subAgentRelations();
     init_subAgents();
     init_tasks();
@@ -234301,6 +234385,338 @@ var init_config = __esm({
   }
 });
 
+// src/codegen/variable-name-registry.ts
+var variable_name_registry_exports = {};
+__export(variable_name_registry_exports, {
+  DEFAULT_NAMING_CONVENTIONS: () => DEFAULT_NAMING_CONVENTIONS,
+  VariableNameGenerator: () => VariableNameGenerator,
+  collectAllEntities: () => collectAllEntities
+});
+function collectAllEntities(projectData) {
+  const entities = [];
+  entities.push({ id: projectData.id, type: "project", data: projectData });
+  if (projectData.agents) {
+    for (const [agentId, agentData] of Object.entries(projectData.agents)) {
+      entities.push({ id: agentId, type: "agent", data: agentData });
+      const agentObj = agentData;
+      if (agentObj.subAgents) {
+        for (const [subAgentId, subAgentData] of Object.entries(agentObj.subAgents)) {
+          entities.push({ id: subAgentId, type: "subAgent", data: subAgentData });
+        }
+      }
+    }
+  }
+  if (projectData.tools) {
+    for (const [toolId, toolData] of Object.entries(projectData.tools)) {
+      entities.push({ id: toolId, type: "tool", data: toolData });
+    }
+  }
+  if (projectData.dataComponents) {
+    for (const [compId, compData] of Object.entries(projectData.dataComponents)) {
+      entities.push({ id: compId, type: "dataComponent", data: compData });
+    }
+  }
+  if (projectData.artifactComponents) {
+    for (const [compId, compData] of Object.entries(projectData.artifactComponents)) {
+      entities.push({ id: compId, type: "artifactComponent", data: compData });
+    }
+  }
+  if (projectData.externalAgents) {
+    for (const [agentId, agentData] of Object.entries(projectData.externalAgents)) {
+      entities.push({ id: agentId, type: "externalAgent", data: agentData });
+    }
+  }
+  if (projectData.agents) {
+    for (const [_agentId, agentData] of Object.entries(projectData.agents)) {
+      const agentObj = agentData;
+      if (agentObj.statusUpdates?.statusComponents) {
+        for (const statusComp of agentObj.statusUpdates.statusComponents) {
+          if (statusComp.type) {
+            entities.push({ id: statusComp.type, type: "statusComponent" });
+          }
+        }
+      }
+    }
+  }
+  const credentialReferences2 = /* @__PURE__ */ new Set();
+  if (projectData.credentialReferences) {
+    for (const credId of Object.keys(projectData.credentialReferences)) {
+      credentialReferences2.add(credId);
+    }
+  }
+  if (projectData.tools) {
+    for (const [_toolId, toolData] of Object.entries(projectData.tools)) {
+      const tool2 = toolData;
+      if (tool2.credentialReferenceId) {
+        credentialReferences2.add(tool2.credentialReferenceId);
+      }
+    }
+  }
+  if (projectData.externalAgents) {
+    for (const [_agentId, agentData] of Object.entries(projectData.externalAgents)) {
+      const agent = agentData;
+      if (agent.credentialReferenceId) {
+        credentialReferences2.add(agent.credentialReferenceId);
+      }
+    }
+  }
+  if (projectData.agents) {
+    for (const [_agentId, agentData] of Object.entries(projectData.agents)) {
+      const agent = agentData;
+      if (agent.contextConfig?.headers?.credentialReferenceId) {
+        credentialReferences2.add(agent.contextConfig.headers.credentialReferenceId);
+      }
+      if (agent.contextConfig?.contextVariables) {
+        for (const [_varId, varData] of Object.entries(agent.contextConfig.contextVariables)) {
+          const contextVar = varData;
+          if (contextVar.credentialReferenceId) {
+            credentialReferences2.add(contextVar.credentialReferenceId);
+          }
+        }
+      }
+      if (agent.subAgents) {
+        for (const [_subAgentId, subAgentData] of Object.entries(agent.subAgents)) {
+          const subAgent = subAgentData;
+          if (subAgent.contextConfig?.headers?.credentialReferenceId) {
+            credentialReferences2.add(subAgent.contextConfig.headers.credentialReferenceId);
+          }
+          if (subAgent.contextConfig?.contextVariables) {
+            for (const [_varId, varData] of Object.entries(
+              subAgent.contextConfig.contextVariables
+            )) {
+              const contextVar = varData;
+              if (contextVar.credentialReferenceId) {
+                credentialReferences2.add(contextVar.credentialReferenceId);
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+  return entities;
+}
+var DEFAULT_NAMING_CONVENTIONS, VariableNameGenerator;
+var init_variable_name_registry = __esm({
+  "src/codegen/variable-name-registry.ts"() {
+    "use strict";
+    init_esm_shims();
+    DEFAULT_NAMING_CONVENTIONS = {
+      projectSuffix: "Project",
+      agentSuffix: "Agent",
+      subAgentSuffix: "SubAgent",
+      toolSuffix: null,
+      // Usually no suffix needed
+      dataComponentSuffix: null,
+      artifactComponentSuffix: null,
+      statusComponentSuffix: null,
+      credentialSuffix: null,
+      environmentSuffix: null,
+      // No suffix needed for environments
+      externalAgentSuffix: null
+    };
+    VariableNameGenerator = class {
+      registry;
+      conventions;
+      conflicts;
+      constructor(conventions = DEFAULT_NAMING_CONVENTIONS) {
+        this.registry = {
+          projects: /* @__PURE__ */ new Map(),
+          agents: /* @__PURE__ */ new Map(),
+          subAgents: /* @__PURE__ */ new Map(),
+          tools: /* @__PURE__ */ new Map(),
+          dataComponents: /* @__PURE__ */ new Map(),
+          artifactComponents: /* @__PURE__ */ new Map(),
+          statusComponents: /* @__PURE__ */ new Map(),
+          credentials: /* @__PURE__ */ new Map(),
+          environments: /* @__PURE__ */ new Map(),
+          externalAgents: /* @__PURE__ */ new Map(),
+          usedNames: /* @__PURE__ */ new Map()
+        };
+        this.conventions = conventions;
+        this.conflicts = [];
+      }
+      /**
+       * Generate unique variable name for an entity
+       * Ensures no conflicts across all entity types
+       */
+      generateVariableName(id, entityType, entityData) {
+        const registryMap = this.getRegistryMap(entityType);
+        const existing = registryMap.get(id);
+        if (existing) {
+          return existing;
+        }
+        let baseName;
+        if (entityType === "tool" && entityData?.name && this.isRandomId(id)) {
+          baseName = this.idToVariableName(entityData.name);
+        } else {
+          baseName = this.idToVariableName(id);
+        }
+        if (!this.registry.usedNames.has(baseName)) {
+          this.register(id, baseName, entityType);
+          return baseName;
+        }
+        const existingEntity = this.registry.usedNames.get(baseName);
+        if (existingEntity) {
+          const existingConflict = this.conflicts.find((c2) => c2.id === id);
+          if (existingConflict) {
+            existingConflict.types.push(entityType);
+          } else {
+            this.conflicts.push({
+              id,
+              types: [existingEntity.type, entityType],
+              resolvedNames: {
+                [existingEntity.type]: baseName
+              }
+            });
+          }
+        }
+        const suffix = this.getSuffixForType(entityType);
+        const uniqueName = baseName + suffix;
+        let finalName = uniqueName;
+        let counter = 2;
+        while (this.registry.usedNames.has(finalName)) {
+          finalName = `${uniqueName}${counter}`;
+          counter++;
+        }
+        this.register(id, finalName, entityType);
+        const conflict = this.conflicts.find((c2) => c2.id === id);
+        if (conflict) {
+          conflict.resolvedNames[entityType] = finalName;
+        }
+        return finalName;
+      }
+      /**
+       * Register an existing variable name (from detected patterns)
+       */
+      register(id, variableName, entityType) {
+        const registryMap = this.getRegistryMap(entityType);
+        registryMap.set(id, variableName);
+        this.registry.usedNames.set(variableName, { id, type: entityType });
+      }
+      /**
+       * Get the registry for lookup
+       */
+      getRegistry() {
+        return this.registry;
+      }
+      /**
+       * Get all conflicts that were resolved
+       */
+      getConflicts() {
+        return this.conflicts;
+      }
+      /**
+       * Convert ID to camelCase variable name
+       */
+      idToVariableName(id) {
+        if (this.isRandomId(id)) {
+          return id;
+        }
+        const parts = id.split(/[-_]/);
+        const camelCase = parts.map((part, index2) => {
+          if (index2 === 0) {
+            return part.toLowerCase();
+          }
+          return part.charAt(0).toUpperCase() + part.slice(1).toLowerCase();
+        }).join("");
+        return camelCase;
+      }
+      /**
+       * Check if an ID looks random/UUID-like
+       */
+      isRandomId(id) {
+        if (!id.includes("-") && !id.includes("_")) {
+          return /[0-9]/.test(id) || /[A-Z]/.test(id);
+        }
+        return false;
+      }
+      /**
+       * Generate filename from entity data (for file naming)
+       */
+      generateFileName(id, entityType, entityData) {
+        let baseName;
+        if (entityType === "tool" && entityData?.name && this.isRandomId(id)) {
+          baseName = this.nameToFileName(entityData.name);
+        } else {
+          baseName = this.idToFileName(id);
+        }
+        return baseName;
+      }
+      /**
+       * Convert name to kebab-case filename
+       */
+      nameToFileName(name) {
+        return name.replace(/[^\w\s-]/g, "").trim().replace(/\s+/g, "-").replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+      }
+      /**
+       * Convert ID to kebab-case filename
+       */
+      idToFileName(id) {
+        return id.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
+      }
+      /**
+       * Get appropriate suffix for entity type
+       */
+      getSuffixForType(entityType) {
+        switch (entityType) {
+          case "project":
+            return this.conventions.projectSuffix;
+          case "agent":
+            return this.conventions.agentSuffix;
+          case "subAgent":
+            return this.conventions.subAgentSuffix;
+          case "tool":
+            return this.conventions.toolSuffix || "";
+          case "dataComponent":
+            return this.conventions.dataComponentSuffix || "";
+          case "artifactComponent":
+            return this.conventions.artifactComponentSuffix || "";
+          case "statusComponent":
+            return this.conventions.statusComponentSuffix || "";
+          case "credential":
+            return this.conventions.credentialSuffix || "";
+          case "environment":
+            return this.conventions.environmentSuffix || "";
+          case "externalAgent":
+            return this.conventions.externalAgentSuffix || "";
+          default:
+            return "";
+        }
+      }
+      /**
+       * Get the appropriate registry map for an entity type
+       */
+      getRegistryMap(entityType) {
+        switch (entityType) {
+          case "project":
+            return this.registry.projects;
+          case "agent":
+            return this.registry.agents;
+          case "subAgent":
+            return this.registry.subAgents;
+          case "tool":
+            return this.registry.tools;
+          case "dataComponent":
+            return this.registry.dataComponents;
+          case "artifactComponent":
+            return this.registry.artifactComponents;
+          case "statusComponent":
+            return this.registry.statusComponents;
+          case "credential":
+            return this.registry.credentials;
+          case "environment":
+            return this.registry.environments;
+          case "externalAgent":
+            return this.registry.externalAgents;
+          default:
+            throw new Error(`Unknown entity type: ${entityType}`);
+        }
+      }
+    };
+  }
+});
+
 // src/commands/pull.placeholder-system.ts
 import { randomBytes as randomBytes2 } from "crypto";
 import { jsonSchemaToZod } from "json-schema-to-zod";
@@ -234503,6 +234919,7 @@ __export(pull_llm_generate_exports, {
   generateDataComponentFile: () => generateDataComponentFile,
   generateEnvironmentFileTemplate: () => generateEnvironmentFileTemplate,
   generateEnvironmentFiles: () => generateEnvironmentFiles,
+  generateExternalAgentFile: () => generateExternalAgentFile,
   generateIndexFile: () => generateIndexFile,
   generateStatusComponentFile: () => generateStatusComponentFile,
   generateTextWithPlaceholders: () => generateTextWithPlaceholders,
@@ -234554,7 +234971,9 @@ function detectAvailableProvider() {
   if (googleKey) {
     return "google";
   }
-  throw new Error("No LLM provider API key found. Please set ANTHROPIC_API_KEY, OPENAI_API_KEY, or GOOGLE_API_KEY");
+  throw new Error(
+    "No LLM provider API key found. Please set ANTHROPIC_API_KEY, OPENAI_API_KEY, or GOOGLE_API_KEY"
+  );
 }
 function getDefaultModelForProvider(provider) {
   switch (provider) {
@@ -234726,7 +235145,7 @@ Generate ONLY the TypeScript code without any markdown or explanations.`;
   );
   writeFileSync3(outputPath, cleanGeneratedCode(text4));
 }
-function generateImportMappings(toolFilenames, componentFilenames) {
+function generateImportMappings(toolFilenames, componentFilenames, externalAgentFilenames) {
   let result = "";
   if (toolFilenames && toolFilenames.size > 0) {
     result += "TOOLS (use exact import paths):\n";
@@ -234751,9 +235170,18 @@ function generateImportMappings(toolFilenames, componentFilenames) {
 `;
     }
   }
+  if (externalAgentFilenames && externalAgentFilenames.size > 0) {
+    result += "EXTERNAL AGENTS (use exact import paths):\n";
+    for (const [externalAgentId, fileName] of externalAgentFilenames.entries()) {
+      result += `  - External Agent ID: "${externalAgentId}" \u2192 Import: "../external-agents/${fileName.replace(".ts", "")}"
+`;
+    }
+    result += "\n";
+  }
+  console.log("result", result);
   return result;
 }
-async function generateAgentFile(agentData, agentId, outputPath, modelSettings, toolFilenames, componentFilenames, debug = false, reasoningConfig) {
+async function generateAgentFile(agentData, agentId, outputPath, modelSettings, toolFilenames, componentFilenames, externalAgentFilenames, debug = false, reasoningConfig) {
   const model = createModel(modelSettings);
   const promptTemplate = `Generate a TypeScript file for an Inkeep agent.
 
@@ -234763,7 +235191,7 @@ AGENT DATA:
 AGENT ID: ${agentId}
 
 ${toolFilenames || componentFilenames ? `IMPORT PATH MAPPINGS (CRITICAL - USE EXACT PATHS):
-${generateImportMappings(toolFilenames, componentFilenames)}
+${generateImportMappings(toolFilenames, componentFilenames, externalAgentFilenames)}
 
 !!! WARNING: Entity IDs \u2260 File Paths !!!
 - Entity IDs may use underscores or different naming
@@ -234796,6 +235224,7 @@ REQUIREMENTS:
 2. Define each agent using the agent() function following the type definitions provided above
 3. Create the agent using agent() with proper structure
    - IMPORTANT: If description is null, undefined, or empty string, omit the description field entirely
+4. External agents live within the agents directory, import them using the import { externalAgent } from '../agents/external-agent'; syntax.
 4. CRITICAL: Template Literals vs Raw Code:
    - For STRING VALUES: ALWAYS use template literals with backticks: \`string content\`
    - This includes: prompt, description, query, url, method, body, defaultValue, etc.
@@ -234839,12 +235268,13 @@ prompt: \`<{{subAgents.facts.prompt.abc12345}}>\`
 prompt: '<{{subAgents.facts.prompt.abc12345}}>'
 
 FULL EXAMPLE:
-import { agent, agent } from '@inkeep/agents-sdk';
+import { agent } from '@inkeep/agents-sdk';
 import { contextConfig, fetchDefinition, headers } from '@inkeep/agents-core';
 import { userProfile } from '../data-components/user-profile';
 import { searchTool } from '../tools/search-tool';
 import { weatherTool } from '../tools/weather-tool';
 import { toolSummary } from '../status-components/tool-summary';
+import { externalHelperAgent } from '../agents/external-helper-agent';
 import { progressStatus } from '../status-components/progress-status';
 import { z } from 'zod';
 
@@ -234885,6 +235315,7 @@ const routerAgent = agent({
   name: 'Router Agent',
   prompt: \`Route requests to appropriate agents using \${supportAgentContext.toTemplate('supportDescription.description')} for the user \${supportAgentHeaders.toTemplate('userId')}\`,
   canTransferTo: () => [qaAgent]
+  canDelegateTo: () => [externalHelperAgent.with({ headers: { 'X-API-Key': '123' } })],
 });
 
 const qaAgent = agent({
@@ -234898,6 +235329,7 @@ Follow these rules:
 - Use the user's name \${supportAgentHeaders.toTemplate('userId')} when applicable
 - Use available tools\`,
   canUse: () => [searchTool, weatherTool],
+  canDelegateTo: () => [externalHelperAgent],
   selectedTools: {
     [searchTool.id]: ['search_web', 'search_docs'],
     [weatherTool.id]: ['get_forecast']
@@ -235321,6 +235753,61 @@ Generate ONLY the TypeScript code without any markdown or explanations.`;
   );
   writeFileSync3(outputPath, cleanGeneratedCode(text4));
 }
+async function generateExternalAgentFile(externalAgentData, externalAgentId, outputPath, modelSettings, reasoningConfig) {
+  const model = createModel(modelSettings);
+  const promptTemplate = `Generate a TypeScript file for an Inkeep external agent.
+
+EXTERNAL AGENT DATA:
+{{DATA}}
+
+EXTERNAL AGENT ID: ${externalAgentId}
+
+${getTypeDefinitions()}
+
+${NAMING_CONVENTION_RULES}
+
+${IMPORT_INSTRUCTIONS}
+
+REQUIREMENTS:
+1. Import externalAgent from '@inkeep/agents-sdk'
+3. Create the external agent using externalAgent()
+4. Export following naming convention rules (camelCase version of ID)
+5. Include all properties from the external agent data INCLUDING the 'id' property
+6. CRITICAL: All imports must be alphabetically sorted to comply with Biome linting
+7. CRITICAL: Use template literals with backticks for all STRING values (url, description, etc.)
+
+EXAMPLE:
+import { externalAgent } from '@inkeep/agents-sdk';
+import { }
+
+export const externalHelper = externalAgent({
+  id: 'external-helper',
+  name: 'External Helper',
+  url: \`https://api.example.com/agent\`,
+  credentialReference: 'my-credential-reference',
+});
+
+
+Generate ONLY the TypeScript code without any markdown or explanations.`;
+  const text4 = await generateTextWithPlaceholders(
+    model,
+    externalAgentData,
+    promptTemplate,
+    {
+      temperature: 0.1,
+      maxOutputTokens: 4e3,
+      abortSignal: AbortSignal.timeout(9e4)
+      // 90 second timeout (increased for reasoning)
+    },
+    false,
+    // debug
+    { fileType: "external_agent" },
+    // context - for Langfuse metadata
+    reasoningConfig
+    // reasoning config
+  );
+  writeFileSync3(outputPath, cleanGeneratedCode(text4));
+}
 function generateEnvironmentFileTemplate(environmentsDir, environment, credentials) {
   const { writeFileSync: writeFileSync7 } = require3("node:fs");
   const { join: join14 } = require3("node:path");
@@ -235341,9 +235828,11 @@ function generateEnvironmentFileTemplate(environmentsDir, environment, credentia
           `retrievalParams: ${JSON.stringify(cred.retrievalParams, null, 6).replace(/\n/g, "\n      ")}`
         );
       }
-      credentialEntries.push(`    ${varName}: credential({
+      credentialEntries.push(
+        `    ${varName}: credential({
       ${params.join(",\n      ")}
-    })`);
+    })`
+      );
     }
     credentialsCode = `
 ${credentialEntries.join(",\n")}
@@ -235504,7 +235993,7 @@ export const myProject = project({
 });
 `;
         break;
-      case "agent":
+      case "agent": {
         const importMappings = spec.toolFilenames || spec.componentFilenames ? `IMPORT PATH MAPPINGS (CRITICAL - USE EXACT PATHS):
 ${generateImportMappings(spec.toolFilenames, spec.componentFilenames)}
 
@@ -235546,6 +236035,7 @@ ${importMappings}REQUIREMENTS FOR AGENT FILE:
 6. If you are writing zod schemas make them clean. For example if you see z.union([z.string(), z.null()]) write it as z.string().nullable()
 `;
         break;
+      }
       case "tool":
         fileSpecificInstructions = `
 REQUIREMENTS FOR TOOL FILE:
@@ -235557,6 +236047,16 @@ REQUIREMENTS FOR TOOL FILE:
 6. Convert credentialReferenceId to credential key format by replacing hyphens with underscores for the getEnvironmentSetting() call (e.g., 'inkeep-api-credential' becomes 'inkeep_api_credential')
 7. TRANSPORT CONFIG: If config.mcp.transport exists, extract it as a transport property (not nested in config)
 8. NO CONFIG OBJECT: mcpTool does not accept a 'config' property - use individual properties only
+`;
+        break;
+      case "external_agent":
+        fileSpecificInstructions = `
+REQUIREMENTS FOR EXTERNAL AGENT FILE:
+1. Import externalAgent from '@inkeep/agents-sdk'
+2. Create the external agent using externalAgent()
+3. Export following naming convention rules (camelCase version of ID)
+5. CRITICAL: If credentialReferenceId exists in external agent data, add it as a credential property using envSettings.getEnvironmentSetting()
+6. Convert credentialReferenceId to credential key format by replacing hyphens with underscores for the getEnvironmentSetting() call (e.g., 'inkeep-api-credential' becomes 'inkeep_api_credential')
 `;
         break;
       case "data_component":
@@ -236067,325 +236567,6 @@ import { weatherAgent } from './agent/weather-agent';
   }
 });
 
-// src/codegen/variable-name-registry.ts
-var variable_name_registry_exports = {};
-__export(variable_name_registry_exports, {
-  DEFAULT_NAMING_CONVENTIONS: () => DEFAULT_NAMING_CONVENTIONS,
-  VariableNameGenerator: () => VariableNameGenerator,
-  collectAllEntities: () => collectAllEntities
-});
-function collectAllEntities(projectData) {
-  const entities = [];
-  entities.push({ id: projectData.id, type: "project", data: projectData });
-  if (projectData.agents) {
-    for (const [agentId, agentData] of Object.entries(projectData.agents)) {
-      entities.push({ id: agentId, type: "agent", data: agentData });
-      const agentObj = agentData;
-      if (agentObj.subAgents) {
-        for (const [subAgentId, subAgentData] of Object.entries(agentObj.subAgents)) {
-          entities.push({ id: subAgentId, type: "subAgent", data: subAgentData });
-        }
-      }
-    }
-  }
-  if (projectData.tools) {
-    for (const [toolId, toolData] of Object.entries(projectData.tools)) {
-      entities.push({ id: toolId, type: "tool", data: toolData });
-    }
-  }
-  if (projectData.dataComponents) {
-    for (const [compId, compData] of Object.entries(projectData.dataComponents)) {
-      entities.push({ id: compId, type: "dataComponent", data: compData });
-    }
-  }
-  if (projectData.artifactComponents) {
-    for (const [compId, compData] of Object.entries(projectData.artifactComponents)) {
-      entities.push({ id: compId, type: "artifactComponent", data: compData });
-    }
-  }
-  if (projectData.agents) {
-    for (const [_agentId, agentData] of Object.entries(projectData.agents)) {
-      const agentObj = agentData;
-      if (agentObj.statusUpdates?.statusComponents) {
-        for (const statusComp of agentObj.statusUpdates.statusComponents) {
-          if (statusComp.type) {
-            entities.push({ id: statusComp.type, type: "statusComponent" });
-          }
-        }
-      }
-    }
-  }
-  const credentialReferences2 = /* @__PURE__ */ new Set();
-  if (projectData.credentialReferences) {
-    for (const credId of Object.keys(projectData.credentialReferences)) {
-      credentialReferences2.add(credId);
-    }
-  }
-  if (projectData.tools) {
-    for (const [_toolId, toolData] of Object.entries(projectData.tools)) {
-      const tool2 = toolData;
-      if (tool2.credentialReferenceId) {
-        credentialReferences2.add(tool2.credentialReferenceId);
-      }
-    }
-  }
-  if (projectData.externalAgents) {
-    for (const [_agentId, agentData] of Object.entries(projectData.externalAgents)) {
-      const agent = agentData;
-      if (agent.credentialReferenceId) {
-        credentialReferences2.add(agent.credentialReferenceId);
-      }
-    }
-  }
-  if (projectData.agents) {
-    for (const [_agentId, agentData] of Object.entries(projectData.agents)) {
-      const agent = agentData;
-      if (agent.contextConfig?.headers?.credentialReferenceId) {
-        credentialReferences2.add(agent.contextConfig.headers.credentialReferenceId);
-      }
-      if (agent.contextConfig?.contextVariables) {
-        for (const [_varId, varData] of Object.entries(agent.contextConfig.contextVariables)) {
-          const contextVar = varData;
-          if (contextVar.credentialReferenceId) {
-            credentialReferences2.add(contextVar.credentialReferenceId);
-          }
-        }
-      }
-      if (agent.subAgents) {
-        for (const [_subAgentId, subAgentData] of Object.entries(agent.subAgents)) {
-          const subAgent = subAgentData;
-          if (subAgent.contextConfig?.headers?.credentialReferenceId) {
-            credentialReferences2.add(subAgent.contextConfig.headers.credentialReferenceId);
-          }
-          if (subAgent.contextConfig?.contextVariables) {
-            for (const [_varId, varData] of Object.entries(subAgent.contextConfig.contextVariables)) {
-              const contextVar = varData;
-              if (contextVar.credentialReferenceId) {
-                credentialReferences2.add(contextVar.credentialReferenceId);
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-  return entities;
-}
-var DEFAULT_NAMING_CONVENTIONS, VariableNameGenerator;
-var init_variable_name_registry = __esm({
-  "src/codegen/variable-name-registry.ts"() {
-    "use strict";
-    init_esm_shims();
-    DEFAULT_NAMING_CONVENTIONS = {
-      projectSuffix: "Project",
-      agentSuffix: "Agent",
-      subAgentSuffix: "SubAgent",
-      toolSuffix: null,
-      // Usually no suffix needed
-      dataComponentSuffix: null,
-      artifactComponentSuffix: null,
-      statusComponentSuffix: null,
-      credentialSuffix: null,
-      environmentSuffix: null
-      // No suffix needed for environments
-    };
-    VariableNameGenerator = class {
-      registry;
-      conventions;
-      conflicts;
-      constructor(conventions = DEFAULT_NAMING_CONVENTIONS) {
-        this.registry = {
-          projects: /* @__PURE__ */ new Map(),
-          agents: /* @__PURE__ */ new Map(),
-          subAgents: /* @__PURE__ */ new Map(),
-          tools: /* @__PURE__ */ new Map(),
-          dataComponents: /* @__PURE__ */ new Map(),
-          artifactComponents: /* @__PURE__ */ new Map(),
-          statusComponents: /* @__PURE__ */ new Map(),
-          credentials: /* @__PURE__ */ new Map(),
-          environments: /* @__PURE__ */ new Map(),
-          usedNames: /* @__PURE__ */ new Map()
-        };
-        this.conventions = conventions;
-        this.conflicts = [];
-      }
-      /**
-       * Generate unique variable name for an entity
-       * Ensures no conflicts across all entity types
-       */
-      generateVariableName(id, entityType, entityData) {
-        const registryMap = this.getRegistryMap(entityType);
-        const existing = registryMap.get(id);
-        if (existing) {
-          return existing;
-        }
-        let baseName;
-        if (entityType === "tool" && entityData?.name && this.isRandomId(id)) {
-          baseName = this.idToVariableName(entityData.name);
-        } else {
-          baseName = this.idToVariableName(id);
-        }
-        if (!this.registry.usedNames.has(baseName)) {
-          this.register(id, baseName, entityType);
-          return baseName;
-        }
-        const existingEntity = this.registry.usedNames.get(baseName);
-        if (existingEntity) {
-          const existingConflict = this.conflicts.find((c2) => c2.id === id);
-          if (existingConflict) {
-            existingConflict.types.push(entityType);
-          } else {
-            this.conflicts.push({
-              id,
-              types: [existingEntity.type, entityType],
-              resolvedNames: {
-                [existingEntity.type]: baseName
-              }
-            });
-          }
-        }
-        const suffix = this.getSuffixForType(entityType);
-        const uniqueName = baseName + suffix;
-        let finalName = uniqueName;
-        let counter = 2;
-        while (this.registry.usedNames.has(finalName)) {
-          finalName = `${uniqueName}${counter}`;
-          counter++;
-        }
-        this.register(id, finalName, entityType);
-        const conflict = this.conflicts.find((c2) => c2.id === id);
-        if (conflict) {
-          conflict.resolvedNames[entityType] = finalName;
-        }
-        return finalName;
-      }
-      /**
-       * Register an existing variable name (from detected patterns)
-       */
-      register(id, variableName, entityType) {
-        const registryMap = this.getRegistryMap(entityType);
-        registryMap.set(id, variableName);
-        this.registry.usedNames.set(variableName, { id, type: entityType });
-      }
-      /**
-       * Get the registry for lookup
-       */
-      getRegistry() {
-        return this.registry;
-      }
-      /**
-       * Get all conflicts that were resolved
-       */
-      getConflicts() {
-        return this.conflicts;
-      }
-      /**
-       * Convert ID to camelCase variable name
-       */
-      idToVariableName(id) {
-        if (this.isRandomId(id)) {
-          return id;
-        }
-        const parts = id.split(/[-_]/);
-        const camelCase = parts.map((part, index2) => {
-          if (index2 === 0) {
-            return part.toLowerCase();
-          }
-          return part.charAt(0).toUpperCase() + part.slice(1).toLowerCase();
-        }).join("");
-        return camelCase;
-      }
-      /**
-       * Check if an ID looks random/UUID-like
-       */
-      isRandomId(id) {
-        if (!id.includes("-") && !id.includes("_")) {
-          return /[0-9]/.test(id) || /[A-Z]/.test(id);
-        }
-        return false;
-      }
-      /**
-       * Generate filename from entity data (for file naming)
-       */
-      generateFileName(id, entityType, entityData) {
-        let baseName;
-        if (entityType === "tool" && entityData?.name && this.isRandomId(id)) {
-          baseName = this.nameToFileName(entityData.name);
-        } else {
-          baseName = this.idToFileName(id);
-        }
-        return baseName;
-      }
-      /**
-       * Convert name to kebab-case filename
-       */
-      nameToFileName(name) {
-        return name.replace(/[^\w\s-]/g, "").trim().replace(/\s+/g, "-").replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
-      }
-      /**
-       * Convert ID to kebab-case filename
-       */
-      idToFileName(id) {
-        return id.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
-      }
-      /**
-       * Get appropriate suffix for entity type
-       */
-      getSuffixForType(entityType) {
-        switch (entityType) {
-          case "project":
-            return this.conventions.projectSuffix;
-          case "agent":
-            return this.conventions.agentSuffix;
-          case "subAgent":
-            return this.conventions.subAgentSuffix;
-          case "tool":
-            return this.conventions.toolSuffix || "";
-          case "dataComponent":
-            return this.conventions.dataComponentSuffix || "";
-          case "artifactComponent":
-            return this.conventions.artifactComponentSuffix || "";
-          case "statusComponent":
-            return this.conventions.statusComponentSuffix || "";
-          case "credential":
-            return this.conventions.credentialSuffix || "";
-          case "environment":
-            return this.conventions.environmentSuffix || "";
-          default:
-            return "";
-        }
-      }
-      /**
-       * Get the appropriate registry map for an entity type
-       */
-      getRegistryMap(entityType) {
-        switch (entityType) {
-          case "project":
-            return this.registry.projects;
-          case "agent":
-            return this.registry.agents;
-          case "subAgent":
-            return this.registry.subAgents;
-          case "tool":
-            return this.registry.tools;
-          case "dataComponent":
-            return this.registry.dataComponents;
-          case "artifactComponent":
-            return this.registry.artifactComponents;
-          case "statusComponent":
-            return this.registry.statusComponents;
-          case "credential":
-            return this.registry.credentials;
-          case "environment":
-            return this.registry.environments;
-          default:
-            throw new Error(`Unknown entity type: ${entityType}`);
-        }
-      }
-    };
-  }
-});
-
 // src/codegen/pattern-analyzer.ts
 var pattern_analyzer_exports = {};
 __export(pattern_analyzer_exports, {
@@ -236422,6 +236603,7 @@ function analyzeFileStructure(projectDir) {
   const hasDataComponentsDirectory = existsSync7(join8(projectDir, "data-components"));
   const hasArtifactComponentsDirectory = existsSync7(join8(projectDir, "artifact-components"));
   const hasEnvironmentsDirectory = existsSync7(join8(projectDir, "environments"));
+  const hasExternalAgentsDirectory = existsSync7(join8(projectDir, "external-agents"));
   let toolsLocation = "unknown";
   if (hasToolsDirectory) {
     toolsLocation = "separate";
@@ -236448,7 +236630,8 @@ function analyzeFileStructure(projectDir) {
     hasAgentsDirectory,
     hasDataComponentsDirectory,
     hasArtifactComponentsDirectory,
-    hasEnvironmentsDirectory
+    hasEnvironmentsDirectory,
+    hasExternalAgentsDirectory
   };
 }
 function detectFileNamingConvention(files) {
@@ -236531,7 +236714,8 @@ function extractVariableMappings(code, filePath) {
     "tool",
     "tool",
     "dataComponent",
-    "artifactComponent"
+    "artifactComponent",
+    "externalAgent"
   ];
   patterns.forEach((pattern, index2) => {
     const matches = code.matchAll(pattern);
@@ -236625,9 +236809,9 @@ function mostCommon(arr) {
   }
   let maxCount = 0;
   let mostCommonItem = null;
-  for (const [item, count16] of counts.entries()) {
-    if (count16 > maxCount) {
-      maxCount = count16;
+  for (const [item, count17] of counts.entries()) {
+    if (count17 > maxCount) {
+      maxCount = count17;
       mostCommonItem = item;
     }
   }
@@ -236693,6 +236877,7 @@ function displayPlanSummary(plan) {
     dataComponent: [],
     artifactComponent: [],
     statusComponent: [],
+    externalAgent: [],
     environment: []
   };
   for (const file of plan.files) {
@@ -236727,6 +236912,12 @@ function displayPlanSummary(plan) {
       }
     }
   }
+  if (filesByType.externalAgent.length > 0) {
+    console.log(chalk8.gray("\n  External Agents:"));
+    for (const file of filesByType.externalAgent) {
+      console.log(chalk8.gray(`    \u2022 ${file.path}`));
+    }
+  }
   if (filesByType.dataComponent.length > 0) {
     console.log(chalk8.gray("\n  Data Components:"));
     for (const file of filesByType.dataComponent) {
@@ -236889,7 +237080,12 @@ async function generatePlan(projectData, patterns, modelSettings, createModel2,
     fileNameMappings.set(entity.id, fileName);
   }
   const model = createModel2(modelSettings);
-  const promptTemplate = createPlanningPromptTemplate(nameGenerator.getRegistry(), allEntities, fileNameMappings, targetEnvironment);
+  const promptTemplate = createPlanningPromptTemplate(
+    nameGenerator.getRegistry(),
+    allEntities,
+    fileNameMappings,
+    targetEnvironment
+  );
   const promptData = {
     projectData,
     patterns
@@ -236943,7 +237139,7 @@ CRITICAL RULES:
 1. TOOL TYPES - VERY IMPORTANT:
    - **Function Tools** (type: "function"): ALWAYS define INLINE within agent files using "inlineContent" array
    - **MCP Tools** (type: "mcp"): Create separate files in tools/ directory
-   - VALID FILE TYPES: Only use these exact types: "agent", "tool", "dataComponent", "artifactComponent", "statusComponent", "environment", "index"
+   - VALID FILE TYPES: Only use these exact types: "agent", "tool", "dataComponent", "artifactComponent", "externalAgent", "statusComponent", "environment", "index"
    - NEVER create file type "functionTool" - function tools go in "inlineContent" of agent files
 
 2. STATUS COMPONENTS - VERY IMPORTANT:
@@ -236976,6 +237172,7 @@ CRITICAL RULES:
    - data-components/ directory: Data component files
    - artifact-components/ directory: Artifact component files
    - status-components/ directory: Status component files
+    - external-agents/ directory: External agent files
    - environments/ directory: Environment/credential files
    - index.ts: Main project file
 
@@ -237016,6 +237213,11 @@ OUTPUT FORMAT (JSON):
           "fromPath": "../tools/weather-api",
           "entityType": "tool"
         }
+        {
+          "variableName": "externalHelper",
+          "fromPath": "../external-agents/external-helper",
+          "entityType": "externalAgent"
+        }
       ],
       "inlineContent": [
         {
@@ -237040,6 +237242,20 @@ OUTPUT FORMAT (JSON):
       "dependencies": [],
       "inlineContent": null
     },
+    {
+      "path": "external-agents/external-helper.ts",
+      "type": "externalAgent",
+      "entities": [
+        {
+          "id": "external-helper",
+          "variableName": "externalHelper",
+          "entityType": "externalAgent",
+          "exportName": "externalHelper"
+        }
+      ],
+      "dependencies": [],
+      "inlineContent": null
+    },
     {
       "path": "status-components/tool-summary.ts",
       "type": "statusComponent",
@@ -237127,6 +237343,7 @@ function formatVariableMappings(registry2, allEntities) {
     dataComponent: [],
     artifactComponent: [],
     statusComponent: [],
+    externalAgent: [],
     credential: [],
     environment: []
   };
@@ -237161,6 +237378,7 @@ function formatFileNameMappings(fileNameMappings, allEntities) {
     artifactComponent: [],
     statusComponent: [],
     credential: [],
+    externalAgent: [],
     environment: []
   };
   for (const entity of allEntities) {
@@ -237208,6 +237426,8 @@ function getRegistryMap(registry2, entityType) {
       return registry2.artifactComponents;
     case "statusComponent":
       return registry2.statusComponents;
+    case "externalAgent":
+      return registry2.externalAgents;
     case "credential":
       return registry2.credentials;
     case "environment":
@@ -237366,6 +237586,9 @@ async function generateFilesFromPlan(plan, projectData, dirs, modelSettings, deb
       case "statusComponent":
         batchType = "status_component";
         break;
+      case "externalAgent":
+        batchType = "external_agent";
+        break;
       default:
         throw new Error(`Unknown file type for batch generation: ${fileInfo.type}`);
     }
@@ -237385,7 +237608,9 @@ async function generateFilesFromPlan(plan, projectData, dirs, modelSettings, deb
     await generateAllFilesInBatch(fileSpecs, modelSettings, debug, reasoningConfig);
   }
   if (debug && environmentFiles.length > 0) {
-    console.log(`[DEBUG] Generating ${environmentFiles.length} environment files using templates (no LLM)...`);
+    console.log(
+      `[DEBUG] Generating ${environmentFiles.length} environment files using templates (no LLM)...`
+    );
   }
   for (const envFile of environmentFiles) {
     const envStartTime = Date.now();
@@ -237431,6 +237656,13 @@ function extractDataForFile(fileInfo, projectData) {
       }
       return {};
     }
+    case "externalAgent": {
+      const agentId = fileInfo.entities[0]?.id;
+      if (agentId && projectData.externalAgents) {
+        return projectData.externalAgents[agentId];
+      }
+      return {};
+    }
     case "dataComponent": {
       const compId = fileInfo.entities[0]?.id;
       if (compId && projectData.dataComponents) {
@@ -237567,7 +237799,9 @@ function extractDataForFile(fileInfo, projectData) {
                 }
               }
               if (subAgent.contextConfig?.contextVariables) {
-                for (const [varId, varData] of Object.entries(subAgent.contextConfig.contextVariables)) {
+                for (const [varId, varData] of Object.entries(
+                  subAgent.contextConfig.contextVariables
+                )) {
                   const contextVar = varData;
                   if (contextVar.credentialReferenceId) {
                     const credId = contextVar.credentialReferenceId;
@@ -238946,45 +239180,9 @@ ${table.toString()}`);
 init_esm_shims();
 import { existsSync as existsSync9, mkdirSync as mkdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "fs";
 import { dirname as dirname5, join as join10, resolve as resolve4 } from "path";
-import chalk9 from "chalk";
 import * as p7 from "@clack/prompts";
-init_config();
-
-// src/utils/project-directory.ts
-init_esm_shims();
-import { existsSync as existsSync5 } from "fs";
-import { join as join5, resolve as resolve3 } from "path";
-import { findUp as findUp2 } from "find-up";
-async function findProjectDirectory(projectId, configPath) {
-  if (configPath) {
-    const absoluteConfigPath = resolve3(process.cwd(), configPath);
-    if (existsSync5(absoluteConfigPath)) {
-      return resolve3(absoluteConfigPath, "..");
-    }
-  }
-  if (projectId) {
-    if (projectId.includes("/") || projectId.includes("\\")) {
-      const projectPath = resolve3(process.cwd(), projectId);
-      if (existsSync5(join5(projectPath, "inkeep.config.ts"))) {
-        return projectPath;
-      }
-    } else {
-      const projectPath = join5(process.cwd(), projectId);
-      if (existsSync5(join5(projectPath, "inkeep.config.ts"))) {
-        return projectPath;
-      }
-    }
-    return null;
-  }
-  const foundConfigPath = await findUp2("inkeep.config.ts");
-  if (foundConfigPath) {
-    return resolve3(foundConfigPath, "..");
-  }
-  return null;
-}
-
-// src/commands/pull.ts
-init_tsx_loader();
+import chalk9 from "chalk";
+init_variable_name_registry();
 
 // src/utils/background-version-check.ts
 init_esm_shims();
@@ -238992,16 +239190,16 @@ import chalk7 from "chalk";
 
 // src/utils/version-check.ts
 init_esm_shims();
-import { existsSync as existsSync6, readFileSync as readFileSync2 } from "fs";
-import { dirname as dirname4, join as join6 } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync2 } from "fs";
+import { dirname as dirname4, join as join5 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var __filename2 = fileURLToPath2(import.meta.url);
 var __dirname2 = dirname4(__filename2);
 var DEFAULT_PACKAGE_NAME = "@inkeep/agents-cli";
 function getCurrentVersion() {
-  let packageJsonPath2 = join6(__dirname2, "..", "package.json");
-  if (!existsSync6(packageJsonPath2)) {
-    packageJsonPath2 = join6(__dirname2, "..", "..", "package.json");
+  let packageJsonPath2 = join5(__dirname2, "..", "package.json");
+  if (!existsSync5(packageJsonPath2)) {
+    packageJsonPath2 = join5(__dirname2, "..", "..", "package.json");
   }
   const packageJson2 = JSON.parse(readFileSync2(packageJsonPath2, "utf-8"));
   return packageJson2.version;
@@ -239073,8 +239271,43 @@ function performBackgroundVersionCheck() {
 }
 
 // src/commands/pull.ts
-init_pull_llm_generate();
-init_variable_name_registry();
+init_config();
+
+// src/utils/project-directory.ts
+init_esm_shims();
+import { existsSync as existsSync6 } from "fs";
+import { join as join6, resolve as resolve3 } from "path";
+import { findUp as findUp2 } from "find-up";
+async function findProjectDirectory(projectId, configPath) {
+  if (configPath) {
+    const absoluteConfigPath = resolve3(process.cwd(), configPath);
+    if (existsSync6(absoluteConfigPath)) {
+      return resolve3(absoluteConfigPath, "..");
+    }
+  }
+  if (projectId) {
+    if (projectId.includes("/") || projectId.includes("\\")) {
+      const projectPath = resolve3(process.cwd(), projectId);
+      if (existsSync6(join6(projectPath, "inkeep.config.ts"))) {
+        return projectPath;
+      }
+    } else {
+      const projectPath = join6(process.cwd(), projectId);
+      if (existsSync6(join6(projectPath, "inkeep.config.ts"))) {
+        return projectPath;
+      }
+    }
+    return null;
+  }
+  const foundConfigPath = await findUp2("inkeep.config.ts");
+  if (foundConfigPath) {
+    return resolve3(foundConfigPath, "..");
+  }
+  return null;
+}
+
+// src/commands/pull.ts
+init_tsx_loader();
 async function detectCurrentProject(debug = false) {
   const indexPath = join10(process.cwd(), "index.ts");
   if (debug) {
@@ -239294,6 +239527,7 @@ function createProjectStructure(projectDir, projectId, useCurrentDirectory = fal
   const artifactComponentsDir = join10(projectRoot, "artifact-components");
   const statusComponentsDir = join10(projectRoot, "status-components");
   const environmentsDir = join10(projectRoot, "environments");
+  const externalAgentsDir = join10(projectRoot, "external-agents");
   ensureDirectoryExists(projectRoot);
   ensureDirectoryExists(agentsDir);
   ensureDirectoryExists(toolsDir);
@@ -239301,6 +239535,7 @@ function createProjectStructure(projectDir, projectId, useCurrentDirectory = fal
   ensureDirectoryExists(artifactComponentsDir);
   ensureDirectoryExists(statusComponentsDir);
   ensureDirectoryExists(environmentsDir);
+  ensureDirectoryExists(externalAgentsDir);
   return {
     projectRoot,
     agentsDir,
@@ -239308,7 +239543,8 @@ function createProjectStructure(projectDir, projectId, useCurrentDirectory = fal
     dataComponentsDir,
     artifactComponentsDir,
     statusComponentsDir,
-    environmentsDir
+    environmentsDir,
+    externalAgentsDir
   };
 }
 async function pullProjectCommand(options) {
@@ -239317,12 +239553,14 @@ async function pullProjectCommand(options) {
   try {
     const { detectAvailableProvider: detectAvailableProvider2 } = await Promise.resolve().then(() => (init_pull_llm_generate(), pull_llm_generate_exports));
     provider = detectAvailableProvider2();
-    console.log(chalk9.gray(`
-\u{1F916} Using ${provider.charAt(0).toUpperCase() + provider.slice(1)} for code generation`));
-  } catch (error) {
-    console.error(
-      chalk9.red("\n\u274C Error: No LLM provider API key found")
+    console.log(
+      chalk9.gray(
+        `
+\u{1F916} Using ${provider.charAt(0).toUpperCase() + provider.slice(1)} for code generation`
+      )
     );
+  } catch (error) {
+    console.error(chalk9.red("\n\u274C Error: No LLM provider API key found"));
     console.error(
       chalk9.yellow(
         "\nThe pull command requires AI to generate TypeScript files from your project configuration."
@@ -239506,6 +239744,13 @@ async function pullProjectCommand(options) {
       const statusComponents = agentObj.statusUpdates?.statusComponents || [];
       return total + statusComponents.length;
     }, 0);
+    const externalAgentCount = Object.keys(projectData.externalAgents || {}).reduce(
+      (total, agent) => {
+        const agentObj = agent;
+        return total + Object.keys(agentObj.subAgents || {}).length;
+      },
+      0
+    );
     console.log(chalk9.cyan("\n\u{1F4CA} Project Summary:"));
     console.log(chalk9.gray(`  \u2022 Name: ${projectData.name}`));
     console.log(chalk9.gray(`  \u2022 Description: ${projectData.description || "No description"}`));
@@ -239521,6 +239766,9 @@ async function pullProjectCommand(options) {
     if (statusComponentCount > 0) {
       console.log(chalk9.gray(`  \u2022 Status Components: ${statusComponentCount}`));
     }
+    if (externalAgentCount > 0) {
+      console.log(chalk9.gray(`  \u2022 External Agents: ${externalAgentCount}`));
+    }
     const credentialReferences2 = projectData.credentialReferences || {};
     const credentialCount = Object.keys(credentialReferences2).length;
     if (credentialCount > 0) {
@@ -239536,7 +239784,7 @@ async function pullProjectCommand(options) {
           for (const usage of usageInfo) {
             usageByType[usage.type] = (usageByType[usage.type] || 0) + 1;
           }
-          const usageSummary = Object.entries(usageByType).map(([type, count16]) => `${count16} ${type}${count16 > 1 ? "s" : ""}`).join(", ");
+          const usageSummary = Object.entries(usageByType).map(([type, count17]) => `${count17} ${type}${count17 > 1 ? "s" : ""}`).join(", ");
           console.log(chalk9.gray(`      Used by: ${usageSummary}`));
         }
       }
@@ -239576,6 +239824,7 @@ async function pullProjectCommand(options) {
           hasAgentsDirectory: true,
           hasDataComponentsDirectory: true,
           hasArtifactComponentsDirectory: true,
+          hasExternalAgentsDirectory: true,
           hasEnvironmentsDirectory: true
         },
         namingConventions: DEFAULT_NAMING_CONVENTIONS2,
@@ -239605,10 +239854,20 @@ async function pullProjectCommand(options) {
     if (options.debug) {
       console.log(chalk9.gray(`
 \u{1F4CD} Debug: Model selected: ${selectedModel}`));
-      console.log(chalk9.gray(`\u{1F4CD} Debug: Reasoning enabled: ${Object.keys(reasoningConfig).length > 0 ? "Yes" : "No"}`));
+      console.log(
+        chalk9.gray(
+          `\u{1F4CD} Debug: Reasoning enabled: ${Object.keys(reasoningConfig).length > 0 ? "Yes" : "No"}`
+        )
+      );
     }
     const targetEnvironment = options.env || "development";
-    const plan = await generatePlan2(projectData, patterns, modelSettings, createModel2, targetEnvironment);
+    const plan = await generatePlan2(
+      projectData,
+      patterns,
+      modelSettings,
+      createModel2,
+      targetEnvironment
+    );
     s2.stop("Generation plan created");
     const { displayPlanSummary: displayPlanSummary2, displayConflictWarning: displayConflictWarning2 } = await Promise.resolve().then(() => (init_display_utils(), display_utils_exports));
     displayPlanSummary2(plan);
@@ -239645,9 +239904,10 @@ async function pullProjectCommand(options) {
       tools: Object.keys(projectData.tools || {}).length,
       dataComponents: Object.keys(projectData.dataComponents || {}).length,
       artifactComponents: Object.keys(projectData.artifactComponents || {}).length,
+      externalAgents: Object.keys(projectData.externalAgents || {}).length,
       statusComponents: statusComponentsCount
     };
-    const totalFiles = fileCount.agents + fileCount.tools + fileCount.dataComponents + fileCount.artifactComponents + fileCount.statusComponents + 5;
+    const totalFiles = fileCount.agents + fileCount.tools + fileCount.dataComponents + fileCount.artifactComponents + fileCount.externalAgents + fileCount.statusComponents + 5;
     s2.stop(`Project files generated (${totalFiles} files created)`);
     s2.start("Verifying generated files...");
     try {
@@ -239698,6 +239958,9 @@ async function pullProjectCommand(options) {
     if (fileCount.tools > 0) {
       console.log(chalk9.gray(`  \u251C\u2500\u2500 tools/ (${fileCount.tools} files)`));
     }
+    if (fileCount.externalAgents > 0) {
+      console.log(chalk9.gray(`  \u251C\u2500\u2500 external-agents/ (${fileCount.externalAgents} files)`));
+    }
     if (fileCount.dataComponents > 0) {
       console.log(chalk9.gray(`  \u251C\u2500\u2500 data-components/ (${fileCount.dataComponents} files)`));
     }
@@ -239926,7 +240189,7 @@ async function pushCommand(options) {
             for (const usage of usageInfo) {
               usageByType[usage.type] = (usageByType[usage.type] || 0) + 1;
             }
-            const usageSummary = Object.entries(usageByType).map(([type, count16]) => `${count16} ${type}${count16 > 1 ? "s" : ""}`).join(", ");
+            const usageSummary = Object.entries(usageByType).map(([type, count17]) => `${count17} ${type}${count17 > 1 ? "s" : ""}`).join(", ");
             console.log(chalk10.gray(`      Used by: ${usageSummary}`));
           }
         }