@cyanheads/secedgar-mcp-server 0.17.0 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/AGENTS.md +22 -16
  2. package/CLAUDE.md +22 -16
  3. package/README.md +14 -10
  4. package/changelog/0.17.x/0.17.1.md +36 -0
  5. package/changelog/0.18.x/0.18.0.md +16 -0
  6. package/dist/config/server-config.js +1 -1
  7. package/dist/config/server-config.js.map +1 -1
  8. package/dist/index.js +2 -1
  9. package/dist/index.js.map +1 -1
  10. package/dist/mcp-server/tools/ambiguous-matches.d.ts +20 -0
  11. package/dist/mcp-server/tools/ambiguous-matches.d.ts.map +1 -0
  12. package/dist/mcp-server/tools/ambiguous-matches.js +22 -0
  13. package/dist/mcp-server/tools/ambiguous-matches.js.map +1 -0
  14. package/dist/mcp-server/tools/definitions/company-search.tool.d.ts.map +1 -1
  15. package/dist/mcp-server/tools/definitions/company-search.tool.js +15 -8
  16. package/dist/mcp-server/tools/definitions/company-search.tool.js.map +1 -1
  17. package/dist/mcp-server/tools/definitions/compare-companies.tool.d.ts +8 -4
  18. package/dist/mcp-server/tools/definitions/compare-companies.tool.d.ts.map +1 -1
  19. package/dist/mcp-server/tools/definitions/compare-companies.tool.js +182 -45
  20. package/dist/mcp-server/tools/definitions/compare-companies.tool.js.map +1 -1
  21. package/dist/mcp-server/tools/definitions/dataframe-describe.tool.d.ts.map +1 -1
  22. package/dist/mcp-server/tools/definitions/dataframe-describe.tool.js +10 -2
  23. package/dist/mcp-server/tools/definitions/dataframe-describe.tool.js.map +1 -1
  24. package/dist/mcp-server/tools/definitions/dataframe-drop.tool.d.ts.map +1 -1
  25. package/dist/mcp-server/tools/definitions/dataframe-drop.tool.js +6 -6
  26. package/dist/mcp-server/tools/definitions/dataframe-drop.tool.js.map +1 -1
  27. package/dist/mcp-server/tools/definitions/dataframe-query.tool.d.ts.map +1 -1
  28. package/dist/mcp-server/tools/definitions/dataframe-query.tool.js +10 -10
  29. package/dist/mcp-server/tools/definitions/dataframe-query.tool.js.map +1 -1
  30. package/dist/mcp-server/tools/definitions/fetch-frames.tool.d.ts +4 -4
  31. package/dist/mcp-server/tools/definitions/fetch-frames.tool.d.ts.map +1 -1
  32. package/dist/mcp-server/tools/definitions/fetch-frames.tool.js +36 -15
  33. package/dist/mcp-server/tools/definitions/fetch-frames.tool.js.map +1 -1
  34. package/dist/mcp-server/tools/definitions/find-holders.tool.d.ts +14 -0
  35. package/dist/mcp-server/tools/definitions/find-holders.tool.d.ts.map +1 -1
  36. package/dist/mcp-server/tools/definitions/find-holders.tool.js +80 -16
  37. package/dist/mcp-server/tools/definitions/find-holders.tool.js.map +1 -1
  38. package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.d.ts +2 -0
  39. package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.d.ts.map +1 -1
  40. package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.js +147 -77
  41. package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.js.map +1 -1
  42. package/dist/mcp-server/tools/definitions/get-filing.tool.d.ts +4 -4
  43. package/dist/mcp-server/tools/definitions/get-filing.tool.d.ts.map +1 -1
  44. package/dist/mcp-server/tools/definitions/get-filing.tool.js +321 -90
  45. package/dist/mcp-server/tools/definitions/get-filing.tool.js.map +1 -1
  46. package/dist/mcp-server/tools/definitions/get-financials.tool.d.ts.map +1 -1
  47. package/dist/mcp-server/tools/definitions/get-financials.tool.js +19 -21
  48. package/dist/mcp-server/tools/definitions/get-financials.tool.js.map +1 -1
  49. package/dist/mcp-server/tools/definitions/get-fund-holdings.tool.d.ts.map +1 -1
  50. package/dist/mcp-server/tools/definitions/get-fund-holdings.tool.js +11 -19
  51. package/dist/mcp-server/tools/definitions/get-fund-holdings.tool.js.map +1 -1
  52. package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.d.ts +10 -0
  53. package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.d.ts.map +1 -1
  54. package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.js +23 -9
  55. package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.js.map +1 -1
  56. package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.d.ts +14 -0
  57. package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.d.ts.map +1 -1
  58. package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.js +16 -14
  59. package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.js.map +1 -1
  60. package/dist/mcp-server/tools/definitions/get-material-events.tool.d.ts.map +1 -1
  61. package/dist/mcp-server/tools/definitions/get-material-events.tool.js +9 -5
  62. package/dist/mcp-server/tools/definitions/get-material-events.tool.js.map +1 -1
  63. package/dist/mcp-server/tools/definitions/get-snapshot.tool.d.ts.map +1 -1
  64. package/dist/mcp-server/tools/definitions/get-snapshot.tool.js +11 -8
  65. package/dist/mcp-server/tools/definitions/get-snapshot.tool.js.map +1 -1
  66. package/dist/mcp-server/tools/definitions/index.d.ts +635 -594
  67. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  68. package/dist/mcp-server/tools/definitions/search-concepts.tool.js +2 -2
  69. package/dist/mcp-server/tools/definitions/search-concepts.tool.js.map +1 -1
  70. package/dist/mcp-server/tools/definitions/search-filings.tool.d.ts +45 -0
  71. package/dist/mcp-server/tools/definitions/search-filings.tool.d.ts.map +1 -1
  72. package/dist/mcp-server/tools/definitions/search-filings.tool.js +64 -12
  73. package/dist/mcp-server/tools/definitions/search-filings.tool.js.map +1 -1
  74. package/dist/mcp-server/tools/escape-inline.d.ts +35 -0
  75. package/dist/mcp-server/tools/escape-inline.d.ts.map +1 -0
  76. package/dist/mcp-server/tools/escape-inline.js +51 -0
  77. package/dist/mcp-server/tools/escape-inline.js.map +1 -0
  78. package/dist/mcp-server/tools/format-usd.d.ts +22 -0
  79. package/dist/mcp-server/tools/format-usd.d.ts.map +1 -0
  80. package/dist/mcp-server/tools/format-usd.js +53 -0
  81. package/dist/mcp-server/tools/format-usd.js.map +1 -0
  82. package/dist/mcp-server/tools/limit-clamp.d.ts +50 -18
  83. package/dist/mcp-server/tools/limit-clamp.d.ts.map +1 -1
  84. package/dist/mcp-server/tools/limit-clamp.js +51 -15
  85. package/dist/mcp-server/tools/limit-clamp.js.map +1 -1
  86. package/dist/services/edgar/edgar-api-service.d.ts +96 -11
  87. package/dist/services/edgar/edgar-api-service.d.ts.map +1 -1
  88. package/dist/services/edgar/edgar-api-service.js +333 -50
  89. package/dist/services/edgar/edgar-api-service.js.map +1 -1
  90. package/dist/services/edgar/filing-to-text.d.ts +4 -3
  91. package/dist/services/edgar/filing-to-text.d.ts.map +1 -1
  92. package/dist/services/edgar/filing-to-text.js +12 -0
  93. package/dist/services/edgar/filing-to-text.js.map +1 -1
  94. package/package.json +4 -4
  95. package/server.json +3 -3
  96. package/skills/secedgar-guide/SKILL.md +1 -0
