@meetkai/mka1 0.55.34 → 0.55.36

package/src/react-query/guardrailsGetGuardrailsResourcePolicy.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 { 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 {
+  buildGuardrailsGetGuardrailsResourcePolicyQuery,
+  GuardrailsGetGuardrailsResourcePolicyQueryData,
+  prefetchGuardrailsGetGuardrailsResourcePolicy,
+  queryKeyGuardrailsGetGuardrailsResourcePolicy,
+} from "./guardrailsGetGuardrailsResourcePolicy.core.js";
+export {
+  buildGuardrailsGetGuardrailsResourcePolicyQuery,
+  type GuardrailsGetGuardrailsResourcePolicyQueryData,
+  prefetchGuardrailsGetGuardrailsResourcePolicy,
+  queryKeyGuardrailsGetGuardrailsResourcePolicy,
+};
+
+export type GuardrailsGetGuardrailsResourcePolicyQueryError =
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Get a resource guardrails policy
+ *
+ * @remarks
+ * Additional guardrails attached to a saved agent in the active team or a catalog model endpoint throughout the organization. Cluster, organization and team policies are always enforced as well. Model aliases resolve to canonical model IDs; auto is not an attachable endpoint. Only organization admins/owners may change these policies. Policies apply to saved-agent versions and future background executions independently of version snapshots. Configured fallback and image-reroute endpoint policies are checked before dispatch as well, even if a fallback is not eventually needed.
+ */
+export function useGuardrailsGetGuardrailsResourcePolicy(
+  request: operations.GetGuardrailsResourcePolicyRequest,
+  options?: QueryHookOptions<
+    GuardrailsGetGuardrailsResourcePolicyQueryData,
+    GuardrailsGetGuardrailsResourcePolicyQueryError
+  >,
+): UseQueryResult<
+  GuardrailsGetGuardrailsResourcePolicyQueryData,
+  GuardrailsGetGuardrailsResourcePolicyQueryError
+> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildGuardrailsGetGuardrailsResourcePolicyQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Get a resource guardrails policy
+ *
+ * @remarks
+ * Additional guardrails attached to a saved agent in the active team or a catalog model endpoint throughout the organization. Cluster, organization and team policies are always enforced as well. Model aliases resolve to canonical model IDs; auto is not an attachable endpoint. Only organization admins/owners may change these policies. Policies apply to saved-agent versions and future background executions independently of version snapshots. Configured fallback and image-reroute endpoint policies are checked before dispatch as well, even if a fallback is not eventually needed.
+ */
+export function useGuardrailsGetGuardrailsResourcePolicySuspense(
+  request: operations.GetGuardrailsResourcePolicyRequest,
+  options?: SuspenseQueryHookOptions<
+    GuardrailsGetGuardrailsResourcePolicyQueryData,
+    GuardrailsGetGuardrailsResourcePolicyQueryError
+  >,
+): UseSuspenseQueryResult<
+  GuardrailsGetGuardrailsResourcePolicyQueryData,
+  GuardrailsGetGuardrailsResourcePolicyQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildGuardrailsGetGuardrailsResourcePolicyQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setGuardrailsGetGuardrailsResourcePolicyData(
+  client: QueryClient,
+  queryKeyBase: [
+    parameters: {
+      resourceType: operations.ResourceType;
+      resourceId: string;
+      xOnBehalfOf?: string | undefined;
+    },
+  ],
+  data: GuardrailsGetGuardrailsResourcePolicyQueryData,
+): GuardrailsGetGuardrailsResourcePolicyQueryData | undefined {
+  const key = queryKeyGuardrailsGetGuardrailsResourcePolicy(...queryKeyBase);
+
+  return client.setQueryData<GuardrailsGetGuardrailsResourcePolicyQueryData>(
+    key,
+    data,
+  );
+}
+
+export function invalidateGuardrailsGetGuardrailsResourcePolicy(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [parameters: {
+      resourceType: operations.ResourceType;
+      resourceId: string;
+      xOnBehalfOf?: string | undefined;
+    }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@meetkai/mka1",
+      "Guardrails",
+      "getGuardrailsResourcePolicy",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllGuardrailsGetGuardrailsResourcePolicy(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "Guardrails", "getGuardrailsResourcePolicy"],
+  });
+}

package/src/react-query/guardrailsUpdateGuardrailsResourcePolicy.ts

