@meetkai/mka1 0.49.11 → 0.49.13

package/src/models/components/createwhatsappagentconnectorrequest.ts

@@ -0,0 +1,301 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type CreateWhatsAppAgentConnectorRequestCredentials = {
+  /**
+   * Long-lived Meta system-user access token with whatsapp_business_messaging and whatsapp_business_management permissions. It is encrypted at rest and never returned.
+   */
+  accessToken: string;
+  /**
+   * Meta app secret used to authenticate webhook payloads. It is encrypted at rest and never returned.
+   */
+  appSecret: string;
+};
+
+export type Account = {
+  /**
+   * Meta app ID. It is used with the app secret to verify that the system-user token belongs to this app and has the required WhatsApp permissions.
+   */
+  appId: string;
+  whatsappBusinessAccountId: string;
+  phoneNumberId: string;
+};
+
+export const CreateWhatsAppAgentConnectorRequestMode = {
+  Allowlist: "allowlist",
+} as const;
+export type CreateWhatsAppAgentConnectorRequestMode = ClosedEnum<
+  typeof CreateWhatsAppAgentConnectorRequestMode
+>;
+
+/**
+ * Exact WhatsApp sender IDs permitted to invoke the agent. These are digit strings without a leading plus sign.
+ */
+export type CreateWhatsAppAgentConnectorRequestAccess = {
+  mode: CreateWhatsAppAgentConnectorRequestMode;
+  userIds: Array<string>;
+};
+
+export type CreateWhatsAppAgentConnectorRequest = {
+  /**
+   * WhatsApp Cloud API connector with text, image, document, and native thumbs-reaction feedback support.
+   */
+  provider: "whatsapp";
+  name?: string | undefined;
+  credentials: CreateWhatsAppAgentConnectorRequestCredentials;
+  account: Account;
+  /**
+   * Exact WhatsApp sender IDs permitted to invoke the agent. These are digit strings without a leading plus sign.
+   */
+  access: CreateWhatsAppAgentConnectorRequestAccess;
+};
+
+/** @internal */
+export const CreateWhatsAppAgentConnectorRequestCredentials$inboundSchema:
+  z.ZodType<
+    CreateWhatsAppAgentConnectorRequestCredentials,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    access_token: z.string(),
+    app_secret: z.string(),
+  }).transform((v) => {
+    return remap$(v, {
+      "access_token": "accessToken",
+      "app_secret": "appSecret",
+    });
+  });
+/** @internal */
+export type CreateWhatsAppAgentConnectorRequestCredentials$Outbound = {
+  access_token: string;
+  app_secret: string;
+};
+
+/** @internal */
+export const CreateWhatsAppAgentConnectorRequestCredentials$outboundSchema:
+  z.ZodType<
+    CreateWhatsAppAgentConnectorRequestCredentials$Outbound,
+    z.ZodTypeDef,
+    CreateWhatsAppAgentConnectorRequestCredentials
+  > = z.object({
+    accessToken: z.string(),
+    appSecret: z.string(),
+  }).transform((v) => {
+    return remap$(v, {
+      accessToken: "access_token",
+      appSecret: "app_secret",
+    });
+  });
+
+export function createWhatsAppAgentConnectorRequestCredentialsToJSON(
+  createWhatsAppAgentConnectorRequestCredentials:
+    CreateWhatsAppAgentConnectorRequestCredentials,
+): string {
+  return JSON.stringify(
+    CreateWhatsAppAgentConnectorRequestCredentials$outboundSchema.parse(
+      createWhatsAppAgentConnectorRequestCredentials,
+    ),
+  );
+}
+export function createWhatsAppAgentConnectorRequestCredentialsFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  CreateWhatsAppAgentConnectorRequestCredentials,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CreateWhatsAppAgentConnectorRequestCredentials$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'CreateWhatsAppAgentConnectorRequestCredentials' from JSON`,
+  );
+}
+
+/** @internal */
+export const Account$inboundSchema: z.ZodType<Account, z.ZodTypeDef, unknown> =
+  z.object({
+    app_id: z.string(),
+    whatsapp_business_account_id: z.string(),
+    phone_number_id: z.string(),
+  }).transform((v) => {
+    return remap$(v, {
+      "app_id": "appId",
+      "whatsapp_business_account_id": "whatsappBusinessAccountId",
+      "phone_number_id": "phoneNumberId",
+    });
+  });
+/** @internal */
+export type Account$Outbound = {
+  app_id: string;
+  whatsapp_business_account_id: string;
+  phone_number_id: string;
+};
+
+/** @internal */
+export const Account$outboundSchema: z.ZodType<
+  Account$Outbound,
+  z.ZodTypeDef,
+  Account
+> = z.object({
+  appId: z.string(),
+  whatsappBusinessAccountId: z.string(),
+  phoneNumberId: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    appId: "app_id",
+    whatsappBusinessAccountId: "whatsapp_business_account_id",
+    phoneNumberId: "phone_number_id",
+  });
+});
+
+export function accountToJSON(account: Account): string {
+  return JSON.stringify(Account$outboundSchema.parse(account));
+}
+export function accountFromJSON(
+  jsonString: string,
+): SafeParseResult<Account, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Account$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Account' from JSON`,
+  );
+}
+
+/** @internal */
+export const CreateWhatsAppAgentConnectorRequestMode$inboundSchema:
+  z.ZodNativeEnum<typeof CreateWhatsAppAgentConnectorRequestMode> = z
+    .nativeEnum(CreateWhatsAppAgentConnectorRequestMode);
+/** @internal */
+export const CreateWhatsAppAgentConnectorRequestMode$outboundSchema:
+  z.ZodNativeEnum<typeof CreateWhatsAppAgentConnectorRequestMode> =
+    CreateWhatsAppAgentConnectorRequestMode$inboundSchema;
+
+/** @internal */
+export const CreateWhatsAppAgentConnectorRequestAccess$inboundSchema: z.ZodType<
+  CreateWhatsAppAgentConnectorRequestAccess,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  mode: CreateWhatsAppAgentConnectorRequestMode$inboundSchema,
+  user_ids: z.array(z.string()),
+}).transform((v) => {
+  return remap$(v, {
+    "user_ids": "userIds",
+  });
+});
+/** @internal */
+export type CreateWhatsAppAgentConnectorRequestAccess$Outbound = {
+  mode: string;
+  user_ids: Array<string>;
+};
+
+/** @internal */
+export const CreateWhatsAppAgentConnectorRequestAccess$outboundSchema:
+  z.ZodType<
+    CreateWhatsAppAgentConnectorRequestAccess$Outbound,
+    z.ZodTypeDef,
+    CreateWhatsAppAgentConnectorRequestAccess
+  > = z.object({
+    mode: CreateWhatsAppAgentConnectorRequestMode$outboundSchema,
+    userIds: z.array(z.string()),
+  }).transform((v) => {
+    return remap$(v, {
+      userIds: "user_ids",
+    });
+  });
+
+export function createWhatsAppAgentConnectorRequestAccessToJSON(
+  createWhatsAppAgentConnectorRequestAccess:
+    CreateWhatsAppAgentConnectorRequestAccess,
+): string {
+  return JSON.stringify(
+    CreateWhatsAppAgentConnectorRequestAccess$outboundSchema.parse(
+      createWhatsAppAgentConnectorRequestAccess,
+    ),
+  );
+}
+export function createWhatsAppAgentConnectorRequestAccessFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  CreateWhatsAppAgentConnectorRequestAccess,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CreateWhatsAppAgentConnectorRequestAccess$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'CreateWhatsAppAgentConnectorRequestAccess' from JSON`,
+  );
+}
+
+/** @internal */
+export const CreateWhatsAppAgentConnectorRequest$inboundSchema: z.ZodType<
+  CreateWhatsAppAgentConnectorRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  provider: z.literal("whatsapp"),
+  name: z.string().optional(),
+  credentials: z.lazy(() =>
+    CreateWhatsAppAgentConnectorRequestCredentials$inboundSchema
+  ),
+  account: z.lazy(() => Account$inboundSchema),
+  access: z.lazy(() => CreateWhatsAppAgentConnectorRequestAccess$inboundSchema),
+});
+/** @internal */
+export type CreateWhatsAppAgentConnectorRequest$Outbound = {
+  provider: "whatsapp";
+  name?: string | undefined;
+  credentials: CreateWhatsAppAgentConnectorRequestCredentials$Outbound;
+  account: Account$Outbound;
+  access: CreateWhatsAppAgentConnectorRequestAccess$Outbound;
+};
+
+/** @internal */
+export const CreateWhatsAppAgentConnectorRequest$outboundSchema: z.ZodType<
+  CreateWhatsAppAgentConnectorRequest$Outbound,
+  z.ZodTypeDef,
+  CreateWhatsAppAgentConnectorRequest
+> = z.object({
+  provider: z.literal("whatsapp"),
+  name: z.string().optional(),
+  credentials: z.lazy(() =>
+    CreateWhatsAppAgentConnectorRequestCredentials$outboundSchema
+  ),
+  account: z.lazy(() => Account$outboundSchema),
+  access: z.lazy(() =>
+    CreateWhatsAppAgentConnectorRequestAccess$outboundSchema
+  ),
+});
+
+export function createWhatsAppAgentConnectorRequestToJSON(
+  createWhatsAppAgentConnectorRequest: CreateWhatsAppAgentConnectorRequest,
+): string {
+  return JSON.stringify(
+    CreateWhatsAppAgentConnectorRequest$outboundSchema.parse(
+      createWhatsAppAgentConnectorRequest,
+    ),
+  );
+}
+export function createWhatsAppAgentConnectorRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateWhatsAppAgentConnectorRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CreateWhatsAppAgentConnectorRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateWhatsAppAgentConnectorRequest' from JSON`,
+  );
+}

