captchakraken 2.9.0 → 3.1.0

package/python/src/captchakraken/kinds.py

@@ -0,0 +1,152 @@
+"""Every closed set of names the two ports agree on. Mirrored in js/src/kinds.ts; keep both in the same order."""
+from enum import StrEnum
+
+
+class Vendor(StrEnum):
+    """`puzzle_source` everywhere. UNKNOWN must stay permissive: GeeTest and Prosopo report it, and so does the offline grader."""
+
+    HCAPTCHA = "hcaptcha"
+    RECAPTCHA = "recaptcha"
+    TURNSTILE = "turnstile"
+    GEETEST = "geetest"
+    TENCENT = "tencent"
+    YIDUN = "yidun"
+    YANDEX = "yandex"
+    LEMIN = "lemin"
+    PROSOPO = "prosopo"
+    MTCAPTCHA = "mtcaptcha"
+    BOTDETECT = "botdetect"
+    UNKNOWN = "unknown"
+
+
+class ActionKind(StrEnum):
+    CLICK = "click"
+    DRAG = "drag"
+    TYPE = "type"
+    WAIT = "wait"
+    DONE = "done"
+
+
+class PixelAnswerKind(StrEnum):
+    """What the pixel parser reads off the model's text before it becomes an action."""
+
+    CLICK = "click"
+    DRAG = "drag"
+    SLIDE = "slide"
+    TYPE = "type"
+
+
+class RetryMode(StrEnum):
+    MISSED_TILES = "missed-tiles"
+
+
+class SettleVerdict(StrEnum):
+    SETTLED = "settled"
+    ANIMATED = "animated"
+    TIMEOUT = "timeout"
+
+
+class PaintVerdict(StrEnum):
+    PAINTED = "painted"
+    BLANK = "blank"
+    UNKNOWN = "unknown"
+
+
+class KeyframeMode(StrEnum):
+    """EVEN means the slicer could not prove recurrence, not that the board is still."""
+
+    STATIC = "static"
+    CYCLE = "cycle"
+    EVEN = "even"
+
+
+class RecaptchaBanner(StrEnum):
+    SELECT_MORE = "select-more"
+    DYNAMIC_MORE = "dynamic-more"
+    REJECTED = "rejected"
+
+
+class PromptFamily(StrEnum):
+    """One expert per family; `pixel` is spelled to match ckgate's prompt markers."""
+
+    PIXEL = "pixel"
+    GRID = "grid"
+    VIDEO = "video"
+    TEXT = "text"
+
+
+class Availability(StrEnum):
+    """PRIVATE is not a softer LICENSED: refusing a private model early would stop an authorised token from fetching weights."""
+
+    PUBLIC = "public"
+    PRIVATE = "private"
+    LICENSED = "licensed"
+
+
+class HumanizationMode(StrEnum):
+    MOUSE = "mouse"
+    MOBILE = "mobile"
+    NONE = "none"
+
+
+class PauseKind(StrEnum):
+    TAP = "tap"
+    BETWEEN = "between"
+    GRAB = "grab"
+    DROP = "drop"
+    PROBE = "probe"
+    SETTLE = "settle"
+    KEY = "key"
+
+
+class Outcome(StrEnum):
+    SOLVED = "solved"
+    FAILED = "failed"
+
+
+class Phase(StrEnum):
+    """Timing phases. Only INFERENCE and MOUSE are productive; everything else is waiting."""
+
+    INFERENCE = "inference"
+    MOUSE = "mouse"
+    SCREENSHOT = "screenshot"
+    DETECT = "detect"
+    SETTLE = "settle"
+    BURST = "burst"
+    GRID = "grid"
+    GRID_LOAD = "grid-load"
+    FADE_WAIT = "fade-wait"
+    BOARD_PAINT = "board-paint"
+    HCAPTCHA_IMAGES = "hcaptcha-images"
+    AWAIT_NEXT_ROUND = "await-next-round"
+    AWAIT_VERDICT = "await-verdict"
+    POST_SUBMIT_DELAY = "post-submit-delay"
+
+
+class FrameRole(StrEnum):
+    CHECKBOX = "checkbox"
+    CHALLENGE = "challenge"
+    UNKNOWN = "unknown"
+
+
+class LabelPosition(StrEnum):
+    TOP_LEFT = "top-left"
+    CENTER = "center"
+    TOP_RIGHT = "top-right"
+    BOTTOM_LEFT = "bottom-left"
+    BOTTOM_RIGHT = "bottom-right"
+
+
+class ErrorCode(StrEnum):
+    """The hosted API's machine-readable codes. Unknown codes still carry the server's message through; this is not a filter."""
+
+    MISSING_API_KEY = "missing_api_key"
+    INVALID_API_KEY = "invalid_api_key"
+    ACCOUNT_SUSPENDED = "account_suspended"
+    INSUFFICIENT_CREDITS = "insufficient_credits"
+    RATE_LIMITED = "rate_limited"
+    SOLVE_ABANDONED = "solve_abandoned"
+    UNRECOGNIZED_PROMPT = "unrecognized_prompt"
+    INVALID_REQUEST = "invalid_request"
+    REQUEST_TOO_LARGE = "request_too_large"
+    UPSTREAM_UNAVAILABLE = "upstream_unavailable"

