@decaf-ts/mcp-server 0.4.9 → 0.4.16

package/lib/esm/tools/jsdoc/ts-jsdoc-element-tool.js

@@ -1,84 +1,111 @@
-import { z } from "zod";
-import { zAstObject } from "./../ast/types.js";
-import { TsDocConstPrompt } from "./../../prompts/jsdocs/const-prompt.js";
-import { TsDocClassPrompt } from "./../../prompts/jsdocs/class-prompt.js";
-import { TsDocFunctionPrompt } from "./../../prompts/jsdocs/function-prompt.js";
-import { TsDocInterfacePrompt } from "./../../prompts/jsdocs/interface-prompt.js";
-import { TsDocTypeePrompt } from "./../../prompts/jsdocs/types-prompt.js";
-import { TsDocEnumPrompt } from "./../../prompts/jsdocs/enum-prompt.js";
-import { TsDocDecoratorPrompt } from "./../../prompts/jsdocs/decorator-prompt.js";
-import { ToolBuilder } from "./../../builders/tool-builder.js";
-import { Cost, EffortLevel, ReasoningLevel } from "./../../constants.js";
-const toolName = "ts.jsdoc.element";
-const inputSchema = z
-    .object({
-    astElement: zAstObject.describe("The AST TypeScript object to document"),
-    previewLength: z.number().min(50).max(500).default(100),
-})
-    .describe(`the input schema for the ${toolName} tool`);
-const outputSchema = z
-    .object({})
-    .describe(`the output schema for the ${toolName} tool`);
-export const TsDocumentElementTool = ToolBuilder.builder
-    .setName(toolName)
-    .setTitle("Tool to generate jsdocs for a javascript element (class, interface, function etc)")
-    .setDescription("Generate JSDoc comments for a specific element in a TypeScript file according to a curated template and prompt.")
-    .setInputSchema(inputSchema)
-    .setOutputSchema(outputSchema)
-    .setAnnotations({
-    title: "Tool to generate jsdocs for a javascript element (class, interface, function etc)",
-    readOnlyHint: false,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: false,
-})
-    .setReasoning(ReasoningLevel.HIGH)
-    .setEffort(EffortLevel.MEDIUM)
-    .setCost(Cost.LOW)
-    .setCb(async (input, extra) => {
-    const elType = input.astElement.kind;
-    const filePath = input.astElement.location.filePath;
-    if (!filePath) {
-        throw new Error("AST element is missing filePath in location");
-    }
-    function getPrompt() {
-        switch (elType) {
-            case "class":
-                return TsDocClassPrompt;
-            case "function":
-                return TsDocFunctionPrompt;
-            case "interface":
-                return TsDocInterfacePrompt;
-            case "type":
-                return TsDocTypeePrompt;
-            case "enum":
-                return TsDocEnumPrompt;
-            case "constant":
-                return TsDocConstPrompt;
-            case "decorator":
-                return TsDocDecoratorPrompt;
-            case "namespace":
-            case "cli-module":
-            case "module":
-            default:
-                throw new Error(`Invalid element type: ${elType}`);
-        }
-    }
-    const prompt = (await getPrompt()["cb"]({}, extra)).messages
-        .map((m) => m.content)
-        .join("\n");
-    const preview = prompt.substring(0, input.previewLength);
-    return {
-        // TEXT content so the model sees a readable version in chat
-        content: [{ type: "text", text: prompt }],
-        // small metadata so hosts can inspect provenance
-        _meta: { filePath },
-        // STRUCTURED for hosts/clients that inspect tool results
-        structuredContent: {
-            kind: "messages",
-            preview,
-            messages: input.astElement,
-        },
-    };
-});
+"use strict";
+// import { z } from "zod";
+// import { zAstObject } from "../ast/types";
+// import { TsDocConstPrompt } from "../../prompts/jsdocs/const-prompt";
+// import { TsDocClassPrompt } from "../../prompts/jsdocs/class-prompt";
+// import { TsDocFunctionPrompt } from "../../prompts/jsdocs/function-prompt";
+// import { TsDocInterfacePrompt } from "../../prompts/jsdocs/interface-prompt";
+// import { TsDocTypeePrompt } from "../../prompts/jsdocs/types-prompt";
+// import { TsDocEnumPrompt } from "../../prompts/jsdocs/enum-prompt";
+// import { TsDocDecoratorPrompt } from "../../prompts/jsdocs/decorator-prompt";
+// import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol";
+// import {
+//   ServerNotification,
+//   ServerRequest,
+// } from "@modelcontextprotocol/sdk/types";
+// import { ToolBuilder } from "../../builders/tool-builder";
+// import { Cost, EffortLevel, ReasoningLevel } from "../../constants";
+//
+// const toolName = "ts.jsdoc.element";
+//
+// const inputSchema = z
+//   .object({
+//     astElement: zAstObject.describe("The AST TypeScript object to document"),
+//     previewLength: z.number().min(50).max(500).default(100),
+//   })
+//   .describe(`the input schema for the ${toolName} tool`);
+//
+// const outputSchema = z
+//   .object({})
+//   .describe(`the output schema for the ${toolName} tool`);
+//
+// export const TsDocumentElementTool: ToolBuilder = ToolBuilder.builder
+//   .setName(toolName)
+//   .setTitle(
+//     "Tool to generate jsdocs for a javascript element (class, interface, function etc)"
+//   )
+//   .setDescription(
+//     "Generate JSDoc comments for a specific element in a TypeScript file according to a curated template and prompt."
+//   )
+//   .setInputSchema(inputSchema)
+//   .setOutputSchema(outputSchema)
+//   .setAnnotations({
+//     title:
+//       "Tool to generate jsdocs for a javascript element (class, interface, function etc)",
+//     readOnlyHint: false,
+//     destructiveHint: false,
+//     idempotentHint: true,
+//     openWorldHint: false,
+//   })
+//   .setReasoning(ReasoningLevel.HIGH)
+//   .setEffort(EffortLevel.MEDIUM)
+//   .setCost(Cost.LOW)
+//   .setCb(
+//     async (
+//       input: any,
+//
+//       extra: RequestHandlerExtra<ServerRequest, ServerNotification>
+//     ) => {
+//       const elType = input.astElement.kind;
+//       const filePath = input.astElement.location.filePath;
+//       if (!filePath) {
+//         throw new Error("AST element is missing filePath in location");
+//       }
+//
+//       function getPrompt() {
+//         switch (elType) {
+//           case "class":
+//             return TsDocClassPrompt;
+//           case "function":
+//             return TsDocFunctionPrompt;
+//           case "interface":
+//             return TsDocInterfacePrompt;
+//           case "type":
+//             return TsDocTypeePrompt;
+//           case "enum":
+//             return TsDocEnumPrompt;
+//           case "constant":
+//             return TsDocConstPrompt;
+//           case "decorator":
+//             return TsDocDecoratorPrompt;
+//           case "namespace":
+//           case "cli-module":
+//           case "module":
+//           default:
+//             throw new Error(`Invalid element type: ${elType}`);
+//         }
+//       }
+//
+//       const prompt: string = (
+//         await getPrompt()["cb"]({} as any, extra)
+//       ).messages
+//         .map((m) => m.content)
+//         .join("\n");
+//
+//       const preview = prompt.substring(0, input.previewLength);
+//
+//       return {
+//         // TEXT content so the model sees a readable version in chat
+//         content: [{ type: "text", text: prompt }],
+//         // small metadata so hosts can inspect provenance
+//         _meta: { filePath },
+//         // STRUCTURED for hosts/clients that inspect tool results
+//         structuredContent: {
+//           kind: "messages",
+//           preview,
+//           messages: input.astElement,
+//         },
+//       };
+//     }
+//   );
 //# sourceMappingURL=ts-jsdoc-element-tool.js.map

