kanban-lite 1.2.2 → 1.2.3

package/dist/mcp-server.js

@@ -17664,11 +17664,83 @@ function migrateConfigV1ToV2(raw) {
   }
   return v2;
 }
+function loadDotEnv(dir) {
+  const envPath = path.join(dir, ".env");
+  let content;
+  try {
+    content = fs.readFileSync(envPath, "utf-8");
+  } catch {
+    return;
+  }
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#"))
+      continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx < 1)
+      continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    let val = trimmed.slice(eqIdx + 1).trim();
+    if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'")) {
+      val = val.slice(1, -1);
+    }
+    if (process.env[key] === void 0) {
+      process.env[key] = val;
+    }
+  }
+}
+function resolveConfigEnvVars(node, configFileName, nodePath = "") {
+  if (typeof node === "string") {
+    return node.replace(/\$\{([^}]+)\}/g, (_match, varName) => {
+      const envValue = process.env[varName];
+      if (envValue === void 0) {
+        throw new Error(
+          `missing ${varName} in ${configFileName}: ${nodePath} "${node}"`
+        );
+      }
+      return envValue;
+    });
+  }
+  if (Array.isArray(node)) {
+    for (let i = 0; i < node.length; i++) {
+      node[i] = resolveConfigEnvVars(node[i], configFileName, `${nodePath}[${i}]`);
+    }
+    return node;
+  }
+  if (node !== null && typeof node === "object") {
+    const obj = node;
+    for (const key of Object.keys(obj)) {
+      const jsonKey = /[^a-zA-Z0-9_]/.test(key) ? `"${key}"` : key;
+      const childPath = nodePath ? `${nodePath}.${jsonKey}` : `.${jsonKey}`;
+      obj[key] = resolveConfigEnvVars(obj[key], configFileName, childPath);
+    }
+    return obj;
+  }
+  return node;
+}
 function readConfig(workspaceRoot) {
   const filePath = configPath(workspaceRoot);
   const defaults = { ...DEFAULT_CONFIG, boards: { default: { ...DEFAULT_BOARD_CONFIG, columns: [...DEFAULT_COLUMNS] } } };
+  let raw;
+  try {
+    raw = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch {
+    return defaults;
+  }
+  loadDotEnv(workspaceRoot);
+  try {
+    resolveConfigEnvVars(raw, CONFIG_FILENAME);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`
+Configuration error: ${msg}
+
+Set the missing environment variable before starting the server.
+
+`);
+    process.exit(1);
+  }
   try {
-    const raw = JSON.parse(fs.readFileSync(filePath, "utf-8"));
     const isV1 = raw.version === 1 || !raw.version && !(typeof raw.boards === "object" && raw.boards !== null && !Array.isArray(raw.boards));
     if (isV1) {
       const v2 = migrateConfigV1ToV2(raw);
@@ -21268,7 +21340,7 @@ function resolveAuthIdentityPlugin(ref) {
   if (ref.provider === "rbac")
     return RBAC_IDENTITY_PLUGIN;
   const packageName = AUTH_PROVIDER_ALIASES.get(ref.provider) ?? ref.provider;
-  return loadExternalAuthIdentityPlugin(packageName, ref.provider);
+  return loadExternalAuthIdentityPlugin(packageName, ref.provider, ref.options);
 }
 function resolveAuthPolicyPlugin(ref) {
   if (ref.provider === "noop")
@@ -21494,8 +21566,13 @@ function selectAuthPolicyPlugin(mod, providerId) {
     return direct;
   return null;
 }
-function loadExternalAuthIdentityPlugin(packageName, providerId) {
+function loadExternalAuthIdentityPlugin(packageName, providerId, options) {
   const mod = loadExternalModule(packageName);
+  if (options !== void 0 && typeof mod.createAuthIdentityPlugin === "function") {
+    const created = mod.createAuthIdentityPlugin(options);
+    if (isValidAuthIdentityPlugin(created, providerId))
+      return created;
+  }
   const plugin = selectAuthIdentityPlugin(mod, providerId);
   if (!plugin) {
     throw new Error(
@@ -24565,29 +24642,10 @@ async function updateCard(ctx, { cardId, updates, boardId }) {
   return card;
 }
 async function triggerAction(ctx, { cardId, action, boardId }) {
-  const config = readConfig(ctx.workspaceRoot);
-  const { actionWebhookUrl } = config;
-  if (!actionWebhookUrl) {
-    throw new Error("No action webhook URL configured. Set actionWebhookUrl in .kanban.json");
-  }
   const card = await getCard(ctx, { cardId, boardId });
   if (!card)
     throw new Error(`Card not found: ${cardId}`);
   const resolvedBoardId = card.boardId || ctx._resolveBoardId(boardId);
-  const payload = {
-    action,
-    board: resolvedBoardId,
-    list: card.status,
-    card: sanitizeCard(card)
-  };
-  const response = await fetch(actionWebhookUrl, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(payload)
-  });
-  if (!response.ok) {
-    throw new Error(`Action webhook responded with ${response.status}: ${response.statusText}`);
-  }
   await appendActivityLog(ctx, {
     cardId,
     boardId: resolvedBoardId,
@@ -24598,6 +24656,12 @@ async function triggerAction(ctx, { cardId, action, boardId }) {
     }
   }).catch(() => {
   });
+  return {
+    action,
+    board: resolvedBoardId,
+    list: card.status,
+    card: sanitizeCard(card)
+  };
 }
 async function submitForm(ctx, input) {
   const card = await getCard(ctx, { cardId: input.cardId, boardId: input.boardId });
@@ -26480,21 +26544,17 @@ var KanbanSDK = class _KanbanSDK {
     return result;
   }
   /**
-   * Triggers a named action for a card by POSTing to the global `actionWebhookUrl`
-   * configured in `.kanban.json`.
+   * Triggers a named action for a card.
    *
-   * The payload sent to the webhook is:
-   * ```json
-   * { "action": "retry", "board": "default", "list": "in-progress", "card": { ...sanitizedCard } }
-   * ```
+   * Validates the card, appends an activity log entry, and emits the
+   * `card.action.triggered` after-event so registered webhooks receive
+   * the action payload automatically.
    *
    * @param cardId - The ID of the card to trigger the action for.
    * @param action - The action name string (e.g. `'retry'`, `'sendEmail'`).
    * @param boardId - Optional board ID. Defaults to the workspace's default board.
-   * @returns A promise resolving when the webhook responds with 2xx.
-   * @throws {Error} If no `actionWebhookUrl` is configured in `.kanban.json`.
+   * @returns A promise that resolves when the action has been processed.
    * @throws {Error} If the card is not found.
-   * @throws {Error} If the webhook responds with a non-2xx status.
    *
    * @example
    * ```ts
@@ -26504,7 +26564,8 @@ var KanbanSDK = class _KanbanSDK {
    */
   async triggerAction(cardId, action, boardId) {
     const mergedInput = await this._runBeforeEvent("card.action.trigger", { cardId, action, boardId }, void 0, boardId);
-    return triggerAction(this, mergedInput);
+    const payload = await triggerAction(this, mergedInput);
+    this._runAfterEvent("card.action.triggered", payload, void 0, payload.board);
   }
   /**
    * Moves a card to a different status column and/or position within that column.
@@ -28159,7 +28220,7 @@ async function main() {
   );
   server.tool(
     "trigger_action",
-    "Trigger a named action on a card. The action name must match one of the card's configured actions. Calls the configured action webhook URL with the action name and card details.",
+    "Trigger a named action on a card. The action name must match one of the card's configured actions. Emits a card.action.triggered event delivered to registered webhooks.",
     {
       card_id: import_zod.z.string().describe("Card ID (partial match supported)"),
       action: import_zod.z.string().describe("Action name to trigger"),

package/dist/sdk/index.cjs

@@ -17694,11 +17694,83 @@ function migrateConfigV1ToV2(raw) {
   }
   return v2;
 }
+function loadDotEnv(dir) {
+  const envPath = path.join(dir, ".env");
+  let content;
+  try {
+    content = fs.readFileSync(envPath, "utf-8");
+  } catch {
+    return;
+  }
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#"))
+      continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx < 1)
+      continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    let val = trimmed.slice(eqIdx + 1).trim();
+    if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'")) {
+      val = val.slice(1, -1);
+    }
+    if (process.env[key] === void 0) {
+      process.env[key] = val;
+    }
+  }
+}
+function resolveConfigEnvVars(node, configFileName, nodePath = "") {
+  if (typeof node === "string") {
+    return node.replace(/\$\{([^}]+)\}/g, (_match, varName) => {
+      const envValue = process.env[varName];
+      if (envValue === void 0) {
+        throw new Error(
+          `missing ${varName} in ${configFileName}: ${nodePath} "${node}"`
+        );
+      }
+      return envValue;
+    });
+  }
+  if (Array.isArray(node)) {
+    for (let i = 0; i < node.length; i++) {
+      node[i] = resolveConfigEnvVars(node[i], configFileName, `${nodePath}[${i}]`);
+    }
+    return node;
+  }
+  if (node !== null && typeof node === "object") {
+    const obj = node;
+    for (const key of Object.keys(obj)) {
+      const jsonKey = /[^a-zA-Z0-9_]/.test(key) ? `"${key}"` : key;
+      const childPath = nodePath ? `${nodePath}.${jsonKey}` : `.${jsonKey}`;
+      obj[key] = resolveConfigEnvVars(obj[key], configFileName, childPath);
+    }
+    return obj;
+  }
+  return node;
+}
 function readConfig(workspaceRoot) {
   const filePath = configPath(workspaceRoot);
   const defaults = { ...DEFAULT_CONFIG, boards: { default: { ...DEFAULT_BOARD_CONFIG, columns: [...DEFAULT_COLUMNS] } } };
+  let raw;
+  try {
+    raw = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch {
+    return defaults;
+  }
+  loadDotEnv(workspaceRoot);
+  try {
+    resolveConfigEnvVars(raw, CONFIG_FILENAME);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`
+Configuration error: ${msg}
+
+Set the missing environment variable before starting the server.
+
+`);
+    process.exit(1);
+  }
   try {
-    const raw = JSON.parse(fs.readFileSync(filePath, "utf-8"));
     const isV1 = raw.version === 1 || !raw.version && !(typeof raw.boards === "object" && raw.boards !== null && !Array.isArray(raw.boards));
     if (isV1) {
       const v2 = migrateConfigV1ToV2(raw);
@@ -21302,7 +21374,7 @@ function resolveAuthIdentityPlugin(ref) {
   if (ref.provider === "rbac")
     return RBAC_IDENTITY_PLUGIN;
   const packageName = AUTH_PROVIDER_ALIASES.get(ref.provider) ?? ref.provider;
-  return loadExternalAuthIdentityPlugin(packageName, ref.provider);
+  return loadExternalAuthIdentityPlugin(packageName, ref.provider, ref.options);
 }
 function resolveAuthPolicyPlugin(ref) {
   if (ref.provider === "noop")
@@ -21528,8 +21600,13 @@ function selectAuthPolicyPlugin(mod, providerId) {
     return direct;
   return null;
 }
-function loadExternalAuthIdentityPlugin(packageName, providerId) {
+function loadExternalAuthIdentityPlugin(packageName, providerId, options) {
   const mod = loadExternalModule(packageName);
+  if (options !== void 0 && typeof mod.createAuthIdentityPlugin === "function") {
+    const created = mod.createAuthIdentityPlugin(options);
+    if (isValidAuthIdentityPlugin(created, providerId))
+      return created;
+  }
   const plugin = selectAuthIdentityPlugin(mod, providerId);
   if (!plugin) {
     throw new Error(
@@ -24532,29 +24609,10 @@ async function updateCard(ctx, { cardId, updates, boardId }) {
   return card;
 }
 async function triggerAction(ctx, { cardId, action, boardId }) {
-  const config = readConfig(ctx.workspaceRoot);
-  const { actionWebhookUrl } = config;
-  if (!actionWebhookUrl) {
-    throw new Error("No action webhook URL configured. Set actionWebhookUrl in .kanban.json");
-  }
   const card = await getCard(ctx, { cardId, boardId });
   if (!card)
     throw new Error(`Card not found: ${cardId}`);
   const resolvedBoardId = card.boardId || ctx._resolveBoardId(boardId);
-  const payload = {
-    action,
-    board: resolvedBoardId,
-    list: card.status,
-    card: sanitizeCard(card)
-  };
-  const response = await fetch(actionWebhookUrl, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(payload)
-  });
-  if (!response.ok) {
-    throw new Error(`Action webhook responded with ${response.status}: ${response.statusText}`);
-  }
   await appendActivityLog(ctx, {
     cardId,
     boardId: resolvedBoardId,
@@ -24565,6 +24623,12 @@ async function triggerAction(ctx, { cardId, action, boardId }) {
     }
   }).catch(() => {
   });
+  return {
+    action,
+    board: resolvedBoardId,
+    list: card.status,
+    card: sanitizeCard(card)
+  };
 }
 async function submitForm(ctx, input) {
   const card = await getCard(ctx, { cardId: input.cardId, boardId: input.boardId });
@@ -26447,21 +26511,17 @@ var KanbanSDK = class _KanbanSDK {
     return result;
   }
   /**
-   * Triggers a named action for a card by POSTing to the global `actionWebhookUrl`
-   * configured in `.kanban.json`.
+   * Triggers a named action for a card.
    *
-   * The payload sent to the webhook is:
-   * ```json
-   * { "action": "retry", "board": "default", "list": "in-progress", "card": { ...sanitizedCard } }
-   * ```
+   * Validates the card, appends an activity log entry, and emits the
+   * `card.action.triggered` after-event so registered webhooks receive
+   * the action payload automatically.
    *
    * @param cardId - The ID of the card to trigger the action for.
    * @param action - The action name string (e.g. `'retry'`, `'sendEmail'`).
    * @param boardId - Optional board ID. Defaults to the workspace's default board.
-   * @returns A promise resolving when the webhook responds with 2xx.
-   * @throws {Error} If no `actionWebhookUrl` is configured in `.kanban.json`.
+   * @returns A promise that resolves when the action has been processed.
    * @throws {Error} If the card is not found.
-   * @throws {Error} If the webhook responds with a non-2xx status.
    *
    * @example
    * ```ts
@@ -26471,7 +26531,8 @@ var KanbanSDK = class _KanbanSDK {
    */
   async triggerAction(cardId, action, boardId) {
     const mergedInput = await this._runBeforeEvent("card.action.trigger", { cardId, action, boardId }, void 0, boardId);
-    return triggerAction(this, mergedInput);
+    const payload = await triggerAction(this, mergedInput);
+    this._runAfterEvent("card.action.triggered", payload, void 0, payload.board);
   }
   /**
    * Moves a card to a different status column and/or position within that column.
@@ -27519,6 +27580,7 @@ var AFTER_ENTRIES = [
   { event: "board.updated", resource: "board", label: "Board updated" },
   { event: "board.deleted", resource: "board", label: "Board deleted" },
   { event: "board.action", resource: "board", label: "Board action triggered" },
+  { event: "card.action.triggered", resource: "card", label: "Card action triggered" },
   { event: "board.log.added", resource: "board", label: "Board log added" },
   { event: "board.log.cleared", resource: "board", label: "Board log cleared" },
   // card logs

package/dist/sdk/index.mjs

@@ -17653,11 +17653,83 @@ function migrateConfigV1ToV2(raw) {
   }
   return v2;
 }
+function loadDotEnv(dir) {
+  const envPath = path.join(dir, ".env");
+  let content;
+  try {
+    content = fs.readFileSync(envPath, "utf-8");
+  } catch {
+    return;
+  }
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#"))
+      continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx < 1)
+      continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    let val = trimmed.slice(eqIdx + 1).trim();
+    if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'")) {
+      val = val.slice(1, -1);
+    }
+    if (process.env[key] === void 0) {
+      process.env[key] = val;
+    }
+  }
+}
+function resolveConfigEnvVars(node, configFileName, nodePath = "") {
+  if (typeof node === "string") {
+    return node.replace(/\$\{([^}]+)\}/g, (_match, varName) => {
+      const envValue = process.env[varName];
+      if (envValue === void 0) {
+        throw new Error(
+          `missing ${varName} in ${configFileName}: ${nodePath} "${node}"`
+        );
+      }
+      return envValue;
+    });
+  }
+  if (Array.isArray(node)) {
+    for (let i = 0; i < node.length; i++) {
+      node[i] = resolveConfigEnvVars(node[i], configFileName, `${nodePath}[${i}]`);
+    }
+    return node;
+  }
+  if (node !== null && typeof node === "object") {
+    const obj = node;
+    for (const key of Object.keys(obj)) {
+      const jsonKey = /[^a-zA-Z0-9_]/.test(key) ? `"${key}"` : key;
+      const childPath = nodePath ? `${nodePath}.${jsonKey}` : `.${jsonKey}`;
+      obj[key] = resolveConfigEnvVars(obj[key], configFileName, childPath);
+    }
+    return obj;
+  }
+  return node;
+}
 function readConfig(workspaceRoot) {
   const filePath = configPath(workspaceRoot);
   const defaults = { ...DEFAULT_CONFIG, boards: { default: { ...DEFAULT_BOARD_CONFIG, columns: [...DEFAULT_COLUMNS] } } };
+  let raw;
+  try {
+    raw = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch {
+    return defaults;
+  }
+  loadDotEnv(workspaceRoot);
+  try {
+    resolveConfigEnvVars(raw, CONFIG_FILENAME);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`
+Configuration error: ${msg}
+
+Set the missing environment variable before starting the server.
+
+`);
+    process.exit(1);
+  }
   try {
-    const raw = JSON.parse(fs.readFileSync(filePath, "utf-8"));
     const isV1 = raw.version === 1 || !raw.version && !(typeof raw.boards === "object" && raw.boards !== null && !Array.isArray(raw.boards));
     if (isV1) {
       const v2 = migrateConfigV1ToV2(raw);
@@ -21261,7 +21333,7 @@ function resolveAuthIdentityPlugin(ref) {
   if (ref.provider === "rbac")
     return RBAC_IDENTITY_PLUGIN;
   const packageName = AUTH_PROVIDER_ALIASES.get(ref.provider) ?? ref.provider;
-  return loadExternalAuthIdentityPlugin(packageName, ref.provider);
+  return loadExternalAuthIdentityPlugin(packageName, ref.provider, ref.options);
 }
 function resolveAuthPolicyPlugin(ref) {
   if (ref.provider === "noop")
@@ -21487,8 +21559,13 @@ function selectAuthPolicyPlugin(mod, providerId) {
     return direct;
   return null;
 }
-function loadExternalAuthIdentityPlugin(packageName, providerId) {
+function loadExternalAuthIdentityPlugin(packageName, providerId, options) {
   const mod = loadExternalModule(packageName);
+  if (options !== void 0 && typeof mod.createAuthIdentityPlugin === "function") {
+    const created = mod.createAuthIdentityPlugin(options);
+    if (isValidAuthIdentityPlugin(created, providerId))
+      return created;
+  }
   const plugin = selectAuthIdentityPlugin(mod, providerId);
   if (!plugin) {
     throw new Error(
@@ -24491,29 +24568,10 @@ async function updateCard(ctx, { cardId, updates, boardId }) {
   return card;
 }
 async function triggerAction(ctx, { cardId, action, boardId }) {
-  const config = readConfig(ctx.workspaceRoot);
-  const { actionWebhookUrl } = config;
-  if (!actionWebhookUrl) {
-    throw new Error("No action webhook URL configured. Set actionWebhookUrl in .kanban.json");
-  }
   const card = await getCard(ctx, { cardId, boardId });
   if (!card)
     throw new Error(`Card not found: ${cardId}`);
   const resolvedBoardId = card.boardId || ctx._resolveBoardId(boardId);
-  const payload = {
-    action,
-    board: resolvedBoardId,
-    list: card.status,
-    card: sanitizeCard(card)
-  };
-  const response = await fetch(actionWebhookUrl, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(payload)
-  });
-  if (!response.ok) {
-    throw new Error(`Action webhook responded with ${response.status}: ${response.statusText}`);
-  }
   await appendActivityLog(ctx, {
     cardId,
     boardId: resolvedBoardId,
@@ -24524,6 +24582,12 @@ async function triggerAction(ctx, { cardId, action, boardId }) {
     }
   }).catch(() => {
   });
+  return {
+    action,
+    board: resolvedBoardId,
+    list: card.status,
+    card: sanitizeCard(card)
+  };
 }
 async function submitForm(ctx, input) {
   const card = await getCard(ctx, { cardId: input.cardId, boardId: input.boardId });
@@ -26406,21 +26470,17 @@ var KanbanSDK = class _KanbanSDK {
     return result;
   }
   /**
-   * Triggers a named action for a card by POSTing to the global `actionWebhookUrl`
-   * configured in `.kanban.json`.
+   * Triggers a named action for a card.
    *
-   * The payload sent to the webhook is:
-   * ```json
-   * { "action": "retry", "board": "default", "list": "in-progress", "card": { ...sanitizedCard } }
-   * ```
+   * Validates the card, appends an activity log entry, and emits the
+   * `card.action.triggered` after-event so registered webhooks receive
+   * the action payload automatically.
    *
    * @param cardId - The ID of the card to trigger the action for.
    * @param action - The action name string (e.g. `'retry'`, `'sendEmail'`).
    * @param boardId - Optional board ID. Defaults to the workspace's default board.
-   * @returns A promise resolving when the webhook responds with 2xx.
-   * @throws {Error} If no `actionWebhookUrl` is configured in `.kanban.json`.
+   * @returns A promise that resolves when the action has been processed.
    * @throws {Error} If the card is not found.
-   * @throws {Error} If the webhook responds with a non-2xx status.
    *
    * @example
    * ```ts
@@ -26430,7 +26490,8 @@ var KanbanSDK = class _KanbanSDK {
    */
   async triggerAction(cardId, action, boardId) {
     const mergedInput = await this._runBeforeEvent("card.action.trigger", { cardId, action, boardId }, void 0, boardId);
-    return triggerAction(this, mergedInput);
+    const payload = await triggerAction(this, mergedInput);
+    this._runAfterEvent("card.action.triggered", payload, void 0, payload.board);
   }
   /**
    * Moves a card to a different status column and/or position within that column.
@@ -27478,6 +27539,7 @@ var AFTER_ENTRIES = [
   { event: "board.updated", resource: "board", label: "Board updated" },
   { event: "board.deleted", resource: "board", label: "Board deleted" },
   { event: "board.action", resource: "board", label: "Board action triggered" },
+  { event: "card.action.triggered", resource: "card", label: "Card action triggered" },
   { event: "board.log.added", resource: "board", label: "Board log added" },
   { event: "board.log.cleared", resource: "board", label: "Board log cleared" },
   // card logs

package/dist/sdk/sdk/KanbanSDK.d.ts

@@ -969,21 +969,17 @@ export declare class KanbanSDK {
      */
     submitForm(input: SubmitFormInput): Promise<SubmitFormResult>;
     /**
-     * Triggers a named action for a card by POSTing to the global `actionWebhookUrl`
-     * configured in `.kanban.json`.
+     * Triggers a named action for a card.
      *
-     * The payload sent to the webhook is:
-     * ```json
-     * { "action": "retry", "board": "default", "list": "in-progress", "card": { ...sanitizedCard } }
-     * ```
+     * Validates the card, appends an activity log entry, and emits the
+     * `card.action.triggered` after-event so registered webhooks receive
+     * the action payload automatically.
      *
      * @param cardId - The ID of the card to trigger the action for.
      * @param action - The action name string (e.g. `'retry'`, `'sendEmail'`).
      * @param boardId - Optional board ID. Defaults to the workspace's default board.
-     * @returns A promise resolving when the webhook responds with 2xx.
-     * @throws {Error} If no `actionWebhookUrl` is configured in `.kanban.json`.
+     * @returns A promise that resolves when the action has been processed.
      * @throws {Error} If the card is not found.
-     * @throws {Error} If the webhook responds with a non-2xx status.
      *
      * @example
      * ```ts

package/dist/sdk/sdk/modules/cards.d.ts

@@ -52,13 +52,22 @@ export declare function updateCard(ctx: SDKContext, { cardId, updates, boardId }
     boardId?: string;
 }): Promise<Card>;
 /**
- * Triggers a named action for a card by POSTing to the global `actionWebhookUrl`.
+ * Triggers a named action for a card.
+ *
+ * Validates the card exists, appends an activity log entry, and returns the
+ * action payload. Webhook delivery is handled by the webhook plugin via the
+ * `card.action.triggered` after-event emitted by {@link KanbanSDK.triggerAction}.
  */
 export declare function triggerAction(ctx: SDKContext, { cardId, action, boardId }: {
     cardId: string;
     action: string;
     boardId?: string;
-}): Promise<void>;
+}): Promise<{
+    action: string;
+    board: string;
+    list: string;
+    card: Omit<Card, 'filePath'>;
+}>;
 /**
  * Validates and persists a card form submission, then emits `form.submit`.
  */

package/dist/sdk/sdk/types.d.ts

@@ -58,7 +58,7 @@ export type SDKBeforeEventType = 'card.create' | 'card.update' | 'card.move' | '
  *
  * @see AfterEventPayload for the payload envelope passed to after-event listeners.
  */
-export type SDKAfterEventType = 'task.created' | 'task.updated' | 'task.moved' | 'task.deleted' | 'comment.created' | 'comment.updated' | 'comment.deleted' | 'column.created' | 'column.updated' | 'column.deleted' | 'attachment.added' | 'attachment.removed' | 'settings.updated' | 'board.created' | 'board.updated' | 'board.deleted' | 'board.action' | 'board.log.added' | 'board.log.cleared' | 'log.added' | 'log.cleared' | 'storage.migrated' | 'form.submitted' | 'auth.allowed' | 'auth.denied';
+export type SDKAfterEventType = 'task.created' | 'task.updated' | 'task.moved' | 'task.deleted' | 'comment.created' | 'comment.updated' | 'comment.deleted' | 'column.created' | 'column.updated' | 'column.deleted' | 'attachment.added' | 'attachment.removed' | 'settings.updated' | 'board.created' | 'board.updated' | 'board.deleted' | 'board.action' | 'card.action.triggered' | 'board.log.added' | 'board.log.cleared' | 'log.added' | 'log.cleared' | 'storage.migrated' | 'form.submitted' | 'auth.allowed' | 'auth.denied';
 /**
  * Union of all SDK event types (before-events and after-events).
  *