@inkeep/agents-core 0.41.2 → 0.42.0

package/dist/auth/permissions.js

@@ -10,138 +10,19 @@ const statement = {
 		"read",
 		"update",
 		"delete"
-	],
-	agent: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	sub_agent: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	tool: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	api_key: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	credential: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	data_component: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	artifact_component: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	external_agent: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	function: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	context_config: [
-		"create",
-		"read",
-		"update",
-		"delete"
 	]
 };
 const ac = createAccessControl(statement);
 const memberRole = ac.newRole({
 	project: ["read"],
-	agent: ["read"],
-	sub_agent: ["read"],
-	tool: ["read"],
-	api_key: ["read"],
-	credential: ["read"],
-	data_component: ["read"],
-	artifact_component: ["read"],
-	external_agent: ["read"],
-	function: ["read"],
-	context_config: ["read"],
 	...memberAc.statements
 });
 const adminRole = ac.newRole({
 	project: [
 		"create",
 		"read",
-		"update"
-	],
-	agent: [
-		"create",
-		"read",
-		"update"
-	],
-	sub_agent: [
-		"create",
-		"read",
-		"update"
-	],
-	tool: [
-		"create",
-		"read",
-		"update"
-	],
-	api_key: [
-		"create",
-		"read",
-		"update"
-	],
-	credential: [
-		"create",
-		"read",
-		"update"
-	],
-	data_component: [
-		"create",
-		"read",
-		"update"
-	],
-	artifact_component: [
-		"create",
-		"read",
-		"update"
-	],
-	external_agent: [
-		"create",
-		"read",
-		"update"
-	],
-	function: [
-		"create",
-		"read",
-		"update"
-	],
-	context_config: [
-		"create",
-		"read",
-		"update"
+		"update",
+		"delete"
 	],
 	...adminAc.statements
 });
@@ -152,66 +33,6 @@ const ownerRole = ac.newRole({
 		"update",
 		"delete"
 	],
-	agent: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	sub_agent: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	tool: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	api_key: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	credential: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	data_component: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	artifact_component: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	external_agent: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	function: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
-	context_config: [
-		"create",
-		"read",
-		"update",
-		"delete"
-	],
 	...ownerAc.statements
 });
 

package/dist/client-exports.d.ts

@@ -1,12 +1,13 @@
+import { BreakdownComponentDef, CONTEXT_BREAKDOWN_TOTAL_SPAN_ATTRIBUTE, ContextBreakdown, V1_BREAKDOWN_SCHEMA, calculateBreakdownTotal, createEmptyBreakdown, parseContextBreakdownFromSpan } from "./constants/context-breakdown.js";
 import { ACTIVITY_NAMES, ACTIVITY_STATUS, ACTIVITY_TYPES, AGENT_IDS, AI_OPERATIONS, AI_TOOL_TYPES, DELEGATION_FROM_SUB_AGENT_ID, DELEGATION_ID, DELEGATION_TO_SUB_AGENT_ID, SPAN_KEYS, SPAN_NAMES, TRANSFER_FROM_SUB_AGENT_ID, TRANSFER_TO_SUB_AGENT_ID, UNKNOWN_VALUE } from "./constants/otel-attributes.js";
 import { AGGREGATE_OPERATORS, DATA_SOURCES, DATA_TYPES, FIELD_TYPES, OPERATORS, ORDER_DIRECTIONS, PANEL_TYPES, QUERY_DEFAULTS, QUERY_EXPRESSIONS, QUERY_FIELD_CONFIGS, QUERY_TYPES, REDUCE_OPERATIONS } from "./constants/signoz-queries.js";
-import { AgentStopWhen, AgentStopWhenSchema, ApiKeyApiUpdateSchema, FullAgentAgentInsertSchema, FunctionApiInsertSchema, FunctionApiSelectSchema, FunctionApiUpdateSchema, ModelSettings, ModelSettingsSchema, StopWhen, StopWhenSchema, SubAgentStopWhen, SubAgentStopWhenSchema } from "./validation/schemas.js";
+import { ConversationHistoryConfig, CredentialStoreType, MCPTransportType } from "./types/utility.js";
 import "./types/index.js";
 import { DEFAULT_NANGO_STORE_ID } from "./credential-stores/default-constants.js";
 import { detectAuthenticationRequired } from "./utils/auth-detection.js";
 import { validatePropsAsJsonSchema } from "./validation/props-validation.js";
 import "./index.js";
