@decaf-ts/mcp-server 0.4.2 → 0.4.7

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

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

package/lib/esm/tools/ast-jsdoc-tools/utils/conflict-detector.d.ts

@@ -0,0 +1,5 @@
+export declare function hasExistingJsDoc(fileContent: string, nodeStartLine: number): {
+    has: boolean;
+    block: string;
+};
+export default hasExistingJsDoc;

package/lib/esm/tools/ast-jsdoc-tools/utils/conflict-detector.js

@@ -0,0 +1,30 @@
+export function hasExistingJsDoc(fileContent, nodeStartLine) {
+    const lines = fileContent.split(/\r?\n/);
+    // look up to 10 lines above the node start for a JSDoc block
+    const startIdx = Math.max(0, nodeStartLine - 10); // nodeStartLine is 1-based
+    // check from the provided line (nodeStartLine - 1) upwards
+    for (let i = nodeStartLine - 1; i >= startIdx; i--) {
+        const line = (lines[i] || '').trim();
+        if (line.endsWith('*/') || line === '*/') {
+            // gather the block
+            let j = i;
+            const blockLines = [];
+            while (j >= 0) {
+                blockLines.unshift(lines[j]);
+                if (lines[j].trim().startsWith('/**'))
+                    break;
+                j--;
+            }
+            const block = blockLines.join('\n');
+            if (block.includes('/**')) {
+                return { has: true, block };
+            }
+        }
+        // stop if hit a blank line or code line without comment marker
+        if (line && !line.startsWith('*') && !line.startsWith('//') && !line.startsWith('/**'))
+            break;
+    }
+    return { has: false, block: '' };
+}
+export default hasExistingJsDoc;
+//# sourceMappingURL=conflict-detector.js.map

package/lib/esm/tools/ast-jsdoc-tools/utils/conflict-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-detector.js","sourceRoot":"","sources":["../../../../../src/tools/ast-jsdoc-tools/utils/conflict-detector.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,aAAqB;IACzE,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,EAAE,CAAC,CAAC,CAAC,2BAA2B;IAC7E,2DAA2D;IAC3D,KAAK,IAAI,CAAC,GAAG,aAAa,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACzC,mBAAmB;YACnB,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,MAAM,UAAU,GAAG,EAAc,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACd,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7B,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;oBAAE,MAAM;gBAC7C,CAAC,EAAE,CAAC;YACN,CAAC;YACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,+DAA+D;QAC/D,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM;IAChG,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACnC,CAAC;AAED,eAAe,gBAAgB,CAAC"}

package/lib/esm/tools/ast-jsdoc-tools/utils/context-schema.d.ts

@@ -0,0 +1,7 @@
+/** Very small validator for the mapping file used by the tool.
+ * Returns { valid, errors } where errors is a list of strings describing issues.
+ */
+export declare function validateMappingFile(obj: any): {
+    valid: boolean;
+    errors: string[];
+};

package/lib/esm/tools/ast-jsdoc-tools/utils/context-schema.js

@@ -0,0 +1,29 @@
+/** Very small validator for the mapping file used by the tool.
+ * Returns { valid, errors } where errors is a list of strings describing issues.
+ */
+export function validateMappingFile(obj) {
+    const errors = [];
+    if (!obj || typeof obj !== 'object') {
+        return { valid: false, errors: ['mapping is not an object'] };
+    }
+    if (!obj.mappingVersion || typeof obj.mappingVersion !== 'string') {
+        errors.push('mappingVersion must be a string');
+    }
+    if (obj.overrides) {
+        if (typeof obj.overrides !== 'object')
+            errors.push('overrides must be an object');
+        else if (obj.overrides.files) {
+            if (!Array.isArray(obj.overrides.files))
+                errors.push('overrides.files must be an array');
+            else {
+                for (const [i, e] of obj.overrides.files.entries()) {
+                    if (!e.pattern || typeof e.pattern !== 'string')
+                        errors.push(`overrides.files[${i}].pattern must be a string`);
+                }
+            }
+        }
+    }
+    // heuristics optional
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=context-schema.js.map

package/lib/esm/tools/ast-jsdoc-tools/utils/context-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-schema.js","sourceRoot":"","sources":["../../../../../src/tools/ast-jsdoc-tools/utils/context-schema.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAQ;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;QAClE,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;aAC7E,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;iBACpF,CAAC;gBACJ,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;oBACnD,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;wBAAE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,4BAA4B,CAAC,CAAC;gBACjH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,sBAAsB;IACtB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}

