@decaf-ts/mcp-server 0.4.2 → 0.4.6

package/lib/esm/mcp-server.js

@@ -0,0 +1,189 @@
+import { LoggedClass } from "@decaf-ts/logging";
+import { McpServer as MCP } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { printBanner } from "./utils/banner.js";
+import { Tools } from "./tools/index.js";
+import { Prompts } from "./prompts/index.js";
+import { Resources } from "./resources/index.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";
+import { v4 } from "uuid";
+import { SystemPrompt } from "./constants.js";
+import { Environment } from "./environment.js";
+export class McpServer extends LoggedClass {
+    get client() {
+        if (!this._mcp)
+            throw new Error("Mcp server requires Mcp client");
+        return this._mcp;
+    }
+    constructor() {
+        super();
+    }
+    async load() {
+        try {
+            const loadedResourced = await Promise.all(Resources.map((r) => r.build(this.client)));
+            this.log.verbose(`Loaded ${loadedResourced.length} resources`);
+            const loadedPrompts = await Promise.all(Prompts.map((r) => r.build(this.client)));
+            this.log.verbose(`Loaded ${loadedPrompts.length} prompts`);
+            const loadedTools = await Promise.all(Tools.map((r) => r.build(this.client)));
+            this.log.verbose(`Loaded ${loadedTools.length} tools`);
+            // Also attempt to load any exported builder-like objects from the tools module itself.
+            // Some modules export individual builders (not only the Tools array). Load those
+            // exported objects if they expose a `build` method and were not already loaded
+            // via the `Tools` array above.
+            try {
+                // dynamic import so this code runs at runtime and picks up whatever the module exports
+                // (uses the same resolution as the static imports above)
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const toolsModule = await import("./tools");
+                const candidates = Object.values(toolsModule).filter((v) => v && typeof v.build === "function");
+                // remove duplicates that are already present in Tools (by identity)
+                const toLoad = candidates.filter((c) => !Tools.includes(c));
+                if (toLoad.length > 0) {
+                    const loadedExported = await Promise.all(toLoad.map((t) => t.build(this.client)));
+                    this.log.verbose(`Loaded ${loadedExported.length} exported builders from tools module`);
+                }
+            }
+            catch (err) {
+                // don't fail the whole load if the dynamic step can't run; just log it for debugging
+                this.log.verbose(`No additional exported builders loaded from tools module: ${err}`);
+            }
+        }
+        catch (e) {
+            // nothing else. just for debugging
+            this.log.error(`Error loading core MCP components`, e);
+            throw e;
+        }
+    }
+    async boot(transportType = "stdio") {
+        const log = this.log;
+        this.log.for(this.boot).info("McpServer booting...");
+        printBanner(this.log);
+        const iconsRaw = Array.isArray(Environment.icons) ? Environment.icons : [Environment.icons];
+        const normalizedIcons = (iconsRaw || []).map((i) => {
+            const src = typeof i?.src === 'string' ? i.src : String(i?.src ?? '');
+            const mimeType = typeof i?.mimeType === 'string' ? i.mimeType : String(i?.mimeType ?? '');
+            let sizes = [];
+            if (Array.isArray(i?.sizes))
+                sizes = i.sizes.map((s) => String(s));
+            else if (typeof i?.sizes === 'string')
+                sizes = String(i.sizes).split(',').map((s) => s.trim());
+            return { src, mimeType, sizes };
+        });
+        // Normalize contacts: Environment may expose proxies or array-like objects
+        // (from the LoggedEnvironment proxy). Ensure a real array of plain objects
+        // with string fields is provided to the MCP protocol.
+        const contactsRaw = Environment.contacts;
+        let normalizedContacts;
+        if (typeof contactsRaw !== "undefined" && contactsRaw !== null) {
+            if (Array.isArray(contactsRaw)) {
+                normalizedContacts = contactsRaw.map((c) => ({
+                    name: typeof c?.name === "string" ? c.name : String(c?.name ?? ""),
+                    email: typeof c?.email === "string" ? c.email : c?.email ? String(c.email) : undefined,
+                    url: typeof c?.url === "string" ? c.url : c?.url ? String(c.url) : undefined,
+                }));
+            }
+            else if (typeof contactsRaw === "object") {
+                // Prefer numeric-indexed properties if present (handles array-like proxies)
+                const keys = Object.keys(contactsRaw || {});
+                const numericKeys = keys.filter((k) => /^[0-9]+$/.test(k)).sort((a, b) => Number(a) - Number(b));
+                if (numericKeys.length > 0) {
+                    normalizedContacts = numericKeys.map((k) => {
+                        const c = contactsRaw[k];
+                        return {
+                            name: typeof c?.name === "string" ? c.name : String(c?.name ?? ""),
+                            email: typeof c?.email === "string" ? c.email : c?.email ? String(c.email) : undefined,
+                            url: typeof c?.url === "string" ? c.url : c?.url ? String(c.url) : undefined,
+                        };
+                    });
+                }
+                else if (typeof contactsRaw.length === "number") {
+                    const len = Number(contactsRaw.length) || 0;
+                    normalizedContacts = [];
+                    for (let i = 0; i < len; i++) {
+                        const c = contactsRaw[i];
+                        normalizedContacts.push({
+                            name: typeof c?.name === "string" ? c.name : String(c?.name ?? ""),
+                            email: typeof c?.email === "string" ? c.email : c?.email ? String(c.email) : undefined,
+                            url: typeof c?.url === "string" ? c.url : c?.url ? String(c.url) : undefined,
+                        });
+                    }
+                }
+                else {
+                    // Fallback: collect own enumerable values but ignore the `length` pseudo-property
+                    normalizedContacts = Object.keys(contactsRaw)
+                        .filter((k) => k !== "length")
+                        .map((k) => {
+                        const c = contactsRaw[k];
+                        return {
+                            name: typeof c?.name === "string" ? c.name : String(c?.name ?? ""),
+                            email: typeof c?.email === "string" ? c.email : c?.email ? String(c.email) : undefined,
+                            url: typeof c?.url === "string" ? c.url : c?.url ? String(c.url) : undefined,
+                        };
+                    });
+                }
+            }
+        }
+        const serverInfo = {
+            id: Environment.mcpId,
+            name: Environment.name,
+            title: Environment.title,
+            description: Environment.description,
+            websiteUrl: Environment.websiteUrl,
+            repositoryUrl: Environment.repositoryUrl,
+            version: Environment.version,
+            license: Environment.license,
+            contacts: normalizedContacts,
+            tags: Environment.tags ? Environment.tags.split(",") : undefined,
+            metadata: Environment.metadata,
+            icons: normalizedIcons,
+        };
+        const options = {
+            instructions: SystemPrompt,
+            capabilities: {
+                logging: {},
+                completions: {},
+                resources: {
+                // subscribe: false,
+                // listChanged: false,
+                },
+                tools: {
+                // listChanged: false,
+                },
+                prompts: {
+                // listChanged: false,
+                },
+            },
+        };
+        this._mcp = new MCP(serverInfo, options);
+        try {
+            await this.load();
+        }
+        catch (err) {
+            this.log.error(`Error loading resources/prompts/tools: ${err}`);
+            throw err;
+        }
+        if (typeof transportType === "string") {
+            switch (transportType) {
+                case "stdio":
+                    transportType = new StdioServerTransport();
+                    break;
+                case "http":
+                    transportType = new StreamableHTTPServerTransport({
+                        sessionIdGenerator: () => v4(),
+                        onsessioninitialized: (sessionId) => log.verbose(`Session initialized: ${sessionId}`),
+                        onsessionclosed: (sessionId) => log.verbose(`Session closed: ${sessionId}`),
+                        enableJsonResponse: true,
+                        eventStore: undefined,
+                        allowedHosts: ["*"],
+                        allowedOrigins: ["*"],
+                        enableDnsRebindingProtection: true,
+                    });
+                    break;
+                default:
+                    throw new Error(`Invalid transport type: ${transportType}`);
+            }
+        }
+        return this.client.connect(transportType);
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/lib/esm/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../../src/mcp-server.ts"],"names":[],"mappings":"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"}

package/lib/esm/modules/template-module/index.d.ts

@@ -0,0 +1,6 @@
+import { ToolBuilder } from "../../builders/tool-builder";
+import { ResourceBuilder } from "../../builders/resource-builder";
+import { PromptBuilder } from "../../builders/prompt-builder";
+export declare const Tools: ToolBuilder[];
+export declare const Resources: ResourceBuilder[];
+export declare const Prompts: PromptBuilder[];

package/lib/esm/modules/template-module/index.js

@@ -0,0 +1,4 @@
+export const Tools = [];
+export const Resources = [];
+export const Prompts = [];
+//# sourceMappingURL=index.js.map

package/lib/esm/modules/template-module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/template-module/index.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,KAAK,GAAkB,EAAE,CAAC;AAEvC,MAAM,CAAC,MAAM,SAAS,GAAsB,EAAE,CAAC;AAE/C,MAAM,CAAC,MAAM,OAAO,GAAoB,EAAE,CAAC"}

package/lib/esm/prompts/code/constants.d.ts

@@ -0,0 +1 @@
+export declare const TsBaseCodePrompt = "You're a senior TypeScript developer writing typescript code.";

package/lib/esm/prompts/code/constants.js

@@ -0,0 +1,2 @@
+export const TsBaseCodePrompt = `You're a senior TypeScript developer writing typescript code.`;
+//# sourceMappingURL=constants.js.map

package/lib/esm/prompts/code/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/prompts/code/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,+DAA+D,CAAC"}

package/lib/esm/prompts/code/design-patterns/builder.d.ts

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

package/lib/esm/prompts/code/design-patterns/builder.js

@@ -0,0 +1,118 @@
+import { z } from "zod";
+import { PromptBuilder } from "./../../../builders/prompt-builder.js";
+import { ReasoningLevel } from "./../../../constants.js";
+import { TsDPBasePromptClass } from "./constants.js";
+import { toPascalCase } from "@decaf-ts/logging";
+const promptName = "ts.code.dp.builder";
+const argsSchema = z.object({
+    className: z.string().describe("the class name to turn into a builder"),
+});
+export const TsCodeDesignPatterBuilderPrompt = PromptBuilder.builder
+    .setName(promptName)
+    .setTitle("Typescript builder design patter prompt")
+    .setDescription("for a class, with a defined set of properties, scafold a builder design pattern")
+    .setArgsSchema(argsSchema)
+    .setReasoning(ReasoningLevel.BASIC)
+    .setCb((args, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+extra) => {
+    args.className = toPascalCase(args.className);
+    const prompt = `${TsDPBasePromptClass}
+Transform the selected class into a builder design pattern implementation in Typescript.
+use @decaf-ts validation decorators to enforce the validation of your builder.
+
+- must extend the Model Class from @decaf-ts/decorator-validation;
+- each property must be marked as protected;
+- each property must have a setter method that returns 'this' for chaining;
+- the build() method must validate the properties using hasErrors() method from Model class;
+- if validation fails, throw an error with the validation errors;
+- if validation passes, return an instance of the original class with the set properties;
+- optionally (but do so by default) add the static builder and from methods from the example;
+- if the clasee already follows the pattern but has properties without decoration or without setters, simple add them;
+
+example:
+
+original class:
+\`\`\`typescript
+export class ${args.className} {
+  description!: string;
+  name!: string = "default name";
+  title!: string;
+  age?: string;
+  dateOfBirth!: Date;
+}}
+\`\`\`        
+
+resulting builder pattern implementation:
+\`\`\`typescript
+export class ${args.className}Builder extends Model {
+
+  @minlength(10
+  @required()
+  protected description!: string;
+  
+  @required()
+  protected name!: string = "default value;
+  
+  @required()
+  protected title!: string;
+  
+  @min(18)
+  protected age?: string;
+  
+  @date()
+  protected dateOfBirth!: Date;
+
+  protected constructor(arg?: ModelArg<${args.className}Builder>>) {
+    super(arg);
+    Model.fromModel(this, arg);
+  }
+
+  setDescription(value: string) {
+    this.description = value;
+    return this;
+  }
+
+  setName(value: string) {
+    this.name = value;
+    return this;
+  }
+
+  setTitle(value: string) {
+    this.title = value;
+    return this;
+  }
+  setAge(value: number) {
+    this.age = value;
+    return this;
+  }
+  setDate(value: Date) {
+    this.age = value;
+    return this;
+  }
+  
+  build(...args: any[]): ${args.className}Builder | Promise<${args.className}Builder> {
+    const errs = this.hasErrors();
+    if (errs) throw new Error(errs.toString());
+    
+    return // code that builds OBJ here
+  }
+  
+  static get builder(): ${args.className}Builder {
+    return new ${args.className}Builder(); // static method to get a new builder instance
+  }
+  
+  static from<K extends keyof ${args.className}Builder>(obj: K, ${args.className}Builder[K]): ${args.className}Builder {
+    return new ${args.className}Builder(); // static method to create a builder from an object
+  }
+}
+\`\`\`        
+
+`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+        _meta: {},
+    };
+    return result;
+});
+//# sourceMappingURL=builder.js.map

package/lib/esm/prompts/code/design-patterns/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../../src/prompts/code/design-patterns/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,EAAE,aAAa,EAAE,8CAAyC;AACjE,OAAO,EAAE,cAAc,EAAE,gCAA2B;AACpD,OAAO,EAAE,mBAAmB,EAAE,uBAAoB;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CACxE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAC1C,aAAa,CAAC,OAAO;KAClB,OAAO,CAAC,UAAU,CAAC;KACnB,QAAQ,CAAC,yCAAyC,CAAC;KACnD,cAAc,CACb,iFAAiF,CAClF;KACA,aAAa,CAAC,UAAiB,CAAC;KAChC,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC;KAClC,KAAK,CACJ,CACE,IAAS;AACT,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,GAAG,mBAAmB;;;;;;;;;;;;;;;;;eAiB9B,IAAI,CAAC,SAAS;;;;;;;;;;;eAWd,IAAI,CAAC,SAAS;;;;;;;;;;;;;;;;;;yCAkBY,IAAI,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA4B5B,IAAI,CAAC,SAAS,qBAAqB,IAAI,CAAC,SAAS;;;;;;;0BAOlD,IAAI,CAAC,SAAS;iBACvB,IAAI,CAAC,SAAS;;;gCAGC,IAAI,CAAC,SAAS,oBAAoB,IAAI,CAAC,SAAS,gBAAgB,IAAI,CAAC,SAAS;iBAC7F,IAAI,CAAC,SAAS;;;;;CAK9B,CAAC;IAEM,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/esm/prompts/code/design-patterns/constants.d.ts

@@ -0,0 +1 @@
+export declare const TsDPBasePromptClass = "You're a senior TypeScript developer writing typescript code.You're a senior TypeScript developer writing typescript code.";

package/lib/esm/prompts/code/design-patterns/constants.js

@@ -0,0 +1,3 @@
+import { TsBaseCodePrompt } from "./../constants.js";
+export const TsDPBasePromptClass = `${TsBaseCodePrompt}You're a senior TypeScript developer writing typescript code.`;
+//# sourceMappingURL=constants.js.map

package/lib/esm/prompts/code/design-patterns/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/prompts/code/design-patterns/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,0BAAqB;AAEhD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,gBAAgB,+DAA+D,CAAC"}

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

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

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

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { PromptBuilder } from "./../../builders/prompt-builder.js";
+import { ReasoningLevel } from "./../../constants.js";
+const promptName = "example.prompt.echo";
+const argsSchema = z.object({ text: z.string().optional() });
+export const ExamplePrompt = PromptBuilder.builder
+    .setName(promptName)
+    .setTitle("Example: Echo Prompt")
+    .setDescription("Returns a short prompt containing the provided `text` as a user message.")
+    .setArgsSchema(argsSchema)
+    .setReasoning(ReasoningLevel.BASIC)
+    .setCb((args, _extra) => {
+    const text = args?.text ?? "(no text provided)";
+    const messages = [{ role: "user", content: { type: "text", text } }];
+    return { messages, _meta: {} };
+});
+// Named export already provided above; avoid default exports per repository policy.
+//# sourceMappingURL=index.js.map

package/lib/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,2CAAsC;AAO9D,OAAO,EAAE,cAAc,EAAqB,6BAAwB;AAEpE,MAAM,UAAU,GAAG,qBAAqB,CAAC;AAEzC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAG7D,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,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,cAAc,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/esm/prompts/index.d.ts

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

package/lib/esm/prompts/index.js

@@ -0,0 +1,26 @@
+import { TsDocClassPrompt } from "./jsdocs/class-prompt.js";
+import { TsDocConstPrompt } from "./jsdocs/const-prompt.js";
+import { TsDocDecoratorPrompt } from "./jsdocs/decorator-prompt.js";
+import { TsDocEnumPrompt } from "./jsdocs/enum-prompt.js";
+import { TsDocFunctionPrompt } from "./jsdocs/function-prompt.js";
+import { TsDocInterfacePrompt } from "./jsdocs/interface-prompt.js";
+import { TsDocTypeePrompt } from "./jsdocs/types-prompt.js";
+import { TsCodeDesignPatterBuilderPrompt } from "./code/design-patterns/builder.js";
+import { ExamplePrompt } from "./example-prompt/index.js";
+import { InteractiveJsDocPrompt } from "./interactive-jsdoc/index.js";
+export const Prompts = [
+    // Documentation prompts
+    TsDocClassPrompt,
+    TsDocConstPrompt,
+    TsDocDecoratorPrompt,
+    TsDocEnumPrompt,
+    TsDocFunctionPrompt,
+    TsDocInterfacePrompt,
+    TsDocTypeePrompt,
+    // Code generation prompts
+    TsCodeDesignPatterBuilderPrompt,
+    // Example prompt
+    ExamplePrompt,
+    InteractiveJsDocPrompt,
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iCAA8B;AACzD,OAAO,EAAE,gBAAgB,EAAE,iCAA8B;AACzD,OAAO,EAAE,oBAAoB,EAAE,qCAAkC;AACjE,OAAO,EAAE,eAAe,EAAE,gCAA6B;AACvD,OAAO,EAAE,mBAAmB,EAAE,oCAAiC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,qCAAkC;AACjE,OAAO,EAAE,gBAAgB,EAAE,iCAA8B;AAEzD,OAAO,EAAE,+BAA+B,EAAE,0CAAuC;AACjF,OAAO,EAAE,aAAa,EAAE,kCAAyB;AACjD,OAAO,EAAE,sBAAsB,EAAE,qCAA4B;AAE7D,MAAM,CAAC,MAAM,OAAO,GAAoB;IACtC,wBAAwB;IACxB,gBAAgB;IAChB,gBAAgB;IAChB,oBAAoB;IACpB,eAAe;IACf,mBAAmB;IACnB,oBAAoB;IACpB,gBAAgB;IAChB,0BAA0B;IAC1B,+BAA+B;IAC/B,iBAAiB;IACjB,aAAa;IACb,sBAAsB;CACvB,CAAC"}

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

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

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

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { PromptBuilder } from "./../../builders/prompt-builder.js";
+import { ReasoningLevel } from "./../../constants.js";
+const promptName = "interactive.jsdoc.assistant";
+const argsSchema = z.object({ code: z.string().optional(), astObject: z.any().optional() });
+export const InteractiveJsDocPrompt = 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(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/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,2CAAsC;AAO9D,OAAO,EAAE,cAAc,EAAE,6BAAwB;AAEjD,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAEjD,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAG5F,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,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,cAAc,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/esm/prompts/jsdocs/class-prompt.d.ts

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

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

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

package/lib/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,uBAAoB;AAOtD,OAAO,EAAE,aAAa,EAAE,2CAAsC;AAC9D,OAAO,EAAE,cAAc,EAAE,6BAAwB;AAEjD,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAEpC,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,qBAAqB,CAAC;KAC/B,cAAc,CACb,4FAA4F,CAC7F;KACA,aAAa,CAAC,UAAiB,CAAC;KAChC,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC;KAClC,KAAK,CACJ;AACE,6DAA6D;AAC7D,IAAU;AACV,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,MAAM,GAAG,GAAG,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BrC,MAAM,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/esm/prompts/jsdocs/const-prompt.d.ts

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

package/lib/esm/prompts/jsdocs/const-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.const";
+const argsSchema = z.object({});
+export const TsDocConstPrompt = 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 = `${BaseJSDocPrompt}
+${ConstantsPrompt}
+${Footer}`;
+    const result = {
+        messages: [{ role: "user", content: { type: "text", text: prompt } }],
+    };
+    return result;
+});
+//# sourceMappingURL=const-prompt.js.map

package/lib/esm/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,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,gBAAgB,CAAC;AAEpC,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,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,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/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/esm/prompts/jsdocs/constants.js

@@ -0,0 +1,46 @@
+export const 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:`;
+export 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.
+  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`;
+export 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.
+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`;
+export const 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/esm/prompts/jsdocs/constants.js.map

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

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

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