@meetkai/mka1 0.49.12 → 0.49.13

package/src/funcs/agentConnectorsSetupWhatsAppAppWebhook.ts

@@ -0,0 +1,201 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { SDKCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.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 { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * 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 agentConnectorsSetupWhatsAppAppWebhook(
+  client: SDKCore,
+  request: operations.SetupWhatsAppAppWebhookRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.SetupWhatsAppAppWebhookResponse,
+    | errors.ErrorEnvelope
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: SDKCore,
+  request: operations.SetupWhatsAppAppWebhookRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.SetupWhatsAppAppWebhookResponse,
+      | errors.ErrorEnvelope
+      | SDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.SetupWhatsAppAppWebhookRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.WhatsAppWebhookSetupRequest, {
+    explode: true,
+  });
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/api/v1/agents/{id}/connectors/whatsapp/setup")(
+    pathParams,
+  );
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    "X-On-Behalf-Of": encodeSimple(
+      "X-On-Behalf-Of",
+      payload["X-On-Behalf-Of"],
+      { explode: false, charEncoding: "none" },
+    ),
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearerAuth);
+  const securityInput = secConfig == null ? {} : { bearerAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "setupWhatsAppAppWebhook",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearerAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || {
+        strategy: "backoff",
+        backoff: {
+          initialInterval: 500,
+          maxInterval: 5000,
+          exponent: 1.5,
+          maxElapsedTime: 15000,
+        },
+        retryConnectionErrors: true,
+      }
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    operations.SetupWhatsAppAppWebhookResponse,
+    | errors.ErrorEnvelope
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.SetupWhatsAppAppWebhookResponse$inboundSchema, {
+      hdrs: true,
+      key: "Result",
+    }),
+    M.jsonErr([400, 401, 403, 404], errors.ErrorEnvelope$inboundSchema),
+    M.jsonErr(503, errors.ErrorEnvelope$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.1.0",
-  sdkVersion: "0.49.12",
+  sdkVersion: "0.49.13",
   genVersion: "2.918.3",
-  userAgent: "speakeasy-sdk/typescript 0.49.12 2.918.3 1.1.0 @meetkai/mka1",
+  userAgent: "speakeasy-sdk/typescript 0.49.13 2.918.3 1.1.0 @meetkai/mka1",
 } as const;

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

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.49.12",
+    currentVersion: "0.49.13",
   },
 });
 

package/src/mcp-server/server.ts

@@ -18,6 +18,7 @@ import { tool$agentConnectorsCreateAgentConnector } from "./tools/agentConnector
 import { tool$agentConnectorsDeleteAgentConnector } from "./tools/agentConnectorsDeleteAgentConnector.js";
 import { tool$agentConnectorsGetAgentConnector } from "./tools/agentConnectorsGetAgentConnector.js";
 import { tool$agentConnectorsListAgentConnectors } from "./tools/agentConnectorsListAgentConnectors.js";
+import { tool$agentConnectorsSetupWhatsAppAppWebhook } from "./tools/agentConnectorsSetupWhatsAppAppWebhook.js";
 import { tool$agentRunsCreateAgentRun } from "./tools/agentRunsCreateAgentRun.js";
 import { tool$agentRunsGetAgentRun } from "./tools/agentRunsGetAgentRun.js";
 import { tool$agentRunsListAgentRuns } from "./tools/agentRunsListAgentRuns.js";
@@ -345,7 +346,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "SDK",
-    version: "0.49.12",
+    version: "0.49.13",
   });
 
   const client = new SDKCore({
@@ -404,6 +405,7 @@ export function createMCPServer(deps: {
   tool(tool$agentsDeleteAgent);
   tool(tool$agentConnectorsListAgentConnectors);
   tool(tool$agentConnectorsCreateAgentConnector);
+  tool(tool$agentConnectorsSetupWhatsAppAppWebhook);
   tool(tool$agentConnectorsGetAgentConnector);
   tool(tool$agentConnectorsDeleteAgentConnector);
   tool(tool$agentConnectorsActivateAgentConnector);

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

@@ -550,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`,
+  );
+}