openbb-tensorust 0.1.0__py3-none-any.whl

openbb_tensorust/__init__.py

@@ -0,0 +1,52 @@
+"""OpenBB provider and router extension for Tensorust data.
+
+Private credit loan marks from SEC BDC filings, federal contractor credit,
+banned-vendor exposure in federal research awards, and No Surprises Act IDR
+offer bands. Free previews without a key; set ``tensorust_api_key`` (or the
+``TENSORUST_API_KEY`` environment variable) for full records.
+"""
+
+from openbb_core.provider.abstract.provider import Provider
+
+from openbb_tensorust.models.contractor import (
+    TensorustContractorCreditFetcher,
+    TensorustContractorWatchFetcher,
+)
+from openbb_tensorust.models.credit import (
+    TensorustBdcLoanMarksFetcher,
+    TensorustCreditDisagreementsFetcher,
+    TensorustCreditQ3CutsFetcher,
+)
+from openbb_tensorust.models.exposure import TensorustExposureInstitutionFetcher
+from openbb_tensorust.models.idr import TensorustIdrOfferFetcher
+
+__version__ = "0.1.0"
+
+tensorust_provider = Provider(
+    name="tensorust",
+    website="https://tensorust.com",
+    description=(
+        "Tensorust builds entity-level datasets from US public records: what BDC (private credit) "
+        "lenders mark each first-lien loan at, which federal contractors sit on marked-down loans, "
+        "which federal research awards pay for work by vendors on banned-vendor lists, and the "
+        "No Surprises Act IDR offer band by code, payer and state. Every command answers a free "
+        "preview without a key."
+    ),
+    credentials=["api_key"],
+    fetcher_dict={
+        "TensorustBdcLoanMarks": TensorustBdcLoanMarksFetcher,
+        "TensorustCreditDisagreements": TensorustCreditDisagreementsFetcher,
+        "TensorustCreditQ3Cuts": TensorustCreditQ3CutsFetcher,
+        "TensorustContractorCredit": TensorustContractorCreditFetcher,
+        "TensorustContractorWatch": TensorustContractorWatchFetcher,
+        "TensorustExposureInstitution": TensorustExposureInstitutionFetcher,
+        "TensorustIdrOffer": TensorustIdrOfferFetcher,
+    },
+    repr_name="Tensorust",
+    instructions=(
+        "No key is needed for previews. For full records set the credential tensorust_api_key "
+        "to a Tensorust enterprise key (tdk_...): https://shop.tensorust.com/offers/enterprise-api"
+    ),
+)
+
+__all__ = ["__version__", "tensorust_provider"]

openbb_tensorust/client.py

