@meetkai/mka1 0.49.12 → 0.49.14

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/agentConnectorsCreateAgentConnector.ts

@@ -51,7 +51,7 @@ export type AgentConnectorsCreateAgentConnectorMutationError =
  * Create a connector
  *
  * @remarks
- * 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.
+ * Connects the agent to a Telegram bot or WhatsApp Business phone number, validates the provider credentials, and registers the agent's webhook. WhatsApp connector support is beta. 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/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 (Beta)
+ *
+ * @remarks
+ * Beta. 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 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.
+   * Connects the agent to a Telegram bot or WhatsApp Business phone number, validates the provider credentials, and registers the agent's webhook. WhatsApp connector support is beta. 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 (Beta)
+   *
+   * @remarks
+   * Beta. 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
    *