package/python/src/captchakraken/models.json

@@ -64,8 +64,8 @@
     "               never be private either — an unpinned self-hoster would get",
     "               a 401 instead of a model — and the release parity gate says so.",
     "",
-    "  \"licensed\" — NOT downloadable by anyone. Reachable only through",
-    "               api.captchakraken.com, or by a holder of a licence we issue.",
+    "  \"licensed\" — NOT downloadable without a licence we issue. Served to",
+    "               every account through api.captchakraken.com.",
     "               There is no Hub repo to point CAPTCHA_LORA_ADAPTER at, and",
     "               `captchakraken fetch` refuses rather than 404ing at the Hub.",
     "",
@@ -121,6 +121,28 @@
     "routed model in the first place."
   ],
   "latest": "CaptchaKraken/CaptchaKraken-Lora-v1.2",
+  "_comment_hosted_default": [
+    "WHAT THE HOSTED ENDPOINT IS ASKED FOR, which is not what gets DOWNLOADED.",
+    "",
+    "`latest` is the download default: the repo a self-hoster pulls and serves.",
+    "`hosted_default` is the served NAME a client sends when it is talking to",
+    "our API. They were one field until Abyss, and one field cannot express",
+    "this: Abyss is hosted-only, so naming it as `latest` would point every",
+    "self-hoster at weights they are not licensed to download, while leaving it",
+    "out would mean the hosted endpoint never serves the better model.",
+    "",
+    "This is also what makes the rollout version-gated without a version",
+    "header. A client that ships this file asks for `abyss`; one that predates",
+    "it asks for whatever its own registry says and keeps getting v1.2. Nothing",
+    "server-side has to know which is which.",
+    "",
+    "Only consulted for an endpoint that is OURS \u2014 see config.is_hosted_endpoint.",
+    "A self-hosted vLLM, local or remote, resolves from `latest` exactly as",
+    "before, because it serves whatever its operator loaded and asking it for",
+    "`abyss` would 404."
+  ],
+  "hosted_default": "CaptchaKraken/Abyss",
+  
   "models": {
     "CaptchaKraken/CaptchaKraken-Lora-v1.2": {
       "prompt_version": "2",
@@ -154,6 +176,16 @@
       },
       "note": "CaptchaKraken-Lora-v1.2 merged into Qwen/Qwen3.5-9B at AWQ 4-bit. Generation 2. Quantization changes the weights, not the schema they answer in, so the prompt generation and the pixel budget are the adapter's."
     },
