api-key-manager 2.1.0__py3-none-any.whl

api_key_manager-2.1.0.dist-info/RECORD

@@ -0,0 +1,73 @@
+key_manager/__init__.py,sha256=x4LlmQ4xZJVNwK-01OQdwdwc2H5PYz4VRLJ51gf3V4I,421
+key_manager/__main__.py,sha256=GzkP1E6JO-GmOaq3z30Op1DQMS0i7YopewS5k7F2iAE,124
+key_manager/api_models.py,sha256=EHMyl7NUefPihEEUBQWcG7bhKoalitq-cPn0jNlUNIQ,15946
+key_manager/checker.py,sha256=srQUMT_StEDphSTYr3rYyKZPI2g4Je22RidzV5oz5DE,1675
+key_manager/cli.py,sha256=KRouKOkRaMHhlk4d27Qv1IsgEsY8fYSqxQotM9UqXX4,9387
+key_manager/config.py,sha256=bAKPmpdQXOwcKtfSqFV4-Vu3h83a1dQq0KQDB_I4Vvk,1814
+key_manager/core.py,sha256=IoU7Ic4OnTaI4Dg6tZ0ILRmC5KgoZgloGubHc7izVzE,6419
+key_manager/detector.py,sha256=8vHZkMMrmy_acGLceN4lqUt4b9nQfktr65LlF2EqRkk,13809
+key_manager/errors.py,sha256=cB_z8qoYXvj3hlh86SCAjgNJBejR6w6YRdcmHNG-5hE,6088
+key_manager/i18n.py,sha256=hqqFWanD6ybs8or5qg9FcOg9a7T61zLVdGVkUYRhevQ,4077
+key_manager/logger.py,sha256=rzISVc4SBSJ06BV0houobmLpDYAqcTwQLXh7kpxjSRM,7922
+key_manager/model_capabilities.py,sha256=o_Qb7gl9fB5HOxsGE2zRRq7Sj9Dpmnm-qazPezkgXtc,12758
+key_manager/parser.py,sha256=oanTRB0h8hFLfn6oY-gU418KBcU5lT7A1ALrwERBwnQ,5429
+key_manager/proxy.py,sha256=jrpm8-XnUxGhqJrQQh4Kh0SllpFB9RgdyXh927BYjwo,1894
+key_manager/ssrf.py,sha256=xh4RexLgIudjWZH-2-Uroj_4V3yU5WkiNzdWb26oDcA,1992
+key_manager/storage.py,sha256=qrwKKxbc-5684mNGStM11HjVU1YYlZdUvjsllFbYTic,4514
+key_manager/tester.py,sha256=_jMZSmH9U5tPtFnd8ZZTEf0lLpWam2-UfjP2CYmn-lY,5107
+key_manager/url_override.py,sha256=EQYre1FDcPd1oC9PLxeUoSiLwQ_vn--96Xhy_3LLiE0,252
+key_manager/validator.py,sha256=zNHomlXNL6y8ro9OTMVPvk_sOdlF2Xn_Z84OWPVBENQ,7291
+key_manager/web.py,sha256=trMpdtb383j70Z0_yTAWQ_r65akl7-Jr7JaohvE82SA,66778
+key_manager/webhook.py,sha256=ke4-7kNyaDu6ZQqg_YeWeHPVe2kTM6ansQ4im93goYE,8055
+key_manager/providers/__init__.py,sha256=UEPyPh4FN5nSijsNSxzENMDdwu0-GsHR4Pgk5MVy2AE,13968
+key_manager/providers/ai302.py,sha256=-Rw6eC6wxwjVdze4LFs_iTq-7RlP84uEOVa7EOq8ccA,4421
+key_manager/providers/anthropic.py,sha256=wUG9bwRAFFyWmmfoQhgvimyZWA5HdNUYcfcHSnQus_g,4382
+key_manager/providers/baichuan.py,sha256=mzjSseNslrI1O9iRASRRlPEr5GQn8WGDKdVxo6O7sXM,4156
+key_manager/providers/base.py,sha256=zmwPMoQk3-4o8s2N83HnH-KX836fFSzL24K9yJpQ_js,11819
+key_manager/providers/cerebras.py,sha256=cbqTpKr6siDGHl_OovSP_5G6adpNj-rCJYUeU4C7dlA,4432
+key_manager/providers/cohere.py,sha256=ccNRzCLdIumqIDPkPbml1tfvc02dsg-1us0Y1Iom3b0,3645
+key_manager/providers/cstcloud.py,sha256=UwcNrltUl1p8pSALHwFB-D_-8vqgq6Rh5CdzmMF0Z9s,5346
+key_manager/providers/dashscope.py,sha256=6Gf3slaXXLI1Pw0R-ocF2iGWWOeOEyvx9n4yPS6WhtI,5206
+key_manager/providers/dashscope_coding.py,sha256=bIEt9-O4ZoDwZbp5geAkbnBv0CVGD1ksmT7zgl8QpUc,5404
+key_manager/providers/deepseek.py,sha256=RHrk0pOPAxZP1JA8DXjGP5tFu-S39wyJxkDGIyp_W_Q,7074
+key_manager/providers/dmxapi.py,sha256=uPUG6-dyWFRAHhin80PX7q1yczBHExiTD6E4KKbC-1Y,4426
+key_manager/providers/doubao.py,sha256=h3l2h_6MvtTBrd79qBAaGxlfrfUPKme-IWwQKYjYRUc,4448
+key_manager/providers/fireworks.py,sha256=ciecI3plQGsUL582YoIwGSCWmhV2Q6W-d9UiGRVNTO4,4545
+key_manager/providers/google.py,sha256=Td1OhcIRJFPJEQ4VaUVTOBJUCDkBa4Bj1-0QdwqMFUs,4132
+key_manager/providers/grok.py,sha256=R-zSjaLBzmaIg_E22_57jR555g_IHlMRIaY228K1bPc,4418
+key_manager/providers/groq.py,sha256=Bht4XUApmUA3JZjuDnh_IUZp6p_PfBoblCrXdAi1uAE,4454
+key_manager/providers/huggingface.py,sha256=1IjsoQNh3cdtf38u5Bh3mZQNFeHN069AFr7lFfExhrs,2352
+key_manager/providers/hyperbolic.py,sha256=i13BASJn2jBCEFbaji3GPCovTZSJNJag6wUh9C9VLKg,4481
+key_manager/providers/infini.py,sha256=PmrazMa7YcCEwXyjg5f4jqPrsLl56jtQ4MprmQ3Knh8,5597
+key_manager/providers/infini_coding.py,sha256=yLCzH8CI5u5w4hyciGqgTn0aBJLrBgddIprBYnHEOLw,5408
+key_manager/providers/kimi.py,sha256=T1M9k1cC-v0QGdIIYP4ddRhkkgpBwXThi_Ws6W9FyWw,5201
+key_manager/providers/kimi_coding.py,sha256=THjpljhqjZirkGz8GOXxwq0GbFNAwXgobO3ax2gkUPI,5360
+key_manager/providers/longcat.py,sha256=1EzQZ0FehXWA8IO7VZmNZpU4B10je9Uy4EaegHnj7_8,5035
+key_manager/providers/mimo.py,sha256=OxSJu9-E0ZkniyIpv6AHZ43_gH733lQinyncYvMZ5o4,4419
+key_manager/providers/mimo_plan.py,sha256=vdRwqOC9vK0FDKKM5goyIYYLrHVwYzf2xV8NWbFE9vk,5904
+key_manager/providers/minimax.py,sha256=WrxtjpLOg3vE9ZYTl6enPvkOKKoEZFoJlj4z96Mo4vg,4142
+key_manager/providers/minimax_plan.py,sha256=FOTLFENsKaoBf7XRRs3DOxTh7nqCqP8MHPkcOHpSowY,5407
+key_manager/providers/mistral.py,sha256=loySnKHvxz4j-ZWfCyWCT-RtwtCJiHAtr41oR4jmiTQ,4437
+key_manager/providers/models_registry.py,sha256=XSegzg6L-pesh-s4Onb4OBXuuJl6LPfGQrZpYP-lVHk,84818
+key_manager/providers/modelscope.py,sha256=3DPtPEZ1cyMlWOc_T_B_9JDMndMGAM643TBsPs7My8Y,5603
+key_manager/providers/nvidia.py,sha256=OzDFTBcRerJniXn69MbKfykmagEifwfo8Mlv40IOy4M,4461
+key_manager/providers/ocoolai.py,sha256=kdha8BPLVWphuTOezwkRG4keywqlAMhsnLIR6FTmmHM,4430
+key_manager/providers/openai.py,sha256=ky0ykK0hbqljTWK13Jni9XeltWlFEmb9X3t_FooiPns,5652
+key_manager/providers/openrouter.py,sha256=xiCw7H1stbzjQSixEak4ELkYLWv1LeDD__QcHZ5Z4RI,5262
+key_manager/providers/perplexity.py,sha256=ZUtVQSwYwlVnGBwH3yImJapIkmnC5T82Eb0xs_ZHlhs,4454
+key_manager/providers/poe.py,sha256=rUr_jzt3dH_FODh0qoca3WzKjfa8Dz2zyc0oRGak1AA,4418
+key_manager/providers/ppio.py,sha256=1nq5JHffdWYD0K3sxWfaTd1mGkkxcqVSfbCkjX5NdYc,4453
+key_manager/providers/replicate.py,sha256=TwoiGGS-bIaKPYG_KW9Z92QsTp_xCaUuhNK5rcxGyus,2348
+key_manager/providers/siliconflow.py,sha256=SdlWuyEGYiRFBJavyUBF3SMi2bsSSjOioLd2NGLNxpY,5234
+key_manager/providers/stepfun.py,sha256=JkuZv26G-imVXOGiGLGgbouIWoiWFNvFJUsRUlbklzA,5416
+key_manager/providers/tencent_hunyuan.py,sha256=q5fV8af98qNAovadLe_rDTS11LVcF4FTnE-3Yt8c4oI,5416
+key_manager/providers/together.py,sha256=wD8Z3T_si-9ttMSxYNFxY7t588O1Ok7dPcKmzCPvvxg,5566
+key_manager/providers/yi.py,sha256=krOLqoEV6ytwLV4JqCFMjgI28s6B11NA-TtyiZlfiB0,4135
+key_manager/providers/zai.py,sha256=RkLlhEz9LEs8VoHVhQUhh9o-p9q4lZsSmF1lK1saXyY,4424
+key_manager/providers/zhipu.py,sha256=gUMSyJSzUvLopNHKEM1bn4FBSzRaiSAQPs3itwOrnhY,5665
+key_manager/providers/zhipu_coding.py,sha256=yy4SuKXXpLCAHqZfTInlvZ5tYCOQ1u55EPbZfKVYcNw,5381
+api_key_manager-2.1.0.dist-info/METADATA,sha256=KxMBaY8mYAh4U4UOxmfmTtje7-smlMimsnO1NXYkvGo,21747
+api_key_manager-2.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+api_key_manager-2.1.0.dist-info/entry_points.txt,sha256=Md42USNyHdYOXdPsW9NYvcZyTl_5rP7aySf8gqQu9tA,57
+api_key_manager-2.1.0.dist-info/top_level.txt,sha256=tCMUyU-fS25OwJkzgCLR5ewI0FzSiO2k6Ui1eqITqAc,12
+api_key_manager-2.1.0.dist-info/RECORD,,

