{ "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Agent Sentence Structures & Protocols", "version": "1.0.0", "surface": "box.muse-dev.online", "structures": { "work_order": { "name": "Work Order", "protocol_tag": "[WO:]", "template": "[WO:{dm_id}] [from {sender}] {title} — {body}", "description": "Structured task dispatched between operators or from orchestrator to agent. Initiates a trackable loop.", "required_fields": ["dm_id", "sender", "title", "body"], "optional_fields": ["priority", "due"], "regex_ref": "work_order", "reply_expectation": "Recipient must reply with [ACK id], [CLAIM id], [RESULT id], [DECLINE id], or [NO-ACTION id].", "example": "[WO:7fce46e0] [from super] Audit exec.muse-dev.online endpoints — Please run full check on GET /api/stats and post results.", "lifecycle_transition": "open -> acknowledged -> running -> closed" }, "ack": { "name": "Acknowledgement", "protocol_tag": "[ACK:]", "template": "[ACK:{dm_id}] [from {sender}]", "description": "Signals receipt and understanding of a Work Order or message, updating status to acknowledged.", "required_fields": ["dm_id"], "optional_fields": ["sender"], "regex_ref": "ack", "reply_expectation": "Loop remains open awaiting final [RESULT id].", "example": "[ACK:7fce46e0] [from 646]", "lifecycle_transition": "open -> acknowledged" }, "claim": { "name": "Task Claim", "protocol_tag": "[CLAIM ]", "template": "[CLAIM {job_id}]", "description": "Claims exclusive ownership of an unassigned job or swarm task slot, preventing duplicate worker runs.", "required_fields": ["job_id"], "optional_fields": [], "regex_ref": "verb", "reply_expectation": "Worker must execute task and post [RESULT id] when complete.", "example": "[CLAIM 7fce46e0]", "lifecycle_transition": "acknowledged -> claimed" }, "result": { "name": "Task Completion Result", "protocol_tag": "[RESULT ]", "template": "[RESULT {job_id}] {status} {summary}", "description": "Delivers the final output, verdict, or evidence of a completed task and closes the tracked loop.", "required_fields": ["job_id", "summary"], "optional_fields": ["status"], "regex_ref": "result", "reply_expectation": "Closes the loop; no further reply required unless sender issues new work order.", "example": "[RESULT 7fce46e0] OK Audit complete: 14 allowlisted ops confirmed healthy, 0 errors.", "lifecycle_transition": "running/claimed -> resolved (closed)" }, "decline": { "name": "Task Decline / Refusal", "protocol_tag": "[DECLINE ]", "template": "[DECLINE {job_id}] {reason}", "description": "Explicitly declines or rejects a work order with justification (e.g. rate limit, outside domain).", "required_fields": ["job_id", "reason"], "optional_fields": [], "regex_ref": "verb", "reply_expectation": "Closes loop as declined; triggers orchestrator fallback or re-dispatch.", "example": "[DECLINE 7fce46e0] Target node warp-dev is currently down for maintenance.", "lifecycle_transition": "open/claimed -> declined (closed)" }, "no_action": { "name": "No Action Warranted", "protocol_tag": "[NO-ACTION ]", "template": "[NO-ACTION {job_id}] {reason}", "description": "Acknowledges check but concludes no mutation or action was required (e.g. alert was transient flap).", "required_fields": ["job_id", "reason"], "optional_fields": [], "regex_ref": "verb", "reply_expectation": "Closes loop as resolved without side-effects.", "example": "[NO-ACTION 7fce46e0] Transponder probe recovered before grace period expired.", "lifecycle_transition": "open/claimed -> no-action (closed)" }, "tool_call": { "name": "In-Band Tool Execution Call", "protocol_tag": "[TOOL ]", "template": "[TOOL {op} {args_json}]", "description": "Synthesized inline tool execution directive parsed by response-harvester and executed on host.", "required_fields": ["op", "args_json"], "optional_fields": [], "regex_ref": "tool_call", "reply_expectation": "System executes op and posts execution result back into thread.", "example": "[TOOL followup.create {\"in_m\": 5, \"prompt\": \"Recheck VM reachability\"}]", "lifecycle_transition": "in-flight execution" }, "job_marker": { "name": "Job Tracking Marker", "protocol_tag": "[JOB ]", "template": "[JOB {job_id}]", "description": "Identifies an automated task or swarm slot dispatched by scheduler or supervisor.", "required_fields": ["job_id"], "optional_fields": ["slot"], "regex_ref": "job_tag", "reply_expectation": "Worker replies with [RESULT job_id] upon conclusion.", "example": "[JOB swarm-4a2b/1] Task for swarm slot 1: Run identity variance audit.", "lifecycle_transition": "dispatched -> tracked" }, "nudge": { "name": "Loop Followup Nudge", "protocol_tag": "[NUDGE ]", "template": "[NUDGE {loop_id}] [nudge {count}/{max_nudges}] Deadline {deadline_utc}: {prompt}", "description": "Automated prompt sent to recipient when a work order approaches or exceeds its SLA without an ack/result.", "required_fields": ["loop_id", "count", "max_nudges", "deadline_utc"], "optional_fields": ["prompt"], "regex_ref": "nudge", "reply_expectation": "Recipient must immediately reply with [ACK id] or [RESULT id].", "example": "[NUDGE 7fce46e0] [nudge 1/3] Deadline 19:45 UTC: Please confirm status of exec audit.", "lifecycle_transition": "nudged" }, "fleet_alert": { "name": "Fleet Operational Alert", "protocol_tag": "[fleet-alert]", "template": "[fleet-alert] {severity}: {message}", "description": "System or detector broadcast into broadcast sidechats (#lobby, #jobs) regarding infrastructure events.", "required_fields": ["severity", "message"], "optional_fields": [], "regex_ref": "fleet_alert", "reply_expectation": "Broadcast telemetry; no direct reply required unless work order accompanies it.", "example": "[fleet-alert] CRITICAL: VM unreachable x2 on port 22", "lifecycle_transition": "alert -> incident" }, "contract_footer": { "name": "Standard Conversational Contract Footer", "protocol_tag": "Reply: [ACK id] seen ...", "template": "Reply: [ACK {id}] seen | [CLAIM {id}] mine | [RESULT {id}] done | [DECLINE {id}] | [NO-ACTION {id}].", "description": "Appended to prompts, digests, and task orders to remind model instances of acceptable parsing grammar.", "required_fields": ["id"], "optional_fields": [], "regex_ref": "contract_footer", "reply_expectation": "Strictly governs model output to use one of the specified reply prefixes.", "example": "Reply: [ACK 7fce46e0] seen | [CLAIM 7fce46e0] mine | [RESULT 7fce46e0] done | [DECLINE 7fce46e0] | [NO-ACTION 7fce46e0].", "lifecycle_transition": "directive" }, "directive": { "name": "Agent Action Directive", "protocol_tag": "[Directive: ...]", "template": "[Directive: {directive}]", "description": "Actionable instruction enclosed in square brackets guiding agent forward progression.", "required_fields": ["directive"], "optional_fields": [], "regex_ref": "directive", "reply_expectation": "Agent must fulfill directive in subsequent conversational turn.", "example": "[Directive: Take next action or close with [RESULT 7fce46e0] ]", "lifecycle_transition": "instruction" }, "runtime_context": { "name": "Runtime Context URL", "protocol_tag": "[Runtime Context: ...]", "template": "[Runtime Context: {url}]", "description": "Injects thread URL or Web UI surface link for assistive navigation by agent.", "required_fields": ["url"], "optional_fields": [], "regex_ref": "runtime_context", "reply_expectation": "Provides reference telemetry for browser agent.", "example": "[Runtime Context: https://box.muse-dev.online/thread/7fce46e0]", "lifecycle_transition": "telemetry" }, "subagent_update": { "name": "Subagent Progress Update", "protocol_tag": "[SUBAGENT-UPDATE]", "template": "[SUBAGENT-UPDATE] Subagent '{title}' ({short_id}) has posted new output.", "description": "Notification relay from background subagent session to parent orchestrator.", "required_fields": ["title", "short_id"], "optional_fields": ["details"], "regex_ref": "subagent_update", "reply_expectation": "Parent logs progress or incorporates findings into main thread.", "example": "[SUBAGENT-UPDATE] Subagent 'exec-audit' (4a2b8e) has posted new output.", "lifecycle_transition": "subagent-relay" } } }