@tradejs/node 3.1.29-beta.272 → 3.1.29-beta.275

package/dist/mcp.d.mts

@@ -8,10 +8,11 @@ declare const mcpPackageManifestHash: () => Promise<string>;
 declare const enqueueMcpJob: (principal: McpPrincipal, kind: McpJob["kind"], request: Record<string, unknown>, idempotencyKey: string) => Promise<McpJob>;
 declare const readMcpJob: (userName: string, id: string) => Promise<McpJob>;
 declare const readAuthorizedMcpJob: (principal: McpPrincipal, id: string) => Promise<McpJob>;
+declare const redactMcpJobLog: (line: string) => string;
 /** Offsets refer to the retained worker tail, which may shift while running. */
 declare const readMcpJobLogs: (principal: McpPrincipal, id: string, offset?: number, limit?: number) => Promise<{
     jobId: string;
-    status: "completed" | "failed" | "running" | "queued" | "cancelled";
+    status: "running" | "completed" | "failed" | "queued" | "cancelled";
     updatedAt: number;
     offset: number;
     nextOffset: number | null;
@@ -144,6 +145,10 @@ declare const readMcpStrategies: (userName: string, deploymentId: string) => Pro
     }[];
     observedAt: number;
 }>;
+declare class McpCursorError extends Error {
+    readonly code: 'CURSOR_EXPIRED' | 'CURSOR_MISMATCH';
+    constructor(code: 'CURSOR_EXPIRED' | 'CURSOR_MISMATCH');
+}
 declare const readMcpRuntimePage: (userName: string, kind: "signals" | "evaluations" | "orders", request: {
     deploymentId: string;
     cursor: string;
@@ -151,6 +156,7 @@ declare const readMcpRuntimePage: (userName: string, kind: "signals" | "evaluati
     endTime: number;
     strategy?: string;
     symbol?: string;
+    limit?: number;
 }) => Promise<{
     items: Record<string, unknown>[];
     cursor: string;
@@ -162,6 +168,16 @@ declare const readMcpRuntimePage: (userName: string, kind: "signals" | "evaluati
         endTime: number;
     };
     coverage: string;
+    pagination: {
+        scanComplete: boolean;
+        storageReads: number;
+        inspected: number;
+        cursorTtlSeconds: number;
+        consistency: string;
+        order: string;
+        retentionStartTime: null;
+        persistenceCompleteness: string;
+    };
     note: string;
 }>;
 declare const readMcpSignal: (userName: string, signalId: string, deploymentId: string, timestamp: number, strategy: string) => Promise<{
@@ -212,4 +228,4 @@ declare const readMcpBacktestResult: (userName: string, id: string, offset?: num
     source: string;
 }>;
 
-export { MCP_JOB_TTL, cancelMcpJob, enqueueMcpJob, isMcpRecord, mcpId, mcpJobDirectory, mcpJobStorageId, mcpPackageManifestHash, mcpProjectRoot, publicMcpJob, readAuthorizedMcpJob, readMcpBacktestPage, readMcpBacktestResult, readMcpChart, readMcpDeployments, readMcpEvaluationStats, readMcpJob, readMcpJobLogs, readMcpMarket, readMcpRuntimePage, readMcpSignal, readMcpStrategies, redactMcpData, requireMcpDeployment };
+export { MCP_JOB_TTL, McpCursorError, cancelMcpJob, enqueueMcpJob, isMcpRecord, mcpId, mcpJobDirectory, mcpJobStorageId, mcpPackageManifestHash, mcpProjectRoot, publicMcpJob, readAuthorizedMcpJob, readMcpBacktestPage, readMcpBacktestResult, readMcpChart, readMcpDeployments, readMcpEvaluationStats, readMcpJob, readMcpJobLogs, readMcpMarket, readMcpRuntimePage, readMcpSignal, readMcpStrategies, redactMcpData, redactMcpJobLog, requireMcpDeployment };

package/dist/mcp.d.ts

@@ -8,10 +8,11 @@ declare const mcpPackageManifestHash: () => Promise<string>;
 declare const enqueueMcpJob: (principal: McpPrincipal, kind: McpJob["kind"], request: Record<string, unknown>, idempotencyKey: string) => Promise<McpJob>;
 declare const readMcpJob: (userName: string, id: string) => Promise<McpJob>;
 declare const readAuthorizedMcpJob: (principal: McpPrincipal, id: string) => Promise<McpJob>;
+declare const redactMcpJobLog: (line: string) => string;
 /** Offsets refer to the retained worker tail, which may shift while running. */
 declare const readMcpJobLogs: (principal: McpPrincipal, id: string, offset?: number, limit?: number) => Promise<{
     jobId: string;
-    status: "completed" | "failed" | "running" | "queued" | "cancelled";
+    status: "running" | "completed" | "failed" | "queued" | "cancelled";
     updatedAt: number;
     offset: number;
     nextOffset: number | null;
@@ -144,6 +145,10 @@ declare const readMcpStrategies: (userName: string, deploymentId: string) => Pro
     }[];
     observedAt: number;
 }>;
+declare class McpCursorError extends Error {
+    readonly code: 'CURSOR_EXPIRED' | 'CURSOR_MISMATCH';
+    constructor(code: 'CURSOR_EXPIRED' | 'CURSOR_MISMATCH');
+}
 declare const readMcpRuntimePage: (userName: string, kind: "signals" | "evaluations" | "orders", request: {
     deploymentId: string;
     cursor: string;
@@ -151,6 +156,7 @@ declare const readMcpRuntimePage: (userName: string, kind: "signals" | "evaluati
     endTime: number;
     strategy?: string;
     symbol?: string;
+    limit?: number;
 }) => Promise<{
     items: Record<string, unknown>[];
     cursor: string;
@@ -162,6 +168,16 @@ declare const readMcpRuntimePage: (userName: string, kind: "signals" | "evaluati
         endTime: number;
     };
     coverage: string;
+    pagination: {
+        scanComplete: boolean;
+        storageReads: number;
+        inspected: number;
+        cursorTtlSeconds: number;
+        consistency: string;
+        order: string;
+        retentionStartTime: null;
+        persistenceCompleteness: string;
+    };
     note: string;
 }>;
 declare const readMcpSignal: (userName: string, signalId: string, deploymentId: string, timestamp: number, strategy: string) => Promise<{
@@ -212,4 +228,4 @@ declare const readMcpBacktestResult: (userName: string, id: string, offset?: num
     source: string;
 }>;
 
-export { MCP_JOB_TTL, cancelMcpJob, enqueueMcpJob, isMcpRecord, mcpId, mcpJobDirectory, mcpJobStorageId, mcpPackageManifestHash, mcpProjectRoot, publicMcpJob, readAuthorizedMcpJob, readMcpBacktestPage, readMcpBacktestResult, readMcpChart, readMcpDeployments, readMcpEvaluationStats, readMcpJob, readMcpJobLogs, readMcpMarket, readMcpRuntimePage, readMcpSignal, readMcpStrategies, redactMcpData, requireMcpDeployment };
+export { MCP_JOB_TTL, McpCursorError, cancelMcpJob, enqueueMcpJob, isMcpRecord, mcpId, mcpJobDirectory, mcpJobStorageId, mcpPackageManifestHash, mcpProjectRoot, publicMcpJob, readAuthorizedMcpJob, readMcpBacktestPage, readMcpBacktestResult, readMcpChart, readMcpDeployments, readMcpEvaluationStats, readMcpJob, readMcpJobLogs, readMcpMarket, readMcpRuntimePage, readMcpSignal, readMcpStrategies, redactMcpData, redactMcpJobLog, requireMcpDeployment };

package/dist/mcp.js

@@ -778,6 +778,7 @@ var init_jevTraining = __esm({
 var mcp_exports = {};
 __export(mcp_exports, {
   MCP_JOB_TTL: () => MCP_JOB_TTL,
+  McpCursorError: () => McpCursorError,
   cancelMcpJob: () => cancelMcpJob,
   enqueueMcpJob: () => enqueueMcpJob,
   isMcpRecord: () => isMcpRecord,
@@ -800,6 +801,7 @@ __export(mcp_exports, {
   readMcpSignal: () => readMcpSignal,
   readMcpStrategies: () => readMcpStrategies,
   redactMcpData: () => redactMcpData,
+  redactMcpJobLog: () => redactMcpJobLog,
   requireMcpDeployment: () => requireMcpDeployment
 });
 module.exports = __toCommonJS(mcp_exports);
@@ -8874,7 +8876,7 @@ var readAuthorizedMcpJob = async (principal, id) => {
     throw new Error("Insufficient scope");
   return job;
 };
-var redactJobLog = (line) => line.replace(/\u001b\[[0-9;]*m/g, "").replace(/\b(Bearer|Basic)\s+\S+/gi, "$1 [redacted]").replace(/([a-z][a-z0-9+.-]*:\/\/)[^\s/@]*:[^\s/@]+@/gi, "$1[redacted]@").replace(/((?:authorization|cookie)\s*:\s*)[^\r\n]+/gi, "$1[redacted]").replace(
+var redactMcpJobLog = (line) => line.replace(/\u001b\[[0-9;]*m/g, "").replace(/\b(Bearer|Basic)\s+\S+/gi, "$1 [redacted]").replace(/([a-z][a-z0-9+.-]*:\/\/)[^\s/@]*:[^\s/@]+@/gi, "$1[redacted]@").replace(/((?:authorization|cookie)\s*:\s*)[^\r\n]+/gi, "$1[redacted]").replace(
   /((?:[\w.-]*(?:secret|password|token|api[_-]?key|private[_-]?key|authorization|cookie|credential)[\w.-]*)["']?\s*[:=]\s*)(?:"[^"\r\n]*"|'[^'\r\n]*'|[^\s,;&}]+)/gi,
   "$1[redacted]"
 ).slice(0, 1e3);
@@ -8885,7 +8887,7 @@ var readMcpJobLogs = async (principal, id, offset = 0, limit = 50) => {
   const lines = [];
   let bytes = 0;
   for (const line of job.logs.slice(offset, offset + limit)) {
-    const redacted = redactJobLog(line);
+    const redacted = redactMcpJobLog(line);
     const size = Buffer.byteLength(JSON.stringify(redacted)) + 1;
     if (bytes + size > 48e3) break;
     lines.push(redacted);
@@ -9081,11 +9083,34 @@ var readMcpStrategies = async (userName, deploymentId) => {
     observedAt: Date.now()
   };
 };
+var McpCursorError = class extends Error {
+  constructor(code) {
+    super(
+      code === "CURSOR_EXPIRED" ? "Invalid storage cursor: expired or unavailable; restart the same window and deduplicate record identities" : "Invalid storage cursor: user, account or filters changed"
+    );
+    this.code = code;
+    this.name = "McpCursorError";
+  }
+};
+var RUNTIME_CURSOR_TTL = 86400;
 var readMcpRuntimePage = async (userName, kind, request) => {
   const deployment = await requireMcpDeployment(userName, request.deploymentId);
   const prefix = kind === "signals" ? import_redis4.redisKeys.runtimeSignalBuckets(userName) : kind === "evaluations" ? import_redis4.redisKeys.runtimeSignalEvaluationBuckets(userName) : import_redis4.redisKeys.runtimeTrades(userName);
-  const { cursor: _cursor, ...filters } = request;
-  const binding = mcpId(JSON.stringify({ userName, kind, ...filters }));
+  const limit = request.limit ?? 50;
+  if (!Number.isInteger(limit) || limit < 1 || limit > 50)
+    throw new Error("Select a page limit of 1\u201350");
+  const binding = mcpId(
+    JSON.stringify({
+      userName,
+      kind,
+      accountId: deployment.accountId,
+      deploymentId: request.deploymentId,
+      startTime: request.startTime,
+      endTime: request.endTime,
+      strategy: request.strategy ?? null,
+      symbol: request.symbol ?? null
+    })
+  );
   let state = {
     binding,
     scan: "0",
@@ -9098,29 +9123,46 @@ var readMcpRuntimePage = async (userName, kind, request) => {
     const saved = await import_redis4.mcpStorage.get(
       `cursor:${request.cursor}`
     );
-    if (!saved || saved.binding !== binding)
-      throw new Error("Invalid storage cursor");
-    state = saved;
-  }
-  if (!state.keys.length && !state.values.length && (!state.scanned || state.scan !== "0")) {
-    const page = await (0, import_redis4.scanDataKeys)(prefix, state.scan);
-    state = { ...state, scan: page.cursor, keys: page.keys, scanned: true };
-  }
-  if (!state.values.length && state.keys.length) {
-    const key = state.keys[0];
-    if (kind === "orders") {
-      state.keys.shift();
-      if (!key.slice(prefix.length).startsWith("days:"))
-        state.values = [await (0, import_redis4.getDataStrict)(key)];
-    } else {
-      const page = await (0, import_redis4.scanHashJson)(key, state.hash);
-      state.values = page.values;
-      state.hash = page.cursor;
-      if (page.cursor === "0") state.keys.shift();
-    }
+    if (!saved) throw new McpCursorError("CURSOR_EXPIRED");
+    if (saved.binding !== binding) throw new McpCursorError("CURSOR_MISMATCH");
+    state = structuredClone(saved);
   }
   const items = [];
-  for (let row of state.values.splice(0, 50)) {
+  let storageReads = 0;
+  let inspected = 0;
+  let responseBytes = 0;
+  while (items.length < limit && storageReads < 40 && inspected < 1e3) {
+    if (!state.values.length) {
+      if (!state.keys.length) {
+        if (state.scanned && state.scan === "0") break;
+        const page = await (0, import_redis4.scanDataKeys)(prefix, state.scan);
+        storageReads++;
+        state.scan = page.cursor;
+        state.scanned = true;
+        state.keys = page.keys.filter((key2) => {
+          if (kind === "orders")
+            return !key2.slice(prefix.length).startsWith("days:");
+          const suffix = key2.slice(prefix.length);
+          const day = suffix.slice(0, 10);
+          return day >= (0, import_time3.getRuntimeStorageDayKey)(request.startTime) && day <= (0, import_time3.getRuntimeStorageDayKey)(request.endTime - 1) && (!request.strategy || suffix.slice(11) === request.strategy);
+        });
+        if (!state.keys.length) continue;
+      }
+      const key = state.keys[0];
+      storageReads++;
+      if (kind === "orders") {
+        state.keys.shift();
+        state.values = [await (0, import_redis4.getDataStrict)(key)];
+      } else {
+        const page = await (0, import_redis4.scanHashJson)(key, state.hash);
+        state.values = page.values;
+        state.hash = page.cursor;
+        if (page.cursor === "0") state.keys.shift();
+      }
+      if (!state.values.length) continue;
+    }
+    let row = state.values.shift();
+    inspected++;
     if (kind === "signals" && isMcpRecord(row) && typeof row.symbol === "string" && typeof row.signalId === "string")
       row = await (0, import_redis4.getDataStrict)(
         import_redis4.redisKeys.storeSignal(row.symbol, row.signalId)
@@ -9138,12 +9180,23 @@ var readMcpRuntimePage = async (userName, kind, request) => {
       additionalIndicators: _additional,
       ...summary
     } = row;
+    const bytes = Buffer.byteLength(JSON.stringify(summary));
+    if (bytes > 8e4)
+      throw new Error(
+        "Response too large. Use runtime_get_signal for record details."
+      );
+    if (responseBytes + bytes > 8e4) {
+      state.values.unshift(row);
+      break;
+    }
+    responseBytes += bytes;
     items.push(summary);
   }
   let next = "0";
   if (state.values.length || state.keys.length || state.scan !== "0") {
-    next = mcpId((0, import_node_crypto6.randomUUID)());
-    await import_redis4.mcpStorage.put(`cursor:${next}`, state, 600);
+    next = mcpId(JSON.stringify(state));
+    if (!await import_redis4.mcpStorage.put(`cursor:${next}`, state, RUNTIME_CURSOR_TTL))
+      throw new Error("MCP cursor persistence failed");
   }
   return {
     items,
@@ -9153,7 +9206,17 @@ var readMcpRuntimePage = async (userName, kind, request) => {
     source: "runtime_storage",
     window: { startTime: request.startTime, endTime: request.endTime },
     coverage: "stored_records_only",
-    note: "Missing records do not prove no evaluation occurred. Continue until cursor is 0; cursors expire after 10 minutes."
+    pagination: {
+      scanComplete: next === "0",
+      storageReads,
+      inspected,
+      cursorTtlSeconds: RUNTIME_CURSOR_TTL,
+      consistency: "mutable_storage_scan",
+      order: "storage_scan",
+      retentionStartTime: null,
+      persistenceCompleteness: "unknown"
+    },
+    note: "Continue until cursor=0, including empty pages. Cursors are shared across server processes and retained for 24 hours. Retry identical requests after transport failures. If CURSOR_EXPIRED, restart the same window and deduplicate record identities. Storage scans may repeat rows and are not immutable snapshots; missing records do not prove no activity."
   };
 };
 var readMcpSignal = async (userName, signalId, deploymentId, timestamp, strategy) => {
@@ -9273,6 +9336,7 @@ var readMcpBacktestResult = async (userName, id, offset = 0, limit = 20) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   MCP_JOB_TTL,
+  McpCursorError,
   cancelMcpJob,
   enqueueMcpJob,
   isMcpRecord,
@@ -9295,5 +9359,6 @@ var readMcpBacktestResult = async (userName, id, offset = 0, limit = 20) => {
   readMcpSignal,
   readMcpStrategies,
   redactMcpData,
+  redactMcpJobLog,
   requireMcpDeployment
 });

package/dist/mcp.mjs

@@ -17,7 +17,7 @@ import "./chunk-GHSLOJLE.mjs";
 import "./chunk-Y6FXYEAI.mjs";
 
 // src/mcp.ts
-import { createHash as createHash2, randomUUID } from "crypto";
+import { createHash as createHash2 } from "crypto";
 import { createIndicators } from "@tradejs/core/indicators";
 import { intervalToMs } from "@tradejs/core/data";
 import {
@@ -200,7 +200,7 @@ var readAuthorizedMcpJob = async (principal, id) => {
     throw new Error("Insufficient scope");
   return job;
 };
-var redactJobLog = (line) => line.replace(/\u001b\[[0-9;]*m/g, "").replace(/\b(Bearer|Basic)\s+\S+/gi, "$1 [redacted]").replace(/([a-z][a-z0-9+.-]*:\/\/)[^\s/@]*:[^\s/@]+@/gi, "$1[redacted]@").replace(/((?:authorization|cookie)\s*:\s*)[^\r\n]+/gi, "$1[redacted]").replace(
+var redactMcpJobLog = (line) => line.replace(/\u001b\[[0-9;]*m/g, "").replace(/\b(Bearer|Basic)\s+\S+/gi, "$1 [redacted]").replace(/([a-z][a-z0-9+.-]*:\/\/)[^\s/@]*:[^\s/@]+@/gi, "$1[redacted]@").replace(/((?:authorization|cookie)\s*:\s*)[^\r\n]+/gi, "$1[redacted]").replace(
   /((?:[\w.-]*(?:secret|password|token|api[_-]?key|private[_-]?key|authorization|cookie|credential)[\w.-]*)["']?\s*[:=]\s*)(?:"[^"\r\n]*"|'[^'\r\n]*'|[^\s,;&}]+)/gi,
   "$1[redacted]"
 ).slice(0, 1e3);
@@ -211,7 +211,7 @@ var readMcpJobLogs = async (principal, id, offset = 0, limit = 50) => {
   const lines = [];
   let bytes = 0;
   for (const line of job.logs.slice(offset, offset + limit)) {
-    const redacted = redactJobLog(line);
+    const redacted = redactMcpJobLog(line);
     const size = Buffer.byteLength(JSON.stringify(redacted)) + 1;
     if (bytes + size > 48e3) break;
     lines.push(redacted);
@@ -407,11 +407,34 @@ var readMcpStrategies = async (userName, deploymentId) => {
     observedAt: Date.now()
   };
 };
+var McpCursorError = class extends Error {
+  constructor(code) {
+    super(
+      code === "CURSOR_EXPIRED" ? "Invalid storage cursor: expired or unavailable; restart the same window and deduplicate record identities" : "Invalid storage cursor: user, account or filters changed"
+    );
+    this.code = code;
+    this.name = "McpCursorError";
+  }
+};
+var RUNTIME_CURSOR_TTL = 86400;
 var readMcpRuntimePage = async (userName, kind, request) => {
   const deployment = await requireMcpDeployment(userName, request.deploymentId);
   const prefix = kind === "signals" ? redisKeys2.runtimeSignalBuckets(userName) : kind === "evaluations" ? redisKeys2.runtimeSignalEvaluationBuckets(userName) : redisKeys2.runtimeTrades(userName);
-  const { cursor: _cursor, ...filters } = request;
-  const binding = mcpId(JSON.stringify({ userName, kind, ...filters }));
+  const limit = request.limit ?? 50;
+  if (!Number.isInteger(limit) || limit < 1 || limit > 50)
+    throw new Error("Select a page limit of 1\u201350");
+  const binding = mcpId(
+    JSON.stringify({
+      userName,
+      kind,
+      accountId: deployment.accountId,
+      deploymentId: request.deploymentId,
+      startTime: request.startTime,
+      endTime: request.endTime,
+      strategy: request.strategy ?? null,
+      symbol: request.symbol ?? null
+    })
+  );
   let state = {
     binding,
     scan: "0",
@@ -424,29 +447,46 @@ var readMcpRuntimePage = async (userName, kind, request) => {
     const saved = await mcpStorage2.get(
       `cursor:${request.cursor}`
     );
-    if (!saved || saved.binding !== binding)
-      throw new Error("Invalid storage cursor");
-    state = saved;
-  }
-  if (!state.keys.length && !state.values.length && (!state.scanned || state.scan !== "0")) {
-    const page = await scanDataKeys(prefix, state.scan);
-    state = { ...state, scan: page.cursor, keys: page.keys, scanned: true };
+    if (!saved) throw new McpCursorError("CURSOR_EXPIRED");
+    if (saved.binding !== binding) throw new McpCursorError("CURSOR_MISMATCH");
+    state = structuredClone(saved);
   }
-  if (!state.values.length && state.keys.length) {
-    const key = state.keys[0];
-    if (kind === "orders") {
-      state.keys.shift();
-      if (!key.slice(prefix.length).startsWith("days:"))
+  const items = [];
+  let storageReads = 0;
+  let inspected = 0;
+  let responseBytes = 0;
+  while (items.length < limit && storageReads < 40 && inspected < 1e3) {
+    if (!state.values.length) {
+      if (!state.keys.length) {
+        if (state.scanned && state.scan === "0") break;
+        const page = await scanDataKeys(prefix, state.scan);
+        storageReads++;
+        state.scan = page.cursor;
+        state.scanned = true;
+        state.keys = page.keys.filter((key2) => {
+          if (kind === "orders")
+            return !key2.slice(prefix.length).startsWith("days:");
+          const suffix = key2.slice(prefix.length);
+          const day = suffix.slice(0, 10);
+          return day >= getRuntimeStorageDayKey(request.startTime) && day <= getRuntimeStorageDayKey(request.endTime - 1) && (!request.strategy || suffix.slice(11) === request.strategy);
+        });
+        if (!state.keys.length) continue;
+      }
+      const key = state.keys[0];
+      storageReads++;
+      if (kind === "orders") {
+        state.keys.shift();
         state.values = [await getDataStrict2(key)];
-    } else {
-      const page = await scanHashJson(key, state.hash);
-      state.values = page.values;
-      state.hash = page.cursor;
-      if (page.cursor === "0") state.keys.shift();
+      } else {
+        const page = await scanHashJson(key, state.hash);
+        state.values = page.values;
+        state.hash = page.cursor;
+        if (page.cursor === "0") state.keys.shift();
+      }
+      if (!state.values.length) continue;
     }
-  }
-  const items = [];
-  for (let row of state.values.splice(0, 50)) {
+    let row = state.values.shift();
+    inspected++;
     if (kind === "signals" && isMcpRecord(row) && typeof row.symbol === "string" && typeof row.signalId === "string")
       row = await getDataStrict2(
         redisKeys2.storeSignal(row.symbol, row.signalId)
@@ -464,12 +504,23 @@ var readMcpRuntimePage = async (userName, kind, request) => {
       additionalIndicators: _additional,
       ...summary
     } = row;
+    const bytes = Buffer.byteLength(JSON.stringify(summary));
+    if (bytes > 8e4)
+      throw new Error(
+        "Response too large. Use runtime_get_signal for record details."
+      );
+    if (responseBytes + bytes > 8e4) {
+      state.values.unshift(row);
+      break;
+    }
+    responseBytes += bytes;
     items.push(summary);
   }
   let next = "0";
   if (state.values.length || state.keys.length || state.scan !== "0") {
-    next = mcpId(randomUUID());
-    await mcpStorage2.put(`cursor:${next}`, state, 600);
+    next = mcpId(JSON.stringify(state));
+    if (!await mcpStorage2.put(`cursor:${next}`, state, RUNTIME_CURSOR_TTL))
+      throw new Error("MCP cursor persistence failed");
   }
   return {
     items,
@@ -479,7 +530,17 @@ var readMcpRuntimePage = async (userName, kind, request) => {
     source: "runtime_storage",
     window: { startTime: request.startTime, endTime: request.endTime },
     coverage: "stored_records_only",
-    note: "Missing records do not prove no evaluation occurred. Continue until cursor is 0; cursors expire after 10 minutes."
+    pagination: {
+      scanComplete: next === "0",
+      storageReads,
+      inspected,
+      cursorTtlSeconds: RUNTIME_CURSOR_TTL,
+      consistency: "mutable_storage_scan",
+      order: "storage_scan",
+      retentionStartTime: null,
+      persistenceCompleteness: "unknown"
+    },
+    note: "Continue until cursor=0, including empty pages. Cursors are shared across server processes and retained for 24 hours. Retry identical requests after transport failures. If CURSOR_EXPIRED, restart the same window and deduplicate record identities. Storage scans may repeat rows and are not immutable snapshots; missing records do not prove no activity."
   };
 };
 var readMcpSignal = async (userName, signalId, deploymentId, timestamp, strategy) => {
@@ -598,6 +659,7 @@ var readMcpBacktestResult = async (userName, id, offset = 0, limit = 20) => {
 };
 export {
   MCP_JOB_TTL,
+  McpCursorError,
   cancelMcpJob,
   enqueueMcpJob,
   isMcpRecord,
@@ -620,5 +682,6 @@ export {
   readMcpSignal,
   readMcpStrategies,
   redactMcpData,
+  redactMcpJobLog,
   requireMcpDeployment
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tradejs/node",
-  "version": "3.1.29-beta.272",
+  "version": "3.1.29-beta.275",
   "description": "Node-only runtime for the TradeJS TypeScript framework: strategies, backtests, Pine strategy loading, and plugin registries.",
   "keywords": [
     "tradejs",
@@ -105,9 +105,9 @@
   "dependencies": {
     "@langchain/core": "^1.2.3",
     "@langchain/openai": "^1.5.5",
-    "@tradejs/core": "^3.1.29-beta.272",
-    "@tradejs/infra": "^3.1.29-beta.272",
-    "@tradejs/types": "^3.1.29-beta.272",
+    "@tradejs/core": "^3.1.29-beta.275",
+    "@tradejs/infra": "^3.1.29-beta.275",
+    "@tradejs/types": "^3.1.29-beta.275",
     "@types/node": "^24",
     "chalk": "4.1.2",
     "ioredis": "5.11.1",
@@ -120,7 +120,7 @@
     "typescript": "^5.9"
   },
   "devDependencies": {
-    "@tradejs/indicators": "^3.1.29-beta.272",
+    "@tradejs/indicators": "^3.1.29-beta.275",
     "@tradejs/strategy-adaptive-momentum-ribbon": "3.0.5",
     "@tradejs/strategy-hyperliquid-consensus": "3.0.5",
     "@tradejs/strategy-kit": "3.0.6",