@meetkai/mka1 0.48.27 → 0.48.28

package/src/react-query/guardrailsListGuardrailsPolicies.ts

@@ -0,0 +1,146 @@
+/*
+ * 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 {
+  buildGuardrailsListGuardrailsPoliciesQuery,
+  GuardrailsListGuardrailsPoliciesQueryData,
+  prefetchGuardrailsListGuardrailsPolicies,
+  queryKeyGuardrailsListGuardrailsPolicies,
+} from "./guardrailsListGuardrailsPolicies.core.js";
+export {
+  buildGuardrailsListGuardrailsPoliciesQuery,
+  type GuardrailsListGuardrailsPoliciesQueryData,
+  prefetchGuardrailsListGuardrailsPolicies,
+  queryKeyGuardrailsListGuardrailsPolicies,
+};
+
+export type GuardrailsListGuardrailsPoliciesQueryError =
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * List guardrails policies
+ *
+ * @remarks
+ * List the stored guardrails policies visible to the caller: org admins see every policy in their org (the org-wide policy has team_id null, plus each team's additional policy); other callers see the org-wide policy and their own team's policy. Unlike GET /guardrails, rows are returned per scope so a team can see which rules it owns versus which the org mandates.
+ */
+export function useGuardrailsListGuardrailsPolicies(
+  request: operations.ListGuardrailsPoliciesRequest,
+  options?: QueryHookOptions<
+    GuardrailsListGuardrailsPoliciesQueryData,
+    GuardrailsListGuardrailsPoliciesQueryError
+  >,
+): UseQueryResult<
+  GuardrailsListGuardrailsPoliciesQueryData,
+  GuardrailsListGuardrailsPoliciesQueryError
+> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildGuardrailsListGuardrailsPoliciesQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List guardrails policies
+ *
+ * @remarks
+ * List the stored guardrails policies visible to the caller: org admins see every policy in their org (the org-wide policy has team_id null, plus each team's additional policy); other callers see the org-wide policy and their own team's policy. Unlike GET /guardrails, rows are returned per scope so a team can see which rules it owns versus which the org mandates.
+ */
+export function useGuardrailsListGuardrailsPoliciesSuspense(
+  request: operations.ListGuardrailsPoliciesRequest,
+  options?: SuspenseQueryHookOptions<
+    GuardrailsListGuardrailsPoliciesQueryData,
+    GuardrailsListGuardrailsPoliciesQueryError
+  >,
+): UseSuspenseQueryResult<
+  GuardrailsListGuardrailsPoliciesQueryData,
+  GuardrailsListGuardrailsPoliciesQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildGuardrailsListGuardrailsPoliciesQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setGuardrailsListGuardrailsPoliciesData(
+  client: QueryClient,
+  queryKeyBase: [parameters: { xOnBehalfOf?: string | undefined }],
+  data: GuardrailsListGuardrailsPoliciesQueryData,
+): GuardrailsListGuardrailsPoliciesQueryData | undefined {
+  const key = queryKeyGuardrailsListGuardrailsPolicies(...queryKeyBase);
+
+  return client.setQueryData<GuardrailsListGuardrailsPoliciesQueryData>(
+    key,
+    data,
+  );
+}
+
+export function invalidateGuardrailsListGuardrailsPolicies(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [parameters: { xOnBehalfOf?: string | undefined }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@meetkai/mka1",
+      "Guardrails",
+      "listGuardrailsPolicies",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllGuardrailsListGuardrailsPolicies(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "Guardrails", "listGuardrailsPolicies"],
+  });
+}

package/src/react-query/guardrailsTestGuardrails.ts

@@ -49,7 +49,7 @@ export type GuardrailsTestGuardrailsMutationError =
  * Test content against guardrails
  *
  * @remarks