@@ -0,0 +1,22 @@
1
+ /**
2
+ * @fileoverview USD amounts and other reported quantities as `content[]` text: a USD amount
3
+ * scaled by its own magnitude so a non-zero amount never reads as zero, a per-share amount and
4
+ * an exact amount to every digit, the sign before the `$`.
5
+ * @module mcp-server/tools/format-usd
6
+ */
7
+ /**
8
+ * A number's every digit (`fixedPoint`), its integer part grouped in threes:
9
+ * `-1234567.0004` → `-1,234,567.0004`, `0.0004` → `0.0004`.
10
+ */
11
+ export declare function groupedDigits(value: number): string;
12
+ /**
13
+ * A USD amount, its sign before the `$`.
14
+ * - `scaled` (default): T, B, M, or K chosen by absolute value, two decimals (`42538` →
15
+ * `$42.54K`, `-2.5e9` → `-$2.50B`); under $1K every digit with at least two decimals
16
+ * (`0.004` → `$0.004`, `0` → `$0.00`).
17
+ * - `per-share`: never scaled, every digit with at least two decimals (`6.1` → `$6.10`).
18
+ * - `exact`: every digit, integer part grouped (`-375000` → `-$375,000`) — the exact amount
19
+ * printed beside a scaled one.
20
+ */
21
+ export declare function formatUsd(value: number, style?: 'scaled' | 'per-share' | 'exact'): string;
22
+ //# sourceMappingURL=format-usd.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format-usd.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/format-usd.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,QAAQ,GAAG,WAAW,GAAG,OAAkB,GACjD,MAAM,CAiBR"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * @fileoverview USD amounts and other reported quantities as `content[]` text: a USD amount
3
+ * scaled by its own magnitude so a non-zero amount never reads as zero, a per-share amount and
4
+ * an exact amount to every digit, the sign before the `$`.
5
+ * @module mcp-server/tools/format-usd
6
+ */
7
+ import { fixedPoint } from './fixed-point.js';
8
+ /** Each scale's divisor and suffix, largest first. */
9
+ const SCALES = [
10
+ [1e12, 'T'],
11
+ [1e9, 'B'],
12
+ [1e6, 'M'],
13
+ [1e3, 'K'],
14
+ ];
15
+ /**
16
+ * A number's every digit (`fixedPoint`), its integer part grouped in threes:
17
+ * `-1234567.0004` → `-1,234,567.0004`, `0.0004` → `0.0004`.
18
+ */
19
+ export function groupedDigits(value) {
20
+ const digits = fixedPoint(Math.abs(value));
21
+ const dotAt = digits.indexOf('.');
22
+ const whole = BigInt(dotAt === -1 ? digits : digits.slice(0, dotAt)).toLocaleString('en-US');
23
+ return `${value < 0 ? '-' : ''}${whole}${dotAt === -1 ? '' : digits.slice(dotAt)}`;
24
+ }
25
+ /**
26
+ * A USD amount, its sign before the `$`.
27
+ * - `scaled` (default): T, B, M, or K chosen by absolute value, two decimals (`42538` →
28
+ * `$42.54K`, `-2.5e9` → `-$2.50B`); under $1K every digit with at least two decimals
29
+ * (`0.004` → `$0.004`, `0` → `$0.00`).
30
+ * - `per-share`: never scaled, every digit with at least two decimals (`6.1` → `$6.10`).
31
+ * - `exact`: every digit, integer part grouped (`-375000` → `-$375,000`) — the exact amount
32
+ * printed beside a scaled one.
33
+ */
34
+ export function formatUsd(value, style = 'scaled') {
35
+ const sign = value < 0 ? '-' : '';
36
+ const magnitude = Math.abs(value);
37
+ if (style === 'exact')
38
+ return `${sign}$${groupedDigits(magnitude)}`;
39
+ if (style === 'scaled') {
40
+ let above;
41
+ for (const [divisor, suffix] of SCALES) {
42
+ if (magnitude >= divisor) {
43
+ const figure = (magnitude / divisor).toFixed(2);
44
+ // Two-decimal rounding can carry a figure to 1000 of its scale (999999 → 1000.00K),
45
+ // which the scale above reads as 1.00. T has no scale above and keeps its thousands.
46
+ return `${sign}$${figure === '1000.00' && above ? `1.00${above}` : `${figure}${suffix}`}`;
47
+ }
48
+ above = suffix;
49
+ }
50
+ }
51
+ return `${sign}$${fixedPoint(magnitude, 2)}`;
52
+ }
53
+ //# sourceMappingURL=format-usd.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format-usd.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/format-usd.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAE/D,sDAAsD;AACtD,MAAM,MAAM,GAAG;IACb,CAAC,IAAI,EAAE,GAAG,CAAC;IACX,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;IACV,CAAC,GAAG,EAAE,GAAG,CAAC;CACF,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC7F,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AACrF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CACvB,KAAa,EACb,KAAK,GAAqC,QAAQ;IAElD,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;IACpE,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,IAAI,KAAyB,CAAC;QAC9B,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvC,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAChD,oFAAoF;gBACpF,qFAAqF;gBACrF,OAAO,GAAG,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC5F,CAAC;YACD,KAAK,GAAG,MAAM,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,IAAI,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC"}
@@ -1,24 +1,27 @@
1
1
  /**
2
- * @fileoverview Serving an over-cap numeric input at its cap (#197). A count or
3
- * size input above the cap its handler applies returns exactly what the call at
4
- * the cap returns, so rejecting it only costs the caller a retry.
2
+ * @fileoverview Serving an over-cap input at its cap. A count or size input
3
+ * above the cap its handler applies returns exactly what the call at the cap
4
+ * returns (#197), and an ID batch longer than its cap answers up to the cap and
5
+ * names the rest (#201), so rejecting either only costs the caller a retry.
5
6
  *
6
7
  * One switch, `EDGAR_CLAMP_OVERSIZED_LIMITS` (default on), governs every field
7
8
  * built here:
8
9
  *
9
- * | Switch | Value | Schema | Handler reads | Log line + counter |
10
- * |:-------|:------|:-------|:--------------|:-------------------|
11
- * | on | at most `cap` | accepted | the value | none |
12
- * | on | above `cap`, at most `bound` | accepted | `cap` | one each |
10
+ * | Switch | Value or list | Schema | Handler reads | Log line + counter |
11
+ * |:-------|:--------------|:-------|:--------------|:-------------------|
12
+ * | on | at most `cap` | accepted | all of it | none |
13
+ * | on | above `cap`, at most `bound` | accepted | `cap` (a list: up to `cap`, the rest deferred) | one each |
13
14
  * | on | above `bound` | rejected | — | — |
14
- * | off | at most `cap` | accepted | the value | none |
15
- * | off | above `cap` | rejected (`maximum` is `cap`) | — | — |
15
+ * | off | at most `cap` | accepted | all of it | none |
16
+ * | off | above `cap` | rejected (`maximum` / `maxItems` is `cap`) | — | — |
16
17
  *
17
18
  * The handler is the same in both modes: switched off, the schema rejects every
18
- * value `apply()` would cut, so only the advertised and validated bound changes.
19
- * A clamped call carries no notice of its own — the result must equal the call
20
- * at the cap — and reports the applied value wherever the tool already reports
21
- * its cap (`cap`, the page it returns, its continuation).
19
+ * value `apply()` would cut and every list that would defer anything, so only
20
+ * the advertised and validated bound changes. A clamped number carries no notice
21
+ * of its own — the result must equal the call at the cap — and reports the
22
+ * applied value wherever the tool already reports its cap (`cap`, the page it
23
+ * returns, its continuation). A deferred list is the exception: its tool returns
24
+ * the deferred items as supplied and says how to re-call with them.
22
25
  *
23
26
  * @module mcp-server/tools/limit-clamp
24
27
  */
