@decaf-ts/mcp-server 0.0.4 → 0.3.0

package/lib/esm/mcp/tools/index.d.ts

@@ -0,0 +1,321 @@
+import { decoratorTools } from "../decorator-tools";
+export * from "./tools";
+export * from "./codex-tools";
+export * from "./generateMcpModule";
+export declare const toolList: any[];
+export declare const decoratorToolList: ({
+    readonly name: "create-or-update-model";
+    readonly description: "Create or update a validation-ready model class";
+    readonly execute: (args: {
+        filePath: string;
+        className: string;
+        classDecorators?: import("../decorator-tools").DecoratorSpec[];
+        properties: import("../decorator-tools").AttributeSpec[];
+        importsFrom: string;
+        overwrite?: boolean;
+    }) => Promise<{
+        filePath: string;
+    }>;
+} | {
+    readonly name: "add-attribute";
+    readonly description: "Add a decorated attribute to an existing model";
+    readonly execute: (args: {
+        filePath: string;
+        className: string;
+        attribute: import("../decorator-tools").AttributeSpec;
+        importsFrom: string;
+    }) => Promise<{
+        filePath: string;
+    }>;
+} | {
+    readonly name: "remove-attribute";
+    readonly description: "Remove an attribute from a model class";
+    readonly execute: (args: {
+        filePath: string;
+        className: string;
+        attributeName: string;
+    }) => Promise<{
+        filePath: string;
+    }>;
+} | {
+    readonly name: "apply-decorator";
+    readonly description: "Apply a decorator to a class or property";
+    readonly execute: (args: {
+        filePath: string;
+        className: string;
+        target: {
+            kind: "class" | "property";
+            name?: string;
+        };
+        decorator: import("../decorator-tools").DecoratorSpec;
+        importsFrom: string;
+    }) => Promise<{
+        filePath: string;
+    }>;
+} | {
+    readonly name: "remove-decorator";
+    readonly description: "Remove a decorator from a class or property";
+    readonly execute: (args: {
+        filePath: string;
+        className: string;
+        target: {
+            kind: "class" | "property";
+            name?: string;
+        };
+        decoratorName: string;
+    }) => Promise<{
+        filePath: string;
+    }>;
+} | {
+    readonly name: "scaffold-validator";
+    readonly description: "Scaffold a validator class and optional decorator";
+    readonly execute: (args: {
+        validatorsDir: string;
+        decoratorDir?: string;
+        name: string;
+    }) => Promise<{
+        classFile: string;
+        decoratorFile: string | undefined;
+    }>;
+} | {
+    readonly name: "scaffold-serializer";
+    readonly description: "Scaffold a serializer class and optional registry";
+    readonly execute: (args: {
+        dir: string;
+        name: string;
+        registerDir?: string;
+        setDefault?: boolean;
+    }) => Promise<{
+        classFile: string;
+        registerFile: string | undefined;
+    }>;
+} | {
+    readonly name: "scaffold-hashing";
+    readonly description: "Scaffold a hashing function and optional registry";
+    readonly execute: (args: {
+        dir: string;
+        name: string;
+        registerDir?: string;
+        setDefault?: boolean;
+    }) => Promise<{
+        functionFile: string;
+        registerFile: string | undefined;
+    }>;
+})[];
+export declare const tools: {
+    createOrUpdateModelTool: {
+        readonly name: "create-or-update-model";
+        readonly description: "Create or update a validation-ready model class";
+        readonly execute: (args: {
+            filePath: string;
+            className: string;
+            classDecorators?: import("../decorator-tools").DecoratorSpec[];
+            properties: import("../decorator-tools").AttributeSpec[];
+            importsFrom: string;
+            overwrite?: boolean;
+        }) => Promise<{
+            filePath: string;
+        }>;
+    };
+    addAttributeTool: {
+        readonly name: "add-attribute";
+        readonly description: "Add a decorated attribute to an existing model";
+        readonly execute: (args: {
+            filePath: string;
+            className: string;
+            attribute: import("../decorator-tools").AttributeSpec;
+            importsFrom: string;
+        }) => Promise<{
+            filePath: string;
+        }>;
+    };
+    removeAttributeTool: {
+        readonly name: "remove-attribute";
+        readonly description: "Remove an attribute from a model class";
+        readonly execute: (args: {
+            filePath: string;
+            className: string;
+            attributeName: string;
+        }) => Promise<{
+            filePath: string;
+        }>;
+    };
+    applyDecoratorTool: {
+        readonly name: "apply-decorator";
+        readonly description: "Apply a decorator to a class or property";
+        readonly execute: (args: {
+            filePath: string;
+            className: string;
+            target: {
+                kind: "class" | "property";
+                name?: string;
+            };
+            decorator: import("../decorator-tools").DecoratorSpec;
+            importsFrom: string;
+        }) => Promise<{
+            filePath: string;
+        }>;
+    };
+    removeDecoratorTool: {
+        readonly name: "remove-decorator";
+        readonly description: "Remove a decorator from a class or property";
+        readonly execute: (args: {
+            filePath: string;
+            className: string;
+            target: {
+                kind: "class" | "property";
+                name?: string;
+            };
+            decoratorName: string;
+        }) => Promise<{
+            filePath: string;
+        }>;
+    };
+    scaffoldValidatorTool: {
+        readonly name: "scaffold-validator";
+        readonly description: "Scaffold a validator class and optional decorator";
+        readonly execute: (args: {
+            validatorsDir: string;
+            decoratorDir?: string;
+            name: string;
+        }) => Promise<{
+            classFile: string;
+            decoratorFile: string | undefined;
+        }>;
+    };
+    scaffoldSerializerTool: {
+        readonly name: "scaffold-serializer";
+        readonly description: "Scaffold a serializer class and optional registry";
+        readonly execute: (args: {
+            dir: string;
+            name: string;
+            registerDir?: string;
+            setDefault?: boolean;
+        }) => Promise<{
+            classFile: string;
+            registerFile: string | undefined;
+        }>;
+    };
+    scaffoldHashingTool: {
+        readonly name: "scaffold-hashing";
+        readonly description: "Scaffold a hashing function and optional registry";
+        readonly execute: (args: {
+            dir: string;
+            name: string;
+            registerDir?: string;
+            setDefault?: boolean;
+        }) => Promise<{
+            functionFile: string;
+            registerFile: string | undefined;
+        }>;
+    };
+    analyzeRepositoryTool: {
+        annotations?: {
+            streamingHint?: boolean;
+        } & {
+            destructiveHint?: boolean;
+            idempotentHint?: boolean;
+            openWorldHint?: boolean;
+            readOnlyHint?: boolean;
+            title?: string;
+        };
+        canAccess?: ((auth: undefined) => boolean) | undefined;
+        description?: string;
+        execute: (args: any, context: import("fastmcp").Context<undefined>) => Promise<import("fastmcp").AudioContent | import("fastmcp").ContentResult | import("fastmcp").ImageContent | import("fastmcp").ResourceContent | import("fastmcp").ResourceLink | string | import("fastmcp").TextContent | void>;
+        name: string;
+        parameters?: any;
+        timeoutMs?: number;
+    };
+    enumerateCapabilitiesTool: {
+        annotations?: {
+            streamingHint?: boolean;
+        } & {
+            destructiveHint?: boolean;
+            idempotentHint?: boolean;
+            openWorldHint?: boolean;
+            readOnlyHint?: boolean;
+            title?: string;
+        };
+        canAccess?: ((auth: undefined) => boolean) | undefined;
+        description?: string;
+        execute: (args: any, context: import("fastmcp").Context<undefined>) => Promise<import("fastmcp").AudioContent | import("fastmcp").ContentResult | import("fastmcp").ImageContent | import("fastmcp").ResourceContent | import("fastmcp").ResourceLink | string | import("fastmcp").TextContent | void>;
+        name: string;
+        parameters?: any;
+        timeoutMs?: number;
+    };
+    planFeatureTool: {
+        annotations?: {
+            streamingHint?: boolean;
+        } & {
+            destructiveHint?: boolean;
+            idempotentHint?: boolean;
+            openWorldHint?: boolean;
+            readOnlyHint?: boolean;
+            title?: string;
+        };
+        canAccess?: ((auth: undefined) => boolean) | undefined;
+        description?: string;
+        execute: (args: any, context: import("fastmcp").Context<undefined>) => Promise<import("fastmcp").AudioContent | import("fastmcp").ContentResult | import("fastmcp").ImageContent | import("fastmcp").ResourceContent | import("fastmcp").ResourceLink | string | import("fastmcp").TextContent | void>;
+        name: string;
+        parameters?: any;
+        timeoutMs?: number;
+    };
+    documentCodeTool: {
+        annotations?: {
+            streamingHint?: boolean;
+        } & {
+            destructiveHint?: boolean;
+            idempotentHint?: boolean;
+            openWorldHint?: boolean;
+            readOnlyHint?: boolean;
+            title?: string;
+        };
+        canAccess?: ((auth: undefined) => boolean) | undefined;
+        description?: string;
+        execute: (args: any, context: import("fastmcp").Context<undefined>) => Promise<import("fastmcp").AudioContent | import("fastmcp").ContentResult | import("fastmcp").ImageContent | import("fastmcp").ResourceContent | import("fastmcp").ResourceLink | string | import("fastmcp").TextContent | void>;
+        name: string;
+        parameters?: any;
+        timeoutMs?: number;
+    };
+    applyCodeChangeTool: {
+        annotations?: {
+            streamingHint?: boolean;
+        } & {
+            destructiveHint?: boolean;
+            idempotentHint?: boolean;
+            openWorldHint?: boolean;
+            readOnlyHint?: boolean;
+            title?: string;
+        };
+        canAccess?: ((auth: undefined) => boolean) | undefined;
+        description?: string;
+        execute: (args: any, context: import("fastmcp").Context<undefined>) => Promise<import("fastmcp").AudioContent | import("fastmcp").ContentResult | import("fastmcp").ImageContent | import("fastmcp").ResourceContent | import("fastmcp").ResourceLink | string | import("fastmcp").TextContent | void>;
+        name: string;
+        parameters?: any;
+        timeoutMs?: number;
+    };
+    documentObjectTool: import("fastmcp").Tool<undefined, import("zod").ZodObject<{
+        basePath: import("zod").ZodString;
+        objectType: import("zod").ZodEnum<{
+            function: "function";
+            module: "module";
+            file: "file";
+            class: "class";
+            interface: "interface";
+            decorator: "decorator";
+            constant: "constant";
+        }>;
+        targetFile: import("zod").ZodOptional<import("zod").ZodString>;
+        includeContent: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strict>>;
+    coverageEnforcerTool: import("fastmcp").Tool<undefined, import("zod").ZodObject<{
+        basePath: import("zod").ZodString;
+        coverage: import("zod").ZodDefault<import("zod").ZodNumber>;
+        dryRun: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strict>>;
+    readmeImprovementTool: import("fastmcp").Tool<undefined, import("zod").ZodObject<{
+        basePath: import("zod").ZodString;
+        includeExamples: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strict>>;
+};
+export { decoratorTools };

package/lib/esm/mcp/tools/index.js

@@ -0,0 +1,29 @@
+import { decoratorTools } from "../decorator-tools";
+import { moduleRegistry } from "../moduleRegistry";
+import { toolList as coreToolList, } from "./tools";
+import { coverageEnforcerTool, documentObjectTool, readmeImprovementTool, } from "./codex-tools";
+export * from "./tools";
+export * from "./codex-tools";
+export * from "./generateMcpModule";
+const codexToolList = [
+    documentObjectTool,
+    coverageEnforcerTool,
+    readmeImprovementTool,
+];
+const moduleToolList = moduleRegistry.listTools().map((asset) => asset.tool);
+export const toolList = [...coreToolList, ...codexToolList, ...moduleToolList];
+export const decoratorToolList = Object.values(decoratorTools);
+const [analyzeRepositoryTool, enumerateCapabilitiesTool, planFeatureTool, documentCodeToolRef, applyCodeChangeToolRef,] = coreToolList;
+export const tools = {
+    analyzeRepositoryTool,
+    enumerateCapabilitiesTool,
+    planFeatureTool,
+    documentCodeTool: documentCodeToolRef,
+    applyCodeChangeTool: applyCodeChangeToolRef,
+    documentObjectTool,
+    coverageEnforcerTool,
+    readmeImprovementTool,
+    ...decoratorTools,
+};
+export { decoratorTools };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbWNwL3Rvb2xzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUNwRCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDbkQsT0FBTyxFQUdMLFFBQVEsSUFBSSxZQUFZLEdBQ3pCLE1BQU0sU0FBUyxDQUFDO0FBQ2pCLE9BQU8sRUFDTCxvQkFBb0IsRUFDcEIsa0JBQWtCLEVBQ2xCLHFCQUFxQixHQUN0QixNQUFNLGVBQWUsQ0FBQztBQUV2QixjQUFjLFNBQVMsQ0FBQztBQUN4QixjQUFjLGVBQWUsQ0FBQztBQUM5QixjQUFjLHFCQUFxQixDQUFDO0FBRXBDLE1BQU0sYUFBYSxHQUFHO0lBQ3BCLGtCQUFrQjtJQUNsQixvQkFBb0I7SUFDcEIscUJBQXFCO0NBQ3RCLENBQUM7QUFFRixNQUFNLGNBQWMsR0FBRyxjQUFjLENBQUMsU0FBUyxFQUFFLENBQUMsR0FBRyxDQUFDLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxLQUFLLENBQUMsSUFBVyxDQUFDLENBQUM7QUFFcEYsTUFBTSxDQUFDLE1BQU0sUUFBUSxHQUFHLENBQUMsR0FBRyxZQUFZLEVBQUUsR0FBRyxhQUFhLEVBQUUsR0FBRyxjQUFjLENBQUMsQ0FBQztBQUMvRSxNQUFNLENBQUMsTUFBTSxpQkFBaUIsR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDLGNBQWMsQ0FBQyxDQUFDO0FBQy9ELE1BQU0sQ0FDSixxQkFBcUIsRUFDckIseUJBQXlCLEVBQ3pCLGVBQWUsRUFDZixtQkFBbUIsRUFDbkIsc0JBQXNCLEVBQ3ZCLEdBQUcsWUFBWSxDQUFDO0FBRWpCLE1BQU0sQ0FBQyxNQUFNLEtBQUssR0FBRztJQUNuQixxQkFBcUI7SUFDckIseUJBQXlCO0lBQ3pCLGVBQWU7SUFDZixnQkFBZ0IsRUFBRSxtQkFBbUI7SUFDckMsbUJBQW1CLEVBQUUsc0JBQXNCO0lBQzNDLGtCQUFrQjtJQUNsQixvQkFBb0I7SUFDcEIscUJBQXFCO0lBQ3JCLEdBQUcsY0FBYztDQUNsQixDQUFDO0FBRUYsT0FBTyxFQUFFLGNBQWMsRUFBRSxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgZGVjb3JhdG9yVG9vbHMgfSBmcm9tIFwiLi4vZGVjb3JhdG9yLXRvb2xzXCI7XG5pbXBvcnQgeyBtb2R1bGVSZWdpc3RyeSB9IGZyb20gXCIuLi9tb2R1bGVSZWdpc3RyeVwiO1xuaW1wb3J0IHtcbiAgYXBwbHlDb2RlQ2hhbmdlVG9vbCxcbiAgZG9jdW1lbnRDb2RlVG9vbCxcbiAgdG9vbExpc3QgYXMgY29yZVRvb2xMaXN0LFxufSBmcm9tIFwiLi90b29sc1wiO1xuaW1wb3J0IHtcbiAgY292ZXJhZ2VFbmZvcmNlclRvb2wsXG4gIGRvY3VtZW50T2JqZWN0VG9vbCxcbiAgcmVhZG1lSW1wcm92ZW1lbnRUb29sLFxufSBmcm9tIFwiLi9jb2RleC10b29sc1wiO1xuXG5leHBvcnQgKiBmcm9tIFwiLi90b29sc1wiO1xuZXhwb3J0ICogZnJvbSBcIi4vY29kZXgtdG9vbHNcIjtcbmV4cG9ydCAqIGZyb20gXCIuL2dlbmVyYXRlTWNwTW9kdWxlXCI7XG5cbmNvbnN0IGNvZGV4VG9vbExpc3QgPSBbXG4gIGRvY3VtZW50T2JqZWN0VG9vbCxcbiAgY292ZXJhZ2VFbmZvcmNlclRvb2wsXG4gIHJlYWRtZUltcHJvdmVtZW50VG9vbCxcbl07XG5cbmNvbnN0IG1vZHVsZVRvb2xMaXN0ID0gbW9kdWxlUmVnaXN0cnkubGlzdFRvb2xzKCkubWFwKChhc3NldCkgPT4gYXNzZXQudG9vbCBhcyBhbnkpO1xuXG5leHBvcnQgY29uc3QgdG9vbExpc3QgPSBbLi4uY29yZVRvb2xMaXN0LCAuLi5jb2RleFRvb2xMaXN0LCAuLi5tb2R1bGVUb29sTGlzdF07XG5leHBvcnQgY29uc3QgZGVjb3JhdG9yVG9vbExpc3QgPSBPYmplY3QudmFsdWVzKGRlY29yYXRvclRvb2xzKTtcbmNvbnN0IFtcbiAgYW5hbHl6ZVJlcG9zaXRvcnlUb29sLFxuICBlbnVtZXJhdGVDYXBhYmlsaXRpZXNUb29sLFxuICBwbGFuRmVhdHVyZVRvb2wsXG4gIGRvY3VtZW50Q29kZVRvb2xSZWYsXG4gIGFwcGx5Q29kZUNoYW5nZVRvb2xSZWYsXG5dID0gY29yZVRvb2xMaXN0O1xuXG5leHBvcnQgY29uc3QgdG9vbHMgPSB7XG4gIGFuYWx5emVSZXBvc2l0b3J5VG9vbCxcbiAgZW51bWVyYXRlQ2FwYWJpbGl0aWVzVG9vbCxcbiAgcGxhbkZlYXR1cmVUb29sLFxuICBkb2N1bWVudENvZGVUb29sOiBkb2N1bWVudENvZGVUb29sUmVmLFxuICBhcHBseUNvZGVDaGFuZ2VUb29sOiBhcHBseUNvZGVDaGFuZ2VUb29sUmVmLFxuICBkb2N1bWVudE9iamVjdFRvb2wsXG4gIGNvdmVyYWdlRW5mb3JjZXJUb29sLFxuICByZWFkbWVJbXByb3ZlbWVudFRvb2wsXG4gIC4uLmRlY29yYXRvclRvb2xzLFxufTtcblxuZXhwb3J0IHsgZGVjb3JhdG9yVG9vbHMgfTsiXX0=

package/lib/esm/mcp/tools/tools.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from "fastmcp";
+import { analyzeRepoSchema, codeChangeSchema, documentCodeSchema, enumerateCapabilitiesSchema, planFeatureSchema } from "../schemas";
+export declare function buildAnalyzeRepositoryTool(): Tool<undefined, typeof analyzeRepoSchema>;
+export declare function buildEnumerateCapabilitiesTool(): Tool<undefined, typeof enumerateCapabilitiesSchema>;
+export declare function buildPlanFeatureTool(): Tool<undefined, typeof planFeatureSchema>;
+export declare const documentCodeTool: Tool<undefined, typeof documentCodeSchema>;
+export declare const applyCodeChangeTool: Tool<undefined, typeof codeChangeSchema>;
+type AnyTool = Tool<undefined, any>;
+export declare const toolList: AnyTool[];
+export {};