opencode-discord-notify 0.1.1 → 0.2.0

package/README-JP.md

@@ -62,6 +62,7 @@ OpenCode を再起動してください。
 - `DISCORD_WEBHOOK_COMPLETE_MENTION`: `session.idle` / `session.error` の通知本文に付けるメンション（`@everyone` または `@here` のみ許容。Forum webhook の仕様上、ping は常に発生しない）
 - `DISCORD_WEBHOOK_PERMISSION_MENTION`: `permission.updated` の通知本文に付けるメンション（`DISCORD_WEBHOOK_COMPLETE_MENTION` へのフォールバックなし。`@everyone` または `@here` のみ許容。Forum webhook の仕様上、ping は常に発生しない）
 - `DISCORD_WEBHOOK_EXCLUDE_INPUT_CONTEXT`: `1` のとき input context（`<file>` から始まる user `text` part）を通知しない（デフォルト: `1` / `0` で無効化）
+- `SEND_PARAMS`: embed の fields として送るキーをカンマ区切りで指定。指定可能キー: `sessionID`, `permissionID`, `type`, `pattern`, `messageID`, `callID`, `partID`, `role`, `directory`, `projectID`。未設定・空文字・空要素のみの場合は全て選択。`session.created` は `SEND_PARAMS` に関わらず `sessionID`, `projectID`, `directory` を必ず含みます。
 
 ## 仕様メモ
 
@@ -81,8 +82,10 @@ OpenCode を再起動してください。
 - `message.updated` は通知しません（role 判定用に追跡。role 未確定で保留した `text` part を後から通知することがあります）。
 - `message.part.updated` は以下の方針です。
   - `text`: user は即時通知。assistant は `part.time.end` がある確定時のみ通知（ストリーミング途中更新は通知しない）
+    - embed タイトルは `User says` / `Agent says` です
   - `tool`: 通知しない
   - `reasoning`: 通知しない（内部思考が含まれる可能性があるため）
+- `SEND_PARAMS` の制御対象は embed の fields のみです（title/description/content/timestamp などは対象外）。また `share` は fields としては送りません（Session started の embed URL には `shareUrl` を使います）。
 
 ## 動作確認（手動）
 

package/README.md

@@ -64,6 +64,7 @@ Optional:
 - `DISCORD_WEBHOOK_COMPLETE_MENTION`: mention to put in `session.idle` / `session.error` messages (only `@everyone` or `@here` supported; Forum webhooks may not actually ping due to Discord behavior)
 - `DISCORD_WEBHOOK_PERMISSION_MENTION`: mention to put in `permission.updated` messages (no fallback to `DISCORD_WEBHOOK_COMPLETE_MENTION`; only `@everyone` or `@here` supported; Forum webhooks may not actually ping due to Discord behavior)
 - `DISCORD_WEBHOOK_EXCLUDE_INPUT_CONTEXT`: when set to `1`, exclude "input context" (user `text` parts that start with `<file>`) from notifications (default: `1`; set to `0` to disable)
+- `SEND_PARAMS`: comma-separated list of keys to include as embed fields. Allowed keys: `sessionID`, `permissionID`, `type`, `pattern`, `messageID`, `callID`, `partID`, `role`, `directory`, `projectID`. If unset, empty, or containing only empty elements, all keys are selected. `session.created` always includes `sessionID`, `projectID`, `directory` regardless.
 
 ## Notes / behavior
 
@@ -83,8 +84,10 @@ Optional:
 - `message.updated` is not posted (tracked for role inference; may post a previously-held text part later).
 - `message.part.updated` policy:
   - `text`: user is posted immediately; assistant is posted only when finalized (when `part.time.end` exists)
+    - Embed titles are `User says` / `Agent says`
   - `tool`: not posted
   - `reasoning`: not posted (to avoid exposing internal thoughts)
+- `SEND_PARAMS` controls embed fields only (it does not affect title/description/content/timestamp). `share` is not an embed field (but Session started uses `shareUrl` as the embed URL).
 
 ## Manual test
 

package/dist/index.js

@@ -1,4 +1,17 @@
 // src/index.ts
+var SEND_PARAM_KEYS = [
+  "sessionID",
+  "permissionID",
+  "type",
+  "pattern",
+  "messageID",
+  "callID",
+  "partID",
+  "role",
+  "directory",
+  "projectID"
+];
+var SEND_PARAM_KEY_SET = new Set(SEND_PARAM_KEYS);
 var COLORS = {
   info: 5793266,
   success: 5763719,
@@ -32,6 +45,23 @@ function buildFields(fields, inline = false) {
   }
   return result.length ? result : void 0;
 }
