@pentatonic-ai/ai-agent-sdk 0.9.6 → 0.10.0

package/packages/memory-engine-v2/docker-compose.aws.yml

@@ -0,0 +1,78 @@
+# AWS overlay for pentatonic-memory-engine v2.
+#
+# Differences vs the base compose:
+#   - Volumes bind-mounted under /var/lib/pme-v2/* so AWS Backup
+#     snapshots map cleanly to per-layer data dirs (matches v1's
+#     pattern).
+#   - org-model + extractor-async tuned for production (more
+#     connection pool headroom, longer claim TTL).
+#   - cloudflared added as a service so v2 is reachable via the
+#     same tunnel + Access policy v1 uses (until the memory-proxy
+#     Worker lands).
+#
+# Apply:
+#   docker compose --env-file .env \
+#     -f docker-compose.yml -f docker-compose.aws.yml up -d --build
+#
+# Cloudflared expects TUNNEL_TOKEN in the env file. The token is the
+# same one v1 uses unless you've cut a separate tunnel for v2.
+
+services:
+  org-model:
+    environment:
+      # Production tuning: bigger shared_buffers for the materialised
+      # views, more connection slots for the extractor + compat pools.
+      POSTGRES_SHARED_BUFFERS: "1GB"
+      POSTGRES_MAX_CONNECTIONS: "200"
+    volumes:
+      - /var/lib/pme-v2/org-model:/var/lib/postgresql/data
+      - ./org-model/migrations:/docker-entrypoint-initdb.d:ro
+
+  vector-index:
+    environment:
+      # Qdrant prod settings: allow more storage threads, log INFO.
+      QDRANT__STORAGE__PERFORMANCE__MAX_OPTIMIZATION_THREADS: "4"
+      QDRANT__LOG_LEVEL: "INFO"
+    volumes:
+      - /var/lib/pme-v2/vector-index:/qdrant/storage
+
+  extractor-sync:
+    environment:
+      PG_DSN: ${PME_V2_PG_DSN}
+
+  extractor-async:
+    environment:
+      PG_DSN: ${PME_V2_PG_DSN}
+      LLM_ENDPOINT: ${PME_V2_LLM_ENDPOINT:-}
+      LLM_API_KEY: ${PENTATONIC_AI_GATEWAY_KEY:-}
+      POLL_INTERVAL_SEC: "10"
+      CLAIM_TTL_SEC: "600"
+
+  compat:
+    environment:
+      PG_DSN: ${PME_V2_PG_DSN}
+      VECTOR_INDEX_URL: http://vector-index:6333
+      EXTRACTOR_SYNC_URL: http://extractor-sync:8101
+      NV_EMBED_URL: ${NV_EMBED_URL}
+      NV_EMBED_API_KEY: ${PENTATONIC_AI_GATEWAY_KEY}
+      NV_EMBED_PROVIDER: pentatonic-gateway
+      EMBED_DIM: "4096"
+
+  # Cloudflared tunnel — same pattern as v1. Optional; only start if
+  # you want v2 reachable via the public tunnel before the memory-proxy
+  # Worker migration lands.
+  cloudflared:
+    image: cloudflare/cloudflared:latest
+    container_name: pme2-cloudflared
+    restart: unless-stopped
+    # --protocol http2 matches the v1 setup: forces TCP/7844 instead of
+    # QUIC/UDP/7844, which is more robust through restrictive outbound
+    # firewalls / NATs and matches how v1's tunnel was running. Keep
+    # parity so the cutover doesn't change any tunnel-level behaviour
+    # the operator's used to.
+    command: tunnel --no-autoupdate --protocol http2 run --token ${TUNNEL_TOKEN_V2}
+    networks:
+      - engine-net
+    depends_on:
+      compat:
+        condition: service_healthy

package/packages/memory-engine-v2/docker-compose.yml

