@aui.io/aui-client 3.1.2 → 3.2.0

package/dist/esm/Client.mjs

@@ -16,17 +16,18 @@ import { Messaging } from "./api/resources/messaging/client/Client.mjs";
 import { Projects } from "./api/resources/projects/client/Client.mjs";
 import { Session } from "./api/resources/session/client/Client.mjs";
 import { Threads } from "./api/resources/threads/client/Client.mjs";
-import { mergeHeaders } from "./core/headers.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "./core/headers.mjs";
 import * as core from "./core/index.mjs";
 import * as environments from "./environments.mjs";
 import * as errors from "./errors/index.mjs";
 export class ApolloClient {
-    constructor(_options = {}) {
+    constructor(_options) {
         this._options = Object.assign(Object.assign({}, _options), { logging: core.logging.createLogger(_options === null || _options === void 0 ? void 0 : _options.logging), headers: mergeHeaders({
+                "x-organization-api-key": _options === null || _options === void 0 ? void 0 : _options.organizationApiKey,
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@aui.io/aui-client",
-                "X-Fern-SDK-Version": "3.1.2",
-                "User-Agent": "@aui.io/aui-client/3.1.2",
+                "X-Fern-SDK-Version": "3.2.0",
+                "User-Agent": "@aui.io/aui-client/3.2.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });
@@ -64,6 +65,8 @@ export class ApolloClient {
         return ((_a = this._session) !== null && _a !== void 0 ? _a : (this._session = new Session(this._options)));
     }
     /**
+     * Liveness probe. Returns ``{"status": "ok"}`` when the service is up.
+     *
      * @param {ApolloClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
@@ -74,17 +77,20 @@ export class ApolloClient {
     }
     __health(requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                Authorization: yield this._getAuthorizationHeader(),
+                "x-organization-api-key": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationApiKey) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.organizationApiKey,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ApolloEnvironment.Gcp).base, "health"),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, "health"),
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 60) * 1000,
+                maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
                 logging: this._options.logging,
             });
             if (_response.ok) {
@@ -114,4 +120,13 @@ export class ApolloClient {
             }
         });
     }
+    _getAuthorizationHeader() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const bearer = yield core.Supplier.get(this._options.token);
+            if (bearer != null) {
+                return `Bearer ${bearer}`;
+            }
+            return undefined;
+        });
+    }
 }

package/dist/esm/api/resources/agentVersions/client/Client.d.mts

@@ -9,8 +9,11 @@ export declare namespace AgentVersions {
 }
 export declare class AgentVersions {
     protected readonly _options: AgentVersions.Options;
-    constructor(_options?: AgentVersions.Options);
+    constructor(_options: AgentVersions.Options);
     /**
+     * List an agent's versions, newest first. Filter by status, tag, label,
+     * or version number; set ``exclude_revisions`` to see only base versions.
+     *
      * @param {string} agentId
      * @param {Apollo.ListVersionsRequest} request
      * @param {AgentVersions.RequestOptions} requestOptions - Request-specific configuration.
@@ -28,9 +31,13 @@ export declare class AgentVersions {
      *         filters: {}
      *     })
      */
-    listVersions(agentId: string, request: Apollo.ListVersionsRequest, requestOptions?: AgentVersions.RequestOptions): core.HttpResponsePromise<Apollo.ExternalPageAgentVersion>;
+    listVersions(agentId: string, request: Apollo.ListVersionsRequest, requestOptions?: AgentVersions.RequestOptions): core.HttpResponsePromise<Apollo.PageAgentVersion>;
     private __listVersions;
     /**
+     * Create a new draft version — empty, from a template, or cloned from an
+     * existing version (``source`` selects which). Drafts stay editable until
+     * published.
+     *
      * @param {string} agentId
      * @param {Apollo.AgentVersionCreateRequest} request
      * @param {AgentVersions.RequestOptions} requestOptions - Request-specific configuration.
@@ -51,6 +58,9 @@ export declare class AgentVersions {
     createVersion(agentId: string, request: Apollo.AgentVersionCreateRequest, requestOptions?: AgentVersions.RequestOptions): core.HttpResponsePromise<Apollo.AgentVersionCreateResponse>;
     private __createVersion;
     /**
+     * Update a version's metadata: label, tags, and notes. The configuration
+     * itself changes through push, never here.
+     *
      * @param {string} agentId
      * @param {string} versionId
      * @param {Apollo.AgentVersionUpdateRequest} request
@@ -70,6 +80,10 @@ export declare class AgentVersions {
     updateVersion(agentId: string, versionId: string, request?: Apollo.AgentVersionUpdateRequest, requestOptions?: AgentVersions.RequestOptions): core.HttpResponsePromise<Apollo.AgentVersionUpdateResponse>;
     private __updateVersion;
     /**
+     * Make this version the agent's live version. Publishing a draft freezes
+     * it first; publishing an already-published version re-activates it — the
+     * same call handles shipping, switching, and rolling back.
+     *
      * @param {string} agentId
      * @param {string} versionId
      * @param {AgentVersions.RequestOptions} requestOptions - Request-specific configuration.
@@ -88,6 +102,9 @@ export declare class AgentVersions {
     publishVersion(agentId: string, versionId: string, requestOptions?: AgentVersions.RequestOptions): core.HttpResponsePromise<Apollo.AgentVersionPublishResponse>;
     private __publishVersion;
     /**
+     * Archive a version to retire it from everyday use. The agent's live
+     * version can't be archived — publish another version first.
+     *
      * @param {string} agentId
      * @param {string} versionId
      * @param {AgentVersions.RequestOptions} requestOptions - Request-specific configuration.
@@ -106,6 +123,9 @@ export declare class AgentVersions {
     archiveVersion(agentId: string, versionId: string, requestOptions?: AgentVersions.RequestOptions): core.HttpResponsePromise<Apollo.AgentVersionArchiveResponse>;
     private __archiveVersion;
     /**
+     * Upload a configuration bundle to a version, committing a new revision.
+     * The response carries the new revision's tag and content digest.
+     *
      * @param {string} agentId
      * @param {string} versionId
      * @param {Apollo.AgentVersionPushRequest} request
@@ -130,6 +150,9 @@ export declare class AgentVersions {
     pushVersion(agentId: string, versionId: string, request: Apollo.AgentVersionPushRequest, requestOptions?: AgentVersions.RequestOptions): core.HttpResponsePromise<Apollo.AgentVersionPushResponse>;
     private __pushVersion;
     /**
+     * Download a version's configuration bundle — the current revision, or a
+     * specific one via ``version_tag``.
+     *
      * @param {string} agentId
      * @param {string} versionId
      * @param {Apollo.PullVersionRequest} request
@@ -150,4 +173,5 @@ export declare class AgentVersions {
      */
     pullVersion(agentId: string, versionId: string, request?: Apollo.PullVersionRequest, requestOptions?: AgentVersions.RequestOptions): core.HttpResponsePromise<Apollo.AgentVersionPullResponse>;
     private __pullVersion;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

package/dist/esm/api/resources/agentVersions/client/Client.mjs

@@ -8,16 +8,19 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { mergeHeaders } from "../../../../core/headers.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
 import * as core from "../../../../core/index.mjs";
 import * as environments from "../../../../environments.mjs";
 import * as errors from "../../../../errors/index.mjs";
 import * as Apollo from "../../../index.mjs";
 export class AgentVersions {
-    constructor(_options = {}) {
+    constructor(_options) {
         this._options = _options;
     }
     /**
+     * List an agent's versions, newest first. Filter by status, tag, label,
+     * or version number; set ``exclude_revisions`` to see only base versions.
+     *
      * @param {string} agentId
      * @param {Apollo.ListVersionsRequest} request
      * @param {AgentVersions.RequestOptions} requestOptions - Request-specific configuration.
@@ -40,7 +43,7 @@ export class AgentVersions {
     }
     __listVersions(agentId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
             const { filters, "page[size]": pageSize, "page[after]": pageAfter, "page[before]": pageBefore, sort_by: sortBy, sort_order: sortOrder, } = request;
             const _queryParams = {};
             _queryParams.filters = filters;
@@ -59,16 +62,19 @@ export class AgentVersions {
             if (sortOrder != null) {
                 _queryParams.sort_order = sortOrder;
             }
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                Authorization: yield this._getAuthorizationHeader(),
+                "x-organization-api-key": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationApiKey) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.organizationApiKey,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions`),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 60) * 1000,
+                maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
                 logging: this._options.logging,
             });
             if (_response.ok) {
@@ -116,6 +122,10 @@ export class AgentVersions {
         });
     }
     /**
+     * Create a new draft version — empty, from a template, or cloned from an
+     * existing version (``source`` selects which). Drafts stay editable until
+     * published.
+     *
      * @param {string} agentId
      * @param {Apollo.AgentVersionCreateRequest} request
      * @param {AgentVersions.RequestOptions} requestOptions - Request-specific configuration.
@@ -138,20 +148,23 @@ export class AgentVersions {
     }
     __createVersion(agentId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                Authorization: yield this._getAuthorizationHeader(),
+                "x-organization-api-key": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationApiKey) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.organizationApiKey,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions`),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions`),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
                 body: request,
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 60) * 1000,
+                maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
                 logging: this._options.logging,
             });
             if (_response.ok) {
@@ -199,6 +212,9 @@ export class AgentVersions {
         });
     }
     /**
+     * Update a version's metadata: label, tags, and notes. The configuration
+     * itself changes through push, never here.
+     *
      * @param {string} agentId
      * @param {string} versionId
      * @param {Apollo.AgentVersionUpdateRequest} request
@@ -220,20 +236,23 @@ export class AgentVersions {
     }
     __updateVersion(agentId_1, versionId_1) {
         return __awaiter(this, arguments, void 0, function* (agentId, versionId, request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                Authorization: yield this._getAuthorizationHeader(),
+                "x-organization-api-key": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationApiKey) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.organizationApiKey,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions/${core.url.encodePathParam(versionId)}`),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions/${core.url.encodePathParam(versionId)}`),
                 method: "PATCH",
                 headers: _headers,
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
                 body: request,
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 60) * 1000,
+                maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
                 logging: this._options.logging,
             });
             if (_response.ok) {
@@ -281,6 +300,10 @@ export class AgentVersions {
         });
     }
     /**
+     * Make this version the agent's live version. Publishing a draft freezes
+     * it first; publishing an already-published version re-activates it — the
+     * same call handles shipping, switching, and rolling back.
+     *
      * @param {string} agentId
      * @param {string} versionId
      * @param {AgentVersions.RequestOptions} requestOptions - Request-specific configuration.
@@ -301,17 +324,20 @@ export class AgentVersions {
     }
     __publishVersion(agentId, versionId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                Authorization: yield this._getAuthorizationHeader(),
+                "x-organization-api-key": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationApiKey) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.organizationApiKey,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions/${core.url.encodePathParam(versionId)}/publish`),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions/${core.url.encodePathParam(versionId)}/publish`),
                 method: "POST",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 60) * 1000,
+                maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
                 logging: this._options.logging,
             });
             if (_response.ok) {
@@ -359,6 +385,9 @@ export class AgentVersions {
         });
     }
     /**
+     * Archive a version to retire it from everyday use. The agent's live
+     * version can't be archived — publish another version first.
+     *
      * @param {string} agentId
      * @param {string} versionId
      * @param {AgentVersions.RequestOptions} requestOptions - Request-specific configuration.
@@ -379,17 +408,20 @@ export class AgentVersions {
     }
     __archiveVersion(agentId, versionId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                Authorization: yield this._getAuthorizationHeader(),
+                "x-organization-api-key": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationApiKey) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.organizationApiKey,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions/${core.url.encodePathParam(versionId)}/archive`),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions/${core.url.encodePathParam(versionId)}/archive`),
                 method: "POST",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 60) * 1000,
+                maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
                 logging: this._options.logging,
             });
             if (_response.ok) {
@@ -437,6 +469,9 @@ export class AgentVersions {
         });
     }
     /**
+     * Upload a configuration bundle to a version, committing a new revision.
+     * The response carries the new revision's tag and content digest.
+     *
      * @param {string} agentId
      * @param {string} versionId
      * @param {Apollo.AgentVersionPushRequest} request
@@ -463,20 +498,23 @@ export class AgentVersions {
     }
     __pushVersion(agentId, versionId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                Authorization: yield this._getAuthorizationHeader(),
+                "x-organization-api-key": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationApiKey) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.organizationApiKey,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions/${core.url.encodePathParam(versionId)}/push`),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions/${core.url.encodePathParam(versionId)}/push`),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
                 body: request,
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 60) * 1000,
+                maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
                 logging: this._options.logging,
             });
             if (_response.ok) {
@@ -524,6 +562,9 @@ export class AgentVersions {
         });
     }
     /**
+     * Download a version's configuration bundle — the current revision, or a
+     * specific one via ``version_tag``.
+     *
      * @param {string} agentId
      * @param {string} versionId
      * @param {Apollo.PullVersionRequest} request
@@ -547,22 +588,25 @@ export class AgentVersions {
     }
     __pullVersion(agentId_1, versionId_1) {
         return __awaiter(this, arguments, void 0, function* (agentId, versionId, request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
             const { version_tag: versionTag } = request;
             const _queryParams = {};
             if (versionTag != null) {
                 _queryParams.version_tag = versionTag;
             }
-            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                Authorization: yield this._getAuthorizationHeader(),
+                "x-organization-api-key": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationApiKey) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.organizationApiKey,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions/${core.url.encodePathParam(versionId)}/pull`),
+                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ApolloEnvironment.Gcp).base, `management/v1/agents/${core.url.encodePathParam(agentId)}/versions/${core.url.encodePathParam(versionId)}/pull`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
-                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
-                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 60) * 1000,
+                maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
                 logging: this._options.logging,
             });
             if (_response.ok) {
@@ -609,4 +653,13 @@ export class AgentVersions {
             }
         });
     }
+    _getAuthorizationHeader() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const bearer = yield core.Supplier.get(this._options.token);
+            if (bearer != null) {
+                return `Bearer ${bearer}`;
+            }
+            return undefined;
+        });
+    }
 }

package/dist/esm/api/resources/agentVersions/client/requests/AgentVersionPushRequest.d.mts

@@ -10,7 +10,7 @@
 export interface AgentVersionPushRequest {
     caller: AgentVersionPushRequest.Caller;
     commit_message?: string;
-    /** Versioned agent-settings bundle. Must include 'schema_version' and 'general_settings'. */
+    /** Versioned agent configuration bundle. Must include 'schema_version' and 'general_settings'. */
     bundle: Record<string, unknown>;
 }
 export declare namespace AgentVersionPushRequest {

package/dist/esm/api/resources/agents/client/Client.d.mts

@@ -9,8 +9,10 @@ export declare namespace Agents {
 }
 export declare class Agents {
     protected readonly _options: Agents.Options;
-    constructor(_options?: Agents.Options);
+    constructor(_options: Agents.Options);
     /**
+     * List the project's agents, optionally filtered by name.
+     *
      * @param {string} projectId
      * @param {Apollo.ListAgentsRequest} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -28,11 +30,14 @@ export declare class Agents {
      *         filters: {}
      *     })
      */
-    listAgents(projectId: string, request: Apollo.ListAgentsRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Apollo.ExternalPageExternalAgent>;
+    listAgents(projectId: string, request: Apollo.ListAgentsRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Apollo.PageAgent>;
     private __listAgents;
     /**
+     * Create an agent in the project. New agents start without a live version
+     * — create and publish a version to make the agent answer.
+     *
      * @param {string} projectId
-     * @param {Apollo.ExternalAgentCreateRequest} request
+     * @param {Apollo.AgentCreateRequest} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Apollo.BadRequestError}
@@ -48,9 +53,11 @@ export declare class Agents {
      *         name: "name"
      *     })
      */
-    createAgent(projectId: string, request: Apollo.ExternalAgentCreateRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Apollo.ExternalAgentCreateResponse>;
+    createAgent(projectId: string, request: Apollo.AgentCreateRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Apollo.AgentCreateResponse>;
     private __createAgent;
     /**
+     * Fetch one agent, including which version is currently live.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -65,9 +72,11 @@ export declare class Agents {
      * @example
      *     await client.agents.getAgent("agentId")
      */
-    getAgent(agentId: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Apollo.ExternalAgent>;
+    getAgent(agentId: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Apollo.Agent>;
     private __getAgent;
     /**
+     * Delete an agent and all of its versions. This cannot be undone.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -85,8 +94,11 @@ export declare class Agents {
     deleteAgent(agentId: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<void>;
     private __deleteAgent;
     /**
+     * Rename an agent. To change which version is live, publish a version
+     * instead.
+     *
      * @param {string} agentId
-     * @param {Apollo.ExternalAgentUpdateRequest} request
+     * @param {Apollo.AgentUpdateRequest} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Apollo.BadRequestError}
@@ -100,9 +112,11 @@ export declare class Agents {
      * @example
      *     await client.agents.updateAgent("agentId")
      */
-    updateAgent(agentId: string, request?: Apollo.ExternalAgentUpdateRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Apollo.ExternalAgentUpdateResponse>;
+    updateAgent(agentId: string, request?: Apollo.AgentUpdateRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Apollo.AgentUpdateResponse>;
     private __updateAgent;
     /**
+     * Usage metrics for one agent, optionally bounded by a date range.
+     *
      * @param {string} agentId
      * @param {Apollo.GetAgentUsageRequest} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -123,4 +137,5 @@ export declare class Agents {
      */
     getAgentUsage(agentId: string, request?: Apollo.GetAgentUsageRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Apollo.UsageResponse>;
     private __getAgentUsage;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
 }