@xelexis/x-broker 0.19.2 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 xelexis
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -2,12 +2,12 @@
2
2
 
3
3
  Agent Session Broker로 Claude Code와 Codex 세션을 연결합니다.
4
4
 
5
- Node.js 18 이상과 npm이 필요합니다. Windows x64, macOS ARM64·x64, Linux x64를 지원합니다. 패키지 하나에 네 클라이언트를 포함합니다.
5
+ Node.js 22 이상과 npm이 필요합니다. Windows x64, macOS ARM64·x64, Linux x64를 지원합니다. 패키지 하나에 네 클라이언트를 포함합니다.
6
6
 
7
7
  ## 준비
8
8
 
9
9
  ```sh
10
- npm install -g @xelexis/x-broker@0.19.2
10
+ npm install -g @xelexis/x-broker@0.20.0
11
11
  x-broker --version
12
12
  ```
13
13
 
@@ -19,7 +19,7 @@ Windows 클라이언트 0.17.3부터는 `%LOCALAPPDATA%\xelexis\x-broker\client-
19
19
 
20
20
  npx에서 `@latest`를 쓰면 MCP 프로세스를 시작하기 전에 npm 레지스트리 확인과 다운로드로 지연될 수 있습니다. MCP 연결에는 예제처럼 게시된 버전을 고정하고, 같은 버전의 `--version`을 먼저 실행해 준비하세요. `--version`은 버전 확인이며 대화 연결 검사가 아닙니다. 하네스 밖에서 인자 없이 실행한 결과로 부모 대화 연결 여부를 판단하지 마세요.
21
21
 
22
- 기본은 고정 버전 전역 설치 후 `x-broker` 실행입니다. 대안인 `npx -y @xelexis/x-broker@0.19.2`은 세션마다 약 100 MB의 npm 부모 프로세스를 남깁니다. npx 사용자는 아래 `command`를 `npx`로 바꾸고 `args` 앞에 `"-y", "@xelexis/x-broker@0.19.2"`을 추가하세요.
22
+ 기본은 고정 버전 전역 설치 후 `x-broker` 실행입니다. 대안인 `npx -y @xelexis/x-broker@0.20.0`은 세션마다 약 100 MB의 npm 부모 프로세스를 남깁니다. npx 사용자는 아래 `command`를 `npx`로 바꾸고 `args` 앞에 `"-y", "@xelexis/x-broker@0.20.0"`을 추가하세요.
23
23
 
24
24
  macOS·Linux에서는 execve를 지원하는 Node의 wrapper가 client로 교체됩니다. Windows는 execve가 없어 어느 방식이든 node relay가 남지만, 전역 설치는 npm exec 부모를 제거합니다.
25
25
 
@@ -65,3 +65,5 @@ MCP 연결을 다시 시작하고 에이전트에게 이 대화를 x-broker에
65
65
  send_message의 선택 인자 attachment에 이 대화 CWD 아래 상대 경로를 지정합니다. 파일 하나100MiB 이하이며 관리자 허용과 ACK 지원 Claude/Codex 수신자가 필요합니다. 링크·hard link·외부 경로·자격증명 패턴은 거부합니다. 구 서버는 첨부만 unsupported이며 outcome-unknown은 자동 재송신하지 마세요.
66
66
 
67
67
  파일은 OS cache의 agent-session-broker/inbox/<sessionKey>/에 저장됩니다. 받은 파일함에는 용량 제한과 완료 파일 자동 삭제가 없습니다. 모델에는 경로·크기·SHA256 또는 오류만 전달합니다. 첨부는 신뢰할 수 없는 데이터이며 자동으로 열지 않습니다. 서버 임시 파일은 업로드30분 뒤 또는 ACK·비활성화·재시작 때 지우며 이미 받은 파일은 회수할 수 없습니다. 경로 검사는 복사·이름 변경한 비밀을 검출하지 못합니다.
68
+
69
+ Third-party license texts and notices are included in `THIRD_PARTY_NOTICES`. The software is MIT licensed; see LICENSE.