sonamu-tasks

Installation
SKILL.md

Sonamu Tasks

Choose the surface already used by the project:

  • @sonamu-kit/tasks is the standalone queue. The application initializes a BackendPostgres, creates an OpenWorkflow, registers implementations, and starts a worker explicitly.
  • workflow from sonamu is the framework adapter. Sonamu discovers exported metadata from src/application/**/*.workflow.ts, manages the backend and worker, and adds schedules, workflow context, a logger, and step.get/step.define.

A running sonamu dev server reloads a changed framework-managed src/application/**/*.workflow.ts and re-registers its workflows. pnpm sonamu sync performs no workflow action. Outside the dev server, rebuild and restart the API so the compiled workflow modules are reloaded.

Do not import @sonamu-kit/tasks/internal. The package root exports the supported constructors and helpers; let method return types infer handle, workflow, and run types that are not root exports.

Installs
19
First Seen
Sep 18, 2026