@meetkai/mka1 0.55.25 → 0.55.26

package/src/react-query/llmAuditGetRequestTrace.ts

@@ -0,0 +1,136 @@
+/*
+ * 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 {
+  buildLlmAuditGetRequestTraceQuery,
+  LlmAuditGetRequestTraceQueryData,
+  prefetchLlmAuditGetRequestTrace,
+  queryKeyLlmAuditGetRequestTrace,
+} from "./llmAuditGetRequestTrace.core.js";
+export {
+  buildLlmAuditGetRequestTraceQuery,
+  type LlmAuditGetRequestTraceQueryData,
+  prefetchLlmAuditGetRequestTrace,
+  queryKeyLlmAuditGetRequestTrace,
+};
+
+export type LlmAuditGetRequestTraceQueryError =
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Get a request trace
+ *
+ * @remarks
+ * Returns the end-to-end trace of one API request: its timing at the API gateway, every response it created (including agents it called), and each response's model invocations and tool calls with durations. Look it up by the `X-Request-ID` returned on every response, or by the API gateway's own request ID. Org owners and admins only, scoped to their own organization. Requests audited before request IDs were recorded show their gateway timing but no responses.
+ */
+export function useLlmAuditGetRequestTrace(
+  request: operations.GetRequestTraceRequest,
+  options?: QueryHookOptions<
+    LlmAuditGetRequestTraceQueryData,
+    LlmAuditGetRequestTraceQueryError
+  >,
+): UseQueryResult<
+  LlmAuditGetRequestTraceQueryData,
+  LlmAuditGetRequestTraceQueryError
+> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildLlmAuditGetRequestTraceQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Get a request trace
+ *
+ * @remarks
+ * Returns the end-to-end trace of one API request: its timing at the API gateway, every response it created (including agents it called), and each response's model invocations and tool calls with durations. Look it up by the `X-Request-ID` returned on every response, or by the API gateway's own request ID. Org owners and admins only, scoped to their own organization. Requests audited before request IDs were recorded show their gateway timing but no responses.
+ */
+export function useLlmAuditGetRequestTraceSuspense(
+  request: operations.GetRequestTraceRequest,
+  options?: SuspenseQueryHookOptions<
+    LlmAuditGetRequestTraceQueryData,
+    LlmAuditGetRequestTraceQueryError
+  >,
+): UseSuspenseQueryResult<
+  LlmAuditGetRequestTraceQueryData,
+  LlmAuditGetRequestTraceQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildLlmAuditGetRequestTraceQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setLlmAuditGetRequestTraceData(
+  client: QueryClient,
+  queryKeyBase: [requestId: string],
+  data: LlmAuditGetRequestTraceQueryData,
+): LlmAuditGetRequestTraceQueryData | undefined {
+  const key = queryKeyLlmAuditGetRequestTrace(...queryKeyBase);
+
+  return client.setQueryData<LlmAuditGetRequestTraceQueryData>(key, data);
+}
+
+export function invalidateLlmAuditGetRequestTrace(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<[requestId: string]>,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "audit", "getRequestTrace", ...queryKeyBase],
+  });
+}
+
+export function invalidateAllLlmAuditGetRequestTrace(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "audit", "getRequestTrace"],
+  });
+}

package/src/sdk/audit.ts

@@ -2,21 +2,23 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { flagsAuditList } from "../funcs/flagsAuditList.js";
+import { llmAuditGetRequestTrace } from "../funcs/llmAuditGetRequestTrace.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 Audit extends ClientSDK {
   /**
-   * List audit entries, newest first
+   * Get a request trace
+   *
+   * @remarks
+   * Returns the end-to-end trace of one API request: its timing at the API gateway, every response it created (including agents it called), and each response's model invocations and tool calls with durations. Look it up by the `X-Request-ID` returned on every response, or by the API gateway's own request ID. Org owners and admins only, scoped to their own organization. Requests audited before request IDs were recorded show their gateway timing but no responses.
    */
