kanban-lite 1.2.2 → 1.2.4

package/dist/mcp-server.js

@@ -17664,11 +17664,87 @@ 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 = "") {
+  const isFormDefaultDataPath = /^\.forms\.(?:[^.]+|"[^"]+")\.data(?:$|[.\[])/.test(nodePath);
+  if (isFormDefaultDataPath) {
+    return node;
+  }
+  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 +21344,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 +21570,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 +24646,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 +24660,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 });
@@ -26014,6 +26082,25 @@ var KanbanSDK = class _KanbanSDK {
   get workspaceRoot() {
     return path14.dirname(this.kanbanDir);
   }
+  /**
+   * Returns a cloned read-only snapshot of the current workspace config.
+   *
+   * The returned snapshot is created from a fresh config read and deep-cloned
+   * before being returned, so callers receive an isolated view of the current
+   * `.kanban.json` state rather than a live mutable runtime object. Mutating the
+   * returned snapshot does not update persisted config or affect this SDK instance.
+   *
+   * @returns A cloned read-only snapshot of the current {@link KanbanConfig}.
+   *
+   * @example
+   * ```ts
+   * const config = sdk.getConfigSnapshot()
+   * console.log(config.defaultBoard)
+   * ```
+   */
+  getConfigSnapshot() {
+    return structuredClone(readConfig(this.workspaceRoot));
+  }
   // --- Board resolution helpers ---
   /** @internal */
   _resolveBoardId(boardId) {
@@ -26480,21 +26567,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 +26587,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 +28243,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,87 @@ 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 = "") {
+  const isFormDefaultDataPath = /^\.forms\.(?:[^.]+|"[^"]+")\.data(?:$|[.\[])/.test(nodePath);
+  if (isFormDefaultDataPath) {
+    return node;
+  }
+  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 +21378,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 +21604,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 +24613,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 +24627,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 });
@@ -25981,6 +26049,25 @@ var KanbanSDK = class _KanbanSDK {
   get workspaceRoot() {
     return path14.dirname(this.kanbanDir);
   }
+  /**
+   * Returns a cloned read-only snapshot of the current workspace config.
+   *
+   * The returned snapshot is created from a fresh config read and deep-cloned
+   * before being returned, so callers receive an isolated view of the current
+   * `.kanban.json` state rather than a live mutable runtime object. Mutating the
+   * returned snapshot does not update persisted config or affect this SDK instance.
+   *
+   * @returns A cloned read-only snapshot of the current {@link KanbanConfig}.
+   *
+   * @example
+   * ```ts
+   * const config = sdk.getConfigSnapshot()
+   * console.log(config.defaultBoard)
+   * ```
+   */
+  getConfigSnapshot() {
+    return structuredClone(readConfig(this.workspaceRoot));
+  }
   // --- Board resolution helpers ---
   /** @internal */
   _resolveBoardId(boardId) {
@@ -26447,21 +26534,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 +26554,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 +27603,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,87 @@ 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 = "") {
+  const isFormDefaultDataPath = /^\.forms\.(?:[^.]+|"[^"]+")\.data(?:$|[.\[])/.test(nodePath);
+  if (isFormDefaultDataPath) {
+    return node;
+  }
+  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 +21337,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 +21563,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 +24572,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 +24586,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 });
@@ -25940,6 +26008,25 @@ var KanbanSDK = class _KanbanSDK {
   get workspaceRoot() {
     return path14.dirname(this.kanbanDir);
   }
+  /**
+   * Returns a cloned read-only snapshot of the current workspace config.
+   *
+   * The returned snapshot is created from a fresh config read and deep-cloned
+   * before being returned, so callers receive an isolated view of the current
+   * `.kanban.json` state rather than a live mutable runtime object. Mutating the
+   * returned snapshot does not update persisted config or affect this SDK instance.
+   *
+   * @returns A cloned read-only snapshot of the current {@link KanbanConfig}.
+   *
+   * @example
+   * ```ts
+   * const config = sdk.getConfigSnapshot()
+   * console.log(config.defaultBoard)
+   * ```
+   */
+  getConfigSnapshot() {
+    return structuredClone(readConfig(this.workspaceRoot));
+  }
   // --- Board resolution helpers ---
   /** @internal */
   _resolveBoardId(boardId) {
@@ -26406,21 +26493,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 +26513,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 +27562,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