@inkeep/agents-core 0.17.0 → 0.18.0

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 };

package/dist/chunk-TCLX6C3C.js

@@ -0,0 +1,271 @@
+// src/constants/otel-attributes.ts
+var DELEGATION_FROM_SUB_AGENT_ID = "delegation.from_sub_agent_id";
+var DELEGATION_TO_SUB_AGENT_ID = "delegation.to_sub_agent_id";
+var DELEGATION_ID = "delegation.id";
+var TRANSFER_FROM_SUB_AGENT_ID = "transfer.from_sub_agent_id";
+var TRANSFER_TO_SUB_AGENT_ID = "transfer.to_sub_agent_id";
+var SPAN_NAMES = {
+  AI_TOOL_CALL: "ai.toolCall",
+  CONTEXT_RESOLUTION: "context-resolver.resolve_single_fetch_definition",
+  CONTEXT_HANDLE: "context.handle_context_resolution",
+  AGENT_GENERATION: "agent.generate",
+  CONTEXT_FETCHER: "context-fetcher.http-request"
+};
+var AI_OPERATIONS = {
+  GENERATE_TEXT: "ai.generateText.doGenerate",
+  STREAM_TEXT: "ai.streamText.doStream"
+};
+var SPAN_KEYS = {
+  // Core span attributes
+  SPAN_ID: "spanID",
+  TRACE_ID: "traceID",
+  DURATION_NANO: "durationNano",
+  TIMESTAMP: "timestamp",
+  HAS_ERROR: "hasError",
+  STATUS_MESSAGE: "status_message",
+  OTEL_STATUS_CODE: "otel.status_code",
+  OTEL_STATUS_DESCRIPTION: "otel.status_description",
+  // Graph attributes
+  GRAPH_ID: "graph.id",
+  GRAPH_NAME: "graph.name",
+  TENANT_ID: "tenant.id",
+  PROJECT_ID: "project.id",
+  // AI/Agent attributes
+  AI_AGENT_NAME: "ai.agentName",
+  AI_AGENT_NAME_ALT: "ai.agent.name",
+  AI_OPERATION_ID: "ai.operationId",
+  AI_RESPONSE_TIMESTAMP: "ai.response.timestamp",
+  AI_RESPONSE_CONTENT: "ai.response.content",
+  AI_RESPONSE_TEXT: "ai.response.text",
+  AI_RESPONSE_MODEL: "ai.response.model",
+  AI_RESPONSE_TOOL_CALLS: "ai.response.toolCalls",
+  AI_PROMPT_MESSAGES: "ai.prompt.messages",
+  AI_MODEL_PROVIDER: "ai.model.provider",
+  AI_TELEMETRY_FUNCTION_ID: "ai.telemetry.functionId",
+  AI_MODEL_ID: "ai.model.id",
+  // Tool attributes
+  AI_TOOL_CALL_NAME: "ai.toolCall.name",
+  AI_TOOL_CALL_RESULT: "ai.toolCall.result",
+  AI_TOOL_CALL_ARGS: "ai.toolCall.args",
+  AI_TOOL_CALL_ID: "ai.toolCall.id",
+  AI_TOOL_TYPE: "ai.toolType",
+  TOOL_PURPOSE: "tool.purpose",
+  // Agent attributes
+  AGENT_ID: "agent.id",
+  AGENT_NAME: "agent.name",
+  // Token usage
+  GEN_AI_USAGE_INPUT_TOKENS: "gen_ai.usage.input_tokens",
+  GEN_AI_USAGE_OUTPUT_TOKENS: "gen_ai.usage.output_tokens",
+  // Context attributes
+  CONTEXT_URL: "context.url",
+  CONTEXT_CONFIG_ID: "context.context_config_id",
+  CONTEXT_AGENT_GRAPH_ID: "context.agent_graph_id",
+  CONTEXT_HEADERS_KEYS: "context.headers_keys",
+  // Message attributes
+  MESSAGE_CONTENT: "message.content",
+  MESSAGE_TIMESTAMP: "message.timestamp",
+  MCP_TOOL_DESCRIPTION: "mcp.tool.description",
+  // Delegation/Transfer attributes
+  DELEGATION_FROM_SUB_AGENT_ID,
+  DELEGATION_TO_SUB_AGENT_ID,
+  DELEGATION_ID,
+  TRANSFER_FROM_SUB_AGENT_ID,
+  TRANSFER_TO_SUB_AGENT_ID,
+  // HTTP attributes
+  HTTP_URL: "http.url",
+  HTTP_STATUS_CODE: "http.status_code",
+  HTTP_RESPONSE_BODY_SIZE: "http.response.body_size",
+  // Core attributes
+  NAME: "name",
+  PARENT_SPAN_ID: "parentSpanID",
+  CONVERSATION_ID: "conversation.id"
+};
+var UNKNOWN_VALUE = "unknown";
+var ACTIVITY_TYPES = {
+  TOOL_CALL: "tool_call",
+  AI_GENERATION: "ai_generation",
+  AGENT_GENERATION: "agent_generation",
+  CONTEXT_FETCH: "context_fetch",
+  CONTEXT_RESOLUTION: "context_resolution",
+  USER_MESSAGE: "user_message",
+  AI_ASSISTANT_MESSAGE: "ai_assistant_message",
+  AI_MODEL_STREAMED_TEXT: "ai_model_streamed_text"
+};
+var ACTIVITY_STATUS = {
+  SUCCESS: "success",
+  ERROR: "error",
+  PENDING: "pending"
+};
+var AGENT_IDS = {
+  USER: "user",
+  AI_ASSISTANT: "ai-assistant"
+};
+var ACTIVITY_NAMES = {
+  CONTEXT_FETCH: "Context Fetch",
+  USER_MESSAGE: "User Message",
+  AI_ASSISTANT_MESSAGE: "AI Assistant Message",
+  AI_TEXT_GENERATION: "AI Text Generation",
+  AI_STREAMING_TEXT: "AI Streaming Text",
+  UNKNOWN_AGENT: "Unknown Agent",
+  USER: "User"
+};
+var TOOL_NAMES = {
+  SAVE_TOOL_RESULT: "save_tool_result"
+};
+var AI_TOOL_TYPES = {
+  MCP: "mcp",
+  TRANSFER: "transfer",
+  DELEGATION: "delegation"
+};
+
+// src/constants/signoz-queries.ts
+var DATA_TYPES = {
+  STRING: "string",
+  INT64: "int64",
+  FLOAT64: "float64",
+  BOOL: "bool"
+};
+var FIELD_TYPES = {
+  TAG: "tag",
+  RESOURCE: "resource"
+};
+var QUERY_FIELD_CONFIGS = {
+  // String tag fields
+  STRING_TAG: {
+    dataType: DATA_TYPES.STRING,
+    type: FIELD_TYPES.TAG,
+    isColumn: false
+  },
+  STRING_TAG_COLUMN: {
+    dataType: DATA_TYPES.STRING,
+    type: FIELD_TYPES.TAG,
+    isColumn: true
+  },
+  // Numeric tag fields
+  INT64_TAG: {
+    dataType: DATA_TYPES.INT64,
+    type: FIELD_TYPES.TAG,
+    isColumn: false
+  },
+  INT64_TAG_COLUMN: {
+    dataType: DATA_TYPES.INT64,
+    type: FIELD_TYPES.TAG,
+    isColumn: true
+  },
+  FLOAT64_TAG: {
+    dataType: DATA_TYPES.FLOAT64,
+    type: FIELD_TYPES.TAG,
+    isColumn: false
+  },
+  FLOAT64_TAG_COLUMN: {
+    dataType: DATA_TYPES.FLOAT64,
+    type: FIELD_TYPES.TAG,
+    isColumn: true
+  },
+  // Boolean tag fields
+  BOOL_TAG: {
+    dataType: DATA_TYPES.BOOL,
+    type: FIELD_TYPES.TAG,
+    isColumn: false
+  },
+  BOOL_TAG_COLUMN: {
+    dataType: DATA_TYPES.BOOL,
+    type: FIELD_TYPES.TAG,
+    isColumn: true
+  }
+};
+var OPERATORS = {
+  // Comparison operators
+  EQUALS: "=",
+  NOT_EQUALS: "!=",
+  LESS_THAN: "<",
+  GREATER_THAN: ">",
+  LESS_THAN_OR_EQUAL: "<=",
+  GREATER_THAN_OR_EQUAL: ">=",
+  // String operators
+  LIKE: "like",
+  NOT_LIKE: "nlike",
+  // Existence operators
+  EXISTS: "exists",
+  NOT_EXISTS: "nexists",
+  // Logical operators
+  AND: "AND",
+  OR: "OR"
+};
+var QUERY_EXPRESSIONS = {
+  SPAN_NAMES: "spanNames",
+  AGENT_MODEL_CALLS: "agentModelCalls",
+  MODEL_CALLS: "modelCalls",
+  LAST_ACTIVITY: "lastActivity",
+  CONVERSATION_METADATA: "conversationMetadata",
+  FILTERED_CONVERSATIONS: "filteredConversations",
+  TOOLS: "tools",
+  TRANSFERS: "transfers",
+  DELEGATIONS: "delegations",
+  AI_CALLS: "aiCalls",
+  CONTEXT_ERRORS: "contextErrors",
+  AGENT_GENERATION_ERRORS: "agentGenerationErrors",
+  USER_MESSAGES: "userMessages",
+  UNIQUE_GRAPHS: "uniqueGraphs",
+  UNIQUE_MODELS: "uniqueModels",
+  // Route-specific query names
+  TOOL_CALLS: "toolCalls",
+  CONTEXT_RESOLUTION: "contextResolution",
+  CONTEXT_HANDLE: "contextHandle",
+  AI_ASSISTANT_MESSAGES: "aiAssistantMessages",
+  AI_GENERATIONS: "aiGenerations",
+  AI_STREAMING_TEXT: "aiStreamingText",
+  CONTEXT_FETCHERS: "contextFetchers",
+  DURATION_SPANS: "durationSpans",
+  AGENT_GENERATIONS: "agentGenerations",
+  SPANS_WITH_ERRORS: "spansWithErrors"
+};
+var REDUCE_OPERATIONS = {
+  SUM: "sum",
+  MAX: "max",
+  MIN: "min",
+  AVG: "avg",
+  COUNT: "count"
+};
+var ORDER_DIRECTIONS = {
+  ASC: "asc",
+  DESC: "desc"
+};
+var QUERY_TYPES = {
+  BUILDER: "builder",
+  CLICKHOUSE: "clickhouse",
+  PROMQL: "promql"
+};
+var PANEL_TYPES = {
+  LIST: "list",
+  TABLE: "table",
+  GRAPH: "graph",
+  VALUE: "value"
+};
+var DATA_SOURCES = {
+  TRACES: "traces",
+  METRICS: "metrics",
+  LOGS: "logs"
+};
+var AGGREGATE_OPERATORS = {
+  COUNT: "count",
+  SUM: "sum",
+  AVG: "avg",
+  MIN: "min",
+  MAX: "max",
+  NOOP: "noop"
+};
+var QUERY_DEFAULTS = {
+  STEP: 60,
+  STEP_INTERVAL: 60,
+  OFFSET: 0,
+  DISABLED: false,
+  HAVING: [],
+  LEGEND: "",
+  LIMIT_NULL: null,
+  LIMIT_ZERO: 0,
+  LIMIT_1000: 1e3,
+  EMPTY_GROUP_BY: []
+};
+
+export { ACTIVITY_NAMES, ACTIVITY_STATUS, ACTIVITY_TYPES, AGENT_IDS, AGGREGATE_OPERATORS, AI_OPERATIONS, AI_TOOL_TYPES, DATA_SOURCES, DATA_TYPES, DELEGATION_FROM_SUB_AGENT_ID, DELEGATION_ID, DELEGATION_TO_SUB_AGENT_ID, FIELD_TYPES, OPERATORS, ORDER_DIRECTIONS, PANEL_TYPES, QUERY_DEFAULTS, QUERY_EXPRESSIONS, QUERY_FIELD_CONFIGS, QUERY_TYPES, REDUCE_OPERATIONS, SPAN_KEYS, SPAN_NAMES, TOOL_NAMES, TRANSFER_FROM_SUB_AGENT_ID, TRANSFER_TO_SUB_AGENT_ID, UNKNOWN_VALUE };