package/lib/esm/tools/ast-jsdoc-tools/utils/heuristics.d.ts

@@ -0,0 +1,2 @@
+export declare function inferContextHints(filePath: string, repoRoot?: string): string[];
+export default inferContextHints;

package/lib/esm/tools/ast-jsdoc-tools/utils/heuristics.js

@@ -0,0 +1,31 @@
+export function inferContextHints(filePath, repoRoot = '.') {
+    const hints = [];
+    const p = filePath.replace(/\\/g, '/');
+    const parts = p.split('/');
+    // directory-based hints
+    if (p.includes('/cli/') || p.endsWith('.cli.ts') || p.includes('/bin/'))
+        hints.push('cli');
+    if (p.includes('/api/'))
+        hints.push('api');
+    if (/\.controller\./.test(p) || p.includes('.controller'))
+        hints.push('controller');
+    if (p.includes('/tests/') || p.includes('/test-fixtures/'))
+        hints.push('test');
+    if (p.startsWith('lib/') || p.startsWith('dist/') || p.startsWith('build/'))
+        hints.push('library');
+    // filename-based hints
+    const file = parts[parts.length - 1] || '';
+    if (/index\./i.test(file))
+        hints.push('index');
+    if (/service\.|\.service\./i.test(file))
+        hints.push('service');
+    if (/router\.|\.router\./i.test(file))
+        hints.push('router');
+    // export surface heuristics
+    if (p.includes('/src/'))
+        hints.push('source');
+    // normalize unique
+    return Array.from(new Set(hints));
+}
+export default inferContextHints;
+//# sourceMappingURL=heuristics.js.map

package/lib/esm/tools/ast-jsdoc-tools/utils/heuristics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heuristics.js","sourceRoot":"","sources":["../../../../../src/tools/ast-jsdoc-tools/utils/heuristics.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,QAAQ,GAAG,GAAG;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE3B,wBAAwB;IACxB,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3F,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpF,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/E,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEnG,uBAAuB;IACvB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/D,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE5D,4BAA4B;IAC5B,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE9C,mBAAmB;IACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,eAAe,iBAAiB,CAAC"}

package/lib/esm/tools/ast-jsdoc-tools/utils/ts-project.d.ts

@@ -0,0 +1,12 @@
+export declare function analyzeFile(filePath: string): Promise<{
+    filePath: string;
+    functions: (string | undefined)[];
+    classes: (string | undefined)[];
+    error?: undefined;
+} | {
+    filePath: string;
+    functions: never[];
+    classes: never[];
+    error: string;
+}>;
+export default analyzeFile;

package/lib/esm/tools/ast-jsdoc-tools/utils/ts-project.js

@@ -0,0 +1,21 @@
+import { Project } from 'ts-morph';
+import * as fs from 'fs';
+export async function analyzeFile(filePath) {
+    try {
+        const p = new Project({ tsConfigFilePath: 'tsconfig.json' });
+        if (fs.existsSync(filePath)) {
+            const sf = p.addSourceFileAtPathIfExists(filePath) || p.createSourceFile(filePath, fs.readFileSync(filePath, 'utf8'));
+            return {
+                filePath,
+                functions: sf.getFunctions().map(f => f.getName()),
+                classes: sf.getClasses().map(c => c.getName()),
+            };
+        }
+        return { filePath, functions: [], classes: [] };
+    }
+    catch (e) {
+        return { filePath, functions: [], classes: [], error: String(e) };
+    }
+}
+export default analyzeFile;
+//# sourceMappingURL=ts-project.js.map

package/lib/esm/tools/ast-jsdoc-tools/utils/ts-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-project.js","sourceRoot":"","sources":["../../../../../src/tools/ast-jsdoc-tools/utils/ts-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC,CAAC;QAC7D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,CAAC,CAAC,2BAA2B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;YACtH,OAAO;gBACL,QAAQ;gBACR,SAAS,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;gBAClD,OAAO,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;aAC/C,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAClD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,CAAC;AACH,CAAC;AAED,eAAe,WAAW,CAAC"}

