mavenagi 0.0.0-alpha.3 → 0.0.0-alpha.5

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

@@ -0,0 +1,22 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+/**
+ * @example
+ *     {
+ *         entityId: {
+ *             referenceId: "store-in-snowflake",
+ *             appId: "snowflake",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: MavenAGI.EntityType.EventTrigger
+ *         },
+ *         description: "Stores conversation data in Snowflake",
+ *         type: MavenAGI.EventTriggerType.ConversationCreated
+ *     }
+ */
+export interface EventTriggerResponse extends MavenAGI.EventTriggerBase {
+    /** ID that uniquely identifies this event trigger */
+    entityId: MavenAGI.EntityId;
+}

package/api/resources/triggers/types/EventTriggerResponse.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,4 @@
+export * from "./EventTriggerBase";
+export * from "./EventTriggerRequest";
+export * from "./EventTriggerResponse";
+export * from "./EventTriggerType";

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

@@ -0,0 +1,4 @@
+export * from "./EventTriggerBase";
+export * from "./EventTriggerRequest";
+export * from "./EventTriggerResponse";
+export * from "./EventTriggerType";

package/api/resources/users/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 Users {
+    interface Options {
+        environment?: core.Supplier<environments.MavenAGIEnvironment | string>;
+        appId?: core.Supplier<string | undefined>;
+        appSecret?: core.Supplier<string | undefined>;
+        xOrganizationId: core.Supplier<string>;
+        xAgentId: core.Supplier<string>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        timeoutInSeconds?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
+    }
+}
+export declare class Users {
+    protected readonly _options: Users.Options;
+    constructor(_options: Users.Options);
+    /**
+     * Create a new user or update an existing one
+     *
+     * @param {MavenAGI.AppUser} request
+     * @param {Users.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.users.upsertAppUser({
+     *         id: "string",
+     *         userIdentifiers: {
+     *             identifiers: new Set([{}])
+     *         },
+     *         metadata: {
+     *             "string": "string"
+     *         }
+     *     })
+     */
+    upsertAppUser(request: MavenAGI.AppUser, requestOptions?: Users.RequestOptions): Promise<MavenAGI.AppUser>;
+    /**
+     * Get a user
+     *
+     * @param {string} userId - The ID of the user to get
+     * @param {Users.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.users.getAppUser("string")
+     */
+    getAppUser(userId: string, requestOptions?: Users.RequestOptions): Promise<MavenAGI.AppUser>;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
+}

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