@@ -0,0 +1,109 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { guardrailsUpdateGuardrailsResourcePolicy } from "../funcs/guardrailsUpdateGuardrailsResourcePolicy.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 { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type GuardrailsUpdateGuardrailsResourcePolicyMutationVariables = {
+  request: components.UpdateGuardrailsResourcePolicyRequest;
+  options?: RequestOptions;
+};
+
+export type GuardrailsUpdateGuardrailsResourcePolicyMutationData =
+  components.GetGuardrailsResourcePolicyResponse;
+
+export type GuardrailsUpdateGuardrailsResourcePolicyMutationError =
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Set a resource guardrails policy
+ *
+ * @remarks
+ * Additional guardrails attached to a saved agent in the active team or a catalog model endpoint throughout the organization. Cluster, organization and team policies are always enforced as well. Model aliases resolve to canonical model IDs; auto is not an attachable endpoint. Only organization admins/owners may change these policies. Policies apply to saved-agent versions and future background executions independently of version snapshots. Configured fallback and image-reroute endpoint policies are checked before dispatch as well, even if a fallback is not eventually needed.
+ */
+export function useGuardrailsUpdateGuardrailsResourcePolicyMutation(
+  options?: MutationHookOptions<
+    GuardrailsUpdateGuardrailsResourcePolicyMutationData,
+    GuardrailsUpdateGuardrailsResourcePolicyMutationError,
+    GuardrailsUpdateGuardrailsResourcePolicyMutationVariables
+  >,
+): UseMutationResult<
+  GuardrailsUpdateGuardrailsResourcePolicyMutationData,
+  GuardrailsUpdateGuardrailsResourcePolicyMutationError,
+  GuardrailsUpdateGuardrailsResourcePolicyMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildGuardrailsUpdateGuardrailsResourcePolicyMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyGuardrailsUpdateGuardrailsResourcePolicy(): MutationKey {
+  return ["@meetkai/mka1", "Guardrails", "updateGuardrailsResourcePolicy"];
+}
+
+export function buildGuardrailsUpdateGuardrailsResourcePolicyMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: GuardrailsUpdateGuardrailsResourcePolicyMutationVariables,
+  ) => Promise<GuardrailsUpdateGuardrailsResourcePolicyMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyGuardrailsUpdateGuardrailsResourcePolicy(),
+    mutationFn: function guardrailsUpdateGuardrailsResourcePolicyMutationFn({
+      request,
+      options,
+    }): Promise<GuardrailsUpdateGuardrailsResourcePolicyMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(guardrailsUpdateGuardrailsResourcePolicy(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/index.ts

@@ -223,15 +223,18 @@ export * from "./flagsSetEnvironmentState.js";
 export * from "./flagsUnarchive.js";
 export * from "./flagsUpdate.js";
 export * from "./guardrailsDeleteGuardrails.js";
+export * from "./guardrailsDeleteGuardrailsResourcePolicy.js";
 export * from "./guardrailsGetClusterDefaultGuardrails.js";
 export * from "./guardrailsGetClusterDefaultGuardrailsOrg.js";
 export * from "./guardrailsGetGuardrails.js";
+export * from "./guardrailsGetGuardrailsResourcePolicy.js";
 export * from "./guardrailsListGuardrailsPolicies.js";
 export * from "./guardrailsResetClusterDefaultGuardrails.js";
 export * from "./guardrailsTestGuardrails.js";
 export * from "./guardrailsUpdateClusterDefaultGuardrails.js";
 export * from "./guardrailsUpdateClusterDefaultGuardrailsOrg.js";
 export * from "./guardrailsUpdateGuardrails.js";
+export * from "./guardrailsUpdateGuardrailsResourcePolicy.js";
 export * from "./llmAuditGetRequestTrace.js";
 export * from "./llmBatchesCancel.js";
 export * from "./llmBatchesCreate.js";

package/src/sdk/agentconnectors.ts

@@ -35,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. 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.
+   * 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. A web connector (provider web) needs no provider credentials or access policy: it is active immediately and returns an embed object with an iframe URL and snippet for an anonymous web chat widget whose visitors are limited by signed sessions, rate limits and the optional allowed_origins list. Creating a web connector returns 409 when the deployment has not enabled web chat.
    */
   async createAgentConnector(
     request: operations.CreateAgentConnectorRequest,
@@ -86,7 +86,7 @@ export class AgentConnectors extends ClientSDK {
    * Delete a connector
    *
    * @remarks
-   * Unregisters the connector-specific provider webhook and deletes the stored connector credentials. Telegram pending updates are dropped; WhatsApp deletion clears only the phone-number callback and does not unsubscribe other numbers in the business account.
+   * Unregisters the connector-specific provider webhook and deletes the stored connector credentials. Telegram pending updates are dropped; WhatsApp deletion clears only the phone-number callback and does not unsubscribe other numbers in the business account. Deleting a web connector disables its embed immediately.
    */
   async deleteAgentConnector(
     request: operations.DeleteAgentConnectorRequest,
@@ -103,7 +103,7 @@ export class AgentConnectors extends ClientSDK {
    * Activate a connector
    *
    * @remarks
-   * Revalidates the stored provider credentials and registers the provider webhook. Use this to retry a connector left in an error state. API-key authentication with every listed scope is required; session authentication is rejected, and the key must belong to the connector's original user or service-account principal so existing conversations keep the same owner.
+   * Revalidates the stored provider credentials and registers the provider webhook. Use this to retry a connector left in an error state. API-key authentication with every listed scope is required; session authentication is rejected, and the key must belong to the connector's original user or service-account principal so existing conversations keep the same owner. Web connectors have no provider webhook; activation only re-authorizes the stored API-key identity.
    */
   async activateAgentConnector(
     request: operations.ActivateAgentConnectorRequest,

package/src/sdk/guardrails.ts

@@ -3,15 +3,18 @@
  */
 
 import { guardrailsDeleteGuardrails } from "../funcs/guardrailsDeleteGuardrails.js";
+import { guardrailsDeleteGuardrailsResourcePolicy } from "../funcs/guardrailsDeleteGuardrailsResourcePolicy.js";
 import { guardrailsGetClusterDefaultGuardrails } from "../funcs/guardrailsGetClusterDefaultGuardrails.js";
 import { guardrailsGetClusterDefaultGuardrailsOrg } from "../funcs/guardrailsGetClusterDefaultGuardrailsOrg.js";
 import { guardrailsGetGuardrails } from "../funcs/guardrailsGetGuardrails.js";
+import { guardrailsGetGuardrailsResourcePolicy } from "../funcs/guardrailsGetGuardrailsResourcePolicy.js";
 import { guardrailsListGuardrailsPolicies } from "../funcs/guardrailsListGuardrailsPolicies.js";
 import { guardrailsResetClusterDefaultGuardrails } from "../funcs/guardrailsResetClusterDefaultGuardrails.js";
 import { guardrailsTestGuardrails } from "../funcs/guardrailsTestGuardrails.js";
 import { guardrailsUpdateClusterDefaultGuardrails } from "../funcs/guardrailsUpdateClusterDefaultGuardrails.js";
 import { guardrailsUpdateClusterDefaultGuardrailsOrg } from "../funcs/guardrailsUpdateClusterDefaultGuardrailsOrg.js";
 import { guardrailsUpdateGuardrails } from "../funcs/guardrailsUpdateGuardrails.js";
+import { guardrailsUpdateGuardrailsResourcePolicy } from "../funcs/guardrailsUpdateGuardrailsResourcePolicy.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
 import * as operations from "../models/operations/index.js";
@@ -183,4 +186,55 @@ export class Guardrails extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * Get a resource guardrails policy
+   *
+   * @remarks
+   * Additional guardrails attached to a saved agent in the active team or a catalog model endpoint throughout the organization. Cluster, organization and team policies are always enforced as well. Model aliases resolve to canonical model IDs; auto is not an attachable endpoint. Only organization admins/owners may change these policies. Policies apply to saved-agent versions and future background executions independently of version snapshots. Configured fallback and image-reroute endpoint policies are checked before dispatch as well, even if a fallback is not eventually needed.
+   */
+  async getGuardrailsResourcePolicy(
+    request: operations.GetGuardrailsResourcePolicyRequest,
+    options?: RequestOptions,
+  ): Promise<components.GetGuardrailsResourcePolicyResponse> {
+    return unwrapAsync(guardrailsGetGuardrailsResourcePolicy(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Set a resource guardrails policy
+   *
+   * @remarks
+   * Additional guardrails attached to a saved agent in the active team or a catalog model endpoint throughout the organization. Cluster, organization and team policies are always enforced as well. Model aliases resolve to canonical model IDs; auto is not an attachable endpoint. Only organization admins/owners may change these policies. Policies apply to saved-agent versions and future background executions independently of version snapshots. Configured fallback and image-reroute endpoint policies are checked before dispatch as well, even if a fallback is not eventually needed.
+   */
+  async updateGuardrailsResourcePolicy(
+    request: components.UpdateGuardrailsResourcePolicyRequest,
+    options?: RequestOptions,
+  ): Promise<components.GetGuardrailsResourcePolicyResponse> {
+    return unwrapAsync(guardrailsUpdateGuardrailsResourcePolicy(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Remove a resource guardrails policy
+   *
+   * @remarks
+   * Additional guardrails attached to a saved agent in the active team or a catalog model endpoint throughout the organization. Cluster, organization and team policies are always enforced as well. Model aliases resolve to canonical model IDs; auto is not an attachable endpoint. Only organization admins/owners may change these policies. Policies apply to saved-agent versions and future background executions independently of version snapshots. Configured fallback and image-reroute endpoint policies are checked before dispatch as well, even if a fallback is not eventually needed.
+   */
+  async deleteGuardrailsResourcePolicy(
+    request: components.GuardrailsResourceTarget,
+    options?: RequestOptions,
+  ): Promise<components.DeleteGuardrailsResourcePolicyResponse> {
+    return unwrapAsync(guardrailsDeleteGuardrailsResourcePolicy(
+      this,
+      request,
+      options,
+    ));
+  }
 }