package/lib/esm/tools/example-tool/index.d.ts

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

package/lib/esm/tools/example-tool/index.js

@@ -0,0 +1,29 @@
+import { ToolBuilder } from "./../../builders/tool-builder.js";
+import { z } from "zod";
+import { ReasoningLevel, EffortLevel, Cost } from "./../../constants.js";
+// A tiny example tool that reverses an input string. Useful as a smoke/example tool.
+export const ExampleTool = ToolBuilder.builder
+    .setName("example-tool")
+    .setTitle("Example: Reverse String Tool")
+    .setDescription("Reverses the provided `text` input and returns the result.")
+    .setInputSchema(z.object({ text: z.string() }))
+    .setCb(async (args, _extra) => {
+    const text = args?.text ?? "";
+    const reversed = String(text).split("").reverse().join("");
+    return {
+        // Human-readable content for models and UIs
+        content: [
+            {
+                type: "text",
+                text: reversed,
+            },
+        ],
+        // Structured content matching the declared outputSchema: { result: string }
+        structuredContent: { result: reversed },
+    };
+})
+    .setReasoning(ReasoningLevel.NONE)
+    .setEffort(EffortLevel.NONE)
+    .setCost(Cost.FREE);
+// Named export already provided above; avoid default exports per repository policy.
+//# sourceMappingURL=index.js.map

package/lib/esm/tools/example-tool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/example-tool/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,yCAAoC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,6BAAwB;AAOpE,qFAAqF;AACrF,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO;KAC3C,OAAO,CAAC,cAAc,CAAC;KACvB,QAAQ,CAAC,8BAA8B,CAAC;KACxC,cAAc,CAAC,4DAA4D,CAAC;KAC5E,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;KAC9C,KAAK,CAAC,KAAK,EAAE,IAAS,EAAE,MAA8D,EAAE,EAAE;IACzF,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,OAAO;QACL,4CAA4C;QAC5C,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;aACf;SACF;QACD,4EAA4E;QAC5E,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;KACjC,CAAC;AACX,CAAC,CAAC;KACD,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC;KACjC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC;KAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEtB,oFAAoF"}

package/lib/esm/tools/file-summarizer/index.d.ts

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

package/lib/esm/tools/file-summarizer/index.js

@@ -0,0 +1,29 @@
+import { ToolBuilder } from "./../../builders/tool-builder.js";
+import { z } from "zod";
+import { ReasoningLevel, EffortLevel, Cost } from "./../../constants.js";
+import { analyzeFile } from "./../ast-jsdoc-tools/index.js";
+export const FileSummarizer = ToolBuilder.builder
+    .setName("file.summarizer")
+    .setTitle("File Summarizer")
+    .setDescription("Produce a short structured summary for a TypeScript file.")
+    .setInputSchema(z.object({ filePath: z.string() }))
+    .setCb(async (args, _extra) => {
+    const filePath = args?.filePath ?? args?.path;
+    if (!filePath)
+        return { content: [{ type: "text", text: "" }] };
+    const res = await analyzeFile(filePath).catch(() => null);
+    const objects = (res && res.astObjects) || [];
+    const names = objects.map((o) => o.name || o.id || o.kind).slice(0, 20);
+    const summary = `Found ${objects.length} AST objects. Top names: ${names.join(", ")}`;
+    return {
+        // Text content for readability
+        content: [{ type: "text", text: summary }],
+        // Structured content matching the declared outputSchema: { summary: string }
+        structuredContent: { summary },
+        _meta: { count: objects.length },
+    };
+})
+    .setReasoning(ReasoningLevel.NONE)
+    .setEffort(EffortLevel.NONE)
+    .setCost(Cost.FREE);
+//# sourceMappingURL=index.js.map

