1.0.1 ko public

스펙

RAWP-DPS

Data processing specification for RAWP integrations.

1. 개요 (Introduction)

RAWP-DPS 1.0은 RAWP 1.0의 데이터 평면(§6)을 대체하는 독립 스트리밍 규격이다.

RAWP-DPS 1.0은 다음 목표를 달성하기 위해 설계되었다:

  1. 완전성(Completeness): Claude Code를 포함한 에이전트 코딩 도구의 모든 출력 형태를 단일 프레임 규격으로 포맷화한다.
  2. 범용성(Generality): 특정 에이전트에 종속되지 않으며, 임의의 에이전트 도구 체계를 수용할 수 있는 확장 가능한 타입 시스템을 제공한다.
  3. 호환성(Compatibility): 알 수 없는 타입의 정방향 호환성(Forward Compatibility)을 구조적으로 보장한다.

1.1. 요구사항 표기 규약

본 문서의 "MUST", "MUST NOT", "REQUIRED", "SHOULD", "SHOULD NOT", "OPTIONAL"은 RFC 2119를 따른다.

1.2. RAWP 1.0과의 관계

RAWP-DPS 1.0은 RAWP 1.0의 제어 평면(§1–§5, §7–§8)을 변경하지 않는다. 세션 초기화(§5.1), WebSocket 수립(§5.3), 보안 규격(§7)은 그대로 유지되며, 본 규격은 WSS 연결 수립 이후 교환되는 데이터 프레임의 포맷만을 재정의한다.

1.3. RAWP-1.0-Legacy (지원 종료)

RAWP-1.0-Legacy는 지원이 종료되었다. 모든 구현은 본 규격(rawp-dps-1.0)만을 사용해야 한다 (MUST).

1.4. 용어 정의

본 문서에서 추가로 사용하는 용어:

용어 정의
Agent Session RAWP 1.0.2 §1.2에서 정의. 에이전트의 논리적 생명주기 단위. 본 규격의 모든 Frame은 session_id 필드를 통해 특정 Agent Session에 귀속된다. 본 문서에서 "세션"은 별도 명시가 없는 한 Agent Session을 의미한다.
WSS Connection RAWP 1.0.2 §1.2에서 정의. Agent Session에 바인딩된 WebSocket 전송 채널. 본 규격의 Frame은 WSS Connection을 통해 송수신된다. 하나의 Agent Session에 복수의 WSS Connection이 동시에 존재할 수 있다.
Frame WSS Connection을 통해 송수신되는 하나의 JSON 메시지 단위
Content Block 단일 Frame 내에서 독립적 의미를 가지는 출력 조각
Turn 에이전트의 단일 추론-행동 사이클 (프롬프트 수신 → 도구 사용 → 응답 완료). 하나의 Agent Session 내에서 순차적으로 발생한다.
Tool Invocation 에이전트가 외부 도구를 호출하는 행위와 그 결과의 쌍
Namespace 이벤트 타입의 계층적 분류 체계 (agent., tool., session. 등)

참조