opencode-discord-notify 0.3.0 → 0.3.2

package/README-JP.md

@@ -63,7 +63,7 @@ OpenCode を再起動してください。
 - `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` で無効化）
 - `DISCORD_WEBHOOK_SHOW_ERROR_ALERT`: `1` のとき Discord webhook の送信が失敗した場合に OpenCode TUI のトーストを表示します（429 含む）（デフォルト: `1` / `0` で無効化）
-- `SEND_PARAMS`: embed の fields として送るキーをカンマ区切りで指定。指定可能キー: `sessionID`, `permissionID`, `type`, `pattern`, `messageID`, `callID`, `partID`, `role`, `directory`, `projectID`。未設定・空文字・空要素のみの場合は全て選択。`session.created` は `SEND_PARAMS` に関わらず `sessionID`, `projectID`, `directory` を必ず含みます。
+- `DISCORD_SEND_PARAMS`: embed の fields として送るキーをカンマ区切りで指定。指定可能キー: `sessionID`, `permissionID`, `type`, `pattern`, `messageID`, `callID`, `partID`, `role`, `directory`, `projectID`。未設定・空文字・空要素のみの場合は全て選択。`session.created` は `DISCORD_SEND_PARAMS` に関わらず `sessionID`, `projectID`, `directory` を必ず含みます。
 
 ## 仕様メモ
 
@@ -88,7 +88,7 @@ OpenCode を再起動してください。
     - embed タイトルは `User says` / `Agent says` です
   - `tool`: 通知しない
   - `reasoning`: 通知しない（内部思考が含まれる可能性があるため）
-- `SEND_PARAMS` の制御対象は embed の fields のみです（title/description/content/timestamp などは対象外）。また `share` は fields としては送りません（Session started の embed URL には `shareUrl` を使います）。
+- `DISCORD_SEND_PARAMS` の制御対象は embed の fields のみです（title/description/content/timestamp などは対象外）。また `share` は fields としては送りません（Session started の embed URL には `shareUrl` を使います）。
 
 ## 動作確認（手動）
 

package/README.md

@@ -65,7 +65,7 @@ Optional:
 - `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)
 - `DISCORD_WEBHOOK_SHOW_ERROR_ALERT`: when set to `1`, show an OpenCode TUI toast when Discord webhook requests fail (includes 429). (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.
+- `DISCORD_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
 
@@ -90,7 +90,7 @@ Optional:
     - 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).
+- `DISCORD_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.d.ts

@@ -1,68 +1,5 @@
 import { Plugin } from '@opencode-ai/plugin';
 
-type DiscordWebhookMessageResponse = {
-    id: string;
-    channel_id: string;
-};
-type DiscordEmbed = {
-    title?: string;
-    description?: string;
-    url?: string;
-    color?: number;
-    timestamp?: string;
-    fields?: Array<{
-        name: string;
-        value: string;
-        inline?: boolean;
-    }>;
-};
-type DiscordAllowedMentions = {
-    parse?: Array<'everyone' | 'roles' | 'users'>;
-    roles?: string[];
-    users?: string[];
-};
-type DiscordExecuteWebhookBody = {
-    content?: string;
-    username?: string;
-    avatar_url?: string;
-    thread_name?: string;
-    embeds?: DiscordEmbed[];
-    allowed_mentions?: DiscordAllowedMentions;
-};
-declare function toIsoTimestamp(ms: unknown): string | undefined;
-declare function buildFields(fields: Array<[string, unknown]>, inline?: boolean): DiscordEmbed['fields'];
-declare function buildMention(mention: string | undefined, nameForLog: string): {
-    content?: string;
-    allowed_mentions?: DiscordAllowedMentions;
-} | undefined;
-declare function buildTodoChecklist(todos: unknown): string;
-type ToastVariant = 'info' | 'success' | 'warning' | 'error';
-type MaybeAlertError = (input: {
-    key: string;
-    title?: string;
-    message: string;
-    variant: ToastVariant;
-}) => Promise<void>;
-type PostDiscordWebhookDeps = {
-    showErrorAlert: boolean;
-    maybeAlertError: MaybeAlertError;
-    waitOnRateLimitMs: number;
-    fetchImpl?: typeof fetch;
-    sleepImpl?: (ms: number) => Promise<void>;
-};
-declare function postDiscordWebhook(input: {
-    webhookUrl: string;
-    threadId?: string;
-    wait?: boolean;
-    body: DiscordExecuteWebhookBody;
-}, deps: PostDiscordWebhookDeps): Promise<DiscordWebhookMessageResponse | undefined>;
 declare const plugin: Plugin;
-declare const __test__: {
-    buildMention: typeof buildMention;
-    buildTodoChecklist: typeof buildTodoChecklist;
-    buildFields: typeof buildFields;
-    toIsoTimestamp: typeof toIsoTimestamp;
-    postDiscordWebhook: typeof postDiscordWebhook;
-};
 
-export { __test__, plugin as default };
+export { plugin as default };

package/dist/index.js

@@ -262,7 +262,7 @@ var plugin = async ({ client }) => {
   const showErrorAlert = showErrorAlertRaw !== "0";
   const waitOnRateLimitMs = 1e4;
   const toastCooldownMs = 3e4;
-  const sendParams = parseSendParams(getEnv("SEND_PARAMS"));
+  const sendParams = parseSendParams(getEnv("DISCORD_SEND_PARAMS"));
   const lastAlertAtByKey = /* @__PURE__ */ new Map();
   const showToast = async ({ title, message, variant }) => {
     try {
@@ -285,6 +285,19 @@ var plugin = async ({ client }) => {
     lastAlertAtByKey.set(key, now);
     await showToast({ title, message, variant });
   };
+  const MISSING_URL_KEY = "discord_webhook_missing_url";
+  async function showMissingUrlToastOnce() {
+    const now = Date.now();
+    const last = lastAlertAtByKey.get(MISSING_URL_KEY);
+    if (last !== void 0 && now - last < toastCooldownMs) return;
+    lastAlertAtByKey.set(MISSING_URL_KEY, now);
+    await showToast({
+      title: "Discord webhook not configured",
+      message: "DISCORD_WEBHOOK_URL is not set. Please configure it to enable Discord notifications.",
+      variant: "warning"
+    });
+  }
+  if (!webhookUrl) void showMissingUrlToastOnce();
   const postDeps = {
     showErrorAlert,
     maybeAlertError,
@@ -356,6 +369,10 @@ var plugin = async ({ client }) => {
     return void 0;
   }
   function enqueueToThread(sessionID, body) {
+    if (!webhookUrl) {
+      void showMissingUrlToastOnce();
+      return;
+    }
     const queue = pendingPostsBySession.get(sessionID) ?? [];
     queue.push(body);
     pendingPostsBySession.set(sessionID, queue);
@@ -571,7 +588,7 @@ var plugin = async ({ client }) => {
     }
   };
 };
-var __test__ = {
+plugin.__test__ = {
   buildMention,
   buildTodoChecklist,
   buildFields,
@@ -580,6 +597,5 @@ var __test__ = {
 };
 var index_default = plugin;
 export {
-  __test__,
   index_default as default
 };

package/package.json

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