docs: document the V2 routed delegation bridge

[yansigit]

Summary

• Document the experimental v2RoutedDelegationBridge configuration field and its safety exclusions.
• Update the /api/v2 endpoint matrix to include the bridge toggle.

Verification

• git diff --check
• Documentation changes are limited to the English reference pages and are stacked on the core bridge PR.

Checklist

• Scope stays focused and avoids unrelated cleanup.
• Docs or release notes were updated when needed.
• Security-sensitive changes were reviewed for secrets, auth, and unsafe defaults; documentation describes the opt-in default and fail-closed behavior.

Review readiness checklist

This PR stays in draft until every box below is ticked. Tick all four boxes once the requirements are met:

• All CI tests are green on my local testing.

• I pushed my PR to the latest dev commit.

• I resolved all correct Codex and CodeRabbit findings.

• My PR is ready for review.

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

✅ Deterministic PR hygiene checks passed.

[github-actions]

⏳ DRAFT

• review readiness checklist open (3/4 boxes ticked).

What to do

• Tick all four boxes in the PR description once you're done (currently 3/4).

Review readiness checklist

• ✅ All CI tests are green on my local testing.
• ⬜ I pushed my PR to the latest dev commit.
• ✅ I resolved all correct Codex and CodeRabbit findings.
• ✅ My PR is ready for review.

3/4 boxes ticked.

This PR stays in draft until every box above is ticked.

[Ingwannu]

This describes the still-unmerged #4242 API/config contract. Please add an explicit Depends on #4242 link and keep the documentation from landing before the core behavior is accepted. The current GitHub base is dev, not #4242's head branch, so the description's 'stacked' wording does not currently express that dependency in the PR target. Keeping both Draft pending core review is appropriate; this is a sequencing note, not approval of the new delegation boundary.

[lidge-jun]

리뷰 · 우선순위 42 / 80

이 PR은 #4242가 넣는 실험 플래그 v2RoutedDelegationBridge를 영어 참고 문서 두 곳에만 적습니다. 지금 CURRENT dev HEAD는 babb76449이고, 베이스는 dev, 브랜치는 codex/upstream-v2-routed-delegation-bridge-docs입니다. 작성자는 같은 yansigit이고, 역시 draft입니다. 코드 변경은 없습니다.

docs-site/src/content/docs/reference/configuration/agents.md 표에 한 행을 추가합니다. 타입 boolean, 기본 false, canonical OpenAI Responses V2에서 collaboration 메시지 연산을 미러했다가 native로 되돌린다고 적습니다. maintenance·compaction·shadow·non-native·충돌·잘못된 요청 모양에서는 비활성이라고 짧게 말합니다. docs-site/src/content/docs/reference/management-api.md의 GET, PUT /api/v2 목적 문장에 “optional routed delegation bridge”를 덧붙입니다. 에러 열은 그대로 400/502입니다.

GitHub 파일 목록과 dev...head diff는 문서 두 파일뿐입니다. 코어 구현은 #4242 쪽입니다. 본문도 “stacked on the core bridge PR”이라고 했고, 검증은 git diff --check 수준입니다. 번역본(ko/ja 등)과 GUI 문구는 없습니다. #4242 본문이 문서/UI를 follow-up으로 미룬 약속의 영어 최소치입니다.

단독 머지 위험 - #4242가 dev에 없으면 문서는 존재하지 않는 설정 키를 설명하게 됩니다. 스택/랜딩 순서를 지키세요.

영문만 - remote-hub #4247처럼 로케일 드리프트는 당장 가드가 없습니다. 실험 플래그라 영어 first는 괜찮지만, 안정화 후 agents.md 번역을 잊기 쉽습니다.

내용 밀도 - agents.md 한 줄은 fail-closed 목록을 말하지만, ocx_agents 미러 이름, 평문 args, SSE 바인딩 한도, 관리 API 필드 이름은 안 적습니다. 실험 단계에선 충분할 수 있으나, 켠 운영자가 디버그할 때 코드로 내려가야 합니다.

draft / readiness 미체크 - #4242와 같이 아직 리뷰·머지 대기가 아닙니다.

management-api.md - 표 문장만 바꾸고 요청/응답 예시 JSON에 v2RoutedDelegationBridge 필드를 안 넣었습니다. 그 페이지에 예시가 있다면 같이 맞춰야 합니다.

메인테이너의 판단이 필요한 지점

• feat: add opt-in V2 routed delegation bridge #4242 Ready 직전에 이 docs PR을 스택으로 같이 머지할지, 코어 직후 초짧은 follow-up으로 둘지
• agents.md에 ocx_agents 미러·평문 복원·관리 API 필드명을 더 쓸지, 실험 단계에선 한 줄로 족할지
• 번역 follow-up을 언제 열지(지금은 영어만)

너의 추천
#4242가 Ready·CI 초록이 되기 전에는 이 PR도 draft로 두세요. 코어가 랜딩할 때 영어 두 파일은 같이 가져가는 편이 운영자 발견 경로에 맞습니다. 내용은 최소치로 충분하니, 지금은 문장 확장보다 #4242 계약(미러 네임스페이스·fail-closed)이 안정된 뒤 필요하면 한 단락을 보강하세요. 단독 머지는 하지 마세요.

이 댓글은 grok-bot이 작성했습니다