@inkeep/agents-run-api 0.39.5 → 0.41.0

package/dist/agents/versions/v1/Phase2Config.js

@@ -0,0 +1,330 @@
+import { ArtifactCreateSchema } from "../../../utils/artifact-component-schema.js";
+import artifact_default from "../../../_virtual/_raw_/home/runner/work/agents/agents/agents-run-api/templates/v1/shared/artifact.js";
+import artifact_retrieval_guidance_default from "../../../_virtual/_raw_/home/runner/work/agents/agents/agents-run-api/templates/v1/shared/artifact-retrieval-guidance.js";
+import data_component_default from "../../../_virtual/_raw_/home/runner/work/agents/agents/agents-run-api/templates/v1/phase2/data-component.js";
+import data_components_default from "../../../_virtual/_raw_/home/runner/work/agents/agents/agents-run-api/templates/v1/phase2/data-components.js";
+import system_prompt_default from "../../../_virtual/_raw_/home/runner/work/agents/agents/agents-run-api/templates/v1/phase2/system-prompt.js";
+
+//#region src/agents/versions/v1/Phase2Config.ts
+/**
+* Configuration for Phase 2 structured output generation
+* Handles data components, artifact creation, and JSON formatting guidance
+*/
+var Phase2Config = class {
+	getArtifactCreationGuidance() {
+		return `🚨 MANDATORY ARTIFACT CREATION 🚨
+You MUST create artifacts from tool results to provide citations. This is REQUIRED, not optional.
+Every piece of information from tools MUST be backed by an artifact creation.
+
+CRITICAL CITATION REQUIREMENTS:
+- Information FROM tool results = MUST create artifact citation
+- Information BASED ON tool results = MUST create artifact citation
+- Analysis OF tool results = MUST create artifact citation  
+- Summaries OF tool results = MUST create artifact citation
+- NO INFORMATION from tools can be presented without artifact citation
+
+CRITICAL: ARTIFACTS MUST BE CREATED FIRST
+You MUST create an artifact before you can reference it. You cannot reference artifacts that don't exist yet.
+
+CRITICAL CITATION PRINCIPLE:
+Creating an artifact IS a citation. Only reference again when citing the SAME artifact for a different statement.
+
+CRITICAL: ALWAYS SELECT SINGLE ITEMS, NEVER ARRAYS
+
+SELECTOR REQUIREMENTS:
+- MUST select ONE specific item, never an array  
+- Use compound filtering: result.items[?title=='API Guide' && type=='doc'] | [0]
+- Navigate nested structures: result.structuredContent.content[?title=='Setup'] | [0]
+- ALWAYS end with | [0] to select the first matching item
+- NEVER chain multiple [?...][?...] filters - use && for compound conditions
+
+❌ WRONG FILTER SYNTAX:
+- result.content[?title=='Guide'][?type=='doc'][0]  // Multiple chained filters - INVALID JMESPath
+- result.items[?name=='API'][?status=='active'][0]   // Chained filters - INVALID JMESPath
+
+✅ CORRECT FILTER SYNTAX:
+- result.content[?title=='Guide' && type=='doc'] | [0]     // Compound filter with pipe
+- result.structuredContent.content[?title=='Inkeep' && record_type=='site'] | [0]  // Navigate + filter
+
+HANDLING REPEATED KEYS:
+When the same field names appear at different levels (like 'content', 'title', 'type'):
+- Use the FULL PATH to the correct level: result.structuredContent.content[*] not result.content[*]
+- Check structure hints for the exact path depth
+- Use compound conditions to be more specific: [?title=='Inkeep' && record_type=='site']
+
+CRITICAL: SELECTOR HIERARCHY
+- base_selector: Points to ONE specific item in the tool result
+- details_selector: Contains JMESPath selectors RELATIVE to the base selector  
+- Example: If base="result.documents[?type=='api']" then details_selector uses "title" not "documents[0].title"
+
+❌ WRONG EXAMPLE:
+{
+  "base_selector": "result.content[?title=='Guide']",
+  "details_selector": {
+    "title": "Guide",  // ❌ This is a literal value, not a selector!
+    "url": "result.content[?title=='Guide'].url",  // ❌ This is absolute, not relative!
+    "description": "A comprehensive guide",  // ❌ Literal value instead of selector!
+    "content": "result.content[?title=='Guide'].content"  // ❌ Absolute path instead of relative!
+  }
+}
+
+✅ CORRECT EXAMPLE:
+{
+  "base_selector": "result.content[?title=='Guide']",
+  "details_selector": {
+    "title": "title",  // ✅ Relative selector to get title field
+    "url": "url",       // ✅ Relative selector to get url field  
+    "description": "description",    // ✅ Relative selector
+    "content": "content",            // ✅ Relative selector
+    "metadata": "metadata.details"  // ✅ Relative selector with nesting
+  }
+}
+
+COMMON FAILURE POINTS (AVOID THESE):
+1. **Array Selection**: result.items (returns array) ❌
+   → Fix: result.items[?type=='guide'] (returns single item) ✅
+
+2. **Literal Values Instead of Selectors**: "title": "API Guide" ❌
+   → Fix: "title": "title" (selector to extract title field) ✅
+
+3. **Absolute Paths Instead of Relative**: "title": "result.items[0].title" ❌
+   → Fix: "title": "title" (relative to base_selector) ✅
+
+4. **Similar Key Names**: "title" vs "name" vs "heading"
+   → Always check the actual field names in tool results
+
+5. **Repeated Keys**: Multiple items with same "title" field
+   → Use more specific filters: [?title=='Guide' && section=='setup']
+
+6. **Case Sensitivity**: 'Guide' vs 'guide'
+   → Match exact case from tool results
+
+7. **Missing Nested Levels**: "content.text" when it's "body.content.text"
+   → Include all intermediate levels`;
+	}
+	getStructuredArtifactGuidance(hasArtifactComponents, artifactComponents, shouldShowReferencingRules = true) {
+		if (!shouldShowReferencingRules) return "";
+		const sharedGuidance = artifact_retrieval_guidance_default;
+		if (hasArtifactComponents && artifactComponents && artifactComponents.length > 0) return `${sharedGuidance}
+
+ARTIFACT MANAGEMENT FOR STRUCTURED RESPONSES:
+
+You will create and reference artifacts using data components in your JSON response.
+
+CREATING ARTIFACTS (SERVES AS CITATION):
+Use the appropriate ArtifactCreate_[Type] component to extract and structure data from tool results.
+The creation itself serves as a citation - no additional reference needed.
+
+⚠️ IMPORTANT: Do not create artifacts from get_reference_artifact tool results - these are already compressed artifacts being retrieved. Only create artifacts from original research and analysis tools.
+
+🚫 FORBIDDEN JMESPATH PATTERNS:
+❌ NEVER: [?title~'.*text.*'] (regex patterns with ~ operator)
+❌ NEVER: [?field~'pattern.*'] (any ~ operator usage)
+❌ NEVER: [?title~'Slack.*Discord.*'] (regex wildcards)
+❌ NEVER: [?name~'https://.*'] (regex in URL matching)
+❌ NEVER: [?text ~ contains(@, 'word')] (~ with @ operator)
+❌ NEVER: contains(@, 'text') (@ operator usage)
+❌ NEVER: [?field=="value"] (double quotes in filters)
+❌ NEVER: result.items[?type=='doc'][?status=='active'] (chained filters)
+
+✅ CORRECT JMESPATH SYNTAX:
+✅ [?contains(title, 'text')] (contains function)
+✅ [?title=='exact match'] (exact string matching)
+✅ [?contains(title, 'Slack') && contains(title, 'Discord')] (compound conditions)
+✅ [?starts_with(url, 'https://')] (starts_with function)
+✅ [?type=='doc' && status=='active'] (single filter with &&)
+✅ [?contains(text, 'Founder')] (contains haystack, needle format)
+✅ source.content[?contains(text, 'Founder')].text (correct filter usage)
+
+REFERENCING ARTIFACTS (WHEN CITING AGAIN):
+Only use the Artifact component when you need to cite the same artifact again for a different statement or context.
+
+EXAMPLE STRUCTURED RESPONSE:
+\`\`\`json
+{
+  "dataComponents": [
+    {
+      "id": "text1",
+      "name": "Text",
+      "props": {
+        "text": "Found documentation about the authentication API."
+      }
+    },
+    {
+      "id": "create1",
+      "name": "ArtifactCreate_APIDoc",
+      "props": {
+        "id": "auth-api-doc",
+        "tool_call_id": "call_abc123",
+        "type": "APIDoc",
+        "base_selector": "result.documents[?type=='api']",
+        "details_selector": {"title": "metadata.title", "endpoint": "api.endpoint", "description": "content.description", "parameters": "spec.parameters", "examples": "examples.sample_code"}
+      }
+    },
+    {
+      "id": "text2",
+      "name": "Text",
+      "props": {
+        "text": "The API requires OAuth 2.0 authentication. Later in this guide, we'll reference the same documentation again."
+      }
+    },
+    {
+      "id": "ref1",
+      "name": "Artifact",
+      "props": {
+        "artifact_id": "auth-api-doc",
+        "tool_call_id": "call_abc123"
+      }
+    }
+  ]
+}
+\`\`\`
+
+${this.getArtifactCreationGuidance()}
+
+COMPONENT GUIDELINES:
+- Each artifact type has its own ArtifactCreate_[Type] component
+- ArtifactCreate components serve as both creation AND citation
+- Only add Artifact reference components when citing the SAME artifact again for a different point
+- Use tool_call_id exactly as it appears in tool execution results`;
+		return `${sharedGuidance}
+
+ARTIFACT REFERENCING FOR STRUCTURED RESPONSES:
+
+You can reference existing artifacts but cannot create new ones.
+
+HOW TO REFERENCE ARTIFACTS:
+Use the Artifact component with artifact_id and tool_call_id from existing artifacts or delegation responses.
+
+EXAMPLE STRUCTURED RESPONSE:
+\`\`\`json
+{
+  "dataComponents": [
+    {
+      "id": "text1",
+      "name": "Text",
+      "props": {
+        "text": "Based on the previously collected information about authentication."
+      }
+    },
+    {
+      "id": "ref1",
+      "name": "Artifact",
+      "props": {
+        "artifact_id": "existing-auth-doc",
+        "tool_call_id": "call_previous123"
+      }
+    },
+    {
+      "id": "text2",
+      "name": "Text", 
+      "props": {
+        "text": "The API uses OAuth 2.0 for secure access."
+      }
+    }
+  ]
+}
+\`\`\`
+
+IMPORTANT GUIDELINES:
+- You can only reference artifacts that already exist
+- Use the Artifact component to reference them
+- Copy artifact_id and tool_call_id exactly from existing artifacts
+- Mix artifact references naturally throughout your response`;
+	}
+	getArtifactCreationInstructions(hasArtifactComponents, artifactComponents) {
+		if (!hasArtifactComponents || !artifactComponents || artifactComponents.length === 0) return "";
+		return `
+AVAILABLE ARTIFACT TYPES:
+
+${artifactComponents.map((ac) => {
+			const schemaProps = ac.props?.properties ? Object.entries(ac.props.properties).map(([key, value]) => {
+				const inPreview = value.inPreview ? " [PREVIEW]" : " [FULL]";
+				return `      - ${key}: ${value.description || "Field from tool result"}${inPreview}`;
+			}).join("\n") : "      No properties defined";
+			return `  ArtifactCreate_${ac.name}:
+    Description: ${ac.description || "Extract and structure data"}
+    Schema Properties:
+${schemaProps}`;
+		}).join("\n\n")}`;
+	}
+	generateDataComponentsSection(dataComponents) {
+		if (dataComponents.length === 0) return "";
+		const dataComponentsDescription = dataComponents.map((dc) => `${dc.name}: ${dc.description}`).join(", ");
+		const dataComponentsXml = dataComponents.map((dataComponent) => this.generateDataComponentXml(dataComponent)).join("\n  ");
+		let dataComponentsSection = data_components_default;
+		dataComponentsSection = dataComponentsSection.replace("{{DATA_COMPONENTS_LIST}}", dataComponentsDescription);
+		dataComponentsSection = dataComponentsSection.replace("{{DATA_COMPONENTS_XML}}", dataComponentsXml);
+		return dataComponentsSection;
+	}
+	generateDataComponentXml(dataComponent) {
+		let dataComponentXml = data_component_default;
+		dataComponentXml = dataComponentXml.replace("{{COMPONENT_NAME}}", dataComponent.name);
+		dataComponentXml = dataComponentXml.replace("{{COMPONENT_DESCRIPTION}}", dataComponent.description || "");
+		dataComponentXml = dataComponentXml.replace("{{COMPONENT_PROPS_SCHEMA}}", this.generateParametersXml(dataComponent.props));
+		return dataComponentXml;
+	}
+	generateParametersXml(inputSchema) {
+		if (!inputSchema) return "<type>object</type>\n      <properties>\n      </properties>\n      <required>[]</required>";
+		const schemaType = inputSchema.type || "object";
+		const properties = inputSchema.properties || {};
+		const required = inputSchema.required || [];
+		return `<type>${schemaType}</type>\n      <properties>\n${Object.entries(properties).map(([key, value]) => {
+			const isRequired = required.includes(key);
+			return `        ${key}: {\n          "type": "${value?.type || "string"}",\n          "description": "${value?.description || "No description"}",\n          "required": ${isRequired}\n        }`;
+		}).join("\n")}\n      </properties>\n      <required>${JSON.stringify(required)}</required>`;
+	}
+	generateArtifactsSection(artifacts) {
+		if (artifacts.length === 0) return `<available_artifacts description="No artifacts are currently available.
+
+${artifact_retrieval_guidance_default}
+
+"></available_artifacts>`;
+		return `<available_artifacts description="These are the artifacts available for you to reference in your structured response.
+
+${artifact_retrieval_guidance_default}
+
+">
+  ${artifacts.map((artifact) => this.generateArtifactXml(artifact)).join("\n  ")}
+</available_artifacts>`;
+	}
+	generateArtifactXml(artifact) {
+		let artifactXml = artifact_default;
+		const summaryData = artifact.parts?.map((part) => part.data?.summary).filter(Boolean) || [];
+		const artifactSummary = summaryData.length > 0 ? JSON.stringify(summaryData, null, 2) : "No summary data available";
+		artifactXml = artifactXml.replace("{{ARTIFACT_NAME}}", artifact.name || "");
+		artifactXml = artifactXml.replace("{{ARTIFACT_DESCRIPTION}}", artifact.description || "");
+		artifactXml = artifactXml.replace("{{TASK_ID}}", artifact.taskId || "");
+		artifactXml = artifactXml.replace("{{ARTIFACT_ID}}", artifact.artifactId || "");
+		artifactXml = artifactXml.replace("{{TOOL_CALL_ID}}", artifact.toolCallId || "unknown");
+		artifactXml = artifactXml.replace("{{ARTIFACT_SUMMARY}}", artifactSummary);
+		return artifactXml;
+	}
+	/**
+	* Assemble the complete Phase 2 system prompt for structured output generation
+	*/
+	assemblePhase2Prompt(config) {
+		const { corePrompt, dataComponents, artifactComponents, hasArtifactComponents, hasAgentArtifactComponents, artifacts = [] } = config;
+		let allDataComponents = [...dataComponents];
+		if (hasArtifactComponents && artifactComponents) {
+			const artifactCreateComponents = ArtifactCreateSchema.getDataComponents("tenant", "", artifactComponents);
+			allDataComponents = [...dataComponents, ...artifactCreateComponents];
+		}
+		const dataComponentsSection = this.generateDataComponentsSection(allDataComponents);
+		const artifactsSection = this.generateArtifactsSection(artifacts);
+		const shouldShowReferencingRules = hasAgentArtifactComponents || artifacts.length > 0;
+		const artifactGuidance = this.getStructuredArtifactGuidance(hasArtifactComponents, artifactComponents, shouldShowReferencingRules);
+		const artifactTypes = this.getArtifactCreationInstructions(hasArtifactComponents, artifactComponents);
+		let phase2Prompt = system_prompt_default;
+		if (corePrompt && corePrompt.trim()) phase2Prompt = phase2Prompt.replace("{{CORE_INSTRUCTIONS}}", corePrompt);
+		else phase2Prompt = phase2Prompt.replace(/<core_instructions>\s*\{\{CORE_INSTRUCTIONS\}\}\s*<\/core_instructions>/g, "");
+		phase2Prompt = phase2Prompt.replace("{{DATA_COMPONENTS_SECTION}}", dataComponentsSection);
+		phase2Prompt = phase2Prompt.replace("{{ARTIFACTS_SECTION}}", artifactsSection);
+		phase2Prompt = phase2Prompt.replace("{{ARTIFACT_GUIDANCE_SECTION}}", artifactGuidance);
+		phase2Prompt = phase2Prompt.replace("{{ARTIFACT_TYPES_SECTION}}", artifactTypes);
+		return phase2Prompt;
+	}
+};
+
+//#endregion
+export { Phase2Config };

