@createworker/sdk

TypeScript-SDK

@createworker/sdk is de officiële Node-client zonder dependencies. Hij regelt authenticatie, retries, idempotentie en webhook-verificatie.

Installatie

npm install @createworker/sdk

Vereist Node 18+. Broncode: github.com/CreateWorkerAI/createworker-node.

Maak een client

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,
});

Resource-namespaces

  • cw.accountget(), usage()
  • cw.workerslist / get / create / update / delete (create/update accepteren externalExecutor)
  • cw.taskslist / get / create / cancel / deliverables / waitForTask, plus de methoden voor de externe runner claim / progress / submitDeliverable
  • cw.chatpending / messages / reply (beantwoord de chat van een externe werknemer)
  • 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

De methoden tasks.claim/progress/submitDeliverable en chat zijn bedoeld voor het bouwen van een runner voor een externe werknemer.

Hulpmiddelen

// 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);

Fouten

Non-2xx-responses gooien CreateWorkerError met .status, .code en .referenceId. 429/5xx worden automatisch opnieuw geprobeerd met backoff.

Koppel je app

De namespace integrations is hoe je je eigen product koppelt aan een werknemer — zie de tutorial Koppel je app.