@meetkai/mka1 0.49.10 → 0.49.11

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

@@ -0,0 +1,80 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { sandboxGetBrowserUrl } from "../funcs/sandboxGetBrowserUrl.js";
+import { combineSignals } from "../lib/primitives.js";
+import { 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 type SandboxGetBrowserUrlQueryData = components.SessionUrlResponse;
+
+export function prefetchSandboxGetBrowserUrl(
+  queryClient: QueryClient,
+  client$: SDKCore,
+  request: operations.GetBrowserSessionUrlRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildSandboxGetBrowserUrlQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildSandboxGetBrowserUrlQuery(
+  client$: SDKCore,
+  request: operations.GetBrowserSessionUrlRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<SandboxGetBrowserUrlQueryData>;
+} {
+  return {
+    queryKey: queryKeySandboxGetBrowserUrl(request.sessionId, {
+      sessionToken: request.sessionToken,
+      xOnBehalfOf: request.xOnBehalfOf,
+    }),
+    queryFn: async function sandboxGetBrowserUrlQueryFn(
+      ctx,
+    ): Promise<SandboxGetBrowserUrlQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(sandboxGetBrowserUrl(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeySandboxGetBrowserUrl(
+  sessionId: string,
+  parameters: {
+    sessionToken?: string | null | undefined;
+    xOnBehalfOf?: string | undefined;
+  },
+): QueryKey {
+  return ["@meetkai/mka1", "sandbox", "getBrowserUrl", sessionId, parameters];
+}

package/src/react-query/sandboxGetBrowserUrl.ts

@@ -0,0 +1,152 @@
+/*
+ * 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 {
+  buildSandboxGetBrowserUrlQuery,
+  prefetchSandboxGetBrowserUrl,
+  queryKeySandboxGetBrowserUrl,
+  SandboxGetBrowserUrlQueryData,
+} from "./sandboxGetBrowserUrl.core.js";
+export {
+  buildSandboxGetBrowserUrlQuery,
+  prefetchSandboxGetBrowserUrl,
+  queryKeySandboxGetBrowserUrl,
+  type SandboxGetBrowserUrlQueryData,
+};
+
+export type SandboxGetBrowserUrlQueryError =
+  | errors.HTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Get Browser Session URL
+ *
+ * @remarks
+ * Return the public gateway URL for a browser session's Chrome DevTools Protocol endpoint. Playwright can use this HTTP endpoint directly. For clients that require a WebSocket endpoint, request `json/version` and use its rewritten `webSocketDebuggerUrl`. Insert subpaths before the query string; for example, use `/ports/9222/json/version?session_token=...`. Send the same MKA1 API-key authorization header on the HTTP and WebSocket requests. Standard sessions do not expose a public URL; use the command, code, and workspace operations instead.
+ */
+export function useSandboxGetBrowserUrl(
+  request: operations.GetBrowserSessionUrlRequest,
+  options?: QueryHookOptions<
+    SandboxGetBrowserUrlQueryData,
+    SandboxGetBrowserUrlQueryError
+  >,
+): UseQueryResult<
+  SandboxGetBrowserUrlQueryData,
+  SandboxGetBrowserUrlQueryError
+> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildSandboxGetBrowserUrlQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Get Browser Session URL
+ *
+ * @remarks
+ * Return the public gateway URL for a browser session's Chrome DevTools Protocol endpoint. Playwright can use this HTTP endpoint directly. For clients that require a WebSocket endpoint, request `json/version` and use its rewritten `webSocketDebuggerUrl`. Insert subpaths before the query string; for example, use `/ports/9222/json/version?session_token=...`. Send the same MKA1 API-key authorization header on the HTTP and WebSocket requests. Standard sessions do not expose a public URL; use the command, code, and workspace operations instead.
+ */
+export function useSandboxGetBrowserUrlSuspense(
+  request: operations.GetBrowserSessionUrlRequest,
+  options?: SuspenseQueryHookOptions<
+    SandboxGetBrowserUrlQueryData,
+    SandboxGetBrowserUrlQueryError
+  >,
+): UseSuspenseQueryResult<
+  SandboxGetBrowserUrlQueryData,
+  SandboxGetBrowserUrlQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildSandboxGetBrowserUrlQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setSandboxGetBrowserUrlData(
+  client: QueryClient,
+  queryKeyBase: [
+    sessionId: string,
+    parameters: {
+      sessionToken?: string | null | undefined;
+      xOnBehalfOf?: string | undefined;
+    },
+  ],
+  data: SandboxGetBrowserUrlQueryData,
+): SandboxGetBrowserUrlQueryData | undefined {
+  const key = queryKeySandboxGetBrowserUrl(...queryKeyBase);
+
+  return client.setQueryData<SandboxGetBrowserUrlQueryData>(key, data);
+}
+
+export function invalidateSandboxGetBrowserUrl(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [
+      sessionId: string,
+      parameters: {
+        sessionToken?: string | null | undefined;
+        xOnBehalfOf?: string | undefined;
+      },
+    ]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "sandbox", "getBrowserUrl", ...queryKeyBase],
+  });
+}
+
+export function invalidateAllSandboxGetBrowserUrl(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "sandbox", "getBrowserUrl"],
+  });
+}