package/lib/esm/tools/file-summarizer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/file-summarizer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,yCAAoC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,6BAAwB;AAMpE,OAAO,EAAE,WAAW,EAAE,sCAAiC;AAEvD,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO;KAC9C,OAAO,CAAC,iBAAiB,CAAC;KAC1B,QAAQ,CAAC,iBAAiB,CAAC;KAC3B,cAAc,CAAC,2DAA2D,CAAC;KAC3E,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;KAClD,KAAK,CACJ,KAAK,EACH,IAAS,EACT,MAA8D,EAC9D,EAAE;IACF,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI,EAAE,IAAI,CAAC;IAC9C,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAS,CAAC;IACvE,MAAM,GAAG,GAAQ,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,SAAS,OAAO,CAAC,MAAM,4BAA4B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACtF,OAAO;QACL,+BAA+B;QAC/B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,6EAA6E;QAC7E,iBAAiB,EAAE,EAAE,OAAO,EAAE;QAC9B,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;KAC1B,CAAC;AACX,CAAC,CACF;KACA,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC;KACjC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC;KAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

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

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

package/lib/esm/tools/index.js

@@ -0,0 +1,6 @@
+import { TsAstTool } from "./ast/ts-ast-tool.js";
+import { ExampleTool } from "./example-tool/index.js";
+import { FileSummarizer } from "./file-summarizer/index.js";
+import { AstJsdocTool } from "./ast-jsdoc-tools/index.js";
+export const Tools = [TsAstTool, ExampleTool, FileSummarizer, AstJsdocTool];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,6BAA0B;AAE9C,OAAO,EAAE,WAAW,EAAE,gCAAuB;AAC7C,OAAO,EAAE,cAAc,EAAE,mCAA0B;AACnD,OAAO,EAAE,YAAY,EAAE,mCAA0B;AAEjD,MAAM,CAAC,MAAM,KAAK,GAAkB,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC"}

package/lib/esm/tools/jsdoc/ts-jsdoc-element-tool.d.ts

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

package/lib/esm/tools/jsdoc/ts-jsdoc-element-tool.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import { zAstObject } from "./../ast/types.js";
+import { TsDocConstPrompt } from "./../../prompts/jsdocs/const-prompt.js";
+import { TsDocClassPrompt } from "./../../prompts/jsdocs/class-prompt.js";
+import { TsDocFunctionPrompt } from "./../../prompts/jsdocs/function-prompt.js";
+import { TsDocInterfacePrompt } from "./../../prompts/jsdocs/interface-prompt.js";
+import { TsDocTypeePrompt } from "./../../prompts/jsdocs/types-prompt.js";
+import { TsDocEnumPrompt } from "./../../prompts/jsdocs/enum-prompt.js";
+import { TsDocDecoratorPrompt } from "./../../prompts/jsdocs/decorator-prompt.js";
+import { ToolBuilder } from "./../../builders/tool-builder.js";
+import { Cost, EffortLevel, ReasoningLevel } from "./../../constants.js";
+const toolName = "ts.jsdoc.element";
+const inputSchema = z
+    .object({
+    astElement: zAstObject.describe("The AST TypeScript object to document"),
+    previewLength: z.number().min(50).max(500).default(100),
+})
+    .describe(`the input schema for the ${toolName} tool`);
+const outputSchema = z
+    .object({})
+    .describe(`the output schema for the ${toolName} tool`);
+export const TsDocumentElementTool = ToolBuilder.builder
+    .setName(toolName)
+    .setTitle("Tool to generate jsdocs for a javascript element (class, interface, function etc)")
+    .setDescription("Generate JSDoc comments for a specific element in a TypeScript file according to a curated template and prompt.")
+    .setInputSchema(inputSchema)
+    .setOutputSchema(outputSchema)
+    .setAnnotations({
+    title: "Tool to generate jsdocs for a javascript element (class, interface, function etc)",
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+})
+    .setReasoning(ReasoningLevel.HIGH)
+    .setEffort(EffortLevel.MEDIUM)
+    .setCost(Cost.LOW)
+    .setCb(async (input, extra) => {
+    const elType = input.astElement.kind;
+    const filePath = input.astElement.location.filePath;
+    if (!filePath) {
+        throw new Error("AST element is missing filePath in location");
+    }
+    function getPrompt() {
+        switch (elType) {
+            case "class":
+                return TsDocClassPrompt;
+            case "function":
+                return TsDocFunctionPrompt;
+            case "interface":
+                return TsDocInterfacePrompt;
+            case "type":
+                return TsDocTypeePrompt;
+            case "enum":
+                return TsDocEnumPrompt;
+            case "constant":
+                return TsDocConstPrompt;
+            case "decorator":
+                return TsDocDecoratorPrompt;
+            case "namespace":
+            case "cli-module":
+            case "module":
+            default:
+                throw new Error(`Invalid element type: ${elType}`);
+        }
+    }
+    const prompt = (await getPrompt()["cb"]({}, extra)).messages
+        .map((m) => m.content)
+        .join("\n");
+    const preview = prompt.substring(0, input.previewLength);
+    return {
+        // TEXT content so the model sees a readable version in chat
+        content: [{ type: "text", text: prompt }],
+        // small metadata so hosts can inspect provenance
+        _meta: { filePath },
+        // STRUCTURED for hosts/clients that inspect tool results
+        structuredContent: {
+            kind: "messages",
+            preview,
+            messages: input.astElement,
+        },
+    };
+});
+//# sourceMappingURL=ts-jsdoc-element-tool.js.map

