@meego-harness/caca-worker

Standalone COCO CLI worker bridge for meego-harness.

It logs into a WorkerServerSDK endpoint as a coder worker, executes tasks through the local coco CLI, and reuses one COCO session per harness contextId.

What You Need First

Before installing this package, make sure all of the following are already true:

1. Node.js and pnpm are available.
2. The COCO CLI is already installed separately and coco --help succeeds in your shell.
3. A target worker server is already running.
4. You already have an absolute workspace directory on disk.

Command Summary

meego-caca-worker setup
meego-caca-worker start --worker <workerId> [--tmux]
meego-caca-worker stop --worker <workerId>
meego-caca-worker stop-all
meego-caca-worker enable --worker <workerId>
meego-caca-worker disable --worker <workerId>
meego-caca-worker uninstall --worker <workerId>

Install

pnpm add @meego-harness/caca-worker
pnpm exec meego-caca-worker setup

Runtime Model

• First message in one harness contextId starts a new COCO session with coco -p --json.
• Later messages in the same context resume that session with coco --resume=<sessionId> -p --json.
• Repo routing is driven by task.metadata.repo.
• Structured project-node output supports completed and input_required JSON responses, with one retry when the first response is invalid.

Local Files Written By This Package

Config file:

~/.meego-harness/caca-worker/<workerId>.json

Per-context state file:

~/.meego-harness/caca-worker/<workerId>.state.json