@agxnte/reidx 2.0.2

package/src/reidx/provider/store.py

@@ -0,0 +1,141 @@
+"""On-disk persistence for user-added providers (`/connect`).
+
+File: `<storage_root>/providers.json`, chmod 600 on POSIX so API keys aren't
+world-readable. Format:
+
+    {"providers": [
+        {"name": "local-llama", "kind": "openai-compatible",
+         "base_url": "http://localhost:8080", "api_key": "", "default_model": "..."},
+        ...
+    ]}
+
+The registry rebuilds each provider on load via `build_provider(kind, ...)`.
+Nothing in here auto-changes `config.default_provider` — stub stays default;
+switching is explicit via `/use`.
+"""
+from __future__ import annotations
+
+import json
+import os
+from dataclasses import asdict, dataclass
+from pathlib import Path
+
+from reidx.diagnostics.logger import get_logger
+from reidx.provider.anthropic import AnthropicProvider
+from reidx.provider.base import BaseProvider
+from reidx.provider.ollama import OllamaProvider
+from reidx.provider.openai import OpenAICompatibleProvider, OpenAIProvider
+from reidx.provider.registry import ProviderRegistry
+
+log = get_logger("reidx.provider.store")
+
+SUPPORTED_KINDS = ("anthropic", "openai", "openai-compatible", "ollama")
+
+
+@dataclass
+class ProviderRecord:
+    name: str
+    kind: str
+    base_url: str = ""
+    api_key: str = ""
+    default_model: str = ""
+
+
+def build_provider(record: ProviderRecord) -> BaseProvider:
+    kind = record.kind
+    if kind == "anthropic":
+        return AnthropicProvider(
+            api_key=record.api_key,
+            base_url=record.base_url or "https://api.anthropic.com",
+            default_model=record.default_model,
+        )
+    if kind == "openai":
+        return OpenAIProvider(
+            api_key=record.api_key,
+            base_url=record.base_url,
+            default_model=record.default_model,
+        )
+    if kind == "openai-compatible":
+        return OpenAICompatibleProvider(
+            api_key=record.api_key,
+            base_url=record.base_url,
+            default_model=record.default_model,
+        )
+    if kind == "ollama":
+        return OllamaProvider(
+            base_url=record.base_url,
+            default_model=record.default_model,
+            api_key=record.api_key,
+        )
+    raise ValueError(f"unsupported provider kind: {kind}")
+
+
+class ProviderStore:
+    def __init__(self, storage_root: Path) -> None:
+        self.path = Path(storage_root) / "providers.json"
+
+    def _read(self) -> list[ProviderRecord]:
+        if not self.path.exists():
+            return []
+        try:
+            data = json.loads(self.path.read_text(encoding="utf-8"))
+        except (OSError, ValueError):
+            log.exception("failed to read providers.json; treating as empty")
+            return []
+        out: list[ProviderRecord] = []
+        for entry in data.get("providers", []):
+            try:
+                out.append(ProviderRecord(**entry))
+            except TypeError:
+                log.warning("skipping malformed provider entry: %s", entry)
+        return out
+
+    def _write(self, records: list[ProviderRecord]) -> None:
+        self.path.parent.mkdir(parents=True, exist_ok=True)
+        self.path.write_text(
+            json.dumps({"providers": [asdict(r) for r in records]}, indent=2),
+            encoding="utf-8",
+        )
+        # Best-effort key protection on POSIX; a no-op on Windows.
+        try:
+            os.chmod(self.path, 0o600)
+        except OSError:
+            pass
+
+    def list(self) -> list[ProviderRecord]:
+        return self._read()
+
+    def get(self, name: str) -> ProviderRecord | None:
+        for r in self._read():
+            if r.name == name:
+                return r
+        return None
+
+    def save(self, record: ProviderRecord) -> None:
+        records = [r for r in self._read() if r.name != record.name]
+        records.append(record)
+        self._write(records)
+
+    def delete(self, name: str) -> bool:
+        records = self._read()
+        remaining = [r for r in records if r.name != name]
+        if len(remaining) == len(records):
+            return False
+        self._write(remaining)
+        return True
+
+
+def load_into(registry: ProviderRegistry, storage_root: Path) -> list[str]:
+    """Register every persisted provider into `registry`. Returns the list of
+    names successfully registered. Skips (with a warning) any record whose
+    kind is unknown or fails to construct — the app must not crash on a
+    single bad entry."""
+    added: list[str] = []
+    store = ProviderStore(storage_root)
+    for record in store.list():
+        try:
+            registry.register(record.name, build_provider(record))
+            added.append(record.name)
+        except (ValueError, TypeError):
+            log.exception("skipping provider %s (kind=%s): failed to build", record.name, record.kind)
+    return added

