@meetkai/mka1 0.49.11 → 0.49.13

package/src/react-query/agentConnectorsSetupWhatsAppAppWebhook.ts

@@ -0,0 +1,111 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { agentConnectorsSetupWhatsAppAppWebhook } from "../funcs/agentConnectorsSetupWhatsAppAppWebhook.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type AgentConnectorsSetupWhatsAppAppWebhookMutationVariables = {
+  request: operations.SetupWhatsAppAppWebhookRequest;
+  options?: RequestOptions;
+};
+
+export type AgentConnectorsSetupWhatsAppAppWebhookMutationData =
+  operations.SetupWhatsAppAppWebhookResponse;
+
+export type AgentConnectorsSetupWhatsAppAppWebhookMutationError =
+  | errors.ErrorEnvelope
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Set up a WhatsApp app webhook
+ *
+ * @remarks
+ * Returns the app-level callback URL and verification token that must be saved in Meta before the first WhatsApp phone connector is created. The caller must be allowed to manage the agent. The stable verification token is returned only in this no-store response and is not a Meta access token.
+ */
+export function useAgentConnectorsSetupWhatsAppAppWebhookMutation(
+  options?: MutationHookOptions<
+    AgentConnectorsSetupWhatsAppAppWebhookMutationData,
+    AgentConnectorsSetupWhatsAppAppWebhookMutationError,
+    AgentConnectorsSetupWhatsAppAppWebhookMutationVariables
+  >,
+): UseMutationResult<
+  AgentConnectorsSetupWhatsAppAppWebhookMutationData,
+  AgentConnectorsSetupWhatsAppAppWebhookMutationError,
+  AgentConnectorsSetupWhatsAppAppWebhookMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildAgentConnectorsSetupWhatsAppAppWebhookMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyAgentConnectorsSetupWhatsAppAppWebhook(): MutationKey {
+  return ["@meetkai/mka1", "Agent Connectors", "setupWhatsAppAppWebhook"];
+}
+
+export function buildAgentConnectorsSetupWhatsAppAppWebhookMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: AgentConnectorsSetupWhatsAppAppWebhookMutationVariables,
+  ) => Promise<AgentConnectorsSetupWhatsAppAppWebhookMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyAgentConnectorsSetupWhatsAppAppWebhook(),
+    mutationFn: function agentConnectorsSetupWhatsAppAppWebhookMutationFn({
+      request,
+      options,
+    }): Promise<AgentConnectorsSetupWhatsAppAppWebhookMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(agentConnectorsSetupWhatsAppAppWebhook(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/index.ts

@@ -10,6 +10,7 @@ export * from "./agentConnectorsCreateAgentConnector.js";
 export * from "./agentConnectorsDeleteAgentConnector.js";
 export * from "./agentConnectorsGetAgentConnector.js";
 export * from "./agentConnectorsListAgentConnectors.js";
+export * from "./agentConnectorsSetupWhatsAppAppWebhook.js";
 export * from "./agentRunsCreateAgentRun.js";
 export * from "./agentRunsGetAgentRun.js";
 export * from "./agentRunsListAgentRuns.js";

package/src/sdk/agentconnectors.ts

@@ -7,6 +7,7 @@ import { agentConnectorsCreateAgentConnector } from "../funcs/agentConnectorsCre
 import { agentConnectorsDeleteAgentConnector } from "../funcs/agentConnectorsDeleteAgentConnector.js";
 import { agentConnectorsGetAgentConnector } from "../funcs/agentConnectorsGetAgentConnector.js";
 import { agentConnectorsListAgentConnectors } from "../funcs/agentConnectorsListAgentConnectors.js";
+import { agentConnectorsSetupWhatsAppAppWebhook } from "../funcs/agentConnectorsSetupWhatsAppAppWebhook.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
 import * as operations from "../models/operations/index.js";
@@ -34,7 +35,7 @@ export class AgentConnectors extends ClientSDK {
    * Create a connector
    *
    * @remarks
-   * Connects the agent to a Telegram bot, validates the bot token, and registers the agent's webhook. Telegram text, photos, and gateway-supported documents can invoke the agent; inbound media additionally requires write:files. Managed outbound files require read:files, and generated images require both file scopes so their transient provider URLs can be materialized before delivery. The optional write:feedback scope enables native thumbs reaction synchronization to gateway response feedback. These conditional scopes are deliberately not part of x-required-scopes because text-only connectors do not need them. An API key with every listed scope is required; its identity tuple and current scopes are stored as a non-widening ceiling, then revalidated with mk-authentication before every connector run; session and delegated end-user contexts are rejected. The required access policy controls which Telegram chats may invoke the agent.
+   * Connects the agent to a Telegram bot or WhatsApp Business phone number, validates the provider credentials, and registers the agent's webhook. Text, photos, and gateway-supported documents can invoke the agent; inbound media additionally requires write:files. Managed outbound files require read:files, and generated images require both file scopes so their transient provider URLs can be materialized before delivery. The optional write:feedback scope enables native thumbs reaction synchronization to gateway response feedback. These conditional scopes are deliberately not part of x-required-scopes because text-only connectors do not need them. An API key with every listed scope is required; its identity tuple and current scopes are stored as a non-widening ceiling, then revalidated with mk-authentication before every connector run; session and delegated end-user contexts are rejected. The required access policy controls which provider users or chats may invoke the agent.
    */
   async createAgentConnector(
     request: operations.CreateAgentConnectorRequest,
@@ -47,6 +48,23 @@ export class AgentConnectors extends ClientSDK {
     ));
   }
 
+  /**
+   * Set up a WhatsApp app webhook
+   *
+   * @remarks
+   * Returns the app-level callback URL and verification token that must be saved in Meta before the first WhatsApp phone connector is created. The caller must be allowed to manage the agent. The stable verification token is returned only in this no-store response and is not a Meta access token.
+   */
+  async setupWhatsAppAppWebhook(
+    request: operations.SetupWhatsAppAppWebhookRequest,
+    options?: RequestOptions,
+  ): Promise<operations.SetupWhatsAppAppWebhookResponse> {
+    return unwrapAsync(agentConnectorsSetupWhatsAppAppWebhook(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Retrieve a connector
    *
@@ -68,7 +86,7 @@ export class AgentConnectors extends ClientSDK {
    * Delete a connector
    *
    * @remarks
-   * Unregisters the provider webhook, drops its pending Telegram updates, and deletes the stored connector credentials.
+   * Unregisters the connector-specific provider webhook and deletes the stored connector credentials. Telegram pending updates are dropped; WhatsApp deletion clears only the phone-number callback and does not unsubscribe other numbers in the business account.
    */
   async deleteAgentConnector(
     request: operations.DeleteAgentConnectorRequest,
@@ -85,7 +103,7 @@ export class AgentConnectors extends ClientSDK {
    * Activate a connector
    *
    * @remarks
-   * Revalidates the stored Telegram credentials and registers the provider webhook. Use this to retry a connector left in an error state or rotate its key. API-key authentication with every listed scope is required; session authentication is rejected, and the new key must belong to the connector's original user or service-account principal so existing conversations keep the same owner.
+   * Revalidates the stored provider credentials and registers the provider webhook. Use this to retry a connector left in an error state. API-key authentication with every listed scope is required; session authentication is rejected, and the key must belong to the connector's original user or service-account principal so existing conversations keep the same owner.
    */
   async activateAgentConnector(
     request: operations.ActivateAgentConnectorRequest,