-import { ConversationHistoryConfig, CredentialStoreType, MCPTransportType } from "./types/utility.js";
+import { AgentStopWhen, AgentStopWhenSchema, ApiKeyApiUpdateSchema, FullAgentAgentInsertSchema, FunctionApiInsertSchema, FunctionApiSelectSchema, FunctionApiUpdateSchema, ModelSettings, ModelSettingsSchema, StopWhen, StopWhenSchema, SubAgentStopWhen, SubAgentStopWhenSchema, TriggerApiInsertSchema, TriggerApiSelectSchema, TriggerApiUpdateSchema, TriggerInvocationApiSelectSchema, TriggerInvocationListResponse, TriggerInvocationResponse, TriggerInvocationStatusEnum, TriggerListResponse, TriggerResponse } from "./validation/schemas.js";
 import { z } from "@hono/zod-openapi";
 
 //#region src/client-exports.d.ts
@@ -287,6 +288,10 @@ declare const FullAgentDefinitionSchema: z.ZodObject<{
 type AgentApiInsert = z.infer<typeof AgentApiInsertSchema>;
 type ToolApiInsert = z.infer<typeof ToolApiInsertSchema>;
 type FunctionApiInsert = z.infer<typeof FunctionApiInsertSchema>;
+type TriggerApiInsert = z.infer<typeof TriggerApiInsertSchema>;
+type TriggerApiSelect = z.infer<typeof TriggerApiSelectSchema>;
+type TriggerApiUpdate = z.infer<typeof TriggerApiUpdateSchema>;
+type TriggerInvocationApiSelect = z.infer<typeof TriggerInvocationApiSelectSchema>;
 type ApiKeyApiSelect = z.infer<typeof ApiKeyApiSelectSchema>;
 type ApiKeyApiCreationResponse = z.infer<typeof ApiKeyApiCreationResponseSchema>;
 type ApiKeyApiUpdateResponse = z.infer<typeof ApiKeyApiUpdateSchema>;
@@ -309,4 +314,4 @@ declare function generateIdFromName(name: string): string;
 type ToolInsert = ToolApiInsert;
 type AgentAgentInsert = AgentAgentApiInsert;
 //#endregion
-export { ACTIVITY_NAMES, ACTIVITY_STATUS, ACTIVITY_TYPES, AGENT_IDS, AGGREGATE_OPERATORS, AI_OPERATIONS, AI_TOOL_TYPES, AgentAgentApiInsert, AgentAgentApiInsertSchema, AgentAgentInsert, AgentApiInsert, AgentApiInsertSchema, type AgentStopWhen, AgentStopWhenSchema, ApiKeyApiCreationResponse, ApiKeyApiCreationResponseSchema, ApiKeyApiSelect, ApiKeyApiSelectSchema, ApiKeyApiUpdateResponse, ArtifactComponentApiInsert, ArtifactComponentApiInsertSchema, ContextConfigApiInsert, ContextConfigApiInsertSchema, CredentialReferenceApiInsert, CredentialReferenceApiInsertSchema, CredentialStoreType, DATA_SOURCES, DATA_TYPES, DEFAULT_NANGO_STORE_ID, DELEGATION_FROM_SUB_AGENT_ID, DELEGATION_ID, DELEGATION_TO_SUB_AGENT_ID, DataComponentApiInsert, DataComponentApiInsertSchema, ErrorResponse, ErrorResponseSchema, ExternalAgentApiInsert, ExternalAgentApiInsertSchema, ExternalAgentDefinition, FIELD_TYPES, FullAgentDefinition, FullAgentDefinitionSchema, FunctionApiInsert, FunctionApiInsertSchema, FunctionApiSelectSchema, FunctionApiUpdateSchema, IdParamsSchema, InternalAgentDefinition, ListResponseSchema, MAX_ID_LENGTH, MCPTransportType, MIN_ID_LENGTH, type ModelSettings, ModelSettingsSchema, OPERATORS, ORDER_DIRECTIONS, PANEL_TYPES, PaginationSchema, QUERY_DEFAULTS, QUERY_EXPRESSIONS, QUERY_FIELD_CONFIGS, QUERY_TYPES, REDUCE_OPERATIONS, SPAN_KEYS, SPAN_NAMES, SingleResponseSchema, type StopWhen, StopWhenSchema, type SubAgentStopWhen, SubAgentStopWhenSchema, TRANSFER_FROM_SUB_AGENT_ID, TRANSFER_TO_SUB_AGENT_ID, TenantParams, TenantParamsSchema, TenantProjectIdParamsSchema, TenantProjectParamsSchema, ToolApiInsert, ToolApiInsertSchema, ToolInsert, UNKNOWN_VALUE, URL_SAFE_ID_PATTERN, detectAuthenticationRequired, generateIdFromName, resourceIdSchema, validatePropsAsJsonSchema };
+export { ACTIVITY_NAMES, ACTIVITY_STATUS, ACTIVITY_TYPES, AGENT_IDS, AGGREGATE_OPERATORS, AI_OPERATIONS, AI_TOOL_TYPES, AgentAgentApiInsert, AgentAgentApiInsertSchema, AgentAgentInsert, AgentApiInsert, AgentApiInsertSchema, type AgentStopWhen, AgentStopWhenSchema, ApiKeyApiCreationResponse, ApiKeyApiCreationResponseSchema, ApiKeyApiSelect, ApiKeyApiSelectSchema, ApiKeyApiUpdateResponse, ArtifactComponentApiInsert, ArtifactComponentApiInsertSchema, BreakdownComponentDef, CONTEXT_BREAKDOWN_TOTAL_SPAN_ATTRIBUTE, ContextBreakdown, ContextConfigApiInsert, ContextConfigApiInsertSchema, CredentialReferenceApiInsert, CredentialReferenceApiInsertSchema, CredentialStoreType, DATA_SOURCES, DATA_TYPES, DEFAULT_NANGO_STORE_ID, DELEGATION_FROM_SUB_AGENT_ID, DELEGATION_ID, DELEGATION_TO_SUB_AGENT_ID, DataComponentApiInsert, DataComponentApiInsertSchema, ErrorResponse, ErrorResponseSchema, ExternalAgentApiInsert, ExternalAgentApiInsertSchema, ExternalAgentDefinition, FIELD_TYPES, FullAgentDefinition, FullAgentDefinitionSchema, FunctionApiInsert, FunctionApiInsertSchema, FunctionApiSelectSchema, FunctionApiUpdateSchema, IdParamsSchema, InternalAgentDefinition, ListResponseSchema, MAX_ID_LENGTH, MCPTransportType, MIN_ID_LENGTH, type ModelSettings, ModelSettingsSchema, OPERATORS, ORDER_DIRECTIONS, PANEL_TYPES, PaginationSchema, QUERY_DEFAULTS, QUERY_EXPRESSIONS, QUERY_FIELD_CONFIGS, QUERY_TYPES, REDUCE_OPERATIONS, SPAN_KEYS, SPAN_NAMES, SingleResponseSchema, type StopWhen, StopWhenSchema, type SubAgentStopWhen, SubAgentStopWhenSchema, TRANSFER_FROM_SUB_AGENT_ID, TRANSFER_TO_SUB_AGENT_ID, TenantParams, TenantParamsSchema, TenantProjectIdParamsSchema, TenantProjectParamsSchema, ToolApiInsert, ToolApiInsertSchema, ToolInsert, TriggerApiInsert, TriggerApiInsertSchema, TriggerApiSelect, TriggerApiSelectSchema, TriggerApiUpdate, TriggerApiUpdateSchema, TriggerInvocationApiSelect, TriggerInvocationApiSelectSchema, TriggerInvocationListResponse, TriggerInvocationResponse, TriggerInvocationStatusEnum, TriggerListResponse, TriggerResponse, UNKNOWN_VALUE, URL_SAFE_ID_PATTERN, V1_BREAKDOWN_SCHEMA, calculateBreakdownTotal, createEmptyBreakdown, detectAuthenticationRequired, generateIdFromName, parseContextBreakdownFromSpan, resourceIdSchema, validatePropsAsJsonSchema };

package/dist/client-exports.js

@@ -1,8 +1,9 @@
 import { schemaValidationDefaults } from "./constants/schema-validation/defaults.js";
 import { CredentialStoreType, MCPTransportType } from "./types/utility.js";
-import { AgentStopWhenSchema, ArtifactComponentApiInsertSchema as ArtifactComponentApiInsertSchema$1, FullAgentAgentInsertSchema, FunctionApiInsertSchema, FunctionApiSelectSchema, FunctionApiUpdateSchema, ModelSettingsSchema, StopWhenSchema, SubAgentStopWhenSchema } from "./validation/schemas.js";
+import { AgentStopWhenSchema, ArtifactComponentApiInsertSchema as ArtifactComponentApiInsertSchema$1, FullAgentAgentInsertSchema, FunctionApiInsertSchema, FunctionApiSelectSchema, FunctionApiUpdateSchema, ModelSettingsSchema, StopWhenSchema, SubAgentStopWhenSchema, TriggerApiInsertSchema, TriggerApiSelectSchema, TriggerApiUpdateSchema, TriggerInvocationApiSelectSchema, TriggerInvocationListResponse, TriggerInvocationResponse, TriggerInvocationStatusEnum, TriggerListResponse, TriggerResponse } from "./validation/schemas.js";
 import { DEFAULT_NANGO_STORE_ID } from "./credential-stores/default-constants.js";
 import { validatePropsAsJsonSchema } from "./validation/props-validation.js";
+import { CONTEXT_BREAKDOWN_TOTAL_SPAN_ATTRIBUTE, V1_BREAKDOWN_SCHEMA, calculateBreakdownTotal, createEmptyBreakdown, parseContextBreakdownFromSpan } from "./constants/context-breakdown.js";
 import { ACTIVITY_NAMES, ACTIVITY_STATUS, ACTIVITY_TYPES, AGENT_IDS, AI_OPERATIONS, AI_TOOL_TYPES, DELEGATION_FROM_SUB_AGENT_ID, DELEGATION_ID, DELEGATION_TO_SUB_AGENT_ID, SPAN_KEYS, SPAN_NAMES, TRANSFER_FROM_SUB_AGENT_ID, TRANSFER_TO_SUB_AGENT_ID, UNKNOWN_VALUE } from "./constants/otel-attributes.js";
 import { AGGREGATE_OPERATORS, DATA_SOURCES, DATA_TYPES, FIELD_TYPES, OPERATORS, ORDER_DIRECTIONS, PANEL_TYPES, QUERY_DEFAULTS, QUERY_EXPRESSIONS, QUERY_FIELD_CONFIGS, QUERY_TYPES, REDUCE_OPERATIONS } from "./constants/signoz-queries.js";
 import { detectAuthenticationRequired } from "./utils/auth-detection.js";
@@ -167,4 +168,4 @@ function generateIdFromName(name) {
 }
 
 //#endregion
-export { ACTIVITY_NAMES, ACTIVITY_STATUS, ACTIVITY_TYPES, AGENT_IDS, AGGREGATE_OPERATORS, AI_OPERATIONS, AI_TOOL_TYPES, AgentAgentApiInsertSchema, AgentApiInsertSchema, AgentStopWhenSchema, ApiKeyApiCreationResponseSchema, ApiKeyApiSelectSchema, ArtifactComponentApiInsertSchema, ContextConfigApiInsertSchema, CredentialReferenceApiInsertSchema, CredentialStoreType, DATA_SOURCES, DATA_TYPES, DEFAULT_NANGO_STORE_ID, DELEGATION_FROM_SUB_AGENT_ID, DELEGATION_ID, DELEGATION_TO_SUB_AGENT_ID, DataComponentApiInsertSchema, ErrorResponseSchema, ExternalAgentApiInsertSchema, FIELD_TYPES, FullAgentDefinitionSchema, FunctionApiInsertSchema, FunctionApiSelectSchema, FunctionApiUpdateSchema, IdParamsSchema, ListResponseSchema, MAX_ID_LENGTH, MCPTransportType, MIN_ID_LENGTH, ModelSettingsSchema, OPERATORS, ORDER_DIRECTIONS, PANEL_TYPES, PaginationSchema, QUERY_DEFAULTS, QUERY_EXPRESSIONS, QUERY_FIELD_CONFIGS, QUERY_TYPES, REDUCE_OPERATIONS, SPAN_KEYS, SPAN_NAMES, SingleResponseSchema, StopWhenSchema, SubAgentStopWhenSchema, TRANSFER_FROM_SUB_AGENT_ID, TRANSFER_TO_SUB_AGENT_ID, TenantParamsSchema, TenantProjectIdParamsSchema, TenantProjectParamsSchema, ToolApiInsertSchema, UNKNOWN_VALUE, URL_SAFE_ID_PATTERN, detectAuthenticationRequired, generateIdFromName, resourceIdSchema, validatePropsAsJsonSchema };
+export { ACTIVITY_NAMES, ACTIVITY_STATUS, ACTIVITY_TYPES, AGENT_IDS, AGGREGATE_OPERATORS, AI_OPERATIONS, AI_TOOL_TYPES, AgentAgentApiInsertSchema, AgentApiInsertSchema, AgentStopWhenSchema, ApiKeyApiCreationResponseSchema, ApiKeyApiSelectSchema, ArtifactComponentApiInsertSchema, CONTEXT_BREAKDOWN_TOTAL_SPAN_ATTRIBUTE, ContextConfigApiInsertSchema, CredentialReferenceApiInsertSchema, CredentialStoreType, DATA_SOURCES, DATA_TYPES, DEFAULT_NANGO_STORE_ID, DELEGATION_FROM_SUB_AGENT_ID, DELEGATION_ID, DELEGATION_TO_SUB_AGENT_ID, DataComponentApiInsertSchema, ErrorResponseSchema, ExternalAgentApiInsertSchema, FIELD_TYPES, FullAgentDefinitionSchema, FunctionApiInsertSchema, FunctionApiSelectSchema, FunctionApiUpdateSchema, IdParamsSchema, ListResponseSchema, MAX_ID_LENGTH, MCPTransportType, MIN_ID_LENGTH, ModelSettingsSchema, OPERATORS, ORDER_DIRECTIONS, PANEL_TYPES, PaginationSchema, QUERY_DEFAULTS, QUERY_EXPRESSIONS, QUERY_FIELD_CONFIGS, QUERY_TYPES, REDUCE_OPERATIONS, SPAN_KEYS, SPAN_NAMES, SingleResponseSchema, StopWhenSchema, SubAgentStopWhenSchema, TRANSFER_FROM_SUB_AGENT_ID, TRANSFER_TO_SUB_AGENT_ID, TenantParamsSchema, TenantProjectIdParamsSchema, TenantProjectParamsSchema, ToolApiInsertSchema, TriggerApiInsertSchema, TriggerApiSelectSchema, TriggerApiUpdateSchema, TriggerInvocationApiSelectSchema, TriggerInvocationListResponse, TriggerInvocationResponse, TriggerInvocationStatusEnum, TriggerListResponse, TriggerResponse, UNKNOWN_VALUE, URL_SAFE_ID_PATTERN, V1_BREAKDOWN_SCHEMA, calculateBreakdownTotal, createEmptyBreakdown, detectAuthenticationRequired, generateIdFromName, parseContextBreakdownFromSpan, resourceIdSchema, validatePropsAsJsonSchema };

package/dist/constants/context-breakdown.d.ts

@@ -0,0 +1,61 @@
+//#region src/constants/context-breakdown.d.ts
+/**
+ * Context breakdown schema definitions.
+ *
+ * This module defines the breakdown components tracked for each system prompt version.
+ * It serves as the single source of truth for:
+ * - Component keys and labels
+ * - OpenTelemetry span attribute keys
+ * - UI visualization colors (auto-generated)
+ */
+/**
+ * Defines a single breakdown component for a system prompt version.
+ * Each version can define its own set of components.
+ */
+interface BreakdownComponentDef {
+  /** Unique key for this component (used in breakdown.components map) */
+  key: string;
+  /** Human-readable label for UI display */
+  label: string;
+  /** OpenTelemetry span attribute key for this component */
+  spanAttribute: string;
+  /** Hex color for UI visualization (auto-generated) */
+  color: string;
+}
+/**
+ * V1 Breakdown Schema - defines all context components tracked for V1 system prompts.
+ * Colors are automatically generated for visual distinction.
+ */
+declare const V1_BREAKDOWN_SCHEMA: BreakdownComponentDef[];
+/** Span attribute key for total tokens */
+declare const CONTEXT_BREAKDOWN_TOTAL_SPAN_ATTRIBUTE = "context.breakdown.total_tokens";
+/**
+ * Dynamic context breakdown interface.
+ * Uses a components map to support different system prompt versions.
+ */
+interface ContextBreakdown {
+  /** Token counts by component key (version-specific) */
+  components: Record<string, number>;
+  /** Total estimated tokens */
+  total: number;
+}
+/**
+ * Creates an empty context breakdown from a schema definition.
+ * @param schema - Array of breakdown component definitions
+ */
+declare function createEmptyBreakdown(schema: BreakdownComponentDef[]): ContextBreakdown;
+/**
+ * Calculates the total from all breakdown components and updates the total field.
+ * @param breakdown - The context breakdown to calculate total for
+ * @returns The breakdown with updated total
+ */
+declare function calculateBreakdownTotal(breakdown: ContextBreakdown): ContextBreakdown;
+/**
+ * Parses a context breakdown from span attributes using a schema.
+ * @param data - Span attribute data record
+ * @param schema - Breakdown schema to use for parsing
+ * @returns Parsed context breakdown
+ */
+declare function parseContextBreakdownFromSpan(data: Record<string, unknown>, schema?: BreakdownComponentDef[]): ContextBreakdown;
+//#endregion
+export { BreakdownComponentDef, CONTEXT_BREAKDOWN_TOTAL_SPAN_ATTRIBUTE, ContextBreakdown, V1_BREAKDOWN_SCHEMA, calculateBreakdownTotal, createEmptyBreakdown, parseContextBreakdownFromSpan };

package/dist/constants/context-breakdown.js

@@ -0,0 +1,124 @@
+import { generateDistinctColors } from "../utils/colors.js";
+
+//#region src/constants/context-breakdown.ts
+/**
+* Context breakdown schema definitions.
+*
+* This module defines the breakdown components tracked for each system prompt version.
+* It serves as the single source of truth for:
+* - Component keys and labels
+* - OpenTelemetry span attribute keys
+* - UI visualization colors (auto-generated)
+*/
+/**
+* Base schema without colors - colors are auto-generated based on index
+*/
+const V1_BREAKDOWN_SCHEMA_BASE = [
+	{
+		key: "systemPromptTemplate",
+		label: "System Prompt Template",
+		spanAttribute: "context.breakdown.system_template_tokens"
+	},
+	{
+		key: "coreInstructions",
+		label: "Core Instructions",
+		spanAttribute: "context.breakdown.core_instructions_tokens"
+	},
+	{
+		key: "agentPrompt",
+		label: "Agent Prompt",
+		spanAttribute: "context.breakdown.agent_prompt_tokens"
+	},
+	{
+		key: "toolsSection",
+		label: "Tools (MCP/Function/Relation)",
+		spanAttribute: "context.breakdown.tools_tokens"
+	},
+	{
+		key: "artifactsSection",
+		label: "Artifacts",
+		spanAttribute: "context.breakdown.artifacts_tokens"
+	},
+	{
+		key: "dataComponents",
+		label: "Data Components",
+		spanAttribute: "context.breakdown.data_components_tokens"
+	},
+	{
+		key: "artifactComponents",
+		label: "Artifact Components",
+		spanAttribute: "context.breakdown.artifact_components_tokens"
+	},
+	{
+		key: "transferInstructions",
+		label: "Transfer Instructions",
+		spanAttribute: "context.breakdown.transfer_instructions_tokens"
+	},
+	{
+		key: "delegationInstructions",
+		label: "Delegation Instructions",
+		spanAttribute: "context.breakdown.delegation_instructions_tokens"
+	},
+	{
+		key: "thinkingPreparation",
+		label: "Thinking Preparation",
+		spanAttribute: "context.breakdown.thinking_preparation_tokens"
+	},
+	{
+		key: "conversationHistory",
+		label: "Conversation History",
+		spanAttribute: "context.breakdown.conversation_history_tokens"
+	}
+];
+/** Pre-generated distinct colors for the schema */
+const SCHEMA_COLORS = generateDistinctColors(V1_BREAKDOWN_SCHEMA_BASE.length);
+/**
+* V1 Breakdown Schema - defines all context components tracked for V1 system prompts.
+* Colors are automatically generated for visual distinction.
+*/
+const V1_BREAKDOWN_SCHEMA = V1_BREAKDOWN_SCHEMA_BASE.map((def, index) => ({
+	...def,
+	color: SCHEMA_COLORS[index]
+}));
+/** Span attribute key for total tokens */
+const CONTEXT_BREAKDOWN_TOTAL_SPAN_ATTRIBUTE = "context.breakdown.total_tokens";
+/**
+* Creates an empty context breakdown from a schema definition.
+* @param schema - Array of breakdown component definitions
+*/
+function createEmptyBreakdown(schema) {
+	const components = {};
+	for (const def of schema) components[def.key] = 0;
+	return {
+		components,
+		total: 0
+	};
+}
+/**
+* Calculates the total from all breakdown components and updates the total field.
+* @param breakdown - The context breakdown to calculate total for
+* @returns The breakdown with updated total
+*/
+function calculateBreakdownTotal(breakdown) {
+	breakdown.total = Object.values(breakdown.components).reduce((sum, val) => sum + val, 0);
+	return breakdown;
+}
+/**
+* Parses a context breakdown from span attributes using a schema.
+* @param data - Span attribute data record
+* @param schema - Breakdown schema to use for parsing
+* @returns Parsed context breakdown
+*/
+function parseContextBreakdownFromSpan(data, schema = V1_BREAKDOWN_SCHEMA) {
+	const breakdown = createEmptyBreakdown(schema);
+	for (const def of schema) {
+		const value = data[def.spanAttribute];
+		breakdown.components[def.key] = typeof value === "number" ? value : Number(value) || 0;
+	}
+	const totalValue = data[CONTEXT_BREAKDOWN_TOTAL_SPAN_ATTRIBUTE];
+	breakdown.total = typeof totalValue === "number" ? totalValue : Number(totalValue) || 0;
+	return breakdown;
+}
+
+//#endregion
+export { CONTEXT_BREAKDOWN_TOTAL_SPAN_ATTRIBUTE, V1_BREAKDOWN_SCHEMA, calculateBreakdownTotal, createEmptyBreakdown, parseContextBreakdownFromSpan };

package/dist/constants/otel-attributes.d.ts

@@ -67,6 +67,7 @@ declare const SPAN_KEYS: {
   readonly CONTEXT_AGENT_ID: "context.agent_id";
   readonly CONTEXT_HEADERS_KEYS: "context.headers_keys";
   readonly MESSAGE_CONTENT: "message.content";
+  readonly MESSAGE_PARTS: "message.parts";
   readonly MESSAGE_TIMESTAMP: "message.timestamp";
   readonly MCP_TOOL_DESCRIPTION: "mcp.tool.description";
   readonly DELEGATION_FROM_SUB_AGENT_ID: "delegation.from_sub_agent_id";
@@ -80,6 +81,9 @@ declare const SPAN_KEYS: {
   readonly NAME: "name";
   readonly PARENT_SPAN_ID: "parentSpanID";
   readonly CONVERSATION_ID: "conversation.id";
+  readonly INVOCATION_TYPE: "invocation.type";
+  readonly TRIGGER_ID: "trigger.id";
+  readonly TRIGGER_INVOCATION_ID: "trigger.invocation.id";
   readonly ARTIFACT_ID: "artifact.id";
   readonly ARTIFACT_TYPE: "artifact.type";
   readonly ARTIFACT_TOOL_CALL_ID: "artifact.tool_call_id";

package/dist/constants/otel-attributes.js

@@ -67,6 +67,7 @@ const SPAN_KEYS = {
 	CONTEXT_AGENT_ID: "context.agent_id",
 	CONTEXT_HEADERS_KEYS: "context.headers_keys",
 	MESSAGE_CONTENT: "message.content",
+	MESSAGE_PARTS: "message.parts",
 	MESSAGE_TIMESTAMP: "message.timestamp",
 	MCP_TOOL_DESCRIPTION: "mcp.tool.description",
 	DELEGATION_FROM_SUB_AGENT_ID,
@@ -80,6 +81,9 @@ const SPAN_KEYS = {
 	NAME: "name",
 	PARENT_SPAN_ID: "parentSpanID",
 	CONVERSATION_ID: "conversation.id",
+	INVOCATION_TYPE: "invocation.type",
+	TRIGGER_ID: "trigger.id",
+	TRIGGER_INVOCATION_ID: "trigger.invocation.id",
 	ARTIFACT_ID: "artifact.id",
 	ARTIFACT_TYPE: "artifact.type",
 	ARTIFACT_TOOL_CALL_ID: "artifact.tool_call_id",

package/dist/context/ContextConfig.d.ts

@@ -1,7 +1,7 @@
-import { ContextConfigSelect, CredentialReferenceApiInsert } from "../types/entities.js";
+import { ContextFetchDefinition } from "../types/utility.js";
 import "../types/index.js";
 import { DotPaths } from "./validation-helpers.js";
-import { ContextFetchDefinition } from "../types/utility.js";
+import { ContextConfigSelect, CredentialReferenceApiInsert } from "../types/entities.js";
 import { z } from "@hono/zod-openapi";
 
 //#region src/context/ContextConfig.d.ts

package/dist/context/ContextConfig.js

@@ -31,7 +31,7 @@ var ContextConfigBuilder = class {
 		this.tenantId = options.tenantId || "default";
 		this.projectId = options.projectId || "default";
 		this.agentId = options.agentId || "default";
-		this.baseURL = process.env.INKEEP_AGENTS_MANAGE_API_URL || "http://localhost:3002";
+		this.baseURL = process.env.INKEEP_AGENTS_API_URL || "http://localhost:3002";
 		let headers$1;
 		if (options.headers) {
 			const actualSchema = options.headers instanceof HeadersSchemaBuilder ? options.headers.getSchema() : options.headers;
@@ -165,7 +165,7 @@ var ContextConfigBuilder = class {
 			contextVariables: this.getContextVariables()
 		};
 		try {
-			const updateResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/projects/${this.projectId}/agent/${this.agentId}/context-configs/${this.getId()}`, {
+			const updateResponse = await fetch(`${this.baseURL}/manage/tenants/${this.tenantId}/projects/${this.projectId}/agent/${this.agentId}/context-configs/${this.getId()}`, {
 				method: "PUT",
 				headers: { "Content-Type": "application/json" },
 				body: JSON.stringify(configData)
@@ -176,7 +176,7 @@ var ContextConfigBuilder = class {
 			}
 			if (updateResponse.status === 404) {
 				logger.info({ contextConfigId: this.getId() }, "Context config not found, creating new config");
-				const createResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/projects/${this.projectId}/agent/${this.agentId}/context-configs`, {
+				const createResponse = await fetch(`${this.baseURL}/manage/tenants/${this.tenantId}/projects/${this.projectId}/agent/${this.agentId}/context-configs`, {
 					method: "POST",
 					headers: { "Content-Type": "application/json" },
 					body: JSON.stringify(configData)

package/dist/context/TemplateEngine.js

@@ -63,7 +63,6 @@ var TemplateEngine = class TemplateEngine {
 						variable: trimmedPath,
 						normalizedPath,
 						availableKeys: Object.keys(context),
-						contextStructure: JSON.stringify(context, null, 2),
 						headersContent: context.headers ? JSON.stringify(context.headers, null, 2) : "undefined"
 					}, "Headers template variable debugging");
 					else logger.warn({

package/dist/context/index.d.ts

@@ -1,8 +1,4 @@
 import { DotPaths } from "./validation-helpers.js";
 import { ContextConfigBuilder, ContextConfigBuilderOptions, contextConfig, fetchDefinition, headers } from "./ContextConfig.js";
 import { TemplateContext, TemplateEngine, TemplateRenderOptions } from "./TemplateEngine.js";
-import { ContextFetcher, FetchResult, MissingRequiredVariableError } from "./ContextFetcher.js";
-import { ContextResolutionOptions, ContextResolutionResult, ContextResolver, ResolvedContext } from "./ContextResolver.js";
-import { determineContextTrigger, handleContextConfigChange, handleContextResolution } from "./context.js";
-import { ContextCache } from "./contextCache.js";
-export { ContextCache, ContextConfigBuilder, type ContextConfigBuilderOptions, ContextFetcher, type ContextResolutionOptions, type ContextResolutionResult, ContextResolver, type DotPaths, type FetchResult, MissingRequiredVariableError, type ResolvedContext, type TemplateContext, TemplateEngine, type TemplateRenderOptions, contextConfig, determineContextTrigger, fetchDefinition, handleContextConfigChange, handleContextResolution, headers };
+export { ContextConfigBuilder, type ContextConfigBuilderOptions, type DotPaths, type TemplateContext, TemplateEngine, type TemplateRenderOptions, contextConfig, fetchDefinition, headers };

package/dist/context/index.js

@@ -1,8 +1,4 @@
 import { ContextConfigBuilder, contextConfig, fetchDefinition, headers } from "./ContextConfig.js";
 import { TemplateEngine } from "./TemplateEngine.js";
-import { ContextCache } from "./contextCache.js";
-import { ContextResolver } from "./ContextResolver.js";
-import { ContextFetcher, MissingRequiredVariableError } from "./ContextFetcher.js";
-import { determineContextTrigger, handleContextConfigChange, handleContextResolution } from "./context.js";
 
-export { ContextCache, ContextConfigBuilder, ContextFetcher, ContextResolver, MissingRequiredVariableError, TemplateEngine, contextConfig, determineContextTrigger, fetchDefinition, handleContextConfigChange, handleContextResolution, headers };
+export { ContextConfigBuilder, TemplateEngine, contextConfig, fetchDefinition, headers };

package/dist/credential-stuffer/CredentialStuffer.d.ts

@@ -1,8 +1,8 @@
-import { MCPToolConfig } from "../types/entities.js";
 import "../types/index.js";
 import { CredentialStoreRegistry } from "../credential-stores/CredentialStoreRegistry.js";
 import { PinoLogger } from "../utils/logger.js";
 import { McpServerConfig } from "../utils/mcp-client.js";
+import { MCPToolConfig } from "../types/entities.js";
 
 //#region src/credential-stuffer/CredentialStuffer.d.ts
 /**