Test fixture: concrete subclass that overrides embedding_text.

Inline text input (tests / pre-cleaned content).

A single node in a TreeKnowledge. `summary` is mandatory because agents navigate by reading it. `content` is the optional full-text body (typ

Knobs specific to paper_flow.

Common output shape of every fetch.* function.

Typed provenance reference. Replaces a bare ``source: str``.

Test hook that records every lifecycle call on a shared list.

Arxiv id (e.g. ``2604.12345``) or full arxiv URL.

Arxiv-specific fetch result with metadata attached. All metadata fields default to empty/None so callers can construct instances incrementall

An earnings-release extraction (one filing -> one Earnings card).

Records which flow + model produced this knowledge item.

A single factor card (stub).

A single news event extraction.

Distilled summary card of a `Paper`. The store layer keys this off ``paper_id`` so the card and its tree can be retrieved together. The card

Base configuration shared by all flows.

A pointer back to the source span an extracted fact came from.

A research paper as a tree of sections. The tree's nodes carry per-section ``summary`` (for navigation) and, on leaves, the section ``content

An investment thesis card (stub).

Fan out every lifecycle method to each wrapped hook in order. Exceptions from earlier hooks short-circuit the rest by design — hooks are inte

Aggregate result of running a flow over many inputs. ``results[i]`` is the output for ``inputs[i]`` or ``None`` if that input failed. ``error

Raised when PyMuPDF refuses to open the byte stream.

Raised when an arXiv id/URL cannot be parsed.

Custom formatter with color support for different log levels.

Subset of Crossref's ``works/{doi}`` response we surface to callers.

A DOI to be resolved by ``preprocess.fetch.doi``.

Knobs specific to earnings_flow.

Any web URL; PDF vs HTML is decided by content-type.

Filesystem path to a PDF / HTML / Markdown file.

Knobs specific to news_flow.

Fetched bytes have a content type paper_flow cannot route to a parser.

Parent of every flow's discriminated-union input member.

Root of every quantmind knowledge type. All three shapes (Flatten / Tree / Graph) share this field set; subclasses add domain-specific payloa

Marker base for flat domain cards. Subclasses add a typed payload (e.g. ``summary``, ``methodology``, ``revenue``). They MUST override `embed

Reserved for cross-item edges. NOT IMPLEMENTED. Future shape (sketched, subject to change): - ``nodes: dict[UUID, NodeRef]`` where ``NodeRef

Inline headline text (no body fetching).

URL to an earnings release / IR filing.

Single news article URL.

Output schema returned by the resolver agent.

RSS/Atom feed URL to be polled for items.

Ticker + reporting period (e.g. ``AAPL`` / ``2026Q1``).