Merge branch 'master' into p_sync/pull

Author: AlePouroullis

reference.md

@@ -6267,7 +6267,7 @@ to the original messages in the log.
 <dd>
 
 ```typescript
-await client.agents.continue({
+await client.agents.continueCall({
     logId: "log_id",
     messages: [
         {

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

@@ -156,7 +156,7 @@ export class Agents {
         logId: string,
         request: Humanloop.UpdateAgentLogRequest = {},
         requestOptions?: Agents.RequestOptions,
-    ): Promise<Humanloop.LogResponse> {
+    ): Promise<Humanloop.AgentLogResponse> {
         const _response = await (this._options.fetcher ?? core.fetcher)({
             url: urlJoin(
                 (await core.Supplier.get(this._options.baseUrl)) ??
@@ -183,7 +183,7 @@ export class Agents {
             abortSignal: requestOptions?.abortSignal,
         });
         if (_response.ok) {
-            return serializers.LogResponse.parseOrThrow(_response.body, {
+            return serializers.AgentLogResponse.parseOrThrow(_response.body, {
                 unrecognizedObjectKeys: "passthrough",
                 allowUnrecognizedUnionMembers: true,
                 allowUnrecognizedEnumValues: true,
@@ -230,18 +230,21 @@ export class Agents {
     }
 
     /**
-     * Call an Agent.
+     * Call an Agent. The Agent will run on the Humanloop runtime and return a completed Agent Log.
      *
-     * Calling an Agent calls the model provider before logging
-     * the request, responses and metadata to Humanloop.
+     * If the Agent requires a tool call that cannot be ran by Humanloop, execution will halt. To continue,
+     * pass the ID of the incomplete Log and the required tool call to the /agents/continue endpoint.
+     *
+     * The agent will run for the maximum number of iterations, or until it encounters a stop condition,
+     * according to its configuration.
      *
      * You can use query parameters `version_id`, or `environment`, to target
      * an existing version of the Agent. Otherwise the default deployed version will be chosen.
      *
      * Instead of targeting an existing version explicitly, you can instead pass in
-     * Agent details in the request body. In this case, we will check if the details correspond
-     * to an existing version of the Agent. If they do not, we will create a new version. This is helpful
-     * in the case where you are storing or deriving your Agent details in code.
+     * Agent details in the request body. A new version is created if it does not match
+     * any existing ones. This is helpful in the case where you are storing or deriving
+     * your Agent details in code.
      */
     public async callStream(
         request: Humanloop.AgentsCallStreamRequest,
@@ -343,18 +346,21 @@ export class Agents {
     }
 
     /**
-     * Call an Agent.
+     * Call an Agent. The Agent will run on the Humanloop runtime and return a completed Agent Log.
+     *
+     * If the Agent requires a tool call that cannot be ran by Humanloop, execution will halt. To continue,
+     * pass the ID of the incomplete Log and the required tool call to the /agents/continue endpoint.
      *
-     * Calling an Agent calls the model provider before logging
-     * the request, responses and metadata to Humanloop.
+     * The agent will run for the maximum number of iterations, or until it encounters a stop condition,
+     * according to its configuration.
      *
      * You can use query parameters `version_id`, or `environment`, to target
      * an existing version of the Agent. Otherwise the default deployed version will be chosen.
      *
      * Instead of targeting an existing version explicitly, you can instead pass in
-     * Agent details in the request body. In this case, we will check if the details correspond
-     * to an existing version of the Agent. If they do not, we will create a new version. This is helpful
-     * in the case where you are storing or deriving your Agent details in code.
+     * Agent details in the request body. A new version is created if it does not match
+     * any existing ones. This is helpful in the case where you are storing or deriving
+     * your Agent details in code.
      *
      * @param {Humanloop.AgentsCallRequest} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -455,16 +461,16 @@ export class Agents {
     /**
      * Continue an incomplete Agent call.
      *
-     * This endpoint allows continuing an existing incomplete Agent call, using the context
-     * from the previous interaction. The Agent will resume processing from where it left off.
+     * This endpoint allows continuing an existing incomplete Agent call, by passing the tool call
+     * requested by the Agent. The Agent will resume processing from where it left off.
      *
-     * The original log must be in an incomplete state to be continued.
+     * The messages in the request will be appended to the original messages in the Log. You do not
+     * have to provide the previous conversation history.
      *
-     * The messages in the request will be appended
-     * to the original messages in the log.
+     * The original log must be in an incomplete state to be continued.
      */
-    public async continueStream(
-        request: Humanloop.AgentsContinueStreamRequest,
+    public async continueCallStream(
+        request: Humanloop.AgentsContinueCallStreamRequest,
         requestOptions?: Agents.RequestOptions,
     ): Promise<core.Stream<Humanloop.AgentContinueStreamResponse>> {
         const _response = await (this._options.fetcher ?? core.fetcher)<stream.Readable>({
@@ -488,7 +494,9 @@ export class Agents {
             contentType: "application/json",
             requestType: "json",
             body: {
-                ...serializers.AgentsContinueStreamRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                ...serializers.AgentsContinueCallStreamRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                }),
                 stream: true,
             },
             responseType: "sse",
@@ -554,29 +562,29 @@ export class Agents {
     /**
      * Continue an incomplete Agent call.
      *
-     * This endpoint allows continuing an existing incomplete Agent call, using the context
-     * from the previous interaction. The Agent will resume processing from where it left off.
+     * This endpoint allows continuing an existing incomplete Agent call, by passing the tool call
+     * requested by the Agent. The Agent will resume processing from where it left off.
      *
-     * The original log must be in an incomplete state to be continued.
+     * The messages in the request will be appended to the original messages in the Log. You do not
+     * have to provide the previous conversation history.
      *
-     * The messages in the request will be appended
-     * to the original messages in the log.
+     * The original log must be in an incomplete state to be continued.
      *
-     * @param {Humanloop.AgentsContinueRequest} request
+     * @param {Humanloop.AgentsContinueCallRequest} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Humanloop.UnprocessableEntityError}
      *
      * @example
-     *     await client.agents.continue({
+     *     await client.agents.continueCall({
      *         logId: "log_id",
      *         messages: [{
      *                 role: "user"
      *             }]
      *     })
      */
-    public async continue(
-        request: Humanloop.AgentsContinueRequest,
+    public async continueCall(
+        request: Humanloop.AgentsContinueCallRequest,
         requestOptions?: Agents.RequestOptions,
     ): Promise<Humanloop.AgentContinueResponse> {
         const _response = await (this._options.fetcher ?? core.fetcher)({

…/requests/AgentsContinueStreamRequest.ts …nt/requests/AgentsContinueCallRequest.tssrc/api/resources/agents/client/requests/AgentsContinueStreamRequest.ts renamed to src/api/resources/agents/client/requests/AgentsContinueCallRequest.ts src/api/resources/agents/client/requests/AgentsContinueStreamRequest.ts renamed to src/api/resources/agents/client/requests/AgentsContinueCallRequest.ts

@@ -13,7 +13,7 @@ import * as Humanloop from "../../../../index";
  *             }]
  *     }
  */
-export interface AgentsContinueStreamRequest {
+export interface AgentsContinueCallRequest {
     /** This identifies the Agent Log to continue. */
     logId: string;
     /** The additional messages with which to continue the Agent Log. Often, these should start with the Tool messages with results for the previous Assistant message's tool calls. */

src/api/types/AgentResponse.ts

@@ -100,4 +100,6 @@ export interface AgentResponse {
     evaluators?: Humanloop.MonitoringEvaluatorResponse[];
     /** Aggregation of Evaluator results for the Agent Version. */
     evaluatorAggregates?: Humanloop.EvaluatorAggregate[];
+    /** The raw content of the Agent. Corresponds to the .agent file. */
+    rawFileContent?: string;
 }

src/api/types/PopulateTemplateResponse.ts

@@ -94,6 +94,8 @@ export interface PopulateTemplateResponse {
     evaluators?: Humanloop.MonitoringEvaluatorResponse[];
     /** Aggregation of Evaluator results for the Prompt Version. */
     evaluatorAggregates?: Humanloop.EvaluatorAggregate[];
+    /** The raw content of the Prompt. Corresponds to the .prompt file. */
+    rawFileContent?: string;
     /** The template populated with the input values you provided in the request. Returns None if no template exists. */
     populatedTemplate?: Humanloop.PopulateTemplateResponsePopulatedTemplate;
 }

src/api/types/PromptResponse.ts

@@ -94,4 +94,6 @@ export interface PromptResponse {
     evaluators?: Humanloop.MonitoringEvaluatorResponse[];
     /** Aggregation of Evaluator results for the Prompt Version. */
     evaluatorAggregates?: Humanloop.EvaluatorAggregate[];
+    /** The raw content of the Prompt. Corresponds to the .prompt file. */
+    rawFileContent?: string;
 }

src/serialization/types/AgentResponse.ts

@@ -68,6 +68,7 @@ export const AgentResponse: core.serialization.ObjectSchema<serializers.AgentRes
             "evaluator_aggregates",
             core.serialization.list(EvaluatorAggregate).optional(),
         ),
+        rawFileContent: core.serialization.property("raw_file_content", core.serialization.string().optional()),
     });
 
 export declare namespace AgentResponse {
@@ -115,5 +116,6 @@ export declare namespace AgentResponse {
         inputs: InputResponse.Raw[];
         evaluators?: serializers.MonitoringEvaluatorResponse.Raw[] | null;
         evaluator_aggregates?: EvaluatorAggregate.Raw[] | null;
+        raw_file_content?: string | null;
     }
 }

src/serialization/types/PopulateTemplateResponse.ts

@@ -72,6 +72,7 @@ export const PopulateTemplateResponse: core.serialization.ObjectSchema<
         "evaluator_aggregates",
         core.serialization.list(EvaluatorAggregate).optional(),
     ),
+    rawFileContent: core.serialization.property("raw_file_content", core.serialization.string().optional()),
     populatedTemplate: core.serialization.property(
         "populated_template",
         PopulateTemplateResponsePopulatedTemplate.optional(),
@@ -120,6 +121,7 @@ export declare namespace PopulateTemplateResponse {
         inputs: InputResponse.Raw[];
         evaluators?: serializers.MonitoringEvaluatorResponse.Raw[] | null;
         evaluator_aggregates?: EvaluatorAggregate.Raw[] | null;
+        raw_file_content?: string | null;
         populated_template?: PopulateTemplateResponsePopulatedTemplate.Raw | null;
     }
 }

src/serialization/types/PromptResponse.ts

@@ -69,6 +69,7 @@ export const PromptResponse: core.serialization.ObjectSchema<serializers.PromptR
             "evaluator_aggregates",
             core.serialization.list(EvaluatorAggregate).optional(),
         ),
+        rawFileContent: core.serialization.property("raw_file_content", core.serialization.string().optional()),
     });
 
 export declare namespace PromptResponse {
@@ -113,5 +114,6 @@ export declare namespace PromptResponse {
         inputs: InputResponse.Raw[];
         evaluators?: serializers.MonitoringEvaluatorResponse.Raw[] | null;
         evaluator_aggregates?: EvaluatorAggregate.Raw[] | null;
+        raw_file_content?: string | null;
     }
 }

yarn.lock

@@ -559,10 +559,10 @@
     js-tokens "^4.0.0"
     picocolors "^1.1.1"
 
-"@babel/compat-data@^7.27.1":
-  version "7.27.1"
-  resolved "https://registry.yarnpkg.com/@babel/compat-data/-/compat-data-7.27.1.tgz#db7cf122745e0a332c44e847ddc4f5e5221a43f6"
-  integrity sha512-Q+E+rd/yBzNQhXkG+zQnF58e4zoZfBedaxwzPmicKsiK3nt8iJYrSrDbjwFFDGC4f+rPafqRaPH6TsDoSvMf7A==
+"@babel/compat-data@^7.27.2":
+  version "7.27.2"
+  resolved "https://registry.yarnpkg.com/@babel/compat-data/-/compat-data-7.27.2.tgz#4183f9e642fd84e74e3eea7ffa93a412e3b102c9"
+  integrity sha512-TUtMJYRPyUb/9aU8f3K0mjmjf6M9N5Woshn2CS6nqJSeJtTtQcpLUXjGt9vbF8ZGff0El99sWkLgzwW3VXnxZQ==
 
 "@babel/core@^7.11.6", "@babel/core@^7.12.3", "@babel/core@^7.23.9":
   version "7.27.1"
@@ -606,11 +606,11 @@
     jsesc "^3.0.2"
 
 "@babel/helper-compilation-targets@^7.27.1":
-  version "7.27.1"
-  resolved "https://registry.yarnpkg.com/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.1.tgz#eac1096c7374f161e4f33fc8ae38f4ddf122087a"
-  integrity sha512-2YaDd/Rd9E598B5+WIc8wJPmWETiiJXFYVE60oX8FDohv7rAUU3CQj+A1MgeEmcsk2+dQuEjIe/GDvig0SqL4g==
+  version "7.27.2"
+  resolved "https://registry.yarnpkg.com/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz#46a0f6efab808d51d29ce96858dd10ce8732733d"
+  integrity sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==
   dependencies:
-    "@babel/compat-data" "^7.27.1"
+    "@babel/compat-data" "^7.27.2"
     "@babel/helper-validator-option" "^7.27.1"
     browserslist "^4.24.0"
     lru-cache "^5.1.1"
@@ -690,10 +690,10 @@
     "@babel/template" "^7.27.1"
     "@babel/types" "^7.27.1"
 
-"@babel/parser@^7.1.0", "@babel/parser@^7.14.7", "@babel/parser@^7.20.5", "@babel/parser@^7.20.7", "@babel/parser@^7.23.0", "@babel/parser@^7.23.9", "@babel/parser@^7.27.1":
-  version "7.27.1"
-  resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.27.1.tgz#c55d5bed74449d1223701f1869b9ee345cc94cc9"
-  integrity sha512-I0dZ3ZpCrJ1c04OqlNsQcKiZlsrXf/kkE4FXzID9rIOYICsAbA8mMDzhW/luRNAHdCNt7os/u8wenklZDlUVUQ==
+"@babel/parser@^7.1.0", "@babel/parser@^7.14.7", "@babel/parser@^7.20.5", "@babel/parser@^7.20.7", "@babel/parser@^7.23.0", "@babel/parser@^7.23.9", "@babel/parser@^7.27.1", "@babel/parser@^7.27.2":
+  version "7.27.2"
+  resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.27.2.tgz#577518bedb17a2ce4212afd052e01f7df0941127"
+  integrity sha512-QYLs8299NA7WM/bZAdp+CviYYkVoYXlDW2rzliy3chxd1PQjej7JORuMJDJXJUb9g0TT+B99EwaVLKmX+sPXWw==
   dependencies:
     "@babel/types" "^7.27.1"
 
@@ -817,12 +817,12 @@
     "@babel/helper-plugin-utils" "^7.27.1"
 
 "@babel/template@^7.24.7", "@babel/template@^7.27.1", "@babel/template@^7.3.3":
-  version "7.27.1"
-  resolved "https://registry.yarnpkg.com/@babel/template/-/template-7.27.1.tgz#b9e4f55c17a92312774dfbdde1b3c01c547bbae2"
-  integrity sha512-Fyo3ghWMqkHHpHQCoBs2VnYjR4iWFFjguTDEqA5WgZDOrFesVjMhMM2FSqTKSoUSDO1VQtavj8NFpdRBEvJTtg==
+  version "7.27.2"
+  resolved "https://registry.yarnpkg.com/@babel/template/-/template-7.27.2.tgz#fa78ceed3c4e7b63ebf6cb39e5852fca45f6809d"
+  integrity sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==
   dependencies:
     "@babel/code-frame" "^7.27.1"
-    "@babel/parser" "^7.27.1"
+    "@babel/parser" "^7.27.2"
     "@babel/types" "^7.27.1"
 
 "@babel/traverse@7.23.2":