package/lib/esm/tools/jsdoc/ts-jsdoc-element-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"ts-jsdoc-element-tool.js","sourceRoot":"","sources":["../../../../src/tools/jsdoc/ts-jsdoc-element-tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ts-jsdoc-element-tool.js","sourceRoot":"","sources":["../../../../src/tools/jsdoc/ts-jsdoc-element-tool.ts"],"names":[],"mappings":";AAAA,2BAA2B;AAC3B,6CAA6C;AAC7C,wEAAwE;AACxE,wEAAwE;AACxE,8EAA8E;AAC9E,gFAAgF;AAChF,wEAAwE;AACxE,sEAAsE;AACtE,gFAAgF;AAChF,mFAAmF;AACnF,WAAW;AACX,wBAAwB;AACxB,mBAAmB;AACnB,4CAA4C;AAC5C,6DAA6D;AAC7D,uEAAuE;AACvE,EAAE;AACF,uCAAuC;AACvC,EAAE;AACF,wBAAwB;AACxB,cAAc;AACd,gFAAgF;AAChF,+DAA+D;AAC/D,OAAO;AACP,4DAA4D;AAC5D,EAAE;AACF,yBAAyB;AACzB,gBAAgB;AAChB,6DAA6D;AAC7D,EAAE;AACF,wEAAwE;AACxE,uBAAuB;AACvB,eAAe;AACf,0FAA0F;AAC1F,MAAM;AACN,qBAAqB;AACrB,wHAAwH;AACxH,MAAM;AACN,iCAAiC;AACjC,mCAAmC;AACnC,sBAAsB;AACtB,aAAa;AACb,6FAA6F;AAC7F,2BAA2B;AAC3B,8BAA8B;AAC9B,4BAA4B;AAC5B,4BAA4B;AAC5B,OAAO;AACP,uCAAuC;AACvC,mCAAmC;AACnC,uBAAuB;AACvB,YAAY;AACZ,cAAc;AACd,oBAAoB;AACpB,EAAE;AACF,sEAAsE;AACtE,aAAa;AACb,8CAA8C;AAC9C,6DAA6D;AAC7D,yBAAyB;AACzB,0EAA0E;AAC1E,UAAU;AACV,EAAE;AACF,+BAA+B;AAC/B,4BAA4B;AAC5B,0BAA0B;AAC1B,uCAAuC;AACvC,6BAA6B;AAC7B,0CAA0C;AAC1C,8BAA8B;AAC9B,2CAA2C;AAC3C,yBAAyB;AACzB,uCAAuC;AACvC,yBAAyB;AACzB,sCAAsC;AACtC,6BAA6B;AAC7B,uCAAuC;AACvC,8BAA8B;AAC9B,2CAA2C;AAC3C,8BAA8B;AAC9B,+BAA+B;AAC/B,2BAA2B;AAC3B,qBAAqB;AACrB,kEAAkE;AAClE,YAAY;AACZ,UAAU;AACV,EAAE;AACF,iCAAiC;AACjC,oDAAoD;AACpD,mBAAmB;AACnB,iCAAiC;AACjC,uBAAuB;AACvB,EAAE;AACF,kEAAkE;AAClE,EAAE;AACF,iBAAiB;AACjB,uEAAuE;AACvE,qDAAqD;AACrD,4DAA4D;AAC5D,+BAA+B;AAC/B,oEAAoE;AACpE,+BAA+B;AAC/B,8BAA8B;AAC9B,qBAAqB;AACrB,wCAAwC;AACxC,aAAa;AACb,WAAW;AACX,QAAQ;AACR,OAAO"}

