mavenagi 0.0.0-alpha.7 → 0.0.0-alpha.9

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

@@ -2,7 +2,23 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as MavenAGI from "../../../index";
+/**
+ * @example
+ *     {
+ *         knowledgeDocumentId: {
+ *             referenceId: "getting-started",
+ *             appId: "readme",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: MavenAGI.EntityType.KnowledgeDocument
+ *         },
+ *         content: "## Getting started This is a getting started guide for the help center.",
+ *         title: "Getting started"
+ *     }
+ */
 export interface KnowledgeDocumentResponse extends MavenAGI.BaseKnowledgeDocument {
+    /** ID that uniquely identifies this knowledge document within its knowledge base */
+    knowledgeDocumentId: MavenAGI.EntityId;
     /** The content of the document in markdown format. Not shown directly to users. */
     content: string;
 }

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

@@ -1,10 +1,10 @@
-export * from "./KnowledgeBaseId";
-export * from "./KnowledgeBase";
+export * from "./KnowledgeBaseProperties";
 export * from "./KnowledgeBaseType";
+export * from "./KnowledgeBaseRequest";
+export * from "./KnowledgeBaseResponse";
 export * from "./KnowledgeBaseVersion";
 export * from "./KnowledgeBaseVersionType";
-export * from "./KnowledgeDocumentId";
 export * from "./BaseKnowledgeDocument";
-export * from "./KnowledgeDocumentRequest";
 export * from "./KnowledgeDocumentContentType";
+export * from "./KnowledgeDocumentRequest";
 export * from "./KnowledgeDocumentResponse";

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

@@ -1,10 +1,10 @@
-export * from "./KnowledgeBaseId";
-export * from "./KnowledgeBase";
+export * from "./KnowledgeBaseProperties";
 export * from "./KnowledgeBaseType";
+export * from "./KnowledgeBaseRequest";
+export * from "./KnowledgeBaseResponse";
 export * from "./KnowledgeBaseVersion";
 export * from "./KnowledgeBaseVersionType";
-export * from "./KnowledgeDocumentId";
 export * from "./BaseKnowledgeDocument";
-export * from "./KnowledgeDocumentRequest";
 export * from "./KnowledgeDocumentContentType";
+export * from "./KnowledgeDocumentRequest";
 export * from "./KnowledgeDocumentResponse";

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

