mavenagi 1.2.48 → 1.2.49

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.49",
+        "User-Agent": "mavenagi/1.2.49",
         "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/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,6 +110,7 @@ export * from "./InboxItemMissingKnowledge";
 export * from "./InboxItemSeverity";
 export * from "./InboxItemStatus";
 export * from "./InboxItemType";
+export * from "./InitializeConversationResponse";
 export * from "./IntelligentFieldCondition";
 export * from "./IntelligentFieldPrecondition";
 export * from "./IntelligentFieldPreconditionResponse";

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,6 +126,7 @@ __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);

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/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.49",
     "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>

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

@@ -0,0 +1,11 @@
+import type * as MavenAGI from "../../../../api/index";
+import * as core from "../../../../core";
+import type * as serializers from "../../../index";
+import { ConversationKickoffStatus } from "./ConversationKickoffStatus";
+export declare const ConversationKickoffResult: core.serialization.ObjectSchema<serializers.ConversationKickoffResult.Raw, MavenAGI.ConversationKickoffResult>;
+export declare namespace ConversationKickoffResult {
+    interface Raw {
+        status: ConversationKickoffStatus.Raw;
+        message?: string | null;
+    }
+}

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

@@ -0,0 +1,43 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationKickoffResult = void 0;
+const core = __importStar(require("../../../../core"));
+const ConversationKickoffStatus_1 = require("./ConversationKickoffStatus");
+exports.ConversationKickoffResult = core.serialization.object({
+    status: ConversationKickoffStatus_1.ConversationKickoffStatus,
+    message: core.serialization.string().optional(),
+});

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

@@ -0,0 +1,7 @@
+import type * as MavenAGI from "../../../../api/index";
+import * as core from "../../../../core";
+import type * as serializers from "../../../index";
+export declare const ConversationKickoffStatus: core.serialization.Schema<serializers.ConversationKickoffStatus.Raw, MavenAGI.ConversationKickoffStatus>;
+export declare namespace ConversationKickoffStatus {
+    type Raw = "SUCCESS" | "FAILED";
+}

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

@@ -0,0 +1,39 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationKickoffStatus = void 0;
+const core = __importStar(require("../../../../core"));
+exports.ConversationKickoffStatus = core.serialization.forwardCompatibleEnum_(["SUCCESS", "FAILED"]);

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

@@ -6,5 +6,6 @@ export declare namespace ConversationMessageBase {
     interface Raw {
         createdAt?: string | null;
         updatedAt?: string | null;
+        appMetadata?: Record<string, string> | null;
     }
 }

package/serialization/resources/commons/types/ConversationMessageBase.js

@@ -39,4 +39,5 @@ const core = __importStar(require("../../../../core"));
 exports.ConversationMessageBase = core.serialization.object({
     createdAt: core.serialization.date().optional(),
     updatedAt: core.serialization.date().optional(),
+    appMetadata: core.serialization.record(core.serialization.string(), core.serialization.string()).optional(),
 });

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

