@cyanheads/secedgar-mcp-server 0.13.1 → 0.15.0

package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.js

@@ -0,0 +1,457 @@
+/**
+ * @fileoverview Blockholder ownership for one issuer, parsed from the structured
+ * SCHEDULE 13D / SCHEDULE 13G XML that SEC has required since 2024-12-18. Completes the
+ * ownership triangle alongside secedgar_get_insider_transactions (Form 4 officers and
+ * directors) and secedgar_get_institutional_holdings (13F portfolios): this tool covers the
+ * 5%-and-over stakes, activist and passive. Discovery runs off the issuer's own submissions
+ * feed — SEC cross-lists a 13D/G under every CIK party to it, so the issuer's history
+ * already carries the filings made about it and the archive document is reachable on the
+ * issuer's own path.
+ * @module mcp-server/tools/definitions/get-beneficial-owners
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getCanvasBridge, toDatasetField } from '../../../services/canvas-bridge/canvas-bridge.js';
+import { formNameToSchedule, parseBeneficialOwnershipXml, } from '../../../services/edgar/beneficial-ownership-parser.js';
+import { getEdgarApiService, rawDocumentName } from '../../../services/edgar/edgar-api-service.js';
+/**
+ * First filing date on which every beneficial-ownership filing arrived in the structured
+ * format. The legacy `SC 13D` / `SC 13G` names stop dead here: EDGAR full-text search counts
+ * 37 legacy filings on 2024-12-17 and zero on 2024-12-18, against 44 structured ones the
+ * same day. Filings before it are text or HTML documents with no XML to parse.
+ */
+const STRUCTURED_FROM = '2024-12-18';
+/** Legacy form names that carry the same disclosure with no parseable XML. */
+const LEGACY_FORMS = ['SC 13D', 'SC 13D/A', 'SC 13G', 'SC 13G/A'];
+/**
+ * Character ceiling on the Item 4 purpose-of-transaction prose. It is free text and runs to
+ * several pages on a control filing, which would put one filing's narrative ahead of every
+ * other filing's ownership data in the caller's context. The full text stays one
+ * secedgar_get_filing call away on the accession number each row carries.
+ */
+const PURPOSE_MAX_CHARS = 1200;
+/** Character ceiling on a reporting person's cover-page footnote — same reasoning, per person. */
+const NOTES_MAX_CHARS = 240;
+/** Trim free text to a ceiling, reporting whether anything was cut. */
+function clip(text, max) {
+    if (text === undefined)
+        return { text: undefined, cut: false };
+    const collapsed = text.replace(/\s+/g, ' ').trim();
+    if (collapsed.length <= max)
+        return { text: collapsed, cut: false };
+    return { text: `${collapsed.slice(0, max)}…`, cut: true };
+}
+export const getBeneficialOwnersTool = tool('secedgar_get_beneficial_owners', {
+    title: 'Get Beneficial Owners',
+    description: "List the 5%-and-over beneficial owners of a public company, parsed from the structured SCHEDULE 13D and SCHEDULE 13G filings made about it. The input is the ISSUER — the company being held — which is the opposite direction from secedgar_get_institutional_holdings, where the input is the manager. 13D is the activist form and carries the filer's stated purpose of the transaction; 13G is the passive form and has no purpose field at all, which is the substantive difference between a stake that intends to influence control and one that does not. Every filing is returned with each reporting person listed separately, because voting power, dispositive power, and percent of class are reported per person even on a joint filing where several funds and their controlling principal report overlapping shares — summing those percentages double-counts the same position. Coverage starts at 2024-12-18, when SEC replaced the legacy SC 13D / SC 13G text filings with this XML format; earlier stakes are readable but not parseable, and the response reports how many of them the issuer has. The full parsed set is materialized as df_<id> when a canvas is available, one row per reporting person, so it joins against the insider and 13F dataframes on issuer CIK.",
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    errors: [
+        {
+            reason: 'issuer_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The issuer input does not resolve to a known EDGAR company',
+            recovery: 'Use secedgar_company_search to find the issuer ticker or 10-digit CIK.',
+        },
+        {
+            reason: 'ambiguous_issuer',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'The issuer name matches several EDGAR companies',
+            recovery: 'Retry with the ticker or the 10-digit CIK of the intended issuer from the matches list.',
+        },
+        {
+            reason: 'no_filings_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The issuer has no structured SCHEDULE 13D/13G filings matching the requested form kind',
+            recovery: 'Use secedgar_search_filings with forms ["SC 13D","SC 13G"] to reach the pre-2024-12-18 text filings, then read them with secedgar_get_filing.',
+        },
+    ],
+    input: z.object({
+        issuer: z
+            .string()
+            .trim()
+            .min(1, 'Issuer cannot be blank')
+            .describe('The company whose blockholders you want — a ticker ("AAPL"), a 10-digit CIK ("0000320193"), or a company name. This is the subject company of the schedule, not the investor filing it; passing an investment manager here returns the schedules filed about that manager, which is almost always empty.'),
+        form_kind: z
+            .enum(['all', '13D', '13G'])
+            .default('all')
+            .describe('Which schedule to return. "13D" is the activist form, filed by a holder that may seek to influence control and carrying a stated purpose of transaction. "13G" is the passive form, available to institutions and holders under 20% that certify no control intent. "all" (default) returns both, newest first.'),
+        include_amendments: z
+            .boolean()
+            .default(true)
+            .describe('Whether to include amendments (SCHEDULE 13D/A, SCHEDULE 13G/A). Amendments carry the current position and are how an ongoing stake is tracked, so they are included by default. Set false to see only filings that opened a new position.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(20)
+            .default(10)
+            .describe('Number of filings to fetch and parse, newest first. Each filing is a separate document fetch, so this is the cost of the call as well as its depth. Default 10; a widely-held company can have dozens of blockholder filings a year.'),
+    }),
+    output: z.object({
+        issuer: z.string().describe('The issuer input, echoed.'),
+        issuer_cik: z.string().describe('CIK of the resolved issuer, zero-padded to 10 digits.'),
+        issuer_name: z.string().describe('EDGAR-conformed name of the resolved issuer.'),
+        form_kind: z
+            .enum(['all', '13D', '13G'])
+            .describe('The schedule filter applied — the requested value, or the default "all".'),
+        total_structured_filings: z
+            .number()
+            .describe("Structured SCHEDULE 13D/13G filings matching the form filter in the issuer's recent submissions window, before the limit. The population the returned filings are the newest slice of."),
+        filings_parsed: z
+            .number()
+            .describe('Filings actually fetched and parsed — total_structured_filings capped by limit.'),
+        structured_coverage_from: z
+            .string()
+            .describe('First filing date on which SEC required this XML format (YYYY-MM-DD). Blockholder filings before it exist but are not parseable into this schema.'),
+        legacy_filings_before_coverage: z
+            .number()
+            .describe("Legacy SC 13D / SC 13G filings in the issuer's recent submissions window — pre-2024-12-18 stakes this tool cannot parse. Reach them with secedgar_search_filings and read them with secedgar_get_filing. A floor, not a lifetime count: the submissions window holds roughly the last thousand filings of every type."),
+        filings: z
+            .array(z
+            .object({
+            form: z.string().describe('EDGAR form name, e.g. "SCHEDULE 13D" or "SCHEDULE 13G/A".'),
+            schedule: z
+                .enum(['13D', '13G'])
+                .describe('Which schedule this is — 13D activist, 13G passive.'),
+            is_amendment: z.boolean().describe('True when the form name carries the /A suffix.'),
+            amendment_number: z
+                .string()
+                .optional()
+                .describe('Amendment sequence from the cover page. Absent on an original filing.'),
+            accession_number: z
+                .string()
+                .describe('Accession number — pass to secedgar_get_filing for the full document.'),
+            filing_date: z.string().describe('Date the schedule was submitted (YYYY-MM-DD).'),
+            event_date: z
+                .string()
+                .optional()
+                .describe('Date of the event that required the filing (YYYY-MM-DD) — when the position actually crossed or changed, which precedes filing_date. Absent when the cover page omits it.'),
+            security_class: z
+                .string()
+                .optional()
+                .describe('Title of the class of securities the schedule covers. A multi-class issuer has a separate schedule per class, so percentages are of this class only.'),
+            cusips: z
+                .array(z.string())
+                .describe('CUSIPs of the subject class from the cover page. Empty when none listed.'),
+            purpose_of_transaction: z
+                .string()
+                .optional()
+                .describe('Item 4 purpose-of-transaction prose — what the holder says it intends. Present on 13D filings only; 13G has no such field, which is what makes it the passive form. Absent on an amendment that restates no purpose.'),
+            purpose_truncated: z
+                .boolean()
+                .describe('True when purpose_of_transaction was clipped to fit — read the full item with secedgar_get_filing on this accession number.'),
+            reporting_persons: z
+                .array(z
+                .object({
+                name: z.string().describe('Reporting person as named on the cover page.'),
+                cik: z
+                    .string()
+                    .optional()
+                    .describe('Reporting person CIK, when the schedule carries one. SCHEDULE 13G never does — its cover page has no CIK field — so this is populated on 13D filings only.'),
+                citizenship: z
+                    .string()
+                    .optional()
+                    .describe('SEC citizenship or place-of-organization code — a US state ("DE"), or an SEC country code ("X1" United States, "E9" Cayman Islands).'),
+                percent_of_class: z
+                    .number()
+                    .optional()
+                    .describe('Percent of the class this person beneficially owns (0-100), as this person reports it. Per person, not per filing: joint filers report overlapping shares, so these do not sum to a group total.'),
+                aggregate_amount_owned: z
+                    .number()
+                    .optional()
+                    .describe('Shares beneficially owned by this person. Absent when the person reports no amount, which happens on an exit amendment reporting a zero position.'),
+                sole_voting_power: z
+                    .number()
+                    .optional()
+                    .describe('Shares this person alone may vote.'),
+                shared_voting_power: z
+                    .number()
+                    .optional()
+                    .describe('Shares this person votes jointly with another party.'),
+                sole_dispositive_power: z
+                    .number()
+                    .optional()
+                    .describe('Shares this person alone may sell or transfer.'),
+                shared_dispositive_power: z
+                    .number()
+                    .optional()
+                    .describe('Shares this person may sell or transfer jointly with another party.'),
+                person_types: z
+                    .array(z.string())
+                    .describe('SEC type-of-reporting-person codes — IN individual, CO corporation, PN partnership, IA investment adviser, HC holding company, OO other. One person can carry several.'),
+                excludes_certain_shares: z
+                    .boolean()
+                    .optional()
+                    .describe('True when the reported aggregate deliberately excludes shares this person disclaims beneficial ownership of. Absent when the filing does not answer.'),
+                notes: z
+                    .string()
+                    .optional()
+                    .describe("The filer's own cover-page footnote, usually the share count the percentage was computed against. Clipped when long — the full text is in the filing."),
+            })
+                .describe('One reporting person from the schedule cover page.'))
+                .describe('Every reporting person on this filing. A joint filing lists a fund, its adviser, and its controlling principal separately, each reporting the same underlying shares.'),
+        })
+            .describe('One SCHEDULE 13D or 13G filing made about this issuer.'))
+            .describe('Blockholder filings, newest first, capped at limit.'),
+        dataset: z
+            .object({
+            name: z
+                .string()
+                .describe('Dataframe handle (df_XXXXX_XXXXX) — pass to secedgar_dataframe_query.'),
+            row_count: z.number().describe('Rows materialized in the dataframe.'),
+            expires_at: z.string().describe('ISO 8601 expiry timestamp.'),
+            truncated: z
+                .boolean()
+                .describe('True when the issuer has more structured filings than limit fetched — the dataframe holds the parsed filings only, not the whole history.'),
+        })
+            .optional()
+            .describe("Canvas dataframe holding one row per reporting person across every parsed filing, each row carrying the issuer, form, accession, and dates alongside the person's powers. Joins against the insider and 13F dataframes on issuer_cik. Absent when canvas is unavailable or nothing parsed."),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Guidance when no filings matched — names the coverage boundary and the fallback.'),
+        truncated: z.boolean().optional().describe('True when filings were capped by limit.'),
+        shown: z.number().optional().describe('Number of filings returned.'),
+        cap: z.number().optional().describe('The limit cap applied.'),
+    },
+    async handler(input, ctx) {
+        const api = getEdgarApiService();
+        const resolved = await api.resolveCik(input.issuer);
+        const candidates = Array.isArray(resolved) ? resolved : [resolved];
+        if (candidates.length > 1) {
+            const shown = candidates.slice(0, 10);
+            const list = shown.map((c) => `${c.ticker ?? c.cik} (${c.name ?? 'Unknown'})`).join(', ');
+            throw ctx.fail('ambiguous_issuer', `'${input.issuer}' matches multiple EDGAR companies: ${list}.`, {
+                ...ctx.recoveryFor('ambiguous_issuer'),
+                matches: shown.map((c) => ({ cik: c.cik, name: c.name, ticker: c.ticker })),
+            });
+        }
+        const match = candidates[0];
+        if (!match) {
+            throw ctx.fail('issuer_not_found', `Issuer '${input.issuer}' not found in EDGAR.`, {
+                ...ctx.recoveryFor('issuer_not_found'),
+            });
+        }
+        const submissions = await api.getSubmissions(match.cik);
+        const recent = submissions.filings.recent;
+        // SEC indexes a 13D/G under every CIK party to it, so the issuer's own feed already
+        // carries the schedules filed about it — no entity-scoped search needed.
+        const selected = [];
+        let totalMatching = 0;
+        let legacyCount = 0;
+        for (let i = 0; i < recent.form.length; i++) {
+            const form = recent.form[i] ?? '';
+            if (LEGACY_FORMS.includes(form)) {
+                legacyCount++;
+                continue;
+            }
+            const schedule = formNameToSchedule(form);
+            if (!schedule)
+                continue;
+            if (input.form_kind !== 'all' && schedule !== input.form_kind)
+                continue;
+            if (!input.include_amendments && form.endsWith('/A'))
+                continue;
+            totalMatching++;
+            if (selected.length < input.limit) {
+                selected.push({
+                    form,
+                    schedule,
+                    accessionNumber: recent.accessionNumber[i] ?? '',
+                    filingDate: recent.filingDate[i] ?? '',
+                    document: rawDocumentName(recent.primaryDocument[i]),
+                });
+            }
+        }
+        if (totalMatching === 0) {
+            const kindLabel = input.form_kind === 'all' ? 'SCHEDULE 13D/13G' : `SCHEDULE ${input.form_kind}`;
+            const legacyHint = legacyCount > 0
+                ? `Its submissions window does hold ${legacyCount} legacy SC 13D/SC 13G filings from before ${STRUCTURED_FROM}; those are text filings with no XML to parse — read them with secedgar_get_filing.`
+                : `Blockholder filings from before ${STRUCTURED_FROM} use the legacy SC 13D / SC 13G names and are not parseable into this schema — search for them with secedgar_search_filings.`;
+            throw ctx.fail('no_filings_found', `No structured ${kindLabel} filings found for ${submissions.name} (CIK ${match.cik}). ${legacyHint}`, {
+                ...ctx.recoveryFor('no_filings_found'),
+                issuer_cik: match.cik,
+                issuer_name: submissions.name,
+                legacy_filings_before_coverage: legacyCount,
+            });
+        }
+        // Fetch and parse each selected filing. A document that 404s or does not parse as a
+        // schedule is dropped rather than failing the call — one malformed filing must not
+        // hide every other blockholder in the list.
+        const filings = [];
+        for (const ref of selected) {
+            const xml = await api.tryGetFilingDocument(match.cik, ref.accessionNumber, ref.document);
+            const parsed = xml ? parseBeneficialOwnershipXml(xml) : undefined;
+            if (!parsed) {
+                ctx.log.debug('Skipping unparseable beneficial-ownership filing', {
+                    accessionNumber: ref.accessionNumber,
+                    document: ref.document,
+                });
+                continue;
+            }
+            const purpose = clip(parsed.purpose_of_transaction, PURPOSE_MAX_CHARS);
+            filings.push({
+                form: ref.form,
+                schedule: ref.schedule,
+                is_amendment: ref.form.endsWith('/A'),
+                amendment_number: parsed.amendment_number,
+                accession_number: ref.accessionNumber,
+                filing_date: ref.filingDate,
+                event_date: parsed.event_date,
+                security_class: parsed.security_class,
+                cusips: parsed.issuer_cusips,
+                purpose_of_transaction: purpose.text,
+                purpose_truncated: purpose.cut,
+                reporting_persons: parsed.owners.map((o) => ({
+                    name: o.name,
+                    cik: o.cik,
+                    citizenship: o.citizenship,
+                    percent_of_class: o.percent_of_class,
+                    aggregate_amount_owned: o.aggregate_amount_owned,
+                    sole_voting_power: o.sole_voting_power,
+                    shared_voting_power: o.shared_voting_power,
+                    sole_dispositive_power: o.sole_dispositive_power,
+                    shared_dispositive_power: o.shared_dispositive_power,
+                    person_types: o.person_types,
+                    excludes_certain_shares: o.excludes_certain_shares,
+                    notes: clip(o.notes, NOTES_MAX_CHARS).text,
+                })),
+            });
+        }
+        const truncated = totalMatching > filings.length;
+        // One row per reporting person — the grain the ownership question is asked at, and the
+        // grain that joins to the insider and 13F dataframes on issuer_cik.
+        let dataset;
+        const bridge = getCanvasBridge();
+        const rows = filings.flatMap((f) => f.reporting_persons.map((p) => ({
+            issuer_cik: match.cik,
+            issuer_name: submissions.name,
+            form: f.form,
+            schedule: f.schedule,
+            is_amendment: f.is_amendment,
+            accession_number: f.accession_number,
+            filing_date: f.filing_date,
+            event_date: f.event_date ?? null,
+            security_class: f.security_class ?? null,
+            cusip: f.cusips[0] ?? null,
+            reporting_person: p.name,
+            reporting_person_cik: p.cik ?? null,
+            citizenship: p.citizenship ?? null,
+            percent_of_class: p.percent_of_class ?? null,
+            aggregate_amount_owned: p.aggregate_amount_owned ?? null,
+            sole_voting_power: p.sole_voting_power ?? null,
+            shared_voting_power: p.shared_voting_power ?? null,
+            sole_dispositive_power: p.sole_dispositive_power ?? null,
+            shared_dispositive_power: p.shared_dispositive_power ?? null,
+            person_types: p.person_types.join(',') || null,
+            has_stated_purpose: f.purpose_of_transaction !== undefined,
+        })));
+        if (bridge && rows.length > 0) {
+            const registered = await bridge.registerDataframe(ctx, {
+                rows,
+                sourceTool: 'secedgar_get_beneficial_owners',
+                queryParams: {
+                    issuer: input.issuer,
+                    issuer_cik: match.cik,
+                    form_kind: input.form_kind,
+                    include_amendments: input.include_amendments,
+                    limit: input.limit,
+                },
+                truncated,
+            });
+            if (registered)
+                dataset = { ...toDatasetField(registered), truncated };
+        }
+        if (filings.length === 0) {
+            ctx.enrich.notice(`${totalMatching} structured filings are indexed for ${submissions.name}, but none of the ${selected.length} fetched parsed as a SCHEDULE 13D or 13G document. Read one directly with secedgar_get_filing on an accession number from secedgar_search_filings.`);
+        }
+        else if (truncated) {
+            ctx.enrich.truncated({
+                shown: filings.length,
+                cap: input.limit,
+                guidance: `${totalMatching} structured blockholder filings are indexed for this issuer. Raise limit to reach further back, or narrow with form_kind or include_amendments=false.`,
+            });
+        }
+        ctx.log.info('Beneficial owners retrieved', {
+            cik: match.cik,
+            formKind: input.form_kind,
+            totalMatching,
+            parsed: filings.length,
+            owners: rows.length,
+            datasetName: dataset?.name,
+        });
+        return {
+            issuer: input.issuer,
+            issuer_cik: match.cik,
+            issuer_name: submissions.name,
+            form_kind: input.form_kind,
+            total_structured_filings: totalMatching,
+            filings_parsed: filings.length,
+            structured_coverage_from: STRUCTURED_FROM,
+            legacy_filings_before_coverage: legacyCount,
+            filings,
+            dataset,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**5%+ beneficial owners of ${result.issuer_name}** (CIK ${result.issuer_cik}) — input "${result.issuer}"`,
+            `Schedule filter: ${result.form_kind} | ${result.filings_parsed} of ${result.total_structured_filings} structured filings parsed`,
+            `Structured coverage starts ${result.structured_coverage_from}; ${result.legacy_filings_before_coverage} legacy SC 13D/SC 13G filings sit before it in the submissions window (read those with secedgar_get_filing).`,
+        ];
+        for (const f of result.filings) {
+            lines.push('');
+            const amendment = f.is_amendment
+                ? ` (amendment${f.amendment_number ? ` no. ${f.amendment_number}` : ''})`
+                : '';
+            lines.push(`## ${f.form}${amendment} — filed ${f.filing_date} [${f.accession_number}]`);
+            const bits = [`Schedule ${f.schedule}`];
+            if (f.event_date)
+                bits.push(`event ${f.event_date}`);
+            if (f.security_class)
+                bits.push(f.security_class);
+            if (f.cusips.length > 0)
+                bits.push(`CUSIP ${f.cusips.join(', ')}`);
+            lines.push(bits.join(' | '));
+            for (const p of f.reporting_persons) {
+                const pct = p.percent_of_class !== undefined ? `${p.percent_of_class}% of class` : 'percent N/A';
+                const owned = p.aggregate_amount_owned !== undefined
+                    ? `${p.aggregate_amount_owned.toLocaleString()} shares`
+                    : 'amount N/A';
+                const idBits = [];
+                if (p.cik)
+                    idBits.push(`CIK ${p.cik}`);
+                if (p.citizenship)
+                    idBits.push(p.citizenship);
+                if (p.person_types.length > 0)
+                    idBits.push(p.person_types.join('/'));
+                lines.push(`- **${p.name}**${idBits.length > 0 ? ` (${idBits.join(', ')})` : ''}`);
+                lines.push(`  ${owned} | ${pct}`);
+                lines.push(`  voting sole/shared: ${p.sole_voting_power ?? 'N/A'} / ${p.shared_voting_power ?? 'N/A'} | dispositive sole/shared: ${p.sole_dispositive_power ?? 'N/A'} / ${p.shared_dispositive_power ?? 'N/A'}`);
+                if (p.excludes_certain_shares !== undefined) {
+                    lines.push(`  Excludes disclaimed shares: ${p.excludes_certain_shares ? 'yes' : 'no'}`);
+                }
+                if (p.notes)
+                    lines.push(`  Note: ${p.notes}`);
+            }
+            if (f.purpose_of_transaction) {
+                lines.push(`**Purpose of transaction:** ${f.purpose_of_transaction}${f.purpose_truncated ? ' (clipped — read the full Item 4 with secedgar_get_filing)' : ''}`);
+            }
+            else {
+                lines.push(f.schedule === '13G'
+                    ? '**Purpose of transaction:** not applicable — 13G is the passive form and has no purpose item.'
+                    : '**Purpose of transaction:** not stated in this filing.');
+            }
+        }
+        if (result.dataset) {
+            const note = result.dataset.truncated
+                ? ' (truncated — more structured filings exist beyond limit)'
+                : '';
+            lines.push(`\nDataset: ${result.dataset.name} (${result.dataset.row_count} reporting-person rows, expires ${result.dataset.expires_at})${note} — query with secedgar_dataframe_query.`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-beneficial-owners.tool.js.map

package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-beneficial-owners.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-beneficial-owners.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-financials.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-financials.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-financials.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAajE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyd5B,CAAC"}
+{"version":3,"file":"get-financials.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-financials.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAejE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkf5B,CAAC"}

package/dist/mcp-server/tools/definitions/get-financials.tool.js

@@ -7,7 +7,7 @@ import { tool, z } from '@cyanheads/mcp-ts-core';
 import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 import { getCanvasBridge, toDatasetField } from '../../../services/canvas-bridge/canvas-bridge.js';
 import { resolveConceptTarget } from '../../../services/edgar/concept-map.js';
-import { deprecatedTagCaveats, matchesPeriodType, resolveFrameSeries, } from '../../../services/edgar/concept-series.js';
+import { matchesPeriodType, preferredTagIndex, resolveFrameSeries, seriesStalenessCaveats, } from '../../../services/edgar/concept-series.js';
 import { getEdgarApiService } from '../../../services/edgar/edgar-api-service.js';
 import { missingQuarterCaveats } from '../../../services/edgar/fiscal-periods.js';
 export const getFinancialsTool = tool('secedgar_get_financials', {
@@ -128,7 +128,7 @@ export const getFinancialsTool = tool('secedgar_get_financials', {
         caveats: z
             .array(z.string())
             .optional()
-            .describe("Data-completeness warnings about the returned series. Two kinds. On quarterly results, one entry when one or two calendar quarters are absent from every recent qualifying year — SEC reports a filer's fiscal Q4 as the 10-K residual rather than a discrete quarterly fact, so the calendar quarter fiscal Q4 spans has no frame-tagged value, and a filer whose other fiscal quarters span non-calendar durations loses a second quarter the same way. Applies to calendar-year filers (no discrete Q4) as much as to off-calendar ones. On any result, one entry when the concept resolved to an XBRL tag SEC has retired from the taxonomy, which means the current tags reported nothing and the series may stop years short. Absent when the series has nothing to flag."),
+            .describe("Data-completeness warnings about the returned series. Two kinds. On quarterly results, one entry when one or two calendar quarters are absent from every recent qualifying year — SEC reports a filer's fiscal Q4 as the 10-K residual rather than a discrete quarterly fact, so the calendar quarter fiscal Q4 spans has no frame-tagged value, and a filer whose other fiscal quarters span non-calendar durations loses a second quarter the same way. Applies to calendar-year filers (no discrete Q4) as much as to off-calendar ones. On any result, one entry when the series stops well short of today — either because the concept resolved to an XBRL tag SEC has retired from the taxonomy (the current tags reported nothing), or because a current tag's series ends more than two years plus a filing window back, which is what a filer migrating to a different element or dropping the disclosure looks like. Absent when the series has nothing to flag."),
     }),
     async handler(input, ctx) {
         const api = getEdgarApiService();
@@ -166,12 +166,13 @@ export const getFinancialsTool = tool('secedgar_get_financials', {
         // Resolve concept to taxonomy + XBRL tag(s). The mapping's own taxonomy wins
         // over the `us-gaap` default (e.g. `dei` for shares_outstanding); ifrs-full
         // uses the confirmed IFRS variants when the mapping has them.
-        const { label, tags, taxonomy, unit: mappedUnit, } = resolveConceptTarget(input.concept, input.taxonomy);
+        const { label, tagSelection, tags, taxonomy, unit: mappedUnit, } = resolveConceptTarget(input.concept, input.taxonomy);
         // Default to "annual" for unset period_type; post-fetch fallback handles instant concepts (#48).
         const effectivePeriodType = input.period_type ?? 'annual';
         // Try each tag until we get data. `tryGetCompanyConcept` returns null for 404
         // (tag not reported by this company); other errors propagate.
-        let conceptResponse;
+        /** Responding tags keyed by array position, in declared order. */
+        const responses = new Map();
         const tagsTried = [];
         /**
          * Each unit is augmented with its source-tag index so the frame dedup can
@@ -183,20 +184,24 @@ export const getFinancialsTool = tool('secedgar_get_financials', {
             const resp = await api.tryGetCompanyConcept(match.cik, taxonomy, tag);
             if (!resp)
                 continue;
-            if (!conceptResponse) {
-                conceptResponse = {
-                    units: resp.units,
-                    label: resp.label,
-                    description: resp.description ?? undefined,
-                    tag: resp.tag,
-                };
-            }
+            responses.set(tagIndex, {
+                units: resp.units,
+                label: resp.label,
+                description: resp.description ?? undefined,
+                tag: resp.tag,
+            });
             for (const units of Object.values(resp.units)) {
                 for (const u of units) {
                     allUnits.push({ ...u, tagIndex });
                 }
             }
         }
+        /**
+         * The concept is described by the tag that won for this filer, which under a
+         * `coverage` selection is not the first one to respond (#101).
+         */
+        const winningTagIndex = preferredTagIndex(allUnits, tagSelection);
+        const conceptResponse = winningTagIndex !== undefined ? responses.get(winningTagIndex) : undefined;
         if (!conceptResponse || allUnits.length === 0) {
             // Probe companyfacts to discover what namespaces and tags this filer actually reports.
             // Only on the error path — one extra request, never on the happy path.
@@ -238,7 +243,7 @@ export const getFinancialsTool = tool('secedgar_get_financials', {
          * only, same-frame collisions resolved by tag priority then latest `filed`
          * (#44). An empty map means the concept exists but has no frame-aligned entries.
          */
-        const byFrameClean = resolveFrameSeries(allUnits);
+        const byFrameClean = resolveFrameSeries(allUnits, tagSelection);
         if (byFrameClean.size === 0) {
             throw ctx.fail('no_frame_data', `'${conceptResponse.tag}' exists for this company but has no standard-period data.`, {
                 ...ctx.recoveryFor('no_frame_data'),
@@ -278,6 +283,12 @@ export const getFinancialsTool = tool('secedgar_get_financials', {
         }
         // Sort newest first
         filtered.sort((a, b) => b.end.localeCompare(a.end));
+        /**
+         * Read from the full deduped set, not the period-filtered slice: an annual
+         * view that stops a year behind a still-current quarterly series is a
+         * property of the filter, not of the concept.
+         */
+        const newestFramed = [...byFrameClean.values()].reduce((newest, unit) => (!newest || unit.end > newest.end ? unit : newest), undefined);
         /**
          * Off-calendar filers lose a whole calendar quarter from the frame-tagged
          * series — SEC reports fiscal Q4 as the 10-K residual, never as a discrete
@@ -290,11 +301,17 @@ export const getFinancialsTool = tool('secedgar_get_financials', {
         const caveats = [
             ...(resolvedPeriodType === 'annual' ? [] : missingQuarterCaveats(byFrameClean.keys())),
             /**
-             * The tag that won the priority walk can be one SEC retired years ago,
-             * which happens exactly when no current tag reports for this filer. The
-             * values look ordinary; the taxonomy label is the only tell (#98).
+             * The tag that won the walk can be one SEC retired years ago, which
+             * happens exactly when no current tag reports for this filer; the values
+             * look ordinary and the taxonomy label is the only tell (#98). A current
+             * tag whose series simply stops carries no tell at all, so the gap to
+             * today is the signal — one companyconcept payload is all this tool reads,
+             * and it holds no filer-wide period to compare against (#102).
              */
-            ...deprecatedTagCaveats(conceptResponse.tag, conceptResponse.label),
+            ...seriesStalenessCaveats(conceptResponse.tag, conceptResponse.label, newestFramed, {
+                date: new Date().toISOString().slice(0, 10),
+                kind: 'current-date',
+            }),
         ];
         // Determine unit string
         const unitKey = Object.keys(conceptResponse.units)[0] ?? mappedUnit ?? 'USD';