opencode-discord-notify 0.3.2 → 0.4.0

package/dist/index.js

@@ -1,4 +1,15 @@
 // src/index.ts
+var DISCORD_FIELD_VALUE_MAX_LENGTH = 1024;
+var DISCORD_EMBED_DESCRIPTION_MAX_LENGTH = 4096;
+var DISCORD_THREAD_NAME_MAX_LENGTH = 100;
+var ELLIPSIS = "...";
+var ELLIPSIS_LENGTH = 3;
+var TOAST_DURATION_MS = 8e3;
+var TOAST_COOLDOWN_MS = 3e4;
+var TODO_ITEM_DISPLAY_MAX_LENGTH = 200;
+var HTTP_STATUS_TOO_MANY_REQUESTS = 429;
+var MS_PER_SECOND = 1e3;
+var DEFAULT_RATE_LIMIT_WAIT_MS = 1e4;
 var SEND_PARAM_KEYS = [
   "sessionID",
   "permissionID",
@@ -37,9 +48,13 @@ function buildFields(fields, inline = false) {
   for (const [name, rawValue] of fields) {
     const value = safeString(rawValue);
     if (!value) continue;
+    const truncatedValue = value.length > DISCORD_FIELD_VALUE_MAX_LENGTH ? value.slice(
+      0,
+      DISCORD_FIELD_VALUE_MAX_LENGTH - ELLIPSIS_LENGTH
+    ) + ELLIPSIS : value;
     result.push({
       name,
-      value: value.length > 1024 ? value.slice(0, 1021) + "..." : value,
+      value: truncatedValue,
       inline
     });
   }
@@ -117,8 +132,12 @@ function buildMention(mention, nameForLog) {
 function normalizeTodoContent(value) {
   return safeString(value).replace(/\s+/g, " ").trim();
 }
+function getTodoStatusMarker(status) {
+  if (status === "completed") return "[\u2713]";
+  if (status === "in_progress") return "[\u25B6]";
+  return "[ ]";
+}
 function buildTodoChecklist(todos) {
-  const maxDescription = 4096;
   const items = Array.isArray(todos) ? todos : [];
   let matchCount = 0;
   let description = "";
@@ -128,10 +147,10 @@ function buildTodoChecklist(todos) {
     if (status === "cancelled") continue;
     const content = normalizeTodoContent(item?.content);
     if (!content) continue;
-    const marker = status === "completed" ? "[\u2713]" : status === "in_progress" ? "[\u25B6]" : "[ ]";
-    const line = `> ${marker} ${truncateText(content, 200)}`;
+    const marker = getTodoStatusMarker(status);
+    const line = `> ${marker} ${truncateText(content, TODO_ITEM_DISPLAY_MAX_LENGTH)}`;
     const nextChunk = (description ? "\n" : "") + line;
-    if (description.length + nextChunk.length > maxDescription) {
+    if (description.length + nextChunk.length > DISCORD_EMBED_DESCRIPTION_MAX_LENGTH) {
       truncated = true;
       break;
     }
@@ -143,7 +162,7 @@ function buildTodoChecklist(todos) {
   }
   if (truncated || matchCount < items.length) {
     const moreLine = `${description ? "\n" : ""}> ...and more`;
-    if (description.length + moreLine.length <= maxDescription) {
+    if (description.length + moreLine.length <= DISCORD_EMBED_DESCRIPTION_MAX_LENGTH) {
       description += moreLine;
     }
   }
@@ -197,10 +216,10 @@ async function postDiscordWebhook(input, deps) {
       return void 0;
     return { id: messageId, channel_id: channelId };
   }
-  if (response.status === 429) {
+  if (response.status === HTTP_STATUS_TOO_MANY_REQUESTS) {
     const text2 = await response.text().catch(() => "");
     const retryAfterSeconds = parseRetryAfterFromText(text2) ?? parseRetryAfterFromHeader(response.headers);
-    const waitMs = retryAfterSeconds === void 0 ? deps.waitOnRateLimitMs : Math.ceil(retryAfterSeconds * 1e3);
+    const waitMs = retryAfterSeconds === void 0 ? deps.waitOnRateLimitMs : Math.ceil(retryAfterSeconds * MS_PER_SECOND);
     await sleepImpl(waitMs);
     const retryResponse = await doRequest();
     if (!retryResponse.ok) {
@@ -208,8 +227,8 @@ async function postDiscordWebhook(input, deps) {
         await deps.maybeAlertError({
           key: `discord_webhook_error:${retryResponse.status}`,
           title: "Discord webhook rate-limited",
-          message: `Discord webhook returned 429 (rate limited). Waited ${Math.round(
-            waitMs / 1e3
+          message: `Discord webhook returned ${HTTP_STATUS_TOO_MANY_REQUESTS} (rate limited). Waited ${Math.round(
+            waitMs / MS_PER_SECOND
           )}s and retried, but it still failed.`,
           variant: "warning"
         });
@@ -260,14 +279,14 @@ var plugin = async ({ client }) => {
   const excludeInputContext = excludeInputContextRaw !== "0";
   const showErrorAlertRaw = (getEnv("DISCORD_WEBHOOK_SHOW_ERROR_ALERT") ?? "1").trim();
   const showErrorAlert = showErrorAlertRaw !== "0";
-  const waitOnRateLimitMs = 1e4;
-  const toastCooldownMs = 3e4;
+  const waitOnRateLimitMs = DEFAULT_RATE_LIMIT_WAIT_MS;
   const sendParams = parseSendParams(getEnv("DISCORD_SEND_PARAMS"));
   const lastAlertAtByKey = /* @__PURE__ */ new Map();
+  const sentTextPartIds = /* @__PURE__ */ new Set();
   const showToast = async ({ title, message, variant }) => {
     try {
       await client.tui.showToast({
-        body: { title, message, variant, duration: 8e3 }
+        body: { title, message, variant, duration: TOAST_DURATION_MS }
       });
     } catch {
     }
@@ -281,7 +300,7 @@ var plugin = async ({ client }) => {
     if (!showErrorAlert) return;
     const now = Date.now();
     const last = lastAlertAtByKey.get(key);
-    if (last !== void 0 && now - last < toastCooldownMs) return;
+    if (last !== void 0 && now - last < TOAST_COOLDOWN_MS) return;
     lastAlertAtByKey.set(key, now);
     await showToast({ title, message, variant });
   };
@@ -289,7 +308,7 @@ var plugin = async ({ client }) => {
   async function showMissingUrlToastOnce() {
     const now = Date.now();
     const last = lastAlertAtByKey.get(MISSING_URL_KEY);
-    if (last !== void 0 && now - last < toastCooldownMs) return;
+    if (last !== void 0 && now - last < TOAST_COOLDOWN_MS) return;
     lastAlertAtByKey.set(MISSING_URL_KEY, now);
     await showToast({
       title: "Discord webhook not configured",
@@ -317,15 +336,17 @@ var plugin = async ({ client }) => {
   }
   function buildThreadName(sessionID) {
     const fromUser = normalizeThreadTitle(firstUserTextBySession.get(sessionID));
-    if (fromUser) return fromUser.slice(0, 100);
+    if (fromUser) return fromUser.slice(0, DISCORD_THREAD_NAME_MAX_LENGTH);
     const fromSessionTitle = normalizeThreadTitle(
       lastSessionInfo.get(sessionID)?.title
     );
-    if (fromSessionTitle) return fromSessionTitle.slice(0, 100);
+    if (fromSessionTitle)
+      return fromSessionTitle.slice(0, DISCORD_THREAD_NAME_MAX_LENGTH);
     const fromSessionId = normalizeThreadTitle(
       sessionID ? `session ${sessionID}` : ""
     );
-    if (fromSessionId) return fromSessionId.slice(0, 100);
+    if (fromSessionId)
+      return fromSessionId.slice(0, DISCORD_THREAD_NAME_MAX_LENGTH);
     return "untitled";
   }
   async function ensureThread(sessionID) {
@@ -424,11 +445,52 @@ var plugin = async ({ client }) => {
   function buildPermissionMention() {
     return buildMention(permissionMention, "DISCORD_WEBHOOK_PERMISSION_MENTION");
   }
-  function setIfChanged(map, key, next) {
-    const prev = map.get(key);
-    if (prev === next) return false;
-    map.set(key, next);
-    return true;
+  function escapeDiscordMention(text) {
+    return text.replace(/^@/g, "@\u200B");
+  }
+  async function handleTextPart(input) {
+    const { part, role, sessionID, messageID, replay } = input;
+    const partID = part?.id;
+    if (!partID) return;
+    if (!replay && role === "assistant" && !part?.time?.end) return;
+    if (sentTextPartIds.has(partID)) return;
+    sentTextPartIds.add(partID);
+    const text = escapeDiscordMention(safeString(part?.text));
+    if (role === "user" && excludeInputContext && isInputContextText(text)) {
+      return;
+    }
+    if (role === "user" && text.trim() === "" || text.trim() === "(empty)") {
+      return;
+    }
+    if (role === "user" && !firstUserTextBySession.has(sessionID)) {
+      const normalized = normalizeThreadTitle(text);
+      if (normalized) firstUserTextBySession.set(sessionID, normalized);
+    }
+    const embed = {
+      title: getTextPartEmbedTitle(role),
+      color: COLORS.info,
+      fields: buildFields(
+        filterSendFields(
+          [
+            ["sessionID", sessionID],
+            ["messageID", messageID],
+            ["partID", partID],
+            ["role", role]
+          ],
+          sendParams
+        )
+      ),
+      description: truncateText(
+        text || "(empty)",
+        DISCORD_EMBED_DESCRIPTION_MAX_LENGTH
+      )
+    };
+    enqueueToThread(sessionID, { embeds: [embed] });
+    if (role === "user") {
+      await flushPending(sessionID);
+    } else if (shouldFlush(sessionID)) {
+      await flushPending(sessionID);
+    }
   }
   return {
     event: async ({ event }) => {
@@ -465,7 +527,105 @@ var plugin = async ({ client }) => {
             };
             lastSessionInfo.set(sessionID, { title, shareUrl });
             enqueueToThread(sessionID, { embeds: [embed] });
-            if (shouldFlush(sessionID)) await flushPending(sessionID);
+            return;
+          }
+          case "permission.updated": {
+            const p = event.properties;
+            const sessionID = p?.sessionID;
+            if (!sessionID) return;
+            const embed = {
+              title: "Permission required",
+              description: p?.title,
+              color: COLORS.warning,
+              timestamp: toIsoTimestamp(p?.time?.created),
+              fields: buildFields(
+                filterSendFields(
+                  [
+                    ["sessionID", sessionID],
+                    ["permissionID", p?.id],
+                    ["type", p?.type],
+                    ["pattern", p?.pattern],
+                    ["messageID", p?.messageID],
+                    ["callID", p?.callID]
+                  ],
+                  sendParams
+                )
+              )
+            };
+            const mention = buildPermissionMention();
+            enqueueToThread(sessionID, {
+              content: mention ? `${mention.content}` : void 0,
+              allowed_mentions: mention?.allowed_mentions,
+              embeds: [embed]
+            });
+            return;
+          }
+          case "session.idle": {
+            const sessionID = event.properties?.sessionID;
+            if (!sessionID) return;
+            const embed = {
+              title: "Session completed",
+              color: COLORS.success,
+              fields: buildFields(
+                filterSendFields(
+                  [["sessionID", sessionID]],
+                  withForcedSendParams(sendParams, ["sessionID"])
+                )
+              )
+            };
+            const mention = buildCompleteMention();
+            enqueueToThread(sessionID, {
+              content: mention ? `${mention.content}` : void 0,
+              allowed_mentions: mention?.allowed_mentions,
+              embeds: [embed]
+            });
+            return;
+          }
+          case "session.error": {
+            const p = event.properties;
+            const sessionID = p?.sessionID;
+            const errorStr = safeString(p?.error);
+            const embed = {
+              title: "Session error",
+              color: COLORS.error,
+              description: errorStr ? errorStr.length > DISCORD_EMBED_DESCRIPTION_MAX_LENGTH ? errorStr.slice(
+                0,
+                DISCORD_EMBED_DESCRIPTION_MAX_LENGTH - ELLIPSIS_LENGTH
+              ) + ELLIPSIS : errorStr : void 0,
+              fields: buildFields(
+                filterSendFields(
+                  [["sessionID", sessionID]],
+                  withForcedSendParams(sendParams, [
+                    "sessionID",
+                    "projectID",
+                    "directory"
+                  ])
+                )
+              )
+            };
+            if (!sessionID) return;
+            const mention = buildCompleteMention();
+            enqueueToThread(sessionID, {
+              content: mention ? `$Session error` : void 0,
+              allowed_mentions: mention?.allowed_mentions,
+              embeds: [embed]
+            });
+            await flushPending(sessionID);
+            return;
+          }
+          case "todo.updated": {
+            const p = event.properties;
+            const sessionID = p?.sessionID;
+            if (!sessionID) return;
+            const embed = {
+              title: "Todo updated",
+              color: COLORS.info,
+              fields: buildFields(
+                filterSendFields([["sessionID", sessionID]], sendParams)
+              ),
+              description: buildTodoChecklist(p?.todos)
+            };
+            enqueueToThread(sessionID, { embeds: [embed] });
             return;
           }
           case "message.updated": {
@@ -473,52 +633,22 @@ var plugin = async ({ client }) => {
             const messageID = info?.id;
             const role = info?.role;
             if (!messageID) return;
-            if (role === "user" || role === "assistant") {
-              messageRoleById.set(messageID, role);
-              const pendingParts = pendingTextPartsByMessageId.get(messageID);
-              if (pendingParts?.length) {
-                pendingTextPartsByMessageId.delete(messageID);
-                for (const pendingPart of pendingParts) {
-                  const sessionID = pendingPart?.sessionID;
-                  const partID = pendingPart?.id;
-                  const type = pendingPart?.type;
-                  if (!sessionID || !partID || type !== "text") continue;
-                  const text = safeString(pendingPart?.text);
-                  if (role === "user" && excludeInputContext && isInputContextText(text)) {
-                    const snapshot = JSON.stringify({
-                      type,
-                      role,
-                      skipped: "input_context"
-                    });
-                    setIfChanged(/* @__PURE__ */ new Map(), partID, snapshot);
-                    continue;
-                  }
-                  if (role === "user" && !firstUserTextBySession.has(sessionID)) {
-                    const normalized = normalizeThreadTitle(text);
-                    if (normalized)
-                      firstUserTextBySession.set(sessionID, normalized);
-                  }
-                  const embed = {
-                    title: getTextPartEmbedTitle(role),
-                    color: COLORS.info,
-                    fields: buildFields(
-                      filterSendFields(
-                        [
-                          ["sessionID", sessionID],
-                          ["messageID", messageID],
-                          ["partID", partID],
-                          ["role", role]
-                        ],
-                        sendParams
-                      )
-                    ),
-                    description: truncateText(text || "(empty)", 4096)
-                  };
-                  enqueueToThread(sessionID, { embeds: [embed] });
-                  if (role === "user") await flushPending(sessionID);
-                  else if (shouldFlush(sessionID)) await flushPending(sessionID);
-                }
-              }
+            if (role !== "user" && role !== "assistant") return;
+            messageRoleById.set(messageID, role);
+            const pendingParts = pendingTextPartsByMessageId.get(messageID);
+            if (!pendingParts?.length) return;
+            pendingTextPartsByMessageId.delete(messageID);
+            for (const part of pendingParts) {
+              const sessionID = part?.sessionID;
+              const partID = part?.id;
+              if (!sessionID || !partID || part?.type !== "text") continue;
+              await handleTextPart({
+                part,
+                role,
+                sessionID,
+                messageID,
+                replay: true
+              });
             }
             return;
           }
@@ -538,46 +668,12 @@ var plugin = async ({ client }) => {
               pendingTextPartsByMessageId.set(messageID, list);
               return;
             }
-            if (type === "text") {
-              if (role === "assistant" && !part?.time?.end) return;
-              const text = safeString(part?.text);
-              if (role === "user" && excludeInputContext && isInputContextText(text)) {
-                const snapshot = JSON.stringify({
-                  type,
-                  role,
-                  skipped: "input_context"
-                });
-                setIfChanged(/* @__PURE__ */ new Map(), partID, snapshot);
-                return;
-              }
-              if (role === "user" && !firstUserTextBySession.has(sessionID)) {
-                const normalized = normalizeThreadTitle(text);
-                if (normalized)
-                  firstUserTextBySession.set(sessionID, normalized);
-              }
-              const embed = {
-                title: getTextPartEmbedTitle(role),
-                color: COLORS.info,
-                fields: buildFields(
-                  filterSendFields(
-                    [
-                      ["sessionID", sessionID],
-                      ["messageID", messageID],
-                      ["partID", partID],
-                      ["role", role]
-                    ],
-                    sendParams
-                  )
-                ),
-                description: truncateText(text || "(empty)", 4096)
-              };
-              enqueueToThread(sessionID, { embeds: [embed] });
-              if (role === "user") {
-                await flushPending(sessionID);
-              } else if (shouldFlush(sessionID)) {
-                await flushPending(sessionID);
-              }
-            }
+            await handleTextPart({
+              part,
+              role,
+              sessionID,
+              messageID
+            });
             return;
           }
           default:
@@ -593,7 +689,8 @@ plugin.__test__ = {
   buildTodoChecklist,
   buildFields,
   toIsoTimestamp,
-  postDiscordWebhook
+  postDiscordWebhook,
+  getTodoStatusMarker
 };
 var index_default = plugin;
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-discord-notify",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "A plugin that posts OpenCode events to a Discord webhook.",
   "license": "MIT",
   "type": "module",
@@ -36,6 +36,7 @@
   "devDependencies": {
     "@opencode-ai/plugin": "1.0.194",
     "@types/node": "^20.19.27",
+    "@vitest/coverage-v8": "^4.0.16",
     "prettier": "^3.7.4",
     "prettier-plugin-organize-imports": "^4.3.0",
     "tsup": "^8.5.0",