package/lib/esm/tools/jsdoc/utils.d.ts

@@ -1,5 +0,0 @@
-export declare function hasExistingJsDoc(sourceText: string, nodeStartLine: number): {
-    has: boolean;
-    block?: string;
-};
-export declare function inferContextHints(filePath: string, repoRoot?: string): string[];

package/lib/esm/tools/jsdoc/utils.js

@@ -1,53 +1,60 @@
-import path from "path";
-export function hasExistingJsDoc(sourceText, nodeStartLine) {
-    // Simple heuristic: look for /** */ block immediately preceding the line
-    const lines = sourceText.split(/\r?\n/);
-    const idx = Math.max(0, nodeStartLine - 2); // 0-based
-    for (let i = idx; i >= 0 && i > idx - 6; i--) {
-        const line = lines[i].trim();
-        if (line.startsWith("/**")) {
-            // collect block
-            const blockLines = [];
-            for (let j = i; j < lines.length; j++) {
-                blockLines.push(lines[j]);
-                if (lines[j].includes("*/"))
-                    break;
-            }
-            return { has: true, block: blockLines.join("\n") };
-        }
-        if (line && !line.startsWith("*") && !line.startsWith("//"))
-            break;
-    }
-    return { has: false };
-}
-export function inferContextHints(filePath, repoRoot) {
-    const rel = repoRoot ? path.relative(repoRoot, filePath) : filePath;
-    const parts = rel.split(path.sep);
-    const hints = new Set();
-    const p = rel.toLowerCase();
-    if (p.includes(`${path.sep}cli${path.sep}`) ||
-        p.endsWith(".cli.ts") ||
-        p.includes("bin"))
-        hints.add("cli");
-    if (p.includes(`${path.sep}api${path.sep}`) || p.includes("/api/"))
-        hints.add("api");
-    if (p.includes(`${path.sep}lib${path.sep}`) || p.includes("/lib/"))
-        hints.add("lib");
-    if (p.includes("test") || p.includes("__tests__"))
-        hints.add("test-fixture");
-    if (p.endsWith("index.ts"))
-        hints.add("index");
-    // filename patterns
-    const file = path.basename(rel);
-    if (file.endsWith(".controller.ts"))
-        hints.add("controller");
-    if (file.endsWith(".service.ts"))
-        hints.add("service");
-    if (file.endsWith(".spec.ts") || file.endsWith(".test.ts"))
-        hints.add("test");
-    // default: if under src or lib, mark as library
-    if (parts.includes("src") || parts.includes("lib"))
-        hints.add("library");
-    return Array.from(hints);
-}
+"use strict";
+// import * as path from "path";
+//
+// export function hasExistingJsDoc(
+//   sourceText: string,
+//   nodeStartLine: number
+// ): { has: boolean; block?: string } {
+//   // Simple heuristic: look for /** */ block immediately preceding the line
+//   const lines = sourceText.split(/\r?\n/);
+//   const idx = Math.max(0, nodeStartLine - 2); // 0-based
+//   for (let i = idx; i >= 0 && i > idx - 6; i--) {
+//     const line = lines[i].trim();
+//     if (line.startsWith("/**")) {
+//       // collect block
+//       const blockLines = [];
+//       for (let j = i; j < lines.length; j++) {
+//         blockLines.push(lines[j]);
+//         if (lines[j].includes("*/")) break;
+//       }
+//       return { has: true, block: blockLines.join("\n") };
+//     }
+//     if (line && !line.startsWith("*") && !line.startsWith("//")) break;
+//   }
+//   return { has: false };
+// }
+//
+// export function inferContextHints(
+//   filePath: string,
+//   repoRoot?: string
+// ): string[] {
+//   const rel = repoRoot ? path.relative(repoRoot, filePath) : filePath;
+//   const parts = rel.split(path.sep);
+//   const hints = new Set<string>();
+//
+//   const p = rel.toLowerCase();
+//   if (
+//     p.includes(`${path.sep}cli${path.sep}`) ||
+//     p.endsWith(".cli.ts") ||
+//     p.includes("bin")
+//   )
+//     hints.add("cli");
+//   if (p.includes(`${path.sep}api${path.sep}`) || p.includes("/api/"))
+//     hints.add("api");
+//   if (p.includes(`${path.sep}lib${path.sep}`) || p.includes("/lib/"))
+//     hints.add("lib");
+//   if (p.includes("test") || p.includes("__tests__")) hints.add("test-fixture");
+//   if (p.endsWith("index.ts")) hints.add("index");
+//
+//   // filename patterns
+//   const file = path.basename(rel);
+//   if (file.endsWith(".controller.ts")) hints.add("controller");
+//   if (file.endsWith(".service.ts")) hints.add("service");
+//   if (file.endsWith(".spec.ts") || file.endsWith(".test.ts")) hints.add("test");
+//
+//   // default: if under src or lib, mark as library
+//   if (parts.includes("src") || parts.includes("lib")) hints.add("library");
+//
+//   return Array.from(hints);
+// }
 //# sourceMappingURL=utils.js.map

