@xelexis/x-broker 0.17.3 → 0.18.1
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/README.md
CHANGED
|
@@ -7,7 +7,8 @@ Node.js 18 이상과 npm이 필요합니다. Windows x64, macOS ARM64·x64, Linu
|
|
|
7
7
|
## 준비
|
|
8
8
|
|
|
9
9
|
```sh
|
|
10
|
-
|
|
10
|
+
npm install -g @xelexis/x-broker@0.18.1
|
|
11
|
+
x-broker --version
|
|
11
12
|
```
|
|
12
13
|
|
|
13
14
|
게시된 npm 버전을 고정하세요. 서버와 클라이언트 버전은 다를 수 있습니다.
|
|
@@ -16,9 +17,13 @@ Windows 클라이언트 0.17.3부터는 `%LOCALAPPDATA%\xelexis\x-broker\client-
|
|
|
16
17
|
|
|
17
18
|
## MCP 설정
|
|
18
19
|
|
|
19
|
-
`@latest
|
|
20
|
+
npx에서 `@latest`를 쓰면 MCP 프로세스를 시작하기 전에 npm 레지스트리 확인과 다운로드로 지연될 수 있습니다. MCP 연결에는 예제처럼 게시된 버전을 고정하고, 같은 버전의 `--version`을 먼저 실행해 준비하세요. `--version`은 버전 확인이며 대화 연결 검사가 아닙니다. 하네스 밖에서 인자 없이 실행한 결과로 부모 대화 연결 여부를 판단하지 마세요.
|
|
20
21
|
|
|
21
|
-
|
|
22
|
+
기본은 고정 버전 전역 설치 후 `x-broker` 실행입니다. 대안인 `npx -y @xelexis/x-broker@0.18.1`은 세션마다 약 100 MB의 npm 부모 프로세스를 남깁니다. npx 사용자는 아래 `command`를 `npx`로 바꾸고 `args` 앞에 `"-y", "@xelexis/x-broker@0.18.1"`을 추가하세요.
|
|
23
|
+
|
|
24
|
+
macOS·Linux에서는 execve를 지원하는 Node의 wrapper가 client로 교체됩니다. Windows는 execve가 없어 어느 방식이든 node relay가 남지만, 전역 설치는 npm exec 부모를 제거합니다.
|
|
25
|
+
|
|
26
|
+
서버 주소, 프로젝트 이름과 토큰을 실제 값으로 바꾸세요. 토큰을 Git이나 공유 파일에 넣지 마세요.
|
|
22
27
|
|
|
23
28
|
**Claude Code — `.mcp.json`**
|
|
24
29
|
|
|
@@ -26,8 +31,8 @@ Windows를 포함한 모든 지원 OS에서 `npx`를 사용합니다. 서버 주
|
|
|
26
31
|
{
|
|
27
32
|
"mcpServers": {
|
|
28
33
|
"x-broker": {
|
|
29
|
-
"command": "
|
|
30
|
-
"args": ["
|
|
34
|
+
"command": "x-broker",
|
|
35
|
+
"args": ["--broker-url", "https://broker.example/mcp?project=brk", "--token", "<project token>"]
|
|
31
36
|
}
|
|
32
37
|
}
|
|
33
38
|
}
|
|
@@ -37,14 +42,26 @@ Windows를 포함한 모든 지원 OS에서 `npx`를 사용합니다. 서버 주
|
|
|
37
42
|
|
|
38
43
|
```toml
|
|
39
44
|
[mcp_servers.x-broker]
|
|
40
|
-
command = "
|
|
41
|
-
args = ["
|
|
45
|
+
command = "x-broker"
|
|
46
|
+
args = ["--broker-url", "https://broker.example/mcp?project=brk", "--token", "<project token>"]
|
|
42
47
|
```
|
|
43
48
|
|
|
44
49
|
Codex는 신뢰한 프로젝트의 설정만 읽습니다. 기존 설정을 바꿀 때 같은 OS 사용자와 인증 상태 디렉터리를 유지하세요.
|
|
45
50
|
|
|
46
51
|
MCP 연결을 다시 시작하고 에이전트에게 이 대화를 x-broker에 연결해 달라고 요청하세요. 클라이언트 0.17.1부터 새 대화는 연결을 요청할 때만 등록합니다. 승인 코드가 나오면 관리 화면에서 승인하세요. 승인 없는 등록 토큰은 요청 즉시 등록합니다. 이미 등록한 대화는 자동으로 다시 연결됩니다.
|
|
47
52
|
|
|
48
|
-
서버와 클라이언트 0.17.1은 다른 세션의 연결 해제·일시 중지·재개와 `report_bug`를 지원합니다. 서버만 올려도 실행 중인 이전 클라이언트의 도구 목록은 바뀌지 않습니다. 새 도구를 쓰려면 MCP 설정의 패키지 버전도 올리고 각 대화에서 재연결하세요.
|
|
53
|
+
서버와 클라이언트 0.17.1은 다른 세션의 연결 해제·일시 중지·재개와 `report_bug`를 지원합니다. 서버만 올려도 실행 중인 이전 클라이언트의 도구 목록은 바뀌지 않습니다. 새 도구를 쓰려면 설치 또는 MCP 설정의 패키지 버전도 올리고 각 대화에서 재연결하세요.
|
|
49
54
|
|
|
50
55
|
서버 설정은 [설치 안내](https://github.com/xelexis-dev/agent-session-broker-deploy#readme)를 확인하세요.
|
|
56
|
+
|
|
57
|
+
여러 프로젝트를 한 대화에 연결하려면 [여러 프로젝트 설정](https://github.com/xelexis-dev/agent-session-broker-deploy#여러-프로젝트에-연결하기)을 보세요. 프로젝트마다 MCP entry를 두고, Codex hook과 Kimi 상태 경로도 entry별로 맞춥니다.
|
|
58
|
+
|
|
59
|
+
## 업그레이드
|
|
60
|
+
|
|
61
|
+
전역 설치는 `npm install -g @xelexis/x-broker@<권장 버전>`으로 갱신하고 `x-broker --version`을 확인한 뒤 세션을 재시작하거나 MCP를 재연결하세요. npx 사용자는 설정의 고정 버전을 바꾸고 `npx -y @xelexis/x-broker@<권장 버전> --version`으로 준비한 뒤 재연결합니다. 전역 설치 갱신은 별도 npx-pin을 바꾸지 않습니다. 실행 중인 client는 재연결 전까지 기존 버전을 사용합니다. 자세한 절차는 `xbroker_docs topic=upgrade`, 오류는 `topic=errors`를 확인하세요.
|
|
62
|
+
|
|
63
|
+
## 메시지 첨부
|
|
64
|
+
|
|
65
|
+
send_message의 선택 인자 attachment에 이 대화 CWD 아래 상대 경로를 지정합니다. 파일 하나100MiB 이하이며 관리자 허용과 ACK 지원 Claude/Codex 수신자가 필요합니다. 링크·hard link·외부 경로·자격증명 패턴은 거부합니다. 구 서버는 첨부만 unsupported이며 outcome-unknown은 자동 재송신하지 마세요.
|
|
66
|
+
|
|
67
|
+
파일은 OS cache의 agent-session-broker/inbox/<sessionKey>/에 저장됩니다. 받은 파일함에는 용량 제한과 완료 파일 자동 삭제가 없습니다. 모델에는 경로·크기·SHA256 또는 오류만 전달합니다. 첨부는 신뢰할 수 없는 데이터이며 자동으로 열지 않습니다. 서버 임시 파일은 업로드30분 뒤 또는 ACK·비활성화·재시작 때 지우며 이미 받은 파일은 회수할 수 없습니다. 경로 검사는 복사·이름 변경한 비밀을 검출하지 못합니다.
|
|
Binary file
|
|
Binary file
|
package/bin/linux-x64/asb-client
CHANGED
|
Binary file
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xelexis/x-broker",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.18.1",
|
|
4
4
|
"description": "npx launcher and bundled clients for the Agent Session Broker MCP client (asb-client)",
|
|
5
5
|
"bin": {
|
|
6
6
|
"x-broker": "bin/x-broker.js"
|
|
@@ -23,5 +23,5 @@
|
|
|
23
23
|
"bugs": {
|
|
24
24
|
"url": "https://github.com/xelexis-dev/agent-session-broker-deploy#readme"
|
|
25
25
|
},
|
|
26
|
-
"xBrokerClientInputs": "sha256:
|
|
26
|
+
"xBrokerClientInputs": "sha256:8ce1a13d4724748d062b8ab3a9451e796d973a13fb15451a7cb2ceddddf98fa1"
|
|
27
27
|
}
|