package/src/models/components/index.ts

@@ -100,10 +100,12 @@ export * from "./createpromptrequest.js";
 export * from "./createpromptresponse.js";
 export * from "./createsessionrequest.js";
 export * from "./createsessionresponse.js";
+export * from "./createtelegramagentconnectorrequest.js";
 export * from "./createvectorstorefilebatchrequest.js";
 export * from "./createvectorstorefilerequest.js";
 export * from "./createvectorstorerequest.js";
 export * from "./createversionresponse.js";
+export * from "./createwhatsappagentconnectorrequest.js";
 export * from "./customtoolcall.js";
 export * from "./customtoolcalloutput.js";
 export * from "./customtoolcalloutputwithid.js";
@@ -548,6 +550,8 @@ export * from "./websearchpreviewtooldefinition.js";
 export * from "./websearchtoolcall.js";
 export * from "./websearchtoolcallwithid.js";
 export * from "./websearchtooldefinition.js";
+export * from "./whatsappwebhooksetup.js";
+export * from "./whatsappwebhooksetuprequest.js";
 export * from "./workspacearchiverequest.js";
 export * from "./workspacefile.js";
 export * from "./workspacemanifest.js";

package/src/models/components/whatsappwebhooksetup.ts

@@ -0,0 +1,96 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export const WhatsAppWebhookSetupObject = {
+  AgentConnectorWhatsappWebhookSetup: "agent.connector.whatsapp_webhook_setup",
+} as const;
+export type WhatsAppWebhookSetupObject = ClosedEnum<
+  typeof WhatsAppWebhookSetupObject
+>;
+
+export type WhatsAppWebhookSetup = {
+  object: WhatsAppWebhookSetupObject;
+  appId: string;
+  callbackUrl: string;
+  /**
+   * Stable verification value for Meta's app-level Webhooks form. This is not a Meta API access token.
+   */
+  verifyToken: string;
+};
+
+/** @internal */
+export const WhatsAppWebhookSetupObject$inboundSchema: z.ZodNativeEnum<
+  typeof WhatsAppWebhookSetupObject
+> = z.nativeEnum(WhatsAppWebhookSetupObject);
+/** @internal */
+export const WhatsAppWebhookSetupObject$outboundSchema: z.ZodNativeEnum<
+  typeof WhatsAppWebhookSetupObject
+> = WhatsAppWebhookSetupObject$inboundSchema;
+
+/** @internal */
+export const WhatsAppWebhookSetup$inboundSchema: z.ZodType<
+  WhatsAppWebhookSetup,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  object: WhatsAppWebhookSetupObject$inboundSchema,
+  app_id: z.string(),
+  callback_url: z.string(),
+  verify_token: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "app_id": "appId",
+    "callback_url": "callbackUrl",
+    "verify_token": "verifyToken",
+  });
+});
+/** @internal */
+export type WhatsAppWebhookSetup$Outbound = {
+  object: string;
+  app_id: string;
+  callback_url: string;
+  verify_token: string;
+};
+
+/** @internal */
+export const WhatsAppWebhookSetup$outboundSchema: z.ZodType<
+  WhatsAppWebhookSetup$Outbound,
+  z.ZodTypeDef,
+  WhatsAppWebhookSetup
+> = z.object({
+  object: WhatsAppWebhookSetupObject$outboundSchema,
+  appId: z.string(),
+  callbackUrl: z.string(),
+  verifyToken: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    appId: "app_id",
+    callbackUrl: "callback_url",
+    verifyToken: "verify_token",
+  });
+});
+
+export function whatsAppWebhookSetupToJSON(
+  whatsAppWebhookSetup: WhatsAppWebhookSetup,
+): string {
+  return JSON.stringify(
+    WhatsAppWebhookSetup$outboundSchema.parse(whatsAppWebhookSetup),
+  );
+}
+export function whatsAppWebhookSetupFromJSON(
+  jsonString: string,
+): SafeParseResult<WhatsAppWebhookSetup, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WhatsAppWebhookSetup$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WhatsAppWebhookSetup' from JSON`,
+  );
+}

