@bike4mind/cli 0.2.46-fix-empty-text-content-block.20674 → 0.2.47-docs-clawdbot-comparison-analysis.20779

package/dist/{chunk-LE6YGEIO.js → chunk-YIYLUPY4.js}

@@ -1677,6 +1677,83 @@ var CliToolResponseAction = z10.object({
   content: z10.unknown().optional(),
   error: z10.string().optional()
 });
+var KeepCommandRequestAction = z10.object({
+  action: z10.literal("keep_command_request"),
+  accessToken: z10.string().optional(),
+  commandType: z10.enum(["read_file", "list_directory", "run_tool"]),
+  params: z10.record(z10.string(), z10.unknown()),
+  requestId: z10.string()
+});
+var KeepCommandAction = z10.object({
+  action: z10.literal("keep_command"),
+  commandType: z10.enum(["read_file", "list_directory", "run_tool"]),
+  params: z10.record(z10.string(), z10.unknown()),
+  requestId: z10.string(),
+  originConnectionId: z10.string()
+});
+var KeepCommandResponseAction = z10.object({
+  action: z10.literal("keep_command_response"),
+  requestId: z10.string(),
+  originConnectionId: z10.string(),
+  success: z10.boolean(),
+  result: z10.unknown().optional(),
+  error: z10.string().optional()
+});
+var KeepCommandResultAction = z10.object({
+  action: z10.literal("keep_command_result"),
+  requestId: z10.string(),
+  success: z10.boolean(),
+  result: z10.unknown().optional(),
+  error: z10.string().optional()
+});
+var TilePositionSchema = z10.object({ x: z10.number(), y: z10.number() });
+var SceneCommandSchema = z10.discriminatedUnion("type", [
+  z10.object({
+    type: z10.literal("add_entity"),
+    params: z10.object({
+      id: z10.string(),
+      spriteSheetId: z10.string(),
+      position: TilePositionSchema,
+      facing: z10.enum(["left", "right"]).optional(),
+      animation: z10.string().optional(),
+      visible: z10.boolean().optional(),
+      zIndex: z10.number().optional(),
+      metadata: z10.record(z10.string(), z10.unknown()).optional()
+    })
+  }),
+  z10.object({ type: z10.literal("remove_entity"), id: z10.string() }),
+  z10.object({
+    type: z10.literal("walk_to"),
+    id: z10.string(),
+    target: TilePositionSchema,
+    options: z10.object({ speed: z10.number().optional() }).optional()
+  }),
+  z10.object({ type: z10.literal("teleport"), id: z10.string(), position: TilePositionSchema }),
+  z10.object({ type: z10.literal("play_animation"), id: z10.string(), animation: z10.string(), loop: z10.boolean().optional() }),
+  z10.object({
+    type: z10.literal("show_speech"),
+    id: z10.string(),
+    text: z10.string(),
+    options: z10.object({
+      duration: z10.number().optional(),
+      style: z10.enum(["speech", "thought", "shout"]).optional()
+    }).optional()
+  }),
+  z10.object({ type: z10.literal("clear_speech"), id: z10.string() }),
+  z10.object({ type: z10.literal("set_visible"), id: z10.string(), visible: z10.boolean() }),
+  z10.object({ type: z10.literal("set_facing"), id: z10.string(), facing: z10.enum(["left", "right"]) })
+]);
+var TavernSceneCommandRequestAction = z10.object({
+  action: z10.literal("tavern_scene_command"),
+  accessToken: z10.string().optional(),
+  commands: z10.array(SceneCommandSchema),
+  requestId: z10.string().optional()
+});
+var TavernSceneBroadcastAction = z10.object({
+  action: z10.literal("tavern_scene_broadcast"),
+  commands: z10.array(SceneCommandSchema),
+  clientId: z10.string().optional()
+});
 var SessionCreatedAction = shareableDocumentSchema.extend({
   action: z10.literal("session.created"),
   id: z10.string(),
@@ -1713,7 +1790,10 @@ var MessageDataToServer = z10.discriminatedUnion("action", [
   VoiceSessionSendTranscriptAction,
   VoiceSessionEndedAction,
   CliCompletionRequestAction,
-  CliToolRequestAction
+  CliToolRequestAction,
+  KeepCommandRequestAction,
+  KeepCommandResponseAction,
+  TavernSceneCommandRequestAction
 ]);
 var MessageDataToClient = z10.discriminatedUnion("action", [
   DataSubscriptionUpdateAction,
@@ -1743,7 +1823,10 @@ var MessageDataToClient = z10.discriminatedUnion("action", [
   CliCompletionChunkAction,
   CliCompletionDoneAction,
   CliCompletionErrorAction,
-  CliToolResponseAction
+  CliToolResponseAction,
+  KeepCommandAction,
+  KeepCommandResultAction,
+  TavernSceneBroadcastAction
 ]);
 
 // ../../b4m-core/packages/common/dist/src/schemas/cliCompletions.js
@@ -2701,6 +2784,7 @@ var SettingKeySchema = z21.enum([
   "EnableHelpChat",
   // B4M PI SETTINGS
   "EnableBmPi",
+  "EnableBmPiJira",
   // QUANTUM CANVASSER SETTINGS
   "EnableQuantumCanvasser",
   // CONTEXT TELEMETRY SETTINGS
@@ -3268,7 +3352,8 @@ var API_SERVICE_GROUPS = {
       { key: "EnableParallelToolExecution", order: 17 },
       { key: "EnableHelpChat", order: 18 },
       { key: "EnableBmPi", order: 19 },
-      { key: "EnableQuantumCanvasser", order: 20 }
+      { key: "EnableBmPiJira", order: 20 },
+      { key: "EnableQuantumCanvasser", order: 21 }
     ]
   },
   NOTEBOOK: {
@@ -4479,6 +4564,16 @@ var settingsMap = {
     group: API_SERVICE_GROUPS.EXPERIMENTAL.id,
     order: 18
   }),
+  EnableBmPiJira: makeBooleanSetting({
+    key: "EnableBmPiJira",
+    name: "Enable B4M Pi \u2014 Jira Integration",
+    defaultValue: false,
+    description: 'Show Jira source toggle and Jira views in the B4M Pi dashboard. Requires "Enable B4M Pi" to be on.',
+    category: "Experimental",
+    group: API_SERVICE_GROUPS.EXPERIMENTAL.id,
+    order: 19,
+    dependsOn: "EnableBmPi"
+  }),
   // OptiHashi Settings
   EnableQuantumCanvasser: makeBooleanSetting({
     key: "EnableQuantumCanvasser",
@@ -7624,7 +7719,8 @@ function formatIssueDetails(issue, siteUrl) {
     priority: issue.fields?.priority?.name,
     assignee: issue.fields?.assignee ? {
       accountId: issue.fields.assignee.accountId,
-      displayName: issue.fields.assignee.displayName
+      displayName: issue.fields.assignee.displayName,
+      accountType: issue.fields.assignee.accountType
     } : null,
     reporter: issue.fields?.reporter ? {
       accountId: issue.fields.reporter.accountId,
@@ -7648,7 +7744,8 @@ function formatSearchResults2(searchResult, siteUrl) {
     total: searchResult.total || 0,
     startAt: searchResult.startAt || 0,
     maxResults: searchResult.maxResults || 0,
-    issues
+    issues,
+    ...searchResult.nextPageToken && { nextPageToken: searchResult.nextPageToken }
   };
 }
 function formatProjectList(response, siteUrl) {
@@ -7703,7 +7800,7 @@ function formatTransitions(transitionsResponse) {
     name: transition.name,
     to: transition.to
   })) : [];
-  return transitions;
+  return { transitions };
 }
 function formatUser(user) {
   if (!user || typeof user !== "object" || user.error || user.errors) {
@@ -8056,1449 +8153,1483 @@ var AgileApi = class {
   }
 };
 
-// ../../b4m-core/packages/common/dist/src/jira/webhook/format.js
-function daysUntil(dateString) {
-  const expirationDate = new Date(dateString);
-  const now = /* @__PURE__ */ new Date();
-  const diffMs = expirationDate.getTime() - now.getTime();
-  return Math.ceil(diffMs / (1e3 * 60 * 60 * 24));
-}
-function formatWebhook(webhook) {
-  const daysUntilExpiry = daysUntil(webhook.expirationDate);
-  return {
-    id: webhook.id,
-    events: webhook.events,
-    jqlFilter: webhook.jqlFilter,
-    expirationDate: webhook.expirationDate,
-    daysUntilExpiry,
-    isExpiringSoon: daysUntilExpiry < 7
-  };
+// ../../b4m-core/packages/common/dist/src/jira/api.js
+var JIRA_MAX_ATTACHMENT_SIZE = 20 * 1024 * 1024;
+var JIRA_PROJECT_KEY_RE = /^[A-Z][A-Z0-9_]*$/i;
+function isValidProjectKey(key) {
+  return JIRA_PROJECT_KEY_RE.test(key);
 }
-function formatWebhookList(response) {
-  return {
-    webhooks: response.values.map(formatWebhook),
-    total: response.total,
-    hasMore: !response.isLast
-  };
+function isValidIssueKey(key) {
+  return /^[A-Z][A-Z0-9]*-\d+$/.test(key);
 }
-function extractAdfText(body, maxLength = 500) {
-  if (!body || typeof body !== "object")
-    return "";
-  const doc = body;
-  if (doc.type !== "doc" || !Array.isArray(doc.content))
-    return "";
-  const parts = [];
-  let totalLength = 0;
-  function walk(nodes) {
-    for (const node of nodes) {
-      if (totalLength >= maxLength)
-        return;
-      if (!node || typeof node !== "object")
-        continue;
-      const n = node;
-      if (n.type === "text" && typeof n.text === "string") {
-        const remaining = maxLength - totalLength;
-        const text = n.text.slice(0, remaining);
-        parts.push(text);
-        totalLength += text.length;
-      }
-      if (Array.isArray(n.content)) {
-        walk(n.content);
-      }
+function wikiMarkupToAdf(text) {
+  const lines = text.split("\n");
+  const content = [];
+  let currentTableRows = [];
+  let inTable = false;
+  for (const line of lines) {
+    const trimmedLine = line.trim();
+    if (trimmedLine.startsWith("||") && trimmedLine.endsWith("||")) {
+      inTable = true;
+      const cells = trimmedLine.slice(2, -2).split("||").map((cell) => cell.trim());
+      const headerRow = {
+        type: "tableRow",
+        content: cells.map((cell) => ({
+          type: "tableHeader",
+          attrs: {},
+          content: [{ type: "paragraph", content: [{ type: "text", text: cell || " " }] }]
+        }))
+      };
+      currentTableRows.push(headerRow);
+      continue;
+    }
+    if (trimmedLine.startsWith("|") && trimmedLine.endsWith("|") && !trimmedLine.startsWith("||")) {
+      inTable = true;
+      const cells = trimmedLine.slice(1, -1).split("|").map((cell) => cell.trim());
+      const dataRow = {
+        type: "tableRow",
+        content: cells.map((cell) => ({
+          type: "tableCell",
+          attrs: {},
+          content: [{ type: "paragraph", content: [{ type: "text", text: cell || " " }] }]
+        }))
+      };
+      currentTableRows.push(dataRow);
+      continue;
+    }
+    if (inTable && currentTableRows.length > 0) {
+      const table = {
+        type: "table",
+        attrs: { isNumberColumnEnabled: false, layout: "default" },
+        content: currentTableRows
+      };
+      content.push(table);
+      currentTableRows = [];
+      inTable = false;
+    }
+    if (trimmedLine) {
+      content.push({
+        type: "paragraph",
+        content: [{ type: "text", text: trimmedLine }]
+      });
     }
   }
-  walk(doc.content);
-  const result = parts.join("");
-  if (totalLength >= maxLength)
-    return result + "...";
-  return result;
-}
-function escapeSlackMrkdwn(text) {
-  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/\*/g, "\u2217").replace(/_/g, "\uFF3F").replace(/~/g, "\u223C").replace(/`/g, "\u02CB");
+  if (currentTableRows.length > 0) {
+    const table = {
+      type: "table",
+      attrs: { isNumberColumnEnabled: false, layout: "default" },
+      content: currentTableRows
+    };
+    content.push(table);
+  }
+  if (content.length === 0) {
+    content.push({ type: "paragraph", content: [{ type: "text", text: " " }] });
+  }
+  return { type: "doc", version: 1, content };
 }
-var PRIORITY_EMOJI = {
-  Highest: ":red_circle:",
-  High: ":large_orange_circle:",
-  Medium: ":large_yellow_circle:",
-  Low: ":large_green_circle:",
-  Lowest: ":white_circle:"
-};
-function getPriorityEmoji(priority) {
-  if (!priority)
-    return "";
-  return PRIORITY_EMOJI[priority] || ":blue_circle:";
+function containsWikiTable(text) {
+  return /^\|\|.+\|\|$/m.test(text) || /^\|(?!\|).+\|$/m.test(text);
 }
-function formatIssueEventForSlack(event, siteUrl) {
-  const { issue, webhookEvent, user, changelog } = event;
-  const { fields } = issue;
-  const priorityEmoji = getPriorityEmoji(fields.priority?.name);
-  const issueUrl = `${siteUrl}/browse/${issue.key}`;
-  let action;
-  let emoji;
-  switch (webhookEvent) {
-    case "jira:issue_created":
-      action = "created";
-      emoji = ":new:";
-      break;
-    case "jira:issue_updated":
-      action = "updated";
-      emoji = ":pencil2:";
-      break;
-    case "jira:issue_deleted":
-      action = "deleted";
-      emoji = ":wastebasket:";
-      break;
-    default:
-      action = "changed";
-      emoji = ":bell:";
+var JiraApi = class {
+  config;
+  constructor(config) {
+    this.config = config;
   }
-  let changelogText = "";
-  if (changelog?.items && changelog.items.length > 0) {
-    const changes = changelog.items.slice(0, 3).map((item) => {
-      const from = escapeSlackMrkdwn(item.fromString || "None");
-      const to = escapeSlackMrkdwn(item.toString || "None");
-      if (item.field === "status") {
-        return `Status: ${from} \u2192 ${to}`;
-      }
-      if (item.field === "assignee") {
-        return `Assignee: ${escapeSlackMrkdwn(item.fromString || "Unassigned")} \u2192 ${escapeSlackMrkdwn(item.toString || "Unassigned")}`;
-      }
-      if (item.field === "priority") {
-        return `Priority: ${from} \u2192 ${to}`;
-      }
-      return `${escapeSlackMrkdwn(item.field)}: ${from} \u2192 ${to}`;
+  /**
+   * Build URL with query parameters
+   */
+  buildUrl(path, query = {}) {
+    const base = `${this.config.apiBaseUrl}${path}`;
+    const url = new URL(base);
+    Object.entries(query).forEach(([key, value]) => {
+      if (value === void 0 || value === "")
+        return;
+      url.searchParams.append(key, String(value));
     });
-    if (changes.length > 0) {
-      changelogText = "\n" + changes.map((c) => `\u2022 ${c}`).join("\n");
-      if (changelog.items.length > 3) {
-        changelogText += `
-_...and ${changelog.items.length - 3} more changes_`;
+    return url.toString();
+  }
+  /**
+   * Build web URL for Jira UI links
+   */
+  buildWebUrl(path) {
+    if (!path)
+      return "";
+    const cleanPath = path.startsWith("/") ? path.slice(1) : path;
+    return `${this.config.webBaseUrl}/${cleanPath}`;
+  }
+  /**
+   * Make authenticated HTTP request
+   */
+  async request(method, path, options = {}) {
+    const url = this.buildUrl(path, options.query);
+    const headers = {
+      Authorization: this.config.authHeader,
+      Accept: "application/json",
+      "Content-Type": "application/json"
+    };
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: options.body ? JSON.stringify(options.body) : void 0
+    });
+    const rateLimitInfo = parseRateLimitHeaders(response.headers);
+    if (hasRateLimitInfo(rateLimitInfo)) {
+      const logEntry = buildRateLimitLogEntry("jira", path, rateLimitInfo);
+      console.error(JSON.stringify(logEntry));
+      if (isNearLimit(rateLimitInfo)) {
+        console.error(`[Jira] Rate limit warning: ${rateLimitInfo.usagePercent}% used (${rateLimitInfo.remaining}/${rateLimitInfo.limit} remaining)`);
       }
     }
-  }
-  const blocks = [
-    {
-      type: "header",
-      text: {
-        type: "plain_text",
-        text: `${emoji} Issue ${action}: ${escapeSlackMrkdwn(issue.key)}`,
-        emoji: true
-      }
-    },
-    {
-      type: "section",
-      text: {
-        type: "mrkdwn",
-        text: `*<${issueUrl}|${escapeSlackMrkdwn(issue.key)}>* ${escapeSlackMrkdwn(fields.summary)}`
-      }
-    },
-    {
-      type: "section",
-      text: {
-        type: "mrkdwn",
-        text: [
-          `${priorityEmoji} *Priority:* ${escapeSlackMrkdwn(fields.priority?.name || "None")}`,
-          `*Status:* ${escapeSlackMrkdwn(fields.status.name)}`,
-          `*Type:* ${escapeSlackMrkdwn(fields.issuetype.name)}`,
-          `*Assignee:* ${escapeSlackMrkdwn(fields.assignee?.displayName || "Unassigned")}`
-        ].join("  |  ")
-      }
+    if (response.status === 429 && (options._retryCount ?? 0) < 1) {
+      const retryAfterMs = rateLimitInfo.retryAfterMs ?? 5e3;
+      const jitterMs = Math.floor(Math.random() * 1e3);
+      const delayMs = Math.min(retryAfterMs + jitterMs, 1e4);
+      const logEntry = buildRateLimitLogEntry("jira", path, rateLimitInfo, true);
+      console.error(JSON.stringify(logEntry));
+      console.error(`[Jira] Rate limited on ${path}, retrying after ${delayMs}ms`);
+      await new Promise((resolve) => setTimeout(resolve, delayMs));
+      return this.request(method, path, {
+        ...options,
+        _retryCount: (options._retryCount ?? 0) + 1
+      });
     }
-  ];
-  if (changelogText) {
-    blocks.push({
-      type: "section",
-      text: {
-        type: "mrkdwn",
-        text: `*Changes:*${changelogText}`
+    if (!response.ok) {
+      const errorBody = await response.text();
+      throw new Error(`Jira API error (${response.status}): ${errorBody}`);
+    }
+    if (response.status === 204) {
+      return {};
+    }
+    const data = await response.json();
+    return data;
+  }
+  // ============================================================================
+  // High-Level API Methods
+  // ============================================================================
+  /**
+   * Get issue by key or ID
+   */
+  async getIssue(params) {
+    const { issueKey, expand } = params;
+    const issue = await this.request("GET", `/issue/${issueKey}`, {
+      query: {
+        expand: expand?.join(",")
       }
     });
+    return formatIssueDetails(issue, this.config.siteUrl);
   }
-  blocks.push({
-    type: "context",
-    elements: [
-      {
-        type: "mrkdwn",
-        text: `${escapeSlackMrkdwn(user?.displayName || "Someone")} \u2022 ${escapeSlackMrkdwn(fields.project.name)} (${escapeSlackMrkdwn(fields.project.key)})`
-      }
-    ]
-  });
-  blocks.push({
-    type: "actions",
-    elements: [
-      {
-        type: "button",
-        text: {
-          type: "plain_text",
-          text: "View in Jira",
-          emoji: true
-        },
-        url: issueUrl,
-        style: "primary"
+  /**
+   * Create a new issue
+   */
+  async createIssue(params) {
+    const { projectKey, summary, description, issueTypeName, assignee, labels, parentKey, ...customFields } = params;
+    const fields = {
+      project: { key: projectKey },
+      summary,
+      issuetype: { name: issueTypeName },
+      ...customFields
+    };
+    if (description) {
+      if (containsWikiTable(description)) {
+        console.log("[JIRA-ADF] Converting wiki table to ADF", { length: description.length });
+        fields.description = wikiMarkupToAdf(description);
+      } else {
+        fields.description = {
+          type: "doc",
+          version: 1,
+          content: [
+            {
+              type: "paragraph",
+              content: [{ type: "text", text: description }]
+            }
+          ]
+        };
       }
-    ]
-  });
-  return {
-    blocks,
-    text: `${emoji} ${escapeSlackMrkdwn(issue.key)} ${action}: ${escapeSlackMrkdwn(fields.summary)}`
-  };
-}
-function formatCommentEventForSlack(event, siteUrl) {
-  const { issue, comment, webhookEvent } = event;
-  const issueUrl = `${siteUrl}/browse/${issue.key}`;
-  let action;
-  let emoji;
-  switch (webhookEvent) {
-    case "comment_created":
-      action = "commented on";
-      emoji = ":speech_balloon:";
-      break;
-    case "comment_updated":
-      action = "updated comment on";
-      emoji = ":pencil:";
-      break;
-    case "comment_deleted":
-      action = "deleted comment on";
-      emoji = ":x:";
-      break;
-    default:
-      action = "commented on";
-      emoji = ":speech_balloon:";
+    }
+    if (assignee) {
+      fields.assignee = { id: assignee };
+    }
+    if (labels && labels.length > 0) {
+      fields.labels = labels;
+    }
+    if (parentKey) {
+      fields.parent = { key: parentKey };
+    }
+    const result = await this.request("POST", "/issue", {
+      body: { fields }
+    });
+    return formatIssueResponse(result, this.config.siteUrl);
   }
-  const blocks = [
-    {
-      type: "header",
-      text: {
-        type: "plain_text",
-        text: `${emoji} ${escapeSlackMrkdwn(comment.author.displayName)} ${action} ${escapeSlackMrkdwn(issue.key)}`,
-        emoji: true
-      }
-    },
-    {
-      type: "section",
-      text: {
-        type: "mrkdwn",
-        text: `*<${issueUrl}|${escapeSlackMrkdwn(issue.key)}>* ${escapeSlackMrkdwn(issue.fields.summary)}`
+  /**
+   * Update an existing issue
+   */
+  async updateIssue(params) {
+    const { issueKey, summary, description, labels, ...customFields } = params;
+    const fields = { ...customFields };
+    if (summary) {
+      fields.summary = summary;
+    }
+    if (description) {
+      if (containsWikiTable(description)) {
+        console.log("[JIRA-ADF] Converting wiki table to ADF (update)", { length: description.length });
+        fields.description = wikiMarkupToAdf(description);
+      } else {
+        fields.description = {
+          type: "doc",
+          version: 1,
+          content: [
+            {
+              type: "paragraph",
+              content: [{ type: "text", text: description }]
+            }
+          ]
+        };
       }
     }
-  ];
-  if (webhookEvent !== "comment_deleted") {
-    const bodyText = extractAdfText(comment.body);
-    if (bodyText) {
-      blocks.push({
-        type: "section",
-        text: {
-          type: "mrkdwn",
-          text: `> ${escapeSlackMrkdwn(bodyText).replace(/\n/g, "\n> ")}`
-        }
+    if (labels && labels.length > 0) {
+      fields.labels = labels;
+    }
+    if (Object.keys(fields).length > 0) {
+      await this.request("PUT", `/issue/${issueKey}`, {
+        body: { fields }
       });
     }
   }
-  blocks.push({
-    type: "context",
-    elements: [
-      {
-        type: "mrkdwn",
-        text: `${escapeSlackMrkdwn(issue.fields.project.name)} \u2022 ${escapeSlackMrkdwn(issue.fields.issuetype.name)}`
+  /**
+   * Search for issues using JQL
+   */
+  async searchIssues(params) {
+    const { jql, startAt = 0, maxResults = 50, fields, expand, nextPageToken } = params;
+    const result = await this.request("GET", "/search/jql", {
+      query: {
+        jql,
+        ...nextPageToken ? { nextPageToken } : { startAt },
+        maxResults,
+        fields: fields?.join(",") || "*all",
+        expand: expand?.join(",")
       }
-    ]
-  }, {
-    type: "actions",
-    elements: [
-      {
-        type: "button",
-        text: {
-          type: "plain_text",
-          text: "View in Jira",
-          emoji: true
-        },
-        url: issueUrl,
-        style: "primary"
-      }
-    ]
-  });
-  return {
-    blocks,
-    text: `${emoji} ${escapeSlackMrkdwn(comment.author.displayName)} ${action} ${escapeSlackMrkdwn(issue.key)}: ${escapeSlackMrkdwn(issue.fields.summary)}`
-  };
-}
-function formatSprintEventForSlack(event, siteUrl) {
-  const { sprint, webhookEvent, user } = event;
-  let action;
-  let emoji;
-  switch (webhookEvent) {
-    case "sprint_created":
-      action = "created";
-      emoji = ":calendar:";
-      break;
-    case "sprint_started":
-      action = "started";
-      emoji = ":rocket:";
-      break;
-    case "sprint_closed":
-      action = "completed";
-      emoji = ":checkered_flag:";
-      break;
-    case "sprint_updated":
-      action = "updated";
-      emoji = ":pencil2:";
-      break;
-    case "sprint_deleted":
-      action = "deleted";
-      emoji = ":wastebasket:";
-      break;
-    default:
-      action = "changed";
-      emoji = ":bell:";
-  }
-  const sprintUrl = `${siteUrl}/secure/RapidBoard.jspa?rapidView=${sprint.originBoardId}`;
-  const blocks = [
-    {
-      type: "header",
-      text: {
-        type: "plain_text",
-        text: `${emoji} Sprint ${action}: ${escapeSlackMrkdwn(sprint.name)}`,
-        emoji: true
-      }
-    },
-    {
-      type: "section",
-      text: {
-        type: "mrkdwn",
-        text: [
-          `*State:* ${escapeSlackMrkdwn(sprint.state)}`,
-          sprint.startDate ? `*Start:* ${new Date(sprint.startDate).toLocaleDateString()}` : "",
-          sprint.endDate ? `*End:* ${new Date(sprint.endDate).toLocaleDateString()}` : ""
-        ].filter(Boolean).join("  |  ")
-      }
-    }
-  ];
-  if (sprint.goal) {
-    blocks.push({
-      type: "section",
-      text: {
-        type: "mrkdwn",
-        text: `*Goal:* ${escapeSlackMrkdwn(sprint.goal)}`
-      }
-    });
-  }
-  blocks.push({
-    type: "context",
-    elements: [
-      {
-        type: "mrkdwn",
-        text: user?.displayName ? escapeSlackMrkdwn(user.displayName) : "System"
-      }
-    ]
-  });
-  blocks.push({
-    type: "actions",
-    elements: [
-      {
-        type: "button",
-        text: {
-          type: "plain_text",
-          text: "View Board",
-          emoji: true
-        },
-        url: sprintUrl,
-        style: "primary"
-      }
-    ]
-  });
-  return {
-    blocks,
-    text: `${emoji} Sprint ${action}: ${escapeSlackMrkdwn(sprint.name)}`
-  };
-}
-function formatGenericEventForSlack(eventType, payload, siteUrl) {
-  const issue = payload.issue;
-  const user = payload.user;
-  const issueLink = payload.issueLink;
-  const changelog = payload.changelog;
-  const project = payload.project ?? issue?.fields?.project;
-  const version = payload.version;
-  const worklog = payload.worklog;
-  const board = payload.board;
-  const readableEvent = eventType.replace(/^jira:/, "").replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-  const blocks = [
-    {
-      type: "header",
-      text: {
-        type: "plain_text",
-        text: `:bell: ${readableEvent}`,
-        emoji: true
-      }
-    }
-  ];
-  const details = [];
-  if (issue?.key) {
-    const issueUrl = `${siteUrl}/browse/${issue.key}`;
-    blocks.push({
-      type: "section",
-      text: {
-        type: "mrkdwn",
-        text: `*<${issueUrl}|${escapeSlackMrkdwn(issue.key)}>* ${escapeSlackMrkdwn(issue.fields?.summary || "")}`
+    });
+    return formatSearchResults2(result, this.config.siteUrl);
+  }
+  /**
+   * List all accessible projects
+   */
+  async listProjects(params) {
+    const projects = await this.request("GET", "/project/search", {
+      query: {
+        maxResults: params?.maxResults,
+        query: params?.query,
+        expand: params?.expand
       }
     });
-    const meta = [];
-    if (issue.fields?.status?.name)
-      meta.push(`*Status:* ${escapeSlackMrkdwn(issue.fields.status.name)}`);
-    if (issue.fields?.issuetype?.name)
-      meta.push(`*Type:* ${escapeSlackMrkdwn(issue.fields.issuetype.name)}`);
-    if (issue.fields?.priority?.name) {
-      const emoji = getPriorityEmoji(issue.fields.priority.name);
-      meta.push(`${emoji} *Priority:* ${escapeSlackMrkdwn(issue.fields.priority.name)}`);
-    }
-    if (issue.fields?.assignee?.displayName)
-      meta.push(`*Assignee:* ${escapeSlackMrkdwn(issue.fields.assignee.displayName)}`);
-    if (meta.length > 0)
-      details.push(meta.join("  |  "));
-  }
-  if (issueLink?.issueLinkType) {
-    const linkType = issueLink.issueLinkType;
-    const linkDesc = escapeSlackMrkdwn(linkType.outwardName || linkType.name || "linked");
-    details.push(`*Link type:* ${linkDesc}`);
-    if (issueLink.sourceIssueId)
-      details.push(`*Source issue ID:* ${issueLink.sourceIssueId}`);
-    if (issueLink.destinationIssueId)
-      details.push(`*Destination issue ID:* ${issueLink.destinationIssueId}`);
-  }
-  if (version?.name) {
-    const versionParts = [`*Version:* ${escapeSlackMrkdwn(version.name)}`];
-    if (version.description)
-      versionParts.push(escapeSlackMrkdwn(version.description));
-    if (version.released !== void 0)
-      versionParts.push(version.released ? ":white_check_mark: Released" : "Unreleased");
-    details.push(versionParts.join("  |  "));
-  }
-  if (worklog) {
-    const wlParts = [];
-    if (worklog.author?.displayName)
-      wlParts.push(`*By:* ${escapeSlackMrkdwn(worklog.author.displayName)}`);
-    if (worklog.timeSpent)
-      wlParts.push(`*Time:* ${escapeSlackMrkdwn(worklog.timeSpent)}`);
-    if (wlParts.length > 0)
-      details.push(wlParts.join("  |  "));
-  }
-  if (board?.name) {
-    details.push(`*Board:* ${escapeSlackMrkdwn(board.name)}`);
-  }
-  if (changelog?.items && changelog.items.length > 0) {
-    const changes = changelog.items.slice(0, 3).map((item) => `\u2022 ${escapeSlackMrkdwn(item.field || "")}: ${escapeSlackMrkdwn(item.fromString || "None")} \u2192 ${escapeSlackMrkdwn(item.toString || "None")}`);
-    if (changelog.items.length > 3) {
-      changes.push(`_...and ${changelog.items.length - 3} more_`);
-    }
-    details.push(`*Changes:*
-${changes.join("\n")}`);
+    return formatProjectList(projects, this.config.siteUrl);
   }
-  if (details.length > 0) {
-    blocks.push({
-      type: "section",
-      text: {
-        type: "mrkdwn",
-        text: details.join("\n")
+  /**
+   * Get project details
+   */
+  async getProject(params) {
+    const { projectKey, expand } = params;
+    const project = await this.request("GET", `/project/${projectKey}`, {
+      query: {
+        expand: expand?.join(",")
       }
     });
+    return formatProjectResponse(project, this.config.siteUrl);
   }
-  const contextParts = [];
-  if (user?.displayName)
-    contextParts.push(escapeSlackMrkdwn(user.displayName));
-  if (project?.name)
-    contextParts.push(`${escapeSlackMrkdwn(project.name)}${project.key ? ` (${escapeSlackMrkdwn(project.key)})` : ""}`);
-  if (contextParts.length > 0) {
-    blocks.push({
-      type: "context",
-      elements: [{ type: "mrkdwn", text: contextParts.join(" \u2022 ") }]
-    });
+  /**
+   * List issue types for a project
+   */
+  async listIssueTypes(params) {
+    const { projectKey } = params;
+    const project = await this.getProject({ projectKey, expand: ["issueTypes"] });
+    return project.issueTypes || [];
   }
-  if (issue?.key) {
-    const issueUrl = `${siteUrl}/browse/${issue.key}`;
-    blocks.push({
-      type: "actions",
-      elements: [
-        {
-          type: "button",
-          text: { type: "plain_text", text: "View in Jira", emoji: true },
-          url: issueUrl,
-          style: "primary"
+  /**
+   * Add comment to an issue
+   */
+  async addComment(params) {
+    const { issueKey, body } = params;
+    const comment = await this.request("POST", `/issue/${issueKey}/comment`, {
+      body: {
+        body: {
+          type: "doc",
+          version: 1,
+          content: [
+            {
+              type: "paragraph",
+              content: [{ type: "text", text: body }]
+            }
+          ]
         }
-      ]
+      }
     });
-  }
-  const summary = issue?.key ? `${escapeSlackMrkdwn(issue.key)}: ${escapeSlackMrkdwn(issue.fields?.summary || readableEvent)}` : readableEvent;
-  return {
-    blocks,
-    text: `:bell: ${summary}`
-  };
-}
-
-// ../../b4m-core/packages/common/dist/src/jira/webhook/api.js
-var WebhookApi = class {
-  config;
-  constructor(config) {
-    this.config = config;
+    return formatComment(comment);
   }
   /**
-   * Build URL for webhook API endpoints.
-   *
-   * Note: Webhooks use a different base URL than other Jira APIs.
+   * Get all statuses available in a project, grouped by issue type.
+   * Uses GET /project/{projectKey}/statuses which returns every workflow status.
    */
-  buildUrl(path, query = {}) {
-    const url = new URL(`${this.config.apiBaseUrl}${path}`);
-    for (const [key, value] of Object.entries(query)) {
-      if (value !== void 0) {
-        url.searchParams.append(key, String(value));
+  async getProjectStatuses(params) {
+    const { projectKey } = params;
+    const result = await this.request("GET", `/project/${projectKey}/statuses`);
+    const names = /* @__PURE__ */ new Set();
+    for (const issueType of result) {
+      for (const status of issueType.statuses) {
+        names.add(status.name);
       }
     }
-    return url.toString();
+    return Array.from(names).sort();
   }
   /**
-   * Make an authenticated request to the Jira Webhook API.
+   * Get available transitions for an issue
    */
-  async request(method, path, options = {}) {
-    const url = this.buildUrl(path, options.query);
-    const headers = {
-      Authorization: this.config.authHeader,
-      Accept: "application/json",
-      "Content-Type": "application/json"
-    };
-    const response = await fetch(url, {
-      method,
-      headers,
-      body: options.body ? JSON.stringify(options.body) : void 0
+  async getTransitions(params) {
+    const { issueKey } = params;
+    const result = await this.request("GET", `/issue/${issueKey}/transitions`);
+    return formatTransitions(result);
+  }
+  /**
+   * Transition issue to a new status
+   */
+  async transitionIssue(params) {
+    const { issueKey, transitionId } = params;
+    await this.request("POST", `/issue/${issueKey}/transitions`, {
+      body: {
+        transition: { id: transitionId }
+      }
     });
-    if (!response.ok) {
-      const errorBody = await response.text();
-      throw new Error(`Jira Webhook API error (${response.status}): ${errorBody}`);
-    }
-    if (response.status === 204) {
-      return {};
-    }
-    const data = await response.json();
-    return data;
+    const result = { issueKey, transitionId };
+    return formatTransitionResult(result, this.config.siteUrl);
   }
-  // ============================================================================
-  // Webhook CRUD Operations
-  // ============================================================================
   /**
-   * List all webhooks registered by this OAuth app.
-   *
-   * @param startAt - Pagination start index (default: 0)
-   * @param maxResults - Max results per page (default: 50, max: 100)
+   * Assign issue to a user
    */
-  async listWebhooks(params = {}) {
-    const { startAt = 0, maxResults = 50 } = params;
-    const response = await this.request("GET", "/webhook", {
-      query: { startAt, maxResults }
+  async assignIssue(params) {
+    const { issueKey, accountId } = params;
+    await this.request("PUT", `/issue/${issueKey}/assignee`, {
+      body: { accountId }
     });
-    return formatWebhookList(response);
   }
   /**
-   * Register a new webhook.
-   *
-   * @param url - The URL where Jira will POST webhook events
-   * @param events - Events to subscribe to
-   * @param jqlFilter - Optional JQL filter (only matching issues trigger events)
-   * @returns The created webhook ID
+   * Delete an issue
    */
-  async registerWebhook(params) {
-    const { url, events, jqlFilter } = params;
-    const webhook = {
-      // Jira webhook API requires jqlFilter but has limited operator support.
-      // "IS NOT EMPTY" and empty strings are rejected. Use a universally-true expression.
-      jqlFilter: jqlFilter || "project != null",
-      events
-    };
-    const body = {
-      url,
-      webhooks: [webhook]
-    };
-    const response = await this.request("POST", "/webhook", {
-      body
+  async deleteIssue(params) {
+    const { issueKey } = params;
+    if (!issueKey) {
+      throw new Error("issueKey is required to delete an issue.");
+    }
+    await this.request("DELETE", `/issue/${issueKey}`);
+  }
+  /**
+   * Get current user information
+   */
+  async getCurrentUser() {
+    const user = await this.request("GET", "/myself");
+    return formatUser(user);
+  }
+  /**
+   * Search for users by query string (name, email, username)
+   */
+  async searchUsers(params) {
+    const { query, maxResults = 50 } = params;
+    const users = await this.request("GET", "/user/search", {
+      query: {
+        query,
+        maxResults
+      }
     });
-    console.log("[JIRA-WEBHOOK-API] registerWebhook raw response:", JSON.stringify(response, null, 2));
-    if (!response.webhookRegistrationResult || response.webhookRegistrationResult.length === 0) {
-      throw new Error("Failed to register webhook: No registration result returned");
+    return formatUserList(users);
+  }
+  /**
+   * Find users assignable to issues in a specific project.
+   * Uses GET /user/assignable/search?project=KEY which respects
+   * project permissions and roles.
+   */
+  async findAssignableUsers(params) {
+    const pageSize = 50;
+    const maxTotal = params.maxResults ?? 500;
+    const allUsers = [];
+    let startAt = 0;
+    while (allUsers.length < maxTotal) {
+      const page = await this.request("GET", "/user/assignable/search", {
+        query: { project: params.projectKey, startAt, maxResults: pageSize }
+      });
+      if (!page || page.length === 0)
+        break;
+      for (const u of page) {
+        if (u.active && u.accountType === "atlassian") {
+          allUsers.push(u);
+        }
+      }
+      if (page.length < pageSize)
+        break;
+      startAt += pageSize;
     }
-    const result = response.webhookRegistrationResult[0];
-    if (result.errors && result.errors.length > 0) {
-      throw new Error(`Failed to register webhook: ${result.errors.join(", ")}`);
+    return formatUserList(allUsers);
+  }
+  /**
+   * Bulk create multiple issues in a single API call.
+   * Supports up to 50 issues per request (Jira API limit).
+   * Ideal for creating multiple subtasks under a parent issue.
+   */
+  async bulkCreateIssues(params) {
+    const { issues } = params;
+    if (issues.length === 0) {
+      return { issues: [], errors: [] };
     }
-    if (result.createdWebhookId === void 0 || result.createdWebhookId === null) {
-      throw new Error(`Failed to register webhook: No webhook ID in response. Full result: ${JSON.stringify(result)}`);
+    if (issues.length > 50) {
+      throw new Error("Bulk create is limited to 50 issues per request. Please split your request.");
     }
+    const issueUpdates = issues.map((issue) => {
+      const { projectKey, summary, description, issueTypeName, assignee, labels, parentKey } = issue;
+      const fields = {
+        project: { key: projectKey },
+        summary,
+        issuetype: { name: issueTypeName }
+      };
+      if (description) {
+        if (containsWikiTable(description)) {
+          console.log("[JIRA-ADF] Converting wiki table to ADF (bulk)", { length: description.length });
+          fields.description = wikiMarkupToAdf(description);
+        } else {
+          fields.description = {
+            type: "doc",
+            version: 1,
+            content: [
+              {
+                type: "paragraph",
+                content: [{ type: "text", text: description }]
+              }
+            ]
+          };
+        }
+      }
+      if (assignee) {
+        fields.assignee = { id: assignee };
+      }
+      if (labels && labels.length > 0) {
+        fields.labels = labels;
+      }
+      if (parentKey) {
+        fields.parent = { key: parentKey };
+      }
+      return { update: {}, fields };
+    });
+    const result = await this.request("POST", "/issue/bulk", {
+      body: { issueUpdates }
+    });
+    const formattedIssues = (result.issues || []).map((issue) => formatIssueResponse(issue, this.config.siteUrl));
+    const formattedErrors = (result.errors || []).map((error) => ({
+      status: error.status,
+      message: Object.values(error.elementErrors?.errors || {}).join(", ") || "Unknown error",
+      failedElementNumber: error.failedElementNumber
+    }));
     return {
-      webhookId: result.createdWebhookId
+      issues: formattedIssues,
+      errors: formattedErrors
     };
   }
   /**
-   * Refresh webhook expiration dates.
-   *
-   * Jira webhooks expire after 30 days. Call this to extend expiration.
+   * Bulk transition multiple issues to new statuses in a single API call.
+   * Uses the Jira Cloud Bulk Transition API.
+   * Supports up to 1000 issues per request.
    *
-   * @param webhookIds - IDs of webhooks to refresh
-   * @returns New expiration date
+   * Note: This is an async operation - returns a task ID for tracking progress.
    */
-  async refreshWebhooks(params) {
-    const { webhookIds } = params;
-    const body = {
-      webhookIds
-    };
-    const response = await this.request("PUT", "/webhook/refresh", {
-      body
+  async bulkTransitionIssues(params) {
+    const { issues } = params;
+    console.error(`[Jira] bulkTransitionIssues called with ${issues.length} issue(s)`);
+    if (issues.length === 0) {
+      console.error("[Jira] bulkTransitionIssues: No issues provided, returning early");
+      return { taskId: "", message: "No issues to transition", issueCount: 0 };
+    }
+    if (issues.length > 1e3) {
+      console.error(`[Jira] bulkTransitionIssues: Exceeded 1000 issue limit (${issues.length})`);
+      throw new Error("Bulk transition is limited to 1000 issues per request. Please split your request.");
+    }
+    const transitionGroups = {};
+    for (const issue of issues) {
+      if (!transitionGroups[issue.transitionId]) {
+        transitionGroups[issue.transitionId] = [];
+      }
+      transitionGroups[issue.transitionId].push(issue.issueIdOrKey);
+    }
+    const bulkTransitionInputs = Object.entries(transitionGroups).map(([transitionId, selectedIssueIdsOrKeys]) => ({
+      selectedIssueIdsOrKeys,
+      transitionId
+    }));
+    console.error(`[Jira] bulkTransitionIssues: Grouped into ${bulkTransitionInputs.length} transition group(s)`);
+    const result = await this.request("POST", "/bulk/issues/transition", {
+      body: { bulkTransitionInputs }
     });
+    console.error(`[Jira] bulkTransitionIssues: Task created with ID ${result.taskId}`);
     return {
-      expirationDate: response.expirationDate
+      taskId: result.taskId,
+      message: `Bulk transition started for ${issues.length} issue(s).`,
+      issueCount: issues.length
     };
   }
   /**
-   * Delete webhooks by ID.
+   * Bulk update labels on multiple issues in a single API call.
+   * Uses the Jira Cloud Bulk Edit API.
+   * Supports up to 1000 issues per request.
    *
-   * @param webhookIds - IDs of webhooks to delete
-   */
-  async deleteWebhooks(params) {
-    const { webhookIds } = params;
-    const body = {
-      webhookIds
-    };
-    await this.request("DELETE", "/webhook", {
-      body
-    });
-  }
-  /**
-   * Get a specific webhook by ID.
+   * Note: This is an async operation - returns a task ID for tracking progress.
    *
-   * Note: Jira API doesn't have a direct "get by ID" endpoint,
-   * so we list and filter.
+   * Why only labels? Jira's Bulk Edit API has significant limitations:
+   * - Summary, description, assignee fields are NOT supported for bulk editing
+   * - Priority and issueType require IDs and have inconsistent behavior
+   * - Labels is the most reliable and commonly used bulk operation
+   * See: https://community.atlassian.com/forums/Jira-questions/Bulk-Change-Description-Field/qaq-p/897762
    */
-  async getWebhook(params) {
-    const { webhookId } = params;
-    const response = await this.request("GET", "/webhook", {
-      query: { startAt: 0, maxResults: 100 }
-    });
-    const webhook = response.values.find((w) => w.id === webhookId);
-    return webhook || null;
-  }
-};
-
-// ../../b4m-core/packages/common/dist/src/jira/api.js
-var JIRA_MAX_ATTACHMENT_SIZE = 20 * 1024 * 1024;
-function isValidIssueKey(key) {
-  return /^[A-Z][A-Z0-9]*-\d+$/.test(key);
-}
-function wikiMarkupToAdf(text) {
-  const lines = text.split("\n");
-  const content = [];
-  let currentTableRows = [];
-  let inTable = false;
-  for (const line of lines) {
-    const trimmedLine = line.trim();
-    if (trimmedLine.startsWith("||") && trimmedLine.endsWith("||")) {
-      inTable = true;
-      const cells = trimmedLine.slice(2, -2).split("||").map((cell) => cell.trim());
-      const headerRow = {
-        type: "tableRow",
-        content: cells.map((cell) => ({
-          type: "tableHeader",
-          attrs: {},
-          content: [{ type: "paragraph", content: [{ type: "text", text: cell || " " }] }]
-        }))
-      };
-      currentTableRows.push(headerRow);
-      continue;
-    }
-    if (trimmedLine.startsWith("|") && trimmedLine.endsWith("|") && !trimmedLine.startsWith("||")) {
-      inTable = true;
-      const cells = trimmedLine.slice(1, -1).split("|").map((cell) => cell.trim());
-      const dataRow = {
-        type: "tableRow",
-        content: cells.map((cell) => ({
-          type: "tableCell",
-          attrs: {},
-          content: [{ type: "paragraph", content: [{ type: "text", text: cell || " " }] }]
-        }))
-      };
-      currentTableRows.push(dataRow);
-      continue;
-    }
-    if (inTable && currentTableRows.length > 0) {
-      const table = {
-        type: "table",
-        attrs: { isNumberColumnEnabled: false, layout: "default" },
-        content: currentTableRows
-      };
-      content.push(table);
-      currentTableRows = [];
-      inTable = false;
+  async bulkUpdateIssues(params) {
+    const { issueIdsOrKeys, labels } = params;
+    console.error(`[Jira] bulkUpdateIssues called with ${issueIdsOrKeys.length} issue(s), action: ${labels.action}`);
+    if (issueIdsOrKeys.length === 0) {
+      console.error("[Jira] bulkUpdateIssues: No issues provided, returning early");
+      return { taskId: "", message: "No issues to update", issueCount: 0 };
     }
-    if (trimmedLine) {
-      content.push({
-        type: "paragraph",
-        content: [{ type: "text", text: trimmedLine }]
-      });
+    if (issueIdsOrKeys.length > 1e3) {
+      console.error(`[Jira] bulkUpdateIssues: Exceeded 1000 issue limit (${issueIdsOrKeys.length})`);
+      throw new Error("Bulk update is limited to 1000 issues per request. Please split your request.");
     }
-  }
-  if (currentTableRows.length > 0) {
-    const table = {
-      type: "table",
-      attrs: { isNumberColumnEnabled: false, layout: "default" },
-      content: currentTableRows
+    const selectedActions = ["labels"];
+    const editedFieldsInput = {
+      labelsFields: [
+        {
+          fieldId: "labels",
+          labels: labels.values.map((name) => ({ name })),
+          bulkEditMultiSelectFieldOption: labels.action
+        }
+      ]
+    };
+    console.error(`[Jira] bulkUpdateIssues: Updating labels [${labels.values.join(", ")}] with action ${labels.action}`);
+    const result = await this.request("POST", "/bulk/issues/fields", {
+      body: {
+        selectedActions,
+        selectedIssueIdsOrKeys: issueIdsOrKeys,
+        editedFieldsInput
+      }
+    });
+    console.error(`[Jira] bulkUpdateIssues: Task created with ID ${result.taskId}`);
+    return {
+      taskId: result.taskId,
+      message: `Bulk label update started for ${issueIdsOrKeys.length} issue(s). Action: ${labels.action}.`,
+      issueCount: issueIdsOrKeys.length
     };
-    content.push(table);
-  }
-  if (content.length === 0) {
-    content.push({ type: "paragraph", content: [{ type: "text", text: " " }] });
-  }
-  return { type: "doc", version: 1, content };
-}
-function containsWikiTable(text) {
-  return /^\|\|.+\|\|$/m.test(text) || /^\|(?!\|).+\|$/m.test(text);
-}
-var JiraApi = class {
-  config;
-  constructor(config) {
-    this.config = config;
   }
   /**
-   * Build URL with query parameters
+   * Get watchers for an issue
    */
-  buildUrl(path, query = {}) {
-    const base = `${this.config.apiBaseUrl}${path}`;
-    const url = new URL(base);
-    Object.entries(query).forEach(([key, value]) => {
-      if (value === void 0 || value === "")
-        return;
-      url.searchParams.append(key, String(value));
-    });
-    return url.toString();
+  async getWatchers(params) {
+    const { issueKey } = params;
+    const result = await this.request("GET", `/issue/${issueKey}/watchers`);
+    return formatWatchers(result);
   }
   /**
-   * Build web URL for Jira UI links
+   * Add a watcher to an issue
    */
-  buildWebUrl(path) {
-    if (!path)
-      return "";
-    const cleanPath = path.startsWith("/") ? path.slice(1) : path;
-    return `${this.config.webBaseUrl}/${cleanPath}`;
+  async addWatcher(params) {
+    const { issueKey, accountId } = params;
+    await this.request("POST", `/issue/${issueKey}/watchers`, {
+      body: accountId
+    });
   }
   /**
-   * Make authenticated HTTP request
+   * Remove a watcher from an issue
    */
-  async request(method, path, options = {}) {
-    const url = this.buildUrl(path, options.query);
-    const headers = {
-      Authorization: this.config.authHeader,
-      Accept: "application/json",
-      "Content-Type": "application/json"
-    };
-    const response = await fetch(url, {
-      method,
-      headers,
-      body: options.body ? JSON.stringify(options.body) : void 0
+  async removeWatcher(params) {
+    const { issueKey, accountId } = params;
+    await this.request("DELETE", `/issue/${issueKey}/watchers`, {
+      query: { accountId }
     });
-    const rateLimitInfo = parseRateLimitHeaders(response.headers);
-    if (hasRateLimitInfo(rateLimitInfo)) {
-      const logEntry = buildRateLimitLogEntry("jira", path, rateLimitInfo);
-      console.error(JSON.stringify(logEntry));
-      if (isNearLimit(rateLimitInfo)) {
-        console.error(`[Jira] Rate limit warning: ${rateLimitInfo.usagePercent}% used (${rateLimitInfo.remaining}/${rateLimitInfo.limit} remaining)`);
-      }
-    }
-    if (response.status === 429 && (options._retryCount ?? 0) < 1) {
-      const retryAfterMs = rateLimitInfo.retryAfterMs ?? 5e3;
-      const jitterMs = Math.floor(Math.random() * 1e3);
-      const delayMs = Math.min(retryAfterMs + jitterMs, 1e4);
-      const logEntry = buildRateLimitLogEntry("jira", path, rateLimitInfo, true);
-      console.error(JSON.stringify(logEntry));
-      console.error(`[Jira] Rate limited on ${path}, retrying after ${delayMs}ms`);
-      await new Promise((resolve) => setTimeout(resolve, delayMs));
-      return this.request(method, path, {
-        ...options,
-        _retryCount: (options._retryCount ?? 0) + 1
-      });
-    }
-    if (!response.ok) {
-      const errorBody = await response.text();
-      throw new Error(`Jira API error (${response.status}): ${errorBody}`);
-    }
-    if (response.status === 204) {
-      return {};
-    }
-    const data = await response.json();
-    return data;
   }
   // ============================================================================
-  // High-Level API Methods
+  // Issue Link Operations
   // ============================================================================
   /**
-   * Get issue by key or ID
+   * Get all available issue link types in the Jira instance
    */
-  async getIssue(params) {
-    const { issueKey, expand } = params;
-    const issue = await this.request("GET", `/issue/${issueKey}`, {
-      query: {
-        expand: expand?.join(",")
-      }
-    });
-    return formatIssueDetails(issue, this.config.siteUrl);
+  async getIssueLinkTypes() {
+    const result = await this.request("GET", "/issueLinkType");
+    return formatIssueLinkTypes(result);
   }
   /**
-   * Create a new issue
+   * Get all issue links for a specific issue
    */
-  async createIssue(params) {
-    const { projectKey, summary, description, issueTypeName, assignee, labels, parentKey, ...customFields } = params;
-    const fields = {
-      project: { key: projectKey },
-      summary,
-      issuetype: { name: issueTypeName },
-      ...customFields
-    };
-    if (description) {
-      if (containsWikiTable(description)) {
-        console.log("[JIRA-ADF] Converting wiki table to ADF", { length: description.length });
-        fields.description = wikiMarkupToAdf(description);
-      } else {
-        fields.description = {
-          type: "doc",
-          version: 1,
-          content: [
-            {
-              type: "paragraph",
-              content: [{ type: "text", text: description }]
-            }
-          ]
-        };
-      }
-    }
-    if (assignee) {
-      fields.assignee = { id: assignee };
-    }
-    if (labels && labels.length > 0) {
-      fields.labels = labels;
-    }
-    if (parentKey) {
-      fields.parent = { key: parentKey };
+  async getIssueLinks(params) {
+    const { issueKey } = params;
+    if (!isValidIssueKey(issueKey)) {
+      throw new Error(`Invalid issue key format: ${issueKey}. Expected format: PROJECT-123`);
     }
-    const result = await this.request("POST", "/issue", {
-      body: { fields }
+    const issue = await this.request("GET", `/issue/${issueKey}`, {
+      query: { fields: "issuelinks" }
     });
-    return formatIssueResponse(result, this.config.siteUrl);
+    return formatIssueLinks(issue.fields?.issuelinks || [], this.config.siteUrl);
   }
   /**
-   * Update an existing issue
+   * Create a link between two issues.
+   * Uses intuitive sourceIssue/targetIssue terminology:
+   * - sourceIssue: The issue doing the action (e.g., PROJ-1 in "PROJ-1 blocks PROJ-2")
+   * - targetIssue: The issue being acted upon (e.g., PROJ-2 in "PROJ-1 blocks PROJ-2")
+   *
+   * This maps to Jira's API as: sourceIssue → outwardIssue, targetIssue → inwardIssue
+   *
+   * @returns void - Jira returns 201 with no body on success
    */
-  async updateIssue(params) {
-    const { issueKey, summary, description, labels, ...customFields } = params;
-    const fields = { ...customFields };
-    if (summary) {
-      fields.summary = summary;
+  async createIssueLink(params) {
+    const { linkType, sourceIssue, targetIssue } = params;
+    if (!isValidIssueKey(sourceIssue)) {
+      throw new Error(`Invalid source issue key format: ${sourceIssue}. Expected format: PROJECT-123`);
     }
-    if (description) {
-      if (containsWikiTable(description)) {
-        console.log("[JIRA-ADF] Converting wiki table to ADF (update)", { length: description.length });
-        fields.description = wikiMarkupToAdf(description);
-      } else {
-        fields.description = {
-          type: "doc",
-          version: 1,
-          content: [
-            {
-              type: "paragraph",
-              content: [{ type: "text", text: description }]
-            }
-          ]
-        };
-      }
+    if (!isValidIssueKey(targetIssue)) {
+      throw new Error(`Invalid target issue key format: ${targetIssue}. Expected format: PROJECT-123`);
     }
-    if (labels) {
-      fields.labels = labels;
+    const linkTypes = await this.getIssueLinkTypes();
+    const matchedType = linkTypes.find((t) => t.name.toLowerCase() === linkType.toLowerCase());
+    if (!matchedType) {
+      const availableTypes = linkTypes.map((t) => t.name).join(", ");
+      throw new Error(`Invalid link type: "${linkType}". Available types: ${availableTypes}`);
     }
-    await this.request("PUT", `/issue/${issueKey}`, {
-      body: { fields }
+    await this.request("POST", "/issueLink", {
+      body: {
+        type: { name: matchedType.name },
+        outwardIssue: { key: sourceIssue },
+        inwardIssue: { key: targetIssue }
+      }
     });
   }
   /**
-   * Search for issues using JQL
+   * Delete an issue link by its ID
    */
-  async searchIssues(params) {
-    const { jql, startAt = 0, maxResults = 50, fields, expand } = params;
-    const result = await this.request("GET", "/search/jql", {
-      query: {
-        jql,
-        startAt,
-        maxResults,
-        fields: fields?.join(",") || "*all",
-        expand: expand?.join(",")
-      }
-    });
-    return formatSearchResults2(result, this.config.siteUrl);
+  async deleteIssueLink(params) {
+    const { linkId } = params;
+    await this.request("DELETE", `/issueLink/${linkId}`);
   }
   /**
-   * List all accessible projects
+   * Find a specific issue link between two issues by their keys and link type.
+   * Searches bidirectionally - works regardless of which issue key is provided first.
+   *
+   * @returns The link ID if found, null if no matching link exists
    */
-  async listProjects(params) {
-    const projects = await this.request("GET", "/project/search", {
-      query: {
-        maxResults: params?.maxResults,
-        query: params?.query,
-        expand: params?.expand
+  async findIssueLink(params) {
+    const { issueKey, linkedIssueKey, linkType } = params;
+    if (!isValidIssueKey(issueKey)) {
+      throw new Error(`Invalid issue key format: ${issueKey}. Expected format: PROJECT-123`);
+    }
+    if (!isValidIssueKey(linkedIssueKey)) {
+      throw new Error(`Invalid linked issue key format: ${linkedIssueKey}. Expected format: PROJECT-123`);
+    }
+    const links = await this.getIssueLinks({ issueKey });
+    const linkTypeLower = linkType.toLowerCase();
+    for (const link of links) {
+      if (link.type.name.toLowerCase() !== linkTypeLower) {
+        continue;
       }
-    });
-    return formatProjectList(projects, this.config.siteUrl);
+      const outwardKey = link.outwardIssue?.key;
+      const inwardKey = link.inwardIssue?.key;
+      if (outwardKey === linkedIssueKey || inwardKey === linkedIssueKey) {
+        return link.id;
+      }
+    }
+    return null;
   }
+  // ============================================================================
+  // Project Role & Member Operations
+  // ============================================================================
   /**
-   * Get project details
+   * Get all project roles for a project.
+   * Returns a list of roles with their IDs.
    */
-  async getProject(params) {
-    const { projectKey, expand } = params;
-    const project = await this.request("GET", `/project/${projectKey}`, {
-      query: {
-        expand: expand?.join(",")
-      }
-    });
-    return formatProjectResponse(project, this.config.siteUrl);
+  async getProjectRoles(params) {
+    const { projectKey } = params;
+    const rolesMap = await this.request("GET", `/project/${projectKey}/role`);
+    return formatProjectRoles(rolesMap);
   }
   /**
-   * List issue types for a project
+   * Get members (actors) for a specific project role.
+   * Returns the role details with a simplified list of user and group members.
    */
-  async listIssueTypes(params) {
-    const { projectKey } = params;
-    const project = await this.getProject({ projectKey, expand: ["issueTypes"] });
-    return project.issueTypes || [];
+  async getProjectRoleMembers(params) {
+    const { projectKey, roleId } = params;
+    const role = await this.request("GET", `/project/${projectKey}/role/${roleId}`);
+    return formatProjectRoleMembers(role);
   }
   /**
-   * Add comment to an issue
+   * Get all project members grouped by role.
+   * Convenience method that fetches all roles then all members for each role.
+   * Deduplicates users who appear in multiple roles.
    */
-  async addComment(params) {
-    const { issueKey, body } = params;
-    const comment = await this.request("POST", `/issue/${issueKey}/comment`, {
-      body: {
-        body: {
-          type: "doc",
-          version: 1,
-          content: [
-            {
-              type: "paragraph",
-              content: [{ type: "text", text: body }]
-            }
-          ]
+  async getAllProjectMembers(params) {
+    const { projectKey } = params;
+    const roles = await this.getProjectRoles({ projectKey });
+    const roleDetails = await Promise.all(roles.map((role) => this.getProjectRoleMembers({ projectKey, roleId: role.id })));
+    const memberMap = /* @__PURE__ */ new Map();
+    for (const role of roleDetails) {
+      for (const member of role.members) {
+        const key = member.accountId || member.groupName || member.displayName;
+        const existing = memberMap.get(key);
+        if (existing) {
+          existing.roles.push(role.name);
+        } else {
+          memberMap.set(key, { ...member, roles: [role.name] });
         }
       }
-    });
-    return formatComment(comment);
+    }
+    return {
+      projectKey,
+      roles: roleDetails.map((r) => ({
+        name: r.name,
+        id: r.id,
+        members: r.members
+      })),
+      allMembers: Array.from(memberMap.values())
+    };
   }
+  // ============================================================================
+  // Attachment Operations
+  // ============================================================================
   /**
-   * Get available transitions for an issue
+   * List all attachments for an issue
    */
-  async getTransitions(params) {
+  async listAttachments(params) {
     const { issueKey } = params;
-    const result = await this.request("GET", `/issue/${issueKey}/transitions`);
-    return formatTransitions(result);
+    if (!isValidIssueKey(issueKey)) {
+      throw new Error(`Invalid issue key format: ${issueKey}. Expected format: PROJECT-123`);
+    }
+    const issue = await this.request("GET", `/issue/${issueKey}`, {
+      query: { fields: "attachment" }
+    });
+    const attachments = issue.fields?.attachment || [];
+    return attachments.map((att) => ({
+      id: att.id,
+      self: att.self,
+      filename: att.filename,
+      author: att.author,
+      created: att.created,
+      size: att.size,
+      mimeType: att.mimeType,
+      content: att.content,
+      thumbnail: att.thumbnail
+    }));
   }
   /**
-   * Transition issue to a new status
+   * Upload an attachment to an issue.
+   * Jira requires multipart/form-data with X-Atlassian-Token: no-check header.
+   *
+   * @param params.issueKey - The issue key (e.g., PROJ-123)
+   * @param params.filename - Name for the uploaded file
+   * @param params.content - Base64-encoded file content
+   * @param params.mimeType - MIME type (auto-detected if omitted)
    */
-  async transitionIssue(params) {
-    const { issueKey, transitionId } = params;
-    await this.request("POST", `/issue/${issueKey}/transitions`, {
-      body: {
-        transition: { id: transitionId }
-      }
+  async uploadAttachment(params) {
+    const { issueKey, filename, content, mimeType } = params;
+    if (!isValidIssueKey(issueKey)) {
+      throw new Error(`Invalid issue key format: ${issueKey}. Expected format: PROJECT-123`);
+    }
+    const binaryContent = Buffer.from(content, "base64");
+    if (binaryContent.length > JIRA_MAX_ATTACHMENT_SIZE) {
+      throw new Error(`File size (${Math.round(binaryContent.length / 1024 / 1024)}MB) exceeds maximum allowed size (${JIRA_MAX_ATTACHMENT_SIZE / 1024 / 1024}MB)`);
+    }
+    const detectedMimeType = mimeType || detectMimeType(filename);
+    const formData = new FormData();
+    const blob = new Blob([binaryContent], { type: detectedMimeType });
+    formData.append("file", blob, filename);
+    const url = `${this.config.apiBaseUrl}/issue/${issueKey}/attachments`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        Authorization: this.config.authHeader,
+        Accept: "application/json",
+        "X-Atlassian-Token": "no-check"
+        // Required for attachment uploads
+      },
+      body: formData
     });
-    const result = { issueKey, transitionId };
-    return formatTransitionResult(result, this.config.siteUrl);
+    if (!response.ok) {
+      const errorBody = await response.text();
+      if (response.status === 413) {
+        throw new Error(`File too large: The attachment exceeds Jira's maximum file size limit.`);
+      }
+      throw new Error(`Jira attachment upload error (${response.status}): ${errorBody}`);
+    }
+    const result = await response.json();
+    return result;
   }
   /**
-   * Assign issue to a user
+   * Download an attachment by ID.
+   * Returns the file content as base64-encoded string.
    */
-  async assignIssue(params) {
-    const { issueKey, accountId } = params;
-    await this.request("PUT", `/issue/${issueKey}/assignee`, {
-      body: { accountId }
+  async downloadAttachment(params) {
+    const { attachmentId } = params;
+    const metadata = await this.request("GET", `/attachment/${attachmentId}`);
+    if (!metadata.content) {
+      throw new Error(`Attachment ${attachmentId} has no download URL`);
+    }
+    const response = await fetch(metadata.content, {
+      method: "GET",
+      headers: {
+        Authorization: this.config.authHeader
+      }
     });
+    if (!response.ok) {
+      throw new Error(`Failed to download attachment (${response.status}): ${response.statusText}`);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    const content = Buffer.from(arrayBuffer).toString("base64");
+    return {
+      filename: metadata.filename,
+      mimeType: metadata.mimeType,
+      size: metadata.size,
+      content
+    };
   }
   /**
-   * Delete an issue
+   * Delete an attachment by ID.
    */
-  async deleteIssue(params) {
-    const { issueKey } = params;
-    if (!issueKey) {
-      throw new Error("issueKey is required to delete an issue.");
-    }
-    await this.request("DELETE", `/issue/${issueKey}`);
+  async deleteAttachment(params) {
+    const { attachmentId } = params;
+    await this.request("DELETE", `/attachment/${attachmentId}`);
   }
+  // ============================================================================
+  // Agile API Access (Jira Software - Boards, Sprints)
+  // ============================================================================
+  _agileApi = null;
   /**
-   * Get current user information
+   * Get the Agile API client for board and sprint operations.
+   * Lazily instantiated on first access.
    */
-  async getCurrentUser() {
-    const user = await this.request("GET", "/myself");
-    return formatUser(user);
+  get agile() {
+    if (!this._agileApi) {
+      this._agileApi = new AgileApi(this.config);
+    }
+    return this._agileApi;
   }
-  /**
-   * Search for users by query string (name, email, username)
-   */
-  async searchUsers(params) {
-    const { query, maxResults = 50 } = params;
-    const users = await this.request("GET", "/user/search", {
-      query: {
-        query,
-        maxResults
+};
+
+// ../../b4m-core/packages/common/dist/src/jira/webhook/format.js
+function daysUntil(dateString) {
+  const expirationDate = new Date(dateString);
+  const now = /* @__PURE__ */ new Date();
+  const diffMs = expirationDate.getTime() - now.getTime();
+  return Math.ceil(diffMs / (1e3 * 60 * 60 * 24));
+}
+function formatWebhook(webhook) {
+  const daysUntilExpiry = daysUntil(webhook.expirationDate);
+  return {
+    id: webhook.id,
+    events: webhook.events,
+    jqlFilter: webhook.jqlFilter,
+    expirationDate: webhook.expirationDate,
+    daysUntilExpiry,
+    isExpiringSoon: daysUntilExpiry < 7
+  };
+}
+function formatWebhookList(response) {
+  return {
+    webhooks: response.values.map(formatWebhook),
+    total: response.total,
+    hasMore: !response.isLast
+  };
+}
+function extractAdfText(body, maxLength = 500) {
+  if (!body || typeof body !== "object")
+    return "";
+  const doc = body;
+  if (doc.type !== "doc" || !Array.isArray(doc.content))
+    return "";
+  const parts = [];
+  let totalLength = 0;
+  function walk(nodes) {
+    for (const node of nodes) {
+      if (totalLength >= maxLength)
+        return;
+      if (!node || typeof node !== "object")
+        continue;
+      const n = node;
+      if (n.type === "text" && typeof n.text === "string") {
+        const remaining = maxLength - totalLength;
+        const text = n.text.slice(0, remaining);
+        parts.push(text);
+        totalLength += text.length;
+      }
+      if (Array.isArray(n.content)) {
+        walk(n.content);
       }
-    });
-    return formatUserList(users);
-  }
-  /**
-   * Bulk create multiple issues in a single API call.
-   * Supports up to 50 issues per request (Jira API limit).
-   * Ideal for creating multiple subtasks under a parent issue.
-   */
-  async bulkCreateIssues(params) {
-    const { issues } = params;
-    if (issues.length === 0) {
-      return { issues: [], errors: [] };
     }
-    if (issues.length > 50) {
-      throw new Error("Bulk create is limited to 50 issues per request. Please split your request.");
+  }
+  walk(doc.content);
+  const result = parts.join("");
+  if (totalLength >= maxLength)
+    return result + "...";
+  return result;
+}
+function escapeSlackMrkdwn(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/\*/g, "\u2217").replace(/_/g, "\uFF3F").replace(/~/g, "\u223C").replace(/`/g, "\u02CB");
+}
+var PRIORITY_EMOJI = {
+  Highest: ":red_circle:",
+  High: ":large_orange_circle:",
+  Medium: ":large_yellow_circle:",
+  Low: ":large_green_circle:",
+  Lowest: ":white_circle:"
+};
+function getPriorityEmoji(priority) {
+  if (!priority)
+    return "";
+  return PRIORITY_EMOJI[priority] || ":blue_circle:";
+}
+function formatIssueEventForSlack(event, siteUrl) {
+  const { issue, webhookEvent, user, changelog } = event;
+  const { fields } = issue;
+  const priorityEmoji = getPriorityEmoji(fields.priority?.name);
+  const issueUrl = `${siteUrl}/browse/${issue.key}`;
+  let action;
+  let emoji;
+  switch (webhookEvent) {
+    case "jira:issue_created":
+      action = "created";
+      emoji = ":new:";
+      break;
+    case "jira:issue_updated":
+      action = "updated";
+      emoji = ":pencil2:";
+      break;
+    case "jira:issue_deleted":
+      action = "deleted";
+      emoji = ":wastebasket:";
+      break;
+    default:
+      action = "changed";
+      emoji = ":bell:";
+  }
+  let changelogText = "";
+  if (changelog?.items && changelog.items.length > 0) {
+    const changes = changelog.items.slice(0, 3).map((item) => {
+      const from = escapeSlackMrkdwn(item.fromString || "None");
+      const to = escapeSlackMrkdwn(item.toString || "None");
+      if (item.field === "status") {
+        return `Status: ${from} \u2192 ${to}`;
+      }
+      if (item.field === "assignee") {
+        return `Assignee: ${escapeSlackMrkdwn(item.fromString || "Unassigned")} \u2192 ${escapeSlackMrkdwn(item.toString || "Unassigned")}`;
+      }
+      if (item.field === "priority") {
+        return `Priority: ${from} \u2192 ${to}`;
+      }
+      return `${escapeSlackMrkdwn(item.field)}: ${from} \u2192 ${to}`;
+    });
+    if (changes.length > 0) {
+      changelogText = "\n" + changes.map((c) => `\u2022 ${c}`).join("\n");
+      if (changelog.items.length > 3) {
+        changelogText += `
+_...and ${changelog.items.length - 3} more changes_`;
+      }
     }
-    const issueUpdates = issues.map((issue) => {
-      const { projectKey, summary, description, issueTypeName, assignee, labels, parentKey } = issue;
-      const fields = {
-        project: { key: projectKey },
-        summary,
-        issuetype: { name: issueTypeName }
-      };
-      if (description) {
-        if (containsWikiTable(description)) {
-          console.log("[JIRA-ADF] Converting wiki table to ADF (bulk)", { length: description.length });
-          fields.description = wikiMarkupToAdf(description);
-        } else {
-          fields.description = {
-            type: "doc",
-            version: 1,
-            content: [
-              {
-                type: "paragraph",
-                content: [{ type: "text", text: description }]
-              }
-            ]
-          };
-        }
+  }
+  const blocks = [
+    {
+      type: "header",
+      text: {
+        type: "plain_text",
+        text: `${emoji} Issue ${action}: ${escapeSlackMrkdwn(issue.key)}`,
+        emoji: true
       }
-      if (assignee) {
-        fields.assignee = { id: assignee };
+    },
+    {
+      type: "section",
+      text: {
+        type: "mrkdwn",
+        text: `*<${issueUrl}|${escapeSlackMrkdwn(issue.key)}>* ${escapeSlackMrkdwn(fields.summary)}`
       }
-      if (labels && labels.length > 0) {
-        fields.labels = labels;
+    },
+    {
+      type: "section",
+      text: {
+        type: "mrkdwn",
+        text: [
+          `${priorityEmoji} *Priority:* ${escapeSlackMrkdwn(fields.priority?.name || "None")}`,
+          `*Status:* ${escapeSlackMrkdwn(fields.status.name)}`,
+          `*Type:* ${escapeSlackMrkdwn(fields.issuetype.name)}`,
+          `*Assignee:* ${escapeSlackMrkdwn(fields.assignee?.displayName || "Unassigned")}`
+        ].join("  |  ")
       }
-      if (parentKey) {
-        fields.parent = { key: parentKey };
+    }
+  ];
+  if (changelogText) {
+    blocks.push({
+      type: "section",
+      text: {
+        type: "mrkdwn",
+        text: `*Changes:*${changelogText}`
       }
-      return { update: {}, fields };
-    });
-    const result = await this.request("POST", "/issue/bulk", {
-      body: { issueUpdates }
     });
-    const formattedIssues = (result.issues || []).map((issue) => formatIssueResponse(issue, this.config.siteUrl));
-    const formattedErrors = (result.errors || []).map((error) => ({
-      status: error.status,
-      message: Object.values(error.elementErrors?.errors || {}).join(", ") || "Unknown error",
-      failedElementNumber: error.failedElementNumber
-    }));
-    return {
-      issues: formattedIssues,
-      errors: formattedErrors
-    };
   }
-  /**
-   * Bulk transition multiple issues to new statuses in a single API call.
-   * Uses the Jira Cloud Bulk Transition API.
-   * Supports up to 1000 issues per request.
-   *
-   * Note: This is an async operation - returns a task ID for tracking progress.
-   */
-  async bulkTransitionIssues(params) {
-    const { issues } = params;
-    console.error(`[Jira] bulkTransitionIssues called with ${issues.length} issue(s)`);
-    if (issues.length === 0) {
-      console.error("[Jira] bulkTransitionIssues: No issues provided, returning early");
-      return { taskId: "", message: "No issues to transition", issueCount: 0 };
+  blocks.push({
+    type: "context",
+    elements: [
+      {
+        type: "mrkdwn",
+        text: `${escapeSlackMrkdwn(user?.displayName || "Someone")} \u2022 ${escapeSlackMrkdwn(fields.project.name)} (${escapeSlackMrkdwn(fields.project.key)})`
+      }
+    ]
+  });
+  blocks.push({
+    type: "actions",
+    elements: [
+      {
+        type: "button",
+        text: {
+          type: "plain_text",
+          text: "View in Jira",
+          emoji: true
+        },
+        url: issueUrl,
+        style: "primary"
+      }
+    ]
+  });
+  return {
+    blocks,
+    text: `${emoji} ${escapeSlackMrkdwn(issue.key)} ${action}: ${escapeSlackMrkdwn(fields.summary)}`
+  };
+}
+function formatCommentEventForSlack(event, siteUrl) {
+  const { issue, comment, webhookEvent } = event;
+  const issueUrl = `${siteUrl}/browse/${issue.key}`;
+  let action;
+  let emoji;
+  switch (webhookEvent) {
+    case "comment_created":
+      action = "commented on";
+      emoji = ":speech_balloon:";
+      break;
+    case "comment_updated":
+      action = "updated comment on";
+      emoji = ":pencil:";
+      break;
+    case "comment_deleted":
+      action = "deleted comment on";
+      emoji = ":x:";
+      break;
+    default:
+      action = "commented on";
+      emoji = ":speech_balloon:";
+  }
+  const blocks = [
+    {
+      type: "header",
+      text: {
+        type: "plain_text",
+        text: `${emoji} ${escapeSlackMrkdwn(comment.author.displayName)} ${action} ${escapeSlackMrkdwn(issue.key)}`,
+        emoji: true
+      }
+    },
+    {
+      type: "section",
+      text: {
+        type: "mrkdwn",
+        text: `*<${issueUrl}|${escapeSlackMrkdwn(issue.key)}>* ${escapeSlackMrkdwn(issue.fields.summary)}`
+      }
     }
-    if (issues.length > 1e3) {
-      console.error(`[Jira] bulkTransitionIssues: Exceeded 1000 issue limit (${issues.length})`);
-      throw new Error("Bulk transition is limited to 1000 issues per request. Please split your request.");
+  ];
+  if (webhookEvent !== "comment_deleted") {
+    const bodyText = extractAdfText(comment.body);
+    if (bodyText) {
+      blocks.push({
+        type: "section",
+        text: {
+          type: "mrkdwn",
+          text: `> ${escapeSlackMrkdwn(bodyText).replace(/\n/g, "\n> ")}`
+        }
+      });
     }
-    const transitionGroups = {};
-    for (const issue of issues) {
-      if (!transitionGroups[issue.transitionId]) {
-        transitionGroups[issue.transitionId] = [];
+  }
+  blocks.push({
+    type: "context",
+    elements: [
+      {
+        type: "mrkdwn",
+        text: `${escapeSlackMrkdwn(issue.fields.project.name)} \u2022 ${escapeSlackMrkdwn(issue.fields.issuetype.name)}`
+      }
+    ]
+  }, {
+    type: "actions",
+    elements: [
+      {
+        type: "button",
+        text: {
+          type: "plain_text",
+          text: "View in Jira",
+          emoji: true
+        },
+        url: issueUrl,
+        style: "primary"
+      }
+    ]
+  });
+  return {
+    blocks,
+    text: `${emoji} ${escapeSlackMrkdwn(comment.author.displayName)} ${action} ${escapeSlackMrkdwn(issue.key)}: ${escapeSlackMrkdwn(issue.fields.summary)}`
+  };
+}
+function formatSprintEventForSlack(event, siteUrl) {
+  const { sprint, webhookEvent, user } = event;
+  let action;
+  let emoji;
+  switch (webhookEvent) {
+    case "sprint_created":
+      action = "created";
+      emoji = ":calendar:";
+      break;
+    case "sprint_started":
+      action = "started";
+      emoji = ":rocket:";
+      break;
+    case "sprint_closed":
+      action = "completed";
+      emoji = ":checkered_flag:";
+      break;
+    case "sprint_updated":
+      action = "updated";
+      emoji = ":pencil2:";
+      break;
+    case "sprint_deleted":
+      action = "deleted";
+      emoji = ":wastebasket:";
+      break;
+    default:
+      action = "changed";
+      emoji = ":bell:";
+  }
+  const sprintUrl = `${siteUrl}/secure/RapidBoard.jspa?rapidView=${sprint.originBoardId}`;
+  const blocks = [
+    {
+      type: "header",
+      text: {
+        type: "plain_text",
+        text: `${emoji} Sprint ${action}: ${escapeSlackMrkdwn(sprint.name)}`,
+        emoji: true
+      }
+    },
+    {
+      type: "section",
+      text: {
+        type: "mrkdwn",
+        text: [
+          `*State:* ${escapeSlackMrkdwn(sprint.state)}`,
+          sprint.startDate ? `*Start:* ${new Date(sprint.startDate).toLocaleDateString()}` : "",
+          sprint.endDate ? `*End:* ${new Date(sprint.endDate).toLocaleDateString()}` : ""
+        ].filter(Boolean).join("  |  ")
       }
-      transitionGroups[issue.transitionId].push(issue.issueIdOrKey);
     }
-    const bulkTransitionInputs = Object.entries(transitionGroups).map(([transitionId, selectedIssueIdsOrKeys]) => ({
-      selectedIssueIdsOrKeys,
-      transitionId
-    }));
-    console.error(`[Jira] bulkTransitionIssues: Grouped into ${bulkTransitionInputs.length} transition group(s)`);
-    const result = await this.request("POST", "/bulk/issues/transition", {
-      body: { bulkTransitionInputs }
+  ];
+  if (sprint.goal) {
+    blocks.push({
+      type: "section",
+      text: {
+        type: "mrkdwn",
+        text: `*Goal:* ${escapeSlackMrkdwn(sprint.goal)}`
+      }
     });
-    console.error(`[Jira] bulkTransitionIssues: Task created with ID ${result.taskId}`);
-    return {
-      taskId: result.taskId,
-      message: `Bulk transition started for ${issues.length} issue(s).`,
-      issueCount: issues.length
-    };
   }
-  /**
-   * Bulk update labels on multiple issues in a single API call.
-   * Uses the Jira Cloud Bulk Edit API.
-   * Supports up to 1000 issues per request.
-   *
-   * Note: This is an async operation - returns a task ID for tracking progress.
-   *
-   * Why only labels? Jira's Bulk Edit API has significant limitations:
-   * - Summary, description, assignee fields are NOT supported for bulk editing
-   * - Priority and issueType require IDs and have inconsistent behavior
-   * - Labels is the most reliable and commonly used bulk operation
-   * See: https://community.atlassian.com/forums/Jira-questions/Bulk-Change-Description-Field/qaq-p/897762
-   */
-  async bulkUpdateIssues(params) {
-    const { issueIdsOrKeys, labels } = params;
-    console.error(`[Jira] bulkUpdateIssues called with ${issueIdsOrKeys.length} issue(s), action: ${labels.action}`);
-    if (issueIdsOrKeys.length === 0) {
-      console.error("[Jira] bulkUpdateIssues: No issues provided, returning early");
-      return { taskId: "", message: "No issues to update", issueCount: 0 };
-    }
-    if (issueIdsOrKeys.length > 1e3) {
-      console.error(`[Jira] bulkUpdateIssues: Exceeded 1000 issue limit (${issueIdsOrKeys.length})`);
-      throw new Error("Bulk update is limited to 1000 issues per request. Please split your request.");
+  blocks.push({
+    type: "context",
+    elements: [
+      {
+        type: "mrkdwn",
+        text: user?.displayName ? escapeSlackMrkdwn(user.displayName) : "System"
+      }
+    ]
+  });
+  blocks.push({
+    type: "actions",
+    elements: [
+      {
+        type: "button",
+        text: {
+          type: "plain_text",
+          text: "View Board",
+          emoji: true
+        },
+        url: sprintUrl,
+        style: "primary"
+      }
+    ]
+  });
+  return {
+    blocks,
+    text: `${emoji} Sprint ${action}: ${escapeSlackMrkdwn(sprint.name)}`
+  };
+}
+function formatGenericEventForSlack(eventType, payload, siteUrl) {
+  const issue = payload.issue;
+  const user = payload.user;
+  const issueLink = payload.issueLink;
+  const changelog = payload.changelog;
+  const project = payload.project ?? issue?.fields?.project;
+  const version = payload.version;
+  const worklog = payload.worklog;
+  const board = payload.board;
+  const readableEvent = eventType.replace(/^jira:/, "").replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+  const blocks = [
+    {
+      type: "header",
+      text: {
+        type: "plain_text",
+        text: `:bell: ${readableEvent}`,
+        emoji: true
+      }
     }
-    const selectedActions = ["labels"];
-    const editedFieldsInput = {
-      labelsFields: [
-        {
-          fieldId: "labels",
-          labels: labels.values.map((name) => ({ name })),
-          bulkEditMultiSelectFieldOption: labels.action
-        }
-      ]
-    };
-    console.error(`[Jira] bulkUpdateIssues: Updating labels [${labels.values.join(", ")}] with action ${labels.action}`);
-    const result = await this.request("POST", "/bulk/issues/fields", {
-      body: {
-        selectedActions,
-        selectedIssueIdsOrKeys: issueIdsOrKeys,
-        editedFieldsInput
+  ];
+  const details = [];
+  if (issue?.key) {
+    const issueUrl = `${siteUrl}/browse/${issue.key}`;
+    blocks.push({
+      type: "section",
+      text: {
+        type: "mrkdwn",
+        text: `*<${issueUrl}|${escapeSlackMrkdwn(issue.key)}>* ${escapeSlackMrkdwn(issue.fields?.summary || "")}`
       }
     });
-    console.error(`[Jira] bulkUpdateIssues: Task created with ID ${result.taskId}`);
-    return {
-      taskId: result.taskId,
-      message: `Bulk label update started for ${issueIdsOrKeys.length} issue(s). Action: ${labels.action}.`,
-      issueCount: issueIdsOrKeys.length
-    };
+    const meta = [];
+    if (issue.fields?.status?.name)
+      meta.push(`*Status:* ${escapeSlackMrkdwn(issue.fields.status.name)}`);
+    if (issue.fields?.issuetype?.name)
+      meta.push(`*Type:* ${escapeSlackMrkdwn(issue.fields.issuetype.name)}`);
+    if (issue.fields?.priority?.name) {
+      const emoji = getPriorityEmoji(issue.fields.priority.name);
+      meta.push(`${emoji} *Priority:* ${escapeSlackMrkdwn(issue.fields.priority.name)}`);
+    }
+    if (issue.fields?.assignee?.displayName)
+      meta.push(`*Assignee:* ${escapeSlackMrkdwn(issue.fields.assignee.displayName)}`);
+    if (meta.length > 0)
+      details.push(meta.join("  |  "));
   }
-  /**
-   * Get watchers for an issue
-   */
-  async getWatchers(params) {
-    const { issueKey } = params;
-    const result = await this.request("GET", `/issue/${issueKey}/watchers`);
-    return formatWatchers(result);
+  if (issueLink?.issueLinkType) {
+    const linkType = issueLink.issueLinkType;
+    const linkDesc = escapeSlackMrkdwn(linkType.outwardName || linkType.name || "linked");
+    details.push(`*Link type:* ${linkDesc}`);
+    if (issueLink.sourceIssueId)
+      details.push(`*Source issue ID:* ${issueLink.sourceIssueId}`);
+    if (issueLink.destinationIssueId)
+      details.push(`*Destination issue ID:* ${issueLink.destinationIssueId}`);
   }
-  /**
-   * Add a watcher to an issue
-   */
-  async addWatcher(params) {
-    const { issueKey, accountId } = params;
-    await this.request("POST", `/issue/${issueKey}/watchers`, {
-      body: accountId
-    });
+  if (version?.name) {
+    const versionParts = [`*Version:* ${escapeSlackMrkdwn(version.name)}`];
+    if (version.description)
+      versionParts.push(escapeSlackMrkdwn(version.description));
+    if (version.released !== void 0)
+      versionParts.push(version.released ? ":white_check_mark: Released" : "Unreleased");
+    details.push(versionParts.join("  |  "));
   }
-  /**
-   * Remove a watcher from an issue
-   */
-  async removeWatcher(params) {
-    const { issueKey, accountId } = params;
-    await this.request("DELETE", `/issue/${issueKey}/watchers`, {
-      query: { accountId }
-    });
+  if (worklog) {
+    const wlParts = [];
+    if (worklog.author?.displayName)
+      wlParts.push(`*By:* ${escapeSlackMrkdwn(worklog.author.displayName)}`);
+    if (worklog.timeSpent)
+      wlParts.push(`*Time:* ${escapeSlackMrkdwn(worklog.timeSpent)}`);
+    if (wlParts.length > 0)
+      details.push(wlParts.join("  |  "));
   }
-  // ============================================================================
-  // Issue Link Operations
-  // ============================================================================
-  /**
-   * Get all available issue link types in the Jira instance
-   */
-  async getIssueLinkTypes() {
-    const result = await this.request("GET", "/issueLinkType");
-    return formatIssueLinkTypes(result);
+  if (board?.name) {
+    details.push(`*Board:* ${escapeSlackMrkdwn(board.name)}`);
   }
-  /**
-   * Get all issue links for a specific issue
-   */
-  async getIssueLinks(params) {
-    const { issueKey } = params;
-    if (!isValidIssueKey(issueKey)) {
-      throw new Error(`Invalid issue key format: ${issueKey}. Expected format: PROJECT-123`);
+  if (changelog?.items && changelog.items.length > 0) {
+    const changes = changelog.items.slice(0, 3).map((item) => `\u2022 ${escapeSlackMrkdwn(item.field || "")}: ${escapeSlackMrkdwn(item.fromString || "None")} \u2192 ${escapeSlackMrkdwn(item.toString || "None")}`);
+    if (changelog.items.length > 3) {
+      changes.push(`_...and ${changelog.items.length - 3} more_`);
     }
-    const issue = await this.request("GET", `/issue/${issueKey}`, {
-      query: { fields: "issuelinks" }
-    });
-    return formatIssueLinks(issue.fields?.issuelinks || [], this.config.siteUrl);
+    details.push(`*Changes:*
+${changes.join("\n")}`);
   }
-  /**
-   * Create a link between two issues.
-   * Uses intuitive sourceIssue/targetIssue terminology:
-   * - sourceIssue: The issue doing the action (e.g., PROJ-1 in "PROJ-1 blocks PROJ-2")
-   * - targetIssue: The issue being acted upon (e.g., PROJ-2 in "PROJ-1 blocks PROJ-2")
-   *
-   * This maps to Jira's API as: sourceIssue → outwardIssue, targetIssue → inwardIssue
-   *
-   * @returns void - Jira returns 201 with no body on success
-   */
-  async createIssueLink(params) {
-    const { linkType, sourceIssue, targetIssue } = params;
-    if (!isValidIssueKey(sourceIssue)) {
-      throw new Error(`Invalid source issue key format: ${sourceIssue}. Expected format: PROJECT-123`);
-    }
-    if (!isValidIssueKey(targetIssue)) {
-      throw new Error(`Invalid target issue key format: ${targetIssue}. Expected format: PROJECT-123`);
-    }
-    const linkTypes = await this.getIssueLinkTypes();
-    const matchedType = linkTypes.find((t) => t.name.toLowerCase() === linkType.toLowerCase());
-    if (!matchedType) {
-      const availableTypes = linkTypes.map((t) => t.name).join(", ");
-      throw new Error(`Invalid link type: "${linkType}". Available types: ${availableTypes}`);
-    }
-    await this.request("POST", "/issueLink", {
-      body: {
-        type: { name: matchedType.name },
-        outwardIssue: { key: sourceIssue },
-        inwardIssue: { key: targetIssue }
+  if (details.length > 0) {
+    blocks.push({
+      type: "section",
+      text: {
+        type: "mrkdwn",
+        text: details.join("\n")
       }
     });
   }
-  /**
-   * Delete an issue link by its ID
-   */
-  async deleteIssueLink(params) {
-    const { linkId } = params;
-    await this.request("DELETE", `/issueLink/${linkId}`);
+  const contextParts = [];
+  if (user?.displayName)
+    contextParts.push(escapeSlackMrkdwn(user.displayName));
+  if (project?.name)
+    contextParts.push(`${escapeSlackMrkdwn(project.name)}${project.key ? ` (${escapeSlackMrkdwn(project.key)})` : ""}`);
+  if (contextParts.length > 0) {
+    blocks.push({
+      type: "context",
+      elements: [{ type: "mrkdwn", text: contextParts.join(" \u2022 ") }]
+    });
   }
-  /**
-   * Find a specific issue link between two issues by their keys and link type.
-   * Searches bidirectionally - works regardless of which issue key is provided first.
-   *
-   * @returns The link ID if found, null if no matching link exists
-   */
-  async findIssueLink(params) {
-    const { issueKey, linkedIssueKey, linkType } = params;
-    if (!isValidIssueKey(issueKey)) {
-      throw new Error(`Invalid issue key format: ${issueKey}. Expected format: PROJECT-123`);
-    }
-    if (!isValidIssueKey(linkedIssueKey)) {
-      throw new Error(`Invalid linked issue key format: ${linkedIssueKey}. Expected format: PROJECT-123`);
-    }
-    const links = await this.getIssueLinks({ issueKey });
-    const linkTypeLower = linkType.toLowerCase();
-    for (const link of links) {
-      if (link.type.name.toLowerCase() !== linkTypeLower) {
-        continue;
-      }
-      const outwardKey = link.outwardIssue?.key;
-      const inwardKey = link.inwardIssue?.key;
-      if (outwardKey === linkedIssueKey || inwardKey === linkedIssueKey) {
-        return link.id;
-      }
-    }
-    return null;
+  if (issue?.key) {
+    const issueUrl = `${siteUrl}/browse/${issue.key}`;
+    blocks.push({
+      type: "actions",
+      elements: [
+        {
+          type: "button",
+          text: { type: "plain_text", text: "View in Jira", emoji: true },
+          url: issueUrl,
+          style: "primary"
+        }
+      ]
+    });
   }
-  // ============================================================================
-  // Project Role & Member Operations
-  // ============================================================================
-  /**
-   * Get all project roles for a project.
-   * Returns a list of roles with their IDs.
-   */
-  async getProjectRoles(params) {
-    const { projectKey } = params;
-    const rolesMap = await this.request("GET", `/project/${projectKey}/role`);
-    return formatProjectRoles(rolesMap);
+  const summary = issue?.key ? `${escapeSlackMrkdwn(issue.key)}: ${escapeSlackMrkdwn(issue.fields?.summary || readableEvent)}` : readableEvent;
+  return {
+    blocks,
+    text: `:bell: ${summary}`
+  };
+}
+
+// ../../b4m-core/packages/common/dist/src/jira/webhook/api.js
+var WebhookApi = class {
+  config;
+  constructor(config) {
+    this.config = config;
   }
   /**
-   * Get members (actors) for a specific project role.
-   * Returns the role details with a simplified list of user and group members.
+   * Build URL for webhook API endpoints.
+   *
+   * Note: Webhooks use a different base URL than other Jira APIs.
    */
-  async getProjectRoleMembers(params) {
-    const { projectKey, roleId } = params;
-    const role = await this.request("GET", `/project/${projectKey}/role/${roleId}`);
-    return formatProjectRoleMembers(role);
+  buildUrl(path, query = {}) {
+    const url = new URL(`${this.config.apiBaseUrl}${path}`);
+    for (const [key, value] of Object.entries(query)) {
+      if (value !== void 0) {
+        url.searchParams.append(key, String(value));
+      }
+    }
+    return url.toString();
   }
   /**
-   * Get all project members grouped by role.
-   * Convenience method that fetches all roles then all members for each role.
-   * Deduplicates users who appear in multiple roles.
+   * Make an authenticated request to the Jira Webhook API.
    */
-  async getAllProjectMembers(params) {
-    const { projectKey } = params;
-    const roles = await this.getProjectRoles({ projectKey });
-    const roleDetails = await Promise.all(roles.map((role) => this.getProjectRoleMembers({ projectKey, roleId: role.id })));
-    const memberMap = /* @__PURE__ */ new Map();
-    for (const role of roleDetails) {
-      for (const member of role.members) {
-        const key = member.accountId || member.groupName || member.displayName;
-        const existing = memberMap.get(key);
-        if (existing) {
-          existing.roles.push(role.name);
-        } else {
-          memberMap.set(key, { ...member, roles: [role.name] });
-        }
-      }
-    }
-    return {
-      projectKey,
-      roles: roleDetails.map((r) => ({
-        name: r.name,
-        id: r.id,
-        members: r.members
-      })),
-      allMembers: Array.from(memberMap.values())
+  async request(method, path, options = {}) {
+    const url = this.buildUrl(path, options.query);
+    const headers = {
+      Authorization: this.config.authHeader,
+      Accept: "application/json",
+      "Content-Type": "application/json"
     };
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: options.body ? JSON.stringify(options.body) : void 0
+    });
+    if (!response.ok) {
+      const errorBody = await response.text();
+      throw new Error(`Jira Webhook API error (${response.status}): ${errorBody}`);
+    }
+    if (response.status === 204) {
+      return {};
+    }
+    const data = await response.json();
+    return data;
   }
   // ============================================================================
-  // Attachment Operations
+  // Webhook CRUD Operations
   // ============================================================================
   /**
-   * List all attachments for an issue
+   * List all webhooks registered by this OAuth app.
+   *
+   * @param startAt - Pagination start index (default: 0)
+   * @param maxResults - Max results per page (default: 50, max: 100)
    */
-  async listAttachments(params) {
-    const { issueKey } = params;
-    if (!isValidIssueKey(issueKey)) {
-      throw new Error(`Invalid issue key format: ${issueKey}. Expected format: PROJECT-123`);
-    }
-    const issue = await this.request("GET", `/issue/${issueKey}`, {
-      query: { fields: "attachment" }
+  async listWebhooks(params = {}) {
+    const { startAt = 0, maxResults = 50 } = params;
+    const response = await this.request("GET", "/webhook", {
+      query: { startAt, maxResults }
     });
-    const attachments = issue.fields?.attachment || [];
-    return attachments.map((att) => ({
-      id: att.id,
-      self: att.self,
-      filename: att.filename,
-      author: att.author,
-      created: att.created,
-      size: att.size,
-      mimeType: att.mimeType,
-      content: att.content,
-      thumbnail: att.thumbnail
-    }));
+    return formatWebhookList(response);
   }
   /**
-   * Upload an attachment to an issue.
-   * Jira requires multipart/form-data with X-Atlassian-Token: no-check header.
+   * Register a new webhook.
    *
-   * @param params.issueKey - The issue key (e.g., PROJ-123)
-   * @param params.filename - Name for the uploaded file
-   * @param params.content - Base64-encoded file content
-   * @param params.mimeType - MIME type (auto-detected if omitted)
+   * @param url - The URL where Jira will POST webhook events
+   * @param events - Events to subscribe to
+   * @param jqlFilter - Optional JQL filter (only matching issues trigger events)
+   * @returns The created webhook ID
    */
-  async uploadAttachment(params) {
-    const { issueKey, filename, content, mimeType } = params;
-    if (!isValidIssueKey(issueKey)) {
-      throw new Error(`Invalid issue key format: ${issueKey}. Expected format: PROJECT-123`);
-    }
-    const binaryContent = Buffer.from(content, "base64");
-    if (binaryContent.length > JIRA_MAX_ATTACHMENT_SIZE) {
-      throw new Error(`File size (${Math.round(binaryContent.length / 1024 / 1024)}MB) exceeds maximum allowed size (${JIRA_MAX_ATTACHMENT_SIZE / 1024 / 1024}MB)`);
-    }
-    const detectedMimeType = mimeType || detectMimeType(filename);
-    const formData = new FormData();
-    const blob = new Blob([binaryContent], { type: detectedMimeType });
-    formData.append("file", blob, filename);
-    const url = `${this.config.apiBaseUrl}/issue/${issueKey}/attachments`;
-    const response = await fetch(url, {
-      method: "POST",
-      headers: {
-        Authorization: this.config.authHeader,
-        Accept: "application/json",
-        "X-Atlassian-Token": "no-check"
-        // Required for attachment uploads
-      },
-      body: formData
+  async registerWebhook(params) {
+    const { url, events, jqlFilter } = params;
+    const webhook = {
+      // Jira webhook API requires jqlFilter but has limited operator support.
+      // "IS NOT EMPTY" and empty strings are rejected. Use a universally-true expression.
+      jqlFilter: jqlFilter || "project != null",
+      events
+    };
+    const body = {
+      url,
+      webhooks: [webhook]
+    };
+    const response = await this.request("POST", "/webhook", {
+      body
     });
-    if (!response.ok) {
-      const errorBody = await response.text();
-      if (response.status === 413) {
-        throw new Error(`File too large: The attachment exceeds Jira's maximum file size limit.`);
-      }
-      throw new Error(`Jira attachment upload error (${response.status}): ${errorBody}`);
+    console.log("[JIRA-WEBHOOK-API] registerWebhook raw response:", JSON.stringify(response, null, 2));
+    if (!response.webhookRegistrationResult || response.webhookRegistrationResult.length === 0) {
+      throw new Error("Failed to register webhook: No registration result returned");
     }
-    const result = await response.json();
-    return result;
-  }
-  /**
-   * Download an attachment by ID.
-   * Returns the file content as base64-encoded string.
-   */
-  async downloadAttachment(params) {
-    const { attachmentId } = params;
-    const metadata = await this.request("GET", `/attachment/${attachmentId}`);
-    if (!metadata.content) {
-      throw new Error(`Attachment ${attachmentId} has no download URL`);
+    const result = response.webhookRegistrationResult[0];
+    if (result.errors && result.errors.length > 0) {
+      throw new Error(`Failed to register webhook: ${result.errors.join(", ")}`);
     }
-    const response = await fetch(metadata.content, {
-      method: "GET",
-      headers: {
-        Authorization: this.config.authHeader
-      }
-    });
-    if (!response.ok) {
-      throw new Error(`Failed to download attachment (${response.status}): ${response.statusText}`);
+    if (result.createdWebhookId === void 0 || result.createdWebhookId === null) {
+      throw new Error(`Failed to register webhook: No webhook ID in response. Full result: ${JSON.stringify(result)}`);
     }
-    const arrayBuffer = await response.arrayBuffer();
-    const content = Buffer.from(arrayBuffer).toString("base64");
     return {
-      filename: metadata.filename,
-      mimeType: metadata.mimeType,
-      size: metadata.size,
-      content
+      webhookId: result.createdWebhookId
     };
   }
   /**
-   * Delete an attachment by ID.
+   * Refresh webhook expiration dates.
+   *
+   * Jira webhooks expire after 30 days. Call this to extend expiration.
+   *
+   * @param webhookIds - IDs of webhooks to refresh
+   * @returns New expiration date
    */
-  async deleteAttachment(params) {
-    const { attachmentId } = params;
-    await this.request("DELETE", `/attachment/${attachmentId}`);
+  async refreshWebhooks(params) {
+    const { webhookIds } = params;
+    const body = {
+      webhookIds
+    };
+    const response = await this.request("PUT", "/webhook/refresh", {
+      body
+    });
+    return {
+      expirationDate: response.expirationDate
+    };
   }
-  // ============================================================================
-  // Agile API Access (Jira Software - Boards, Sprints)
-  // ============================================================================
-  _agileApi = null;
   /**
-   * Get the Agile API client for board and sprint operations.
-   * Lazily instantiated on first access.
+   * Delete webhooks by ID.
+   *
+   * @param webhookIds - IDs of webhooks to delete
    */
-  get agile() {
-    if (!this._agileApi) {
-      this._agileApi = new AgileApi(this.config);
-    }
-    return this._agileApi;
+  async deleteWebhooks(params) {
+    const { webhookIds } = params;
+    const body = {
+      webhookIds
+    };
+    await this.request("DELETE", "/webhook", {
+      body
+    });
   }
-  // ============================================================================
-  // Webhook API Access (Webhook Management)
-  // ============================================================================
-  _webhookApi = null;
   /**
-   * Get the Webhook API client for webhook management operations.
-   * Lazily instantiated on first access.
+   * Get a specific webhook by ID.
+   *
+   * Note: Jira API doesn't have a direct "get by ID" endpoint,
+   * so we list and filter.
    */
-  get webhook() {
-    if (!this._webhookApi) {
-      this._webhookApi = new WebhookApi(this.config);
-    }
-    return this._webhookApi;
+  async getWebhook(params) {
+    const { webhookId } = params;
+    const response = await this.request("GET", "/webhook", {
+      query: { startAt: 0, maxResults: 100 }
+    });
+    const webhook = response.values.find((w) => w.id === webhookId);
+    return webhook || null;
   }
 };
 
@@ -11399,6 +11530,12 @@ export {
   CliCompletionDoneAction,
   CliCompletionErrorAction,
   CliToolResponseAction,
+  KeepCommandRequestAction,
+  KeepCommandAction,
+  KeepCommandResponseAction,
+  KeepCommandResultAction,
+  TavernSceneCommandRequestAction,
+  TavernSceneBroadcastAction,
   SessionCreatedAction,
   MessageDataToServer,
   MessageDataToClient,
@@ -11646,6 +11783,13 @@ export {
   formatProjectRoles,
   formatProjectRoleMembers,
   AgileApi,
+  JIRA_MAX_ATTACHMENT_SIZE,
+  JIRA_PROJECT_KEY_RE,
+  isValidProjectKey,
+  isValidIssueKey,
+  wikiMarkupToAdf,
+  containsWikiTable,
+  JiraApi,
   formatWebhook,
   formatWebhookList,
   extractAdfText,
@@ -11655,11 +11799,6 @@ export {
   formatSprintEventForSlack,
   formatGenericEventForSlack,
   WebhookApi,
-  JIRA_MAX_ATTACHMENT_SIZE,
-  isValidIssueKey,
-  wikiMarkupToAdf,
-  containsWikiTable,
-  JiraApi,
   isIssueWebhookEvent,
   isCommentWebhookEvent,
   isSprintWebhookEvent,