package/lib/esm/tools/jsdoc/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/tools/jsdoc/utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,aAAqB;IAErB,yEAAyE;IACzE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU;IACtD,KAAK,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,gBAAgB;YAChB,MAAM,UAAU,GAAG,EAAE,CAAC;YACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1B,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,MAAM;YACrC,CAAC;YACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM;IACrE,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,QAAiB;IAEjB,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACpE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC5B,IACE,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QACrB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAEjB,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAChE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAChE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC7E,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE/C,oBAAoB;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7D,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE9E,gDAAgD;IAChD,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEzE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/tools/jsdoc/utils.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,EAAE;AACF,oCAAoC;AACpC,wBAAwB;AACxB,0BAA0B;AAC1B,wCAAwC;AACxC,8EAA8E;AAC9E,6CAA6C;AAC7C,2DAA2D;AAC3D,oDAAoD;AACpD,oCAAoC;AACpC,oCAAoC;AACpC,yBAAyB;AACzB,+BAA+B;AAC/B,iDAAiD;AACjD,qCAAqC;AACrC,8CAA8C;AAC9C,UAAU;AACV,4DAA4D;AAC5D,QAAQ;AACR,0EAA0E;AAC1E,MAAM;AACN,2BAA2B;AAC3B,IAAI;AACJ,EAAE;AACF,qCAAqC;AACrC,sBAAsB;AACtB,sBAAsB;AACtB,gBAAgB;AAChB,yEAAyE;AACzE,uCAAuC;AACvC,qCAAqC;AACrC,EAAE;AACF,iCAAiC;AACjC,SAAS;AACT,iDAAiD;AACjD,+BAA+B;AAC/B,wBAAwB;AACxB,MAAM;AACN,wBAAwB;AACxB,wEAAwE;AACxE,wBAAwB;AACxB,wEAAwE;AACxE,wBAAwB;AACxB,kFAAkF;AAClF,oDAAoD;AACpD,EAAE;AACF,yBAAyB;AACzB,qCAAqC;AACrC,kEAAkE;AAClE,4DAA4D;AAC5D,mFAAmF;AACnF,EAAE;AACF,qDAAqD;AACrD,8EAA8E;AAC9E,EAAE;AACF,8BAA8B;AAC9B,IAAI"}

