@inkeep/agents-core 0.0.0-dev-20251031184130 → 0.0.0-dev-20251031184231

package/dist/{chunk-4FQG5A4Z.js → chunk-E5SNN43B.js}

@@ -1,6 +1,51 @@
 import { AgentWithinContextOfProjectSchema, resourceIdSchema, MAX_ID_LENGTH } from './chunk-37BY2EHU.js';
 import { z } from 'zod';
 
+// src/validation/cycleDetection.ts
+function detectDelegationCycles(agentData) {
+  const graph = buildDelegationGraph(agentData);
+  const cycles = [];
+  const visited = /* @__PURE__ */ new Set();
+  const stack = /* @__PURE__ */ new Set();
+  const path = [];
+  function dfs(node) {
+    visited.add(node);
+    stack.add(node);
+    path.push(node);
+    for (const neighbor of graph.get(node) || []) {
+      if (!visited.has(neighbor)) {
+        if (dfs(neighbor)) return true;
+      } else if (stack.has(neighbor)) {
+        const cycleStart = path.indexOf(neighbor);
+        cycles.push(`Circular delegation detected: ${[...path.slice(cycleStart), neighbor].join(" \u2192 ")}`);
+        return true;
+      }
+    }
+    stack.delete(node);
+    path.pop();
+    return false;
+  }
+  for (const node of graph.keys()) {
+    if (!visited.has(node)) {
+      path.length = 0;
+      dfs(node);
+    }
+  }
+  return cycles;
+}
+function buildDelegationGraph(agentData) {
+  const graph = /* @__PURE__ */ new Map();
+  for (const [subAgentId, subAgent] of Object.entries(agentData.subAgents)) {
+    const delegates = subAgent.canDelegateTo?.filter(
+      (d) => typeof d === "string"
+    );
+    if (delegates?.length) {
+      graph.set(subAgentId, delegates);
+    }
+  }
+  return graph;
+}
+
 // src/validation/agentFull.ts
 function validateAndTypeAgentData(data) {
   return AgentWithinContextOfProjectSchema.parse(data);
@@ -94,6 +139,10 @@ function validateAgentRelationships(agentData) {
       }
     }
   }
+  const cycles = detectDelegationCycles(agentData);
+  if (cycles.length > 0) {
+    errors.push(...cycles);
+  }
   if (errors.length > 0)
     throw new Error(`Agent relationship validation failed:
 ${errors.join("\n")}`);

package/dist/client-exports.d.cts

@@ -1,7 +1,7 @@
 export { i as ACTIVITY_NAMES, g as ACTIVITY_STATUS, f as ACTIVITY_TYPES, h as AGENT_IDS, p as AGGREGATE_OPERATORS, A as AI_OPERATIONS, j as AI_TOOL_TYPES, o as DATA_SOURCES, k as DATA_TYPES, D as DELEGATION_FROM_SUB_AGENT_ID, b as DELEGATION_ID, a as DELEGATION_TO_SUB_AGENT_ID, F as FIELD_TYPES, O as OPERATORS, m as ORDER_DIRECTIONS, P as PANEL_TYPES, q as QUERY_DEFAULTS, l as QUERY_EXPRESSIONS, Q as QUERY_FIELD_CONFIGS, n as QUERY_TYPES, R as REDUCE_OPERATIONS, e as SPAN_KEYS, S as SPAN_NAMES, T as TRANSFER_FROM_SUB_AGENT_ID, c as TRANSFER_TO_SUB_AGENT_ID, U as UNKNOWN_VALUE, d as detectAuthenticationRequired } from './auth-detection-DtO-n2WD.cjs';
 import { z } from 'zod';
-import { C as ConversationHistoryConfig, F as FunctionApiInsertSchema, A as ApiKeyApiUpdateSchema, a as FullAgentAgentInsertSchema } from './utility-fD4C61M4.cjs';
-export { e as AgentStopWhen, b as AgentStopWhenSchema, h as CredentialStoreType, j as FunctionApiSelectSchema, k as FunctionApiUpdateSchema, i as MCPTransportType, g as ModelSettings, M as ModelSettingsSchema, d as StopWhen, S as StopWhenSchema, f as SubAgentStopWhen, c as SubAgentStopWhenSchema } from './utility-fD4C61M4.cjs';
+import { C as ConversationHistoryConfig, F as FunctionApiInsertSchema, A as ApiKeyApiUpdateSchema, a as FullAgentAgentInsertSchema } from './utility-eADYCyd-.cjs';
+export { e as AgentStopWhen, b as AgentStopWhenSchema, h as CredentialStoreType, j as FunctionApiSelectSchema, k as FunctionApiUpdateSchema, i as MCPTransportType, g as ModelSettings, M as ModelSettingsSchema, d as StopWhen, S as StopWhenSchema, f as SubAgentStopWhen, c as SubAgentStopWhenSchema } from './utility-eADYCyd-.cjs';
 export { v as validatePropsAsJsonSchema } from './props-validation-BMR1qNiy.cjs';
 import 'pino';
 import 'drizzle-zod';
