{"$schema":"https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json","version":"1.0","protocolVersion":"2025-11-25","serverInfo":{"name":"kosa8-cloud","title":"kosa8 Cloud","version":"1.0.0","websiteUrl":"https://kosa8.com","icons":[{"src":"https://kosa8.com/assets/mark.svg","mimeType":"image/svg+xml","sizes":["any"]},{"src":"https://kosa8.com/assets/mark-512.png","mimeType":"image/png","sizes":["512x512"]},{"src":"https://kosa8.com/assets/mark-256.png","mimeType":"image/png","sizes":["256x256"]}]},"description":"Sealed Linux sandboxes (microVMs) for AI agents on kosa8 Cloud: run commands, move files, preview ports, snapshot, checkpoint, rewind and fork.","iconUrl":"https://kosa8.com/assets/mark-512.png","documentationUrl":"https://docs.kosa8.com/guides/cloud-mcp/","transport":{"type":"streamable-http","endpoint":"/mcp"},"capabilities":{"tools":{"listChanged":false}},"authentication":{"required":true,"schemes":["bearer"],"description":"A kosa8 Cloud API key (k8c_live_…) as Authorization: Bearer. Make one at https://app.kosa8.com/app#keys."},"instructions":"kosa8 Cloud runs sealed Linux sandboxes (microVMs) on kosa8's hosts, within the limits of the account's plan. Typical use: sandbox_create (optionally pick a template from templates_list, or a size such as 4x8, an image, docker: true, env), then sandbox_exec as many times as needed; files under /workspace persist between commands. For anything longer than 90 s (installs, builds, servers) use sandbox_exec with background: true and poll sandbox_exec_status. file_read, file_write and file_list move files without a shell; preview_create gives a port its own https URL; code_run runs Python in a stateful kernel (charts come back as images); snapshot_create saves a sandbox to start others from (sandbox_create with snapshot); pipeline_run runs a repository's CI. sandbox_sleep keeps state and frees its compute; the next sandbox_exec wakes it. sandbox_delete when finished. Secrets are set by the person (dashboard or kosa8 cloud secrets set), never through these tools. If a tool says payment is required or the spending cap is reached, tell the person the message and the upgrade_url word for word; do not retry until they have acted.","tools":[{"name":"sandbox_create","title":"Create a sandbox","description":"Start a new kosa8 Cloud sandbox and return it (id, state, template, region). Its running time counts toward the account's plan. A sized, image or docker sandbox may boot cold and come back with state creating: poll sandbox_get until it is running.","inputSchema":{"type":"object","properties":{"template":{"type":"string","description":"Template key from templates_list, e.g. base, python, node. Default: the org's default."},"region":{"type":"string","description":"Region id: us-ash1 (Dallas, US) or eu-hel1 (Helsinki, EU), or the area alone (us, eu). Default: the org's default, else the region nearest the caller."},"sleep_after_s":{"type":"integer","minimum":0,"maximum":604800,"description":"Idle seconds before it sleeps; 0 never."},"ttl_s":{"type":"integer","minimum":60,"maximum":7776000,"description":"Delete it automatically after this many seconds."},"persistent":{"type":"boolean","description":"Run every command in one long-lived container, so installed packages, $HOME and background processes (nohup cmd &) persist between commands. Default false."},"size":{"type":"string","enum":["2x4","4x8","8x16","16x32"],"description":"vCPU x GiB, booted cold (state creating until up). Needs a payment method."},"image":{"type":"string","maxLength":512,"description":"An OCI image to run instead of a template's, e.g. kosa8-template/universal-24.04-20261115.2 (Ubuntu 24.04 with common languages and build tools), kosa8-template/universal-full-24.04-20261115.2 (more languages and tools), or a public image such as python:3.12."},"disk_gb":{"type":"integer","minimum":8,"maximum":200,"description":"Data disk in GB (default 32)."},"name":{"type":"string","description":"A label to find it by."},"cpu":{"type":"string","enum":["shared","dedicated"],"description":"dedicated: each vCPU a whole physical core of its own (with a size); never sleeps."},"cpus":{"type":"integer","minimum":1,"maximum":16,"description":"vCPUs, the other way to give a size (with mem_mb): together they must be one of the sizes, e.g. cpus 4 and mem_mb 8192 for 4x8."},"mem_mb":{"type":"integer","minimum":1024,"maximum":32768,"description":"Memory in MiB, with cpus (see cpus)."},"docker":{"type":"boolean","description":"Run a Docker daemon inside (docker build, docker run, compose). Implies persistent."},"env":{"type":"object","additionalProperties":{"type":"string"},"description":"Environment variables every command in the sandbox sees, NAME: value. Not for secrets: the person sets those."},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"Labels to find it by, key: value (at most 16)."},"snapshot":{"type":"string","pattern":"^snap_[A-Za-z0-9]{8,40}$","description":"Start from this snapshot (snap_…, from snapshot_list): its disk, memory and processes. Not with size, image or docker."}},"additionalProperties":false},"annotations":{"title":"Create a sandbox","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"sandbox_list","title":"List sandboxes","description":"List the organization's sandboxes with their state and cost so far.","inputSchema":{"type":"object","properties":{"include_deleted":{"type":"boolean","description":"Also list deleted sandboxes."}},"additionalProperties":false},"annotations":{"title":"List sandboxes","readOnlyHint":true,"openWorldHint":false}},{"name":"sandbox_exec","title":"Run a command in a sandbox","description":"Run a command in a sandbox and return its exit code, stdout and stderr. Give argv (exact arguments) or command (a shell string, run with sh -c). A sleeping sandbox wakes first. Each command runs in a fresh container: files under /workspace persist between commands, background processes do not. A command may run at most 90 s; past that it is stopped and the tool returns exec_timeout. Set timeout_s to stop it sooner (at most 90, or longer with background), e.g. a test run you do not trust to finish. For long work (installs, test suites, builds, servers) set background: true: it returns at once with an exec id (bg_…) and keeps running; read its state, exit code and output with sandbox_exec_status.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"argv":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":256,"description":"The command and its arguments, e.g. [\"python3\", \"-c\", \"print(1)\"]"},"command":{"type":"string","maxLength":8192,"description":"A shell command line, run as sh -c '<command>'. Use this or argv."},"env":{"type":"object","additionalProperties":{"type":"string"},"description":"Environment variables for this command."},"image":{"type":"string","description":"Run in this image instead of the template's own."},"background":{"type":"boolean","description":"Start it detached and return its exec id at once; poll sandbox_exec_status. Default false."},"timeout_s":{"type":"integer","minimum":1,"maximum":86400,"description":"Stop the command after this many seconds: at most 90 in the foreground (exec_timeout); with background, any length, and sandbox_exec_status then says timed_out."}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"Run a command in a sandbox","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"sandbox_sleep","title":"Put a sandbox to sleep","description":"Snapshot a running sandbox and free its RAM. It keeps its state and uses no compute until it wakes.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"Put a sandbox to sleep","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"sandbox_wake","title":"Wake a sandbox","description":"Restore a sleeping sandbox now (sandbox_exec also wakes it on demand).","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"Wake a sandbox","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"sandbox_delete","title":"Delete a sandbox","description":"Delete a sandbox and everything in it. This cannot be undone.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"Delete a sandbox","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"usage_get","title":"This month's usage","description":"This month's kosa8 Cloud usage so far: sandbox-hours, compute and storage, the plan, the spending cap, and whether new work is paused for payment.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"title":"This month's usage","readOnlyHint":true,"openWorldHint":false}},{"name":"templates_list","title":"List templates","description":"The sandbox templates this organization can create now, with size, image, regions and warm count.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"title":"List templates","readOnlyHint":true,"openWorldHint":false}},{"name":"sandbox_get","title":"Get a sandbox","description":"One sandbox: its state (creating, running, sleeping, deleted), size, image, region, labels and cost so far. Poll it after a sized or docker sandbox_create until state is running.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"Get a sandbox","readOnlyHint":true,"openWorldHint":false}},{"name":"sandbox_exec_status","title":"Check a background command","description":"A command started with sandbox_exec background: true: whether it is running or exited, its exit code, and its output so far (stdout and stderr together).","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"exec_id":{"type":"string","pattern":"^bg_[0-9a-f]{16}$","description":"The background command's id, bg_…, from sandbox_exec with background: true"}},"required":["sandbox_id","exec_id"],"additionalProperties":false},"annotations":{"title":"Check a background command","readOnlyHint":true,"openWorldHint":false}},{"name":"sandbox_exec_stop","title":"Stop a background command","description":"End a command started with sandbox_exec background: true, and what it started (a dev server, a watcher): SIGTERM, then SIGKILL after 5 s. sandbox_exec_status then shows it exited with stopped: true.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"exec_id":{"type":"string","pattern":"^bg_[0-9a-f]{16}$","description":"The background command's id, bg_…, from sandbox_exec with background: true"}},"required":["sandbox_id","exec_id"],"additionalProperties":false},"annotations":{"title":"Stop a background command","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"sandbox_logs","title":"A sandbox's recent commands","description":"The sandbox's last commands (at most 200), each with its exit code and the tail of its output.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"How many (default 200)."}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"A sandbox's recent commands","readOnlyHint":true,"openWorldHint":false}},{"name":"sandbox_metrics","title":"A sandbox's resource use","description":"CPU, memory, disk and network use of a running sandbox, read on its host now.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"A sandbox's resource use","readOnlyHint":true,"openWorldHint":false}},{"name":"file_list","title":"List a folder","description":"List a folder in a sandbox (default /workspace): names, types and sizes. A sleeping sandbox wakes first.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"path":{"type":"string","minLength":1,"maxLength":4096,"description":"The folder (default /workspace)."}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"List a folder","readOnlyHint":true,"openWorldHint":false}},{"name":"file_read","title":"Read a file","description":"Read one file from a sandbox (at most 8 MiB). Text comes back as text; anything else as base64 (encoding: base64). For big or binary files prefer file_link, a download URL that does not pass through your context.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"path":{"type":"string","minLength":1,"maxLength":4096,"description":"An absolute path in the sandbox, e.g. /workspace/app.py"}},"required":["sandbox_id","path"],"additionalProperties":false},"annotations":{"title":"Read a file","readOnlyHint":true,"openWorldHint":false}},{"name":"file_write","title":"Write a file","description":"Create or replace one file in a sandbox with the given text (or base64 bytes). Parent folders must exist (file_mkdir). A sleeping sandbox wakes first.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"path":{"type":"string","minLength":1,"maxLength":4096,"description":"An absolute path in the sandbox, e.g. /workspace/app.py"},"content":{"type":"string","description":"The file's text (UTF-8)."},"content_base64":{"type":"string","description":"The file's bytes, base64. Use this or content."}},"required":["sandbox_id","path"],"additionalProperties":false},"annotations":{"title":"Write a file","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"file_mkdir","title":"Make a folder","description":"Make a folder in a sandbox, with any missing parents.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"path":{"type":"string","minLength":1,"maxLength":4096,"description":"An absolute path in the sandbox, e.g. /workspace/app.py"}},"required":["sandbox_id","path"],"additionalProperties":false},"annotations":{"title":"Make a folder","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"file_delete","title":"Remove a file","description":"Remove a file from a sandbox, or a folder and everything in it with recursive: true. This cannot be undone.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"path":{"type":"string","minLength":1,"maxLength":4096,"description":"An absolute path in the sandbox, e.g. /workspace/app.py"},"recursive":{"type":"boolean","description":"Remove a folder and its contents."}},"required":["sandbox_id","path"],"additionalProperties":false},"annotations":{"title":"Remove a file","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"file_link","title":"A file download or upload URL","description":"A presigned URL for one download (GET, the default) or upload (PUT) of one path, straight to the sandbox's host, no size cap. Hand it to curl or the person; it works once and expires.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"path":{"type":"string","minLength":1,"maxLength":4096,"description":"An absolute path in the sandbox, e.g. /workspace/app.py"},"method":{"type":"string","enum":["GET","PUT"],"description":"GET to download (default), PUT to upload."},"ttl_s":{"type":"integer","minimum":10,"maximum":300,"description":"Seconds the URL stays valid."}},"required":["sandbox_id","path"],"additionalProperties":false},"annotations":{"title":"A file download or upload URL","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"code_run","title":"Run Python in a kernel","description":"Run a Python cell in a stateful kernel in the sandbox: variables, imports and open files persist between calls in the same context. Returns stdout, stderr, the cell's value and any matplotlib charts as images.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"code":{"type":"string","minLength":1,"maxLength":200000,"description":"The Python code to run."},"context":{"type":"string","pattern":"^[a-z0-9-]{1,32}$","description":"A named kernel to keep state apart (default: default)."},"timeout_s":{"type":"number","exclusiveMinimum":0,"maximum":80,"description":"Stop the cell after this many seconds."}},"required":["sandbox_id","code"],"additionalProperties":false},"annotations":{"title":"Run Python in a kernel","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"preview_create","title":"Open a port at an https URL","description":"Give a port in the sandbox its own https URL (on kosa8labs.com), for a web app or API the sandbox serves. Private by default: the URL carries a signed token and expires; public: true makes it open to anyone.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"port":{"type":"integer","minimum":1,"maximum":65535,"description":"The TCP port the app listens on inside the sandbox, e.g. 3000"},"public":{"type":"boolean","description":"Anyone with the URL can open it, no token. Default false."},"expires_in_s":{"type":"integer","minimum":60,"maximum":604800,"description":"How long the private link works."},"wake":{"type":"boolean","description":"A visit wakes the sandbox if it is sleeping."}},"required":["sandbox_id","port"],"additionalProperties":false},"annotations":{"title":"Open a port at an https URL","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"preview_list","title":"List a sandbox's previews","description":"The sandbox's open preview URLs, without their tokens (preview_link makes a new signed link).","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"List a sandbox's previews","readOnlyHint":true,"openWorldHint":false}},{"name":"preview_link","title":"A new link for a private preview","description":"A fresh signed URL for a private preview, e.g. to hand to the person.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"port":{"type":"integer","minimum":1,"maximum":65535,"description":"The TCP port the app listens on inside the sandbox, e.g. 3000"},"expires_in_s":{"type":"integer","minimum":60,"maximum":604800,"description":"How long the link works."}},"required":["sandbox_id","port"],"additionalProperties":false},"annotations":{"title":"A new link for a private preview","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"preview_delete","title":"Close a preview","description":"Close a port's preview URL; links to it stop working.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"port":{"type":"integer","minimum":1,"maximum":65535,"description":"The TCP port the app listens on inside the sandbox, e.g. 3000"}},"required":["sandbox_id","port"],"additionalProperties":false},"annotations":{"title":"Close a preview","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"snapshot_create","title":"Save a sandbox as a snapshot","description":"Save a sandbox (memory, processes and disk) as a snapshot the organization keeps until it is deleted, whatever happens to the sandbox. Start new sandboxes from it with sandbox_create snapshot. Snapshot storage is billed.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"name":{"type":"string","maxLength":64,"description":"A name to find it by."}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"Save a sandbox as a snapshot","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"snapshot_list","title":"List snapshots","description":"The organization's snapshots, newest first, optionally only those of one sandbox.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"Only snapshots taken from this sandbox."}},"additionalProperties":false},"annotations":{"title":"List snapshots","readOnlyHint":true,"openWorldHint":false}},{"name":"snapshot_delete","title":"Delete a snapshot","description":"Delete a snapshot. Sandboxes already started from it keep running. This cannot be undone.","inputSchema":{"type":"object","properties":{"snapshot_id":{"type":"string","pattern":"^snap_[A-Za-z0-9]{8,40}$","description":"The snapshot id, snap_…, from snapshot_create or snapshot_list"}},"required":["snapshot_id"],"additionalProperties":false},"annotations":{"title":"Delete a snapshot","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"checkpoint_create","title":"Checkpoint a sandbox","description":"Save a sandbox's /workspace as a checkpoint, kept with the sandbox, to rewind to later (sandbox_rewind). Take one before a risky change.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"label":{"type":"string","maxLength":200,"description":"What it is, e.g. before upgrade."}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"Checkpoint a sandbox","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"checkpoint_list","title":"List a sandbox's checkpoints","description":"The sandbox's checkpoints, oldest first.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"List a sandbox's checkpoints","readOnlyHint":true,"openWorldHint":false}},{"name":"sandbox_rewind","title":"Rewind a sandbox to a checkpoint","description":"Put a sandbox's /workspace back to a checkpoint. The state before the rewind is kept as a checkpoint too, so it can be undone.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"checkpoint":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,128}$","description":"The checkpoint id from checkpoint_create or checkpoint_list"}},"required":["sandbox_id","checkpoint"],"additionalProperties":false},"annotations":{"title":"Rewind a sandbox to a checkpoint","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false}},{"name":"sandbox_fork","title":"Fork a sandbox","description":"Make n new sandboxes (1 to 100), each a copy of this one as it is now, e.g. to try several approaches in parallel. Each counts toward the account's plan.","inputSchema":{"type":"object","properties":{"sandbox_id":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$","description":"The sandbox id, sbx_…, from sandbox_create or sandbox_list"},"n":{"type":"integer","minimum":1,"maximum":100,"description":"How many copies (default 1)."}},"required":["sandbox_id"],"additionalProperties":false},"annotations":{"title":"Fork a sandbox","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"pipeline_run","title":"Run a repository's pipeline","description":"Run a repository's .kosa8/pipeline.yml (or its .github/workflows through act) in kosa8 Cloud sandboxes. Returns the run (prun_…); follow it with pipeline_get and pipeline_logs.","inputSchema":{"type":"object","properties":{"repo_url":{"type":"string","maxLength":512,"description":"An https clone URL without credentials, e.g. https://github.com/acme/app.git."},"ref":{"type":"string","maxLength":255,"description":"Branch, tag or commit (default main)."},"event":{"type":"string","enum":["push","pull_request","workflow_dispatch","schedule"],"description":"The event to run as (default workflow_dispatch)."},"workflow":{"type":"string","maxLength":128,"description":"A file in .github/workflows to run through act."},"job":{"type":"string","maxLength":64,"description":"Run only this job."},"inputs":{"type":"object","additionalProperties":{"type":"string"},"description":"workflow_dispatch inputs."},"size":{"type":"string","enum":["2x4","4x8","8x16","16x32"],"description":"Each job's sandbox size."},"secrets":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{1,32}$"},"maxItems":32,"description":"Names of the org's secrets (set by the person, never by you) to give the run."},"token_secret":{"type":"string","pattern":"^[a-z0-9-]{1,32}$","description":"Name of the secret holding a token to clone a private repository."},"timeout_s":{"type":"integer","minimum":60,"maximum":21600,"description":"Stop the run after this many seconds."}},"required":["repo_url"],"additionalProperties":false},"annotations":{"title":"Run a repository's pipeline","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"pipeline_list","title":"List pipeline runs","description":"The organization's pipeline runs, newest first.","inputSchema":{"type":"object","properties":{"state":{"type":"string","maxLength":32,"description":"Only runs in this state, e.g. running, succeeded, failed."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many."}},"additionalProperties":false},"annotations":{"title":"List pipeline runs","readOnlyHint":true,"openWorldHint":false}},{"name":"pipeline_get","title":"Get a pipeline run","description":"One pipeline run: its state and each job's state, exit code and timing.","inputSchema":{"type":"object","properties":{"run_id":{"type":"string","pattern":"^prun_[A-Za-z0-9_]{1,60}$","description":"The pipeline run id, prun_…, from pipeline_run or pipeline_list"}},"required":["run_id"],"additionalProperties":false},"annotations":{"title":"Get a pipeline run","readOnlyHint":true,"openWorldHint":false}},{"name":"pipeline_logs","title":"A pipeline run's logs","description":"A run's logs by job, secrets replaced with ***. Pass after (a job's next value from the last call) to get only new lines.","inputSchema":{"type":"object","properties":{"run_id":{"type":"string","pattern":"^prun_[A-Za-z0-9_]{1,60}$","description":"The pipeline run id, prun_…, from pipeline_run or pipeline_list"},"job":{"type":"string","maxLength":64,"description":"Only this job's log."},"after":{"type":"integer","minimum":-1,"description":"Only lines after this sequence number."}},"required":["run_id"],"additionalProperties":false},"annotations":{"title":"A pipeline run's logs","readOnlyHint":true,"openWorldHint":false}},{"name":"pipeline_cancel","title":"Cancel a pipeline run","description":"Stop a pipeline run that is queued or running.","inputSchema":{"type":"object","properties":{"run_id":{"type":"string","pattern":"^prun_[A-Za-z0-9_]{1,60}$","description":"The pipeline run id, prun_…, from pipeline_run or pipeline_list"}},"required":["run_id"],"additionalProperties":false},"annotations":{"title":"Cancel a pipeline run","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}}],"resources":[],"prompts":[]}