mavenagi 0.0.0-alpha.4 → 0.0.0-alpha.5

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

@@ -20,270 +20,10 @@ export class Actions {
     constructor(_options) {
         this._options = _options;
     }
-    /**
-     * Update an action set or create it if it doesn't exist
-     *
-     * @param {MavenAGI.ActionSetRequest} request
-     * @param {Actions.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link MavenAGI.NotFoundError}
-     * @throws {@link MavenAGI.BadRequestError}
-     * @throws {@link MavenAGI.ServerError}
-     *
-     * @example
-     *     await client.actions.createActionSet({
-     *         id: "string",
-     *         name: "string"
-     *     })
-     */
-    createActionSet(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/actions/sets"),
-                method: "POST",
-                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.ActionSetRequest.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.ActionSetResponse.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 action set by its supplied ID
-     *
-     * @param {string} actionSetId - The ID of the action set to get
-     * @param {Actions.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link MavenAGI.NotFoundError}
-     * @throws {@link MavenAGI.BadRequestError}
-     * @throws {@link MavenAGI.ServerError}
-     *
-     * @example
-     *     await client.actions.getActionSet("string")
-     */
-    getActionSet(actionSetId, 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/actions/sets/${encodeURIComponent(actionSetId)}`),
-                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.ActionSetResponse.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,
-                    });
-            }
-        });
-    }
-    /**
-     * Delete an action set
-     *
-     * @param {string} actionSetId - The ID of the action set to delete
-     * @param {Actions.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link MavenAGI.NotFoundError}
-     * @throws {@link MavenAGI.BadRequestError}
-     * @throws {@link MavenAGI.ServerError}
-     *
-     * @example
-     *     await client.actions.deleteActionSet("string")
-     */
-    deleteActionSet(actionSetId, 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/actions/sets/${encodeURIComponent(actionSetId)}`),
-                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,
-                    });
-            }
-        });
-    }
     /**
      * Update an action or create it if it doesn't exist
      *
-     * @param {MavenAGI.Action} request
+     * @param {MavenAGI.ActionRequest} request
      * @param {Actions.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -291,19 +31,18 @@ export class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.registerAction({
-     *         id: "string",
-     *         actionSetId: "string",
-     *         appId: "string",
-     *         name: "string",
-     *         description: "string",
-     *         userInteractionRequired: true,
-     *         buttonName: "string",
-     *         requiredUserContextFieldNames: new Set(["string"]),
-     *         userFormParameters: [{}]
+     *     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: []
      *     })
      */
