add_asset_images
ChatGPT이미 있는 내 에셋에 사진·파일을 더한다(앱 에셋 상세의 추가와 같다) — create_upload_url 로 먼저 올린다 (PDF·문서·소리 파일이면 accept:'files'). 기존 항목·순서는 그대로 두고 끝에 붙인다. 남의 공유 보드 에셋에는 더할 수 없다(파일이 주인 계정에 있어야 한다). 앱에서 그 에셋을 아직 올리는 중이면(uploadStatus: uploading) 끝난 뒤 다시 부른다.
add_item_to_timeline_event
ChatGPT기존 타임라인 이벤트에 항목·텍스트·성찰을 추가(append). create_timeline_event로 만든 회고 카드에 나중에 항목을 더 담거나 결론을 덧붙일 때 사용. items: 참조 항목 추가 (실존 검증). 이미 참조된 (uid+type)은 자동으로 건너뜀(중복 방지). texts: 이벤트 본문에 자유 텍스트 요소 추가. reflections: 성찰(reflectionElements)에 텍스트 추가. 추가 시 이벤트의 활동 종료 시각(time.endTime)이 현재로 연장된다. 이벤트에 카테고리가 없으면 새로 담은 항목 중 처음으로 카테고리가 있는 항목의 것을 물려받는다(있으면 그대로 둔다).
add_project_component
ChatGPT프로젝트 보드에 새 컴포넌트를 추가. 이 tool은 프로젝트 문서를 직접 수정하므로 사용자 승인 없이 대량 호출 금지. type 미지정 시 item_tile로 가정. offset/size 미지정 시 (0,0)과 타입별 기본 사이즈로 배치된다 — (0,0)이 어느 섹션 안일 수도 있으니 자리를 뜻대로 두려면 offset 을 명시하거나, 더 나은 방법으로 sectionId 를 줘서 섹션이 자리를 만들게 할 것(그러면 좌표를 계산할 필요가 없다). 여러 내용을 새로 구성할 때는 getGuide(guideIds:['board-planning'])를 먼저 읽는다. 긴 안내·이론·실험 기록은 type:'item' 단일 메모 카드, 실습·진행 체크는 itemTile을 선택한다. type:'item' 은 항목 하나를 독립 카드로 놓는다 — 앱 보드가 단일 카드로 그리는 종류 전부: asset, collection, companionReport, event, locationMap, memo, project, record, routine, snapshot, todo. 크기를 생략하면 그 종류의 앱 기본 규격으로 선다. 여러 대상을 같은 기준으로 비교하고 선택 근거를 정리할 때는 type:'table' 에 table:{columns, rows}를 준다 (첫 행 = columns 가 제목 행 · 수식·정렬·차트 없음 · table 미지정이면 빈 3열×2행 표). containItems 규칙 (서버에서 강제): - 허용 type: 'todo' | 'memo' | 'project' | 'companionReport' 와 단일 카드 종류(asset, collection, companionReport, event, locationMap, memo, project, record, routine, snapshot, todo). 그 외는 명시적 실패. - uid는 실존하는 내 항목이어야 함(컬렉션은 내가 소유자·멤버). 미실존 uid가 1개라도 있으면 전체 호출 실패. - itemTile은 여러 항목을 담는다. item은 containItems:[{uid:<항목 UID>,type:<종류>}] 하나가 필수다. - 단일 카드는 먼저 create_ 로 만들거나 찾은 항목의 UID 로 배치한다. attachToComponentId는 itemTile 전용이다. - 카드를 다른 종류로 바꿀 때(메모 → 할일): 새 항목을 만들고 delete_project_component 로 옛 카드를 지운 뒤 그 응답의 removed.offset·size·sectionId 를 그대로 주면 같은 자리에 선다. - 리스트를 선택한 경우: 빈 itemTile을 먼저 만들고 update_project_component(mode:'append')로 채우거나 create_todo/create_memo/create_report의 attachToComponentId를 사용. 내가 멤버로 참여 중인 공유 보드에도 컴포넌트를 추가할 수 있다. 단 containItems에는 자기 항목만 넣을 수 있고(항목 소유는 영원히 1인), 넣는 즉시 그 항목에 sharedProjectRef가 찍혀 다른 멤버도 읽을 수 있게 된다. 항목은 한 번에 공유 보드 하나에만* 속한다. 이미 다른 공유 보드에 공유된 항목을 담으려 하면 거절되고 사유가 돌아온다 — 사용자에게 옮길지 묻고, 원하면 moveFromOtherSharedBoard:true 로 다시 호출.
add_record_trace
ChatGPT기록에 측정값을 남긴다 — "오늘 푸쉬업 30개 했어", "5km 뛰었어"에 해당하는 동작. 기록을 실제로 "하는" 도구이므로 사용자가 활동 수행을 말하면 대부분 이것이다. 값 넣기 — 먼저 기록의 fields(칸 목록)를 본다(list_records/get_record) - 칸이 하나인 기록: value 하나. number 면 실제 수치, successOrFailure 면 1(성공)/0(실패), check 면 생략해도 된다. - 칸이 여럿인 기록: values 에 {칸 이름 또는 칸 id: 값}. 대표 칸(primary)은 꼭 있어야 한다(check 대표는 생략 가능). 값 모양: number·rating=숫자 · successOrFailure=true/false · check=true · choice=보기 중 하나 · text=글 · numberSet(숫자 묶음)=숫자 이름별 {"킬":12,"데스":3,"어시":8} · 순서대로 [12,3,8] · 글 "12/3/8"(빈 숫자는 빼거나 null). 모르는 칸 이름·묶음에 없는 숫자 이름이면 거절된다(칸을 새로 만들지 않는다 — 칸을 늘리려면 update_record(fields)). - span(구간) 칸은 values 가 아니라 time(시작)·endTime(끝)으로 준다. span 이 대표면 endTime 필수. - value 는 대표 칸 값의 줄임이다 — values 에 대표 칸이 있으면 values 가 이긴다(계산 값이 있는 묶음 대표는 value 로 못 적는다). - 세트: 무게×횟수×세트 묶음 칸이 있으면 "80kg 10회 3세트"는 한 줄 — values:{"무게 × 횟수 × 세트":"80/10/3"}. 세트마다 무게·횟수가 다르면 다른 조합마다 한 줄 더 부른다(80kg 10회 2세트 + 85kg 8회 1세트 = 두 번). 옛 기록에 "세트" 칸(id:set)이 있으면 그 칸에 세트 수를 set 으로 적고 한 번만 부른다. 세트를 담을 칸이 없는 기록(무게·횟수 칸만)은 세트마다 한 줄이다 — 자주 쓰면 update_record 로 무게×횟수×세트 묶음 칸으로 바꾸자고 사용자에게 제안한다. time으로 과거 시각을 지정하면 사후 기록이 된다. 타임라인: 측정값마다 "기록 추가: {기록 제목}" 카드가 time 시각에 생긴다. endTime: (선택) 활동 구간의 끝 — "time 부터 endTime 까지 했다"(게임·운동·작업 세션). 측정값에 저장되고 카드가 그 구간으로 그려진다. 대표가 span 이 아니면 대표 값은 따로 준다(예: 분 단위 기록이면 구간 길이를 분으로). dedupeKey: (선택) 재전송 중복 방지 키. 같은 키로 다시 부르면 측정값을 또 쌓지 않고 처음 것을 돌려준다 (deduplicated:true). 오프라인 뒤 재전송하는 프로그램용.
complete_routine_instance
ChatGPT루틴 인스턴스를 완료 처리한다 (= 루틴 1회 수행 완료). 타임라인 이벤트가 자동 생성된다. completeAllTodos(기본 true)면 인스턴스에 딸린 할일도 모두 완료 처리한다 — 앱에서 루틴을 끝냈을 때와 같은 상태가 된다. 개별 할일만 체크하려면 complete_todo를 쓸 것. ⚠️ 루틴의 달성 현황(스트릭·달성률)은 이 호출로 갱신되지 않는다 — 앱에서 완료했을 때만 재계산된다. 사용자가 스트릭을 물으면 get_routine이 주는 값이 최신이 아닐 수 있음을 알릴 것.
complete_todo
ChatGPT할일 완료 처리. 타임라인 이벤트 자동 생성. doneTime을 ISO 8601로 명시하면 과거 시각으로 완료 가능 (사후 기록). 루틴에서 생성된 할일이면 이 호출 하나로 루틴 인스턴스의 진행 상태까지 함께 갱신된다 (마지막 할일을 체크하면 인스턴스도 완료 처리 + 루틴 완료 타임라인 이벤트 생성). 즉 인스턴스 내부 할일을 체크할 때 별도 도구가 필요 없다 — list_routine_instances가 준 todos[].todoId를 그대로 넘기면 된다. 공유 보드에 올라온 남의 할일도 체크할 수 있다 — 단 보드 소유자가 '멤버 항목 편집 허용'을 켰을 때만. 완료 로그와 타임라인 이벤트는 항목 소유자가 아니라 체크한 본인 계정에 쌓인다(앱과 동일: 타임라인은 개인 활동 기록이다).
create_asset
ChatGPT사진·파일로 에셋(앱의 사진·파일 항목)을 만든다 — "이 사진들 보드에 올려줘 / 스크린샷을 에셋으로 남겨줘 / 이 PDF·녹음 파일 보드에 올려줘". 먼저 create_upload_url 로 올리고 그 uploadId 를 uploads 에 준다(한 에셋에 여러 개 — 앱 에셋처럼 묶음). PDF·문서·압축·소리 파일은 create_upload_url(accept:'files') 로 올린다 — 앱에서 PDF 는 페이지로 보이고, 소리는 재생되고, 그 밖의 파일은 이름과 함께 담겨 기기 앱으로 열거나 내려받는다. 사진과 파일을 한 에셋에 섞어도 된다. 파일은 앱이 올리는 자리로 복사된다 — 업로드는 줄지 않아 같은 것을 keepUntil(24시간) 안에 다른 에셋에도 또 쓸 수 있고, 올린 임시 사본이 지워져도 에셋 쪽은 남는다. 보드에 두기: - 리스트에 담기 = projectUid + attachToComponentId(create_memo 와 같은 규약 — 담기 대상은 만들기 전에 확인, 만든 뒤 실패는 attachError). - 사진을 보드에 카드 한 장으로 크게 두려면 만든 뒤 add_project_component(type:'item', containItems:[{uid:<assetId>, type:'asset'}]). memo 는 에셋 설명(평문 → 앱 본문 형식으로 변환). generateTimelineEvent(기본 true)면 앱처럼 타임라인에 「자산 생성」 카드가 남는다 (보드에서 만들면 근시간 안의 그 보드 카드에 합류) — 따로 create_timeline_event 를 부를 필요가 없다. 만든 에셋의 사진을 할일/메모 본문에도 넣으려면 assetImages:[{assetId}] — 같은 파일을 가리킨다(본문은 사진만). 응답: assetId · title · imageCount(사진 수) · fileCount(파일 수) · timelineEventUid(남기거나 합류한 「자산 생성」 카드 — generateTimelineEvent:false 거나 사용자가 앱에서 새 에셋 자동 기록을 껐으면 null) · attachedToComponentId — 만든 것을 확인하려고 다시 조회하지 않아도 된다.
create_category
ChatGPT새 카테고리 생성. 앱과 동일하게 홈 필터 페이지 카드(HomeCategoryCard)까지 함께 생성됩니다. - createHomePage(기본 true): 홈 화면에 이 카테고리의 필터 카드를 추가. 끄면 카테고리만 생성되어 홈에 보이지 않음. - withDefaultPages(기본 true): 홈 카드에 기본 페이지 4종(할일✅/프로젝트📁/메모📝/루틴🔄)을 구성. - 같은 이름의 카테고리가 이미 있으면 실패하며, 기존 카테고리 이름 목록을 알려줍니다. 생성 후 create_todo(categoryUid=...) 등으로 이 카테고리에 항목을 만들 수 있습니다.
create_collection
ChatGPT새 컬렉션(30 서가의 책 한 권 — 페이지를 모아 두는 앨범)을 나만 보는 상태로 만든다. 여행 기록 · 프로젝트 회고처럼 기록을 모아 둘 자리를 미리 만들 때 쓴다. 같은 이름이 이미 있는지 list_collections 로 먼저 본다. 나만 보는 컬렉션입니다 — 공유(친구 · 멤버 초대)와 공개는 사용자가 앱에서 직접 바꿉니다(이 도구로는 바꿀 수 없다).
create_companion
ChatGPT새 전용 컴패니언(운동 코치 · 여행 플래너 · 독서 친구처럼 한 분야를 맡는 AI 동료)을 만든다. 만들기 전에 사용자에게 어떤 컴패니언을 만들지(이름 · 역할 · 말투) 확인을 받는다. 비슷한 역할이 이미 있는지 list_companions 로 먼저 본다. 모든 컴패니언은 같은 도구를 쓴다 — 전용 컴패니언의 차이는 역할 · 성격 · 말투 · 기억이다. 만든 뒤 대화는 사용자가 앱에서 그 컴패니언을 골라 시작한다.
create_companion_action
ChatGPT컴패니언 액션(저장된 지시)을 만든다 — 수동 실행 전용(예약 없음). 만든 actionUid 를 할일 · 루틴의 시작 트리거 {kind:'companionAction', actionUid} 에 걸면, 사용자가 그 할일을 시작할 때 앱이 그 컴패니언의 메인 대화에서 prompt 를 보낸다 (예: 대화형 복습 — 「오늘 복습할 개념을 하나씩 물어봐 줘」). 사용자는 앱의 액션 목록에서 직접 실행할 수도 있다. - 먼저 list_companion_actions 로 같은 일을 하는 액션이 있는지 본다 — 같은 컴패니언에 같은 이름이 있으면 거절된다(그 uid 를 쓴다). - prompt 는 그 컴패니언에게 사용자가 보내는 말처럼 쓴다(지금 맥락 없이도 무엇을 할지 알 수 있게). 시작 트리거로 돌면 앱이 복습 기한이 된 개념 · 그 할일 id 를 함께 실어 보낸다(끝나면 complete_todo 로 그 할일을 닫으라는 안내 포함). - 정한 때에 컴패니언이 일하게 하려면 이것이 아니라 create_scheduled_request 다. 고치기 · 지우기 · 예약 · 홈 고정은 사용자가 앱에서 한다.
create_event
ChatGPT캘린더 일정(이벤트) 생성. user/{uid}/event 에 저장되어 앱 캘린더 월/주/일 뷰에 표시됨. startTime/endTime은 ISO 8601로 전달 (예: "2026-06-26T15:00:00+09:00" 또는 "2026-06-26T15:00:00Z"). - endTime 미지정 시 자동: 시각 일정은 startTime + 1시간, 종일은 그날 하루. isAllDay: 하루 종일 일정 (기본 false). 종일은 시각을 버리고 적힌 날짜만 쓴다(오프셋 기준 벽시계 날짜). - 첫날 = startTime 의 날짜: "2026-10-02T00:00:00+09:00" · "2026-10-02" 모두 10-02. - 마지막 날 = endTime 의 날짜(포함). 여러 날이면 마지막 날을 준다: 10-02~10-04 → endTime "2026-10-04". ⚠️ 다음 날 자정("2026-10-03T00:00:00+09:00")을 주면 10-03 까지 이틀짜리다. - 저장은 앱과 같은 UTC 자정 규약(첫날 00:00:00Z ~ 마지막 날 23:59:59Z)이라 응답 시각은 Z 로 나온다. reminderMinutes: 시작 N분 전 알림 시점(분 단위 배열). 필드로 저장되며, 실제 OS 알림 예약은 클라이언트 동기화 또는 backfillEventNotifications 시 등록된다. projectUid: 관련 프로젝트로 연결 (event.includedProjectUids에 기록). containItems: 일정에 첨부할 할일·메모·리포트 uid. 접근 가능한 항목만 허용한다. repeat: 반복 일정(구조화 필드 — create_routine 의 repeat 과 같은 모양). 회차의 시각·길이는 startTime/endTime 이 정하고, 반복 시작일은 startTime 이다. 회차는 list_events(expandRecurring:true) 로 본다. ⚠️ 반복 일정의 reminderMinutes 알림 예약은 MCP 에서 등록하지 않는다(앱에서 열어 저장하면 등록된다). 위치(location)는 현재 MCP에서 미지원.
create_image
ChatGPT머메이드 · SVG 원문을 그림(PNG) 으로 굽는다 — "이 흐름을 그림으로 메모에 넣어줘 / 구조도·순서도·관계도를 에셋으로 / 인포그래픽 만들어줘 / 이 표를 도식으로". 사진·일러스트(그림 모델)가 아니라 코드로 그리는 그림이다(비용 없음). 그린 그림은 업로드(uploadId)로 돌려준다 — 넣는 일은 기존 도구가 한다. 이 그림 넣기: 메모·할일 본문 끝 → create_memo · update_memo · create_todo · update_todo 의 uploadImages:[{uploadId}] · 에셋(보드에 둘 사진 항목) → create_asset(uploads:[{uploadId}]) · 페이지 사진 칸 → image:{uploadId, index:1}. 같은 uploadId 를 24시간 안에 여러 곳에 써도 된다. 고쳐 그리려면 원문을 고쳐 다시 부른다(새 uploadId). 응답에 구운 그림이 이미지로 붙는다 — 넣기 전에 보고, 글자가 겹치거나 잘렸으면 원문을 고쳐 다시 부른다. format: - mermaid — 구조를 그릴 때. 머리줄: flowchart(또는 graph) TD/LR · sequenceDiagram · stateDiagram-v2 · classDiagram · erDiagram · xychart-beta(막대·선). 간트 · 파이 · 마인드맵 · 타임라인은 지원하지 않는다 → svg 로 그린다. 색 · 글꼴은 서버가 정한다(흰 바탕 · Pretendard). 원문 20,000자까지. - svg — 인포그래픽 · 도식 · 카드처럼 직접 배치할 때. <svg xmlns="http://www.w3.org/2000/svg" viewBox="…"> 하나. 글자는 <text>(줄바꿈은 <tspan x=… dy=…>) — 글꼴은 무엇을 적어도 Pretendard(굵기 400 · 700)로 그려진다. <script> · <foreignObject>(HTML) · 외부 주소(http) 이미지는 그리지 않는다. 이모지는 글꼴이 없어 비어 나온다. 원문 300,000자까지. 크기: 2배로 굽고 긴 변 4096px · 8백만 픽셀을 넘으면 줄인다. 늘 흰 바탕 PNG. 리포트에 숫자 차트를 넣을 때는 이 도구 말고 리포트 원고의 ```chart 가 낫다(앱이 직접 그린다).
create_location_map
ChatGPT새 위치지도를 만든다 — 가 볼 곳 · 맛집 · 여행 동선처럼 장소를 모아 지도 한 장으로. 장소는 search_places 로 찾은 좌표 · placeId 를 그대로 넣는다(좌표를 지어내지 않는다). 지도 화면은 담긴 장소가 모두 보이게 자동으로 맞춘다. connectPlaces:true 면 담은 차례대로 핀을 선으로 잇는다(동선) — 순서가 없는 "가 볼 곳 모음"이면 켜지 않는다. 보드에 카드로 놓으려면 만든 뒤 add_project_component(type:"item", containItems:[{uid:<locationMapId>, type:"locationMap"}]).
create_memo
ChatGPT메모 생성 — "메모해줘 / 적어줘 / 남겨줘 / 정리해줘"처럼 나중에 다시 읽을 본문이 있는 기록은 기본적으로 이 도구다. 대화 정리·아이디어·회의록·독서 노트 등 텍스트 기록의 정본은 메모다. (이미 만든 항목을 묶거나 성찰을 남기는 것만 create_timeline_event, 수치 측정은 add_record_trace.) plain text 본문을 전달하면 Quill Delta로 자동 변환되어 저장됨. generateTimelineEvent가 true(기본값)이면 메모 생성이 Odyssey 타임라인에도 📝 이벤트로 남는다 — 따라서 "타임라인에도 보이게 하려고" create_timeline_event를 따로 부를 필요가 없다. projectUid: 메모를 해당 프로젝트와 "관련된 메모"로 연결 (memo.includedProjectUids에 기록). ⚠️ 이것만으로는 프로젝트 보드 카드에 메모가 보이지 않는다 — 보드는 component.containItems 를 렌더링하므로 별도로 컴포넌트에 추가해야 한다. attachToComponentId: (선택) projectUid와 함께 지정하면, 메모 생성 직후 서버가 해당 프로젝트의 지정 컴포넌트(itemTile) containItems에 이 메모 uid를 자동 append. 4단계 흐름을 1턴에 처리. - attachToComponentId만 있고 projectUid가 없으면 명시적 실패. - 프로젝트 미존재 / 컴포넌트 미존재 / 컴포넌트 type이 itemTile이 아님 / 담을 권한 없음은 메모를 만들기 전에 확인해 명시적으로 실패한다 — 이때는 아무것도 만들어지지 않으니 입력을 고쳐 다시 부르면 된다. - 내가 멤버로 참여 중인 남의 공유 보드(list_projects 의 shared:true)에도 담을 수 있다. 메모는 내 것으로 만들어지고, 그 보드의 카테고리는 물려받지 않는다(카테고리는 사용자별이라 보드 오너의 것이다). - 공유 보드면 멤버도 읽을 수 있게 그 메모에 sharedProjectRef 가 함께 찍힌다. - 드물게 메모를 만든 뒤 담기가 실패하면(그 사이 컴포넌트가 지워지는 등) 에러 대신 성공 응답에 attachError 가 실린다 — 메모는 이미 있으니 create_memo 를 다시 부르지 말 것. 보드 컴포넌트가 아직 없다면 먼저 add_project_component(type:'itemTile')로 만들고 그 componentId를 넘기거나, 사용자에게 어느 섹션에 둘지 물어볼 것.
create_memos
ChatGPT메모 항목을 한 번에 최대 50개 만든다. items의 각 항목은 create_memo과 같은 입력이며 projectUid + attachToComponentId도 항목마다 지정할 수 있다. 입력 형식은 쓰기 전에 전체 검증하고, 생성은 입력 순서대로 실행한다. 개별 생성 실패는 results의 index(0부터)·status·error로 반환하고 나머지는 계속한다. succeeded는 개별 생성이 성공 응답한 개수다. 성공한 항목은 취소하지 않으며 다시 생성하면 중복된다. 오류 항목도 원본 생성 뒤 로그·후처리에서 실패했을 수 있어 creationMayHaveOccurred:true를 반환한다. 오류만 보고 다시 만들지 말고 실제 생성 여부를 확인한 뒤 필요한 항목만 재시도한다. result.attachError가 있으면 항목은 이미 생성된 것이므로 다시 만들지 말고 보드 담기만 복구한다.
create_project
ChatGPT새 프로젝트(빈 보드) 생성. 응답으로 받은 projectId만 있고 components는 비어있다. 보드의 여러 내용을 구성하기 전에 getGuide(guideIds:['board-planning'])를 읽는다. 목적·내용 역할에 따라 section(주제), itemTile(실습·실행 목록), item(독립 메모), mindmap(관계 지도), table(같은 기준 비교표)을 선택한다. - 실습 리스트: add_project_component(type:'itemTile', text:'<리스트 제목>') → componentId. create_todo/create_memo/create_report에 projectUid와 attachToComponentId를 함께 주면 리스트에 담긴다. - 안내·이론·기록의 단일 메모 카드: create_memo → memoId → add_project_component(type:'item', containItems:[{uid:memoId,type:'memo'}]). 할일·루틴·기록·일정·스냅샷·컬렉션·리포트 등 다른 항목도 같은 방법으로 단일 카드가 된다. - 주제 묶음: section을 만든 뒤 반환 componentId를 자식 sectionId에 넣는다. 리스트 제목은 섹션이 아니다. ❌ 안티패턴: create_project 후 곧바로 create_memo(projectUid:...) 만 호출하는 것. 메모는 생성되지만 보드 카드로는 보이지 않는다 (projectUid는 "관련 프로젝트" 라는 약한 링크일 뿐 보드 배치가 아님). 사용자가 보드 구성을 요청했다면 지침에 따라 적합한 카드를 배치한다. 태그는 프로젝트 레벨에 저장되며, 앱에서 필터 기준으로 사용됨.
create_record
ChatGPT새 기록 항목(측정 대상의 정의)을 생성한다. 예: "푸쉬업"(count/횟수), "러닝"(distance/km), "독서"(time/min). ⚠️ 이미 있는 기록에 오늘 값을 남기는 것이라면 이 도구가 아니라 add_record_trace다. 먼저 list_records나 search로 같은 기록이 있는지 확인할 것 — 중복 정의가 쌓이면 통계가 갈라진다. 사용자가 이미 수행한 활동을 말하면(예: "오늘 5km 뛰었어") initialValue를 함께 넘겨 정의 생성과 첫 측정값 기록을 한 번에 끝낼 것. 칸(fields) — 측정 한 번에 값을 여럿 적는 기록 운동(무게×횟수×세트), 게임(결과·KDA·챔피언·플레이 시간)처럼 한 번에 여러 값을 남기면 fields 로 칸을 정의한다. - 첫 칸 = 대표값(차트·최고값·달성조건이 읽는다). 대표는 text 일 수 없다. - choice 는 options 필수(첫 보기 = 좋은 쪽 — 대표면 첫 보기 비율이 차트, 예: 승률). - span 은 시작~끝 구간(기록당 하나) — 측정값의 time·endTime 이 그 값이다. - numberSet(숫자 묶음)은 한 덩어리로 생각하는 숫자 여럿을 한 칸에 — parts(숫자 둘 이상 [{label, unitLabel?}], 숫자 id 는 서버가 만든다) · joiner(slash "12/3/8" · times "80kg × 10회" · colon "3 : 2") · calc(none · sum · product · difference · kda) · calcLabel(계산 값 이름). 계산 값은 저장하지 않고 읽을 때 계산하며, 대표면 계산 값(calc none 이면 첫 숫자)이 차트가 된다. label 을 생략하면 숫자 이름을 이은 이름으로 부른다. - fields 를 주면 type/numType/numUnit/useSet 은 주지 않는다(대표 칸에서 정해진다). - 칸 하나짜리 단순 기록이면 fields 없이 type/numType/numUnit 으로 충분하다. 숫자 묶음 프리셋(그대로 fields 항목으로): 무게×횟수×세트 {kind:"numberSet",parts:[{label:"무게",unitLabel:"kg"},{label:"횟수",unitLabel:"회"},{label:"세트",unitLabel:"세트"}],joiner:"times",calc:"product",calcLabel:"볼륨"} 횟수×세트 {kind:"numberSet",parts:[{label:"횟수",unitLabel:"회"},{label:"세트",unitLabel:"세트"}],joiner:"times",calc:"product",calcLabel:"총 횟수"} 킬/데스/어시 {label:"KDA",kind:"numberSet",parts:[{label:"킬"},{label:"데스"},{label:"어시"}],joiner:"slash",calc:"kda"} 점수 우리:상대 {label:"점수",kind:"numberSet",parts:[{label:"우리"},{label:"상대"}],joiner:"colon",calc:"difference",calcLabel:"점수 차"} 혈압 {label:"혈압",kind:"numberSet",parts:[{label:"수축"},{label:"이완"}],joiner:"slash",calc:"none"} — 단위가 같으면 숫자마다 적지 않는다("120/80") 근력은 무게×횟수×세트 묶음 한 칸이다(세트 칸을 따로 만들지 않는다 — 세트는 묶음 안의 숫자 하나). "80kg 10회 3세트"는 측정값 한 줄이고, 세트마다 무게·횟수가 다르면 측정값을 한 줄 더 남긴다(80kg 10회 2세트 + 85kg 8회 1세트 = 두 줄). 예: 게임 → fields:[{label:"결과",kind:"choice",options:["승","패"]},{label:"KDA",kind:"numberSet",parts:[{label:"킬"},{label:"데스"},{label:"어시"}],joiner:"slash",calc:"kda"},{label:"챔피언",kind:"text"},{label:"플레이",kind:"span"}] 첫 측정값: initialValue(대표 칸 숫자) 또는 initialValues({칸 이름: 값}). 숫자 묶음 값은 {숫자 이름: 수} · [수, …](순서대로) · "12/3/8" 글 (예: {"결과":"승","KDA":"12/3/8"} · {"무게 × 횟수 × 세트":{"무게":80,"횟수":10,"세트":3}}). 계산 값이 있는 묶음이 대표면 initialValue 로는 못 적는다 — initialValues 로. span 칸이 있으면 initialTime(시작)·initialEndTime(끝).
create_report
ChatGPT요청과 제목을 가진 빈 리포트 항목 생성. 생성 시 타임라인 이벤트가 자동으로 남는다. projectUid와 attachToComponentId로 보드에도 담을 수 있다.
create_routine
ChatGPT새 루틴(반복 활동의 틀) 생성. todoTemplates에 담은 할일들이 루틴을 수행할 때마다 복제 생성된다. ⚠️ 루틴을 만드는 것만으로는 할일이 생기지 않는다 — 틀만 만들어진다. "오늘 이 루틴을 했다/한다"까지 하려면 이어서 create_routine_instance를 호출할 것. repeat을 지정하면 앱의 일일 반복 처리기가 매일 자동으로 인스턴스를 만든다(수동 호출 불필요). 사용자가 "매일 아침 스트레칭 루틴 만들어줘"처럼 반복 주기를 말하면 repeat을 함께 지정하라.
create_routine_instance
ChatGPT루틴을 실행한다 — 루틴의 할일 템플릿을 실제 할일로 복제 생성하고, 그것들을 묶는 루틴 인스턴스를 만든다. "오늘 아침 루틴 시작할게" / "운동 루틴 했다고 기록해줘"에 해당하는 동작. 생성된 할일은 오늘 할일(isToday)로 등록되며 list_todos에도 나타난다. todayDate로 과거 날짜를 지정하면 사후 기록(어제 한 루틴을 지금 남기기)이 가능하다. markAllDone:true면 생성과 동시에 전부 완료 처리 + 타임라인 이벤트까지 한 번에 끝낸다 (이미 수행을 마친 루틴을 기록할 때 이 편이 호출 수가 적다). ⚠️ 같은 루틴을 하루에 여러 번 호출하면 인스턴스가 중복 생성된다. 이미 오늘 것이 있는지 list_routine_instances(routineId, date)로 먼저 확인할 것.
create_scheduled_request
ChatGPT정한 시각(한 번 예약)이나 반복(요청 루틴)마다 컴패니언이 깨어나 이 요청을 처리하게 예약한다. 결과는 홈의 요청 카드와 알림으로 간다 (「내일 아침 9시에 오늘 할일 정리해 줘」 · 「평일 8시마다 일정·할일 브리핑해 줘」). 그 시각에 알리기만 하면 되는 일은 이 도구가 아니라 할일 알림(create_todo 의 notification) · 일정 알림을 쓴다 — 예약된 요청은 깰 때마다 사용량을 쓴다. 한 번은 runAt 또는 delayMinutes, 반복은 repeat(루틴과 같은 모양 · 공휴일 제외는 아직 안 됨) + hour · minute(사용자 시간대 — 시간대는 묻지 않는다). 켜 둘 수 있는 예약은 20건.
create_snapshot
ChatGPTcreate_snapshot_draft
ChatGPTcreate_suggestion
ChatGPT30(회고) 제안 화면에 질문 한 장을 넣는다 — 사용자가 나중에 앱에서 그 카드의 ✎(글로 답하기)를 누르면 이 질문을 글감으로 단 새 글(페이지 원고)이 열리고, 근거 기록(timelineEventUids)은 재료로 담긴다. 언제: 사용자와 나눈 대화가 돌아볼 만했을 때 — 결정을 내렸거나, 생각이 정리됐거나, 무언가를 함께 만들었을 때 — 대화를 마치며 "이 대화의 후기를 써 볼 질문을 30 제안에 남겨 둘까요?"라고 한 번 권하고, 원하면 넣는다 (사용자가 미리 늘 남겨 달라고 했다면 묻지 않고 넣어도 된다). 대화 하나에 한 장. 넣었으면 그렇다고 알린다. 돌아볼 거리가 없는 짧은 질의응답에는 권하지 않는다. 글을 대신 써 두는 것은 create_snapshot_draft 다 — 이 도구는 사용자가 직접 쓰도록 건네는 질문이다. - question: 열린 질문 한 문장. "후기를 써 보세요" 같은 지시 대신 "이사 계획을 정리하고 나니, 가장 마음에 남는 건 뭔가요?"처럼 사용자가 자기 말로 답할 수 있는 질문. 칭찬·해석·조언을 싣지 않는다. - fact: 질문이 기대는 사실 한 줄 — 무엇을 이야기했나(예: "Claude와 이사 체크리스트를 정리했어요"). 카드에서 질문 아래에, 글감 띠에도 함께 선다. 대화 내용의 세부는 싣지 않는다. - timelineEventUids: (선택) 근거 기록 최대 6개 — create_memo · create_timeline_event · add_record_trace 가 돌려준 timelineEventUid. 대화 정리를 메모로 남겼다면 그 메모의 timelineEventUid 를 주면, 쓰기를 시작할 때 그 메모가 재료로 딸려 온다. 없는 uid 가 하나라도 있으면 아무것도 만들지 않고 거절한다. - authorName / authorEmoji: (선택) 카드 머리의 화자(「{이름}의 질문」). 기본 'Claude' / '✨'. 다른 AI 면 그 이름을 준다. 40자 이하, 운영자·관리자·공식·Odyssey 처럼 운영 주체로 읽히는 이름은 거부된다. - dedupeKey: (선택) 재전송 중복 방지 키. 같은 키로 다시 부르면 새로 만들지 않고 처음 것을 돌려준다(deduplicated:true). 앱에서는 30 › 제안 › '쓸거리' 탭에 「{화자}의 질문」 카드로 질문 은행 위에 서고(「전체」 탭에도), 30 홈 입력창의 쓸거리 수에 잡힌다. 새로 넣으면 사용자 기기로 「{화자}의 질문」 푸시가 가고, 누르면 쓸거리 탭의 그 카드가 맨 앞에 강조돼 열린다(재전송은 다시 울리지 않는다). 7일 뒤 시든다(안 쓰면 화면에서 빠진다). 아직 쓰거나 숨기지 않은 외부 AI 제안이 10장이면 거절된다.
create_timeline_event
ChatGPTOdyssey 60(계획+기록) 타임라인에 이벤트를 직접 생성. user/{uid}/timeline_event 에 저장되어 앱 타임라인에 기록 카드로 표시됨. 용도 — 대화를 실제 수행·회고로 남긴다: 방금 create_todo/create_memo로 만든 항목들을 items로 묶고, 대화의 결론/통찰을 reflection으로 남기면 "이 대화에서 이런 결론에 이르렀고, 이걸 하기로 했다" 회고 카드가 타임라인에 남는다. (권장 순서: 항목 먼저 생성해 uid 회수 → 이 도구로 묶기.) ⚠️ 경계 — 이 도구는 "묶고 성찰하는" 도구지 본문을 남기는 도구가 아니다: · 읽을 본문(대화 정리·아이디어·회의록·일기)을 남기는 것은 create_memo다. 메모를 만들면 타임라인 카드도 자동으로 함께 생기므로, 본문을 이 도구로 남기면 타임라인에만 뜨고 메모함에는 아무것도 남지 않는다. · 그래서 items가 비고 texts만 있는 호출은 거부된다 — create_memo로 만들 기록이다. · 수치 측정은 add_record_trace, 미래 일정·약속은 create_event. 활동 구간 — "언제부터 언제까지 이걸 했다"(게임·운동·작업 세션 등 프로그램이 재는 활동): startTime·endTime 을 둘 다 주면(endTime > startTime) items·reflection 없이, 제목만 또는 texts 한두 줄로 만들 수 있다. 성찰(reflection) 칸은 비워 둔다 — 사용자가 나중에 직접 반응을 쓰는 자리다. 시간을 통계로도 쌓으려면 기록(record)을 두고 add_record_trace(time·endTime)로 남기는 편이 낫다 — 그쪽도 구간 카드가 생긴다. categoryName / categoryUid: (선택) 이벤트 카테고리. 앱 타임라인의 카테고리 필터·기록장 '카테고리로 묶기'가 이 값으로 거른다 — 없으면 카테고리 화면에 안 뜬다. 생략하면 items 중 처음으로 카테고리가 있는 항목의 것을 물려받는다(앱 자동 카드와 같은 규칙). 이름은 정확히 일치해야 하고(list_categories), 없는 이름·uid 는 거절된다. dedupeKey: (선택) 재전송 중복 방지 키. 같은 키로 다시 부르면 새로 만들지 않고 처음 만든 이벤트를 돌려준다(deduplicated:true). 오프라인 뒤 재전송하는 프로그램용 — 내용을 고치는 용도가 아니다. items: 기존 할일·메모·프로젝트를 참조로 묶는다. 각 항목은 실존해야 하며(무결성 검증), 존재하지 않는 uid가 하나라도 있으면 전체 실패한다. type은 'todo'|'memo'|'project'. emoji를 생략하면 items 순서에서 첫 번째로 이모지가 있는 항목의 TitleIcon을 물려받는다. texts: items·reflection에 곁들이는 자유 텍스트(대화 발췌 등). 단독으로는 쓸 수 없다. reflection / reflections: 대화의 결론·성찰을 reflectionElements(성찰 영역)에 텍스트로 저장. reflection(단일 문자열) 또는 reflections(문자열 배열) 중 편한 쪽 사용. startTime: ISO 8601 (미지정 시 현재). 과거 시각을 주면 지난 대화의 결론을 사후 기록 가능. items·reflection 중 최소 하나는 있어야 한다(texts만으로는 생성 불가) — 단 위의 활동 구간은 예외.
create_todo
ChatGPT새 할일 생성. status를 "done"으로 하면 완료 상태 + 타임라인 이벤트도 생성. createdAt/doneTime을 ISO 8601로 명시하면 사후 기록(이미 끝낸 일을 과거 시각으로 등록)이 가능. deadline으로 기한(startTime/endTime, ISO 8601)을 지정할 수 있다 — 마감만 있으면 endTime만. projectUid: 할일을 해당 프로젝트와 "관련된 할일"로 연결 (todo.includedProjectUids에 기록). ⚠️ 이것만으로는 프로젝트 보드 카드에 할일이 보이지 않는다 — 보드는 component.containItems 를 렌더링하므로 별도로 컴포넌트에 추가해야 한다. attachToComponentId: (선택) projectUid와 함께 지정하면, 할일 생성 직후 서버가 해당 프로젝트의 지정 컴포넌트(itemTile) containItems에 이 할일 uid를 자동 append. 4단계 흐름을 1턴에 처리. - attachToComponentId만 있고 projectUid가 없으면 명시적 실패. - 프로젝트 미존재 / 컴포넌트 미존재 / 컴포넌트 type이 itemTile이 아님 / 담을 권한 없음은 할일을 만들기 전에 확인해 명시적으로 실패한다 — 이때는 아무것도 만들어지지 않으니 입력을 고쳐 다시 부르면 된다. - 내가 멤버로 참여 중인 남의 공유 보드(list_projects 의 shared:true)에도 담을 수 있다. 할일은 내 것으로 만들어지고, 그 보드의 카테고리는 물려받지 않는다(카테고리는 사용자별이라 보드 오너의 것이다). - 공유 보드면 멤버도 읽을 수 있게 그 할일에 sharedProjectRef 가 함께 찍힌다. - 드물게 할일을 만든 뒤 담기가 실패하면(그 사이 컴포넌트가 지워지는 등) 에러 대신 성공 응답에 attachError 가 실린다 — 할일은 이미 있으니 create_todo 를 다시 부르지 말 것.
create_todos
ChatGPT할일 항목을 한 번에 최대 50개 만든다. items의 각 항목은 create_todo과 같은 입력이며 projectUid + attachToComponentId도 항목마다 지정할 수 있다. 입력 형식은 쓰기 전에 전체 검증하고, 생성은 입력 순서대로 실행한다. 개별 생성 실패는 results의 index(0부터)·status·error로 반환하고 나머지는 계속한다. succeeded는 개별 생성이 성공 응답한 개수다. 성공한 항목은 취소하지 않으며 다시 생성하면 중복된다. 오류 항목도 원본 생성 뒤 로그·후처리에서 실패했을 수 있어 creationMayHaveOccurred:true를 반환한다. 오류만 보고 다시 만들지 말고 실제 생성 여부를 확인한 뒤 필요한 항목만 재시도한다. result.attachError가 있으면 항목은 이미 생성된 것이므로 다시 만들지 말고 보드 담기만 복구한다.
create_upload_url
ChatGPT사진·파일을 Odyssey 로 올릴 1회용 업로드 주소를 만든다 — 사용자 쪽에 있는 사진·파일(로컬 파일·채팅에 붙인 것)을 보드 · 에셋 · 페이지 · 메모에 넣어야 할 때 먼저 부른다. 바이트를 도구 인자에 싣지 않는다 — 이 주소로 따로 보낸다. accept: 기본 images(사진만) · PDF·문서·압축·소리를 에셋에 담을 거면 'files'(사진도 받는다). 동영상은 받지 않는다. 1) 파일을 직접 읽을 수 있으면(터미널·코드 실행 환경 — 채팅에 붙인 사진이 그 환경의 파일로 보일 때도): 한 장씩 POST. curl -sS -X POST --data-binary @<파일> -H "Content-Type: application/octet-stream" "<uploadUrl>?name=<URL 인코딩한 파일 이름>" name 은 URL 인코딩해 붙인다(예: 스크린샷 1.png → %EC%8A%A4%ED%81%AC%EB%A6%B0%EC%83%B7%201.png) — 한글·공백을 그대로 넣으면 거절된다. curl 7.87+ 이면 ?name= 없이 --url-query "name=<파일 이름>" 으로 인코딩을 맡겨도 된다. 파일은 name 을 꼭 붙인다(확장자 + 내용으로 형식 확인). 403·CONNECT 류로 막히면 그 환경의 네트워크 허용 목록에 업로드 도메인이 없는 것이다 — 사용자에게 더해 달라고 하거나 2) 로 간다. 2) 파일을 못 읽으면(코드 실행이 없는 채팅·모바일): uploadUrl 을 링크로 사용자에게 건넨다 — 다 올렸다고 하면 get_upload 로 확인. 한 개 20MB · 받는 시간 30분 · 보관 24시간. 한 업로드의 사진은 keepUntil(발급부터 24시간)까지 몇 번이든 쓴다 — 쓸 때마다 그 자리로 복사되고 업로드에서 빠지지 않는다. 지나면 그 uploadId 는 못 쓰지만 이미 넣은 사진은 남는다. 쓰는 길은 응답의 next. odyssey CLI 는 이 도구가 필요 없다 — image:{file} · uploadImages:[{file}] · create_asset 의 files 를 CLI 가 올려 바꿔 보낸다.
delete_companion_topic
ChatGPT주제 문서 한 장을 지운다 — 끝나 더 이어지지 않는 주제 · 다른 장에 합친 주제. 되돌릴 수 없다.
delete_event
ChatGPT일정 삭제(되살릴 수 없다 — 일정은 휴지통에 들어가지 않는다). 사용자가 명시적으로 지우라고 했을 때만. 반복 일정이면 시리즈 전체(예외 회차 포함)가 지워지고 알림도 함께 꺼진다. 내 일정만 지울 수 있다.
delete_list
ChatGPT리스트(= 항목 리스트)를 지운다 — 보드에도 보이는 리스트면 보드에서도 사라진다(두 렌즈 모두에서). 리스트 보기에서만 빼려면 이 도구 말고 set_component_visibility(componentId:<열 id>, lists:false). 열에 담긴 항목 문서는 지워지지 않는다(보드의 다른 자리에 없으면 프로젝트 포함 표시가 풀린다). 되돌릴 수 없어 사용자 확인 뒤에 부른다. 내 보드에서만(공유 보드 멤버는 불가).
delete_memo
ChatGPT메모를 삭제 — 휴지통으로 옮긴다(30일 안에 앱의 휴지통에서 되살릴 수 있고, 그 뒤 영구 삭제). 그래도 사용자의 명시적 승인 후에만 호출할 것. 보드에 담긴 카드는 기본으로 남겨 둔다(되살리면 그 자리로 돌아온다) — 보드에서도 즉시 빼려면 detachFromProjects:true. (LogModel에 delete_memo 타입이 없어 별도 로그는 남지 않음.)
delete_project
ChatGPT프로젝트(보드)를 삭제 — 휴지통으로 옮긴다(30일 안에 앱 휴지통에서 되살릴 수 있다). 보드에 담긴 할일 · 메모 등 항목은 지우지 않는다. 공유 중인 보드면 지우는 순간 공유가 끝난다(되살려도 멤버는 돌아오지 않는다). 사용자의 명시적 요청이 있을 때만. 내 보드만.
delete_project_component
ChatGPT컴포넌트를 삭제. 해당 컴포넌트를 참조하는 링크(화살표)도 함께 제거된다. 되돌릴 수 없으니 반드시 사용자의 명시적 승인 후에만 호출할 것. 담긴 항목은 지우지 않는다(지우려면 delete_memo·delete_todo 등 — 휴지통으로 간다). 응답의 removed 에 지운 카드의 offset·size·sectionId 가 온다 — 같은 자리에 다른 카드를 놓을 때(메모 카드 → 할일 카드) 그대로 add_project_component 에 넘긴다.
delete_project_folder
ChatGPT프로젝트 폴더를 해체한다 — 폴더만 사라지고, 그 안의 하위 폴더와 프로젝트는 한 단계 위(상위 폴더 · 없으면 루트)로 올라간다. 프로젝트(보드)는 지워지지 않는다. 프로젝트 자체를 지우려는 요청이면 이 도구가 아니라 delete_project 다. 사용자가 폴더 삭제를 명시적으로 요청했을 때만 호출할 것. folderUid 는 list_project_folders 로 확보한다. 폴더는 프로젝트(보드)를 묶어 보는 디렉터리일 뿐이다 — 폴더에 넣고 빼도 보드 내용은 바뀌지 않는다. 한 프로젝트는 한 폴더에만 들고, 어느 폴더에도 없으면 루트(미분류)다.
delete_project_page
ChatGPT시트를 내용째 지운다 — 그 시트의 컴포넌트(보드 카드 · 리스트 · 숨긴 카드) 전부와 그 시트의 손그림, 그리고 시트 자체. 담긴 항목 문서는 지우지 않는다(다른 시트에 없으면 프로젝트 포함 표시가 풀린다). 기본 시트는 못 지운다. 되돌릴 수 없어(앱의 버전 기록으로만 카드를 되살린다 · 그림은 못 되살린다) 사용자의 명시적 승인 뒤에만 부른다. 카드를 살리려면 먼저 move_components_to_page 로 옮긴다. 내 보드에서만.
delete_record
ChatGPT기록(측정 항목)을 삭제 — 휴지통으로 옮긴다(30일 안에 앱 휴지통에서 되살릴 수 있다). 사용자의 명시적 요청이 있을 때만. 보드 카드는 기본으로 남긴다(되살리면 제자리) — 즉시 빼려면 detachFromProjects:true. 내 기록만.
delete_report
ChatGPT내 리포트 원본 삭제. 기본적으로 보드의 참조도 제거한다. 타임라인과 스냅샷의 보관 사본은 유지된다.
delete_routine
ChatGPT루틴 삭제 — 루틴과 지난 회차 · 그 할일까지 한 묶음으로 휴지통에 옮기고 루틴 알림을 끈다(30일 안에 앱 휴지통에서 되살리면 다시 켜진다). 사용자의 명시적 요청이 있을 때만. 내 루틴만.
delete_scheduled_request
ChatGPT예약된 요청 · 요청 루틴을 지운다(남은 회차까지). 이미 처리된 요청 카드는 그대로 남는다.
delete_timeline_event
ChatGPT타임라인 이벤트(기록 카드)를 삭제한다 — 되살릴 수 없다. 카드에 담긴 할일 · 메모 원본은 지워지지 않는다. 사용자의 명시적 요청이 있을 때만.
delete_todo
ChatGPT할일을 삭제 — 휴지통으로 옮긴다(30일 안에 앱의 휴지통에서 되살릴 수 있고, 그 뒤 영구 삭제). 그래도 사용자의 명시적 승인 후에만 호출할 것. 보드에 담긴 카드는 기본으로 남겨 둔다(되살리면 그 자리로 돌아온다) — 보드에서도 즉시 빼려면 detachFromProjects:true. delete_todo 로그가 남아 추후 추적 가능.
fetch
ChatGPTsearch 결과의 id("타입:uid")로 항목 하나의 전체 내용을 읽는다(연결한 사용자가 볼 수 있는 항목만). 응답: {id, title, text, url, metadata}. text 는 항목의 모든 칸을 읽을 수 있는 글로 옮긴 것이고, 메모 본문·할일 메모·리포트 원고 같은 본문은 끝에 통째로 붙는다. 타입: todo / memo / project / routine / record / collection / event / companionReport. 같은 내용을 타입별 get_* 도구로도 읽을 수 있다.
follow_thread
ChatGPT항목·보드·보드 카드의 댓글 스레드를 관심 스레드로 올린다. 실시간 감시(odyssey watch)가 관심 스레드의 새 댓글을 누가 썼든 낸다 — 사람이 그 스레드에 답하면 감시하는 에이전트가 다시 깨어날 수 있다. comment_on_item·comment_on_project 로 댓글을 남긴 스레드는 이미 자동으로 관심 스레드다. 이 도구는 아직 댓글을 남기지 않은 스레드를 미리 올리거나, 감시할 기간을 정할 때 쓴다. 마지막 에이전트 활동(댓글·이 도구) 뒤 그 기간(기본 14일) 조용하면 저절로 빠진다. 정한 기간은 스레드에 남아, 뒤의 에이전트 댓글이 자동으로 다시 올릴 때도 그 기간으로 다시 센다. - itemType / itemUid / projectId: list_item_comments 와 같다. 스레드가 없으면 만든다(댓글은 쓰지 않는다). - days: 기간(일, 1~365). 생략하면 이미 정한 기간을 그대로(처음이면 14일). 사용자가 "한 달 동안 지켜봐"처럼 기간을 말했을 때만 준다. 만료 없이 계속 볼 항목은 태그 감시(odyssey watch --tag)가 맞다. follow:false 면 관심 스레드에서 뺀다 — 감시가 그 스레드의 새 댓글을 더는 내지 않는다(맡은 일이 끝났거나 사용자가 "그만"이라 할 때. 할일을 끝냈다고 빼지 않아도 된다 — 조용하면 정한 기간 뒤 저절로 빠진다). 뺄 때는 roomUid(odyssey watch · list_followed_threads)로도 고른다.
getGuide
ChatGPT작업에 맞는 지침을 읽는다(데이터 쓰기 없음). guideIds를 생략하면 현재 제공하는 지침의 ID·제목·사용 상황·버전 목록을 반환한다. 목록에서 작업에 맞는 ID를 골라 조회하면 본문·실행 도구·의존 지침을 함께 반환한다. 지침 조회가 사용자 요청 범위나 쓰기 권한을 확장하지 않는다.
get_app_link
ChatGPT항목(할일·메모·기록·루틴·프로젝트·컬렉션·일정·리포트)이나 앱 화면으로 가는 이동 링크를 만든다. 작업을 마친 뒤 사용자가 결과를 바로 확인하도록 답에 url 을 링크로 붙인다 — 누르면 앱(설치된 폰) 또는 웹앱에서 그 자리가 열린다. 여러 항목을 만들었으면 확인할 대표 하나(보드에 담았으면 그 프로젝트)에 건다. 남의 공유 보드 항목이면 ownerUid 를 준다. 항목은 itemType + itemUid, 화면은 screen 하나만 준다. 일정 · 리포트는 그 항목이 아니라 캘린더 · 리포트 모아보기로 간다. 데이터를 읽거나 바꾸지 않는다.
get_asset
ChatGPT에셋(미디어·첨부파일 묶음) 상세 조회. 제목·메모·태그와 엔트리 목록을 반환한다. 엔트리는 entries([{index,type,name,url,caption,...}])로 오며 index는 1-based — 이미지를 실제 픽셀로 보려면 그 index를 read_asset_image에, PDF·텍스트 문서의 내용을 읽으려면 read_asset_document에 넘길 것. 에셋의 memo에는 사용자가 남긴 설명이 들어 있다(제보·캡션 등 본문이 여기 있는 경우가 많다). 내 에셋이 아니면 내가 참여 중인 공유 보드의 항목까지 찾아본다. 남의 항목이면 응답에 shared{ownerUid, viaProjectId, canEdit} 가 붙는다.
get_collection
ChatGPT컬렉션 하나와 담긴 스냅샷 목록(요약)을 반환한다. 지면 전문은 get_snapshot 으로 이어 간다. 컬렉션에는 남의 스냅샷이 섞일 수 있는데, 열람 권한이 없는 것은 목록에 자리만 남기고 내용 없이 표시된다.
get_companion
ChatGPT컴패니언 하나의 프로필 — 역할(이름 · 설명 · 지시), 성격 · 말투, 상황별 메모리(대화할 때 · 알림 문구를 만들 때 따를 지시), 켜짐 · 알림 여부, 그 컴패니언이 건 반복 알림, 배우는 실행 설정(pipelines — 일일 이해 · 장기 회고의 켜짐 · 주기, pipelinesMasterEnabled = 전체 스위치). update_companion 으로 목록(지시 · 메모리)을 고치기 전에 이것으로 지금 목록을 읽는다(고치기는 목록을 통째로 바꾼다).
get_companion_request
ChatGPTrequest_companion 으로 맡긴 요청의 지금 상태와 결과(답 · 만든/고친 항목 · 되물음)를 읽는다. waitSeconds 를 주면 그동안 판정을 기다린다(최대 40초). 같은 일을 다시 맡기지 말고 이것으로 본다.
get_companion_topic
ChatGPT주제 문서 한 장을 읽는다 — 본문과 함께 마지막으로 맞춘 뒤(syncedAt) 범위 안의 타임라인 변화(changes)가 온다. 변화를 읽고 현황이 바뀌었으면 save_companion_topic 으로 고쳐 쓴다(고칠 게 없으면 topicId 만 넘겨 맞춘 시각만 올린다).
get_context
ChatGPT사용자의 "지금 상황"을 여러 종류에 걸쳐 한 번에 목차로 돌려준다 — 그 날의 일정 · 할일 · 루틴 · 최근 손댄 메모 · 최근 손댄 보드. 사용자의 상황을 알아야 하는 대화(브리핑·"오늘 뭐 하지"·일 맡기기 전 맥락 파악)의 첫 호출로 쓴다. list_ 를 종류마다 따로 부르지 말 것. 좁히기(축끼리 AND): date · 라벨(categoryName/categoryUid · tags, 또는 filterPage — tags 와 함께 못 씀 · 라벨은 모든 종류에 건다) · projectUid(보드 하나 — 카드 ∪ 내 소속 항목. 카드면 listTitle·sectionTitle, 소속만이면 notOnBoard:true · 보드로 좁히면 보드 화면처럼 다 보인다) · types. 할일 칸(한 할일은 한 칸에만): today(그 날 '오늘 할일'로 잡은 미완료 · 루틴이 만든 건 fromRoutine) · overdueToday(지난 날 '오늘 할일'인데 안 끝난 것 — 최근 30일 · 루틴 제외. 오늘 할 일로 단정하지 말 것) · deadline(기한이 그 날까지이거나 지난 미완료) · inProgress · doneToday · releasedToday(놓음 — 이유는 resolutionNote) · backlog(나머지 시작 전 개수 · 30일+ 손대지 않은 개수). 출력은 목차다 — 칸마다 total · 상위 limit 개 · 잘렸으면 nextCall. 본문은 없으니 uid 로 get_todo / get_event / get_memo / get_project. lastTouchedAt · ageDays 가 오래된 진행 중 · 지난 오늘 할일은 이미 놓은 일일 수 있다 — 단정하지 말고 사용자에게 확인한 뒤, 놓았다면 complete_todo(resolution:'released', completionNote:이유)로 남길 것(완료로 찍으면 끝낸 일과 섞이고, 지우면 같은 질문을 또 한다). ⚠️ 상태는 지금 기준이다(과거 date 를 줘도 그 날의 상태를 재현하지 않는다). 일정은 그 날 시작하는* 것(반복 회차 포함)만 — 전날 시작해 이어지는 여러 날 일정은 빠진다. 한 종류가 실패하면 그 자리에 error 가 실리고 나머지는 그대로 나온다.
get_event
ChatGPT캘린더 일정 상세 조회. 설명·알림·반복·위치 등 전체 정보 포함. 내 일정이 아니면 내가 참여 중인 공유 보드의 항목까지 찾아본다. 남의 항목이면 응답에 shared{ownerUid, viaProjectId, canEdit} 가 붙는다.
get_lists
ChatGPT프로젝트의 리스트 보기(열 순서 · 열마다 담긴 항목의 제목·상태 · 타일)을 읽는다. 보드와 리스트 보기(옛 앱 화면 이름 「칸반」 — 사용자가 그렇게 말해도 이것이다)는 한 프로젝트를 보는 두 렌즈다 — 같은 컴포넌트를 다루고 각자 숨기고 보인다. 사용자에게는 「리스트 보기」, 열 하나는 「리스트」라고 말한다. 리스트 보기의 열 = 항목 리스트다(보드에도 보이는 리스트면 보드 카드와 같은 데이터 — 한쪽에서 담으면 다른 쪽에도 보인다). 리스트가 아닌 표 · 단일 항목 카드 · 링크 · 글 카드 · 캘린더는 열 안의 타일(projectComponent 참조)로 보인다. 좌표가 없으므로 순서(index)만 생각하면 된다. 리스트 보기에 담긴 항목도 프로젝트의 항목이다(공유 보드 표시 · 프로젝트 포함 표시가 보드 리스트와 같다). filter:true 인 열은 자동 필터 리스트(필터 열)다 — 조건에 맞는 항목이 저절로 모이므로 담기 · 빼기 · 옮기기를 거절한다(조건은 앱에서 고친다). 리스트 보기는 시트마다다 — get_lists · save_list 는 pageId(생략 · 'default' = 기본 시트)로 시트를 고르고, 열 · 항목을 다루는 도구는 그 열의 시트 안에서만 움직인다. 열에는 상태(status: notStarted · inProgress · done)를 맬 수 있다 — 상태가 매인 열에 할일을 놓으면(담기 · 옮기기 · 만들며 담기) 그 할일의 상태가 열 상태로 바뀌고(완료 열이면 complete_todo 와 같은 완료 처리), 할일 상태가 바뀌면(어디서 바꾸든) 서버가 그 상태가 매인 열의 맨 아래로 옮긴다. 상태가 없는 열은 상태를 건드리지 않는다. 보관함(archive)은 지우지 않고 치워 둔 항목의 자리라 열이 아니며 리스트 보기 도구가 담거나 옮기지 않는다. 리스트 보기를 고치기 전에 반드시 먼저 부른다. 열이 없으면 columns 가 빈 배열이다(save_list 로 만들거나, 보드의 리스트를 set_component_visibility(lists:true)로 열로 켠다).
get_location_map
ChatGPT위치지도 하나 — 제목 · 담긴 장소(이름 · 주소 · 좌표 · placeId, 담은 차례) · 태그 · 카테고리 · 메모 글 · 핀 잇기 여부.
get_memo
ChatGPT메모 상세 조회. 본문은 plain text로 변환되어 text에 반환됨. 본문에 임베드된 이미지/비디오는 text 안에 [이미지 N]/[동영상 N] 자리표시자로 남고, 실제 URL 목록은 assets([{index,type,url}])로 함께 반환됨(임베드가 있을 때만). assets의 url은 대개 공개 다운로드 URL이라, 이미지 내용을 직접 확인하려면 read_memo_image를 쓸 것. 내 메모가 아니면 내가 참여 중인 공유 보드의 항목까지 찾아본다. 남의 항목이면 응답에 shared{ownerUid, viaProjectId, canEdit} 가 붙는다.
get_project
ChatGPT프로젝트 상세 조회. components에 포함된 아이템(todo/memo/project/asset 등)을 items[]로 평탄화해서 반환. 자동 필터 리스트(type auto_filter_list)의 항목(할일·메모·루틴·기록·이벤트)도 만든 사람 앱이 넣은 containItems 라 일반 항목과 같이 실린다. includeComponents:true를 주면 컴포넌트 원본(components/links/offset/scale)까지 포함한다(= get_project_components). 보드를 편집하기 전엔 includeComponents:true로 현재 상태를 먼저 확인할 것. structure 는 includeComponents 와 무관하게 늘 실린다(보드에 구조가 있을 때) — 사용자가 만든 묶음이다: - sections[]: {id, title, childIds} — 섹션(묶음 영역)과 거기 소속된 컴포넌트 - mindmaps[]: {id, title, type, direction, children[]} — 갈래 트리(중심에서 사방으로) - looseComponentIds[]: 어느 섹션에도 갈래에도 안 속한 컴포넌트 ⚠️ 섹션 소속은 좌표가 아니라 관계다. childIds 가 정본이고, 컴포넌트가 화면상 섹션 면 위에 있어도 목록에 없으면 그 섹션 소속이 아니다 — offset/size 로 유추하지 말 것. 컴포넌트를 섹션에 넣거나 뺄 때도 좌표를 계산하지 말고 update_project_component 의 sectionId 를 쓰면 자리는 섹션이 만든다. items[]의 각 항목에는 listTitle(담고 있는 리스트 카드 제목)과 sectionTitle(그 리스트가 속한 섹션 제목)이 붙어, 항목 하나만 봐도 보드 어디에 있는지 읽힌다(리스트 제목이 비어 있으면 listTitle 은 없다). 항목 요약도 함께 실린다 — title·emoji, 할일이면 status·dueAt(기한 마감). 원본이 사라진 참조는 missing:true, 읽을 수 없는 남의 항목(공유가 끊긴 항목 등)은 restricted:true 로 제목 없이 온다. 진행 상황 파악엔 이것으로 충분하니 본문·체크리스트가 필요한 항목만 get_todo/get_memo 로 연다. 텍스트 컴포넌트의 text 가 Quill Delta 원문이면 textPlain 에 평문이 함께 실린다. 표(type table) 컴포넌트는 저장 원본 tableData{columns, rows:[{cells}], columnWidths} 와 함께 읽기용 table{columns, rows:string[][]} 이 실린다(첫 행 = columns 가 제목 행). 내가 멤버로 참여 중인 공유 보드도 같은 방식으로 조회된다. 이때 응답에 shared{ownerUid, role, canEditItems} 가 붙고, items[]의 각 항목엔 ownerUid(항목 소유자)가 실린다. canEditItems 가 false 면 남의 항목은 읽기만 가능하다. 큰 보드는 나눠서 온다. items[] 는 기본 100개, components 는 기본 40개까지 싣는다. 잘렸으면 itemsPage / componentsPage {offset, returned, total, nextOffset} 가 붙으니 nextOffset 을 itemOffset / componentOffset 에 넣어 다음 쪽을 부른다(nextOffset 이 null 이면 끝). 잘린 컴포넌트 쪽의 links 는 그 쪽 컴포넌트에 닿는 연결선만이다. structure·componentCount 는 늘 보드 전체다.
get_project_components
ChatGPT프로젝트의 컴포넌트/링크 원본을 반환. 반환: { components[], links[], items[](평탄화), structure, offset, scale, ... }. structure 는 사용자가 만든 묶음(sections/mindmaps/looseComponentIds)이고 섹션 소속은 좌표가 아니라 관계다 — structure.sections[].childIds 가 정본이므로 offset 으로 유추하지 말 것. 편집 전 반드시 호출해 현재 상태를 확인할 것. (get_project(includeComponents:true)와 동일 — 신규 코드는 get_project를 쓰는 편을 권장.) 큰 보드는 나눠서 온다 — components 기본 40개 · items 기본 100개. 잘렸으면 componentsPage/itemsPage 의 nextOffset 으로 다음 쪽을 부른다.
get_record
ChatGPT기록 상세 조회. 측정값(trace) 전체 이력을 최신순으로 포함한다. 이력이 길 수 있으니 목록 훑기에는 list_records를 쓸 것. fields: 칸 목록 — 첫 칸(primary:true)이 대표값(차트·최고값·달성조건이 읽는 칸). name 으로 부른다. 숫자 묶음(numberSet) 칸은 parts(숫자들 — id·label·unitLabel)·joiner·calc(계산 값)를 함께 낸다. 측정값의 values 는 {칸 이름: 값}, value 는 대표 칸의 숫자 거울, endTime·durationMin 은 구간(span)의 끝·길이. 숫자 묶음 값은 앱 표기 그대로 글 한 줄 — "12/3/8 (KDA 6.67)", "80kg × 10회 × 3세트 (볼륨 2400kg)"(괄호 = 계산 값, 빈 숫자는 –). 내 기록이 아니면 내가 참여 중인 공유 보드의 항목까지 찾아본다. 남의 항목이면 응답에 shared{ownerUid, viaProjectId, canEdit} 가 붙는다.
get_report
ChatGPT리포트 한 편의 제목, 요청, 생성 지면 블록을 조회. 공유 보드의 항목도 권한 확인 후 조회.
get_routine
ChatGPT루틴 상세 조회. 할일 템플릿 전문·반복 설정·달성 현황 포함. 이 루틴을 실제로 수행하려면 create_routine_instance. 내 루틴이 아니면 내가 참여 중인 공유 보드의 항목까지 찾아본다. 남의 항목이면 응답에 shared{ownerUid, viaProjectId, canEdit} 가 붙는다.
get_setup_template
ChatGPTOdyssey MCP 연동 설정을 위한 CLAUDE.md 섹션 템플릿을 반환. 사용자에게 원하는 워크플로우(todoTracking/docSummary/projectDiscussion/journal)를 물어본 후 list_categories로 실제 카테고리 이름을 얻어 이 tool에 전달할 것. 반환된 markdown을 Write tool로 프로젝트 CLAUDE.md에 append 하면 됨.
get_snapshot
ChatGPT스냅샷 한 편의 지면 전문을 의미 단위로 반환한다. 저장 데이터는 "무엇을 담았나"만 알고 지면에서의 역할은 조판이 정하므로, 이 도구가 앱과 같은 배정 규칙으로 역할을 복원해 준다. 역할 이름은 쓰기 도구(create_snapshot · update_snapshot)와 같다 — 읽은 page 의 uid 로 그대로 고쳐 쓴다. 응답의 page 는 앱과 같은 배정 규칙으로 되읽은 지면이다 — [{uid, role, text|lines|title, rich?}] 를 머리부터 위에서 아래 순서로. 쓰기와 같은 role 이름이고, uid 가 고치기(update_snapshot · create_snapshot 의 edits)의 주소다. rich:true 칸은 위 글 안 서식 표기로 온다. image 는 caption·size 와 함께 오고(한 블록에 여러 장이면 index), 같은 uid 의 글과 한 블록에 들 수 있다. divider 는 uid 만(글 없음), link 는 url·title 로 온다 — 고칠 때도 url·title. 읽기에만 서는 role: file·reference(사진 칸의 파일·참조 항목), title(지면 안의 제목 블록), text(이 도구가 모르는 조판의 글 — style 은 참고용). editable:false 칸은 표·비고 조판이라 앱에서 고친다. image 는 mediaType 으로 사진·동영상이 갈리고, file 은 사진 칸에 앉은 문서·소리(그림이 아니다 — name 으로 부른다)다. 조판 전용 표기는 걷어내고 평문으로 준다. rich:true 칸의 서식 표기: 굵게 · _기울임_ · <u>밑줄</u> · ~~취소선~~ · [글](주소) · 줄 머리 "- "/"1. "/"> "/"## " (기호를 글자 그대로 쓴 곳은 앞에 \ 가 붙는다). 지면 날짜(바이라인의 날)는 writtenAt 이 있으면 그것, 없으면 createdAt(발행 시각)이다. kind='legacy' 스냅샷은 지면이 아니라 타임라인 이벤트 하나를 담은 옛 형식이라 event 필드로 나온다. 남의 스냅샷은 ownerUid 를 함께 주어야 하고, 공개된(shared/public) 것만 열린다. 남의 스냅샷의 참조는 앱과 같이 발행 당시 보관 사본으로 펼친다 — 사본이 없으면 notArchived:true, 지면 주인이 아닌 계정의 참조는 restricted:true 로 내용 없이 온다.
get_timeline_event
ChatGPT타임라인 카드 하나를 읽는다 — 제목 · 시각 · 태그 · 카테고리와 함께 elements(담긴 항목 · 글)와 reflections(사용자가 남긴 성찰 · 반응). eventUid 는 search_timeline_events(시점을 모를 때 뜻으로) 또는 list_timeline_events(기간을 알 때)로 확보한다. 카드 모양은 list_timeline_events 와 같다. "왜 했더라 · 어떻게 했지" 같은 경위의 답은 대개 담긴 항목의 본문에 있다 — elements 의 {kind:'item', type, uid} 를 get_todo · get_memo · get_project 로 이어 읽는다.
get_todo
ChatGPT할일 상세 조회. 체크리스트, 달성조건 등 전체 정보 포함. 내 할일이 아니면 내가 참여 중인 공유 보드의 항목까지 찾아본다. 남의 항목이면 응답에 shared{ownerUid, viaProjectId, canEdit} 가 붙는다 — canEdit 이 false 면 update_todo/complete_todo 는 거부된다(보드 소유자가 '멤버 항목 편집 허용'을 켜야 함).
get_upload
ChatGPT업로드 주소(create_upload_url)에 사진·파일이 왔는지 본다 — 사용자가 링크에서 "올렸어" 라고 하면 이걸로 확인한다. state: waiting(아직 없음) · uploaded(files — index 로 고른다 · kind image · document · audio · other) · expired(→ 새 주소). accepting 이 true 면 같은 주소로 remaining 장 더 받는다. 이미 쓴 업로드도 uploaded 그대로다 — 한 업로드의 사진은 keepUntil(발급부터 24시간)까지 몇 번이든 쓴다 — 쓸 때마다 그 자리로 복사되고 업로드에서 빠지지 않는다. 지나면 그 uploadId 는 못 쓰지만 이미 넣은 사진은 남는다. 파일(document · audio · other)은 에셋에만 담는다(본문 · 페이지 사진 칸은 사진만) — 쓰는 길은 응답의 next.
link_project_components
ChatGPT보드의 두 카드를 연결선(관계선) 으로 잇는다 — 단계의 순서, 원인 → 결과, 여행 동선(호텔 → 관광지)처럼 카드 사이의 관계를 보이게 한다. 기본 모양은 앱에서 사람이 새로 잇는 선과 같다(실선 · 도착 쪽 화살촉 · 자동 곡선). 라벨은 선의 양 끝에 붙는 짧은 글(예: "09:00", "도보 10분"). - 컴포넌트 id 는 get_project(includeComponents:true) 의 components[].id 또는 add_project_component 응답에서 고른다. - 같은 시트에 보이는 카드끼리만 잇는다(리스트 보기에만 있는 열 · 다른 시트 카드는 거절). 선(line) 컴포넌트는 끝이 될 수 없다. - 마인드맵 가지는 부모 관계가 선을 그리므로 따로 잇지 않는다(add_project_component 의 mindmapParentId). - 같은 방향으로 이미 이어져 있으면 새로 만들지 않고 alreadyLinked:true 와 그 linkId 를 돌려준다. - 연결선을 지우는 도구는 없다 — 카드째 지우면(delete_project_component) 그 카드에 닿은 선도 함께 지워진다.
list_activity_logs
ChatGPT내 활동 로그(원시 이력)를 최신순으로 — 할일 만들기 · 끝내기 · 지우기(new_todo · done_todo · delete_todo), 메모(new_memo), 루틴 회차(new_routine_instance · done_routine_instance), 보드 수정(update_project), 기록 흔적(add_record_trace), 페이지(new_snapshot) 등. 「이번 달 끝낸 할일이 몇 개」「어제 뭘 만들었나」처럼 개수 · 빠짐없음이 중요할 때 쓴다. 무엇을 했는지 읽기엔 list_timeline_events(다듬은 카드)가 낫다. - fromDate · toDate(YYYY-MM-DD 또는 ISO) — 날짜만이면 사용자 시간대의 하루(toDate 는 그 날 끝까지). - logType 으로 한 종류만. limit 기본 20 · 최대 100 — hasMore 가 true 면 더 있다(세거나 다 나열해야 하면 limit 을 올리거나 기간을 좁혀 다시). 각 로그: type · createdAt · 항목 uid(todoUid · memoUid …) · title(남아 있으면). 본문은 get_todo · get_memo 로.
list_categories
ChatGPT사용자의 카테고리 목록을 조회합니다. nameFilter로 부분 일치 검색 가능.
list_collections
ChatGPT내가 접근할 수 있는 컬렉션 목록. 컬렉션은 스냅샷을 묶어 두는 서가다(책 한 권에 가깝다). 소유(owner)·편집(member)·열람(viewer) 중 하나로 참여 중인 것이 전부 나오며, access 필드로 구분된다. 담긴 스냅샷 목록은 get_collection 으로 조회. 응답에 total/offset/hasMore/nextOffset 포함. 정렬 기본 = 생성 시각 내림차순.
list_companion_actions
ChatGPT사용자의 컴패니언 액션(저장된 지시 — 정한 컴패니언에게 보낼 prompt) 목록. 최신순. 할일 · 루틴의 시작 트리거 {kind:'companionAction', actionUid} 에 걸 actionUid 를 찾을 때 쓴다 — 새로 만들기(create_companion_action) 전에 같은 일을 하는 액션이 이미 있는지 본다. run = manual(수동 · 트리거 전용) · schedule(예약) · interval(간격). prompt 는 앞 300자.
list_companion_topics
ChatGPT주제 문서(컴패니언 작업 노트) 목차 — 최근에 고친 순. 주제 문서는 공부 · 프로젝트처럼 대화를 넘어 이어지는 일의 현황(정한 것 · 미해결 · 다음)을 주제마다 한 장으로 둔 것이고 사용자 화면에는 나오지 않는다. query 는 제목 · 한 줄 요약 · 키워드 · 본문에서 부분일치(대소문자 무시). 본문은 get_companion_topic 으로 읽는다.
list_companions
ChatGPT사용자의 컴패니언(AI 동료) 목록 — 기본 컴패니언과 사용자가 만든 전용 컴패니언(운동 코치 · 여행 플래너 같은 역할). 역할이 겹치는 컴패니언이 있는지 보거나, 새로 만들기(create_companion) 전에 이미 있는지 확인할 때 쓴다. 상세는 get_companion.
list_events
ChatGPT캘린더 일정(이벤트) 목록 조회. startDate~endDate 범위(ISO 8601)에 "시작하는" 일정을 반환. ⚠️ startTime 기준 단일 필드 범위 쿼리다 — 범위 시작 이전에 시작해 범위 안까지 이어지는 다중일 이벤트는 포함되지 않는다. 종일 일정(isAllDay)은 시작 날짜로 본다 — startDate·endDate 의 UTC 오프셋 날짜 사이(끝 날짜 포함)면 나온다. 반복 일정: 기본은 마스터만(첫 회차가 범위 안일 때만) 나온다. expandRecurring:true 면 범위 안 회차로 펼쳐 준다 — 앱 캘린더와 같은 규칙(EXDATE·예외 인스턴스·주말/공휴일 제외 반영). · 펼친 회차는 uid=마스터 uid, startTime/endTime=그 회차, occurrence:{masterEventUid, date, virtual:true}. 회차의 신원은 (masterEventUid, date) 다(하루 최대 1회). · 그 회차만 고친 예외 인스턴스는 별도 문서로 나오며 masterEventUid·originalStartTime 이 붙는다. · 회차의 시각은 startDate 의 UTC 오프셋 벽시계로 계산한다 — "+09:00" 으로 주면 KST. 종일 일정은 날짜 단위(범위의 날짜들과 겹치는 날). tags: 지정한 태그 중 하나라도 가진 일정만(펼친 회차 포함). 전체 본문/알림/반복 등 상세는 get_event로 조회.
list_followed_threads
ChatGPT내 관심 스레드 목록 — 최근 에이전트 활동 순. 각 줄은 방(roomUid)과 그 항목(itemType·itemUid, 보드 카드면 projectId), 등록 경위(source: auto = 에이전트 댓글 · manual = follow_thread), 기간(ttlDays — follow_thread 의 days, 정하지 않았으면 14), 만료 시각(expiresAt = 마지막 에이전트 활동 + ttlDays)이다. expired:true 는 이미 감시에서 빠진 것이다(다음 등록 때 정리된다). 스레드 본문은 list_item_comments 로 읽는다.
list_location_maps
ChatGPT내 위치지도 목록(최근에 바꾼 것 먼저) — locationMapId · 제목 · 장소 수. 지도를 고치기(update_location_map) 전에 이것으로 id 를 찾는다. categoryUid/tags 로 거르면 앱 모아보기(지도)의 카테고리·태그 필터와 같다(tags 는 하나라도 겹치면 통과).
list_memos
ChatGPT메모 목록 조회/검색. query로 제목+본문 텍스트 부분일치 검색(대소문자 무시). 카테고리/태그/핀 필터 + 정렬 + offset 페이지네이션 지원. 본문은 미리보기(앞 120자)만 반환되며, 전체 본문은 get_memo로 조회. 본문 임베드 이미지/비디오는 개수를 assetCount로 표시(상세는 get_memo). 응답에 total/offset/hasMore/nextOffset 포함. 정렬 기본 = 생성 시각 내림차순(최신 우선).
list_project_folders
ChatGPT프로젝트 목록 디렉터리(폴더) 구조 조회 — 앱 프로젝트 목록의 폴더 모드와 같은 트리. 폴더마다 folderUid·제목·상위 폴더·경로(path, "여행 / 2026")·깊이·하위 폴더 수·담긴 프로젝트(projectId·제목, 최근 넣은 것 먼저)를 루트부터 깊이 우선(화면의 펼침 순서)으로 돌려준다. create_project(folderUid)로 새 보드를 폴더에 만들거나 move_project_to_folder 로 옮기기 전에 이것으로 folderUid 를 확보한다. 어느 폴더에도 없는 프로젝트는 루트(미분류)에 있다 — 전체 프로젝트는 list_projects. space=shared 폴더는 루트의 "공유받은 보드" 특수 폴더 안에서 공유받은 보드를 정리하는 하위 폴더다. 폴더는 프로젝트(보드)를 묶어 보는 디렉터리일 뿐이다 — 폴더에 넣고 빼도 보드 내용은 바뀌지 않는다. 한 프로젝트는 한 폴더에만 들고, 어느 폴더에도 없으면 루트(미분류)다.
list_projects
ChatGPT프로젝트 목록 조회. 정렬 + offset 페이지네이션 지원. 응답에 total/offset/hasMore/nextOffset 포함. 정렬 기본 = 생성 시각 내림차순(최신 우선). 내가 멤버로 참여 중인 공유 보드도 함께 나온다 (shared:true + ownerUid + canEditItems). 공유 보드는 소유자 계정에 있는 문서라 내 카테고리 체계에 속하지 않으므로, categoryName/categoryUid 필터를 주면 목록에서 빠진다.
list_records
ChatGPT기록 목록 조회. 기록은 "무엇을 재는가"의 정의(예: 푸쉬업, 러닝 거리)이며, 실제 측정값은 각 기록의 trace에 쌓인다. 목록에는 최근 3건의 측정값 + 누적 집계만 담긴다 — 전체 이력은 get_record. fields: 칸 목록 — 첫 칸(primary:true)이 대표값(차트·최고값·달성조건이 읽는 칸). name 으로 부른다. 숫자 묶음(numberSet) 칸은 parts(숫자들 — id·label·unitLabel)·joiner·calc(계산 값)를 함께 낸다. 측정값의 values 는 {칸 이름: 값}, value 는 대표 칸의 숫자 거울, endTime·durationMin 은 구간(span)의 끝·길이. 숫자 묶음 값은 앱 표기 그대로 글 한 줄 — "12/3/8 (KDA 6.67)", "80kg × 10회 × 3세트 (볼륨 2400kg)"(괄호 = 계산 값, 빈 숫자는 –).
list_reports
ChatGPT내 리포트 목록과 제목 검색. 최신순, offset 페이지네이션. 지면은 get_report로 조회.
list_routine_instances
ChatGPT루틴 인스턴스(= 실제 수행 이력) 조회. 각 인스턴스의 내부 할일 목록과 체크 상태를 함께 반환한다. "오늘 루틴 뭐 했어?" / "이번 주 운동 루틴 얼마나 했지?" / "아침 루틴 남은 항목" 에 쓰는 도구. routineId를 지정하면 특정 루틴의 이력만, date/dateFrom/dateTo로 날짜를 좁힌다. 날짜는 사용자 벽시계로 읽는다 — "2026-10-02T00:00:00+09:00" 처럼 오프셋을 붙이면 그 오프셋의 하루, "2026-10-02" 처럼 날짜만 주면 사용자 시간대 설정(앱 설정, 기본 Asia/Seoul)의 하루다. 아무것도 지정하지 않으면 최근 인스턴스를 최신순으로 반환한다. 반환된 todos[].todoId 로 complete_todo를 호출하면 개별 할일을 체크할 수 있다.
list_routines
ChatGPT루틴 목록 조회. 루틴은 "반복 활동의 틀"이며, 실제 수행 이력은 루틴 인스턴스다 (오늘 뭘 했는지 보려면 list_routine_instances). 목록에는 반복 설정·달성현황(스트릭/달성률)·할일 템플릿 개수까지만 담긴다 — 템플릿 내용은 get_routine.
list_scheduled_requests
ChatGPT예약된 요청 · 요청 루틴 목록 — 다음 실행(nextRunAt) · 지난 결과(lastRun: done · needsReply · failed) · 건너뜀(lastSkip: budget · companionOff · waitingReply). 켜진 것 먼저, 다음 실행이 가까운 순.
list_snapshots
ChatGPT내 스냅샷(발행된 지면) 목록. 스냅샷은 사용자가 자기 기록을 골라 조판해 펴낸 완성된 지면이다. theme/컬렉션/가시성/태그/기간 필터 + 정렬 + offset 페이지네이션 지원. 각 항목은 요약만 반환한다(지면 본문은 get_snapshot). kind='page' 는 블록 조판 지면, kind='legacy' 는 타임라인 이벤트 하나를 담은 옛 형식이다. summary 는 앱이 만들어 둔 내용 서술로, 레거시에서 "무슨 글인지" 아는 유일한 축이다. 응답에 total/offset/hasMore/nextOffset 포함. 정렬 기본 = 생성 시각 내림차순. writtenAt 은 작성자가 정한 지면 날짜(지난 날짜로 쓴 일기 — 바이라인의 날)다. 없으면 createdAt 이 지면 날짜다. createdAt 은 발행 시각이고, 기간 필터·정렬은 발행 시각 기준이다("10월 3일 일기"를 찾을 땐 writtenAt 도 볼 것).
list_tags
ChatGPT내가 써 온 항목 태그 목록(최근 쓴 순). 항목을 만들거나 고칠 때 태그는 여기서 고르고, 맞는 것이 없을 때만 짧게 새로 짓는다(같은 뜻의 다른 말 · 다른 언어 · 띄어쓰기만 다른 말은 새로 짓지 않는다).
list_timeline_events
ChatGPT타임라인(60 기록 카드)을 기간·카테고리로 읽는다 — 최신순, 카드마다 담긴 항목(제목·상태)과 성찰까지. "최근 이틀 Odyssey60 에서 뭘 했나" 같은 회고·요약의 재료를 읽을 때 쓴다. 범위: startDate~endDate 에 시작하는 카드(list_events 와 같은 규칙 — 날짜만이면 사용자 시간대의 하루, endDate 는 그 날 끝까지 포함, 하루를 보려면 같은 날짜를 둘 다). ⚠️ 범위 전에 시작해 안까지 이어지는 카드는 빠진다. 응답의 range 가 실제로 읽은 구간이다. 카테고리를 주면 카테고리 없는 카드는 빠진다(앱 타임라인 필터와 같은 기준). 완료한 할일마다 카드가 생겨 이틀이면 수십 건이 흔하다 — hasMore 면 nextOffset 으로 이어 읽고 hint 를 따를 것. 카드의 elements(본문) · reflections(성찰)는 kind 로 갈린다 — item{type, uid, title, status, released?, missing?}(본문은 uid 로 get_*) · text(평문 · 사진은 [이미지 N]) · emoji · starRating · milestone · recordTrace · quizResult{setId, score, total, questions[{concept, correct, …}]} (리포트 퀴즈를 한 번 푼 학습 기록 — 틀린 개념 = correct:false 의 concept). 프로젝트 item 의 drawing[{pageId, drawn, erased, region}] = 이 카드 동안 바뀐 손그림 — region 을 view_board_drawing(projectId: uid, pageId, region)에 그대로 넣으면 그 자리만 본다. ⚠️ 이 도구가 아닌 경우: 오늘의 상황(일정·할일·루틴)은 get_context, 다가올 일정은 list_events, 메모·할일 본문은 get_memo / get_todo. 카드를 만들거나 성찰을 더하는 건 create_timeline_event / add_item_to_timeline_event.
list_todos
ChatGPT할일 목록을 조회합니다. 정렬·페이지네이션·다중 상태 필터 지원. 기본 동작: 상태를 지정하지 않으면 "아직 안 한 할일"(notStarted + inProgress)만 반환한다. 완료(done)까지 보려면 includeDone:true 또는 status/statuses에 done을 명시. (앱의 '나머지'/'오늘' 목록과 동일하게, 쌓인 완료 항목이 미완료를 가리지 않도록 하기 위함.) 응답에는 total(필터 후 전체 매칭 수), offset, hasMore, nextOffset, statusCounts (카테고리 전체의 notStarted/inProgress/done 개수)가 포함된다 — 완료 항목이 몇 개 걸러졌는지 항상 투명하게 보인다. 페이지네이션: offset/limit로 순차 조회. hasMore가 true면 nextOffset을 다음 호출 offset에 넣는다. 정렬: sortBy(createdAt|updatedAt|deadline|title) + order(asc|desc). 기본 createdAt desc. tags 필터: 지정한 태그 중 하나라도 가진 할일만 반환(hasAny 의미). 목록의 memo는 길면 미리보기로 잘린다(전문은 get_todo).
move_list_item
ChatGPT리스트 보기에 담긴 항목(또는 타일)을 다른 열로(또는 같은 열 안 다른 자리로) 옮긴다 — 열 사이 진행 상태를 바꾸는 주된 도구. 도착 열에 상태가 매여 있으면(get_lists 의 columns[].status) 옮긴 할일의 상태가 그 열의 상태로 바뀐다 — 완료 열이면 complete_todo 와 같은 완료 처리, 진행 중 · 할 일 열이면 update_todo(status)와 같다(응답의 statusChanged). 상태 없는 열로 옮기면 할일 상태는 그대로다. 할일이 아닌 항목(메모 · 타일 …)은 소속만 바뀐다. 같은 열 안 순서만 바꾸면 상태는 그대로다. fromColumnId 를 주지 않으면 그 항목이 든 열을 찾는다(여러 열에 있으면 fromColumnId 가 필요하다).
move_project_to_folder
ChatGPT프로젝트(보드)를 폴더에 넣거나 다른 폴더로 옮긴다. folderUid 를 생략하거나 빈 문자열이면 폴더에서 빼 루트(미분류)로. 원래 폴더에서는 자동으로 빠진다. projectId 는 list_projects·search, folderUid 는 list_project_folders 로 확보한다. 공유받은 보드는 공유받은 보드 폴더(space=shared)에만, 내 프로젝트는 내 프로젝트 폴더(space=own)에만 넣을 수 있다. 새 보드를 만들면서 폴더에 넣으려면 create_project(folderUid) 한 번이면 된다. 폴더는 프로젝트(보드)를 묶어 보는 디렉터리일 뿐이다 — 폴더에 넣고 빼도 보드 내용은 바뀌지 않는다. 한 프로젝트는 한 폴더에만 들고, 어느 폴더에도 없으면 루트(미분류)다.
read_asset_document
ChatGPT에셋에 담긴 PDF·텍스트 문서를 열어 본문 텍스트로 반환한다. get_asset의 entries에서 type:"document"/"other" 로 보이는 파일의 내용을 실제로 읽을 때 사용 — "이 PDF 무슨 내용이야?" 같은 질문은 파일명만으로 답할 수 없다. entryIndex(1-based, get_asset entries의 index)로 특정 파일만, 미지정 시 읽을 수 있는 첫 문서. 읽는 형식: PDF, txt, md, csv, json, xml, html, rtf, yaml. docx·xlsx·hwp·zip 등은 읽지 않고 거절한다(바이너리를 텍스트로 뭉개면 잡음만 남는다). 스캔본(텍스트 레이어 없는 PDF)이면 그 사실을 알려 준다 — 그때는 read_asset_image 로 그림을 볼 것. 본문이 maxChars(기본 20000)를 넘으면 잘린 사실과 전체 길이를 함께 알린다. 내 에셋이 아니면 내가 참여 중인 공유 보드의 항목까지 찾아본다(get_asset 과 동일 규칙).
read_asset_image
ChatGPT에셋에 담긴 이미지를 실제 픽셀로 읽어 반환한다(비전). get_asset의 entries에서 확인한 이미지를 직접 눈으로 보고 싶을 때 사용 — 화면 캡처 제보처럼 그림 자체가 내용인 경우가 많다. 토큰 절감을 위해 긴 변 768px·JPEG로 축소되어 반환된다. imageIndex(1-based, get_asset entries의 index)로 특정 장만, 미지정 시 앞에서 최대 maxImages(기본 3)장. 동영상 엔트리는 표지(posterUrl)가 있을 때만 그 한 장을 읽는다. 내 에셋이 아니면 내가 참여 중인 공유 보드의 항목까지 찾아본다(get_asset 과 동일 규칙).
read_image
ChatGPT항목에 담긴 그림을 실제 픽셀로 읽는다(비전) — 스크린샷이 곧 내용인 제보처럼 눈으로 봐야 할 때. 셋 중 하나만 준다: memoId(메모 본문 — get_memo 의 assets) · todoId(할일 메모 — get_todo 의 memoAssets) · assetId(에셋 — get_asset 의 entries). 긴 변 768px JPEG 로 줄여 돌려준다. imageIndex(1부터, 그 목록의 번호)로 한 장만, 생략하면 앞에서 maxImages(기본 3)장. 동영상은 에셋의 표지가 있을 때만 그 한 장. 내 것이 아니면 참여 중인 공유 보드의 항목까지 찾는다.
read_memo_image
ChatGPT메모 본문에 임베드된 이미지를 실제 픽셀로 읽어 반환한다(비전). get_memo의 assets에서 확인한 이미지를 직접 눈으로 보고 싶을 때 사용. 토큰 절감을 위해 긴 변 768px·JPEG로 축소되어 반환된다. imageIndex(1-based, get_memo assets의 image index)로 특정 이미지만, 미지정 시 앞에서 최대 maxImages(기본 3)장. 비디오는 지원하지 않음. 내 메모가 아니면 내가 참여 중인 공유 보드의 항목까지 찾아본다(get_memo 와 동일 규칙).
remove_from_list
ChatGPT리스트에서 항목(또는 타일)을 뺀다 — 항목은 지워지지 않는다(보드의 다른 자리에도 없으면 프로젝트 포함 표시가 풀린다). 타일을 빼도 그 컴포넌트는 그대로다(보드에서 숨긴 것이었다면 어디에도 안 보이는 숨긴 카드로 남는다 — get_project 의 offBoard). 공유 보드 멤버는 자기 항목만 뺄 수 있다. 열(리스트) 자체를 리스트 보기에서 빼려면 set_component_visibility(lists:false).
reorder_lists
ChatGPT리스트 순서를 통째로 다시 세운다 — columnIds 순서대로(왼쪽부터). 목록에 없는 열은 원래 순서대로 뒤에 붙는다.
resolve_filter_page
ChatGPT앱 홈 화면의 "필터 페이지"(사용자가 저장한 필터 — 예: "새로운 기능")를 이름으로 찾아, 그 실체인 항목타입 + 카테고리 + 태그 3축으로 역해석합니다. MCP의 list_* 도구는 이 3축을 받지만 "필터 이름 → 조합"을 되짚는 경로가 없어 이 도구가 그 갭을 메웁니다. - name 생략: 전체 필터 페이지 목록(카탈로그)을 반환 — 어떤 필터들이 있는지 발견용. - name 지정: 이름 부분일치(대소문자 무시)로 찾아 각 매치의 3축 + 바로 이어 호출할 MCP 도구(nextCall)를 반환. - categoryName/categoryUid로 특정 카테고리의 필터만으로 범위를 좁힐 수 있습니다. - 못 찾으면 사용 가능한 필터 이름 목록을 함께 알려줍니다. 앱 필터의 태그 결합은 arrayContainsAny(OR)이므로, list_todos/list_memos의 tags(hasAny)와 동일하게 재현됩니다. 전형적 흐름: resolve_filter_page("새로운 기능") → 반환된 nextCall(예: list_todos(categoryUid=..., tags=[...])) 실행.
save_companion_topic
ChatGPT주제 문서를 만들거나 고친다. topicId 가 없으면 새 장(title · summary · body 필수), 있으면 준 칸만 바꾼다. 한 주제에 한 장 — 덧붙여 쌓지 말고 지금 현황(정한 것 · 미해결 · 다음)으로 다시 쓴다. 같은 제목의 장이 있으면 새로 만들지 않고 거절한다(그 id 를 알려 준다). 기본으로 맞춘 시각(syncedAt)을 지금으로 올린다 — 다음 get_companion_topic 은 그 뒤 변화만 준다.
save_list
ChatGPT리스트 보기에 리스트(열)를 만들거나 고친다. columnId 가 없으면 새로 만든다 — 리스트 보기에만 보이는 새 항목 리스트(보드에서는 숨긴 채, index 생략 = 맨 오른쪽 · 여러 개면 index 없이 순서대로 부른다). 보드에 이미 있는 리스트를 쓰려면 새로 만들지 말고 set_component_visibility(componentId, lists:true). columnId 가 있으면 준 필드만 고친다(이름 · 색 · 상태 — 보드에도 보이는 리스트면 보드 카드도 같이 바뀐다). status('notStarted' · 'inProgress' · 'done', 고칠 때 'none' = 지우기)를 매면 그 리스트에 놓는 할일이 그 상태가 되고, 할일 상태가 바뀌면 그 상태의 리스트로 옮겨 간다 — 고칠 때 지금 담긴 할일의 상태는 바꾸지 않는다. 단계 이름 리스트는 status 를 주지 않는다. 순서는 reorder_lists, 항목은 add_to_list / move_list_item. 리스트 보기는 시트마다다(pageId).
save_project_folder
ChatGPT프로젝트 폴더(디렉터리)를 만들거나 고친다 — folderUid 가 없으면 새로 만들고(title 필수 · parentFolderUid 를 주면 그 안에, 생략하면 루트 · space 는 루트에 만들 때만), 있으면 준 필드만 고친다(제목 · 이모지 · 옮기기 — parentFolderUid "" = 루트로 · emoji "" = 떼기). 만들기 전에 같은 이름이 있는지 list_project_folders 로 본다(이름이 같아도 하나 더 생긴다). 자기 자신 · 하위 폴더 아래로, 내 폴더(own)와 공유받은 보드 폴더(shared) 사이로는 못 옮긴다. 보드를 폴더에 넣는 건 move_project_to_folder.
save_project_page
ChatGPT프로젝트에 시트(사용자 화면 이름 — 도구 · 필드 이름은 page · pageId)를 더하거나 고친다. 시트마다 보드와 리스트 보기가 따로 있다. pageId 가 없으면 맨 뒤에 새로 만들고(title 필수 · lists 에 제목 · 색 · 상태 목록을 주면 리스트 보기의 빈 리스트까지 한 번에 — 보드에서는 숨김), 있으면 준 필드만 고친다(이름 · 이모지 · index = 목록 안 새 자리, 기본 시트 'default' 도 이름을 바꿀 수 있다). 만든 시트에 카드를 놓으려면 add_project_component · save_list 등에 그 pageId 를 준다. 기존 카드를 옮기려면 move_components_to_page. 사용자가 시트(면 · 탭)를 나눠 달라고 할 때만 만든다.
search
ChatGPT항목 타입을 가리지 않는 통합 키워드 검색(연결한 사용자의 Odyssey 항목 안에서만). 검색 대상: todo(할일) / memo(메모) / project(프로젝트) / routine(루틴) / record(기록) / collection(컬렉션) / event(일정) / companionReport(리포트). types를 지정하면 해당 타입만, 생략하면 위 8종 전부. ⚠️ 이름으로 항목을 찾을 때는 list_ 도구를 전량 훑지 말고 이 도구를 먼저 쓸 것. list_todos/list_projects에는 텍스트 검색이 아예 없다. ⚠️ 매칭은 제목 기준이다 (인덱스에 본문이 실려 있지 않음). 메모 본문까지 뒤지려면 list_memos(query:"...") 를 쓸 것 — 그쪽은 제목+본문 부분일치다. 일정(event)도 제목으로 찾는다. 날짜 범위로 훑을 때는 list_events 를 쓸 것. keyword 요령: 기본 검색은 AND다 — 넣은 단어가 전부 제목에 있어야 잡힌다. 사용자 발화를 그대로 넣지 말고 핵심어만 남긴다. 잉여 단어 하나가 결과를 0건으로 만든다. 예: "회사지원하기 할일 찾아줘" → keyword="회사 지원" (띄어쓰기 없는 합성어는 의미 단위로 분해). 0건이면 ① 더 짧은 핵심어로 재시도 → ② 그래도 0건이면 relax:true 로 한 번 더. 결과의 각 hit에는 nextCall이 붙는다 — 상세를 보려면 그대로 호출하면 된다. todo/memo/project/event/collection/companionReport는 get_ 도구가 있다. routine/record는 uid·제목까지만 확인할 수 있다.
search_passages
ChatGPT내 자료의 본문을 뜻으로 찾는다 — 메모 · 할일(메모 · 체크리스트) · 리포트 원고 · 에셋 PDF 쪽 · 타임라인 카드 · 내 페이지(발행한 지면 글). 어느 항목의 어디인지 발췌와 함께 돌려준다. 타임라인 카드는 담은 항목 본문까지 원료라, 항목과 그 항목을 담은 카드가 함께 걸리면 항목 하나로 나오고 카드는 timelineCards 로 붙는다. 고르는 기준: - 제목 · 이름을 알면 search(키워드)가 정확하다. 이 도구는 본문 속 내용 · 생각 · 사실을 뜻으로 찾을 때. - 지목한 문서 하나가 짧으면(get_asset 의 chars 가 약 2만 자 이하 · 메모 하나) 통째로 읽는 게 더 정확하다 — 이 도구를 쓰지 않는다. - 문서 전체 요약 · 정리는 검색이 아니다 — 문서를 나눠 읽는다. 필터는 겹쳐 걸 수 있다(칸끼리 AND · 한 칸 안은 하나라도): types(출처 종류) · since/until(YYYY-MM-DD 또는 ISO, 날짜만이면 사용자 시간대) · dateField(created 쓴 날 기본 · updated 본문을 고친 날) · categoryUid · tags · projectId(그 보드에 지금 담긴 항목) · assetIds(고른 에셋, 공유 보드 포함). projectId 와 assetIds 는 하나만. 결과는 뜻이 가까운 순일 뿐 정답 순이 아니다 — 발췌를 읽고 무관한 것은 버린다. PDF 쪽은 앞뒤 쪽(neighbors)이 함께 온다(정의는 앞 쪽, 해설은 다음 쪽에 있는 일이 잦다). 원문 전체는 각 결과의 read 로 읽는다. partial 이면 일부만 본 것이니 필터를 좁혀 다시 찾고, notIndexed 의 에셋은 없다고 단정하지 말고 사유대로 읽는다. 글이 아주 짧은 항목(15자 미만)은 색인하지 않는다 — 그런 항목은 search 로 찾는다.
search_places
ChatGPT장소를 이름 · 주소로 찾는다(Google 지도). 위치지도에 담을 장소의 좌표 · place id 를 얻을 때 쓴다 — 좌표를 지어내지 말고 이걸로 찾는다. 결과는 최대 10건: placeId · name · address · latitude · longitude · mapsUrl. 이름은 사용자 언어로 온다(languageCode 로 바꿀 수 있다). "제주 동백마을", "성수동 카페 어니언"처럼 지역을 함께 쓰면 잘 걸린다.
search_timeline_events
ChatGPT내 타임라인(지나간 활동 · 기록 · 성찰 카드)을 뜻으로 찾는다 — 키워드가 아니라 뜻이 가까운 것. "지난번 여행 준비하면서 힘들었던 일", "운동을 다시 시작한 계기"처럼 날짜를 모르는 기억을 찾을 때 쓴다. 기간을 알면 list_timeline_events 가 정확하다. - query 는 토막 단어보다 문장이나 구절로 쓴다(뜻이 담긴 표현이 잘 걸린다). - sinceDate(YYYY-MM-DD 또는 ISO)를 주면 그 이후에서만 찾는다(날짜만이면 사용자 시간대의 그 날 0시). 결과는 뜻이 가까운 순일 뿐 정답 순이 아니다 — preview 로 무관한 것을 버리고, 전부 무관하면 못 찾았다고 답한다.
send_notification
ChatGPT사용자 본인에게 임의의 메시지 알림을 보낸다. 작업 완료 보고 등에 사용. 홈 알림함에 카드로 표시되며, containItems 로 관련 항목(todo/memo/snapshot 등)을 참조하면 카드를 탭했을 때 다이얼로그에서 해당 항목들이 함께 렌더된다. FCM 푸시 알림도 함께 발송된다.
set_component_visibility
ChatGPT컴포넌트가 보드 · 리스트 보기 어느 렌즈에 보일지 켜고 끈다(odyssey60-core D40) — 숨기기는 지우기가 아니다(어디에도 안 보여도 컴포넌트는 남는다 · get_project 의 offBoard). board:false = 보드에서 숨기기(선 · 연결점 · 마인드맵 중심 · 마인드맵 노드는 못 숨긴다 — 섹션은 안의 카드째 숨는다), board:true = 보드에 보이기(리스트 보기에서 태어나 자리가 없으면 기본 크기로 빈 자리에 놓인다 · 섹션이나 숨은 섹션 안의 것을 보이면 그 섹션째 돌아온다). lists:true = 리스트 보기에 보이기 — 리스트는 열로(index = 열 자리), 표 · 단일 항목 카드 · 링크 · 글 카드 · 캘린더는 columnId 열 안의 타일로(index = 열 안 자리, 다른 열에 있었으면 옮겨진다). lists:false = 리스트 보기에서 빼기(리스트는 열에서, 타일은 참조를 뺀다). board · lists 중 하나 이상. componentId는 프로젝트 전체에서 찾고 해당 컴포넌트의 시트 안에서 처리하므로 pageId는 필요하지 않다.
tidy_board
ChatGPT보드를 보기 좋게 다시 깐다 — 겹침을 없애고, 섹션을 내용에 맞추고, 열로 가지런히 정렬한다. 조판을 마친 뒤 마지막에 한 번 부르는 도구다. 컴포넌트를 만들 때 좌표를 계산하지 말고, sectionId 로 소속만 정한 뒤 끝에서 이걸 부르는 것이 권장 흐름이다. 네 층을 순서대로 적용한다: 1. 갈래 — mindmapParentId 로 이어 둔 노드를 중심에서 상·하·좌·우로 펼친다. (갈래를 붙이기만 하고 좌표를 안 줬어도 여기서 자리를 받는다.) 2. 섹션 안 — 담긴 카드를 넣은 차례대로 세로로 다시 쌓는다(갈래는 덩어리째). 3. 섹션 자신 — 담긴 내용에 딱 맞게 크기를 맞춘다(줄이기도 한다). 4. 루트 층 — 섹션과 무소속 카드를 열(최대 3열)로 갈라, 서로 겹치지 않게 깐다. 넣은 차례는 보존된다(왼쪽 열을 위에서 아래로 읽으면 만든 순서). ⚠️ 사람이 손으로 맞춰 둔 보드에는 쓰지 말 것. 좌우로 벌려 둔 배치를 세로 한 줄로 되돌린다. 에이전트가 방금 만든 보드, 또는 사용자가 "정리해줘"라고 명시적으로 요청한 경우에만 쓴다.
update_memo
ChatGPT메모 수정. 변경할 필드만 전달하고, 넘기지 않은 필드는 건드리지 않는다. text는 본문 전체 교체다(부분 편집이 아님) — 일부만 고치려면 get_memo로 현재 본문을 받아 수정한 전문을 다시 넘길 것. 빈 문자열을 주면 본문이 비워진다. tags도 전체 교체(통째로 덮어씀). 수정은 타임라인 이벤트를 새로 만들지 않는다 — 생성 때 이미 남았다. 공유 보드에 올라온 남의 메모도 수정할 수 있다 — 단 보드 소유자가 '멤버 항목 편집 허용'을 켰을 때만. 남의 항목에는 categoryUid/categoryName을 쓸 수 없고(사용자별 네임스페이스), 편집 이력(lastEditedByUid)이 남는다.
update_project_component
ChatGPT기존 컴포넌트를 부분 업데이트. 제공된 필드만 교체되며 나머지는 유지. containItems(item_tile=item_list 컴포넌트의 내부 항목 리스트) 편집 mode: - replace (기본): containItems 전체를 incoming으로 교체 - append: 기존 + incoming, (uid,type) 기준 중복 제거 — 항목 추가 용도 - remove: 기존에서 incoming으로 지정한 (uid,type)들만 빼냄 — 항목 제거 용도 ⚠️ 참조 무결성(서버 강제): replace/append 모드에서 containItems의 uid는 모두 실존해야 한다. 하나라도 없는 uid가 섞이면 전체 호출이 실패한다. type은 'todo'|'memo'|'project'|'companionReport'와 단일 카드 종류(asset, collection, companionReport, event, locationMap, memo, project, record, routine, snapshot, todo)만 허용. itemTile은 여러 항목, item은 실제 항목 하나만 받는다. 단일 카드의 마지막 참조 제거는 거절된다. ⚠️ 중요(참조형 주의): containItems에 들어있는 todo/memo/companionReport는 "참조"일 뿐 원본은 별도 문서에 산다. mode=remove로 컴포넌트에서 항목을 빼더라도 원본 todo/memo 자체는 그대로 남는다. 사용자가 "이 항목 빼줘/삭제해줘"라고 할 때는 반드시 다음 둘 중 어느 쪽인지 명시적으로 확인한 후 호출할 것: (a) 컴포넌트의 리스트에서만 빼기 → 이 tool에서 mode=remove (b) 원본 todo/memo까지 완전 삭제 → 추가로 delete_todo / delete_memo 호출 삭제나 대규모 구조 변경 전에는 사용자 확인을 거칠 것. 공유 보드(내가 멤버)에서는 containItems 편집이 append/remove 로만 가능하고 대상은 자기 항목만이다. replace 는 같은 리스트의 남의 항목까지 조용히 떨어뜨리므로 거부된다. 항목은 한 번에 공유 보드 하나에만 속한다. 이미 다른 공유 보드에 공유된 항목을 담으려 하면 거절되고 사유가 돌아온다 — 사용자에게 옮길지 묻고, 원하면 moveFromOtherSharedBoard:true 로 다시 호출. 빼기(remove)는 그 항목이 이 보드에 공유돼 있을 때만 공유 포인터를 걷는다(다른 보드 것은 그대로). 표(type table) 내용은 table:{columns, rows} 로 통째 교체한다(칸 하나만 고쳐도 표 전체를 보낸다 — get_project 의 table 을 고쳐 되돌려 쓰면 된다). 열 수가 그대로면 사람이 맞춘 열 폭을 유지하고, 바뀌면 자동 폭으로 돌린다. type 을 'table' 로 바꾸면 table 이 없을 때 빈 3열×2행 표가 심긴다. 표가 아닌 컴포넌트에 table 을 주면 에러.
update_record
ChatGPT기록 정의를 부분 수정한다 (이름·단위·카테고리·칸 등). 지정한 필드만 변경된다. ⚠️ 측정값을 남기는 도구가 아니다 — 그건 add_record_trace. ⚠️ numType/numUnit을 바꿔도 이미 쌓인 측정값은 변환되지 않는다(숫자 그대로 남는다). fields: 칸 목록 전체 교체(첫 칸 = 대표). 기존 칸을 이으려면 get_record 의 fields[].id 를 그대로 넘긴다 (id 없이 이름·종류가 같은 기존 칸도 같은 칸으로 본다 — 그 밖은 새 칸). 숫자 묶음(numberSet)은 parts·joiner·calc 도 통째로 다시 준다(get_record 의 칸을 고쳐 되넘기면 된다). 같은 칸의 숫자는 parts[].id 를 주거나 숫자 이름이 같으면 기존 숫자로 이어져 옛 값이 끊기지 않는다 — 그 밖은 새 숫자. 대표를 바꾸면 모든 측정값의 value(대표 칸 숫자 거울)가 새 대표 칸 값으로 다시 계산된다. 목록에서 뺀 칸의 값은 측정값에 남는다(다시 넣으면 돌아온다). numType/numUnit/useSet 은 대표 칸이 number 인 단순 기록의 줄임(대표 칸의 수치 종류·단위 / 세트 칸 붙이기·떼기) — fields 와 함께 줄 수 없다.
update_report
ChatGPT리포트 제목, 요청, 아이콘을 부분 수정. 기존 생성 지면은 유지된다.
update_routine
ChatGPT루틴 부분 수정. 지정한 필드만 변경된다. ⚠️ todoTemplates를 지정하면 전체 교체다(부분 추가가 아님). 기존 템플릿을 유지하며 추가하려면 get_routine으로 현재 목록을 읽어 합친 배열을 넘길 것. ⚠️ 이미 생성된 인스턴스에는 소급되지 않는다 — 템플릿 수정은 이후 생성분부터 적용된다.
update_snapshot
ChatGPTupdate_timeline_event
ChatGPT타임라인 이벤트의 제목 · 이모지 · 시작/끝 시각 · 설명을 고친다(바꿀 것만). 항목 · 성찰을 더하는 건 add_item_to_timeline_event.
update_todo
ChatGPT할일 수정. 변경할 필드만 전달. 상태를 done으로 변경하면 완료 처리. doneTime을 ISO 8601로 명시 가능 (사후 기록). deadline(기한)은 전달 시 전체 교체되며 null을 주면 기한이 해제된다. 공유 보드에 올라온 남의 할일도 수정할 수 있다 — 단 보드 소유자가 '멤버 항목 편집 허용'을 켰을 때만. 꺼져 있으면 무엇을 해야 열리는지 알려주며 거부한다. 남의 항목에는 categoryUid를 쓸 수 없고(사용자별 네임스페이스), 편집 이력(lastEditedByUid)이 남는다.
view_board_drawing
ChatGPT프로젝트 보드에 사용자가 손으로 그린 그림·글씨(펜·형광펜·크레파스)를 이미지로 본다. get_project 에는 손그림이 실리지 않는다 — 보드의 메모·스케치·화살표·체크 표시를 읽어야 하면 이 도구를 쓴다(get_project 응답에 drawing 이 있으면 그림이 있다는 뜻). 서버가 획을 그대로 그리고, 보드 카드는 상자 + 번호로 그린다(카드 속 글씨는 없음). 응답의 markers[] 가 번호 → componentId·제목·리스트 항목을 알려 주니 get_project 의 실제 카드·항목과 대조한다. 에셋 카드·스티커는 앱에서 보여 주는 사진을 그 자리에 깐다 — 사진 위에 그린 네모·동그라미·화살표는 사진 속 그 부분을 가리키니 사진에서 대상을 읽는다. 손그림이 닿은 사진 카드는 사진 해상도 확대 장(kind:"picture")이 따로 온다. - 기본: 그림 전체. 한 장으로 읽히면 한 장, 보드가 넓어 글씨가 뭉개지면 전체 배치도 1장 + 그림 묶음별 확대. - componentId: 그 카드와 거기 닿거나 근처에 그린 그림만(카드 주석·체크 표시 확인용 · 사진 카드면 사진 확대 장 포함). - region: 보드 좌표 사각형만(deferred[] 의 region 을 그대로 넣는다). clusters[].hints 는 기하로 센 후보(연결선·체크·취소선 등) — 판정은 이미지를 보고 한다. 읽기 전용.
