@inkeep/agents-core 0.1.4 → 0.1.7

package/README.md

@@ -170,14 +170,14 @@ Tests use in-memory SQLite databases for isolation and speed.
 
 This package is designed to support a multi-service architecture:
 
-### Management API
+### Agents Manage API
 Handles CRUD operations and entity management:
 - Creating/updating agents
 - Managing agent relationships
 - Configuring tools
 - Database migrations
 
-### Execution API
+### Agents Run API
 Handles runtime operations:
 - Processing conversations
 - Executing tasks

package/SUPPLEMENTAL_TERMS.md

@@ -0,0 +1,40 @@
+<!--
+AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY
+Source: ./SUPPLEMENTAL_TERMS.md
+This file is automatically copied from the root SUPPLEMENTAL_TERMS.md during build.
+Any changes should be made to the root SUPPLEMENTAL_TERMS.md file.
+-->
+
+# Inkeep SDK – Elastic License 2.0 with Supplemental Terms
+
+The Inkeep [SDK] (the "Software") is licensed under the Elastic License 2.0 ("ELv2"), available at [https://www.elastic.co/licensing/elastic-license](https://www.elastic.co/licensing/elastic-license), subject to the supplemental terms below. By using the Software, you, your company, and your licensees agree to both ELv2 and these Supplemental Terms – for purposes of these Supplemental Terms, references to "you" have the same meaning as in ELv2 and include your company and contractors acting on your behalf. In the event of conflict, these Supplemental Terms control.
+
+Any copy or redistribution of the Software must include both the ELv2 license reference and these Supplemental Terms.
+
+## 1. Restrictions
+
+### 1.1
+You may not use the Software, directly or indirectly, to offer, enable, operate, or provide any Agent Builder.
+
+### 1.2
+You may not repackage, rebrand, or otherwise expose the Software's agent-creation or orchestration functionality for third-party use, including in specialized or verticalized offerings that present substantially similar functionality to the Software.
+
+### 1.3
+For clarity, the foregoing restrictions do not prohibit your use of the Software as Embedded Assistants or Professional Services, provided neither allow third parties to create, configure, train, orchestrate, deploy, or manage their own agents or agent workflows.
+
+## 2. Definitions
+
+### 2.1 Inkeep
+**"Inkeep"** means Inkeep, Inc., a Delaware corporation with principal offices at 169 Madison Ave, Ste 2544, New York, NY, 10016, the licensor (as defined in ELv2) of the Software.
+
+### 2.2 Agent Builder
+**"Agent Builder"** means any hosted or on-premise product, platform, UI or API that allows third parties (e.g., customers, developers, or community users other than your personnel) to create, configure, compose, train, orchestrate, deploy, or manage their own Agents using the Software, or that otherwise exposes a substantial set of the Agent-creation and orchestration functionality of the Software.
+
+### 2.3 Agents
+**"Agents"** means autonomous, semi-autonomous, or automated systems — including assistants, copilots, workflows, orchestrations, or other systems powered by or incorporating artificial intelligence, machine learning, large language models, or related technologies.
+
+### 2.4 Embedded Assistant
+**"Embedded Assistant"** means embedding the Software in your own products or services to power a specific assistant/copilot/agent experience for you or your end users (e.g., a support bot in your app or an internal helpdesk agent), where end users do not receive access to any substantial set of the Software's agent-creation or orchestration features.
+
+### 2.5 Professional Services
+**"Professional Services"** means using the Software to deliver a bespoke solution to a single client where only your personnel operate the Software, the client receives access solely to the resulting assistant within the client's environment and not to the agent-creation/orchestration features of the Software, and no multi-tenant or self-service builder is provided.

package/dist/chunk-BMKWVKI2.js

@@ -0,0 +1,126 @@
+import { FullGraphDefinitionSchema, resourceIdSchema, MAX_ID_LENGTH } from './chunk-R3VVJXX7.js';
+
+// src/validation/graphFull.ts
+function isInternalAgent(agent) {
+  return "prompt" in agent;
+}
+function isExternalAgent(agent) {
+  return "baseUrl" in agent;
+}
+function validateAndTypeGraphData(data) {
+  return FullGraphDefinitionSchema.parse(data);
+}
+function validateToolReferences(graphData) {
+  const errors = [];
+  const availableToolIds = new Set(Object.keys(graphData.tools || {}));
+  for (const [agentId, agentData] of Object.entries(graphData.agents)) {
+    if (isInternalAgent(agentData) && agentData.tools && Array.isArray(agentData.tools)) {
+      for (const toolId of agentData.tools) {
+        if (!availableToolIds.has(toolId)) {
+          errors.push(`Agent '${agentId}' references non-existent tool '${toolId}'`);
+        }
+      }
+    }
+  }
+  if (errors.length > 0) {
+    throw new Error(`Tool reference validation failed:
+${errors.join("\n")}`);
+  }
+}
+function validateDataComponentReferences(graphData) {
+  const errors = [];
+  const availableDataComponentIds = new Set(Object.keys(graphData.dataComponents || {}));
+  for (const [agentId, agentData] of Object.entries(graphData.agents)) {
+    if (isInternalAgent(agentData) && agentData.dataComponents) {
+      for (const dataComponentId of agentData.dataComponents) {
+        if (!availableDataComponentIds.has(dataComponentId)) {
+          errors.push(
+            `Agent '${agentId}' references non-existent dataComponent '${dataComponentId}'`
+          );
+        }
+      }
+    }
+  }
+  if (errors.length > 0) {
+    throw new Error(`DataComponent reference validation failed:
+${errors.join("\n")}`);
+  }
+}
+function validateArtifactComponentReferences(graphData) {
+  const errors = [];
+  const availableArtifactComponentIds = new Set(Object.keys(graphData.artifactComponents || {}));
+  for (const [agentId, agentData] of Object.entries(graphData.agents)) {
+    if (isInternalAgent(agentData) && agentData.artifactComponents) {
+      for (const artifactComponentId of agentData.artifactComponents) {
+        if (!availableArtifactComponentIds.has(artifactComponentId)) {
+          errors.push(
+            `Agent '${agentId}' 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.agents));
+  for (const [agentId, agentData] of Object.entries(graphData.agents)) {
+    if (isInternalAgent(agentData)) {
+      if (agentData.canTransferTo && Array.isArray(agentData.canTransferTo)) {
+        for (const targetId of agentData.canTransferTo) {
+          if (!availableAgentIds.has(targetId)) {
+            errors.push(
+              `Agent '${agentId}' 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 '${agentId}' 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) {
+  if (!graphData.agents[graphData.defaultAgentId]) {
+    throw new Error(`Default agent '${graphData.defaultAgentId}' does not exist in agents`);
+  }
+  validateToolReferences(graphData);
+  validateDataComponentReferences(graphData);
+  validateArtifactComponentReferences(graphData);
+  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 { generateIdFromName, isExternalAgent, isInternalAgent, isValidResourceId, validateAgentRelationships, validateAndTypeGraphData, validateArtifactComponentReferences, validateDataComponentReferences, validateGraphStructure, validateToolReferences };

package/dist/chunk-H2F72PDA.js

@@ -0,0 +1,15 @@
+// src/types/a2a.ts
+var TaskState = /* @__PURE__ */ ((TaskState2) => {
+  TaskState2["Submitted"] = "submitted";
+  TaskState2["Working"] = "working";
+  TaskState2["InputRequired"] = "input-required";
+  TaskState2["Completed"] = "completed";
+  TaskState2["Canceled"] = "canceled";
+  TaskState2["Failed"] = "failed";
+  TaskState2["Rejected"] = "rejected";
+  TaskState2["AuthRequired"] = "auth-required";
+  TaskState2["Unknown"] = "unknown";
+  return TaskState2;
+})(TaskState || {});
+
+export { TaskState };

package/dist/chunk-MKBO26DX.js

@@ -0,0 +1,9 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+export { __export, __publicField };