package/lib/esm/tools/project/list-tool.js

@@ -0,0 +1,47 @@
+"use strict";
+// /**
+//  * Jira Project List Tool (Version3-only)
+//  *
+//  * Returns a list of projects visible to the authenticated user.
+//  * Endpoint: GET /rest/api/3/project/search
+//  */
+//
+// import { buildPagination, validateWithSchema } from "../../jira/tool-utils";
+// import { normalizeJiraError } from "../../jira/errors";
+// import { z } from "zod";
+//
+// export const name = "jira.project-list";
+//
+// export const inputSchema = z.object({
+//   startAt: z.number().optional(),
+//   maxResults: z.number().optional(),
+//   query: z.string().optional(),
+// });
+//
+// export async function runTool(client: any, input: any) {
+//   const v = validateWithSchema(input, inputSchema as any);
+//   if (!v.valid)
+//     throw {
+//       code: "validation_error",
+//       message: "Invalid input",
+//       details: v.errors,
+//     };
+//   try {
+//     const { startAt, maxResults, query } = input || {};
+//     const page = buildPagination(startAt, maxResults);
+//     const res: any = await client.project.search({
+//       startAt: page.startAt,
+//       maxResults: page.maxResults,
+//       query,
+//     });
+//     return {
+//       startAt: res.startAt ?? page.startAt,
+//       maxResults: res.maxResults ?? page.maxResults,
+//       total: res.total ?? (res.values ? res.values.length : undefined),
+//       values: res.values ?? res.projects ?? res,
+//     };
+//   } catch (err: any) {
+//     throw normalizeJiraError(err);
+//   }
+// }
+//# sourceMappingURL=list-tool.js.map

package/lib/esm/tools/project/list-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tool.js","sourceRoot":"","sources":["../../../../src/tools/project/list-tool.ts"],"names":[],"mappings":";AAAA,MAAM;AACN,4CAA4C;AAC5C,KAAK;AACL,mEAAmE;AACnE,8CAA8C;AAC9C,MAAM;AACN,EAAE;AACF,+EAA+E;AAC/E,0DAA0D;AAC1D,2BAA2B;AAC3B,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,wCAAwC;AACxC,oCAAoC;AACpC,uCAAuC;AACvC,kCAAkC;AAClC,MAAM;AACN,EAAE;AACF,2DAA2D;AAC3D,6DAA6D;AAC7D,kBAAkB;AAClB,cAAc;AACd,kCAAkC;AAClC,kCAAkC;AAClC,2BAA2B;AAC3B,SAAS;AACT,UAAU;AACV,0DAA0D;AAC1D,yDAAyD;AACzD,qDAAqD;AACrD,+BAA+B;AAC/B,qCAAqC;AACrC,eAAe;AACf,UAAU;AACV,eAAe;AACf,8CAA8C;AAC9C,uDAAuD;AACvD,0EAA0E;AAC1E,mDAAmD;AACnD,SAAS;AACT,yBAAyB;AACzB,qCAAqC;AACrC,MAAM;AACN,IAAI"}

