@inkeep/agents-sdk 0.1.10 → 0.2.1

package/dist/index.cjs

@@ -459,7 +459,12 @@ var Agent = class {
   getInstructions() {
     return this.config.prompt;
   }
-  // adjust
+  /**
+   * Get the agent's description (the human-readable description field)
+   */
+  getDescription() {
+    return this.config.description || "";
+  }
   getTools() {
     const tools = resolveGetter(this.config.canUse);
     if (!tools) {
@@ -1292,12 +1297,15 @@ var AgentGraph = class {
         const tools = [];
         const selectedToolsMapping = {};
         const agentTools = internalAgent.getTools();
-        for (const [toolName, toolInstance] of Object.entries(agentTools)) {
+        for (const [_toolName, toolInstance] of Object.entries(agentTools)) {
           if (toolInstance && typeof toolInstance === "object") {
             let toolId;
             toolId = toolInstance.getId?.() || toolInstance.id;
             if ("selectedTools" in toolInstance && toolInstance.selectedTools !== void 0) {
-              logger7.info({ toolId, selectedTools: toolInstance.selectedTools }, "Selected tools");
+              logger7.info(
+                { toolId, selectedTools: toolInstance.selectedTools },
+                "Selected tools"
+              );
               selectedToolsMapping[toolId] = toolInstance.selectedTools;
             }
             tools.push(toolId);
@@ -1472,12 +1480,18 @@ var AgentGraph = class {
       agents: agentsObject,
       tools: toolsObject,
       contextConfig: this.contextConfig?.toObject(),
-      credentialReferences: this.credentials?.map((credentialReference) => ({
-        type: credentialReference.type,
-        id: credentialReference.id,
-        credentialStoreId: credentialReference.credentialStoreId,
-        retrievalParams: credentialReference.retrievalParams || {}
-      })),
+      credentialReferences: this.credentials?.reduce(
+        (acc, credentialReference) => {
+          acc[credentialReference.id] = {
+            type: credentialReference.type,
+            id: credentialReference.id,
+            credentialStoreId: credentialReference.credentialStoreId,
+            retrievalParams: credentialReference.retrievalParams || {}
+          };
+          return acc;
+        },
+        {}
+      ),
       models: this.models,
       statusUpdates: this.statusUpdateSettings,
       graphPrompt: this.graphPrompt,
@@ -2682,6 +2696,7 @@ async function deleteFullProjectViaAPI(tenantId, apiUrl, projectId) {
 var logger9 = agentsCore.getLogger("project");
 var Project = class {
   constructor(config) {
+    __publicField(this, "__type", "project");
     __publicField(this, "projectId");
     __publicField(this, "projectName");
     __publicField(this, "projectDescription");
@@ -2692,6 +2707,7 @@ var Project = class {
     __publicField(this, "stopWhen");
     __publicField(this, "graphs", []);
     __publicField(this, "graphMap", /* @__PURE__ */ new Map());
+    __publicField(this, "credentialReferences", []);
     this.projectId = config.id;
     this.projectName = config.name;
     this.projectDescription = config.description;
@@ -2719,12 +2735,15 @@ var Project = class {
    * Set or update the configuration (tenantId and apiUrl)
    * This is used by the CLI to inject configuration from inkeep.config.ts
    */
-  setConfig(tenantId, apiUrl) {
+  setConfig(tenantId, apiUrl, models) {
     if (this.initialized) {
       throw new Error("Cannot set config after project has been initialized");
     }
     this.tenantId = tenantId;
     this.baseURL = apiUrl;
+    if (models) {
+      this.models = models;
+    }
     for (const graph of this.graphs) {
       graph.setConfig(tenantId, this.projectId, apiUrl);
     }
@@ -2732,11 +2751,26 @@ var Project = class {
       {
         projectId: this.projectId,
         tenantId: this.tenantId,
-        apiUrl: this.baseURL
+        apiUrl: this.baseURL,
+        hasModels: !!this.models
       },
       "Project configuration updated"
     );
   }
+  /**
+   * Set credential references for the project
+   * This is used by the CLI to inject environment-specific credentials
+   */
+  setCredentials(credentials) {
+    this.credentialReferences = Object.values(credentials);
+    logger9.info(
+      {
+        projectId: this.projectId,
+        credentialCount: this.credentialReferences?.length || 0
+      },
+      "Project credentials updated"
+    );
+  }
   /**
    * Initialize the project and create/update it in the backend using full project approach
    */
@@ -2754,6 +2788,35 @@ var Project = class {
       "Initializing project using full project endpoint"
     );
     try {
+      const projectMetadata = {
+        id: this.projectId,
+        name: this.projectName,
+        description: this.projectDescription || "",
+        models: this.models,
+        stopWhen: this.stopWhen,
+        graphs: {},
+        // Empty graphs object for now
+        tools: {},
+        // Empty tools object
+        credentialReferences: void 0,
+        createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      logger9.info(
+        {
+          projectId: this.projectId,
+          mode: "api-client",
+          apiUrl: this.baseURL
+        },
+        "Creating project metadata first"
+      );
+      await updateFullProjectViaAPI(this.tenantId, this.baseURL, this.projectId, projectMetadata);
+      logger9.info(
+        {
+          projectId: this.projectId
+        },
+        "Project metadata created successfully"
+      );
       const initPromises = this.graphs.map(async (graph) => {
         try {
           await graph.init();

package/dist/index.d.cts

@@ -312,11 +312,9 @@ interface RunResult {
     };
 }
 interface StatusComponent {
-    id: string;
-    name: string;
     type: string;
     description?: string;
-    schema: {
+    schema?: {
         type: 'object';
         properties: Record<string, any>;
         required?: string[];
@@ -368,6 +366,7 @@ interface AgentInterface {
     init(): Promise<void>;
     getId(): string;
     getName(): string;
+    getDescription(): string;
     getInstructions(): string;
     getTools(): Record<string, any>;
     getTransfers(): AgentInterface[];
@@ -439,6 +438,10 @@ declare class Agent implements AgentInterface {
     getId(): string;
     getName(): string;
     getInstructions(): string;
+    /**
+     * Get the agent's description (the human-readable description field)
+     */
+    getDescription(): string;
     getTools(): Record<string, unknown>;
     getModels(): typeof this$1.config.models;
     setModels(models: typeof this$1.config.models): void;
@@ -771,6 +774,7 @@ interface ProjectInterface {
  * ```
  */
 declare class Project implements ProjectInterface {
+    readonly __type: "project";
     private projectId;
     private projectName;
     private projectDescription?;
@@ -781,12 +785,18 @@ declare class Project implements ProjectInterface {
     private stopWhen?;
     private graphs;
     private graphMap;
+    private credentialReferences?;
     constructor(config: ProjectConfig);
     /**
      * Set or update the configuration (tenantId and apiUrl)
      * This is used by the CLI to inject configuration from inkeep.config.ts
      */
-    setConfig(tenantId: string, apiUrl: string): void;
+    setConfig(tenantId: string, apiUrl: string, models?: ProjectConfig['models']): void;
+    /**
+     * Set credential references for the project
+     * This is used by the CLI to inject environment-specific credentials
+     */
+    setCredentials(credentials: Record<string, CredentialReferenceApiInsert>): void;
     /**
      * Initialize the project and create/update it in the backend using full project approach
      */

package/dist/index.d.ts

@@ -312,11 +312,9 @@ interface RunResult {
     };
 }
 interface StatusComponent {
-    id: string;
-    name: string;
     type: string;
     description?: string;
-    schema: {
+    schema?: {
         type: 'object';
         properties: Record<string, any>;
         required?: string[];
@@ -368,6 +366,7 @@ interface AgentInterface {
     init(): Promise<void>;
     getId(): string;
     getName(): string;
+    getDescription(): string;
     getInstructions(): string;
     getTools(): Record<string, any>;
     getTransfers(): AgentInterface[];
@@ -439,6 +438,10 @@ declare class Agent implements AgentInterface {
     getId(): string;
     getName(): string;
     getInstructions(): string;
+    /**
+     * Get the agent's description (the human-readable description field)
+     */
+    getDescription(): string;
     getTools(): Record<string, unknown>;
     getModels(): typeof this$1.config.models;
     setModels(models: typeof this$1.config.models): void;
@@ -771,6 +774,7 @@ interface ProjectInterface {
  * ```
  */
 declare class Project implements ProjectInterface {
+    readonly __type: "project";
     private projectId;
     private projectName;
     private projectDescription?;
@@ -781,12 +785,18 @@ declare class Project implements ProjectInterface {
     private stopWhen?;
     private graphs;
     private graphMap;
+    private credentialReferences?;
     constructor(config: ProjectConfig);
     /**
      * Set or update the configuration (tenantId and apiUrl)
      * This is used by the CLI to inject configuration from inkeep.config.ts
      */
-    setConfig(tenantId: string, apiUrl: string): void;
+    setConfig(tenantId: string, apiUrl: string, models?: ProjectConfig['models']): void;
+    /**
+     * Set credential references for the project
+     * This is used by the CLI to inject environment-specific credentials
+     */
+    setCredentials(credentials: Record<string, CredentialReferenceApiInsert>): void;
     /**
      * Initialize the project and create/update it in the backend using full project approach
      */

package/dist/index.js

@@ -457,7 +457,12 @@ var Agent = class {
   getInstructions() {
     return this.config.prompt;
   }
-  // adjust
+  /**
+   * Get the agent's description (the human-readable description field)
+   */
+  getDescription() {
+    return this.config.description || "";
+  }
   getTools() {
     const tools = resolveGetter(this.config.canUse);
     if (!tools) {
@@ -1290,12 +1295,15 @@ var AgentGraph = class {
         const tools = [];
         const selectedToolsMapping = {};
         const agentTools = internalAgent.getTools();
-        for (const [toolName, toolInstance] of Object.entries(agentTools)) {
+        for (const [_toolName, toolInstance] of Object.entries(agentTools)) {
           if (toolInstance && typeof toolInstance === "object") {
             let toolId;
             toolId = toolInstance.getId?.() || toolInstance.id;
             if ("selectedTools" in toolInstance && toolInstance.selectedTools !== void 0) {
-              logger7.info({ toolId, selectedTools: toolInstance.selectedTools }, "Selected tools");
+              logger7.info(
+                { toolId, selectedTools: toolInstance.selectedTools },
+                "Selected tools"
+              );
               selectedToolsMapping[toolId] = toolInstance.selectedTools;
             }
             tools.push(toolId);
@@ -1470,12 +1478,18 @@ var AgentGraph = class {
       agents: agentsObject,
       tools: toolsObject,
       contextConfig: this.contextConfig?.toObject(),
-      credentialReferences: this.credentials?.map((credentialReference) => ({
-        type: credentialReference.type,
-        id: credentialReference.id,
-        credentialStoreId: credentialReference.credentialStoreId,
-        retrievalParams: credentialReference.retrievalParams || {}
-      })),
+      credentialReferences: this.credentials?.reduce(
+        (acc, credentialReference) => {
+          acc[credentialReference.id] = {
+            type: credentialReference.type,
+            id: credentialReference.id,
+            credentialStoreId: credentialReference.credentialStoreId,
+            retrievalParams: credentialReference.retrievalParams || {}
+          };
+          return acc;
+        },
+        {}
+      ),
       models: this.models,
       statusUpdates: this.statusUpdateSettings,
       graphPrompt: this.graphPrompt,
@@ -2680,6 +2694,7 @@ async function deleteFullProjectViaAPI(tenantId, apiUrl, projectId) {
 var logger9 = getLogger("project");
 var Project = class {
   constructor(config) {
+    __publicField(this, "__type", "project");
     __publicField(this, "projectId");
     __publicField(this, "projectName");
     __publicField(this, "projectDescription");
@@ -2690,6 +2705,7 @@ var Project = class {
     __publicField(this, "stopWhen");
     __publicField(this, "graphs", []);
     __publicField(this, "graphMap", /* @__PURE__ */ new Map());
+    __publicField(this, "credentialReferences", []);
     this.projectId = config.id;
     this.projectName = config.name;
     this.projectDescription = config.description;
@@ -2717,12 +2733,15 @@ var Project = class {
    * Set or update the configuration (tenantId and apiUrl)
    * This is used by the CLI to inject configuration from inkeep.config.ts
    */
-  setConfig(tenantId, apiUrl) {
+  setConfig(tenantId, apiUrl, models) {
     if (this.initialized) {
       throw new Error("Cannot set config after project has been initialized");
     }
     this.tenantId = tenantId;
     this.baseURL = apiUrl;
+    if (models) {
+      this.models = models;
+    }
     for (const graph of this.graphs) {
       graph.setConfig(tenantId, this.projectId, apiUrl);
     }
@@ -2730,11 +2749,26 @@ var Project = class {
       {
         projectId: this.projectId,
         tenantId: this.tenantId,
-        apiUrl: this.baseURL
+        apiUrl: this.baseURL,
+        hasModels: !!this.models
       },
       "Project configuration updated"
     );
   }
+  /**
+   * Set credential references for the project
+   * This is used by the CLI to inject environment-specific credentials
+   */
+  setCredentials(credentials) {
+    this.credentialReferences = Object.values(credentials);
+    logger9.info(
+      {
+        projectId: this.projectId,
+        credentialCount: this.credentialReferences?.length || 0
+      },
+      "Project credentials updated"
+    );
+  }
   /**
    * Initialize the project and create/update it in the backend using full project approach
    */
@@ -2752,6 +2786,35 @@ var Project = class {
       "Initializing project using full project endpoint"
     );
     try {
+      const projectMetadata = {
+        id: this.projectId,
+        name: this.projectName,
+        description: this.projectDescription || "",
+        models: this.models,
+        stopWhen: this.stopWhen,
+        graphs: {},
+        // Empty graphs object for now
+        tools: {},
+        // Empty tools object
+        credentialReferences: void 0,
+        createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      logger9.info(
+        {
+          projectId: this.projectId,
+          mode: "api-client",
+          apiUrl: this.baseURL
+        },
+        "Creating project metadata first"
+      );
+      await updateFullProjectViaAPI(this.tenantId, this.baseURL, this.projectId, projectMetadata);
+      logger9.info(
+        {
+          projectId: this.projectId
+        },
+        "Project metadata created successfully"
+      );
       const initPromises = this.graphs.map(async (graph) => {
         try {
           await graph.init();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-sdk",
-  "version": "0.1.10",
+  "version": "0.2.1",
   "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.1.10"
+    "@inkeep/agents-core": "^0.2.1"
   },
   "devDependencies": {
     "@types/node": "^20.11.24",