TypeScript SDK

npm install @polpo-ai/sdk@0.15.35

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

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

const stream = client.chatCompletionsStream({
  agent: "backend-dev",
  loop: "implementation-flow",
  model: "anthropic/claude-sonnet-4-5",
  sandbox: { isolation: "reuse" },
  messages: [{ role: "user", content: "Review the auth module" }],
  metadata: { tenant_id: "tenant_123" },
});

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

console.log(stream.sessionId, stream.aborted);

const response = await client.chatCompletions({
  messages: [{ role: "user", content: "Summarize the project" }],
});
console.log(response.choices[0].message.content);

const { sessions } = await client.getSessions();
const { session, messages } = await client.getSessionMessages(sessions[0].id);
await client.renameSession(session.id, "Architecture review");
await client.deleteSession(session.id);

await client.addAgent({
  name: "qa-engineer",
  role: "Writes and runs tests",
  model: "anthropic/claude-sonnet-4-5",
  allowedTools: ["read", "write", "edit", "bash"],
  sandbox: { isolation: "fresh" },
  assignedLoops: ["qa-flow"],
});

await client.updateAgent("qa-engineer", { reasoning: "high" });
const agent = await client.getAgent("qa-engineer");
const agents = await client.getAgents();
await client.removeAgent("qa-engineer");

const shared = await client.getMemory();
await client.saveMemory("Updated project context");
const agentMemory = await client.getAgentMemory("backend-dev");
await client.saveAgentMemory("backend-dev", "Prefers functional patterns");

await client.saveVaultEntry({
  agent: "emailer",
  service: "smtp",
  type: "smtp",
  credentials: { host: "smtp.example.com", user: "bot", pass: "secret" },
});
const entries = await client.listVaultEntries("emailer");
await client.patchVaultEntry("emailer", "smtp", { credentials: { pass: "rotated" } });
await client.removeVaultEntry("emailer", "smtp");

const { roots } = await client.getFileRoots();
const { path, entries } = await client.listFiles("/src");
const preview = await client.previewFile("/src/index.ts");
const response = await client.readFile("/src/index.ts");
await client.uploadFile("/workspace", file, file.name);
await client.createDirectory("/src/utils");
await client.renameFile("/src/old.ts", "new.ts");
await client.deleteFile("/src/obsolete.ts");
const results = await client.searchFiles("config", "/src", 20);

await client.createSkill({
  name: "code-review",
  description: "Reviews changes for correctness",
  content: "Review behavior, tests, and error handling.",
  allowedTools: ["read", "grep"],
});

await client.installSkills("github:acme/polpo-skills", {
  skillNames: ["testing"],
  force: false,
});
await client.assignSkill("code-review", "backend-dev");
await client.unassignSkill("code-review", "backend-dev");
await client.deleteSkill("code-review");

await client.createSchedule({
  missionId: "mission_abc123",
  expression: "0 2 * * *",
  recurring: true,
});
await client.updateSchedule("mission_abc123", { enabled: false });
await client.deleteSchedule("mission_abc123");

await client.createPlaybook({
  name: "onboard-repo",
  description: "Analyze a repository",
  mission: {
    tasks: [{ title: "Scan", description: "Map the repository", assignTo: "analyst" }],
  },
});
await client.deletePlaybook("onboard-repo");

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

try {
  await client.getAgent("missing");
} catch (error) {
  if (error instanceof PolpoApiError) {
    console.error(error.code, error.statusCode, error.message);
  }
}