package/lib/esm/tools/search/jql-tool.js

@@ -0,0 +1,49 @@
+"use strict";
+// /**
+//  * Jira JQL Search Tool (Version3-only)
+//  *
+//  * Executes a JQL query and returns matching issues.
+//  * Endpoint: GET /rest/api/3/search
+//  */
+//
+// import { validateWithSchema, buildPagination } from "../../jira/tool-utils";
+// import { normalizeJiraError } from "../../jira/errors";
+// import { z } from "zod";
+//
+// export const name = "jira.search-jql";
+//
+// export const inputSchema = z.object({
+//   jql: z.string(),
+//   startAt: z.number().optional(),
+//   maxResults: z.number().optional(),
+//   fields: z.array(z.string()).optional(),
+// });
+//
+// export async function runTool(client: any, input: any) {
+//   const v = validateWithSchema(input, inputSchema as any);
+//   if (!v.valid)
+//     throw {
+//       code: "validation_error",
+//       message: "Invalid input",
+//       details: v.errors,
+//     };
+//   try {
+//     const { jql, startAt, maxResults, fields } = input;
+//     const page = buildPagination(startAt, maxResults);
+//     const res: any = await client.search.search({
+//       jql,
+//       startAt: page.startAt,
+//       maxResults: page.maxResults,
+//       fields,
+//     });
+//     return {
+//       startAt: res.startAt ?? page.startAt,
+//       maxResults: res.maxResults ?? page.maxResults,
+//       total: res.total,
+//       issues: res.issues ?? res.values ?? [],
+//     };
+//   } catch (err: any) {
+//     throw normalizeJiraError(err);
+//   }
+// }
+//# sourceMappingURL=jql-tool.js.map

package/lib/esm/tools/search/jql-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-tool.js","sourceRoot":"","sources":["../../../../src/tools/search/jql-tool.ts"],"names":[],"mappings":";AAAA,MAAM;AACN,0CAA0C;AAC1C,KAAK;AACL,uDAAuD;AACvD,sCAAsC;AACtC,MAAM;AACN,EAAE;AACF,+EAA+E;AAC/E,0DAA0D;AAC1D,2BAA2B;AAC3B,EAAE;AACF,yCAAyC;AACzC,EAAE;AACF,wCAAwC;AACxC,qBAAqB;AACrB,oCAAoC;AACpC,uCAAuC;AACvC,4CAA4C;AAC5C,MAAM;AACN,EAAE;AACF,2DAA2D;AAC3D,6DAA6D;AAC7D,kBAAkB;AAClB,cAAc;AACd,kCAAkC;AAClC,kCAAkC;AAClC,2BAA2B;AAC3B,SAAS;AACT,UAAU;AACV,0DAA0D;AAC1D,yDAAyD;AACzD,oDAAoD;AACpD,aAAa;AACb,+BAA+B;AAC/B,qCAAqC;AACrC,gBAAgB;AAChB,UAAU;AACV,eAAe;AACf,8CAA8C;AAC9C,uDAAuD;AACvD,0BAA0B;AAC1B,gDAAgD;AAChD,SAAS;AACT,yBAAyB;AACzB,qCAAqC;AACrC,MAAM;AACN,IAAI"}

package/lib/esm/tools/testing/ts-jest-list-tests.d.ts

@@ -1,2 +0,0 @@
-import { ToolBuilder } from "../../builders/tool-builder";
-export declare const TsDocumentElementTool: ToolBuilder;

package/lib/esm/tools/testing/ts-jest-list-tests.js