package/dist/constants/execution-limits/defaults.d.ts

@@ -0,0 +1,51 @@
+//#region src/constants/execution-limits/defaults.d.ts
+/**
+ * Run-API specific execution limit constants that control runtime behavior.
+ * These are used as defaults when user configuration is null/undefined.
+ */
+declare const executionLimitsDefaults: {
+  readonly AGENT_EXECUTION_MAX_CONSECUTIVE_ERRORS: 3;
+  readonly AGENT_EXECUTION_MAX_GENERATION_STEPS: 5;
+  readonly LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_STREAMING: 270000;
+  readonly LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_NON_STREAMING: 90000;
+  readonly LLM_GENERATION_SUBSEQUENT_CALL_TIMEOUT_MS: 90000;
+  readonly LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS: 600000;
+  readonly FUNCTION_TOOL_EXECUTION_TIMEOUT_MS_DEFAULT: 30000;
+  readonly FUNCTION_TOOL_SANDBOX_VCPUS_DEFAULT: 4;
+  readonly FUNCTION_TOOL_SANDBOX_POOL_TTL_MS: 300000;
+  readonly FUNCTION_TOOL_SANDBOX_MAX_USE_COUNT: 50;
+  readonly FUNCTION_TOOL_SANDBOX_MAX_OUTPUT_SIZE_BYTES: 1048576;
+  readonly FUNCTION_TOOL_SANDBOX_QUEUE_WAIT_TIMEOUT_MS: 30000;
+  readonly FUNCTION_TOOL_SANDBOX_CLEANUP_INTERVAL_MS: 60000;
+  readonly MCP_TOOL_REQUEST_TIMEOUT_MS_DEFAULT: 60000;
+  readonly DELEGATION_TOOL_BACKOFF_INITIAL_INTERVAL_MS: 100;
+  readonly DELEGATION_TOOL_BACKOFF_MAX_INTERVAL_MS: 10000;
+  readonly DELEGATION_TOOL_BACKOFF_EXPONENT: 2;
+  readonly DELEGATION_TOOL_BACKOFF_MAX_ELAPSED_TIME_MS: 20000;
+  readonly A2A_BACKOFF_INITIAL_INTERVAL_MS: 500;
+  readonly A2A_BACKOFF_MAX_INTERVAL_MS: 60000;
+  readonly A2A_BACKOFF_EXPONENT: 1.5;
+  readonly A2A_BACKOFF_MAX_ELAPSED_TIME_MS: 30000;
+  readonly ARTIFACT_GENERATION_MAX_RETRIES: 3;
+  readonly ARTIFACT_SESSION_MAX_PENDING: 100;
+  readonly ARTIFACT_SESSION_MAX_PREVIOUS_SUMMARIES: 3;
+  readonly ARTIFACT_GENERATION_BACKOFF_INITIAL_MS: 1000;
+  readonly ARTIFACT_GENERATION_BACKOFF_MAX_MS: 10000;
+  readonly SESSION_TOOL_RESULT_CACHE_TIMEOUT_MS: 300000;
+  readonly SESSION_CLEANUP_INTERVAL_MS: 60000;
+  readonly STATUS_UPDATE_DEFAULT_NUM_EVENTS: 1;
+  readonly STATUS_UPDATE_DEFAULT_INTERVAL_SECONDS: 2;
+  readonly STREAM_PARSER_MAX_SNAPSHOT_SIZE: 100;
+  readonly STREAM_PARSER_MAX_STREAMED_SIZE: 1000;
+  readonly STREAM_PARSER_MAX_COLLECTED_PARTS: 10000;
+  readonly STREAM_BUFFER_MAX_SIZE_BYTES: 5242880;
+  readonly STREAM_TEXT_GAP_THRESHOLD_MS: 2000;
+  readonly STREAM_MAX_LIFETIME_MS: 600000;
+  readonly CONVERSATION_HISTORY_DEFAULT_LIMIT: 50;
+  readonly CONVERSATION_ARTIFACTS_LIMIT: 12;
+  readonly COMPRESSION_HARD_LIMIT: 120000;
+  readonly COMPRESSION_SAFETY_BUFFER: 20000;
+  readonly COMPRESSION_ENABLED: true;
+};
+//#endregion
+export { executionLimitsDefaults };

