@inkeep/agents-core 0.17.0 → 0.18.1

package/dist/chunk-JTHQYGCX.js

@@ -0,0 +1,173 @@
+import { GraphWithinContextOfProjectSchema, resourceIdSchema, MAX_ID_LENGTH } from './chunk-E4SFK6AI.js';
+import { z } from 'zod';
+
+var TransferDataSchema = z.object({
+  fromSubAgent: z.string().describe("ID of the sub-agent transferring control"),
+  targetSubAgent: z.string().describe("ID of the sub-agent receiving control"),
+  reason: z.string().optional().describe("Reason for the transfer"),
+  context: z.any().optional().describe("Additional context data")
+});
+var DelegationSentDataSchema = z.object({
+  delegationId: z.string().describe("Unique identifier for this delegation"),
+  fromSubAgent: z.string().describe("ID of the delegating sub-agent"),
+  targetSubAgent: z.string().describe("ID of the sub-agent receiving the delegation"),
+  taskDescription: z.string().describe("Description of the delegated task"),
+  context: z.any().optional().describe("Additional context data")
+});
+var DelegationReturnedDataSchema = z.object({
+  delegationId: z.string().describe("Unique identifier matching the original delegation"),
+  fromSubAgent: z.string().describe("ID of the sub-agent that completed the task"),
+  targetSubAgent: z.string().describe("ID of the sub-agent receiving the result"),
+  result: z.any().optional().describe("Result data from the delegated task")
+});
+var DataOperationDetailsSchema = z.object({
+  timestamp: z.number().describe("Unix timestamp in milliseconds"),
+  subAgentId: z.string().describe("ID of the sub-agent that generated this data"),
+  data: z.any().describe("The actual data payload")
+});
+var DataOperationEventSchema = z.object({
+  type: z.string().describe("Event type identifier"),
+  label: z.string().describe("Human-readable label for the event"),
+  details: DataOperationDetailsSchema
+});
+var A2AMessageMetadataSchema = z.object({
+  fromSubAgentId: z.string().optional().describe("ID of the sending sub-agent"),
+  toSubAgentId: z.string().optional().describe("ID of the receiving sub-agent"),
+  fromExternalAgentId: z.string().optional().describe("ID of the sending external agent"),
+  toExternalAgentId: z.string().optional().describe("ID of the receiving external agent"),
+  taskId: z.string().optional().describe("Associated task ID"),
+  a2aTaskId: z.string().optional().describe("A2A-specific task ID")
+});
+
+// src/validation/graphFull.ts
+function isInternalAgent(agent) {
+  return "prompt" in agent;
+}
+function isExternalAgent(agent) {
+  return "baseUrl" in agent;
+}
+function validateAndTypeGraphData(data) {
+  return GraphWithinContextOfProjectSchema.parse(data);
+}
+function validateToolReferences(graphData, availableToolIds) {
+  if (!availableToolIds) {
+    return;
+  }
+  const errors = [];
+  for (const [subAgentId, agentData] of Object.entries(graphData.subAgents)) {
+    if (isInternalAgent(agentData) && agentData.canUse && Array.isArray(agentData.canUse)) {
+      for (const canUseItem of agentData.canUse) {
+        if (!availableToolIds.has(canUseItem.toolId)) {
+          errors.push(`Agent '${subAgentId}' references non-existent tool '${canUseItem.toolId}'`);
+        }
+      }
+    }
+  }
+  if (errors.length > 0) {
+    throw new Error(`Tool reference validation failed:
+${errors.join("\n")}`);
+  }
+}
+function validateDataComponentReferences(graphData, availableDataComponentIds) {
+  if (!availableDataComponentIds) {
+    return;
+  }
+  const errors = [];
+  for (const [subAgentId, agentData] of Object.entries(graphData.subAgents)) {
+    if (isInternalAgent(agentData) && agentData.dataComponents) {
+      for (const dataComponentId of agentData.dataComponents) {
+        if (!availableDataComponentIds.has(dataComponentId)) {
+          errors.push(
+            `Agent '${subAgentId}' references non-existent dataComponent '${dataComponentId}'`
+          );
+        }
+      }
+    }
+  }
+  if (errors.length > 0) {
+    throw new Error(`DataComponent reference validation failed:
+${errors.join("\n")}`);
+  }
+}
+function validateArtifactComponentReferences(graphData, availableArtifactComponentIds) {
+  if (!availableArtifactComponentIds) {
+    return;
+  }
+  const errors = [];
+  for (const [subAgentId, agentData] of Object.entries(graphData.subAgents)) {
+    if (isInternalAgent(agentData) && agentData.artifactComponents) {
+      for (const artifactComponentId of agentData.artifactComponents) {
+        if (!availableArtifactComponentIds.has(artifactComponentId)) {
+          errors.push(
+            `Agent '${subAgentId}' references non-existent artifactComponent '${artifactComponentId}'`
+          );
+        }
+      }
+    }
+  }
+  if (errors.length > 0) {
+    throw new Error(`ArtifactComponent reference validation failed:
+${errors.join("\n")}`);
+  }
+}
+function validateAgentRelationships(graphData) {
+  const errors = [];
+  const availableAgentIds = new Set(Object.keys(graphData.subAgents));
+  for (const [subAgentId, agentData] of Object.entries(graphData.subAgents)) {
+    if (isInternalAgent(agentData)) {
+      if (agentData.canTransferTo && Array.isArray(agentData.canTransferTo)) {
+        for (const targetId of agentData.canTransferTo) {
+          if (!availableAgentIds.has(targetId)) {
+            errors.push(
+              `Agent '${subAgentId}' has transfer target '${targetId}' that doesn't exist in graph`
+            );
+          }
+        }
+      }
+      if (agentData.canDelegateTo && Array.isArray(agentData.canDelegateTo)) {
+        for (const targetId of agentData.canDelegateTo) {
+          if (!availableAgentIds.has(targetId)) {
+            errors.push(
+              `Agent '${subAgentId}' has delegation target '${targetId}' that doesn't exist in graph`
+            );
+          }
+        }
+      }
+    }
+  }
+  if (errors.length > 0) {
+    throw new Error(`Agent relationship validation failed:
+${errors.join("\n")}`);
+  }
+}
+function validateGraphStructure(graphData, projectResources) {
+  if (graphData.defaultSubAgentId && !graphData.subAgents[graphData.defaultSubAgentId]) {
+    throw new Error(`Default agent '${graphData.defaultSubAgentId}' does not exist in agents`);
+  }
+  if (projectResources) {
+    validateToolReferences(graphData, projectResources.toolIds);
+    validateDataComponentReferences(graphData, projectResources.dataComponentIds);
+    validateArtifactComponentReferences(graphData, projectResources.artifactComponentIds);
+  }
+  validateAgentRelationships(graphData);
+}
+
+// src/validation/id-validation.ts
+function isValidResourceId(id) {
+  const result = resourceIdSchema.safeParse(id);
+  return result.success;
+}
+function generateIdFromName(name) {
+  const id = name.toLowerCase().replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-");
+  if (!id) {
+    throw new Error("Cannot generate valid ID from provided name");
+  }
+  const truncatedId = id.substring(0, MAX_ID_LENGTH);
+  const result = resourceIdSchema.safeParse(truncatedId);
+  if (!result.success) {
+    throw new Error(`Generated ID "${truncatedId}" is not valid: ${result.error.message}`);
+  }
+  return truncatedId;
+}
+
+export { A2AMessageMetadataSchema, DataOperationDetailsSchema, DataOperationEventSchema, DelegationReturnedDataSchema, DelegationSentDataSchema, TransferDataSchema, generateIdFromName, isExternalAgent, isInternalAgent, isValidResourceId, validateAgentRelationships, validateAndTypeGraphData, validateArtifactComponentReferences, validateDataComponentReferences, validateGraphStructure, validateToolReferences };