Release 0.8.21

Author: fern-api[bot]

jest.config.mjs

@@ -3,6 +3,6 @@ export default {
     preset: "ts-jest",
     testEnvironment: "node",
     moduleNameMapper: {
-        "^(?!.*node_modules)(.+)\\.js$": "$1",
+        "(.+)\.js$": "$1",
     },
 };

package.json

@@ -1,6 +1,6 @@
 {
     "name": "humanloop",
-    "version": "0.8.21-beta1",
+    "version": "0.8.21",
     "private": false,
     "repository": "https://github.com/humanloop/humanloop-node",
     "main": "./index.js",
@@ -26,6 +26,8 @@
         "@traceloop/instrumentation-cohere": ">=0.11.1",
         "@traceloop/instrumentation-openai": ">=0.11.3",
         "@traceloop/ai-semantic-conventions": ">=0.11.6",
+        "dotenv": "^16.5.0",
+        "commander": "^14.0.0",
         "cli-progress": "^3.12.0",
         "lodash": "^4.17.21"
     },
@@ -46,7 +48,6 @@
         "openai": "^4.74.0",
         "@anthropic-ai/sdk": "^0.32.1",
         "cohere-ai": "^7.15.0",
-        "dotenv": "^16.4.6",
         "jsonschema": "^1.4.1",
         "@types/cli-progress": "^3.11.6",
         "@types/lodash": "4.14.74",
@@ -56,5 +57,8 @@
         "fs": false,
         "os": false,
         "path": false
+    },
+    "bin": {
+        "humanloop": "./cli.js"
     }
 }

reference.md

@@ -1342,7 +1342,7 @@ await client.prompts.updateMonitoring("pr_30gco7dx6JDq4200GVOHa", {
 </dl>
 </details>
 
-<details><summary><code>client.prompts.<a href="/src/api/resources/prompts/client/Client.ts">serialize</a>(id, { ...params }) -> void</code></summary>
+<details><summary><code>client.prompts.<a href="/src/api/resources/prompts/client/Client.ts">serialize</a>(id, { ...params }) -> string</code></summary>
 <dl>
 <dd>
 
@@ -7313,7 +7313,7 @@ await client.agents.updateMonitoring("ag_1234567890", {
 </dl>
 </details>
 
-<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">serialize</a>(id, { ...params }) -> void</code></summary>
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">serialize</a>(id, { ...params }) -> string</code></summary>
 <dl>
 <dd>
 

src/api/resources/agents/client/Client.ts

@@ -89,8 +89,14 @@ export interface AgentLogRequest {
      * - `{'type': 'function', 'function': {name': <TOOL_NAME>}}` forces the model to use the named function.
      */
     toolChoice?: Humanloop.AgentLogRequestToolChoice;
-    /** Details of your Agent. A new Agent version will be created if the provided details are new. */
-    agent?: Humanloop.AgentKernelRequest;
+    /**
+     * The Agent configuration to use. Two formats are supported:
+     * - An object representing the details of the Agent configuration
+     * - A string representing the raw contents of a .agent file
+     *
+     * A new Agent version will be created if the provided details do not match any existing version.
+     */
+    agent?: Humanloop.AgentLogRequestAgent;
     /** When the logged event started. */
     startTime?: Date;
     /** When the logged event ended. */

src/api/resources/agents/client/requests/AgentLogRequest.ts

@@ -37,8 +37,14 @@ export interface AgentsCallRequest {
      * - `{'type': 'function', 'function': {name': <TOOL_NAME>}}` forces the model to use the named function.
      */
     toolChoice?: Humanloop.AgentsCallRequestToolChoice;
-    /** Details of your Agent. A new Agent version will be created if the provided details are new. */
-    agent?: Humanloop.AgentKernelRequest;
+    /**
+     * The Agent configuration to use. Two formats are supported:
+     * - An object representing the details of the Agent configuration
+     * - A string representing the raw contents of a .agent file
+     *
+     * A new Agent version will be created if the provided details do not match any existing version.
+     */
+    agent?: Humanloop.AgentsCallRequestAgent;
     /** The inputs passed to the prompt template. */
     inputs?: Record<string, unknown>;
     /** Identifies where the model was called from. */

src/api/resources/agents/client/requests/AgentsCallRequest.ts

@@ -31,8 +31,14 @@ export interface AgentsCallStreamRequest {
      * - `{'type': 'function', 'function': {name': <TOOL_NAME>}}` forces the model to use the named function.
      */
     toolChoice?: Humanloop.AgentsCallStreamRequestToolChoice;
-    /** Details of your Agent. A new Agent version will be created if the provided details are new. */
-    agent?: Humanloop.AgentKernelRequest;
+    /**
+     * The Agent configuration to use. Two formats are supported:
+     * - An object representing the details of the Agent configuration
+     * - A string representing the raw contents of a .agent file
+     *
+     * A new Agent version will be created if the provided details do not match any existing version.
+     */
+    agent?: Humanloop.AgentsCallStreamRequestAgent;
     /** The inputs passed to the prompt template. */
     inputs?: Record<string, unknown>;
     /** Identifies where the model was called from. */

src/api/resources/agents/client/requests/AgentsCallStreamRequest.ts

@@ -30,7 +30,7 @@ export interface ListAgentsGetRequest {
     /**
      * Field to sort Agents by
      */
-    sortBy?: Humanloop.ProjectSortBy;
+    sortBy?: Humanloop.FileSortBy;
     /**
      * Direction to sort by.
      */