package/src/reidx/provider/stub.py

@@ -0,0 +1,60 @@
+"""StubProvider: offline provider so the runtime loop is real and testable.
+
+Returns a canned assistant turn. If the user message asks to "list" files or "read"
+a file, it emits a matching tool call so the agent loop executes a real tool
+end-to-end. This is honest scaffolding — replace by registering a real provider.
+"""
+from __future__ import annotations
+
+import uuid
+from typing import Any
+
+from reidx.provider.base import BaseProvider, Message, ProviderResponse, ToolCall, Usage
+
+
+class StubProvider(BaseProvider):
+    name = "stub"
+
+    def chat(
+        self,
+        messages: list[Message],
+        tools: list[dict[str, Any]] | None = None,
+        model: str | None = None,
+    ) -> ProviderResponse:
+        last = next((m for m in reversed(messages) if m.role == "user"), None)
+        text = (last.content if last else "").lower()
+        tool_names = {t.get("function", {}).get("name") for t in tools or []}
+
+        # After a tool result comes back, finalize the turn instead of looping.
+        last_msg = messages[-1] if messages else None
+        if last_msg is not None and last_msg.role == "tool":
+            return ProviderResponse(
+                text=f"[stub] Tool returned: {last_msg.content[:200]}",
+                usage=Usage(prompt_tokens=12, completion_tokens=8),
+                stop_reason="stop",
+            )
+
+        if ("list" in text or "dir" in text) and "list_dir" in tool_names:
+            return ProviderResponse(
+                text="I'll list the current directory first.",
+                tool_calls=[ToolCall(id=uuid.uuid4().hex[:8], name="list_dir", arguments={})],
+                usage=Usage(prompt_tokens=8, completion_tokens=6),
+                stop_reason="tool_use",
+            )
+        if "read" in text and "read_file" in tool_names:
+            target = "README.md"
+            return ProviderResponse(
+                text=f"Reading {target}.",
+                tool_calls=[
+                    ToolCall(id=uuid.uuid4().hex[:8], name="read_file", arguments={"path": target})
+                ],
+                usage=Usage(prompt_tokens=10, completion_tokens=4),
+                stop_reason="tool_use",
+            )
+
+        echo = f"[stub] Acknowledged: {last.content if last else ''}"
+        return ProviderResponse(
+            text=echo,
+            usage=Usage(prompt_tokens=len(echo), completion_tokens=len(echo)),
+            stop_reason="stop",
+        )

package/src/reidx/provider_manager/__init__.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+from reidx.provider_manager.catalog import (
+    ProviderDefinition,
+    all_providers,
+    by_id,
+    popular_providers,
+    search,
+)
+from reidx.provider_manager.database import (
+    ProviderDatabase,
+    StoredKey,
+    StoredProvider,
+)
+from reidx.provider_manager.keychain import decrypt, encrypt
+from reidx.provider_manager.palette import (
+    ACCENT,
+    BG,
+    BG_ALT,
+    BORDER,
+    ProviderPalette,
+)
+
+__all__ = [
+    "ACCENT",
+    "BG",
+    "BG_ALT",
+    "BORDER",
+    "ProviderDatabase",
+    "ProviderDefinition",
+    "ProviderPalette",
+    "StoredKey",
+    "StoredProvider",
+    "all_providers",
+    "by_id",
+    "decrypt",
+    "encrypt",
+    "popular_providers",
+    "search",
+]

package/src/reidx/provider_manager/catalog.py

