rootr-cli 0.24.0 → 0.26.0

package/lib/client.js

@@ -6,7 +6,7 @@
  * can render consistent, helpful messages.
  */
 
-import { currentRateLimitSink } from './context.js';
+import { currentDocMailSink, currentRateLimitSink } from './context.js';
 import { t as tr } from './i18n.js';
 
 /** Copy the API's X-RateLimit-* headers into the ambient per-call sink, if any. */
@@ -23,6 +23,25 @@ function captureRateLimit(res) {
   sink.upgradeUrl = res.headers.get('x-ratelimit-upgrade-url') || undefined;
 }
 
+/** DOC-MAIL-NOTIFY — 응답의 안 읽은 받은 문서 머리줄을 그릇에 모은다(그릇이 없으면 아무 일도 안 한다). */
+function captureDocMail(res, sink) {
+  if (!sink) return;
+  const unread = Number(res.headers.get('x-rootr-doc-mail-unread'));
+  if (Number.isFinite(unread) && res.headers.get('x-rootr-doc-mail-unread') !== null) sink.unread = unread;
+  const raw = res.headers.get('x-rootr-doc-mail-new-items');
+  if (!raw) return;
+  try {
+    const items = JSON.parse(Buffer.from(raw, 'base64url').toString('utf8'));
+    sink.items = sink.items || [];
+    for (const it of Array.isArray(items) ? items : []) {
+      if (it && it.id && !sink.items.some((x) => x.id === it.id)) sink.items.push(it);
+    }
+    sink.newCount = Math.max(sink.newCount || 0, Number(res.headers.get('x-rootr-doc-mail-new')) || 0);
+  } catch {
+    /* 알림만 빠진다 */
+  }
+}
+
 export class RootrApiError extends Error {
   constructor(message, { status, body, hint } = {}) {
     super(message);
@@ -154,6 +173,8 @@ export class RootrClient {
       ...this.defaultHeaders,
       ...(opts.headers || {}),
     };
+    const docMailSink = currentDocMailSink();
+    if (docMailSink?.channel) headers['X-Rootr-Doc-Mail-Channel'] = docMailSink.channel;
 
     let body = opts.body;
     if (body !== undefined && typeof body !== 'string' && !(body instanceof Uint8Array)) {
@@ -173,6 +194,7 @@ export class RootrClient {
     }
 
     captureRateLimit(res);
+    if (res.ok) captureDocMail(res, docMailSink);
 
     if (opts.returnResponse) {
       if (!res.ok) {
@@ -1049,11 +1071,11 @@ export class RootrClient {
    */
   async createDatabaseView(
     databaseId,
-    { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale } = {},
+    { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale, density, frozenColumns } = {},
   ) {
     return this.request(`/databases/${encodeURIComponent(databaseId)}/views`, {
       method: 'POST',
-      body: { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale },
+      body: { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale, density, frozenColumns },
     });
   }
 
@@ -1220,31 +1242,78 @@ export class RootrClient {
 
   async addColumn(
     databaseId,
-    { name, type, options, relationDatabaseId, reverseName, formula, rollup, prefix, searchExcluded, dimensions } = {},
+    { name, type, options, relationDatabaseId, reverseName, formula, rollup, prefix, searchExcluded, dimensions, align, wrap, highlightOverdue, allowTime, allowRange } = {},
   ) {
     return this.request(`/databases/${encodeURIComponent(databaseId)}/columns`, {
       method: 'POST',
       // 계산 칸(수식·롤업·번호)은 설정이 곧 그 칸이라 같이 보내야 한다.
       // reverseName 은 상대 표에 짝 칸을 만든다(양방향 관계).
       // searchExcluded 는 "검색 색인에서 제외"(표 관리자만).
-      body: { name, type, options, relationDatabaseId, reverseName, formula, rollup, prefix, searchExcluded, dimensions },
+      // align·wrap·highlightOverdue·allowTime·allowRange 는 칸 표시 설정(정렬·줄바꿈·지난 날짜 빨강·시간·기간).
+      body: { name, type, options, relationDatabaseId, reverseName, formula, rollup, prefix, searchExcluded, dimensions, align, wrap, highlightOverdue, allowTime, allowRange },
     });
   }
 
   async updateColumn(
     databaseId,
     propertyId,
-    { name, options, optionRenames, formula, rollup, prefix, reverseName, searchExcluded, dedupe, dedupeShow, relationFilter } = {},
+    { name, options, optionRenames, formula, rollup, prefix, reverseName, searchExcluded, dedupe, dedupeShow, relationFilter, align, wrap, highlightOverdue, allowTime, allowRange, dedupeCarry, validate, identifyProps } = {},
   ) {
     return this.request(
       `/databases/${encodeURIComponent(databaseId)}/columns/${encodeURIComponent(propertyId)}`,
       {
         method: 'PATCH',
-        body: { name, options, optionRenames, formula, rollup, prefix, reverseName, searchExcluded, dedupe, dedupeShow, relationFilter },
+        // identifyProps — 제목 칸만: 다른 표에서 이 표의 행을 고를 때 제목 옆에 붙일 칸(REL-PICK-IDENTIFY).
+        body: { name, options, optionRenames, formula, rollup, prefix, reverseName, searchExcluded, dedupe, dedupeShow, relationFilter, align, wrap, highlightOverdue, allowTime, allowRange, dedupeCarry, validate, identifyProps },
       },
     );
   }
 
+  /** DEDUPE-CARRY(P1) — 같은 사람의 이전 행 값을 `rowId` 행으로 가져온다(`from` 없으면 같은 값의 가장 최근 행). 이전 행은 그대로. */
+  async carryOver(databaseId, rowId, from) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/rows/${encodeURIComponent(rowId)}/carry-over`, {
+      method: 'POST',
+      body: from ? { from } : {},
+    });
+  }
+
+  /** VALUE-RULE(P2) — 지금 들어 있는 값 가운데 칸 검사에 안 맞는 것(고치지 않는다). */
+  async ruleViolations(databaseId, { limit } = {}) {
+    const q = limit ? `?limit=${encodeURIComponent(limit)}` : '';
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/rule-violations${q}`);
+  }
+
+  /** VALUE-RULE — 미리 채운 예시 꼴(제품이 정한 규칙이 아니라 고쳐 쓸 출발점). */
+  async valueRulePresets() {
+    return this.request('/value-rules/presets');
+  }
+
+  /** VALUE-RULE — 규칙을 걸기 전에 시험 값으로 돌려 본다(아무것도 저장하지 않는다). */
+  async testValueRule(rule, values, type) {
+    return this.request('/value-rules/test', { method: 'POST', body: { rule, values, ...(type ? { type } : {}) } });
+  }
+
+  /**
+   * COL-RENAME — 이 칸을 `name` 으로 바꾸면 함께 바뀌는 것(수식·버튼/자동 규칙 치환·다른 표 롤업·이어진 폼 질문·페이지 블록)과
+   * 따라갈 수 없는 것(warnings). 아무것도 쓰지 않는다. 실제로 바꾸면 updateColumn 응답의 `renameCascade` 에 같은 모양으로 온다.
+   */
+  async columnRenameImpact(databaseId, propertyId, name) {
+    return this.request(
+      `/databases/${encodeURIComponent(databaseId)}/columns/${encodeURIComponent(propertyId)}/rename-impact?name=${encodeURIComponent(name)}`,
+    );
+  }
+
+  /**
+   * REL-PICK — 관계 칸에 이을 행을 표 전체에서 제목(과 구분 칸)으로 찾는다. `{ rows: [{ id, title, subtitle }], total, hasMore }`.
+   * subtitle 은 그 표 제목 칸의 identifyProps(예: 연락처 끝 4자리 · 지원일) — 같은 이름을 가른다.
+   */
+  async pickRows(databaseId, { q, filters, ids, limit } = {}) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/rows/pick`, {
+      method: 'POST',
+      body: { q, filters, ids, limit },
+    });
+  }
+
   /**
    * DEDUPE(F5) — 중복 감지 칸 값이 같은 기존 행. `rowId` 를 주면 그 행의 지금 값으로(그 행은 빠진다), 아니면 `values`
    * ({칸 id 또는 이름: 값})로 찾는다. 기존 행마다 보일 칸(preview)과 이어진 행 최근 5건(history)이 함께 온다.
@@ -2051,15 +2120,16 @@ export class RootrClient {
 
   // ---- Doc mail (DOC-MAIL — 문서 송수신) ---------------------------------
   //
-  // 노드 하나를 **보낼 때의 복사본**으로 이메일 1~20명에게 보낸다. 받은 문서는 받는 사람의
-  // 이메일에 붙는다 — 계정이 없어도 메일 링크로 열리고, 나중에 그 이메일로 가입하면 문서함에
-  // 그대로 있다. 문서함은 사람(이메일)에 붙으므로 워크스페이스 주소 밑이 아니다.
+  // 노드 하나를 이메일 1~20명에게 **보낸다 = 원본을 그 이메일에 열어 준다**(복사본이 아니다 — DOC-MAIL-LIVE).
+  // 받는 사람은 원본을 실시간으로 보고, 받은 권한(read 보기·comment 댓글·write 편집)만큼 쓴다. 계정이 없으면 메일 링크에서
+  // 받은 이메일을 넣어 읽기 전용으로 열고, 그 이메일로 가입하면 문서함에서 원본이 열린다. 문서함은 사람(이메일)에 붙으므로
+  // 워크스페이스 주소 밑이 아니다.
 
-  /** 보내기 — WRITE 이상. 응답 `{batchId, items:[{id,to,emailed}]}`. */
-  async sendNode(nodeId, { to, message } = {}) {
+  /** 보내기 — 구성원 규칙으로 WRITE 이상. access: read|comment|write(기본 read). 응답 `{batchId, access, items:[{id,to,emailed,resent}]}`. */
+  async sendNode(nodeId, { to, message, access } = {}) {
     return this.request(`/nodes/${encodeURIComponent(nodeId)}/send`, {
       method: 'POST',
-      body: { to, ...(message ? { message } : {}) },
+      body: { to, ...(message ? { message } : {}), ...(access ? { access } : {}) },
     });
   }
 
@@ -2074,16 +2144,47 @@ export class RootrClient {
     return this.request(`/doc-mail${s ? `?${s}` : ''}`);
   }
 
-  /** 한 통 열기(본문 payload 포함). 받는 사람이 열면 읽음으로 바뀐다. */
-  async getDocMail(id) {
-    return this.request(`/doc-mail/${encodeURIComponent(id)}`);
+  /**
+   * 한 통 열기 — 원본의 **지금** 내용(읽기 전용: 문서면 contentMd, 그 밖은 payload)·받은 권한(access)·원본 주소(openUrl).
+   * 폴더를 받았으면 children 이 오고, node 로 그 아래 것을 골라 읽는다. 받는 사람이 열면 읽음으로 바뀐다.
+   */
+  async getDocMail(id, { node } = {}) {
+    return this.request(`/doc-mail/${encodeURIComponent(id)}${node ? `?node=${encodeURIComponent(node)}` : ''}`);
   }
 
-  /** 회수 — 보낸 사람만. 이후 받는 쪽에서 본문이 안 보인다. */
+  /** 회수 — 보낸 사람만. 받는 사람의 원본 접근이 바로 닫힌다. */
   async revokeDocMail(id) {
     return this.request(`/doc-mail/${encodeURIComponent(id)}/revoke`, { method: 'POST', body: {} });
   }
 
+  // ---- Doc mail webhooks (DOC-MAIL-HOOK — 사람 단위) ---------------------
+  /** 내 받은 문서 웹훅 만들기 — events: doc_mail.received|doc_mail.revoked|doc_mail.read(안 주면 셋 다). 비밀값은 이 응답에만. */
+  async addDocMailWebhook({ url, events, name } = {}) {
+    return this.request('/doc-mail-webhooks', { method: 'POST', body: { url, ...(events?.length ? { events } : {}), ...(name ? { name } : {}) } });
+  }
+
+  async listDocMailWebhooks() {
+    return this.request('/doc-mail-webhooks');
+  }
+
+  async removeDocMailWebhook(id) {
+    return this.request(`/doc-mail-webhooks/${encodeURIComponent(id)}`, { method: 'DELETE' });
+  }
+
+  /** 시험 전송 한 통(doc_mail.test). 결과는 docMailWebhookDeliveries(id). */
+  async testDocMailWebhook(id) {
+    return this.request(`/doc-mail-webhooks/${encodeURIComponent(id)}/test`, { method: 'POST', body: {} });
+  }
+
+  async docMailWebhookDeliveries(id) {
+    return this.request(`/doc-mail-webhooks/${encodeURIComponent(id)}/deliveries`);
+  }
+
+  /** 받은 사람의 권한 바꾸기 — 보낸 사람만, 내 수준까지. */
+  async setDocMailAccess(id, access) {
+    return this.request(`/doc-mail/${encodeURIComponent(id)}`, { method: 'PATCH', body: { access } });
+  }
+
   /** 내 문서함에서만 지우기(상대 화면은 그대로). box 로 나에게 보낸 것의 한쪽만 고를 수 있다. */
   async hideDocMail(id, { box } = {}) {
     return this.request(`/doc-mail/${encodeURIComponent(id)}${box ? `?box=${encodeURIComponent(box)}` : ''}`, {

package/lib/context.js

@@ -36,3 +36,24 @@ export function withRateLimitSink(sink, fn) {
 export function currentRateLimitSink() {
   return rateLimitStorage.getStore();
 }
+
+/**
+ * DOC-MAIL-NOTIFY — 안 읽은 받은 문서 알림을 모으는 그릇. `RootrClient.request` 가 그릇이 있으면 요청에
+ * `X-Rootr-Doc-Mail-Channel: <channel>` 을 붙이고, 응답의 `X-Rootr-Doc-Mail-Unread/New/New-Items` 를 여기 모은다(서버가
+ * 그 채널에 한 번만 알린다). MCP 는 도구 호출마다 async-local 그릇(channel 'mcp'), CLI 명령은 프로세스 전체 그릇(channel 'cli').
+ * 원격 MCP(API 프로세스 안)는 async-local 만 쓴다 — 전역 그릇은 CLI 실행 파일만 놓는다(여러 사람이 한 프로세스를 나눠 쓴다).
+ */
+const docMailStorage = new AsyncLocalStorage();
+let globalDocMailSink = null;
+
+export function withDocMailSink(sink, fn) {
+  return docMailStorage.run(sink, fn);
+}
+
+export function setGlobalDocMailSink(sink) {
+  globalDocMailSink = sink;
+}
+
+export function currentDocMailSink() {
+  return docMailStorage.getStore() ?? globalDocMailSink;
+}

package/lib/mcp-tools/booking.js

@@ -50,12 +50,22 @@ const GOOGLE_SCHEMA = z.object({
   busyCalendarIds: z
     .array(z.string())
     .optional()
-    .describe('Calendars whose busy times block bookings. Only free/busy is read — never event titles.'),
+    .describe(
+      'Calendars whose busy times block bookings. Only busy times and the dates of all-day events are read — never titles or guests.',
+    ),
   writeCalendarId: z
     .string()
     .nullable()
     .optional()
     .describe('Calendar that receives confirmed bookings. null = do not write anything to Google.'),
+  allDayBusy: z
+    .boolean()
+    .optional()
+    .describe(
+      'All-day events block the whole day (default true). Google marks all-day events "free" by default, so busy times alone miss ' +
+        'vacations, trips and holidays; a public holiday calendar in busyCalendarIds then closes holidays. Working-location, birthday ' +
+        'and declined events never block. false = only busy times block.',
+    ),
   meet: z
     .boolean()
     .optional()