@@ -0,0 +1,206 @@
+name: pentatonic-memory-engine-v2
+
+# pentatonic-memory-engine v2 — keystone-first rebuild.
+#
+# 3 stores, not 7:
+#   - org-model (Postgres): structured extraction; source of truth for
+#     "what the company knows". Most queries answer here without
+#     touching the vector index.
+#   - vector-index (Qdrant): single binary, mmap + filtered search by
+#     default. Holds embeddings + lightweight payloads only. Cited by
+#     org-model via provenance pointers (late materialisation).
+#   - compat shim (FastAPI): wire-format compatible with v1's
+#     /store, /store-batch, /search, /forget. Routes writes through
+#     extractor-sync (deterministic fast path) before indexing.
+#     Routes reads via the typed-router architecture.
+#
+# Extraction is split:
+#   - extractor-sync: deterministic per-source rules (entities,
+#     mentions, content-hash, basic typing). Inline on the write path,
+#     no LLM. Fast — does not block the consumer DO drain.
+#   - extractor-async: LLM-driven distillation (decisions, commitments,
+#     summaries). Reads from a `distillation_queue` table in
+#     org-model; writes facts back. Independent of write-path latency.
+#
+# Embed gateway is external — same as v1's `NV_EMBED_URL` env. In
+# prod this points at the GH200 / Lambda Cloud gateway. Local dev
+# can point at the same shared dev endpoint.
+#
+# Bring up:        docker compose up -d
+# API surface:     http://localhost:${PME_V2_COMPAT_PORT:-8099}
+# Health:          curl http://localhost:${PME_V2_COMPAT_PORT:-8099}/health
+
+x-engine-base: &engine-base
+  restart: unless-stopped
+  networks:
+    - engine-net
+
+services:
+  # --------------------------------------------------------------------
+  # org-model — Postgres holding the canonical org model.
+  #
+  # Schema includes provenance + participant set + disclosure class
+  # columns from day one. See org-model/migrations/001_init.sql for
+  # the canonical schema definition and the rationale comments.
+  # --------------------------------------------------------------------
+  org-model:
+    <<: *engine-base
+    image: postgres:16-alpine
+    container_name: pme2-org-model
+    ports: ["127.0.0.1:${PME_V2_ORG_MODEL_PORT:-15432}:5432"]
+    environment:
+      POSTGRES_USER: ${PME_V2_PG_USER:-pme}
+      POSTGRES_PASSWORD: ${PME_V2_PG_PASSWORD:-local-dev-pw}
+      POSTGRES_DB: ${PME_V2_PG_DB:-org_model}
+    volumes:
+      - pme2-org-model-data:/var/lib/postgresql/data
+      - ./org-model/migrations:/docker-entrypoint-initdb.d:ro
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${PME_V2_PG_USER:-pme} -d ${PME_V2_PG_DB:-org_model}"]
+      interval: 5s
+      timeout: 3s
+      retries: 30
+      start_period: 20s
+
+  # --------------------------------------------------------------------
+  # vector-index — Qdrant.
+  #
+  # Single-node, mmap-by-default, payload-indexed for fast filtered
+  # search on (arena, kind, recency). Replaces the four vector
+  # materialisations in v1 (L4-vec, L4-QMD, L5, L6).
+  #
+  # Quantization (SQ8) is configured per-collection at creation time
+  # by compat/server.py on startup; not a compose-level concern.
+  # --------------------------------------------------------------------
+  vector-index:
+    <<: *engine-base
+    image: qdrant/qdrant:v1.12.4
+    container_name: pme2-vector-index
+    ports:
+      - "127.0.0.1:${PME_V2_QDRANT_HTTP_PORT:-16333}:6333"
+      - "127.0.0.1:${PME_V2_QDRANT_GRPC_PORT:-16334}:6334"
+    environment:
+      QDRANT__SERVICE__HTTP_PORT: "6333"
+      QDRANT__SERVICE__GRPC_PORT: "6334"
+      # mmap by default — disk-resident, page-cache governed.
+      # Avoids the v1 "everything pinned in RAM" problem.
+      QDRANT__STORAGE__PERFORMANCE__MAX_OPTIMIZATION_THREADS: "2"
+    volumes:
+      - pme2-vector-index-data:/qdrant/storage
+    healthcheck:
+      # qdrant image has bash but no curl/wget. Use bash's built-in
+      # /dev/tcp to confirm the port is accepting connections — enough
+      # to gate dependents on the service being up.
+      test: ["CMD", "bash", "-c", "</dev/tcp/localhost/6333"]
+      interval: 5s
+      timeout: 3s
+      retries: 30
+      start_period: 20s
+
+  # --------------------------------------------------------------------
+  # extractor-sync — deterministic fast-path extraction.
+  #
+  # Inline on the compat shim's write path. No LLM. Per-source
+  # rules (slack → chat, drive → doc, gmail → note, calendar → event,
+  # etc.) extract entities + content-hash + canonical typing.
+  # Writes provisional facts into org-model + enqueues an entry on
+  # the distillation_queue for the async worker to upgrade with LLM
+  # extraction later.
+  #
+  # See extractor-sync/server.py for the per-source rule registry.
+  # --------------------------------------------------------------------
+  extractor-sync:
+    <<: *engine-base
+    build:
+      context: ./extractor-sync
+      dockerfile: Dockerfile
+    container_name: pme2-extractor-sync
+    ports: ["127.0.0.1:${PME_V2_EXTRACTOR_SYNC_PORT:-8101}:8101"]
+    environment:
+      PG_DSN: ${PME_V2_PG_DSN:-postgresql://pme:local-dev-pw@org-model:5432/org_model}
+    depends_on:
+      org-model:
+        condition: service_healthy
+    healthcheck:
+      # python:slim base image has no wget; use urllib instead.
+      test: ["CMD", "python", "-c", "import urllib.request,sys; urllib.request.urlopen('http://localhost:8101/health',timeout=3)"]
+      interval: 10s
+      timeout: 5s
+      retries: 20
+      start_period: 15s
+
+  # --------------------------------------------------------------------
+  # extractor-async — LLM-driven distillation worker.
+  #
+  # Reads from org-model's distillation_queue table, runs LLM
+  # extraction against the provisional facts that extractor-sync
+  # laid down, and writes back the upgraded versions. Independent
+  # of the write-path — runs at its own cadence, retries on failure,
+  # never blocks the consumer drain.
+  #
+  # In prod this calls out to the same embed/LLM gateway compat does
+  # (NV_EMBED_URL + a chat-completions LLM endpoint).
+  # --------------------------------------------------------------------
+  extractor-async:
+    <<: *engine-base
+    build:
+      context: ./extractor-async
+      dockerfile: Dockerfile
+    container_name: pme2-extractor-async
+    environment:
+      PG_DSN: ${PME_V2_PG_DSN:-postgresql://pme:local-dev-pw@org-model:5432/org_model}
+      LLM_ENDPOINT: ${PME_V2_LLM_ENDPOINT:-http://localhost:8000/v1/chat/completions}
+      LLM_API_KEY: ${PENTATONIC_AI_GATEWAY_KEY:-}
+      POLL_INTERVAL_SEC: "5"
+    depends_on:
+      org-model:
+        condition: service_healthy
+
+  # --------------------------------------------------------------------
+  # compat — FastAPI shim, wire-format compatible with v1.
+  #
+  # /store, /store-batch       → extractor-sync → org-model + vector-index
+  # /search                    → typed-router → org-model and/or vector-index
+  # /forget                    → org-model deletes + vector-index payload filter
+  # /health, /health/deep      → reports all three stores
+  # /aggregate, /people-list   → org-model (graph-as-derived-view)
+  #
+  # Same external port as v1 (8099) so a TES env-var flip is the
+  # only thing needed to point traffic at v2.
+  # --------------------------------------------------------------------
+  compat:
+    <<: *engine-base
+    build:
+      context: ./compat
+      dockerfile: Dockerfile
+    container_name: pme2-compat
+    ports: ["${PME_V2_COMPAT_PORT:-8099}:8099"]
+    environment:
+      PG_DSN: ${PME_V2_PG_DSN:-postgresql://pme:local-dev-pw@org-model:5432/org_model}
+      VECTOR_INDEX_URL: ${PME_V2_VECTOR_INDEX_URL:-http://vector-index:6333}
+      EXTRACTOR_SYNC_URL: ${PME_V2_EXTRACTOR_SYNC_URL:-http://extractor-sync:8101}
+      NV_EMBED_URL: ${NV_EMBED_URL:-http://nv-embed:8041/v1/embeddings}
+      NV_EMBED_API_KEY: ${PENTATONIC_AI_GATEWAY_KEY:-}
+      NV_EMBED_PROVIDER: ${NV_EMBED_PROVIDER:-pentatonic-gateway}
+      EMBED_DIM: ${PME_V2_EMBED_DIM:-4096}
+    depends_on:
+      org-model:
+        condition: service_healthy
+      vector-index:
+        condition: service_healthy
+      extractor-sync:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "python", "-c", "import urllib.request,sys; urllib.request.urlopen('http://localhost:8099/health',timeout=3)"]
+      interval: 10s
+      timeout: 5s
+      retries: 30
+      start_period: 30s
+
+volumes:
+  pme2-org-model-data:
+  pme2-vector-index-data:
+
+networks:
+  engine-net:
+    driver: bridge

package/packages/memory-engine-v2/extractor-async/Dockerfile

@@ -0,0 +1,14 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY worker.py .
+# Pure helper modules — sibling imports inside worker.py
+# (noise_filter, confidence). The test_*.py files are intentionally
+# excluded; they're for local pytest, not container runtime.
+COPY noise_filter.py confidence.py ./
+
+CMD ["python", "worker.py"]

package/packages/memory-engine-v2/extractor-async/confidence.py

@@ -0,0 +1,62 @@
+"""confidence — fact confidence promotion based on multi-source corroboration.
+
+Today every fact lands in org_model at confidence 0.5 / stage 'provisional'
+and never moves. Live-data audit (2026-05-25): EVERY fact across 200
+sampled rows in pentatonic-team is stuck at 0.5 — no signal of
+"how trustworthy is this?" reaches the read side.
+
+The right signal is **multi-source corroboration**: the same statement
+appearing in two emails AND a calendar event is meaningfully more
+trustworthy than a one-off mention in a Slack DM. The extractor
+already records `provenance_event_ids` (the list of source events
+that mention each fact), so the data needed for promotion is there
+— we just don't use it.
+
+Formula:
+
+    confidence = min(0.5 + 0.15 * (n_sources - 1), 0.9)
+
+Concretely:
+
+    1 source  →  0.50  (single mention, default)
+    2 sources →  0.65  (one corroboration)
+    3 sources →  0.80
+    4 sources →  0.90  (cap; "verified" remains human-only)
+    5+        →  0.90
+
+Cap at 0.9 reserves the [0.9, 1.0] range for human-verified facts
+(`stage = 'verified'`), which the extractor cannot produce on its
+own. We never bump the stage from `provisional` to `distilled` or
+`verified` from this code path — corroboration is a signal, not a
+promotion. Stage transitions stay deliberate / explicit.
+
+Pure module — no I/O, no deps. Importable from worker.py without
+pulling in psycopg / httpx.
+"""
+
+from __future__ import annotations
+
+# Bump-per-additional-source. Tuned so:
+#   1 → 0.50  (base)
+#   2 → 0.65
+#   3 → 0.80
+#   4 → 0.90 (cap reached)
+# Picked instead of a smooth log/sqrt because the read-side bucket
+# boundaries (UI badge colours) align cleanly with these steps.
+_CONF_PER_SOURCE = 0.15
+_CONF_BASE = 0.5
+_CONF_CAP = 0.9
+
+
+def corroborated_confidence(n_sources: int) -> float:
+    """Confidence score for a fact corroborated by `n_sources` events.
+
+    `n_sources <= 0` returns the base confidence — never negative,
+    never above the cap. Pure function for easy unit testing.
+    """
+    if n_sources <= 1:
+        return _CONF_BASE
+    bumped = _CONF_BASE + _CONF_PER_SOURCE * (n_sources - 1)
+    if bumped > _CONF_CAP:
+        return _CONF_CAP
+    return round(bumped, 2)

package/packages/memory-engine-v2/extractor-async/noise_filter.py

@@ -0,0 +1,144 @@
+"""noise_filter — drop junk entity names before they enter the graph.
+
+The extractor-async LLM pulls "entities" from event content, but the
+model has no way to know which proper nouns are real and which are
+artefacts of the prompt or transcript. Live-data audit of the
+pentatonic-team arena (2026-05-25) found the following classes of
+junk under entity_type=person / other:
+
+  - First-person pronouns: "i", "me", "my", "myself"
+  - Second-person pronouns: "you", "yourself"
+  - Plural first-person: "we", "us", "ourselves"
+  - Generic referents: "agent", "the user", "the speaker",
+    "the guy who wrote it", "both of you"
+  - Tailscale hostnames the agent emits in scratchpad text:
+    "pin-dev-office-01.tail4aaf0c.ts.net"
+  - Worktree/agent labels the orchestrator leaks into transcripts:
+    "Agent A — L2 provenance taint", "Agent B"
+  - Filesystem paths: "/Users/admin/cursor/Pip",
+    "src/memory-engine/compat/server.py"
+  - Single-character or empty strings: "i", "a", ""
+
+These are precise patterns, not heuristics. The intent is "if a
+human looked at this row they'd say 'that's not a thing' immediately",
+not "low-confidence extraction" — those keep their place in the graph
+with the existing confidence scoring. The bar for adding a new
+pattern: it appears repeatedly in real arena data AND there is no
+realistic case where the same string could be a legitimate entity.
+
+Pure module — no I/O, no deps. Importable from worker.py without
+pulling in psycopg / httpx, and importable from tests without any
+fixtures.
+"""
+
+from __future__ import annotations
+
+import re
+
+# --------------------------------------------------------------------
+# Pattern banks
+# --------------------------------------------------------------------
+
+# Lowercased exact-match drops. Order doesn't matter; lookup is O(1).
+_NOISE_EXACT: frozenset[str] = frozenset(
+    {
+        # First-person
+        "i", "me", "my", "mine", "myself",
+        # Second-person
+        "you", "your", "yours", "yourself",
+        # Plural first-person
+        "we", "us", "our", "ours", "ourselves",
+        # Plural second-person
+        "y'all", "yall",
+        # Generic referents the LLM falls back to
+        "agent", "the agent", "user", "the user",
+        "speaker", "the speaker", "author", "the author",
+        "person", "the person", "someone", "anyone",
+        "everyone", "nobody", "no one", "everybody",
+        # Spurious meta the prompt sometimes echoes
+        "transcript", "meeting", "the meeting", "this",
+        "that", "the conversation", "conversation",
+    }
+)
+
+# Substring/regex drops. Slower (linear scan), so kept small. Each
+# pattern is anchored to be precise.
+_NOISE_REGEX: tuple[re.Pattern[str], ...] = (
+    # Tailscale hostnames (always have .ts.net suffix). Real
+    # companies don't have ".ts.net" in their canonical name.
+    re.compile(r"\.ts\.net$", re.IGNORECASE),
+    # Filesystem paths — absolute or repo-rooted. A real entity name
+    # never contains "/" (commercial slashes like "and/or" don't
+    # land as entity names) or starts with "src/".
+    re.compile(r"^/[A-Za-z]"),
+    re.compile(r"^[A-Za-z]+/[A-Za-z]"),
+    # Worktree labels emitted by parallel-agent orchestrators. The
+    # em-dash + descriptive suffix is the dead giveaway.
+    re.compile(r"^Agent [A-Z]\s*[—–-]", re.IGNORECASE),
+    # Long descriptive sentence-shapes ("the guy who wrote it",
+    # "both of you", "the team that handles this"). Heuristic:
+    # entity names with >3 spaces AND lowercase first letter aren't
+    # canonical proper nouns.
+    re.compile(r"^[a-z][a-z\s']*\s\S+\s\S+\s\S+"),
+)
+
+
+# --------------------------------------------------------------------
+# Public API
+# --------------------------------------------------------------------
+
+
+def is_noise_entity_name(entity_type: str, name: str) -> bool:
+    """Return True when `name` is junk that should never enter the
+    entities table. The decision is independent of `entity_type` for
+    most patterns, but the param is kept so future per-type rules
+    have a place (e.g. "any 'person' shorter than 2 chars" without
+    rejecting "AI" as a concept).
+
+    Args:
+        entity_type: lowercased entity type ("person", "company",
+            "concept", "topic", "place", "date", "other").
+        name: the canonical name the LLM extracted, pre-cleaning.
+
+    Returns:
+        True if the name should be dropped, False if it should be
+        upserted. Empty / whitespace-only names always drop.
+    """
+    if not isinstance(name, str):
+        return True
+    cleaned = name.strip()
+    if not cleaned:
+        return True
+
+    # Single-character drops are always junk for any entity type.
+    # "AI" and "ML" (legitimate 2-char concepts) are kept by the
+    # >=2 length floor below.
+    if len(cleaned) < 2:
+        return True
+
+    lowered = cleaned.lower()
+
+    # Exact-match drops (pronouns, generic referents).
+    if lowered in _NOISE_EXACT:
+        return True
+
+    # Per-type fine-grained rules. Person entities have a higher bar
+    # because every junk person creates a fake node in the relationship
+    # graph; companies/concepts get a lighter touch since proper-noun
+    # uniqueness is more naturally enforced.
+    if entity_type == "person":
+        # Person names without any uppercase letter are almost always
+        # junk ("the user", "the guy", "someone"). Real names — even
+        # all-lowercase handles like "philip" — are extremely rare;
+        # the LLM almost always title-cases when it has a real signal.
+        # Allow if the lower string contains '@' (an email) since
+        # that's a legitimate signal we don't want to lose.
+        if cleaned == lowered and "@" not in cleaned:
+            return True
+
+    # Regex drops (Tailscale, paths, agent-worktree labels).
+    for pattern in _NOISE_REGEX:
+        if pattern.search(cleaned):
+            return True
+
+    return False

package/packages/memory-engine-v2/extractor-async/requirements.txt

@@ -0,0 +1,2 @@
+psycopg[binary,pool]==3.2.3
+httpx==0.27.2

package/packages/memory-engine-v2/extractor-async/test_confidence.py

@@ -0,0 +1,76 @@
+"""Tests for confidence — fact confidence promotion formula.
+
+Run: pytest packages/memory-engine-v2/extractor-async/test_confidence.py
+"""
+
+from __future__ import annotations
+
+import pytest
+
+from confidence import corroborated_confidence
+
+
+class TestCorroboratedConfidence:
+    """The promotion ladder: 1 → 0.5, 2 → 0.65, 3 → 0.8, 4+ → 0.9."""
+
+    def test_single_source_base(self):
+        assert corroborated_confidence(1) == 0.5
+
+    def test_two_sources_first_bump(self):
+        assert corroborated_confidence(2) == 0.65
+
+    def test_three_sources_second_bump(self):
+        assert corroborated_confidence(3) == 0.80
+
+    def test_four_sources_at_cap(self):
+        assert corroborated_confidence(4) == 0.90
+
+    def test_five_sources_clamped_at_cap(self):
+        # The cap reserves [0.9, 1.0] for human-verified facts. No
+        # amount of corroboration alone can push a fact above 0.9.
+        assert corroborated_confidence(5) == 0.90
+        assert corroborated_confidence(50) == 0.90
+        assert corroborated_confidence(1_000) == 0.90
+
+    def test_zero_or_negative_falls_back_to_base(self):
+        # Defensive: should never happen in practice (provenance is
+        # always >= 1 by the time this is called), but the helper
+        # tolerates pathological inputs without spitting NaN.
+        assert corroborated_confidence(0) == 0.5
+        assert corroborated_confidence(-3) == 0.5
+
+    def test_monotonic_non_decreasing(self):
+        # The function must be monotonically non-decreasing — more
+        # corroboration is never less confident.
+        prev = -1.0
+        for n in range(1, 20):
+            cur = corroborated_confidence(n)
+            assert cur >= prev, (n, cur, prev)
+            prev = cur
+
+    def test_stays_within_valid_range(self):
+        # CHECK (confidence BETWEEN 0.0 AND 1.0) on the org_model
+        # facts table — the helper must never produce a value the
+        # database would reject.
+        for n in range(-5, 1000, 13):
+            c = corroborated_confidence(n)
+            assert 0.0 <= c <= 1.0, (n, c)
+
+
+class TestNoStageTransition:
+    """The helper only produces a confidence number. Stage transitions
+    (provisional → distilled → verified) are explicitly NOT in scope —
+    they require deliberate signal that this code can't see.
+
+    This test exists as a documentation pin: if a future change tries
+    to fold stage into the helper, the contract should be revisited
+    intentionally.
+    """
+
+    def test_returns_only_a_float(self):
+        result = corroborated_confidence(3)
+        assert isinstance(result, float)
+        # Not a tuple, dict, or any structured value that might encode
+        # stage alongside confidence.
+        with pytest.raises((TypeError, IndexError)):
+            _ = result[0]  # type: ignore[index]