@meetkai/mka1 0.49.9 → 0.49.11

package/src/react-query/llmUsageFiles.ts

@@ -105,13 +105,11 @@ export function setLlmUsageFilesData(
       bucketWidth?: components.BucketWidth | undefined;
       limit?: number | undefined;
       page?: string | undefined;
-      userIds?: operations.GetFilesUsageQueryParamUserIds | undefined;
-      externalUserIds?:
-        | operations.GetFilesUsageQueryParamExternalUserIds
-        | undefined;
+      userIds?: Array<string> | undefined;
+      externalUserIds?: Array<string> | undefined;
       allOrgs?: string | undefined;
-      orgIds?: operations.GetFilesUsageQueryParamOrgIds | undefined;
-      groupBy?: operations.GetFilesUsageQueryParamGroupBy | undefined;
+      orgIds?: Array<string> | undefined;
+      groupBy?: Array<components.FilesGroupBy> | undefined;
       xOnBehalfOf?: string | undefined;
     },
   ],
@@ -131,13 +129,11 @@ export function invalidateLlmUsageFiles(
       bucketWidth?: components.BucketWidth | undefined;
       limit?: number | undefined;
       page?: string | undefined;
-      userIds?: operations.GetFilesUsageQueryParamUserIds | undefined;
-      externalUserIds?:
-        | operations.GetFilesUsageQueryParamExternalUserIds
-        | undefined;
+      userIds?: Array<string> | undefined;
+      externalUserIds?: Array<string> | undefined;
       allOrgs?: string | undefined;
-      orgIds?: operations.GetFilesUsageQueryParamOrgIds | undefined;
-      groupBy?: operations.GetFilesUsageQueryParamGroupBy | undefined;
+      orgIds?: Array<string> | undefined;
+      groupBy?: Array<components.FilesGroupBy> | undefined;
       xOnBehalfOf?: string | undefined;
     }]
   >,

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

@@ -88,12 +88,12 @@ export function queryKeyLlmUsageResponses(
     bucketWidth?: components.BucketWidth | undefined;
     limit?: number | undefined;
     page?: string | undefined;
-    userIds?: operations.QueryParamUserIds | undefined;
-    externalUserIds?: operations.QueryParamExternalUserIds | undefined;
+    userIds?: Array<string> | undefined;
+    externalUserIds?: Array<string> | undefined;
     allOrgs?: string | undefined;
-    orgIds?: operations.QueryParamOrgIds | undefined;
-    groupBy?: operations.QueryParamGroupBy | undefined;
-    models?: operations.QueryParamModels | undefined;
+    orgIds?: Array<string> | undefined;
+    groupBy?: Array<components.ResponsesGroupBy> | undefined;
+    models?: Array<string> | undefined;
     background?: boolean | undefined;
     xOnBehalfOf?: string | undefined;
   },

package/src/react-query/llmUsageResponses.ts

@@ -111,12 +111,12 @@ export function setLlmUsageResponsesData(
       bucketWidth?: components.BucketWidth | undefined;
       limit?: number | undefined;
       page?: string | undefined;
-      userIds?: operations.QueryParamUserIds | undefined;
-      externalUserIds?: operations.QueryParamExternalUserIds | undefined;
+      userIds?: Array<string> | undefined;
+      externalUserIds?: Array<string> | undefined;
       allOrgs?: string | undefined;
-      orgIds?: operations.QueryParamOrgIds | undefined;
-      groupBy?: operations.QueryParamGroupBy | undefined;
-      models?: operations.QueryParamModels | undefined;
+      orgIds?: Array<string> | undefined;
+      groupBy?: Array<components.ResponsesGroupBy> | undefined;
+      models?: Array<string> | undefined;
       background?: boolean | undefined;
       xOnBehalfOf?: string | undefined;
     },