@@ -0,0 +1,110 @@
+"""Tensorust MCP client: one JSON-RPC ``tools/call`` per OpenBB command.
+
+Every fetcher in this package calls the public Tensorust MCP server
+(https://shop.tensorust.com/api/mcp). Without a key it answers free previews.
+With a Tensorust key (``tensorust_api_key`` in OpenBB credentials, or the
+``TENSORUST_API_KEY`` environment variable) the call asks for ``full=true``
+and the server returns full records.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from typing import Any
+
+import requests
+from openbb_core.app.model.abstract.error import OpenBBError
+from openbb_core.provider.utils.errors import EmptyDataError
+
+MCP_URL = "https://shop.tensorust.com/api/mcp"
+KEY_URL = "https://shop.tensorust.com/offers/enterprise-api"
+USER_AGENT = "openbb-tensorust"
+
+
+def mcp_url() -> str:
+    """Endpoint, overridable with TENSORUST_MCP_URL (tests, staging)."""
+    return os.environ.get("TENSORUST_MCP_URL", MCP_URL)
+
+
+def api_key(credentials: dict[str, str] | None) -> str | None:
+    """The Tensorust key from OpenBB credentials, else from the environment."""
+    key = (credentials or {}).get("tensorust_api_key") or os.environ.get("TENSORUST_API_KEY")
+    return key.strip() if key and key.strip() else None
+
+
+def call_tool(
+    name: str,
+    arguments: dict[str, Any],
+    credentials: dict[str, str] | None = None,
+    timeout: float = 60.0,
+) -> dict[str, Any]:
+    """Call one Tensorust MCP tool and return its JSON answer as a dict.
+
+    Adds ``full=true`` and the bearer key when a key is configured.
+    Raises OpenBBError on transport or tool errors.
+    """
+    key = api_key(credentials)
+    args = {k: v for k, v in arguments.items() if v is not None and v != ""}
+    headers = {
+        "content-type": "application/json",
+        "accept": "application/json",
+        "user-agent": USER_AGENT,
+    }
+    if key:
+        headers["authorization"] = f"Bearer {key}"
+        args["full"] = True
+    payload = {
+        "jsonrpc": "2.0",
+        "id": 1,
+        "method": "tools/call",
+        "params": {"name": name, "arguments": args},
+    }
+    try:
+        resp = requests.post(mcp_url(), json=payload, headers=headers, timeout=timeout)
+    except requests.RequestException as exc:  # pragma: no cover - network
+        raise OpenBBError(f"Tensorust request failed: {exc}") from exc
+    if resp.status_code != 200:
+        raise OpenBBError(f"Tensorust answered HTTP {resp.status_code}: {resp.text[:300]}")
+    body = resp.json()
+    if "error" in body:
+        raise OpenBBError(f"Tensorust error: {body['error'].get('message', body['error'])}")
+    result = body.get("result") or {}
+    text = "".join(c.get("text", "") for c in result.get("content", []) if c.get("type") == "text")
+    if result.get("isError"):
+        raise EmptyDataError(text or f"Tensorust tool {name} returned an error.")
+    try:
+        data = json.loads(text)
+    except json.JSONDecodeError as exc:
+        raise OpenBBError(f"Tensorust tool {name} returned non-JSON text: {text[:200]}") from exc
+    if not isinstance(data, dict):
+        raise OpenBBError(f"Tensorust tool {name} returned {type(data).__name__}, not an object.")
+    return data
+
+
+def not_found(data: dict[str, Any], what: str) -> EmptyDataError:
+    """EmptyDataError naming the closest matches the server suggested."""
+    similar = data.get("similar") or []
+    names = [s.get("name") if isinstance(s, dict) else str(s) for s in similar if s]
+    hint = f" Closest names: {', '.join(n for n in names if n)}." if names else ""
+    note = f" {data['note']}" if data.get("note") else ""
+    return EmptyDataError(f"No {what} matches '{data.get('query', '')}'.{note}{hint}")
+
+
+def access_note(data: dict[str, Any]) -> str | None:
+    """How to get the full answer, when this one is a preview (None when it is already full)."""
+    if data.get("access") in ("full", "key", "free"):
+        return None
+    scope = ""
+    for k in ("access", "full_data", "full"):
+        v = data.get(k)
+        if isinstance(v, str) and v.lower().startswith(("top ", "first ")):
+            scope = f" ({v.split(';')[0].strip()})"
+            break
+    is_preview = data.get("access") is not None or data.get("preview") is True or "full_data" in data
+    if not is_preview:
+        return None
+    return (
+        f"Free preview{scope}. For full records set obb.user.credentials.tensorust_api_key "
+        f"(or TENSORUST_API_KEY) to a Tensorust key: {KEY_URL}"
+    )

openbb_tensorust/models/__init__.py

@@ -0,0 +1 @@
+"""Tensorust provider models."""

openbb_tensorust/models/contractor.py

@@ -0,0 +1,213 @@
+"""Contractor Credit: federal contractors financed by BDC lenders, and how those lenders mark them.
+
+Sources: SEC BDC schedules of investments (Q3 2026 from 10-Qs as filed),
+USAspending.gov, SAM parent UEI, DOL Form 5500, FCC, FAA and county records.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Literal
+
+from openbb_core.provider.abstract.annotated_result import AnnotatedResult
+from openbb_core.provider.abstract.data import Data
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.abstract.query_params import QueryParams
+from pydantic import Field
+
+from openbb_tensorust.client import access_note, call_tool, not_found
+
+MARK = "Fraction of par (0.95 = 95% of par)."
+
+
+# ---- contractor_credit ----------------------------------------------------------------------
+
+
+class TensorustContractorCreditQueryParams(QueryParams):
+    """Contractor credit query."""
+
+    contractor: str = Field(description="Federal contractor name, 12-character UEI or 9-digit EIN.")
+
+
+class TensorustContractorCreditData(Data):
+    """One federal contractor's credit picture."""
+
+    operating_company: str = Field(description="Federal award recipient.")
+    uei: str | None = Field(default=None, description="SAM UEI of the recipient.")
+    state: str | None = Field(default=None, description="Recipient state.")
+    borrower: str | None = Field(default=None, description="Borrower name in BDC filings.")
+    sam_parent: str | None = Field(default=None, description="Parent reported to SAM.")
+    federal_obligations_fy2025_to_date: float | None = Field(default=None, description="USD.")
+    dod_fy2024_2026: float | None = Field(default=None, description="DoD obligations FY2024-26, USD.")
+    top_agency: str | None = Field(default=None, description="Agency with the most obligations.")
+    marks_as_of: str | None = Field(default=None, description="Quarter end of the BDC marks.")
+    lowest_mark: float | None = Field(default=None, description="Lowest Jun 30 BDC mark. " + MARK)
+    highest_mark: float | None = Field(default=None, description="Highest Jun 30 BDC mark. " + MARK)
+    sep30_lowest_mark: float | None = Field(default=None, description="Lowest Sep 30 2026 mark filed so far. " + MARK)
+    all_debt_mark: float | None = Field(
+        default=None, description="Par-weighted mark of every BDC debt line, latest quarter."
+    )
+    bdc_par: float | None = Field(default=None, description="BDC first-lien par, USD.")
+    headcount_change_pct: float | None = Field(default=None, description="Form 5500 participants, 2024 to 2025, %.")
+    signals: list[str] = Field(default_factory=list, description="Stress signals.")
+    market_priced: str | None = Field(default=None, description="Set when the credit is already market priced.")
+    read: str | None = Field(default=None, description="One-paragraph summary.")
+
+
+class TensorustContractorCreditFetcher(
+    Fetcher[TensorustContractorCreditQueryParams, list[TensorustContractorCreditData]]
+):
+    """contractor_credit: obligations, lender marks, headcount and signals for one contractor."""
+
+    require_credentials = False
+
+    @staticmethod
+    def transform_query(params: dict[str, Any]) -> TensorustContractorCreditQueryParams:
+        return TensorustContractorCreditQueryParams(**params)
+
+    @staticmethod
+    def extract_data(
+        query: TensorustContractorCreditQueryParams,
+        credentials: dict[str, str] | None,
+        **kwargs: Any,
+    ) -> dict[str, Any]:
+        return call_tool("contractor_credit", {"name": query.contractor}, credentials)
+
+    @staticmethod
+    def transform_data(
+        query: TensorustContractorCreditQueryParams, data: dict[str, Any], **kwargs: Any
+    ) -> AnnotatedResult[list[TensorustContractorCreditData]]:
+        if not data.get("found"):
+            raise not_found(data, "BDC-financed federal contractor")
+        op = data.get("operating_company") or {}
+        fed = data.get("federal") or {}
+        m = data.get("marks") or {}
+        hc = data.get("headcount") or {}
+        mp = data.get("market_priced") or {}
+        all_debt = m.get("all_debt_lines_latest") or {}
+        row = TensorustContractorCreditData(
+            operating_company=op.get("name") or query.contractor,
+            uei=op.get("uei"),
+            state=op.get("state"),
+            borrower=data.get("borrower"),
+            sam_parent=op.get("sam_parent_reported"),
+            federal_obligations_fy2025_to_date=fed.get("obligations_fy2025_to_date"),
+            dod_fy2024_2026=fed.get("dod_fy2024_2026"),
+            top_agency=fed.get("top_agency"),
+            marks_as_of=m.get("as_of"),
+            lowest_mark=m.get("lowest"),
+            highest_mark=m.get("highest"),
+            sep30_lowest_mark=m.get("q3_lowest"),
+            all_debt_mark=all_debt.get("mark"),
+            bdc_par=m.get("bdc_par"),
+            headcount_change_pct=hc.get("change_pct"),
+            signals=data.get("signals") or [],
+            market_priced=mp.get("kind"),
+            read=data.get("read"),
+        )
+        meta: dict[str, Any] = {
+            k: data[k]
+            for k in (
+                "federal",
+                "marks",
+                "headcount",
+                "footprint",
+                "subcontracts_fy2025_to_date",
+                "market_priced",
+                "agencies",
+                "sample_agencies",
+                "lenders",
+                "q3_pending_holders",
+                "recipients",
+                "mark_history",
+                "source",
+            )
+            if data.get(k) is not None
+        }
+        note = access_note(data)
+        if note:
+            meta["access"] = note
+        return AnnotatedResult(result=[row], metadata=meta)
+
+
+# ---- contractor_watch -----------------------------------------------------------------------
+
+
+class TensorustContractorWatchQueryParams(QueryParams):
+    """Stressed federal contractors query."""
+
+    sort: Literal["federal", "mark", "q3"] = Field(
+        default="federal",
+        description="federal: largest federal exposure first; mark: lowest mark first; q3: biggest Sep 30 cut first.",
+    )
+    private_only: bool = Field(default=False, description="Drop names with listed equity or a rated syndicated loan.")
+    agency: str | None = Field(default=None, description="Only contractors paid by this agency (substring).")
+    state: str | None = Field(default=None, description="Two-letter recipient state.")
+    signal: str | None = Field(
+        default=None,
+        description="One signal instead of the stress default, e.g. marked_below_80, lenders_10pt_apart, cut_5pt_q3.",
+    )
+
+
+class TensorustContractorWatchData(Data):
+    """A federal contractor whose BDC lenders are marking its loan down."""
+
+    operating_company: str = Field(description="Federal award recipient.")
+    borrower: str | None = Field(default=None, description="Borrower name in BDC filings.")
+    uei: str | None = Field(default=None, description="SAM UEI.")
+    state: str | None = Field(default=None, description="Recipient state.")
+    federal_exposure: float | None = Field(
+        default=None, description="Larger of FY2025-to-date and DoD FY2024-26 obligations, USD."
+    )
+    top_agency: str | None = Field(default=None, description="Agency with the most obligations.")
+    latest_mark: float | None = Field(default=None, description="Latest BDC mark. " + MARK)
+    q3_change_points: float | None = Field(default=None, description="Worst Jun 30 to Sep 30 move, points.")
+    managers: int | None = Field(default=None, description="BDC managers on the loan.")
+    bdc_par: float | None = Field(default=None, description="BDC first-lien par, USD.")
+    headcount_change_pct: float | None = Field(default=None, description="Form 5500 participants, 2024 to 2025, %.")
+    signals: list[str] = Field(default_factory=list, description="Stress signals.")
+    market_priced: str | None = Field(default=None, description="public or bsl when already market priced.")
+
+
+class TensorustContractorWatchFetcher(Fetcher[TensorustContractorWatchQueryParams, list[TensorustContractorWatchData]]):
+    """contractor_credit_watch. Free: top 10; with a key: every name."""
+
+    require_credentials = False
+
+    @staticmethod
+    def transform_query(params: dict[str, Any]) -> TensorustContractorWatchQueryParams:
+        return TensorustContractorWatchQueryParams(**params)
+
+    @staticmethod
+    def extract_data(
+        query: TensorustContractorWatchQueryParams,
+        credentials: dict[str, str] | None,
+        **kwargs: Any,
+    ) -> dict[str, Any]:
+        args: dict[str, Any] = {
+            "sort": query.sort,
+            "agency": query.agency,
+            "state": query.state,
+            "signal": query.signal,
+        }
+        if query.private_only:
+            args["private_only"] = True
+        return call_tool("contractor_credit_watch", args, credentials)
+
+    @staticmethod
+    def transform_data(
+        query: TensorustContractorWatchQueryParams, data: dict[str, Any], **kwargs: Any
+    ) -> AnnotatedResult[list[TensorustContractorWatchData]]:
+        fields = set(TensorustContractorWatchData.model_fields)
+        rows = []
+        for x in data.get("items") or []:
+            known = {k: v for k, v in x.items() if k in fields}
+            known["signals"] = x.get("signals") or []
+            extra = {k: v for k, v in x.items() if k not in fields and k != "key"}
+            rows.append(TensorustContractorWatchData(**known, **extra))
+        meta: dict[str, Any] = {
+            k: data[k] for k in ("marks_as_of", "q3_filers", "q3_last_filed", "count", "federal_exposure") if k in data
+        }
+        note = access_note(data)
+        if note:
+            meta["access"] = note
+        return AnnotatedResult(result=rows, metadata=meta)