-    registerAction(request, requestOptions) {
+    createOrUpdateAction(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)({
@@ -311,22 +50,22 @@ export class Actions {
                 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-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.4",
+                    "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.Action.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                body: yield serializers.ActionRequest.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.Action.parseOrThrow(_response.body, {
+                return yield serializers.ActionResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -381,7 +120,7 @@ export class Actions {
     /**
      * Get an action by its supplied ID
      *
-     * @param {string} actionId - The ID of the action to get
+     * @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}
@@ -389,21 +128,21 @@ export class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.getAction("string")
+     *     await client.actions.getAction("get-balance")
      */
-    getAction(actionId, requestOptions) {
+    getAction(referenceId, 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/actions/${encodeURIComponent(actionId)}`),
+                url: urlJoin((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, `/v1/actions/${encodeURIComponent(referenceId)}`),
                 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-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.4",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.5",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -413,7 +152,7 @@ export class Actions {
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
-                return yield serializers.Action.parseOrThrow(_response.body, {
+                return yield serializers.ActionResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -468,7 +207,7 @@ export class Actions {
     /**
      * Delete an action
      *
-     * @param {string} actionId - The ID of the action to delete
+     * @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}
@@ -476,21 +215,21 @@ export class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.deleteAction("string")
+     *     await client.actions.deleteAction("get-balance")
      */
-    deleteAction(actionId, requestOptions) {
+    deleteAction(referenceId, 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/actions/${encodeURIComponent(actionId)}`),
+                url: urlJoin((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, `/v1/actions/${encodeURIComponent(referenceId)}`),
                 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-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.4",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.5",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },

package/api/resources/actions/types/{Action.d.ts → ActionBase.d.ts}

@@ -2,13 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as MavenAGI from "../../../index";
-export interface Action {
-    /** Externally supplied ID to uniquely identify this action */
-    id: string;
-    /** The ID of the action set this action belongs to. Must be an existing action set ID. */
-    actionSetId: string;
-    /** The maven app id of the app that runs this action */
-    appId: string;
+export interface ActionBase {
     /** The name of the action */
     name: string;
     /** The description of the action. This helps Maven decide when to trigger the action and is not displayed directly to the end user. */

package/api/resources/actions/types/ActionParameter.d.ts

@@ -3,6 +3,7 @@
  */
 export interface ActionParameter {
     id: string;
+    label: string;
     description: string;
     required: boolean;
 }

package/api/resources/actions/types/ActionRequest.d.ts

@@ -0,0 +1,21 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+/**
+ * @example
+ *     {
+ *         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: []
+ *     }
+ */
+export interface ActionRequest extends MavenAGI.ActionBase {
+    /** ID that uniquely identifies this action */
+    entityId: MavenAGI.EntityIdBase;
+}

package/api/resources/actions/types/ActionResponse.d.ts

@@ -0,0 +1,25 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+/**
+ * @example
+ *     {
+ *         entityId: {
+ *             referenceId: "get-balance",
+ *             appId: "my-billing-system",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: MavenAGI.EntityType.Action
+ *         },
+ *         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: []
+ *     }
+ */
+export interface ActionResponse extends MavenAGI.ActionBase {
+    /** ID that uniquely identifies this action */
+    entityId: MavenAGI.EntityId;
+}

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

@@ -1,5 +1,4 @@
-export * from "./ActionSetBase";
-export * from "./ActionSetRequest";
-export * from "./ActionSetResponse";
-export * from "./Action";
+export * from "./ActionBase";
 export * from "./ActionParameter";
+export * from "./ActionRequest";
+export * from "./ActionResponse";

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

@@ -1,5 +1,4 @@
-export * from "./ActionSetBase";
-export * from "./ActionSetRequest";
-export * from "./ActionSetResponse";
-export * from "./Action";
+export * from "./ActionBase";
 export * from "./ActionParameter";
+export * from "./ActionRequest";
+export * from "./ActionResponse";

package/api/resources/commons/types/EntityId.d.ts

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface EntityId extends MavenAGI.EntityIdBase {
+    /** The object type */
+    type: MavenAGI.EntityType;
+    /** The ID of the application that created this object */
+    appId: string;
+    /** The ID of the organization that this object belongs too */
+    organizationId: string;
+    /** The ID of the agent that this object belongs too */
+    agentId: string;
+}

package/api/resources/commons/types/EntityIdBase.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * All other entityId fields are inferred from the API request.
+ */
+export interface EntityIdBase {
+    /** Externally supplied ID to uniquely identify this object. Is globally unique when combined with all other entityId fields (type, appId, organizationId, agentId) */
+    referenceId: string;
+}

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

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export declare type EntityType = "CONVERSATION" | "CONVERSATION_MESSAGE" | "KNOWLEDGE_BASE" | "KNOWLEDGE_DOCUMENT" | "ACTION" | "USER" | "USER_EVENT" | "EVENT_TRIGGER";
+export declare const EntityType: {
+    readonly Conversation: "CONVERSATION";
+    readonly ConversationMessage: "CONVERSATION_MESSAGE";
+    readonly KnowledgeBase: "KNOWLEDGE_BASE";
+    readonly KnowledgeDocument: "KNOWLEDGE_DOCUMENT";
+    readonly Action: "ACTION";
+    readonly User: "USER";
+    readonly UserEvent: "USER_EVENT";
+    readonly EventTrigger: "EVENT_TRIGGER";
+};

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

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const EntityType = {
+    Conversation: "CONVERSATION",
+    ConversationMessage: "CONVERSATION_MESSAGE",
+    KnowledgeBase: "KNOWLEDGE_BASE",
+    KnowledgeDocument: "KNOWLEDGE_DOCUMENT",
+    Action: "ACTION",
+    User: "USER",
+    UserEvent: "USER_EVENT",
+    EventTrigger: "EVENT_TRIGGER",
+};

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

@@ -1,4 +1,7 @@
 export * from "./ErrorMessage";
+export * from "./EntityType";
+export * from "./EntityIdBase";
+export * from "./EntityId";
 export * from "./User";
 export * from "./FeedbackType";
 export * from "./Feedback";

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

@@ -1,4 +1,7 @@
 export * from "./ErrorMessage";
+export * from "./EntityType";
+export * from "./EntityIdBase";
+export * from "./EntityId";
 export * from "./User";
 export * from "./FeedbackType";
 export * from "./Feedback";

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

@@ -9,8 +9,8 @@ export declare namespace Conversation {
         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 {
@@ -35,8 +35,8 @@ export declare class Conversation {
      * @example
      *     await client.conversation.initialize({
      *         messages: [{}],
-     *         id: "string",
      *         context: {},
+     *         id: "string",
      *         responseConfig: {
      *             capabilities: [MavenAGI.Capability.Markdown],
      *             isCopilot: true,
@@ -172,5 +172,22 @@ export declare class Conversation {
      *     })
      */
     submitActionForm(conversationId: string, request: MavenAGI.ActionExecutionRequest, requestOptions?: Conversation.RequestOptions): Promise<MavenAGI.ActionExecutionResponse>;
+    /**
+     * Add metadata to an existing conversation's Context. If a metadata field already exists, it will be overwritten.
+     *
+     * @param {string} conversationId - The ID of a conversation the metadata being added belongs to
+     * @param {Record<string, string>} request
+     * @param {Conversation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.conversation.addConversationMetadata("string", {
+     *         "string": "string"
+     *     })
+     */
+    addConversationMetadata(conversationId: string, request: Record<string, string>, requestOptions?: Conversation.RequestOptions): Promise<Record<string, string>>;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }