cao-worker-protocols

name	cao-worker-protocols
description	Worker-side callback and completion rules for assigned and handed-off tasks in CAO

CAO Worker Protocols

Use this skill when acting as a worker agent inside CLI Agent Orchestrator.

This skill explains how workers should interpret assigned versus handed-off work, when to call send_message, and how to report results back cleanly.

Understand the Dispatch Mode

Workers receive tasks through one of two orchestration modes:

• handoff: blocking work where the orchestrator captures your final output automatically
• assign: non-blocking work where you must actively return results to the requesting terminal

Depending on provider and CAO behavior, a handoff may be made explicit in the task text. For example, Codex workers currently receive a [CAO Handoff] prefix for blocking handoffs. Other providers may rely on the task wording and orchestration context instead.

Rules for Handoff Tasks

When the task is a blocking handoff, complete the work and present the result in your normal response. The orchestrator captures that response automatically.

Do not call send_message for ordinary handoff completion unless the task explicitly asks for additional side-channel communication.

Rules for Assigned Tasks

When the task came through assign, the task message should include a callback terminal ID. After you finish the work:

1. Extract the callback terminal ID from the task message.
2. Format the result clearly and concisely.
3. Call send_message(receiver_id=..., message=...) with the completed result.

Do not stop after writing a normal response if the assignment explicitly requires a callback. The requesting terminal depends on send_message to receive the result.

Assigned tasks may include callback instructions directly in the main message or in an appended suffix such as [Assigned by terminal ...]. Treat that callback terminal ID as authoritative.

Your own CAO_TERMINAL_ID identifies your terminal, not the callback target. Send results to the receiver specified in the task.

Message Formatting

Return results that are easy for the supervisor to merge into a larger workflow:

• Identify what task or dataset the result belongs to
• Include the requested output or deliverable
• Keep the message specific enough to act on without re-reading the whole task

If the task asks for progress updates, use send_message for those updates too. Otherwise prefer one final callback with the completed deliverable.

Filesystem and Reporting Discipline

If the task asks you to create files, write them before reporting completion. When sending results back to a supervisor, include absolute file paths so the supervisor can continue the workflow without ambiguity.

Reliability Guidelines

• Parse the callback terminal ID before you start expensive work.
• If send_message is available and the task requires a callback, call it directly rather than ending with prose alone.
• Keep callback messages structured so the supervisor can merge them into a larger workflow.
• For handoff tasks, return the completed output directly and let the orchestrator handle delivery.