@decaf-ts/mcp-server 0.4.2 → 0.4.7

package/lib/prompts/example-prompt/index.d.ts

@@ -0,0 +1,2 @@
+import { PromptBuilder } from "../../builders/prompt-builder";
+export declare const ExamplePrompt: PromptBuilder;

package/lib/prompts/example-prompt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompts/example-prompt/index.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wEAA8D;AAO9D,qDAAoE;AAEpE,MAAM,UAAU,GAAG,qBAAqB,CAAC;AAEzC,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAGhD,QAAA,aAAa,GAAG,8BAAa,CAAC,OAAO;KAC/C,OAAO,CAAC,UAAU,CAAC;KACnB,QAAQ,CAAC,sBAAsB,CAAC;KAChC,cAAc,CAAC,0EAA0E,CAAC;KAC1F,aAAa,CAAC,UAAiB,CAAC;KAChC,YAAY,CAAC,0BAAc,CAAC,KAAK,CAAC;KAClC,KAAK,CACJ,CACE,IAAU,EACV,MAA8D,EAC7C,EAAE;IACnB,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,oBAAoB,CAAC;IAChD,MAAM,QAAQ,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACrE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAS,CAAC;AACxC,CAAC,CACF,CAAC;AAEJ,oFAAoF"}

package/lib/prompts/index.cjs

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Prompts = void 0;
+const class_prompt_1 = require("./jsdocs/class-prompt.cjs");
+const const_prompt_1 = require("./jsdocs/const-prompt.cjs");
+const decorator_prompt_1 = require("./jsdocs/decorator-prompt.cjs");
+const enum_prompt_1 = require("./jsdocs/enum-prompt.cjs");
+const function_prompt_1 = require("./jsdocs/function-prompt.cjs");
+const interface_prompt_1 = require("./jsdocs/interface-prompt.cjs");
+const types_prompt_1 = require("./jsdocs/types-prompt.cjs");
+const builder_1 = require("./code/design-patterns/builder.cjs");
+const example_prompt_1 = require("./example-prompt/index.cjs");
+const interactive_jsdoc_1 = require("./interactive-jsdoc/index.cjs");
+exports.Prompts = [
+    // Documentation prompts
+    class_prompt_1.TsDocClassPrompt,
+    const_prompt_1.TsDocConstPrompt,
+    decorator_prompt_1.TsDocDecoratorPrompt,
+    enum_prompt_1.TsDocEnumPrompt,
+    function_prompt_1.TsDocFunctionPrompt,
+    interface_prompt_1.TsDocInterfacePrompt,
+    types_prompt_1.TsDocTypeePrompt,
+    // Code generation prompts
+    builder_1.TsCodeDesignPatterBuilderPrompt,
+    // Example prompt
+    example_prompt_1.ExamplePrompt,
+    interactive_jsdoc_1.InteractiveJsDocPrompt,
+];
+//# sourceMappingURL=index.js.map

package/lib/prompts/index.d.ts

@@ -0,0 +1,2 @@
+import { PromptBuilder } from "../builders/prompt-builder";
+export declare const Prompts: PromptBuilder[];

package/lib/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":";;;AAAA,4DAAyD;AACzD,4DAAyD;AACzD,oEAAiE;AACjE,0DAAuD;AACvD,kEAA+D;AAC/D,oEAAiE;AACjE,4DAAyD;AAEzD,gEAAiF;AACjF,+DAAiD;AACjD,qEAA6D;AAEhD,QAAA,OAAO,GAAoB;IACtC,wBAAwB;IACxB,+BAAgB;IAChB,+BAAgB;IAChB,uCAAoB;IACpB,6BAAe;IACf,qCAAmB;IACnB,uCAAoB;IACpB,+BAAgB;IAChB,0BAA0B;IAC1B,yCAA+B;IAC/B,iBAAiB;IACjB,8BAAa;IACb,0CAAsB;CACvB,CAAC"}

package/lib/prompts/interactive-jsdoc/index.cjs

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractiveJsDocPrompt = void 0;
+const zod_1 = require("zod");
+const prompt_builder_1 = require("./../../builders/prompt-builder.cjs");
+const constants_1 = require("./../../constants.cjs");
+const promptName = "interactive.jsdoc.assistant";
+const argsSchema = zod_1.z.object({ code: zod_1.z.string().optional(), astObject: zod_1.z.any().optional() });
+exports.InteractiveJsDocPrompt = prompt_builder_1.PromptBuilder.builder
+    .setName(promptName)
+    .setTitle("Interactive JSDoc Assistant")
+    .setDescription("Produce a ready-to-insert JSDoc block for a provided code snippet or AST object.")
+    .setArgsSchema(argsSchema)
+    .setReasoning(constants_1.ReasoningLevel.BASIC)
+    .setCb((args, _extra) => {
+    const code = args?.code ?? "";
+    const prompt = `Generate a complete JSDoc comment block for the following code. Respond only with the full JSDoc block.\n\n${code}`;
+    const result = { messages: [{ role: "user", content: { type: "text", text: prompt } }], _meta: {} };
+    return result;
+});
+//# sourceMappingURL=index.js.map

