@sage-protocol/sdk 0.0.8 → 0.1.2

package/dist/index.cjs

@@ -14,7 +14,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.0.8",
+      version: "0.1.2",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",
@@ -24,9 +24,21 @@ var require_package = __commonJS({
       exports: {
         ".": {
           types: "./types/index.d.ts",
-          require: "./dist/index.cjs",
+          browser: "./dist/browser/index.mjs",
           import: "./dist/index.mjs",
-          default: "./dist/index.cjs"
+          require: "./dist/index.cjs",
+          default: "./dist/index.mjs"
+        },
+        "./browser": {
+          types: "./types/index.d.ts",
+          import: "./dist/browser/index.mjs",
+          default: "./dist/browser/index.mjs"
+        },
+        "./node": {
+          types: "./types/index.d.ts",
+          import: "./dist/node/index.mjs",
+          require: "./dist/node/index.cjs",
+          default: "./dist/node/index.mjs"
         },
         "./package.json": "./package.json",
         "./types/*": "./types/*"
@@ -37,6 +49,12 @@ var require_package = __commonJS({
         "README.md"
       ],
       sideEffects: false,
+      browser: {
+        fs: false,
+        path: false,
+        os: false,
+        child_process: false
+      },
       repository: {
         type: "git",
         url: "git+https://github.com/sage-protocol/sdk.git"
@@ -848,7 +866,17 @@ var require_ipfs = __commonJS({
           pinUrl: removeTrailingSlash(options.workerPinUrl || env.SAGE_IPFS_WORKER_PIN_URL || ""),
           warmUrl: removeTrailingSlash(options.workerWarmUrl || env.SAGE_IPFS_WORKER_WARM_URL || ""),
           signer: options.workerSigner || options.signer || null,
-          getAuth: options.workerGetAuth || null
+          getAuth: options.workerGetAuth || null,
+          address: options.workerAddress || env.SAGE_SANDBOX_ADDRESS || "",
+          discoveryEventsPath: options.workerDiscoveryEventsPath || env.SAGE_IPFS_WORKER_DISCOVERY_EVENTS_PATH || "/discover/events",
+          discoveryMcpPath: options.workerDiscoveryMcpPath || env.SAGE_IPFS_WORKER_DISCOVERY_MCP_PATH || "/discover/mcp",
+          discoveryLaunchPath: options.workerDiscoveryLaunchPath || env.SAGE_IPFS_WORKER_DISCOVERY_LAUNCH_PATH || "/discover/launch",
+          discoveryFeedPath: options.workerDiscoveryFeedPath || env.SAGE_IPFS_WORKER_DISCOVERY_FEED_PATH || "/discover",
+          discoveryMetricsPath: options.workerDiscoveryMetricsPath || env.SAGE_IPFS_WORKER_DISCOVERY_METRICS_PATH || "/discover/metrics",
+          governanceReportPath: options.workerGovernanceReportPath || env.SAGE_IPFS_WORKER_GOVERNANCE_REPORT_PATH || "/governance/report",
+          governanceReportsPath: options.workerGovernanceReportsPath || env.SAGE_IPFS_WORKER_GOVERNANCE_REPORTS_PATH || "/governance/reports",
+          governanceReviewPath: options.workerGovernanceReviewPath || env.SAGE_IPFS_WORKER_GOVERNANCE_REVIEW_PATH || "/governance/report/review",
+          governanceBatchPath: options.workerGovernanceBatchPath || env.SAGE_IPFS_WORKER_GOVERNANCE_BATCH_PATH || "/governance/report/batch"
         },
         web3: {
           token: options.web3Token || env.W3S_TOKEN || env.WEB3_STORAGE_TOKEN || ""
@@ -892,6 +920,28 @@ var require_ipfs = __commonJS({
         if (kind === "delete" && config.worker.pinUrl) return `${ensureEndsWith(config.worker.pinUrl, "/pin")}/${cid}`;
         throw new Error(`Worker endpoint for ${kind} not configured`);
       }
+      function workerPath(key, fallback) {
+        return ensureLeadingSlash(config.worker[key] || fallback);
+      }
+      function workerEndpoint(key, fallback) {
+        const base = workerBaseUrl();
+        if (!base) throw new Error("worker_base_url_required");
+        return `${base}${workerPath(key, fallback)}`;
+      }
+      async function postWorkerJson(pathKey, fallback, payload = {}, extraHeaders = {}) {
+        const url = workerEndpoint(pathKey, fallback);
+        const { headers, auth } = await buildWorkerAuthHeaders({ ...extraHeaders, "Content-Type": "application/json" });
+        const body = { ...payload };
+        if (auth && body.auth == null) body.auth = auth;
+        const response = await axiosInstance.post(url, body, { headers, timeout: config.timeoutMs });
+        return response?.data;
+      }
+      async function getWorkerJson(pathKey, fallback, params = {}, extraHeaders = {}) {
+        const url = workerEndpoint(pathKey, fallback);
+        const { headers } = await buildWorkerAuthHeaders({ "Accept": "application/json", ...extraHeaders });
+        const response = await axiosInstance.get(url, { headers, params, timeout: config.timeoutMs });
+        return response?.data;
+      }
       async function buildWorkerAuthHeaders(extraHeaders = {}) {
         if (config.worker.token) {
           return { headers: { ...extraHeaders, Authorization: `Bearer ${config.worker.token}` }, auth: null };
@@ -1168,6 +1218,83 @@ var require_ipfs = __commonJS({
         }
         return { provider: null, ok: true };
       }
+      async function recordDiscoveryEvent(event = {}) {
+        if (!event || typeof event !== "object") throw new Error("event required");
+        const promptId = typeof event.promptId === "string" ? event.promptId.trim() : "";
+        if (!promptId) throw new Error("promptId required");
+        const payload = { ...event, promptId };
+        return postWorkerJson("discoveryEventsPath", "/discover/events", payload);
+      }
+      async function recordMcpUsageEvent({ promptId, metadata, address } = {}) {
+        const id = typeof promptId === "string" ? promptId.trim() : "";
+        if (!id) throw new Error("promptId required");
+        const payload = { promptId: id };
+        if (metadata && typeof metadata === "object") payload.metadata = metadata;
+        const actor = address || config.worker.address;
+        if (actor) payload.address = actor;
+        return postWorkerJson("discoveryMcpPath", "/discover/mcp", payload);
+      }
+      async function recordLaunchEvent({ promptId, metadata, address } = {}) {
+        const id = typeof promptId === "string" ? promptId.trim() : "";
+        if (!id) throw new Error("promptId required");
+        const payload = { promptId: id };
+        if (metadata && typeof metadata === "object") payload.metadata = metadata;
+        const actor = address || config.worker.address;
+        if (actor) payload.address = actor;
+        return postWorkerJson("discoveryLaunchPath", "/discover/launch", payload);
+      }
+      async function submitGovernanceReport(payload = {}) {
+        if (!payload || typeof payload !== "object") throw new Error("payload required");
+        const promptId = typeof payload.promptId === "string" ? payload.promptId.trim() : "";
+        if (!promptId) throw new Error("promptId required");
+        const body = { promptId };
+        const reporter = payload.address || config.worker.address;
+        if (reporter) body.address = reporter;
+        if (typeof payload.reason === "string") body.reason = payload.reason;
+        if (typeof payload.note === "string") body.note = payload.note;
+        if (payload.weight !== void 0) {
+          const weight = Number(payload.weight);
+          if (Number.isFinite(weight) && weight > 0) body.weight = weight;
+        }
+        return postWorkerJson("governanceReportPath", "/governance/report", body);
+      }
+      async function listGovernanceReports(params = {}) {
+        const query = {};
+        if (params.status) query.status = params.status;
+        if (params.limit !== void 0) query.limit = params.limit;
+        if (params.cursor !== void 0) query.cursor = params.cursor;
+        return getWorkerJson("governanceReportsPath", "/governance/reports", query);
+      }
+      async function reviewGovernanceReport(payload = {}) {
+        if (!payload || typeof payload !== "object") throw new Error("payload required");
+        const id = typeof payload.id === "string" ? payload.id.trim() : "";
+        if (!id) throw new Error("report id required");
+        const status = typeof payload.status === "string" ? payload.status.trim() : "";
+        if (!status) throw new Error("status required");
+        const body = { id, status };
+        if (typeof payload.note === "string") body.note = payload.note;
+        if (typeof payload.action === "string") body.action = payload.action;
+        return postWorkerJson("governanceReviewPath", "/governance/report/review", body);
+      }
+      async function batchGovernanceReports(payload = {}) {
+        if (!payload || typeof payload !== "object") throw new Error("payload required");
+        const ids = Array.isArray(payload.ids) ? payload.ids.map(String).filter(Boolean) : [];
+        if (!ids.length) throw new Error("ids required");
+        const action = typeof payload.action === "string" ? payload.action.trim() : "";
+        if (!action) throw new Error("action required");
+        const body = { ids, action };
+        if (typeof payload.note === "string") body.note = payload.note;
+        return postWorkerJson("governanceBatchPath", "/governance/report/batch", body);
+      }
+      async function fetchDiscovery(params = {}) {
+        const query = {};
+        if (params.filter) query.filter = params.filter;
+        if (params.limit !== void 0) query.limit = params.limit;
+        return getWorkerJson("discoveryFeedPath", "/discover", query);
+      }
+      async function fetchDiscoveryMetrics(params = {}) {
+        return getWorkerJson("discoveryMetricsPath", "/discover/metrics", params);
+      }
       return {
         config,
         hasPinataCreds,
@@ -1180,6 +1307,15 @@ var require_ipfs = __commonJS({
         warmGateways,
         buildGatewayUrls: (cid, extra) => buildGatewayUrls(cid, config.gateway, extra),
         pin,
+        recordDiscoveryEvent,
+        recordMcpUsage: recordMcpUsageEvent,
+        recordLaunchEvent,
+        submitGovernanceReport,
+        listGovernanceReports,
+        reviewGovernanceReport,
+        batchGovernanceReports,
+        fetchDiscovery,
+        fetchDiscoveryMetrics,
         generateCid
       };
     }
@@ -3120,7 +3256,12 @@ var require_operations = __commonJS({
       proposalId,
       refresh = false,
       cache = null,
-      fromBlock = 0
+      fromBlock = 0,
+      helperAddress = null,
+      hints = {},
+      chunkSizeBlocks = 1e4,
+      lookBackBlocks = 2e3,
+      lookAheadBlocks = 2e3
     }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
       const govAddr = normaliseGovernor(governor);
@@ -3130,6 +3271,30 @@ var require_operations = __commonJS({
         const cached = await cacheAdapter.load(govAddr, id);
         if (cached) return cached;
       }
+      if (helperAddress) {
+        try {
+          const helperAbi = [
+            "function getProposalTuple(uint256) view returns (address[] targets,uint256[] values,bytes[] calldatas,bytes32 descriptionHash,bool exists)"
+          ];
+          const helper = new Contract(helperAddress, helperAbi, provider);
+          const res = await helper.getProposalTuple(id);
+          if (res && res.exists) {
+            const tuple2 = {
+              id,
+              governor: normaliseGovernor(governor),
+              targets: res.targets || [],
+              values: (res.values || []).map((v) => BigInt(v)),
+              calldatas: (res.calldatas || []).map(String),
+              description: "",
+              descriptionHash: res.descriptionHash || null,
+              createdBlock: null
+            };
+            if (cacheAdapter) await cacheAdapter.save(governor, id, tuple2);
+            return tuple2;
+          }
+        } catch (_) {
+        }
+      }
       let metadata = null;
       try {
         metadata = await governance2.getProposalMetadata({ provider, governor: govAddr, id });
@@ -3137,14 +3302,66 @@ var require_operations = __commonJS({
         metadata = null;
       }
       if (!metadata) {
-        const page = await governance2.listProposals({ provider, governor: govAddr, fromBlock, toBlock: "latest" });
-        metadata = page.find((entry) => {
-          try {
-            return normaliseProposalId(entry.id || entry.proposalId) === id;
-          } catch (_) {
-            return false;
+        let lower = fromBlock || 0;
+        try {
+          const govAbi = new Interface(ABI.Governor);
+          const govC = new Contract(govAddr, govAbi, provider);
+          const snapshot = hints.snapshot ?? await govC.proposalSnapshot(id).catch(() => null);
+          const votingDelay = hints.votingDelay ?? await govC.votingDelay().catch(() => null);
+          if (snapshot !== null && votingDelay !== null) {
+            const approxCreation = Number(snapshot) - Number(votingDelay);
+            lower = approxCreation > 0 ? approxCreation : 0;
+            const upper = lower + Number(lookAheadBlocks);
+            const from = lower > lookBackBlocks ? lower - Number(lookBackBlocks) : 0;
+            const toBlock = await provider.getBlockNumber();
+            const max = Math.min(upper + Number(lookBackBlocks), Number(toBlock));
+            const topic = govC.interface.getEvent("ProposalCreated").topicHash;
+            for (let start = from; start <= max; start += Number(chunkSizeBlocks)) {
+              const end = Math.min(max, start + Number(chunkSizeBlocks));
+              try {
+                const logs = await provider.getLogs({
+                  address: govAddr,
+                  topics: [topic],
+                  fromBlock: start,
+                  toBlock: end
+                });
+                for (const log of logs) {
+                  try {
+                    const parsed = govC.interface.parseLog(log);
+                    const pid = normaliseProposalId(parsed.args.proposalId);
+                    if (pid === id) {
+                      metadata = {
+                        id,
+                        governor: govAddr,
+                        targets: Array.from(parsed.args.targets || [], String),
+                        values: Array.from(parsed.args.values || [], (v) => BigInt(v.toString())),
+                        calldatas: Array.from(parsed.args.calldatas || [], (b) => String(b)),
+                        description: String(parsed.args.description || ""),
+                        descriptionHash: governance2.hashDescription ? governance2.hashDescription(String(parsed.args.description || "")) : keccak256(toUtf8Bytes(String(parsed.args.description || ""))),
+                        createdBlock: log.blockNumber
+                      };
+                      break;
+                    }
+                  } catch (_) {
+                  }
+                }
+                if (metadata) break;
+              } catch (_) {
+              }
+            }
           }
-        }) || null;
+        } catch (_) {
+        }
+        if (!metadata) {
+          const page = await governance2.listProposals({ provider, governor: govAddr, fromBlock, toBlock: "latest" });
+          metadata = page.find((entry) => {
+            try {
+              return normaliseProposalId(entry.id || entry.proposalId) === id;
+            } catch (_) {
+              return false;
+            }
+          }) || null;
+        }
       }
       if (!metadata) {
         throw new SageSDKError(CODES.NOT_FOUND, "proposal tuple not found");
@@ -3342,10 +3559,11 @@ var require_operations = __commonJS({
       proposalId,
       refresh = false,
       cache = null,
-      includeTimeline = false
+      includeTimeline = false,
+      helperAddress = null
     }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const tuple = await resolveProposalTuple({ provider, governor, proposalId, refresh, cache });
+      const tuple = await resolveProposalTuple({ provider, governor, proposalId, refresh, cache, helperAddress });
       let proposal = null;
       try {
         proposal = await governance2.getProposal({ provider, governor: tuple.governor, id: tuple.id });

package/dist/index.mjs

@@ -20,7 +20,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.0.8",
+      version: "0.1.2",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",
@@ -30,9 +30,21 @@ var require_package = __commonJS({
       exports: {
         ".": {
           types: "./types/index.d.ts",
-          require: "./dist/index.cjs",
+          browser: "./dist/browser/index.mjs",
           import: "./dist/index.mjs",
-          default: "./dist/index.cjs"
+          require: "./dist/index.cjs",
+          default: "./dist/index.mjs"
+        },
+        "./browser": {
+          types: "./types/index.d.ts",
+          import: "./dist/browser/index.mjs",
+          default: "./dist/browser/index.mjs"
+        },
+        "./node": {
+          types: "./types/index.d.ts",
+          import: "./dist/node/index.mjs",
+          require: "./dist/node/index.cjs",
+          default: "./dist/node/index.mjs"
         },
         "./package.json": "./package.json",
         "./types/*": "./types/*"
@@ -43,6 +55,12 @@ var require_package = __commonJS({
         "README.md"
       ],
       sideEffects: false,
+      browser: {
+        fs: false,
+        path: false,
+        os: false,
+        child_process: false
+      },
       repository: {
         type: "git",
         url: "git+https://github.com/sage-protocol/sdk.git"
@@ -854,7 +872,17 @@ var require_ipfs = __commonJS({
           pinUrl: removeTrailingSlash(options.workerPinUrl || env.SAGE_IPFS_WORKER_PIN_URL || ""),
           warmUrl: removeTrailingSlash(options.workerWarmUrl || env.SAGE_IPFS_WORKER_WARM_URL || ""),
           signer: options.workerSigner || options.signer || null,
-          getAuth: options.workerGetAuth || null
+          getAuth: options.workerGetAuth || null,
+          address: options.workerAddress || env.SAGE_SANDBOX_ADDRESS || "",
+          discoveryEventsPath: options.workerDiscoveryEventsPath || env.SAGE_IPFS_WORKER_DISCOVERY_EVENTS_PATH || "/discover/events",
+          discoveryMcpPath: options.workerDiscoveryMcpPath || env.SAGE_IPFS_WORKER_DISCOVERY_MCP_PATH || "/discover/mcp",
+          discoveryLaunchPath: options.workerDiscoveryLaunchPath || env.SAGE_IPFS_WORKER_DISCOVERY_LAUNCH_PATH || "/discover/launch",
+          discoveryFeedPath: options.workerDiscoveryFeedPath || env.SAGE_IPFS_WORKER_DISCOVERY_FEED_PATH || "/discover",
+          discoveryMetricsPath: options.workerDiscoveryMetricsPath || env.SAGE_IPFS_WORKER_DISCOVERY_METRICS_PATH || "/discover/metrics",
+          governanceReportPath: options.workerGovernanceReportPath || env.SAGE_IPFS_WORKER_GOVERNANCE_REPORT_PATH || "/governance/report",
+          governanceReportsPath: options.workerGovernanceReportsPath || env.SAGE_IPFS_WORKER_GOVERNANCE_REPORTS_PATH || "/governance/reports",
+          governanceReviewPath: options.workerGovernanceReviewPath || env.SAGE_IPFS_WORKER_GOVERNANCE_REVIEW_PATH || "/governance/report/review",
+          governanceBatchPath: options.workerGovernanceBatchPath || env.SAGE_IPFS_WORKER_GOVERNANCE_BATCH_PATH || "/governance/report/batch"
         },
         web3: {
           token: options.web3Token || env.W3S_TOKEN || env.WEB3_STORAGE_TOKEN || ""
@@ -898,6 +926,28 @@ var require_ipfs = __commonJS({
         if (kind === "delete" && config.worker.pinUrl) return `${ensureEndsWith(config.worker.pinUrl, "/pin")}/${cid}`;
         throw new Error(`Worker endpoint for ${kind} not configured`);
       }
+      function workerPath(key, fallback) {
+        return ensureLeadingSlash(config.worker[key] || fallback);
+      }
+      function workerEndpoint(key, fallback) {
+        const base = workerBaseUrl();
+        if (!base) throw new Error("worker_base_url_required");
+        return `${base}${workerPath(key, fallback)}`;
+      }
+      async function postWorkerJson(pathKey, fallback, payload = {}, extraHeaders = {}) {
+        const url = workerEndpoint(pathKey, fallback);
+        const { headers, auth } = await buildWorkerAuthHeaders({ ...extraHeaders, "Content-Type": "application/json" });
+        const body = { ...payload };
+        if (auth && body.auth == null) body.auth = auth;
+        const response = await axiosInstance.post(url, body, { headers, timeout: config.timeoutMs });
+        return response?.data;
+      }
+      async function getWorkerJson(pathKey, fallback, params = {}, extraHeaders = {}) {
+        const url = workerEndpoint(pathKey, fallback);
+        const { headers } = await buildWorkerAuthHeaders({ "Accept": "application/json", ...extraHeaders });
+        const response = await axiosInstance.get(url, { headers, params, timeout: config.timeoutMs });
+        return response?.data;
+      }
       async function buildWorkerAuthHeaders(extraHeaders = {}) {
         if (config.worker.token) {
           return { headers: { ...extraHeaders, Authorization: `Bearer ${config.worker.token}` }, auth: null };
@@ -1174,6 +1224,83 @@ var require_ipfs = __commonJS({
         }
         return { provider: null, ok: true };
       }
+      async function recordDiscoveryEvent(event = {}) {
+        if (!event || typeof event !== "object") throw new Error("event required");
+        const promptId = typeof event.promptId === "string" ? event.promptId.trim() : "";
+        if (!promptId) throw new Error("promptId required");
+        const payload = { ...event, promptId };
+        return postWorkerJson("discoveryEventsPath", "/discover/events", payload);
+      }
+      async function recordMcpUsageEvent({ promptId, metadata, address } = {}) {
+        const id = typeof promptId === "string" ? promptId.trim() : "";
+        if (!id) throw new Error("promptId required");
+        const payload = { promptId: id };
+        if (metadata && typeof metadata === "object") payload.metadata = metadata;
+        const actor = address || config.worker.address;
+        if (actor) payload.address = actor;
+        return postWorkerJson("discoveryMcpPath", "/discover/mcp", payload);
+      }
+      async function recordLaunchEvent({ promptId, metadata, address } = {}) {
+        const id = typeof promptId === "string" ? promptId.trim() : "";
+        if (!id) throw new Error("promptId required");
+        const payload = { promptId: id };
+        if (metadata && typeof metadata === "object") payload.metadata = metadata;
+        const actor = address || config.worker.address;
+        if (actor) payload.address = actor;
+        return postWorkerJson("discoveryLaunchPath", "/discover/launch", payload);
+      }
+      async function submitGovernanceReport(payload = {}) {
+        if (!payload || typeof payload !== "object") throw new Error("payload required");
+        const promptId = typeof payload.promptId === "string" ? payload.promptId.trim() : "";
+        if (!promptId) throw new Error("promptId required");
+        const body = { promptId };
+        const reporter = payload.address || config.worker.address;
+        if (reporter) body.address = reporter;
+        if (typeof payload.reason === "string") body.reason = payload.reason;
+        if (typeof payload.note === "string") body.note = payload.note;
+        if (payload.weight !== void 0) {
+          const weight = Number(payload.weight);
+          if (Number.isFinite(weight) && weight > 0) body.weight = weight;
+        }
+        return postWorkerJson("governanceReportPath", "/governance/report", body);
+      }
+      async function listGovernanceReports(params = {}) {
+        const query = {};
+        if (params.status) query.status = params.status;
+        if (params.limit !== void 0) query.limit = params.limit;
+        if (params.cursor !== void 0) query.cursor = params.cursor;
+        return getWorkerJson("governanceReportsPath", "/governance/reports", query);
+      }
+      async function reviewGovernanceReport(payload = {}) {
+        if (!payload || typeof payload !== "object") throw new Error("payload required");
+        const id = typeof payload.id === "string" ? payload.id.trim() : "";
+        if (!id) throw new Error("report id required");
+        const status = typeof payload.status === "string" ? payload.status.trim() : "";
+        if (!status) throw new Error("status required");
+        const body = { id, status };
+        if (typeof payload.note === "string") body.note = payload.note;
+        if (typeof payload.action === "string") body.action = payload.action;
+        return postWorkerJson("governanceReviewPath", "/governance/report/review", body);
+      }
+      async function batchGovernanceReports(payload = {}) {
+        if (!payload || typeof payload !== "object") throw new Error("payload required");
+        const ids = Array.isArray(payload.ids) ? payload.ids.map(String).filter(Boolean) : [];
+        if (!ids.length) throw new Error("ids required");
+        const action = typeof payload.action === "string" ? payload.action.trim() : "";
+        if (!action) throw new Error("action required");
+        const body = { ids, action };
+        if (typeof payload.note === "string") body.note = payload.note;
+        return postWorkerJson("governanceBatchPath", "/governance/report/batch", body);
+      }
+      async function fetchDiscovery(params = {}) {
+        const query = {};
+        if (params.filter) query.filter = params.filter;
+        if (params.limit !== void 0) query.limit = params.limit;
+        return getWorkerJson("discoveryFeedPath", "/discover", query);
+      }
+      async function fetchDiscoveryMetrics(params = {}) {
+        return getWorkerJson("discoveryMetricsPath", "/discover/metrics", params);
+      }
       return {
         config,
         hasPinataCreds,
@@ -1186,6 +1313,15 @@ var require_ipfs = __commonJS({
         warmGateways,
         buildGatewayUrls: (cid, extra) => buildGatewayUrls(cid, config.gateway, extra),
         pin,
+        recordDiscoveryEvent,
+        recordMcpUsage: recordMcpUsageEvent,
+        recordLaunchEvent,
+        submitGovernanceReport,
+        listGovernanceReports,
+        reviewGovernanceReport,
+        batchGovernanceReports,
+        fetchDiscovery,
+        fetchDiscoveryMetrics,
         generateCid
       };
     }
@@ -3126,7 +3262,12 @@ var require_operations = __commonJS({
       proposalId,
       refresh = false,
       cache = null,
-      fromBlock = 0
+      fromBlock = 0,
+      helperAddress = null,
+      hints = {},
+      chunkSizeBlocks = 1e4,
+      lookBackBlocks = 2e3,
+      lookAheadBlocks = 2e3
     }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
       const govAddr = normaliseGovernor(governor);
@@ -3136,6 +3277,30 @@ var require_operations = __commonJS({
         const cached = await cacheAdapter.load(govAddr, id);
         if (cached) return cached;
       }
+      if (helperAddress) {
+        try {
+          const helperAbi = [
+            "function getProposalTuple(uint256) view returns (address[] targets,uint256[] values,bytes[] calldatas,bytes32 descriptionHash,bool exists)"
+          ];
+          const helper = new Contract(helperAddress, helperAbi, provider);
+          const res = await helper.getProposalTuple(id);
+          if (res && res.exists) {
+            const tuple2 = {
+              id,
+              governor: normaliseGovernor(governor),
+              targets: res.targets || [],
+              values: (res.values || []).map((v) => BigInt(v)),
+              calldatas: (res.calldatas || []).map(String),
+              description: "",
+              descriptionHash: res.descriptionHash || null,
+              createdBlock: null
+            };
+            if (cacheAdapter) await cacheAdapter.save(governor, id, tuple2);
+            return tuple2;
+          }
+        } catch (_) {
+        }
+      }
       let metadata = null;
       try {
         metadata = await governance.getProposalMetadata({ provider, governor: govAddr, id });
@@ -3143,14 +3308,66 @@ var require_operations = __commonJS({
         metadata = null;
       }
       if (!metadata) {
-        const page = await governance.listProposals({ provider, governor: govAddr, fromBlock, toBlock: "latest" });
-        metadata = page.find((entry) => {
-          try {
-            return normaliseProposalId(entry.id || entry.proposalId) === id;
-          } catch (_) {
-            return false;
+        let lower = fromBlock || 0;
+        try {
+          const govAbi = new Interface(ABI.Governor);
+          const govC = new Contract(govAddr, govAbi, provider);
+          const snapshot = hints.snapshot ?? await govC.proposalSnapshot(id).catch(() => null);
+          const votingDelay = hints.votingDelay ?? await govC.votingDelay().catch(() => null);
+          if (snapshot !== null && votingDelay !== null) {
+            const approxCreation = Number(snapshot) - Number(votingDelay);
+            lower = approxCreation > 0 ? approxCreation : 0;
+            const upper = lower + Number(lookAheadBlocks);
+            const from = lower > lookBackBlocks ? lower - Number(lookBackBlocks) : 0;
+            const toBlock = await provider.getBlockNumber();
+            const max = Math.min(upper + Number(lookBackBlocks), Number(toBlock));
+            const topic = govC.interface.getEvent("ProposalCreated").topicHash;
+            for (let start = from; start <= max; start += Number(chunkSizeBlocks)) {
+              const end = Math.min(max, start + Number(chunkSizeBlocks));
+              try {
+                const logs = await provider.getLogs({
+                  address: govAddr,
+                  topics: [topic],
+                  fromBlock: start,
+                  toBlock: end
+                });
+                for (const log of logs) {
+                  try {
+                    const parsed = govC.interface.parseLog(log);
+                    const pid = normaliseProposalId(parsed.args.proposalId);
+                    if (pid === id) {
+                      metadata = {
+                        id,
+                        governor: govAddr,
+                        targets: Array.from(parsed.args.targets || [], String),
+                        values: Array.from(parsed.args.values || [], (v) => BigInt(v.toString())),
+                        calldatas: Array.from(parsed.args.calldatas || [], (b) => String(b)),
+                        description: String(parsed.args.description || ""),
+                        descriptionHash: governance.hashDescription ? governance.hashDescription(String(parsed.args.description || "")) : keccak256(toUtf8Bytes(String(parsed.args.description || ""))),
+                        createdBlock: log.blockNumber
+                      };
+                      break;
+                    }
+                  } catch (_) {
+                  }
+                }
+                if (metadata) break;
+              } catch (_) {
+              }
+            }
           }
-        }) || null;
+        } catch (_) {
+        }
+        if (!metadata) {
+          const page = await governance.listProposals({ provider, governor: govAddr, fromBlock, toBlock: "latest" });
+          metadata = page.find((entry) => {
+            try {
+              return normaliseProposalId(entry.id || entry.proposalId) === id;
+            } catch (_) {
+              return false;
+            }
+          }) || null;
+        }
       }
       if (!metadata) {
         throw new SageSDKError(CODES.NOT_FOUND, "proposal tuple not found");
@@ -3348,10 +3565,11 @@ var require_operations = __commonJS({
       proposalId,
       refresh = false,
       cache = null,
-      includeTimeline = false
+      includeTimeline = false,
+      helperAddress = null
     }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const tuple = await resolveProposalTuple({ provider, governor, proposalId, refresh, cache });
+      const tuple = await resolveProposalTuple({ provider, governor, proposalId, refresh, cache, helperAddress });
       let proposal = null;
       try {
         proposal = await governance.getProposal({ provider, governor: tuple.governor, id: tuple.id });
@@ -7923,7 +8141,7 @@ var require_doppler = __commonJS({
 });
 
 // src/index.js
-var require_index = __commonJS({
+var require_src = __commonJS({
   "src/index.js"(exports, module) {
     var pkg = require_package();
     var abi = require_abi();
@@ -8023,4 +8241,4 @@ var require_index = __commonJS({
     };
   }
 });
-export default require_index();
+export default require_src();