@@ -134,8 +134,8 @@ declare const DataComponentApiInsertSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 declare const ArtifactComponentApiInsertSchema: z.ZodObject<{
-    name: z.ZodString;
     id: z.ZodString;
+    name: z.ZodString;
     description: z.ZodString;
     props: z.ZodOptional<z.ZodNullable<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>>;
 }, {
@@ -170,11 +170,12 @@ declare const FullAgentDefinitionSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     defaultSubAgentId: z.ZodOptional<z.ZodString>;
     subAgents: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
-        name: z.ZodString;
         id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        prompt: z.ZodString;
         createdAt: z.ZodOptional<z.ZodString>;
         updatedAt: z.ZodOptional<z.ZodString>;
-        description: z.ZodString;
         models: z.ZodOptional<z.ZodObject<{
             base: z.ZodOptional<z.ZodObject<{
                 model: z.ZodOptional<z.ZodString>;
@@ -198,7 +199,6 @@ declare const FullAgentDefinitionSchema: z.ZodObject<{
         }, {
             stepCountIs?: number | undefined;
         }>>>>;
-        prompt: z.ZodString;
         conversationHistoryConfig: z.ZodOptional<z.ZodNullable<z.ZodType<ConversationHistoryConfig, ConversationHistoryConfig, z.core.$ZodTypeInternals<ConversationHistoryConfig, ConversationHistoryConfig>>>>;
         type: z.ZodLiteral<"internal">;
         canUse: z.ZodArray<z.ZodObject<{

package/dist/client-exports.d.ts

@@ -1,7 +1,7 @@
 export { i as ACTIVITY_NAMES, g as ACTIVITY_STATUS, f as ACTIVITY_TYPES, h as AGENT_IDS, p as AGGREGATE_OPERATORS, A as AI_OPERATIONS, j as AI_TOOL_TYPES, o as DATA_SOURCES, k as DATA_TYPES, D as DELEGATION_FROM_SUB_AGENT_ID, b as DELEGATION_ID, a as DELEGATION_TO_SUB_AGENT_ID, F as FIELD_TYPES, O as OPERATORS, m as ORDER_DIRECTIONS, P as PANEL_TYPES, q as QUERY_DEFAULTS, l as QUERY_EXPRESSIONS, Q as QUERY_FIELD_CONFIGS, n as QUERY_TYPES, R as REDUCE_OPERATIONS, e as SPAN_KEYS, S as SPAN_NAMES, T as TRANSFER_FROM_SUB_AGENT_ID, c as TRANSFER_TO_SUB_AGENT_ID, U as UNKNOWN_VALUE, d as detectAuthenticationRequired } from './auth-detection-DtO-n2WD.js';
 import { z } from 'zod';
-import { C as ConversationHistoryConfig, F as FunctionApiInsertSchema, A as ApiKeyApiUpdateSchema, a as FullAgentAgentInsertSchema } from './utility-fD4C61M4.js';
-export { e as AgentStopWhen, b as AgentStopWhenSchema, h as CredentialStoreType, j as FunctionApiSelectSchema, k as FunctionApiUpdateSchema, i as MCPTransportType, g as ModelSettings, M as ModelSettingsSchema, d as StopWhen, S as StopWhenSchema, f as SubAgentStopWhen, c as SubAgentStopWhenSchema } from './utility-fD4C61M4.js';
+import { C as ConversationHistoryConfig, F as FunctionApiInsertSchema, A as ApiKeyApiUpdateSchema, a as FullAgentAgentInsertSchema } from './utility-eADYCyd-.js';
+export { e as AgentStopWhen, b as AgentStopWhenSchema, h as CredentialStoreType, j as FunctionApiSelectSchema, k as FunctionApiUpdateSchema, i as MCPTransportType, g as ModelSettings, M as ModelSettingsSchema, d as StopWhen, S as StopWhenSchema, f as SubAgentStopWhen, c as SubAgentStopWhenSchema } from './utility-eADYCyd-.js';
 export { v as validatePropsAsJsonSchema } from './props-validation-BMR1qNiy.js';
 import 'pino';
 import 'drizzle-zod';
@@ -134,8 +134,8 @@ declare const DataComponentApiInsertSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 declare const ArtifactComponentApiInsertSchema: z.ZodObject<{
-    name: z.ZodString;
     id: z.ZodString;
+    name: z.ZodString;
     description: z.ZodString;
     props: z.ZodOptional<z.ZodNullable<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>>;
 }, {
@@ -170,11 +170,12 @@ declare const FullAgentDefinitionSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     defaultSubAgentId: z.ZodOptional<z.ZodString>;
     subAgents: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
-        name: z.ZodString;
         id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        prompt: z.ZodString;
         createdAt: z.ZodOptional<z.ZodString>;
         updatedAt: z.ZodOptional<z.ZodString>;
-        description: z.ZodString;
         models: z.ZodOptional<z.ZodObject<{
             base: z.ZodOptional<z.ZodObject<{
                 model: z.ZodOptional<z.ZodString>;
@@ -198,7 +199,6 @@ declare const FullAgentDefinitionSchema: z.ZodObject<{
         }, {
             stepCountIs?: number | undefined;
         }>>>>;
-        prompt: z.ZodString;
         conversationHistoryConfig: z.ZodOptional<z.ZodNullable<z.ZodType<ConversationHistoryConfig, ConversationHistoryConfig, z.core.$ZodTypeInternals<ConversationHistoryConfig, ConversationHistoryConfig>>>>;
         type: z.ZodLiteral<"internal">;
         canUse: z.ZodArray<z.ZodObject<{

package/dist/db/schema.d.cts

@@ -1,7 +1,7 @@
 import 'drizzle-orm';
 import 'drizzle-orm/sqlite-core';
-import '../utility-fD4C61M4.cjs';
-export { G as agentRelations, J as agentToolRelationsRelations, a as agents, y as apiKeys, I as apiKeysRelations, j as artifactComponents, O as artifactComponentsRelations, b as contextCache, E as contextCacheRelations, c as contextConfigs, D as contextConfigsRelations, v as conversations, M as conversationsRelations, z as credentialReferences, K as credentialReferencesRelations, h as dataComponents, Q as dataComponentsRelations, f as externalAgents, H as externalAgentsRelations, m as functionTools, V as functionToolsRelations, n as functions, T as functionsRelations, x as ledgerArtifacts, S as ledgerArtifactsRelations, w as messages, N as messagesRelations, p as projects, B as projectsRelations, k as subAgentArtifactComponents, P as subAgentArtifactComponentsRelations, i as subAgentDataComponents, R as subAgentDataComponentsRelations, q as subAgentExternalAgentRelations, X as subAgentExternalAgentRelationsRelations, u as subAgentFunctionToolRelations, W as subAgentFunctionToolRelationsRelations, e as subAgentRelations, U as subAgentRelationsRelations, r as subAgentTeamAgentRelations, Y as subAgentTeamAgentRelationsRelations, o as subAgentToolRelations, d as subAgents, F as subAgentsRelations, g as taskRelations, C as taskRelationsRelations, t as tasks, A as tasksRelations, l as tools, L as toolsRelations } from '../schema-uPzoiY7F.cjs';
+import '../utility-eADYCyd-.cjs';
+export { G as agentRelations, J as agentToolRelationsRelations, a as agents, y as apiKeys, I as apiKeysRelations, j as artifactComponents, O as artifactComponentsRelations, b as contextCache, E as contextCacheRelations, c as contextConfigs, D as contextConfigsRelations, v as conversations, M as conversationsRelations, z as credentialReferences, K as credentialReferencesRelations, h as dataComponents, Q as dataComponentsRelations, f as externalAgents, H as externalAgentsRelations, m as functionTools, V as functionToolsRelations, n as functions, T as functionsRelations, x as ledgerArtifacts, S as ledgerArtifactsRelations, w as messages, N as messagesRelations, p as projects, B as projectsRelations, k as subAgentArtifactComponents, P as subAgentArtifactComponentsRelations, i as subAgentDataComponents, R as subAgentDataComponentsRelations, q as subAgentExternalAgentRelations, X as subAgentExternalAgentRelationsRelations, u as subAgentFunctionToolRelations, W as subAgentFunctionToolRelationsRelations, e as subAgentRelations, U as subAgentRelationsRelations, r as subAgentTeamAgentRelations, Y as subAgentTeamAgentRelationsRelations, o as subAgentToolRelations, d as subAgents, F as subAgentsRelations, g as taskRelations, C as taskRelationsRelations, t as tasks, A as tasksRelations, l as tools, L as toolsRelations } from '../schema-DgEdaA4i.cjs';
 import 'zod';
 import 'drizzle-zod';
 import '@hono/zod-openapi';

package/dist/db/schema.d.ts

@@ -1,7 +1,7 @@
 import 'drizzle-orm';
 import 'drizzle-orm/sqlite-core';
-import '../utility-fD4C61M4.js';
-export { G as agentRelations, J as agentToolRelationsRelations, a as agents, y as apiKeys, I as apiKeysRelations, j as artifactComponents, O as artifactComponentsRelations, b as contextCache, E as contextCacheRelations, c as contextConfigs, D as contextConfigsRelations, v as conversations, M as conversationsRelations, z as credentialReferences, K as credentialReferencesRelations, h as dataComponents, Q as dataComponentsRelations, f as externalAgents, H as externalAgentsRelations, m as functionTools, V as functionToolsRelations, n as functions, T as functionsRelations, x as ledgerArtifacts, S as ledgerArtifactsRelations, w as messages, N as messagesRelations, p as projects, B as projectsRelations, k as subAgentArtifactComponents, P as subAgentArtifactComponentsRelations, i as subAgentDataComponents, R as subAgentDataComponentsRelations, q as subAgentExternalAgentRelations, X as subAgentExternalAgentRelationsRelations, u as subAgentFunctionToolRelations, W as subAgentFunctionToolRelationsRelations, e as subAgentRelations, U as subAgentRelationsRelations, r as subAgentTeamAgentRelations, Y as subAgentTeamAgentRelationsRelations, o as subAgentToolRelations, d as subAgents, F as subAgentsRelations, g as taskRelations, C as taskRelationsRelations, t as tasks, A as tasksRelations, l as tools, L as toolsRelations } from '../schema-BWDgXp-e.js';
+import '../utility-eADYCyd-.js';
+export { G as agentRelations, J as agentToolRelationsRelations, a as agents, y as apiKeys, I as apiKeysRelations, j as artifactComponents, O as artifactComponentsRelations, b as contextCache, E as contextCacheRelations, c as contextConfigs, D as contextConfigsRelations, v as conversations, M as conversationsRelations, z as credentialReferences, K as credentialReferencesRelations, h as dataComponents, Q as dataComponentsRelations, f as externalAgents, H as externalAgentsRelations, m as functionTools, V as functionToolsRelations, n as functions, T as functionsRelations, x as ledgerArtifacts, S as ledgerArtifactsRelations, w as messages, N as messagesRelations, p as projects, B as projectsRelations, k as subAgentArtifactComponents, P as subAgentArtifactComponentsRelations, i as subAgentDataComponents, R as subAgentDataComponentsRelations, q as subAgentExternalAgentRelations, X as subAgentExternalAgentRelationsRelations, u as subAgentFunctionToolRelations, W as subAgentFunctionToolRelationsRelations, e as subAgentRelations, U as subAgentRelationsRelations, r as subAgentTeamAgentRelations, Y as subAgentTeamAgentRelationsRelations, o as subAgentToolRelations, d as subAgents, F as subAgentsRelations, g as taskRelations, C as taskRelationsRelations, t as tasks, A as tasksRelations, l as tools, L as toolsRelations } from '../schema-DfnCgRwo.js';
 import 'zod';
 import 'drizzle-zod';
 import '@hono/zod-openapi';

package/dist/index.cjs

@@ -215950,6 +215950,51 @@ function getConversationId() {
   return generateId();
 }
 
+// src/validation/cycleDetection.ts
+function detectDelegationCycles(agentData) {
+  const graph = buildDelegationGraph(agentData);
+  const cycles = [];
+  const visited = /* @__PURE__ */ new Set();
+  const stack = /* @__PURE__ */ new Set();
+  const path2 = [];
+  function dfs(node) {
+    visited.add(node);
+    stack.add(node);
+    path2.push(node);
+    for (const neighbor of graph.get(node) || []) {
+      if (!visited.has(neighbor)) {
+        if (dfs(neighbor)) return true;
+      } else if (stack.has(neighbor)) {
+        const cycleStart = path2.indexOf(neighbor);
+        cycles.push(`Circular delegation detected: ${[...path2.slice(cycleStart), neighbor].join(" \u2192 ")}`);
+        return true;
+      }
+    }
+    stack.delete(node);
+    path2.pop();
+    return false;
+  }
+  for (const node of graph.keys()) {
+    if (!visited.has(node)) {
+      path2.length = 0;
+      dfs(node);
+    }
+  }
+  return cycles;
+}
+function buildDelegationGraph(agentData) {
+  const graph = /* @__PURE__ */ new Map();
+  for (const [subAgentId, subAgent] of Object.entries(agentData.subAgents)) {
+    const delegates = subAgent.canDelegateTo?.filter(
+      (d) => typeof d === "string"
+    );
+    if (delegates?.length) {
+      graph.set(subAgentId, delegates);
+    }
+  }
+  return graph;
+}
+
 // src/validation/agentFull.ts
 function validateAndTypeAgentData(data) {
   return AgentWithinContextOfProjectSchema.parse(data);
@@ -216043,6 +216088,10 @@ function validateAgentRelationships(agentData) {
       }
     }
   }
+  const cycles = detectDelegationCycles(agentData);
+  if (cycles.length > 0) {
+    errors.push(...cycles);
+  }
   if (errors.length > 0)
     throw new Error(`Agent relationship validation failed:
 ${errors.join("\n")}`);