-  async list(
-    request: operations.ListFeatureFlagAuditEntriesRequest,
+  async getRequestTrace(
+    request: operations.GetRequestTraceRequest,
     options?: RequestOptions,
-  ): Promise<components.FeatureFlagAuditPage> {
-    return unwrapAsync(flagsAuditList(
+  ): Promise<operations.GetRequestTraceResponseBody> {
+    return unwrapAsync(llmAuditGetRequestTrace(
       this,
       request,
       options,

package/src/sdk/billing.ts

@@ -13,6 +13,9 @@ import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class Billing extends ClientSDK {
+  /**
+   * Read organization billing. API keys require read:billing and either a human owner/admin or delegated service account. Keys are bound to their organization; cross-organization reads require a human cluster administrator with read:cluster.
+   */
   async getOrganizationBilling(
     request: operations.GetOrganizationBillingRequest,
     options?: RequestOptions,
@@ -24,6 +27,9 @@ export class Billing extends ClientSDK {
     ));
   }
 
+  /**
+   * Enable or disable organization billing. Requires a human cluster administrator. API keys require both write:billing and the bootstrap-only write:cluster scope. Service-account keys cannot enable or disable billing.
+   */
   async setOrganizationBillingEnabled(
     request: operations.SetOrganizationBillingEnabledRequest,
     options?: RequestOptions,
@@ -35,6 +41,9 @@ export class Billing extends ClientSDK {
     ));
   }
 
+  /**
+   * Update the bound organization's billing profile. API keys require write:billing and either a human owner/admin or delegated service account. The organization is resolved from the API key.
+   */
   async updateOrganizationBillingProfile(
     request: operations.UpdateOrganizationBillingProfileRequestBody,
     options?: RequestOptions,
@@ -46,6 +55,9 @@ export class Billing extends ClientSDK {
     ));
   }
 
+  /**
+   * Create a payment-provider setup session for the bound organization. API keys require write:billing and either a human owner/admin or delegated service account. The organization is resolved from the API key.
+   */
   async createOrganizationBillingSetup(
     request: operations.CreateOrganizationBillingSetupRequestBody,
     options?: RequestOptions,
@@ -57,6 +69,9 @@ export class Billing extends ClientSDK {
     ));
   }
 
+  /**
+   * Create a payment-provider portal session for the bound organization. API keys require write:billing and either a human owner/admin or delegated service account. The organization is resolved from the API key.
+   */
   async createOrganizationBillingPortal(
     request: operations.CreateOrganizationBillingPortalRequestBody,
     options?: RequestOptions,
@@ -68,6 +83,9 @@ export class Billing extends ClientSDK {
     ));
   }
 
+  /**
+   * List invoices for an organization. API keys require read:billing and either a human owner/admin or delegated service account. Cross-organization reads require a human cluster administrator with read:cluster.
+   */
   async listOrganizationBillingInvoices(
     request: operations.ListOrganizationBillingInvoicesRequest,
     options?: RequestOptions,

package/src/sdk/flags.ts

@@ -14,7 +14,7 @@ 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";
-import { Audit } from "./audit.js";
+import { SDKAudit } from "./sdkaudit.js";
 import { SDKEnvironments } from "./sdkenvironments.js";
 import { SDKProjects } from "./sdkprojects.js";
 
@@ -24,9 +24,9 @@ export class Flags extends ClientSDK {
     return (this._projects ??= new SDKProjects(this._options));
   }
 
-  private _audit?: Audit;
-  get audit(): Audit {
-    return (this._audit ??= new Audit(this._options));
+  private _audit?: SDKAudit;
+  get audit(): SDKAudit {
+    return (this._audit ??= new SDKAudit(this._options));
   }
 
   private _environments?: SDKEnvironments;

package/src/sdk/llm.ts

@@ -3,6 +3,7 @@
  */
 
 import { ClientSDK } from "../lib/sdks.js";
+import { Audit } from "./audit.js";
 import { Batches } from "./batches.js";
 import { Chat } from "./chat.js";
 import { Classify } from "./classify.js";
@@ -25,6 +26,11 @@ import { Speech } from "./speech.js";
 import { VectorStores } from "./vectorstores.js";
 
 export class Llm extends ClientSDK {
+  private _audit?: Audit;
+  get audit(): Audit {
+    return (this._audit ??= new Audit(this._options));
+  }
+
   private _batches?: Batches;
   get batches(): Batches {
     return (this._batches ??= new Batches(this._options));

package/src/sdk/sdkaudit.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { flagsAuditList } from "../funcs/flagsAuditList.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 SDKAudit extends ClientSDK {
+  /**
+   * List audit entries, newest first
+   */
+  async list(
+    request: operations.ListFeatureFlagAuditEntriesRequest,
+    options?: RequestOptions,
+  ): Promise<components.FeatureFlagAuditPage> {
+    return unwrapAsync(flagsAuditList(
+      this,
+      request,
+      options,
+    ));
+  }
+}