@odyssey365/cli 0.2.5 → 0.3.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.
@@ -0,0 +1,90 @@
1
+ /**
2
+ * 올리기 전 글 다듬기(설계 §11.3) — 비밀 값 가림 · 답 상한 · 답 속 미디어 경로 찾기.
3
+ * 서버(agent_message_post)도 같은 가림 · 상한을 한다 — 여기는 디스크(outbox)에 남기기 전 한 겹 더.
4
+ */
5
+ import { existsSync, realpathSync, statSync } from 'node:fs';
6
+ import { basename, isAbsolute, resolve, sep } from 'node:path';
7
+ import { MEDIA_EXTS } from './api.js';
8
+ export const MESSAGE_MAX_CHARS = 8000;
9
+ const SECRET_PATTERNS = [
10
+ /\bsk-[A-Za-z0-9_-]{16,}/g, // OpenAI · Anthropic(sk-ant-…)
11
+ /\bAKIA[0-9A-Z]{16}\b/g, // AWS 키 id
12
+ /\bgh[pousr]_[A-Za-z0-9]{30,}\b/g, // GitHub 토큰
13
+ /\bxox[abpr]-[A-Za-z0-9-]{10,}/g, // Slack
14
+ /\bAIza[0-9A-Za-z_-]{35}\b/g, // Google API 키
15
+ /\bod[kt]_[A-Za-z0-9_-]{16,}/g, // Odyssey API 키 · 토큰
16
+ /\boat_[A-Za-z0-9_-]{16,}/g,
17
+ /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g,
18
+ ];
19
+ /** 긴 base64 — 경로(슬래시 여럿) · 한 가지 글자만 있는 긴 낱말은 빼고, 대 · 소문자 · 숫자가 섞인 것만. */
20
+ const LONG_B64 = /[A-Za-z0-9+/]{48,}={0,2}/g;
21
+ function looksLikeKey(s) {
22
+ return (s.match(/\//g)?.length ?? 0) < 3 && /[A-Z]/.test(s) && /[a-z]/.test(s) && /[0-9]/.test(s);
23
+ }
24
+ /** `.env` 줄 꼴(KEY=값) 중 이름이 비밀스러운 것. */
25
+ const ENV_LINE = /^(\s*(?:export\s+)?[A-Z0-9_]*(?:SECRET|TOKEN|PASSWORD|PASSWD|API_KEY|APIKEY|PRIVATE_KEY|ACCESS_KEY)[A-Z0-9_]*\s*=\s*)(\S.*)$/gim;
26
+ export function redactSecrets(text) {
27
+ let out = text.replace(ENV_LINE, (_m, head) => `${head}[가림]`);
28
+ for (const re of SECRET_PATTERNS)
29
+ out = out.replace(re, '[가림]');
30
+ return out.replace(LONG_B64, (m) => (looksLikeKey(m) ? '[가림]' : m));
31
+ }
32
+ export function clampMessage(text, max = MESSAGE_MAX_CHARS) {
33
+ if (text.length <= max)
34
+ return text;
35
+ return `${text.slice(0, max)}\n…(컴퓨터에서 이어 보기)`;
36
+ }
37
+ export function cleanText(text) {
38
+ return clampMessage(redactSecrets(text));
39
+ }
40
+ /** 세션 제목 — 첫 프롬프트 앞부분. */
41
+ export function titleOf(prompt) {
42
+ const one = prompt.replace(/\s+/g, ' ').trim();
43
+ return one.length > 60 ? `${one.slice(0, 60)}…` : one;
44
+ }
45
+ /**
46
+ * 답 속의 이미지 · 영상 경로 — **작업 폴더 안**의 있는 파일만(폴더 밖 · 숨김 경로 제외, 설계 §9.2 안전망).
47
+ * 마크다운 이미지 `![](p)` · 링크 `[](p)` · 백틱 `` `p` `` · 맨 경로를 다 본다. 상대 경로는 cwd 기준.
48
+ */
49
+ export function findMediaPaths(text, cwd, workspaceRoot) {
50
+ const exts = MEDIA_EXTS.map((e) => e.slice(1)).join('|');
51
+ // 경로 앞뒤 구분자 — 마크다운 링크 · 코드 · 따옴표 · 괄호 · 공백, 그리고 강조(**굵게** · _기울임_)도(261122 E2E: 「**./clip.mov**」를 놓쳤다).
52
+ const re = new RegExp(`(?:\\]\\(|\`|["'(\\s*_]|^)((?:~|\\.{1,2})?[^\\s\`"'()<>\\[\\]*]*\\.(?:${exts}))(?=[)\`"'\\s.,;:!?*_]|$)`, 'gim');
53
+ const real = (p) => {
54
+ try {
55
+ return realpathSync(p);
56
+ }
57
+ catch {
58
+ return p;
59
+ }
60
+ };
61
+ const root = real(resolve(workspaceRoot));
62
+ const found = [];
63
+ for (const m of text.matchAll(re)) {
64
+ let p = m[1];
65
+ if (!p || /^[a-z]+:\/\//i.test(p))
66
+ continue;
67
+ if (p.startsWith('file://'))
68
+ p = p.slice(7);
69
+ if (p.startsWith('~'))
70
+ continue; // 홈 경로 = 작업 폴더 밖
71
+ const abs = real(isAbsolute(p) ? resolve(p) : resolve(cwd, p)); // 심볼릭 링크(/var → /private/var)를 풀어 비교
72
+ if (!(abs === root || abs.startsWith(root.endsWith(sep) ? root : root + sep)))
73
+ continue;
74
+ const rel = abs.slice(root.length);
75
+ if (rel.split(sep).some((part) => part.startsWith('.') && part.length > 1))
76
+ continue; // 숨김 폴더 · 파일
77
+ if (basename(abs).startsWith('.'))
78
+ continue;
79
+ try {
80
+ if (!existsSync(abs) || !statSync(abs).isFile())
81
+ continue;
82
+ }
83
+ catch {
84
+ continue;
85
+ }
86
+ if (!found.includes(abs))
87
+ found.push(abs);
88
+ }
89
+ return found;
90
+ }
@@ -0,0 +1,107 @@
1
+ /**
2
+ * 클로드 코드 transcript(JSONL) 읽기 — Stop 훅이 마지막 턴의 답 · 활동 요약을 뽑는다.
3
+ *
4
+ * 줄 꼴(claude 2.1.3xx 실측): `{type:'user'|'assistant'|'system'|…, isSidechain, uuid, promptId?, isMeta?, entrypoint?,
5
+ * message:{id?, role, content: string | [{type:'text'|'tool_use'|'tool_result'|'thinking'|'image', …}]}}`.
6
+ * 한 assistant 메시지(message.id)가 내용 블록마다 줄로 갈라져 온다. 서브에이전트 대화는 isSidechain:true(빼고 센다).
7
+ */
8
+ import { readFileSync } from 'node:fs';
9
+ const FILE_TOOLS = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit']);
10
+ const COMMAND_TOOLS = new Set(['Bash', 'PowerShell']);
11
+ /** 진짜 사용자 프롬프트 줄인가 — 도구 결과만 있는 user 줄 · 메타(명령 안내 등)는 아니다. */
12
+ function isPrompt(l) {
13
+ if (l.type !== 'user' || l.isSidechain || l.isMeta)
14
+ return false;
15
+ const c = l.message?.content;
16
+ if (typeof c === 'string')
17
+ return c.trim().length > 0 && !c.startsWith('<local-command') && !c.startsWith('<command-');
18
+ if (!Array.isArray(c))
19
+ return false;
20
+ return c.some((b) => b.type === 'text' || b.type === 'image') && !c.some((b) => b.type === 'tool_result');
21
+ }
22
+ function promptText(l) {
23
+ const c = l.message?.content;
24
+ if (typeof c === 'string')
25
+ return c;
26
+ return (c ?? []).filter((b) => b.type === 'text').map((b) => b.text ?? '').join('\n');
27
+ }
28
+ export function parseTranscriptLines(lines) {
29
+ const parsed = [];
30
+ for (const raw of lines) {
31
+ if (!raw.trim())
32
+ continue;
33
+ try {
34
+ parsed.push(JSON.parse(raw));
35
+ }
36
+ catch {
37
+ // 쓰는 중인 마지막 줄 · 깨진 줄
38
+ }
39
+ }
40
+ let start = -1;
41
+ for (let i = parsed.length - 1; i >= 0; i--) {
42
+ if (isPrompt(parsed[i])) {
43
+ start = i;
44
+ break;
45
+ }
46
+ }
47
+ const prompt = start >= 0 ? parsed[start] : null;
48
+ const desktop = parsed.some((l) => l.entrypoint === 'claude-desktop');
49
+ const summary = { calls: 0, filesChanged: 0, commands: 0 };
50
+ const files = new Set();
51
+ let lastId = null;
52
+ const textById = new Map();
53
+ for (let i = start + 1; i < parsed.length; i++) {
54
+ const l = parsed[i];
55
+ if (l.type !== 'assistant' || l.isSidechain)
56
+ continue;
57
+ const c = l.message?.content;
58
+ if (!Array.isArray(c))
59
+ continue;
60
+ const id = l.message?.id ?? l.uuid ?? `line-${i}`;
61
+ for (const b of c) {
62
+ if (b.type === 'tool_use') {
63
+ summary.calls++;
64
+ if (b.name && FILE_TOOLS.has(b.name)) {
65
+ const p = (b.input?.file_path ?? b.input?.notebook_path ?? '');
66
+ files.add(p || `${id}-${summary.calls}`);
67
+ }
68
+ if (b.name && COMMAND_TOOLS.has(b.name))
69
+ summary.commands++;
70
+ }
71
+ else if (b.type === 'text' && b.text && b.text.trim()) {
72
+ if (!textById.has(id))
73
+ textById.set(id, []);
74
+ textById.get(id).push(b.text);
75
+ lastId = id;
76
+ }
77
+ }
78
+ }
79
+ summary.filesChanged = files.size;
80
+ const images = [];
81
+ const pc = prompt?.message?.content;
82
+ if (Array.isArray(pc)) {
83
+ for (const b of pc) {
84
+ if (b.type === 'image' && b.source?.type === 'base64' && b.source.data && b.source.media_type) {
85
+ images.push({ mime: b.source.media_type, data: b.source.data });
86
+ }
87
+ }
88
+ }
89
+ return {
90
+ prompt: prompt ? promptText(prompt) : null,
91
+ promptUuid: prompt?.uuid ?? null,
92
+ promptId: prompt?.promptId ?? null,
93
+ promptImages: images,
94
+ text: lastId ? textById.get(lastId).join('\n\n') : '',
95
+ messageId: lastId,
96
+ toolSummary: summary,
97
+ desktop,
98
+ };
99
+ }
100
+ export function readTranscript(path) {
101
+ try {
102
+ return parseTranscriptLines(readFileSync(path, 'utf-8').split('\n'));
103
+ }
104
+ catch {
105
+ return null;
106
+ }
107
+ }
@@ -0,0 +1,118 @@
1
+ /**
2
+ * 등록한 작업 폴더(설계 §11.6) — 등록은 컴퓨터에서만, 폴더마다 이름(필수) · 올리기 방식(all · appOnly).
3
+ * 앱 · 서버에는 id · 이름 · mirror 만 간다. 경로는 `workspaces.json` 에만 있다.
4
+ */
5
+ import { realpathSync, statSync } from 'node:fs';
6
+ import { basename, resolve, sep } from 'node:path';
7
+ import { UsageError } from '../config.js';
8
+ import { newId, paths, readJson, writeJson } from './store.js';
9
+ export function loadWorkspaces() {
10
+ const f = readJson(paths.workspaces(), {});
11
+ return Array.isArray(f.workspaces) ? f.workspaces.filter((w) => w && w.id && w.path && w.name) : [];
12
+ }
13
+ function save(list) {
14
+ writeJson(paths.workspaces(), { version: 1, workspaces: list });
15
+ }
16
+ /** 심볼릭 링크 · 상대 경로를 풀어 비교 가능한 절대 경로로. 없는 경로면 resolve 만. */
17
+ export function canonicalPath(p) {
18
+ const abs = resolve(p);
19
+ try {
20
+ return realpathSync(abs);
21
+ }
22
+ catch {
23
+ return abs;
24
+ }
25
+ }
26
+ /** 서버에 보낼 꼴 — 이름 · mirror 만. */
27
+ export function publicWorkspaces(list = loadWorkspaces()) {
28
+ return list.map((w) => ({ id: w.id, name: w.name, mirror: w.mirror }));
29
+ }
30
+ /** cwd 를 품는 가장 가까운(가장 깊은) 등록 폴더. 없으면 null — 등록 밖 세션은 미러링도 실행도 하지 않는다. */
31
+ export function findWorkspace(cwd, list = loadWorkspaces()) {
32
+ if (!cwd)
33
+ return null;
34
+ const c = canonicalPath(cwd);
35
+ let best = null;
36
+ for (const w of list) {
37
+ const root = canonicalPath(w.path);
38
+ if (c === root || c.startsWith(root.endsWith(sep) ? root : root + sep)) {
39
+ if (!best || root.length > canonicalPath(best.path).length)
40
+ best = w;
41
+ }
42
+ }
43
+ return best;
44
+ }
45
+ export function workspaceById(id, list = loadWorkspaces()) {
46
+ if (!id)
47
+ return null;
48
+ return list.find((w) => w.id === id) ?? null;
49
+ }
50
+ function findByRef(ref, list) {
51
+ const asPath = canonicalPath(ref);
52
+ return list.find((w) => w.id === ref) ?? list.find((w) => canonicalPath(w.path) === asPath) ?? list.find((w) => w.name === ref);
53
+ }
54
+ export function suggestName(path) {
55
+ return basename(canonicalPath(path)) || 'workspace';
56
+ }
57
+ export function addWorkspace(path, name, appOnly) {
58
+ const abs = canonicalPath(path);
59
+ let isDir = false;
60
+ try {
61
+ isDir = statSync(abs).isDirectory();
62
+ }
63
+ catch {
64
+ isDir = false;
65
+ }
66
+ if (!isDir)
67
+ throw new UsageError(`폴더가 아닙니다: ${abs}`);
68
+ const n = (name ?? '').trim();
69
+ if (!n)
70
+ throw new UsageError('작업 폴더에는 이름이 필요합니다(--name). 앱에는 이 이름만 보입니다.');
71
+ if (n.length > 40)
72
+ throw new UsageError('작업 폴더 이름은 40자까지입니다.');
73
+ const list = loadWorkspaces();
74
+ const existing = list.find((w) => canonicalPath(w.path) === abs);
75
+ if (existing) {
76
+ existing.name = n;
77
+ existing.mirror = appOnly ? 'appOnly' : 'all';
78
+ save(list);
79
+ return existing;
80
+ }
81
+ if (list.some((w) => w.name === n))
82
+ throw new UsageError(`같은 이름의 작업 폴더가 이미 있습니다: ${n}`);
83
+ const w = { id: newId('ws'), name: n, path: abs, mirror: appOnly ? 'appOnly' : 'all', addedAt: new Date().toISOString() };
84
+ list.push(w);
85
+ save(list);
86
+ return w;
87
+ }
88
+ export function renameWorkspace(ref, name) {
89
+ const n = name.trim();
90
+ if (!n)
91
+ throw new UsageError('새 이름이 비었습니다.');
92
+ const list = loadWorkspaces();
93
+ const w = findByRef(ref, list);
94
+ if (!w)
95
+ throw new UsageError(`등록된 작업 폴더가 아닙니다: ${ref}`);
96
+ if (list.some((x) => x !== w && x.name === n))
97
+ throw new UsageError(`같은 이름의 작업 폴더가 이미 있습니다: ${n}`);
98
+ w.name = n;
99
+ save(list);
100
+ return w;
101
+ }
102
+ export function setWorkspaceMirror(ref, appOnly) {
103
+ const list = loadWorkspaces();
104
+ const w = findByRef(ref, list);
105
+ if (!w)
106
+ throw new UsageError(`등록된 작업 폴더가 아닙니다: ${ref}`);
107
+ w.mirror = appOnly ? 'appOnly' : 'all';
108
+ save(list);
109
+ return w;
110
+ }
111
+ export function removeWorkspace(ref) {
112
+ const list = loadWorkspaces();
113
+ const w = findByRef(ref, list);
114
+ if (!w)
115
+ throw new UsageError(`등록된 작업 폴더가 아닙니다: ${ref}`);
116
+ save(list.filter((x) => x !== w));
117
+ return w;
118
+ }
package/dist/files.js CHANGED
@@ -8,7 +8,8 @@
8
8
  *
9
9
  * 바꾸는 자리(앱에서 사람이 사진을 넣는 세 곳과 같다):
10
10
  * - `image: { file }` — 페이지 사진 칸(create_page · update_page · create_page_draft — 옛 이름 *_snapshot*).
11
- * - `uploadImages: [{ file }]` — 할일·메모 본문 끝(create_todo · update_todo · create_memo · update_memo).
11
+ * - `uploadImages: [{ file }]` — 할일·메모 본문 끝(create_todo · update_todo · create_memo · update_memo) · 리포트 원고 끝 삽화
12
+ * (create_report · update_report).
12
13
  * - `files: ["경로", …]` — 에셋(save_asset — 옛 create_asset · add_asset_images) → `uploads: [{ uploadId, index }]`.
13
14
  * 에셋은 사진뿐 아니라 PDF·문서·소리도 담으므로, 이 자리가 있으면 주소를 `accept:'files'` 로 받는다(서버가 내용으로 판정한다).
14
15
  * 이름이 다른 키의 `file` 은 손대지 않는다 — 다른 도구의 문자열을 파일로 오인해 읽어 보내면 안 된다.
@@ -0,0 +1,32 @@
1
+ /**
2
+ * CLI 자격 → Firebase(App Check + 커스텀 토큰) → Firestore — `odyssey watch` 와 `odyssey agent daemon` 이 같이 쓴다.
3
+ * 자격 수명 · 회수 설명은 watch.ts 머리말. Firebase JS SDK 는 여기서만 동적으로 불러온다(다른 명령은 의존성 없이 뜬다).
4
+ */
5
+ import { UsageError } from './config.js';
6
+ export async function connectFirestore(client, appName) {
7
+ let session = await client.firebaseSession();
8
+ let sessionAt = Date.now();
9
+ const { initializeApp } = await import('firebase/app');
10
+ const { initializeAppCheck, CustomProvider } = await import('firebase/app-check');
11
+ const { getAuth, signInWithCustomToken } = await import('firebase/auth');
12
+ const fs = await import('firebase/firestore');
13
+ const app = initializeApp(session.firebase, appName);
14
+ initializeAppCheck(app, {
15
+ provider: new CustomProvider({
16
+ // SDK 는 토큰이 다 됐을 때만 다시 부른다. 처음 한 번은 교환에서 받은 것을 쓰고, 그 뒤는 다시 교환한다.
17
+ getToken: async () => {
18
+ if (Date.now() - sessionAt > 60_000) {
19
+ session = await client.firebaseSession();
20
+ sessionAt = Date.now();
21
+ }
22
+ return { token: session.appCheck.token, expireTimeMillis: sessionAt + session.appCheck.ttlMillis };
23
+ },
24
+ }),
25
+ isTokenAutoRefreshEnabled: false,
26
+ });
27
+ const signedIn = await signInWithCustomToken(getAuth(app), session.customToken);
28
+ if (signedIn.user.uid !== session.firebaseUid) {
29
+ throw new UsageError('Firebase 신원이 CLI 전용 세션과 일치하지 않습니다. 서버의 감시 보안 업데이트가 필요합니다.');
30
+ }
31
+ return { fs, db: fs.getFirestore(app), uid: session.uid };
32
+ }
package/dist/index.js CHANGED
@@ -30,6 +30,7 @@ import { collectLocalFiles, inlineImageFiles, uploadLocalFiles } from './files.j
30
30
  import { renderAgentGuide, renderSkill, renderSnippet } from './guide.js';
31
31
  import { cmdWatch, WATCH_HELP } from './watch.js';
32
32
  import { cmdWatchAgent, WATCH_AGENT_HELP } from './watch-agent.js';
33
+ import { cmdAgent } from './agent/command.js';
33
34
  const __dirname = dirname(fileURLToPath(import.meta.url));
34
35
  const VERSION = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8')).version;
35
36
  const HELP = `Odyssey CLI v${VERSION} — Odyssey 계정의 할일·메모·보드·페이지를 터미널과 AI 에이전트에서 다룬다.
@@ -58,6 +59,10 @@ AI 에이전트라면 먼저: odyssey agent-guide (사용법·로그인된 계
58
59
  follow --days N: 감시 기간(일, 1~365 · 기본 14 — 뒤의 자동 등록도 이 기간으로)
59
60
  빼기는 마지막 답글 뒤에(뺀 뒤 댓글을 달면 다시 오른다) · 할일 완료로는 안 빠진다
60
61
 
62
+ 에이전트 브리지(클로드 코드 · 코덱스 세션을 앱 컴패니언 대화로)
63
+ odyssey agent setup 첫 설정(이름 · 이모지 · 미러링 · 작업 폴더 · 승인 · 잠자기 방지 · 자동 시작)
64
+ odyssey agent status|start|stop 상태 · 데몬 켜고 끄기 · 자세히: odyssey agent help (별칭 odyssey claude · odyssey codex)
65
+
61
66
  AI 에이전트
62
67
  odyssey agent-guide 에이전트용 설명서(사용법 + 계정 + 서버 사용 지침 실시간)
63
68
  odyssey agent-guide --skill Claude Code·Codex 스킬 파일(SKILL.md) 내용
@@ -546,6 +551,9 @@ async function main(argv) {
546
551
  process.stdout.write(`${WATCH_AGENT_HELP}\n`);
547
552
  return 0;
548
553
  }
554
+ if (command === 'agent' || command === 'claude' || command === 'codex') {
555
+ return cmdAgent(g, args, command === 'agent' ? undefined : command);
556
+ }
549
557
  if (g.help && command === 'threads') {
550
558
  const tool = THREADS_TOOLS[args[0] ?? 'list'];
551
559
  if (!tool)
package/dist/watch.js CHANGED
@@ -40,6 +40,7 @@
40
40
  */
41
41
  import { UsageError } from './config.js';
42
42
  import { OdysseyClient, resolveTarget } from './session.js';
43
+ import { connectFirestore } from './firebase-connect.js';
43
44
  import { activeFollowedRooms, activeTaggedRooms, commentAuthor, commentEvent, InChunks, isLiveComment, isTaggedRoom, TAG_SOURCES, tagThreadEvent, threadEvent, todoEvent, } from './watch-events.js';
44
45
  export const WATCH_HELP = `odyssey watch [--tag 태그 ...] [--no-tag-threads] [--no-comments] [--no-threads] [--include-agent] [--since ISO]
45
46
  내 계정의 변화를 실시간으로 받아 한 줄에 JSON 하나씩(NDJSON) stdout 으로 낸다. 끄려면 Ctrl+C.
@@ -50,6 +51,8 @@ export const WATCH_HELP = `odyssey watch [--tag 태그 ...] [--no-tag-threads] [
50
51
  --no-threads 관심 스레드(에이전트가 댓글을 남긴 방 · odyssey threads follow)를 보지 않는다
51
52
  --include-agent AI(MCP·컴패니언)가 단 댓글도 낸다(기본은 사람이 쓴 것만)
52
53
  --since <ISO> 이 시각 뒤의 댓글부터(기본: 지금). 밀린 댓글을 다시 받을 때
54
+ --bridge-turns <브리지 id> 에이전트 브리지 턴(주인 bridge:<id> · running)을 {"type":"turn",…} 으로 낸다(host = 세션의
55
+ external.host — 데스크톱 듣는 세션이 desktop 턴을 넘겨받는다 · odyssey agent status 의 bridgeId)
53
56
  이벤트: {"type":"ready"} · {"type":"todo",...} · {"type":"comment",...} · {"type":"thread",...} · {"type":"error",...}
54
57
  comment 의 followed:true = 관심 스레드의 댓글 · tagged:true = 태그 항목 스레드의 댓글(둘 다 남이 쓴 것은 author "other")
55
58
  replyTo = 답글이면 원 댓글과 그 작성자 · thread 의 source "tag" = 태그 항목의 방(태그를 떼면 reason "untagged" 로 빠진다)
@@ -79,6 +82,9 @@ export function parseWatchArgs(args, now = new Date()) {
79
82
  case '--no-threads':
80
83
  o.threads = false;
81
84
  break;
85
+ case '--bridge-turns':
86
+ o.bridgeTurns = value();
87
+ break;
82
88
  case '--include-agent':
83
89
  o.includeAgent = true;
84
90
  break;
@@ -96,7 +102,7 @@ export function parseWatchArgs(args, now = new Date()) {
96
102
  }
97
103
  if (o.tags.length > 30)
98
104
  throw new UsageError('--tag 는 30개까지입니다(Firestore array-contains-any 한도).');
99
- if (!o.tags.length && !o.comments && !o.threads) {
105
+ if (!o.tags.length && !o.comments && !o.threads && !o.bridgeTurns) {
100
106
  throw new UsageError('볼 것이 없습니다 — --tag 를 주거나 --no-comments·--no-threads 를 빼세요.');
101
107
  }
102
108
  return o;
@@ -108,32 +114,7 @@ export async function cmdWatch(g, args, version) {
108
114
  const opts = parseWatchArgs(args);
109
115
  const target = resolveTarget(g);
110
116
  const client = new OdysseyClient(target, version);
111
- let session = await client.firebaseSession();
112
- let sessionAt = Date.now();
113
- const { initializeApp } = await import('firebase/app');
114
- const { initializeAppCheck, CustomProvider } = await import('firebase/app-check');
115
- const { getAuth, signInWithCustomToken } = await import('firebase/auth');
116
- const fs = await import('firebase/firestore');
117
- const app = initializeApp(session.firebase, `odyssey-cli-${target.profileName ?? 'env'}`);
118
- initializeAppCheck(app, {
119
- provider: new CustomProvider({
120
- // SDK 는 토큰이 다 됐을 때만 다시 부른다. 처음 한 번은 교환에서 받은 것을 쓰고, 그 뒤는 다시 교환한다.
121
- getToken: async () => {
122
- if (Date.now() - sessionAt > 60_000) {
123
- session = await client.firebaseSession();
124
- sessionAt = Date.now();
125
- }
126
- return { token: session.appCheck.token, expireTimeMillis: sessionAt + session.appCheck.ttlMillis };
127
- },
128
- }),
129
- isTokenAutoRefreshEnabled: false,
130
- });
131
- const signedIn = await signInWithCustomToken(getAuth(app), session.customToken);
132
- if (signedIn.user.uid !== session.firebaseUid) {
133
- throw new UsageError('Firebase 신원이 CLI 전용 세션과 일치하지 않습니다. 서버의 감시 보안 업데이트가 필요합니다.');
134
- }
135
- const db = fs.getFirestore(app);
136
- const uid = session.uid;
117
+ const { fs, db, uid } = await connectFirestore(client, `odyssey-cli-${target.profileName ?? 'env'}`);
137
118
  const unsubs = [];
138
119
  const streams = [];
139
120
  const pending = new Set();
@@ -420,6 +401,63 @@ export async function cmdWatch(g, args, version) {
420
401
  }));
421
402
  }
422
403
  }
404
+ if (opts.bridgeTurns) {
405
+ // 에이전트 브리지 턴(설계 §6.3) — 주인이 이 브리지인 running 턴. 세션 host 를 함께 실어 듣기가 desktop 만 고른다.
406
+ // 세션 문서를 못 읽는 서버 규칙이면 host 는 null(듣기가 bridge 데몬 몫으로 본다).
407
+ streams.push('turns');
408
+ pending.add('turns');
409
+ let first = true;
410
+ const hosts = new Map();
411
+ const hostOf = async (sessionUid) => {
412
+ try {
413
+ const snap = await fs.getDoc(fs.doc(db, 'user', uid, 'companion_session', sessionUid));
414
+ const ext = snap.data()?.external ?? {};
415
+ const host = typeof ext.host === 'string' ? ext.host : null;
416
+ hosts.set(sessionUid, host);
417
+ return {
418
+ host,
419
+ workspaceName: typeof ext.workspaceName === 'string' ? ext.workspaceName : null,
420
+ externalSessionId: typeof ext.externalSessionId === 'string' ? ext.externalSessionId : null,
421
+ };
422
+ }
423
+ catch {
424
+ return { host: hosts.get(sessionUid) ?? null, workspaceName: null, externalSessionId: null };
425
+ }
426
+ };
427
+ const seenTurns = new Set();
428
+ const q = fs.query(fs.collection(db, 'user', uid, 'companion_turn'), fs.where('leaseOwner', '==', `bridge:${opts.bridgeTurns}`), fs.where('status', '==', 'running'));
429
+ unsubs.push(fs.onSnapshot(q, async (snap) => {
430
+ const initial = first;
431
+ first = false;
432
+ for (const ch of snap.docChanges()) {
433
+ if (ch.type !== 'added' || seenTurns.has(ch.doc.id))
434
+ continue;
435
+ seenTurns.add(ch.doc.id);
436
+ const d = ch.doc.data();
437
+ const sessionUid = String(d.sessionUid ?? '');
438
+ const meta = await hostOf(sessionUid);
439
+ const createdAt = d.createdAt;
440
+ emit({
441
+ type: 'turn',
442
+ turnUid: ch.doc.id,
443
+ sessionUid,
444
+ bridgeId: opts.bridgeTurns,
445
+ host: meta.host,
446
+ workspaceName: meta.workspaceName,
447
+ externalSessionId: meta.externalSessionId,
448
+ text: typeof d.text === 'string' ? d.text : '',
449
+ approval: d.approval ?? null,
450
+ imageStoragePaths: Array.isArray(d.imageStoragePaths) ? d.imageStoragePaths : [],
451
+ createdAt: typeof createdAt === 'string' ? createdAt : createdAt?.toDate?.().toISOString() ?? null,
452
+ initial,
453
+ });
454
+ }
455
+ if (initial) {
456
+ pending.delete('turns');
457
+ ready();
458
+ }
459
+ }, (e) => emit({ type: 'error', stream: 'turns', code: e.code ?? null, message: e.message })));
460
+ }
423
461
  if (opts.comments) {
424
462
  streams.push('comments');
425
463
  pending.add('comments');
@@ -68,6 +68,7 @@ node ../odyssey-listen/listen.mjs --dry-run # 밀린 태그 할일 중 무엇
68
68
  | `mention` | 아무 항목에 단 **내** 댓글의 `@클로드코드`(공백·대소문자 무시) — 그 항목은 맡은 스레드가 된다 |
69
69
  | `tagged` | 태그가 걸린 할일·메모·프로젝트·리포트 스레드의 내 댓글 |
70
70
  | `reply` | 맡은 스레드의 내 댓글(멘션 없어도) |
71
+ | `turn` | 앱 컴패니언 대화에서 이 컴퓨터의 **데스크톱** 에이전트 세션에 보낸 말(`bridgeId` 를 넣었을 때만 — 아래) |
71
72
 
72
73
  AI 댓글(세션 자신의 답글)·다른 사람 댓글·할일 수정은 깨우지 않습니다 — 메아리와 남의 지시를 막습니다.
73
74
  상태 줄: `ended`(2) · `error`(3) · `busy`(4, 다른 듣기가 돎 — 이어받으려면 `--replace`) · `stopped`(5).
@@ -81,7 +82,12 @@ AI 댓글(세션 자신의 답글)·다른 사람 댓글·할일 수정은 깨
81
82
  | `odysseyProfile` | init 때 프로필 | `odyssey login` 프로필 |
82
83
  | `expectedUid` | 빈 값 | `--check`의 uid — 넣으면 다른 계정이면 오류로 끝난다 |
83
84
  | `followedThreads` | `false` | 관심 스레드(남의 답까지)도 들을지 — 지시는 내 댓글뿐이라 보통 끈다 |
84
- | `statePath` | `./state/listen.json` | 상태(since·seen·tagged·threads). 세션을 비우거나 바꿔도 이어 듣는다 |
85
+ | `bridgeId` | 빈 값 | 에이전트 브리지(`odyssey agent status` 의 bridgeId). 넣으면 데스크톱 세션 턴(`turn`)도 깨운다 — 데몬은 그 턴을 실행하지 않는다(`odyssey agent setup --desktop-relay`) |
86
+ | `statePath` | `./state/listen.json` | 상태(since·seen·tagged·threads·turns). 세션을 비우거나 바꿔도 이어 듣는다 |
87
+
88
+ `turn` 을 받은 세션은 그 대화의 데스크톱 세션(`externalSessionId` — 없으면 새로)에 `text` 를 넘긴다(`send_message` · `start_session`).
89
+ 훅 미러링이 그 글을 알아보고 그 세션의 답을 앱 대화의 답으로 쓰고 턴을 닫는다. 넘기지 못하면
90
+ `odyssey agent_turn_update --turnUid <턴> --settle failed --error noDesktopListener` 로 닫는다.
85
91
 
86
92
  ## 끄기·비우기
87
93
 
@@ -5,6 +5,7 @@
5
5
  "watchTag": "클로드 코드",
6
6
  "mentions": ["@클로드코드"],
7
7
  "followedThreads": false,
8
+ "bridgeId": "",
8
9
  "readyTimeoutMs": 120000,
9
10
  "statePath": "./state/listen.json"
10
11
  }
@@ -36,6 +36,9 @@ export const DEFAULT_CONFIG = Object.freeze({
36
36
  expectedUid: '',
37
37
  // 관심 스레드(남의 답까지 오는 방)도 들을지 — 지시는 내 댓글뿐이라 기본은 끈다(--no-threads)
38
38
  followedThreads: false,
39
+ // 에이전트 브리지(odyssey agent) 의 브리지 id — 넣으면 앱이 데스크톱 세션(host desktop)에 보낸 턴도 깨운다(listen: turn).
40
+ // 이 컴퓨터의 데몬은 그 턴을 실행하지 않고 이 세션에 맡긴다 — `odyssey agent setup --desktop-relay` · `odyssey agent status` 의 bridgeId
41
+ bridgeId: '',
39
42
  // 감시가 첫 스냅샷(ready)까지 이 안에 못 오면 오류(3)로 끝낸다 — 세션이 한 번 다시 띄운다
40
43
  readyTimeoutMs: 120_000,
41
44
  statePath: path.join(HERE, 'state', 'listen.json'),
@@ -72,6 +75,7 @@ export function validateConfig(cfg) {
72
75
  if (!cfg.mentions.some((m) => normalizeMention(m))) throw new Error('설정 mentions 가 비었어요');
73
76
  if (typeof cfg.expectedUid !== 'string') throw new Error('설정 expectedUid 는 문자열이어야 해요');
74
77
  if (typeof cfg.followedThreads !== 'boolean') throw new Error('설정 followedThreads 는 true/false 여야 해요');
78
+ if (typeof cfg.bridgeId !== 'string') throw new Error('설정 bridgeId 는 문자열이어야 해요');
75
79
  if (!(Number.isFinite(cfg.readyTimeoutMs) && cfg.readyTimeoutMs > 0)) throw new Error('설정 readyTimeoutMs 는 유한한 양수여야 해요');
76
80
  }
77
81
 
@@ -79,6 +83,7 @@ export function validateConfig(cfg) {
79
83
 
80
84
  const SEEN_KEEP = 500; // 기억하는 댓글 uid 수(파일이 끝없이 커지지 않게)
81
85
  const TAGGED_KEEP = 2000;
86
+ const TURNS_KEEP = 500;
82
87
 
83
88
  /** 세션이 답글을 달 수 있는 항목 종류 — comment_on_item 의 itemType(보드 전체 project 포함 — 옛 comment_on_project). */
84
89
  export const COMMENT_ITEM_TYPES = Object.freeze([
@@ -98,7 +103,7 @@ export function hasMention(text, mentions) {
98
103
  }
99
104
 
100
105
  export function emptyState(now = nowIso()) {
101
- return { since: now, seen: [], tagged: [], threads: {} };
106
+ return { since: now, seen: [], tagged: [], threads: {}, turns: [] };
102
107
  }
103
108
 
104
109
  export function normalizeState(raw, now = nowIso()) {
@@ -108,6 +113,7 @@ export function normalizeState(raw, now = nowIso()) {
108
113
  if (Array.isArray(raw.seen)) s.seen = raw.seen.filter((x) => typeof x === 'string');
109
114
  if (Array.isArray(raw.tagged)) s.tagged = raw.tagged.filter((x) => typeof x === 'string');
110
115
  if (raw.threads && typeof raw.threads === 'object') s.threads = { ...raw.threads };
116
+ if (Array.isArray(raw.turns)) s.turns = raw.turns.filter((x) => typeof x === 'string');
111
117
  }
112
118
  return s;
113
119
  }
@@ -118,9 +124,23 @@ export function normalizeState(raw, now = nowIso()) {
118
124
  * mention 아무 항목에 단 내 댓글의 멘션. 그 항목은 맡은 스레드(threads)에 오른다
119
125
  * tagged 태그 항목 스레드의 내 댓글 — 멘션 없어도 대화창이다
120
126
  * reply 맡은 스레드의 내 댓글
127
+ * turn 앱이 이 컴퓨터의 **데스크톱** 에이전트 세션에 보낸 말(브리지 턴 · host desktop) — bridgeId 를 넣었을 때만
121
128
  * 깨우지 않는 것: 에이전트 댓글(세션 자신의 답글 — 메아리) · 남의 댓글(author "other" — 지시가 아니다) · 할일 수정(세션이 바꾼 상태의 메아리).
122
129
  */
123
130
  export function classify(evt, state, cfg) {
131
+ if (evt?.type === 'turn') {
132
+ // 데스크톱 갈래(설계 §6.3) — cli 턴은 브리지 데몬이 직접 돌린다. host 를 모르면(세션 문서를 못 읽음) 데몬 몫으로 둔다.
133
+ if (!cfg.bridgeId || evt.bridgeId !== cfg.bridgeId || evt.host !== 'desktop') return null;
134
+ if (!evt.turnUid || state.turns.includes(evt.turnUid)) return null;
135
+ state.turns = [...state.turns, evt.turnUid].slice(-TURNS_KEEP);
136
+ return {
137
+ listen: 'turn', turnUid: evt.turnUid, sessionUid: evt.sessionUid ?? null, bridgeId: evt.bridgeId,
138
+ externalSessionId: evt.externalSessionId ?? null, workspaceName: evt.workspaceName ?? null,
139
+ text: typeof evt.text === 'string' ? evt.text.slice(0, 4000) : '', approval: evt.approval ?? null,
140
+ imageStoragePaths: Array.isArray(evt.imageStoragePaths) ? evt.imageStoragePaths : [],
141
+ createdAt: evt.createdAt ?? null, initial: Boolean(evt.initial),
142
+ };
143
+ }
124
144
  if (evt?.type === 'todo') {
125
145
  if (evt.change !== 'added' || evt.status !== 'notStarted') return null;
126
146
  if (!evt.uid || state.tagged.includes(evt.uid)) return null;
@@ -230,7 +250,8 @@ export function commandOf(bin, args) {
230
250
  }
231
251
 
232
252
  export function buildWatchArgs(cfg, since) {
233
- return ['-p', cfg.odysseyProfile, 'watch', '--tag', cfg.watchTag, ...(cfg.followedThreads ? [] : ['--no-threads']), '--since', since];
253
+ return ['-p', cfg.odysseyProfile, 'watch', '--tag', cfg.watchTag, ...(cfg.followedThreads ? [] : ['--no-threads']),
254
+ ...(cfg.bridgeId ? ['--bridge-turns', cfg.bridgeId] : []), '--since', since];
234
255
  }
235
256
 
236
257
  /** 감시를 띄우지 않고 CLI 로그인·계정만 확인한다. */
@@ -173,3 +173,18 @@ test('설정 — 모르는 키는 거절, 상대 경로는 설정 파일 기준'
173
173
  writeFileSync(config, JSON.stringify({ workDir: '.' }));
174
174
  assert.throws(() => loadConfig(config), /모르는 키/);
175
175
  });
176
+
177
+ test('브리지 턴(turn) — bridgeId 를 넣었을 때 데스크톱 턴만 한 번 깨운다', () => {
178
+ const s = emptyState('2026-11-22T00:00:00.000Z');
179
+ const turn = { type: 'turn', turnUid: 'T1', sessionUid: 'S', bridgeId: 'br_1', host: 'desktop', text: '화면 봐 줘', initial: true };
180
+ assert.equal(classify(turn, s, cfg), null); // bridgeId 없으면 듣지 않는다
181
+ const c = { ...cfg, bridgeId: 'br_1' };
182
+ assert.equal(classify({ ...turn, host: 'cli' }, s, c), null); // cli 턴은 데몬 몫
183
+ assert.equal(classify({ ...turn, host: null }, s, c), null);
184
+ assert.equal(classify({ ...turn, bridgeId: 'br_2' }, s, c), null);
185
+ const o = classify(turn, s, c);
186
+ assert.equal(o.listen, 'turn');
187
+ assert.equal(o.text, '화면 봐 줘');
188
+ assert.equal(classify(turn, s, c), null); // 두 번 내지 않는다
189
+ assert.deepEqual(buildWatchArgs(c, 'S').slice(-4), ['--bridge-turns', 'br_1', '--since', 'S']);
190
+ });