openbb_tensorust/models/credit.py

@@ -0,0 +1,261 @@
+"""Private credit: what BDC lenders mark a company's first-lien loan at.
+
+Source: SEC Business Development Company data sets (XBRL schedules of
+investments), first-lien term loans, fully funded, cost 85-110% of par.
+Marks are fractions of par (0.95 = 95% of par).
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from openbb_core.provider.abstract.annotated_result import AnnotatedResult
+from openbb_core.provider.abstract.data import Data
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.abstract.query_params import QueryParams
+from pydantic import Field
+
+from openbb_tensorust.client import access_note, call_tool, not_found
+
+MARK = "Fair value as a fraction of par (0.95 = 95% of par)."
+
+
+def _meta(data: dict[str, Any], *keys: str) -> dict[str, Any]:
+    out = {k: data[k] for k in keys if data.get(k) is not None}
+    note = access_note(data)
+    if note:
+        out["access"] = note
+    return out
+
+
+# ---- bdc_loan_marks -------------------------------------------------------------------------
+
+
+class TensorustBdcLoanMarksQueryParams(QueryParams):
+    """BDC loan marks query."""
+
+    company: str = Field(
+        description="Borrower name as BDC schedules of investments spell it. A prefix works ('Pluralsight')."
+    )
+
+
+class TensorustBdcLoanMarksData(Data):
+    """One BDC fund's mark on a company's first-lien term loan."""
+
+    company: str = Field(description="Borrower name.")
+    as_of: str | None = Field(default=None, description="Quarter end of the marks.")
+    fund: str = Field(description="BDC fund holding the loan.")
+    manager: str | None = Field(default=None, description="Fund manager.")
+    mark: float | None = Field(default=None, description=MARK)
+    prior_mark: float | None = Field(default=None, description="Prior-quarter mark (key only). " + MARK)
+    sep30_mark: float | None = Field(default=None, description="Sep 30 2026 mark if this fund has filed it (key only).")
+    sep30_filed: str | None = Field(default=None, description="Date the Sep 30 mark was filed (key only).")
+    par: float | None = Field(default=None, description="Par held by this fund, USD (key only).")
+    filing: str | None = Field(default=None, description="SEC filing link (key only).")
+
+
+class TensorustBdcLoanMarksFetcher(Fetcher[TensorustBdcLoanMarksQueryParams, list[TensorustBdcLoanMarksData]]):
+    """lender_marks: every BDC fund's mark on one borrower's first-lien loan."""
+
+    require_credentials = False
+
+    @staticmethod
+    def transform_query(params: dict[str, Any]) -> TensorustBdcLoanMarksQueryParams:
+        return TensorustBdcLoanMarksQueryParams(**params)
+
+    @staticmethod
+    def extract_data(
+        query: TensorustBdcLoanMarksQueryParams,
+        credentials: dict[str, str] | None,
+        **kwargs: Any,
+    ) -> dict[str, Any]:
+        return call_tool("lender_marks", {"name": query.company}, credentials)
+
+    @staticmethod
+    def transform_data(
+        query: TensorustBdcLoanMarksQueryParams, data: dict[str, Any], **kwargs: Any
+    ) -> AnnotatedResult[list[TensorustBdcLoanMarksData]]:
+        if not data.get("found"):
+            raise not_found(data, "BDC first-lien term loan")
+        company = data.get("company") or data.get("name") or query.company
+        as_of = data.get("as_of")
+        lenders = data.get("lenders")
+        if isinstance(lenders, list):  # full record
+            rows = [
+                TensorustBdcLoanMarksData(
+                    company=company,
+                    as_of=as_of,
+                    fund=x.get("fund"),
+                    manager=x.get("manager"),
+                    mark=x.get("mark"),
+                    prior_mark=x.get("prev_mark"),
+                    sep30_mark=x.get("q3_mark"),
+                    sep30_filed=x.get("q3_filed"),
+                    par=x.get("par"),
+                    filing=x.get("filing"),
+                )
+                for x in lenders
+            ]
+        else:
+            rows = [
+                TensorustBdcLoanMarksData(
+                    company=company, as_of=as_of, fund=x.get("fund"), manager=x.get("manager"), mark=x.get("mark")
+                )
+                for x in data.get("sample") or []
+            ]
+        meta = _meta(
+            data,
+            "funds",
+            "managers",
+            "loan_par_usd",
+            "maturity",
+            "lowest_mark",
+            "lowest_manager",
+            "highest_mark",
+            "highest_manager",
+            "gap_points",
+            "read",
+            "q3_so_far",
+            "signal",
+            "source",
+        )
+        if "gap_points" not in meta and isinstance(data.get("gap"), (int, float)):
+            meta["gap_points"] = round(data["gap"] * 100, 1)
+        return AnnotatedResult(result=rows, metadata=meta)
+
+
+# ---- credit_disagreements -------------------------------------------------------------------
+
+
+class TensorustCreditDisagreementsQueryParams(QueryParams):
+    """Loans BDC lenders disagree on. No parameters."""
+
+
+class TensorustCreditDisagreementsData(Data):
+    """A company whose first-lien loan two or more BDC managers mark 10+ points apart."""
+
+    company: str = Field(description="Borrower name.")
+    gap_points: float | None = Field(default=None, description="Highest minus lowest manager mark, in points of par.")
+    lowest_mark: float | None = Field(default=None, description="Lowest manager mark. " + MARK)
+    lowest_manager: str | None = Field(default=None, description="Manager with the lowest mark.")
+    highest_mark: float | None = Field(default=None, description="Highest manager mark. " + MARK)
+    highest_manager: str | None = Field(default=None, description="Manager with the highest mark.")
+    loan_par: float | None = Field(default=None, description="BDC par on the loan, USD.")
+    funds: int | None = Field(default=None, description="BDC funds holding the loan.")
+    managers: int | None = Field(default=None, description="Distinct managers (key only).")
+    maturity: str | None = Field(default=None, description="Loan maturity (key only).")
+
+
+class TensorustCreditDisagreementsFetcher(
+    Fetcher[TensorustCreditDisagreementsQueryParams, list[TensorustCreditDisagreementsData]]
+):
+    """credit_disagreements: widest gaps first. Free: top 10; with a key: all of them."""
+
+    require_credentials = False
+
+    @staticmethod
+    def transform_query(params: dict[str, Any]) -> TensorustCreditDisagreementsQueryParams:
+        return TensorustCreditDisagreementsQueryParams(**params)
+
+    @staticmethod
+    def extract_data(
+        query: TensorustCreditDisagreementsQueryParams,
+        credentials: dict[str, str] | None,
+        **kwargs: Any,
+    ) -> dict[str, Any]:
+        return call_tool("credit_disagreements", {}, credentials)
+
+    @staticmethod
+    def transform_data(
+        query: TensorustCreditDisagreementsQueryParams, data: dict[str, Any], **kwargs: Any
+    ) -> AnnotatedResult[list[TensorustCreditDisagreementsData]]:
+        rows = []
+        for x in data.get("items") or []:
+            gap = x.get("gap_points")
+            if gap is None and isinstance(x.get("gap"), (int, float)):
+                gap = round(x["gap"] * 100, 1)
+            rows.append(
+                TensorustCreditDisagreementsData(
+                    company=x.get("company") or x.get("name"),
+                    gap_points=gap,
+                    lowest_mark=x.get("lowest_mark", x.get("low")),
+                    lowest_manager=x.get("lowest_manager", x.get("low_manager")),
+                    highest_mark=x.get("highest_mark", x.get("high")),
+                    highest_manager=x.get("highest_manager", x.get("high_manager")),
+                    loan_par=x.get("loan_par_usd", x.get("par")),
+                    funds=x.get("funds"),
+                    managers=x.get("managers"),
+                    maturity=x.get("maturity"),
+                )
+            )
+        return AnnotatedResult(
+            result=rows,
+            metadata=_meta(data, "as_of", "companies_with_2plus_managers", "disagreements_10pt", "source"),
+        )
+
+
+# ---- credit_q3_cuts -------------------------------------------------------------------------
+
+
+class TensorustCreditQ3CutsQueryParams(QueryParams):
+    """Q3 2026 BDC markdowns. No parameters."""
+
+
+class TensorustCreditQ3CutsData(Data):
+    """A fund that cut its mark on a loan by 5+ points from Jun 30 to Sep 30 2026."""
+
+    company: str = Field(description="Borrower name.")
+    fund: str = Field(description="BDC fund that cut its mark.")
+    manager: str | None = Field(default=None, description="Fund manager (key only).")
+    jun30_mark: float | None = Field(default=None, description="Jun 30 2026 mark. " + MARK)
+    sep30_mark: float | None = Field(default=None, description="Sep 30 2026 mark. " + MARK)
+    change_points: float | None = Field(default=None, description="Sep 30 minus Jun 30, points of par.")
+    par: float | None = Field(default=None, description="Par held by this fund, USD.")
+    filed: str | None = Field(default=None, description="Date the Sep 30 mark was filed (key only).")
+    holders_not_filed_yet_above: int | None = Field(
+        default=None,
+        description="Other holders that have not filed Sep 30 yet and still carry the loan 5+ points higher.",
+    )
+
+
+class TensorustCreditQ3CutsFetcher(Fetcher[TensorustCreditQ3CutsQueryParams, list[TensorustCreditQ3CutsData]]):
+    """credit_q3_cuts: biggest cuts first. Free: top 10; with a key: all, with each pending holder."""
+
+    require_credentials = False
+
+    @staticmethod
+    def transform_query(params: dict[str, Any]) -> TensorustCreditQ3CutsQueryParams:
+        return TensorustCreditQ3CutsQueryParams(**params)
+
+    @staticmethod
+    def extract_data(
+        query: TensorustCreditQ3CutsQueryParams,
+        credentials: dict[str, str] | None,
+        **kwargs: Any,
+    ) -> dict[str, Any]:
+        return call_tool("credit_q3_cuts", {}, credentials)
+
+    @staticmethod
+    def transform_data(
+        query: TensorustCreditQ3CutsQueryParams, data: dict[str, Any], **kwargs: Any
+    ) -> AnnotatedResult[list[TensorustCreditQ3CutsData]]:
+        rows = []
+        for x in data.get("items") or []:
+            pending = x.get("not_filed_yet_above")
+            count = len(pending) if isinstance(pending, list) else x.get("holders_not_filed_yet_above")
+            extra: dict[str, Any] = {"pending_holders": pending} if isinstance(pending, list) else {}
+            rows.append(
+                TensorustCreditQ3CutsData(
+                    company=x.get("company"),
+                    fund=x.get("fund"),
+                    manager=x.get("manager"),
+                    jun30_mark=x.get("jun30"),
+                    sep30_mark=x.get("sep30"),
+                    change_points=x.get("change_points"),
+                    par=x.get("par"),
+                    filed=x.get("filed"),
+                    holders_not_filed_yet_above=count,
+                    **extra,
+                )
+            )
+        return AnnotatedResult(result=rows, metadata=_meta(data, "as_of", "funds_filed", "last_filing", "cuts_5pt"))

openbb_tensorust/models/exposure.py

@@ -0,0 +1,107 @@
+"""Research Exposure Ledger: federal awards whose papers name vendors on banned-vendor lists.
+
+Lists: DoD 1260H, Section 889 (FAR 52.204-25), FCC Covered List, DHS UFLPA
+Entity List, BIOSECURE. Evidence: Europe PMC, OpenAlex, Crossref, open-access
+PDFs, ENA and dbGaP; dollars from USAspending and NIH RePORTER.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from openbb_core.provider.abstract.annotated_result import AnnotatedResult
+from openbb_core.provider.abstract.data import Data
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.abstract.query_params import QueryParams
+from pydantic import Field
+
+from openbb_tensorust.client import access_note, call_tool, not_found
+
+
+class TensorustExposureInstitutionQueryParams(QueryParams):
+    """Exposure query for one institution."""
+
+    institution: str = Field(description="Federal award recipient name or UEI.")
+
+
+class TensorustExposureInstitutionData(Data):
+    """One federal award whose 2025-26 papers name a listed vendor."""
+
+    award: str = Field(description="Award id (FAIN).")
+    recipient: str | None = Field(default=None, description="Recipient name.")
+    agency: str | None = Field(default=None, description="Awarding agency.")
+    title: str | None = Field(default=None, description="Award title.")
+    fy25_obligations: float | None = Field(default=None, description="Whole-award FY2025 obligations, USD.")
+    fy26_amount: float | None = Field(default=None, description="FY2026 amount, USD.")
+    project_end: str | None = Field(default=None, description="Project end date.")
+    vendors: list[str] = Field(default_factory=list, description="Listed vendors named in the evidence.")
+    lists: list[str] = Field(default_factory=list, description="Lists the vendors are on.")
+    rules: dict[str, str] = Field(default_factory=dict, description="Rule id to status for this award.")
+    attribution: str | None = Field(default=None, description="broad, narrow or likely_paid.")
+    in_force_or_no_grace: bool | None = Field(
+        default=None, description="A consequence binds now or has no grace period."
+    )
+    papers: int | None = Field(default=None, description="Citing 2025-26 papers.")
+    latest_paper: str | None = Field(default=None, description="Date of the latest citing paper.")
+    evidence: str | None = Field(default=None, description="Sentence naming the vendor (key only).")
+    evidence_paper: str | None = Field(default=None, description="Link to the paper (key only).")
+
+
+class TensorustExposureInstitutionFetcher(
+    Fetcher[TensorustExposureInstitutionQueryParams, list[TensorustExposureInstitutionData]]
+):
+    """exposure_institution. Free: totals and the 5 largest awards; with a key: every award with evidence."""
+
+    require_credentials = False
+
+    @staticmethod
+    def transform_query(params: dict[str, Any]) -> TensorustExposureInstitutionQueryParams:
+        return TensorustExposureInstitutionQueryParams(**params)
+
+    @staticmethod
+    def extract_data(
+        query: TensorustExposureInstitutionQueryParams,
+        credentials: dict[str, str] | None,
+        **kwargs: Any,
+    ) -> dict[str, Any]:
+        return call_tool("exposure_institution", {"name": query.institution}, credentials)
+
+    @staticmethod
+    def transform_data(
+        query: TensorustExposureInstitutionQueryParams, data: dict[str, Any], **kwargs: Any
+    ) -> AnnotatedResult[list[TensorustExposureInstitutionData]]:
+        if not data.get("found"):
+            raise not_found(data, "award recipient with a listed-vendor paper")
+        rows = []
+        for a in data.get("items") or []:
+            row = {k: v for k, v in a.items() if v is not None}
+            row["vendors"] = a.get("vendors") or []
+            row["lists"] = a.get("lists") or []
+            row["rules"] = a.get("rules") or {}
+            rows.append(TensorustExposureInstitutionData(**row))
+        meta: dict[str, Any] = {
+            k: data[k]
+            for k in (
+                "institution",
+                "uei",
+                "state",
+                "as_of",
+                "awards",
+                "fy25",
+                "fy26",
+                "in_force_awards",
+                "in_force_fy25",
+                "narrow_awards",
+                "narrow_fy25",
+                "likely_paid_awards",
+                "likely_paid_fy25",
+                "by_list",
+                "rule_status_counts",
+                "ontology_id",
+            )
+            if k in data
+        }
+        note = access_note(data)
+        if note:
+            meta["access"] = note
+        return AnnotatedResult(result=rows, metadata=meta)

