nworks 0.3.3 → 0.5.0

package/dist/mcp.js

@@ -14311,6 +14311,230 @@ async function downloadFile(fileId, userId = "me", profile = "default") {
   return { buffer, fileName };
 }
 
+// src/api/mail.ts
+var BASE_URL4 = "https://www.worksapis.com/v1.0";
+async function authedFetch2(url2, init, profile) {
+  const token = await getValidUserToken(profile);
+  const headers = new Headers(init.headers);
+  headers.set("Authorization", `Bearer ${token}`);
+  return fetch(url2, { ...init, headers });
+}
+async function handleError2(res) {
+  if (res.status === 401) {
+    throw new AuthError("User token expired. Run `nworks login --user --scope mail` again.");
+  }
+  let code = "UNKNOWN";
+  let description = `HTTP ${res.status}`;
+  try {
+    const body = await res.json();
+    code = body.code ?? code;
+    description = body.description ?? description;
+  } catch {
+  }
+  throw new ApiError(code, description, res.status);
+}
+async function sendMail(opts) {
+  const userId = opts.userId ?? "me";
+  const profile = opts.profile ?? "default";
+  const url2 = `${BASE_URL4}/users/${userId}/mail`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] POST ${url2}`);
+  }
+  const body = {
+    to: opts.to,
+    subject: opts.subject
+  };
+  if (opts.body !== void 0) body.body = opts.body;
+  if (opts.cc) body.cc = opts.cc;
+  if (opts.bcc) body.bcc = opts.bcc;
+  if (opts.contentType) body.contentType = opts.contentType;
+  const res = await authedFetch2(
+    url2,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    },
+    profile
+  );
+  if (res.status === 202) return;
+  if (!res.ok) return handleError2(res);
+}
+async function listMails(folderId = 0, userId = "me", count = 30, cursor, isUnread, profile = "default") {
+  const params = new URLSearchParams();
+  params.set("count", String(count));
+  if (cursor) params.set("cursor", cursor);
+  if (isUnread) params.set("isUnread", "true");
+  const url2 = `${BASE_URL4}/users/${userId}/mail/mailfolders/${folderId}/children?${params.toString()}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url2}`);
+  }
+  const res = await authedFetch2(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError2(res);
+  const data = await res.json();
+  return {
+    mails: data.mails ?? [],
+    unreadCount: data.unreadCount,
+    folderName: data.folderName,
+    totalCount: data.totalCount,
+    responseMetaData: data.responseMetaData
+  };
+}
+async function readMail(mailId, userId = "me", profile = "default") {
+  const url2 = `${BASE_URL4}/users/${userId}/mail/${mailId}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url2}`);
+  }
+  const res = await authedFetch2(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError2(res);
+  return await res.json();
+}
+
+// src/api/task.ts
+var BASE_URL5 = "https://www.worksapis.com/v1.0";
+async function authedFetch3(url2, init, profile) {
+  const token = await getValidUserToken(profile);
+  const headers = new Headers(init.headers);
+  headers.set("Authorization", `Bearer ${token}`);
+  return fetch(url2, { ...init, headers });
+}
+async function handleError3(res) {
+  if (res.status === 401) {
+    throw new AuthError("User token expired. Run `nworks login --user --scope task` again.");
+  }
+  let code = "UNKNOWN";
+  let description = `HTTP ${res.status}`;
+  try {
+    const body = await res.json();
+    code = body.code ?? code;
+    description = body.description ?? description;
+  } catch {
+  }
+  throw new ApiError(code, description, res.status);
+}
+async function resolveUserId(userId, profile) {
+  if (userId !== "me") return userId;
+  const url2 = `${BASE_URL5}/users/me`;
+  const res = await authedFetch3(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError3(res);
+  const data = await res.json();
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] Resolved "me" \u2192 ${data.userId}`);
+  }
+  return data.userId;
+}
+async function listTasks(categoryId = "default", userId = "me", count = 50, cursor, status = "ALL", profile = "default") {
+  const params = new URLSearchParams();
+  params.set("categoryId", categoryId);
+  params.set("count", String(count));
+  params.set("status", status);
+  if (cursor) params.set("cursor", cursor);
+  const url2 = `${BASE_URL5}/users/${userId}/tasks?${params.toString()}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url2}`);
+  }
+  const res = await authedFetch3(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError3(res);
+  const data = await res.json();
+  return { tasks: data.tasks ?? [], responseMetaData: data.responseMetaData };
+}
+async function createTask(opts) {
+  const userId = opts.userId ?? "me";
+  const profile = opts.profile ?? "default";
+  const resolvedUserId = await resolveUserId(userId, profile);
+  const assignorId = opts.assignorId ?? resolvedUserId;
+  const assigneeIds = opts.assigneeIds ?? [resolvedUserId];
+  const body = {
+    assignorId,
+    assignees: assigneeIds.map((id) => ({ assigneeId: id, status: "TODO" })),
+    title: opts.title,
+    content: opts.content ?? "",
+    completionCondition: "ANY_ONE"
+  };
+  if (opts.dueDate) body.dueDate = opts.dueDate;
+  if (opts.categoryId) body.categoryId = opts.categoryId;
+  const url2 = `${BASE_URL5}/users/${userId}/tasks`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] POST ${url2}`);
+    console.error(`[nworks] Body: ${JSON.stringify(body, null, 2)}`);
+  }
+  const res = await authedFetch3(
+    url2,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    },
+    profile
+  );
+  if (res.status === 201) {
+    return await res.json();
+  }
+  if (!res.ok) return handleError3(res);
+  return await res.json();
+}
+async function updateTask(opts) {
+  const profile = opts.profile ?? "default";
+  const body = {};
+  if (opts.title !== void 0) body.title = opts.title;
+  if (opts.content !== void 0) body.content = opts.content;
+  if (opts.dueDate !== void 0) body.dueDate = opts.dueDate;
+  const url2 = `${BASE_URL5}/tasks/${opts.taskId}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] PATCH ${url2}`);
+  }
+  const res = await authedFetch3(
+    url2,
+    {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    },
+    profile
+  );
+  if (!res.ok) return handleError3(res);
+  return await res.json();
+}
+async function completeTask(taskId, profile = "default") {
+  const url2 = `${BASE_URL5}/tasks/${taskId}/complete`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] POST ${url2}`);
+  }
+  const res = await authedFetch3(
+    url2,
+    { method: "POST" },
+    profile
+  );
+  if (res.status === 204) return;
+  if (!res.ok) return handleError3(res);
+}
+async function incompleteTask(taskId, profile = "default") {
+  const url2 = `${BASE_URL5}/tasks/${taskId}/incomplete`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] POST ${url2}`);
+  }
+  const res = await authedFetch3(
+    url2,
+    { method: "POST" },
+    profile
+  );
+  if (res.status === 204) return;
+  if (!res.ok) return handleError3(res);
+}
+async function deleteTask(taskId, profile = "default") {
+  const url2 = `${BASE_URL5}/tasks/${taskId}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] DELETE ${url2}`);
+  }
+  const res = await authedFetch3(
+    url2,
+    { method: "DELETE" },
+    profile
+  );
+  if (res.status === 204) return;
+  if (!res.ok) return handleError3(res);
+}
+
 // src/mcp/tools.ts
 function registerTools(server) {
   server.tool(
@@ -14559,6 +14783,256 @@ function registerTools(server) {
       }
     }
   );
+  server.tool(
+    "nworks_mail_send",
+    "\uBA54\uC77C\uC744 \uC804\uC1A1\uD569\uB2C8\uB2E4 (User OAuth mail scope \uD544\uC694). \uBE44\uB3D9\uAE30 \uC804\uC1A1\uC73C\uB85C, \uC131\uACF5 \uC2DC 202 \uC751\uB2F5\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4.",
+    {
+      to: external_exports.string().describe("\uC218\uC2E0\uC790 \uC774\uBA54\uC77C (\uC5EC\uB7EC \uBA85\uC740 ; \uB85C \uAD6C\uBD84)"),
+      subject: external_exports.string().describe("\uBA54\uC77C \uC81C\uBAA9"),
+      body: external_exports.string().optional().describe("\uBA54\uC77C \uBCF8\uBB38"),
+      cc: external_exports.string().optional().describe("\uCC38\uC870 \uC774\uBA54\uC77C (\uC5EC\uB7EC \uBA85\uC740 ; \uB85C \uAD6C\uBD84)"),
+      bcc: external_exports.string().optional().describe("\uC228\uC740\uCC38\uC870 \uC774\uBA54\uC77C (\uC5EC\uB7EC \uBA85\uC740 ; \uB85C \uAD6C\uBD84)"),
+      contentType: external_exports.enum(["html", "text"]).optional().describe("\uBCF8\uBB38 \uD615\uC2DD (\uAE30\uBCF8: html)"),
+      userId: external_exports.string().optional().describe("\uBC1C\uC2E0\uC790 ID (\uBBF8\uC9C0\uC815 \uC2DC me)")
+    },
+    async ({ to, subject, body, cc, bcc, contentType, userId }) => {
+      try {
+        await sendMail({
+          to,
+          subject,
+          body,
+          cc,
+          bcc,
+          contentType,
+          userId: userId ?? "me"
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, message: "Mail sent (async)" }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_mail_list",
+    "\uBA54\uC77C\uD568\uC758 \uBA54\uC77C \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4 (User OAuth mail \uB610\uB294 mail.read scope \uD544\uC694)",
+    {
+      folderId: external_exports.number().optional().describe("\uBA54\uC77C \uD3F4\uB354 ID (\uAE30\uBCF8: 0 = \uBC1B\uC740\uD3B8\uC9C0\uD568)"),
+      count: external_exports.number().optional().describe("\uD398\uC774\uC9C0\uB2F9 \uD56D\uBAA9 \uC218 (\uAE30\uBCF8: 30, \uCD5C\uB300: 200)"),
+      cursor: external_exports.string().optional().describe("\uD398\uC774\uC9C0\uB124\uC774\uC158 \uCEE4\uC11C"),
+      isUnread: external_exports.boolean().optional().describe("\uC77D\uC9C0 \uC54A\uC740 \uBA54\uC77C\uB9CC \uC870\uD68C"),
+      userId: external_exports.string().optional().describe("\uB300\uC0C1 \uC0AC\uC6A9\uC790 ID (\uBBF8\uC9C0\uC815 \uC2DC me)")
+    },
+    async ({ folderId, count, cursor, isUnread, userId }) => {
+      try {
+        const result = await listMails(
+          folderId ?? 0,
+          userId ?? "me",
+          count ?? 30,
+          cursor,
+          isUnread
+        );
+        const mails = result.mails.map((m) => ({
+          mailId: m.mailId,
+          from: m.from.email,
+          subject: m.subject,
+          date: m.receivedTime,
+          status: m.status,
+          attachments: m.attachCount ?? 0
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify({ mails, count: mails.length, totalCount: result.totalCount, unreadCount: result.unreadCount, nextCursor: result.responseMetaData?.nextCursor ?? null }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_mail_read",
+    "\uD2B9\uC815 \uBA54\uC77C\uC758 \uC0C1\uC138 \uB0B4\uC6A9\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4 (User OAuth mail \uB610\uB294 mail.read scope \uD544\uC694)",
+    {
+      mailId: external_exports.number().describe("\uBA54\uC77C ID"),
+      userId: external_exports.string().optional().describe("\uB300\uC0C1 \uC0AC\uC6A9\uC790 ID (\uBBF8\uC9C0\uC815 \uC2DC me)")
+    },
+    async ({ mailId, userId }) => {
+      try {
+        const result = await readMail(
+          mailId,
+          userId ?? "me"
+        );
+        const mail = result.mail;
+        return {
+          content: [{ type: "text", text: JSON.stringify({
+            mailId: mail.mailId,
+            from: mail.from,
+            to: mail.to,
+            cc: mail.cc ?? [],
+            subject: mail.subject,
+            body: mail.body,
+            date: mail.receivedTime,
+            attachments: result.attachments?.map((a) => ({
+              id: a.attachmentId,
+              filename: a.filename,
+              contentType: a.contentType,
+              size: a.size
+            })) ?? []
+          }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_task_list",
+    "\uD560 \uC77C \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4 (User OAuth task \uB610\uB294 task.read scope \uD544\uC694)",
+    {
+      categoryId: external_exports.string().optional().describe("\uCE74\uD14C\uACE0\uB9AC ID (\uAE30\uBCF8: default)"),
+      status: external_exports.enum(["TODO", "ALL"]).optional().describe("\uD544\uD130: TODO \uB610\uB294 ALL (\uAE30\uBCF8: ALL)"),
+      count: external_exports.number().optional().describe("\uD398\uC774\uC9C0\uB2F9 \uD56D\uBAA9 \uC218 (\uAE30\uBCF8: 50, \uCD5C\uB300: 100)"),
+      cursor: external_exports.string().optional().describe("\uD398\uC774\uC9C0\uB124\uC774\uC158 \uCEE4\uC11C"),
+      userId: external_exports.string().optional().describe("\uB300\uC0C1 \uC0AC\uC6A9\uC790 ID (\uBBF8\uC9C0\uC815 \uC2DC me)")
+    },
+    async ({ categoryId, status, count, cursor, userId }) => {
+      try {
+        const result = await listTasks(
+          categoryId ?? "default",
+          userId ?? "me",
+          count ?? 50,
+          cursor,
+          status ?? "ALL"
+        );
+        const tasks = result.tasks.map((t) => ({
+          taskId: t.taskId,
+          title: t.title,
+          status: t.status,
+          dueDate: t.dueDate,
+          assignor: t.assignorName ?? t.assignorId,
+          created: t.createdTime
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify({ tasks, count: tasks.length, nextCursor: result.responseMetaData?.nextCursor ?? null }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_task_create",
+    "\uD560 \uC77C\uC744 \uC0DD\uC131\uD569\uB2C8\uB2E4 (User OAuth task scope \uD544\uC694). \uAE30\uBCF8\uC801\uC73C\uB85C \uC790\uAE30 \uC790\uC2E0\uC5D0\uAC8C \uD560\uB2F9\uB429\uB2C8\uB2E4.",
+    {
+      title: external_exports.string().describe("\uD560 \uC77C \uC81C\uBAA9"),
+      content: external_exports.string().optional().describe("\uD560 \uC77C \uB0B4\uC6A9"),
+      dueDate: external_exports.string().optional().describe("\uB9C8\uAC10\uC77C (YYYY-MM-DD)"),
+      categoryId: external_exports.string().optional().describe("\uCE74\uD14C\uACE0\uB9AC ID"),
+      assigneeIds: external_exports.array(external_exports.string()).optional().describe("\uB2F4\uB2F9\uC790 user ID \uBAA9\uB85D (\uBBF8\uC9C0\uC815 \uC2DC \uC790\uAE30 \uC790\uC2E0)"),
+      userId: external_exports.string().optional().describe("\uC0DD\uC131\uC790 user ID (\uBBF8\uC9C0\uC815 \uC2DC me)")
+    },
+    async ({ title, content, dueDate, categoryId, assigneeIds, userId }) => {
+      try {
+        const result = await createTask({
+          title,
+          content,
+          dueDate,
+          categoryId,
+          assigneeIds,
+          userId: userId ?? "me"
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, taskId: result.taskId, title: result.title, status: result.status, dueDate: result.dueDate }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_task_update",
+    "\uD560 \uC77C\uC744 \uC218\uC815\uD569\uB2C8\uB2E4 (User OAuth task scope \uD544\uC694). \uC0C1\uD0DC \uBCC0\uACBD(done/todo)\uACFC \uD544\uB4DC \uC218\uC815\uC744 \uBAA8\uB450 \uC9C0\uC6D0\uD569\uB2C8\uB2E4.",
+    {
+      taskId: external_exports.string().describe("\uD560 \uC77C ID"),
+      status: external_exports.enum(["done", "todo"]).optional().describe("\uC0C1\uD0DC \uBCC0\uACBD: done \uB610\uB294 todo"),
+      title: external_exports.string().optional().describe("\uC0C8 \uC81C\uBAA9"),
+      content: external_exports.string().optional().describe("\uC0C8 \uB0B4\uC6A9"),
+      dueDate: external_exports.string().optional().describe("\uC0C8 \uB9C8\uAC10\uC77C (YYYY-MM-DD)")
+    },
+    async ({ taskId, status, title, content, dueDate }) => {
+      try {
+        if (status) {
+          if (status === "done") {
+            await completeTask(taskId);
+          } else {
+            await incompleteTask(taskId);
+          }
+        }
+        if (title !== void 0 || content !== void 0 || dueDate !== void 0) {
+          const result = await updateTask({ taskId, title, content, dueDate });
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, taskId: result.taskId, title: result.title, status: result.status, dueDate: result.dueDate }) }]
+          };
+        }
+        if (status) {
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, taskId, status: status === "done" ? "DONE" : "TODO" }) }]
+          };
+        }
+        return {
+          content: [{ type: "text", text: "Error: status, title, content, dueDate \uC911 \uD558\uB098 \uC774\uC0C1\uC744 \uC9C0\uC815\uD558\uC138\uC694." }],
+          isError: true
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_task_delete",
+    "\uD560 \uC77C\uC744 \uC0AD\uC81C\uD569\uB2C8\uB2E4 (User OAuth task scope \uD544\uC694)",
+    {
+      taskId: external_exports.string().describe("\uC0AD\uC81C\uD560 \uD560 \uC77C ID")
+    },
+    async ({ taskId }) => {
+      try {
+        await deleteTask(taskId);
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, taskId, message: "Task deleted" }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
   server.tool(
     "nworks_whoami",
     "\uD604\uC7AC \uC778\uC99D\uB41C NAVER WORKS \uACC4\uC815 \uC815\uBCF4\uB97C \uD655\uC778\uD569\uB2C8\uB2E4",