React SDK

npm install @polpo-ai/sdk@0.15.35 @polpo-ai/react@0.15.35

import { PolpoProvider } from "@polpo-ai/react";

export function App() {
  return (
    <PolpoProvider baseUrl="/api/polpo" autoConnect={false}>
      <Dashboard />
    </PolpoProvider>
  );
}

const {
  messages, sendMessage, sendToolResult,
  sessionId, setSessionId, newSession,
  status, error, isStreaming, pendingToolCall, abort,
} = useChat({
  agent: "backend-dev",
  loop: "implementation-flow",
  onFinish: (text) => console.log(text),
  onSessionCreated: (id) => console.log(id),
  onAskUser: (payload) => showQuestions(payload),
  onToolCall: (call) => console.log(call),
});

await sendMessage("Review the handler");
await sendMessage([
  { type: "text", text: "Analyze this file" },
  { type: "file", file_id: "/workspace/report.pdf" },
]);
await setSessionId(null);

const { tasks, createTask, deleteTask, retryTask, refetch } = useTasks();
const { task } = useTask("task_123");
const { missions, createMission, deleteMission } = useMissions();
const { agents, addAgent, updateAgent, removeAgent } = useAgents();
const { processes } = useProcesses();
const { memory, save } = useMemory();
const { memory: agentMemory, save: saveAgentMemory } = useAgentMemory("backend-dev");

const {
  mission, report, executeMission, resumeMission, abortMission,
  createTask, updateTask, deleteTask, reorderTasks,
  addCheckpoint, updateCheckpoint, removeCheckpoint,
  addQualityGate, updateQualityGate, removeQualityGate,
  addTeamMember, updateTeamMember, removeTeamMember,
  updateNotifications,
} = useMission("mission_123");

const {
  sessions, activeSessionId, setActiveSessionId,
  getMessages, renameSession, deleteSession, refetch,
} = useSessions();

const {
  roots, entries, listFiles, previewFile, readFile,
  uploadFile, createDirectory, renameFile, deleteFile, searchFiles,
} = useFiles("/src");

await uploadFile("/workspace", file, file.name);

const {
  skills, createSkill, installSkills, deleteSkill,
  assignSkill, unassignSkill,
} = useSkills();

await createSkill({
  name: "code-review",
  description: "Reviews changes",
  content: "Check correctness and tests.",
});
await installSkills("github:acme/polpo-skills", { skillNames: ["testing"] });

const { schedules, createSchedule, updateSchedule, deleteSchedule } = useSchedules();
await createSchedule({ missionId: "mission_123", expression: "0 2 * * *", recurring: true });
await updateSchedule("mission_123", { enabled: false });
await deleteSchedule("mission_123");

const { playbooks, loading, createPlaybook, deletePlaybook } = usePlaybooks();
await createPlaybook({
  name: "repo-scan",
  description: "Scan a repository",
  mission: { tasks: [{ title: "Scan", description: "Map the code", assignTo: "analyst" }] },
});

const { entries, saveEntry, patchEntry, removeEntry } = useVaultEntries("emailer");
await saveEntry({
  agent: "emailer",
  service: "smtp",
  type: "smtp",
  credentials: { host: "smtp.example.com", user: "bot", pass: "secret" },
});
await patchEntry("emailer", "smtp", { credentials: { pass: "rotated" } });
await removeEntry("emailer", "smtp");

const {
  activeDelays, fetchedDelays, loading, refetch,
  addDelay, updateDelay, removeDelay,
} = useActiveDelays();

await addDelay("mission_123", {
  name: "Wait for data",
  afterTasks: ["Collect data"],
  blocksTasks: ["Analyze data"],
  duration: "PT1H",
});

const { client, connectionStatus } = usePolpo();