@@ -27,17 +30,29 @@ import { type Context, z } from '@cyanheads/mcp-ts-core';
27
30
  export interface LimitClampOptions {
28
31
  clampOversizedLimits: boolean;
29
32
  }
33
+ /** An input whose advertised bound the switch picks; {@link withLimitClamps} rebuilds it. */
34
+ export interface ClampedField<S extends z.ZodType = z.ZodType> {
35
+ readonly field: string;
36
+ /** The field's schema: its maximum is `bound` when clamping, else `cap`. */
37
+ schema(clampOversizedLimits: boolean): S;
38
+ }
30
39
  /** One numeric input served at its cap. */
31
- export interface LimitClamp<S extends z.ZodType> {
40
+ export interface LimitClamp<S extends z.ZodType> extends ClampedField<S> {
32
41
  /**
33
42
  * The value every handler read uses: `min(value, cap)`. A clamp writes one
34
43
  * `ctx.log` line and adds 1 to `secedgar.input.clamped`, tagged with tool and
35
44
  * field. An omitted optional value passes through.
36
45
  */
37
46
  apply<V extends number | undefined>(value: V, ctx: Context): V;
38
- readonly field: string;
39
- /** The field's schema: `maximum` is `bound` when clamping, else `cap`. */
40
- schema(clampOversizedLimits: boolean): S;
47
+ }
48
+ /** One list input answered up to its cap, the rest returned unread (#201). */
49
+ export interface BatchClamp extends ClampedField<z.ZodArray<z.ZodString>> {
50
+ /**
51
+ * Record the items the handler left past the cap. When there are any, writes
52
+ * one `ctx.log` line and adds 1 to `secedgar.input.clamped`, tagged with tool
53
+ * and field; an empty list records nothing.
54
+ */
55
+ defer(deferred: readonly string[], ctx: Context): void;
41
56
  }
42
57
  /**
43
58
  * Define a clamped numeric input. `shape` adds the field's default or optional
@@ -53,6 +68,23 @@ export declare function limitClamp<S extends z.ZodType>(spec: {
53
68
  shape: (bounded: z.ZodNumber) => S;
54
69
  description: string;
55
70
  }): LimitClamp<S>;
71
+ /**
72
+ * Define a list input answered up to its cap. Which items fill the cap is the
73
+ * handler's call (the first `cap` as given, or the first `cap` distinct), so it
74
+ * passes the rest to `defer()`. `description` is the field's own text; switched
75
+ * on, `overCap` follows it to say what a longer list returns, and switched off,
76
+ * the cap sentence does.
77
+ */
78
+ export declare function batchClamp(spec: {
79
+ tool: string;
80
+ field: string;
81
+ item: z.ZodString;
82
+ min: number;
83
+ cap: number;
84
+ bound: number;
85
+ description: string;
86
+ overCap: string;
87
+ }): BatchClamp;
56
88
  /**
57
89
  * The definition to register for this deployment. Switched on, the definition
58
90
  * as built (its clamped fields take `schema(true)`); off, the same definition
@@ -61,5 +93,5 @@ export declare function limitClamp<S extends z.ZodType>(spec: {
61
93
  export declare function withLimitClamps<D extends {
62
94
  name: string;
63
95
  input: z.ZodObject;
64
- }>(definition: D, clamps: readonly LimitClamp<z.ZodType>[], { clampOversizedLimits }: LimitClampOptions): D;
96
+ }>(definition: D, clamps: readonly ClampedField[], { clampOversizedLimits }: LimitClampOptions): D;
65
97
  //# sourceMappingURL=limit-clamp.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"limit-clamp.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/limit-clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG/D,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAQD,2CAA2C;AAC3C,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;IAC7C;;;;OAIG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,MAAM,CAAC,oBAAoB,EAAE,OAAO,GAAG,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,UAAU,CAAC,CAAC,CAAC,CAiChB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAA;CAAE,EAC5E,UAAU,EAAE,CAAC,EACb,MAAM,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EACxC,EAAE,oBAAoB,EAAE,EAAE,iBAAiB,GAC1C,CAAC,CAQH"}
1
+ {"version":3,"file":"limit-clamp.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/limit-clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG/D,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAkBD,6FAA6F;AAC7F,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,MAAM,CAAC,oBAAoB,EAAE,OAAO,GAAG,CAAC,CAAC;CAC1C;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IACtE;;;;OAIG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC;CAChE;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAW,SAAQ,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACvE;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,UAAU,CAAC,CAAC,CAAC,CA4BhB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,UAAU,CAuBb;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAA;CAAE,EAC5E,UAAU,EAAE,CAAC,EACb,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,EAAE,oBAAoB,EAAE,EAAE,iBAAiB,GAC1C,CAAC,CAQH"}
@@ -1,24 +1,27 @@
1
1
  /**
2
- * @fileoverview Serving an over-cap numeric input at its cap (#197). A count or
3
- * size input above the cap its handler applies returns exactly what the call at
4
- * the cap returns, so rejecting it only costs the caller a retry.
2
+ * @fileoverview Serving an over-cap input at its cap. A count or size input
3
+ * above the cap its handler applies returns exactly what the call at the cap
4
+ * returns (#197), and an ID batch longer than its cap answers up to the cap and
5
+ * names the rest (#201), so rejecting either only costs the caller a retry.
5
6
  *
6
7
  * One switch, `EDGAR_CLAMP_OVERSIZED_LIMITS` (default on), governs every field
7
8
  * built here:
8
9
  *
9
- * | Switch | Value | Schema | Handler reads | Log line + counter |
10
- * |:-------|:------|:-------|:--------------|:-------------------|
11
- * | on | at most `cap` | accepted | the value | none |
12
- * | on | above `cap`, at most `bound` | accepted | `cap` | one each |
10
+ * | Switch | Value or list | Schema | Handler reads | Log line + counter |
11
+ * |:-------|:--------------|:-------|:--------------|:-------------------|
12
+ * | on | at most `cap` | accepted | all of it | none |
13
+ * | on | above `cap`, at most `bound` | accepted | `cap` (a list: up to `cap`, the rest deferred) | one each |
13
14
  * | on | above `bound` | rejected | — | — |
14
- * | off | at most `cap` | accepted | the value | none |
15
- * | off | above `cap` | rejected (`maximum` is `cap`) | — | — |
15
+ * | off | at most `cap` | accepted | all of it | none |
16
+ * | off | above `cap` | rejected (`maximum` / `maxItems` is `cap`) | — | — |
16
17
  *
17
18
  * The handler is the same in both modes: switched off, the schema rejects every
18
- * value `apply()` would cut, so only the advertised and validated bound changes.
19
- * A clamped call carries no notice of its own — the result must equal the call
20
- * at the cap — and reports the applied value wherever the tool already reports
21
- * its cap (`cap`, the page it returns, its continuation).
19
+ * value `apply()` would cut and every list that would defer anything, so only
20
+ * the advertised and validated bound changes. A clamped number carries no notice
21
+ * of its own — the result must equal the call at the cap — and reports the
22
+ * applied value wherever the tool already reports its cap (`cap`, the page it
23
+ * returns, its continuation). A deferred list is the exception: its tool returns
24
+ * the deferred items as supplied and says how to re-call with them.
22
25
  *
23
26
  * @module mcp-server/tools/limit-clamp
24
27
  */
@@ -29,6 +32,11 @@ import { ATTR_MCP_TOOL_NAME, createCounter } from '@cyanheads/mcp-ts-core/utils'
29
32
  * the OTel no-op meter before the SDK registers its provider, and stays a no-op.
30
33
  */
31
34
  let clampedCalls;
35
+ /** Add 1 to `secedgar.input.clamped`, tagged with tool and field. */
36
+ function countClamp(toolName, field) {
37
+ clampedCalls ??= createCounter('secedgar.input.clamped', 'Calls whose numeric input exceeded its cap and was served at the cap, or whose list exceeded its cap and was answered up to it, counted once per field', '{calls}');
38
+ clampedCalls.add(1, { [ATTR_MCP_TOOL_NAME]: toolName, 'secedgar.input.field': field });
39
+ }
32
40
  /**
33
41
  * Define a clamped numeric input. `shape` adds the field's default or optional
34
42
  * marker; `description` is the field's own text, to which the cap sentence for
@@ -54,12 +62,40 @@ export function limitClamp(spec) {
54
62
  requested: value,
55
63
  applied: cap,
56
64
  });
57
- clampedCalls ??= createCounter('secedgar.input.clamped', 'Calls whose numeric input exceeded its cap and was served at the cap', '{calls}');
58
- clampedCalls.add(1, { [ATTR_MCP_TOOL_NAME]: toolName, 'secedgar.input.field': field });
65
+ countClamp(toolName, field);
59
66
  return cap;
60
67
  },
61
68
  };
62
69
  }
70
+ /**
71
+ * Define a list input answered up to its cap. Which items fill the cap is the
72
+ * handler's call (the first `cap` as given, or the first `cap` distinct), so it
73
+ * passes the rest to `defer()`. `description` is the field's own text; switched
74
+ * on, `overCap` follows it to say what a longer list returns, and switched off,
75
+ * the cap sentence does.
76
+ */
77
+ export function batchClamp(spec) {
78
+ const { tool: toolName, field, item, min, cap, bound, description, overCap } = spec;
79
+ return {
80
+ field,
81
+ schema: (clampOversizedLimits) => z
82
+ .array(item)
83
+ .min(min)
84
+ .max(clampOversizedLimits ? bound : cap)
85
+ .describe(clampOversizedLimits ? `${description} ${overCap}` : `${description} At most ${cap}.`),
86
+ defer(deferred, ctx) {
87
+ if (deferred.length === 0)
88
+ return;
89
+ ctx.log.info('List above its cap answered up to the cap, the rest deferred', {
90
+ tool: toolName,
91
+ field,
92
+ cap,
93
+ deferred: deferred.length,
94
+ });
95
+ countClamp(toolName, field);
96
+ },
97
+ };
98
+ }
63
99
  /**
64
100
  * The definition to register for this deployment. Switched on, the definition
65
101
  * as built (its clamped fields take `schema(true)`); off, the same definition
@@ -1 +1 @@
1
- {"version":3,"file":"limit-clamp.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/limit-clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAgB,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAOjF;;;GAGG;AACH,IAAI,YAA0D,CAAC;AAe/D;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAsB,IAQ/C;IACC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC5E,OAAO;QACL,KAAK;QACL,MAAM,EAAE,CAAC,oBAAoB,EAAE,EAAE,CAC/B,KAAK,CACH,CAAC;aACE,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,GAAG,CAAC;aACR,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAC3C,CAAC,QAAQ,CACR,oBAAoB;YAClB,CAAC,CAAC,GAAG,WAAW,cAAc,GAAG,2BAA2B,KAAK,kBAAkB,GAAG,WAAW;YACjG,CAAC,CAAC,GAAG,WAAW,YAAY,GAAG,GAAG,CACrC;QACH,KAAK,CAA+B,KAAQ,EAAE,GAAY;YACxD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,IAAI,GAAG;gBAAE,OAAO,KAAK,CAAC;YACtD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,+CAA+C,EAAE;gBAC5D,IAAI,EAAE,QAAQ;gBACd,KAAK;gBACL,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,GAAG;aACb,CAAC,CAAC;YACH,YAAY,KAAK,aAAa,CAC5B,wBAAwB,EACxB,sEAAsE,EACtE,SAAS,CACV,CAAC;YACF,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,sBAAsB,EAAE,KAAK,EAAE,CAAC,CAAC;YACvF,OAAO,GAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAa,EACb,MAAwC,EACxC,EAAE,oBAAoB,EAAqB;IAE3C,IAAI,oBAAoB;QAAE,OAAO,UAAU,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,oFAAoF;IACpF,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;QAC3B,GAAI,UAAoD;QACxD,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;KACxC,CAAiB,CAAC;AACrB,CAAC"}
1
+ {"version":3,"file":"limit-clamp.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/limit-clamp.ts"],"names":[],"mappings":"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"}
@@ -12,6 +12,26 @@ interface HeadCutoff {
12
12
  readonly maxBytes: number;
13
13
  readonly stopAt?: string;
14
14
  }
15
+ /**
16
+ * A failure EDGAR full-text search relays in a 200 body in place of its payload (#206):
17
+ * `errorType` is the class of the error its OpenSearch client threw, `errorMessage`
18
+ * that error's message, when the body carries one as a string.
19
+ */
20
+ interface EftsBackendError {
21
+ readonly errorMessage: string | undefined;
22
+ readonly errorType: string;
23
+ }
24
+ /** How one request reads its answer. */
25
+ interface ReadOptions {
26
+ /**
27
+ * The transient backend failure a whole 2xx body relays, which fails the attempt
28
+ * like a 5xx — or `undefined` for a body to return. Opt-in per request: only EDGAR
29
+ * full-text search answers its backend's failures this way (#206).
30
+ */
31
+ readonly backendFailure?: (text: string, url: string) => EftsBackendError | undefined;
32
+ /** Read only the body's head (`tryGetFilingDocumentHead`). */
33
+ readonly cutoff?: HeadCutoff;
34
+ }
15
35
  /** A candidate suggestion from the trigram scan on no-result name search. */
16
36
  export interface CompanySuggestion {
17
37
  cik: string;
@@ -54,6 +74,33 @@ export interface SeriesFilingFeed {
54
74
  * back unchanged, so the result is safe to compare against a raw lowercased name.
55
75
  */
56
76
  export declare function normalizeCompanySuffix(name: string): string;
77
+ /**
78
+ * Delete every comma, period, and apostrophe (`'` and `’`) from a company name, then
79
+ * collapse each whitespace run to one space and trim the ends — the comparison form the
80
+ * name passes' folded tiers read, so `QXO Inc` meets `QXO, Inc.`, `U.S. Bancorp` meets
81
+ * `US BANCORP`, `Macys` meets `Macy's, Inc.` (#210), and `Forgent Networks Inc` meets the
82
+ * former name `forgent networks inc` (#219). A period is deleted, never turned into a
83
+ * space, so a dotted initialism meets its undotted spelling. Nothing else changes — `&`,
84
+ * `-`, `/`, and `\` stay, and so do spaced initials (`joinSpacedInitials` is a separate
85
+ * step) — and the result is for comparison only: a returned name is never folded.
86
+ */
87
+ export declare function foldNamePunctuation(name: string): string;
88
+ /**
89
+ * Join each run of two or more one-letter words into one word (`j m smucker co` →
90
+ * `jm smucker co`), so `JM Smucker` meets the conformed name `J M SMUCKER Co` and
91
+ * `WP Carey` meets `W. P. Carey Inc.` once folded (#219). Reads a folded name: words are
92
+ * split on single spaces, and a word is one letter in any script — a digit or a symbol
93
+ * ends the run. A space joins when a one-letter word sits on each side of it; the
94
+ * lookarounds are fixed-width, so the scan stays linear in the name's length.
95
+ */
96
+ export declare function joinSpacedInitials(name: string): string;
97
+ /**
98
+ * Whether `name` contains `query` starting at a word boundary, so a substring hit never
99
+ * begins inside a word: `embassy bancorp, inc.` does not contain `sy bancorp, inc.` (#218).
100
+ * The query may end mid-word (`berkshire hath`). Every occurrence is tried, since the first
101
+ * can sit mid-word and a later one at a word start.
102
+ */
103
+ export declare function containsFromWordStart(name: string, query: string): boolean;
57
104
  /**
58
105
  * Run a trigram similarity scan over the in-memory entry set. Each entry is scored
59
106
  * on its name and on its ticker, and keeps the higher of the two — one ranked,
@@ -83,8 +130,11 @@ declare class EdgarApiService {
83
130
  * any request made afterwards. Requests already sent are left to finish.
84
131
  */
85
132
  dispose(): void;
86
- /** Fetch and parse JSON, throwing on non-OK responses and on a body that is not JSON. */
87
- fetchJson<T>(url: string, scope: CallScope): Promise<T>;
133
+ /**
134
+ * Fetch and parse JSON, throwing on non-OK responses and on a body that is not JSON.
135
+ * `backendFailure` names the 200 bodies that fail an attempt (#206).
136
+ */
137
+ fetchJson<T>(url: string, scope: CallScope, options?: Pick<ReadOptions, 'backendFailure'>): Promise<T>;
88
138
  /** Fetch JSON, returning `null` on 404 and throwing on other non-OK responses. */
89
139
  tryFetchJson<T>(url: string, scope: CallScope): Promise<T | null>;
90
140
  /** Fetch raw text content (HTML filing documents). */
@@ -95,8 +145,12 @@ declare class EdgarApiService {
95
145
  * Resolve a query (ticker, name, or CIK) to company match(es).
96
146
  * - Numeric input → direct CIK lookup
97
147
  * - 1-5 uppercase letters → ticker lookup (O(1))
98
- * - Otherwise → name search (exact, prefix, substring — resolved within the best
99
- * tier a current name reaches), then the catch-all ticker lookup
148
+ * - No letter or digit (`.`, `'`) → no match
149
+ * - Otherwise → name search (exact as written; exact once commas, periods, and
150
+ * apostrophes are folded out and whitespace runs collapse; exact once spaced initials
151
+ * join; prefix of the joined form ending at a word boundary; substring as written
152
+ * starting at one — resolved within the best tier a current name reaches), then the
153
+ * catch-all ticker lookup
100
154
  * Returns a single match, an array of multiple matches, or an empty array (no match).
101
155
  * On no-result name search, the returned empty array carries `suggestions` on
102
156
  * the thrown error at the handler layer — call `suggestCompanies` there.
@@ -111,7 +165,9 @@ declare class EdgarApiService {
111
165
  * a legal name under different CIKs (e.g. "VANGUARD GROUP INC" = a transfer agent and
112
166
  * the 13F filer), so callers must disambiguate rather than auto-pick the top hit (#73).
113
167
  * Distinct from `searchFilings`: same URL path, different query param (`keysTyped`)
114
- * and response shape (`_source.entity`, not the filing-document `_source`).
168
+ * and response shape (`_source.entity`, not the filing-document `_source`). A
169
+ * failure of the search backend throws `efts_degraded_response` like a search's,
170
+ * never reads as no match (#206). The name is escaped like a search's `q` (#205).
115
171
  */
116
172
  resolveEntityByName(name: string, scope: CallScope): Promise<EntityNameMatch[]>;
117
173
  /** Reverse lookup: CIK → ticker symbol. */
@@ -187,7 +243,12 @@ declare class EdgarApiService {
187
243
  * Returns zero or more padded 10-digit CIKs in SEC-provided order.
188
244
  */
189
245
  findFilingCiks(accessionNumber: string, scope: CallScope): Promise<string[]>;
190
- /** Fetch a filing's document index. Returns `null` if the filing does not exist. */
246
+ /**
247
+ * Fetch a filing's document index. Returns `null` if the filing does not exist.
248
+ * Entries listed with no filename are dropped: SEC lists each document of a
249
+ * pre-2001 SGML submission that way, with only its size, and such a document
250
+ * exists only inside the full submission `<accession>.txt` (#203).
251
+ */
191
252
  tryGetFilingIndex(cik: string, accessionNumber: string, scope: CallScope): Promise<FilingIndex | null>;
192
253
  /**
193
254
  * Fetch the SEC submission header page (`<accession>-index-headers.html`) and parse
@@ -196,6 +257,16 @@ declare class EdgarApiService {
196
257
  * document TYPE values (e.g. "EX-21.1") that the directory listing JSON does not.
197
258
  */
198
259
  tryGetFilingHeaders(cik: string, accessionNumber: string, scope: CallScope): Promise<FilingHeaders | null>;
260
+ /**
261
+ * Fetch a filing's index page (`<accession>-index.html`) and return the CIKs of the
262
+ * parties it names — filer, subject company, filed-by, reporting owner, issuer — in
263
+ * page order, without repeats (see {@link filingPartyCiks}). Returns `null` if the
264
+ * page is absent. SEC serves the page under the accession number's own prefix CIK
265
+ * for any filing that exists, including a filing agent's prefix whose directory has
266
+ * no `index.json`, so it names the filers of an accession full-text search does not
267
+ * cover (before 2001) (#203).
268
+ */
269
+ tryGetFilingPartyCiks(cik: string, accessionNumber: string, scope: CallScope): Promise<string[] | null>;
199
270
  /**
200
271
  * Fetch the bare SGML submission header (`<accession>.hdr.sgml`, under 1 KB) and read
201
272
  * its form, filing date, and period. Returns `null` if the file is absent. The
@@ -285,10 +356,12 @@ declare class EdgarApiService {
285
356
  * 404's, a retried 5xx's, a 429's, one that lands as the caller cancels — is
286
357
  * cancelled unread (#188); an error the last attempt earns carries a bounded head
287
358
  * of its body, read like any other (#202). The body is read inside the ladder
288
- * (#181): a 5xx, an attempt that got no HTTP response, and a 2xx whose body
289
- * failed to read all retry up to `MAX_RETRIES` attempts, and
290
- * then the last attempt decides — a 5xx throws its status-classified `McpError`,
291
- * the other two `sec_unreachable`. Other non-OK statuses throw at once, as does
359
+ * (#181): a 5xx, an attempt that got no HTTP response, a 2xx whose body failed to
360
+ * read, and — for a request that opts in with `backendFailure` — a 2xx whose whole
361
+ * body relays a transient failure of the search backend (#206) all retry up to
362
+ * `MAX_RETRIES` attempts, and then the last attempt decides — a 5xx throws its
363
+ * status-classified `McpError`, a backend failure `efts_degraded_response`, the
364
+ * other two `sec_unreachable`. Other non-OK statuses throw at once, as does
292
365
  * the local refusal while SEC's rate-limit block is active, and the pacer's
293
366
  * `RequestCancelled` — those are `McpError`s from `send()`, never retried.
294
367
  *
@@ -301,7 +374,8 @@ declare class EdgarApiService {
301
374
  private rawFetch;
302
375
  /**
303
376
  * The error a request's last attempt earned: `sec_unreachable` for no response or
304
- * an unreadable body; for an HTTP answer, its status-classified `McpError`, with
377
+ * an unreadable body; `efts_degraded_response` for a body relaying a failure of the
378
+ * search backend (#206); for an HTTP answer, its status-classified `McpError`, with
305
379
  * the 403 and 429 hints. A 5xx ladder the failure budget stopped keeps its status
306
380
  * mapping and `data`, and its message says the budget stopped it (#179).
307
381
  *
@@ -413,6 +487,17 @@ export declare function parseMasterIndex(text: string): FullIndexEntry[];
413
487
  * result — the caller's cue that the series is unknown. Exported for direct unit testing.
414
488
  */
415
489
  export declare function parseSeriesFilingFeed(xml: string): SeriesFilingFeed;
490
+ /**
491
+ * The 10-digit CIKs a filing index page (`<accession>-index.html`) names, in page
492
+ * order without repeats: every party block links its company as
493
+ * `browse-edgar?CIK=<10 digits>&amp;action=getcompany`, while the page's other
494
+ * `browse-edgar` links (latest filings, file number, SIC code) carry no `CIK`
495
+ * parameter (#203). One forward pass: each link's query ends at the first character
496
+ * that ends an `href`, the next link is searched for from there, and the `CIK`
497
+ * parameter is looked for inside that query alone, so no character is scanned more
498
+ * than twice whatever the markup. Exported for direct unit testing.
499
+ */
500
+ export declare function filingPartyCiks(html: string): string[];
416
501
  /**
417
502
  * Name of the raw XML document inside a filing's archive directory. The submissions feed
418
503
  * points at the human-readable rendering (`xslSCHEDULE_13D_X02/primary_doc.xml`,
@@ -1 +1 @@
1
- {"version":3,"file":"edgar-api-service.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/edgar-api-service.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"edgar-api-service.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/edgar-api-service.ts"],"names":[],"mappings":"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"}