@meetkai/mka1 0.49.1 → 0.49.2

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"],
+  });
+}

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

@@ -0,0 +1,89 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { agentConnectorsListAgentConnectors } from "../funcs/agentConnectorsListAgentConnectors.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 AgentConnectorsListAgentConnectorsQueryData =
+  components.AgentConnectorList;
+
+export function prefetchAgentConnectorsListAgentConnectors(
+  queryClient: QueryClient,
+  client$: SDKCore,
+  request: operations.ListAgentConnectorsRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildAgentConnectorsListAgentConnectorsQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildAgentConnectorsListAgentConnectorsQuery(
+  client$: SDKCore,
+  request: operations.ListAgentConnectorsRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<AgentConnectorsListAgentConnectorsQueryData>;
+} {
+  return {
+    queryKey: queryKeyAgentConnectorsListAgentConnectors(request.id, {
+      limit: request.limit,
+      order: request.order,
+      xOnBehalfOf: request.xOnBehalfOf,
+    }),
+    queryFn: async function agentConnectorsListAgentConnectorsQueryFn(
+      ctx,
+    ): Promise<AgentConnectorsListAgentConnectorsQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(agentConnectorsListAgentConnectors(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyAgentConnectorsListAgentConnectors(
+  id: string,
+  parameters: {
+    limit?: number | undefined;
+    order?: operations.ListAgentConnectorsQueryParamOrder | undefined;
+    xOnBehalfOf?: string | undefined;
+  },
+): QueryKey {
+  return [
+    "@meetkai/mka1",
+    "Agent Connectors",
+    "listAgentConnectors",
+    id,
+    parameters,
+  ];
+}