Release 0.8.21-beta2 (#26)

* Updated doc-strings to match the changes made in observability, per [16.05 changelog](https://humanloop.com/docs/v5/changelog/2025/05#improved-observability-for-traces)

Author: Andrei Bratu

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-beta2",
     "private": false,
     "repository": "https://github.com/humanloop/humanloop-node",
     "main": "./index.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>
 
@@ -4794,9 +4794,6 @@ Log to a Flow.
 You can use query parameters `version_id`, or `environment`, to target
 an existing version of the Flow. Otherwise, the default deployed version will be chosen.
 
-If you create the Flow Log with a `log_status` of `incomplete`, you should later update it to `complete`
-in order to trigger Evaluators.
-
 </dd>
 </dl>
 </dd>
@@ -7313,7 +7310,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,13 @@ 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. */
@@ -115,8 +120,6 @@ export interface AgentLogRequest {
     source?: string;
     /** Any additional metadata to record. */
     metadata?: Record<string, unknown>;
-    /** Status of a Log. Set to `incomplete` if you intend to update and eventually complete the Log and want the File's monitoring Evaluators to wait until you mark it as `complete`. If log_status is not provided, observability will pick up the Log as soon as possible. Updating this from specified to unspecified is undefined behavior. */
-    logStatus?: Humanloop.LogStatus;
     /** Unique identifier for the Datapoint that this Log is derived from. This can be used by Humanloop to associate Logs to Evaluations. If provided, Humanloop will automatically associate this Log to Evaluations that require a Log for this Datapoint-Version pair. */
     sourceDatapointId?: string;
     /** The ID of the parent Log to nest this Log under in a Trace. */

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

@@ -37,8 +37,13 @@ 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. */
@@ -49,8 +54,6 @@ export interface AgentsCallRequest {
     startTime?: Date;
     /** When the logged event ended. */
     endTime?: Date;
-    /** Status of a Log. Set to `incomplete` if you intend to update and eventually complete the Log and want the File's monitoring Evaluators to wait until you mark it as `complete`. If log_status is not provided, observability will pick up the Log as soon as possible. Updating this from specified to unspecified is undefined behavior. */
-    logStatus?: Humanloop.LogStatus;
     /** Unique identifier for the Datapoint that this Log is derived from. This can be used by Humanloop to associate Logs to Evaluations. If provided, Humanloop will automatically associate this Log to Evaluations that require a Log for this Datapoint-Version pair. */
     sourceDatapointId?: string;
     /** The ID of the parent Log to nest this Log under in a Trace. */

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

@@ -31,8 +31,13 @@ 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. */
@@ -43,8 +48,6 @@ export interface AgentsCallStreamRequest {
     startTime?: Date;
     /** When the logged event ended. */
     endTime?: Date;
-    /** Status of a Log. Set to `incomplete` if you intend to update and eventually complete the Log and want the File's monitoring Evaluators to wait until you mark it as `complete`. If log_status is not provided, observability will pick up the Log as soon as possible. Updating this from specified to unspecified is undefined behavior. */
-    logStatus?: Humanloop.LogStatus;
     /** Unique identifier for the Datapoint that this Log is derived from. This can be used by Humanloop to associate Logs to Evaluations. If provided, Humanloop will automatically associate this Log to Evaluations that require a Log for this Datapoint-Version pair. */
     sourceDatapointId?: string;
     /** The ID of the parent Log to nest this Log under in a Trace. */

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.
      */