package/lib/esm/tools/jsdoc/ts-jsdoc-element-tool.js.map

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

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

@@ -0,0 +1,5 @@
+export declare function hasExistingJsDoc(sourceText: string, nodeStartLine: number): {
+    has: boolean;
+    block?: string;
+};
+export declare function inferContextHints(filePath: string, repoRoot?: string): string[];

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

@@ -0,0 +1,53 @@
+import path from "path";
+export function hasExistingJsDoc(sourceText, nodeStartLine) {
+    // Simple heuristic: look for /** */ block immediately preceding the line
+    const lines = sourceText.split(/\r?\n/);
+    const idx = Math.max(0, nodeStartLine - 2); // 0-based
+    for (let i = idx; i >= 0 && i > idx - 6; i--) {
+        const line = lines[i].trim();
+        if (line.startsWith("/**")) {
+            // collect block
+            const blockLines = [];
+            for (let j = i; j < lines.length; j++) {
+                blockLines.push(lines[j]);
+                if (lines[j].includes("*/"))
+                    break;
+            }
+            return { has: true, block: blockLines.join("\n") };
+        }
+        if (line && !line.startsWith("*") && !line.startsWith("//"))
+            break;
+    }
+    return { has: false };
+}
+export function inferContextHints(filePath, repoRoot) {
+    const rel = repoRoot ? path.relative(repoRoot, filePath) : filePath;
+    const parts = rel.split(path.sep);
+    const hints = new Set();
+    const p = rel.toLowerCase();
+    if (p.includes(`${path.sep}cli${path.sep}`) ||
+        p.endsWith(".cli.ts") ||
+        p.includes("bin"))
+        hints.add("cli");
+    if (p.includes(`${path.sep}api${path.sep}`) || p.includes("/api/"))
+        hints.add("api");
+    if (p.includes(`${path.sep}lib${path.sep}`) || p.includes("/lib/"))
+        hints.add("lib");
+    if (p.includes("test") || p.includes("__tests__"))
+        hints.add("test-fixture");
+    if (p.endsWith("index.ts"))
+        hints.add("index");
+    // filename patterns
+    const file = path.basename(rel);
+    if (file.endsWith(".controller.ts"))
+        hints.add("controller");
+    if (file.endsWith(".service.ts"))
+        hints.add("service");
+    if (file.endsWith(".spec.ts") || file.endsWith(".test.ts"))
+        hints.add("test");
+    // default: if under src or lib, mark as library
+    if (parts.includes("src") || parts.includes("lib"))
+        hints.add("library");
+    return Array.from(hints);
+}
+//# sourceMappingURL=utils.js.map

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

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

package/lib/esm/tools/testing/ts-jest-list-tests.d.ts

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

