mavenagi 0.0.0-alpha.3 → 0.0.0-alpha.4

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

@@ -2,3 +2,7 @@ export * from "./ErrorMessage";
 export * from "./User";
 export * from "./FeedbackType";
 export * from "./Feedback";
+export * from "./AppUserIdentification";
+export * from "./AppUserIdentifyingProperty";
+export * from "./AppUserIdentifyingPropertyType";
+export * from "./AppUser";

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

@@ -36,7 +36,12 @@ export declare class Conversation {
      *     await client.conversation.initialize({
      *         messages: [{}],
      *         id: "string",
-     *         context: {}
+     *         context: {},
+     *         responseConfig: {
+     *             capabilities: [MavenAGI.Capability.Markdown],
+     *             isCopilot: true,
+     *             responseLength: MavenAGI.ResponseLength.Short
+     *         }
      *     })
      */
     initialize(request: MavenAGI.ConversationRequest, requestOptions?: Conversation.RequestOptions): Promise<MavenAGI.ConversationResponse>;
@@ -89,7 +94,8 @@ export declare class Conversation {
      *     await client.conversation.ask("string", {
      *         id: "string",
      *         text: "string",
-     *         context: {}
+     *         context: {},
+     *         responseConfig: {}
      *     })
      */
     ask(conversationId: string, request: MavenAGI.AskRequest, requestOptions?: Conversation.RequestOptions): Promise<MavenAGI.ConversationResponse>;

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

@@ -34,7 +34,12 @@ export class Conversation {
      *     await client.conversation.initialize({
      *         messages: [{}],
      *         id: "string",
-     *         context: {}
+     *         context: {},
+     *         responseConfig: {
+     *             capabilities: [MavenAGI.Capability.Markdown],
+     *             isCopilot: true,
+     *             responseLength: MavenAGI.ResponseLength.Short
+     *         }
      *     })
      */
     initialize(request, requestOptions) {
@@ -49,7 +54,7 @@ export class Conversation {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -137,7 +142,7 @@ export class Conversation {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -230,7 +235,7 @@ export class Conversation {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -310,7 +315,8 @@ export class Conversation {
      *     await client.conversation.ask("string", {
      *         id: "string",
      *         text: "string",
-     *         context: {}
+     *         context: {},
+     *         responseConfig: {}
      *     })
      */
     ask(conversationId, request, requestOptions) {
@@ -325,7 +331,7 @@ export class Conversation {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -403,7 +409,7 @@ export class Conversation {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -505,7 +511,7 @@ export class Conversation {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -601,7 +607,7 @@ export class Conversation {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -702,7 +708,7 @@ export class Conversation {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },

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

@@ -9,4 +9,6 @@ export interface AskRequest {
     text: string;
     /** The context of the message */
     context?: MavenAGI.ConversationMessageContext;
+    /** Optional configuration for responses to this conversation. Only applies to new conversations. */
+    responseConfig?: MavenAGI.ResponseConfig;
 }

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export declare type Capability = "MARKDOWN" | "FORMS";
+export declare const Capability: {
+    readonly Markdown: "MARKDOWN";
+    readonly Forms: "FORMS";
+};

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

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const Capability = {
+    Markdown: "MARKDOWN",
+    Forms: "FORMS",
+};

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

@@ -7,4 +7,6 @@ export interface ConversationBase {
     id: string;
     /** The context of the conversation */
     context?: MavenAGI.ConversationContext;
+    /** Optional configurations for responses to this conversation */
+    responseConfig?: MavenAGI.ResponseConfig;
 }

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

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface ResponseConfig {
+    /** List of capabilities supported by the caller. Defaults to all */
+    capabilities?: MavenAGI.Capability[];
+    /** Whether the response is for an human agent (true) or an end user (false). Defaults to false. */
+    isCopilot?: boolean;
+    /** The desired response length. Defaults to ResponseLength.MEDIUM. */
+    responseLength?: MavenAGI.ResponseLength;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export declare type ResponseLength = "SHORT" | "MEDIUM" | "LONG";
+export declare const ResponseLength: {
+    readonly Short: "SHORT";
+    readonly Medium: "MEDIUM";
+    readonly Long: "LONG";
+};

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const ResponseLength = {
+    Short: "SHORT",
+    Medium: "MEDIUM",
+    Long: "LONG",
+};

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

@@ -1,4 +1,7 @@
 export * from "./AskRequest";
+export * from "./ResponseConfig";
+export * from "./Capability";
+export * from "./ResponseLength";
 export * from "./GenerateMavenSuggestionsRequest";
 export * from "./ConversationBase";
 export * from "./ConversationResponse";

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

@@ -1,4 +1,7 @@
 export * from "./AskRequest";
+export * from "./ResponseConfig";
+export * from "./Capability";
+export * from "./ResponseLength";
 export * from "./GenerateMavenSuggestionsRequest";
 export * from "./ConversationBase";
 export * from "./ConversationResponse";

package/api/resources/index.d.ts

@@ -1,11 +1,12 @@
-export * as actionSet from "./actionSet";
-export * from "./actionSet/types";
-export * as action from "./action";
-export * from "./action/types";
+export * as actions from "./actions";
+export * from "./actions/types";
 export * as commons from "./commons";
 export * from "./commons/types";
 export * as conversation from "./conversation";
 export * from "./conversation/types";
 export * as knowledge from "./knowledge";
 export * from "./knowledge/types";
+export * as triggers from "./triggers";
+export * from "./triggers/types";
 export * from "./commons/errors";
+export * as user from "./user";

package/api/resources/index.js

@@ -1,11 +1,12 @@
-export * as actionSet from "./actionSet";
-export * from "./actionSet/types";
-export * as action from "./action";
-export * from "./action/types";
+export * as actions from "./actions";
+export * from "./actions/types";
 export * as commons from "./commons";
 export * from "./commons/types";
 export * as conversation from "./conversation";
 export * from "./conversation/types";
 export * as knowledge from "./knowledge";
 export * from "./knowledge/types";
+export * as triggers from "./triggers";
+export * from "./triggers/types";
 export * from "./commons/errors";
+export * as user from "./user";

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

@@ -41,6 +41,20 @@ export declare class Knowledge {
      *     })
      */
     createKnowledgeBase(request: MavenAGI.KnowledgeBase, requestOptions?: Knowledge.RequestOptions): Promise<MavenAGI.KnowledgeBase>;
+    /**
+     * Get an existing knowledge base.
+     *
+     * @param {string} knowledgeBaseId - The ID of the knowledge base to get
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.getKnowledgeBase("string")
+     */
+    getKnowledgeBase(knowledgeBaseId: string, requestOptions?: Knowledge.RequestOptions): Promise<MavenAGI.KnowledgeBase>;
     /**
      * Create a new knowledge base version. Only supported on API knowledge bases. Will throw an exception if there is an existing version in progress.
      *
@@ -77,7 +91,7 @@ export declare class Knowledge {
     /**
      * Create knowledge document. Requires an existing knowledge base with an in progress version. Will throw an exception if the latest version is not in progress.
      *
-     * @param {MavenAGI.KnowledgeDocument} request
+     * @param {MavenAGI.KnowledgeDocumentRequest} request
      * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -86,8 +100,9 @@ export declare class Knowledge {
      *
      * @example
      *     await client.knowledge.createKnowledgeDocument({
-     *         title: "string",
+     *         contentType: MavenAGI.KnowledgeDocumentContentType.Html,
      *         content: "string",
+     *         title: "string",
      *         url: "string",
      *         language: "string",
      *         createdAt: new Date("2024-01-15T09:30:00.000Z"),
@@ -97,11 +112,11 @@ export declare class Knowledge {
      *         documentId: "string"
      *     })
      */
-    createKnowledgeDocument(request: MavenAGI.KnowledgeDocument, requestOptions?: Knowledge.RequestOptions): Promise<MavenAGI.KnowledgeDocument>;
+    createKnowledgeDocument(request: MavenAGI.KnowledgeDocumentRequest, requestOptions?: Knowledge.RequestOptions): Promise<MavenAGI.KnowledgeDocumentResponse>;
     /**
      * Update knowledge document. Requires an existing knowledge base with an in progress version of type PARTIAL. Will throw an exception if the latest version is not in progress.
      *
-     * @param {MavenAGI.KnowledgeDocument} request
+     * @param {MavenAGI.KnowledgeDocumentRequest} request
      * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -110,8 +125,9 @@ export declare class Knowledge {
      *
      * @example
      *     await client.knowledge.updateKnowledgeDocument({
-     *         title: "string",
+     *         contentType: MavenAGI.KnowledgeDocumentContentType.Html,
      *         content: "string",
+     *         title: "string",
      *         url: "string",
      *         language: "string",
      *         createdAt: new Date("2024-01-15T09:30:00.000Z"),
@@ -121,7 +137,7 @@ export declare class Knowledge {
      *         documentId: "string"
      *     })
      */
-    updateKnowledgeDocument(request: MavenAGI.KnowledgeDocument, requestOptions?: Knowledge.RequestOptions): Promise<MavenAGI.KnowledgeDocument>;
+    updateKnowledgeDocument(request: MavenAGI.KnowledgeDocumentRequest, requestOptions?: Knowledge.RequestOptions): Promise<MavenAGI.KnowledgeDocumentResponse>;
     /**
      * Delete knowledge document. Requires an existing knowledge base with an in progress version of type PARTIAL. Will throw an exception if the latest version is not in progress.
      *

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

@@ -50,7 +50,7 @@ export class Knowledge {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -113,6 +113,93 @@ export class Knowledge {
             }
         });
     }
+    /**
+     * Get an existing knowledge base.
+     *
+     * @param {string} knowledgeBaseId - The ID of the knowledge base to get
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.getKnowledgeBase("string")
+     */
+    getKnowledgeBase(knowledgeBaseId, requestOptions) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: urlJoin((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, `/v1/knowledge/${encodeURIComponent(knowledgeBaseId)}`),
+                method: "GET",
+                headers: {
+                    Authorization: yield this._getAuthorizationHeader(),
+                    "X-Organization-Id": yield core.Supplier.get(this._options.organizationId),
+                    "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
+                    "X-Fern-Language": "JavaScript",
+                    "X-Fern-SDK-Name": "mavenagi",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
+                    "X-Fern-Runtime": core.RUNTIME.type,
+                    "X-Fern-Runtime-Version": core.RUNTIME.version,
+                },
+                contentType: "application/json",
+                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 yield serializers.KnowledgeBase.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    breadcrumbsPrefix: ["response"],
+                });
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new MavenAGI.NotFoundError(yield serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    case 400:
+                        throw new MavenAGI.BadRequestError(yield serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    case 500:
+                        throw new MavenAGI.ServerError(yield serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    default:
+                        throw new errors.MavenAGIError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.MavenAGIError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                    });
+                case "timeout":
+                    throw new errors.MavenAGITimeoutError();
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                    });
+            }
+        });
+    }
     /**
      * Create a new knowledge base version. Only supported on API knowledge bases. Will throw an exception if there is an existing version in progress.
      *
@@ -141,7 +228,7 @@ export class Knowledge {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -231,7 +318,7 @@ export class Knowledge {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -292,7 +379,7 @@ export class Knowledge {
     /**
      * Create knowledge document. Requires an existing knowledge base with an in progress version. Will throw an exception if the latest version is not in progress.
      *
-     * @param {MavenAGI.KnowledgeDocument} request
+     * @param {MavenAGI.KnowledgeDocumentRequest} request
      * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -301,8 +388,9 @@ export class Knowledge {
      *
      * @example
      *     await client.knowledge.createKnowledgeDocument({
-     *         title: "string",
+     *         contentType: MavenAGI.KnowledgeDocumentContentType.Html,
      *         content: "string",
+     *         title: "string",
      *         url: "string",
      *         language: "string",
      *         createdAt: new Date("2024-01-15T09:30:00.000Z"),
@@ -324,18 +412,18 @@ export class Knowledge {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
                 contentType: "application/json",
-                body: yield serializers.KnowledgeDocument.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                body: yield serializers.KnowledgeDocumentRequest.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 yield serializers.KnowledgeDocument.parseOrThrow(_response.body, {
+                return yield serializers.KnowledgeDocumentResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -390,7 +478,7 @@ export class Knowledge {
     /**
      * Update knowledge document. Requires an existing knowledge base with an in progress version of type PARTIAL. Will throw an exception if the latest version is not in progress.
      *
-     * @param {MavenAGI.KnowledgeDocument} request
+     * @param {MavenAGI.KnowledgeDocumentRequest} request
      * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -399,8 +487,9 @@ export class Knowledge {
      *
      * @example
      *     await client.knowledge.updateKnowledgeDocument({
-     *         title: "string",
+     *         contentType: MavenAGI.KnowledgeDocumentContentType.Html,
      *         content: "string",
+     *         title: "string",
      *         url: "string",
      *         language: "string",
      *         createdAt: new Date("2024-01-15T09:30:00.000Z"),
@@ -422,18 +511,18 @@ export class Knowledge {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
                 contentType: "application/json",
-                body: yield serializers.KnowledgeDocument.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                body: yield serializers.KnowledgeDocumentRequest.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 yield serializers.KnowledgeDocument.parseOrThrow(_response.body, {
+                return yield serializers.KnowledgeDocumentResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -513,7 +602,7 @@ export class Knowledge {
                     "X-Agent-Id": yield core.Supplier.get(this._options.agentId),
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "mavenagi",
-                    "X-Fern-SDK-Version": "0.0.0-alpha.3",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.4",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },

package/api/resources/knowledge/types/{KnowledgeDocument.d.ts → BaseKnowledgeDocument.d.ts}

@@ -2,11 +2,9 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as MavenAGI from "../../../index";
-export interface KnowledgeDocument extends MavenAGI.KnowledgeDocumentId {
+export interface BaseKnowledgeDocument extends MavenAGI.KnowledgeDocumentId {
     /** The title of the document. Will be shown as part of answers. */
     title: string;
-    /** The content of the document. Not shown directly to users. */
-    content: string;
     /** The URL of the document. Should be visible to end users. Will be shown as part of answers. */
     url?: string;
     /** The document language. Must be a valid ISO 639-1 language code. */

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

@@ -2,7 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 /**
- * The type of knowledge base version
+ * API knowledge bases are managed by a Maven App. URL knowledge bases will start a web crawl of the provided URL. RSS knowledge bases will parse documents from the RSS returned from the provided URL.
  */
 export declare type KnowledgeBaseType = "API" | "URL" | "RSS";
 export declare const KnowledgeBaseType: {

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

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * The type of the knowledge document content. Markdown preferred.
+ */
+export declare type KnowledgeDocumentContentType = "HTML" | "MARKDOWN";
+export declare const KnowledgeDocumentContentType: {
+    readonly Html: "HTML";
+    readonly Markdown: "MARKDOWN";
+};

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

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const KnowledgeDocumentContentType = {
+    Html: "HTML",
+    Markdown: "MARKDOWN",
+};

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

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface KnowledgeDocumentRequest extends MavenAGI.BaseKnowledgeDocument {
+    contentType: MavenAGI.KnowledgeDocumentContentType;
+    /** 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;
+}

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface KnowledgeDocumentResponse extends MavenAGI.BaseKnowledgeDocument {
+    /** The content of the document in markdown format. Not shown directly to users. */
+    content: string;
+}

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

@@ -4,4 +4,7 @@ export * from "./KnowledgeBaseType";
 export * from "./KnowledgeBaseVersion";
 export * from "./KnowledgeBaseVersionType";
 export * from "./KnowledgeDocumentId";
-export * from "./KnowledgeDocument";
+export * from "./BaseKnowledgeDocument";
+export * from "./KnowledgeDocumentRequest";
+export * from "./KnowledgeDocumentContentType";
+export * from "./KnowledgeDocumentResponse";

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

@@ -4,4 +4,7 @@ export * from "./KnowledgeBaseType";
 export * from "./KnowledgeBaseVersion";
 export * from "./KnowledgeBaseVersionType";
 export * from "./KnowledgeDocumentId";
-export * from "./KnowledgeDocument";
+export * from "./BaseKnowledgeDocument";
+export * from "./KnowledgeDocumentRequest";
+export * from "./KnowledgeDocumentContentType";
+export * from "./KnowledgeDocumentResponse";