@@ -1,53 +1,71 @@
-import { z } from "zod";
-import { zAstObject } from "./../ast/types.js";
-import { ToolBuilder } from "./../../builders/tool-builder.js";
-import { Cost, EffortLevel, ReasoningLevel } from "./../../constants.js";
-import { runCommand } from "@decaf-ts/utils";
-const toolName = "ts.jsdoc.element";
-const inputSchema = z
-    .object({
-    astElement: zAstObject.describe("The AST TypeScript object to document"),
-    previewLength: z.number().min(50).max(500).default(100),
-})
-    .describe(`the input schema for the ${toolName} tool`);
-const outputSchema = z
-    .object({})
-    .describe(`the output schema for the ${toolName} tool`);
-export const TsDocumentElementTool = ToolBuilder.builder
-    .setName(toolName)
-    .setTitle("Tool to generate jsdocs for a javascript element (class, interface, function etc)")
-    .setDescription("Generate JSDoc comments for a specific element in a TypeScript file according to a curated template and prompt.")
-    .setInputSchema(inputSchema)
-    .setOutputSchema(outputSchema)
-    .setAnnotations({
-    title: "Tool to generate jsdocs for a javascript element (class, interface, function etc)",
-    readOnlyHint: false,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: false,
-})
-    .setReasoning(ReasoningLevel.HIGH)
-    .setEffort(EffortLevel.MEDIUM)
-    .setCost(Cost.LOW)
-    .setCb(async (input, 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-extra) => {
-    const cwd = process.cwd();
-    const tests = await runCommand("npx jest --listTests", {
-        cwd,
-    }).promise;
-    // run npx jest --listTests and capture output
-    return {
-        // TEXT content so the model sees a readable version in chat
-        content: [{ type: "text", text: tests }],
-        // small metadata so hosts can inspect provenance
-        _meta: { cwd },
-        // STRUCTURED for hosts/clients that inspect tool results
-        structuredContent: {
-            kind: "messages",
-            tests,
-            messages: input.astElement,
-        },
-    };
-});
+"use strict";
+// import { z } from "zod";
+// import { zAstObject } from "../ast/types";
+// import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol";
+// import {
+//   ServerNotification,
+//   ServerRequest,
+// } from "@modelcontextprotocol/sdk/types";
+// import { ToolBuilder } from "../../builders/tool-builder";
+// import { Cost, EffortLevel, ReasoningLevel } from "../../constants";
+// import { runCommand } from "@decaf-ts/utils";
+//
+// const toolName = "ts.jsdoc.element";
+//
+// const inputSchema = z
+//   .object({
+//     astElement: zAstObject.describe("The AST TypeScript object to document"),
+//     previewLength: z.number().min(50).max(500).default(100),
+//   })
+//   .describe(`the input schema for the ${toolName} tool`);
+//
+// const outputSchema = z.object({}).describe(`the output schema for the ${toolName} tool`);
+//
+// export const TsDocumentElementTool: ToolBuilder = ToolBuilder.builder
+//   .setName(toolName)
+//   .setTitle(
+//     "Tool to generate jsdocs for a javascript element (class, interface, function etc)"
+//   )
+//   .setDescription(
+//     "Generate JSDoc comments for a specific element in a TypeScript file according to a curated template and prompt."
+//   )
+//   .setInputSchema(inputSchema)
+//   .setOutputSchema(outputSchema)
+//   .setAnnotations({
+//     title:
+//       "Tool to generate jsdocs for a javascript element (class, interface, function etc)",
+//     readOnlyHint: false,
+//     destructiveHint: false,
+//     idempotentHint: true,
+//     openWorldHint: false,
+//   })
+//   .setReasoning(ReasoningLevel.HIGH)
+//   .setEffort(EffortLevel.MEDIUM)
+//   .setCost(Cost.LOW)
+//   .setCb(
+//     async (
+//       input: any,
+//       // eslint-disable-next-line @typescript-eslint/no-unused-vars
+//       extra: RequestHandlerExtra<ServerRequest, ServerNotification>
+//     ) => {
+//       const cwd = process.cwd();
+//       const tests = await runCommand("npx jest --listTests", {
+//         cwd,
+//       }).promise;
+//       // run npx jest --listTests and capture output
+//
+//       return {
+//         // TEXT content so the model sees a readable version in chat
+//         content: [{ type: "text", text: tests }],
+//         // small metadata so hosts can inspect provenance
+//         _meta: { cwd },
+//         // STRUCTURED for hosts/clients that inspect tool results
+//         structuredContent: {
+//           kind: "messages",
+//           tests,
+//           messages: input.astElement,
+//         },
+//       };
+//     }
+//   );
 //# sourceMappingURL=ts-jest-list-tests.js.map