@@ -33,19 +33,19 @@ export declare class Triggers {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.triggers.registerTrigger({
-     *         entityId: {
+     *     await client.triggers.createOrUpdate({
+     *         triggerId: {
      *             referenceId: "store-in-snowflake"
      *         },
      *         description: "Stores conversation data in Snowflake",
      *         type: MavenAGI.EventTriggerType.ConversationCreated
      *     })
      */
-    registerTrigger(request: MavenAGI.EventTriggerRequest, requestOptions?: Triggers.RequestOptions): Promise<MavenAGI.EventTriggerResponse>;
+    createOrUpdate(request: MavenAGI.EventTriggerRequest, requestOptions?: Triggers.RequestOptions): Promise<MavenAGI.EventTriggerResponse>;
     /**
      * Get an event trigger by its supplied ID
      *
-     * @param {string} referenceId - The reference ID of the event trigger to get. All other entity ID fields are inferred from the request.
+     * @param {string} triggerReferenceId - The reference ID of the event trigger to get. All other entity ID fields are inferred from the request.
      * @param {Triggers.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -53,13 +53,13 @@ export declare class Triggers {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.triggers.getTrigger("store-in-snowflake")
+     *     await client.triggers.get("store-in-snowflake")
      */
-    getTrigger(referenceId: string, requestOptions?: Triggers.RequestOptions): Promise<MavenAGI.EventTriggerResponse>;
+    get(triggerReferenceId: string, requestOptions?: Triggers.RequestOptions): Promise<MavenAGI.EventTriggerResponse>;
     /**
-     * Unregister an event trigger
+     * Delete an event trigger
      *
-     * @param {string} referenceId - The reference ID of the event trigger to unregister. All other entity ID fields are inferred from the request.
+     * @param {string} triggerReferenceId - The reference ID of the event trigger to delete. All other entity ID fields are inferred from the request.
      * @param {Triggers.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -67,8 +67,8 @@ export declare class Triggers {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.triggers.unregisterTrigger("store-in-snowflake")
+     *     await client.triggers.delete("store-in-snowflake")
      */
-    unregisterTrigger(referenceId: string, requestOptions?: Triggers.RequestOptions): Promise<void>;
+    delete(triggerReferenceId: string, requestOptions?: Triggers.RequestOptions): Promise<void>;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -31,15 +31,15 @@ export class Triggers {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.triggers.registerTrigger({
-     *         entityId: {
+     *     await client.triggers.createOrUpdate({
+     *         triggerId: {
      *             referenceId: "store-in-snowflake"
      *         },
      *         description: "Stores conversation data in Snowflake",
      *         type: MavenAGI.EventTriggerType.ConversationCreated
      *     })
      */
-    registerTrigger(request, requestOptions) {
+    createOrUpdate(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)({
@@ -51,7 +51,7 @@ export class Triggers {
                     "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.7",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.9",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -117,7 +117,7 @@ export class Triggers {
     /**
      * Get an event trigger by its supplied ID
      *
-     * @param {string} referenceId - The reference ID of the event trigger to get. All other entity ID fields are inferred from the request.
+     * @param {string} triggerReferenceId - The reference ID of the event trigger to get. All other entity ID fields are inferred from the request.
      * @param {Triggers.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -125,13 +125,13 @@ export class Triggers {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.triggers.getTrigger("store-in-snowflake")
+     *     await client.triggers.get("store-in-snowflake")
      */
-    getTrigger(referenceId, requestOptions) {
+    get(triggerReferenceId, 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(referenceId)}`),
+                url: urlJoin((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, `/v1/triggers/${encodeURIComponent(triggerReferenceId)}`),
                 method: "GET",
                 headers: {
                     Authorization: yield this._getAuthorizationHeader(),
@@ -139,7 +139,7 @@ export class Triggers {
                     "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.7",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.9",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -202,9 +202,9 @@ export class Triggers {
         });
     }
     /**
-     * Unregister an event trigger
+     * Delete an event trigger
      *
-     * @param {string} referenceId - The reference ID of the event trigger to unregister. All other entity ID fields are inferred from the request.
+     * @param {string} triggerReferenceId - The reference ID of the event trigger to delete. All other entity ID fields are inferred from the request.
      * @param {Triggers.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -212,13 +212,13 @@ export class Triggers {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.triggers.unregisterTrigger("store-in-snowflake")
+     *     await client.triggers.delete("store-in-snowflake")
      */
-    unregisterTrigger(referenceId, requestOptions) {
+    delete(triggerReferenceId, 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(referenceId)}`),
+                url: urlJoin((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, `/v1/triggers/${encodeURIComponent(triggerReferenceId)}`),
                 method: "DELETE",
                 headers: {
                     Authorization: yield this._getAuthorizationHeader(),
@@ -226,7 +226,7 @@ export class Triggers {
                     "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.7",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.9",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },

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

@@ -5,7 +5,7 @@ import * as MavenAGI from "../../../index";
 /**
  * @example
  *     {
- *         entityId: {
+ *         triggerId: {
  *             referenceId: "store-in-snowflake"
  *         },
  *         description: "Stores conversation data in Snowflake",
@@ -14,5 +14,5 @@ import * as MavenAGI from "../../../index";
  */
 export interface EventTriggerRequest extends MavenAGI.EventTriggerBase {
     /** ID that uniquely identifies this event trigger */
-    entityId: MavenAGI.EntityIdBase;
+    triggerId: MavenAGI.EntityIdBase;
 }

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

@@ -5,7 +5,7 @@ import * as MavenAGI from "../../../index";
 /**
  * @example
  *     {
- *         entityId: {
+ *         triggerId: {
  *             referenceId: "store-in-snowflake",
  *             appId: "snowflake",
  *             organizationId: "acme",
@@ -18,5 +18,5 @@ import * as MavenAGI from "../../../index";
  */
 export interface EventTriggerResponse extends MavenAGI.EventTriggerBase {
     /** ID that uniquely identifies this event trigger */
-    entityId: MavenAGI.EntityId;
+    triggerId: MavenAGI.EntityId;
 }

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

@@ -25,7 +25,7 @@ export declare class Users {
     /**
      * Create a new user or update an existing one
      *
-     * @param {MavenAGI.AppUser} request
+     * @param {MavenAGI.AppUserRequest} request
      * @param {Users.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -43,11 +43,11 @@ export declare class Users {
      *         }
      *     })
      */
-    upsertAppUser(request: MavenAGI.AppUser, requestOptions?: Users.RequestOptions): Promise<MavenAGI.AppUser>;
+    upsertAppUser(request: MavenAGI.AppUserRequest, requestOptions?: Users.RequestOptions): Promise<MavenAGI.AppUserResponse>;
     /**
      * Get a user
      *
-     * @param {string} userId - The ID of the user to get
+     * @param {string} userId - Externally supplied unique ID of the user
      * @param {Users.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -57,6 +57,6 @@ export declare class Users {
      * @example
      *     await client.users.getAppUser("string")
      */
-    getAppUser(userId: string, requestOptions?: Users.RequestOptions): Promise<MavenAGI.AppUser>;
+    getAppUser(userId: string, requestOptions?: Users.RequestOptions): Promise<MavenAGI.AppUserResponse>;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -23,7 +23,7 @@ export class Users {
     /**
      * Create a new user or update an existing one
      *
-     * @param {MavenAGI.AppUser} request
+     * @param {MavenAGI.AppUserRequest} request
      * @param {Users.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -53,18 +53,18 @@ export class Users {
                     "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.7",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.9",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
                 contentType: "application/json",
-                body: yield serializers.AppUser.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                body: yield serializers.AppUserRequest.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, {
+                return yield serializers.AppUserResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -119,7 +119,7 @@ export class Users {
     /**
      * Get a user
      *
-     * @param {string} userId - The ID of the user to get
+     * @param {string} userId - Externally supplied unique ID of the user
      * @param {Users.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -141,7 +141,7 @@ export class Users {
                     "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.7",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.9",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -151,7 +151,7 @@ export class Users {
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
-                return yield serializers.AppUser.parseOrThrow(_response.body, {
+                return yield serializers.AppUserResponse.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,

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

@@ -33,22 +33,24 @@ export declare class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.createOrUpdateAction({
-     *         entityId: {
+     *     await client.actions.createOrUpdate({
+     *         actionId: {
      *             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"]),
+     *         preconditions: {
+     *             requiredUserContextFieldNames: new Set(["my-billing-system.userId"])
+     *         },
      *         userFormParameters: []
      *     })
      */
-    createOrUpdateAction(request: MavenAGI.ActionRequest, requestOptions?: Actions.RequestOptions): Promise<MavenAGI.ActionResponse>;
+    createOrUpdate(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 {string} actionReferenceId - 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}
@@ -56,13 +58,13 @@ export declare class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.getAction("get-balance")
+     *     await client.actions.get("get-balance")
      */
-    getAction(referenceId: string, requestOptions?: Actions.RequestOptions): Promise<MavenAGI.ActionResponse>;
+    get(actionReferenceId: 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 {string} actionReferenceId - 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}
@@ -70,8 +72,8 @@ export declare class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.deleteAction("get-balance")
+     *     await client.actions.delete("get-balance")
      */
-    deleteAction(referenceId: string, requestOptions?: Actions.RequestOptions): Promise<void>;
+    delete(actionReferenceId: string, requestOptions?: Actions.RequestOptions): Promise<void>;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -31,18 +31,20 @@ export class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.createOrUpdateAction({
-     *         entityId: {
+     *     await client.actions.createOrUpdate({
+     *         actionId: {
      *             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"]),
+     *         preconditions: {
+     *             requiredUserContextFieldNames: new Set(["my-billing-system.userId"])
+     *         },
      *         userFormParameters: []
      *     })
      */
-    createOrUpdateAction(request, requestOptions) {
+    createOrUpdate(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)({
@@ -54,7 +56,7 @@ export class Actions {
                     "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.7",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.9",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -120,7 +122,7 @@ export class Actions {
     /**
      * 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 {string} actionReferenceId - 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}
@@ -128,13 +130,13 @@ export class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.getAction("get-balance")
+     *     await client.actions.get("get-balance")
      */
-    getAction(referenceId, requestOptions) {
+    get(actionReferenceId, 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(referenceId)}`),
+                url: urlJoin((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, `/v1/actions/${encodeURIComponent(actionReferenceId)}`),
                 method: "GET",
                 headers: {
                     Authorization: yield this._getAuthorizationHeader(),
@@ -142,7 +144,7 @@ export class Actions {
                     "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.7",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.9",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -207,7 +209,7 @@ export class Actions {
     /**
      * 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 {string} actionReferenceId - 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}
@@ -215,13 +217,13 @@ export class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.deleteAction("get-balance")
+     *     await client.actions.delete("get-balance")
      */
-    deleteAction(referenceId, requestOptions) {
+    delete(actionReferenceId, 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(referenceId)}`),
+                url: urlJoin((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, `/v1/actions/${encodeURIComponent(actionReferenceId)}`),
                 method: "DELETE",
                 headers: {
                     Authorization: yield this._getAuthorizationHeader(),
@@ -229,7 +231,7 @@ export class Actions {
                     "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.7",
+                    "X-Fern-SDK-Version": "0.0.0-alpha.9",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },

package/dist/api/resources/actions/types/ActionBase.d.ts

@@ -3,15 +3,16 @@
  */
 import * as MavenAGI from "../../../index";
 export interface ActionBase {
-    /** The name of the action */
+    /** The name of the action. This is displayed to the end user as part of forms when user interaction is required. It is also used to help Maven decide if the action is relevant to a conversation. */
     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. */
+    /** The description of the action. This helps Maven decide if the action is relevant to a conversation and is not displayed directly to the end user. */
     description: string;
-    /** Whether the action requires user interaction to execute */
+    /** Whether the action requires user interaction to execute. If false, and all of the required action parameters are known, the LLM may call the action automatically. If true, an conversations ask call will return a BotActionFormResponse which must be submitted by an API caller. API callers must display a button with the buttonName label to confirm the user's intent. */
     userInteractionRequired: boolean;
-    /** When user interaction is required, the name of the button that is shown to the end user to execute the action */
+    /** When user interaction is required, the name of the button that is shown to the end user to confirm execution of the action */
     buttonName?: string;
-    /** The names of the user context fields required by the action */
-    requiredUserContextFieldNames: Set<string>;
+    /** The preconditions that must be met for an action to be relevant to a conversation. Can be used to restrict actions to certain types of users. */
+    preconditions: MavenAGI.Preconditions;
+    /** The parameters that the action uses as input. An action will only be executed when all of the required parameters are provided. During execution, actions all have access to the full Conversation and User objects. Parameter values may be inferred from the user's conversation by the LLM. */
     userFormParameters: MavenAGI.ActionParameter[];
 }

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

@@ -5,17 +5,19 @@ import * as MavenAGI from "../../../index";
 /**
  * @example
  *     {
- *         entityId: {
+ *         actionId: {
  *             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"]),
+ *         preconditions: {
+ *             requiredUserContextFieldNames: new Set(["my-billing-system.userId"])
+ *         },
  *         userFormParameters: []
  *     }
  */
 export interface ActionRequest extends MavenAGI.ActionBase {
     /** ID that uniquely identifies this action */
-    entityId: MavenAGI.EntityIdBase;
+    actionId: MavenAGI.EntityIdBase;
 }

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

@@ -5,7 +5,7 @@ import * as MavenAGI from "../../../index";
 /**
  * @example
  *     {
- *         entityId: {
+ *         actionId: {
  *             referenceId: "get-balance",
  *             appId: "my-billing-system",
  *             organizationId: "acme",
@@ -15,11 +15,13 @@ import * as MavenAGI from "../../../index";
  *         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"]),
+ *         preconditions: {
+ *             requiredUserContextFieldNames: new Set(["my-billing-system.userId"])
+ *         },
  *         userFormParameters: []
  *     }
  */
 export interface ActionResponse extends MavenAGI.ActionBase {
     /** ID that uniquely identifies this action */
-    entityId: MavenAGI.EntityId;
+    actionId: MavenAGI.EntityId;
 }

package/dist/api/resources/actions/types/Preconditions.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface Preconditions {
+    /** The names of the user context fields that must be present in order for this object to be considered relevant to a conversation. */
+    requiredUserContextFieldNames: Set<string>;
+}

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

@@ -1,3 +1,4 @@
+export * from "./Preconditions";
 export * from "./ActionBase";
 export * from "./ActionParameter";
 export * from "./ActionRequest";

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

@@ -1,3 +1,4 @@
+export * from "./Preconditions";
 export * from "./ActionBase";
 export * from "./ActionParameter";
 export * from "./ActionRequest";

package/dist/api/resources/commons/types/AppUserIdentification.d.ts

@@ -3,6 +3,6 @@
  */
 import * as MavenAGI from "../../../index";
 export interface AppUserIdentification {
-    /** At least one identifying property must be provided. etc */
-    identifiers: MavenAGI.AppUserIdentifyingProperty[];
+    /** At least one identifying property must be provided */
+    identifiers: MavenAGI.AppUserIdentifier[];
 }

package/dist/api/resources/commons/types/{AppUserIdentifyingProperty.d.ts → AppUserIdentifier.d.ts}

@@ -2,7 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as MavenAGI from "../../../index";
-export interface AppUserIdentifyingProperty {
+export interface AppUserIdentifier {
     /** The identifying property text */
     value: string;
     userIdentifyingPropertyType: MavenAGI.AppUserIdentifyingPropertyType;

package/dist/api/resources/commons/types/AppUserRequest.d.ts

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export declare type AppUserRequest = MavenAGI.AppUser;

package/dist/api/resources/commons/types/AppUserResponse.d.ts

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export declare type AppUserResponse = MavenAGI.AppUser;

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

@@ -6,6 +6,8 @@ export * from "./User";
 export * from "./FeedbackType";
 export * from "./Feedback";
 export * from "./AppUserIdentification";
-export * from "./AppUserIdentifyingProperty";
+export * from "./AppUserIdentifier";
 export * from "./AppUserIdentifyingPropertyType";
 export * from "./AppUser";
+export * from "./AppUserRequest";
+export * from "./AppUserResponse";