package/dist/constants/execution-limits/defaults.js

@@ -0,0 +1,52 @@
+//#region src/constants/execution-limits/defaults.ts
+/**
+* Run-API specific execution limit constants that control runtime behavior.
+* These are used as defaults when user configuration is null/undefined.
+*/
+const executionLimitsDefaults = {
+	AGENT_EXECUTION_MAX_CONSECUTIVE_ERRORS: 3,
+	AGENT_EXECUTION_MAX_GENERATION_STEPS: 5,
+	LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_STREAMING: 27e4,
+	LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_NON_STREAMING: 9e4,
+	LLM_GENERATION_SUBSEQUENT_CALL_TIMEOUT_MS: 9e4,
+	LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS: 6e5,
+	FUNCTION_TOOL_EXECUTION_TIMEOUT_MS_DEFAULT: 3e4,
+	FUNCTION_TOOL_SANDBOX_VCPUS_DEFAULT: 4,
+	FUNCTION_TOOL_SANDBOX_POOL_TTL_MS: 3e5,
+	FUNCTION_TOOL_SANDBOX_MAX_USE_COUNT: 50,
+	FUNCTION_TOOL_SANDBOX_MAX_OUTPUT_SIZE_BYTES: 1048576,
+	FUNCTION_TOOL_SANDBOX_QUEUE_WAIT_TIMEOUT_MS: 3e4,
+	FUNCTION_TOOL_SANDBOX_CLEANUP_INTERVAL_MS: 6e4,
+	MCP_TOOL_REQUEST_TIMEOUT_MS_DEFAULT: 6e4,
+	DELEGATION_TOOL_BACKOFF_INITIAL_INTERVAL_MS: 100,
+	DELEGATION_TOOL_BACKOFF_MAX_INTERVAL_MS: 1e4,
+	DELEGATION_TOOL_BACKOFF_EXPONENT: 2,
+	DELEGATION_TOOL_BACKOFF_MAX_ELAPSED_TIME_MS: 2e4,
+	A2A_BACKOFF_INITIAL_INTERVAL_MS: 500,
+	A2A_BACKOFF_MAX_INTERVAL_MS: 6e4,
+	A2A_BACKOFF_EXPONENT: 1.5,
+	A2A_BACKOFF_MAX_ELAPSED_TIME_MS: 3e4,
+	ARTIFACT_GENERATION_MAX_RETRIES: 3,
+	ARTIFACT_SESSION_MAX_PENDING: 100,
+	ARTIFACT_SESSION_MAX_PREVIOUS_SUMMARIES: 3,
+	ARTIFACT_GENERATION_BACKOFF_INITIAL_MS: 1e3,
+	ARTIFACT_GENERATION_BACKOFF_MAX_MS: 1e4,
+	SESSION_TOOL_RESULT_CACHE_TIMEOUT_MS: 3e5,
+	SESSION_CLEANUP_INTERVAL_MS: 6e4,
+	STATUS_UPDATE_DEFAULT_NUM_EVENTS: 1,
+	STATUS_UPDATE_DEFAULT_INTERVAL_SECONDS: 2,
+	STREAM_PARSER_MAX_SNAPSHOT_SIZE: 100,
+	STREAM_PARSER_MAX_STREAMED_SIZE: 1e3,
+	STREAM_PARSER_MAX_COLLECTED_PARTS: 1e4,
+	STREAM_BUFFER_MAX_SIZE_BYTES: 5242880,
+	STREAM_TEXT_GAP_THRESHOLD_MS: 2e3,
+	STREAM_MAX_LIFETIME_MS: 6e5,
+	CONVERSATION_HISTORY_DEFAULT_LIMIT: 50,
+	CONVERSATION_ARTIFACTS_LIMIT: 12,
+	COMPRESSION_HARD_LIMIT: 12e4,
+	COMPRESSION_SAFETY_BUFFER: 2e4,
+	COMPRESSION_ENABLED: true
+};
+
+//#endregion
+export { executionLimitsDefaults };

