Clawhub Select

What will you take on? (describe your tasks)
> {user types their tasks}
What are you asking {peer_alias} to do?
> {user types peer's tasks}
What's the deadline? (e.g. "Friday 5pm" or "2026-03-27 17:00")
> {user types deadline}
Check-in time? (optional — leave blank to use the deadline)
> {user types or presses Enter}

4. Confirm before sending:

Here's what you're proposing to {peer_alias}:
  You'll do: {my_tasks_formatted}
  They'll do: {peer_tasks_formatted}
  Deadline: {deadline_local}
  {check_in_line_if_set}
Send this proposal? (yes / no)

5. On yes: generate session_id (UUID4), build and send encrypted PROPOSE message, write PROPOSED to ledger.json, append to memory/YYYY-MM-DD.md 6. Show: Proposal sent to {peer_alias}. Waiting for their response... (I'll let you know when they reply. This session will stay open for {timeout_hours} hours.)

Relay unreachable during send:

Couldn't reach the relay right now. Your proposal has been saved and I'll retry the next time you open your agent.
To retry now: /claw-diplomat propose {peer_alias}

Flow D: Handle Counter-Proposal

When a counter arrives: 1. Decode, sanitize ALL string fields (strip Unicode direction overrides, strip control characters, validate length) 2. Show to human:

↩️  {peer_alias} has a counter-proposal:
  They'll do: {peer_new_my_tasks}
  You'll do: {peer_new_your_tasks}
  Deadline: {peer_new_deadline_local}
  (Changes from your original: {diff_summary})
What do you want to do?
  [accept]  — Agree to these terms
  [counter] — Propose different terms
  [reject]  — Decline and end the negotiation

3. Human chooses — never auto-accept. Increment terms_version in ledger on each round.

When the user counters:

What changes do you want to make?
Your tasks (currently: {current_my_tasks}):
> {user types or presses Enter to keep}
Their tasks (currently: {current_peer_tasks}):
> {user types or presses Enter to keep}
Deadline (currently: {current_deadline_local}):
> {user types or presses Enter to keep}
Sending counter-proposal to {peer_alias}...

Flow E: Commit Sequence (Both Sides ACCEPTED)

1. Both sides send ACCEPT with terms_version and terms_hash = sha256(json.dumps(sorted(final_terms), sort_keys=True)) 2. Verify received ACCEPT references same terms_version and identical terms_hash — on mismatch abort per DATA_FLOWS.md F10 3. Write MEMORY.md compact entry (atomic — temp file + rename): - Format: - [ACTIVE] Peer: {alias} | My: {my_tasks_500chars} | Their: {peer_tasks} | Due: {deadline_utc} | ID: \{session_id_short}\` - Max 500 characters per entry; check 20-entry limit first 4. Write extended entry to memory/YYYY-MM-DD.md 5. Exchange COMMIT_ACK { memory_hash: sha256(entry_written) }; verify peer's hash matches 6. Update ledger.json: state=COMMITTED, memory_hash, peer_memory_hash, committed_at 7. Show to both sides:

✅ Deal locked in with {peer_alias}.
  You'll do: {my_tasks_formatted}
  They'll do: {peer_tasks_formatted}
  Deadline: {deadline_local}
I've logged this in your memory. I'll remind you before the deadline.

MEMORY.md write failure:

⚠️ I accepted the deal but couldn't write it to your memory.
Error: {error_message}
Please check your disk space and file permissions, then run:
/claw-diplomat retry-commit {session_id_short}
Your commitment is safely recorded in the skill's ledger (ledger.json) until this is resolved.

20-entry limit reached:

You already have 20 active commitments logged. Complete or cancel one before taking on another.
To see your current commitments: /claw-diplomat status

Flow F: Check-In (/claw-diplomat checkin done|overdue|partial)

1. Find session in MEMORY.md by session_id_short; find full record in ledger.json 2. Update MEMORY.md in-place (atomic): replace [ACTIVE] with [DONE] / [OVERDUE] / [PARTIAL] 3. Append to memory/YYYY-MM-DD.md: {ts} — {session_id_short}: {STATUS} (reported by self) 4. Update ledger.json: state = STATUS, checkin_at_actual = now() 5. Notify peer via encrypted CHECKIN message if connected 6. Show result:

Done:

✅ Marked complete. {peer_alias}'s agent has been notified.
Great work.

Partial:

Noted. I've logged this as partially complete.
Want to renegotiate the remaining tasks with {peer_alias}? (yes / no)

Overdue (no renegotiation):

Logged as overdue. {peer_alias}'s agent has been notified.
You can renegotiate when you're ready: /claw-diplomat propose {peer_alias}

Overdue (with new deadline — only if human explicitly requested):

Logged as overdue. Opening a renegotiation with {peer_alias}...

Receiving an Inbound Proposal (Surfaced by Heartbeat Hook)

When the diplomat-heartbeat hook surfaces an INBOUND_PENDING session, show:

📨 {peer_alias} is proposing a deal:
  They'll do: {peer_my_tasks}
  You'll do: {peer_your_tasks}
  Deadline: {deadline_local}
  {check_in_line_if_set}
What do you want to do?
  [accept]  — Agree to these terms
  [counter] — Propose different terms
  [reject]  — Decline this proposal

Unknown peer:

📨 An agent you haven't connected with before wants to negotiate.
  Agent key: {pubkey_short} (from {peer_ip})
  They're proposing:
  They'll do: {peer_my_tasks}
  You'll do: {peer_your_tasks}
  Deadline: {deadline_local}
Do you want to accept this peer and consider their proposal?
  [yes] — Add them as a trusted peer named "{suggested_alias}" and see the full proposal
  [no]  — Decline and close the connection

Peer Events (Shown to Responder's Side)

Peer missed check-in alert:

⚠️ {peer_alias} missed their check-in.
  Their tasks: {peer_tasks_summary}
  Was due: {deadline_local}
They haven't reported their status yet. You can:
  • Wait — they may just be running late
  • Renegotiate: /claw-diplomat propose {peer_alias}
  • Log it officially: /claw-diplomat checkin {session_id_short} overdue

Peer went offline mid-negotiation:

Lost connection to {peer_alias} mid-negotiation. No deal was recorded.
Your last proposed terms are saved. I'll try to reconnect the next time you open your agent.

Status and List Displays

/claw-diplomat peers:

Your connected peers:
  {peer_alias_1}  ·  last seen {relative_time_1}  ·  {connection_status_1}
  {peer_alias_2}  ·  last seen {relative_time_2}  ·  {connection_status_2}
{n} peer{s} total. To add a new peer: /claw-diplomat connect 

No peers:

You haven't connected with anyone yet.
Share your address to get started: /claw-diplomat generate-address

/claw-diplomat status:

claw-diplomat status:
Active commitments ({n}):
  {per_commitment_one_liner}
Pending proposals ({n}):
  {per_proposal_one_liner}
Overdue ({n}):
  {per_overdue_one_liner}
{nothing_to_show_message_if_all_zero}

Nothing active:

All clear — no active commitments or pending proposals.

Security Rules (Non-Negotiable)

Tone and Language

Append this exactly once to HEARTBEAT.md during install (idempotent — check for ## Diplomat Deadline Check before writing):

Diplomat Deadline Check
On every heartbeat: scan ## Diplomat Commitments in MEMORY.md. For any entry marked [ACTIVE] where the Due date has passed, reply with the alias and ID. For any entry where Due is within 2 hours, flag as upcoming.

Installation Validation

After install, verify: 1. diplomat.key exists and has mode 0600 2. diplomat.pub exists and has mode 0644 3. peers.json contains {"peers":[]} 4. ledger.json contains {"sessions":[]} 5. HEARTBEAT.md contains exactly one ## Diplomat Deadline Check block 6. listener.py is running (check listener.pid) 7. Relay is reachable: GET https://claw-diplomat-relay-production.up.railway.app/myip` returns 200

*claw-diplomat v1.0.0 — Your agent. Their agent. One deal.*