@cyanheads/secedgar-mcp-server 0.10.0 → 0.10.1

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.
@@ -8,11 +8,11 @@ declare const ServerConfigSchema: z.ZodObject<{
8
8
  rateLimitRps: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
9
9
  tickerCacheTtl: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
10
10
  datasetTtlSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
11
- dataframeDropEnabled: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<boolean, string | undefined>>;
12
- mirrorEnabled: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<boolean, string | undefined>>;
11
+ dataframeDropEnabled: z.ZodDefault<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
12
+ mirrorEnabled: z.ZodDefault<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
13
13
  mirrorPath: z.ZodDefault<z.ZodString>;
14
14
  mirrorRefreshCron: z.ZodOptional<z.ZodString>;
15
- mirrorFallbackLive: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<boolean, string | undefined>>;
15
+ mirrorFallbackLive: z.ZodDefault<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
16
16
  }, z.core.$strip>;
17
17
  export type ServerConfig = z.infer<typeof ServerConfigSchema>;
18
18
  export declare function getServerConfig(): ServerConfig;
@@ -1 +1 @@
1
- {"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C,QAAA,MAAM,kBAAkB;;;;;;;;;;iBA0DtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAa9C"}
1
+ {"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;;;;;;;;iBAuDtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAa9C"}
@@ -3,6 +3,7 @@
3
3
  * @module config/server-config
4
4
  */
5
5
  import { z } from '@cyanheads/mcp-ts-core';
