mavenagi 1.2.4 → 1.2.6

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

@@ -347,6 +347,99 @@ class Knowledge {
             }
         });
     }
+    /**
+     * Request that a knowledge base refresh itself.
+     *
+     * Knowledge bases refresh on a schedule determined by the `refreshFrequency` field.
+     * They can also be refreshed on demand by calling this endpoint.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to refresh. All other entity ID fields are inferred from the request.
+     * @param {MavenAGI.KnowledgeBaseRefreshRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.refreshKnowledgeBase("help-center", {
+     *         appId: "readme"
+     *     })
+     */
+    refreshKnowledgeBase(knowledgeBaseReferenceId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__refreshKnowledgeBase(knowledgeBaseReferenceId, request, requestOptions));
+    }
+    __refreshKnowledgeBase(knowledgeBaseReferenceId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            let _headers = (0, headers_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({
+                Authorization: yield this._getAuthorizationHeader(),
+                "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/${encodeURIComponent(knowledgeBaseReferenceId)}/refresh`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.KnowledgeBaseRefreshRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            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 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,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.MavenAGIError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.MavenAGITimeoutError("Timeout exceeded when calling POST /v1/knowledge/{knowledgeBaseReferenceId}/refresh.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Update mutable knowledge base fields
      *
@@ -362,7 +455,17 @@ class Knowledge {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.knowledge.patchKnowledgeBase("knowledgeBaseReferenceId")
+     *     await client.knowledge.patchKnowledgeBase("help-center", {
+     *         name: "Updated Help Center",
+     *         tags: new Set(["tag1", "tag2", "tag3"]),
+     *         segmentId: {
+     *             referenceId: "premium-users",
+     *             appId: "readme",
+     *             organizationId: "acme",
+     *             agentId: "support",
+     *             type: "SEGMENT"
+     *         }
+     *     })
      */
     patchKnowledgeBase(knowledgeBaseReferenceId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__patchKnowledgeBase(knowledgeBaseReferenceId, request, requestOptions));

package/api/resources/knowledge/client/requests/KnowledgeBasePatchRequest.d.ts

@@ -1,7 +1,17 @@
 import * as MavenAGI from "../../../../index";
 /**
  * @example
- *     {}
+ *     {
+ *         name: "Updated Help Center",
+ *         tags: new Set(["tag1", "tag2", "tag3"]),
+ *         segmentId: {
+ *             referenceId: "premium-users",
+ *             appId: "readme",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: "SEGMENT"
+ *         }
+ *     }
  */
 export interface KnowledgeBasePatchRequest {
     /** The App ID of the knowledge base to patch. If not provided the ID of the calling app will be used. */

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

@@ -1,6 +1,4 @@
 export interface BaseKnowledgeDocument {
-    /** The title of the document. Will be shown as part of answers. */
-    title: string;
     /** The URL of the document. Should be visible to end users. Will be shown as part of answers. Not used for crawling. */
     url?: string;
     /** The document language. Must be a valid ISO 639-1 language code. */

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

@@ -1,5 +1,6 @@
 export declare const KnowledgeBaseField: {
     readonly Title: "Title";
+    readonly CreatedAt: "CreatedAt";
     readonly UpdatedAt: "UpdatedAt";
 };
 export type KnowledgeBaseField = (typeof KnowledgeBaseField)[keyof typeof KnowledgeBaseField];

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

@@ -4,5 +4,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.KnowledgeBaseField = void 0;
 exports.KnowledgeBaseField = {
     Title: "Title",
+    CreatedAt: "CreatedAt",
     UpdatedAt: "UpdatedAt",
 };

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

@@ -1,3 +1,4 @@
+import * as MavenAGI from "../../../index";
 export interface KnowledgeBaseFilter {
     /**
      * Full-text search query for matching knowledge bases by content.
@@ -22,4 +23,8 @@ export interface KnowledgeBaseFilter {
     createdBefore?: Date;
     /** Filter by app IDs */
     appIds?: string[];
+    /** Filter knowledge bases by the most recent version status */
+    mostRecentVersionStatus?: MavenAGI.KnowledgeBaseVersionStatus[];
+    /** Filter knowledge bases by the LLM inclusion status */
+    llmInclusionStatus?: MavenAGI.LlmInclusionStatus;
 }

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

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         appId: "readme"
+ *     }
+ */
+export interface KnowledgeBaseRefreshRequest {
+    /** The App ID of the knowledge base to refresh. If not provided the ID of the calling app will be used. */
+    appId?: string;
+}

package/api/resources/knowledge/types/KnowledgeBaseRefreshRequest.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/knowledge/types/KnowledgeBaseResponse.d.ts

@@ -2,6 +2,8 @@ import * as MavenAGI from "../../../index";
 /**
  * @example
  *     {
+ *         createdAt: new Date("2025-01-01T00:00:00.000Z"),
+ *         updatedAt: new Date("2025-02-02T00:00:00.000Z"),
  *         knowledgeBaseId: {
  *             referenceId: "help-center",
  *             appId: "readme",
@@ -9,20 +11,46 @@ import * as MavenAGI from "../../../index";
  *             agentId: "support",
  *             type: MavenAGI.EntityType.KnowledgeBase
  *         },
+ *         activeVersionId: {
+ *             referenceId: "version-1",
+ *             appId: "readme",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: MavenAGI.EntityType.KnowledgeBaseVersion
+ *         },
+ *         mostRecentVersionStatus: MavenAGI.KnowledgeBaseVersionStatus.Succeeded,
+ *         llmInclusionStatus: MavenAGI.LlmInclusionStatus.WhenRelevant,
  *         name: "Help center",
  *         type: MavenAGI.KnowledgeBaseType.Api,
  *         metadata: {
  *             "key": "value"
  *         },
  *         tags: new Set(["tag1", "tag2"]),
- *         refreshFrequency: MavenAGI.KnowledgeBaseRefreshFrequency.Daily
+ *         refreshFrequency: MavenAGI.KnowledgeBaseRefreshFrequency.Daily,
+ *         segmentId: {
+ *             referenceId: "premium-users",
+ *             appId: "readme",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: MavenAGI.EntityType.Segment
+ *         }
  *     }
  */
 export interface KnowledgeBaseResponse extends MavenAGI.KnowledgeBaseProperties {
+    /** The date and time when the knowledge base was created. */
+    createdAt: Date;
+    /** The date and time when the knowledge base was last updated. */
+    updatedAt: Date;
     /** ID that uniquely identifies this knowledge base */
     knowledgeBaseId: MavenAGI.EntityId;
     /** ID of the knowledge base version that is currently active. Documents can be fetched using this version ID. */
     activeVersionId?: MavenAGI.EntityId;
+    /**
+     * The status of the most recent version of the knowledge base.
+     * The `activeVersionId` will only be populated if this status is `SUCCEEDED`.
+     * Use the `listKnowledgeBaseVersions` endpoint to get the full list of versions.
+     */
+    mostRecentVersionStatus: MavenAGI.KnowledgeBaseVersionStatus;
     /** The type of the knowledge base. Can not be changed once created. */
     type: MavenAGI.KnowledgeBaseType;
     /** Metadata for the knowledge base. */

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

@@ -1,5 +1,12 @@
-/** API knowledge bases are managed by a Maven App. */
+/**
+ * API knowledge bases are managed by a Maven App.
+ * All other knowledge base types are deprecated and can not be created.
+ */
 export declare const KnowledgeBaseType: {
     readonly Api: "API";
+    readonly Url: "URL";
+    readonly Manual: "MANUAL";
+    readonly Rss: "RSS";
+    readonly Legacy: "LEGACY";
 };
 export type KnowledgeBaseType = (typeof KnowledgeBaseType)[keyof typeof KnowledgeBaseType];

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

@@ -2,7 +2,14 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KnowledgeBaseType = void 0;
-/** API knowledge bases are managed by a Maven App. */
+/**
+ * API knowledge bases are managed by a Maven App.
+ * All other knowledge base types are deprecated and can not be created.
+ */
 exports.KnowledgeBaseType = {
     Api: "API",
+    Url: "URL",
+    Manual: "MANUAL",
+    Rss: "RSS",
+    Legacy: "LEGACY",
 };

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

@@ -24,6 +24,8 @@ export interface KnowledgeDocumentRequest extends MavenAGI.BaseKnowledgeDocument
     /** ID that uniquely identifies which knowledge base version to create the document in. If not provided will use the most recent version of the knowledge base. */
     versionId?: MavenAGI.EntityIdWithoutAgent;
     contentType: MavenAGI.KnowledgeDocumentContentType;
+    /** The title of the document. Will be shown as part of answers. */
+    title: string;
     /** The content of the document. Not shown directly to users. May be provided in HTML or markdown. HTML will be converted to markdown automatically. Images are not currently supported and will be ignored. */
     content: string;
     /** Metadata for the knowledge document. */

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

@@ -7,4 +7,6 @@ export interface KnowledgeDocumentSearchResponse extends MavenAGI.BaseKnowledgeD
      * This may be missing on legacy documents.
      */
     knowledgeBaseVersionId?: MavenAGI.EntityId;
+    /** The title of the document. Will be shown as part of answers. May be missing on legacy documents. */
+    title?: string;
 }

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

@@ -24,3 +24,4 @@ export * from "./KnowledgeDocumentSearchRequest";
 export * from "./KnowledgeDocumentSearchResponse";
 export * from "./KnowledgeDocumentsResponse";
 export * from "./KnowledgeBaseVersionsListResponse";
+export * from "./KnowledgeBaseRefreshRequest";

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

@@ -40,3 +40,4 @@ __exportStar(require("./KnowledgeDocumentSearchRequest"), exports);
 __exportStar(require("./KnowledgeDocumentSearchResponse"), exports);
 __exportStar(require("./KnowledgeDocumentsResponse"), exports);
 __exportStar(require("./KnowledgeBaseVersionsListResponse"), exports);
+__exportStar(require("./KnowledgeBaseRefreshRequest"), exports);

package/dist/Client.js

@@ -59,8 +59,8 @@ class MavenAGIClient {
                 "X-Agent-Id": _options === null || _options === void 0 ? void 0 : _options.agentId,
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "mavenagi",
-                "X-Fern-SDK-Version": "1.2.4",
-                "User-Agent": "mavenagi/1.2.4",
+                "X-Fern-SDK-Version": "1.2.6",
+                "User-Agent": "mavenagi/1.2.6",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/api/resources/actions/client/Client.d.ts

@@ -115,7 +115,17 @@ export declare class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.patch("actionReferenceId")
+     *     await client.actions.patch("get-balance", {
+     *         instructions: "Use this action when the user asks about their account balance or remaining credits.",
+     *         llmInclusionStatus: "WHEN_RELEVANT",
+     *         segmentId: {
+     *             referenceId: "premium-users",
+     *             appId: "my-billing-system",
+     *             organizationId: "acme",
+     *             agentId: "support",
+     *             type: "SEGMENT"
+     *         }
+     *     })
      */
     patch(actionReferenceId: string, request?: MavenAGI.ActionPatchRequest, requestOptions?: Actions.RequestOptions): core.HttpResponsePromise<MavenAGI.ActionResponse>;
     private __patch;

package/dist/api/resources/actions/client/Client.js

@@ -375,7 +375,17 @@ class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.patch("actionReferenceId")
+     *     await client.actions.patch("get-balance", {
+     *         instructions: "Use this action when the user asks about their account balance or remaining credits.",
+     *         llmInclusionStatus: "WHEN_RELEVANT",
+     *         segmentId: {
+     *             referenceId: "premium-users",
+     *             appId: "my-billing-system",
+     *             organizationId: "acme",
+     *             agentId: "support",
+     *             type: "SEGMENT"
+     *         }
+     *     })
      */
     patch(actionReferenceId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__patch(actionReferenceId, request, requestOptions));

package/dist/api/resources/actions/client/requests/ActionPatchRequest.d.ts

@@ -1,7 +1,17 @@
 import * as MavenAGI from "../../../../index";
 /**
  * @example
- *     {}
+ *     {
+ *         instructions: "Use this action when the user asks about their account balance or remaining credits.",
+ *         llmInclusionStatus: "WHEN_RELEVANT",
+ *         segmentId: {
+ *             referenceId: "premium-users",
+ *             appId: "my-billing-system",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: "SEGMENT"
+ *         }
+ *     }
  */
 export interface ActionPatchRequest {
     /** The App ID of the action to patch. If not provided the ID of the calling app will be used. */

package/dist/api/resources/agentCapabilities/types/ActionCapability.d.ts

@@ -2,7 +2,7 @@ import * as MavenAGI from "../../../index";
 export interface ActionCapability extends MavenAGI.AgentCapabilityBase {
     userInteractionRequired: boolean;
     /** When user interaction is required, the name of the button that is shown to the end user to confirm execution of the action. Defaults to "Submit" if not supplied. */
-    buttonName: string | null;
+    buttonName?: string;
     /** The parameters that the action uses as input. An action will only be executed when all of the required parameters are provided. Parameter values may be inferred from the user's conversation by the LLM. */
     userFormParameters: MavenAGI.ActionParameter[];
     precondition?: MavenAGI.Precondition;

package/dist/api/resources/agents/client/Client.d.ts

@@ -128,9 +128,9 @@ export declare class Agents {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.agents.patch("organizationReferenceId", "agentReferenceId", {})
+     *     await client.agents.patch("organizationReferenceId", "agentReferenceId")
      */
-    patch(organizationReferenceId: string, agentReferenceId: string, request: MavenAGI.AgentPatchRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<MavenAGI.Agent>;
+    patch(organizationReferenceId: string, agentReferenceId: string, request?: MavenAGI.AgentPatchRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<MavenAGI.Agent>;
     private __patch;
     /**
      * Delete an agent.

package/dist/api/resources/agents/client/Client.js

@@ -460,13 +460,13 @@ class Agents {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.agents.patch("organizationReferenceId", "agentReferenceId", {})
+     *     await client.agents.patch("organizationReferenceId", "agentReferenceId")
      */
-    patch(organizationReferenceId, agentReferenceId, request, requestOptions) {
+    patch(organizationReferenceId, agentReferenceId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__patch(organizationReferenceId, agentReferenceId, request, requestOptions));
     }
-    __patch(organizationReferenceId, agentReferenceId, request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __patch(organizationReferenceId_1, agentReferenceId_1) {
+        return __awaiter(this, arguments, void 0, function* (organizationReferenceId, agentReferenceId, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h;
             let _headers = (0, headers_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({
                 Authorization: yield this._getAuthorizationHeader(),
@@ -477,7 +477,7 @@ class Agents {
                 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/organizations/${encodeURIComponent(organizationReferenceId)}/agents/${encodeURIComponent(agentReferenceId)}`),
                 method: "PATCH",
                 headers: _headers,
-                contentType: "application/json",
+                contentType: "application/merge-patch+json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
                 body: serializers.AgentPatchRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),

package/dist/api/resources/agents/client/index.d.ts

@@ -1 +1,2 @@
 export {};
+export * from "./requests";

package/dist/api/resources/agents/client/index.js

@@ -1,2 +1,17 @@
 "use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests"), exports);

package/dist/api/resources/agents/client/requests/AgentPatchRequest.d.ts

@@ -0,0 +1,27 @@
+import * as MavenAGI from "../../../../index";
+/**
+ * @example
+ *     {}
+ */
+export interface AgentPatchRequest {
+    /** The name of the agent. */
+    name?: string;
+    /** The environment of the agent. */
+    environment?: MavenAGI.AgentEnvironment;
+    /** The agent's default timezone. This is used when a timezone is not set on a conversation. */
+    defaultTimezone?: string;
+    /** The PII categories that are enabled for the agent. */
+    enabledPiiCategories?: Set<MavenAGI.PiiCategory>;
+    /** The system fallback message. */
+    systemFallbackMessage?: string | null;
+    /** The overall persona of the agent. */
+    persona?: MavenAGI.LlmPersona;
+    /** Additional text directly appended to the prompt. */
+    additionalPromptText?: string | null;
+    /** LLM prompt for category generation. */
+    categoryGenerationPromptText?: string | null;
+    /** LLM prompt for generating a response when the user's question has been detected as unsafe. */
+    contentSafetyViolationResponsePromptText?: string | null;
+    /** Return the system fallback message on all questions that have no relevant knowledge bases or actions. */
+    rejectQuestionsWithoutKnowledge?: boolean;
+}

package/dist/api/resources/agents/client/requests/AgentPatchRequest.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/dist/api/resources/agents/client/requests/index.d.ts

@@ -0,0 +1 @@
+export { type AgentPatchRequest } from "./AgentPatchRequest";

package/dist/api/resources/agents/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/agents/types/Agent.d.ts

@@ -20,4 +20,12 @@ export interface Agent {
      * `UsUkPassportNumber`, `UsSocialSecurityNumber`.
      */
     enabledPiiCategories: Set<MavenAGI.PiiCategory>;
+    /**
+     * Text shown to end users when the system encounters an error while generating a bot response message.
+     *
+     * This text is also used when a content safety violation is detected, unless `contentSafetyViolationPromptText` is set.
+     */
+    systemFallbackMessage?: string;
+    /** Agent prompting settings. */
+    prompting: MavenAGI.AgentPrompting;
 }

package/dist/api/resources/agents/types/AgentPrompting.d.ts

@@ -0,0 +1,23 @@
+import * as MavenAGI from "../../../index";
+export interface AgentPrompting {
+    /** The overall persona of the agent. */
+    persona: MavenAGI.LlmPersona;
+    /** Additional text directly appended to the prompt. This field is replaced by Knowledge Documents with `llmInclusionsStatus` set to `ALWAYS`. */
+    additionalPromptText?: string;
+    /**
+     * LLM prompt for category generation.
+     *
+     * Use this to specify a fixed set of categories that an LLM should choose from when analyzing a conversation.
+     * When not set uses a default prompt which gives the LLM flexibility to determine appropriate categories on its own.
+     */
+    categoryGenerationPromptText?: string;
+    /**
+     * LLM prompt for generating a response when the user's question has been detected as unsafe.
+     *
+     * Use this to provide custom LLM generated replies when dealing with content safety violations.
+     * When not set, the system fallback message will be used and replies will not be personalized by the LLM as it will not be involved.
+     */
+    contentSafetyViolationResponsePromptText?: string;
+    /** Return the system fallback message on all questions that have no relevant knowledge bases or actions. */
+    rejectQuestionsWithoutKnowledge: boolean;
+}

package/dist/api/resources/agents/types/AgentPrompting.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/dist/api/resources/agents/types/index.d.ts

@@ -2,8 +2,8 @@ export * from "./PiiCategory";
 export * from "./AgentEnvironment";
 export * from "./Agent";
 export * from "./CreateAgentRequest";
-export * from "./AgentPatchRequest";
 export * from "./AgentsSearchRequest";
 export * from "./AgentField";
 export * from "./AgentFilter";
 export * from "./AgentsSearchResponse";
+export * from "./AgentPrompting";

package/dist/api/resources/agents/types/index.js

@@ -18,8 +18,8 @@ __exportStar(require("./PiiCategory"), exports);
 __exportStar(require("./AgentEnvironment"), exports);
 __exportStar(require("./Agent"), exports);
 __exportStar(require("./CreateAgentRequest"), exports);
-__exportStar(require("./AgentPatchRequest"), exports);
 __exportStar(require("./AgentsSearchRequest"), exports);
 __exportStar(require("./AgentField"), exports);
 __exportStar(require("./AgentFilter"), exports);
 __exportStar(require("./AgentsSearchResponse"), exports);
+__exportStar(require("./AgentPrompting"), exports);

package/dist/api/resources/analytics/client/Client.d.ts

@@ -136,6 +136,16 @@ export declare class Analytics {
      */
     getConversationChart(request: MavenAGI.ConversationChartRequest, requestOptions?: Analytics.RequestOptions): core.HttpResponsePromise<MavenAGI.ChartResponse>;
     private __getConversationChart;
+    /**
+     * Export the conversation analytics table to a CSV file.
+     *
+     * This outputs the current table view defined by the request. For most programmatic use cases, prefer `getConversationTable` and format client-side. The CSV format may change and should not be relied upon by code consumers. A maximum of 10,000 rows can be exported at a time.
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     */
+    exportConversationTable(request: MavenAGI.ConversationTableRequest, requestOptions?: Analytics.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    private __exportConversationTable;
     /**
      * Retrieves structured feedback data formatted as a table, allowing users to group, filter,  and define specific metrics to display as columns.
      *