package/lib/esm/tools/testing/ts-jest-list-tests.js.map

@@ -1 +1 @@
-{"version":3,"file":"ts-jest-list-tests.js","sourceRoot":"","sources":["../../../../src/tools/testing/ts-jest-list-tests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,0BAAqB;AAM1C,OAAO,EAAE,WAAW,EAAE,yCAAoC;AAC1D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,6BAAwB;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAEpC,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACxE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;CACxD,CAAC;KACD,QAAQ,CAAC,4BAA4B,QAAQ,OAAO,CAAC,CAAC;AAEzD,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,CAAC,EAAE,CAAC;KACV,QAAQ,CAAC,6BAA6B,QAAQ,OAAO,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,qBAAqB,GAAgB,WAAW,CAAC,OAAO;KAClE,OAAO,CAAC,QAAQ,CAAC;KACjB,QAAQ,CACP,mFAAmF,CACpF;KACA,cAAc,CACb,iHAAiH,CAClH;KACA,cAAc,CAAC,WAAW,CAAC;KAC3B,eAAe,CAAC,YAAY,CAAC;KAC7B,cAAc,CAAC;IACd,KAAK,EACH,mFAAmF;IACrF,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,KAAK;CACrB,CAAC;KACD,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC;KACjC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC;KAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;KACjB,KAAK,CACJ,KAAK,EACH,KAAU;AACV,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,sBAAsB,EAAE;QACrD,GAAG;KACJ,CAAC,CAAC,OAAO,CAAC;IACX,8CAA8C;IAE9C,OAAO;QACL,4DAA4D;QAC5D,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACxC,iDAAiD;QACjD,KAAK,EAAE,EAAE,GAAG,EAAE;QACd,yDAAyD;QACzD,iBAAiB,EAAE;YACjB,IAAI,EAAE,UAAU;YAChB,KAAK;YACL,QAAQ,EAAE,KAAK,CAAC,UAAU;SAC3B;KACF,CAAC;AACJ,CAAC,CACF,CAAC"}
+{"version":3,"file":"ts-jest-list-tests.js","sourceRoot":"","sources":["../../../../src/tools/testing/ts-jest-list-tests.ts"],"names":[],"mappings":";AAAA,2BAA2B;AAC3B,6CAA6C;AAC7C,mFAAmF;AACnF,WAAW;AACX,wBAAwB;AACxB,mBAAmB;AACnB,4CAA4C;AAC5C,6DAA6D;AAC7D,uEAAuE;AACvE,gDAAgD;AAChD,EAAE;AACF,uCAAuC;AACvC,EAAE;AACF,wBAAwB;AACxB,cAAc;AACd,gFAAgF;AAChF,+DAA+D;AAC/D,OAAO;AACP,4DAA4D;AAC5D,EAAE;AACF,4FAA4F;AAC5F,EAAE;AACF,wEAAwE;AACxE,uBAAuB;AACvB,eAAe;AACf,0FAA0F;AAC1F,MAAM;AACN,qBAAqB;AACrB,wHAAwH;AACxH,MAAM;AACN,iCAAiC;AACjC,mCAAmC;AACnC,sBAAsB;AACtB,aAAa;AACb,6FAA6F;AAC7F,2BAA2B;AAC3B,8BAA8B;AAC9B,4BAA4B;AAC5B,4BAA4B;AAC5B,OAAO;AACP,uCAAuC;AACvC,mCAAmC;AACnC,uBAAuB;AACvB,YAAY;AACZ,cAAc;AACd,oBAAoB;AACpB,sEAAsE;AACtE,sEAAsE;AACtE,aAAa;AACb,mCAAmC;AACnC,iEAAiE;AACjE,eAAe;AACf,oBAAoB;AACpB,uDAAuD;AACvD,EAAE;AACF,iBAAiB;AACjB,uEAAuE;AACvE,oDAAoD;AACpD,4DAA4D;AAC5D,0BAA0B;AAC1B,oEAAoE;AACpE,+BAA+B;AAC/B,8BAA8B;AAC9B,mBAAmB;AACnB,wCAAwC;AACxC,aAAa;AACb,WAAW;AACX,QAAQ;AACR,OAAO"}