@decaf-ts/mcp-server 0.4.1 → 0.4.6

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

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { BaseJSDocPrompt, Footer } from "./constants.js";
+import { PromptBuilder } from "./../../builders/prompt-builder.js";
+const promptName = "ts.jsdoc.decorator";
+const argsSchema = z.object({});
+export const TsDocDecoratorPrompt = 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 = `${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
+${Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=decorator-prompt.js.map

package/lib/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,uBAAoB;AAOtD,OAAO,EAAE,aAAa,EAAE,2CAAsC;AAE9D,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGhC,MAAM,CAAC,MAAM,oBAAoB,GAAkB,aAAa,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,eAAe;;;;;;;;;;;;;;;;;;;;EAoBrC,MAAM,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/esm/prompts/jsdocs/enum-prompt.d.ts

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

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

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { BaseJSDocPrompt, ConstantsPrompt, Footer } from "./constants.js";
+import { PromptBuilder } from "./../../builders/prompt-builder.js";
+const promptName = "ts.jsdoc.enum";
+const argsSchema = z.object({});
+export const TsDocEnumPrompt = 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 = `${BaseJSDocPrompt}
+${ConstantsPrompt}
+${Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=enum-prompt.js.map

package/lib/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,EAAE,uBAAoB;AAOvE,OAAO,EAAE,aAAa,EAAE,2CAAsC;AAE9D,MAAM,UAAU,GAAG,eAAe,CAAC;AAEnC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGhC,MAAM,CAAC,MAAM,eAAe,GAAkB,aAAa,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,eAAe;EACrC,eAAe;EACf,MAAM,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/esm/prompts/jsdocs/function-prompt.d.ts

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

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

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { BaseJSDocPrompt, Footer } from "./constants.js";
+import { PromptBuilder } from "./../../builders/prompt-builder.js";
+const promptName = "ts.jsdoc.function";
+const argsSchema = z.object({});
+export const TsDocFunctionPrompt = 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 = `${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
+${Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=function-prompt.js.map

package/lib/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,uBAAoB;AAOtD,OAAO,EAAE,aAAa,EAAE,2CAAsC;AAE9D,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGhC,MAAM,CAAC,MAAM,mBAAmB,GAAkB,aAAa,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,eAAe;;;;;;;;;;;;;;;;;;;;;EAqBrC,MAAM,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/esm/prompts/jsdocs/interface-prompt.d.ts

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

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

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { BaseJSDocPrompt, Footer, TypesPrompt } from "./constants.js";
+import { PromptBuilder } from "./../../builders/prompt-builder.js";
+const promptName = "ts.jsdoc.interface";
+const argsSchema = z.object({});
+export const TsDocInterfacePrompt = 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 = `${BaseJSDocPrompt}
+${TypesPrompt}
+${Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=interface-prompt.js.map

package/lib/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,uBAAoB;AAOnE,OAAO,EAAE,aAAa,EAAE,2CAAsC;AAE9D,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGhC,MAAM,CAAC,MAAM,oBAAoB,GAAkB,aAAa,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,eAAe;EACrC,WAAW;EACX,MAAM,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/esm/prompts/jsdocs/types-prompt.d.ts

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

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

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { BaseJSDocPrompt, Footer, TypesPrompt } from "./constants.js";
+import { PromptBuilder } from "./../../builders/prompt-builder.js";
+const promptName = "ts.jsdoc.type";
+const argsSchema = z.object({});
+export const TsDocTypeePrompt = 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 = `${BaseJSDocPrompt}
+${TypesPrompt}
+${Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=types-prompt.js.map

package/lib/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,uBAAoB;AAOnE,OAAO,EAAE,aAAa,EAAE,2CAAsC;AAE9D,MAAM,UAAU,GAAG,eAAe,CAAC;AAEnC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGhC,MAAM,CAAC,MAAM,gBAAgB,GAAkB,aAAa,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,eAAe;EACrC,WAAW;EACX,MAAM,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/esm/resources/example-resource/index.d.ts

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

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

@@ -0,0 +1,19 @@
+import { ResourceBuilder } from "./../../builders/resource-builder.js";
+import { ReasoningLevel, EffortLevel, Cost } from "./../../constants.js";
+export const ExampleResource = 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: ReasoningLevel.NONE, effort: EffortLevel.NONE, cost: 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/esm/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,OAAO,EAAE,eAAe,EAAE,6CAAwC;AAOlE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,6BAAwB;AAEpE,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,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,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,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/esm/resources/index.d.ts

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

package/lib/esm/resources/index.js

@@ -0,0 +1,4 @@
+import { ExampleResource } from "./example-resource/index.js";
+import { RepoMetadataResource } from "./repo-metadata/index.js";
+export const Resources = [ExampleResource, RepoMetadataResource];
+//# sourceMappingURL=index.js.map

package/lib/esm/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,oCAA2B;AACrD,OAAO,EAAE,oBAAoB,EAAE,iCAAwB;AAEvD,MAAM,CAAC,MAAM,SAAS,GAAsB,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC"}

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

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

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

@@ -0,0 +1,25 @@
+import { ResourceBuilder } from "./../../builders/resource-builder.js";
+import { ReasoningLevel, EffortLevel, Cost } from "./../../constants.js";
+import { readFile } from "fs/promises";
+import { resolve } from "path";
+export const RepoMetadataResource = 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: ReasoningLevel.NONE, effort: EffortLevel.NONE, cost: Cost.FREE } } })
+    .setCb(async (uri, _extra) => {
+    const file = uri.pathname.replace(/^\//, "") || "package.json";
+    try {
+        const p = resolve(process.cwd(), file);
+        const raw = await 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/esm/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,OAAO,EAAE,eAAe,EAAE,6CAAwC;AAOlE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,6BAAwB;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,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,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,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,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,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/esm/tools/ast/ts-ast-tool.d.ts

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

package/lib/esm/tools/ast/ts-ast-tool.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { analyzeFile } from "./utils.js";
+import { ToolBuilder } from "./../../builders/tool-builder.js";
+const toolName = "ts.ast.extract";
+const toolTitle = "AST Extraction Tool for TypeScript";
+const inputSchema = z
+    .object({
+    filePath: z
+        .string()
+        .describe("The path to the TypeScript file to analyze."),
+})
+    .describe(`the input schema for the ${toolName} tool`);
+const outputSchema = z
+    .object({})
+    .describe(`the output schema for the ${toolName} tool`);
+export const TsAstTool = 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([
+        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

package/lib/esm/tools/ast/ts-ast-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-ast-tool.js","sourceRoot":"","sources":["../../../../src/tools/ast/ts-ast-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,mBAAgB;AAMtC,OAAO,EAAE,WAAW,EAAE,yCAAoC;AAE1D,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAElC,MAAM,SAAS,GAAG,oCAAoC,CAAC;AAEvD,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,6CAA6C,CAAC;CAC3D,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,SAAS,GAAgB,WAAW,CAAC,OAAO;KACtD,OAAO,CAAC,QAAQ,CAAC;KACjB,QAAQ,CAAC,SAAS,CAAC;KACnB,cAAc,CACb,gIAAgI,CACjI;KACA,cAAc,CAAC,WAAW,CAAC;IAC5B,0EAA0E;IAC1E,mEAAmE;IACnE,6CAA6C;KAC5C,cAAc,CAAC;IACd,KAAK,EAAE,SAAS;IAChB,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,KAAK;CACrB,CAAC;KACD,KAAK,CACJ,KAAK,EACH,IAAS;AACT,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC1B,oEAAoE;IACpE,4DAA4D;IAC5D,MAAM,GAAG,GAAQ,MAAM,OAAO,CAAC,IAAI,CAAC;QAClC,WAAW,CAAC,QAAQ,CAAC;QACrB,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;KACxD,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QAC5B,sEAAsE;QACtE,gEAAgE;QAChE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAAC;YACzE,iBAAiB,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;SAC/B,CAAC;IACX,CAAC;IACD,mDAAmD;IACnD,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;QAC9C,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAG,CAAC,CAAC,IAAY,IAAI,SAAS;QAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU;QAC1B,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE;KACnC,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,CAAC,MAAM,cAAc,EAAE,CAAC;QACxE,iBAAiB,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE;KACpC,CAAC;AACX,CAAC,CACF,CAAC"}

package/lib/esm/tools/ast/types.d.ts

@@ -0,0 +1,105 @@
+import { z } from "zod";
+export type AstObjectKind = "class" | "function" | "interface" | "type" | "enum" | "constant" | "module" | "namespace" | "decorator" | "cli-module";
+export declare const zAstObjectKind: z.ZodEnum<["class", "function", "interface", "type", "enum", "constant", "module", "namespace", "decorator", "cli-module"]>;
+export interface SourceLocation {
+    filePath: string;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}
+export declare const zSourceLocation: z.ZodObject<{
+    filePath: z.ZodString;
+    startLine: z.ZodNumber;
+    startColumn: z.ZodNumber;
+    endLine: z.ZodNumber;
+    endColumn: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}, {
+    filePath: string;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}>;
+export interface AstObject {
+    id: string;
+    name: string;
+    kind: AstObjectKind;
+    location: SourceLocation;
+    isExported: boolean;
+    signature?: string;
+    parentId?: string;
+    children?: string[];
+    decorators?: string[];
+    contextHints?: string[];
+}
+export declare const zAstObject: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodEnum<["class", "function", "interface", "type", "enum", "constant", "module", "namespace", "decorator", "cli-module"]>;
+    location: z.ZodObject<{
+        filePath: z.ZodString;
+        startLine: z.ZodNumber;
+        startColumn: z.ZodNumber;
+        endLine: z.ZodNumber;
+        endColumn: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        filePath: string;
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+    }, {
+        filePath: string;
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+    }>;
+    isExported: z.ZodBoolean;
+    signature: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodOptional<z.ZodString>;
+    children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    decorators: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    contextHints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    kind: "function" | "type" | "class" | "interface" | "enum" | "constant" | "module" | "namespace" | "decorator" | "cli-module";
+    id: string;
+    location: {
+        filePath: string;
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+    };
+    isExported: boolean;
+    signature?: string | undefined;
+    parentId?: string | undefined;
+    children?: string[] | undefined;
+    decorators?: string[] | undefined;
+    contextHints?: string[] | undefined;
+}, {
+    name: string;
+    kind: "function" | "type" | "class" | "interface" | "enum" | "constant" | "module" | "namespace" | "decorator" | "cli-module";
+    id: string;
+    location: {
+        filePath: string;
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+    };
+    isExported: boolean;
+    signature?: string | undefined;
+    parentId?: string | undefined;
+    children?: string[] | undefined;
+    decorators?: string[] | undefined;
+    contextHints?: string[] | undefined;
+}>;

package/lib/esm/tools/ast/types.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export const zAstObjectKind = z.enum([
+    "class",
+    "function",
+    "interface",
+    "type",
+    "enum",
+    "constant",
+    "module",
+    "namespace",
+    "decorator",
+    "cli-module",
+]);
+export const zSourceLocation = z.object({
+    filePath: z.string(),
+    startLine: z.number().int().nonnegative(),
+    startColumn: z.number().int().nonnegative(),
+    endLine: z.number().int().nonnegative(),
+    endColumn: z.number().int().nonnegative(),
+});
+export const zAstObject = z.object({
+    id: z.string(),
+    name: z.string(),
+    kind: zAstObjectKind,
+    location: zSourceLocation,
+    isExported: z.boolean(),
+    signature: z.string().optional(),
+    parentId: z.string().optional(),
+    children: z.array(z.string()).optional(),
+    decorators: z.array(z.string()).optional(),
+    contextHints: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=types.js.map

package/lib/esm/tools/ast/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/ast/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,OAAO;IACP,UAAU;IACV,WAAW;IACX,MAAM;IACN,MAAM;IACN,UAAU;IACV,QAAQ;IACR,WAAW;IACX,WAAW;IACX,YAAY;CACb,CAAC,CAAC;AAUH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC1C,CAAC,CAAC;AAeH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC"}

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

@@ -0,0 +1,5 @@
+import { Project } from "ts-morph";
+export declare function getProject(rootDir?: string): Project;
+export declare function analyzeFile(filePath: string): Promise<{
+    astObjects: any[];
+}>;

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

@@ -0,0 +1,58 @@
+import { Project } from "ts-morph";
+import path from "path";
+let _project = null;
+export function getProject(rootDir) {
+    if (_project)
+        return _project;
+    _project = new Project({
+        tsConfigFilePath: rootDir ? path.join(rootDir, "tsconfig.json") : undefined,
+        skipAddingFilesFromTsConfig: true,
+    });
+    return _project;
+}
+export async function analyzeFile(filePath) {
+    const project = getProject();
+    const source = project.addSourceFileAtPathIfExists(filePath) ||
+        project.createSourceFile(filePath, undefined, { overwrite: false });
+    // Resolve dependencies but don't allow this to block the server for too long
+    // (some environments may have large tsconfigs or slow IO). Use a short
+    // timeout so analyzeFile remains responsive in tests and integrations.
+    try {
+        await Promise.race([
+            project.resolveSourceFileDependencies(),
+            new Promise((res) => setTimeout(res, 2000)),
+        ]);
+    }
+    catch (err) {
+        // ignore resolution errors — we can still extract basic info from the file
+    }
+    // Very small example extractor: list exported declarations
+    const exported = source.getExportedDeclarations();
+    const entries = Array.from(exported.entries());
+    const astObjects = entries.flatMap(([name, decls]) => decls.map((d) => {
+        // defensive accessors
+        const start = typeof d.getStartLineNumber === "function" ? d.getStartLineNumber() : 0;
+        const end = typeof d.getEndLineNumber === "function" ? d.getEndLineNumber() : 0;
+        const kind = typeof d.getKindName === "function"
+            ? String(d.getKindName()).toLowerCase()
+            : "unknown";
+        const startColumn = typeof d.getStartLinePos === "function"
+            ? d.getStartLinePos()
+            : 0;
+        return {
+            id: `${filePath}::${name}`,
+            name,
+            kind,
+            location: {
+                filePath,
+                startLine: start,
+                startColumn,
+                endLine: end,
+                endColumn: 0,
+            },
+            isExported: true,
+        };
+    }));
+    return { astObjects };
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/tools/ast/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAc,MAAM,UAAU,CAAC;AAC/C,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,IAAI,QAAQ,GAAmB,IAAI,CAAC;AAEpC,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,QAAQ,GAAG,IAAI,OAAO,CAAC;QACrB,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS;QAC3E,2BAA2B,EAAE,IAAI;KAClC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,MAAM,GACV,OAAO,CAAC,2BAA2B,CAAC,QAAQ,CAAC;QAC7C,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAEtE,6EAA6E;IAC7E,uEAAuE;IACvE,uEAAuE;IACvE,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,OAAO,CAAC,6BAA6B,EAAE;YACvC,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,2EAA2E;IAC7E,CAAC;IAED,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,uBAAuB,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAClD,KAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACzB,sBAAsB;QACtB,MAAM,KAAK,GACT,OAAO,CAAC,CAAC,kBAAkB,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,GAAG,GACP,OAAO,CAAC,CAAC,gBAAgB,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,MAAM,IAAI,GACR,OAAO,CAAC,CAAC,WAAW,KAAK,UAAU;YACjC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE;YACvC,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,WAAW,GACf,OAAQ,CAAS,CAAC,eAAe,KAAK,UAAU;YAC9C,CAAC,CAAE,CAAS,CAAC,eAAe,EAAE;YAC9B,CAAC,CAAC,CAAC,CAAC;QACR,OAAO;YACL,EAAE,EAAE,GAAG,QAAQ,KAAK,IAAI,EAAE;YAC1B,IAAI;YACJ,IAAI;YACJ,QAAQ,EAAE;gBACR,QAAQ;gBACR,SAAS,EAAE,KAAK;gBAChB,WAAW;gBACX,OAAO,EAAE,GAAG;gBACZ,SAAS,EAAE,CAAC;aACb;YACD,UAAU,EAAE,IAAI;SACV,CAAC;IACX,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC"}

package/lib/esm/tools/ast-jsdoc-tools/apply.d.ts

@@ -0,0 +1,6 @@
+import { JSDocSuggestion } from './generator';
+export declare function backupFile(filePath: string): string;
+export declare function applySuggestionsToFile(filePath: string, suggestions: JSDocSuggestion[]): {
+    backup?: string;
+    written: boolean;
+};

package/lib/esm/tools/ast-jsdoc-tools/apply.js

@@ -0,0 +1,29 @@
+import fs from 'fs';
+import path from 'path';
+import { applyJSDocToContent } from "./formatter.js";
+export function backupFile(filePath) {
+    const abs = path.resolve(filePath);
+    const dir = path.dirname(abs);
+    const base = path.basename(abs);
+    const ts = Date.now();
+    const outName = path.join(dir, `.backup.${base}.${ts}`);
+    fs.copyFileSync(abs, outName);
+    return outName;
+}
+export function applySuggestionsToFile(filePath, suggestions) {
+    const abs = path.resolve(filePath);
+    if (!fs.existsSync(abs))
+        throw new Error(`file not found: ${abs}`);
+    const original = fs.readFileSync(abs, 'utf8');
+    let content = original;
+    for (const s of suggestions) {
+        // Attempt to guess symbol name from suggestion id (file::name)
+        const parts = s.id.split('::');
+        const symbol = parts[1] || '';
+        content = applyJSDocToContent(content, s, symbol);
+    }
+    const backup = backupFile(abs);
+    fs.writeFileSync(abs, content, 'utf8');
+    return { backup, written: true };
+}
+//# sourceMappingURL=apply.js.map

package/lib/esm/tools/ast-jsdoc-tools/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../../src/tools/ast-jsdoc-tools/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,uBAAoB;AAElD,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,WAA8B;IACrF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,+DAA+D;QAC/D,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC"}