Chat Completions

{
  "agent": "backend-dev",
  "messages": [{"role": "user", "content": "Inspect the API"}],
  "polpo": {
    "execution": {
      "allowedTools": ["read", "glob", "grep"]
    }
  }
}

curl -N "https://{project-slug}.polpo.cloud/v1/chat/completions" \
  -H "Authorization: Bearer $POLPO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "backend-dev",
    "loop": "qa-flow",
    "model": "anthropic/claude-sonnet-4-5",
    "sandbox": {
      "isolation": "reuse",
      "volumes": [{"name": "reference", "access": "read-only"}],
      "lifecycle": {"onRelease": "pool", "stopAfterIdleMinutes": 30, "deleteAfterStopMinutes": 60}
    },
    "messages": [
      {"role": "user", "content": "Explain the authentication flow"}
    ],
    "stream": true
  }'

curl "https://{project-slug}.polpo.cloud/v1/chat/completions" \
  -H "Authorization: Bearer $POLPO_API_KEY" \
  -H "x-session-id: sess_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "backend-dev",
    "messages": [{"role": "user", "content": "Continue"}]
  }'

import { PolpoClient } from "@polpo-ai/sdk";

const client = new PolpoClient({
  baseUrl: "https://{project-slug}.polpo.cloud",
  apiKey: process.env.POLPO_API_KEY!,
});

const stream = client.chatCompletionsStream({
  agent: "backend-dev",
  messages: [{ role: "user", content: "Review the auth module" }],
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

console.log(stream.sessionId);

const stream = client.chatCompletionsStream({
  agent: "backend-dev",
  messages: [{ role: "user", content: "Build and test the application" }],
  polpo: { delivery: { onDisconnect: "continue" } },
});

stream.subscribeConnectionState((state) => {
  // streaming | reconnecting | closed
  console.log(state);
});

curl -X POST "https://{project-slug}.polpo.cloud/v1/files/upload" \
  -H "Authorization: Bearer $POLPO_API_KEY" \
  -F "path=reference" \
  -F "file=@report.pdf"

{
  "role": "user",
  "content": [
    {"type": "text", "text": "Read and summarize this report"},
    {"type": "file", "file_id": "reference/report.pdf"}
  ]
}