captchakraken 3.2.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/AGENTS.md +5 -9
  2. package/LICENSE +165 -145
  3. package/NOTICE +4 -4
  4. package/README.md +10 -11
  5. package/dist/cli-invocation.d.ts +6 -3
  6. package/dist/cli-invocation.js +26 -10
  7. package/dist/humanize.d.ts +37 -1
  8. package/dist/humanize.js +143 -9
  9. package/dist/index.d.ts +13 -12
  10. package/dist/index.js +25 -33
  11. package/dist/kinds.d.ts +15 -2
  12. package/dist/kinds.js +12 -4
  13. package/dist/playwright-types.d.ts +3 -0
  14. package/dist/selectors.d.ts +96 -11
  15. package/dist/selectors.js +226 -112
  16. package/dist/solver.d.ts +93 -13
  17. package/dist/solver.js +579 -208
  18. package/dist/types.d.ts +53 -8
  19. package/dist/verdicts.d.ts +3 -0
  20. package/dist/verdicts.js +6 -0
  21. package/package.json +4 -4
  22. package/python/AGENTS.md +7 -11
  23. package/python/LICENSE +165 -145
  24. package/python/NOTICE +4 -4
  25. package/python/README.md +10 -9
  26. package/python/pyproject.toml +27 -13
  27. package/python/src/captchakraken/__init__.py +43 -46
  28. package/python/src/captchakraken/action_types.py +32 -1
  29. package/python/src/captchakraken/captchakraken.config.json +416 -0
  30. package/python/src/captchakraken/cli.py +66 -30
  31. package/python/src/captchakraken/clipvideo.py +258 -0
  32. package/python/src/captchakraken/humanize.py +141 -10
  33. package/python/src/captchakraken/image_processor.py +3 -7
  34. package/python/src/captchakraken/keyframes.py +96 -14
  35. package/python/src/captchakraken/kinds.py +14 -2
  36. package/python/src/captchakraken/models.json +28 -3
  37. package/python/src/captchakraken/page_solver.py +621 -259
  38. package/python/src/captchakraken/planner.py +298 -47
  39. package/python/src/captchakraken/pointer/__init__.py +20 -0
  40. package/python/src/captchakraken/pointer/detector.py +333 -0
  41. package/python/src/captchakraken/pointer/elements.py +273 -0
  42. package/python/src/captchakraken/pointer/heads.py +163 -0
  43. package/python/src/captchakraken/pointer/layout.py +319 -0
  44. package/python/src/captchakraken/pointer/marks.py +184 -0
  45. package/python/src/captchakraken/pointer/server.py +146 -0
  46. package/python/src/captchakraken/pointer/service.py +553 -0
  47. package/python/src/captchakraken/pointer/vllm_plugin.py +109 -0
  48. package/python/src/captchakraken/prompts.py +111 -34
  49. package/python/src/captchakraken/selectors.py +224 -131
  50. package/python/src/captchakraken/server_manager.py +18 -0
  51. package/python/src/captchakraken/solver.py +169 -88
  52. package/python/src/captchakraken/tool_calls/board_painted.py +11 -6
  53. package/python/src/captchakraken/tool_calls/fill_tracker.py +152 -0
  54. package/python/src/captchakraken/tool_calls/find_checkbox.py +14 -59
  55. package/python/src/captchakraken/tool_calls/find_grid.py +273 -1191
  56. package/python/src/captchakraken/tool_calls/slide_tracker.py +1102 -0
  57. package/python/src/captchakraken/verdicts.py +16 -0
  58. package/dist/slide-geometry.d.ts +0 -6
  59. package/dist/slide-geometry.js +0 -38
  60. package/python/src/captchakraken/tool_calls/track_piece.py +0 -120
package/dist/types.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import type { RoundVerdict } from './verdicts';
2
2
  import type { Humanizer, TouchTransform } from './humanize.js';
3
+ import type { CustomSelectors, SelectorConfigFile } from './selectors';
3
4
  import type { ActionKind, FrameRole, HumanizationMode, PromptFamily, SolveStage, Vendor } from './kinds';
4
5
  /** One intermediate stage of a solve, handed to `CaptchaKrakenConfig.onStep`. */