package/dist/constants/execution-limits/index.d.ts

@@ -0,0 +1,6 @@
+import { executionLimitsDefaults } from "./defaults.js";
+
+//#region src/constants/execution-limits/index.d.ts
+declare const AGENT_EXECUTION_MAX_CONSECUTIVE_ERRORS: 3, AGENT_EXECUTION_MAX_GENERATION_STEPS: 5, LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_STREAMING: 270000, LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_NON_STREAMING: 90000, LLM_GENERATION_SUBSEQUENT_CALL_TIMEOUT_MS: 90000, LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS: 600000, FUNCTION_TOOL_EXECUTION_TIMEOUT_MS_DEFAULT: 30000, FUNCTION_TOOL_SANDBOX_VCPUS_DEFAULT: 4, FUNCTION_TOOL_SANDBOX_POOL_TTL_MS: 300000, FUNCTION_TOOL_SANDBOX_MAX_USE_COUNT: 50, FUNCTION_TOOL_SANDBOX_MAX_OUTPUT_SIZE_BYTES: 1048576, FUNCTION_TOOL_SANDBOX_QUEUE_WAIT_TIMEOUT_MS: 30000, FUNCTION_TOOL_SANDBOX_CLEANUP_INTERVAL_MS: 60000, MCP_TOOL_REQUEST_TIMEOUT_MS_DEFAULT: 60000, DELEGATION_TOOL_BACKOFF_INITIAL_INTERVAL_MS: 100, DELEGATION_TOOL_BACKOFF_MAX_INTERVAL_MS: 10000, DELEGATION_TOOL_BACKOFF_EXPONENT: 2, DELEGATION_TOOL_BACKOFF_MAX_ELAPSED_TIME_MS: 20000, A2A_BACKOFF_INITIAL_INTERVAL_MS: 500, A2A_BACKOFF_MAX_INTERVAL_MS: 60000, A2A_BACKOFF_EXPONENT: 1.5, A2A_BACKOFF_MAX_ELAPSED_TIME_MS: 30000, ARTIFACT_GENERATION_MAX_RETRIES: 3, ARTIFACT_SESSION_MAX_PENDING: 100, ARTIFACT_SESSION_MAX_PREVIOUS_SUMMARIES: 3, ARTIFACT_GENERATION_BACKOFF_INITIAL_MS: 1000, ARTIFACT_GENERATION_BACKOFF_MAX_MS: 10000, SESSION_TOOL_RESULT_CACHE_TIMEOUT_MS: 300000, SESSION_CLEANUP_INTERVAL_MS: 60000, STATUS_UPDATE_DEFAULT_NUM_EVENTS: 1, STATUS_UPDATE_DEFAULT_INTERVAL_SECONDS: 2, STREAM_PARSER_MAX_SNAPSHOT_SIZE: 100, STREAM_PARSER_MAX_STREAMED_SIZE: 1000, STREAM_PARSER_MAX_COLLECTED_PARTS: 10000, STREAM_BUFFER_MAX_SIZE_BYTES: 5242880, STREAM_TEXT_GAP_THRESHOLD_MS: 2000, STREAM_MAX_LIFETIME_MS: 600000, CONVERSATION_HISTORY_DEFAULT_LIMIT: 50, CONVERSATION_ARTIFACTS_LIMIT: 12, COMPRESSION_HARD_LIMIT: 120000, COMPRESSION_SAFETY_BUFFER: 20000, COMPRESSION_ENABLED: true;
+//#endregion
+export { A2A_BACKOFF_EXPONENT, A2A_BACKOFF_INITIAL_INTERVAL_MS, A2A_BACKOFF_MAX_ELAPSED_TIME_MS, A2A_BACKOFF_MAX_INTERVAL_MS, AGENT_EXECUTION_MAX_CONSECUTIVE_ERRORS, AGENT_EXECUTION_MAX_GENERATION_STEPS, ARTIFACT_GENERATION_BACKOFF_INITIAL_MS, ARTIFACT_GENERATION_BACKOFF_MAX_MS, ARTIFACT_GENERATION_MAX_RETRIES, ARTIFACT_SESSION_MAX_PENDING, ARTIFACT_SESSION_MAX_PREVIOUS_SUMMARIES, COMPRESSION_ENABLED, COMPRESSION_HARD_LIMIT, COMPRESSION_SAFETY_BUFFER, CONVERSATION_ARTIFACTS_LIMIT, CONVERSATION_HISTORY_DEFAULT_LIMIT, DELEGATION_TOOL_BACKOFF_EXPONENT, DELEGATION_TOOL_BACKOFF_INITIAL_INTERVAL_MS, DELEGATION_TOOL_BACKOFF_MAX_ELAPSED_TIME_MS, DELEGATION_TOOL_BACKOFF_MAX_INTERVAL_MS, FUNCTION_TOOL_EXECUTION_TIMEOUT_MS_DEFAULT, FUNCTION_TOOL_SANDBOX_CLEANUP_INTERVAL_MS, FUNCTION_TOOL_SANDBOX_MAX_OUTPUT_SIZE_BYTES, FUNCTION_TOOL_SANDBOX_MAX_USE_COUNT, FUNCTION_TOOL_SANDBOX_POOL_TTL_MS, FUNCTION_TOOL_SANDBOX_QUEUE_WAIT_TIMEOUT_MS, FUNCTION_TOOL_SANDBOX_VCPUS_DEFAULT, LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_NON_STREAMING, LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_STREAMING, LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS, LLM_GENERATION_SUBSEQUENT_CALL_TIMEOUT_MS, MCP_TOOL_REQUEST_TIMEOUT_MS_DEFAULT, SESSION_CLEANUP_INTERVAL_MS, SESSION_TOOL_RESULT_CACHE_TIMEOUT_MS, STATUS_UPDATE_DEFAULT_INTERVAL_SECONDS, STATUS_UPDATE_DEFAULT_NUM_EVENTS, STREAM_BUFFER_MAX_SIZE_BYTES, STREAM_MAX_LIFETIME_MS, STREAM_PARSER_MAX_COLLECTED_PARTS, STREAM_PARSER_MAX_SNAPSHOT_SIZE, STREAM_PARSER_MAX_STREAMED_SIZE, STREAM_TEXT_GAP_THRESHOLD_MS, executionLimitsDefaults };

