@inkeep/agents-sdk 0.0.0-dev-20250911210702 → 0.0.0-dev-20250911221549

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/index.cjs

@@ -970,84 +970,6 @@ var Agent = class {
     }
   }
 };
-var TransferConfigSchema = zod.z.object({
-  agent: zod.z.instanceof(Agent),
-  description: zod.z.string().optional()
-});
-function validateFunction(value, name) {
-  if (typeof value !== "function") {
-    throw new Error(`${name} must be a function`);
-  }
-}
-function agent(config) {
-  if (!config.id) {
-    throw new Error(
-      "Agent ID is required. Agents must have stable IDs for consistency across deployments."
-    );
-  }
-  return new Agent(config);
-}
-function mcpTool(config) {
-  const validatedConfig = agentsCore.MCPToolConfigSchema.parse(config);
-  return new Tool(validatedConfig);
-}
-function credential(config) {
-  return agentsCore.CredentialReferenceApiInsertSchema.parse(config);
-}
-function transfer(targetAgent, description, condition) {
-  if (condition !== void 0) {
-    validateFunction(condition, "condition");
-  }
-  const config = {
-    agent: targetAgent,
-    description: description || `Hand off to ${targetAgent.getName()}`,
-    condition
-  };
-  TransferConfigSchema.parse({
-    agent: config.agent,
-    description: config.description
-  });
-  return config;
-}
-function artifactComponent(config) {
-  return new ArtifactComponent({
-    ...config,
-    tenantId: config.tenantId || "default",
-    projectId: config.projectId || "default"
-  });
-}
-function dataComponent(config) {
-  return new DataComponent({
-    ...config,
-    tenantId: config.tenantId || "default",
-    projectId: config.projectId || "default"
-  });
-}
-
-// src/environment-settings.ts
-function createEnvironmentSettings(environments) {
-  return {
-    getEnvironmentSetting: async (key) => {
-      const currentEnv = process.env.INKEEP_ENV || "development";
-      const env = environments[currentEnv];
-      if (!env) {
-        throw new Error(
-          `Environment '${currentEnv}' not found. Available: ${Object.keys(environments).join(", ")}`
-        );
-      }
-      const credential2 = env.credentials?.[key];
-      if (!credential2) {
-        throw new Error(
-          `Credential '${String(key)}' not found in environment '${currentEnv}'`
-        );
-      }
-      return credential2;
-    }
-  };
-}
-function registerEnvironmentSettings(config) {
-  return config;
-}
 var logger5 = agentsCore.getLogger("external-agent-builder");
 var ExternalAgent = class {
   constructor(config) {
@@ -2595,35 +2517,125 @@ var AgentGraph = class {
     }
   }
 };