5
6
  export interface SolveStepEvent {
@@ -21,6 +22,14 @@ export interface CaptchaKrakenConfig {
21
22
  humanization?: HumanizationMode;
22
23
  /** Your own gesture implementation; overrides `humanization`. */
23
24
  humanizer?: Humanizer;
25
+ /**
26
+ * Every URL pattern and selector the solver detects and drives with: a path to a config file of the shape of the
27
+ * repository's `captchakraken.config.json`, or the parsed object. What it gives is laid over the shipped default, so
28
+ * a file holding only a `custom` entry adds that entry and keeps every built-in vendor. Default: `DEFAULT_CONFIG_PATH`.
29
+ */
30
+ selectors?: string | SelectorConfigFile;
31
+ /** Deprecated, kept working: your own vendor entry in code. Prefer `custom` in the `selectors` file; when both are given this one wins. */
32
+ customSelectors?: CustomSelectors;
24
33
  /** Mobile only: an Appium / WebdriverIO driver on a real handset. Unset dispatches CDP touch at the page. */
25
34
  touchDriver?: any;
26
35
  /** Mobile only: CSS-pixel to device-pixel transform for `touchDriver`. */
@@ -37,6 +46,8 @@ export interface CaptchaKrakenConfig {
37
46
  expert?: PromptFamily;
38
47
  /** Bearer token; also read from CAPTCHA_KRAKEN_API_KEY / VLLM_API_KEY. */
39
48
  apiKey?: string;
49
+ /** OpenAI-compatible base for this solver; defaults to VLLM_BASE_URL. */
50
+ baseUrl?: string;
40
51
  /** Where the pointer starts. Default { x: 100, y: 100 }. */
41
52
  startingMousePosition?: {
42
53
  x: number;
@@ -46,10 +57,10 @@ export interface CaptchaKrakenConfig {
46
57
  maxSolveLoops?: number;
47
58
  /** How long to keep looking for a widget the page has not drawn yet, before "no captcha" is believed. Not charged to `overallSolveTimeoutMs`. Default 15000. */
48
59
  detectionTimeoutMs?: number;
49
- /** Repeats of one answer on one board before the solve ends; the first repeats are re-asked at a fresh sample. Default 2. */
50
- maxNoProgressRounds?: number;
51
60
  /** @deprecated Ignored since 3.2.0: a round that performed nothing goes straight on to the next. */
52
61
  postSolveDelayMs?: number;
62
+ /** Repeats of one answer on one board before the solve ends; the first repeats are re-asked naming the refused answer. Default 2. */
63
+ maxNoProgressRounds?: number;
53
64
  /** Whole-solve time limit. Default 45000. */
54
65
  overallSolveTimeoutMs?: number;
55
66
  /** reCAPTCHA grid-load poll interval. Default 250. */
@@ -86,7 +97,9 @@ export interface CaptchaKrakenConfig {
86
97
  maxStaleFrameReSolves?: number;
87
98
  /** Settle monitor: fraction of pixels that still count as moving. Default 0.01. */
88
99
  settleDiffThreshold?: number;
89
- /** How long to wait for hCaptcha's task images to paint. Default 3000. */
100
+ /** How long to wait for a board's task images (the vendor's `images` selectors) to paint. Default 3000. */
101
+ boardImagesTimeoutMs?: number;
102
+ /** @deprecated Use `boardImagesTimeoutMs`; read when that is unset. */
90
103
  hcaptchaImagesTimeoutMs?: number;
91
104
  /** Settle monitor poll interval. Default 220. */
92
105
  settlePollMs?: number;
@@ -124,10 +137,10 @@ export interface CaptchaKrakenConfig {
124
137
  stepScreenshotTimeoutMs?: number;
125
138
  /** @deprecated Ignored since 3.2.0: a stale handle now counts against `maxSolveLoops`. */
126
139
  maxStaleElementRetries?: number;
127
- /** The pause before a failed round is tried again. Default 900. */
128
- staleElementBackoffMs?: number;
129
140
  /** @deprecated Ignored since 3.2.0: an unusable answer now counts against `maxSolveLoops`. */
130
141
  maxUnsupportedReSolves?: number;
142
+ /** The pause before a failed round is tried again. Default 900. */
143
+ staleElementBackoffMs?: number;
131
144
  }
132
145
  export interface BoundingBox {
133
146
  0: number;
@@ -135,10 +148,15 @@ export interface BoundingBox {
135
148
  2: number;
136
149
  3: number;
137
150
  }
138
- /** Present only on actions from an animated challenge: the keyframe the answer was read off. */
151
+ /**
152
+ * Present only on actions from an animated challenge: the moment the answer was read off, and the picture the
153
+ * driver waits for before acting. `frame` (a keyframe number) on prompt generation 2, `t` (seconds into the
154
+ * clip) on generations that watch the animation as video.
155
+ */
139
156
  export interface AnimatedActionFields {
140
157
  await_keyframe?: string | null;
141
158
  frame?: number | null;
159
+ t?: number | null;
142
160
  }
143
161
  export interface ClickAction extends AnimatedActionFields {
144
162
  action: typeof ActionKind.CLICK;
@@ -150,7 +168,7 @@ export interface ClickAction extends AnimatedActionFields {
150
168
  }
151
169
  export interface DragAction extends AnimatedActionFields {
152
170
  action: typeof ActionKind.DRAG;
153
- /** Null on a puzzle-piece slider: the driver finds the handle and closes the loop on the piece. */
171
+ /** Null on a generation-2 puzzle-piece slider: the driver finds the handle by selector and steers the piece. */
154
172
  source_bounding_box: [number, number, number, number] | null;
155
173
  target_bounding_box: [number, number, number, number];
156
174
  }
@@ -165,7 +183,32 @@ export interface WaitAction {
165
183
  action: typeof ActionKind.WAIT;
166
184
  duration_ms: number;
167
185
  }
168
- export type CaptchaAction = ClickAction | WaitAction | DragAction | TypeAction | DoneAction;
186
+ /**
187
+ * Press on the box and keep pressing until the widget completes (prompt generation 3). When the model also named where
188
+ * the fill starts and where to let go, the driver follows the fill along that line and releases at its end.
189
+ */
190
+ export interface HoldAction extends AnimatedActionFields {
191
+ action: typeof ActionKind.HOLD;
192
+ target_bounding_box: [number, number, number, number];
193
+ fill_from_bounding_box?: [number, number, number, number] | null;
194
+ fill_to_bounding_box?: [number, number, number, number] | null;
195
+ }
196
+ /** Load a new puzzle instead of solving this one (prompt generation 3). The box is the model's point on the control, or null when it saw none; the driver presses the vendor's own control first either way. */
197
+ export interface RefreshAction {
198
+ action: typeof ActionKind.REFRESH;
199
+ target_bounding_box?: [number, number, number, number] | null;
200
+ }
201
+ /**
202
+ * Press the handle and move it until the point on the part it moves reaches the target (prompt generation 3). The
203
+ * driver tracks that part on screen and steers; nothing about the widget is read from its DOM.
204
+ */
205
+ export interface SlideAction {
206
+ action: typeof ActionKind.SLIDE;
207
+ handle_bounding_box: [number, number, number, number];
208
+ source_bounding_box: [number, number, number, number];
209
+ target_bounding_box: [number, number, number, number];
210
+ }
211
+ export type CaptchaAction = ClickAction | WaitAction | DragAction | TypeAction | DoneAction | HoldAction | RefreshAction | SlideAction;
169
212
  export type SolverResult = CaptchaAction | CaptchaAction[];
170
213
  export interface TokenUsage {
171
214
  input_tokens: number;
@@ -175,6 +218,8 @@ export interface TokenUsage {
175
218
  }
176
219
  export interface CliResponse {
177
220
  actions: SolverResult;
221
+ /** The complete plans after the first, best first, and a refresh when they run out. */
222
+ fallbacks?: CaptchaAction[][];
178
223
  token_usage: TokenUsage[];
179
224
  }
180
225
  export interface Vector {
@@ -33,6 +33,9 @@ export declare function readVerdict(url: string, status: number, body: string):
33
33
  export declare class VerdictLog {
34
34
  private readonly page;
35
35
  readonly verdicts: RoundVerdict[];
36
+ /** Requests the page's scripts have made. A board that answers a press with none has refused nothing. */
37
+ exchanges: number;
38
+ readonly listening: boolean;
36
39
  private read;
37
40
  private pending;
38
41
  private readonly listener;
package/dist/verdicts.js CHANGED
@@ -79,6 +79,7 @@ function readVerdict(url, status, body) {
79
79
  const verdict = status >= 200 && status < 300 ? found.endpoint.read(body) : null;
80
80
  return verdict ? { vendor: found.vendor, verdict } : null;
81
81
  }
82
+ const SCRIPTED_REQUESTS = new Set(['xhr', 'fetch', 'script']);
82
83
  /**
83
84
  * Every verdict the page's network carries while a solve runs.
84
85
  *
@@ -89,11 +90,15 @@ class VerdictLog {
89
90
  constructor(page) {
90
91
  this.page = page;
91
92
  this.verdicts = [];
93
+ /** Requests the page's scripts have made. A board that answers a press with none has refused nothing. */
94
+ this.exchanges = 0;
92
95
  this.read = 0;
93
96
  this.pending = [];
94
97
  this.listener = (response) => {
95
98
  const url = response.url();
96
99
  const status = response.status();
100
+ if (SCRIPTED_REQUESTS.has(response.request?.().resourceType?.() ?? ''))
101
+ this.exchanges++;
97
102
  if (!endpointFor(url))
98
103
  return;
99
104
  const body = status === TOO_MANY_REQUESTS ? Promise.resolve('') : response.text();
@@ -103,6 +108,7 @@ class VerdictLog {
103
108
  this.verdicts.push(verdict);
104
109
  }).catch(() => { }));
105
110
  };
111
+ this.listening = typeof page.on === 'function';
106
112
  page.on?.('response', this.listener);
107
113
  }
108
114
  /** The verdicts that arrived since the last call, once every body already on the wire has been read. */
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "captchakraken",
3
- "version": "3.2.0",
4
- "description": "Captcha solver for Playwright and Puppeteer. Finds the captcha, reads the puzzle with a fine-tuned Qwen3.5-9B vision model, and clicks, drags, slides or types through to a token \u2014 reCAPTCHA, GeeTest, NetEase Yidun, Tencent, Lemin, Prosopo, Turnstile and distorted text. Hosted API or self-hosted.",
3
+ "version": "4.0.0",
4
+ "description": "Captcha solver for Playwright and Puppeteer. Finds the captcha, reads it with the v2 pointer model, and clicks, drags, slides or types through to a token \u2014 reCAPTCHA, GeeTest, NetEase Yidun, Tencent, Lemin, Prosopo, Turnstile and distorted text. Hosted API or self-hosted.",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
7
7
  "files": [
@@ -46,14 +46,14 @@
46
46
  "qwen"
47
47
  ],
48
48
  "author": "Jake Writer",
49
- "license": "SEE LICENSE IN LICENSE",
49
+ "license": "LGPL-3.0-only",
50
50
  "type": "commonjs",
51
51
  "bugs": {
52
52
  "url": "https://github.com/CaptchaKraken/CaptchaKraken/issues"
53
53
  },
54
54
  "homepage": "https://github.com/CaptchaKraken/CaptchaKraken#readme",
55
55
  "dependencies": {
56
- "cursory-js": "2.0.1"
56
+ "cursory-js": "2.1.0"
57
57
  },
58
58
  "devDependencies": {
59
59
  "@types/node": "24.10.2",
package/python/AGENTS.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # captchakraken (PyPI)
2
2
 
3
- The Python **engine and CLI**: OpenCV grid detection plus a planner that asks a
3
+ The Python **engine and CLI**: CPU element detection plus a planner that asks a
4
4
  fine-tuned vision model what to do, and a page driver that performs it in a
5
5
  Playwright browser.
6
6
 
@@ -64,7 +64,7 @@ captchakraken path/to/captcha.png # prints a JSON click plan
64
64
 
65
65
  Other CLI modes, all printing JSON: `captchakraken server start|stop|status|run`
66
66
  manages a local vLLM server, `captchakraken fetch` updates weights and the
67
- serving stack together, and the OpenCV tool calls (`find-grid`, `find-checkbox`,
67
+ serving stack together, and the detector tool calls (`find-grid`, `find-checkbox`,
68
68
  `get-numbered-grid`, `detect-selected`, …) are exposed one per subcommand. The
69
69
  module docstring of `captchakraken/cli.py` lists every mode with its arguments.
70
70
 
@@ -111,15 +111,11 @@ generation and the weights drift apart.
111
111
  - **Never print an API key** into a transcript, a log, or a commit. Use
112
112
  `create_api_key`, which writes it to disk instead. `captchakraken.env` and
113
113
  `.env` hold keys and are never committed.
114
- - **Abyss is what our hosted API serves, and it is never downloadable.** The
115
- current client names an Abyss expert on every request to our endpoint and is
116
- answered by Abyss; an older client, or a request that names no model, gets
117
- Twilight v1.2, because its prompts belong to that generation. Nothing about it
118
- is gated on the account. Do not suggest weights, a download or a workaround
119
- for it, and do not quote accuracy figures for it — none are published. Verify
120
- what is serving with `GET /v1/models`.
121
- - **Respect the licence.** Building automation with this is fine; selling the
122
- solve, or shipping it inside a browser or automation product, is not. See
114
+ - **Midnight V2 4B Q4 is the default self-hosted and hosted model.** The v2
115
+ weights are downloadable under LGPL-3.0-only. Older clients keep using their
116
+ registered chat-completion model because the protocols are not interchangeable.
117
+ - **Respect the licence.** CaptchaKraken and all its models are LGPL-3.0-only;
118
+ commercial use and integration are permitted under those terms. See
123
119
  [LICENSE](./LICENSE) and
124
120
  [docs/licensing.md](https://github.com/CaptchaKraken/CaptchaKraken/blob/main/docs/licensing.md).
125
121
  - **Changing this package's own code?** Its rules are in
package/python/LICENSE CHANGED
@@ -1,145 +1,165 @@
1
- CaptchaKraken Source-Available License v1.1
2
- Copyright (c) 2026 CaptchaKraken LLC. All rights reserved.
3
-
4
- This license governs use of the CaptchaKraken software in this repository and of
5
- the associated machine-learning model weights and LoRA adapters published by the
6
- copyright holder (collectively, the "Software"). By using the Software you agree
7
- to these terms. If you do not agree, do not use the Software.
8
-
9
- ================================================================================
10
- 1. GRANT
11
- ================================================================================
12
- Subject to the restrictions below, you are granted a worldwide, royalty-free,
13
- non-exclusive license to use, copy, modify, and distribute the Software, and to
14
- incorporate it into your own products and services.
15
-
16
- ================================================================================
17
- 2. PERMITTED USES
18
- ================================================================================
19
- You MAY use the Software for:
20
-
21
- (a) Personal, non-commercial use, research, and education.
22
-
23
- (b) Commercial use INSIDE a larger product or service that delivers
24
- substantial value BEYOND captcha solving itself — that is, where captcha
25
- solving is an internal, enabling component rather than the product.
26
-
27
- Illustrative (non-exhaustive) examples of PERMITTED commercial use:
28
- - Web scrapers and data-collection pipelines.
29
- - Browser automation you build and operate for your own purposes.
30
- - QA, testing, and accessibility tooling.
31
- - Any application where the captcha solve is a means to an end the user
32
- is actually paying for.
33
-
34
- (c) RUNNING the Software alongside a stealth, anti-detection, or antidetect
35
- browser — Camoufox, Puppeteer, Playwright, or any similar tool — to
36
- automate your own work, commercially or otherwise. Section 3(d) restricts
37
- SHIPPING the Software as a feature of such a browser to other people. It
38
- does not restrict USING it with one.
39
-
40
- ================================================================================
41
- 3. PROHIBITED USES
42
- ================================================================================
43
- You MAY NOT, without a separate written commercial agreement from the copyright
44
- holder:
45
-
46
- (a) Sell, resell, rent, or otherwise offer for a fee any captcha-SOLVING
47
- service, product, or API whose primary value is solving captchas,
48
- where that service is powered by the Software or its model outputs.
49
-
50
- (b) Distribute "thin wrappers" around the Software whose primary purpose is
51
- captcha solving — including but not limited to browser extensions,
52
- hosted endpoints, SaaS products, or CLIs that simply expose the
53
- Software's solving capability to end users.
54
-
55
- (c) Expose, proxy, or relay the responses or outputs of the Software's LoRA
56
- models (e.g. bounding boxes, tile selections, click plans) through a paid
57
- or public API as a captcha-solving service.
58
-
59
- (d) Embed, bundle, preinstall, or otherwise ship the Software — or a client,
60
- wrapper, plugin, or extension for it — as a captcha-solving capability of
61
- any stealth browser, anti-detection or antidetect browser, browser
62
- profile or identity manager, or browser-automation product or platform
63
- that you distribute, host, or otherwise offer to third parties. This
64
- applies whether the Software ships inside your distribution, is fetched
65
- on demand, or is merely wired up and advertised as a supported
66
- integration, and it applies whether or not you charge for it.
67
-
68
- This restriction is about DISTRIBUTION, not use. Nothing in it limits
69
- Section 2(c): a person who uses such a browser may install and run the
70
- Software with it freely.
71
-
72
- In short: you may BUILD WITH this Software, and you may USE it with whatever
73
- browser you like — but you may not SELL THE SOLVE, and you may not SHIP THE
74
- SOLVE as a feature of a stealth browser or automation product you hand to
75
- other people.
76
-
77
- ================================================================================
78
- 4. MODEL OUTPUTS
79
- ================================================================================
80
- Outputs produced by the model weights/adapters are subject to Sections 2 and 3
81
- to the same extent as the Software itself. Reselling or API-relaying those
82
- outputs as a captcha-solving service is prohibited under Section 3(c).
83
-
84
- ================================================================================
85
- 5. REDISTRIBUTION
86
- ================================================================================
87
- If you redistribute the Software (modified or not), you must retain this license
88
- and this notice, and you must not remove or alter the restrictions in Section 3.
89
- The right to redistribute granted by Section 1 is subject to Section 3(d).
90
-
91
- ================================================================================
92
- 6. TRADEMARKS
93
- ================================================================================
94
- This license does not grant permission to use the trade names, trademarks, or
95
- product names of the copyright holder, except as required to describe the origin
96
- of the Software.
97
-
98
- ================================================================================
99
- 7. NO WARRANTY
100
- ================================================================================
101
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
102
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
103
- FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
104
- COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER
105
- IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN
106
- CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
107
-
108
- ================================================================================
109
- 8. RESPONSIBLE USE
110
- ================================================================================
111
- You are responsible for ensuring your use of the Software complies with all
112
- applicable laws, the terms of service of any site you interact with, and
113
- applicable anti-fraud and computer-access statutes. The copyright holder does
114
- not endorse using the Software to violate any third party's terms or rights.
115
-
116
- ================================================================================
117
- 9. COMMERCIAL LICENSING
118
- ================================================================================
119
- For uses prohibited under Section 3 — including selling captcha-solving as a
120
- service, and shipping the Software as a built-in capability of a stealth browser
121
- or automation product — contact the copyright holder to discuss a separate
122
- commercial license. These uses are licensable; they are not categorically
123
- refused.
124
-
125
- ================================================================================
126
- 10. VERSION HISTORY
127
- ================================================================================
128
- v1.1 — Section 3(d) added: shipping the Software as a captcha-solving feature of
129
- a stealth/anti-detection browser or automation product distributed to
130
- third parties now requires a commercial license. Section 2(c) added to
131
- make clear that USING the Software with such a browser remains permitted.
132
- The v1.0 text listed "stealth / anti-detection browsers" as an
133
- illustrative PERMITTED commercial use; that example is removed.
134
- v1.0 — Initial release.
135
-
136
- Each version applies to the releases distributed under it. Copies obtained under
137
- v1.0 remain governed by v1.0.
138
-
139
- --------------------------------------------------------------------------------
140
- This text is a license, not legal advice. If the boundary between a permitted
141
- "value-add" product and a prohibited "thin wrapper", or between using the
142
- Software with a browser and shipping it as part of one, is unclear for your use
143
- case, ask by opening an issue or messaging the maintainer on GitHub:
144
- https://github.com/CaptchaKraken/CaptchaKraken
145
- --------------------------------------------------------------------------------
1
+ GNU LESSER GENERAL PUBLIC LICENSE
2
+ Version 3, 29 June 2007
3
+
4
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
5
+ Everyone is permitted to copy and distribute verbatim copies
6
+ of this license document, but changing it is not allowed.
7
+
8
+
9
+ This version of the GNU Lesser General Public License incorporates
10
+ the terms and conditions of version 3 of the GNU General Public
11
+ License, supplemented by the additional permissions listed below.
12
+
13
+ 0. Additional Definitions.
14
+
15
+ As used herein, "this License" refers to version 3 of the GNU Lesser
16
+ General Public License, and the "GNU GPL" refers to version 3 of the GNU
17
+ General Public License.
18
+
19
+ "The Library" refers to a covered work governed by this License,
20
+ other than an Application or a Combined Work as defined below.
21
+
22
+ An "Application" is any work that makes use of an interface provided
23
+ by the Library, but which is not otherwise based on the Library.
24
+ Defining a subclass of a class defined by the Library is deemed a mode
25
+ of using an interface provided by the Library.
26
+
27
+ A "Combined Work" is a work produced by combining or linking an
28
+ Application with the Library. The particular version of the Library
29
+ with which the Combined Work was made is also called the "Linked
30
+ Version".
31
+
32
+ The "Minimal Corresponding Source" for a Combined Work means the
33
+ Corresponding Source for the Combined Work, excluding any source code
34
+ for portions of the Combined Work that, considered in isolation, are
35
+ based on the Application, and not on the Linked Version.
36
+
37
+ The "Corresponding Application Code" for a Combined Work means the
38
+ object code and/or source code for the Application, including any data
39
+ and utility programs needed for reproducing the Combined Work from the
40
+ Application, but excluding the System Libraries of the Combined Work.
41
+
42
+ 1. Exception to Section 3 of the GNU GPL.
43
+
44
+ You may convey a covered work under sections 3 and 4 of this License
45
+ without being bound by section 3 of the GNU GPL.
46
+
47
+ 2. Conveying Modified Versions.
48
+
49
+ If you modify a copy of the Library, and, in your modifications, a
50
+ facility refers to a function or data to be supplied by an Application
51
+ that uses the facility (other than as an argument passed when the
52
+ facility is invoked), then you may convey a copy of the modified
53
+ version:
54
+
55
+ a) under this License, provided that you make a good faith effort to
56
+ ensure that, in the event an Application does not supply the
57
+ function or data, the facility still operates, and performs
58
+ whatever part of its purpose remains meaningful, or
59
+
60
+ b) under the GNU GPL, with none of the additional permissions of
61
+ this License applicable to that copy.
62
+
63
+ 3. Object Code Incorporating Material from Library Header Files.
64
+
65
+ The object code form of an Application may incorporate material from
66
+ a header file that is part of the Library. You may convey such object
67
+ code under terms of your choice, provided that, if the incorporated
68
+ material is not limited to numerical parameters, data structure
69
+ layouts and accessors, or small macros, inline functions and templates
70
+ (ten or fewer lines in length), you do both of the following:
71
+
72
+ a) Give prominent notice with each copy of the object code that the
73
+ Library is used in it and that the Library and its use are
74
+ covered by this License.
75
+
76
+ b) Accompany the object code with a copy of the GNU GPL and this license
77
+ document.
78
+
79
+ 4. Combined Works.
80
+
81
+ You may convey a Combined Work under terms of your choice that,
82
+ taken together, effectively do not restrict modification of the
83
+ portions of the Library contained in the Combined Work and reverse
84
+ engineering for debugging such modifications, if you also do each of
85
+ the following:
86
+
87
+ a) Give prominent notice with each copy of the Combined Work that
88
+ the Library is used in it and that the Library and its use are
89
+ covered by this License.
90
+
91
+ b) Accompany the Combined Work with a copy of the GNU GPL and this license
92
+ document.
93
+
94
+ c) For a Combined Work that displays copyright notices during
95
+ execution, include the copyright notice for the Library among
96
+ these notices, as well as a reference directing the user to the
97
+ copies of the GNU GPL and this license document.
98
+
99
+ d) Do one of the following:
100
+
101
+ 0) Convey the Minimal Corresponding Source under the terms of this
102
+ License, and the Corresponding Application Code in a form
103
+ suitable for, and under terms that permit, the user to
104
+ recombine or relink the Application with a modified version of
105
+ the Linked Version to produce a modified Combined Work, in the
106
+ manner specified by section 6 of the GNU GPL for conveying
107
+ Corresponding Source.
108
+
109
+ 1) Use a suitable shared library mechanism for linking with the
110
+ Library. A suitable mechanism is one that (a) uses at run time
111
+ a copy of the Library already present on the user's computer
112
+ system, and (b) will operate properly with a modified version
113
+ of the Library that is interface-compatible with the Linked
114
+ Version.
115
+
116
+ e) Provide Installation Information, but only if you would otherwise
117
+ be required to provide such information under section 6 of the
118
+ GNU GPL, and only to the extent that such information is
119
+ necessary to install and execute a modified version of the
120
+ Combined Work produced by recombining or relinking the
121
+ Application with a modified version of the Linked Version. (If
122
+ you use option 4d0, the Installation Information must accompany
123
+ the Minimal Corresponding Source and Corresponding Application
124
+ Code. If you use option 4d1, you must provide the Installation
125
+ Information in the manner specified by section 6 of the GNU GPL
126
+ for conveying Corresponding Source.)
127
+
128
+ 5. Combined Libraries.
129
+
130
+ You may place library facilities that are a work based on the
131
+ Library side by side in a single library together with other library
132
+ facilities that are not Applications and are not covered by this
133
+ License, and convey such a combined library under terms of your
134
+ choice, if you do both of the following:
135
+
136
+ a) Accompany the combined library with a copy of the same work based
137
+ on the Library, uncombined with any other library facilities,
138
+ conveyed under the terms of this License.
139
+
140
+ b) Give prominent notice with the combined library that part of it
141
+ is a work based on the Library, and explaining where to find the
142
+ accompanying uncombined form of the same work.
143
+
144
+ 6. Revised Versions of the GNU Lesser General Public License.
145
+
146
+ The Free Software Foundation may publish revised and/or new versions
147
+ of the GNU Lesser General Public License from time to time. Such new
148
+ versions will be similar in spirit to the present version, but may
149
+ differ in detail to address new problems or concerns.
150
+
151
+ Each version is given a distinguishing version number. If the
152
+ Library as you received it specifies that a certain numbered version
153
+ of the GNU Lesser General Public License "or any later version"
154
+ applies to it, you have the option of following the terms and
155
+ conditions either of that published version or of any later version
156
+ published by the Free Software Foundation. If the Library as you
157
+ received it does not specify a version number of the GNU Lesser
158
+ General Public License, you may choose any version of the GNU Lesser
159
+ General Public License ever published by the Free Software Foundation.
160
+
161
+ If the Library as you received it specifies that a proxy can decide
162
+ whether future versions of the GNU Lesser General Public License shall
163
+ apply, that proxy's public statement of acceptance of any version is
164
+ permanent authorization for you to choose that version for the
165
+ Library.
package/python/NOTICE CHANGED
@@ -1,10 +1,10 @@
1
1
  CaptchaKraken
2
- Copyright (c) 2026 CaptchaKraken LLC. All rights reserved.
2
+ Copyright (c) 2026 CaptchaKraken LLC.
3
3
 
4
4
  This product includes third-party software. The notices below are required by
5
- those components' licences and do not change the terms of the CaptchaKraken
6
- Source-Available License, which governs everything in this repository that is
7
- not listed here.
5
+ those components' licences and do not change the terms of the GNU Lesser
6
+ General Public License, version 3 only (LGPL-3.0-only), which governs
7
+ everything in this repository that is not listed here.
8
8
 
9
9
  ────────────────────────────────────────────────────────────────────────────
10
10
  Cursory — mouse trajectory generation