mavenagi 1.2.48 → 1.2.50

package/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "mavenagi",
-        "X-Fern-SDK-Version": "1.2.48",
-        "User-Agent": "mavenagi/1.2.48",
+        "X-Fern-SDK-Version": "1.2.50",
+        "User-Agent": "mavenagi/1.2.50",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "X-Organization-Id": options === null || options === void 0 ? void 0 : options.organizationId,

package/api/resources/commons/types/ConversationKickoffResult.d.ts

@@ -0,0 +1,7 @@
+import type * as MavenAGI from "../../../index";
+export interface ConversationKickoffResult {
+    /** Whether the Conversation Kickoff completed successfully. */
+    status: MavenAGI.ConversationKickoffStatus;
+    /** Additional detail about the Conversation Kickoff result. */
+    message?: string;
+}

package/api/resources/commons/types/ConversationKickoffResult.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/resources/commons/types/ConversationKickoffStatus.d.ts

@@ -0,0 +1,5 @@
+export declare const ConversationKickoffStatus: {
+    readonly Success: "SUCCESS";
+    readonly Failed: "FAILED";
+};
+export type ConversationKickoffStatus = (typeof ConversationKickoffStatus)[keyof typeof ConversationKickoffStatus] | string;

package/api/resources/commons/types/ConversationKickoffStatus.js

@@ -0,0 +1,8 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationKickoffStatus = void 0;
+exports.ConversationKickoffStatus = {
+    Success: "SUCCESS",
+    Failed: "FAILED",
+};

package/api/resources/commons/types/ConversationMessageBase.d.ts

@@ -3,4 +3,13 @@ export interface ConversationMessageBase {
     createdAt?: Date;
     /** The date and time the conversation was last updated */
     updatedAt?: Date;
+    /**
+     * Key-value metadata for this message, supplied by the app which created the message.
+     * Useful for storing additional structured information about the message and querying
+     * for it via API or the dashboard.
+     *
+     * Keys are strings with a maximum length of 500 characters. Values are strings with a
+     * maximum length of 500 characters.
+     */
+    appMetadata?: Record<string, string>;
 }

package/api/resources/commons/types/ConversationResponse.d.ts

