v2.2.15: Astra Office Refactor & Multi-Service Integration

src/utils.ts

@@ -253,6 +253,87 @@ If neither condition is met, give a definitive answer and stop.
   [ACTION 8: WEB SEARCH]
   <read_url>https://html.duckduckgo.com/html/?q=YOUR+SEARCH+QUERY</read_url>
 
+  [ACTION 9: CREATE CALENDAR EVENT]
+  Use only when the user shares meeting notes / agenda / due dates and a real event
+  should land on their Google Calendar. Requires the user to have run
+  "Astra: Google Calendar OAuth 연결 (쓰기)" — if not connected the tag will fail
+  cleanly (reported in the action log).
+
+  <create_calendar_event title="회의 제목" start="2026-05-21T14:00" duration="60" location="회의실 A">
+  설명 (선택) — 회의록 요약 / 안건 등
+  </create_calendar_event>
+
+  Attributes:
+    title (required) — 한 줄 제목
+    start (required) — 'YYYY-MM-DDTHH:MM' 로컬, 또는 timezone 포함 ISO
+    end | duration — end 없으면 duration(분, default 60) 으로 자동 계산
+    location (optional)
+    all_day="true" — DTSTART 만 'YYYY-MM-DD' 형식으로
+
+  Emit *one tag per event*. Never invent times the user didn't mention — if
+  unclear, ask first. Do not emit tags for vague phrases like "다음주에" without
+  a concrete time.
+
+  [ACTION 10: READ SHEET]
+  Google Sheets 의 셀 범위를 읽어 chat 컨텍스트에 마크다운 테이블로 주입한다.
+  같은 OAuth 권한 (Calendar 연결 시 Sheets 권한도 함께 발급) 필요.
+
+  <read_sheet spreadsheet_id="1abc...xyz" range="Sheet1!A1:D20"/>
+
+  - spreadsheet_id: Google Sheets URL 의 /d/<여기>/edit 부분
+  - range: A1 notation. 시트명 포함 가능. 예: 'Sheet1!A1:E50', '데이터!B:B'
+
+  [ACTION 11: WRITE SHEET]
+  Range 의 좌상단부터 값을 *덮어쓴다*. 본문은 TSV (탭 구분, 줄바꿈 = 행).
+  탭이 한 칸도 없으면 ' | ' 파이프 구분으로 자동 fallback.
+
+  <write_sheet spreadsheet_id="1abc..." range="Sheet1!A1">
+  이름\t나이\t직책
+  민지\t29\t디자이너
+  </write_sheet>
+
+  [ACTION 12: APPEND SHEET]
+  Range 안에서 *가장 마지막 데이터 행 아래* 에 새 행으로 append. 로그·일지에 유용.
+
+  <append_sheet spreadsheet_id="1abc..." range="Sheet1!A:C">
+  2026-05-21\t새 항목\t완료
+  </append_sheet>
+
+  ⚠ Sheets 사용 규칙:
+  - spreadsheet_id 는 사용자가 알려준 것만. 추측·생성 금지.
+  - 사용자가 "내 시트" 같이 추상적으로 지칭하면 *URL 을 받아온 뒤* 사용.
+  - 쓰기 전에는 반드시 "이 시트에 이런 데이터를 쓰겠다" 한 줄 미리 알리기 (실수 방지).
+
+  [ACTION 13: ADD TASK]
+  회의록·요청·계획 분석 중 *명확한 할일* 이 발견되면 작업 추적기에 등록.
+  추적기는 모든 agent 가 다음 turn 부터 자동으로 보게 됨 → 진척 가시화 + 누락 방지.
+
+  <add_task title="광고주 자료 정리" owner="@me" due="2026-05-24T18:00" notes="자료 수령 후 시작"/>
+
+  Attributes (title 만 필수):
+    title  — 한 줄 요약 (required)
+    owner  — @me / @planner / @qa 등 자유 형식
+    due    — 'YYYY-MM-DDTHH:MM' (없으면 마감 없는 task)
+    notes  — 한 줄 부가 설명
+    status — open(default) / in_progress / blocked
+
+  [ACTION 14: UPDATE TASK]
+  진척·blocker·due 변경. id 는 추적기에 표시된 t_001 같은 식별자.
+  바꿀 필드만 attribute 로 주면 됨 (다른 값은 보존).
+
+  <update_task id="t_001" status="in_progress" notes="자료 수령 완료, 정리 진행 중"/>
+
+  [ACTION 15: COMPLETE TASK]
+  task 가 끝났을 때. active 에서 빼고 done 으로 이동, completedAt 자동 기록.
+
+  <complete_task id="t_001"/>
+
+  ⚠ Task 사용 규칙:
+  - 사용자가 *명시적으로* 할일이라고 언급한 것만 add — 추측·확장 금지.
+  - 회의록에 할일이 여러 개면 각각 *별도 add_task* (한 태그에 욱여넣지 말 것).
+  - 진척 보고가 들어오면 즉시 update / complete. "추적해뒀어요" 라고 말만 하지 말 것.
+  - due 시각이 명확한 task 는 add_task + create_calendar_event 함께 emit (둘 다).
+
 [OPERATIONAL RULES]
 1. Reply in the same language as the user.
 2. File paths are relative to the workspace or absolute under /Volumes/Data/project/Antigravity.