package/lib/esm/tools/testing/ts-jest-list-tests.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { zAstObject } from "./../ast/types.js";
+import { ToolBuilder } from "./../../builders/tool-builder.js";
+import { Cost, EffortLevel, ReasoningLevel } from "./../../constants.js";
+import { runCommand } from "@decaf-ts/utils";
+const toolName = "ts.jsdoc.element";
+const inputSchema = z
+    .object({
+    astElement: zAstObject.describe("The AST TypeScript object to document"),
+    previewLength: z.number().min(50).max(500).default(100),
+})
+    .describe(`the input schema for the ${toolName} tool`);
+const outputSchema = z
+    .object({})
+    .describe(`the output schema for the ${toolName} tool`);
+export const TsDocumentElementTool = ToolBuilder.builder
+    .setName(toolName)
+    .setTitle("Tool to generate jsdocs for a javascript element (class, interface, function etc)")
+    .setDescription("Generate JSDoc comments for a specific element in a TypeScript file according to a curated template and prompt.")
+    .setInputSchema(inputSchema)
+    .setOutputSchema(outputSchema)
+    .setAnnotations({
+    title: "Tool to generate jsdocs for a javascript element (class, interface, function etc)",
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+})
+    .setReasoning(ReasoningLevel.HIGH)
+    .setEffort(EffortLevel.MEDIUM)
+    .setCost(Cost.LOW)
+    .setCb(async (input, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+extra) => {
+    const cwd = process.cwd();
+    const tests = await runCommand("npx jest --listTests", {
+        cwd,
+    }).promise;
+    // run npx jest --listTests and capture output
+    return {
+        // TEXT content so the model sees a readable version in chat
+        content: [{ type: "text", text: tests }],
+        // small metadata so hosts can inspect provenance
+        _meta: { cwd },
+        // STRUCTURED for hosts/clients that inspect tool results
+        structuredContent: {
+            kind: "messages",
+            tests,
+            messages: input.astElement,
+        },
+    };
+});
+//# sourceMappingURL=ts-jest-list-tests.js.map

package/lib/esm/tools/testing/ts-jest-list-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-jest-list-tests.js","sourceRoot":"","sources":["../../../../src/tools/testing/ts-jest-list-tests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,0BAAqB;AAM1C,OAAO,EAAE,WAAW,EAAE,yCAAoC;AAC1D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,6BAAwB;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAEpC,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACxE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;CACxD,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,qBAAqB,GAAgB,WAAW,CAAC,OAAO;KAClE,OAAO,CAAC,QAAQ,CAAC;KACjB,QAAQ,CACP,mFAAmF,CACpF;KACA,cAAc,CACb,iHAAiH,CAClH;KACA,cAAc,CAAC,WAAW,CAAC;KAC3B,eAAe,CAAC,YAAY,CAAC;KAC7B,cAAc,CAAC;IACd,KAAK,EACH,mFAAmF;IACrF,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,KAAK;CACrB,CAAC;KACD,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC;KACjC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC;KAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;KACjB,KAAK,CACJ,KAAK,EACH,KAAU;AACV,6DAA6D;AAC7D,KAA6D,EAC7D,EAAE;IACF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,sBAAsB,EAAE;QACrD,GAAG;KACJ,CAAC,CAAC,OAAO,CAAC;IACX,8CAA8C;IAE9C,OAAO;QACL,4DAA4D;QAC5D,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACxC,iDAAiD;QACjD,KAAK,EAAE,EAAE,GAAG,EAAE;QACd,yDAAyD;QACzD,iBAAiB,EAAE;YACjB,IAAI,EAAE,UAAU;YAChB,KAAK;YACL,QAAQ,EAAE,KAAK,CAAC,UAAU;SAC3B;KACF,CAAC;AACJ,CAAC,CACF,CAAC"}

package/lib/esm/types.d.ts