6
+ import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
6
7
  const ServerConfigSchema = z.object({
7
8
  userAgent: z
8
9
  .string()
@@ -27,14 +28,12 @@ const ServerConfigSchema = z.object({
27
28
  .default(86400)
28
29
  .describe('Per-table TTL for canvas-registered dataframes, in seconds. Bridge-side bookkeeping in ctx.state (backstop for cyanheads/mcp-ts-core#140 until the framework exposes RegisterTableOptions.ttlMs).'),
29
30
  dataframeDropEnabled: z
30
- .string()
31
- .optional()
32
- .transform((v) => v === 'true' || v === '1')
31
+ .stringbool()
32
+ .default(false)
33
33
  .describe('Set to "true" to expose secedgar_dataframe_drop. Off by default — the canvas already drops tables on the per-table TTL, and a write surface against the shared canvas is the only destructive tool on this server.'),
34
34
  mirrorEnabled: z
35
- .string()
36
- .optional()
37
- .transform((v) => v === 'true' || v === '1')
35
+ .stringbool()
36
+ .default(false)
38
37
  .describe('Set to "true" to enable the local SQLite mirror of company_tickers + XBRL company-facts. Off by default — when off, every CIK resolution and financials lookup hits the live SEC API. Node/Bun only; ignored on Cloudflare Workers (no SQLite/filesystem).'),
39
38
  mirrorPath: z
40
39
  .string()
@@ -45,23 +44,22 @@ const ServerConfigSchema = z.object({
45
44
  .optional()
46
45
  .describe('Cron expression for the in-process nightly refresh (HTTP transport only). Omit to disable scheduled refresh and run `bun run mirror:refresh` out-of-band instead. Recommended "0 9 * * *" (≈04:00–05:00 ET, after SEC rebuilds the bulk files ~03:00 ET).'),
47
46
  mirrorFallbackLive: z
48
- .string()
49
- .optional()
50
- .transform((v) => v !== 'false' && v !== '0')
47
+ .stringbool()
48
+ .default(true)
51
49
  .describe('When the mirror is enabled but a lookup misses (company/concept not yet synced, or a filing newer than the last refresh), fall back to the live SEC API. Default true. Set "false" for strict mirror-only reads.'),
52
50
  });
53
51
  let _config;
54
52
  export function getServerConfig() {
55
- _config ??= ServerConfigSchema.parse({
56
- userAgent: process.env.EDGAR_USER_AGENT,
57
- rateLimitRps: process.env.EDGAR_RATE_LIMIT_RPS,
58
- tickerCacheTtl: process.env.EDGAR_TICKER_CACHE_TTL,
59
- datasetTtlSeconds: process.env.EDGAR_DATASET_TTL_SECONDS,
60
- dataframeDropEnabled: process.env.EDGAR_DATAFRAME_DROP_ENABLED,
61
- mirrorEnabled: process.env.EDGAR_MIRROR_ENABLED,
62
- mirrorPath: process.env.EDGAR_MIRROR_PATH,
63
- mirrorRefreshCron: process.env.EDGAR_MIRROR_REFRESH_CRON,
64
- mirrorFallbackLive: process.env.EDGAR_MIRROR_FALLBACK_LIVE,
53
+ _config ??= parseEnvConfig(ServerConfigSchema, {
54
+ userAgent: 'EDGAR_USER_AGENT',
55
+ rateLimitRps: 'EDGAR_RATE_LIMIT_RPS',
56
+ tickerCacheTtl: 'EDGAR_TICKER_CACHE_TTL',
57
+ datasetTtlSeconds: 'EDGAR_DATASET_TTL_SECONDS',
58
+ dataframeDropEnabled: 'EDGAR_DATAFRAME_DROP_ENABLED',
59
+ mirrorEnabled: 'EDGAR_MIRROR_ENABLED',
60
+ mirrorPath: 'EDGAR_MIRROR_PATH',
61
+ mirrorRefreshCron: 'EDGAR_MIRROR_REFRESH_CRON',
62
+ mirrorFallbackLive: 'EDGAR_MIRROR_FALLBACK_LIVE',
65
63
  });
66
64
  return _config;
67
65
  }
@@ -1 +1 @@
1
- {"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,2EAA2E,CAAC;IACxF,YAAY,EAAE,CAAC,CAAC,MAAM;SACnB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,cAAc,EAAE,CAAC,CAAC,MAAM;SACrB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,uCAAuC,CAAC;IACpD,iBAAiB,EAAE,CAAC,CAAC,MAAM;SACxB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,mMAAmM,CACpM;IACH,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,CAAC;SAC3C,QAAQ,CACP,oNAAoN,CACrN;IACH,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,CAAC;SAC3C,QAAQ,CACP,4PAA4P,CAC7P;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,OAAO,CAAC,qBAAqB,CAAC;SAC9B,QAAQ,CACP,0GAA0G,CAC3G;IACH,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,2PAA2P,CAC5P;IACH,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC;SAC5C,QAAQ,CACP,kNAAkN,CACnN;CACJ,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,kBAAkB,CAAC,KAAK,CAAC;QACnC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;QACvC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;QAC9C,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;QAClD,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;QACxD,oBAAoB,EAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B;QAC9D,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;QAC/C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QACzC,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;QACxD,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B;KAC3D,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}
1
+ {"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,2EAA2E,CAAC;IACxF,YAAY,EAAE,CAAC,CAAC,MAAM;SACnB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,cAAc,EAAE,CAAC,CAAC,MAAM;SACrB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,uCAAuC,CAAC;IACpD,iBAAiB,EAAE,CAAC,CAAC,MAAM;SACxB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,mMAAmM,CACpM;IACH,oBAAoB,EAAE,CAAC;SACpB,UAAU,EAAE;SACZ,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,oNAAoN,CACrN;IACH,aAAa,EAAE,CAAC;SACb,UAAU,EAAE;SACZ,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,4PAA4P,CAC7P;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,OAAO,CAAC,qBAAqB,CAAC;SAC9B,QAAQ,CACP,0GAA0G,CAC3G;IACH,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,2PAA2P,CAC5P;IACH,kBAAkB,EAAE,CAAC;SAClB,UAAU,EAAE;SACZ,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACP,kNAAkN,CACnN;CACJ,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,SAAS,EAAE,kBAAkB;QAC7B,YAAY,EAAE,sBAAsB;QACpC,cAAc,EAAE,wBAAwB;QACxC,iBAAiB,EAAE,2BAA2B;QAC9C,oBAAoB,EAAE,8BAA8B;QACpD,aAAa,EAAE,sBAAsB;QACrC,UAAU,EAAE,mBAAmB;QAC/B,iBAAiB,EAAE,2BAA2B;QAC9C,kBAAkB,EAAE,4BAA4B;KACjD,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}