@odyssey365/cli 0.1.0 → 0.2.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/README.md +128 -12
- package/dist/files.js +58 -0
- package/dist/guide.js +113 -0
- package/dist/index.js +92 -2
- package/dist/oauth.js +2 -9
- package/dist/rpc.js +20 -13
- package/dist/session.js +57 -1
- package/dist/watch-agent.js +45 -0
- package/dist/watch-events.js +78 -0
- package/dist/watch.js +181 -0
- package/examples/watch-agent/README.md +124 -0
- package/examples/watch-agent/config.example.json +20 -0
- package/examples/watch-agent/dispatcher.mjs +1443 -0
- package/examples/watch-agent/gitignore.template +6 -0
- package/examples/watch-agent/package.json +12 -0
- package/examples/watch-agent/test/dispatcher.test.mjs +763 -0
- package/examples/watch-agent/test/supervisor.test.mjs +126 -0
- package/package.json +10 -3
- package/prompts/watch-agent.md +250 -0
package/README.md
CHANGED
|
@@ -18,7 +18,9 @@ odyssey -p work search "주간 회의"
|
|
|
18
18
|
odyssey get_todo <todoId>
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
Node.js 20 이상. 런타임
|
|
21
|
+
Node.js 20 이상. 런타임 의존성은 `firebase` 하나 — `odyssey watch` 만 쓰고, 그 명령에서만 불러온다.
|
|
22
|
+
감시·예제 준비 기능은 **0.2.0 이상**이 필요하다. 설치 후 `odyssey --version`을 확인한다.
|
|
23
|
+
아직 공개판이 0.1.0이면 감시 명령은 없으므로, 제공된 후보 `.tgz`를 `npm i -g /경로/파일.tgz`로 설치한다.
|
|
22
24
|
|
|
23
25
|
## 계정
|
|
24
26
|
|
|
@@ -36,7 +38,7 @@ Node.js 20 이상. 런타임 의존성 없음.
|
|
|
36
38
|
브라우저 로그인이 끝나면 그 주소로 돌아온 인가 코드를 토큰으로 바꾼다. 로그인 페이지는 매번 새로 로그인하므로
|
|
37
39
|
다른 계정으로 바꿔 로그인하기 쉽다.
|
|
38
40
|
|
|
39
|
-
토큰은 `~/.odyssey/cli/credentials.json
|
|
41
|
+
토큰은 `~/.odyssey/cli/credentials.json`에 평문으로 저장된다(디렉터리 0700·파일 0600, Windows에서는 POSIX chmod가 적용되지 않음). 액세스 토큰은 60일이고, 만료 하루 전부터
|
|
40
42
|
리프레시 토큰으로 알아서 갱신한다.
|
|
41
43
|
|
|
42
44
|
**계정 고르는 순서**: `-p/--profile` → 환경변수 `ODYSSEY_TOKEN`(저장 없이 토큰 직접) → `ODYSSEY_PROFILE`
|
|
@@ -44,7 +46,7 @@ Node.js 20 이상. 런타임 의존성 없음.
|
|
|
44
46
|
|
|
45
47
|
## 도구
|
|
46
48
|
|
|
47
|
-
도구 정의는 서버가 정본이다. 서버에 도구가 늘면 CLI
|
|
49
|
+
도구 정의는 서버가 정본이다. 서버에 도구가 늘면 CLI 코드를 업데이트하지 않아도 쓸 수 있다. 목록은 6시간 캐시하므로 즉시 반영이 필요하면 `--refresh-tools`를 붙인다(모르는 이름은 한 번 새로 받는다).
|
|
48
50
|
|
|
49
51
|
```bash
|
|
50
52
|
odyssey tools # 전체 목록 ([읽기]/[쓰기] 표시)
|
|
@@ -86,14 +88,26 @@ cat input.json | odyssey create_memo --input -
|
|
|
86
88
|
|
|
87
89
|
## AI 에이전트에서
|
|
88
90
|
|
|
89
|
-
CLI
|
|
91
|
+
CLI 가 에이전트용 설명서를 직접 낸다 — 사용법 · 이 컴퓨터에 로그인된 계정 · Odyssey 서버의 사용 지침(실시간).
|
|
90
92
|
|
|
93
|
+
```bash
|
|
94
|
+
odyssey agent-guide # 전문 — 에이전트가 작업을 시작할 때 한 번 읽는다
|
|
95
|
+
odyssey agent-guide --snippet # AGENTS.md · CLAUDE.md · GEMINI.md 등에 붙일 짧은 절
|
|
96
|
+
odyssey agent-guide --skill # Claude Code · Codex 스킬 파일(SKILL.md) 내용
|
|
91
97
|
```
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
98
|
+
|
|
99
|
+
에이전트에게 알리는 가장 쉬운 방법은 그 에이전트가 일하는 프로젝트의 `AGENTS.md`(여러 코딩 에이전트가 함께 읽는 관례 —
|
|
100
|
+
Claude Code 는 `CLAUDE.md`)에 짧은 절을 붙이는 것이다. 그 절은 "시작할 때 `odyssey agent-guide` 를 실행하라"고 가리키므로,
|
|
101
|
+
계정이나 서버 지침이 바뀌어도 파일을 고칠 필요가 없다.
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
odyssey agent-guide --snippet # 내용을 확인한 뒤 기존 저장소 지침의 정본에 맞게 반영
|
|
105
|
+
odyssey agent-guide --skill # 스킬 내용을 출력한다. 기존 파일 덮어쓰기 전에 내용을 확인한다.
|
|
95
106
|
```
|
|
96
107
|
|
|
108
|
+
> MCP 커넥터는 연결할 때 서버의 사용 지침(복잡한 작업 전 `getGuide` 로 절차를 읽을 것 등)을 받는다. CLI 는 호출마다 한 왕복으로
|
|
109
|
+
> 끝내려 그 연결 단계를 건너뛰므로, 그 지침은 `odyssey agent-guide` 로 받는다.
|
|
110
|
+
|
|
97
111
|
## 프로그램에서 쓰기 — 활동 자동 기록 (예: 게임 기록기)
|
|
98
112
|
|
|
99
113
|
사람 없이 도는 프로그램(게임 프로세스 감시기 등)이 "언제부터 언제까지 무엇을 했다"를 남기는 법.
|
|
@@ -102,7 +116,9 @@ Odyssey 데이터는 `odyssey` CLI 로 다룬다. `odyssey tools` 로 도구를
|
|
|
102
116
|
|
|
103
117
|
```bash
|
|
104
118
|
odyssey login # 브라우저 로그인 한 번 — 이후 토큰은 알아서 갱신된다
|
|
105
|
-
odyssey
|
|
119
|
+
odyssey list_categories # 카테고리 이름 확인
|
|
120
|
+
odyssey create_record --title "리그 오브 레전드" --emoji 🎮 --numType time --numUnit min --tags 게임 --categoryName "게임"
|
|
121
|
+
# 기록의 카테고리가 타임라인 카드에도 붙는다 — 앱 타임라인의 카테고리 필터·기록장 묶기가 이 값으로 거른다
|
|
106
122
|
# → {"recordId":"…"} 를 프로그램 설정에 저장
|
|
107
123
|
```
|
|
108
124
|
|
|
@@ -122,7 +138,39 @@ odyssey create_record --title "리그 오브 레전드" --emoji 🎮 --numType t
|
|
|
122
138
|
odyssey add_record_trace --input - # 위 JSON 을 표준입력으로
|
|
123
139
|
```
|
|
124
140
|
|
|
125
|
-
|
|
141
|
+
**승패·KDA 까지 같이 남기려면** — 기록을 만들 때 칸(`fields`)을 설계한다. 첫 칸이 대표값(차트·통계)이다.
|
|
142
|
+
킬·데스·어시처럼 한 덩어리로 생각하는 숫자는 **숫자 묶음 칸(`numberSet`) 하나**에 담는다 — KDA 비율은 저장하지 않고 앱·서버가 계산한다.
|
|
143
|
+
|
|
144
|
+
```json
|
|
145
|
+
{
|
|
146
|
+
"title": "리그 오브 레전드 랭크",
|
|
147
|
+
"emoji": "🎮",
|
|
148
|
+
"fields": [
|
|
149
|
+
{ "label": "결과", "kind": "choice", "options": ["승", "패"] },
|
|
150
|
+
{ "label": "KDA", "kind": "numberSet", "calc": "kda",
|
|
151
|
+
"parts": [{ "label": "킬" }, { "label": "데스" }, { "label": "어시" }] },
|
|
152
|
+
{ "label": "플레이", "kind": "span" }
|
|
153
|
+
]
|
|
154
|
+
}
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
odyssey create_record --input - # 위 JSON — 운동이면 parts 를 무게(kg)·횟수(회)·세트(세트), joiner "times", calc "product"(볼륨)
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
측정값은 칸 **이름**으로 적는다. 묶음 값은 `"12/3/8"` 글·`[12, 3, 8]` 목록·`{"킬": 12, …}` 맵 어느 것이든 된다. 구간 칸은 `time`·`endTime` 이 값이다.
|
|
162
|
+
|
|
163
|
+
```json
|
|
164
|
+
{
|
|
165
|
+
"recordId": "<recordId>",
|
|
166
|
+
"values": { "결과": "승", "KDA": "12/3/8" },
|
|
167
|
+
"time": "2026-10-10T21:03:00+09:00",
|
|
168
|
+
"endTime": "2026-10-10T21:35:00+09:00",
|
|
169
|
+
"dedupeKey": "lol-2026-10-10T21:03:00+09:00"
|
|
170
|
+
}
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
기록 없이 타임라인 카드만 원하면 `create_timeline_event` 에 `title`·`startTime`·`endTime`(+`dedupeKey`·`categoryName`)을 준다 —
|
|
126
174
|
시작·끝이 둘 다 있으면 다른 내용 없이도 만들어진다.
|
|
127
175
|
|
|
128
176
|
**지켜야 할 것**
|
|
@@ -154,6 +202,69 @@ elif p.returncode == 3: notify("odyssey login 이 필요합니다")
|
|
|
154
202
|
elif p.returncode != 0: log_error(p.stderr)
|
|
155
203
|
```
|
|
156
204
|
|
|
205
|
+
## 관리자 — 사용량 한도·요금제 (`-p admin`)
|
|
206
|
+
|
|
207
|
+
관리자(admin 클레임) 계정으로 붙으면 도구 목록에 셋이 더 보인다(일반 계정엔 없다). 사용자가 앱에서 [더 필요해요]로 한도 상향을
|
|
208
|
+
요청하면 이걸로 올린다 — 저장소·서비스 계정 키 없이, 앱 릴리스 없이 바로 먹는다.
|
|
209
|
+
|
|
210
|
+
```bash
|
|
211
|
+
odyssey -p admin get_usage_quota --account user@example.com # 요금제·상향·유효 한도·사용량 + 요금제 표
|
|
212
|
+
odyssey -p admin set_usage_quota --account user@example.com --projectLimit 20 --storageLimitMb 1024
|
|
213
|
+
odyssey -p admin set_usage_quota --account user@example.com --companionMonthlyBudgetKrw 10000
|
|
214
|
+
odyssey -p admin set_usage_quota --json '{"account":"user@example.com","clear":["all"]}' # 상향 지우기(요금제 값으로)
|
|
215
|
+
odyssey -p admin set_usage_plan --planId beta --projectLimit 8 # 요금제 표 고치기 → 그 요금제 계정 전부 다시 적힘
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
유효 한도 = 계정별 상향 ?? 요금제(`usage_plan/{id}`) ?? 코드 기본값(보드 6 · 업로드 300MB · 컴패니언 월 ₩3,000).
|
|
219
|
+
결제가 붙으면 계정의 `plan` 만 바꾼다(`set_usage_quota --plan pro`) — 운영자 상향과 섞이지 않는다.
|
|
220
|
+
이력: `document/90-process/work-log/261019 베타 사용량 한도 요금제 usage_plan 계정별 한도 관리자 도구.md`
|
|
221
|
+
|
|
222
|
+
## 실시간 감시 — `odyssey watch`
|
|
223
|
+
|
|
224
|
+
내 계정의 변화를 실시간으로 받아 **한 줄에 JSON 하나씩(NDJSON)** stdout 으로 흘린다. 그 위에 프로그램을 붙인다.
|
|
225
|
+
|
|
226
|
+
**바로 실행할 감시 에이전트 예제**가 패키지에 포함돼 있다. 작업할 프로젝트 폴더에서:
|
|
227
|
+
|
|
228
|
+
```bash
|
|
229
|
+
odyssey watch-agent init ../my-watch-agent
|
|
230
|
+
cd ../my-watch-agent
|
|
231
|
+
# config.json의 작업 폴더·프로필·Claude Code MCP 이름·예산 확인
|
|
232
|
+
node dispatcher.mjs --check
|
|
233
|
+
node dispatcher.mjs --dry-run
|
|
234
|
+
# 배달 예정 확인 후 Ctrl+C
|
|
235
|
+
node dispatcher.mjs
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
예제는 태그·멘션 배달, 항목별 세션 재개, 중복 방지·커서 보관, 준비 대기 제한시간·재연결, 단일 실행 잠금과 하루 예산을 갖춘다.
|
|
239
|
+
CLI와 Claude Code MCP는 같은 Odyssey 계정으로 로그인한다. 예제 생성은 기존 폴더를 덮어쓰거나 자동 시작을 등록하지 않는다.
|
|
240
|
+
자세한 설치·설정·중지 방법은 [예제 README](examples/watch-agent/README.md)를 따른다.
|
|
241
|
+
|
|
242
|
+
```bash
|
|
243
|
+
odyssey watch --tag "클로드 코드" # 그 태그 할일의 추가·수정·삭제 + 내 댓글
|
|
244
|
+
odyssey watch --tag 버그 --tag "새 기능" --no-comments
|
|
245
|
+
odyssey watch --since 2026-10-16T00:00:00+09:00 # 이 시각 뒤의 내 댓글부터(밀린 댓글)
|
|
246
|
+
odyssey watch --tag "클로드 코드" | my-dispatcher # 파이프로 프로그램에 넘기기
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
| 이벤트 | 내용 |
|
|
250
|
+
|---|---|
|
|
251
|
+
| `{"type":"ready", uid, streams, since}` | 첫 스냅샷까지 받았다 |
|
|
252
|
+
| `{"type":"todo", change, initial, uid, title, status, tags, updatedAt}` | `change` = added·modified·removed. 켠 직후의 첫 묶음은 `initial: true`(밀린 일) |
|
|
253
|
+
| `{"type":"comment", author, commentUid, itemType, itemUid, itemOwnerUid, parentItemUid, replyToCommentUid, roomUid, text, kind, createdAt}` | 내가 쓴 새 댓글. AI(MCP·컴패니언) 댓글은 기본으로 뺀다(`--include-agent`). `parentItemUid` = 보드 카드면 그 보드 · `replyToCommentUid` = 앱 「답글」이면 어느 댓글에 단 것인지 |
|
|
254
|
+
| `{"type":"error", stream, code, message}` | 그 스트림의 오류. Firestore 리스너는 오류 뒤 다시 붙지 않는다 — 받는 쪽이 감시를 다시 띄운다 |
|
|
255
|
+
|
|
256
|
+
- **OAuth 로그인 프로필만** 된다(`odyssey login`). API 키는 서버가 거절한다.
|
|
257
|
+
- 어떻게: CLI 로그인을 서버(`/cli/firebase-session`)에서 Firebase 커스텀 토큰 + App Check 토큰으로 바꿔 Firestore 리스너를 직접 붙인다.
|
|
258
|
+
Firebase 신원은 OAuth 연결마다 분리한다. 내 할일·내 댓글·읽을 수 있는 방 메타데이터만 읽고, 앱 데이터 쓰기는 허용하지 않는다.
|
|
259
|
+
`odyssey logout`으로 서버 연결이 회수되면 rules가 추가 데이터 접근을 거절하고 CLI 신원의 Firebase 갱신도 회수한다. 일반 앱 로그인은 유지한다.
|
|
260
|
+
Firebase 로그인 상태는 메모리에만 두고 App Check는 만료 때 다시 교환한다. Windows 발급·새 OAuth 연결 생성으로 파생 자격을 재사용할 수 없다.
|
|
261
|
+
- 이 보안 변경은 Functions v1/v2·Firestore/Storage 규칙의 동반 반영이 필요하다. 새 CLI는 전용 신원을 주지 않는 구버전 서버에서 `watch`를 거절한다. 현재 후보는 미배포이며 운영 반영은 별도다.
|
|
262
|
+
- 에이전트 댓글을 가르는 표식은 `metadata.authorKind`다. `claude`·`companion`·알 수 없는 비어 있지 않은 값은 모두 `agent`로 분류한다. 직접 디스패처를 만들 때 에이전트 댓글은 배달하지 않는다. 예제는 `--include-agent`로 표식을 받되, 세션 재개 판정에만 쓰고 일꾼에게 배달하지 않는다.
|
|
263
|
+
- **감시 에이전트 만들기**: `odyssey agent-guide --watch-agent` 가 코딩 에이전트(예: Claude Code)에게 줄 프롬프트를 낸다 —
|
|
264
|
+
디스패처는 **배달만** 한다: 감시 → 항목으로 일꾼 세션을 고르고 → 새로 만들거나(`--session-id`) 이어 받아(`--resume`) 깨운다.
|
|
265
|
+
입구는 감시 태그 할일과, 아무 항목 댓글의 멘션(`@클로드코드`) 둘이다. 세션이 생긴 항목은 그 스레드의 내 새 댓글·답글로 다시 깨운다. 세션이 없는 항목은 멘션으로 연다.
|
|
266
|
+
판단·작업·답글·상태는 깨운 세션의 Claude 가 Odyssey MCP 로 한다(`prompts/watch-agent.md`). 일이 없으면 토큰 0.
|
|
267
|
+
|
|
157
268
|
## 환경변수
|
|
158
269
|
|
|
159
270
|
| 이름 | 뜻 |
|
|
@@ -163,19 +274,24 @@ elif p.returncode != 0: log_error(p.stderr)
|
|
|
163
274
|
| `ODYSSEY_MCP_URL` | 서버 주소(기본 `https://mcp-odyssey30-60.odyssey365.app`) |
|
|
164
275
|
| `ODYSSEY_CONFIG_DIR` | 자격증명·캐시 위치(기본 `~/.odyssey/cli`) |
|
|
165
276
|
| `ODYSSEY_OUTPUT_DIR` | 이미지 저장 위치 |
|
|
166
|
-
| `ODYSSEY_TIMEOUT_MS` | 요청 제한 시간(기본 120000) |
|
|
277
|
+
| `ODYSSEY_TIMEOUT_MS` | 헤더부터 본문 수신 완료까지 요청 제한 시간(기본 120000). OAuth·MCP·감시 세션 교환 공통. 네트워크 실패는 종료 4 |
|
|
167
278
|
| `ODYSSEY_PRETTY=1` | 파이프에서도 JSON 들여쓰기 |
|
|
168
279
|
|
|
169
280
|
## 개발
|
|
170
281
|
|
|
171
282
|
```bash
|
|
172
283
|
npm install
|
|
173
|
-
npm test # 빌드 +
|
|
284
|
+
npm test # 빌드 + CLI 회귀·가짜 서버 E2E + 감시 예제 검사
|
|
285
|
+
npm run test:package # tarball → 새 prefix 설치 → 예제 추출·복사본 검사(게시 없음)
|
|
174
286
|
node dist/index.js --help
|
|
175
287
|
```
|
|
176
288
|
|
|
177
|
-
|
|
289
|
+
후보 준비: `npm run prepublishOnly`로 검사하고 `npm pack --pack-destination <폴더>`로 tarball을 만든다.
|
|
290
|
+
`prepack`은 빌드를 갱신하고, `prepublishOnly`는 전체 검사와 패키지 새 설치 검사까지 수행한다.
|
|
291
|
+
실제 게시 `npm publish`는 별도 배포 요청이 있을 때만 실행한다. CI는 Node 20·22·24에서 검사하며 게시 단계는 없다.
|
|
178
292
|
|
|
179
293
|
## License
|
|
180
294
|
|
|
181
295
|
MIT
|
|
296
|
+
|
|
297
|
+
> 2026-10-22: 통신 장애 회귀·감시 예제·패키지 새 설치 검사를 추가했다. 공개 npm 게시와 서버 배포는 별도 단계다.
|
package/dist/files.js
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 로컬 파일 붙이기 — 도구 입력의 `image: { file: "경로" }` 를 보내기 전에 읽어 `{ data: base64, name }` 으로 바꾼다.
|
|
3
|
+
*
|
|
4
|
+
* 서버(MCP)는 바이트만 받는다 — 서버가 로컬 경로를 열 수는 없고, 임의 URL 을 받아 오는 길은 일부러 닫았다
|
|
5
|
+
* (snapshot-images.ts). 커넥터로 붙은 AI 는 파일을 못 읽지만 CLI 는 읽는다: 스냅샷 지면에 스크린샷을 올리는
|
|
6
|
+
* 운영 흐름이 이 한 단계로 열린다.
|
|
7
|
+
*
|
|
8
|
+
* - 바꾸는 자리는 **`image` 키의 객체**뿐이다(create_snapshot · update_snapshot · create_snapshot_draft 의 사진 칸).
|
|
9
|
+
* 이름이 다른 키의 `file` 은 손대지 않는다 — 다른 도구의 문자열을 파일로 오인해 읽어 보내면 안 된다.
|
|
10
|
+
* - 상대 경로는 `--input` 파일이 있는 폴더 기준(원고 JSON 옆에 그림을 두는 흐름), 없으면 지금 폴더.
|
|
11
|
+
*
|
|
12
|
+
* 이력: document/90-process/work-log/261011 MCP 스냅샷 AI 왕복 생성·수정 역할 어휘 통일 서식 표기.md
|
|
13
|
+
*/
|
|
14
|
+
import { readFileSync, statSync } from 'node:fs';
|
|
15
|
+
import { basename, isAbsolute, resolve } from 'node:path';
|
|
16
|
+
import { UsageError } from './config.js';
|
|
17
|
+
/** 서버 상한(한 장 10MB)보다 먼저 막는다 — 큰 파일을 base64 로 부풀려 보낸 뒤 거절받지 않게. */
|
|
18
|
+
export const MAX_INLINE_FILE_BYTES = 10 * 1024 * 1024;
|
|
19
|
+
/** 붙인 파일 수 — 호출부가 안내에 쓴다. */
|
|
20
|
+
export function inlineImageFiles(value, baseDir) {
|
|
21
|
+
let count = 0;
|
|
22
|
+
const visit = (node) => {
|
|
23
|
+
if (Array.isArray(node)) {
|
|
24
|
+
node.forEach(visit);
|
|
25
|
+
return;
|
|
26
|
+
}
|
|
27
|
+
if (!node || typeof node !== 'object')
|
|
28
|
+
return;
|
|
29
|
+
const obj = node;
|
|
30
|
+
for (const [key, child] of Object.entries(obj)) {
|
|
31
|
+
if (key === 'image' && child && typeof child === 'object' && !Array.isArray(child)) {
|
|
32
|
+
const img = child;
|
|
33
|
+
if (typeof img.file === 'string' && img.data === undefined) {
|
|
34
|
+
const path = isAbsolute(img.file) ? img.file : resolve(baseDir, img.file);
|
|
35
|
+
let size;
|
|
36
|
+
try {
|
|
37
|
+
size = statSync(path).size;
|
|
38
|
+
}
|
|
39
|
+
catch {
|
|
40
|
+
throw new UsageError(`image.file 을 찾지 못했습니다: ${path}`);
|
|
41
|
+
}
|
|
42
|
+
if (size > MAX_INLINE_FILE_BYTES) {
|
|
43
|
+
throw new UsageError(`image.file 이 ${(size / 1024 / 1024).toFixed(1)}MB 입니다 — 한 장은 10MB 까지입니다: ${path}`);
|
|
44
|
+
}
|
|
45
|
+
img.data = readFileSync(path).toString('base64');
|
|
46
|
+
if (img.name === undefined)
|
|
47
|
+
img.name = basename(path);
|
|
48
|
+
delete img.file;
|
|
49
|
+
count += 1;
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
visit(child);
|
|
54
|
+
}
|
|
55
|
+
};
|
|
56
|
+
visit(value);
|
|
57
|
+
return count;
|
|
58
|
+
}
|
package/dist/guide.js
ADDED
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AI 에이전트용 설명서 — `odyssey agent-guide`.
|
|
3
|
+
*
|
|
4
|
+
* 다른 AI(Claude Code·Codex·Gemini CLI·Cursor 등)가 이 CLI 를 처음 만나도 쓸 수 있게, 설명서를 CLI 자신이 낸다.
|
|
5
|
+
* 파일로 따로 두지 않는 이유: 계정(프로필)과 서버 사용 지침은 실행할 때마다 다를 수 있다 — 설명서가 그 순간의 사실을 말해야 한다.
|
|
6
|
+
*
|
|
7
|
+
* odyssey agent-guide 전문(사용법 + 로그인된 계정 + 서버 사용 지침 실시간)
|
|
8
|
+
* odyssey agent-guide --skill Claude Code·Codex 스킬 파일(SKILL.md) — "시작할 때 agent-guide 를 읽어라" 가리킴
|
|
9
|
+
* odyssey agent-guide --snippet AGENTS.md·CLAUDE.md·GEMINI.md 등에 붙일 짧은 절
|
|
10
|
+
*
|
|
11
|
+
* AGENTS.md(여러 코딩 에이전트가 함께 읽는 관례)는 **에이전트가 일하는 프로젝트 폴더에 두는 파일**이다 — 도구가
|
|
12
|
+
* 미리 실어 둘 수 없으니, 그 파일에 넣을 내용(--snippet)을 CLI 가 내고 그 내용이 "시작할 때 agent-guide 를 실행하라"고
|
|
13
|
+
* 가리킨다(`odyssey agent-guide --snippet >> AGENTS.md`).
|
|
14
|
+
*
|
|
15
|
+
* 서버 사용 지침(MCP instructions)은 MCP 커넥터라면 연결 때 받는 것인데, CLI 는 왕복을 줄이려 initialize 를
|
|
16
|
+
* 건너뛰어 받지 못했다 — 전문 모드가 initialize 를 한 번 보내 그대로 싣는다.
|
|
17
|
+
*
|
|
18
|
+
* 이력: document/90-process/work-log/261010 Odyssey CLI agent-guide 에이전트 설명서 서버 지침.md
|
|
19
|
+
*/
|
|
20
|
+
const CORE_RULES = `- **사용자의 데이터다.** 쓰기는 사용자 앱 화면·알림에 그대로 나타난다. 요청 범위를 넘는 생성·수정을 하지 않는다.
|
|
21
|
+
- \`[쓰기·덮어씀]\` 도구와 \`delete_*\` 는 사용자가 그 변경을 분명히 원할 때만 부른다(삭제는 휴지통으로 가지만 그래도 먼저 확인).
|
|
22
|
+
- 없는 UID·도구·파라미터를 추측하지 않는다 — \`odyssey search\`·\`list_*\` 로 찾는다. 이름으로 찾을 땐 \`search\` 가 먼저다.
|
|
23
|
+
- 쓰기 뒤에는 \`get_*\`/\`list_*\` 로 다시 읽어 결과를 확인하고, 실제로 한 일만 보고한다.
|
|
24
|
+
- 로그인(\`odyssey login\`)은 브라우저 인증이 필요한 **사람의 일**이다. 종료 코드 3 이면 사용자에게 부탁하고, 비밀번호·토큰을 직접 다루지 않는다.`;
|
|
25
|
+
function profileSection(input) {
|
|
26
|
+
const lines = ['## 계정(프로필)', ''];
|
|
27
|
+
if (input.envToken) {
|
|
28
|
+
lines.push('환경변수 `ODYSSEY_TOKEN` 이 설정돼 있어 `-p` 를 주지 않은 호출은 그 토큰의 계정으로 간다.', '');
|
|
29
|
+
}
|
|
30
|
+
if (input.profiles.length === 0) {
|
|
31
|
+
lines.push('로그인된 프로필이 없다. 사용자에게 터미널에서 `odyssey login` 을 실행해 브라우저로 로그인해 달라고 부탁한다.', '(계정을 여럿 쓰려면 `odyssey login -p <이름>` 으로 이름을 붙인다.)');
|
|
32
|
+
}
|
|
33
|
+
else {
|
|
34
|
+
lines.push('| 프로필 | 계정 | |', '|---|---|---|');
|
|
35
|
+
for (const p of input.profiles) {
|
|
36
|
+
const who = p.email ?? (p.auth === 'apiKey' ? '(API 키 — 계정 정보 없음)' : '(알 수 없음)');
|
|
37
|
+
lines.push(`| \`${p.name}\` | ${who} | ${p.isDefault ? '기본' : `\`-p ${p.name}\``} |`);
|
|
38
|
+
}
|
|
39
|
+
lines.push('', '- `-p <프로필>` 을 주지 않으면 기본 프로필이다. 사용자가 계정을 말하지 않았으면 기본으로 한다.', '- 여러 계정을 다룰 때는 쓰기 전에 `odyssey whoami -p <프로필>` 로 의도한 계정인지 확인한다.');
|
|
40
|
+
}
|
|
41
|
+
return lines.join('\n');
|
|
42
|
+
}
|
|
43
|
+
function instructionsSection(input) {
|
|
44
|
+
const from = input.instructionsFrom ? ` — 프로필 \`${input.instructionsFrom}\` 로 받음` : '';
|
|
45
|
+
if (input.serverInstructions) {
|
|
46
|
+
return `## 서버 사용 지침 (실시간${from})\n\nOdyssey 서버가 모든 AI 클라이언트에 주는 지침이다. 아래 \`getGuide\` 같은 이름은 \`odyssey getGuide\` 로 부른다.\n\n${input.serverInstructions.trim()}`;
|
|
47
|
+
}
|
|
48
|
+
return `## 서버 사용 지침\n\n받지 못했다${input.serverInstructionsError ? ` (${input.serverInstructionsError})` : ''}. 로그인한 뒤 \`odyssey agent-guide\` 를 다시 실행하면 여기에 실린다.\n복잡한 생성·구성(보드 꾸리기 등) 전에는 \`odyssey getGuide\` 로 지침 목록을 보고, 맞는 것을 \`odyssey getGuide --guideIds <ID>\` 로 읽은 뒤 그 절차를 따른다.`;
|
|
49
|
+
}
|
|
50
|
+
/** 전문 — 사용법 + 계정 + 서버 지침. */
|
|
51
|
+
export function renderAgentGuide(input) {
|
|
52
|
+
return `# Odyssey CLI — AI 에이전트 설명서 (odyssey ${input.version})
|
|
53
|
+
|
|
54
|
+
이 문서는 \`odyssey agent-guide\` 의 출력이다. 작업을 시작할 때 한 번 실행해 읽는다 — 계정·서버 지침은 그때그때 다를 수 있다.
|
|
55
|
+
|
|
56
|
+
## 무엇인가
|
|
57
|
+
|
|
58
|
+
Odyssey(계획·기록·회고 앱) 사용자의 데이터 — 할일·메모·루틴·기록(측정값)·일정·타임라인·리포트·프로젝트 보드·댓글·스냅샷·컬렉션 — 를
|
|
59
|
+
읽고 쓰는 CLI 다. 도구는 서버(${input.server})가 정의한다 — Odyssey MCP 서버와 같은 도구다.
|
|
60
|
+
|
|
61
|
+
${profileSection(input)}
|
|
62
|
+
|
|
63
|
+
## 작업 순서
|
|
64
|
+
|
|
65
|
+
1. **찾기** — \`odyssey tools [검색어]\`: 도구 목록. \`[읽기]\`·\`[쓰기]\`·\`[쓰기·덮어씀]\` 표시.
|
|
66
|
+
2. **확인** — \`odyssey describe <도구>\`: 설명 전문·파라미터. 설명에 적힌 선행 조건(먼저 부를 도구·읽을 지침)을 따른다.
|
|
67
|
+
3. **실행** — \`odyssey <도구> --파라미터 값 …\`, 또는 JSON 을 표준입력으로 \`odyssey <도구> --input -\`.
|
|
68
|
+
4. **확인** — 쓰기 뒤 다시 읽어 확인한다.
|
|
69
|
+
|
|
70
|
+
## 파라미터 적는 법
|
|
71
|
+
|
|
72
|
+
- \`--key 값\` · \`--key=값\` · 불리언 \`--flag\` / \`--no-flag\` · 배열은 반복(\`--tags a --tags b\`) 또는 JSON
|
|
73
|
+
- 객체 안쪽은 점 경로(\`--deadline.endTime 2026-10-20T18:00:00+09:00\`) 또는 JSON(\`--checklist '[{"title":"a"}]'\`) · null 은 \`null\`
|
|
74
|
+
- 필수 파라미터가 하나뿐이면 위치 인자: \`odyssey get_todo <todoId>\`
|
|
75
|
+
- 여러 값·특수 문자가 섞이면 \`--input -\` 에 JSON 객체를 넣는 편이 안전하다(셸 따옴표 문제 없음)
|
|
76
|
+
- 시각은 오프셋을 붙인 ISO 8601(\`+09:00\` 또는 \`Z\`)
|
|
77
|
+
- 같은 일을 다시 보낼 수 있는 자동화면 \`dedupeKey\` 를 준다(\`create_timeline_event\`·\`add_record_trace\` — 같은 키 = 한 번만 기록)
|
|
78
|
+
|
|
79
|
+
## 출력과 종료 코드
|
|
80
|
+
|
|
81
|
+
- stdout 은 결과 JSON(파이프면 한 줄), stderr 는 안내·오류. 이미지를 돌려주는 도구는 파일로 저장하고 \`{"images":[{"path":…}]}\` 를 준다.
|
|
82
|
+
- \`0\` 성공 · \`1\` 도구 오류(메시지를 읽고 고쳐 다시 — 틀린 파라미터면 서버가 맞는 이름을 알려 준다) · \`2\` 사용법 오류 ·
|
|
83
|
+
\`3\` 로그인 필요(사람의 일) · \`4\` 네트워크(잠시 뒤 재시도)
|
|
84
|
+
- \`-o text\` 는 서버가 만든 요약 텍스트, \`-o raw\` 는 MCP 결과 전체.
|
|
85
|
+
|
|
86
|
+
## 지켜야 할 것
|
|
87
|
+
|
|
88
|
+
${CORE_RULES}
|
|
89
|
+
|
|
90
|
+
${instructionsSection(input)}
|
|
91
|
+
`;
|
|
92
|
+
}
|
|
93
|
+
/** AGENTS.md·CLAUDE.md·GEMINI.md·Cursor 규칙 등에 붙일 짧은 절 — 기계마다 다른 계정 정보는 싣지 않는다. */
|
|
94
|
+
export function renderSnippet() {
|
|
95
|
+
return `## Odyssey (\`odyssey\` CLI)
|
|
96
|
+
|
|
97
|
+
Odyssey(계획·기록·회고 앱)의 데이터 — 할일·메모·루틴·기록·일정·타임라인·프로젝트 보드·스냅샷 — 는 \`odyssey\` CLI 로 읽고 쓴다.
|
|
98
|
+
|
|
99
|
+
- **작업을 시작할 때 \`odyssey agent-guide\` 를 실행해 읽는다** — 사용법·로그인된 계정·최신 서버 지침이 나온다.
|
|
100
|
+
- 도구: \`odyssey tools\` → \`odyssey describe <도구>\` → \`odyssey <도구> --파라미터 값\`(또는 \`--input -\` 에 JSON). 결과는 JSON.
|
|
101
|
+
- 계정: \`-p <프로필>\`. 종료 코드 3 = 로그인 필요 → 사용자에게 \`odyssey login\` 을 부탁한다.
|
|
102
|
+
${CORE_RULES}
|
|
103
|
+
`;
|
|
104
|
+
}
|
|
105
|
+
/** Claude Code·Codex 스킬 파일(SKILL.md). */
|
|
106
|
+
export function renderSkill() {
|
|
107
|
+
return `---
|
|
108
|
+
name: odyssey
|
|
109
|
+
description: Odyssey(계획·기록·회고 앱) 사용자 데이터 — 할일·메모·루틴·기록(측정값)·일정·타임라인·프로젝트 보드·댓글·스냅샷·컬렉션 — 를 \`odyssey\` CLI 로 읽고 쓴다. 사용자가 Odyssey 나 그 안의 할일·메모·기록·일정·타임라인·보드를 언급하거나 다뤄 달라고 할 때, 여러 Odyssey 계정(-p 프로필)을 오갈 때 사용.
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
${renderSnippet()}`;
|
|
113
|
+
}
|
package/dist/index.js
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
* 이력: document/90-process/work-log/261010 Odyssey CLI 다계정 프로필 MCP CLI판.md
|
|
17
17
|
*/
|
|
18
18
|
import { readFileSync } from 'node:fs';
|
|
19
|
-
import { dirname, join } from 'node:path';
|
|
19
|
+
import { dirname, join, resolve as resolvePath } from 'node:path';
|
|
20
20
|
import { fileURLToPath } from 'node:url';
|
|
21
21
|
import { createInterface } from 'node:readline';
|
|
22
22
|
import { AuthRequiredError, DEFAULT_PROFILE, DEFAULT_SERVER, UsageError, assertProfileName, credentialsPath, loadCredentials, normalizeServer, updateCredentials, } from './config.js';
|
|
@@ -26,10 +26,16 @@ import { NetworkError } from './rpc.js';
|
|
|
26
26
|
import { envServer, OdysseyClient, resolveTarget, selectedProfileName } from './session.js';
|
|
27
27
|
import { findTool, getTools, renderToolDetail, renderToolList, toolListJson } from './tools.js';
|
|
28
28
|
import { printToolResult, writeJson } from './output.js';
|
|
29
|
+
import { inlineImageFiles } from './files.js';
|
|
30
|
+
import { renderAgentGuide, renderSkill, renderSnippet } from './guide.js';
|
|
31
|
+
import { cmdWatch, WATCH_HELP } from './watch.js';
|
|
32
|
+
import { cmdWatchAgent, WATCH_AGENT_HELP } from './watch-agent.js';
|
|
29
33
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
30
34
|
const VERSION = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8')).version;
|
|
31
35
|
const HELP = `Odyssey CLI v${VERSION} — Odyssey 계정의 할일·메모·보드·스냅샷을 터미널과 AI 에이전트에서 다룬다.
|
|
32
36
|
|
|
37
|
+
AI 에이전트라면 먼저: odyssey agent-guide (사용법·로그인된 계정·서버 사용 지침)
|
|
38
|
+
|
|
33
39
|
사용법
|
|
34
40
|
odyssey <도구> [--파라미터 값 ...] 도구 실행 (예: odyssey list_todos --status inProgress)
|
|
35
41
|
odyssey tools [검색어] 도구 목록
|
|
@@ -43,6 +49,17 @@ const HELP = `Odyssey CLI v${VERSION} — Odyssey 계정의 할일·메모·보
|
|
|
43
49
|
odyssey profiles 로그인된 프로필 목록
|
|
44
50
|
odyssey use <이름> 기본 프로필 바꾸기
|
|
45
51
|
|
|
52
|
+
실시간 감시
|
|
53
|
+
odyssey watch-agent init <폴더> 감시 에이전트 예제를 새 폴더에 준비(설정·검사 포함)
|
|
54
|
+
odyssey watch [--tag 태그 ...] 내 할일(태그)·내 댓글 변화를 한 줄에 JSON 하나씩(NDJSON) 흘린다
|
|
55
|
+
자세히: odyssey watch --help
|
|
56
|
+
|
|
57
|
+
AI 에이전트
|
|
58
|
+
odyssey agent-guide 에이전트용 설명서(사용법 + 계정 + 서버 사용 지침 실시간)
|
|
59
|
+
odyssey agent-guide --skill Claude Code·Codex 스킬 파일(SKILL.md) 내용
|
|
60
|
+
odyssey agent-guide --snippet AGENTS.md·CLAUDE.md·GEMINI.md 에 붙일 짧은 절
|
|
61
|
+
odyssey agent-guide --watch-agent 감시 에이전트(watch → 세션 깨우기, 답글은 세션이)를 만들게 하는 프롬프트
|
|
62
|
+
|
|
46
63
|
전역 옵션
|
|
47
64
|
-p, --profile <이름> 이번 실행의 계정. 기본: ODYSSEY_PROFILE → odyssey use 값 → default
|
|
48
65
|
-o, --output <형식> json(기본) · text(요약 텍스트) · raw(MCP 결과 전체)
|
|
@@ -298,6 +315,62 @@ function cmdUse(_g, args) {
|
|
|
298
315
|
process.stdout.write(`✓ 기본 프로필: ${name}\n`);
|
|
299
316
|
return 0;
|
|
300
317
|
}
|
|
318
|
+
// ── 에이전트 설명서 ──────────────────────────────────────────────────────────
|
|
319
|
+
async function cmdAgentGuide(g, args) {
|
|
320
|
+
const skill = takeFlag(args, '--skill');
|
|
321
|
+
const snippet = takeFlag(args, '--snippet');
|
|
322
|
+
const watchAgent = takeFlag(args, '--watch-agent');
|
|
323
|
+
if (args.length || [skill, snippet, watchAgent].filter(Boolean).length > 1) {
|
|
324
|
+
throw new UsageError('사용법: odyssey agent-guide [--skill | --snippet | --watch-agent]');
|
|
325
|
+
}
|
|
326
|
+
// 감시 에이전트(디스패처)를 코딩 에이전트에게 만들게 하는 프롬프트 — 패키지의 prompts/watch-agent.md 그대로.
|
|
327
|
+
// 이력: document/90-process/work-log/261016 Odyssey CLI 감시 에이전트 만들기 프롬프트 watch-agent.md
|
|
328
|
+
// document/90-process/work-log/261018 컴패니언 백그라운드 끊김 이어 하기 CompanionAppPresence 감시 에이전트 A.md(A안 — 배달만)
|
|
329
|
+
if (watchAgent) {
|
|
330
|
+
process.stdout.write(readFileSync(join(__dirname, '..', 'prompts', 'watch-agent.md'), 'utf-8'));
|
|
331
|
+
return 0;
|
|
332
|
+
}
|
|
333
|
+
if (skill || snippet) {
|
|
334
|
+
process.stdout.write(skill ? renderSkill() : renderSnippet());
|
|
335
|
+
return 0;
|
|
336
|
+
}
|
|
337
|
+
const file = loadCredentials();
|
|
338
|
+
const profiles = Object.entries(file.profiles).map(([name, p]) => ({
|
|
339
|
+
name,
|
|
340
|
+
isDefault: file.defaultProfile === name,
|
|
341
|
+
auth: p.credential.type,
|
|
342
|
+
...(p.account?.email ? { email: p.account.email } : {}),
|
|
343
|
+
...(p.account?.uid ? { uid: p.account.uid } : {}),
|
|
344
|
+
}));
|
|
345
|
+
const envToken = !!(process.env.ODYSSEY_TOKEN ?? process.env.ODYSSEY_API_KEY ?? '').trim();
|
|
346
|
+
// 서버 사용 지침 — 로그인 전이거나 연결이 안 돼도 설명서는 낸다(그 사실을 적어서).
|
|
347
|
+
let server = normalizeServer(g.server ?? envServer() ?? DEFAULT_SERVER);
|
|
348
|
+
let instructionsFrom = null;
|
|
349
|
+
let serverInstructions;
|
|
350
|
+
let serverInstructionsError;
|
|
351
|
+
try {
|
|
352
|
+
const target = resolveTarget(g);
|
|
353
|
+
server = target.server;
|
|
354
|
+
instructionsFrom = target.profileName;
|
|
355
|
+
serverInstructions = (await new OdysseyClient(target, VERSION).serverInfo()).instructions;
|
|
356
|
+
if (!serverInstructions)
|
|
357
|
+
serverInstructionsError = '서버가 지침을 보내지 않았다';
|
|
358
|
+
}
|
|
359
|
+
catch (e) {
|
|
360
|
+
serverInstructionsError =
|
|
361
|
+
e instanceof AuthRequiredError ? '로그인 전' : e instanceof NetworkError ? '서버에 연결하지 못함' : e.message;
|
|
362
|
+
}
|
|
363
|
+
process.stdout.write(renderAgentGuide({
|
|
364
|
+
version: VERSION,
|
|
365
|
+
server,
|
|
366
|
+
profiles,
|
|
367
|
+
envToken,
|
|
368
|
+
instructionsFrom,
|
|
369
|
+
...(serverInstructions ? { serverInstructions } : {}),
|
|
370
|
+
...(serverInstructionsError ? { serverInstructionsError } : {}),
|
|
371
|
+
}));
|
|
372
|
+
return 0;
|
|
373
|
+
}
|
|
301
374
|
// ── 도구 명령 ────────────────────────────────────────────────────────────────
|
|
302
375
|
async function cmdTools(g, args) {
|
|
303
376
|
if (args.length > 1)
|
|
@@ -341,11 +414,14 @@ async function cmdCall(g, toolName, tokens) {
|
|
|
341
414
|
(missing.length === 1 && (tool.inputSchema?.required ?? []).length === 1 ? ' (위치 인자로도 됩니다)' : '') +
|
|
342
415
|
`\n자세히: odyssey describe ${tool.name}`);
|
|
343
416
|
}
|
|
417
|
+
// 사진 칸의 로컬 파일(image.file)을 바이트로 바꿔 싣는다 — 상대 경로는 --input 파일 옆 기준.
|
|
418
|
+
const baseDir = g.inputFile && g.inputFile !== '-' ? dirname(resolvePath(g.inputFile)) : process.cwd();
|
|
419
|
+
inlineImageFiles(args, baseDir);
|
|
344
420
|
const result = await client.callTool(tool.name, args);
|
|
345
421
|
return printToolResult(result, g.output ?? 'json', tool.name);
|
|
346
422
|
}
|
|
347
423
|
// ── 진입 ─────────────────────────────────────────────────────────────────────
|
|
348
|
-
const ACCOUNT_COMMANDS = new Set(['login', 'logout', 'whoami', 'profiles', 'use']);
|
|
424
|
+
const ACCOUNT_COMMANDS = new Set(['login', 'logout', 'whoami', 'profiles', 'use', 'agent-guide', 'watch', 'watch-agent']);
|
|
349
425
|
async function main(argv) {
|
|
350
426
|
const { globals: g, rest } = extractGlobals(argv);
|
|
351
427
|
if (g.profile !== undefined)
|
|
@@ -361,6 +437,14 @@ async function main(argv) {
|
|
|
361
437
|
process.stdout.write(HELP);
|
|
362
438
|
return command || g.help ? 0 : 2;
|
|
363
439
|
}
|
|
440
|
+
if (g.help && command === 'watch') {
|
|
441
|
+
process.stdout.write(`${WATCH_HELP}\n`);
|
|
442
|
+
return 0;
|
|
443
|
+
}
|
|
444
|
+
if (g.help && command === 'watch-agent') {
|
|
445
|
+
process.stdout.write(`${WATCH_AGENT_HELP}\n`);
|
|
446
|
+
return 0;
|
|
447
|
+
}
|
|
364
448
|
if (g.help) {
|
|
365
449
|
// odyssey <도구> --help → 그 도구 설명
|
|
366
450
|
if (!ACCOUNT_COMMANDS.has(command) && command !== 'tools' && command !== 'describe' && command !== 'call') {
|
|
@@ -380,6 +464,12 @@ async function main(argv) {
|
|
|
380
464
|
return cmdProfiles(g, args);
|
|
381
465
|
case 'use':
|
|
382
466
|
return cmdUse(g, args);
|
|
467
|
+
case 'agent-guide':
|
|
468
|
+
return cmdAgentGuide(g, args);
|
|
469
|
+
case 'watch':
|
|
470
|
+
return cmdWatch(g, args, VERSION);
|
|
471
|
+
case 'watch-agent':
|
|
472
|
+
return cmdWatchAgent(g, args);
|
|
383
473
|
case 'tools':
|
|
384
474
|
return cmdTools(g, args);
|
|
385
475
|
case 'describe':
|
package/dist/oauth.js
CHANGED
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
import { createHash, randomBytes } from 'node:crypto';
|
|
16
16
|
import { createServer } from 'node:http';
|
|
17
17
|
import { spawn } from 'node:child_process';
|
|
18
|
-
import { errorMessageFromBody,
|
|
18
|
+
import { errorMessageFromBody, fetchText } from './rpc.js';
|
|
19
19
|
export const CLIENT_NAME = 'Odyssey CLI';
|
|
20
20
|
export const LOGIN_SCOPE = 'mcp openid email';
|
|
21
21
|
const REGISTERED_REDIRECT = 'http://127.0.0.1/callback';
|
|
@@ -39,14 +39,7 @@ export function createPkce() {
|
|
|
39
39
|
return { verifier, challenge };
|
|
40
40
|
}
|
|
41
41
|
async function fetchJson(url, init, server) {
|
|
42
|
-
|
|
43
|
-
try {
|
|
44
|
-
res = await fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs()) });
|
|
45
|
-
}
|
|
46
|
-
catch (e) {
|
|
47
|
-
throw new NetworkError(describeFetchError(e, server));
|
|
48
|
-
}
|
|
49
|
-
const body = await res.text();
|
|
42
|
+
const { response: res, body } = await fetchText(url, init, server);
|
|
50
43
|
let json = null;
|
|
51
44
|
try {
|
|
52
45
|
json = JSON.parse(body);
|
package/dist/rpc.js
CHANGED
|
@@ -44,6 +44,21 @@ export function timeoutMs() {
|
|
|
44
44
|
const v = Number(process.env.ODYSSEY_TIMEOUT_MS);
|
|
45
45
|
return Number.isFinite(v) && v > 0 ? v : 120_000;
|
|
46
46
|
}
|
|
47
|
+
/**
|
|
48
|
+
* 요청 시작부터 본문 수신 완료까지 같은 제한시간·네트워크 오류 계약을 적용한다.
|
|
49
|
+
* 헤더를 받은 뒤에도 연결 중단·타임아웃이 날 수 있으므로 본문 읽기를 함께 감싼다.
|
|
50
|
+
* 이력: document/90-process/work-log/261022 Odyssey CLI 배포 안정성 npm watch 감시 에이전트 감사.md
|
|
51
|
+
*/
|
|
52
|
+
export async function fetchText(url, init, server) {
|
|
53
|
+
try {
|
|
54
|
+
const response = await fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs()) });
|
|
55
|
+
const body = await response.text();
|
|
56
|
+
return { response, body };
|
|
57
|
+
}
|
|
58
|
+
catch (e) {
|
|
59
|
+
throw new NetworkError(describeFetchError(e, server));
|
|
60
|
+
}
|
|
61
|
+
}
|
|
47
62
|
/** SSE 본문에서 JSON 메시지들을 꺼낸다. 이벤트 경계=빈 줄, 여러 data 줄은 \n 으로 잇는다. */
|
|
48
63
|
export function parseSseMessages(body) {
|
|
49
64
|
const out = [];
|
|
@@ -117,19 +132,11 @@ export async function postRpc(opts, method, params) {
|
|
|
117
132
|
}
|
|
118
133
|
if (opts.userAgent)
|
|
119
134
|
headers['User-Agent'] = opts.userAgent;
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
body: JSON.stringify({ jsonrpc: '2.0', id, method, ...(params === undefined ? {} : { params }) }),
|
|
126
|
-
signal: AbortSignal.timeout(timeoutMs()),
|
|
127
|
-
});
|
|
128
|
-
}
|
|
129
|
-
catch (e) {
|
|
130
|
-
throw new NetworkError(describeFetchError(e, opts.server));
|
|
131
|
-
}
|
|
132
|
-
const body = await res.text();
|
|
135
|
+
const { response: res, body } = await fetchText(endpointUrl(opts.server), {
|
|
136
|
+
method: 'POST',
|
|
137
|
+
headers,
|
|
138
|
+
body: JSON.stringify({ jsonrpc: '2.0', id, method, ...(params === undefined ? {} : { params }) }),
|
|
139
|
+
}, opts.server);
|
|
133
140
|
if (!res.ok) {
|
|
134
141
|
throw new HttpError(res.status, errorMessageFromBody(body), res.headers.get('www-authenticate') ?? undefined);
|
|
135
142
|
}
|