package/src/models/components/whatsappwebhooksetuprequest.ts

@@ -0,0 +1,62 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type WhatsAppWebhookSetupRequest = {
+  appId: string;
+};
+
+/** @internal */
+export const WhatsAppWebhookSetupRequest$inboundSchema: z.ZodType<
+  WhatsAppWebhookSetupRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  app_id: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "app_id": "appId",
+  });
+});
+/** @internal */
+export type WhatsAppWebhookSetupRequest$Outbound = {
+  app_id: string;
+};
+
+/** @internal */
+export const WhatsAppWebhookSetupRequest$outboundSchema: z.ZodType<
+  WhatsAppWebhookSetupRequest$Outbound,
+  z.ZodTypeDef,
+  WhatsAppWebhookSetupRequest
+> = z.object({
+  appId: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    appId: "app_id",
+  });
+});
+
+export function whatsAppWebhookSetupRequestToJSON(
+  whatsAppWebhookSetupRequest: WhatsAppWebhookSetupRequest,
+): string {
+  return JSON.stringify(
+    WhatsAppWebhookSetupRequest$outboundSchema.parse(
+      whatsAppWebhookSetupRequest,
+    ),
+  );
+}
+export function whatsAppWebhookSetupRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<WhatsAppWebhookSetupRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WhatsAppWebhookSetupRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WhatsAppWebhookSetupRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -273,6 +273,7 @@ export * from "./setapikeybudget.js";
 export * from "./setcurrency.js";
 export * from "./setorgbudget.js";
 export * from "./setorgprice.js";
