@cyanheads/secedgar-mcp-server 0.15.13 → 0.15.15

package/dist/services/edgar/submissions-archive.d.ts

@@ -7,6 +7,7 @@
  * the scan reached and whether pages it selected went unread.
  * @module services/edgar/submissions-archive
  */
+import type { CallScope } from './call-scope.js';
 import type { FilingsRecent, SubmissionsResponse } from './types.js';
 /**
  * Most archive pages one call reads. A page runs 200–360 KB and costs one request
@@ -18,7 +19,7 @@ export declare const ARCHIVE_PAGE_SCAN_CAP = 10;
 export type ArchivePageEntry = SubmissionsResponse['filings']['files'][number];
 /** Where pages are read from — `EdgarApiService`, whose page cache and pacer every read goes through. */
 export interface ArchivePageSource {
-    fetchArchivePage(name: string): Promise<FilingsRecent>;
+    fetchArchivePage(name: string, scope: CallScope): Promise<FilingsRecent>;
 }
 /** Which pages a walk selects and the order it reads them in. */
 export interface ArchiveWalkOptions {
@@ -59,14 +60,16 @@ export declare function selectArchivePages(files: readonly ArchivePageEntry[], o
  * filing dated on or after that day.
  *
  * Iterate it with `for await`; breaking out after any page ends the walk there.
- * Afterwards `scannedThrough` and `truncated` describe what was read.
+ * Afterwards `scannedThrough` and `truncated` describe what was read. Every page
+ * is read under the calling tool's `scope`, so a cancel ends the walk (#179).
  */
 export declare class SubmissionsArchiveWalk implements AsyncIterable<ArchivePageRead> {
     private readonly source;
+    private readonly scope;
     private readonly pages;
     private read;
     private oldestRead;
-    constructor(source: ArchivePageSource, submissions: SubmissionsResponse, options: ArchiveWalkOptions);
+    constructor(source: ArchivePageSource, submissions: SubmissionsResponse, options: ArchiveWalkOptions, scope: CallScope);
     /** Pages read so far. */
     get pagesRead(): number;
     /** Oldest filing date the pages read so far reach (their earliest `filingFrom`). Undefined before any read. */

package/dist/services/edgar/submissions-archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submissions-archive.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/submissions-archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,yGAAyG;AACzG,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACxD;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;;OAKG;IACH,KAAK,EAAE,cAAc,GAAG,cAAc,CAAC;CACxC;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AASD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAClC,OAAO,EAAE,kBAAkB,GAC1B,gBAAgB,EAAE,CAUpB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,YAAW,aAAa,CAAC,eAAe,CAAC;IAMzE,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,UAAU,CAAqB;IAEvC,YACmB,MAAM,EAAE,iBAAiB,EAC1C,WAAW,EAAE,mBAAmB,EAChC,OAAO,EAAE,kBAAkB,EAO5B;IAED,yBAAyB;IACzB,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,+GAA+G;IAC/G,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAEvC;IAED,wGAAwG;IACxG,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,eAAe,CAAC,CAS/D;CACF"}
+{"version":3,"file":"submissions-archive.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/submissions-archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,yGAAyG;AACzG,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC1E;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;;OAKG;IACH,KAAK,EAAE,cAAc,GAAG,cAAc,CAAC;CACxC;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AASD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAClC,OAAO,EAAE,kBAAkB,GAC1B,gBAAgB,EAAE,CAUpB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,YAAW,aAAa,CAAC,eAAe,CAAC;IAMzE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAGvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IARxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,UAAU,CAAqB;IAEvC,YACmB,MAAM,EAAE,iBAAiB,EAC1C,WAAW,EAAE,mBAAmB,EAChC,OAAO,EAAE,kBAAkB,EACV,KAAK,EAAE,SAAS,EAOlC;IAED,yBAAyB;IACzB,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,+GAA+G;IAC/G,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAEvC;IAED,wGAAwG;IACxG,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,eAAe,CAAC,CAS/D;CACF"}

package/dist/services/edgar/submissions-archive.js

@@ -47,15 +47,18 @@ export function selectArchivePages(files, options) {
  * filing dated on or after that day.
  *
  * Iterate it with `for await`; breaking out after any page ends the walk there.
- * Afterwards `scannedThrough` and `truncated` describe what was read.
+ * Afterwards `scannedThrough` and `truncated` describe what was read. Every page
+ * is read under the calling tool's `scope`, so a cancel ends the walk (#179).
  */
 export class SubmissionsArchiveWalk {
     source;
+    scope;
     pages;
     read = 0;
     oldestRead;
-    constructor(source, submissions, options) {
+    constructor(source, submissions, options, scope) {
         this.source = source;
+        this.scope = scope;
         const recentOldest = submissions.filings.recent.filingDate.at(-1);
         const coveredByRecent = Boolean(options.filedAfter && recentOldest && options.filedAfter >= recentOldest);
         this.pages = coveredByRecent ? [] : selectArchivePages(submissions.filings.files, options);
@@ -76,7 +79,7 @@ export class SubmissionsArchiveWalk {
         const limit = Math.min(this.pages.length, ARCHIVE_PAGE_SCAN_CAP);
         while (this.read < limit) {
             const page = this.pages[this.read];
-            const block = await this.source.fetchArchivePage(page.name);
+            const block = await this.source.fetchArchivePage(page.name, this.scope);
             this.read++;
             if (!this.oldestRead || page.filingFrom < this.oldestRead)
                 this.oldestRead = page.filingFrom;

package/dist/services/edgar/submissions-archive.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/secedgar-mcp-server",
-  "version": "0.15.13",
+  "version": "0.15.15",
   "description": "Query SEC EDGAR filings, XBRL financials, and company data via MCP. STDIO or Streamable HTTP.",
   "mcpName": "io.github.cyanheads/secedgar-mcp-server",
   "type": "module",
@@ -91,13 +91,13 @@
     "bun": ">=1.4.0",
     "node": ">=24.0.0"
   },
-  "packageManager": "bun@1.4.3",
+  "packageManager": "bun@1.4.4",
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
     "@cyanheads/mcp-ts-core": "^0.13.15",
-    "@duckdb/node-api": "^1.5.6-r.1",
+    "@duckdb/node-api": "^1.5.6-r.2",
     "better-sqlite3": "^13.0.3",
     "domhandler": "^6.0.1",
     "domutils": "^4.0.2",
@@ -109,13 +109,13 @@
     "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.15",
+    "@biomejs/biome": "^2.6.2",
     "@socketsecurity/bun-security-scanner": "^1.1.3",
     "@types/html-to-text": "^9.0.4",
     "@types/node": "^26.6.5",
     "depcheck": "^1.4.7",
-    "ignore": "^7.0.12",
-    "tsc-alias": "^1.9.7",
+    "ignore": "^7.0.13",
+    "tsc-alias": "^1.9.8",
     "typescript": "^7.0.2",
     "vitest": "^5.0.5"
   },

package/server.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/cyanheads/secedgar-mcp-server",
     "source": "github"
   },
-  "version": "0.15.13",
+  "version": "0.15.15",
   "remotes": [
     {
       "type": "streamable-http",
@@ -19,7 +19,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/secedgar-mcp-server",
       "runtimeHint": "npx",
-      "version": "0.15.13",
+      "version": "0.15.15",
       "environmentVariables": [
         {
           "name": "EDGAR_USER_AGENT",
@@ -51,7 +51,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/secedgar-mcp-server",
       "runtimeHint": "npx",
-      "version": "0.15.13",
+      "version": "0.15.15",
       "environmentVariables": [
         {
           "name": "EDGAR_USER_AGENT",