dexe-mcp 0.11.0 → 0.14.0

package/dist/lib/proposalBuilders.js

@@ -0,0 +1,311 @@
+/**
+ * Server-side proposal action builders — the shared core behind the extended
+ * `dexe_proposal_create` (see `src/tools/flow.ts`). Each entry maps a short
+ * `proposalType` (e.g. `token_transfer`) to a zod param schema + a pure(ish)
+ * builder that returns the on-chain `actionsOnFor`, the frontend metadata
+ * `category`, and the `changes` payload the indexer expects.
+ *
+ * These builders MUST stay byte-parity with the equivalent
+ * `dexe_proposal_build_*` tools (verified in `tests/lib/proposalBuilders.test.ts`).
+ * Where a pure encoder already exists (token sale tiers, settings tuples) we
+ * import it directly so there is a single source of truth for the calldata.
+ *
+ * A builder throws on bad input; the caller (`runProposalCreate`) turns the
+ * throw into an actionable tool error. Builders never broadcast — they only
+ * shape actions + metadata for the flow to deposit/create/vote.
+ */
+import { z } from "zod";
+import { Interface, isAddress, ZeroAddress } from "ethers";
+import { checkBlacklist, blacklistError } from "./blacklist.js";
+import { findForbiddenSelector, dangerousSelectorError } from "./dangerousSelectors.js";
+import { ProposalSettingsSchema, toSettingsTuple, } from "../tools/proposalBuildMore.js";
+import { buildTokenSaleMultiActions, tierSchema, } from "../tools/proposalBuildComplex.js";
+// ---------- ABI fragments (identical strings to the build tools) ----------
+const ERC20_TRANSFER_ABI = new Interface([
+    "function transfer(address to, uint256 amount) returns (bool)",
+    "function approve(address spender, uint256 amount) returns (bool)",
+]);
+const ERC721_TRANSFER_ABI = new Interface([
+    "function transferFrom(address from, address to, uint256 tokenId)",
+]);
+const GOV_SETTINGS_ABI = new Interface([
+    "function editSettings(uint256[] ids, tuple(bool earlyCompletion, bool delegatedVotingAllowed, bool validatorsVote, uint64 duration, uint64 durationValidators, uint64 executionDelay, uint128 quorum, uint128 quorumValidators, uint256 minVotesForVoting, uint256 minVotesForCreating, tuple(address rewardToken, uint256 creationReward, uint256 executionReward, uint256 voteRewardsCoefficient) rewardsInfo, string executorDescription)[] params)",
+    "function addSettings(tuple(bool earlyCompletion, bool delegatedVotingAllowed, bool validatorsVote, uint64 duration, uint64 durationValidators, uint64 executionDelay, uint128 quorum, uint128 quorumValidators, uint256 minVotesForVoting, uint256 minVotesForCreating, tuple(address rewardToken, uint256 creationReward, uint256 executionReward, uint256 voteRewardsCoefficient) rewardsInfo, string executorDescription)[] settings)",
+]);
+const EXPERT_NFT_ABI = new Interface([
+    "function mint(address to, string uri)",
+    "function burn(address from)",
+]);
+const DISTRIBUTION_PROPOSAL_ABI = new Interface([
+    "function execute(uint256 proposalId, address token, uint256 amount)",
+]);
+function changes(proposedChanges) {
+    return { changes: { proposedChanges, currentChanges: {} } };
+}
+// ---------- builders ----------
+const tokenTransferBuilder = {
+    schema: z.object({
+        token: z.string().default("").describe("ERC20 token contract (ignored when isNative=true)"),
+        recipient: z.string().describe("Recipient address"),
+        amount: z.string().describe("Amount in wei / smallest unit"),
+        isNative: z.boolean().default(false).describe("True for native BNB/ETH transfer"),
+    }),
+    async build(raw, { ctx }) {
+        const p = raw;
+        if (!isAddress(p.recipient))
+            throw new Error(`Invalid recipient: ${p.recipient}`);
+        if (p.isNative) {
+            return {
+                actionsOnFor: [{ executor: p.recipient, value: p.amount, data: "0x" }],
+                category: "tokenTransfer",
+                metadataExtra: changes({ data: [{ tokenAmount: p.amount, receiverAddress: p.recipient }], tokenAddress: ZeroAddress }),
+                summary: `Native transfer → ${p.recipient} (${p.amount} wei)`,
+            };
+        }
+        if (!isAddress(p.token))
+            throw new Error(`Invalid token: ${p.token}`);
+        const bl = await checkBlacklist(ctx.config, p.token, p.recipient);
+        if (bl.status === "blacklisted")
+            throw new Error(blacklistError(p.token, p.recipient));
+        const data = ERC20_TRANSFER_ABI.encodeFunctionData("transfer", [p.recipient, BigInt(p.amount)]);
+        return {
+            actionsOnFor: [{ executor: p.token, value: "0", data }],
+            category: "tokenTransfer",
+            metadataExtra: changes({ data: [{ tokenAmount: p.amount, receiverAddress: p.recipient }], tokenAddress: p.token }),
+            summary: `ERC20(${p.token}).transfer(${p.recipient}, ${p.amount})`,
+        };
+    },
+};
+const withdrawTreasuryBuilder = {
+    schema: z.object({
+        receiver: z.string().describe("Treasury withdrawal recipient"),
+        token: z.string().default("").describe("ERC20 token contract (omit for NFT-only)"),
+        amount: z.string().default("0").describe("ERC20 amount in wei (omit/0 for NFT-only)"),
+        nftAddress: z.string().default("").describe("ERC721 contract (omit for token-only)"),
+        nftIds: z.array(z.string()).default([]).describe("NFT ids; one transferFrom per id"),
+    }),
+    async build(raw, { ctx, govPool }) {
+        const p = raw;
+        if (!isAddress(p.receiver))
+            throw new Error(`Invalid receiver: ${p.receiver}`);
+        const wantToken = p.token.length > 0 && BigInt(p.amount) > 0n;
+        const wantNfts = p.nftAddress.length > 0 && p.nftIds.length > 0;
+        if (!wantToken && !wantNfts) {
+            throw new Error("Nothing to withdraw — supply `token` + non-zero `amount`, and/or `nftAddress` + `nftIds`.");
+        }
+        if (wantToken && !isAddress(p.token))
+            throw new Error(`Invalid token: ${p.token}`);
+        if (wantNfts && !isAddress(p.nftAddress))
+            throw new Error(`Invalid nftAddress: ${p.nftAddress}`);
+        // withdraw_treasury MUST emit external token.transfer, NEVER GovPool.withdraw
+        // (failure mode 8 — "Gov: invalid internal data"). Treasury sits on GovPool
+        // as a plain holding, so each withdrawal is an external ERC20/721 call.
+        const actionsOnFor = [];
+        if (wantToken) {
+            const bl = await checkBlacklist(ctx.config, p.token, p.receiver);
+            if (bl.status === "blacklisted")
+                throw new Error(blacklistError(p.token, p.receiver));
+            actionsOnFor.push({
+                executor: p.token,
+                value: "0",
+                data: ERC20_TRANSFER_ABI.encodeFunctionData("transfer", [p.receiver, BigInt(p.amount)]),
+            });
+        }
+        if (wantNfts) {
+            for (const id of p.nftIds) {
+                actionsOnFor.push({
+                    executor: p.nftAddress,
+                    value: "0",
+                    data: ERC721_TRANSFER_ABI.encodeFunctionData("transferFrom", [govPool, p.receiver, BigInt(id)]),
+                });
+            }
+        }
+        return {
+            actionsOnFor,
+            category: "withdrawDeposit",
+            metadataExtra: changes({ receiver: p.receiver, token: p.token, amount: p.amount, nftAddress: p.nftAddress, nftIds: p.nftIds }),
+            summary: `Withdraw treasury → ${p.receiver} (${actionsOnFor.length} action${actionsOnFor.length === 1 ? "" : "s"})`,
+        };
+    },
+};
+const changeVotingSettingsBuilder = {
+    schema: z.object({
+        govSettings: z.string().describe("GovSettings address (dexe_dao_info.helpers.settings)"),
+        settings: z.array(ProposalSettingsSchema).min(1),
+        settingsIds: z.array(z.string()).default([]).describe("Ids to edit (parallel to settings). Empty => addSettings"),
+    }),
+    async build(raw) {
+        const p = raw;
+        if (!isAddress(p.govSettings))
+            throw new Error(`Invalid govSettings: ${p.govSettings}`);
+        if (p.settingsIds.length > 0 && p.settingsIds.length !== p.settings.length) {
+            throw new Error("settingsIds length must match settings length when editing");
+        }
+        const tuples = p.settings.map(toSettingsTuple);
+        const method = p.settingsIds.length > 0 ? "editSettings" : "addSettings";
+        const data = method === "editSettings"
+            ? GOV_SETTINGS_ABI.encodeFunctionData(method, [p.settingsIds.map((n) => BigInt(n)), tuples])
+            : GOV_SETTINGS_ABI.encodeFunctionData(method, [tuples]);
+        return {
+            actionsOnFor: [{ executor: p.govSettings, value: "0", data }],
+            category: "changeSettings",
+            metadataExtra: changes({ mode: method, settingsIds: p.settingsIds, settings: p.settings }),
+            summary: `Change voting settings (${method}, ${p.settings.length} entries)`,
+        };
+    },
+};
+const addExpertBuilder = {
+    schema: z.object({
+        expertNftContract: z.string().describe("ExpertNft address (local: govPool.getNftContracts().expertNft; global: dexeExpertNft)"),
+        scope: z.enum(["local", "global"]),
+        nominatedUser: z.string(),
+        uri: z.string().default(""),
+    }),
+    async build(raw) {
+        const p = raw;
+        if (!isAddress(p.expertNftContract))
+            throw new Error(`Invalid expertNftContract: ${p.expertNftContract}`);
+        if (!isAddress(p.nominatedUser))
+            throw new Error(`Invalid nominatedUser: ${p.nominatedUser}`);
+        const data = EXPERT_NFT_ABI.encodeFunctionData("mint", [p.nominatedUser, p.uri]);
+        return {
+            actionsOnFor: [{ executor: p.expertNftContract, value: "0", data }],
+            category: p.scope === "global" ? "globalExpert" : "localExpert",
+            metadataExtra: changes({ scope: p.scope, nominatedUser: p.nominatedUser, expertNftContract: p.expertNftContract, uri: p.uri }),
+            summary: `Add ${p.scope} expert → ${p.nominatedUser}`,
+        };
+    },
+};
+const removeExpertBuilder = {
+    schema: z.object({
+        expertNftContract: z.string(),
+        scope: z.enum(["local", "global"]),
+        nominatedUser: z.string(),
+    }),
+    async build(raw) {
+        const p = raw;
+        if (!isAddress(p.expertNftContract))
+            throw new Error(`Invalid expertNftContract: ${p.expertNftContract}`);
+        if (!isAddress(p.nominatedUser))
+            throw new Error(`Invalid nominatedUser: ${p.nominatedUser}`);
+        const data = EXPERT_NFT_ABI.encodeFunctionData("burn", [p.nominatedUser]);
+        return {
+            actionsOnFor: [{ executor: p.expertNftContract, value: "0", data }],
+            category: p.scope === "global" ? "globalExpertRemoval" : "localExpertRemoval",
+            metadataExtra: changes({ scope: p.scope, nominatedUser: p.nominatedUser, expertNftContract: p.expertNftContract }),
+            summary: `Remove ${p.scope} expert → ${p.nominatedUser}`,
+        };
+    },
+};
+const tokenDistributionBuilder = {
+    schema: z.object({
+        distributionProposal: z.string().describe("DistributionProposal address"),
+        proposalId: z.string().describe("Expected proposalId (usually latestProposalId + 1)"),
+        token: z.string(),
+        amount: z.string(),
+        isNative: z.boolean().default(false).describe("True for native token — sends value instead of approve"),
+    }),
+    async build(raw) {
+        const p = raw;
+        if (!isAddress(p.distributionProposal))
+            throw new Error(`Invalid distributionProposal: ${p.distributionProposal}`);
+        if (!isAddress(p.token))
+            throw new Error(`Invalid token: ${p.token}`);
+        const executeData = DISTRIBUTION_PROPOSAL_ABI.encodeFunctionData("execute", [BigInt(p.proposalId), p.token, BigInt(p.amount)]);
+        const actionsOnFor = [];
+        if (p.isNative) {
+            actionsOnFor.push({ executor: p.distributionProposal, value: p.amount, data: executeData });
+        }
+        else {
+            const approveData = ERC20_TRANSFER_ABI.encodeFunctionData("approve", [p.distributionProposal, BigInt(p.amount)]);
+            actionsOnFor.push({ executor: p.token, value: "0", data: approveData });
+            actionsOnFor.push({ executor: p.distributionProposal, value: "0", data: executeData });
+        }
+        return {
+            actionsOnFor,
+            category: "tokenDistribution",
+            metadataExtra: changes({ tokenAddress: p.token, tokenAmount: p.amount, proposalId: p.proposalId }),
+            summary: `Token distribution → ${p.amount} of ${p.token} via proposal #${p.proposalId}`,
+        };
+    },
+};
+const tokenSaleBuilder = {
+    schema: z.object({
+        tokenSaleProposal: z.string().describe("TokenSaleProposal contract address"),
+        tiers: z.array(tierSchema).min(1),
+        latestTierId: z.string().default("0").describe("Current latestTierId() — bump when extending an existing sale"),
+    }),
+    async build(raw) {
+        const p = raw;
+        // Reuse the canonical multi-tier encoder (single source of truth, also used
+        // by the OTC composites). Guarantees calldata parity with the build tool.
+        const built = buildTokenSaleMultiActions({
+            tokenSaleProposal: p.tokenSaleProposal,
+            tiers: p.tiers,
+            latestTierId: p.latestTierId,
+        });
+        const meta = built.metadata;
+        return {
+            actionsOnFor: built.actions,
+            category: "tokenSale",
+            metadataExtra: meta.changes ? { changes: meta.changes } : {},
+            summary: `Token sale tiers → ${built.tierNames}`,
+        };
+    },
+};
+const customAbiBuilder = {
+    schema: z.object({
+        target: z.string().describe("Target contract the DAO will call"),
+        signature: z.string().describe("Full function signature, e.g. 'function setX(uint256)'"),
+        method: z.string().describe("Method name matching the signature"),
+        args: z.array(z.unknown()).default([]),
+        value: z.string().default("0"),
+    }),
+    async build(raw) {
+        const p = raw;
+        if (!isAddress(p.target))
+            throw new Error(`Invalid target: ${p.target}`);
+        const iface = new Interface([p.signature]);
+        const coerced = p.args.map((a) => {
+            if (typeof a === "string" && /^-?\d+$/.test(a) && a.length > 9) {
+                try {
+                    return BigInt(a);
+                }
+                catch {
+                    return a;
+                }
+            }
+            return a;
+        });
+        const data = iface.encodeFunctionData(p.method, coerced);
+        const forbidden = findForbiddenSelector(data);
+        if (forbidden)
+            throw new Error(dangerousSelectorError(forbidden, p.target));
+        return {
+            actionsOnFor: [{ executor: p.target, value: p.value, data }],
+            metadataExtra: {},
+            summary: `${p.target}.${p.method}(${p.args.length} args)`,
+        };
+    },
+};
+/**
+ * Registry keyed by the short `proposalType` accepted by `dexe_proposal_create`.
+ * Extend this to wire another catalog type into the composite.
+ */
+export const PROPOSAL_BUILDERS = {
+    token_transfer: tokenTransferBuilder,
+    withdraw_treasury: withdrawTreasuryBuilder,
+    change_voting_settings: changeVotingSettingsBuilder,
+    add_expert: addExpertBuilder,
+    remove_expert: removeExpertBuilder,
+    token_distribution: tokenDistributionBuilder,
+    token_sale: tokenSaleBuilder,
+    custom_abi: customAbiBuilder,
+};
+/** proposalType values `dexe_proposal_create` accepts directly. */
+export const FLOW_PROPOSAL_TYPES = [
+    "modify_dao_profile",
+    "custom",
+    ...Object.keys(PROPOSAL_BUILDERS),
+];
+//# sourceMappingURL=proposalBuilders.js.map