@@ -7,6 +7,9 @@ export declare namespace ConversationSummary {
     interface Raw {
         actionIds: EntityIdWithoutAgent.Raw[];
         incompleteActionIds: EntityIdWithoutAgent.Raw[];
+        matchedCharterIds: EntityIdWithoutAgent.Raw[];
+        matchedCharterNames: string[];
+        matchedSegmentedCharterNames: string[];
         insertCount: number;
         thumbsUpCount: number;
         thumbsDownCount: number;

package/serialization/resources/commons/types/ConversationSummary.js

@@ -40,6 +40,9 @@ const EntityIdWithoutAgent_1 = require("./EntityIdWithoutAgent");
 exports.ConversationSummary = core.serialization.object({
     actionIds: core.serialization.list(EntityIdWithoutAgent_1.EntityIdWithoutAgent),
     incompleteActionIds: core.serialization.list(EntityIdWithoutAgent_1.EntityIdWithoutAgent),
+    matchedCharterIds: core.serialization.list(EntityIdWithoutAgent_1.EntityIdWithoutAgent),
+    matchedCharterNames: core.serialization.list(core.serialization.string()),
+    matchedSegmentedCharterNames: core.serialization.list(core.serialization.string()),
     insertCount: core.serialization.number(),
     thumbsUpCount: core.serialization.number(),
     thumbsDownCount: core.serialization.number(),

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

@@ -3,5 +3,5 @@ import * as core from "../../../../core";
 import type * as serializers from "../../../index";
 export declare const EntityType: core.serialization.Schema<serializers.EntityType.Raw, MavenAGI.EntityType>;
 export declare namespace EntityType {
-    type Raw = "AGENT" | "CONVERSATION" | "CONVERSATION_MESSAGE" | "KNOWLEDGE_BASE" | "KNOWLEDGE_BASE_VERSION" | "KNOWLEDGE_DOCUMENT" | "ACTION" | "USER" | "EVENT" | "EVENT_TRIGGER" | "USER_PROFILE" | "FEEDBACK" | "INBOX_ITEM" | "INBOX_ITEM_FIX" | "SEGMENT" | "CUSTOMER" | "INTELLIGENT_FIELD" | "CHARTER";
+    type Raw = "AGENT" | "CONVERSATION" | "CONVERSATION_MESSAGE" | "KNOWLEDGE_BASE" | "KNOWLEDGE_BASE_VERSION" | "KNOWLEDGE_DOCUMENT" | "ACTION" | "USER" | "EVENT" | "EVENT_TRIGGER" | "USER_PROFILE" | "FEEDBACK" | "INBOX_ITEM" | "INBOX_ITEM_FIX" | "SEGMENT" | "CUSTOMER" | "INTELLIGENT_FIELD" | "CHARTER" | "CONVERSATION_KICKOFF" | "AGENT_VARIANT" | "CONFIG_SNAPSHOT";
 }

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

@@ -55,4 +55,7 @@ exports.EntityType = core.serialization.forwardCompatibleEnum_([
     "CUSTOMER",
     "INTELLIGENT_FIELD",
     "CHARTER",
+    "CONVERSATION_KICKOFF",
+    "AGENT_VARIANT",
+    "CONFIG_SNAPSHOT",
 ]);

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

@@ -0,0 +1,11 @@
+import type * as MavenAGI from "../../../../api/index";
+import * as core from "../../../../core";
+import type * as serializers from "../../../index";
+import { ConversationKickoffResult } from "./ConversationKickoffResult";
+import { ConversationResponse } from "./ConversationResponse";
+export declare const InitializeConversationResponse: core.serialization.ObjectSchema<serializers.InitializeConversationResponse.Raw, MavenAGI.InitializeConversationResponse>;
+export declare namespace InitializeConversationResponse {
+    interface Raw extends ConversationResponse.Raw {
+        conversationKickoffResult?: ConversationKickoffResult.Raw | null;
+    }
+}

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

@@ -0,0 +1,45 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InitializeConversationResponse = void 0;
+const core = __importStar(require("../../../../core"));
+const ConversationKickoffResult_1 = require("./ConversationKickoffResult");
+const ConversationResponse_1 = require("./ConversationResponse");
+exports.InitializeConversationResponse = core.serialization
+    .object({
+    conversationKickoffResult: ConversationKickoffResult_1.ConversationKickoffResult.optional(),
+})
+    .extend(ConversationResponse_1.ConversationResponse);

package/serialization/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,6 +110,7 @@ export * from "./InboxItemMissingKnowledge";
 export * from "./InboxItemSeverity";
 export * from "./InboxItemStatus";
 export * from "./InboxItemType";
+export * from "./InitializeConversationResponse";
 export * from "./IntelligentFieldCondition";
 export * from "./IntelligentFieldPrecondition";
 export * from "./IntelligentFieldPreconditionResponse";

package/serialization/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,6 +126,7 @@ __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);

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

@@ -12,5 +12,6 @@ export declare namespace AskRequest {
         attachments?: AttachmentRequest.Raw[] | null;
         transientData?: Record<string, string> | null;
         timezone?: string | null;
+        appMetadata?: Record<string, string> | null;
     }
 }

package/serialization/resources/conversation/types/AskRequest.js

@@ -45,4 +45,5 @@ exports.AskRequest = core.serialization.object({
     attachments: core.serialization.list(AttachmentRequest_1.AttachmentRequest).optional(),
     transientData: core.serialization.record(core.serialization.string(), core.serialization.string()).optional(),
     timezone: core.serialization.string().optional(),
+    appMetadata: core.serialization.record(core.serialization.string(), core.serialization.string()).optional(),
 });

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

@@ -3,5 +3,5 @@ import * as core from "../../../../core";
 import type * as serializers from "../../../index";
 export declare const KnowledgeBaseIndexingStatus: core.serialization.Schema<serializers.KnowledgeBaseIndexingStatus.Raw, MavenAGI.KnowledgeBaseIndexingStatus>;
 export declare namespace KnowledgeBaseIndexingStatus {
-    type Raw = "BUILDING" | "INDEXING" | "INDEXED" | "PUBLISHED" | "FAILED" | "SUPERSEDED";
+    type Raw = "BUILDING" | "INDEXING" | "INDEXED" | "PUBLISHED" | "ROLLING_BACK" | "FAILED" | "SUPERSEDED" | "ROLLED_BACK";
 }

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

@@ -36,4 +36,13 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KnowledgeBaseIndexingStatus = void 0;
 const core = __importStar(require("../../../../core"));
-exports.KnowledgeBaseIndexingStatus = core.serialization.forwardCompatibleEnum_(["BUILDING", "INDEXING", "INDEXED", "PUBLISHED", "FAILED", "SUPERSEDED"]);
+exports.KnowledgeBaseIndexingStatus = core.serialization.forwardCompatibleEnum_([
+    "BUILDING",
+    "INDEXING",
+    "INDEXED",
+    "PUBLISHED",
+    "ROLLING_BACK",
+    "FAILED",
+    "SUPERSEDED",
+    "ROLLED_BACK",
+]);

package/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.2.48";
+export declare const SDK_VERSION = "1.2.49";

package/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "1.2.48";
+exports.SDK_VERSION = "1.2.49";