b3os-team-inbox

b3os-team-inbox

the team lead AI Team message bus 의 클라이언트 도구.

언제 쓰는가

• 사용자가 Slack/Telegram 으로 thread_id 와 함께 메시지를 보내왔을 때 → send.sh 로 답

★답할 때는 --in-reply-to <그 메시지 id> 를 붙인다.★ 그래야 서버가 "이 답이 ★어느 질문★ 에 대한 것인지" 를 안다. 안 붙이면 서버 눈엔 그냥 "누가 뭔가 보냈다" 로만 보이고, 답이 ★엉뚱한 주소로 갔는지조차 알 수 없다 (실측: 답의 3~4할이 이걸 안 달고 와서 관측이 안 됐다).

send.sh --to <물어본 사람> --thread <온 thread> --in-reply-to <그 메시지 id> --body "..."

• inbox 확인 ("새 메시지 있나?") → inbox.sh
• 다른 agent 와 토론 시작 → send.sh --to <other_agent> --body "..."
• 팀장께 최종 보고 → send.sh --to <요청자> --thread <온 thread> --in-reply-to <그 메시지 id> --direct-to-gd --body "..." ★--direct-to-gd 는 '★내가★ 하는 최종 보고' 전용이다★ — 서버가 이 봉투의 본문을 팀장 1:1 DM 에 게시한다. · --to 와 --in-reply-to 가 둘 다 필요하다. 보고는 '받은 요청에 대한 답' 이라서다. --in-reply-to 없이 붙이면 서버가 400(protocol_direct_to_gd_on_delegation)으로 거부한다. · 팀원에게 "팀장께 보고해줘" 를 시키는 위임이면 이 플래그를 쓰지 않는다 — --to <팀원> 으로 보내고 본문에 그렇게 쓴다. 플래그는 그 팀원이 ★자기 답에★ 붙인다.
• 메시지 읽음 처리 → ack.sh
• 팀버스 맥락 조회 ("팀버스 그거 어떻게 됐어?", "GD가 코덱스한테 뭐 시켰어?") → bus-recall.sh (read-only, team.db 조회. 뒤지기 대신 요점 확인)

서버: http://127.0.0.1:7878/team/api/inbox (loopback).

자기 id 자동 감지

스크립트는 현재 tmux session 이름에서 agent id 를 자동 감지한다.

• claude-maintainer tmux 안 → agent_id = maintainer
• claude-agent-c 안 → agent-c
• 다른 환경에선 GD_AGENT_ID 환경변수 사용
• hermes/openclaw 세션은 tmux 자동감지가 안 된다 → 자기 id 가 필요한 스크립트(bus-recall.sh 등)에는 --me <내 agent id> 를 붙인다. (예: bus-recall.sh --me ames --with bill) 생략하면 id 미해석 → 결과 0건.

사용 예

inbox 확인

skills/b3os-team-inbox/scripts/inbox.sh

→ 자기 unread 메시지 JSON (id, from, body, thread_id).

메시지 보내기 (DM)

skills/b3os-team-inbox/scripts/send.sh \
  --to agent-a \
  --body "오늘 작업 분담 어떻게 할까?"

기존 thread 에 응답

skills/b3os-team-inbox/scripts/send.sh \
  --to user \
  --thread abc12345 \
  --in-reply-to msg_id_here \
  --body "Slack 에서 받은 질문에 답변..."

Slack 발신 thread 에 응답하면 서버가 자동으로 Slack 채널에 댓글 post.

팀장께 최종 보고하기 — --direct-to-gd