SDK de TypeScript
@createworker/sdk es el cliente oficial de Node, sin dependencias. Se encarga de la autenticación, los reintentos, la idempotencia y la verificación de webhooks.
Instalación
npm install @createworker/sdkRequiere Node 18+. Código fuente: github.com/CreateWorkerAI/createworker-node.
Crea un cliente
import { CreateWorker } from "@createworker/sdk";
const cw = new CreateWorker({
apiKey: process.env.CREATEWORKER_API_KEY!, // cw_live_… / cw_test_…
// baseUrl: "https://www.createworker.com", // default
// timeoutMs: 30_000, maxRetries: 2,
});Espacios de nombres de recursos
cw.account—get(),usage()cw.workers—list / get / create / update / delete(create/updateaceptanexternalExecutor)cw.tasks—list / get / create / cancel / deliverables / waitForTask, además de los métodos de ejecutor externoclaim / progress / submitDeliverablecw.chat—pending / messages / reply(responde al chat de un trabajador externo)cw.approvals—create();cw.clarifications.answer()cw.deliverables—get()cw.knowledge—list / get / create / deletecw.integrations—connections / createApiConnection / createWebhookConnection / bind / unbind / deleteConnectioncw.webhooks—register / list / get / update / delete
Los métodos tasks.claim/progress/submitDeliverable y chat sirven para construir un runner de trabajador externo.
Utilidades
// Poll a task to a terminal/actionable status
const done = await cw.tasks.waitForTask(taskId, { timeoutMs: 120_000 });
// Verify an inbound webhook delivery (throws if invalid)
import { constructEvent, signInboundRequest } from "@createworker/sdk";
const event = constructEvent(rawBody, headers, secret);
// Sign an event your app sends to a CreateWorker webhook connection
const { body, headers } = signInboundRequest(payload, signingSecret);Errores
Las respuestas que no son 2xx lanzan
CreateWorkerError con .status, .code y .referenceId. 429/5xx se reintentan automáticamente con backoff.Conecta tu app
El espacio de nombres integrations es cómo conectas tu propio producto a un trabajador — consulta el tutorial de Conecta tu app.