@@ -1,55 +1,64 @@
-import type { ContentResult, FastMCP, Tool } from "fastmcp";
-/**
- * @description Function type for Decaf MCP modules
- * @summary Defines the signature for MCP module functions that each Decaf module must export under the MCP_FILE_NAME file
- * The function should return a Server object or a Promise that resolves to a Server object
- *
- * @typedef {Function} McpModule
- * @return {Server|Promise<Server>} A Command object or Promise that resolves to a Server object
- * @memberOf module:CLI
- */
-export type McpModule = {
-    enrich(mcp: FastMCP): FastMCP | Promise<FastMCP>;
-    PACKAGE_NAME: string;
-    VERSION: string;
-};
-export type ModuleStatus = "active" | "disabled";
-export interface BaseAsset {
+import { ZodErrorMap, ZodOptional, ZodRawShape, ZodType } from "zod";
+import { GetPromptResult, Resource, ToolAnnotations } from "@modelcontextprotocol/sdk/types";
+import { PromptCallback, ReadResourceCallback, ToolCallback } from "@modelcontextprotocol/sdk/server/mcp";
+import { Cost, EffortLevel, ReasoningLevel } from "./constants";
+interface ZodTypeDef {
+    errorMap?: ZodErrorMap | undefined;
+    description?: string | undefined;
+}
+export type PromptExport = {
     id: string;
     title: string;
-    description?: string;
-    tags?: string[];
-    provenance?: string;
+    load: (...args: any[]) => any;
+};
+export type ModuleExportPackage = {
+    name: string;
+    prompts?: PromptExport[];
+    resources?: any[];
+    templates?: any[];
+    tools?: any[];
+};
+export interface Definition {
+    name: string;
+    title: string;
+    description: string;
 }
-export interface PromptAsset extends BaseAsset {
-    load: () => Promise<string> | string;
+export interface ResourceDefinition extends Definition {
+    uriOrTemplate: string;
+    config: Omit<Resource, "uri" | "name">;
+    _meta: ResourceMeta;
+    cb: ReadResourceCallback;
 }
-export interface ResourceAsset extends BaseAsset {
-    uri: string;
-    mimeType: string;
-    load: () => Promise<ContentResult> | ContentResult;
+type PromptArgsRawShape = {
+    [k: string]: ZodType<string, ZodTypeDef, string> | ZodOptional<ZodType<string, ZodTypeDef, string>>;
+};
+export interface PromptDefinition<Args extends PromptArgsRawShape> extends Definition {
+    argsSchema?: Args;
+    _meta: PromptMeta;
+    cb: PromptCallback<Args>;
 }
-export interface TemplateAsset extends BaseAsset {
-    content: string;
-    placeholders?: string[];
+export type PromptCallbackType = GetPromptResult;
+export interface ToolDefinition<InputArgs extends ZodRawShape, OutputArgs extends ZodRawShape> extends Definition {
+    inputSchema: InputArgs;
+    outputSchema: OutputArgs;
+    annotations: ToolAnnotations;
+    _meta: ToolMeta;
+    cb: ToolCallback<InputArgs>;
 }
-export interface ToolAsset extends BaseAsset {
-    tool: Tool<any, any>;
+export interface UsageRequirements {
+    reasoning: ReasoningLevel;
+    effort: EffortLevel;
+    cost: Cost;
 }
-export interface ModuleExportPackage {
-    name: string;
-    status?: ModuleStatus;
-    version?: string;
-    lastUpdated?: string;
-    prompts: PromptAsset[];
-    resources: ResourceAsset[];
-    templates: TemplateAsset[];
-    tools: ToolAsset[];
-}
-export type ValidationIssueType = "missing-folder" | "missing-export" | "duplicate-id" | "empty-asset" | "runtime-failure";
-export interface ValidationIssue {
-    type: ValidationIssueType;
-    module: string;
-    detail: string;
-    severity: "error" | "warning";
+export interface Meta {
+}
+export interface ResourceMeta extends Meta {
+}
+export interface UsableMeta extends Meta {
+    usage: UsageRequirements;
+}
+export interface ToolMeta extends UsableMeta {
+}
+export interface PromptMeta extends UsableMeta {
 }
+export {};

package/lib/esm/types.js

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHsgQ29udGVudFJlc3VsdCwgRmFzdE1DUCwgVG9vbCB9IGZyb20gXCJmYXN0bWNwXCI7XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIEZ1bmN0aW9uIHR5cGUgZm9yIERlY2FmIE1DUCBtb2R1bGVzXG4gKiBAc3VtbWFyeSBEZWZpbmVzIHRoZSBzaWduYXR1cmUgZm9yIE1DUCBtb2R1bGUgZnVuY3Rpb25zIHRoYXQgZWFjaCBEZWNhZiBtb2R1bGUgbXVzdCBleHBvcnQgdW5kZXIgdGhlIE1DUF9GSUxFX05BTUUgZmlsZVxuICogVGhlIGZ1bmN0aW9uIHNob3VsZCByZXR1cm4gYSBTZXJ2ZXIgb2JqZWN0IG9yIGEgUHJvbWlzZSB0aGF0IHJlc29sdmVzIHRvIGEgU2VydmVyIG9iamVjdFxuICpcbiAqIEB0eXBlZGVmIHtGdW5jdGlvbn0gTWNwTW9kdWxlXG4gKiBAcmV0dXJuIHtTZXJ2ZXJ8UHJvbWlzZTxTZXJ2ZXI+fSBBIENvbW1hbmQgb2JqZWN0IG9yIFByb21pc2UgdGhhdCByZXNvbHZlcyB0byBhIFNlcnZlciBvYmplY3RcbiAqIEBtZW1iZXJPZiBtb2R1bGU6Q0xJXG4gKi9cbmV4cG9ydCB0eXBlIE1jcE1vZHVsZSA9IHtcbiAgZW5yaWNoKG1jcDogRmFzdE1DUCk6IEZhc3RNQ1AgfCBQcm9taXNlPEZhc3RNQ1A+O1xuICBQQUNLQUdFX05BTUU6IHN0cmluZztcbiAgVkVSU0lPTjogc3RyaW5nO1xufTtcblxuZXhwb3J0IHR5cGUgTW9kdWxlU3RhdHVzID0gXCJhY3RpdmVcIiB8IFwiZGlzYWJsZWRcIjtcblxuZXhwb3J0IGludGVyZmFjZSBCYXNlQXNzZXQge1xuICBpZDogc3RyaW5nO1xuICB0aXRsZTogc3RyaW5nO1xuICBkZXNjcmlwdGlvbj86IHN0cmluZztcbiAgdGFncz86IHN0cmluZ1tdO1xuICBwcm92ZW5hbmNlPzogc3RyaW5nO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIFByb21wdEFzc2V0IGV4dGVuZHMgQmFzZUFzc2V0IHtcbiAgbG9hZDogKCkgPT4gUHJvbWlzZTxzdHJpbmc+IHwgc3RyaW5nO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIFJlc291cmNlQXNzZXQgZXh0ZW5kcyBCYXNlQXNzZXQge1xuICB1cmk6IHN0cmluZztcbiAgbWltZVR5cGU6IHN0cmluZztcbiAgbG9hZDogKCkgPT4gUHJvbWlzZTxDb250ZW50UmVzdWx0PiB8IENvbnRlbnRSZXN1bHQ7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgVGVtcGxhdGVBc3NldCBleHRlbmRzIEJhc2VBc3NldCB7XG4gIGNvbnRlbnQ6IHN0cmluZztcbiAgcGxhY2Vob2xkZXJzPzogc3RyaW5nW107XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgVG9vbEFzc2V0IGV4dGVuZHMgQmFzZUFzc2V0IHtcbiAgdG9vbDogVG9vbDxhbnksIGFueT47XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgTW9kdWxlRXhwb3J0UGFja2FnZSB7XG4gIG5hbWU6IHN0cmluZztcbiAgc3RhdHVzPzogTW9kdWxlU3RhdHVzO1xuICB2ZXJzaW9uPzogc3RyaW5nO1xuICBsYXN0VXBkYXRlZD86IHN0cmluZztcbiAgcHJvbXB0czogUHJvbXB0QXNzZXRbXTtcbiAgcmVzb3VyY2VzOiBSZXNvdXJjZUFzc2V0W107XG4gIHRlbXBsYXRlczogVGVtcGxhdGVBc3NldFtdO1xuICB0b29sczogVG9vbEFzc2V0W107XG59XG5cbmV4cG9ydCB0eXBlIFZhbGlkYXRpb25Jc3N1ZVR5cGUgPVxuICB8IFwibWlzc2luZy1mb2xkZXJcIlxuICB8IFwibWlzc2luZy1leHBvcnRcIlxuICB8IFwiZHVwbGljYXRlLWlkXCJcbiAgfCBcImVtcHR5LWFzc2V0XCJcbiAgfCBcInJ1bnRpbWUtZmFpbHVyZVwiO1xuXG5leHBvcnQgaW50ZXJmYWNlIFZhbGlkYXRpb25Jc3N1ZSB7XG4gIHR5cGU6IFZhbGlkYXRpb25Jc3N1ZVR5cGU7XG4gIG1vZHVsZTogc3RyaW5nO1xuICBkZXRhaWw6IHN0cmluZztcbiAgc2V2ZXJpdHk6IFwiZXJyb3JcIiB8IFwid2FybmluZ1wiO1xufVxuIl19
+//# sourceMappingURL=types.js.map