@meetkai/mka1 0.49.1 → 0.49.2

package/src/react-query/agentConnectorsListAgentConnectors.ts

@@ -0,0 +1,162 @@
+/*
+ * 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 {
+  AgentConnectorsListAgentConnectorsQueryData,
+  buildAgentConnectorsListAgentConnectorsQuery,
+  prefetchAgentConnectorsListAgentConnectors,
+  queryKeyAgentConnectorsListAgentConnectors,
+} from "./agentConnectorsListAgentConnectors.core.js";
+export {
+  type AgentConnectorsListAgentConnectorsQueryData,
+  buildAgentConnectorsListAgentConnectorsQuery,
+  prefetchAgentConnectorsListAgentConnectors,
+  queryKeyAgentConnectorsListAgentConnectors,
+};
+
+export type AgentConnectorsListAgentConnectorsQueryError =
+  | errors.ErrorEnvelope
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * List connectors for an agent
+ *
+ * @remarks
+ * Lists messaging-channel connectors configured for the agent. Connector credentials are never returned.
+ */
+export function useAgentConnectorsListAgentConnectors(
+  request: operations.ListAgentConnectorsRequest,
+  options?: QueryHookOptions<
+    AgentConnectorsListAgentConnectorsQueryData,
+    AgentConnectorsListAgentConnectorsQueryError
+  >,
+): UseQueryResult<
+  AgentConnectorsListAgentConnectorsQueryData,
+  AgentConnectorsListAgentConnectorsQueryError
+> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildAgentConnectorsListAgentConnectorsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List connectors for an agent
+ *
+ * @remarks
+ * Lists messaging-channel connectors configured for the agent. Connector credentials are never returned.
+ */
+export function useAgentConnectorsListAgentConnectorsSuspense(
+  request: operations.ListAgentConnectorsRequest,
+  options?: SuspenseQueryHookOptions<
+    AgentConnectorsListAgentConnectorsQueryData,
+    AgentConnectorsListAgentConnectorsQueryError
+  >,
+): UseSuspenseQueryResult<
+  AgentConnectorsListAgentConnectorsQueryData,
+  AgentConnectorsListAgentConnectorsQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildAgentConnectorsListAgentConnectorsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setAgentConnectorsListAgentConnectorsData(
+  client: QueryClient,
+  queryKeyBase: [
+    id: string,
+    parameters: {
+      limit?: number | undefined;
+      order?: operations.ListAgentConnectorsQueryParamOrder | undefined;
+      xOnBehalfOf?: string | undefined;
+    },
+  ],
+  data: AgentConnectorsListAgentConnectorsQueryData,
+): AgentConnectorsListAgentConnectorsQueryData | undefined {
+  const key = queryKeyAgentConnectorsListAgentConnectors(...queryKeyBase);
+
+  return client.setQueryData<AgentConnectorsListAgentConnectorsQueryData>(
+    key,
+    data,
+  );
+}
+
+export function invalidateAgentConnectorsListAgentConnectors(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [
+      id: string,
+      parameters: {
+        limit?: number | undefined;
+        order?: operations.ListAgentConnectorsQueryParamOrder | undefined;
+        xOnBehalfOf?: string | undefined;
+      },
+    ]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@meetkai/mka1",
+      "Agent Connectors",
+      "listAgentConnectors",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllAgentConnectorsListAgentConnectors(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "Agent Connectors", "listAgentConnectors"],
+  });
+}

package/src/react-query/index.ts

@@ -5,6 +5,11 @@
 export { SDKProvider, useSDKContext } from "./_context.js";
 export * from "./_types.js";
 
+export * from "./agentConnectorsActivateAgentConnector.js";
+export * from "./agentConnectorsCreateAgentConnector.js";
+export * from "./agentConnectorsDeleteAgentConnector.js";
+export * from "./agentConnectorsGetAgentConnector.js";
+export * from "./agentConnectorsListAgentConnectors.js";
 export * from "./agentRunsCreateAgentRun.js";
 export * from "./agentRunsGetAgentRun.js";
 export * from "./agentRunsListAgentRuns.js";

package/src/sdk/agentconnectors.ts

@@ -0,0 +1,100 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { agentConnectorsActivateAgentConnector } from "../funcs/agentConnectorsActivateAgentConnector.js";
+import { agentConnectorsCreateAgentConnector } from "../funcs/agentConnectorsCreateAgentConnector.js";
+import { agentConnectorsDeleteAgentConnector } from "../funcs/agentConnectorsDeleteAgentConnector.js";
+import { agentConnectorsGetAgentConnector } from "../funcs/agentConnectorsGetAgentConnector.js";
+import { agentConnectorsListAgentConnectors } from "../funcs/agentConnectorsListAgentConnectors.js";
+import { ClientSDK, 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 class AgentConnectors extends ClientSDK {
+  /**
+   * List connectors for an agent
+   *
+   * @remarks
+   * Lists messaging-channel connectors configured for the agent. Connector credentials are never returned.
+   */
+  async listAgentConnectors(
+    request: operations.ListAgentConnectorsRequest,
+    options?: RequestOptions,
+  ): Promise<components.AgentConnectorList> {
+    return unwrapAsync(agentConnectorsListAgentConnectors(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * 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.
+   */
+  async createAgentConnector(
+    request: operations.CreateAgentConnectorRequest,
+    options?: RequestOptions,
+  ): Promise<components.AgentConnector> {
+    return unwrapAsync(agentConnectorsCreateAgentConnector(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Retrieve a connector
+   *
+   * @remarks
+   * Retrieves connector configuration and status without exposing credentials.
+   */
+  async getAgentConnector(
+    request: operations.GetAgentConnectorRequest,
+    options?: RequestOptions,
+  ): Promise<components.AgentConnector> {
+    return unwrapAsync(agentConnectorsGetAgentConnector(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete a connector
+   *
+   * @remarks
+   * Unregisters the provider webhook, drops its pending Telegram updates, and deletes the stored connector credentials.
+   */
+  async deleteAgentConnector(
+    request: operations.DeleteAgentConnectorRequest,
+    options?: RequestOptions,
+  ): Promise<components.AgentConnectorDeleted> {
+    return unwrapAsync(agentConnectorsDeleteAgentConnector(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * 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.
+   */
+  async activateAgentConnector(
+    request: operations.ActivateAgentConnectorRequest,
+    options?: RequestOptions,
+  ): Promise<components.AgentConnector> {
+    return unwrapAsync(agentConnectorsActivateAgentConnector(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/sdk.ts

@@ -3,6 +3,7 @@
  */
 
 import { ClientSDK } from "../lib/sdks.js";
+import { AgentConnectors } from "./agentconnectors.js";
 import { AgentRuns } from "./agentruns.js";
 import { Agents } from "./agents.js";
 import { AgentSchedules } from "./agentschedules.js";
@@ -52,6 +53,11 @@ export class SDK extends ClientSDK {
     return (this._agents ??= new Agents(this._options));
   }
 
+  private _agentConnectors?: AgentConnectors;
+  get agentConnectors(): AgentConnectors {
+    return (this._agentConnectors ??= new AgentConnectors(this._options));
+  }
+
   private _agentVersions?: AgentVersions;
   get agentVersions(): AgentVersions {
     return (this._agentVersions ??= new AgentVersions(this._options));