+
+// src/utils/generateIdFromName.ts
+function generateIdFromName3(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+
+// src/builderFunctions.ts
 function agentGraph(config) {
   return new AgentGraph(config);
 }
-async function generateGraph(configPath) {
-  logger7.info({ configPath }, "Loading graph configuration");
-  try {
-    const config = await import(configPath);
-    const graphConfig = config.default || config;
-    const graph = agentGraph(graphConfig);
-    await graph.init();
-    logger7.info(
-      {
-        configPath,
-        graphId: graph.getStats().graphId,
-        agentCount: graph.getStats().agentCount
-      },
-      "Graph generated successfully"
-    );
-    return graph;
-  } catch (error) {
-    logger7.error(
-      {
-        configPath,
-        error: error instanceof Error ? error.message : "Unknown error"
-      },
-      "Failed to generate graph from configuration"
+function agent(config) {
+  if (!config.id) {
+    throw new Error(
+      "Agent ID is required. Agents must have stable IDs for consistency across deployments."
     );
-    throw error;
   }
+  return new Agent(config);
+}
+function credential(config) {
+  return agentsCore.CredentialReferenceApiInsertSchema.parse(config);
+}
+function mcpServer(config) {
+  if (!config.serverUrl) {
+    throw new Error("MCP server requires a serverUrl");
+  }
+  const id = config.id || generateIdFromName3(config.name);
+  return new Tool({
+    id,
+    name: config.name,
+    description: config.description,
+    serverUrl: config.serverUrl,
+    tenantId: config.tenantId,
+    credential: config.credential,
+    activeTools: config.activeTools,
+    headers: config.headers,
+    imageUrl: config.imageUrl,
+    transport: config.transport ? { type: config.transport } : void 0
+  });
+}
+function mcpTool(config) {
+  const configWithId = {
+    ...config,
+    id: config.id || generateIdFromName3(config.name)
+  };
+  const validatedConfig = agentsCore.MCPToolConfigSchema.parse(configWithId);
+  return new Tool(validatedConfig);
+}
+function artifactComponent(config) {
+  return new ArtifactComponent({
+    ...config,
+    tenantId: config.tenantId || "default",
+    projectId: config.projectId || "default"
+  });
+}
+function dataComponent(config) {
+  return new DataComponent({
+    ...config,
+    tenantId: config.tenantId || "default",
+    projectId: config.projectId || "default"
+  });
+}
+function agentMcp(config) {
+  return {
+    server: config.server,
+    selectedTools: config.selectedTools
+  };
+}
+
+// src/utils/validateFunction.ts
+function validateFunction(value, name) {
+  if (typeof value !== "function") {
+    throw new Error(`${name} must be a function`);
+  }
+}
+
+// src/builders.ts
+var TransferConfigSchema = zod.z.object({
+  agent: zod.z.instanceof(Agent),
+  description: zod.z.string().optional()
+});
+function transfer(targetAgent, description, condition) {
+  if (condition !== void 0) {
+    validateFunction(condition, "condition");
+  }
+  const config = {
+    agent: targetAgent,
+    description: description || `Hand off to ${targetAgent.getName()}`,
+    condition
+  };
+  TransferConfigSchema.parse({
+    agent: config.agent,
+    description: config.description
+  });
+  return config;
+}
+
+// src/environment-settings.ts
+function createEnvironmentSettings(environments) {
+  return {
+    getEnvironmentSetting: async (key) => {
+      const currentEnv = process.env.INKEEP_ENV || "development";
+      const env = environments[currentEnv];
+      if (!env) {
+        throw new Error(
+          `Environment '${currentEnv}' not found. Available: ${Object.keys(environments).join(", ")}`
+        );
+      }
+      const credential2 = env.credentials?.[key];
+      if (!credential2) {
+        throw new Error(
+          `Credential '${String(key)}' not found in environment '${currentEnv}'`
+        );
+      }
+      return credential2;
+    }
+  };
+}
+function registerEnvironmentSettings(config) {
+  return config;
 }
 zod.z.object({
   model: zod.z.string().optional(),
@@ -2828,7 +2840,6 @@ var stream = Runner.stream.bind(Runner);
 var raceGraphs = Runner.raceGraphs.bind(Runner);
 
 exports.Agent = Agent;
-exports.AgentGraph = AgentGraph;
 exports.ArtifactComponent = ArtifactComponent;
 exports.DataComponent = DataComponent;
 exports.ExternalAgent = ExternalAgent;
@@ -2836,13 +2847,14 @@ exports.Runner = Runner;
 exports.Tool = Tool;
 exports.agent = agent;
 exports.agentGraph = agentGraph;
+exports.agentMcp = agentMcp;
 exports.artifactComponent = artifactComponent;
 exports.createEnvironmentSettings = createEnvironmentSettings;
 exports.credential = credential;
 exports.dataComponent = dataComponent;
 exports.externalAgent = externalAgent;
 exports.externalAgents = externalAgents;
-exports.generateGraph = generateGraph;
+exports.mcpServer = mcpServer;
 exports.mcpTool = mcpTool;
 exports.raceGraphs = raceGraphs;
 exports.registerEnvironmentSettings = registerEnvironmentSettings;