api_key_manager-2.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

api_key_manager-2.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+api-key-manager = key_manager.cli:main

api_key_manager-2.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+key_manager

key_manager/__init__.py

@@ -0,0 +1,16 @@
+"""Key Manager - Batch API key management for 44+ AI providers."""
+from key_manager.core import KeyManager
+from key_manager.providers import PROVIDERS, get_display_name
+from key_manager.errors import KeyManagerError, ErrorCode
+from key_manager.storage import KeyStore
+
+__all__ = [
+    "KeyManager",
+    "PROVIDERS",
+    "get_display_name",
+    "KeyManagerError",
+    "ErrorCode",
+    "KeyStore",
+]
+
+__version__ = "2.1.0"

key_manager/__main__.py

@@ -0,0 +1,5 @@
+"""Allow `python -m key_manager` to run the CLI."""
+from key_manager.cli import main
+
+if __name__ == "__main__":
+    main()

key_manager/api_models.py

@@ -0,0 +1,358 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+from key_manager.errors import ErrorResponse
+
+__all__ = [
+    "ErrorResponse",
+    "KeyInfo",
+    "KeyListResponse",
+    "KeyExportItem",
+    "KeyExportResponse",
+    "ImportRequest",
+    "ImportResponse",
+    "CheckSingleRequest",
+    "CheckSingleResponse",
+    "CheckBatchItem",
+    "CheckBatchRequest",
+    "CheckBatchResult",
+    "CheckBatchSummary",
+    "CheckBatchResponse",
+    "TestSingleRequest",
+    "TestSingleResponse",
+    "BalanceRequest",
+    "BalanceResponse",
+    "ModelInfo",
+    "ModelsResponse",
+    "ProviderInfo",
+    "ProvidersResponse",
+    "ProviderDetail",
+    "ProviderDetailResponse",
+    "StatsProviderEntry",
+    "StatsResponse",
+    "StatsChartProviderEntry",
+    "StatsChartStatuses",
+    "StatsChartResponse",
+    "LogEntry",
+    "LogsResponse",
+    "OperationEntry",
+    "OperationsResponse",
+    "ProgressResponse",
+]
+
+
+# ── Keys ──────────────────────────────────────────────────────────────────────
+
+
+class KeyInfo(BaseModel):
+    key_masked: str = Field(..., description="Masked key for display")
+    provider: str = Field(..., description="Provider identifier")
+    status: str = Field(..., description="Key status: valid / invalid / error / unknown")
+    last_checked: str | None = Field(None, description="ISO-8601 timestamp of last check")
+    last_error: str | None = Field(None, description="Most recent error message")
+    error_type: str | None = Field(None, description="Categorised error type")
+    tests: dict[str, Any] = Field(default_factory=dict, description="Test results (max_tokens, max_concurrency)")
+    models: list[str] = Field(default_factory=list, description="Available models")
+    sources_count: int = Field(0, description="Number of import sources")
+    balance: float | None = Field(None, description="Account balance if available")
+
+
+class KeyListResponse(BaseModel):
+    keys: list[KeyInfo] = Field(default_factory=list, description="Paginated key list")
+    total: int = Field(0, description="Total number of keys matching filters")
+    page: int = Field(1, description="Current page number")
+    total_pages: int = Field(0, description="Total number of pages")
+    page_size: int = Field(50, description="Page size")
+
+
+class KeyExportItem(BaseModel):
+    provider: str = Field(..., description="Provider identifier")
+    max_tokens: int | None = Field(None, description="Maximum token limit")
+    max_concurrency: int | None = Field(None, description="Maximum concurrency limit")
+
+
+class KeyExportResponse(BaseModel):
+    keys: list[KeyExportItem] = Field(default_factory=list, description="Exported valid keys")
+    total: int = Field(0, description="Total exported key count")
+
+
+# ── Import ────────────────────────────────────────────────────────────────────
+
+
+class ImportRequest(BaseModel):
+    file: str | None = Field(None, description="Path to a JSON file containing keys")
+    directory: str | None = Field(None, description="Directory to scan for key files")
+    batch: list[str] | None = Field(None, description="Inline list of keys to import")
+
+    model_config = {
+        "json_schema_extra": {
+            "examples": [
+                {"file": "./data/input/keys.json"},
+                {"batch": ["sk-abc123", "sk-def456"]},
+            ]
+        }
+    }
+
+
+class ImportResponse(BaseModel):
+    new: int = Field(0, description="Number of newly imported keys")
+    duplicates: int = Field(0, description="Number of duplicate keys skipped")
+    errors: list[str] = Field(default_factory=list, description="Import error messages")
+
+
+# ── Check ─────────────────────────────────────────────────────────────────────
+
+
+class CheckSingleRequest(BaseModel):
+    key: str = Field(..., min_length=1, description="API key to check")
+    provider: str = Field("", description="Provider name (auto-detected if empty)")
+    custom_base_url: str | None = Field(None, description="Override provider base URL")
+
+    model_config = {
+        "json_schema_extra": {
+            "examples": [{"key": "sk-abc123", "provider": "openai"}]
+        }
+    }
+
+
+class CheckSingleResponse(BaseModel):
+    key_masked: str = Field(..., description="Masked key for display")
+    provider: str = Field(..., description="Provider identifier")
+    display_name: str | None = Field(None, description="Human-readable provider name")
+    status: str = Field(..., description="Check result: valid / invalid / error / unknown")
+    status_code: int | None = Field(None, description="HTTP status code from provider")
+    latency_ms: float = Field(0, description="Response latency in milliseconds")
+    error: str | None = Field(None, description="Error message if check failed")
+    error_type: str | None = Field(None, description="Categorised error type")
+    balance: dict[str, Any] | None = Field(None, description="Balance information")
+    models: list[str] = Field(default_factory=list, description="Available models")
+
+
+class CheckBatchItem(BaseModel):
+    key: str = Field(..., min_length=1, description="API key to check")
+    provider: str = Field("", description="Provider name (auto-detected if empty)")
+
+
+class CheckBatchRequest(BaseModel):
+    keys: list[CheckBatchItem] = Field(..., min_length=1, description="Keys to check")
+    timeout: int = Field(10, description="Per-key timeout in seconds")
+    concurrency: int = Field(50, description="Maximum concurrent checks")
+    custom_base_url: str | None = Field(None, description="Override provider base URL for all keys")
+
+    model_config = {
+        "json_schema_extra": {
+            "examples": [
+                {
+                    "keys": [
+                        {"key": "sk-abc123", "provider": "openai"},
+                        {"key": "sk-def456", "provider": "deepseek"},
+                    ],
+                    "concurrency": 20,
+                }
+            ]
+        }
+    }
+
+
+class CheckBatchResult(BaseModel):
+    key_masked: str = Field(..., description="Masked key for display")
+    provider: str = Field(..., description="Provider identifier")
+    status: str = Field(..., description="Check result: valid / invalid / error / unknown")
+    status_code: int | None = Field(None, description="HTTP status code from provider")
+    latency_ms: float = Field(0, description="Response latency in milliseconds")
+    error: str | None = Field(None, description="Error message if check failed")
+    error_type: str | None = Field(None, description="Categorised error type")
+    balance: dict[str, Any] | None = Field(None, description="Balance information")
+
+
+class CheckBatchSummary(BaseModel):
+    total: int = Field(0, description="Total keys checked")
+    valid: int = Field(0, description="Number of valid keys")
+    invalid: int = Field(0, description="Number of invalid keys")
+    error: int = Field(0, description="Number of errored keys")
+
+
+class CheckBatchResponse(BaseModel):
+    results: list[CheckBatchResult] = Field(default_factory=list, description="Per-key results")
+    summary: CheckBatchSummary = Field(default_factory=CheckBatchSummary, description="Aggregate summary")
+
+
+# ── Test ──────────────────────────────────────────────────────────────────────
+
+
+class TestSingleRequest(BaseModel):
+    key: str = Field(..., min_length=1, description="API key to test")
+    provider: str = Field("", description="Provider name (auto-detected if empty)")
+
+    model_config = {
+        "json_schema_extra": {
+            "examples": [{"key": "sk-abc123", "provider": "openai"}]
+        }
+    }
+
+
+class TestSingleResponse(BaseModel):
+    provider: str = Field(..., description="Provider identifier")
+    key_masked: str = Field(..., description="Masked key for display")
+    max_tokens: int | None = Field(None, description="Detected maximum token limit")
+    max_concurrency: int | None = Field(None, description="Detected maximum concurrency")
+    models: list[str] = Field(default_factory=list, description="Available models")
+    error: str | None = Field(None, description="Error message if test failed")
+
+
+# ── Balance ───────────────────────────────────────────────────────────────────
+
+
+class BalanceRequest(BaseModel):
+    key: str = Field(..., min_length=1, description="API key to query balance for")
+    provider: str = Field("", description="Provider name (auto-detected if empty)")
+    custom_base_url: str | None = Field(None, description="Override provider base URL")
+
+    model_config = {
+        "json_schema_extra": {
+            "examples": [{"key": "sk-abc123", "provider": "openai"}]
+        }
+    }
+
+
+class BalanceResponse(BaseModel):
+    provider: str = Field(..., description="Provider identifier")
+    supported: bool = Field(False, description="Whether provider supports balance queries")
+    balance: float | None = Field(None, description="Account balance")
+    currency: str | None = Field(None, description="Balance currency code")
+    key_masked: str | None = Field(None, description="Masked key for display")
+    error: str | None = Field(None, description="Error message if query failed")
+
+
+# ── Models ────────────────────────────────────────────────────────────────────
+
+
+class ModelInfo(BaseModel):
+    model: str = Field(..., description="Model identifier")
+    available: bool | None = Field(None, description="Whether the model is available (if checked)")
+
+
+class ModelsResponse(BaseModel):
+    provider: str = Field(..., description="Provider identifier")
+    models: list[str] = Field(default_factory=list, description="Available model identifiers")
+    total: int = Field(0, description="Total model count")
+    type_filter: str = Field("all", description="Applied type filter")
+    source: str | None = Field(None, description="Data source: api / static")
+    hint: str | None = Field(None, description="Hint message for user")
+    error: str | None = Field(None, description="Error message if fetch failed")
+
+
+# ── Providers ─────────────────────────────────────────────────────────────────
+
+
+class ProviderInfo(BaseModel):
+    name: str = Field(..., description="Provider identifier")
+    display_name: str = Field(..., description="Human-readable provider name")
+    prefix: str = Field("-", description="Key prefix pattern")
+    base_url: str = Field("", description="Provider API base URL")
+    type: str = Field("ai", description="Provider type")
+
+
+class ProvidersResponse(BaseModel):
+    providers: list[ProviderInfo] = Field(default_factory=list, description="Registered providers")
+    total: int = Field(0, description="Total provider count")
+
+
+class ProviderDetail(BaseModel):
+    name: str = Field(..., description="Provider identifier")
+    display_name: str = Field(..., description="Human-readable provider name")
+    prefix: str = Field("-", description="Key prefix pattern")
+    base_url: str = Field("", description="Provider API base URL")
+    website_url: str = Field("", description="Provider website URL")
+    docs_url: str = Field("", description="Provider documentation URL")
+    website_name: str = Field("", description="Provider website display name")
+
+
+class ProviderDetailResponse(BaseModel):
+    providers: list[ProviderDetail] = Field(default_factory=list, description="Provider details")
+    total: int = Field(0, description="Total provider count")
+
+
+# ── Stats ─────────────────────────────────────────────────────────────────────
+
+
+class StatsProviderEntry(BaseModel):
+    total: int = Field(0, description="Total keys for this provider")
+    valid: int = Field(0, description="Valid keys")
+    invalid: int = Field(0, description="Invalid keys")
+    error: int = Field(0, description="Errored keys")
+    display_name: str = Field("", description="Human-readable provider name")
+
+
+class StatsResponse(BaseModel):
+    providers: dict[str, StatsProviderEntry] = Field(
+        default_factory=dict, description="Per-provider statistics"
+    )
+    total: int = Field(0, description="Total key count")
+
+
+class StatsChartProviderEntry(BaseModel):
+    total: int = Field(0, description="Total keys for this provider")
+    valid: int = Field(0, description="Valid keys")
+    invalid: int = Field(0, description="Invalid keys")
+    error: int = Field(0, description="Errored keys")
+
+
+class StatsChartStatuses(BaseModel):
+    valid: int = Field(0, description="Total valid keys")
+    invalid: int = Field(0, description="Total invalid keys")
+    error: int = Field(0, description="Total errored keys")
+    unknown: int = Field(0, description="Total unknown-status keys")
+
+
+class StatsChartResponse(BaseModel):
+    providers: dict[str, StatsChartProviderEntry] = Field(
+        default_factory=dict, description="Per-provider breakdown for charts"
+    )
+    statuses: StatsChartStatuses = Field(
+        default_factory=StatsChartStatuses, description="Global status counts"
+    )
+
+
+# ── Logs ──────────────────────────────────────────────────────────────────────
+
+
+class LogEntry(BaseModel):
+    timestamp: str | None = Field(None, description="Log entry timestamp")
+    level: str | None = Field(None, description="Log level (INFO, WARNING, ERROR)")
+    message: str = Field("", description="Log message content")
+    extra: dict[str, Any] | None = Field(None, description="Additional structured data")
+
+
+class LogsResponse(BaseModel):
+    logs: list[LogEntry | str] = Field(default_factory=list, description="Recent log entries")
+    total: int = Field(0, description="Number of entries returned")
+
+
+class OperationEntry(BaseModel):
+    timestamp: str | None = Field(None, description="Operation timestamp")
+    action: str = Field("", description="Operation type (import, check, test, etc.)")
+    detail: str = Field("", description="Operation detail")
+    extra: dict[str, Any] | None = Field(None, description="Additional structured data")
+
+
+class OperationsResponse(BaseModel):
+    operations: list[OperationEntry | dict[str, Any]] = Field(
+        default_factory=list, description="Structured operations log"
+    )
+    total: int = Field(0, description="Number of entries returned")
+
+
+# ── Progress ──────────────────────────────────────────────────────────────────
+
+
+class ProgressResponse(BaseModel):
+    active: bool = Field(False, description="Whether a long-running task is in progress")
+    current: int = Field(0, description="Current progress counter")
+    total: int = Field(0, description="Total items to process")
+    status: str = Field("", description="Task status: loading / done / error")
+    results: dict[str, Any] | None = Field(None, description="Final results when complete")