+    "CaptchaKraken/CaptchaKraken-v1.2-GGUF": {
+      "prompt_version": "2",
+      "kind": "merged",
+      "lora_name": "CaptchaKraken/CaptchaKraken-v1.2-GGUF",
+      "pixel_budget": {
+        "min": 518400,
+        "max": 518400
+      },
+      "note": "CaptchaKraken-Lora-v1.2 merged into Qwen/Qwen3.5-9B and converted to GGUF, for llama.cpp and Ollama. ONE entry covers every quantisation in that repo: Q4_K_M, Q8_0 and F16 differ in weight precision, not in the schema they answer or the resolution they read at, so all three share this generation and this band. The vision tower ships beside them as a separate F16 projector and is never quantised — a runtime that loads the weights without it is text-only and cannot see a puzzle at all. Ollama names a model after whatever it was pulled or created as, and that name is what reaches us as `model`; an unrecognised one resolves through CAPTCHA_LORA_ADAPTER instead, which is why the self-hosting guide sets it."
+    },
     "CaptchaKraken/CaptchaKraken_v1.1": {
       "prompt_version": "1",
       "kind": "lora",
@@ -198,7 +230,7 @@
         "video": "abyss-video",
         "text": "abyss-text"
       },
-      "note": "A routed mixture of four expert LoRAs on Qwen3.5-9B — grid, pixel, video and text — selected by prompt family. Hosted only: `availability` refuses the weights, and being nameable is not being downloadable. A licence holder does name this model, which is why it and each of its arms has a served_aliases entry. `lora_name` is `abyss-general` rather than a fifth name because the generalist IS the fallback for any family `experts` does not map, so the two point at one adapter and the mixture needs one fewer resident LoRA slot."
+      "note": "A routed mixture of four expert LoRAs on Qwen3.5-9B — grid, pixel, video and text — selected by prompt family. Hosted only: `availability` refuses the weights, and being nameable is not being downloadable. The current client names this model against our endpoint, which is why it and each of its arms has a served_aliases entry. `lora_name` is `abyss-general` rather than a fifth name because the generalist IS the fallback for any family `experts` does not map, so the two point at one adapter and the mixture needs one fewer resident LoRA slot."
     },
     "CaptchaKraken/Abyss-27B": {
       "availability": "private",
@@ -270,7 +302,7 @@
     "_comment": "A hosted endpoint serves a bare name, not a repo id. Map it back so prompt resolution works for callers who only ever see the alias. The hosted API serves one model behind the permanent public name `captcha`, whatever the caller sends, so `captcha` means whichever adapter is current there. Self-hosters resolve by repo id via CAPTCHA_LORA_ADAPTER and are unaffected. Move this in the same change as the gateway's upstream model, or the hosted model answers a prompt generation it was not trained on.",
     "captcha": "CaptchaKraken/CaptchaKraken-Lora-v1.2",
     "captcha-v12": "CaptchaKraken/CaptchaKraken-Lora-v1.2",
-    "_comment_abyss": "An alias says which model a served NAME means; `availability` says whether its weights can be downloaded. The two are independent. A licence holder names this model — the hosted API accepts it from a licensed key and lists it on /v1/models — and without this line prompt resolution falls through to the `latest` fallback, which is the model/generation mispairing this file exists to prevent. It does not make the weights fetchable.",
+    "_comment_abyss": "An alias says which model a served NAME means; `availability` says whether its weights can be downloaded. The two are independent. The current client names this model against our endpoint — the hosted API serves it to every account and lists it on /v1/models — and without this line prompt resolution falls through to the `latest` fallback, which is the model/generation mispairing this file exists to prevent. It does not make the weights fetchable.",
     "abyss": "CaptchaKraken/Abyss",
     "_comment_abyss_experts": "The four expert arms. These are the names that go on the wire — a routed request for a grid names `abyss-grid`, never `abyss` — so without these lines prompt resolution falls through to `latest` on every routed solve. Aliasing the arms onto one entry is deliberate and checked: they share a base, a prompt generation and a pixel band, and the parity gate requires every expert name to resolve to a registered entry declaring the SAME prompt_version and pixel_budget as the router — so the day an arm trains at another generation or band, the gate refuses the alias and that arm has to graduate to an entry of its own.",
     "abyss-grid": "CaptchaKraken/Abyss-grid",