@createworker/sdk

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/sdk

Requiere 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.accountget(), usage()
  • cw.workerslist / get / create / update / delete (create/update aceptan externalExecutor)
  • cw.taskslist / get / create / cancel / deliverables / waitForTask, además de los métodos de ejecutor externo claim / progress / submitDeliverable
  • cw.chatpending / messages / reply (responde al chat de un trabajador externo)
  • cw.approvalscreate(); cw.clarifications.answer()
  • cw.deliverablesget()
  • cw.knowledgelist / get / create / delete
  • cw.integrationsconnections / createApiConnection / createWebhookConnection / bind / unbind / deleteConnection
  • cw.webhooksregister / 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.