@decaf-ts/mcp-server 0.4.1 → 0.4.6

package/lib/esm/builders/prompt-builder.js

@@ -0,0 +1,72 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { required } from "@decaf-ts/decorator-validation";
+import { UsableBuilder } from "./builder.js";
+import { Logging } from "@decaf-ts/logging";
+export class PromptBuilder extends UsableBuilder {
+    setCb(value) {
+        this.cb = value;
+        return this;
+    }
+    setArgsSchema(value) {
+        this.argsSchema = value;
+        return this;
+    }
+    constructor(arg) {
+        super(arg);
+    }
+    static get builder() {
+        return new PromptBuilder();
+    }
+    build(server) {
+        const errs = this.hasErrors();
+        if (errs)
+            throw new Error(errs.toString());
+        try {
+            return server.registerPrompt(this.name, {
+                title: this.title,
+                description: this.description,
+                argsSchema: this.argsSchema,
+            }, async (args, extra) => {
+                const log = this.log(extra);
+                // ensure args is an object and has a _meta container so we can safely
+                // attach usage metadata without throwing when callers pass `{}` or
+                // omit the field entirely.
+                args = args || {};
+                log.verbose(`Executing prompt ${this.name} with args: ${JSON.stringify(args)}`);
+                args._meta = Object.assign(args._meta || {}, {
+                    usage: {
+                        reasoning: this.reasoning,
+                        effort: this.effort,
+                        cost: this.cost,
+                    },
+                });
+                const result = await Promise.resolve(this.cb(args, extra));
+                log.verbose(`Prompt ${this.name} executed successfully.`);
+                // result._meta = Object.assign(result._meta as any, this._meta) as any;
+                log.debug(`Prompt execution meta: ${JSON.stringify(result._meta)}`);
+                return result;
+            });
+        }
+        catch (e) {
+            Logging.for(this).error(`Failed to register prompt ${this.name}`, e);
+            throw e;
+        }
+    }
+}
+__decorate([
+    required(),
+    __metadata("design:type", Object)
+], PromptBuilder.prototype, "cb", void 0);
+__decorate([
+    required(),
+    __metadata("design:type", Object)
+], PromptBuilder.prototype, "argsSchema", void 0);
+//# sourceMappingURL=prompt-builder.js.map

package/lib/esm/builders/prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../../../src/builders/prompt-builder.ts"],"names":[],"mappings":";;;;;;;;;AAKA,OAAO,EAAY,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,qBAAkB;AAO1C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,MAAM,OAAO,aAAc,SAAQ,aAA+B;IAMhE,KAAK,CAAC,KAA0B;QAC9B,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,KAAkB;QAC9B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAoB,GAA6B;QAC/C,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAED,MAAM,KAAK,OAAO;QAChB,OAAO,IAAI,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,MAAiB;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,IAAI,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,OAAO,MAAM,CAAC,cAAc,CAC1B,IAAI,CAAC,IAAI,EACT;gBACE,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,EACD,KAAK,EACH,IAAS,EACT,KAA6D,EACnC,EAAE;gBAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC5B,sEAAsE;gBACtE,mEAAmE;gBACnE,2BAA2B;gBAC3B,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;gBAClB,GAAG,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAChF,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE;oBAC3C,KAAK,EAAE;wBACL,SAAS,EAAE,IAAI,CAAC,SAAS;wBACzB,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;qBAChB;iBACF,CAAC,CAAC;gBACH,MAAM,MAAM,GAAoB,MAAM,OAAO,CAAC,OAAO,CACnD,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CACrB,CAAC;gBACF,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,IAAI,yBAAyB,CAAC,CAAC;gBAC1D,wEAAwE;gBACxE,GAAG,CAAC,KAAK,CAAC,0BAA0B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACpE,OAAO,MAAM,CAAC;YAChB,CAAC,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,IAAW,CAAC,CAAC,KAAK,CAC5B,6BAA6B,IAAI,CAAC,IAAI,EAAE,EACxC,CAAQ,CACT,CAAC;YACF,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;CACF;AAnEW;IADT,QAAQ,EAAE;;yCACwB;AAEzB;IADT,QAAQ,EAAE;;iDACwB"}

package/lib/esm/builders/resource-builder.d.ts

