nworks 0.3.3 → 0.4.0

package/dist/mcp.js

@@ -14311,6 +14311,85 @@ 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/mcp/tools.ts
 function registerTools(server) {
   server.tool(
@@ -14559,6 +14638,120 @@ 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_whoami",
     "\uD604\uC7AC \uC778\uC99D\uB41C NAVER WORKS \uACC4\uC815 \uC815\uBCF4\uB97C \uD655\uC778\uD569\uB2C8\uB2E4",