package/dist/lib/proposalBuilders.js.map

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

package/dist/lib/stateStore.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Persistent operational state (Phase 3 / v0.14.0). The MCP server otherwise
+ * remembers nothing between sessions — every session re-derives which DAOs
+ * exist, which chain was last used, etc. This is a tiny JSON store that records
+ * DAOs deployed via `dexe_dao_create` and proposals broadcast via
+ * `dexe_proposal_create`, so `dexe_context` can surface them next session.
+ *
+ * Design: single-process, load-once-cache, atomic write (temp + rename).
+ * Tolerant — a missing/corrupt/newer file never throws into a tool; it degrades
+ * to empty state so a disk hiccup can't brick a broadcast.
+ */
+export declare const STATE_VERSION = 1;
+export interface KnownDao {
+    name: string;
+    govPool: string;
+    chainId: number;
+    userKeeper?: string;
+    token?: string;
+    txHash?: string;
+    /** ISO-8601 timestamp of when it was recorded. */
+    deployedAt: string;
+}
+export interface RecentProposal {
+    govPool: string;
+    chainId: number;
+    title?: string;
+    descriptionURL?: string;
+    txHash?: string;
+    createdAt: string;
+}
+export interface PersistedState {
+    version: number;
+    knownDaos: KnownDao[];
+    lastChainId?: number;
+    recentProposals: RecentProposal[];
+    /** address (lowercased) → human label. */
+    walletLabels: Record<string, string>;
+}
+/** Resolve the state file path: DEXE_STATE_PATH override, else ~/.dexe-mcp/state.json. */
+export declare function resolveStatePath(override?: string): string;
+export declare class StateStore {
+    private readonly path;
+    private cache;
+    constructor(path: string);
+    /** Load (and cache) the state. Never throws — degrades to empty on any error. */
+    load(): PersistedState;
+    private readFromDisk;
+    /** Atomic write: temp file + rename. Best-effort — logs and swallows errors. */
+    private persist;
+    getState(): PersistedState;
+    /**
+     * Record a deployed DAO. De-dupes by (govPool, chainId): a repeat deploy of
+     * the same address updates the existing entry and moves it to the front.
+     */
+    recordDao(dao: KnownDao): void;
+    /** Record a broadcast proposal (most-recent first, capped). */
+    recordProposal(p: RecentProposal): void;
+    setLastChainId(chainId: number): void;
+    setWalletLabel(address: string, label: string): void;
+    /** Most-recently recorded DAO, or null. */
+    lastDao(): KnownDao | null;
+}
+//# sourceMappingURL=stateStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stateStore.d.ts","sourceRoot":"","sources":["../../src/lib/stateStore.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AASD,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,KAAK,CAA+B;gBAEf,IAAI,EAAE,MAAM;IAEzC,iFAAiF;IACjF,IAAI,IAAI,cAAc;IAMtB,OAAO,CAAC,YAAY;IA+BpB,gFAAgF;IAChF,OAAO,CAAC,OAAO;IAef,QAAQ,IAAI,cAAc;IAI1B;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAc9B,+DAA+D;IAC/D,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI;IAUvC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKrC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQpD,2CAA2C;IAC3C,OAAO,IAAI,QAAQ,GAAG,IAAI;CAG3B"}