@@ -137,12 +137,12 @@ export function invalidateLlmUsageResponses(
       bucketWidth?: components.BucketWidth | undefined;
       limit?: number | undefined;
       page?: string | undefined;
-      userIds?: operations.QueryParamUserIds | undefined;
-      externalUserIds?: operations.QueryParamExternalUserIds | undefined;
+      userIds?: Array<string> | undefined;
+      externalUserIds?: Array<string> | undefined;
       allOrgs?: string | undefined;
-      orgIds?: operations.QueryParamOrgIds | undefined;
-      groupBy?: operations.QueryParamGroupBy | undefined;
-      models?: operations.QueryParamModels | undefined;
+      orgIds?: Array<string> | undefined;
+      groupBy?: Array<components.ResponsesGroupBy> | undefined;
+      models?: Array<string> | undefined;
       background?: boolean | undefined;
       xOnBehalfOf?: string | undefined;
     }]

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

@@ -86,13 +86,11 @@ export function queryKeyLlmUsageVectorStores(
     bucketWidth?: components.BucketWidth | undefined;
     limit?: number | undefined;
     page?: string | undefined;
-    userIds?: operations.GetVectorStoresUsageQueryParamUserIds | undefined;
-    externalUserIds?:
-      | operations.GetVectorStoresUsageQueryParamExternalUserIds
-      | undefined;
+    userIds?: Array<string> | undefined;
+    externalUserIds?: Array<string> | undefined;
     allOrgs?: string | undefined;
-    orgIds?: operations.GetVectorStoresUsageQueryParamOrgIds | undefined;
-    groupBy?: operations.GetVectorStoresUsageQueryParamGroupBy | undefined;
+    orgIds?: Array<string> | undefined;
+    groupBy?: Array<components.VectorStoresGroupBy> | undefined;
     xOnBehalfOf?: string | undefined;
   },
 ): QueryKey {

package/src/react-query/llmUsageVectorStores.ts

@@ -114,13 +114,11 @@ export function setLlmUsageVectorStoresData(
       bucketWidth?: components.BucketWidth | undefined;
       limit?: number | undefined;
       page?: string | undefined;
-      userIds?: operations.GetVectorStoresUsageQueryParamUserIds | undefined;
-      externalUserIds?:
-        | operations.GetVectorStoresUsageQueryParamExternalUserIds
-        | undefined;
+      userIds?: Array<string> | undefined;
+      externalUserIds?: Array<string> | undefined;
       allOrgs?: string | undefined;
-      orgIds?: operations.GetVectorStoresUsageQueryParamOrgIds | undefined;
-      groupBy?: operations.GetVectorStoresUsageQueryParamGroupBy | undefined;
+      orgIds?: Array<string> | undefined;
+      groupBy?: Array<components.VectorStoresGroupBy> | undefined;
       xOnBehalfOf?: string | undefined;
     },
   ],
@@ -140,13 +138,11 @@ export function invalidateLlmUsageVectorStores(
       bucketWidth?: components.BucketWidth | undefined;
       limit?: number | undefined;
       page?: string | undefined;
-      userIds?: operations.GetVectorStoresUsageQueryParamUserIds | undefined;
-      externalUserIds?:
-        | operations.GetVectorStoresUsageQueryParamExternalUserIds
-        | undefined;
+      userIds?: Array<string> | undefined;
+      externalUserIds?: Array<string> | undefined;
       allOrgs?: string | undefined;
-      orgIds?: operations.GetVectorStoresUsageQueryParamOrgIds | undefined;
-      groupBy?: operations.GetVectorStoresUsageQueryParamGroupBy | undefined;
+      orgIds?: Array<string> | undefined;
+      groupBy?: Array<components.VectorStoresGroupBy> | undefined;
       xOnBehalfOf?: string | undefined;
     }]
   >,

package/src/react-query/sandboxCreate.ts

@@ -50,7 +50,7 @@ export type SandboxCreateMutationError =
  * Create Session
  *
  * @remarks
