@meetkai/mka1 0.49.11 → 0.49.12

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";

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<

package/src/sdk/agentconnectors.ts

@@ -34,7 +34,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,
@@ -68,7 +68,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 +85,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,