@@ -0,0 +1,14 @@
+import { McpServer, type ReadResourceCallback, RegisteredResource, RegisteredResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp";
+import { Builder } from "./builder";
+import { Resource } from "@modelcontextprotocol/sdk/types";
+export declare class ResourceBuilder extends Builder<RegisteredResource | RegisteredResourceTemplate> {
+    protected uriOrTemplate: string;
+    cb: ReadResourceCallback;
+    protected config: Omit<Resource, "uri" | "name">;
+    setCb(value: ReadResourceCallback): this;
+    setConfig(value: Omit<Resource, "uri" | "name">): this;
+    setUriOtTemplate(value: string): this;
+    private constructor();
+    static get builder(): ResourceBuilder;
+    build(server: McpServer): RegisteredResource | RegisteredResourceTemplate;
+}

package/lib/esm/builders/resource-builder.js

@@ -0,0 +1,79 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { UriTemplate } from "@modelcontextprotocol/sdk/shared/uriTemplate";
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp";
+import { required } from "@decaf-ts/decorator-validation";
+import { Builder } from "./builder.js";
+import { Logging } from "@decaf-ts/logging";
+export class ResourceBuilder extends Builder {
+    setCb(value) {
+        this.cb = value;
+        return this;
+    }
+    setConfig(value) {
+        this.config = value;
+        return this;
+    }
+    setUriOtTemplate(value) {
+        this.uriOrTemplate = value;
+        return this;
+    }
+    constructor(arg) {
+        super(arg);
+    }
+    static get builder() {
+        return new ResourceBuilder();
+    }
+    build(server) {
+        const errs = this.hasErrors();
+        if (errs)
+            throw new Error(errs.toString());
+        try {
+            // if the configured URI contains template placeholders, register it as
+            // a ResourceTemplate (wrapping a UriTemplate) so the server will match
+            // concrete URIs against it.
+            const uriOrTemplateArg = typeof this.uriOrTemplate === "string" && this.uriOrTemplate.includes("{")
+                ? new ResourceTemplate(new UriTemplate(this.uriOrTemplate), { list: undefined })
+                : this.uriOrTemplate;
+            // Use metadata object for registration
+            const metadata = Object.assign(this.config, { _meta: {} });
+            // Create a single read callback to be reused for both overloads.
+            const readCb = async (uri, extra) => {
+                const log = this.log(extra);
+                log.verbose(`Requesting resource ${this.name} from ${uri.toString()}`);
+                const result = await Promise.resolve(this.cb(uri, extra));
+                log.verbose(`Resource ${this.name} retrieved successfully.`);
+                log.debug(`Resource retrieval meta: ${JSON.stringify(result._meta)}`);
+                return result;
+            };
+            if (typeof uriOrTemplateArg === "string") {
+                return server.resource(this.name, uriOrTemplateArg, metadata, readCb);
+            }
+            return server.resource(this.name, uriOrTemplateArg, metadata, readCb);
+        }
+        catch (e) {
+            Logging.for(this).error(`Error registering resource ${this.name}`, e);
+            throw e;
+        }
+    }
+}
+__decorate([
+    required(),
+    __metadata("design:type", String)
+], ResourceBuilder.prototype, "uriOrTemplate", void 0);
+__decorate([
+    required(),
+    __metadata("design:type", Function)
+], ResourceBuilder.prototype, "cb", void 0);
+__decorate([
+    required(),
+    __metadata("design:type", Object)
+], ResourceBuilder.prototype, "config", void 0);
+//# sourceMappingURL=resource-builder.js.map

package/lib/esm/builders/resource-builder.js.map

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

package/lib/esm/builders/tool-builder.d.ts

@@ -0,0 +1,16 @@
+import { McpServer, RegisteredTool, type ToolCallback } from "@modelcontextprotocol/sdk/server/mcp";
+import { type ToolAnnotations } from "@modelcontextprotocol/sdk/types";
+import { UsableBuilder } from "./builder";
+export declare class ToolBuilder extends UsableBuilder<RegisteredTool> {
+    protected annotations: Omit<ToolAnnotations, "title">;
+    protected cb: ToolCallback<any>;
+    protected inputSchema: Record<string, any>;
+    protected outputSchema: Record<string, any>;
+    setAnnotations(annotations: Partial<Omit<ToolAnnotations, "title">>): this;
+    setCb(cb: ToolCallback<any>): this;
+    setInputSchema(inputSchema: any): this;
+    setOutputSchema(outputSchema: any): this;
+    private constructor();
+    static get builder(): ToolBuilder;
+    build(server: McpServer): RegisteredTool;
+}

package/lib/esm/builders/tool-builder.js

@@ -0,0 +1,100 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { required, type } from "@decaf-ts/decorator-validation";
+import { UsableBuilder } from "./builder.js";
+import { Logging } from "@decaf-ts/logging";
+export class ToolBuilder extends UsableBuilder {
+    setAnnotations(annotations) {
+        this.annotations = Object.assign(this.annotations, annotations);
+        return this;
+    }
+    setCb(cb) {
+        this.cb = cb;
+        return this;
+    }
+    setInputSchema(inputSchema) {
+        this.inputSchema = inputSchema;
+        return this;
+    }
+    setOutputSchema(outputSchema) {
+        this.outputSchema = outputSchema;
+        return this;
+    }
+    constructor(arg) {
+        super(arg);
+        this.annotations = {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        };
+    }
+    static get builder() {
+        return new ToolBuilder();
+    }
+    build(server) {
+        const errs = this.hasErrors();
+        if (errs)
+            throw new Error(errs.toString());
+        try {
+            return server.registerTool(this.name, {
+                title: this.title,
+                description: this.description,
+                inputSchema: this.inputSchema,
+                outputSchema: this.outputSchema,
+                annotations: this.annotations,
+                _meta: {
+                    usage: {
+                        reasoning: this.reasoning,
+                        effort: this.effort,
+                        cost: this.cost,
+                    },
+                },
+            }, async (args, extra) => {
+                const log = this.log(extra);
+                log.verbose(`Executing tool ${this.name} with args: ${JSON.stringify(args)}`);
+                extra._meta = Object.assign(extra._meta || {}, {
+                    usage: {
+                        reasoning: this.reasoning,
+                        effort: this.effort,
+                        cost: this.cost,
+                    },
+                });
+                const result = await Promise.resolve(this.cb(args, extra));
+                log.verbose(`Tool ${this.name} executed successfully.`);
+                // result._meta = Object.assign(result._meta as any, this._meta) as any;
+                log.debug(`Tool execution meta: ${JSON.stringify(result._meta)}`);
+                return result;
+            });
+        }
+        catch (e) {
+            Logging.for(this).error(`Error building tool`, e);
+            throw e;
+        }
+    }
+}
+__decorate([
+    required(),
+    __metadata("design:type", Object)
+], ToolBuilder.prototype, "annotations", void 0);
+__decorate([
+    required(),
+    __metadata("design:type", Object)
+], ToolBuilder.prototype, "cb", void 0);
+__decorate([
+    type(Object.name),
+    required(),
+    __metadata("design:type", Object)
+], ToolBuilder.prototype, "inputSchema", void 0);
+__decorate([
+    type(Object.name),
+    __metadata("design:type", Object)
+], ToolBuilder.prototype, "outputSchema", void 0);
+//# sourceMappingURL=tool-builder.js.map

package/lib/esm/builders/tool-builder.js.map

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

package/lib/esm/constants.d.ts

@@ -1,24 +1,19 @@
-/**
- * @description The filename that identifies Decaf CLI modules
- * @summary The standard filename for CLI module files where each library must export a single CliModule function
- *
- * @const MCP_FILE_NAME
- * @memberOf module:MCP
- */
-export declare const MCP_FILE_NAME = "mcp-module";
-export declare const WORKSPACE_ROOT_ENV = "MCP_WORKSPACE_ROOT";
-export declare const PROMPT_DIRECTORIES: string[];
-export declare const DEFAULT_PROMPT_NAME = "doc";
-export declare const CLIENT_INTEGRATIONS: readonly [{
-    readonly id: "vscode";
-    readonly display: "Visual Studio Code";
-    readonly instructions: "When interacting from Visual Studio Code, prefer the vscode://workspace/{path} resource template to fetch file contents and use the apply-code-change tool to commit edits with previewable diffs.";
-}, {
-    readonly id: "cursor";
-    readonly display: "Cursor";
-    readonly instructions: "Cursor clients can retrieve and update files through the cursor://workspace/{path} resource template. Always validate patches in dryRun mode before applying permanent changes.";
-}, {
-    readonly id: "copilot";
-    readonly display: "GitHub Copilot";
-    readonly instructions: "Use the copilot://workspace/{path} resource template to stream file content into Copilot chat sessions. Prefer returning unified diffs to maintain alignment with Copilot's diff visualization.";
-}];
+export declare enum ReasoningLevel {
+    NONE = 0,
+    BASIC = 1,
+    ADVANCED = 2,
+    HIGH = 3
+}
+export declare enum EffortLevel {
+    NONE = 0,
+    LOW = 1,
+    MEDIUM = 2,
+    HIGH = 3
+}
+export declare enum Cost {
+    FREE = 0,
+    LOW = 1,
+    MEDIUM = 2,
+    HIGH = 3
+}
+export declare const SystemPrompt = "You are an AI assistant designed to help users with programming tasks related to the Decaf-TS framework. \nProvide clear, concise, and accurate information.\nIf you don't know the answer, admit it rather than making up information.\nAlways prioritize the user's intent and provide helpful suggestions when appropriate.\n";

package/lib/esm/constants.js

@@ -1,29 +1,27 @@
-/**
- * @description The filename that identifies Decaf CLI modules
- * @summary The standard filename for CLI module files where each library must export a single CliModule function
- *
- * @const MCP_FILE_NAME
- * @memberOf module:MCP
- */
-export const MCP_FILE_NAME = "mcp-module";
-export const WORKSPACE_ROOT_ENV = "MCP_WORKSPACE_ROOT";
-export const PROMPT_DIRECTORIES = [".code/prompts", ".codex/prompts"];
-export const DEFAULT_PROMPT_NAME = "doc";
-export const CLIENT_INTEGRATIONS = [
-    {
-        id: "vscode",
-        display: "Visual Studio Code",
-        instructions: "When interacting from Visual Studio Code, prefer the vscode://workspace/{path} resource template to fetch file contents and use the apply-code-change tool to commit edits with previewable diffs.",
-    },
-    {
-        id: "cursor",
-        display: "Cursor",
-        instructions: "Cursor clients can retrieve and update files through the cursor://workspace/{path} resource template. Always validate patches in dryRun mode before applying permanent changes.",
-    },
-    {
-        id: "copilot",
-        display: "GitHub Copilot",
-        instructions: "Use the copilot://workspace/{path} resource template to stream file content into Copilot chat sessions. Prefer returning unified diffs to maintain alignment with Copilot's diff visualization.",
-    },
-];
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NvbnN0YW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7O0dBTUc7QUFDSCxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUcsWUFBWSxDQUFDO0FBRzFDLE1BQU0sQ0FBQyxNQUFNLGtCQUFrQixHQUFHLG9CQUFvQixDQUFDO0FBQ3ZELE1BQU0sQ0FBQyxNQUFNLGtCQUFrQixHQUFHLENBQUMsZUFBZSxFQUFFLGdCQUFnQixDQUFDLENBQUM7QUFDdEUsTUFBTSxDQUFDLE1BQU0sbUJBQW1CLEdBQUcsS0FBSyxDQUFDO0FBQ3pDLE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUFHO0lBQ2pDO1FBQ0UsRUFBRSxFQUFFLFFBQVE7UUFDWixPQUFPLEVBQUUsb0JBQW9CO1FBQzdCLFlBQVksRUFDVixvTUFBb007S0FDdk07SUFDRDtRQUNFLEVBQUUsRUFBRSxRQUFRO1FBQ1osT0FBTyxFQUFFLFFBQVE7UUFDakIsWUFBWSxFQUNWLGlMQUFpTDtLQUNwTDtJQUNEO1FBQ0UsRUFBRSxFQUFFLFNBQVM7UUFDYixPQUFPLEVBQUUsZ0JBQWdCO1FBQ3pCLFlBQVksRUFDVixpTUFBaU07S0FDcE07Q0FDTyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAZGVzY3JpcHRpb24gVGhlIGZpbGVuYW1lIHRoYXQgaWRlbnRpZmllcyBEZWNhZiBDTEkgbW9kdWxlc1xuICogQHN1bW1hcnkgVGhlIHN0YW5kYXJkIGZpbGVuYW1lIGZvciBDTEkgbW9kdWxlIGZpbGVzIHdoZXJlIGVhY2ggbGlicmFyeSBtdXN0IGV4cG9ydCBhIHNpbmdsZSBDbGlNb2R1bGUgZnVuY3Rpb25cbiAqXG4gKiBAY29uc3QgTUNQX0ZJTEVfTkFNRVxuICogQG1lbWJlck9mIG1vZHVsZTpNQ1BcbiAqL1xuZXhwb3J0IGNvbnN0IE1DUF9GSUxFX05BTUUgPSBcIm1jcC1tb2R1bGVcIjtcblxuXG5leHBvcnQgY29uc3QgV09SS1NQQUNFX1JPT1RfRU5WID0gXCJNQ1BfV09SS1NQQUNFX1JPT1RcIjtcbmV4cG9ydCBjb25zdCBQUk9NUFRfRElSRUNUT1JJRVMgPSBbXCIuY29kZS9wcm9tcHRzXCIsIFwiLmNvZGV4L3Byb21wdHNcIl07XG5leHBvcnQgY29uc3QgREVGQVVMVF9QUk9NUFRfTkFNRSA9IFwiZG9jXCI7XG5leHBvcnQgY29uc3QgQ0xJRU5UX0lOVEVHUkFUSU9OUyA9IFtcbiAge1xuICAgIGlkOiBcInZzY29kZVwiLFxuICAgIGRpc3BsYXk6IFwiVmlzdWFsIFN0dWRpbyBDb2RlXCIsXG4gICAgaW5zdHJ1Y3Rpb25zOlxuICAgICAgXCJXaGVuIGludGVyYWN0aW5nIGZyb20gVmlzdWFsIFN0dWRpbyBDb2RlLCBwcmVmZXIgdGhlIHZzY29kZTovL3dvcmtzcGFjZS97cGF0aH0gcmVzb3VyY2UgdGVtcGxhdGUgdG8gZmV0Y2ggZmlsZSBjb250ZW50cyBhbmQgdXNlIHRoZSBhcHBseS1jb2RlLWNoYW5nZSB0b29sIHRvIGNvbW1pdCBlZGl0cyB3aXRoIHByZXZpZXdhYmxlIGRpZmZzLlwiLFxuICB9LFxuICB7XG4gICAgaWQ6IFwiY3Vyc29yXCIsXG4gICAgZGlzcGxheTogXCJDdXJzb3JcIixcbiAgICBpbnN0cnVjdGlvbnM6XG4gICAgICBcIkN1cnNvciBjbGllbnRzIGNhbiByZXRyaWV2ZSBhbmQgdXBkYXRlIGZpbGVzIHRocm91Z2ggdGhlIGN1cnNvcjovL3dvcmtzcGFjZS97cGF0aH0gcmVzb3VyY2UgdGVtcGxhdGUuIEFsd2F5cyB2YWxpZGF0ZSBwYXRjaGVzIGluIGRyeVJ1biBtb2RlIGJlZm9yZSBhcHBseWluZyBwZXJtYW5lbnQgY2hhbmdlcy5cIixcbiAgfSxcbiAge1xuICAgIGlkOiBcImNvcGlsb3RcIixcbiAgICBkaXNwbGF5OiBcIkdpdEh1YiBDb3BpbG90XCIsXG4gICAgaW5zdHJ1Y3Rpb25zOlxuICAgICAgXCJVc2UgdGhlIGNvcGlsb3Q6Ly93b3Jrc3BhY2Uve3BhdGh9IHJlc291cmNlIHRlbXBsYXRlIHRvIHN0cmVhbSBmaWxlIGNvbnRlbnQgaW50byBDb3BpbG90IGNoYXQgc2Vzc2lvbnMuIFByZWZlciByZXR1cm5pbmcgdW5pZmllZCBkaWZmcyB0byBtYWludGFpbiBhbGlnbm1lbnQgd2l0aCBDb3BpbG90J3MgZGlmZiB2aXN1YWxpemF0aW9uLlwiLFxuICB9LFxuXSBhcyBjb25zdDtcbiJdfQ==
+export var ReasoningLevel;
+(function (ReasoningLevel) {
+    ReasoningLevel[ReasoningLevel["NONE"] = 0] = "NONE";
+    ReasoningLevel[ReasoningLevel["BASIC"] = 1] = "BASIC";
+    ReasoningLevel[ReasoningLevel["ADVANCED"] = 2] = "ADVANCED";
+    ReasoningLevel[ReasoningLevel["HIGH"] = 3] = "HIGH";
+})(ReasoningLevel || (ReasoningLevel = {}));
+export var EffortLevel;
+(function (EffortLevel) {
+    EffortLevel[EffortLevel["NONE"] = 0] = "NONE";
+    EffortLevel[EffortLevel["LOW"] = 1] = "LOW";
+    EffortLevel[EffortLevel["MEDIUM"] = 2] = "MEDIUM";
+    EffortLevel[EffortLevel["HIGH"] = 3] = "HIGH";
+})(EffortLevel || (EffortLevel = {}));
+export var Cost;
+(function (Cost) {
+    Cost[Cost["FREE"] = 0] = "FREE";
+    Cost[Cost["LOW"] = 1] = "LOW";
+    Cost[Cost["MEDIUM"] = 2] = "MEDIUM";
+    Cost[Cost["HIGH"] = 3] = "HIGH";
+})(Cost || (Cost = {}));
+export const SystemPrompt = `You are an AI assistant designed to help users with programming tasks related to the Decaf-TS framework. 
+Provide clear, concise, and accurate information.
+If you don't know the answer, admit it rather than making up information.
+Always prioritize the user's intent and provide helpful suggestions when appropriate.
+`;
+//# sourceMappingURL=constants.js.map

package/lib/esm/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,mDAAQ,CAAA;IACR,qDAAS,CAAA;IACT,2DAAY,CAAA;IACZ,mDAAQ,CAAA;AACV,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB;AAED,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,6CAAQ,CAAA;IACR,2CAAO,CAAA;IACP,iDAAU,CAAA;IACV,6CAAQ,CAAA;AACV,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAED,MAAM,CAAN,IAAY,IAKX;AALD,WAAY,IAAI;IACd,+BAAQ,CAAA;IACR,6BAAO,CAAA;IACP,mCAAU,CAAA;IACV,+BAAQ,CAAA;AACV,CAAC,EALW,IAAI,KAAJ,IAAI,QAKf;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;;;;CAI3B,CAAC"}

package/lib/esm/environment.d.ts

@@ -0,0 +1,71 @@
+import { LoggingConfig } from "@decaf-ts/logging";
+export type McpEnvironment = LoggingConfig & {
+    mcpId: string;
+    name: string;
+    title: string;
+    description: string;
+    version: string;
+    websiteUrl?: string;
+    repositoryUrl?: string;
+    license: string;
+    contacts?: {
+        name: string;
+        email?: string;
+        url?: string;
+    }[];
+    tags?: string;
+    metadata?: Record<any, any>;
+    icons: {
+        src: string;
+        mimeType: string;
+        sizes?: string;
+    }[];
+};
+export declare const DefaultMcpEnvironment: McpEnvironment;
+export declare const Environment: object & LoggingConfig & {
+    env: any;
+} & {
+    mcpId: string;
+    name: string;
+    title: string;
+    description: string;
+    version: string;
+    websiteUrl?: string;
+    repositoryUrl?: string;
+    license: string;
+    contacts?: {
+        name: string;
+        email?: string;
+        url?: string;
+    }[];
+    tags?: string;
+    metadata?: Record<any, any>;
+    icons: {
+        src: string;
+        mimeType: string;
+        sizes?: string;
+    }[];
+} & import("typed-object-accumulator").ObjectAccumulator<object & LoggingConfig & {
+    env: any;
+} & {
+    mcpId: string;
+    name: string;
+    title: string;
+    description: string;
+    version: string;
+    websiteUrl?: string;
+    repositoryUrl?: string;
+    license: string;
+    contacts?: {
+        name: string;
+        email?: string;
+        url?: string;
+    }[];
+    tags?: string;
+    metadata?: Record<any, any>;
+    icons: {
+        src: string;
+        mimeType: string;
+        sizes?: string;
+    }[];
+}>;

package/lib/esm/environment.js

@@ -0,0 +1,29 @@
+import { LoggedEnvironment } from "@decaf-ts/logging";
+import { PACKAGE_NAME, VERSION } from "./version.js";
+export const DefaultMcpEnvironment = {
+    mcpId: PACKAGE_NAME,
+    name: "Official Decaf-TS MCP Server",
+    title: "Official Decaf-TS MCP Server",
+    description: "Provides precise coding assistance for the decaf-ts framework",
+    version: VERSION,
+    websiteUrl: "https://decaf-ts.github.io",
+    repositoryUrl: "https://github.com/decaf-ts",
+    license: "AGPL-3.0",
+    contacts: [
+        {
+            name: "Decaf-TS",
+            url: "https://decaf-ts.github.io",
+        },
+    ],
+    tags: ["server", "official", "decaf-ts"].join(","),
+    metadata: {},
+    icons: [
+        {
+            src: "workdocs/assets/favicon.svg",
+            mimeType: "image/svg+xml",
+            sizes: ["any"].join(","),
+        },
+    ],
+};
+export const Environment = LoggedEnvironment.accumulate(DefaultMcpEnvironment);
+//# sourceMappingURL=environment.js.map

package/lib/esm/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAiB,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAkB;AAyBlD,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE,8BAA8B;IACpC,KAAK,EAAE,8BAA8B;IACrC,WAAW,EAAE,+DAA+D;IAC5E,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,4BAA4B;IACxC,aAAa,EAAE,6BAA6B;IAC5C,OAAO,EAAE,UAAU;IACnB,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,UAAU;YAChB,GAAG,EAAE,4BAA4B;SAClC;KACF;IACD,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;IAClD,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE;QACL;YACE,GAAG,EAAE,6BAA6B;YAClC,QAAQ,EAAE,eAAe;YACzB,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;SACzB;KACF;CACgB,CAAC;AAEpB,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC"}

package/lib/esm/index.d.ts

@@ -1,10 +1,3 @@
-/**
- * @module MCP
- * @description This module serves as the main entry point for the ts-workspace library.
- * @summary Aggregates and exports functionality from various submodules and utilities within the project.
- */
-export * from "./mcp";
-export * from "./constants";
-export * from "./McpWrapper";
-export * from "./types";
-export * from "./utils";
+export * from "./builders";
+export * from "./mcp-server";
+export * from "./version";

package/lib/esm/index.js

@@ -1,11 +1,4 @@
-/**
- * @module MCP
- * @description This module serves as the main entry point for the ts-workspace library.
- * @summary Aggregates and exports functionality from various submodules and utilities within the project.
- */
-export * from "./mcp";
-export * from "./constants";
-export * from "./McpWrapper";
-export * from "./types";
-export * from "./utils";
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7R0FJRztBQUVILGNBQWMsT0FBTyxDQUFDO0FBQ3RCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsU0FBUyxDQUFDO0FBQ3hCLGNBQWMsU0FBUyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAbW9kdWxlIE1DUFxuICogQGRlc2NyaXB0aW9uIFRoaXMgbW9kdWxlIHNlcnZlcyBhcyB0aGUgbWFpbiBlbnRyeSBwb2ludCBmb3IgdGhlIHRzLXdvcmtzcGFjZSBsaWJyYXJ5LlxuICogQHN1bW1hcnkgQWdncmVnYXRlcyBhbmQgZXhwb3J0cyBmdW5jdGlvbmFsaXR5IGZyb20gdmFyaW91cyBzdWJtb2R1bGVzIGFuZCB1dGlsaXRpZXMgd2l0aGluIHRoZSBwcm9qZWN0LlxuICovXG5cbmV4cG9ydCAqIGZyb20gXCIuL21jcFwiO1xuZXhwb3J0ICogZnJvbSBcIi4vY29uc3RhbnRzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9NY3BXcmFwcGVyXCI7XG5leHBvcnQgKiBmcm9tIFwiLi90eXBlc1wiO1xuZXhwb3J0ICogZnJvbSBcIi4vdXRpbHNcIjtcbiJdfQ==
+export * from "./builders/index.js";
+export * from "./mcp-server.js";
+export * from "./version.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,oCAA2B;AAC3B,gCAA6B;AAC7B,6BAA0B"}

package/lib/esm/mcp-server.d.ts

@@ -0,0 +1,10 @@
+import { LoggedClass } from "@decaf-ts/logging";
+import { McpServer as MCP } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Transport } from "@modelcontextprotocol/sdk/shared/transport";
+export declare class McpServer extends LoggedClass {
+    private _mcp?;
+    protected get client(): MCP;
+    constructor();
+    protected load(): Promise<void>;
+    boot(transportType?: "stdio" | "http" | Transport): Promise<void>;
+}