React SDK

npm install @polpo-ai/react

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

function App() {
  return (
    <PolpoProvider
      baseUrl="http://localhost:3000"
      projectId="my-project"
      apiKey="optional-key"
    >
      <MyApp />
    </PolpoProvider>
  );
}

const { client, connectionStatus } = usePolpo();

const { tasks, isLoading, error, createTask, deleteTask, retryTask, refetch } = useTasks();

const { task, isLoading, error, updateTask, deleteTask, killTask, reassessTask, retryTask } = useTask("task-1");

const { missions, isLoading, createMission, updateMission, executeMission, resumeMission, abortMission, deleteMission, refetch } = useMissions();

const { mission, report, isLoading, error, updateMission, executeMission, resumeMission, abortMission, deleteMission } = useMission("mission-1");

const { agents, team, isLoading, addAgent, removeAgent, renameTeam, refetch } = useAgents();

const { agent, isLoading, error, refetch } = useAgent("backend-dev");

const { processes, isLoading, error, refetch } = useProcesses();

const { events } = useEvents(["task:*", "assessment:*"], 100);

const stats = useStats();
// stats: { pending, running, done, failed, queued } | null

const { memory, isLoading, saveMemory, refetch } = useMemory();

const { skills, isLoading, error, refetch } = useSkills();

const { notifications, stats, sendNotification, loading, refetch } = useNotifications({
  limit: 50,
  status: "sent",
  channel: "slack",
});

const { approvals, pending, approve, reject, loading, refetch } = useApprovals();

const { playbooks, loading, getPlaybook, runPlaybook, refetch } = usePlaybooks();

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

const { entries, isLoading, error, refetch } = useTaskActivity("task-1");

// With auto-polling
const { entries } = useTaskActivity("task-1", { pollIntervalMs: 5000 });

const { authStatus, isLoading, error, refetch } = useAuthStatus();

const { sessions, isLoading, getLogEntries, refetch } = useLogs();

// Full import (hooks + re-exported client types)
import { PolpoProvider, useTasks, useMissions } from "@polpo-ai/react";
import type { Task, Mission } from "@polpo-ai/react";

// Individual hook imports
import { useTasks } from "@polpo-ai/react/hooks/use-tasks";

// Use the client SDK directly for non-React code
import { PolpoClient } from "@polpo-ai/client";