@@ -0,0 +1,330 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass(frozen=True)
+class ProviderDefinition:
+    id: str
+    name: str
+    description: str
+    kind: str
+    base_url: str
+    default_model: str
+    aliases: list[str] = field(default_factory=list)
+    auth_method: str = "bearer"
+    extra_headers: dict[str, str] = field(default_factory=dict)
+    popular: bool = False
+    icon: str = ""
+
+
+_BUILTIN: list[ProviderDefinition] = [
+    ProviderDefinition(
+        id="openai", name="OpenAI", description="GPT-4o, o-series, and DALL-E models",
+        kind="openai", base_url="https://api.openai.com", default_model="gpt-4o-mini",
+        aliases=["gpt", "chatgpt"], popular=True, icon="🟢",
+    ),
+    ProviderDefinition(
+        id="anthropic", name="Anthropic", description="Claude Sonnet, Opus, and Haiku models",
+        kind="anthropic", base_url="https://api.anthropic.com", default_model="claude-sonnet-4-20250514",
+        aliases=["claude"], auth_method="x-api-key", popular=True, icon="🟠",
+    ),
+    ProviderDefinition(
+        id="google-ai", name="Google AI", description="Gemini Pro, Flash, and Flash-Lite models",
+        kind="openai-compatible", base_url="https://generativelanguage.googleapis.com/v1beta/openai",
+        default_model="gemini-2.0-flash", aliases=["gemini", "google", "google-gemini"],
+        popular=True, icon="🔵",
+    ),
+    ProviderDefinition(
+        id="openrouter", name="OpenRouter", description="Unified API for 300+ models from all providers",
+        kind="openai-compatible", base_url="https://openrouter.ai/api/v1",
+        default_model="auto", aliases=["or"], popular=True, icon="🔀",
+    ),
+    ProviderDefinition(
+        id="zai", name="Z.ai", description="GLM-4 and GLM-4.5 series models",
+        kind="openai-compatible", base_url="https://open.bigmodel.cn/api/paas/v4",
+        default_model="glm-4", aliases=["z-ai", "zhipu", "glm", "bigmodel"], popular=True, icon="🟣",
+    ),
+    ProviderDefinition(
+        id="agentrouter", name="AgentRouter", description="Multi-model routing for AI agents",
+        kind="openai-compatible", base_url="https://api.agentrouter.io/v1",
+        default_model="auto", aliases=["agent-router"], icon="🤖",
+    ),
+    ProviderDefinition(
+        id="together", name="Together AI", description="Open-source Llama, Mixtral, and Qwen models",
+        kind="openai-compatible", base_url="https://api.together.xyz/v1",
+        default_model="meta-llama/Llama-3.3-70B-Instruct-Turbo", aliases=["together-ai"],
+        popular=True, icon="🤝",
+    ),
+    ProviderDefinition(
+        id="fireworks", name="Fireworks AI", description="Fast inference for open-source models",
+        kind="openai-compatible", base_url="https://api.fireworks.ai/inference/v1",
+        default_model="accounts/fireworks/models/llama-v3p1-70b-instruct",
+        aliases=["fireworks-ai"], popular=True, icon="🎆",
+    ),
+    ProviderDefinition(
+        id="groq", name="Groq", description="Ultra-fast LPU inference for Llama and Mixtral",
+        kind="openai-compatible", base_url="https://api.groq.com/openai/v1",
+        default_model="llama-3.3-70b-versatile", aliases=[], popular=True, icon="⚡",
+    ),
+    ProviderDefinition(
+        id="deepinfra", name="DeepInfra", description="Cost-effective inference for open models",
+        kind="openai-compatible", base_url="https://api.deepinfra.com/v1/openai",
+        default_model="meta-llama/Meta-Llama-3.1-70B-Instruct", aliases=[], icon="🔧",
+    ),
+    ProviderDefinition(
+        id="cerebras", name="Cerebras", description="Fastest AI inference with Wafer-Scale Engines",
+        kind="openai-compatible", base_url="https://api.cerebras.ai/v1",
+        default_model="llama3.1-70b", aliases=[], icon="🧠",
+    ),
+    ProviderDefinition(
+        id="cohere", name="Cohere", description="Command R+ and Aya models for enterprise",
+        kind="openai-compatible", base_url="https://api.cohere.ai/v1",
+        default_model="command-r-plus-08-2024", aliases=[], icon="🔗",
+    ),
+    ProviderDefinition(
+        id="xai", name="xAI", description="Grok models from xAI",
+        kind="openai-compatible", base_url="https://api.x.ai/v1",
+        default_model="grok-2-latest", aliases=["grok", "x-ai"], popular=True, icon="✖️",
+    ),
+    ProviderDefinition(
+        id="mistral", name="Mistral", description="Mistral Large, Codestral, and Pixtral models",
+        kind="openai-compatible", base_url="https://api.mistral.ai/v1",
+        default_model="mistral-large-latest", aliases=["mistral-ai"], popular=True, icon="🌬️",
+    ),
+    ProviderDefinition(
+        id="perplexity", name="Perplexity", description="Sonar models with built-in web search",
+        kind="openai-compatible", base_url="https://api.perplexity.ai",
+        default_model="llama-3.1-sonar-large-128k-online", aliases=[], icon="🔮",
+    ),
+    ProviderDefinition(
+        id="ollama", name="Ollama", description="Run models locally — Llama, Qwen, Phi, and more",
+        kind="ollama", base_url="http://localhost:11434",
+        default_model="llama3.2", aliases=[], auth_method="none", popular=True, icon="🐪",
+    ),
+    ProviderDefinition(
+        id="lm-studio", name="LM Studio", description="Local model server with OpenAI-compatible API",
+        kind="openai-compatible", base_url="http://localhost:1234/v1",
+        default_model="local", aliases=["lmstudio"], auth_method="none", icon="🏠",
+    ),
+    ProviderDefinition(
+        id="vllm", name="vLLM", description="High-throughput local inference server",
+        kind="openai-compatible", base_url="http://localhost:8000/v1",
+        default_model="auto", aliases=[], auth_method="none", icon="🚀",
+    ),
+    ProviderDefinition(
+        id="azure-openai", name="Azure OpenAI", description="OpenAI models via Azure cloud",
+        kind="openai", base_url="", default_model="gpt-4o-mini",
+        aliases=["azure"], icon="☁️",
+    ),
+    ProviderDefinition(
+        id="huggingface", name="HuggingFace", description="Inference API for 100k+ models",
+        kind="openai-compatible", base_url="https://api-inference.huggingface.co/v1",
+        default_model="meta-llama/Meta-Llama-3.1-70B-Instruct", aliases=["hf"], icon="🤗",
+    ),
+    ProviderDefinition(
+        id="sambanova", name="SambaNova", description="Fast RDU-based inference for open models",
+        kind="openai-compatible", base_url="https://api.sambanova.ai/v1",
+        default_model="Meta-Llama-3.1-70B-Instruct", aliases=[], icon="🔴",
+    ),
+    ProviderDefinition(
+        id="novita", name="Novita", description="Affordable API for 100+ open models",
+        kind="openai-compatible", base_url="https://api.novita.ai/v3/openai",
+        default_model="meta-llama/llama-3.1-70b-instruct", aliases=[], icon="💎",
+    ),
+    ProviderDefinition(
+        id="featherless", name="Featherless", description="Serverless inference for open models",
+        kind="openai-compatible", base_url="https://api.featherless.ai/v1/openai",
+        default_model="meta-llama/Meta-Llama-3.1-70B-Instruct", aliases=[], icon="🪶",
+    ),
+    ProviderDefinition(
+        id="chutes", name="Chutes", description="GPU-accelerated inference for AI workloads",
+        kind="openai-compatible", base_url="https://api.chutes.ai/v1",
+        default_model="deepseek-ai/DeepSeek-V3", aliases=[], icon="🎯",
+    ),
+    ProviderDefinition(
+        id="aimlapi", name="AI/ML API", description="Unified API for 200+ AI models",
+        kind="openai-compatible", base_url="https://api.aimlapi.com/v1",
+        default_model="gpt-4o", aliases=["ai-ml-api"], icon="📊",
+    ),
+    ProviderDefinition(
+        id="hyperbolic", name="Hyperbolic", description="GPU marketplace for AI inference",
+        kind="openai-compatible", base_url="https://api.hyperbolic.xyz/v1",
+        default_model="meta-llama/Meta-Llama-3.1-70B-Instruct", aliases=[], icon="📈",
+    ),
+    ProviderDefinition(
+        id="deepseek", name="DeepSeek", description="DeepSeek-V3 and DeepSeek-R1 reasoning models",
+        kind="openai-compatible", base_url="https://api.deepseek.com/v1",
+        default_model="deepseek-chat", aliases=[], popular=True, icon="🐳",
+    ),
+    ProviderDefinition(
+        id="moonshot", name="Moonshot", description="Kimi K1.5 and Moonshot models",
+        kind="openai-compatible", base_url="https://api.moonshot.cn/v1",
+        default_model="moonshot-v1-8k", aliases=["kimi"], icon="🌙",
+    ),
+    ProviderDefinition(
+        id="voyage-ai", name="Voyage AI", description="Embeddings and reranking models",
+        kind="openai-compatible", base_url="https://api.voyageai.com/v1",
+        default_model="voyage-large-2", aliases=[], icon="🧭",
+    ),
+    ProviderDefinition(
+        id="nvidia-nim", name="NVIDIA NIM", description="NVIDIA inference microservices for open models",
+        kind="openai-compatible", base_url="https://integrate.api.nvidia.com/v1",
+        default_model="meta/llama-3.1-70b-instruct", aliases=["nvidia"], icon="💚",
+    ),
+    ProviderDefinition(
+        id="ai21", name="AI21 Labs", description="Jamba models with long context windows",
+        kind="openai-compatible", base_url="https://api.ai21.com/v1",
+        default_model="jamba-1.5-large", aliases=[], icon="🃏",
+    ),
+    ProviderDefinition(
+        id="databricks", name="Databricks", description="Serving endpoints for fine-tuned models",
+        kind="openai-compatible", base_url="", default_model="databricks-dbrx-instruct",
+        aliases=[], icon="🧱",
+    ),
+    ProviderDefinition(
+        id="replicate", name="Replicate", description="Run open-source models in the cloud",
+        kind="openai-compatible", base_url="https://api.replicate.com/v1",
+        default_model="meta/llama-2-70b-chat", aliases=[], icon="🔁",
+    ),
+    ProviderDefinition(
+        id="siliconflow", name="SiliconFlow", description="Cost-effective inference for 200+ models",
+        kind="openai-compatible", base_url="https://api.siliconflow.cn/v1",
+        default_model="deepseek-ai/DeepSeek-V3", aliases=[], icon="🌊",
+    ),
+    ProviderDefinition(
+        id="nebius", name="Nebius", description="Cloud GPU platform for AI inference",
+        kind="openai-compatible", base_url="https://api.studio.nebius.ai/v1",
+        default_model="meta-llama/Meta-Llama-3.1-70B-Instruct", aliases=[], icon="☁️",
+    ),
+    ProviderDefinition(
+        id="lepton", name="Lepton AI", description="Serverless inference with auto-scaling",
+        kind="openai-compatible", base_url="https://api.lepton.ai/v1",
+        default_model="meta-llama/Llama-3.2-70B-Instruct", aliases=[], icon="⚛️",
+    ),
+    ProviderDefinition(
+        id="lambda", name="Lambda Labs", description="GPU cloud for AI training and inference",
+        kind="openai-compatible", base_url="https://api.lambdalabs.com/v1",
+        default_model="", aliases=["lambda-labs"], icon="λ",
+    ),
+    ProviderDefinition(
+        id="kluster", name="Kluster AI", description="Distributed GPU network for inference",
+        kind="openai-compatible", base_url="https://api.kluster.ai/v1",
+        default_model="meta-llama/Meta-Llama-3.1-70B-Instruct", aliases=[], icon="🔗",
+    ),
+    ProviderDefinition(
+        id="upstage", name="Upstage", description="Solar Mini and Pro models for Korean and English",
+        kind="openai-compatible", base_url="https://api.upstage.ai/v1",
+        default_model="solar-pro", aliases=[], icon="☀️",
+    ),
+    ProviderDefinition(
+        id="yi", name="Yi (01.AI)", description="Yi-Large and Yi-34B models",
+        kind="openai-compatible", base_url="https://api.01.ai/v1",
+        default_model="yi-large", aliases=["01-ai", "yi-ai"], icon="🎯",
+    ),
+    ProviderDefinition(
+        id="volcengine", name="Volcengine", description="ByteDance's Ark platform for Doubao models",
+        kind="openai-compatible", base_url="https://ark.cn-beijing.volces.com/api/v3",
+        default_model="doubao-pro-32k", aliases=["ark", "bytedance"], icon="🌋",
+    ),
+    ProviderDefinition(
+        id="hunyuan", name="Tencent Hunyuan", description="Tencent's Hunyuan large language models",
+        kind="openai-compatible", base_url="https://api.hunyuan.cloud.tencent.com/v1",
+        default_model="hunyuan-turbos-latest", aliases=["tencent"], icon="🐧",
+    ),
+    ProviderDefinition(
+        id="cloudflare-ai", name="Cloudflare Workers AI", description="Serverless AI inference at the edge",
+        kind="openai-compatible", base_url="", default_model="@cf/meta/llama-3.1-70b-instruct",
+        aliases=["cf-ai"], icon="orange",
+    ),
+    ProviderDefinition(
+        id="monsterapi", name="Monster API", description="Affordable GPU inference for open models",
+        kind="openai-compatible", base_url="https://api.monsterapi.ai/v1",
+        default_model="meta-llama/Meta-Llama-3.1-70B-Instruct", aliases=[], icon="👾",
+    ),
+    ProviderDefinition(
+        id="baseten", name="Baseten", description="Model deployment and serving platform",
+        kind="openai-compatible", base_url="https://inference.baseten.co/v1",
+        default_model="", aliases=[], icon="🏗️",
+    ),
+    ProviderDefinition(
+        id="anyscale", name="Anyscale", description="Ray-based scalable model serving",
+        kind="openai-compatible", base_url="https://api.endpoints.anyscale.com/v1",
+        default_model="meta-llama/Llama-3.1-70B-Instruct", aliases=[], icon="📐",
+    ),
+    ProviderDefinition(
+        id="jan", name="Jan", description="Local AI model server with web UI",
+        kind="openai-compatible", base_url="http://localhost:1337/v1",
+        default_model="local", aliases=[], auth_method="none", icon="🖥️",
+    ),
+    ProviderDefinition(
+        id="llamacpp", name="Llama.cpp Server", description="Local C++ inference server",
+        kind="openai-compatible", base_url="http://localhost:8080",
+        default_model="local", aliases=["llama-cpp"], auth_method="none", icon="🦙",
+    ),
+    ProviderDefinition(
+        id="watsonx", name="IBM Watsonx", description="Enterprise AI platform with Granite models",
+        kind="openai-compatible", base_url="", default_model="ibm/granite-3-8b-instruct",
+        aliases=["ibm"], icon="🔷",
+    ),
+    ProviderDefinition(
+        id="aleph-alpha", name="Aleph Alpha", description="European sovereign AI — Luminous models",
+        kind="openai-compatible", base_url="https://api.aleph-alpha.eu/v1",
+        default_model="luminous-supreme-control", aliases=[], icon="α",
+    ),
+    ProviderDefinition(
+        id="predibase", name="Predibase", description="Fine-tune and serve open-source LLMs",
+        kind="openai-compatible", base_url="https://serving.app.predibase.com/v1",
+        default_model="meta-llama/Meta-Llama-3.1-8B-Instruct", aliases=[], icon="🎯",
+    ),
+    ProviderDefinition(
+        id="gravity", name="Gravity API", description="Multi-model API gateway",
+        kind="openai-compatible", base_url="https://api.gravityapi.com/v1",
+        default_model="auto", aliases=[], icon="🌌",
+    ),
+    ProviderDefinition(
+        id="infermatic", name="Infermatic", description="Fast inference for popular open models",
+        kind="openai-compatible", base_url="https://api.infermatic.ai/v1",
+        default_model="meta-llama/Meta-Llama-3.1-70B-Instruct", aliases=[], icon="💡",
+    ),
+]
+
+_BY_ID: dict[str, ProviderDefinition] = {p.id: p for p in _BUILTIN}
+
+
+def all_providers() -> list[ProviderDefinition]:
+    return list(_BUILTIN)
+
+
+def popular_providers() -> list[ProviderDefinition]:
+    return [p for p in _BUILTIN if p.popular]
+
+
+def by_id(provider_id: str) -> ProviderDefinition | None:
+    return _BY_ID.get(provider_id)
+
+
+def search(query: str) -> list[ProviderDefinition]:
+    q = query.strip().lower()
+    if not q:
+        return list(_BUILTIN)
+    results: list[tuple[int, ProviderDefinition]] = []
+    for p in _BUILTIN:
+        score = 0
+        name_lower = p.name.lower()
+        if name_lower == q:
+            score = 100
+        elif name_lower.startswith(q):
+            score = 80
+        elif q in name_lower:
+            score = 60
+        elif any(q in a.lower() for a in p.aliases):
+            score = 70
+        elif q in p.description.lower():
+            score = 30
+        elif q in p.id.lower():
+            score = 50
+        if score > 0:
+            results.append((score, p))
+    results.sort(key=lambda x: (-x[0], x[1].name))
+    return [p for _, p in results]