Declarative builder

import { Platinum, Template } from "@platinum-dev/sdk";

const client = new Platinum({ url: process.env.PT_API_URL!, token: process.env.PT_TOKEN! });

const tpl = await Template
  .fromPythonImage("3.13-slim")
  .pipInstall(["pandas", "fastapi", "uvicorn"])
  .aptInstall(["curl", "ripgrep"])
  .env("LOG_LEVEL", "info")
  .workdir("/app")
  .copy("app.py", "/app/app.py")
  .entrypoint("uvicorn app:app --host 0.0.0.0 --port 8000")
  .build(client, { name: "my-agent", default_ram_mb: 1024 });

if (tpl.state === "failed") throw new Error(tpl.build_logs);

import os
from platinum import Platinum, Template

client = Platinum(token=os.environ["PT_TOKEN"], api_url=os.environ["PT_API_URL"])

tpl = (Template.from_python_image("3.13-slim")
       .pip_install(["pandas", "fastapi", "uvicorn"])
       .apt_install(["curl", "ripgrep"])
       .env("LOG_LEVEL", "info")
       .workdir("/app")
       .copy("app.py", "/app/app.py")
       .entrypoint("uvicorn app:app --host 0.0.0.0 --port 8000")
       .build(client, "my-agent", default_ram_mb=1024))

if tpl["state"] == "failed":
    raise RuntimeError(tpl["build_logs"])

# No dedicated CLI command for from-spec builds. Use the API passthrough.
pt api POST /v1/templates/from-spec -d @spec.json

curl -X POST $PT_API_URL/v1/templates/from-spec \
  -H "Authorization: Bearer $PT_TOKEN" \
  -d '{
    "name": "my-agent",
    "base_image": "python:3.13-slim",
    "steps": [
      { "op": "pip",     "packages": ["pandas", "fastapi", "uvicorn"] },
      { "op": "apt",     "packages": ["curl", "ripgrep"] },
      { "op": "env",     "key": "LOG_LEVEL", "value": "info" },
      { "op": "workdir", "path": "/app" }
    ],
    "entrypoint": "uvicorn app:app --host 0.0.0.0 --port 8000",
    "default_ram_mb": 1024
  }'

const image = Template.fromImage("alpine:3.20").runCmd("apk add --no-cache curl jq");
const sbx = await client.sandboxes.create(
  { image, env: { GREETING: "hi" } },
  { waitForRunning: true, waitTimeoutMs: 600_000 },
);

image = Template.from_image("alpine:3.20").run_cmd("apk add --no-cache curl jq")
sbx = client.sandboxes.create(image=image, env={"GREETING": "hi"},
                              wait_for_running=True, wait_timeout_ms=600_000)

# No CLI flag for an inline image spec. Use the API passthrough.
pt api POST /v1/sandboxes --query "wait_for_state=running" -d @body.json

curl -X POST "$PT_API_URL/v1/sandboxes?wait_for_state=running&wait_timeout_ms=60000" \
  -H "Authorization: Bearer $PT_TOKEN" \
  -d '{
    "image": {
      "base_image": "alpine:3.20",
      "steps": [{ "op": "run", "cmd": "apk add --no-cache curl jq" }],
      "size_mb": 256
    }
  }'