openbb_tensorust/models/idr.py

@@ -0,0 +1,128 @@
+"""No Surprises Act federal IDR: the offer band that wins for a code, payer and state.
+
+Source: CMS Federal IDR Public Use File, 2025 Q4, computed by Tensorust LLC
+(altered and aggregated; not CMS data as published).
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from openbb_core.provider.abstract.annotated_result import AnnotatedResult
+from openbb_core.provider.abstract.data import Data
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.abstract.query_params import QueryParams
+from pydantic import Field
+
+from openbb_tensorust.client import access_note, call_tool
+
+
+class TensorustIdrOfferQueryParams(QueryParams):
+    """IDR offer query."""
+
+    code: str = Field(description="CPT or HCPCS code, e.g. 99284.")
+    payer: str | None = Field(
+        default=None, description="Payer email domain or common name (uhc.com, aetna.com, cigna.com)."
+    )
+    state: str | None = Field(default=None, description="Two-letter state.")
+    entity: str | None = Field(default=None, description="Certified IDR entity (arbitrator), optional.")
+    qpa: float | None = Field(
+        default=None, description="Your qualifying payment amount in USD, for expected value (key or small cells)."
+    )
+
+
+class TensorustIdrOfferData(Data):
+    """The IDR cell that decides the dispute."""
+
+    code: str = Field(description="Service code.")
+    payer: str | None = Field(default=None, description="Payer domain matched.")
+    state: str | None = Field(default=None, description="State matched.")
+    level: str | None = Field(default=None, description="Which cell matched (code+payer+state, or a wider one).")
+    determinations: int | None = Field(default=None, description="Determinations in the cell.")
+    provider_win_rate_pct: float | None = Field(default=None, description="Share of line items providers won, %.")
+    offer_band_low_multiple: float | None = Field(
+        default=None, description="Median winning provider offer, multiple of QPA."
+    )
+    offer_band_high_multiple: float | None = Field(
+        default=None, description="75th percentile winning provider offer, multiple of QPA."
+    )
+    winning_p25_multiple: float | None = Field(
+        default=None, description="25th percentile winning offer, multiple of QPA (full)."
+    )
+    plan_median_offer_multiple: float | None = Field(
+        default=None, description="Median plan offer, multiple of QPA (full)."
+    )
+    losing_provider_median_offer_multiple: float | None = Field(
+        default=None, description="Median losing provider offer (full)."
+    )
+    median_days_to_determination: float | None = Field(
+        default=None, description="Median days to a determination (full)."
+    )
+    access: str | None = Field(default=None, description="preview, free (small cell) or key.")
+
+
+class TensorustIdrOfferFetcher(Fetcher[TensorustIdrOfferQueryParams, list[TensorustIdrOfferData]]):
+    """idr_offer. Free: win rate and offer band; with a key (or a cell under 50): quartiles, arbitrators, EV."""
+
+    require_credentials = False
+
+    @staticmethod
+    def transform_query(params: dict[str, Any]) -> TensorustIdrOfferQueryParams:
+        return TensorustIdrOfferQueryParams(**params)
+
+    @staticmethod
+    def extract_data(
+        query: TensorustIdrOfferQueryParams,
+        credentials: dict[str, str] | None,
+        **kwargs: Any,
+    ) -> dict[str, Any]:
+        return call_tool(
+            "idr_offer",
+            {"code": query.code, "payer": query.payer, "state": query.state, "entity": query.entity, "qpa": query.qpa},
+            credentials,
+        )
+
+    @staticmethod
+    def transform_data(
+        query: TensorustIdrOfferQueryParams, data: dict[str, Any], **kwargs: Any
+    ) -> AnnotatedResult[list[TensorustIdrOfferData]]:
+        q = data.get("query") or {}
+        matched = data.get("matched") or {}
+        cell = data.get("cell") or {}
+        band = data.get("recommended_offer_band") or {}
+        win = (cell.get("winning_multiple_of_qpa") or {}) if cell else {}
+        preview = data.get("preview") is True
+        row = TensorustIdrOfferData(
+            code=q.get("code") or query.code.upper(),
+            payer=q.get("payer"),
+            state=q.get("state"),
+            level=matched.get("level"),
+            determinations=matched.get("determinations"),
+            provider_win_rate_pct=cell.get("provider_win_rate_pct", data.get("provider_win_rate_pct")),
+            offer_band_low_multiple=band.get("low_multiple"),
+            offer_band_high_multiple=band.get("high_multiple"),
+            winning_p25_multiple=win.get("p25"),
+            plan_median_offer_multiple=cell.get("plan_median_offer_multiple"),
+            losing_provider_median_offer_multiple=cell.get("losing_provider_median_offer_multiple"),
+            median_days_to_determination=cell.get("median_days_to_determination"),
+            access="preview" if preview else data.get("access"),
+        )
+        meta = {
+            k: data[k]
+            for k in (
+                "cell",
+                "at_your_qpa",
+                "code_dollars_q4_2025",
+                "arbitrators_in_cell",
+                "chosen_arbitrator",
+                "entity_pick",
+                "flags",
+                "pricing",
+                "source",
+                "vintage",
+            )
+            if data.get(k) is not None
+        }
+        if preview:
+            meta["access"] = access_note(data)
+        return AnnotatedResult(result=[row], metadata=meta)

openbb_tensorust/router.py

@@ -0,0 +1,115 @@
+"""obb.tensorust: commands served by the Tensorust provider."""
+
+from openbb_core.app.model.command_context import CommandContext
+from openbb_core.app.model.example import APIEx
+from openbb_core.app.model.obbject import OBBject
+from openbb_core.app.provider_interface import (
+    ExtraParams,
+    ProviderChoices,
+    StandardParams,
+)
+from openbb_core.app.query import Query
+from openbb_core.app.router import Router
+
+router = Router(prefix="", description="Tensorust: private credit marks, contractor credit, exposure and IDR data.")
+
+
+@router.command(
+    model="TensorustBdcLoanMarks",
+    examples=[APIEx(parameters={"company": "Pluralsight", "provider": "tensorust"})],
+)
+async def bdc_loan_marks(
+    cc: CommandContext,
+    provider_choices: ProviderChoices,
+    standard_params: StandardParams,
+    extra_params: ExtraParams,
+) -> OBBject:
+    """What each BDC (private credit) fund marks one company's first-lien term loan at, as a fraction of par.
+
+    The results metadata carries the lowest and highest manager mark, the gap and Q3 2026 marks filed so far.
+    """
+    return await OBBject.from_query(Query(**locals()))
+
+
+@router.command(
+    model="TensorustCreditDisagreements",
+    examples=[APIEx(parameters={"provider": "tensorust"})],
+)
+async def credit_disagreements(
+    cc: CommandContext,
+    provider_choices: ProviderChoices,
+    standard_params: StandardParams,
+    extra_params: ExtraParams,
+) -> OBBject:
+    """Companies whose first-lien loan two or more BDC managers mark 10+ points apart, widest gap first."""
+    return await OBBject.from_query(Query(**locals()))
+
+
+@router.command(
+    model="TensorustCreditQ3Cuts",
+    examples=[APIEx(parameters={"provider": "tensorust"})],
+)
+async def credit_q3_cuts(
+    cc: CommandContext,
+    provider_choices: ProviderChoices,
+    standard_params: StandardParams,
+    extra_params: ExtraParams,
+) -> OBBject:
+    """Q3 2026 BDC markdowns of 5+ points as funds file their 10-Qs, with holders that have not filed yet."""
+    return await OBBject.from_query(Query(**locals()))
+
+
+@router.command(
+    model="TensorustContractorCredit",
+    examples=[APIEx(parameters={"contractor": "Peraton", "provider": "tensorust"})],
+)
+async def contractor_credit(
+    cc: CommandContext,
+    provider_choices: ProviderChoices,
+    standard_params: StandardParams,
+    extra_params: ExtraParams,
+) -> OBBject:
+    """One federal contractor: obligations, what its BDC lenders mark its loan at, headcount trend and signals."""
+    return await OBBject.from_query(Query(**locals()))
+
+
+@router.command(
+    model="TensorustContractorWatch",
+    examples=[APIEx(parameters={"sort": "q3", "provider": "tensorust"})],
+)
+async def contractor_watch(
+    cc: CommandContext,
+    provider_choices: ProviderChoices,
+    standard_params: StandardParams,
+    extra_params: ExtraParams,
+) -> OBBject:
+    """Federal contractors whose BDC lenders are marking their loans down."""
+    return await OBBject.from_query(Query(**locals()))
+
+
+@router.command(
+    model="TensorustExposureInstitution",
+    examples=[APIEx(parameters={"institution": "Harvard", "provider": "tensorust"})],
+)
+async def exposure_institution(
+    cc: CommandContext,
+    provider_choices: ProviderChoices,
+    standard_params: StandardParams,
+    extra_params: ExtraParams,
+) -> OBBject:
+    """Federal awards of one institution whose 2025-26 papers name a vendor on a banned-vendor list."""
+    return await OBBject.from_query(Query(**locals()))
+
+
+@router.command(
+    model="TensorustIdrOffer",
+    examples=[APIEx(parameters={"code": "99284", "payer": "uhc.com", "state": "TX", "provider": "tensorust"})],
+)
+async def idr_offer(
+    cc: CommandContext,
+    provider_choices: ProviderChoices,
+    standard_params: StandardParams,
+    extra_params: ExtraParams,
+) -> OBBject:
+    """No Surprises Act federal IDR: provider win rate and the winning offer band for a code, payer and state."""
+    return await OBBject.from_query(Query(**locals()))

openbb_tensorust-0.1.0.dist-info/METADATA

@@ -0,0 +1,65 @@
+Metadata-Version: 2.5
+Name: openbb-tensorust
+Version: 0.1.0
+Summary: OpenBB extension for Tensorust data: BDC private credit loan marks, federal contractor credit, banned-vendor exposure in federal awards and No Surprises Act IDR offer bands.
+Project-URL: Homepage, https://tensorust.com
+Project-URL: Source, https://github.com/Mattbusel/openbb-tensorust
+Project-URL: Documentation, https://github.com/Mattbusel/openbb-tensorust/blob/main/docs/index.md
+Project-URL: Changelog, https://github.com/Mattbusel/openbb-tensorust/blob/main/CHANGELOG.md
+Project-URL: Workspace backend, https://shop.tensorust.com/api/openbb
+Author: Matthew Busel
+License-Expression: MIT
+License-File: LICENSE
+Keywords: bdc,federal-contracts,finance,loan-marks,no-surprises-act,openbb,private-credit,sanctions
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.10
+Requires-Dist: openbb-core<3,>=1.6
+Requires-Dist: requests>=2.31
+Description-Content-Type: text/markdown
+
+# openbb-tensorust
+
+An [OpenBB Platform](https://github.com/OpenBB-finance/OpenBB) extension for
+[Tensorust](https://tensorust.com) data, built from US public records.
+
+```bash
+pip install openbb openbb-tensorust
+openbb-build   # once, so obb picks up the new commands
+```
+
+```python
+from openbb import obb
+
+obb.tensorust.credit_disagreements().to_df()            # loans BDC lenders mark 10+ points apart
+obb.tensorust.bdc_loan_marks(company="Pluralsight").to_df()
+obb.tensorust.credit_q3_cuts().to_df()                  # Q3 2026 markdowns as BDCs file
+obb.tensorust.contractor_credit(contractor="Peraton")
+obb.tensorust.contractor_watch(sort="q3").to_df()
+obb.tensorust.exposure_institution(institution="Harvard").to_df()
+obb.tensorust.idr_offer(code="99284", payer="uhc.com", state="TX")
+```
+
+| Command | Answers |
+|---|---|
+| `bdc_loan_marks` | What each BDC fund marks one company's first-lien loan at (SEC schedules of investments) |
+| `credit_disagreements` | Loans two or more BDC managers mark 10+ points apart |
+| `credit_q3_cuts` | Fund-level cuts of 5+ points from Jun 30 to Sep 30 2026, and who has not filed yet |
+| `contractor_credit` | A federal contractor's obligations, lender marks, headcount trend and stress signals |
+| `contractor_watch` | Federal contractors whose lenders are marking them down |
+| `exposure_institution` | Federal awards whose papers name vendors on the 1260H, Section 889, FCC Covered, UFLPA or BIOSECURE lists |
+| `idr_offer` | No Surprises Act federal IDR: provider win rate and the winning offer band by code, payer and state |
+
+No key is needed: every command answers a free preview (top 10 rows, or a summary).
+Set `obb.user.credentials.tensorust_api_key = "tdk_..."` (or `TENSORUST_API_KEY`) for full
+records. The same data loads in OpenBB Workspace as a custom backend:
+`https://shop.tensorust.com/api/openbb`.
+
+Docs: https://github.com/Mattbusel/openbb-tensorust/blob/main/docs/index.md

openbb_tensorust-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+openbb_tensorust/__init__.py,sha256=OlgfZYk3nSHy6plIWR1sIr0NPcHswxuWddY-pd3Duhk,2242
+openbb_tensorust/client.py,sha256=VDEk61OgFEN62NuUqwEX3kguX585RSNxZFuo_EOIT9Q,4427
+openbb_tensorust/router.py,sha256=UOoAZO7g_B3YunyudExfPLvIOOqeRWaVt3UluhyZSeE,3961
+openbb_tensorust/models/__init__.py,sha256=hCiRAV6sAyhJXHnLoUVl3LJNHXyDbSZRhdLNf3bxMJM,33
+openbb_tensorust/models/contractor.py,sha256=qpDyPrVXC_OoLcL4zAf4kd2ImkV9DamXbrq-5cSxiyU,9800
+openbb_tensorust/models/credit.py,sha256=rT0Hu2nIV7-JhUqDN_8CfDi_FmatvKXKAWCN6Rth_pQ,11113
+openbb_tensorust/models/exposure.py,sha256=2IXylKGibxnL3jVbVoBdSjma4IVfAvmURfEODMGG7E0,4658
+openbb_tensorust/models/idr.py,sha256=0lYLfswK9HQ51bxquRoviyHYo7JtqNesnSWGdAr7Atc,5506
+openbb_tensorust-0.1.0.dist-info/METADATA,sha256=8TeHWBOD6Vm6Lj4DmKJoMRtIlVZ-r-L5d7bocyUXRZQ,3321
+openbb_tensorust-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+openbb_tensorust-0.1.0.dist-info/entry_points.txt,sha256=XqO7mOh_vDsRGmJheNHYiM6QmE0vwkgXCB9feUsydZ8,144
+openbb_tensorust-0.1.0.dist-info/licenses/LICENSE,sha256=TpCqwl9Iq4EFUnYGbR2dGUSmF5tDy-hCISSPJasaP10,1070
+openbb_tensorust-0.1.0.dist-info/RECORD,,

openbb_tensorust-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

openbb_tensorust-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[openbb_core_extension]
+tensorust = openbb_tensorust.router:router
+
+[openbb_provider_extension]
+tensorust = openbb_tensorust:tensorust_provider

openbb_tensorust-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthew Busel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.