package/dist/lib/stateStore.js

@@ -0,0 +1,128 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+/**
+ * Persistent operational state (Phase 3 / v0.14.0). The MCP server otherwise
+ * remembers nothing between sessions — every session re-derives which DAOs
+ * exist, which chain was last used, etc. This is a tiny JSON store that records
+ * DAOs deployed via `dexe_dao_create` and proposals broadcast via
+ * `dexe_proposal_create`, so `dexe_context` can surface them next session.
+ *
+ * Design: single-process, load-once-cache, atomic write (temp + rename).
+ * Tolerant — a missing/corrupt/newer file never throws into a tool; it degrades
+ * to empty state so a disk hiccup can't brick a broadcast.
+ */
+export const STATE_VERSION = 1;
+const MAX_DAOS = 50;
+const MAX_PROPOSALS = 25;
+function emptyState() {
+    return { version: STATE_VERSION, knownDaos: [], recentProposals: [], walletLabels: {} };
+}
+/** Resolve the state file path: DEXE_STATE_PATH override, else ~/.dexe-mcp/state.json. */
+export function resolveStatePath(override) {
+    const raw = (override ?? process.env.DEXE_STATE_PATH)?.trim();
+    if (raw)
+        return raw;
+    return join(homedir(), ".dexe-mcp", "state.json");
+}
+export class StateStore {
+    path;
+    cache = null;
+    constructor(path) {
+        this.path = path;
+    }
+    /** Load (and cache) the state. Never throws — degrades to empty on any error. */
+    load() {
+        if (this.cache)
+            return this.cache;
+        this.cache = this.readFromDisk();
+        return this.cache;
+    }
+    readFromDisk() {
+        try {
+            if (!existsSync(this.path))
+                return emptyState();
+            const raw = readFileSync(this.path, "utf8");
+            const parsed = JSON.parse(raw);
+            if (!parsed || typeof parsed !== "object" || parsed.version !== STATE_VERSION) {
+                // Unknown/older schema — start fresh rather than risk misreads. (A real
+                // migration ladder can slot in here when STATE_VERSION bumps.)
+                if (parsed && parsed.version !== undefined && parsed.version !== STATE_VERSION) {
+                    process.stderr.write(`[dexe-mcp] state.json version ${parsed.version} != ${STATE_VERSION}; starting fresh.\n`);
+                }
+                return emptyState();
+            }
+            return {
+                version: STATE_VERSION,
+                knownDaos: Array.isArray(parsed.knownDaos) ? parsed.knownDaos : [],
+                lastChainId: typeof parsed.lastChainId === "number" ? parsed.lastChainId : undefined,
+                recentProposals: Array.isArray(parsed.recentProposals) ? parsed.recentProposals : [],
+                walletLabels: parsed.walletLabels && typeof parsed.walletLabels === "object" ? parsed.walletLabels : {},
+            };
+        }
+        catch (err) {
+            process.stderr.write(`[dexe-mcp] could not read state at ${this.path} (${err instanceof Error ? err.message : String(err)}); using empty state.\n`);
+            return emptyState();
+        }
+    }
+    /** Atomic write: temp file + rename. Best-effort — logs and swallows errors. */
+    persist(state) {
+        this.cache = state;
+        try {
+            const dir = dirname(this.path);
+            if (!existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+            const tmp = `${this.path}.tmp`;
+            writeFileSync(tmp, JSON.stringify(state, null, 2), "utf8");
+            renameSync(tmp, this.path);
+        }
+        catch (err) {
+            process.stderr.write(`[dexe-mcp] could not persist state to ${this.path} (${err instanceof Error ? err.message : String(err)}).\n`);
+        }
+    }
+    getState() {
+        return this.load();
+    }
+    /**
+     * Record a deployed DAO. De-dupes by (govPool, chainId): a repeat deploy of
+     * the same address updates the existing entry and moves it to the front.
+     */
+    recordDao(dao) {
+        const state = this.load();
+        const key = (d) => `${d.chainId}:${d.govPool.toLowerCase()}`;
+        const k = key(dao);
+        const rest = state.knownDaos.filter((d) => key(d) !== k);
+        const next = {
+            ...state,
+            knownDaos: [dao, ...rest].slice(0, MAX_DAOS),
+            lastChainId: dao.chainId,
+        };
+        this.persist(next);
+    }
+    /** Record a broadcast proposal (most-recent first, capped). */
+    recordProposal(p) {
+        const state = this.load();
+        const next = {
+            ...state,
+            recentProposals: [p, ...state.recentProposals].slice(0, MAX_PROPOSALS),
+            lastChainId: p.chainId,
+        };
+        this.persist(next);
+    }
+    setLastChainId(chainId) {
+        const state = this.load();
+        this.persist({ ...state, lastChainId: chainId });
+    }
+    setWalletLabel(address, label) {
+        const state = this.load();
+        this.persist({
+            ...state,
+            walletLabels: { ...state.walletLabels, [address.toLowerCase()]: label },
+        });
+    }
+    /** Most-recently recorded DAO, or null. */
+    lastDao() {
+        return this.load().knownDaos[0] ?? null;
+    }
+}
+//# sourceMappingURL=stateStore.js.map

package/dist/lib/stateStore.js.map

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

package/dist/lib/time.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Time formatting helpers for on-chain timestamps.
+ *
+ * Contracts store times as Unix seconds (UTC-based, timezone-agnostic). Raw
+ * seconds are unreadable to humans, so read tools should surface a companion
+ * UTC string alongside the raw value to avoid any local-timezone confusion.
+ */
+/**
+ * Format a Unix timestamp (seconds) as an unambiguous UTC string.
+ *
+ * @example unixToUtc(1783100759) // "2026-07-03 17:45:59 UTC"
+ * @returns "" for zero/invalid input — `0` is the contract's "unset" sentinel
+ *          (e.g. no vesting), and an empty string reads better than "1970-...".
+ */
+export declare function unixToUtc(sec: bigint | number | string): string;
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/lib/time.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAO/D"}

package/dist/lib/time.js

@@ -0,0 +1,24 @@
+/**
+ * Time formatting helpers for on-chain timestamps.
+ *
+ * Contracts store times as Unix seconds (UTC-based, timezone-agnostic). Raw
+ * seconds are unreadable to humans, so read tools should surface a companion
+ * UTC string alongside the raw value to avoid any local-timezone confusion.
+ */
+/**
+ * Format a Unix timestamp (seconds) as an unambiguous UTC string.
+ *
+ * @example unixToUtc(1783100759) // "2026-07-03 17:45:59 UTC"
+ * @returns "" for zero/invalid input — `0` is the contract's "unset" sentinel
+ *          (e.g. no vesting), and an empty string reads better than "1970-...".
+ */
+export function unixToUtc(sec) {
+    const n = Number(sec);
+    if (!Number.isFinite(n) || n <= 0)
+        return "";
+    return new Date(n * 1000)
+        .toISOString()
+        .replace("T", " ")
+        .replace(/\.\d{3}Z$/, " UTC");
+}
+//# sourceMappingURL=time.js.map

package/dist/lib/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/lib/time.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAA6B;IACrD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;SACtB,WAAW,EAAE;SACb,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;SACjB,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/daoCreate.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "./context.js";
+import { SignerManager } from "../lib/signer.js";
+import type { StateStore } from "../lib/stateStore.js";
+export declare function registerDaoCreateTools(server: McpServer, ctx: ToolContext, signer: SignerManager, state?: StateStore): void;
+//# sourceMappingURL=daoCreate.d.ts.map

package/dist/tools/daoCreate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daoCreate.d.ts","sourceRoot":"","sources":["../../src/tools/daoCreate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAgCvD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,aAAa,EACrB,KAAK,CAAC,EAAE,UAAU,GACjB,IAAI,CAiJN"}