@@ -0,0 +1,220 @@
+/**
+ * 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 Users {
+    constructor(_options) {
+        this._options = _options;
+    }
+    /**
+     * Create a new user or update an existing one
+     *
+     * @param {MavenAGI.AppUser} request
+     * @param {Users.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.users.upsertAppUser({
+     *         id: "string",
+     *         userIdentifiers: {
+     *             identifiers: new Set([{}])
+     *         },
+     *         metadata: {
+     *             "string": "string"
+     *         }
+     *     })
+     */
+    upsertAppUser(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/users"),
+                method: "PUT",
+                headers: {
+                    Authorization: yield this._getAuthorizationHeader(),
+                    "X-Organization-Id": yield core.Supplier.get(this._options.xOrganizationId),
+                    "X-Agent-Id": yield core.Supplier.get(this._options.xAgentId),
+                    "X-Fern-Language": "JavaScript",
+                    "X-Fern-SDK-Name": "mavenagi",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.5",
+                    "X-Fern-Runtime": core.RUNTIME.type,
+                    "X-Fern-Runtime-Version": core.RUNTIME.version,
+                },
+                contentType: "application/json",
+                body: yield serializers.AppUser.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.AppUser.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 a user
+     *
+     * @param {string} userId - The ID of the user to get
+     * @param {Users.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.users.getAppUser("string")
+     */
+    getAppUser(userId, 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/users/${encodeURIComponent(userId)}`),
+                method: "GET",
+                headers: {
+                    Authorization: yield this._getAuthorizationHeader(),
+                    "X-Organization-Id": yield core.Supplier.get(this._options.xOrganizationId),
+                    "X-Agent-Id": yield core.Supplier.get(this._options.xAgentId),
+                    "X-Fern-Language": "JavaScript",
+                    "X-Fern-SDK-Name": "mavenagi",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.5",
+                    "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.AppUser.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,
+                    });
+            }
+        });
+    }
+    _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/users/index.d.ts

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

package/api/resources/users/index.js

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

package/dist/Client.d.ts

@@ -3,17 +3,18 @@
  */
 import * as environments from "./environments";
 import * as core from "./core";
-import { ActionSet } from "./api/resources/actionSet/client/Client";
-import { Action } from "./api/resources/action/client/Client";
+import { Actions } from "./api/resources/actions/client/Client";
 import { Conversation } from "./api/resources/conversation/client/Client";
 import { Knowledge } from "./api/resources/knowledge/client/Client";
+import { Triggers } from "./api/resources/triggers/client/Client";
+import { Users } from "./api/resources/users/client/Client";
 export declare namespace MavenAGIClient {
     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>;
+        xOrganizationId: core.Supplier<string>;
+        xAgentId: core.Supplier<string>;
         fetcher?: core.FetchFunction;
     }
     interface RequestOptions {
@@ -25,12 +26,14 @@ export declare namespace MavenAGIClient {
 export declare class MavenAGIClient {
     protected readonly _options: MavenAGIClient.Options;
     constructor(_options: MavenAGIClient.Options);
-    protected _actionSet: ActionSet | undefined;
-    get actionSet(): ActionSet;
-    protected _action: Action | undefined;
-    get action(): Action;
+    protected _actions: Actions | undefined;
+    get actions(): Actions;
     protected _conversation: Conversation | undefined;
     get conversation(): Conversation;
     protected _knowledge: Knowledge | undefined;
     get knowledge(): Knowledge;
+    protected _triggers: Triggers | undefined;
+    get triggers(): Triggers;
+    protected _users: Users | undefined;
+    get users(): Users;
 }

package/dist/Client.js

@@ -1,21 +1,18 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import { ActionSet } from "./api/resources/actionSet/client/Client";
-import { Action } from "./api/resources/action/client/Client";
+import { Actions } from "./api/resources/actions/client/Client";
 import { Conversation } from "./api/resources/conversation/client/Client";
 import { Knowledge } from "./api/resources/knowledge/client/Client";
+import { Triggers } from "./api/resources/triggers/client/Client";
+import { Users } from "./api/resources/users/client/Client";
 export class MavenAGIClient {
     constructor(_options) {
         this._options = _options;
     }
-    get actionSet() {
+    get actions() {
         var _a;
-        return ((_a = this._actionSet) !== null && _a !== void 0 ? _a : (this._actionSet = new ActionSet(this._options)));
-    }
-    get action() {
-        var _a;
-        return ((_a = this._action) !== null && _a !== void 0 ? _a : (this._action = new Action(this._options)));
+        return ((_a = this._actions) !== null && _a !== void 0 ? _a : (this._actions = new Actions(this._options)));
     }
     get conversation() {
         var _a;
@@ -25,4 +22,12 @@ export class MavenAGIClient {
         var _a;
         return ((_a = this._knowledge) !== null && _a !== void 0 ? _a : (this._knowledge = new Knowledge(this._options)));
     }
+    get triggers() {
+        var _a;
+        return ((_a = this._triggers) !== null && _a !== void 0 ? _a : (this._triggers = new Triggers(this._options)));
+    }
+    get users() {
+        var _a;
+        return ((_a = this._users) !== null && _a !== void 0 ? _a : (this._users = new Users(this._options)));
+    }
 }

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

@@ -0,0 +1,77 @@
+/**
+ * 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 Actions {
+    interface Options {
+        environment?: core.Supplier<environments.MavenAGIEnvironment | string>;
+        appId?: core.Supplier<string | undefined>;
+        appSecret?: core.Supplier<string | undefined>;
+        xOrganizationId: core.Supplier<string>;
+        xAgentId: core.Supplier<string>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        timeoutInSeconds?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
+    }
+}
+export declare class Actions {
+    protected readonly _options: Actions.Options;
+    constructor(_options: Actions.Options);
+    /**
+     * Update an action or create it if it doesn't exist
+     *
+     * @param {MavenAGI.ActionRequest} request
+     * @param {Actions.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.actions.createOrUpdateAction({
+     *         entityId: {
+     *             referenceId: "get-balance"
+     *         },
+     *         name: "Get the user's balance",
+     *         description: "This action calls an API to get the user's current balance.",
+     *         userInteractionRequired: false,
+     *         requiredUserContextFieldNames: new Set(["my-billing-system.userId"]),
+     *         userFormParameters: []
+     *     })
+     */
+    createOrUpdateAction(request: MavenAGI.ActionRequest, requestOptions?: Actions.RequestOptions): Promise<MavenAGI.ActionResponse>;
+    /**
+     * Get an action by its supplied ID
+     *
+     * @param {string} referenceId - The reference ID of the action to get. All other entity ID fields are inferred from the request.
+     * @param {Actions.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.actions.getAction("get-balance")
+     */
+    getAction(referenceId: string, requestOptions?: Actions.RequestOptions): Promise<MavenAGI.ActionResponse>;
+    /**
+     * Delete an action
+     *
+     * @param {string} referenceId - The reference ID of the action to unregister. All other entity ID fields are inferred from the request.
+     * @param {Actions.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.actions.deleteAction("get-balance")
+     */
+    deleteAction(referenceId: string, requestOptions?: Actions.RequestOptions): Promise<void>;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
+}