dexe-mcp 0.1.5 → 0.3.0

package/dist/lib/markdownToSlate.js

@@ -0,0 +1,203 @@
+/**
+ * Converts a Markdown string to the Slate node format used by the DeXe
+ * investing-dashboard frontend.
+ *
+ * Uses `unified` + `remark-parse` + `remark-slate-transformer` with overrides
+ * that map remark's default node types to the frontend's ELEMENT_TYPES enum:
+ *
+ *   Remark default       → Frontend Slate type
+ *   ─────────────────────────────────────────────
+ *   heading depth=1      → "heading-one"
+ *   heading depth=2      → "heading-two"
+ *   heading depth=3      → "heading-three"
+ *   paragraph            → "paragraph"           (same)
+ *   list ordered=false    → "bulleted-list"
+ *   list ordered=true     → "numbered-list"
+ *   listItem             → "list-item"
+ *   code                 → "code-block"
+ *   link                 → "link"
+ *   image                → "image"
+ *   delete               → "strikethrough"        (~~text~~)
+ *
+ *   Text marks:
+ *   strong               → { bold: true }
+ *   emphasis             → { italic: true }
+ *   inlineCode           → wrapped in code-inline element
+ *   delete               → { strikethrough: true }
+ */
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkGfm from "remark-gfm";
+import { remarkToSlate } from "remark-slate-transformer";
+/**
+ * Override builders that remap remark-slate-transformer's default output
+ * into the exact element/mark types the frontend expects.
+ */
+const overrides = {
+    // ── Block elements ──────────────────────────────────────────────
+    heading(node, next) {
+        const depthMap = {
+            1: "heading-one",
+            2: "heading-two",
+            3: "heading-three",
+        };
+        return {
+            type: depthMap[node.depth] ?? "heading-three",
+            children: next(node.children),
+        };
+    },
+    // paragraph — default type name matches, but we define it explicitly
+    // to ensure children get processed through `next` consistently
+    paragraph(node, next) {
+        return {
+            type: "paragraph",
+            children: next(node.children),
+        };
+    },
+    list(node, next) {
+        const type = node.ordered ? "numbered-list" : "bulleted-list";
+        return {
+            type,
+            children: next(node.children),
+        };
+    },
+    listItem(node, next) {
+        // remark wraps list item content in a paragraph — we need to flatten
+        // so the frontend gets { type: "list-item", children: [{ text }] }
+        const processed = next(node.children);
+        // If the only child is a paragraph, unwrap its children
+        const children = processed.length === 1 &&
+            processed[0] &&
+            processed[0].type === "paragraph"
+            ? processed[0].children
+            : processed;
+        return {
+            type: "list-item",
+            children,
+        };
+    },
+    code(node) {
+        // Fenced code blocks → code-block element
+        return {
+            type: "code-block",
+            language: node.lang ?? "",
+            children: [{ text: node.value }],
+        };
+    },
+    blockquote(node, next) {
+        // Frontend doesn't have a blockquote type — flatten to paragraphs
+        // Each child (usually paragraphs) gets returned as-is
+        const children = next(node.children);
+        return children.length > 0 ? children : undefined;
+    },
+    thematicBreak() {
+        // --- / *** → no frontend equivalent, skip
+        return { type: "paragraph", children: [{ text: "---" }] };
+    },
+    // ── Inline elements ─────────────────────────────────────────────
+    link(node, next) {
+        return {
+            type: "link",
+            url: node.url,
+            children: next(node.children),
+        };
+    },
+    image(node) {
+        return {
+            type: "image",
+            url: node.url,
+            children: [{ text: node.alt ?? "" }],
+        };
+    },
+    // ── Text marks ──────────────────────────────────────────────────
+    // remark-slate-transformer applies these as flags on text nodes.
+    // We need to remap the flag names to match the frontend's CustomText.
+    strong(node, next) {
+        // Apply bold: true to all text children
+        const children = next(node.children);
+        return children.map((child) => ({ ...child, bold: true }));
+    },
+    emphasis(node, next) {
+        const children = next(node.children);
+        return children.map((child) => ({ ...child, italic: true }));
+    },
+    delete(node, next) {
+        const children = next(node.children);
+        return children.map((child) => ({ ...child, strikethrough: "true" }));
+    },
+    inlineCode(node) {
+        // Frontend has code-inline as an element type wrapping text
+        return {
+            type: "code-inline",
+            children: [{ text: node.value }],
+        };
+    },
+};
+/** The default empty Slate document the frontend uses. */
+const SLATE_DEFAULT = [{ type: "paragraph", children: [{ text: "" }] }];
+/**
+ * Unified processor configured with our overrides.
+ */
+const processor = unified()
+    .use(remarkParse)
+    .use(remarkGfm) // GFM: ~~strikethrough~~, tables, autolinks, task lists
+    .use(remarkToSlate, { overrides });
+/**
+ * Convert a Markdown string to a Slate `SlateDescendant[]` array compatible
+ * with the DeXe investing-dashboard frontend.
+ *
+ * - Empty / whitespace-only input → default empty paragraph node
+ * - Plain text (no markdown syntax) → paragraph nodes split by newline
+ * - Rich markdown → full Slate tree with headings, lists, bold, etc.
+ *
+ * This function is synchronous (`processSync`).
+ */
+export function markdownToSlate(markdown) {
+    if (!markdown || markdown.trim().length === 0) {
+        return SLATE_DEFAULT;
+    }
+    try {
+        const result = processor.processSync(markdown);
+        const nodes = result.result;
+        if (!Array.isArray(nodes) || nodes.length === 0) {
+            return SLATE_DEFAULT;
+        }
+        // Flatten any arrays returned by mark overrides (strong/emphasis/delete
+        // return arrays of text nodes instead of a single element)
+        return flattenSlateNodes(nodes);
+    }
+    catch {
+        // Fallback: split by newlines into paragraphs (same as old behavior)
+        const lines = markdown.split("\n").filter((l) => l.length > 0);
+        return lines.length > 0
+            ? lines.map((line) => ({ type: "paragraph", children: [{ text: line }] }))
+            : SLATE_DEFAULT;
+    }
+}
+/**
+ * Recursively flatten any nested arrays that our mark overrides produce.
+ * Mark handlers (strong, emphasis, delete) return arrays of text nodes
+ * instead of elements, which can end up as nested arrays in children.
+ */
+function flattenSlateNodes(nodes) {
+    const result = [];
+    for (const node of nodes) {
+        if (Array.isArray(node)) {
+            result.push(...flattenSlateNodes(node));
+        }
+        else if (node && typeof node === "object") {
+            const n = node;
+            if (Array.isArray(n.children)) {
+                result.push({ ...n, children: flattenSlateNodes(n.children) });
+            }
+            else {
+                result.push(n);
+            }
+        }
+        else {
+            result.push(node);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=markdownToSlate.js.map

package/dist/lib/markdownToSlate.js.map

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

package/dist/lib/multicall.d.ts

@@ -0,0 +1,33 @@
+import { Interface, JsonRpcProvider } from "ethers";
+/**
+ * Multicall3 — deployed at the same address on ~every EVM chain.
+ * https://www.multicall3.com
+ */
+export declare const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
+export interface Call {
+    /** Target contract address. */
+    target: string;
+    /** ABI fragment or full Interface covering `method`. */
+    iface: Interface;
+    /** Method name or full signature. */
+    method: string;
+    /** Positional args (empty array if none). */
+    args: readonly unknown[];
+    /** If true, failures don't revert the whole batch (decoded as `null`). */
+    allowFailure?: boolean;
+}
+export interface CallResult<T = unknown> {
+    success: boolean;
+    value: T | null;
+    /** Hex-encoded raw return data. */
+    raw: string;
+    /** Error message if decoding failed or call reverted with allowFailure. */
+    error?: string;
+}
+/**
+ * Batch `calls` into a single Multicall3 aggregate3 RPC round-trip. Each call
+ * is decoded via its own `iface`. Failed calls with `allowFailure: true`
+ * yield `{ success: false, value: null }` instead of throwing.
+ */
+export declare function multicall(provider: JsonRpcProvider, calls: Call[]): Promise<CallResult[]>;
+//# sourceMappingURL=multicall.d.ts.map

package/dist/lib/multicall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multicall.d.ts","sourceRoot":"","sources":["../../src/lib/multicall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,SAAS,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,+CAA+C,CAAC;AAM/E,MAAM,WAAW,IAAI;IACnB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,EAAE,SAAS,CAAC;IACjB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAChB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,IAAI,EAAE,GACZ,OAAO,CAAC,UAAU,EAAE,CAAC,CAgCvB"}

package/dist/lib/multicall.js

@@ -0,0 +1,46 @@
+import { Contract } from "ethers";
+/**
+ * Multicall3 — deployed at the same address on ~every EVM chain.
+ * https://www.multicall3.com
+ */
+export const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
+const MULTICALL3_ABI = [
+    "function aggregate3((address target, bool allowFailure, bytes callData)[] calls) payable returns ((bool success, bytes returnData)[] returnData)",
+];
+/**
+ * Batch `calls` into a single Multicall3 aggregate3 RPC round-trip. Each call
+ * is decoded via its own `iface`. Failed calls with `allowFailure: true`
+ * yield `{ success: false, value: null }` instead of throwing.
+ */
+export async function multicall(provider, calls) {
+    if (calls.length === 0)
+        return [];
+    const mc = new Contract(MULTICALL3_ADDRESS, MULTICALL3_ABI, provider);
+    const payload = calls.map((c) => ({
+        target: c.target,
+        allowFailure: c.allowFailure ?? false,
+        callData: c.iface.encodeFunctionData(c.method, c.args),
+    }));
+    const results = await mc.getFunction("aggregate3").staticCall(payload);
+    return results.map((r, i) => {
+        const c = calls[i];
+        if (!r.success) {
+            return { success: false, value: null, raw: r.returnData, error: "call reverted" };
+        }
+        try {
+            const decoded = c.iface.decodeFunctionResult(c.method, r.returnData);
+            // Unwrap single-return-value tuples for ergonomic use.
+            const value = decoded.length === 1 ? decoded[0] : decoded;
+            return { success: true, value, raw: r.returnData };
+        }
+        catch (err) {
+            return {
+                success: false,
+                value: null,
+                raw: r.returnData,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    });
+}
+//# sourceMappingURL=multicall.js.map

package/dist/lib/multicall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multicall.js","sourceRoot":"","sources":["../../src/lib/multicall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA8B,MAAM,QAAQ,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,4CAA4C,CAAC;AAE/E,MAAM,cAAc,GAAG;IACrB,kJAAkJ;CAC1I,CAAC;AAwBX;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAyB,EACzB,KAAa;IAEb,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,kBAAkB,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;IAEtE,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,KAAK;QACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;KACvD,CAAC,CAAC,CAAC;IAEJ,MAAM,OAAO,GACX,MAAM,EAAE,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAEzD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QACpF,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;YACrE,uDAAuD;YACvD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI;gBACX,GAAG,EAAE,CAAC,CAAC,UAAU;gBACjB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/proposalCatalog.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Static catalog of every proposal type the DeXe frontend exposes. Derived
+ * from a full audit of `C:/dev/investing-dashboard` forms + hooks
+ * (2026-04-15). Consumed by `dexe_proposal_catalog` so agents can discover
+ * which builder tool to call for a given user intent.
+ *
+ * `mcpTool` is the name of the dedicated MCP builder tool (when one exists)
+ * or `null` if agents must compose via primitives (`build_external` +
+ * `build_custom_abi`) — flip `implemented` to `true` as each ships.
+ */
+export type ProposalCategory = "external" | "internal" | "offchain";
+export interface ProposalTypeEntry {
+    id: string;
+    category: ProposalCategory;
+    name: string;
+    formPath: string;
+    /** High-level description of the on-chain effect or off-chain action. */
+    effect: string;
+    /** Target contract (on-chain) or backend endpoint (off-chain). */
+    target: string;
+    /** Does this type require an IPFS metadata upload? */
+    needsIpfs: boolean;
+    /** Gating tags: "expert", "validator", "babt", "dao-admin". */
+    gating: string[];
+    /** Dedicated MCP builder tool name, or null. */
+    mcpTool: string | null;
+    /** Shipped? */
+    implemented: boolean;
+}
+export declare const PROPOSAL_CATALOG: ProposalTypeEntry[];
+/** Metadata JSON shape used by the frontend for every external proposal. */
+export declare const EXTERNAL_METADATA_SHAPE: {
+    readonly proposalName: "string (required)";
+    readonly proposalDescription: "string (required, markdown/slate)";
+    readonly category: "string (e.g. 'Token Transfer', 'Manage Validators')";
+    readonly isMeta: "boolean (default false)";
+    readonly changes: "object (type-specific structured payload for indexing, optional)";
+};
+export declare const INTERNAL_METADATA_SHAPE: {
+    readonly proposalName: "string (required)";
+    readonly proposalDescription: "string";
+    readonly category: "string (ValidatorBalances | ValidatorSettings | MonthlyWithdraw | Offchain)";
+    readonly changes: "object (type-specific)";
+};
+//# sourceMappingURL=proposalCatalog.d.ts.map

package/dist/lib/proposalCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposalCatalog.d.ts","sourceRoot":"","sources":["../../src/lib/proposalCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe;IACf,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,EAkZ/C,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB;;;;;;CAM1B,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;CAK1B,CAAC"}