+export * from "./setupwhatsappappwebhook.js";
 export * from "./startexportfeedback.js";
 export * from "./streamagentrunevents.js";
 export * from "./suspendclusterorg.js";

package/src/models/operations/setupwhatsappappwebhook.ts

@@ -0,0 +1,140 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type SetupWhatsAppAppWebhookRequest = {
+  /**
+   * The agent ID.
+   */
+  id: string;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+  whatsAppWebhookSetupRequest: components.WhatsAppWebhookSetupRequest;
+};
+
+export type SetupWhatsAppAppWebhookResponse = {
+  headers: { [k: string]: Array<string> };
+  result: components.WhatsAppWebhookSetup;
+};
+
+/** @internal */
+export const SetupWhatsAppAppWebhookRequest$inboundSchema: z.ZodType<
+  SetupWhatsAppAppWebhookRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  "X-On-Behalf-Of": z.string().optional(),
+  WhatsAppWebhookSetupRequest:
+    components.WhatsAppWebhookSetupRequest$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "X-On-Behalf-Of": "xOnBehalfOf",
+    "WhatsAppWebhookSetupRequest": "whatsAppWebhookSetupRequest",
+  });
+});
+/** @internal */
+export type SetupWhatsAppAppWebhookRequest$Outbound = {
+  id: string;
+  "X-On-Behalf-Of"?: string | undefined;
+  WhatsAppWebhookSetupRequest: components.WhatsAppWebhookSetupRequest$Outbound;
+};
+
+/** @internal */
+export const SetupWhatsAppAppWebhookRequest$outboundSchema: z.ZodType<
+  SetupWhatsAppAppWebhookRequest$Outbound,
+  z.ZodTypeDef,
+  SetupWhatsAppAppWebhookRequest
+> = z.object({
+  id: z.string(),
+  xOnBehalfOf: z.string().optional(),
+  whatsAppWebhookSetupRequest:
+    components.WhatsAppWebhookSetupRequest$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    xOnBehalfOf: "X-On-Behalf-Of",
+    whatsAppWebhookSetupRequest: "WhatsAppWebhookSetupRequest",
+  });
+});
+
+export function setupWhatsAppAppWebhookRequestToJSON(
+  setupWhatsAppAppWebhookRequest: SetupWhatsAppAppWebhookRequest,
+): string {
+  return JSON.stringify(
+    SetupWhatsAppAppWebhookRequest$outboundSchema.parse(
+      setupWhatsAppAppWebhookRequest,
+    ),
+  );
+}
+export function setupWhatsAppAppWebhookRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<SetupWhatsAppAppWebhookRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SetupWhatsAppAppWebhookRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SetupWhatsAppAppWebhookRequest' from JSON`,
+  );
+}
+
+/** @internal */
+export const SetupWhatsAppAppWebhookResponse$inboundSchema: z.ZodType<
+  SetupWhatsAppAppWebhookResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  Headers: z.record(z.array(z.string())).default({}),
+  Result: components.WhatsAppWebhookSetup$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "Headers": "headers",
+    "Result": "result",
+  });
+});
+/** @internal */
+export type SetupWhatsAppAppWebhookResponse$Outbound = {
+  Headers: { [k: string]: Array<string> };
+  Result: components.WhatsAppWebhookSetup$Outbound;
+};
+
+/** @internal */
+export const SetupWhatsAppAppWebhookResponse$outboundSchema: z.ZodType<
+  SetupWhatsAppAppWebhookResponse$Outbound,
+  z.ZodTypeDef,
+  SetupWhatsAppAppWebhookResponse
+> = z.object({
+  headers: z.record(z.array(z.string())),
+  result: components.WhatsAppWebhookSetup$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    headers: "Headers",
+    result: "Result",
+  });
+});
+
+export function setupWhatsAppAppWebhookResponseToJSON(
+  setupWhatsAppAppWebhookResponse: SetupWhatsAppAppWebhookResponse,
+): string {
+  return JSON.stringify(
+    SetupWhatsAppAppWebhookResponse$outboundSchema.parse(
+      setupWhatsAppAppWebhookResponse,
+    ),
+  );
+}
+export function setupWhatsAppAppWebhookResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<SetupWhatsAppAppWebhookResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SetupWhatsAppAppWebhookResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SetupWhatsAppAppWebhookResponse' from JSON`,
+  );
+}

package/src/react-query/agentConnectorsActivateAgentConnector.ts

@@ -51,7 +51,7 @@ export type AgentConnectorsActivateAgentConnectorMutationError =
  * 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.
  */
 export function useAgentConnectorsActivateAgentConnectorMutation(
   options?: MutationHookOptions<

package/src/react-query/agentConnectorsCreateAgentConnector.ts

@@ -51,7 +51,7 @@ export type AgentConnectorsCreateAgentConnectorMutationError =
  * 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.
  */
 export function useAgentConnectorsCreateAgentConnectorMutation(
   options?: MutationHookOptions<

package/src/react-query/agentConnectorsDeleteAgentConnector.ts

@@ -51,7 +51,7 @@ export type AgentConnectorsDeleteAgentConnectorMutationError =
  * 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.
  */
 export function useAgentConnectorsDeleteAgentConnectorMutation(
   options?: MutationHookOptions<