- * Test a piece of content against the configured guardrails without making an actual API call. Useful for debugging and validating guardrail configurations. Returns a report indicating whether the content passed and which guardrail was triggered if any.
+ * Test a piece of content against the caller's effective guardrails (org-wide policy plus team policy) without making an actual API call. Useful for debugging and validating guardrail configurations. Returns a report indicating whether the content passed and which guardrail was triggered if any.
  */
 export function useGuardrailsTestGuardrailsMutation(
   options?: MutationHookOptions<

package/src/react-query/guardrailsUpdateGuardrails.ts

@@ -46,10 +46,10 @@ export type GuardrailsUpdateGuardrailsMutationError =
   | SDKValidationError;
 
 /**
- * Update guardrails settings
+ * Update guardrails policy
  *
  * @remarks
- * Update the guardrails configuration for the authenticated user. Configure multiple guardrail modes including ban words (custom word list), prompt injection detection, and system prompt leakage detection. Each guardrail can be individually enabled/disabled with custom thresholds and rejection messages.
+ * Replace a guardrails policy. Omit team_id to set the org-wide policy (org admin only); provide team_id to set that team's additional policy (org admins may target any team in their org, other callers only their own team). The org-wide policy applies to every team; a team policy is enforced in addition to it — configuring a team policy never weakens the org-wide one.
  */
 export function useGuardrailsUpdateGuardrailsMutation(
   options?: MutationHookOptions<

package/src/react-query/index.ts

@@ -26,7 +26,9 @@ export * from "./agentVersionsGetAgentVersion.js";
 export * from "./agentVersionsListAgentVersions.js";
 export * from "./agentVersionsRollbackAgentVersion.js";
 export * from "./authApiKeyGetJwtFromKey.js";
+export * from "./guardrailsDeleteGuardrails.js";
 export * from "./guardrailsGetGuardrails.js";
+export * from "./guardrailsListGuardrailsPolicies.js";
 export * from "./guardrailsTestGuardrails.js";
 export * from "./guardrailsUpdateGuardrails.js";
 export * from "./llmBatchesCancel.js";

package/src/sdk/guardrails.ts

@@ -2,7 +2,9 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import { guardrailsDeleteGuardrails } from "../funcs/guardrailsDeleteGuardrails.js";
 import { guardrailsGetGuardrails } from "../funcs/guardrailsGetGuardrails.js";
+import { guardrailsListGuardrailsPolicies } from "../funcs/guardrailsListGuardrailsPolicies.js";
 import { guardrailsTestGuardrails } from "../funcs/guardrailsTestGuardrails.js";
 import { guardrailsUpdateGuardrails } from "../funcs/guardrailsUpdateGuardrails.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
@@ -12,10 +14,10 @@ import { unwrapAsync } from "../types/fp.js";
 
 export class Guardrails extends ClientSDK {
   /**
-   * Get guardrails settings
+   * Get effective guardrails
    *
    * @remarks
-   * Retrieve the current guardrails configuration for the authenticated user. Returns all configured guardrails including ban words, prompt injection detection, and leakage detection settings.
+   * Retrieve the guardrails that apply to the caller's requests: the org-wide policy plus the caller's team policy, combined. Both are enforced when both exist. Policies are managed by org admins via PUT /guardrails.
    */
   async getGuardrails(
     request: operations.GetGuardrailsRequest,
@@ -29,10 +31,10 @@ export class Guardrails extends ClientSDK {
   }
 
   /**
-   * Update guardrails settings
+   * Update guardrails policy
    *
    * @remarks
-   * Update the guardrails configuration for the authenticated user. Configure multiple guardrail modes including ban words (custom word list), prompt injection detection, and system prompt leakage detection. Each guardrail can be individually enabled/disabled with custom thresholds and rejection messages.
+   * Replace a guardrails policy. Omit team_id to set the org-wide policy (org admin only); provide team_id to set that team's additional policy (org admins may target any team in their org, other callers only their own team). The org-wide policy applies to every team; a team policy is enforced in addition to it — configuring a team policy never weakens the org-wide one.
    */
   async updateGuardrails(
     request: operations.UpdateGuardrailsRequest,
@@ -45,11 +47,45 @@ export class Guardrails extends ClientSDK {
     ));
   }
 
+  /**
+   * Delete guardrails policy
+   *
+   * @remarks
+   * Delete a guardrails policy. Omit team_id to delete the org-wide policy (org admin only); provide team_id to delete that team's policy (org admins may target any team in their org, other callers only their own team). Idempotent: deleting a policy that doesn't exist returns deleted: false.
+   */
+  async deleteGuardrails(
+    request: operations.DeleteGuardrailsRequest,
+    options?: RequestOptions,
+  ): Promise<components.DeleteGuardrailsResponse> {
+    return unwrapAsync(guardrailsDeleteGuardrails(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List guardrails policies
+   *
+   * @remarks
+   * List the stored guardrails policies visible to the caller: org admins see every policy in their org (the org-wide policy has team_id null, plus each team's additional policy); other callers see the org-wide policy and their own team's policy. Unlike GET /guardrails, rows are returned per scope so a team can see which rules it owns versus which the org mandates.
+   */
+  async listGuardrailsPolicies(
+    request: operations.ListGuardrailsPoliciesRequest,
+    options?: RequestOptions,
+  ): Promise<components.ListGuardrailsPoliciesResponse> {
+    return unwrapAsync(guardrailsListGuardrailsPolicies(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Test content against guardrails
    *
    * @remarks
-   * Test a piece of content against the configured guardrails without making an actual API call. Useful for debugging and validating guardrail configurations. Returns a report indicating whether the content passed and which guardrail was triggered if any.
+   * Test a piece of content against the caller's effective guardrails (org-wide policy plus team policy) without making an actual API call. Useful for debugging and validating guardrail configurations. Returns a report indicating whether the content passed and which guardrail was triggered if any.
    */
   async testGuardrails(
     request: operations.TestGuardrailsRequest,