mavenagi 0.0.0-alpha.2 → 0.0.0-alpha.4

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/KnowledgeDocumentRequest.js

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

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/KnowledgeDocumentResponse.js

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

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

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

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

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

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

@@ -0,0 +1,72 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments";
+import * as core from "../../../../core";
+import * as MavenAGI from "../../../index";
+export declare namespace Triggers {
+    interface Options {
+        environment?: core.Supplier<environments.MavenAGIEnvironment | string>;
+        appId?: core.Supplier<string | undefined>;
+        appSecret?: core.Supplier<string | undefined>;
+        organizationId: core.Supplier<string>;
+        agentId: core.Supplier<string>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        timeoutInSeconds?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
+    }
+}
+export declare class Triggers {
+    protected readonly _options: Triggers.Options;
+    constructor(_options: Triggers.Options);
+    /**
+     * Update an event trigger or create it if it doesn't exist.
+     *
+     * @param {MavenAGI.EventTrigger} request
+     * @param {Triggers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.triggers.registerTrigger({
+     *         id: "string",
+     *         description: "string",
+     *         type: MavenAGI.EventTriggerType.ConversationCreated
+     *     })
+     */
+    registerTrigger(request: MavenAGI.EventTrigger, requestOptions?: Triggers.RequestOptions): Promise<MavenAGI.EventTrigger>;
+    /**
+     * Get an event trigger by its supplied ID
+     *
+     * @param {string} triggerId - The ID of the event trigger to get
+     * @param {Triggers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.triggers.getTrigger("string")
+     */
+    getTrigger(triggerId: string, requestOptions?: Triggers.RequestOptions): Promise<MavenAGI.EventTrigger>;
+    /**
+     * Unregister an event trigger
+     *
+     * @param {string} triggerId - The ID of the event trigger to unregister
+     * @param {Triggers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.triggers.unregisterTrigger("string")
+     */
+    unregisterTrigger(triggerId: string, requestOptions?: Triggers.RequestOptions): Promise<void>;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
+}

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

@@ -0,0 +1,298 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as environments from "../../../../environments";
+import * as core from "../../../../core";
+import * as MavenAGI from "../../../index";
+import * as serializers from "../../../../serialization/index";
+import urlJoin from "url-join";
+import * as errors from "../../../../errors/index";
+export class Triggers {
+    constructor(_options) {
+        this._options = _options;
+    }
+    /**
+     * Update an event trigger or create it if it doesn't exist.
+     *
+     * @param {MavenAGI.EventTrigger} request
+     * @param {Triggers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.triggers.registerTrigger({
+     *         id: "string",
+     *         description: "string",
+     *         type: MavenAGI.EventTriggerType.ConversationCreated
+     *     })
+     */
+    registerTrigger(request, 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/triggers"),
+                method: "PUT",
+                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",
+                body: yield serializers.EventTrigger.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.EventTrigger.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,
+                    });
+            }
+        });
+    }
+    /**
+     * Get an event trigger by its supplied ID
+     *
+     * @param {string} triggerId - The ID of the event trigger to get
+     * @param {Triggers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.triggers.getTrigger("string")
+     */
+    getTrigger(triggerId, 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/triggers/${encodeURIComponent(triggerId)}`),
+                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.EventTrigger.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,
+                    });
+            }
+        });
+    }
+    /**
+     * Unregister an event trigger
+     *
+     * @param {string} triggerId - The ID of the event trigger to unregister
+     * @param {Triggers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.triggers.unregisterTrigger("string")
+     */
+    unregisterTrigger(triggerId, 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/triggers/${encodeURIComponent(triggerId)}`),
+                method: "DELETE",
+                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;
+            }
+            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,
+                    });
+            }
+        });
+    }
+    _getAuthorizationHeader() {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const appId = (_a = (yield core.Supplier.get(this._options.appId))) !== null && _a !== void 0 ? _a : process === null || process === void 0 ? void 0 : process.env["MAVENAGI_APP_ID"];
+            const appSecret = (_b = (yield core.Supplier.get(this._options.appSecret))) !== null && _b !== void 0 ? _b : process === null || process === void 0 ? void 0 : process.env["MAVENAGI_APP_SECRET"];
+            if (appId != null && appSecret != null) {
+                return core.BasicAuth.toAuthorizationHeader({
+                    username: appId,
+                    password: appSecret,
+                });
+            }
+            return undefined;
+        });
+    }
+}

package/api/resources/triggers/client/index.d.ts

@@ -0,0 +1 @@
+export {};

package/api/resources/triggers/client/index.js

@@ -0,0 +1 @@
+export {};

package/api/resources/triggers/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./client";

package/api/resources/triggers/index.js

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./client";

package/api/resources/triggers/types/EventTrigger.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface EventTrigger {
+    /** Externally supplied ID to uniquely identify this event trigger */
+    id: string;
+    /** The description of what the event trigger does, shown in the Maven Dashboard */
+    description: string;
+    /** The type of event trigger this app wishes to handle */
+    type: MavenAGI.EventTriggerType;
+}

package/api/resources/triggers/types/EventTrigger.js

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/api/resources/triggers/types/EventTriggerType.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export declare type EventTriggerType = "CONVERSATION_CREATED" | "FEEDBACK_CREATED";
+export declare const EventTriggerType: {
+    readonly ConversationCreated: "CONVERSATION_CREATED";
+    readonly FeedbackCreated: "FEEDBACK_CREATED";
+};

package/api/resources/triggers/types/EventTriggerType.js

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const EventTriggerType = {
+    ConversationCreated: "CONVERSATION_CREATED",
+    FeedbackCreated: "FEEDBACK_CREATED",
+};

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

@@ -0,0 +1,2 @@
+export * from "./EventTrigger";
+export * from "./EventTriggerType";

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

@@ -0,0 +1,2 @@
+export * from "./EventTrigger";
+export * from "./EventTriggerType";

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

@@ -0,0 +1,62 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments";
+import * as core from "../../../../core";
+import * as MavenAGI from "../../../index";
+export declare namespace User {
+    interface Options {
+        environment?: core.Supplier<environments.MavenAGIEnvironment | string>;
+        appId?: core.Supplier<string | undefined>;
+        appSecret?: core.Supplier<string | undefined>;
+        organizationId: core.Supplier<string>;
+        agentId: core.Supplier<string>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        timeoutInSeconds?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
+    }
+}
+export declare class User {
+    protected readonly _options: User.Options;
+    constructor(_options: User.Options);
+    /**
+     * Create a new user or update an existing one
+     *
+     * @param {MavenAGI.AppUser} request
+     * @param {User.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.user.upsertAppUser({
+     *         id: "string",
+     *         userIdentifiers: {
+     *             identifiers: new Set([{}])
+     *         },
+     *         metadata: {
+     *             "string": "string"
+     *         }
+     *     })
+     */
+    upsertAppUser(request: MavenAGI.AppUser, requestOptions?: User.RequestOptions): Promise<MavenAGI.AppUser>;
+    /**
+     * Get a user
+     *
+     * @param {string} userId - The ID of the user to get
+     * @param {User.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.user.getAppUser("string")
+     */
+    getAppUser(userId: string, requestOptions?: User.RequestOptions): Promise<MavenAGI.AppUser>;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
+}