package/src/react-query/sandboxGetUrl.ts

@@ -53,10 +53,12 @@ export type SandboxGetUrlQueryError =
   | SDKValidationError;
 
 /**
- * Get Session URL
+ * Get Browser Session URL (Deprecated)
  *
  * @remarks
- * Resolve a gateway URL for a port exposed by the sandbox session. For `browser` sessions, omit `port` or set it to `9222` to get the browser proxy base URL; then use that URL directly with a CDP client such as Playwright/Puppeteer or append `/json/version` to inspect the browser endpoint over plain HTTP.
+ * Deprecated compatibility alias for `getBrowserUrl`. Return the public gateway URL for a browser session's Chrome DevTools Protocol endpoint. Standard sessions do not expose a public URL; use the command, code, and workspace operations instead.
+ *
+ * @deprecated method: Use sandbox.getBrowserUrl instead.. Use getBrowserUrl instead.
  */
 export function useSandboxGetUrl(
   request: operations.GetSessionUrlRequest,
@@ -74,10 +76,12 @@ export function useSandboxGetUrl(
 }
 
 /**
- * Get Session URL
+ * Get Browser Session URL (Deprecated)
  *
  * @remarks
- * Resolve a gateway URL for a port exposed by the sandbox session. For `browser` sessions, omit `port` or set it to `9222` to get the browser proxy base URL; then use that URL directly with a CDP client such as Playwright/Puppeteer or append `/json/version` to inspect the browser endpoint over plain HTTP.
+ * Deprecated compatibility alias for `getBrowserUrl`. Return the public gateway URL for a browser session's Chrome DevTools Protocol endpoint. Standard sessions do not expose a public URL; use the command, code, and workspace operations instead.
+ *
+ * @deprecated method: Use sandbox.getBrowserUrl instead.. Use getBrowserUrl instead.
  */
 export function useSandboxGetUrlSuspense(
   request: operations.GetSessionUrlRequest,

package/src/react-query/sandboxProxyBrowserPortRequest.ts

@@ -56,7 +56,7 @@ export type SandboxProxyBrowserPortRequestQueryError =
  * Proxy Browser Port Request
  *
  * @remarks
- * Proxy an HTTP request to an exposed browser-session port through the gateway. Use the URL returned by `GET /sessions/{session_id}/url` as the base, then append CDP subpaths such as `json/version` or `json/list`. This low-level proxy is primarily intended for browser sessions on port `9222`.
+ * Proxy an HTTP request to an exposed browser-session port through the gateway. Use the URL returned by `GET /sessions/{session_id}/browser-url` as the base. Insert CDP subpaths such as `json/version` or `json/list` before its query string, preserving the `session_token` parameter. This low-level proxy is intended for browser sessions on port `9222` and still requires the normal MKA1 API-key authorization header.
  */
 export function useSandboxProxyBrowserPortRequest(
   request: operations.ProxyBrowserPortRequestRequest,
@@ -83,7 +83,7 @@ export function useSandboxProxyBrowserPortRequest(
  * Proxy Browser Port Request
  *
  * @remarks
- * Proxy an HTTP request to an exposed browser-session port through the gateway. Use the URL returned by `GET /sessions/{session_id}/url` as the base, then append CDP subpaths such as `json/version` or `json/list`. This low-level proxy is primarily intended for browser sessions on port `9222`.
+ * Proxy an HTTP request to an exposed browser-session port through the gateway. Use the URL returned by `GET /sessions/{session_id}/browser-url` as the base. Insert CDP subpaths such as `json/version` or `json/list` before its query string, preserving the `session_token` parameter. This low-level proxy is intended for browser sessions on port `9222` and still requires the normal MKA1 API-key authorization header.
  */
 export function useSandboxProxyBrowserPortRequestSuspense(
   request: operations.ProxyBrowserPortRequestRequest,

package/src/sdk/apikey.ts

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { authApiKeyGetJwtFromKey } from "../funcs/authApiKeyGetJwtFromKey.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class ApiKey extends ClientSDK {
+  /**
+   * Exchange API key for a JWT token
+   *
+   * @remarks
+   * Exchange an API key for a JWT token
+   *
+   * @deprecated method: Use auth.apiKeys.exchangeToken() instead. This method will be removed in a future release.. Use exchangeToken instead.
+   */
+  async getJwtFromKey(
+    request: operations.GetJwtFromKeyRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetJwtFromKeyResponseBody> {
+    return unwrapAsync(authApiKeyGetJwtFromKey(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/apikeys.ts

@@ -0,0 +1,99 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { authApiKeysCreate } from "../funcs/authApiKeysCreate.js";
+import { authApiKeysExchangeToken } from "../funcs/authApiKeysExchangeToken.js";
+import { authApiKeysList } from "../funcs/authApiKeysList.js";
+import { authApiKeysRegenerate } from "../funcs/authApiKeysRegenerate.js";
+import { authApiKeysUpdate } from "../funcs/authApiKeysUpdate.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class ApiKeys extends ClientSDK {
+  /**
+   * Mint a scoped API key
+   *
+   * @remarks
+   * Mint an API key bound to a (principal, team) carrying an explicit scope set. Requires a session, or a bearer key holding `write:apikeys`. The plaintext secret is returned once.
+   */
+  async create(
+    request: operations.CreateScopedApiKeyRequest,
+    options?: RequestOptions,
+  ): Promise<operations.CreateScopedApiKeyResponseBody> {
+    return unwrapAsync(authApiKeysCreate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List scoped API keys
+   *
+   * @remarks
+   * List the caller's scoped API keys (metadata only — never the secret). Optional `?orgId=&teamId=` narrows; a key caller is scoped to its own org.
+   */
+  async list(
+    request: operations.ListScopedApiKeysRequest,
+    options?: RequestOptions,
+  ): Promise<Array<operations.ResponseBody>> {
+    return unwrapAsync(authApiKeysList(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Update a scoped API key
+   *
+   * @remarks
+   * Update a key's scopes (and optionally name / rate limit). Scopes already on the key are retained; newly-added scopes are bounded by the caller's role (and, for a key caller, the calling key's own scopes).
+   */
+  async update(
+    request: operations.UpdateScopedApiKeyRequest,
+    options?: RequestOptions,
+  ): Promise<operations.UpdateScopedApiKeyResponseBody> {
+    return unwrapAsync(authApiKeysUpdate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Rotate a scoped API key's secret
+   *
+   * @remarks
+   * Issue a new plaintext secret for an existing key in place (id / scopes / binding preserved). Returned once.
+   */
+  async regenerate(
+    request: operations.RegenerateScopedApiKeyRequest,
+    options?: RequestOptions,
+  ): Promise<operations.RegenerateScopedApiKeyResponseBody> {
+    return unwrapAsync(authApiKeysRegenerate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Exchange API key for a JWT token
+   *
+   * @remarks
+   * Exchange an API key for a short-lived JWT token.
+   */
+  async exchangeToken(
+    request: operations.ExchangeApiKeyTokenRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ExchangeApiKeyTokenResponseBody> {
+    return unwrapAsync(authApiKeysExchangeToken(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/auth.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ClientSDK } from "../lib/sdks.js";
+import { ApiKey } from "./apikey.js";
+import { ApiKeys } from "./apikeys.js";
+import { Cluster } from "./cluster.js";
+import { Orgs } from "./orgs.js";
+import { ServiceAccounts } from "./serviceaccounts.js";
+import { Teams } from "./teams.js";
+
+export class Auth extends ClientSDK {
+  private _apiKeys?: ApiKeys;
+  get apiKeys(): ApiKeys {
+    return (this._apiKeys ??= new ApiKeys(this._options));
+  }
+
+  private _teams?: Teams;
+  get teams(): Teams {
+    return (this._teams ??= new Teams(this._options));
+  }
+
+  private _serviceAccounts?: ServiceAccounts;
+  get serviceAccounts(): ServiceAccounts {
+    return (this._serviceAccounts ??= new ServiceAccounts(this._options));
+  }
+
+  private _orgs?: Orgs;
+  get orgs(): Orgs {
+    return (this._orgs ??= new Orgs(this._options));
+  }
+
+  private _cluster?: Cluster;
+  get cluster(): Cluster {
+    return (this._cluster ??= new Cluster(this._options));
+  }
+
+  private _apiKey?: ApiKey;
+  get apiKey(): ApiKey {
+    return (this._apiKey ??= new ApiKey(this._options));
+  }
+}

package/src/sdk/cluster.ts

@@ -0,0 +1,183 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { authClusterAcceptInvite } from "../funcs/authClusterAcceptInvite.js";
+import { authClusterCreateInvite } from "../funcs/authClusterCreateInvite.js";
+import { authClusterDeleteOrg } from "../funcs/authClusterDeleteOrg.js";
+import { authClusterGetOrg } from "../funcs/authClusterGetOrg.js";
+import { authClusterInviteInfo } from "../funcs/authClusterInviteInfo.js";
+import { authClusterListInvites } from "../funcs/authClusterListInvites.js";
+import { authClusterListOrgs } from "../funcs/authClusterListOrgs.js";
+import { authClusterReissueOwnerKey } from "../funcs/authClusterReissueOwnerKey.js";
+import { authClusterRevokeInvite } from "../funcs/authClusterRevokeInvite.js";
+import { authClusterSuspendOrg } from "../funcs/authClusterSuspendOrg.js";
+import { authClusterUnsuspendOrg } from "../funcs/authClusterUnsuspendOrg.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Cluster extends ClientSDK {
+  /**
+   * Create a cluster invitation
+   *
+   * @remarks
+   * Issue a one-shot invite that provisions a new org on acceptance. Email-bound invites can be accepted headless (passwordless + issueApiKey).
+   */
+  async createInvite(
+    request: operations.CreateClusterInviteRequest,
+    options?: RequestOptions,
+  ): Promise<operations.CreateClusterInviteResponseBody> {
+    return unwrapAsync(authClusterCreateInvite(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List cluster invitations
+   */
+  async listInvites(
+    request: operations.ListClusterInvitesRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListClusterInvitesResponseBody> {
+    return unwrapAsync(authClusterListInvites(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Revoke a cluster invitation
+   */
+  async revokeInvite(
+    request: operations.RevokeClusterInviteRequest,
+    options?: RequestOptions,
+  ): Promise<operations.RevokeClusterInviteResponseBody> {
+    return unwrapAsync(authClusterRevokeInvite(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List all organizations
+   */
+  async listOrgs(
+    request: operations.ListClusterOrgsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListClusterOrgsResponseBody> {
+    return unwrapAsync(authClusterListOrgs(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get an organization
+   */
+  async getOrg(
+    request: operations.GetClusterOrgRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetClusterOrgResponseBody> {
+    return unwrapAsync(authClusterGetOrg(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Soft-delete an organization
+   */
+  async deleteOrg(
+    request: operations.DeleteClusterOrgRequest,
+    options?: RequestOptions,
+  ): Promise<operations.DeleteClusterOrgResponseBody> {
+    return unwrapAsync(authClusterDeleteOrg(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Suspend an organization
+   */
+  async suspendOrg(
+    request: operations.SuspendClusterOrgRequest,
+    options?: RequestOptions,
+  ): Promise<operations.SuspendClusterOrgResponseBody> {
+    return unwrapAsync(authClusterSuspendOrg(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Unsuspend an organization
+   */
+  async unsuspendOrg(
+    request: operations.UnsuspendClusterOrgRequest,
+    options?: RequestOptions,
+  ): Promise<operations.UnsuspendClusterOrgResponseBody> {
+    return unwrapAsync(authClusterUnsuspendOrg(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Re-issue an org owner key (recovery)
+   *
+   * @remarks
+   * Mint a fresh owner-bound key for an org whose credential was lost. Cluster-admin only (`write:cluster`). Defaults to the org's oldest human owner and oldest team; `userId` / `teamId` override.
+   */
+  async reissueOwnerKey(
+    request: operations.ReissueOwnerKeyRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ReissueOwnerKeyResponseBody> {
+    return unwrapAsync(authClusterReissueOwnerKey(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Read cluster-invite info (public)
+   */
+  async inviteInfo(
+    request: operations.GetClusterInviteInfoRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetClusterInviteInfoResponseBody> {
+    return unwrapAsync(authClusterInviteInfo(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Accept a cluster invitation (public)
+   *
+   * @remarks
+   * Accept an invite and create the org. Existing signed-in user, new email/password owner, or (email-bound) headless machine owner with `passwordless: true, issueApiKey: true`.
+   */
+  async acceptInvite(
+    request: operations.AcceptClusterInviteRequest,
+    options?: RequestOptions,
+  ): Promise<operations.AcceptClusterInviteResponseBody> {
+    return unwrapAsync(authClusterAcceptInvite(
+      this,
+      request,
+      options,
+    ));
+  }
+}