@meetkai/mka1 0.49.1 → 0.49.3

package/src/models/operations/listagentconnectors.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 ListAgentConnectorsQueryParamOrder = {
+  Asc: "asc",
+  Desc: "desc",
+} as const;
+export type ListAgentConnectorsQueryParamOrder = ClosedEnum<
+  typeof ListAgentConnectorsQueryParamOrder
+>;
+
+export type ListAgentConnectorsRequest = {
+  /**
+   * The agent ID.
+   */
+  id: string;
+  limit?: number | undefined;
+  order?: ListAgentConnectorsQueryParamOrder | undefined;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const ListAgentConnectorsQueryParamOrder$inboundSchema: z.ZodNativeEnum<
+  typeof ListAgentConnectorsQueryParamOrder
+> = z.nativeEnum(ListAgentConnectorsQueryParamOrder);
+/** @internal */
+export const ListAgentConnectorsQueryParamOrder$outboundSchema: z.ZodNativeEnum<
+  typeof ListAgentConnectorsQueryParamOrder
+> = ListAgentConnectorsQueryParamOrder$inboundSchema;
+
+/** @internal */
+export const ListAgentConnectorsRequest$inboundSchema: z.ZodType<
+  ListAgentConnectorsRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  limit: z.number().int().default(20),
+  order: ListAgentConnectorsQueryParamOrder$inboundSchema.default("desc"),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type ListAgentConnectorsRequest$Outbound = {
+  id: string;
+  limit: number;
+  order: string;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const ListAgentConnectorsRequest$outboundSchema: z.ZodType<
+  ListAgentConnectorsRequest$Outbound,
+  z.ZodTypeDef,
+  ListAgentConnectorsRequest
+> = z.object({
+  id: z.string(),
+  limit: z.number().int().default(20),
+  order: ListAgentConnectorsQueryParamOrder$outboundSchema.default("desc"),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function listAgentConnectorsRequestToJSON(
+  listAgentConnectorsRequest: ListAgentConnectorsRequest,
+): string {
+  return JSON.stringify(
+    ListAgentConnectorsRequest$outboundSchema.parse(listAgentConnectorsRequest),
+  );
+}
+export function listAgentConnectorsRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<ListAgentConnectorsRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListAgentConnectorsRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListAgentConnectorsRequest' from JSON`,
+  );
+}

package/src/react-query/agentConnectorsActivateAgentConnector.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { agentConnectorsActivateAgentConnector } from "../funcs/agentConnectorsActivateAgentConnector.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.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 AgentConnectorsActivateAgentConnectorMutationVariables = {
+  request: operations.ActivateAgentConnectorRequest;
+  options?: RequestOptions;
+};
+
+export type AgentConnectorsActivateAgentConnectorMutationData =
+  components.AgentConnector;
+
+export type AgentConnectorsActivateAgentConnectorMutationError =
+  | errors.ErrorEnvelope
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * 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.
+ */
+export function useAgentConnectorsActivateAgentConnectorMutation(
+  options?: MutationHookOptions<
+    AgentConnectorsActivateAgentConnectorMutationData,
+    AgentConnectorsActivateAgentConnectorMutationError,
+    AgentConnectorsActivateAgentConnectorMutationVariables
+  >,
+): UseMutationResult<
+  AgentConnectorsActivateAgentConnectorMutationData,
+  AgentConnectorsActivateAgentConnectorMutationError,
+  AgentConnectorsActivateAgentConnectorMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildAgentConnectorsActivateAgentConnectorMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyAgentConnectorsActivateAgentConnector(): MutationKey {
+  return ["@meetkai/mka1", "Agent Connectors", "activateAgentConnector"];
+}
+
+export function buildAgentConnectorsActivateAgentConnectorMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: AgentConnectorsActivateAgentConnectorMutationVariables,
+  ) => Promise<AgentConnectorsActivateAgentConnectorMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyAgentConnectorsActivateAgentConnector(),
+    mutationFn: function agentConnectorsActivateAgentConnectorMutationFn({
+      request,
+      options,
+    }): Promise<AgentConnectorsActivateAgentConnectorMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(agentConnectorsActivateAgentConnector(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/agentConnectorsCreateAgentConnector.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { agentConnectorsCreateAgentConnector } from "../funcs/agentConnectorsCreateAgentConnector.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.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 AgentConnectorsCreateAgentConnectorMutationVariables = {
+  request: operations.CreateAgentConnectorRequest;
+  options?: RequestOptions;
+};
+
+export type AgentConnectorsCreateAgentConnectorMutationData =
+  components.AgentConnector;
+
+export type AgentConnectorsCreateAgentConnectorMutationError =
+  | errors.ErrorEnvelope
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Create a connector
+ *
+ * @remarks
+ * Connects the agent to a Telegram bot, validates the bot token, and registers the agent's webhook. 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.
+ */
+export function useAgentConnectorsCreateAgentConnectorMutation(
+  options?: MutationHookOptions<
+    AgentConnectorsCreateAgentConnectorMutationData,
+    AgentConnectorsCreateAgentConnectorMutationError,
+    AgentConnectorsCreateAgentConnectorMutationVariables
+  >,
+): UseMutationResult<
+  AgentConnectorsCreateAgentConnectorMutationData,
+  AgentConnectorsCreateAgentConnectorMutationError,
+  AgentConnectorsCreateAgentConnectorMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildAgentConnectorsCreateAgentConnectorMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyAgentConnectorsCreateAgentConnector(): MutationKey {
+  return ["@meetkai/mka1", "Agent Connectors", "createAgentConnector"];
+}
+
+export function buildAgentConnectorsCreateAgentConnectorMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: AgentConnectorsCreateAgentConnectorMutationVariables,
+  ) => Promise<AgentConnectorsCreateAgentConnectorMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyAgentConnectorsCreateAgentConnector(),
+    mutationFn: function agentConnectorsCreateAgentConnectorMutationFn({
+      request,
+      options,
+    }): Promise<AgentConnectorsCreateAgentConnectorMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(agentConnectorsCreateAgentConnector(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/agentConnectorsDeleteAgentConnector.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { agentConnectorsDeleteAgentConnector } from "../funcs/agentConnectorsDeleteAgentConnector.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.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 AgentConnectorsDeleteAgentConnectorMutationVariables = {
+  request: operations.DeleteAgentConnectorRequest;
+  options?: RequestOptions;
+};
+
+export type AgentConnectorsDeleteAgentConnectorMutationData =
+  components.AgentConnectorDeleted;
+
+export type AgentConnectorsDeleteAgentConnectorMutationError =
+  | errors.ErrorEnvelope
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Delete a connector
+ *
+ * @remarks
+ * Unregisters the provider webhook, drops its pending Telegram updates, and deletes the stored connector credentials.
+ */
+export function useAgentConnectorsDeleteAgentConnectorMutation(
+  options?: MutationHookOptions<
+    AgentConnectorsDeleteAgentConnectorMutationData,
+    AgentConnectorsDeleteAgentConnectorMutationError,
+    AgentConnectorsDeleteAgentConnectorMutationVariables
+  >,
+): UseMutationResult<
+  AgentConnectorsDeleteAgentConnectorMutationData,
+  AgentConnectorsDeleteAgentConnectorMutationError,
+  AgentConnectorsDeleteAgentConnectorMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildAgentConnectorsDeleteAgentConnectorMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyAgentConnectorsDeleteAgentConnector(): MutationKey {
+  return ["@meetkai/mka1", "Agent Connectors", "deleteAgentConnector"];
+}
+
+export function buildAgentConnectorsDeleteAgentConnectorMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: AgentConnectorsDeleteAgentConnectorMutationVariables,
+  ) => Promise<AgentConnectorsDeleteAgentConnectorMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyAgentConnectorsDeleteAgentConnector(),
+    mutationFn: function agentConnectorsDeleteAgentConnectorMutationFn({
+      request,
+      options,
+    }): Promise<AgentConnectorsDeleteAgentConnectorMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(agentConnectorsDeleteAgentConnector(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/agentConnectorsGetAgentConnector.core.ts

@@ -0,0 +1,87 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { agentConnectorsGetAgentConnector } from "../funcs/agentConnectorsGetAgentConnector.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+export type AgentConnectorsGetAgentConnectorQueryData =
+  components.AgentConnector;
+
+export function prefetchAgentConnectorsGetAgentConnector(
+  queryClient: QueryClient,
+  client$: SDKCore,
+  request: operations.GetAgentConnectorRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildAgentConnectorsGetAgentConnectorQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildAgentConnectorsGetAgentConnectorQuery(
+  client$: SDKCore,
+  request: operations.GetAgentConnectorRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<AgentConnectorsGetAgentConnectorQueryData>;
+} {
+  return {
+    queryKey: queryKeyAgentConnectorsGetAgentConnector(
+      request.id,
+      request.connectorId,
+      { xOnBehalfOf: request.xOnBehalfOf },
+    ),
+    queryFn: async function agentConnectorsGetAgentConnectorQueryFn(
+      ctx,
+    ): Promise<AgentConnectorsGetAgentConnectorQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(agentConnectorsGetAgentConnector(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyAgentConnectorsGetAgentConnector(
+  id: string,
+  connectorId: string,
+  parameters: { xOnBehalfOf?: string | undefined },
+): QueryKey {
+  return [
+    "@meetkai/mka1",
+    "Agent Connectors",
+    "getAgentConnector",
+    id,
+    connectorId,
+    parameters,
+  ];
+}

package/src/react-query/agentConnectorsGetAgentConnector.ts

@@ -0,0 +1,156 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  InvalidateQueryFilters,
+  QueryClient,
+  useQuery,
+  UseQueryResult,
+  useSuspenseQuery,
+  UseSuspenseQueryResult,
+} from "@tanstack/react-query";
+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 { useSDKContext } from "./_context.js";
+import {
+  QueryHookOptions,
+  SuspenseQueryHookOptions,
+  TupleToPrefixes,
+} from "./_types.js";
+import {
+  AgentConnectorsGetAgentConnectorQueryData,
+  buildAgentConnectorsGetAgentConnectorQuery,
+  prefetchAgentConnectorsGetAgentConnector,
+  queryKeyAgentConnectorsGetAgentConnector,
+} from "./agentConnectorsGetAgentConnector.core.js";
+export {
+  type AgentConnectorsGetAgentConnectorQueryData,
+  buildAgentConnectorsGetAgentConnectorQuery,
+  prefetchAgentConnectorsGetAgentConnector,
+  queryKeyAgentConnectorsGetAgentConnector,
+};
+
+export type AgentConnectorsGetAgentConnectorQueryError =
+  | errors.ErrorEnvelope
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Retrieve a connector
+ *
+ * @remarks
+ * Retrieves connector configuration and status without exposing credentials.
+ */
+export function useAgentConnectorsGetAgentConnector(
+  request: operations.GetAgentConnectorRequest,
+  options?: QueryHookOptions<
+    AgentConnectorsGetAgentConnectorQueryData,
+    AgentConnectorsGetAgentConnectorQueryError
+  >,
+): UseQueryResult<
+  AgentConnectorsGetAgentConnectorQueryData,
+  AgentConnectorsGetAgentConnectorQueryError
+> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildAgentConnectorsGetAgentConnectorQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Retrieve a connector
+ *
+ * @remarks
+ * Retrieves connector configuration and status without exposing credentials.
+ */
+export function useAgentConnectorsGetAgentConnectorSuspense(
+  request: operations.GetAgentConnectorRequest,
+  options?: SuspenseQueryHookOptions<
+    AgentConnectorsGetAgentConnectorQueryData,
+    AgentConnectorsGetAgentConnectorQueryError
+  >,
+): UseSuspenseQueryResult<
+  AgentConnectorsGetAgentConnectorQueryData,
+  AgentConnectorsGetAgentConnectorQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildAgentConnectorsGetAgentConnectorQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setAgentConnectorsGetAgentConnectorData(
+  client: QueryClient,
+  queryKeyBase: [
+    id: string,
+    connectorId: string,
+    parameters: { xOnBehalfOf?: string | undefined },
+  ],
+  data: AgentConnectorsGetAgentConnectorQueryData,
+): AgentConnectorsGetAgentConnectorQueryData | undefined {
+  const key = queryKeyAgentConnectorsGetAgentConnector(...queryKeyBase);
+
+  return client.setQueryData<AgentConnectorsGetAgentConnectorQueryData>(
+    key,
+    data,
+  );
+}
+
+export function invalidateAgentConnectorsGetAgentConnector(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [
+      id: string,
+      connectorId: string,
+      parameters: { xOnBehalfOf?: string | undefined },
+    ]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@meetkai/mka1",
+      "Agent Connectors",
+      "getAgentConnector",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllAgentConnectorsGetAgentConnector(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "Agent Connectors", "getAgentConnector"],
+  });
+}