package/lib/prompts/interactive-jsdoc/index.d.ts

@@ -0,0 +1,2 @@
+import { PromptBuilder } from "../../builders/prompt-builder";
+export declare const InteractiveJsDocPrompt: PromptBuilder;

package/lib/prompts/interactive-jsdoc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompts/interactive-jsdoc/index.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wEAA8D;AAO9D,qDAAiD;AAEjD,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAEjD,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAG/E,QAAA,sBAAsB,GAAG,8BAAa,CAAC,OAAO;KACxD,OAAO,CAAC,UAAU,CAAC;KACnB,QAAQ,CAAC,6BAA6B,CAAC;KACvC,cAAc,CAAC,kFAAkF,CAAC;KAClG,aAAa,CAAC,UAAiB,CAAC;KAChC,YAAY,CAAC,0BAAc,CAAC,KAAK,CAAC;KAClC,KAAK,CAAC,CAAC,IAAU,EAAE,MAA8D,EAAmB,EAAE;IACrG,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,8GAA8G,IAAI,EAAE,CAAC;IACpI,MAAM,MAAM,GAAoB,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAS,CAAC;IAC5H,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC"}

package/lib/prompts/jsdocs/class-prompt.cjs

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsDocClassPrompt = void 0;
+const zod_1 = require("zod");
+const constants_1 = require("./constants.cjs");
+const prompt_builder_1 = require("./../../builders/prompt-builder.cjs");
+const constants_2 = require("./../../constants.cjs");
+const promptName = "ts.jsdoc.class";
+const argsSchema = zod_1.z.object({});
+exports.TsDocClassPrompt = prompt_builder_1.PromptBuilder.builder
+    .setName(promptName)
+    .setTitle("Class JSDocs Prompt")
+    .setDescription("Generate JSDoc comments for a TypeScript class according to a curated template and prompt.")
+    .setArgsSchema(argsSchema)
+    .setReasoning(constants_2.ReasoningLevel.BASIC)
+    .setCb((
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+args, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+extra) => {
+    const prompt = `${constants_1.BaseJSDocPrompt}
+document the entire class and each of its functions including always including the @description tag with a short description of the target, and a@summary tag with a more detailed one.
+Include @class tags when applicable.
+include @param tags in the class documentation and its type definitions
+Include detailed @description for all properties.
+Include @template tags when necessary.
+Do NOT document the constructor, but include the constructor arguments as @param in the class documentation
+For methods and functions:
+- include @description and @summary tags as defined for the target. also document every argument, including its type definition, and return type, referencing @template tags when necessary.
+- create a usage example under the @example tag on the class documentation
+- create mermaid sequence diagrams under the @mermaid tag;
+
+The order of tags (when applicable) should be as follows:
+1 - @description;
+2 - @summary;
+3 - @template;
+4 - @param;
+5 - @return;
+6 - @class
+7 - @example
+8 - @mermaid;
+
+ignore @mermaid for methods with less that 15 lines and constructors.
+Respond only with the full JSDoc comment block for the class and its methods.
+NEVER user @memberOf in the class or any of it's methods
+if the element is already documented, only restructure, correct, or add to the documentation. NEVER remove existing information
+never omit or change any code, including the constructor
+${constants_1.Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+        _meta: {},
+    };
+    return result;
+});
+//# sourceMappingURL=class-prompt.js.map

package/lib/prompts/jsdocs/class-prompt.d.ts

@@ -0,0 +1,2 @@
+import { PromptBuilder } from "../../builders/prompt-builder";
+export declare const TsDocClassPrompt: PromptBuilder;

package/lib/prompts/jsdocs/class-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-prompt.js","sourceRoot":"","sources":["../../../src/prompts/jsdocs/class-prompt.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+CAAsD;AAOtD,wEAA8D;AAC9D,qDAAiD;AAEjD,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAEpC,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGnB,QAAA,gBAAgB,GAAkB,8BAAa,CAAC,OAAO;KACjE,OAAO,CAAC,UAAU,CAAC;KACnB,QAAQ,CAAC,qBAAqB,CAAC;KAC/B,cAAc,CACb,4FAA4F,CAC7F;KACA,aAAa,CAAC,UAAiB,CAAC;KAChC,YAAY,CAAC,0BAAc,CAAC,KAAK,CAAC;KAClC,KAAK,CACJ;AACE,6DAA6D;AAC7D,IAAU;AACV,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,MAAM,GAAG,GAAG,2BAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BrC,kBAAM,EAAE,CAAC;IACL,MAAM,MAAM,GAAoB;QAC9B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;QACrE,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC,CACF,CAAC"}

package/lib/prompts/jsdocs/const-prompt.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsDocConstPrompt = void 0;
+const zod_1 = require("zod");
+const constants_1 = require("./constants.cjs");
+const prompt_builder_1 = require("./../../builders/prompt-builder.cjs");
+const promptName = "ts.jsdoc.const";
+const argsSchema = zod_1.z.object({});
+exports.TsDocConstPrompt = prompt_builder_1.PromptBuilder.builder
+    .setName(promptName)
+    .setTitle("Const JSDocs Prompt")
+    .setDescription("Generate JSDoc comments for a TypeScript constant according to a curated template and prompt.")
+    .setArgsSchema(argsSchema)
+    .setCb((
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+args, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+extra) => {
+    const prompt = `${constants_1.BaseJSDocPrompt}
+${constants_1.ConstantsPrompt}
+${constants_1.Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=const-prompt.js.map

package/lib/prompts/jsdocs/const-prompt.d.ts

@@ -0,0 +1,2 @@
+import { PromptBuilder } from "../../builders/prompt-builder";
+export declare const TsDocConstPrompt: PromptBuilder;

package/lib/prompts/jsdocs/const-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const-prompt.js","sourceRoot":"","sources":["../../../src/prompts/jsdocs/const-prompt.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+CAAuE;AAOvE,wEAA8D;AAE9D,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAEpC,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGnB,QAAA,gBAAgB,GAAkB,8BAAa,CAAC,OAAO;KACjE,OAAO,CAAC,UAAU,CAAC;KACnB,QAAQ,CAAC,qBAAqB,CAAC;KAC/B,cAAc,CACb,+FAA+F,CAChG;KACA,aAAa,CAAC,UAAiB,CAAC;KAChC,KAAK,CACJ;AACE,6DAA6D;AAC7D,IAAU;AACV,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,MAAM,GAAG,GAAG,2BAAe;EACrC,2BAAe;EACf,kBAAM,EAAE,CAAC;IAEL,MAAM,MAAM,GAAoB;QAC9B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;KACtE,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC,CACF,CAAC"}

package/lib/prompts/jsdocs/constants.cjs

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Footer = exports.ConstantsPrompt = exports.TypesPrompt = exports.BaseJSDocPrompt = void 0;
+exports.BaseJSDocPrompt = `You're a senior TypeScript developer writing JSDoc documentation for a class to be used with better-docs. Given the module code:
+Generate a JSDoc comment block for a TypeScript module file using better-docs formatting:`;
+exports.TypesPrompt = `document the target code, always including the @description tag with a short description of the target, and a@summary tag with a more detailed one.
+  Include @interface and @typeDef an @template tags when appropriate.
+  Include detailed @description for all properties.
+  For methods, include @description and @summary tags as defined for the target. also document every argument, including its type definition, and return type, referencing @template tags when necessary.
+
+  The order of tags  (when applicable) should be as follows:
+1 - @description;
+2 - @summary;
+3 - @template;
+4 - @param;
+5 - @return;
+6 - @interface or @typeDef followed by the interface or type name;
+8 - @memberOf referencing the appropriate module using the appropriate syntax
+
+Output only the completed JSDoc comment block for the type or interface.
+refer to the module it belongs with @memberOf this the \`@memberOf module:<module_name>\` syntax
+never omit or change any code
+if the element is already documented, only restructure, correct, or add to the documentation. NEVER remove existing information`;
+exports.ConstantsPrompt = `document the target code, always including the @description tag with a short description of the target, and a@summary tag with a more detailed one.
+Include @const and @typeDef tags when appropriate.
+Include detailed @description for all properties.
+- For enums, include @enum and @readonly, and add inline documentation for each member
+- For object-like constants:
+    - Create a @typedef with @property for each key
+    - Reference it in the constant using @type
+    - Alternatively, document each key inline if small
+
+The order of tags  (when applicable) should be as follows:
+1 - @description;
+2 - @summary;
+3 - @template;
+4 - @property;
+6 - @const followed by the const or enum name;
+8 - @memberOf referencing the appropriate module using the appropriate syntax
+
+Respond with the JSDoc comment block(s) for both the typedef and the constant or enum.
+refer to the module it belongs with @memberOf this the \`@memberOf module:<module_name>\` syntax
+never omit or change any code
+if the element is already documented, only restructure, correct, or add to the documentation. NEVER remove existing information`;
+exports.Footer = `NOTES:
+ - when document a function/method parameters, and there is a template type involved, ALWAYS reference it using the @template tag;
+ - when documenting a function type as a parameter, ALWAYS use the function(type1,type2):return_type syntax;
+ `;
+//# sourceMappingURL=constants.js.map

package/lib/prompts/jsdocs/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const BaseJSDocPrompt = "You're a senior TypeScript developer writing JSDoc documentation for a class to be used with better-docs. Given the module code:\nGenerate a JSDoc comment block for a TypeScript module file using better-docs formatting:";
+export declare const TypesPrompt = "document the target code, always including the @description tag with a short description of the target, and a@summary tag with a more detailed one.\n  Include @interface and @typeDef an @template tags when appropriate.\n  Include detailed @description for all properties.\n  For methods, include @description and @summary tags as defined for the target. also document every argument, including its type definition, and return type, referencing @template tags when necessary.\n\n  The order of tags  (when applicable) should be as follows:\n1 - @description;\n2 - @summary;\n3 - @template;\n4 - @param;\n5 - @return;\n6 - @interface or @typeDef followed by the interface or type name;\n8 - @memberOf referencing the appropriate module using the appropriate syntax\n\nOutput only the completed JSDoc comment block for the type or interface.\nrefer to the module it belongs with @memberOf this the `@memberOf module:<module_name>` syntax\nnever omit or change any code\nif the element is already documented, only restructure, correct, or add to the documentation. NEVER remove existing information";
+export declare const ConstantsPrompt = "document the target code, always including the @description tag with a short description of the target, and a@summary tag with a more detailed one.\nInclude @const and @typeDef tags when appropriate.\nInclude detailed @description for all properties.\n- For enums, include @enum and @readonly, and add inline documentation for each member\n- For object-like constants:\n    - Create a @typedef with @property for each key\n    - Reference it in the constant using @type\n    - Alternatively, document each key inline if small\n\nThe order of tags  (when applicable) should be as follows:\n1 - @description;\n2 - @summary;\n3 - @template;\n4 - @property;\n6 - @const followed by the const or enum name;\n8 - @memberOf referencing the appropriate module using the appropriate syntax\n\nRespond with the JSDoc comment block(s) for both the typedef and the constant or enum.\nrefer to the module it belongs with @memberOf this the `@memberOf module:<module_name>` syntax\nnever omit or change any code\nif the element is already documented, only restructure, correct, or add to the documentation. NEVER remove existing information";
+export declare const Footer = "NOTES:\n - when document a function/method parameters, and there is a template type involved, ALWAYS reference it using the @template tag;\n - when documenting a function type as a parameter, ALWAYS use the function(type1,type2):return_type syntax;\n ";

package/lib/prompts/jsdocs/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/prompts/jsdocs/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG;0FAC2D,CAAC;AAE9E,QAAA,WAAW,GAAG;;;;;;;;;;;;;;;;;gIAiBqG,CAAC;AAEpH,QAAA,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;gIAoBiG,CAAC;AAEpH,QAAA,MAAM,GAAG;;;EAGpB,CAAC"}

package/lib/prompts/jsdocs/decorator-prompt.cjs

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsDocDecoratorPrompt = void 0;
+const zod_1 = require("zod");
+const constants_1 = require("./constants.cjs");
+const prompt_builder_1 = require("./../../builders/prompt-builder.cjs");
+const promptName = "ts.jsdoc.decorator";
+const argsSchema = zod_1.z.object({});
+exports.TsDocDecoratorPrompt = prompt_builder_1.PromptBuilder.builder
+    .setName(promptName)
+    .setTitle("Decorator JSDocs Prompt")
+    .setDescription("Generate JSDoc comments for a TypeScript Decorator according to a curated template and prompt.")
+    .setArgsSchema(argsSchema)
+    .setCb((
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+args, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+extra) => {
+    const prompt = `${constants_1.BaseJSDocPrompt}
+document the target code, always including the @description tag with a short description of the target, and a@summary tag with a more detailed one.
+Include @function an @template tags when appropriate.
+Include detailed @description for all properties.
+For methods, include @description and @summary tags as defined for the target. also document every argument, including its type definition, and return type, referencing @template tags when necessary.
+create mermaid sequence diagrams under the @mermaid tag;
+
+The order of tags (when applicable) should be as follows:
+1 - @description;
+2 - @summary;
+3 - @template;
+4 - @param including type definitions;
+5 - @return;
+6 - @function followed by the interface or type name;
+7 - @mermaid with the sequence diagram for the function if it has over 10 lines
+8 - @category one of: "Decorators", "Class Decorators", "Method Decorators", "Property Decorators", "Parameter Decorators"
+Output only the full JSDoc comment block for the function.
+DO NOT refer to the module it belongs with @memberOf
+never omit or change any code
+if the element is already documented, only restructure, correct, or add to the documentation. NEVER remove existing information
+${constants_1.Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=decorator-prompt.js.map

package/lib/prompts/jsdocs/decorator-prompt.d.ts

@@ -0,0 +1,2 @@
+import { PromptBuilder } from "../../builders/prompt-builder";
+export declare const TsDocDecoratorPrompt: PromptBuilder;

package/lib/prompts/jsdocs/decorator-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-prompt.js","sourceRoot":"","sources":["../../../src/prompts/jsdocs/decorator-prompt.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+CAAsD;AAOtD,wEAA8D;AAE9D,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGnB,QAAA,oBAAoB,GAAkB,8BAAa,CAAC,OAAO;KACrE,OAAO,CAAC,UAAU,CAAC;KACnB,QAAQ,CAAC,yBAAyB,CAAC;KACnC,cAAc,CACb,gGAAgG,CACjG;KACA,aAAa,CAAC,UAAiB,CAAC;KAChC,KAAK,CACJ;AACE,6DAA6D;AAC7D,IAAU;AACV,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,MAAM,GAAG,GAAG,2BAAe;;;;;;;;;;;;;;;;;;;;EAoBrC,kBAAM,EAAE,CAAC;IAEL,MAAM,MAAM,GAAoB;QAC9B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;KACtE,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC,CACF,CAAC"}

package/lib/prompts/jsdocs/enum-prompt.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsDocEnumPrompt = void 0;
+const zod_1 = require("zod");
+const constants_1 = require("./constants.cjs");
+const prompt_builder_1 = require("./../../builders/prompt-builder.cjs");
+const promptName = "ts.jsdoc.enum";
+const argsSchema = zod_1.z.object({});
+exports.TsDocEnumPrompt = prompt_builder_1.PromptBuilder.builder
+    .setName(promptName)
+    .setTitle("Enum JSDocs Prompt")
+    .setDescription("Generate JSDoc comments for a TypeScript enum according to a curated template and prompt.")
+    .setArgsSchema(argsSchema)
+    .setCb((
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+args, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+extra) => {
+    const prompt = `${constants_1.BaseJSDocPrompt}
+${constants_1.ConstantsPrompt}
+${constants_1.Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=enum-prompt.js.map

package/lib/prompts/jsdocs/enum-prompt.d.ts

@@ -0,0 +1,2 @@
+import { PromptBuilder } from "../../builders/prompt-builder";
+export declare const TsDocEnumPrompt: PromptBuilder;

package/lib/prompts/jsdocs/enum-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-prompt.js","sourceRoot":"","sources":["../../../src/prompts/jsdocs/enum-prompt.ts"],"names":[],"mappings":";;;AACA,6BAAwB;AACxB,+CAAuE;AAOvE,wEAA8D;AAE9D,MAAM,UAAU,GAAG,eAAe,CAAC;AAEnC,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGnB,QAAA,eAAe,GAAkB,8BAAa,CAAC,OAAO;KAChE,OAAO,CAAC,UAAU,CAAC;KACnB,QAAQ,CAAC,oBAAoB,CAAC;KAC9B,cAAc,CACb,2FAA2F,CAC5F;KACA,aAAa,CAAC,UAAiB,CAAC;KAChC,KAAK,CACJ;AACE,6DAA6D;AAC7D,IAAU;AACV,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,MAAM,GAAG,GAAG,2BAAe;EACrC,2BAAe;EACf,kBAAM,EAAE,CAAC;IAEL,MAAM,MAAM,GAAoB;QAC9B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;KACtE,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC,CACF,CAAC"}

package/lib/prompts/jsdocs/function-prompt.cjs

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsDocFunctionPrompt = void 0;
+const zod_1 = require("zod");
+const constants_1 = require("./constants.cjs");
+const prompt_builder_1 = require("./../../builders/prompt-builder.cjs");
+const promptName = "ts.jsdoc.function";
+const argsSchema = zod_1.z.object({});
+exports.TsDocFunctionPrompt = prompt_builder_1.PromptBuilder.builder
+    .setName(promptName)
+    .setTitle("Function JSDocs Prompt")
+    .setDescription("Generate JSDoc comments for a TypeScript function according to a curated template and prompt.")
+    .setArgsSchema(argsSchema)
+    .setCb((
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+args, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+extra) => {
+    const prompt = `${constants_1.BaseJSDocPrompt}
+document the target code, always including the @description tag with a short description of the target, and a@summary tag with a more detailed one.
+Include @function an @template tags when appropriate.
+Include detailed @description for all properties.
+For methods, include @description and @summary tags as defined for the target. also document every argument, including its type definition, and return type, referencing @template tags when necessary.
+create mermaid sequence diagrams under the @mermaid tag;
+
+The order of tags (when applicable) should be as follows:
+1 - @description;
+2 - @summary;
+3 - @template;
+4 - @param including type definitions;
+5 - @return;
+6 - @function followed by the interface or type name;
+7 - @mermaid with the sequence diagram for the function if ithas over 10 lines
+8 - @memberOf referencing the appropriate module using the appropriate syntax
+
+Output only the full JSDoc comment block for the function.
+refer to the module it belongs with @memberOf this the \`@memberOf module:<module_name>\` syntax
+never omit or change any code
+if the element is already documented, only restructure, correct, or add to the documentation. NEVER remove existing information
+${constants_1.Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=function-prompt.js.map

package/lib/prompts/jsdocs/function-prompt.d.ts

@@ -0,0 +1,2 @@
+import { PromptBuilder } from "../../builders/prompt-builder";
+export declare const TsDocFunctionPrompt: PromptBuilder;

package/lib/prompts/jsdocs/function-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-prompt.js","sourceRoot":"","sources":["../../../src/prompts/jsdocs/function-prompt.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+CAAsD;AAOtD,wEAA8D;AAE9D,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGnB,QAAA,mBAAmB,GAAkB,8BAAa,CAAC,OAAO;KACpE,OAAO,CAAC,UAAU,CAAC;KACnB,QAAQ,CAAC,wBAAwB,CAAC;KAClC,cAAc,CACb,+FAA+F,CAChG;KACA,aAAa,CAAC,UAAiB,CAAC;KAChC,KAAK,CACJ;AACE,6DAA6D;AAC7D,IAAU;AACV,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,MAAM,GAAG,GAAG,2BAAe;;;;;;;;;;;;;;;;;;;;;EAqBrC,kBAAM,EAAE,CAAC;IAEL,MAAM,MAAM,GAAoB;QAC9B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;KACtE,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC,CACF,CAAC"}

package/lib/prompts/jsdocs/interface-prompt.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsDocInterfacePrompt = void 0;
+const zod_1 = require("zod");
+const constants_1 = require("./constants.cjs");
+const prompt_builder_1 = require("./../../builders/prompt-builder.cjs");
+const promptName = "ts.jsdoc.interface";
+const argsSchema = zod_1.z.object({});
+exports.TsDocInterfacePrompt = prompt_builder_1.PromptBuilder.builder
+    .setName(promptName)
+    .setTitle("Interface JSDocs Prompt")
+    .setDescription("Generate JSDoc comments for a TypeScript interface according to a curated template and prompt.")
+    .setArgsSchema(argsSchema)
+    .setCb((
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+args, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+extra) => {
+    const prompt = `${constants_1.BaseJSDocPrompt}
+${constants_1.TypesPrompt}
+${constants_1.Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=interface-prompt.js.map

package/lib/prompts/jsdocs/interface-prompt.d.ts

@@ -0,0 +1,2 @@
+import { PromptBuilder } from "../../builders/prompt-builder";
+export declare const TsDocInterfacePrompt: PromptBuilder;

package/lib/prompts/jsdocs/interface-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-prompt.js","sourceRoot":"","sources":["../../../src/prompts/jsdocs/interface-prompt.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+CAAmE;AAOnE,wEAA8D;AAE9D,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGnB,QAAA,oBAAoB,GAAkB,8BAAa,CAAC,OAAO;KACrE,OAAO,CAAC,UAAU,CAAC;KACnB,QAAQ,CAAC,yBAAyB,CAAC;KACnC,cAAc,CACb,gGAAgG,CACjG;KACA,aAAa,CAAC,UAAiB,CAAC;KAChC,KAAK,CACJ;AACE,6DAA6D;AAC7D,IAAU;AACV,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,MAAM,GAAG,GAAG,2BAAe;EACrC,uBAAW;EACX,kBAAM,EAAE,CAAC;IAEL,MAAM,MAAM,GAAoB;QAC9B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;KACtE,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC,CACF,CAAC"}

package/lib/prompts/jsdocs/types-prompt.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsDocTypeePrompt = void 0;
+const zod_1 = require("zod");
+const constants_1 = require("./constants.cjs");
+const prompt_builder_1 = require("./../../builders/prompt-builder.cjs");
+const promptName = "ts.jsdoc.type";
+const argsSchema = zod_1.z.object({});
+exports.TsDocTypeePrompt = prompt_builder_1.PromptBuilder.builder
+    .setName(promptName)
+    .setTitle("Type JSDocs Prompt")
+    .setDescription("Generate JSDoc comments for a TypeScript type according to a curated template and prompt.")
+    .setArgsSchema(argsSchema)
+    .setCb((
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+args, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+extra) => {
+    const prompt = `${constants_1.BaseJSDocPrompt}
+${constants_1.TypesPrompt}
+${constants_1.Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=types-prompt.js.map

package/lib/prompts/jsdocs/types-prompt.d.ts

@@ -0,0 +1,2 @@
+import { PromptBuilder } from "../../builders/prompt-builder";
+export declare const TsDocTypeePrompt: PromptBuilder;

package/lib/prompts/jsdocs/types-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-prompt.js","sourceRoot":"","sources":["../../../src/prompts/jsdocs/types-prompt.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+CAAmE;AAOnE,wEAA8D;AAE9D,MAAM,UAAU,GAAG,eAAe,CAAC;AAEnC,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGnB,QAAA,gBAAgB,GAAkB,8BAAa,CAAC,OAAO;KACjE,OAAO,CAAC,UAAU,CAAC;KACnB,QAAQ,CAAC,oBAAoB,CAAC;KAC9B,cAAc,CACb,2FAA2F,CAC5F;KACA,aAAa,CAAC,UAAiB,CAAC;KAChC,KAAK,CACJ;AACE,6DAA6D;AAC7D,IAAU;AACV,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,MAAM,GAAG,GAAG,2BAAe;EACrC,uBAAW;EACX,kBAAM,EAAE,CAAC;IAEL,MAAM,MAAM,GAAoB;QAC9B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;KACtE,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC,CACF,CAAC"}

package/lib/resources/example-resource/index.cjs

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExampleResource = void 0;
+const resource_builder_1 = require("./../../builders/resource-builder.cjs");
+const constants_1 = require("./../../constants.cjs");
+exports.ExampleResource = resource_builder_1.ResourceBuilder.builder
+    .setName("example.resource.hello")
+    .setTitle("Example: Hello Resource")
+    .setDescription("A tiny example resource that returns a simple payload for any URI.")
+    .setUriOtTemplate("example://hello/{name}")
+    .setConfig({ description: "Example resource", _meta: { usage: { reasoning: constants_1.ReasoningLevel.NONE, effort: constants_1.EffortLevel.NONE, cost: constants_1.Cost.FREE } } })
+    .setCb(async (_uri, _extra) => {
+    const payload = {
+        content: {
+            type: "text",
+            text: "hello from example resource",
+        },
+        _meta: {},
+    };
+    return payload;
+});
+//# sourceMappingURL=index.js.map

package/lib/resources/example-resource/index.d.ts

@@ -0,0 +1,2 @@
+import { ResourceBuilder } from "../../builders/resource-builder";
+export declare const ExampleResource: ResourceBuilder;

package/lib/resources/example-resource/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/example-resource/index.ts"],"names":[],"mappings":";;;AAAA,4EAAkE;AAOlE,qDAAoE;AAEvD,QAAA,eAAe,GAAG,kCAAe,CAAC,OAAO;KACnD,OAAO,CAAC,wBAAwB,CAAC;KACjC,QAAQ,CAAC,yBAAyB,CAAC;KACnC,cAAc,CAAC,oEAAoE,CAAC;KACpF,gBAAgB,CAAC,wBAAwB,CAAC;KAC1C,SAAS,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,0BAAc,CAAC,IAAI,EAAE,MAAM,EAAE,uBAAW,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;KAC/I,KAAK,CAAC,KAAK,EAAE,IAAS,EAAE,MAA8D,EAAE,EAAE;IACzF,MAAM,OAAO,GAAuB;QAClC,OAAO,EAAE;YACP,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,6BAA6B;SACpC;QACD,KAAK,EAAE,EAAE;KACH,CAAC;IACT,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC,CACD"}

package/lib/resources/index.cjs

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Resources = void 0;
+const example_resource_1 = require("./example-resource/index.cjs");
+const repo_metadata_1 = require("./repo-metadata/index.cjs");
+exports.Resources = [example_resource_1.ExampleResource, repo_metadata_1.RepoMetadataResource];
+//# sourceMappingURL=index.js.map

package/lib/resources/index.d.ts

@@ -0,0 +1,2 @@
+import { ResourceBuilder } from "../builders/resource-builder";
+export declare const Resources: ResourceBuilder[];

package/lib/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":";;;AACA,mEAAqD;AACrD,6DAAuD;AAE1C,QAAA,SAAS,GAAsB,CAAC,kCAAe,EAAE,oCAAoB,CAAC,CAAC"}

package/lib/resources/repo-metadata/index.cjs

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RepoMetadataResource = void 0;
+const resource_builder_1 = require("./../../builders/resource-builder.cjs");
+const constants_1 = require("./../../constants.cjs");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+exports.RepoMetadataResource = resource_builder_1.ResourceBuilder.builder
+    .setName("repo.metadata")
+    .setTitle("Repository Metadata Resource")
+    .setDescription("Expose basic repository metadata such as package.json and lint rules.")
+    .setUriOtTemplate("repo://metadata/{file}")
+    .setConfig({ description: "Repository metadata resource", _meta: { usage: { reasoning: constants_1.ReasoningLevel.NONE, effort: constants_1.EffortLevel.NONE, cost: constants_1.Cost.FREE } } })
+    .setCb(async (uri, _extra) => {
+    const file = uri.pathname.replace(/^\//, "") || "package.json";
+    try {
+        const p = (0, path_1.resolve)(process.cwd(), file);
+        const raw = await (0, promises_1.readFile)(p, { encoding: "utf8" });
+        const parsed = JSON.parse(raw);
+        const payload = { content: { type: "json", data: JSON.stringify(parsed) }, _meta: {} };
+        return payload;
+    }
+    catch (e) {
+        const payload = { content: { type: "text", text: "" }, _meta: {} };
+        return payload;
+    }
+});
+//# sourceMappingURL=index.js.map

package/lib/resources/repo-metadata/index.d.ts

@@ -0,0 +1,2 @@
+import { ResourceBuilder } from "../../builders/resource-builder";
+export declare const RepoMetadataResource: ResourceBuilder;

package/lib/resources/repo-metadata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/repo-metadata/index.ts"],"names":[],"mappings":";;;AAAA,4EAAkE;AAOlE,qDAAoE;AACpE,0CAAuC;AACvC,+BAA+B;AAElB,QAAA,oBAAoB,GAAG,kCAAe,CAAC,OAAO;KACxD,OAAO,CAAC,eAAe,CAAC;KACxB,QAAQ,CAAC,8BAA8B,CAAC;KACxC,cAAc,CAAC,uEAAuE,CAAC;KACvF,gBAAgB,CAAC,wBAAwB,CAAC;KAC1C,SAAS,CAAC,EAAE,WAAW,EAAE,8BAA8B,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,0BAAc,CAAC,IAAI,EAAE,MAAM,EAAE,uBAAW,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;KAC3J,KAAK,CAAC,KAAK,EAAE,GAAQ,EAAE,MAA8D,EAAE,EAAE;IACxF,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC;IAC/D,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAA,cAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,IAAA,mBAAQ,EAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAuB,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAS,CAAC;QAClH,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,OAAO,GAAuB,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAS,CAAC;QAC9F,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/lib/tools/ast/ts-ast-tool.cjs

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsAstTool = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("./utils.cjs");
+const tool_builder_1 = require("./../../builders/tool-builder.cjs");
+const toolName = "ts.ast.extract";
+const toolTitle = "AST Extraction Tool for TypeScript";
+const inputSchema = zod_1.z
+    .object({
+    filePath: zod_1.z
+        .string()
+        .describe("The path to the TypeScript file to analyze."),
+})
+    .describe(`the input schema for the ${toolName} tool`);
+const outputSchema = zod_1.z
+    .object({})
+    .describe(`the output schema for the ${toolName} tool`);
+exports.TsAstTool = tool_builder_1.ToolBuilder.builder
+    .setName(toolName)
+    .setTitle(toolTitle)
+    .setDescription("Extracts and analyzes the Abstract Syntax Tree (AST) of TypeScript code to provide insights into its structure and components.")
+    .setInputSchema(inputSchema)
+    // This tool returns a list of content blocks (in `content`) rather than a
+    // structured object; do not set an outputSchema to avoid requiring
+    // `structuredContent` in the CallToolResult.
+    .setAnnotations({
+    title: toolTitle,
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+})
+    .setCb(async (args, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+extra) => {
+    const { filePath } = args;
+    // Guard analyzeFile with a short overall timeout so a slow ts-morph
+    // resolution won't block the integration test indefinitely.
+    const res = await Promise.race([
+        (0, utils_1.analyzeFile)(filePath),
+        new Promise((res) => setTimeout(() => res(null), 1500)),
+    ]);
+    if (!res || !res.astObjects) {
+        // return an empty content array (CallToolResult expects an object; we
+        // provide readable content and a lightweight structuredContent)
+        return {
+            content: [{ type: "text", text: "No AST objects or analysis timed out" }],
+            structuredContent: { astObjects: [] },
+        };
+    }
+    // Normalize shape to AstObject as much as possible
+    const objects = res.astObjects.map((o) => ({
+        id: o.id,
+        name: o.name,
+        kind: o.kind || "unknown",
+        location: o.location,
+        isExported: !!o.isExported,
+        signature: o.signature,
+        parentId: o.parentId,
+        children: o.children,
+        decorators: o.decorators,
+        contextHints: o.contextHints || [],
+    }));
+    return {
+        content: [{ type: "text", text: `Found ${objects.length} AST objects` }],
+        structuredContent: { astObjects: objects },
+    };
+});
+//# sourceMappingURL=ts-ast-tool.js.map