@meetkai/mka1 0.53.27 → 0.53.29

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxCreate } from "../../funcs/sandboxCreate.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CreateSessionRequest$inboundSchema,
+};
+
+export const tool$sandboxCreate: ToolDefinition<typeof args> = {
+  name: "sandbox-create",
+  description: `Create Session
+
+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\`.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxCreate(
+      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);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxDownloadArchive } from "../../funcs/sandboxDownloadArchive.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.DownloadWorkspaceArchiveRequest$inboundSchema,
+};
+
+export const tool$sandboxDownloadArchive: ToolDefinition<typeof args> = {
+  name: "sandbox-download-archive",
+  description: `Download Workspace Archive
+
+Download a zip archive containing the selected workspace paths.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxDownloadArchive(
+      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);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxDownloadFile } from "../../funcs/sandboxDownloadFile.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.DownloadWorkspaceFileRequest$inboundSchema,
+};
+
+export const tool$sandboxDownloadFile: ToolDefinition<typeof args> = {
+  name: "sandbox-download-file",
+  description: `Download Workspace File
+
+Download raw bytes from a file in the session workspace.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxDownloadFile(
+      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);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxGet } from "../../funcs/sandboxGet.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetSessionRequest$inboundSchema,
+};
+
+export const tool$sandboxGet: ToolDefinition<typeof args> = {
+  name: "sandbox-get",
+  description: `Get Session
+
+Return the current state, configuration, and resource allocation for a sandbox session.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxGet(
+      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);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxGetBrowserUrl } from "../../funcs/sandboxGetBrowserUrl.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetBrowserSessionUrlRequest$inboundSchema,
+};
+
+export const tool$sandboxGetBrowserUrl: ToolDefinition<typeof args> = {
+  name: "sandbox-get-browser-url",
+  description: `Get Browser Session URL
+
+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.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxGetBrowserUrl(
+      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);
+  },
+};

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

@@ -0,0 +1,30 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxGetPricing } from "../../funcs/sandboxGetPricing.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+export const tool$sandboxGetPricing: ToolDefinition = {
+  name: "sandbox-get-pricing",
+  description: `Get Sandbox Pricing
+
+Current sandbox pricing rate card, keyed by SKU (\`standard\`, \`browser\`, \`eval-python\`). Metered sandbox usage is billed \`hours × (per_hour + reserved_memory_GiB × per_gib_hour)\`; SKUs without a configured rate accrue no spend. Cluster admins only.`,
+  tool: async (client, ctx) => {
+    const [result, apiCall] = await sandboxGetPricing(
+      client,
+      { 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);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxGetWorkspace } from "../../funcs/sandboxGetWorkspace.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetWorkspaceRequest$inboundSchema,
+};
+
+export const tool$sandboxGetWorkspace: ToolDefinition<typeof args> = {
+  name: "sandbox-get-workspace",
+  description: `Get Workspace Manifest
+
+List files currently stored in the session workspace, including paths, sizes, and etags.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxGetWorkspace(
+      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);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxList } from "../../funcs/sandboxList.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListSessionsRequest$inboundSchema,
+};
+
+export const tool$sandboxList: ToolDefinition<typeof args> = {
+  name: "sandbox-list",
+  description: `List Sessions
+
+List sandbox sessions visible to the authenticated caller.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxList(
+      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);
+  },
+};

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

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxProxyBrowserPortRequest } from "../../funcs/sandboxProxyBrowserPortRequest.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ProxyBrowserPortRequestRequest$inboundSchema,
+};
+
+export const tool$sandboxProxyBrowserPortRequest: ToolDefinition<typeof args> =
+  {
+    name: "sandbox-proxy-browser-port-request",
+    description: `Proxy Browser Port Request
+
+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.`,
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await sandboxProxyBrowserPortRequest(
+        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);
+    },
+  };

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxRunCode } from "../../funcs/sandboxRunCode.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.RunCodeRequest$inboundSchema,
+};
+
+export const tool$sandboxRunCode: ToolDefinition<typeof args> = {
+  name: "sandbox-run-code",
+  description: `Run Code
+
+Execute source code in the session workspace using a supported runtime and return the execution result.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxRunCode(
+      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);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxRunCommand } from "../../funcs/sandboxRunCommand.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.RunCommandRequest$inboundSchema,
+};
+
+export const tool$sandboxRunCommand: ToolDefinition<typeof args> = {
+  name: "sandbox-run-command",
+  description: `Run Command
+
+Run a command in the session workspace and return stdout, stderr, exit code, and changed files.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxRunCommand(
+      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);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxSetPricing } from "../../funcs/sandboxSetPricing.js";
+import * as components from "../../models/components/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: components.SandboxPricingUpdate$inboundSchema,
+};
+
+export const tool$sandboxSetPricing: ToolDefinition<typeof args> = {
+  name: "sandbox-set-pricing",
+  description: `Set Sandbox Pricing
+
+Replace the sandbox pricing rate card. Full-replace semantics: SKUs omitted from the request become unpriced and accrue no spend. Takes effect on the next meter window without a restart. Cluster admins only.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxSetPricing(
+      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);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxTerminate } from "../../funcs/sandboxTerminate.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.TerminateSessionRequest$inboundSchema,
+};
+
+export const tool$sandboxTerminate: ToolDefinition<typeof args> = {
+  name: "sandbox-terminate",
+  description: `Terminate Session
+
+Stop a sandbox session and release the backing sandbox resources.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxTerminate(
+      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);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxUploadArchive } from "../../funcs/sandboxUploadArchive.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.UploadWorkspaceArchiveRequest$inboundSchema,
+};
+
+export const tool$sandboxUploadArchive: ToolDefinition<typeof args> = {
+  name: "sandbox-upload-archive",
+  description: `Upload Workspace Archive
+
+Upload a zip archive and extract its files into the session workspace.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxUploadArchive(
+      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);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { sandboxUploadFile } from "../../funcs/sandboxUploadFile.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.UploadWorkspaceFileRequest$inboundSchema,
+};
+
+export const tool$sandboxUploadFile: ToolDefinition<typeof args> = {
+  name: "sandbox-upload-file",
+  description: `Upload Workspace File
+
+Upload raw bytes into the session workspace at the given path.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await sandboxUploadFile(
+      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);
+  },
+};

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

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { schema3OtherReadCloneApiV1SandboxSessionsSessionIdGithubReadClonePost } from "../../funcs/schema3OtherReadCloneApiV1SandboxSessionsSessionIdGithubReadClonePost.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request:
+    operations
+      .ReadCloneApiV1SandboxSessionsSessionIdGithubReadClonePostRequest$inboundSchema,
+};
+
+export const tool$schema3OtherReadCloneApiV1SandboxSessionsSessionIdGithubReadClonePost:
+  ToolDefinition<typeof args> = {
+    name:
+      "schema-3-other-read-clone-api-v1-sandbox-sessions-session-id-github-read-clone-post",
+    description: `Read Clone`,
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] =
+        await schema3OtherReadCloneApiV1SandboxSessionsSessionIdGithubReadClonePost(
+          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);
+    },
+  };

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { usageSandbox } from "../../funcs/usageSandbox.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetSandboxUsageRequest$inboundSchema,
+};
+
+export const tool$usageSandbox: ToolDefinition<typeof args> = {
+  name: "usage-sandbox",
+  description: `Get Sandbox Usage
+
+Aggregate sandbox usage (session lifecycle, execution, and workspace operations) over a time range, bucketed and optionally grouped. Buckets are calendar-aligned in UTC: \`start_time\` is snapped down and \`end_time\` snapped up to the nearest bucket-width boundary, so the first and last buckets may extend slightly beyond the requested range. Org-scoped: callers see their own usage, org admins their team's; cluster admins may pass \`all_orgs\` or \`org_ids\`. Cost and spend reporting lives in the budgeting API (\`/api/v1/budgeting/usage/costs\`).`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await usageSandbox(
+      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);
+  },
+};