@hanhnd/agent-kit 1.0.12 → 1.0.13

package/dist/kit-server.js

@@ -20993,7 +20993,7 @@ var StdioServerTransport = class {
 import * as fs from "fs";
 import * as path from "path";
 
-// src/utils.ts
+// src/utils/utils.ts
 function getWorkspaceRoot() {
   return process.env.WORKSPACE_DIR || process.env.CLAUDE_WORKSPACE || process.env.GEMINI_WORKSPACE || process.env.INIT_CWD || process.env.PWD || process.cwd();
 }
@@ -21097,9 +21097,7 @@ function validatePath(filePath, baseDir = process.cwd()) {
     }
   }
   const fileName = path2.basename(resolved);
-  const isExactForbidden = FORBIDDEN_FILES.some(
-    (f) => fileName.toLowerCase() === f.toLowerCase()
-  );
+  const isExactForbidden = FORBIDDEN_FILES.some((f) => fileName.toLowerCase() === f.toLowerCase());
   const isPatternForbidden = FORBIDDEN_PATTERNS.some((re) => re.test(fileName));
   if (isExactForbidden || isPatternForbidden) {
     throw new Error(`Access to sensitive file is FORBIDDEN: ${fileName}`);
@@ -21306,7 +21304,7 @@ function registerAgentTools(server2) {
 // src/tools/integration.ts
 import { writeFileSync as writeFileSync3 } from "fs";
 
-// src/credentials.ts
+// src/utils/credentials.ts
 import * as fs3 from "fs";
 import * as os from "os";
 import * as path4 from "path";
@@ -21366,6 +21364,130 @@ function getCredential(key) {
   return loadCredentials()[key];
 }
 
+// src/utils/parser.ts
+function adfToMarkdown(adf) {
+  if (!adf || typeof adf !== "object") return "No description";
+  const content = adf.content;
+  if (!content || !Array.isArray(content)) return "No description";
+  function renderNodes(nodes, listDepth = 0, parentType) {
+    let result = "";
+    if (!nodes || !Array.isArray(nodes)) return result;
+    for (const node of nodes) {
+      switch (node.type) {
+        case "paragraph": {
+          const text = renderNodes(node.content, listDepth, node.type);
+          result += parentType === "listItem" ? text : text + "\n\n";
+          break;
+        }
+        case "heading": {
+          const level = node.attrs?.level || 1;
+          result += "#".repeat(level) + " " + renderNodes(node.content, listDepth, node.type) + "\n\n";
+          break;
+        }
+        case "text": {
+          let text = node.text || "";
+          if (node.marks) {
+            for (const mark of node.marks) {
+              switch (mark.type) {
+                case "strong":
+                  text = `**${text}**`;
+                  break;
+                case "em":
+                  text = `*${text}*`;
+                  break;
+                case "code":
+                  text = `\`${text}\``;
+                  break;
+                case "strike":
+                  text = `~~${text}~~`;
+                  break;
+                case "link":
+                  text = `[${text}](${mark.attrs?.href})`;
+                  break;
+              }
+            }
+          }
+          result += text;
+          break;
+        }
+        case "bulletList":
+        case "orderedList":
+          result += renderNodes(node.content, listDepth + 1, node.type);
+          if (listDepth === 0) result += "\n";
+          break;
+        case "listItem": {
+          const indent = "  ".repeat(Math.max(0, listDepth - 1));
+          const bullet = parentType === "orderedList" ? "1." : "-";
+          const text = renderNodes(node.content, listDepth, node.type).trim();
+          result += `${indent}${bullet} ${text}
+`;
+          break;
+        }
+        case "blockquote":
+          result += "> " + renderNodes(node.content, listDepth, node.type).trim().replace(/\n/g, "\n> ") + "\n\n";
+          break;
+        case "codeBlock":
+          result += `\`\`\`${node.attrs?.language || ""}
+${renderNodes(node.content, listDepth, node.type).trim()}
+\`\`\`
+
+`;
+          break;
+        case "rule":
+          result += "---\n\n";
+          break;
+        case "hardBreak":
+          result += "\n";
+          break;
+        case "table":
+          result += renderTable(node.content);
+          break;
+        case "mention":
+          result += `@${node.attrs?.text || node.attrs?.displayName || "user"}`;
+          break;
+        case "emoji":
+          result += node.attrs?.text || "";
+          break;
+        case "inlineCard":
+        case "blockCard":
+          result += `[${node.attrs?.url}](${node.attrs?.url})`;
+          if (node.type === "blockCard") result += "\n\n";
+          break;
+        case "mediaSingle":
+        case "mediaInline":
+        case "media":
+          result += "[media omitted]";
+          break;
+        default:
+          if (node.content) {
+            result += renderNodes(node.content, listDepth, node.type);
+          }
+          break;
+      }
+    }
+    return result;
+  }
+  function renderTable(rows) {
+    if (!rows || !Array.isArray(rows)) return "";
+    let result = "\n";
+    let isFirstRow = true;
+    for (const row of rows) {
+      if (row.type !== "tableRow") continue;
+      const cells = row.content || [];
+      const rendered = cells.map(
+        (c) => renderNodes(c.content).trim().replace(/\n+/g, " ").replace(/\|/g, "\\|")
+      );
+      result += "| " + rendered.join(" | ") + " |\n";
+      if (isFirstRow) {
+        result += "| " + cells.map(() => "---").join(" | ") + " |\n";
+        isFirstRow = false;
+      }
+    }
+    return result + "\n";
+  }
+  return renderNodes(content).trim() || "No description";
+}
+
 // src/tools/integration.ts
 var BitbucketPrSchema = external_exports.object({
   id: external_exports.number(),
@@ -21404,24 +21526,6 @@ var JiraTicketSchema = external_exports.object({
   errorMessages: external_exports.array(external_exports.string()).optional(),
   fields: JiraFieldsSchema
 });
-function extractAdfText(adf) {
-  if (!adf || typeof adf !== "object") return "No description";
-  const content = adf.content;
-  if (!content || !Array.isArray(content)) return "No description";
-  const textParts = [];
-  function extractText(nodes) {
-    for (const node of nodes) {
-      if (typeof node.text === "string") {
-        textParts.push(node.text);
-      }
-      if (Array.isArray(node.content)) {
-        extractText(node.content);
-      }
-    }
-  }
-  extractText(content);
-  return textParts.join(" ") || "No description";
-}
 function buildJiraBasicAuth() {
   const email2 = getCredential("ATLASSIAN_USER_EMAIL");
   const token = getCredential("ATLASSIAN_API_TOKEN");
@@ -21665,7 +21769,7 @@ ${ticket.errorMessages.join("\n")}`
 **Type:** ${ticket.fields.issuetype?.name || "Unknown"}
 
 ### Description
-${typeof ticket.fields.description === "string" ? ticket.fields.description : extractAdfText(ticket.fields.description)}
+${typeof ticket.fields.description === "string" ? ticket.fields.description : adfToMarkdown(ticket.fields.description)}
 
 ### Labels
 ${ticket.fields.labels?.join(", ") || "None"}`;

package/dist/tools/agent.js

@@ -7,8 +7,8 @@ import { randomUUID } from 'crypto';
 import * as fs from 'fs';
 import * as path from 'path';
 import { z } from 'zod';
-import { getWorkspaceRoot } from '../utils.js';
-import { commandExists, validatePath, sanitizeOutput } from './security.js';
+import { getWorkspaceRoot } from '../utils/utils.js';
+import { commandExists, sanitizeOutput, validatePath } from './security.js';
 // Configurable timeout via environment variable (default: 5 minutes)
 const AGENT_TIMEOUT = parseInt(process.env.KIT_AGENT_TIMEOUT || '300000', 10);
 const jobRegistry = new Map();

package/dist/tools/core.js

@@ -4,7 +4,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { z } from 'zod';
-import { getWorkspaceRoot } from '../utils.js';
+import { getWorkspaceRoot } from '../utils/utils.js';
 import { DEFAULT_EXTENSIONS } from './config.js';
 /**
  * Register core tools with MCP server

package/dist/tools/integration.js

@@ -4,7 +4,8 @@
  */
 import { writeFileSync } from 'fs';
 import { z } from 'zod';
-import { getCredential } from '../credentials.js';
+import { getCredential } from '../utils/credentials.js';
+import { adfToMarkdown } from '../utils/parser.js';
 import { sanitize } from './security.js';
 // Zod schema for Bitbucket PR REST API response
 const BitbucketPrSchema = z.object({
@@ -53,30 +54,6 @@ const JiraTicketSchema = z.object({
     errorMessages: z.array(z.string()).optional(),
     fields: JiraFieldsSchema,
 });
-/**
- * Extract plain text from ADF (Atlassian Document Format) content
- * Recursively walks the content tree to find text nodes
- */
-function extractAdfText(adf) {
-    if (!adf || typeof adf !== 'object')
-        return 'No description';
-    const content = adf.content;
-    if (!content || !Array.isArray(content))
-        return 'No description';
-    const textParts = [];
-    function extractText(nodes) {
-        for (const node of nodes) {
-            if (typeof node.text === 'string') {
-                textParts.push(node.text);
-            }
-            if (Array.isArray(node.content)) {
-                extractText(node.content);
-            }
-        }
-    }
-    extractText(content);
-    return textParts.join(' ') || 'No description';
-}
 function buildJiraBasicAuth() {
     const email = getCredential('ATLASSIAN_USER_EMAIL');
     const token = getCredential('ATLASSIAN_API_TOKEN');
@@ -309,7 +286,7 @@ ${pr.description || 'No description'}`;
 ### Description
 ${typeof ticket.fields.description === 'string'
                 ? ticket.fields.description
-                : extractAdfText(ticket.fields.description)}
+                : adfToMarkdown(ticket.fields.description)}
 
 ### Labels
 ${ticket.fields.labels?.join(', ') || 'None'}`;

package/dist/tools/security.js

@@ -5,8 +5,8 @@
 import { execFileSync } from 'child_process';
 import * as fs from 'fs';
 import * as path from 'path';
-import { getWorkspaceRoot } from '../utils.js';
-import { FORBIDDEN_FILES, FORBIDDEN_PATTERNS, FORBIDDEN_DIRS } from './config.js';
+import { getWorkspaceRoot } from '../utils/utils.js';
+import { FORBIDDEN_DIRS, FORBIDDEN_FILES, FORBIDDEN_PATTERNS } from './config.js';
 /**
  * Sanitize string for safe use with execFileSync
  * Only removes dangerous shell operators - safe chars like !?#* are allowed

package/dist/utils/parser.d.ts

@@ -0,0 +1 @@
+export declare function adfToMarkdown(adf: Record<string, unknown> | null | undefined): string;

package/dist/utils/parser.js

@@ -0,0 +1,126 @@
+export function adfToMarkdown(adf) {
+    if (!adf || typeof adf !== 'object')
+        return 'No description';
+    const content = adf.content;
+    if (!content || !Array.isArray(content))
+        return 'No description';
+    function renderNodes(nodes, listDepth = 0, parentType) {
+        let result = '';
+        if (!nodes || !Array.isArray(nodes))
+            return result;
+        for (const node of nodes) {
+            switch (node.type) {
+                case 'paragraph': {
+                    const text = renderNodes(node.content, listDepth, node.type);
+                    result += parentType === 'listItem' ? text : text + '\n\n';
+                    break;
+                }
+                case 'heading': {
+                    const level = node.attrs?.level || 1;
+                    result +=
+                        '#'.repeat(level) + ' ' + renderNodes(node.content, listDepth, node.type) + '\n\n';
+                    break;
+                }
+                case 'text': {
+                    let text = node.text || '';
+                    if (node.marks) {
+                        for (const mark of node.marks) {
+                            switch (mark.type) {
+                                case 'strong':
+                                    text = `**${text}**`;
+                                    break;
+                                case 'em':
+                                    text = `*${text}*`;
+                                    break;
+                                case 'code':
+                                    text = `\`${text}\``;
+                                    break;
+                                case 'strike':
+                                    text = `~~${text}~~`;
+                                    break;
+                                case 'link':
+                                    text = `[${text}](${mark.attrs?.href})`;
+                                    break;
+                            }
+                        }
+                    }
+                    result += text;
+                    break;
+                }
+                case 'bulletList':
+                case 'orderedList':
+                    result += renderNodes(node.content, listDepth + 1, node.type);
+                    if (listDepth === 0)
+                        result += '\n';
+                    break;
+                case 'listItem': {
+                    const indent = '  '.repeat(Math.max(0, listDepth - 1));
+                    const bullet = parentType === 'orderedList' ? '1.' : '-';
+                    const text = renderNodes(node.content, listDepth, node.type).trim();
+                    result += `${indent}${bullet} ${text}\n`;
+                    break;
+                }
+                case 'blockquote':
+                    result +=
+                        '> ' +
+                            renderNodes(node.content, listDepth, node.type).trim().replace(/\n/g, '\n> ') +
+                            '\n\n';
+                    break;
+                case 'codeBlock':
+                    result += `\`\`\`${node.attrs?.language || ''}\n${renderNodes(node.content, listDepth, node.type).trim()}\n\`\`\`\n\n`;
+                    break;
+                case 'rule':
+                    result += '---\n\n';
+                    break;
+                case 'hardBreak':
+                    result += '\n';
+                    break;
+                case 'table':
+                    result += renderTable(node.content);
+                    break;
+                case 'mention':
+                    result += `@${node.attrs?.text || node.attrs?.displayName || 'user'}`;
+                    break;
+                case 'emoji':
+                    result += node.attrs?.text || '';
+                    break;
+                case 'inlineCard':
+                case 'blockCard':
+                    result += `[${node.attrs?.url}](${node.attrs?.url})`;
+                    if (node.type === 'blockCard')
+                        result += '\n\n';
+                    break;
+                case 'mediaSingle':
+                case 'mediaInline':
+                case 'media':
+                    result += '[media omitted]';
+                    break;
+                default:
+                    if (node.content) {
+                        result += renderNodes(node.content, listDepth, node.type);
+                    }
+                    break;
+            }
+        }
+        return result;
+    }
+    function renderTable(rows) {
+        if (!rows || !Array.isArray(rows))
+            return '';
+        let result = '\n';
+        let isFirstRow = true;
+        for (const row of rows) {
+            if (row.type !== 'tableRow')
+                continue;
+            const cells = row.content || [];
+            const rendered = cells.map((c) => renderNodes(c.content).trim().replace(/\n+/g, ' ').replace(/\|/g, '\\|'));
+            result += '| ' + rendered.join(' | ') + ' |\n';
+            if (isFirstRow) {
+                result += '| ' + cells.map(() => '---').join(' | ') + ' |\n';
+                isFirstRow = false;
+            }
+        }
+        return result + '\n';
+    }
+    return renderNodes(content).trim() || 'No description';
+}

package/dist/{utils.d.ts → utils/utils.d.ts}

@@ -1,4 +1 @@
-/**
- * Utility functions for agent-kit
- */
 export declare function getWorkspaceRoot(): string;

package/dist/{utils.js → utils/utils.js}

@@ -1,6 +1,3 @@
-/**
- * Utility functions for agent-kit
- */
 export function getWorkspaceRoot() {
     return (process.env.WORKSPACE_DIR ||
         process.env.CLAUDE_WORKSPACE ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanhnd/agent-kit",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "Super Engineer - Team of AI Agents for software development (Claude Code Plugin)",
   "type": "module",
   "main": "dist/kit-server.js",