@meetkai/mka1 0.55.24 → 0.55.26

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

@@ -0,0 +1,71 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { llmAuditGetRequestTrace } from "../funcs/llmAuditGetRequestTrace.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+export type LlmAuditGetRequestTraceQueryData =
+  operations.GetRequestTraceResponseBody;
+
+export function prefetchLlmAuditGetRequestTrace(
+  queryClient: QueryClient,
+  client$: SDKCore,
+  request: operations.GetRequestTraceRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildLlmAuditGetRequestTraceQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildLlmAuditGetRequestTraceQuery(
+  client$: SDKCore,
+  request: operations.GetRequestTraceRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<LlmAuditGetRequestTraceQueryData>;
+} {
+  return {
+    queryKey: queryKeyLlmAuditGetRequestTrace(request.requestId),
+    queryFn: async function llmAuditGetRequestTraceQueryFn(
+      ctx,
+    ): Promise<LlmAuditGetRequestTraceQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(llmAuditGetRequestTrace(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyLlmAuditGetRequestTrace(requestId: string): QueryKey {
+  return ["@meetkai/mka1", "audit", "getRequestTrace", requestId];
+}

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/agentruns.ts

@@ -33,7 +33,7 @@ export class AgentRuns extends ClientSDK {
    * Start a saved agent run
    *
    * @remarks
-   * Starts an asynchronous background run for a saved agent and returns the queued run record. Use the run retrieval endpoint to poll status or the events endpoint to stream progress.
+   * Starts an asynchronous background run for a saved agent and returns the queued run record. Use the run retrieval endpoint to poll status or the events endpoint to stream progress. When the agent is already running max_concurrent_runs runs, concurrency_overflow decides: reject returns 429 with error code agent_concurrency_limit and creates no run; queue returns 202 with a waiting run that starts when a slot frees.
    */
   async createAgentRun(
     request: operations.CreateAgentRunRequest,
@@ -67,7 +67,7 @@ export class AgentRuns extends ClientSDK {
    * Cancel a saved-agent run
    *
    * @remarks
-   * Cancels a queued run locally before dispatch, or forwards cancellation to its linked gateway response. Locally failed linked runs with an active or missing gateway snapshot are checked upstream before cancellation; genuine terminal work is never relabelled cancelled. Fresh incomplete gateway snapshots are presented as incomplete on subsequent reads while preserving the connector error and completion timestamp, even if cancel returns 409. Repeated cancellation is idempotent. Returns 409 if submission has no linked response yet or a genuine terminal outcome already won. Uses the run's organization, team and delegated-user mutation scope; operator read access does not grant cancellation access. API-key callers also need write:responses for linked cancellation and read:responses to inspect locally failed runs or reconcile a completion race.
+   * Cancels a waiting or queued run locally before dispatch, or forwards cancellation to its linked gateway response. Locally failed linked runs with an active or missing gateway snapshot are checked upstream before cancellation; genuine terminal work is never relabelled cancelled. Fresh incomplete gateway snapshots are presented as incomplete on subsequent reads while preserving the connector error and completion timestamp, even if cancel returns 409. Repeated cancellation is idempotent. Returns 409 if submission has no linked response yet or a genuine terminal outcome already won. Uses the run's organization, team and delegated-user mutation scope; operator read access does not grant cancellation access. API-key callers also need write:responses for linked cancellation and read:responses to inspect locally failed runs or reconcile a completion race.
    */
   async cancelAgentRun(
     request: operations.CancelAgentRunRequest,

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