Use this when the user asks for the contents or a summary of one specific BSE filing of an Indian company, using a news_id from get_stock_events. It may queue processing and use a small daily allowance.
Get the cached PDF-extraction for one BSE corporate filing. Accepts NSE symbol, ISIN,
or BSE code + a BSE news_id. Obtain the `news_id` from get_stock_events, which lists a
security's recent filings each carrying its `news_id`.
Returns cached grounded facts + a factual summary extracted from the filing PDF. On a cache
miss for any filing that has an attached PDF, calling this tool ENQUEUES on-demand extraction.
It waits (up to ~30 seconds) only when the queue estimate says the result can be ready in
that time; otherwise it returns at once with `status="pending", queued=true`,
`retry_after_seconds` and, when known, an `eta_seconds` estimate from the current queue and
recent run times — call again after that long to retrieve the facts. Extraction often takes a
few minutes, so to read several filings of one company use get_filing_extracts (up to 10
news_ids per call) rather than polling this tool per filing. Extraction works for ANY filing
with a PDF, not a fixed doc-type list — EXCEPT financial-results
filings, which return `not_queued` reason `results_available_via_financials` (+ a `see_instead`
pointer) because their figures come from XBRL via get_financials / get_financial_trends, not
PDF extraction. Every `pending` response carries a `reason_code` that stays consistent across
repeat polls of the same news_id: `on_demand_processing` (this tool's own trigger enqueued it,
or moved an already-queued automatic job up to on-demand priority, and it is still
queued/running — keep polling), `auto_backfill_processing` (already being processed by
automatic extraction, not this tool — keep polling), or `awaiting_auto_backfill` (not yet
queued, but eligible for a future sweep). Other cache-miss statuses: `not_queued` reason
`no_document_to_extract` (no PDF), `not_queued` reason `on_demand_quota_exceeded`
(authenticated caller hit its per-day on-demand cap — retry tomorrow, or read
`attachment_url` directly), or `failed` (retries exhausted; see `error_reason`). Every
cache-miss response includes `attachment_url` to read the filing PDF directly. Raw disclosed
facts with verbatim source quotes only — no verdicts, targets, or recommendations.