+function isSendParamKey(value) {
+  return SEND_PARAM_KEY_SET.has(value);
+}
+function filterSendFields(fields, allowed) {
+  return fields.filter(([name]) => {
+    if (!isSendParamKey(name)) return false;
+    return allowed.has(name);
+  });
+}
+function getTextPartEmbedTitle(role) {
+  return role === "user" ? "User says" : "Agent says";
+}
+function withForcedSendParams(base, forced) {
+  const next = new Set(base);
+  for (const key of forced) next.add(key);
+  return next;
+}
 function getEnv(name) {
   try {
     return process.env[name];
@@ -39,6 +69,17 @@ function getEnv(name) {
     return void 0;
   }
 }
+function parseSendParams(raw) {
+  if (raw === void 0) return new Set(SEND_PARAM_KEYS);
+  const tokens = raw.split(",").map((v) => v.trim()).filter(Boolean);
+  if (!tokens.length) return new Set(SEND_PARAM_KEYS);
+  const result = /* @__PURE__ */ new Set();
+  for (const token of tokens) {
+    if (!SEND_PARAM_KEY_SET.has(token)) continue;
+    result.add(token);
+  }
+  return result;
+}
 function withQuery(url, params) {
   const u = new URL(url);
   for (const [k, v] of Object.entries(params)) {
@@ -97,6 +138,7 @@ var plugin = async () => {
   const permissionMention = permissionMentionRaw || void 0;
   const excludeInputContextRaw = (getEnv("DISCORD_WEBHOOK_EXCLUDE_INPUT_CONTEXT") ?? "1").trim();
   const excludeInputContext = excludeInputContextRaw !== "0";
+  const sendParams = parseSendParams(getEnv("SEND_PARAMS"));
   const sessionToThread = /* @__PURE__ */ new Map();
   const threadCreateInFlight = /* @__PURE__ */ new Map();
   const pendingPostsBySession = /* @__PURE__ */ new Map();
@@ -321,12 +363,19 @@ var plugin = async () => {
               color: COLORS.info,
               timestamp: createdAt,
               fields: buildFields(
-                [
-                  ["sessionID", sessionID],
-                  ["projectID", projectID],
-                  ["directory", directory],
-                  ["share", shareUrl]
-                ],
+                filterSendFields(
+                  [
+                    ["sessionID", sessionID],
+                    ["projectID", projectID],
+                    ["directory", directory],
+                    ["share", shareUrl]
+                  ],
+                  withForcedSendParams(sendParams, [
+                    "sessionID",
+                    "projectID",
+                    "directory"
+                  ])
+                ),
                 false
               )
             };
@@ -345,14 +394,17 @@ var plugin = async () => {
               color: COLORS.warning,
               timestamp: toIsoTimestamp(p?.time?.created),
               fields: buildFields(
-                [
-                  ["sessionID", sessionID],
-                  ["permissionID", p?.id],
-                  ["type", p?.type],
-                  ["pattern", p?.pattern],
-                  ["messageID", p?.messageID],
-                  ["callID", p?.callID]
-                ],
+                filterSendFields(
+                  [
+                    ["sessionID", sessionID],
+                    ["permissionID", p?.id],
+                    ["type", p?.type],
+                    ["pattern", p?.pattern],
+                    ["messageID", p?.messageID],
+                    ["callID", p?.callID]
+                  ],
+                  sendParams
+                ),
                 false
               )
             };
@@ -371,7 +423,10 @@ var plugin = async () => {
             const embed = {
               title: "Session completed",
               color: COLORS.success,
-              fields: buildFields([["sessionID", sessionID]], false)
+              fields: buildFields(
+                filterSendFields([["sessionID", sessionID]], sendParams),
+                false
+              )
             };
             const mention = buildCompleteMention();
             enqueueToThread(sessionID, {
@@ -390,7 +445,10 @@ var plugin = async () => {
               title: "Session error",
               color: COLORS.error,
               description: errorStr ? errorStr.length > 4096 ? errorStr.slice(0, 4093) + "..." : errorStr : void 0,
-              fields: buildFields([["sessionID", sessionID]], false)
+              fields: buildFields(
+                filterSendFields([["sessionID", sessionID]], sendParams),
+                false
+              )
             };
             if (!sessionID) return;
             const mention = buildCompleteMention();
@@ -409,7 +467,10 @@ var plugin = async () => {
             const embed = {
               title: "Todo updated",
               color: COLORS.info,
-              fields: buildFields([["sessionID", sessionID]], false),
+              fields: buildFields(
+                filterSendFields([["sessionID", sessionID]], sendParams),
+                false
+              ),
               description: buildTodoChecklist(p?.todos)
             };
             enqueueToThread(sessionID, { embeds: [embed] });
@@ -450,15 +511,18 @@ var plugin = async () => {
                       firstUserTextBySession.set(sessionID, normalized);
                   }
                   const embed = {
-                    title: role === "user" ? "Message part updated: text (user)" : "Message part updated: text (assistant)",
+                    title: getTextPartEmbedTitle(role),
                     color: COLORS.info,
                     fields: buildFields(
-                      [
-                        ["sessionID", sessionID],
-                        ["messageID", messageID],
-                        ["partID", partID],
-                        ["role", role]
-                      ],
+                      filterSendFields(
+                        [
+                          ["sessionID", sessionID],
+                          ["messageID", messageID],
+                          ["partID", partID],
+                          ["role", role]
+                        ],
+                        sendParams
+                      ),
                       false
                     ),
                     description: truncateText(text || "(empty)", 4096)
@@ -507,15 +571,18 @@ var plugin = async () => {
                   firstUserTextBySession.set(sessionID, normalized);
               }
               const embed = {
-                title: role === "user" ? "Message part updated: text (user)" : "Message part updated: text (assistant)",
+                title: getTextPartEmbedTitle(role),
                 color: COLORS.info,
                 fields: buildFields(
-                  [
-                    ["sessionID", sessionID],
-                    ["messageID", messageID],
-                    ["partID", partID],
-                    ["role", role]
-                  ],
+                  filterSendFields(
+                    [
+                      ["sessionID", sessionID],
+                      ["messageID", messageID],
+                      ["partID", partID],
+                      ["role", role]
+                    ],
+                    sendParams
+                  ),
                   false
                 ),
                 description: truncateText(text || "(empty)", 4096)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-discord-notify",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "A plugin that posts OpenCode events to a Discord webhook.",
   "license": "MIT",
   "type": "module",