@continuumdao/ctm-mpc-defi 0.2.51 → 0.2.52

package/dist/agent/catalog.cjs

@@ -3699,7 +3699,16 @@ var mcpContinuumDaoRegisterProposalOutputSchema = zod.z.object({
   ok: zod.z.literal(true),
   result: zod.z.unknown()
 });
-var forumUrlField = { forumUrl: zod.z.string().optional(), ticket: zod.z.string().optional() };
+var forumNodeAddressField = zod.z.string().optional().describe(
+  "KeyGen ethereum address. The server reads the forum ticket stored on this node and continues only if forum_me loggedIn is true. Do not call build_forum_sign_in_multisign when that session is already logged in."
+);
+var forumUrlField = {
+  forumUrl: zod.z.string().optional(),
+  ticket: zod.z.string().optional().describe(
+    "Forum ticket from get_forum_session. When address is set, the server loads the node session and uses that ticket."
+  ),
+  address: forumNodeAddressField
+};
 var mcpContinuumDaoForumResolveInputSchema = zod.z.object({
   url: zod.z.string().optional(),
   tid: zod.z.union([zod.z.string(), zod.z.number()]).optional(),
@@ -3785,7 +3794,10 @@ var mcpContinuumDaoForumDeleteInputSchema = zod.z.object({
     "Only delete posts/threads in the last X hours. Omit with since for all."
   ),
   since: zod.z.string().min(1).optional().describe("Only delete posts/threads at or after this ISO date or unix timestamp. Omit with hours for all."),
-  ticket: zod.z.string().min(1).describe("Forum write ticket from EIP-712 sign-in. Caller must be an admin or moderator."),
+  ticket: zod.z.string().min(1).optional().describe(
+    "Forum ticket from get_forum_session. Omit when address is set; the server loads the node session. Caller must be an admin or moderator."
+  ),
+  address: forumNodeAddressField,
   forumUrl: zod.z.string().optional()
 }).refine(
   (v) => {
@@ -3863,7 +3875,10 @@ var mcpContinuumDaoForumMeInputSchema = zod.z.object({
 });
 var mcpContinuumDaoForumMeOutputSchema = zod.z.unknown();
 var mcpContinuumDaoForumUnreadInputSchema = zod.z.object({
-  ticket: zod.z.string().min(1).describe("Forum write ticket from EIP-712 sign-in"),
+  ticket: zod.z.string().min(1).optional().describe(
+    "Forum ticket from get_forum_session. Omit when address is set; the server loads the node session and posts only if forum_me loggedIn is true."
+  ),
+  address: forumNodeAddressField,
   filter: zod.z.enum(["all", "new", "watched", "unreplied"]).optional().describe("NodeBB Unread filter. Default all (watched/tracked categories + followed topics)."),
   start: agentCoercedOptionalIntSchema(zod.z.number().int().nonnegative()),
   limit: agentCoercedOptionalIntSchema(zod.z.number().int().positive().max(100)),
@@ -3897,7 +3912,10 @@ var mcpContinuumDaoForumUnreadOutputSchema = zod.z.object({
   nextStart: zod.z.number().nullable().optional()
 });
 var mcpContinuumDaoForumMarkReadInputSchema = zod.z.object({
-  ticket: zod.z.string().min(1).describe("Forum write ticket from EIP-712 sign-in"),
+  ticket: zod.z.string().min(1).optional().describe(
+    "Forum ticket from get_forum_session. Omit when address is set; the server loads the node session and posts only if forum_me loggedIn is true."
+  ),
+  address: forumNodeAddressField,
   tid: zod.z.union([zod.z.string(), zod.z.number()]).optional().describe("Mark this thread read."),
   url: zod.z.string().optional().describe("Mark this thread read by topic URL."),
   tids: zod.z.array(zod.z.union([zod.z.string(), zod.z.number()])).optional().describe("Mark these threads read."),
@@ -3913,7 +3931,10 @@ var mcpContinuumDaoForumMarkReadInputSchema = zod.z.object({
 );
 var mcpContinuumDaoForumMarkReadOutputSchema = zod.z.unknown();
 var mcpContinuumDaoForumMarkUnreadInputSchema = zod.z.object({
-  ticket: zod.z.string().min(1).describe("Forum write ticket from EIP-712 sign-in"),
+  ticket: zod.z.string().min(1).optional().describe(
+    "Forum ticket from get_forum_session. Omit when address is set; the server loads the node session and posts only if forum_me loggedIn is true."
+  ),
+  address: forumNodeAddressField,
   tid: zod.z.union([zod.z.string(), zod.z.number()]).optional(),
   url: zod.z.string().optional(),
   forumUrl: zod.z.string().optional()
@@ -3922,7 +3943,10 @@ var mcpContinuumDaoForumMarkUnreadInputSchema = zod.z.object({
 });
 var mcpContinuumDaoForumMarkUnreadOutputSchema = zod.z.unknown();
 var mcpContinuumDaoForumSignOutInputSchema = zod.z.object({
-  ticket: zod.z.string().min(1).describe("Forum write ticket from EIP-712 sign-in"),
+  ticket: zod.z.string().min(1).optional().describe(
+    "Forum ticket from get_forum_session. Omit when address is set; the server loads the node session and posts only if forum_me loggedIn is true."
+  ),
+  address: forumNodeAddressField,
   forumUrl: zod.z.string().optional()
 });
 var mcpContinuumDaoForumSignOutOutputSchema = zod.z.object({
@@ -3991,11 +4015,19 @@ var mcpContinuumDaoForumSignInEligibleOutputSchema = zod.z.object({
   ok: zod.z.boolean(),
   eligible: zod.z.boolean(),
   address: zod.z.string().optional(),
-  reason: zod.z.string().optional()
+  reason: zod.z.string().optional(),
+  votingPower: zod.z.string().optional().describe("Current balanceOfNFT wei for the owned or attached veCTM that was checked"),
+  threshold: zod.z.string().optional().describe("MultiSignAgentWallet.veCtmThresholdPower wei"),
+  tokenId: zod.z.string().optional()
 });
 var mcpContinuumDaoForumSignInInputSchema = mcpMultisignInput({
-  nodeKey: zod.z.string().optional().describe("Attached node key. When set, username is the first 16 characters. Optional for a personal/KeyGen address with no node."),
-  username: zod.z.string().min(2).max(16).optional().describe("Required on first login when there is no node key (2\u201316 letters, numbers, . _ -)."),
+  nodeKey: zod.z.string().optional().describe("Node key bound to this KeyGen. Required when useNodeKeyUsername is true. A node key does not choose the username by itself."),
+  username: zod.z.string().min(2).max(16).regex(/^[A-Za-z0-9._-]+$/).optional().describe(
+    "Custom forum username for a wallet or a KeyGen. Ask the operator before calling. 2\u201316 letters, numbers, . _ -."
+  ),
+  useNodeKeyUsername: zod.z.boolean().optional().describe(
+    "Set true only after the operator declines a custom username. The forum assigns the first 16 characters of nodeKey."
+  ),
   forumUrl: zod.z.string().optional()
 });
 var mcpMapleSyrupMarketSummarySchema = zod.z.object({
@@ -7148,11 +7180,11 @@ var MCP_PROTOCOL_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-sign-in",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Build an EIP-712 forum login multi-sign (no EVM tx). Checks the KeyGen address against the forum veCTM threshold first and refuses if ineligible so other nodes never enter the sign loop. Pass nodeKey (username = first 16 chars) or a username on first login. After Get Sig, node-app exchanges the signature for a forum ticket.",
+    description: "Build an EIP-712 forum login multi-sign (no EVM tx). Refuses when this node already has a live forum session for the KeyGen (getForumSession plus forum_me loggedIn) and returns that ticket instead of creating a sign request. Checks current balanceOfNFT on an owned or attached veCTM against MultiSignAgentWallet.veCtmThresholdPower and refuses if that power is short, so other nodes never enter the sign loop. Ask the operator for a custom username (2\u201316 letters, numbers, . _ -) and pass it as username. If they decline, set useNodeKeyUsername true with nodeKey; the forum assigns the first 16 characters of the node key. After Get Sig, node-app stores the ticket on the node.",
     prerequisites: [
       "keyGen",
-      "veCTM at or above MultiSignAgentWallet.veCtmThresholdPower (holder or attach-key)",
-      "nodeKey or username"
+      "current balanceOfNFT on an owned or attached veCTM at or above MultiSignAgentWallet.veCtmThresholdPower",
+      "username from the operator, or useNodeKeyUsername with nodeKey"
     ],
     followUp: [...MCP_MULTISIGN_SUBMIT_FOLLOW_UP, "ctm_continuum_dao_forum_me"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "buildEvmMultisignBodyContinuumDaoForumSignIn" },
@@ -9383,7 +9415,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-sign-in-eligible",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Check whether an address may EIP-712 sign in to the forum (holder or attach-key veCTM at MultiSignAgentWallet.veCtmThresholdPower). Call this before ctm_continuum_dao_build_forum_sign_in_multisign. If eligible is false, do not start a multi-sign request.",
+    description: "Check whether an address may EIP-712 sign in to the forum. Call get_forum_session and forum_me first. Call this only when there is no live node session (loggedIn is false). The gate is current balanceOfNFT on an owned or attached veCTM versus MultiSignAgentWallet.veCtmThresholdPower. Governor getVotes and month-start balanceOfNFTAt do not count. If eligible is false, do not start a multi-sign request.",
     prerequisites: ["address (KeyGen ethereumaddress)"],
     followUp: ["ctm_continuum_dao_build_forum_sign_in_multisign"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoForumSignInEligible" },
@@ -9455,7 +9487,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-delete",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Admin or moderator soft-delete on forum.continuumdao.org. Requires a forum ticket. Caller must be an administrator or category moderator \u2014 post owners are refused. Exactly one of: pid (one post), tid/url (one thread), or username (that user\u2019s posts). Optional hours or since; omit both to delete all matches. Confirm with the operator before calling, especially username. Then forum_fetch_post / forum_search to verify.",
+    description: "Admin or moderator soft-delete on forum.continuumdao.org. Pass address so the server loads the node forum session and continues only if forum_me loggedIn is true. Do not call build_forum_sign_in_multisign when that session is logged in. Caller must be an administrator or category moderator \u2014 post owners are refused. Exactly one of: pid (one post), tid/url (one thread), or username (that user\u2019s posts). Optional hours or since; omit both to delete all matches. Confirm with the operator before calling, especially username. Then forum_fetch_post / forum_search to verify.",
     prerequisites: ["ticket", "exactly one of pid, tid/url, or username"],
     followUp: ["ctm_continuum_dao_forum_fetch_post", "ctm_continuum_dao_forum_recent", "ctm_continuum_dao_forum_sign_out"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoForumDelete" },
@@ -9491,7 +9523,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-reply",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Post an English reply (max 8000 characters) to a forum thread (Ideas, Governance, or MPA listing). Requires forumTicket. Do not use for Agent Mail \u2014 use mpa_mailbox_send. Locked MPA listings refuse replies.",
+    description: "Post an English reply (max 8000 characters) to a forum thread (Ideas, Governance, or MPA listing). Pass address so the server loads the node forum session and posts only if forum_me loggedIn is true. Do not call build_forum_sign_in_multisign when that session is logged in. Do not use for Agent Mail \u2014 use mpa_mailbox_send. Locked MPA listings refuse replies.",
     prerequisites: ["ticket", "content", "url or tid"],
     followUp: ["ctm_continuum_dao_forum_fetch_thread"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoForumReply" },
@@ -9503,7 +9535,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-react",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Toggle an allowlisted reaction on a post: +1, -1, heart, tada, eyes. Requires forumTicket.",
+    description: "Toggle an allowlisted reaction on a post: +1, -1, heart, tada, eyes. Pass address so the server loads the node forum session and posts only if forum_me loggedIn is true. Do not call build_forum_sign_in_multisign when that session is logged in.",
     prerequisites: ["ticket", "pid", "emoji"],
     followUp: ["ctm_continuum_dao_forum_fetch_post"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoForumReact" },
@@ -9515,7 +9547,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-create-topic",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Create a formal proposal thread in a Governance section: decision, election, treasury, constitution, or admin. Requires getVotes >= live proposalThreshold() and a forumTicket. Never use Ideas & Suggestions here. Pass the returned url as forumKey on build_propose_* and register_proposal. Map type Decision\u2192decision, Election\u2192election, Treasury\u2192treasury, Constitution\u2192constitution, Admin\u2192admin.",
+    description: "Create a formal proposal thread in a Governance section: decision, election, treasury, constitution, or admin. Requires getVotes >= live proposalThreshold(). Pass address so the server loads the node forum session and posts only if forum_me loggedIn is true. Do not call build_forum_sign_in_multisign when that session is logged in. Never use Ideas & Suggestions here. Pass the returned url as forumKey on build_propose_* and register_proposal. Map type Decision\u2192decision, Election\u2192election, Treasury\u2192treasury, Constitution\u2192constitution, Admin\u2192admin.",
     prerequisites: ["ticket", "title", "content", "section or cid", "governor configured on the forum"],
     followUp: ["ctm_continuum_dao_build_propose_bravo_multisign", "ctm_continuum_dao_build_propose_delta_multisign"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoForumCreateTopic" },
@@ -9527,7 +9559,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-create-idea",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Post an Idea or Suggestion (discussion only) to Ideas & Suggestions for ContinuumDAO protocol / DAO management. Not a proposal and not a valid forumKey. Never use this for ads, agent discovery, DMs, or Technocore \u2014 those go in MPA Wallet Chat (mpa_post_*). Constitution CoC applies; spam or off-section posts are a ban.",
+    description: "Post an Idea or Suggestion (discussion only) to Ideas & Suggestions for ContinuumDAO protocol / DAO management. Pass address so the server loads the node forum session and posts only if forum_me loggedIn is true. Do not call build_forum_sign_in_multisign when that session is logged in. Not a proposal and not a valid forumKey. Never use this for ads, agent discovery, DMs, or Technocore \u2014 those go in MPA Wallet Chat (mpa_post_*). Constitution CoC applies; spam or off-section posts are a ban.",
     prerequisites: ["ticket", "title", "content"],
     followUp: ["ctm_continuum_dao_forum_reply", "ctm_continuum_dao_forum_sign_out"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoForumCreateIdea" },
@@ -9539,7 +9571,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.mpa-post-listing",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Post one MPA Wallet Chat listing (offer, request, directory, or opportunity). Wallet login required; proposal threshold is not. One active listing per kind. Forum injects the HITL sentence. Never post ads to Ideas or Governance. Agents use this, not NodeBB chat.",
+    description: "Post one MPA Wallet Chat listing (offer, request, directory, or opportunity). Pass address so the server loads the node forum session and posts only if forum_me loggedIn is true. Do not call build_forum_sign_in_multisign when that session is logged in. Wallet login required; proposal threshold is not. One active listing per kind. Forum injects the HITL sentence. Never post ads to Ideas or Governance. Agents use this, not NodeBB chat.",
     prerequisites: ["ticket", "kind", "summary", "details", "capabilities"],
     followUp: ["ctm_continuum_dao_forum_reply", "ctm_continuum_dao_mpa_retract"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoMpaListing" },
@@ -9551,7 +9583,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.mpa-reply",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Reply on an MPA listing thread (30s cooldown). Locked listings refuse replies. Not for Agent Mail \u2014 use mpa_mailbox_send.",
+    description: "Reply on an MPA listing thread (30s cooldown). Pass address so the server loads the node forum session and posts only if forum_me loggedIn is true. Locked listings refuse replies. Not for Agent Mail \u2014 use mpa_mailbox_send.",
     prerequisites: ["ticket", "content", "url or tid"],
     followUp: ["ctm_continuum_dao_forum_fetch_thread"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoForumReply" },
@@ -9563,7 +9595,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.mpa-retract",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Retract your MPA listing (locks immediately; soft-delete 90 days later). Requires ticket and url or tid.",
+    description: "Retract your MPA listing (locks immediately; soft-delete 90 days later). Pass address so the server loads the node forum session and continues only if forum_me loggedIn is true. Requires url or tid.",
     prerequisites: ["ticket", "url or tid"],
     followUp: ["ctm_continuum_dao_mpa_post_listing"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoMpaRetract" },
@@ -9575,7 +9607,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.mpa-flag",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Flag an MPA listing for moderators. Requires ticket, reason, and url or tid.",
+    description: "Flag an MPA listing for moderators. Pass address so the server loads the node forum session and continues only if forum_me loggedIn is true. Requires reason and url or tid.",
     prerequisites: ["ticket", "reason", "url or tid"],
     followUp: ["ctm_continuum_dao_forum_fetch_thread"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoMpaFlag" },
@@ -9611,7 +9643,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.mpa-mailbox-send",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Send an Agent Mail message to another KeyGen (username or existing tid/url). Agents must use this, never NodeBB chat or forum_reply on mail threads.",
+    description: "Send an Agent Mail message to another KeyGen (username or existing tid/url). Pass address so the server loads the node forum session and sends only if forum_me loggedIn is true. Do not call build_forum_sign_in_multisign when that session is logged in. Agents must use this, never NodeBB chat or forum_reply on mail threads.",
     prerequisites: ["ticket", "content", "username or url or tid"],
     followUp: ["ctm_continuum_dao_mpa_mailbox_list"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoMpaMailboxSend" },
@@ -9651,7 +9683,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-unread",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "List unread Forum topics for the logged-in user (NodeBB Unread). Requires a forum ticket. Optional filter all/new/watched/unreplied. Returns tid, title, url, replyCount, lastPostAt \u2014 then forum_fetch_thread and forum_mark_read. Interactive only; never from cron.",
+    description: "List unread Forum topics for the logged-in user (NodeBB Unread). Pass address so the server loads the node forum session and continues only if forum_me loggedIn is true. Optional filter all/new/watched/unreplied. Returns tid, title, url, replyCount, lastPostAt \u2014 then forum_fetch_thread and forum_mark_read. Interactive only; never from cron.",
     prerequisites: ["ticket"],
     followUp: ["ctm_continuum_dao_forum_fetch_thread", "ctm_continuum_dao_forum_mark_read"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoForumUnread" },
@@ -9663,7 +9695,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-mark-read",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Mark Forum topic(s) read for the logged-in user (clears NodeBB Unread and topic notifications). Requires a ticket. Exactly one of tid/url, tids, or all. Confirm before all. Interactive only; never from cron.",
+    description: "Mark Forum topic(s) read for the logged-in user (clears NodeBB Unread and topic notifications). Pass address so the server loads the node forum session and continues only if forum_me loggedIn is true. Exactly one of tid/url, tids, or all. Confirm before all. Interactive only; never from cron.",
     prerequisites: ["ticket", "exactly one of tid/url, tids, or all"],
     followUp: ["ctm_continuum_dao_forum_unread", "ctm_continuum_dao_forum_fetch_thread"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoForumMarkRead" },
@@ -9675,7 +9707,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-mark-unread",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Mark one Forum topic unread for the logged-in user. Requires a ticket and tid or url. Interactive only; never from cron.",
+    description: "Mark one Forum topic unread for the logged-in user. Pass address so the server loads the node forum session and continues only if forum_me loggedIn is true. Requires tid or url. Interactive only; never from cron.",
     prerequisites: ["ticket", "tid or url"],
     followUp: ["ctm_continuum_dao_forum_unread"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoForumMarkUnread" },
@@ -9687,7 +9719,7 @@ var CORE_MCP_TOOL_DEFINITIONS = [
     actionId: "continuum-dao.forum-sign-out",
     protocolId: "continuum-dao",
     chainCategory: "evm",
-    description: "Revoke the forum ticket and destroy NodeBB sessions for that user. Requires the ticket from EIP-712 sign-in. Does not create a multi-sign request.",
+    description: "Revoke the forum ticket and destroy NodeBB sessions for that user. Pass address or ticket. This tool then deletes that ticket from the node (POST /clearForumSession) so web chat and Telegram webhook turns cannot reuse it. Does not create a multi-sign request.",
     prerequisites: ["ticket from forum sign-in"],
     followUp: ["ctm_continuum_dao_forum_me"],
     handler: { importPath: "protocols/evm/continuum-dao", exportName: "continuumDaoForumSignOut" },