@@ -20,6 +20,9 @@ import type * as MavenAGI from "../../../index";
  *         summary: {
  *             actionIds: [],
  *             incompleteActionIds: [],
+ *             matchedCharterIds: [],
+ *             matchedCharterNames: [],
+ *             matchedSegmentedCharterNames: [],
  *             insertCount: 0,
  *             thumbsUpCount: 0,
  *             thumbsDownCount: 0,

package/api/resources/commons/types/ConversationSummary.d.ts

@@ -4,6 +4,12 @@ export interface ConversationSummary {
     actionIds: MavenAGI.EntityIdWithoutAgent[];
     /** The IDs of the actions that were taken by Maven but not completed in the conversation. Occurs when the user is shown an action form but does not submit it. */
     incompleteActionIds: MavenAGI.EntityIdWithoutAgent[];
+    /** The IDs of the charters that were matched anywhere in the conversation. */
+    matchedCharterIds: MavenAGI.EntityIdWithoutAgent[];
+    /** The names of the charters that were matched anywhere in the conversation. */
+    matchedCharterNames: string[];
+    /** The names of the matched charters that are gated by a segment (i.e. have a segment condition) anywhere in the conversation. */
+    matchedSegmentedCharterNames: string[];
     /** The number of insert events on messages in the conversation. */
     insertCount: number;
     /** The number of thumbs up events on messages in the conversation. */

package/api/resources/commons/types/EntityType.d.ts

@@ -17,5 +17,8 @@ export declare const EntityType: {
     readonly Customer: "CUSTOMER";
     readonly IntelligentField: "INTELLIGENT_FIELD";
     readonly Charter: "CHARTER";
+    readonly ConversationKickoff: "CONVERSATION_KICKOFF";
+    readonly AgentVariant: "AGENT_VARIANT";
+    readonly ConfigSnapshot: "CONFIG_SNAPSHOT";
 };
 export type EntityType = (typeof EntityType)[keyof typeof EntityType] | string;

package/api/resources/commons/types/EntityType.js

@@ -21,4 +21,7 @@ exports.EntityType = {
     Customer: "CUSTOMER",
     IntelligentField: "INTELLIGENT_FIELD",
     Charter: "CHARTER",
+    ConversationKickoff: "CONVERSATION_KICKOFF",
+    AgentVariant: "AGENT_VARIANT",
+    ConfigSnapshot: "CONFIG_SNAPSHOT",
 };

package/api/resources/commons/types/InitializeConversationResponse.d.ts

@@ -0,0 +1,14 @@
+import type * as MavenAGI from "../../../index";
+/**
+ * A conversation as returned by the `initialize` endpoint. Extends the shared
+ * ConversationResponse with the Conversation Kickoff result, which is only available at
+ * initialization time.
+ */
+export interface InitializeConversationResponse extends MavenAGI.ConversationResponse {
+    /**
+     * Result of the Conversation Kickoff, when one ran during conversation initialization.
+     * Only present on this initialize response; other endpoints that return a conversation
+     * do not include it.
+     */
+    conversationKickoffResult?: MavenAGI.ConversationKickoffResult;
+}

package/api/resources/commons/types/InitializeConversationResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/resources/commons/types/IntelligentFieldCondition.d.ts

@@ -13,7 +13,7 @@ import type * as MavenAGI from "../../../index";
  * The caller is responsible for querying the validationType and enumOptions
  * from the intelligent field API to ensure the values are valid enumOptions.
  */
-export type IntelligentFieldCondition = MavenAGI.IntelligentFieldCondition.String | MavenAGI.IntelligentFieldCondition.Numeric | MavenAGI.IntelligentFieldCondition.Boolean | MavenAGI.IntelligentFieldCondition.Set;
+export type IntelligentFieldCondition = MavenAGI.IntelligentFieldCondition.String | MavenAGI.IntelligentFieldCondition.Numeric | MavenAGI.IntelligentFieldCondition.Boolean | MavenAGI.IntelligentFieldCondition.Set | MavenAGI.IntelligentFieldCondition.Universal;
 export declare namespace IntelligentFieldCondition {
     interface String {
         fieldValidationType: "string";
@@ -30,4 +30,8 @@ export declare namespace IntelligentFieldCondition {
         fieldValidationType: "set";
         value: MavenAGI.SetCondition;
     }
+    interface Universal {
+        fieldValidationType: "universal";
+        value: MavenAGI.UniversalCondition;
+    }
 }

package/api/resources/commons/types/JsonSchemaSettingsSchemaEntry.d.ts

@@ -0,0 +1,6 @@
+import type * as MavenAGI from "../../../index";
+export interface JsonSchemaSettingsSchemaEntry extends MavenAGI.SettingsSchemaEntryBase {
+    /** JSON Schema (as a JSON string) describing the expected shape of this setting's value. */
+    jsonSchema: string;
+    defaultValue?: unknown;
+}

package/api/resources/commons/types/JsonSchemaSettingsSchemaEntry.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/resources/commons/types/PresenceCondition.d.ts

@@ -0,0 +1,9 @@
+import type * as MavenAGI from "../../../index";
+/**
+ * A type-independent check on whether an intelligent field is determined or
+ * undetermined. Works for every field validationType.
+ */
+export interface PresenceCondition {
+    /** The presence operator to apply */
+    operator: MavenAGI.PresenceOperator;
+}

package/api/resources/commons/types/PresenceCondition.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/resources/commons/types/PresenceOperator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Type-independent operators that check whether an intelligent field has a
+ * determined value on the conversation, rather than comparing its value.
+ */
+export declare const PresenceOperator: {
+    /**
+     * The field has no determined value — the LLM could not determine one, the
+     * computation failed, is still running, or has not run. Surfaced to authors as
+     * the special "Undetermined" value. */
+    readonly IsUndetermined: "IS_UNDETERMINED";
+    /**
+     * The field has a determined (non-null) value. */
+    readonly IsDetermined: "IS_DETERMINED";
+};
+export type PresenceOperator = (typeof PresenceOperator)[keyof typeof PresenceOperator] | string;

package/api/resources/commons/types/PresenceOperator.js

@@ -0,0 +1,18 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PresenceOperator = void 0;
+/**
+ * Type-independent operators that check whether an intelligent field has a
+ * determined value on the conversation, rather than comparing its value.
+ */
+exports.PresenceOperator = {
+    /**
+     * The field has no determined value — the LLM could not determine one, the
+     * computation failed, is still running, or has not run. Surfaced to authors as
+     * the special "Undetermined" value. */
+    IsUndetermined: "IS_UNDETERMINED",
+    /**
+     * The field has a determined (non-null) value. */
+    IsDetermined: "IS_DETERMINED",
+};

package/api/resources/commons/types/SettingsSchemaEntry.d.ts

@@ -1,5 +1,5 @@
 import type * as MavenAGI from "../../../index";
-export type SettingsSchemaEntry = MavenAGI.SettingsSchemaEntry.Text | MavenAGI.SettingsSchemaEntry.Multiline | MavenAGI.SettingsSchemaEntry.Array | MavenAGI.SettingsSchemaEntry.Complexarray | MavenAGI.SettingsSchemaEntry.Color | MavenAGI.SettingsSchemaEntry.Image | MavenAGI.SettingsSchemaEntry.Checkbox | MavenAGI.SettingsSchemaEntry.Dropdown | MavenAGI.SettingsSchemaEntry.Section | MavenAGI.SettingsSchemaEntry.Oauth | MavenAGI.SettingsSchemaEntry.Number | MavenAGI.SettingsSchemaEntry.OneOf;
+export type SettingsSchemaEntry = MavenAGI.SettingsSchemaEntry.Text | MavenAGI.SettingsSchemaEntry.Multiline | MavenAGI.SettingsSchemaEntry.Array | MavenAGI.SettingsSchemaEntry.Complexarray | MavenAGI.SettingsSchemaEntry.Color | MavenAGI.SettingsSchemaEntry.Image | MavenAGI.SettingsSchemaEntry.Checkbox | MavenAGI.SettingsSchemaEntry.Switch | MavenAGI.SettingsSchemaEntry.Dropdown | MavenAGI.SettingsSchemaEntry.Section | MavenAGI.SettingsSchemaEntry.Oauth | MavenAGI.SettingsSchemaEntry.Number | MavenAGI.SettingsSchemaEntry.OneOf | MavenAGI.SettingsSchemaEntry.JsonSchema;
 export declare namespace SettingsSchemaEntry {
     interface Text extends MavenAGI.TextSettingsSchemaEntry {
         type: "text";
@@ -22,6 +22,9 @@ export declare namespace SettingsSchemaEntry {
     interface Checkbox extends MavenAGI.CheckboxSettingsSchemaEntry {
         type: "checkbox";
     }
+    interface Switch extends MavenAGI.SwitchSettingsSchemaEntry {
+        type: "switch";
+    }
     interface Dropdown extends MavenAGI.DropdownSettingsSchemaEntry {
         type: "dropdown";
     }
@@ -37,4 +40,7 @@ export declare namespace SettingsSchemaEntry {
     interface OneOf extends MavenAGI.OneOfSettingsSchemaEntry {
         type: "oneOf";
     }
+    interface JsonSchema extends MavenAGI.JsonSchemaSettingsSchemaEntry {
+        type: "jsonSchema";
+    }
 }

package/api/resources/commons/types/SwitchSettingsSchemaEntry.d.ts

@@ -0,0 +1,4 @@
+import type * as MavenAGI from "../../../index";
+export interface SwitchSettingsSchemaEntry extends MavenAGI.SettingsSchemaEntryBase {
+    defaultValue?: boolean;
+}

package/api/resources/commons/types/SwitchSettingsSchemaEntry.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/resources/commons/types/UniversalCondition.d.ts

@@ -0,0 +1,13 @@
+import type * as MavenAGI from "../../../index";
+/**
+ * Type-independent conditions that apply to any intelligent field regardless of its
+ * validationType. Currently only a presence (determined/undetermined) check. Modeled as
+ * its own discriminated union so future type-independent operators can be added without
+ * changing the top-level IntelligentFieldCondition union.
+ */
+export type UniversalCondition = MavenAGI.UniversalCondition.Presence;
+export declare namespace UniversalCondition {
+    interface Presence extends MavenAGI.PresenceCondition {
+        opType: "presence";
+    }
+}

package/api/resources/commons/types/UniversalCondition.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/resources/commons/types/index.d.ts

@@ -59,6 +59,8 @@ export * from "./ContextInfo";
 export * from "./ConversationAnalysis";
 export * from "./ConversationExecutedActionPrecondition";
 export * from "./ConversationInformation";
+export * from "./ConversationKickoffResult";
+export * from "./ConversationKickoffStatus";
 export * from "./ConversationMessageBase";
 export * from "./ConversationMessageResponse";
 export * from "./ConversationPrecondition";
@@ -108,11 +110,13 @@ export * from "./InboxItemMissingKnowledge";
 export * from "./InboxItemSeverity";
 export * from "./InboxItemStatus";
 export * from "./InboxItemType";
+export * from "./InitializeConversationResponse";
 export * from "./IntelligentFieldCondition";
 export * from "./IntelligentFieldPrecondition";
 export * from "./IntelligentFieldPreconditionResponse";
 export * from "./IntelligentFieldValueResponse";
 export * from "./IpInfo";
+export * from "./JsonSchemaSettingsSchemaEntry";
 export * from "./KnowledgeContextByEntities";
 export * from "./KnowledgeContextByEntityTypes";
 export * from "./KnowledgeContextFilter";
@@ -147,6 +151,8 @@ export * from "./PreconditionGroupOperator";
 export * from "./PreconditionGroupResponse";
 export * from "./PreconditionOperator";
 export * from "./PreconditionResponse";
+export * from "./PresenceCondition";
+export * from "./PresenceOperator";
 export * from "./Quality";
 export * from "./QualityReason";
 export * from "./ResolutionStatus";
@@ -179,10 +185,12 @@ export * from "./StringCondition";
 export * from "./StringMembershipCondition";
 export * from "./StringMembershipOperator";
 export * from "./SurveyInfo";
+export * from "./SwitchSettingsSchemaEntry";
 export * from "./SystemEvent";
 export * from "./SystemEventName";
 export * from "./TagsPrecondition";
 export * from "./TextSettingsSchemaEntry";
+export * from "./UniversalCondition";
 export * from "./UserConversationMessageType";
 export * from "./UserData";
 export * from "./UserDataWithReference";

package/api/resources/commons/types/index.js

@@ -75,6 +75,8 @@ __exportStar(require("./ContextInfo"), exports);
 __exportStar(require("./ConversationAnalysis"), exports);
 __exportStar(require("./ConversationExecutedActionPrecondition"), exports);
 __exportStar(require("./ConversationInformation"), exports);
+__exportStar(require("./ConversationKickoffResult"), exports);
+__exportStar(require("./ConversationKickoffStatus"), exports);
 __exportStar(require("./ConversationMessageBase"), exports);
 __exportStar(require("./ConversationMessageResponse"), exports);
 __exportStar(require("./ConversationPrecondition"), exports);
@@ -124,11 +126,13 @@ __exportStar(require("./InboxItemMissingKnowledge"), exports);
 __exportStar(require("./InboxItemSeverity"), exports);
 __exportStar(require("./InboxItemStatus"), exports);
 __exportStar(require("./InboxItemType"), exports);
+__exportStar(require("./InitializeConversationResponse"), exports);
 __exportStar(require("./IntelligentFieldCondition"), exports);
 __exportStar(require("./IntelligentFieldPrecondition"), exports);
 __exportStar(require("./IntelligentFieldPreconditionResponse"), exports);
 __exportStar(require("./IntelligentFieldValueResponse"), exports);
 __exportStar(require("./IpInfo"), exports);
+__exportStar(require("./JsonSchemaSettingsSchemaEntry"), exports);
 __exportStar(require("./KnowledgeContextByEntities"), exports);
 __exportStar(require("./KnowledgeContextByEntityTypes"), exports);
 __exportStar(require("./KnowledgeContextFilter"), exports);
@@ -163,6 +167,8 @@ __exportStar(require("./PreconditionGroupOperator"), exports);
 __exportStar(require("./PreconditionGroupResponse"), exports);
 __exportStar(require("./PreconditionOperator"), exports);
 __exportStar(require("./PreconditionResponse"), exports);
+__exportStar(require("./PresenceCondition"), exports);
+__exportStar(require("./PresenceOperator"), exports);
 __exportStar(require("./Quality"), exports);
 __exportStar(require("./QualityReason"), exports);
 __exportStar(require("./ResolutionStatus"), exports);
@@ -195,10 +201,12 @@ __exportStar(require("./StringCondition"), exports);
 __exportStar(require("./StringMembershipCondition"), exports);
 __exportStar(require("./StringMembershipOperator"), exports);
 __exportStar(require("./SurveyInfo"), exports);
+__exportStar(require("./SwitchSettingsSchemaEntry"), exports);
 __exportStar(require("./SystemEvent"), exports);
 __exportStar(require("./SystemEventName"), exports);
 __exportStar(require("./TagsPrecondition"), exports);
 __exportStar(require("./TextSettingsSchemaEntry"), exports);
+__exportStar(require("./UniversalCondition"), exports);
 __exportStar(require("./UserConversationMessageType"), exports);
 __exportStar(require("./UserData"), exports);
 __exportStar(require("./UserDataWithReference"), exports);

package/api/resources/conversation/client/Client.d.ts

@@ -55,7 +55,7 @@ export declare class ConversationClient {
      *             }]
      *     })
      */
-    initialize(request: MavenAGI.ConversationRequest, requestOptions?: ConversationClient.RequestOptions): core.HttpResponsePromise<MavenAGI.ConversationResponse>;
+    initialize(request: MavenAGI.ConversationRequest, requestOptions?: ConversationClient.RequestOptions): core.HttpResponsePromise<MavenAGI.InitializeConversationResponse>;
     private __initialize;
     /**
      * Update mutable conversation fields.

package/api/resources/conversation/client/Client.js

@@ -129,7 +129,7 @@ class ConversationClient {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.ConversationResponse.parseOrThrow(_response.body, {
+                    data: serializers.InitializeConversationResponse.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,

package/api/resources/conversation/types/AskRequest.d.ts

@@ -36,4 +36,13 @@ export interface AskRequest {
     transientData?: Record<string, string>;
     /** IANA timezone identifier (e.g. "America/New_York", "Europe/London") to be used for time-based operations in the conversation. */
     timezone?: string;
+    /**
+     * Key-value metadata to persist on the user message created by this request. Unlike
+     * `transientData` (which is never persisted) this is stored and returned when the message
+     * is read back via the API or dashboard, and unlike user data it is not sent to the LLM.
+     * Applied only when the message is first created — if `conversationMessageId` already
+     * exists the message is reused and its metadata is not updated. Keys and values are strings
+     * with a maximum length of 500 characters each.
+     */
+    appMetadata?: Record<string, string>;
 }

package/api/resources/conversation/types/ConversationField.d.ts

@@ -21,6 +21,7 @@ export declare const ConversationField: {
     readonly Languages: "Languages";
     readonly Actions: "Actions";
     readonly IncompleteActions: "IncompleteActions";
+    readonly Charters: "Charters";
     readonly Sources: "Sources";
     readonly CreatedAt: "CreatedAt";
     readonly PredictedNps: "PredictedNPS";

package/api/resources/conversation/types/ConversationField.js

@@ -25,6 +25,7 @@ exports.ConversationField = {
     Languages: "Languages",
     Actions: "Actions",
     IncompleteActions: "IncompleteActions",
+    Charters: "Charters",
     Sources: "Sources",
     CreatedAt: "CreatedAt",
     PredictedNps: "PredictedNPS",

package/api/resources/knowledge/client/Client.d.ts

@@ -111,6 +111,23 @@ export declare class KnowledgeClient {
      */
     cancelKnowledgeBaseVersion(knowledgeBaseReferenceId: string, request: MavenAGI.CancelKnowledgeBaseVersionRequest, requestOptions?: KnowledgeClient.RequestOptions): core.HttpResponsePromise<void>;
     private __cancelKnowledgeBaseVersion;
+    /**
+     * Rolls the knowledge base back to its previous published version.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to roll back. All other entity ID fields are inferred from the request.
+     * @param {KnowledgeClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.PayloadTooLargeError}
+     * @throws {@link MavenAGI.TooManyRequestsError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.rollbackKnowledgeBaseVersion("knowledgeBaseReferenceId")
+     */
+    rollbackKnowledgeBaseVersion(knowledgeBaseReferenceId: string, requestOptions?: KnowledgeClient.RequestOptions): core.HttpResponsePromise<void>;
+    private __rollbackKnowledgeBaseVersion;
     /**
      * Update mutable knowledge base fields
      *

package/api/resources/knowledge/client/Client.js

@@ -558,6 +558,94 @@ class KnowledgeClient {
             return (0, handleNonStatusCodeError_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/knowledge/{knowledgeBaseReferenceId}/cancel");
         });
     }
+    /**
+     * Rolls the knowledge base back to its previous published version.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to roll back. All other entity ID fields are inferred from the request.
+     * @param {KnowledgeClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.PayloadTooLargeError}
+     * @throws {@link MavenAGI.TooManyRequestsError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.rollbackKnowledgeBaseVersion("knowledgeBaseReferenceId")
+     */
+    rollbackKnowledgeBaseVersion(knowledgeBaseReferenceId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__rollbackKnowledgeBaseVersion(knowledgeBaseReferenceId, requestOptions));
+    }
+    __rollbackKnowledgeBaseVersion(knowledgeBaseReferenceId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({
+                "X-Organization-Id": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationId) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.organizationId,
+                "X-Agent-Id": (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.agentId) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.agentId,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_f = this._options.fetcher) !== null && _f !== void 0 ? _f : core.fetcher)({
+                url: core.url.join((_h = (_g = (yield core.Supplier.get(this._options.baseUrl))) !== null && _g !== void 0 ? _g : (yield core.Supplier.get(this._options.environment))) !== null && _h !== void 0 ? _h : environments.MavenAGIEnvironment.Production, `/v1/knowledge/${core.url.encodePathParam(knowledgeBaseReferenceId)}/rollback`),
+                method: "POST",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_l = (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.timeoutInSeconds) !== null && _l !== void 0 ? _l : 60) * 1000,
+                maxRetries: (_m = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _m !== void 0 ? _m : (_o = this._options) === null || _o === void 0 ? void 0 : _o.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_p = this._options) === null || _p === void 0 ? void 0 : _p.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: undefined, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new MavenAGI.NotFoundError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 400:
+                        throw new MavenAGI.BadRequestError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 413:
+                        throw new MavenAGI.PayloadTooLargeError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 429:
+                        throw new MavenAGI.TooManyRequestsError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 500:
+                        throw new MavenAGI.ServerError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.MavenAGIError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/knowledge/{knowledgeBaseReferenceId}/rollback");
+        });
+    }
     /**
      * Update mutable knowledge base fields
      *

package/api/resources/knowledge/types/KnowledgeBaseIndexingStatus.d.ts

@@ -4,7 +4,9 @@ export declare const KnowledgeBaseIndexingStatus: {
     readonly Indexing: "INDEXING";
     readonly Indexed: "INDEXED";
     readonly Published: "PUBLISHED";
+    readonly RollingBack: "ROLLING_BACK";
     readonly Failed: "FAILED";
     readonly Superseded: "SUPERSEDED";
+    readonly RolledBack: "ROLLED_BACK";
 };
 export type KnowledgeBaseIndexingStatus = (typeof KnowledgeBaseIndexingStatus)[keyof typeof KnowledgeBaseIndexingStatus] | string;

package/api/resources/knowledge/types/KnowledgeBaseIndexingStatus.js

@@ -8,6 +8,8 @@ exports.KnowledgeBaseIndexingStatus = {
     Indexing: "INDEXING",
     Indexed: "INDEXED",
     Published: "PUBLISHED",
+    RollingBack: "ROLLING_BACK",
     Failed: "FAILED",
     Superseded: "SUPERSEDED",
+    RolledBack: "ROLLED_BACK",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mavenagi",
-    "version": "1.2.48",
+    "version": "1.2.50",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -1681,7 +1681,7 @@ await client.assets.commitUpload("assetReferenceId", {});
 </details>
 
 ## Conversation
-<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">initialize</a>({ ...params }) -> MavenAGI.ConversationResponse</code></summary>
+<details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">initialize</a>({ ...params }) -> MavenAGI.InitializeConversationResponse</code></summary>
 <dl>
 <dd>
 
@@ -4455,6 +4455,69 @@ await client.knowledge.cancelKnowledgeBaseVersion("knowledgeBaseReferenceId", {}
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">rollbackKnowledgeBaseVersion</a>(knowledgeBaseReferenceId) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Rolls the knowledge base back to its previous published version.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.knowledge.rollbackKnowledgeBaseVersion("knowledgeBaseReferenceId");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to roll back. All other entity ID fields are inferred from the request.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `KnowledgeClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>