@inkeep/agents-sdk 0.0.0-dev-20250912172534 → 0.0.0-dev-20250912184011

package/dist/index.js

@@ -1960,10 +1960,10 @@ var AgentGraph = class {
    */
   async getProjectModelDefaults() {
     try {
-      const project = await getProject(this.dbClient)({
+      const project2 = await getProject(this.dbClient)({
         scopes: { tenantId: this.tenantId, projectId: this.projectId }
       });
-      return project?.models;
+      return project2?.models;
     } catch (error) {
       logger7.warn(
         {
@@ -1981,10 +1981,10 @@ var AgentGraph = class {
    */
   async getProjectStopWhenDefaults() {
     try {
-      const project = await getProject(this.dbClient)({
+      const project2 = await getProject(this.dbClient)({
         scopes: { tenantId: this.tenantId, projectId: this.projectId }
       });
-      return project?.stopWhen;
+      return project2?.stopWhen;
     } catch (error) {
       logger7.warn(
         {
@@ -2481,6 +2481,511 @@ var AgentGraph = class {
     }
   }
 };
+var logger8 = getLogger("projectFullClient");
+async function createFullProjectViaAPI(tenantId, apiUrl, projectData) {
+  logger8.info(
+    {
+      tenantId,
+      projectId: projectData.id,
+      apiUrl
+    },
+    "Creating full project via API"
+  );
+  const url = `${apiUrl}/tenants/${tenantId}/project-full`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(projectData)
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    let errorMessage = `Failed to create project: ${response.status} ${response.statusText}`;
+    try {
+      const errorJson = JSON.parse(errorText);
+      if (errorJson.error) {
+        errorMessage = errorJson.error;
+      }
+    } catch {
+      if (errorText) {
+        errorMessage = errorText;
+      }
+    }
+    logger8.error(
+      {
+        status: response.status,
+        error: errorMessage
+      },
+      "Failed to create project via API"
+    );
+    throw new Error(errorMessage);
+  }
+  const result = await response.json();
+  logger8.info(
+    {
+      projectId: projectData.id
+    },
+    "Successfully created project via API"
+  );
+  return result.data;
+}
+async function updateFullProjectViaAPI(tenantId, apiUrl, projectId, projectData) {
+  logger8.info(
+    {
+      tenantId,
+      projectId,
+      apiUrl
+    },
+    "Updating full project via API"
+  );
+  const url = `${apiUrl}/tenants/${tenantId}/project-full/${projectId}`;
+  const response = await fetch(url, {
+    method: "PUT",
+    headers: {
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(projectData)
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    let errorMessage = `Failed to update project: ${response.status} ${response.statusText}`;
+    try {
+      const errorJson = JSON.parse(errorText);
+      if (errorJson.error) {
+        errorMessage = errorJson.error;
+      }
+    } catch {
+      if (errorText) {
+        errorMessage = errorText;
+      }
+    }
+    logger8.error(
+      {
+        status: response.status,
+        error: errorMessage
+      },
+      "Failed to update project via API"
+    );
+    throw new Error(errorMessage);
+  }
+  const result = await response.json();
+  logger8.info(
+    {
+      projectId
+    },
+    "Successfully updated project via API"
+  );
+  return result.data;
+}
+async function getFullProjectViaAPI(tenantId, apiUrl, projectId) {
+  logger8.info(
+    {
+      tenantId,
+      projectId,
+      apiUrl
+    },
+    "Getting full project via API"
+  );
+  const url = `${apiUrl}/tenants/${tenantId}/project-full/${projectId}`;
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      "Content-Type": "application/json"
+    }
+  });
+  if (!response.ok) {
+    if (response.status === 404) {
+      logger8.info(
+        {
+          projectId
+        },
+        "Project not found"
+      );
+      return null;
+    }
+    const errorText = await response.text();
+    let errorMessage = `Failed to get project: ${response.status} ${response.statusText}`;
+    try {
+      const errorJson = JSON.parse(errorText);
+      if (errorJson.error) {
+        errorMessage = errorJson.error;
+      }
+    } catch {
+      if (errorText) {
+        errorMessage = errorText;
+      }
+    }
+    logger8.error(
+      {
+        status: response.status,
+        error: errorMessage
+      },
+      "Failed to get project via API"
+    );
+    throw new Error(errorMessage);
+  }
+  const result = await response.json();
+  logger8.info(
+    {
+      projectId
+    },
+    "Successfully retrieved project via API"
+  );
+  return result.data;
+}
+async function deleteFullProjectViaAPI(tenantId, apiUrl, projectId) {
+  logger8.info(
+    {
+      tenantId,
+      projectId,
+      apiUrl
+    },
+    "Deleting full project via API"
+  );
+  const url = `${apiUrl}/tenants/${tenantId}/project-full/${projectId}`;
+  const response = await fetch(url, {
+    method: "DELETE",
+    headers: {
+      "Content-Type": "application/json"
+    }
+  });
+  if (!response.ok) {
+    const errorText = await response.text();
+    let errorMessage = `Failed to delete project: ${response.status} ${response.statusText}`;
+    try {
+      const errorJson = JSON.parse(errorText);
+      if (errorJson.error) {
+        errorMessage = errorJson.error;
+      }
+    } catch {
+      if (errorText) {
+        errorMessage = errorText;
+      }
+    }
+    logger8.error(
+      {
+        status: response.status,
+        error: errorMessage
+      },
+      "Failed to delete project via API"
+    );
+    throw new Error(errorMessage);
+  }
+  logger8.info(
+    {
+      projectId
+    },
+    "Successfully deleted project via API"
+  );
+}
+
+// src/project.ts
+var logger9 = getLogger("project");
+var Project = class {
+  constructor(config) {
+    __publicField(this, "projectId");
+    __publicField(this, "projectName");
+    __publicField(this, "projectDescription");
+    __publicField(this, "tenantId");
+    __publicField(this, "baseURL");
+    __publicField(this, "initialized", false);
+    __publicField(this, "models");
+    __publicField(this, "stopWhen");
+    __publicField(this, "graphs", []);
+    __publicField(this, "graphMap", /* @__PURE__ */ new Map());
+    this.projectId = config.id;
+    this.projectName = config.name;
+    this.projectDescription = config.description;
+    this.tenantId = config.tenantId || "default";
+    this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
+    this.models = config.models;
+    this.stopWhen = config.stopWhen;
+    if (config.graphs) {
+      this.graphs = config.graphs();
+      this.graphMap = new Map(this.graphs.map((graph) => [graph.getId(), graph]));
+      for (const graph of this.graphs) {
+        graph.setConfig(this.tenantId, this.projectId, this.baseURL);
+      }
+    }
+    logger9.info(
+      {
+        projectId: this.projectId,
+        tenantId: this.tenantId,
+        graphCount: this.graphs.length
+      },
+      "Project created"
+    );
+  }
+  /**
+   * Set or update the configuration (tenantId and apiUrl)
+   * This is used by the CLI to inject configuration from inkeep.config.ts
+   */
+  setConfig(tenantId, apiUrl) {
+    if (this.initialized) {
+      throw new Error("Cannot set config after project has been initialized");
+    }
+    this.tenantId = tenantId;
+    this.baseURL = apiUrl;
+    for (const graph of this.graphs) {
+      graph.setConfig(tenantId, this.projectId, apiUrl);
+    }
+    logger9.info(
+      {
+        projectId: this.projectId,
+        tenantId: this.tenantId,
+        apiUrl: this.baseURL
+      },
+      "Project configuration updated"
+    );
+  }
+  /**
+   * Initialize the project and create/update it in the backend using full project approach
+   */
+  async init() {
+    if (this.initialized) {
+      logger9.info({ projectId: this.projectId }, "Project already initialized");
+      return;
+    }
+    logger9.info(
+      {
+        projectId: this.projectId,
+        tenantId: this.tenantId,
+        graphCount: this.graphs.length
+      },
+      "Initializing project using full project endpoint"
+    );
+    try {
+      const initPromises = this.graphs.map(async (graph) => {
+        try {
+          await graph.init();
+          logger9.debug(
+            {
+              projectId: this.projectId,
+              graphId: graph.getId()
+            },
+            "Graph initialized in project"
+          );
+        } catch (error) {
+          logger9.error(
+            {
+              projectId: this.projectId,
+              graphId: graph.getId(),
+              error: error instanceof Error ? error.message : "Unknown error"
+            },
+            "Failed to initialize graph in project"
+          );
+          throw error;
+        }
+      });
+      await Promise.all(initPromises);
+      const projectDefinition = await this.toFullProjectDefinition();
+      logger9.info(
+        {
+          projectId: this.projectId,
+          mode: "api-client",
+          apiUrl: this.baseURL
+        },
+        "Using API client to create/update full project"
+      );
+      const createdProject = await updateFullProjectViaAPI(
+        this.tenantId,
+        this.baseURL,
+        this.projectId,
+        projectDefinition
+      );
+      this.initialized = true;
+      logger9.info(
+        {
+          projectId: this.projectId,
+          tenantId: this.tenantId,
+          graphCount: Object.keys(createdProject.graphs || {}).length
+        },
+        "Project initialized successfully using full project endpoint"
+      );
+    } catch (error) {
+      logger9.error(
+        {
+          projectId: this.projectId,
+          error: error instanceof Error ? error.message : "Unknown error"
+        },
+        "Failed to initialize project using full project endpoint"
+      );
+      throw error;
+    }
+  }
+  /**
+   * Get the project ID
+   */
+  getId() {
+    return this.projectId;
+  }
+  /**
+   * Get the project name
+   */
+  getName() {
+    return this.projectName;
+  }
+  /**
+   * Get the project description
+   */
+  getDescription() {
+    return this.projectDescription;
+  }
+  /**
+   * Get the tenant ID
+   */
+  getTenantId() {
+    return this.tenantId;
+  }
+  /**
+   * Get the project's model configuration
+   */
+  getModels() {
+    return this.models;
+  }
+  /**
+   * Set the project's model configuration
+   */
+  setModels(models) {
+    this.models = models;
+  }
+  /**
+   * Get the project's stopWhen configuration
+   */
+  getStopWhen() {
+    return this.stopWhen;
+  }
+  /**
+   * Set the project's stopWhen configuration
+   */
+  setStopWhen(stopWhen) {
+    this.stopWhen = stopWhen;
+  }
+  /**
+   * Get all graphs in the project
+   */
+  getGraphs() {
+    return this.graphs;
+  }
+  /**
+   * Get a graph by ID
+   */
+  getGraph(id) {
+    return this.graphMap.get(id);
+  }
+  /**
+   * Add a graph to the project
+   */
+  addGraph(graph) {
+    this.graphs.push(graph);
+    this.graphMap.set(graph.getId(), graph);
+    graph.setConfig(this.tenantId, this.projectId, this.baseURL);
+    logger9.info(
+      {
+        projectId: this.projectId,
+        graphId: graph.getId()
+      },
+      "Graph added to project"
+    );
+  }
+  /**
+   * Remove a graph from the project
+   */
+  removeGraph(id) {
+    const graphToRemove = this.graphMap.get(id);
+    if (graphToRemove) {
+      this.graphMap.delete(id);
+      this.graphs = this.graphs.filter((graph) => graph.getId() !== id);
+      logger9.info(
+        {
+          projectId: this.projectId,
+          graphId: id
+        },
+        "Graph removed from project"
+      );
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Get project statistics
+   */
+  getStats() {
+    return {
+      projectId: this.projectId,
+      tenantId: this.tenantId,
+      graphCount: this.graphs.length,
+      initialized: this.initialized
+    };
+  }
+  /**
+   * Validate the project configuration
+   */
+  validate() {
+    const errors = [];
+    if (!this.projectId) {
+      errors.push("Project must have an ID");
+    }
+    if (!this.projectName) {
+      errors.push("Project must have a name");
+    }
+    const graphIds = /* @__PURE__ */ new Set();
+    for (const graph of this.graphs) {
+      const id = graph.getId();
+      if (graphIds.has(id)) {
+        errors.push(`Duplicate graph ID: ${id}`);
+      }
+      graphIds.add(id);
+    }
+    for (const graph of this.graphs) {
+      const graphValidation = graph.validate();
+      if (!graphValidation.valid) {
+        errors.push(...graphValidation.errors.map((error) => `Graph '${graph.getId()}': ${error}`));
+      }
+    }
+    return {
+      valid: errors.length === 0,
+      errors
+    };
+  }
+  /**
+   * Convert the Project to FullProjectDefinition format
+   */
+  async toFullProjectDefinition() {
+    const graphsObject = {};
+    for (const graph of this.graphs) {
+      const graphDefinition = await graph.toFullGraphDefinition();
+      graphsObject[graph.getId()] = graphDefinition;
+    }
+    return {
+      id: this.projectId,
+      name: this.projectName,
+      description: this.projectDescription || "",
+      models: this.models,
+      stopWhen: this.stopWhen,
+      graphs: graphsObject,
+      tools: {},
+      // Empty tools object as SDK doesn't manage tools directly yet
+      credentialReferences: void 0,
+      // Projects don't directly hold credentials yet
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+  /**
+   * Convert project configuration to API format
+   */
+  toApiFormat() {
+    return {
+      id: this.projectId,
+      name: this.projectName,
+      description: this.projectDescription || "",
+      models: this.models,
+      stopWhen: this.stopWhen
+    };
+  }
+};
 
 // src/utils/generateIdFromName.ts
 function generateIdFromName3(name) {
@@ -2491,6 +2996,9 @@ function generateIdFromName3(name) {
 function agentGraph(config) {
   return new AgentGraph(config);
 }
+function project(config) {
+  return new Project(config);
+}
 function agent(config) {
   if (!config.id) {
     throw new Error(
@@ -2619,7 +3127,7 @@ var MaxTurnsExceededError = class extends AgentError {
 };
 
 // src/runner.ts
-var logger8 = getLogger("runner");
+var logger10 = getLogger("runner");
 var Runner = class _Runner {
   /**
    * Run a graph until completion, handling transfers and tool calls
@@ -2631,7 +3139,7 @@ var Runner = class _Runner {
     let turnCount = 0;
     const messageHistory = _Runner.normalizeToMessageHistory(messages);
     const allToolCalls = [];
-    logger8.info(
+    logger10.info(
       {
         graphId: graph.getId(),
         defaultAgent: graph.getDefaultAgent()?.getName(),
@@ -2641,7 +3149,7 @@ var Runner = class _Runner {
       "Starting graph run"
     );
     while (turnCount < maxTurns) {
-      logger8.debug(
+      logger10.debug(
         {
           graphId: graph.getId(),
           turnCount,
@@ -2651,7 +3159,7 @@ var Runner = class _Runner {
       );
       const response = await graph.generate(messageHistory, options);
       turnCount++;
-      logger8.info(
+      logger10.info(
         {
           graphId: graph.getId(),
           turnCount,
@@ -2671,7 +3179,7 @@ var Runner = class _Runner {
         }
       };
     }
-    logger8.error(
+    logger10.error(
       {
         graphId: graph.getId(),
         maxTurns,
@@ -2685,7 +3193,7 @@ var Runner = class _Runner {
    * Stream a graph's response
    */
   static async stream(graph, messages, options) {
-    logger8.info(
+    logger10.info(
       {
         graphId: graph.getId(),
         defaultAgent: graph.getDefaultAgent()?.getName()
@@ -2701,7 +3209,7 @@ var Runner = class _Runner {
     if (graphs.length === 0) {
       throw new Error("No graphs provided for race");
     }
-    logger8.info(
+    logger10.info(
       {
         graphCount: graphs.length,
         graphIds: graphs.map((g) => g.getId())
@@ -2713,7 +3221,7 @@ var Runner = class _Runner {
         const result2 = await _Runner.run(graph, messages, options);
         return { ...result2, raceIndex: index };
       } catch (error) {
-        logger8.error(
+        logger10.error(
           {
             graphId: graph.getId(),
             error: error instanceof Error ? error.message : "Unknown error"
@@ -2724,7 +3232,7 @@ var Runner = class _Runner {
       }
     });
     const result = await Promise.race(promises);
-    logger8.info(
+    logger10.info(
       {
         winningGraphId: result.graphId || "unknown",
         raceIndex: result.raceIndex
@@ -2798,4 +3306,4 @@ var run = Runner.run.bind(Runner);
 var stream = Runner.stream.bind(Runner);
 var raceGraphs = Runner.raceGraphs.bind(Runner);
 
-export { Agent, ArtifactComponent, DataComponent, ExternalAgent, Runner, Tool, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, credential, dataComponent, externalAgent, externalAgents, mcpServer, mcpTool, raceGraphs, registerEnvironmentSettings, run, stream, transfer };
+export { Agent, ArtifactComponent, DataComponent, ExternalAgent, Project, Runner, Tool, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-sdk",
-  "version": "0.0.0-dev-20250912172534",
+  "version": "0.0.0-dev-20250912184011",
   "description": "Agents SDK for building and managing agents in the Inkeep Agent Framework",
   "main": "dist/index.js",
   "type": "module",
@@ -8,7 +8,7 @@
   "dependencies": {
     "nanoid": "^5.1.5",
     "zod": "^4.1.5",
-    "@inkeep/agents-core": "^0.0.0-dev-20250912172534"
+    "@inkeep/agents-core": "^0.0.0-dev-20250912184011"
   },
   "devDependencies": {
     "@types/node": "^20.11.24",