@meetkai/mka1 0.49.11 → 0.49.13

package/src/mcp-server/tools/agentConnectorsSetupWhatsAppAppWebhook.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { agentConnectorsSetupWhatsAppAppWebhook } from "../../funcs/agentConnectorsSetupWhatsAppAppWebhook.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.SetupWhatsAppAppWebhookRequest$inboundSchema,
+};
+
+export const tool$agentConnectorsSetupWhatsAppAppWebhook: ToolDefinition<
+  typeof args
+> = {
+  name: "agent-connectors-setup-whats-app-app-webhook",
+  description: `Set up a WhatsApp app webhook
+
+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.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await agentConnectorsSetupWhatsAppAppWebhook(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value.result;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/models/components/agentconnector.ts

@@ -22,6 +22,7 @@ export type AgentConnectorObject = ClosedEnum<typeof AgentConnectorObject>;
 
 export const Provider = {
   Telegram: "telegram",
+  Whatsapp: "whatsapp",
 } as const;
 export type Provider = ClosedEnum<typeof Provider>;
 
@@ -36,11 +37,11 @@ export type AgentConnector = {
    */
   status: string;
   /**
-   * The Telegram bot user ID.
+   * The provider account ID: Telegram bot user ID or WhatsApp phone-number ID.
    */
   providerAccountId: string;
   /**
-   * The Telegram bot username when one is available.
+   * Provider account display name when one is available.
    */
   providerAccountName: string | null;
   config: JsonValue | null;

package/src/models/components/createagentconnectorrequest.ts

@@ -3,218 +3,49 @@
  */
 
 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";
-
-/**
- * Telegram Bot API connector. Supports text, photos up to the Bot API's 20 MiB download limit, gateway-supported documents, and response feedback through native thumbs reactions.
- */
-export const CreateAgentConnectorRequestProvider = {
-  Telegram: "telegram",
-} as const;
-/**
- * Telegram Bot API connector. Supports text, photos up to the Bot API's 20 MiB download limit, gateway-supported documents, and response feedback through native thumbs reactions.
- */
-export type CreateAgentConnectorRequestProvider = ClosedEnum<
-  typeof CreateAgentConnectorRequestProvider
->;
-
-export type Credentials = {
-  /**
-   * Telegram bot token issued by BotFather. It is encrypted at rest and is never returned by the API.
-   */
-  botToken: string;
-};
-
-export const CreateAgentConnectorRequestMode = {
-  Allowlist: "allowlist",
-} as const;
-export type CreateAgentConnectorRequestMode = ClosedEnum<
-  typeof CreateAgentConnectorRequestMode
->;
-
-/**
- * The explicit Telegram chat allowlist permitted to invoke the agent.
- */
-export type CreateAgentConnectorRequestAccess = {
-  mode: CreateAgentConnectorRequestMode;
-  chatIds: Array<number>;
-};
-
-export type CreateAgentConnectorRequest = {
-  /**
-   * Telegram Bot API connector. Supports text, photos up to the Bot API's 20 MiB download limit, gateway-supported documents, and response feedback through native thumbs reactions.
-   */
-  provider: CreateAgentConnectorRequestProvider;
-  name?: string | undefined;
-  credentials: Credentials;
-  /**
-   * The explicit Telegram chat allowlist permitted to invoke the agent.
-   */
-  access: CreateAgentConnectorRequestAccess;
-  /**
-   * Always true: Telegram discards updates queued before this tenancy's webhook is registered.
-   */
-  dropPendingUpdates?: true | undefined;
-};
-
-/** @internal */
-export const CreateAgentConnectorRequestProvider$inboundSchema: z.ZodNativeEnum<
-  typeof CreateAgentConnectorRequestProvider
-> = z.nativeEnum(CreateAgentConnectorRequestProvider);
-/** @internal */
-export const CreateAgentConnectorRequestProvider$outboundSchema:
-  z.ZodNativeEnum<typeof CreateAgentConnectorRequestProvider> =
-    CreateAgentConnectorRequestProvider$inboundSchema;
-
-/** @internal */
-export const Credentials$inboundSchema: z.ZodType<
-  Credentials,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  bot_token: z.string(),
-}).transform((v) => {
-  return remap$(v, {
-    "bot_token": "botToken",
-  });
-});
-/** @internal */
-export type Credentials$Outbound = {
-  bot_token: string;
-};
-
-/** @internal */
-export const Credentials$outboundSchema: z.ZodType<
-  Credentials$Outbound,
-  z.ZodTypeDef,
-  Credentials
-> = z.object({
-  botToken: z.string(),
-}).transform((v) => {
-  return remap$(v, {
-    botToken: "bot_token",
-  });
-});
-
-export function credentialsToJSON(credentials: Credentials): string {
-  return JSON.stringify(Credentials$outboundSchema.parse(credentials));
-}
-export function credentialsFromJSON(
-  jsonString: string,
-): SafeParseResult<Credentials, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => Credentials$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Credentials' from JSON`,
-  );
-}
-
-/** @internal */
-export const CreateAgentConnectorRequestMode$inboundSchema: z.ZodNativeEnum<
-  typeof CreateAgentConnectorRequestMode
-> = z.nativeEnum(CreateAgentConnectorRequestMode);
-/** @internal */
-export const CreateAgentConnectorRequestMode$outboundSchema: z.ZodNativeEnum<
-  typeof CreateAgentConnectorRequestMode
-> = CreateAgentConnectorRequestMode$inboundSchema;
-
-/** @internal */
-export const CreateAgentConnectorRequestAccess$inboundSchema: z.ZodType<
-  CreateAgentConnectorRequestAccess,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  mode: CreateAgentConnectorRequestMode$inboundSchema,
-  chat_ids: z.array(z.number().int()),
-}).transform((v) => {
-  return remap$(v, {
-    "chat_ids": "chatIds",
-  });
-});
-/** @internal */
-export type CreateAgentConnectorRequestAccess$Outbound = {
-  mode: string;
-  chat_ids: Array<number>;
-};
-
-/** @internal */
-export const CreateAgentConnectorRequestAccess$outboundSchema: z.ZodType<
-  CreateAgentConnectorRequestAccess$Outbound,
-  z.ZodTypeDef,
-  CreateAgentConnectorRequestAccess
-> = z.object({
-  mode: CreateAgentConnectorRequestMode$outboundSchema,
-  chatIds: z.array(z.number().int()),
-}).transform((v) => {
-  return remap$(v, {
-    chatIds: "chat_ids",
-  });
-});
-
-export function createAgentConnectorRequestAccessToJSON(
-  createAgentConnectorRequestAccess: CreateAgentConnectorRequestAccess,
-): string {
-  return JSON.stringify(
-    CreateAgentConnectorRequestAccess$outboundSchema.parse(
-      createAgentConnectorRequestAccess,
-    ),
-  );
-}
-export function createAgentConnectorRequestAccessFromJSON(
-  jsonString: string,
-): SafeParseResult<CreateAgentConnectorRequestAccess, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => CreateAgentConnectorRequestAccess$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'CreateAgentConnectorRequestAccess' from JSON`,
-  );
-}
+import {
+  CreateTelegramAgentConnectorRequest,
+  CreateTelegramAgentConnectorRequest$inboundSchema,
+  CreateTelegramAgentConnectorRequest$Outbound,
+  CreateTelegramAgentConnectorRequest$outboundSchema,
+} from "./createtelegramagentconnectorrequest.js";
+import {
+  CreateWhatsAppAgentConnectorRequest,
+  CreateWhatsAppAgentConnectorRequest$inboundSchema,
+  CreateWhatsAppAgentConnectorRequest$Outbound,
+  CreateWhatsAppAgentConnectorRequest$outboundSchema,
+} from "./createwhatsappagentconnectorrequest.js";
+
+export type CreateAgentConnectorRequest =
+  | CreateTelegramAgentConnectorRequest
+  | CreateWhatsAppAgentConnectorRequest;
 
 /** @internal */
 export const CreateAgentConnectorRequest$inboundSchema: z.ZodType<
   CreateAgentConnectorRequest,
   z.ZodTypeDef,
   unknown
-> = z.object({
-  provider: CreateAgentConnectorRequestProvider$inboundSchema,
-  name: z.string().optional(),
-  credentials: z.lazy(() => Credentials$inboundSchema),
-  access: z.lazy(() => CreateAgentConnectorRequestAccess$inboundSchema),
-  drop_pending_updates: z.literal(true).default(true),
-}).transform((v) => {
-  return remap$(v, {
-    "drop_pending_updates": "dropPendingUpdates",
-  });
-});
+> = z.union([
+  CreateTelegramAgentConnectorRequest$inboundSchema,
+  CreateWhatsAppAgentConnectorRequest$inboundSchema,
+]);
 /** @internal */
-export type CreateAgentConnectorRequest$Outbound = {
-  provider: string;
-  name?: string | undefined;
-  credentials: Credentials$Outbound;
-  access: CreateAgentConnectorRequestAccess$Outbound;
-  drop_pending_updates: true;
-};
+export type CreateAgentConnectorRequest$Outbound =
+  | CreateTelegramAgentConnectorRequest$Outbound
+  | CreateWhatsAppAgentConnectorRequest$Outbound;
 
 /** @internal */
 export const CreateAgentConnectorRequest$outboundSchema: z.ZodType<
   CreateAgentConnectorRequest$Outbound,
   z.ZodTypeDef,
   CreateAgentConnectorRequest
-> = z.object({
-  provider: CreateAgentConnectorRequestProvider$outboundSchema,
-  name: z.string().optional(),
-  credentials: z.lazy(() => Credentials$outboundSchema),
-  access: z.lazy(() => CreateAgentConnectorRequestAccess$outboundSchema),
-  dropPendingUpdates: z.literal(true).default(true as const),
-}).transform((v) => {
-  return remap$(v, {
-    dropPendingUpdates: "drop_pending_updates",
-  });
-});
+> = z.union([
+  CreateTelegramAgentConnectorRequest$outboundSchema,
+  CreateWhatsAppAgentConnectorRequest$outboundSchema,
+]);
 
 export function createAgentConnectorRequestToJSON(
   createAgentConnectorRequest: CreateAgentConnectorRequest,

package/src/models/components/createtelegramagentconnectorrequest.ts

@@ -0,0 +1,225 @@
+/*
+ * 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 Credentials = {
+  /**
+   * Telegram bot token issued by BotFather. It is encrypted at rest and is never returned by the API.
+   */
+  botToken: string;
+};
+
+export const CreateTelegramAgentConnectorRequestMode = {
+  Allowlist: "allowlist",
+} as const;
+export type CreateTelegramAgentConnectorRequestMode = ClosedEnum<
+  typeof CreateTelegramAgentConnectorRequestMode
+>;
+
+/**
+ * The explicit Telegram chat allowlist permitted to invoke the agent.
+ */
+export type CreateTelegramAgentConnectorRequestAccess = {
+  mode: CreateTelegramAgentConnectorRequestMode;
+  chatIds: Array<number>;
+};
+
+export type CreateTelegramAgentConnectorRequest = {
+  /**
+   * Telegram Bot API connector. Supports text, photos up to the Bot API's 20 MiB download limit, gateway-supported documents, and response feedback through native thumbs reactions.
+   */
+  provider: "telegram";
+  name?: string | undefined;
+  credentials: Credentials;
+  /**
+   * The explicit Telegram chat allowlist permitted to invoke the agent.
+   */
+  access: CreateTelegramAgentConnectorRequestAccess;
+  /**
+   * Always true: Telegram discards updates queued before this tenancy's webhook is registered.
+   */
+  dropPendingUpdates?: true | undefined;
+};
+
+/** @internal */
+export const Credentials$inboundSchema: z.ZodType<
+  Credentials,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  bot_token: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "bot_token": "botToken",
+  });
+});
+/** @internal */
+export type Credentials$Outbound = {
+  bot_token: string;
+};
+
+/** @internal */
+export const Credentials$outboundSchema: z.ZodType<
+  Credentials$Outbound,
+  z.ZodTypeDef,
+  Credentials
+> = z.object({
+  botToken: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    botToken: "bot_token",
+  });
+});
+
+export function credentialsToJSON(credentials: Credentials): string {
+  return JSON.stringify(Credentials$outboundSchema.parse(credentials));
+}
+export function credentialsFromJSON(
+  jsonString: string,
+): SafeParseResult<Credentials, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Credentials$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Credentials' from JSON`,
+  );
+}
+
+/** @internal */
+export const CreateTelegramAgentConnectorRequestMode$inboundSchema:
+  z.ZodNativeEnum<typeof CreateTelegramAgentConnectorRequestMode> = z
+    .nativeEnum(CreateTelegramAgentConnectorRequestMode);
+/** @internal */
+export const CreateTelegramAgentConnectorRequestMode$outboundSchema:
+  z.ZodNativeEnum<typeof CreateTelegramAgentConnectorRequestMode> =
+    CreateTelegramAgentConnectorRequestMode$inboundSchema;
+
+/** @internal */
+export const CreateTelegramAgentConnectorRequestAccess$inboundSchema: z.ZodType<
+  CreateTelegramAgentConnectorRequestAccess,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  mode: CreateTelegramAgentConnectorRequestMode$inboundSchema,
+  chat_ids: z.array(z.number().int()),
+}).transform((v) => {
+  return remap$(v, {
+    "chat_ids": "chatIds",
+  });
+});
+/** @internal */
+export type CreateTelegramAgentConnectorRequestAccess$Outbound = {
+  mode: string;
+  chat_ids: Array<number>;
+};
+
+/** @internal */
+export const CreateTelegramAgentConnectorRequestAccess$outboundSchema:
+  z.ZodType<
+    CreateTelegramAgentConnectorRequestAccess$Outbound,
+    z.ZodTypeDef,
+    CreateTelegramAgentConnectorRequestAccess
+  > = z.object({
+    mode: CreateTelegramAgentConnectorRequestMode$outboundSchema,
+    chatIds: z.array(z.number().int()),
+  }).transform((v) => {
+    return remap$(v, {
+      chatIds: "chat_ids",
+    });
+  });
+
+export function createTelegramAgentConnectorRequestAccessToJSON(
+  createTelegramAgentConnectorRequestAccess:
+    CreateTelegramAgentConnectorRequestAccess,
+): string {
+  return JSON.stringify(
+    CreateTelegramAgentConnectorRequestAccess$outboundSchema.parse(
+      createTelegramAgentConnectorRequestAccess,
+    ),
+  );
+}
+export function createTelegramAgentConnectorRequestAccessFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  CreateTelegramAgentConnectorRequestAccess,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CreateTelegramAgentConnectorRequestAccess$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'CreateTelegramAgentConnectorRequestAccess' from JSON`,
+  );
+}
+
+/** @internal */
+export const CreateTelegramAgentConnectorRequest$inboundSchema: z.ZodType<
+  CreateTelegramAgentConnectorRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  provider: z.literal("telegram"),
+  name: z.string().optional(),
+  credentials: z.lazy(() => Credentials$inboundSchema),
+  access: z.lazy(() => CreateTelegramAgentConnectorRequestAccess$inboundSchema),
+  drop_pending_updates: z.literal(true).default(true),
+}).transform((v) => {
+  return remap$(v, {
+    "drop_pending_updates": "dropPendingUpdates",
+  });
+});
+/** @internal */
+export type CreateTelegramAgentConnectorRequest$Outbound = {
+  provider: "telegram";
+  name?: string | undefined;
+  credentials: Credentials$Outbound;
+  access: CreateTelegramAgentConnectorRequestAccess$Outbound;
+  drop_pending_updates: true;
+};
+
+/** @internal */
+export const CreateTelegramAgentConnectorRequest$outboundSchema: z.ZodType<
+  CreateTelegramAgentConnectorRequest$Outbound,
+  z.ZodTypeDef,
+  CreateTelegramAgentConnectorRequest
+> = z.object({
+  provider: z.literal("telegram"),
+  name: z.string().optional(),
+  credentials: z.lazy(() => Credentials$outboundSchema),
+  access: z.lazy(() =>
+    CreateTelegramAgentConnectorRequestAccess$outboundSchema
+  ),
+  dropPendingUpdates: z.literal(true).default(true as const),
+}).transform((v) => {
+  return remap$(v, {
+    dropPendingUpdates: "drop_pending_updates",
+  });
+});
+
+export function createTelegramAgentConnectorRequestToJSON(
+  createTelegramAgentConnectorRequest: CreateTelegramAgentConnectorRequest,
+): string {
+  return JSON.stringify(
+    CreateTelegramAgentConnectorRequest$outboundSchema.parse(
+      createTelegramAgentConnectorRequest,
+    ),
+  );
+}
+export function createTelegramAgentConnectorRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateTelegramAgentConnectorRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CreateTelegramAgentConnectorRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateTelegramAgentConnectorRequest' from JSON`,
+  );
+}