package/dist/constants/execution-limits/index.js

@@ -0,0 +1,21 @@
+import { executionLimitsDefaults } from "./defaults.js";
+import { z } from "@hono/zod-openapi";
+import { loadEnvironmentFiles } from "@inkeep/agents-core";
+
+//#region src/constants/execution-limits/index.ts
+loadEnvironmentFiles();
+const constantsSchema = z.object(Object.fromEntries(Object.keys(executionLimitsDefaults).map((key) => {
+	const defaultValue = executionLimitsDefaults[key];
+	const envKey = `AGENTS_${key}`;
+	if (typeof defaultValue === "boolean") return [envKey, z.coerce.boolean().optional()];
+	else return [envKey, z.coerce.number().optional()];
+})));
+const parseConstants = () => {
+	const envOverrides = constantsSchema.parse(process.env);
+	return Object.fromEntries(Object.entries(executionLimitsDefaults).map(([key, defaultValue]) => [key, envOverrides[`AGENTS_${key}`] ?? defaultValue]));
+};
+const constants = parseConstants();
+const { AGENT_EXECUTION_MAX_CONSECUTIVE_ERRORS, AGENT_EXECUTION_MAX_GENERATION_STEPS, LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_STREAMING, LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_NON_STREAMING, LLM_GENERATION_SUBSEQUENT_CALL_TIMEOUT_MS, LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS, FUNCTION_TOOL_EXECUTION_TIMEOUT_MS_DEFAULT, FUNCTION_TOOL_SANDBOX_VCPUS_DEFAULT, FUNCTION_TOOL_SANDBOX_POOL_TTL_MS, FUNCTION_TOOL_SANDBOX_MAX_USE_COUNT, FUNCTION_TOOL_SANDBOX_MAX_OUTPUT_SIZE_BYTES, FUNCTION_TOOL_SANDBOX_QUEUE_WAIT_TIMEOUT_MS, FUNCTION_TOOL_SANDBOX_CLEANUP_INTERVAL_MS, MCP_TOOL_REQUEST_TIMEOUT_MS_DEFAULT, DELEGATION_TOOL_BACKOFF_INITIAL_INTERVAL_MS, DELEGATION_TOOL_BACKOFF_MAX_INTERVAL_MS, DELEGATION_TOOL_BACKOFF_EXPONENT, DELEGATION_TOOL_BACKOFF_MAX_ELAPSED_TIME_MS, A2A_BACKOFF_INITIAL_INTERVAL_MS, A2A_BACKOFF_MAX_INTERVAL_MS, A2A_BACKOFF_EXPONENT, A2A_BACKOFF_MAX_ELAPSED_TIME_MS, ARTIFACT_GENERATION_MAX_RETRIES, ARTIFACT_SESSION_MAX_PENDING, ARTIFACT_SESSION_MAX_PREVIOUS_SUMMARIES, ARTIFACT_GENERATION_BACKOFF_INITIAL_MS, ARTIFACT_GENERATION_BACKOFF_MAX_MS, SESSION_TOOL_RESULT_CACHE_TIMEOUT_MS, SESSION_CLEANUP_INTERVAL_MS, STATUS_UPDATE_DEFAULT_NUM_EVENTS, STATUS_UPDATE_DEFAULT_INTERVAL_SECONDS, STREAM_PARSER_MAX_SNAPSHOT_SIZE, STREAM_PARSER_MAX_STREAMED_SIZE, STREAM_PARSER_MAX_COLLECTED_PARTS, STREAM_BUFFER_MAX_SIZE_BYTES, STREAM_TEXT_GAP_THRESHOLD_MS, STREAM_MAX_LIFETIME_MS, CONVERSATION_HISTORY_DEFAULT_LIMIT, CONVERSATION_ARTIFACTS_LIMIT, COMPRESSION_HARD_LIMIT, COMPRESSION_SAFETY_BUFFER, COMPRESSION_ENABLED } = constants;
+
+//#endregion
+export { A2A_BACKOFF_EXPONENT, A2A_BACKOFF_INITIAL_INTERVAL_MS, A2A_BACKOFF_MAX_ELAPSED_TIME_MS, A2A_BACKOFF_MAX_INTERVAL_MS, AGENT_EXECUTION_MAX_CONSECUTIVE_ERRORS, AGENT_EXECUTION_MAX_GENERATION_STEPS, ARTIFACT_GENERATION_BACKOFF_INITIAL_MS, ARTIFACT_GENERATION_BACKOFF_MAX_MS, ARTIFACT_GENERATION_MAX_RETRIES, ARTIFACT_SESSION_MAX_PENDING, ARTIFACT_SESSION_MAX_PREVIOUS_SUMMARIES, COMPRESSION_ENABLED, COMPRESSION_HARD_LIMIT, COMPRESSION_SAFETY_BUFFER, CONVERSATION_ARTIFACTS_LIMIT, CONVERSATION_HISTORY_DEFAULT_LIMIT, DELEGATION_TOOL_BACKOFF_EXPONENT, DELEGATION_TOOL_BACKOFF_INITIAL_INTERVAL_MS, DELEGATION_TOOL_BACKOFF_MAX_ELAPSED_TIME_MS, DELEGATION_TOOL_BACKOFF_MAX_INTERVAL_MS, FUNCTION_TOOL_EXECUTION_TIMEOUT_MS_DEFAULT, FUNCTION_TOOL_SANDBOX_CLEANUP_INTERVAL_MS, FUNCTION_TOOL_SANDBOX_MAX_OUTPUT_SIZE_BYTES, FUNCTION_TOOL_SANDBOX_MAX_USE_COUNT, FUNCTION_TOOL_SANDBOX_POOL_TTL_MS, FUNCTION_TOOL_SANDBOX_QUEUE_WAIT_TIMEOUT_MS, FUNCTION_TOOL_SANDBOX_VCPUS_DEFAULT, LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_NON_STREAMING, LLM_GENERATION_FIRST_CALL_TIMEOUT_MS_STREAMING, LLM_GENERATION_MAX_ALLOWED_TIMEOUT_MS, LLM_GENERATION_SUBSEQUENT_CALL_TIMEOUT_MS, MCP_TOOL_REQUEST_TIMEOUT_MS_DEFAULT, SESSION_CLEANUP_INTERVAL_MS, SESSION_TOOL_RESULT_CACHE_TIMEOUT_MS, STATUS_UPDATE_DEFAULT_INTERVAL_SECONDS, STATUS_UPDATE_DEFAULT_NUM_EVENTS, STREAM_BUFFER_MAX_SIZE_BYTES, STREAM_MAX_LIFETIME_MS, STREAM_PARSER_MAX_COLLECTED_PARTS, STREAM_PARSER_MAX_SNAPSHOT_SIZE, STREAM_PARSER_MAX_STREAMED_SIZE, STREAM_TEXT_GAP_THRESHOLD_MS, executionLimitsDefaults };

package/dist/create-app.d.ts

@@ -0,0 +1,9 @@
+import { SandboxConfig } from "./types/execution-context.js";
+import { CredentialStoreRegistry, ServerConfig } from "@inkeep/agents-core";
+import { Hono } from "hono";
+import * as hono_types0 from "hono/types";
+
+//#region src/create-app.d.ts
+declare function createExecutionHono(serverConfig: ServerConfig, credentialStores: CredentialStoreRegistry, sandboxConfig?: SandboxConfig): Hono<hono_types0.BlankEnv, hono_types0.BlankSchema, "/">;
+//#endregion
+export { createExecutionHono };