- * Create a sandbox session and return a session token, provider, and base sandbox URL. Set `session_kind` to `browser` to start a browser-backed session instead of a standard command/code sandbox. Set `queue_if_full` to `true` to queue the request instead of failing when runner capacity is temporarily unavailable.
+ * Create a sandbox session and return its public session metadata, session token, and provider. Set `session_kind` to `browser` to start a browser-backed session instead of a standard command/code sandbox. Set `queue_if_full` to `true` to queue the request instead of failing when runner capacity is temporarily unavailable. It does not queue requests for session kinds the deployment does not support. Browser sessions require a Firecracker-backed deployment; standard-only deployments reject them immediately with `browser_sessions_not_enabled`.
  */
 export function useSandboxCreateMutation(
   options?: MutationHookOptions<

package/src/react-query/sandboxGet.ts

@@ -56,7 +56,7 @@ export type SandboxGetQueryError =
  * Get Session
  *
  * @remarks
- * Return the current state, features, and runner metadata for a sandbox session.
+ * Return the current state, configuration, and resource allocation for a sandbox session.
  */
 export function useSandboxGet(
   request: operations.GetSessionRequest,
@@ -77,7 +77,7 @@ export function useSandboxGet(
  * Get Session
  *
  * @remarks
- * Return the current state, features, and runner metadata for a sandbox session.
+ * Return the current state, configuration, and resource allocation for a sandbox session.
  */
 export function useSandboxGetSuspense(
   request: operations.GetSessionRequest,

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

@@ -6,6 +6,7 @@ import { sandboxCreate } from "../funcs/sandboxCreate.js";
 import { sandboxDownloadArchive } from "../funcs/sandboxDownloadArchive.js";
 import { sandboxDownloadFile } from "../funcs/sandboxDownloadFile.js";
 import { sandboxGet } from "../funcs/sandboxGet.js";
+import { sandboxGetBrowserUrl } from "../funcs/sandboxGetBrowserUrl.js";
 import { sandboxGetPricing } from "../funcs/sandboxGetPricing.js";
 import { sandboxGetUrl } from "../funcs/sandboxGetUrl.js";
 import { sandboxGetWorkspace } from "../funcs/sandboxGetWorkspace.js";
@@ -27,7 +28,7 @@ export class Sandbox extends ClientSDK {
    * Create Session
    *
    * @remarks
-   * Create a sandbox session and return a session token, provider, and base sandbox URL. Set `session_kind` to `browser` to start a browser-backed session instead of a standard command/code sandbox. Set `queue_if_full` to `true` to queue the request instead of failing when runner capacity is temporarily unavailable.
+   * Create a sandbox session and return its public session metadata, session token, and provider. Set `session_kind` to `browser` to start a browser-backed session instead of a standard command/code sandbox. Set `queue_if_full` to `true` to queue the request instead of failing when runner capacity is temporarily unavailable. It does not queue requests for session kinds the deployment does not support. Browser sessions require a Firecracker-backed deployment; standard-only deployments reject them immediately with `browser_sessions_not_enabled`.
    */
   async create(
     request: operations.CreateSessionRequest,
@@ -61,7 +62,7 @@ export class Sandbox extends ClientSDK {
    * Get Session
    *
    * @remarks
-   * Return the current state, features, and runner metadata for a sandbox session.
+   * Return the current state, configuration, and resource allocation for a sandbox session.
    */
   async get(
     request: operations.GetSessionRequest,
@@ -107,10 +108,29 @@ export class Sandbox extends ClientSDK {
   }
 
   /**
-   * Get Session URL
+   * Get Browser Session URL
    *
    * @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.
+   * 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.
+   */
+  async getBrowserUrl(
+    request: operations.GetBrowserSessionUrlRequest,
+    options?: RequestOptions,
+  ): Promise<components.SessionUrlResponse> {
+    return unwrapAsync(sandboxGetBrowserUrl(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get Browser Session URL (Deprecated)
+   *
+   * @remarks
+   * 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.
    */
   async getUrl(
     request: operations.GetSessionUrlRequest,
@@ -127,7 +147,7 @@ export class Sandbox extends ClientSDK {
    * 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.
    */
   async proxyBrowserPortRequest(
     request: operations.ProxyBrowserPortRequestRequest,

package/dist/commonjs/mcp-server/tools/sandboxGetUrl.d.ts

@@ -1,8 +0,0 @@
-import * as operations from "../../models/operations/index.js";
-import { ToolDefinition } from "../tools.js";
-declare const args: {
-    request: import("zod").ZodType<operations.GetSessionUrlRequest, import("zod").ZodTypeDef, unknown>;
-};
-export declare const tool$sandboxGetUrl: ToolDefinition<typeof args>;
-export {};
-//# sourceMappingURL=sandboxGetUrl.d.ts.map

package/dist/commonjs/mcp-server/tools/sandboxGetUrl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandboxGetUrl.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/sandboxGetUrl.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,UAAU,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,OAAO,IAAI,CAwB1D,CAAC"}

package/dist/commonjs/mcp-server/tools/sandboxGetUrl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandboxGetUrl.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/sandboxGetUrl.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,mEAA6D;AAC7D,6EAA+D;AAC/D,0CAA2D;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,UAAU,CAAC,kCAAkC;CACvD,CAAC;AAEW,QAAA,kBAAkB,GAAgC;IAC7D,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;yTAE0S;IACvT,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,IAAA,gCAAa,EAC3C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,IAAA,uBAAY,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/dist/esm/mcp-server/tools/sandboxGetUrl.d.ts

@@ -1,8 +0,0 @@
-import * as operations from "../../models/operations/index.js";
-import { ToolDefinition } from "../tools.js";
-declare const args: {
-    request: import("zod").ZodType<operations.GetSessionUrlRequest, import("zod").ZodTypeDef, unknown>;
-};
-export declare const tool$sandboxGetUrl: ToolDefinition<typeof args>;
-export {};
-//# sourceMappingURL=sandboxGetUrl.d.ts.map

package/dist/esm/mcp-server/tools/sandboxGetUrl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandboxGetUrl.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/sandboxGetUrl.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,UAAU,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,QAAA,MAAM,IAAI;;CAET,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,OAAO,IAAI,CAwB1D,CAAC"}

package/dist/esm/mcp-server/tools/sandboxGetUrl.js

@@ -1,28 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-import { sandboxGetUrl } from "../../funcs/sandboxGetUrl.js";
-import * as operations from "../../models/operations/index.js";
-import { formatResult } from "../tools.js";
-const args = {
-    request: operations.GetSessionUrlRequest$inboundSchema,
-};
-export const tool$sandboxGetUrl = {
-    name: "sandbox-get-url",
-    description: `Get Session URL
-
-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.`,
-    args,
-    tool: async (client, args, ctx) => {
-        const [result, apiCall] = await sandboxGetUrl(client, args.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
-        if (!result.ok) {
-            return {
-                content: [{ type: "text", text: result.error.message }],
-                isError: true,
-            };
-        }
-        const value = result.value;
-        return formatResult(value, apiCall);
-    },
-};
-//# sourceMappingURL=sandboxGetUrl.js.map

package/dist/esm/mcp-server/tools/sandboxGetUrl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandboxGetUrl.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/sandboxGetUrl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,UAAU,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,UAAU,CAAC,kCAAkC;CACvD,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;yTAE0S;IACvT,IAAI;IACJ,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,aAAa,CAC3C,MAAM,EACN,IAAI,CAAC,OAAO,EACZ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CACzC,CAAC,QAAQ,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE3B,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/src/mcp-server/tools/sandboxGetUrl.ts

@@ -1,37 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { sandboxGetUrl } from "../../funcs/sandboxGetUrl.js";
-import * as operations from "../../models/operations/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: operations.GetSessionUrlRequest$inboundSchema,
-};
-
-export const tool$sandboxGetUrl: ToolDefinition<typeof args> = {
-  name: "sandbox-get-url",
-  description: `Get Session URL
-
-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.`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await sandboxGetUrl(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};