key_manager/checker.py

@@ -0,0 +1,51 @@
+import asyncio
+import json
+from datetime import datetime
+from pathlib import Path
+
+import httpx
+
+from .providers import PROVIDERS
+from .validator import validate_keys
+
+
+async def run_check(keys_file: str = "./data/keys.json",
+                    results_file: str = "./data/check_results.json",
+                    logs_dir: str = "./data/logs",
+                    concurrency: int = 100,
+                    timeout: int = 30,
+                    proxy: str = None,
+                    retry_failed: bool = True,
+                    retry_count: int = 2) -> dict:
+    results = await validate_keys(
+        keys_file=keys_file,
+        results_file=results_file,
+        logs_dir=logs_dir,
+        concurrency=concurrency,
+        timeout=timeout,
+        proxy=proxy
+    )
+
+    # Retry failed keys
+    if retry_failed and results["summary"]["error"]["count"] > 0:
+        for i in range(retry_count):
+            error_keys = results["summary"]["error"]["keys"]
+            if not error_keys:
+                break
+
+            retry_results = await validate_keys(
+                keys_file=keys_file,
+                results_file=results_file,
+                logs_dir=logs_dir,
+                concurrency=concurrency,
+                timeout=timeout,
+                proxy=proxy,
+                status_filter="error"
+            )
+
+            # Merge results
+            results["summary"]["valid"]["count"] += retry_results["summary"]["valid"]["count"]
+            results["summary"]["invalid"]["count"] += retry_results["summary"]["invalid"]["count"]
+            results["summary"]["error"]["count"] = retry_results["summary"]["error"]["count"]
+
+    return results